Getting Started with RS9116 EVK and WiSeConnect™
The fastest way get started with the RS9116 EVK and WiSeConnect™ is to use a PC with a terminal application such as Tera Term . To get started with a microcontroller instead, see Getting Started with a Microcontroller
Using AT-Commands and a Tera Term example script, your EVK will be connected to a wireless network in minutes.
There's just a few steps involved:
To get started with app development on a host MCU using the RS9116 Simple API (SAPI) , refer to Using RS9116W with STM32 .
Download WiSeConnect™
STEP 1.
Download the
WiSeConnect™ Software Driver Package
STEP 2.
Unzip the software package to the PC location of your choice.
Note! If you experience a
Path too long
error during the unzip process you should change the PC location to reduce the base path length or use 7-Zip to uncompress the software package.
Additional Software Requirements
The terminal program Tera Term is required to complete the steps in this guide. Other terminal programs can be used to control the RS9116W however the example scripts used in this guide will only work with Tera Term. Download Tera Term for PC .
Connect the EVK
STEP 1. Connect the EVK to a PC using the USB interface labeled UART as identified below. There are several USB interfaces on the RS9116 EVK however, for the purposes of basic evaluation using a PC, only the UART port is required.
NOTE! There are several version of the RS9116 EVK. Your EVK may look slightly different than the image above but the steps in this guide will remain the same.
STEP 2. If this is the first time connecting the EVK to your PC, verfy that it is properly detected by the PC. The EVK will appear to the PC as a COM port labeled USB Serial Port (COMx) . If the EVK is not properly detected you may need to download and install the FTDI Virtual COM Port (VCP) driver .
STEP 3. Configure your terminal application with the following settings:
- Configure the serial port settings to 115200 baud / 8-bit data / No parity / 1 stop bit
- Enable local echo
- Set receive and transmit new-line characters to CR+LF
Load the RS9116W Firmware
The RS9116W firmware must be loaded from flash into the device upon power-up or reset. This action is performed via the bootloader menu as described in the following steps.
STEP 1.
After power-up or reset, enter the bootloader as follows (this sequence sends the key combination
|U
).
- press and hold
Shift
- press then release
|
(the 'vertical line' or 'pipe' character)- press then release
u
- release
Shift
The console displays the bootloader menu after the characters
|UU
(highlighted in yellow) in the following example.|UU
WELCOME TO REDPINE SIGNALS BootLoader Version 1.0 1 Load Default Wireless Firmware A Load Wireless Firmware (Image No : 0-f) B Burn Wireless Firmware (Image No : 0-f) 5 Select Default Wireless Firmware (Image No : 0-f) K Check Wireless Firmware Integrity (Image No : 0-f) 7 Enable GPIO Based Bypass Mode 8 Disable GPIO Based Bypass Mode Q Update KEY Z JTAG Selection
Note! The bootloader menu does not appear automatically on boot because the device waits to perform Auto Baud Rate Detection (ABRD). The character sequence
Shift + |
followed byShift + u
initiates ABRD causing the device to enter bootloader mode. For more details on ABRD and the bootloader, see the RS9116W Programming Reference Manuals .
STEP 2.
Press
1
to load the default firmware. The console displays
Loading...
followed by
Loading Done
as shown in the following example. Note that the yellow highlighted
1
is shown twice because both Tera Term and the RS9116 bootloader echo any character typed.
|UU WELCOME TO REDPINE SIGNALS BootLoader Version 1.0 1 Load Default Wireless Firmware A Load Wireless Firmware (Image No : 0-f) B Burn Wireless Firmware (Image No : 0-f) 5 Select Default Wireless Firmware (Image No : 0-f) K Check Wireless Firmware Integrity (Image No : 0-f) 7 Enable GPIO Based Bypass Mode 8 Disable GPIO Based Bypass Mode Q Update KEY Z JTAG Selection
11
Loading... Loading Done
Note!
- The bootloader automatically loads the default firmware after 20 seconds if a selection is not made.
- If the console only displays
Loading...
withoutLoading Done
, the device may be in legacy binary mode. See, Switching between legacy binary mode and AT-command mode .- The device can be configured in 'Bootloader Bypass Mode' as described in the RS9116W Programming Reference Manuals .
STEP 3.
Query the version of the firmware by typing the command
at+rsi_fwversion?
as shown by the yellow text in the following console example.
... Loading... Loading Done
at+rsi_fwversion?
OK1610.1.2.24.0014
STEP 4.
If the reported firmware version is older than the latest version available in the
\firmware
directory of the WiSeConnect software package, we strongly suggest updating to the latest firmware. For update instructions see,
Updating the RS9116W EVK Firmware
Run Tera Term Example Scripts
The WiSeConnect™ software package includes several Tera Term example scripts that use AT-Commands to demonstrate basic RS9116W functionality. The scripts are found in the WiSeConnect™ software package in the folder
\RS9116.NB0.WC.GENR.OSI.x.x.xx\utils\scripts\teraterm_ttl_scripts
Tera Term Example Scripts
Name | Filename | Purpose |
---|---|---|
Wi-Fi Station |
station_mode.ttl
|
Demonstrates connecting to a Wi-Fi access point in station mode. |
Wi-Fi Soft AP |
ap_mode.ttl
|
Demonstrates setting up the device as a Wi-Fi Access Point and connecting to it from another mobile phone or PC |
Wi-Fi Enterprise Authentication |
wlan_eap_peap_station.ttl
|
Demonstrates connecting to a Wi-Fi access point in station mode using enterprise authenticarion |
Wi-Fi Low Power |
low_power_standby_associated_wifi_station .ttl
|
Configures the device in a low-power mode allowing the user to measure and evaluate the low-power consumption of the device |
Wi-Fi Low Power + BLE |
low_power_standby_associated_wifi_station_and_ble_advertising.ttl
|
Demonstrates WLAN Station standby associated power save functionality along with BLE advertising |
BLE Central |
ble_central.ttl
|
Demonstrates setting up the device as a BLE Central |
BLE Peripheral |
ble_preipheral.ttl
|
Demonstrates setting up the device as a BLE Peripheral |
BT SPP Master |
spp_master.ttl
|
Demonstrates setting up the device as a Bluetooth Serial Port Profile (SPP) master |
BT SPP Slave |
spp_slave.ttl
|
Demonstrates setting up the device as a Bluetooth Serial Port Profile (SPP) slave |
Firmware Update over Wi-Fi |
fw_upgrade_over_wifi.ttl
|
Demonstrates how to update firmware via Wi-Fi |
The following text describes how to run the Wi-Fi Station Mode script. For a description of each of the other scripts, refer to the RS9116W EVK User's Guide
Wi-Fi Station Mode
Before continuing, ensure the RS9116 EVK is plugged into your computer and TeraTerm is connected .
STEP 1.
Reset the RS9116 EVK, then in the Tera Term menu select
Control->Macro
.
STEP 2.
Navigate to the folder
./RS9116.NB0.WC.GENR.OSI.x.x.xx/utils/scripts/teraterm_ttl_scripts
which contains the example scripts and select the file
station_mode.ttl`
.
STEP 3. Follow the prompts provided by the script.
STEP 4. Select the Wi-Fi frequency band (0 = 2.4 GHz, 1 = 5GHz, 2 = Dual Band). Note that single band EVK's only support the 2.4GHz frequency band.
STEP 5. Enter the network name (SSID) of the Wi-Fi access point you wish to connect to.
STEP 6. Enter the password of the access point you wish to connect to.
STEP 7. After successfully joining the network, several status boxes are displayed. Take note of the IP address and port # displayed, this information will be used in the following steps**.
The following steps assume the EVK and the PC are connected to the same Wi-Fi access point ! If that is not the case, then you can alternately use a different computer and telnet application that is connected to the same network as the EVK.
STEP 8.
In the Tera Term menu, select
File->New Connection...
then enter the IP address of the EVK, select the
Telnet
service and enter the TCP port #.
STEP 9. A new Tera Term window opens with a TCP connection to the device. Commands typed in the new window appear in the UART console as shown below.