User Manual WISE-1510 M2.
Copyright The documentation and the software included with this product are copyrighted 2016 by Advantech Co., Ltd. All rights are reserved. Advantech Co., Ltd. reserves the right to make improvements in the products described in this manual at any time without notice. No part of this manual may be reproduced, copied, translated or transmitted in any form or by any means without the prior written permission of Advantech Co., Ltd. Information provided in this manual is intended to be accurate and reliable.
shippable container. A product returned without proof of the purchase date is not eligible for warranty service. 5. Write the RMA number visibly on the outside of the package and ship it prepaid to your dealer. Declaration of Conformity FCC Class B Note: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation.
USERS MANUAL OF THE END PRODUCT: In the users manual of the end product, the end user has to be informed to keep at least 20cm separation with the antenna while this end product is installed and operated. The end user has to be informed that the FCC radio-frequency exposure guidelines for an uncontrolled environment can be satisfied. The end user has to also be informed that any changes or modifications not expressly approved by the manufacturer could void the user's authority to operate this equipment.
brouillage, et (2) l'utilisateur de l'appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est susceptible d'en compromettre le fonctionnement. This radio transmitter (9404A-WISE1510) has been approved by Industry Canada to operate with the antenna types listed below with the maximum permissible gain indicated. Antenna types not included in this list, having a gain greater than the maximum gain indicated for that type, are strictly prohibited for use with this device.
the manufacturer could void the user's authority to operate this equipment. Operation is subject to the following two conditions: (1) this device may not cause harmful interference and (2) this device must accept any interference received, including interference that may cause undesired operation. LABEL OF THE END PRODUCT: The final end product must be labeled in a visible area with the following " Contains IC: 9404A-WISE1510 ".
Packing List Before setting up the system, check that the items listed below are included and in good condition. If any item does not accord with the table, please contact your dealer immediately. 1 WISE-1510 1 Screw for WISE-1510 1 China RoHs Notice Optional Accessories Part No. Description 1750008598-01 Sub G antenna Dipole L=195mm, 1dBi 902~928 MHz 1750008599-01 Sub G antenna Dipole L=195mm, 1dBi 863~870 MHz 1750008569-01 Antenna Cable SMA to MHF4 L=300mm 1700015038 FPC Cable 10P-0.
WISE-1510 User Manual 7
Safety Instructions 1. Read these safety instructions carefully. 2. Keep this User Manual for later reference. 3. Disconnect this equipment from any AC outlet before cleaning. Use a damp cloth. Do not use liquid or spray detergents for cleaning. 4. For plug-in equipment, the power outlet socket must be located near the equipment and must be easily accessible. 5. Keep this equipment away from humidity. 6. Put this equipment on a reliable surface during installation.
Change Log: Date Version Description / Major change 2017/01/05 V0.1 Draft version 2017/02/03 V0.2 Modify chapter 3.2 & 3.3 and add Figure. 10 2017/02/13 V0.3 Update optional accessory with Sub G antenna Chapter 5 is added for the instruction to enable LoRaWAN 2017/03/14 V0.4 Modify chapter 3.5~3.7 and 4. 2017/04/10 V0.5 Add chapter 3.5 Memory Layout and update 3.6~3.7 2017/04/12 V0.6 Remove Chapter 1.3, update page 2~3 Declaration of Conformity, Chapter 3.
Table of Content 1. PRODUCT OVERVIEW ............................................................................................. 11 1.1. INTRODUCTION ..................................................................................................... 11 1.2. SPECIFICATIONS ..................................................................................................... 12 2. H/W INSTALLATION ................................................................................................ 13 2.1.
1. Product Overview 1.1. Introduction WISE-1510 is a wireless module integrated with ARM Cortex-M4 Processor and LoRa / LoRaWAN connectivity. This technology is the best solution for Low-Power Wide-Area Network (LPWAN) Applications. LoRaWAN is defined to optimize the power consumption and wide range. Your sensors or applications with low data rate requirement can be achieved years battery lifetime and kilometers long distance connection.
1.2. Specifications ARM Cortex-M4 Core Processor 80MHz Processor System MCU Memory RAM 64KB Flash 256KB STM – STM32L443RC Form Factor M2.COM Type A 2230 Spec. Standard M2 COM Technical SPEC_v1.
Physical Dimensions Characteristics (WxD) 22 x 30 mm mbed 5.2 OS * Note: Frequency Band can be configurable for Japan or Korea by request. 2. H/W Installation 2.1. Board Connector M2.COM Type A Module Module size: 22 mm x 30 mm PCB thickness: 0.8 mm ± 10% Pin count: 75 pins Module input voltage: 3.3V DC-in Connector mating force: 30N Maximum Connector current rating: 0.
Figure 2 Card Edge Outline-Topside Figure 3 Card Edge Outline-Backside Reference from PCI Express M.2 Specification Rev 1.0 (Nov 1, 2013) Section 2.3.
2.2. Module Outline The mechanical dimension information of M2.COM form factor follows the Type A 2230 module size: 22 x 30 mm. Both module types use a 75-position host interface connector and have room to support up to four RF connectors in the upper section. Figure 4 Type A 2230 2.3. Connector Specifications 2.3.1. Top Side Connector Physical Dimensions The top-side scheme has two connectors that share a common footprint but have different stack-up requirements.
Figure 5 Top Side Connector Physical Dimensions Reference from PCI Express M.2 Specification, Revision 1.0, November 1, 2013 2.3.2. Carrier Board Connection Length The carrier board connector of M2.COM follows the Type 2230 M.2 module connector: The additional increase in length is 7.05mm maximum for top-side connector to the module length. The retention screw adds 2.75 mm maximum. The maximum extension, including land pattern, beyond the module leading edge is 4.3 mm. M2.
Figure 6 Carrier Board Connection Length Reference from PCI Express M.2 Specification, Revision 1.0, November 1, 2013 2.3.3. Carrier Board Connector Height The dimensions of M2.COM form factor follow the Type A 2230 -D3 M.2 module size. Hence, the carrier board connectors must choose H3.2-D3 or H4.2-D5 connector as in the following diagrams. Figure 7 H3.2-D3 Reference from PCI Express M.2 Specification, Revision 1.
2.4. WISE-1510 Pin-Out Map PIN M2.COM Signal name STM32L443RCI6 MCU Pin Name M2.COM Signal name PIN 1 GND GND 3.3V VCC 2 3 USB_DP PA12 3.3V VCC 4 5 USB_DM PA11 N.C. 6 7 GND GND N.C. 8 9 N.C. N.C. 10 11 N.C. N.C. 12 13 N.C. N.C. 14 15 N.C. PC6 17 N.C. GND GND 18 19 N.C. PC9 CB_PWR_ON 20 21 N.C. PC4 UART TX (O) 22 23 N.C.
69 GND GND PB9 SPI_CS1# 70 71 RESET_IN# NRST 3.3V VCC 72 73 Wake# PC3 3.3V VCC 74 75 GND GND Figure 8 M.2 Connector 2.5. Quick Starter of WISE-1510 2.5.1. Debug Port Connection 1. Connect debug port FPC cable to WISE-1510 debug port (CN1; on the back of PCB) 2. Connect WISE-ED20 debug board to the FPC debug cable. 3. Connect USB-to-microUSB cable from WISE-ED20 to the USB port on your PC.
2.5.2. Debug Port Setting WISE-1510 can communicate with a host server (Windows or Linux) by using serial cables. Common serial communication programs such as Hyper Terminal, Tera Term or PuTTY can be used in this case. The example below describes the serial terminal setup using Hyper Terminal on a Windows host: 1. Connect WISE-ED20 with your Windows PC by using a serial cable. 2. Open Hyper Terminal on your Windows PC, and select the settings as shown in Figure 9. 3.
Figure 9 Hyper Terminal Settings for Terminal Setup Figure 10 Image version is shown on terminal WISE-1510 User Manual 21
3. Development Environment Setup 3.1. Overview ARM mbed is used for you to create applications running on WISE-1510. Your application code is written in C++. It uses the application programming interfaces (APIs) that mbed OS provides. These APIs allow your code to work on different microcontrollers in a uniform way. This reduces a lot of the challenges in getting started with microcontrollers and integrating large amounts of software.
Git - version 1.9.5 or later ( https://git-scm.com/ ). Mercurial - version 2.2.2 or later ( https://www.mercurial-scm.org/ ). If you don’t want to use repositories, you can just skip it. 3. Install gcc mbed CLI invokes the mbed OS 5 tools for various features, such as compiling, testing and exporting to industry standard toolchains. To compile your code, you will need either a compiler or an IDE: Compilers: GCC ARM, ARM Compiler 5, IAR. IDE: Keil uVision, DS-5, IAR Workbench.
Next, you can select the tool chain and target platform which mbed CLI uses to build applications. Change directory to target mbed program. $ mbed config target NUCLEO_L443RC [mbed] NUCLEO_L443RC now set as default target in program "xxxxx" $ mbed config toolchain GCC_ARM [mbed] GCC_ARM now set as default toolchain in program "xxxx" You can see the active mbed CLI configuration via: $ mbed config --list [mbed] Global config: GCC_ARM_PATH =C:\Program Files\GCC_ARM [mbed] Local config (xxxx): TOOLCHAIN=GCC_AR
| hal | 802 | 0| 8| | platform | 1782 | 4 | 297 | | rtos | 910 | 4| 4| | rtos/rtx | 7369 | 20 | 6870 | | targets/TARGET_STM | 19944 | 4 | 1719 | | Subtotals | 138938 | 7856 | 14180 | +--------------------+--------+-------+-------+ Allocated Heap: unknown Allocated Stack: unknown Total Static RAM memory (data + bss): 22036 bytes Total RAM memory (data + bss + heap + stack): 22036 bytes Total Flash memory (text + data + misc): 146794 bytes Image: ./BUILD/NUCLEO_L443RC/GCC_ARM/xxxxx.
WISE-1510 User Manual 26
3.6. Partitioning The content of flash is portioned by boot loader as below: Boot Loader occupies the first 16 kilo-bytes starting at 0x8000000. LoRa Config partition is used to store LoRa parameters, which occupies no more than 4 kilo-bytes. All user own parameters should be written into User Config partition, for which another 4 kilo-bytes are reserved. Application (Runtime image) partition is where users’ application is stored, up to 224 kilo-bytes can be used.
3.7. Flashing Application (Runtime Image) To flash runtime image, your terminal program needs to support “Y-Modem”. Tera Term is used for demonstration here. Step 1: UART port connect via debug board Connect USB-to-microUSB cable from WISE-ED20 to the USB port on your Windows PC. (Red frame is reset button.) Open the corresponding COM port in serial program, ex: Tera Term. Set baud rate to 115200.
Step 2: Runtime image upgrade mode Press ‘u’ on the PC keyboard and press reset button on ED-20 debug board. The terminal will show messages as below. Press "1" to “Download image to the internal Flash”.
Step 3: Start upgrading via Y modem Select the run-time image ".bin" file via Y-Modem. Waiting for run-time image transmission is complete.
After downloading completed, the terminal will show as below. Step 4: Reset device Press reset button on ED-20 debug board to reset device.
3.8. Testing Now, you’re ready to test your WISE-1510. The sample application we created is to send sensor data every 5 seconds via LoRa if values are changed. To observe it, you can connect the debug port as described earlier.
4. Application Development Node APIs were provided to assist user develop applications. There are 2 UART interfaces in WISE-1510. “debug_serial” is used for user development and debug. User can see debug information of sample code via debug_serial. “m2_serial” is the UART interface of M2.com. 4.1. Node API Following show the architecture of the layer of LoRa Node and user application. User can send request to LoRa node via API and got response.
nodeApiGetDevEui nodeApiGetAppEui nodeApiGetAppKey nodeApiGetDevAddr nodeApiGetNwkSKey nodeApiGetAppSKey nodeApiGetDevActMode nodeApiGetDevOpMode nodeApiGetDevAdvwiseFreq nodeApiGetDevAdvwiseDataRate nodeApiGetDevAdvwiseTxPwr nodeApiSetDevEui nodeApiSetAppEui nodeApiSetAppKey nodeApiSetDevAddr nodeApiSetNwkSKey nodeApiSetAppSKey nodeApiSetDevActMode nodeApiSetDevOpMode nodeApiSetDevAdvwiseFreq nodeApiSetDevAdvwiseDataRate nodeApiSetDevAdvwiseTxPwr nodeApiSaveCfg nodeApiLoadCfg nodeApiApplyCfg nodeApiFactory
nodeApiSetDevSleepRTCWakeup The detailed description of APIs can be found in /docs/html/index.html in the released SDK. 4.2. Sample Code for API If WISE-1510 was plugged in M2.com carrier board (WISE-DB1500), do below action to enable M2.com carrier board. Set boud rate of debug_serial and m2_serial. Create sensor thread. Set and apply node configuration. Start LoRa. Start LoRa State loop to start rx/tx data.
2 API were used to notify user application that LoRa finished transmit or receive action. What you should do is Register callback function in the beginning. Make sure node successfully joined LoRa gateway. Then, start to run the state machine. If no data need to send, enter deep sleep mode and wait for waking up NODE_ACTIVE_PERIOD_IN_SEC seconds. This example send sensor (Temperature, Humidity) data periodically, user should modify node_get_sensor_data() to implement read sensor data.
The detailed description of Sample code can be found in /docs/html/index.html in the released SDK.
Appendix I: Node Setup Parameters In the sample application, there is a function node_set_config() as below: This function is used to configure all parameters of nodes. Let’s go through them briefly. 1. Device EUI (DevEUI) is read from eFuse, and set without any change. 2. Two application dependent parameters, application EUI (AppEUI) and application key (APPKey), are set respectively (line 218 and 219). 3.
operating mode (DevOpMode): 1 for Harmony Link* and 2 for LoRaWAN. Here, Harmony Link is selected as the default. (line 225) If you’d like to use LoRaWAN, change it from 1 to 2. * Harmony Link is Advantech’s proprietary LoRa MAC. 7. You can select which class of Node: 1 for Class A, and 3 for Class C. (2 for Class B is reserved for future use.) Here, Class C is selected (line 226). 8.
Appendix II: Sensor Data Format In the sample application, node_get_sensor_data() encodes sensor data according to the following format: ,where Length: Total TLV length MsgType: Fixed as 0xc Multiple TLVs are one or more Tag-Length-Values: tag matches with gateway’s setting, length is sensor data length, and value is sensor data. All octets are in hexadecimal. For example, LoRa Payload Field setting on WISE-3610 is as below: If temperature is 25.
