03. Spresense Wi-Fi Initial Setup

Introduction

Before beginning the initial setup, please complete the following:

Before beginning the initial setup, please review the supported communication specifications:

Wi-Fi authentication method supports only WPA/WPA2-Persoanl.


Initial Setup

To perform the initial setup, follow the steps below:

  1. Prepare a Windows 10 PC with TeraTerm (Terminal software) installed in advance.

  2. Install the USB serial driver before connecting the Spresense board to the PC.
    Download and install the driver from the following link:

  3. Connect the Spresense main board to the PC using a USB cable for communication.

  4. Open the device manager on the PC and identify the COM port number that the Spresense is connected to.

  5. Start TeraTerm and open the COM port.

  6. Set the serial port and terminal settings as shown below.

  7. After opening the COM port and displaying Welcome to NEQTO!, enter a key within 2.5 seconds to activate the User Console mode.
    If no prompt appears, disconnect the USB from the PC and repeat from step 3.

    Welcome to NEQTO!
    neqtoSpresenseWiFi Ver.00.00.00 Build [Apr  1 2021 00:00:00]
    Copyright (c) 2020 JIG-SAW INC. All Right Reserved.
    User Console Mode!

    > ↵
    > ↵
    > 


  8. Configure the communication settings for Spresense.
    Set the required configurations using the commands below.
    The set value will be immediately saved in the nonvolatile memory after the command is input.

    List of communication setting commands

    CommandContentNote
    wifi set ssid <SSID>Sets the SSID of the Wi-Fi connection point.
    31 character limit.
    If <SSID> is omitted, the setting value will be blank.
    Caution: If there are two or more spaces in a row, one space is used.
    wifi set pass <PASS>Sets the password to connect to the Wi-Fi.
    A valid password must be 8-63 characters.
    If <PASS> is omitted, the setting value will be blank.
    wifi getGets the Wi-Fi connection setting information (SSID, Password).
    If a setting value is blank, nothing is set.

    The following are example command inputs:

    > wifi set ssid AP-TEST-g↵
    OK

    > wifi set pass 1234567890Abc↵
    OK

    > wifi get↵
    [0]SSID     : AP-TEST-g
    [0]PASSWORD : ********

    > 


  9. To connect to the NEQTO service for the first time, please proceed to Challenge Registration.

    If challenge registration has already been completed, enter the start command to launch the NEQTO service.
    Note that node registration must be completed on the NEQTO Console before entering the start command.

    CommandContentNote
    startEstablish a communication connection and launch the NEQTO service.

    > start↵
    OK

    > [system][info]Certification Complete(00.00.00)
    [system][info]Checking Script...
    [system][info]Ready
    Thu Apr 08 2021 02:31:03 GMT+00:00+766ms : Hello World!!! 0
    Thu Apr 08 2021 02:31:04 GMT+00:00+766ms : Hello World!!! 1
    Thu Apr 08 2021 02:31:05 GMT+00:00+766ms : Hello World!!! 2
    Thu Apr 08 2021 02:31:06 GMT+00:00+766ms : Hello World!!! 3
    Thu Apr 08 2021 02:31:07 GMT+00:00+766ms : Hello World!!! 4
    Thu Apr 08 2021 02:31:08 GMT+00:00+766ms : Hello World!!! 5
    Thu Apr 08 2021 02:31:09 GMT+00:00+766ms : Hello World!!! 6
    Thu Apr 08 2021 02:31:10 GMT+00:00+766ms : Hello World!!! 7
    Thu Apr 08 2021 02:31:11 GMT+00:00+766ms : Hello World!!! 8
    Thu Apr 08 2021 02:31:12 GMT+00:00+766ms : Hello World!!! 9
    Thu Apr 08 2021 02:31:13 GMT+00:00+766ms : Hello World!!! 10


Challenge Registration

If connecting Spresense to the NEQTO service for the first time, it is necessary to perform the procedure to register the serial number issued by the NEQTO Console to the Spresense device. This is called "challenge registration".

Due to challenge registration requiring a communication connection to the NEQTO Console, ensure that the communication settings are completed in advance.

