The TI Wi-SUN® software overview describes the overall Wi-SUN® FAN software content and supporting ecosystem from Texas Instruments based on the TI Wi-SUN® FAN 1.0 implementation. The document provides a high level overview of the features and capabilities of the Wi-SUN® FAN software without specific details. For further information on APIs and implementation details, see the Wi-SUN® Developers Guide and the SIMPLELINK-LOWPOWER-F2-SDK.
LaunchPad™, and SimpleLink™Code Composer Studio are trademarks of Texas Instruments.
Wi-SUN® is a registered trademark of Wi-SUN Alliance.
Microsoft® and Windows® are registered trademarks of Microsoft Corporation.
Linux® is a registered trademark of Linus Torvalds.
macOS® is a registered trademark of Apple Inc..
All trademarks are the property of their respective owners.
This product overview uses the following acronyms:
Wi-SUN® is a standards-based mesh network with frequency hopping. The Wi-SUN® Alliance (wi-sun.org) has more than 300 members from 46 countries, with 100M+ devices deployed world-wide. Wi-SUN® supports IPv6 protocol suite and standards based multilayer security. The standard supports multiple data rates and frequency bands to meet different regulatory requirements world-wide. Applications include smart grid and smart city applications, with certified products enabling multi-vendor interoperability.
TI's Wi-SUN® FAN 1.0 is based on the open source IETF RFC components integrated on top of the Wi-SUN® compliant TI 15.4 Stack. A Network Interface is provided either as the TI Wi-SUN FAN Spinel Client Interface or the TI wfantund Linux network interface. Customers typically develop applications on top of IPv6 using UDP as the transport layer.
TI's Wi-SUN® FAN v1.0.0 design is optimized for a small memory footprint to fit embedded devices, in addition to optimizations for low-power operation. Integration and testing of the software stack is done in tagged, certified releases.
| Component | Version |
|---|---|
| TI Wi-SUN® FAN | 1.0 |
| Distribution | Included in SDK8.30 for CC13x2 and CC13x4 devices as library code |
| IDE support | CCS v 12.8 or CCS 1.5 for Microsoft® Windows® 10, Linux®, and macOS® |
| Compiler support | TI Clang 3.2.2 LTS |
| RTOS support | TI-RTOS, Free RTOS |
| Supported devices | Border router: CC1312R7, CC1352P7, CC1314R10, CC1354R10, CC1354P10 Router nodes: CC1312R, CC1312PSIP, CC1352R, CC1352P, CC1312R7, CC1352P7, CC1314R10, CC1354R10, CC1354P10 |
| Recommended development kits | Border router: Personal Computer (PC) host + CC1352P7 LaunchPad™ Development Kit or CC1354P10 LaunchPad™ Router nodes: CC1352P LaunchPad™ or CC1354P10 LaunchPad™ |
TI has certified multiple FAN profiles with the Wi-SUN® Alliance to be used on CC13x2x as well as CC13x4x10 devices. Not every devices support all of the FAN profiles due to constraints of the internal memory of the device. Table 2 lists the Wi-SUN® FAN profiles with the corresponding certificate and the certificate for the PHYs that can be used with the respective device.
| Wi-SUN® Certificate | FAN profile | Corresponding PHYs |
|---|---|---|
| WSA0272 | FAN profile (router) for CC13x2R or CC13x2P | WSA0260 WSA0262 (800MHz) |
| WSA0273 | FAN profile (router) for CC13x2R7 or CC13x2P7 | WSA0261 WSA0263 (800MHz) |
| WSA0278 | FAN profile (border router) for CC13x2R7 or CC13x2P7 | WSA0261 WSA0263 (800MHz) |
| WSA0313 | FAN profile (router) for CC13x4R10 or CC13x4P10 | WSA0311 WSA0312 |
| WSA0314 | FAN profile (border router) for CC13x4R10 or CC13x4P10 | WSA0311 WSA0312 |
The SimpleLink™ SDK incorporates a number of examples for the different roles in a Wi-SUN® FAN. Not every role and example is available for every device. This is due to the memory requirements of some roles. Lower memory devices are therefore not be able to be used as a border router role. A list of examples with the corresponding capable devices is listed in Table 3 and Table 4.
| Application | Usage |
|---|---|
|
ti-wisunfan-pyspinel |
Python interface module to control a NWP from a Linux or Microsoft® Windows® 10 PC. Public on TI GitHub |
|
ti-wisunfantund |
Linux network interface to control a NWP from Linux as a network interface. Public on TI GitHub |
| ns_br ns_br_src* |
Border router in NWP configuration controlled over UART with TI-defined API (based on SPINEL interface layer). |
| ns_node ns_node_src* |
Router node in NWP configuration controlled over UART with TI defined API (based on SPINEL interface layer). |
| ns_coap_node ns_coap_node_src* |
Embedded router node example with CoAP server. |
|
ns_coap_oad_offchip ns_coap_oad_offchip_src* |
Embedded router node example with off-chip Over-the-Air-Download capability and CoAP server. |
|
ns_coap_oad_onchip ns_coap_oad_onchip_src* |
Embedded router node example with on-chip Over-the-Air-Download capability and CoAP server. |
| *the src examples include the nanostack source code |
| SDK examples |
Occupied FLASH [kB] |
Occupied RAM[kB] |
Supported Devices |
|---|---|---|---|
| ns_br |
367 |
122 |
CC1312R7, CC1352P7, CC1352R7, CC1354P10, CC1354R10 |
|
ns_node |
310 |
64 |
CC1312R, CC1312PSIP, CC1352R, CC1352P, CC1352P7, CC1352R7, CC1354P10, CC1354R10 |
| ns_coap_node, ns_coap_oad_offchip |
310 |
60 |
CC1312R7, CC1352P7, CC1352R7, CC1354P10, CC1354R10 |
|
ns_coap_oad_onchip |
310 |
61 |
CC1354P10, CC1354R10 |
For on-chip OAD the FLASH is split into 2 application slots each of 344kB.
The memory footprint is based on using the TIRTOS7 and TICLANG compiler. It is possible that the footprint varies when using FreeRTOS or another compiler. See summary of memory sizes of each device in the wireless MCU overview on TI.com
Wi-SUN® supports a number of frequencies and data rates to enable world-wide coverage and address different application needs. Major frequency bands used are 902 to 928 MHz for North America, 863MHz to 876MHz for Europe and 920MHz to 928MHz for Japan. Further details and information about frequency plan and channels is available to Wi-SUN® alliance members.
| Symbol Rate (ksymbol/s) |
Modulation Index | Wi-SUN® Mode | Frequency Bands | Regulatory Compliance Targets |
|---|---|---|---|---|
| 50 | 0.5 | #1a | EU | EN300 220 |
| 1.0 | #1b | NA, BZ, JP |
FCC 15.247 | |
| 100 | 0.5 | #2a | EU | EN300 220 FCC 15.247 |
| 1.0 | #2b | NA, BZ, JP | ARIB STD-108 | |
| 150 | 0.5 | #3 | EU, NA, BZ, JP | FCC 15.247 ARIB STD-T108 |
| 200 | 0.5 | #4a | NA, BZ |
FCC15.247 |
| 1.0 | #4b | JP | ARIB STD-T108 | |
| 300 | 0.5 | #5 | NA, BZ, JP | FCC15.247 ARIB STD-T108 |