Silicon Labs Getting Started Quick start guide

Brand: Silicon Labs

Model: Getting Started

Category: Server/workstation motherboards

Type: Quick start guide

v1.1 Page 1

Getting Started with WiSeConnect®

And Connect-io-n® Firmware development

Introduction

WiSeConnect and Connect-io-on are feature-rich, low power wireless modules

suitable for embedded applications. In addition to wireless connectivity over

Wi-Fi, Bluetooth, Bluetooth Low Energy, and ZigBee, these modules implement a

full TCP/IP stack and provide application level protocols such HTTP, Websockets,

TCP, and more.

The purpose of this document is to quickly get you started with building and

running code on Spansion MCU as well as to provide references to important

documentation.

Prerequisites

It is assumed that you are developing on a Spansion MCU using CooCox CoIDE. If

this is not the case, consult the WiSeConnect SAPI Porting Guide

(9)

to port the APIs

and examples to your choice of MCU. Contact Silicon Labs if you require projects

for Renesas Studio, IAR or Keil and HAL ports for Renesas RX, STM32 and LPC

MCUs.

The Silicon Labs APIs and examples can be used with or without RTOS. The Silicon

Labs APIs use OS abstraction layer to enable support for any RTOS. Out of box,

Silicon Labs APIs support FreeRTOS. Other RTOS may be supported by modifying the

RTOS abstraction layer.

Software

1. CooCox CoIDE 1.7.8 (Version 2.0 has compatibility issues)

2. Iperf2 (Iperf3 is not compatible)

3. WiSeConnect Software Package

(3)

Getting Started

The WiSeConnect Software Package provides many example applications to help you

get started. This section will walk through a selection of these examples to

familiarize them with the API and development environment.

1. Navigate to

RS9113.NBZ.WC.GEN.OSI.X.Y.Z/host/sapis/platforms/spansion_MB9BF

568NBGL

2. Navigate to no_os/ to develop without an operating system or freeRTOS/ to

develop using freeRTOS. For this tutorial, it is recommended to use no_os/.

3. Double click on Spansion.coproj to open the project in CoIDE.

All examples from this point onwards will require modifying this project. The first

example, rsi_tcp_client.c is already included in the project.

v1.1 Page 2

Getting Started with WiSeConnect®

And Connect-io-n® Firmware development

Figure 1 Erase, Build and Flash the Project

TCP Client Example

The first example will demonstrate WiSeConnect’s TCP functionality. The Device

will connect to a specified server and port. Then, it will send the message “Hello

from TCP client!!!” repeatedly to the destination.

The TCP Client app has its own documentation which is located in the same

directory as rsi_tcp_client.c. Navigate to /host/sapis/examples/tcp_client/ and

open rsi_tcp_client.pdf.

Follow the instructions in rsi_tcp_client.pdf to get this example working. The

instructions, in brief, are:

1. Run iperf as a listening tcp server on port 5001.

2. In rsi_tcp_client.c, modify SSID, SECURITY_TYPE, and PSK to match your

access point credentials.

3. Modify DEVICE_IP to match your PC’s IP Address. (Address 10.11.12.255

would be 0xFF0C0B0A)

4. Modify rsi_wlan_config.h macros to match the table in pages 7-8. This

should be correct by default.

5. Compile and flash the project to your device (Figure 1).

Access Point Example

The WiSeConnect device can be configured to act as an access point that other Wi-Fi

devices can connect to.

1. To get started on this example, navigate to

host/sapis/examples/wlan/access_point and open rsi_ap_start_app.pdf. In

addition, drag and drop the file rsi_ap_start.c into the CoIDE project examples

directory.

v1.1 Page 3

Getting Started with WiSeConnect®

And Connect-io-n® Firmware development

Figure 2 Importing Access Point Project

2. Right click on rsi_tcp_client.c in the CoIDE project and click Delete. This will

remove the file from the project, but the file will still be available in

/sapis/examples/wlan/tcp_client.

3. Follow the instructions in rsi_ap_start.c, then build and flash the project.