The procedure is as follows:

  1. Complete the Spresense device registration and node registration on the NEQTO Console.

  2. View the details of the Spresense device registered in step 1. and note the challenge code.

  3. In User Console mode, enter the chal command. Specify the challenge code confirmed in step 2.

    CommandContentNote
    chal <Challenge Code>Schedules the challenge registration.
    Specify the 12 character challenge code.
    This command must be entered before entering the start command.

    User Console Mode!

    > chal 123456789Abc↵
    OK

    > 


  4. Enter the start command to initiate the challenge registration.

    If the challenge registration is successful, the NEQTO service will continue to be launched.

    User Console Mode!

    > chal 123456789Abc↵
    OK

    > start↵
    OK

    > [system][info]Registration Complete(00.00.00)
    [system][info]Checking Script...
    [system][info]Ready
    Thu Apr 08 2021 02:31:03 GMT+00:00+766ms : Hello World!!! 0
    Thu Apr 08 2021 02:31:04 GMT+00:00+766ms : Hello World!!! 1
    Thu Apr 08 2021 02:31:05 GMT+00:00+766ms : Hello World!!! 2
    Thu Apr 08 2021 02:31:06 GMT+00:00+766ms : Hello World!!! 3
    Thu Apr 08 2021 02:31:07 GMT+00:00+766ms : Hello World!!! 4
    Thu Apr 08 2021 02:31:08 GMT+00:00+766ms : Hello World!!! 5
    Thu Apr 08 2021 02:31:09 GMT+00:00+766ms : Hello World!!! 6
    Thu Apr 08 2021 02:31:10 GMT+00:00+766ms : Hello World!!! 7
    Thu Apr 08 2021 02:31:11 GMT+00:00+766ms : Hello World!!! 8
    Thu Apr 08 2021 02:31:12 GMT+00:00+766ms : Hello World!!! 9
    Thu Apr 08 2021 02:31:13 GMT+00:00+766ms : Hello World!!! 10

    If the message below is displayed, the challenge registration has failed.
    Review the settings on the NEQTO Console and retry the challenge registration.

    User Console Mode!

    > chal 123456789Abc↵
    OK

    > start↵
    OK

    > Challenge failed. Check the network configuration and try again.
    Welcome to neqto!!!
    neqtoSpresenseWiFi Ver.00.00.00 Build [Apr  1 2021 00:00:00]
    Copyright (c) 2020 JIG-SAW INC. All Right Reserved.
    Enter challenge-code!
    User Console Mode!

If the challenge registration is successful, it will not be necessary to perform the challenge registration from the next boot up.
If the device registration has been changed on the NEQTO Console, it will be necessary to re-perform the challenge registration.


Troubleshooting

The operating status of the device can be ascertained from the state of the system LEDs and the display of event messages.


  • While System LED1 remains on and System LED2 flashes continuously, the NEQTO service does not start.

    Cannot connect to Wi-Fi.

     » Review the Wi-Fi communication settings of Spresense.
     » Verify that the Wi-Fi wireless communication environment is favorable.

  • While System LED1 remains off, System LED2 flashes continuously, the NEQTO service does not start.

    Cannot connect to NEQTO Console.

     » Verify that the Wi-Fi connection point has access to the internet.
     » Review the device settings on the NEQTO Console.
     » If the issue cannot be resolved, please contact NEQTO support for further assistance.


Appendix

Get Device-specific Information

The following commands may be used to get device-specific information.

CommandContentNote
srGets the serial ID of the Spresense.
vGets the firmware version of the Spresense.
uGets the unique ID of the Spresense.

MAC Address Acquisition

The following command may be used to get the MAC address of the Wi-Fi module.

CommandContentNote
wifi macGets the Wi-Fi MAC address.
It is necessary to setup the Wi-Fi and enter the start command before inputting this command. When not yet acquired, it becomes 00:00:00:00:00:00.
User Console Mode!

> start↵
OK

> wifi mac↵
12:34:56:78:90:ab

> 


Antenna Level Indication

The current antenna level may be indicated via the system LED.
Refer to System LED Indications for the LED display pattern.

CommandContentNote
wifi led <on/off>Sets the antenna level indicator.
off: Disabled
on: Indicate the antenna level via LED.
The default value is off.

Wi-Fi Module Type Setting

The following command may be used to set the Wi-Fi module type used by Spresense.
The set value is immediately saved in the nonvolatile memory after the command is input.

CommandContentNote
wifiex set type <0/1/2>Sets the Wi-Fi module type.
0: iS110B V1.0B
1: iS110B V1.0A
2: iS110B V1.0C (FW version 01.02.00 or later)
The default values are as follows;
FW version 01.02.00 or later: 2
FW version less than 01.02.00: 0
wifiex get typeGets the Wi-Fi module type.

Factory Reset

The following commands may be used to restore the Spresense factory settings.
All communication settings and storage data will be reset.
Note that after factory reset, it will be necessary to start again from challenge registration.

CommandContentNote
frst <uniqueId>Performs factory reset.
For uniqueId, specify the unique ID of Spresense (which can be obtained using the u command).
After executing the command, wait until a response is returned.
It takes about 10 seconds.
frst <uniqueId> fullPerforms a complete factory reset. The storage will be completely erased.
For uniqueId, specify the unique ID of Spresense (which can be obtained using the u command).
After executing the command, wait until a response is returned.
It takes about 40 seconds.


Updated: 2022-06-24
← 02. Initial Installation04. Spresense LTE-M Initial Setup →