4. The SSID (default “REDPINE_AP” should appear in your PC’s Wi-Fi connections.

Connect to it using the password (default “12345678”).

5. Once connected, you can ping your device on its IP address (default

192.168.10.1) to verify that your PC can communicate with it.

And that’s it!

What’s Next

You should now be familiar with the basics of WiSeConnect firmware

development. You can continue to try out other examples. The procedure will

be similar to the above tutorials.

To learn more about the WiSeConnect API, consult the WiSeConnect PRM located

in RS9113.NBZ.WC.GEN.OSI.X.Y.Z/hosts/sapis/docs.

v1.1 Page 4

Getting Started with WiSeConnect®

And Connect-io-n® Firmware development

References

Documentation, Software Packages, and more are available on Redpine’s document

portal. Contact Silicon Labs Sales office to obtain the NDA and instructions to

A subset of online documents is included in the USB Thumb drive included in the EVK

package. Please use silabs.com as the latest and authoritative source for all

information.

References

Name

Location on USB Thumb drive

silabs.com

RS9113 EVK User Guide

RS9113 Combo Modules/EVK Board

WiSeConnect Getting

Started Guide

RS9113 Combo Modules/EVK Board

WiSeConnect Software

Package including

examples

/RS9113.NBZ.WC.GEN.OSI.X.Y.Z

RS9113 Combo

Modules/WiSeConnect_Connect-io-

n/Software/

n-Link Software Package

Located in boot image

“/home/OneBox-

Mobile/RS9113.NBZ.NL.GENR.LNX.

X.Y.Z”

RS9113 Combo Modules/n-

link/Software

WiSeConnect

Programmer’s Reference

Manual

/RS9113.NBZ.WC.GEN.OSI.X.Y.Z/

docs

Included in the WiSeConnect

Sofware Package

WiSeConnect SAPI

Guide

/RS9113.NBZ.WC.GEN.OSI.X.Y.Z/

host/sapis/docs

Included in the WiSeConnect

Software Package

n-Link Technical

Reference Manual

N/A

Included in the n-Link Software

Package (Documents/)

RS9113 Module Family

Datasheet

N/A

RS9113 Combo Modules/ Datasheet

WiSeConnect SAPI

Porting Guide

/RS9113.NBZ.WC.GEN.OSI.X.Y.Z/

host/sapis/docs

In the WiSeConnect Software

Package

Module Integration

Guide, Regulatory

Certificates, 3D Models,

PCB Footprints, IBIS

Models etc.

N/A

Various sub-folders under “RS9113

Combo Modules”

Application Notes

N/A

Application notes

Smart.

Connected.

Energy-Friendly.

Products

www.silabs.com/products

Quality

www.silabs.com/quality

Support and Community

community.silabs.com

http://www.silabs.com

Silicon Laboratories Inc.

400 West Cesar Chavez

Austin, TX 78701

USA

Disclaimer

Silicon Labs intends to provide customers with the latest, accurate, and in-depth documentation of all peripherals and modules available for system and software implementers using or

intending to use the Silicon Labs products. Characterization data, available modules and peripherals, memory sizes and memory addresses refer to each specific device, and "Typical"

parameters provided can and do vary in different applications. Application examples described herein are for illustrative purposes only. Silicon Labs reserves the right to make changes without

further notice to the product information, specifications, and descriptions herein, and does not give warranties as to the accuracy or completeness of the included information. Without prior

notification, Silicon Labs may update product firmware during the manufacturing process for security or reliability reasons. Such changes will not alter the specifications or the performance

of the product. Silicon Labs shall have no liability for the consequences of use of the information supplied in this document. This document does not imply or expressly grant any license

to design or fabricate any integrated circuits. The products are not designed or authorized to be used within any FDA Class III devices, applications for which FDA premarket approval is

required, or Life Support Systems without the specific written consent of Silicon Labs. A "Life Support System" is any product or system intended to support or sustain life and/or health,

which, if it fails, can be reasonably expected to result in significant personal injury or death. Silicon Labs products are not designed or authorized for military applications. Silicon Labs

products shall under no circumstances be used in weapons of mass destruction including (but not limited to) nuclear, biological or chemical weapons, or missiles capable of delivering

such weapons. Silicon Labs disclaims all express and implied warranties and shall not be responsible or liable for any injuries or damages related to use of a Silicon Labs product in such

unauthorized applications.

Trademark Information

Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® and the Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, ClockBuilder®, CMEMS®, DSPLL®, EFM®, EFM32®,

EFR, Ember®, Energy Micro, Energy Micro logo and combinations thereof, "the world’s most energy friendly microcontrollers", Ember®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®,

Gecko OS, Gecko OS Studio, ISOmodem®, Precision32®, ProSLIC®, Simplicity Studio®, SiPHY®, Telegesis, the Telegesis Logo®, USBXpress® , Zentri, the Zentri logo and Zentri DMS, Z-

Wave®, and others are trademarks or registered trademarks of Silicon Labs. ARM, CORTEX, Cortex-M3 and THUMB are trademarks or registered trademarks of ARM Holdings. Keil is a

registered trademark of ARM Limited. Wi-Fi is a registered trademark of the Wi-Fi Alliance. All other products or brand names mentioned herein are trademarks of their respective holders.