WSL05-A0_User_Manual WSL05-A0 User Manual Version 1.2.0 Date: 2021-04 Shenzhen Friendcom Technology Co., Ltd.
WSL05-A0_User_Manual Additional testing, Part 15 Subpart B disclaimer 1. This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference. (2) This device must accept any interference received, including interference that may cause undesired operation. 2. Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
WSL05-A0_User_Manual NOTICE Information in this document has been carefully reviewed and is considered to be accurate. However, Friendcom assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein.
WSL05-A0_User_Manual Friendcom_WSL05-A0_LoRaWAN_Module_Datasheet Friendcom_WSL05-A0_AT_Commands_Manual Conventions Symbol Indication This warning symbol means danger. You are in a situation that could cause fatal device damage or even bodily damage. Means reader be careful. In this situation, you might perform an action that could result in module or product damages. Means note or tips for readers to use the module.
WSL05-A0_User_Manual History Issue 1.0 1.1 1.
WSL05-A0_User_Manual Content About This Document..................................................................................................................................................... 3 Table Index...................................................................................................................................................................... 7 Figure Index.......................................................................................................................
WSL05-A0_User_Manual 5.3 Activation Method......................................................................................................................................... 35 5.3.1 OTAA Mode......................................................................................................................................... 35 5.3.2 ABP Mode........................................................................................................................................... 36 5.
WSL05-A0_User_Manual Table 5- 1 Table 5- 2 Table 6- 1 Table 6- 2 Table 6- 3 UART interface of WSL05-A0..................................................................................................25 SPI interface of WSL05-A0..................................................................................................... 27 DIOx configuration function table..........................................................................................41 DIO PIN mapping table...............................
WSL05-A0_User_Manual Figure Index Figure 2- 1 Figure 3- 1 Figure 5- 1 Figure 5- 2 Figure 5- 3 Figure 5- 4 Figure 5- 5 Figure 5- 6 Figure 5- 7 Figure 5- 8 Figure 5- 9 Figure 7- 1 Figure 7- 2 Figure 7- 3 Figure 8- 1 Figure 8- 2 Figure 8- 3 Figure 8- 4 Figure 8- 5 WSL05-A0 module block diagram........................................................................................ 12 Pin assignment (Top View).....................................................................................................
WSL05-A0_User_Manual 1 Introduction This document describes the air interface, hardware interfaces and technical parameters which are related to customers’ applications, and it can help customers quickly understand the interface definitions, electrical and mechanical details, as well as other information of WSL05-A0 module. This manual together with AT command user manual guides customers to integrate this module in various LPWAN applications easily. 1.
WSL05-A0_User_Manual 2 Product Concept 2.1 General Description WSL05-A0 module is a low-power, high-performance LoRaWAN module, which integrates LoRaWANTM protocol stack internally and complies with LoRaWANTM Specification 1.0.2 Class A \ C application standard. WSL05-A0 module uses serial interface (UART or SPI) to exchange data with user devices.
WSL05-A0_User_Manual 1.1 Simplified Block Diagram WSL05-A0 module (hereinafter referred to as the module) integrates the LoRaWANTM protocol stack and uses a serial interface (UART or SPI) to perform data and command interaction with the user host device, which can provide users with LoRaWAN network access and wireless data services quickly and easily. The functional block diagram of the module is shown as follows. Figure 2- 1 WSL05-A0 module block diagram 1.
WSL05-A0_User_Manual V1.0.2, Class A \ C. Multi-band supported:US915, AU915. User-friendly interface: UART, SPI, I2C, GPIOs, ADC. Support AT command mode and transparent transmission mode. Multiple sleep management modes, support UART interface wake-up mode. Support battery power detection and optional automatic power reporting. UART firmware upgrade or FOTA.
WSL05-A0_User_Manual 1.4 List of Applicable FCC Rules FCC Part 15 Subpart C 15.245 &15.207 &15.209. 1.5 The Specific Operational Use Conditions The module is a with communication functions. Operation frequency: 902-928MHZ Number of channel:72 Modulation:LORAWAN The module can be used for mobile or portable applications.
WSL05-A0_User_Manual The WSL05-A0 module(A1 area) is welded with an SMA base, and there is an SMA female on the base. Connect the SMA female connector of the base to the SMA male connector of the antenna. Welded with module SMA male SMA female The SMA base The Antenna The insulating layer of the outer skin is rubber, and the inside of it is a ring-shaped inductive antenna, and the end connector of the antenna is SMA male. And the inside structure of the antenna as follows. 4 1.
WSL05-A0_User_Manual 1.9 Label and Compliance Information The label meets FCC certification requirements, including product model, product name, FCC ID and other content. 1.
WSL05-A0_User_Manual Figure 3- 1 Pin assignment (Top View) 2.2 Pin Description The following tables show the pin definition and description of WSL05-A0. Table 3- 1 Pin Reuse Function Name WSL05-A0 pin description Pull-up Resistor Description 1 GND - - 2 TOOL - Yes 3 RESET - - Reset pin, active low 4 GND - - Ground 5 VCC - - 6 DIO0 SPI_ATTN/ANI0 No 7 DIO1 SPI_BUSY/ANI1 No Page Ground Program simulation and programming port Power supply for the module, range 2.2V to 3.
WSL05-A0_User_Manual 8 DIO2 SPI_CS(M) Yes DIO3 SPI_MISO(M) Yes SPI_MOSI(S) DIO4 SPI_MOSI(M) Pay special attention: Used as SPI_MISO in master mode Used as SPI_MOSI in slave mode General-purpose I/O, SPI interface data output, SO 10 mode General-purpose I/O, SPI interface data input, SI 9 General-purpose I/O, CS pin in SPI master Yes SPI_MISO(S) Pay special attention: Used as SPI_MOSI in master mode Used as SPI_MISO in slave mode 11 DIO5 SPI_SCK Yes 12 RESV - - Reserved 13 VCC -
WSL05-A0_User_Manual 3 Technical Specifications 3.1 Absolute Maximum Ratings As stated that the values listed below may cause permanent device failure. Exposure to absolute maximum ratings for extended periods may affect device reliability. Table 4- 1 Absolute maximum ratings of WSL05-A0 Items Symbol Description Min. Typ Max. Unit -0.3 - 3.9 V Input voltage of GPIO port -0.3 - 3.9 V -55 +115 ℃ 2.
WSL05-A0_User_Manual BW=125K, SF=7 Frequency Fs Characteristics Output - 5.4 - Kbps 20dBm - 19.7 - dBm 17dBm - 16.9 - dBm 14dBm - 13.8 - dBm 10dBm - 10.4 - dBm Temperature range:-40~85°C - 15 30 ppm - 50 - Ω Ro Impedance 3.3 Power Characteristics Table 4- 3 Power characteristics of WSL05-A0 Items Supply Voltage Symbol Condition VCC Min. Typ Max. Unit 2.2 3.3 3.7 V - 0.65 - mA - 4.6 - mA - 1.5 3.
WSL05-A0_User_Manual 3.4 GPIO Characteristics Table 4- 4 GPIO characteristics of WLS05-A0 Items Symbol High-level Output Voltage VOH Low-level Output Voltage VOL High-level Input Voltage Low-level Input Voltage High-level Output Current Low-level Output Current Pull-up Resistor Min. Typ Max. Unit VCC=3.3V,IOH=-1.0mA VCC0.5 - - V VCC=3.3V,IOL=1.0mA - - 0.2 V VIH 0.8 x VCC - VCC V VIL 0 - 0.
WSL05-A0_User_Manual SPI Interface Clock Rate SPIclk - - - 1.0 MHz 3.6 General Specifications Table 4- 6 General specifications of WSL05-A0 Items Symbol Condition Min. Typ Max. Unit Storage Temperature Tstg Storage temperature range -40 - 125 °C Top Working temperature range -40 - 85 °C 5 - 95 % Operating Temperature Operating Humidity Dimension RHop Operating humidity range - 22(L)X14(W)X3.
WSL05-A0_User_Manual Peripherals interface RF interface 4.1 Power Supply Power supply design consists two parts: circuit design and PCB layout. 1) Circuit design: The design and layout of the power circuit is a very important part of the overall product design, and it affects the performance of the entire product. It is recommended that the external power supply should be an LDO power supply or directly connected to the battery. In order to reduce noise, in the PCB layout, connect 1.
WSL05-A0_User_Manual It is recommended to thicken the traces of VCC and GND as much as possible to ensure that the module has sufficient current loop. 4.2 Control Interface WSL05-A0 provides RESET pin and TOOL pin as a control interface. Program programming or simulation need to connect VCC, GND, TOOL and RESET pins, users who requires secondary development should reserve these ports. The TOOL pin is internally connected with a pull-up resistor and it is recommended to float.
WSL05-A0_User_Manual Figure 5- 3 MCU reset circuit 4.3 Peripherals Interface WSL05-A0 module provides external interfaces such as UART and SPI. UART0 and SPI interface that can be utilized as communication interfaces for data exchange, UART1 port is used as debug interface which can print debugging information. 4.3.1 UART Interface The following table shows the UART interface of WSL05-A0.
WSL05-A0_User_Manual UART interface is not used, it is recommended that the RXD0 pin be connected to a pull-up resistor and the TXD0 pin be left floating. WSL05-A0 UART interface is compatible with CMOS logic levels. External controllers and host devices can be in the following two ways: An external logic voltage compatible MCU is used as the main controller and communicates through the UART peripheral; Connect to a PC through a logic level converter (such as a USB to RS-232 adapter board).
WSL05-A0_User_Manual Figure 5- 5 UART communication timing diagram The baud rate, parity, and stop bits of the module can be configured by AT commands. For details , refer to AT command manual. 4.3.2 SPI Interface The following table shows the SPI interface . Table 5- 2 Pin No.
WSL05-A0_User_Manual The SPI interface is used as a backup solution. When the external controller has no UART interface or high-speed data exchange is required, the SPI interface can be used instead of the UART interface.
WSL05-A0_User_Manual Figure 5- 7 SPI connection After the module detects that the SPI_NSS pin is pulled low, it wakes up from sleep mode (if in sleep mode) and begins to initialize the SPI peripherals. The peripheral controller must wait until the BUSY pin is pulled low to start the transmission.The module will pull the BUSY pin high again before the current byte transfer is completed. After the module receives a byte of data and stores the data in the receive buffer it pulls the BUSY pin low again.
WSL05-A0_User_Manual To enable the SPI interface (slave mode), you need to configure the NSS (S), SCK, MISO (S), MOSI (S), BUSY, ATTN and other pins of the interface as the main function, that is, the corresponding DIOx configuration value is equal to 1. When the user needs to use the SPI interface for secondary development (master mode), it is recommended to disable the corresponding SPI pin DIOx , and the SPI interface is directly controlled by the user code. 4.3.
WSL05-A0_User_Manual 4.4 RF Interface WSL05-A0 module requires 50Ω impedance characteristics of antenna, the cabling from module ANT interface to antenna also needs to be controlled within this impedance range. The reference circuit is shown below. Figure 5- 9 Antenna reference circuit design 5 Application Function 5.1 Working Mode WSL05-A0 module supports AT command and transparent transmission mode. Different working modes have different data processing.
WSL05-A0_User_Manual 5.1.1 AT Command Mode By default, the module is in AT command mode. The AT command mode can perform all operations on the module, including data sending and receiving, parameter configuration, and status reading. After receiving an instruction, the module makes command analysis, execution, and response. The format of AT command is to use AT as the leading characters and the carriage return character (\ r) as the end; the response command format begins and ends with the carriage return
WSL05-A0_User_Manual you can re-enter the AT command mode through the command sequence and execute the AT + SAVE command to save the parameters. View the following example: +++ OK AT+SAVE OK 5.1.2 Transparent Transmission Mode In the transparent transmission mode, module regards all data received from the serial port as payload data, organizes it into LoRaWAN packets, and then sends the data to the server. When receiving the data from the server, only the payload data is output to the serial port.
WSL05-A0_User_Manual no response, verify the following: Please check whether the wire is correct. Please check whether the baud rate, parity, stop bit and other configurations are correct. The module runs in UART sleep wake-up mode, the wake-up code should be added. The module is in AT command mode. the default carriage return (\r\n), the carriage return (\r\n) should be canceled.
WSL05-A0_User_Manual channels 8 ~ 15, view operation example below: AT+CHMASK=FF00 OK AT+SAVE OK Or quickly set up by channel group, for example, select channel 8 ~ 15, namely group 2, operation example: AT+CHGROUP=2 OK AT+SAVE OK 5.3 Activation Method In order to access LoRaWAN network, module needs to perform an activation operation before use.Module supports two activation methods, OTAA and ABP, and the activation methods of the two modes are different.
WSL05-A0_User_Manual Configure AppEui, AppKey and other parameters of the module. Set OTAA activation mode. Delete the session context of Enable hot start. Save parameters. After the configuration is complete, the Join operation can be performed automatically module and set AutoJoin flag. after the module is reset.
WSL05-A0_User_Manual same as those of the server. Set to ABP activation mode. Save parameters. After the configuration is complete, the module is in an activated state on reset (that can send data to the server). View an example of activation configuration for ABP mode: AT+DEVADDR=1 OK AT+NWKSKEY=1234567890ABCDEF1234567890ABCDEF OK AT+APPSKEY=00112233445566778899AABBCCDDEEFF OK AT+JOINMODE=1 OK AT+SAVE OK AT+RESET OK 5.
WSL05-A0_User_Manual 5.4.1 Automatic Network Access Automatic network access function can automatically detect connection status between module and server. When module lost connection to server or the module determines disconnection from the server, it can automatically trigger the Join process.
WSL05-A0_User_Manual different channels until it receives Join response from server. If module can not join the network for a certain number of times, module will terminate the Join process to save power. At any time, you can use the “AT+JOIN” instruction to stop and restart the Join process.
WSL05-A0_User_Manual indicates the current network access trigger mode, 1 indicates automatic trigger, and 0 indicates manual trigger. For more detailes description of the instructions, please refer to the AT instruction manual. 5.5 Warm Boot The warm boot function is used to save the LoRaWAN session context. When the warm boot function is enabled, the module automatically saves the session context parameters to the EEPROM every time the Join succeeds and sends upstream data.
WSL05-A0_User_Manual AT+DIO0=1 OK AT+SAVE OK 5.6.1 DIOx Configuration Function DIOx configuration function is shown as following table. Table 6- 1 DIOx configuration function table DIOx = Description 0 Disable the port, the module will not do anything to the DIO configured to this value 1 Main functions, such as peripheral pins such as SPI, UART, I2C, etc.
WSL05-A0_User_Manual 5.6.
WSL05-A0_User_Manual module acts as a slave. DIO0、DIO1、DIO11、DIO12 do not support pull-up input. SDA and SCL are internally connected with 10K pull-up resistors and cannot be cancelled. 5.6.3 Signal Indication The module can output some special signals to adapt to different applications. When the conditions are met, the indication will be set (output 0/1), and after the condition is eliminated, the indication will be cleared (output 1/0). The following table describes.
WSL05-A0_User_Manual increase the transmission channel by command. You can also add up to 15 channels. To increase the transmission channel, you must determine the parameters such as channel number, frequency point, and rate range. The command format for increasing the sending channel is as follows: +TXCH=,,[MinDr],[MaxDr] Among them, Channel and Freq are required items, and the rate ranges MinDr and MaxDr are optional and can be omitted. If omitted, the module will use the default values.
WSL05-A0_User_Manual Port 221 is used as a remote AT command access channel and cannot be used as a user port; In CLASS A mode, commands can only be sent to the module when the module sends upstream data frames. When the length of the response frame is greater than the maximum allowed packet length, the response frame will be discarded; 6 Data Business The module needs to go through network initialization, network activation and other operations before it can be used for data transmission.
WSL05-A0_User_Manual Figure 7- 1 Data exchange flowchart The network initialization process only needs to be set when the module is activated for the first time. The network access request process only needs to be executed when the network access mode is manually triggered and the warm boot function is cancelled, otherwise the module will be automatically executed. Normally, after the module is successfully connected to the network, it always thinks that it is connected to the server.
WSL05-A0_User_Manual disconnected, and then the module will automatically trigger a network access request. When the warm boot function is enabled, after the module is successfully connected to the network, the module will be in the network connection state after being powered on. 6.1 Send Parameter Configuration During data transmission, according to different application scenarios, some parameters may need to be adjusted, such as rate adaptation, transmit power, rate, duty cycle, application port, etc.
WSL05-A0_User_Manual protocol. 4) Send duty cycle The transmit duty ratio is used to limit the frequency of data transmission. In addition to the regional regulations that must be enabled, you can use this function to limit the module to transmit data to avoid excessive consumption of traffic resources by certain devices. Example of setting the duty cycle of sending: AT+TXDC=1,5 OK Example of operation to turn off duty cycle: AT+TXDC=0 OK 5) Application port The application port is application-specific.
WSL05-A0_User_Manual transmissions before stopping. Confirm that although the upstream data frame increases the data traffic, the reliability of the data is effectively guaranteed. Since the LoRaWAN network supports 8 upstream channels, but only supports 1 downstream channel, under normal circumstances, you should use as many unacknowledged upstream data frames as possible to transmit data. The module sends data through the + DTRX command.
WSL05-A0_User_Manual 6.3 Data Reception According to the communication mechanism specified in the LoRaWAN protocol specification, the module delays RX1Delay after the upstream data frame, and then opens the receiving windows RX1 and RX2 to receive data in turn, as shown in the following figure: Figure 7- 2 Schematic diagram of Class A Figure 7- 3 Schematic diagram of Class C When the module is used as a CLASS A device, the radio frequency is normally dormant and cannot receive data at this time.
WSL05-A0_User_Manual +DRXSTR: [RxWin], [DownLinkCounter], [Port], [Length], , [RSSI], [SNR] Content in “[ ]” is an optional option, which can be enabled and canceled through RXOPT (receive option byte).
WSL05-A0_User_Manual 6.4 Maximum Load Length The maximum load sent depends on the rate. For details, please refer to the LoRaWAN protocol specification. When the transmission length is greater than the maximum load, the module cannot perform the send operation. In addition, the uplink data frame may carry MAC command information, and it cannot be sent according to the maximum packet length.
WSL05-A0_User_Manual Under normal circumstances, the module has been in a deep sleep state. When it is awakened, it begins to receive serial data and processes the data at the same time. After processing, it returns to the deep sleep state. In order to minimize power consumption, when the module detects that there is no data activity on the serial port, it will enter a deep sleep state. When there is still data being sent, the module will automatically wake up and handle subsequent operations.
WSL05-A0_User_Manual that trigger reporting at a fixed period. For detailed instructions on setting the sleep time, please refer to the AT instruction manual. 6.10 PIN Cycle Wake-up Mode (SM=4) Pin cycle wake-up mode is a combination of pin wake-up and cycle wake-up modes. When the module is in the sleep state, the SLEEP_REQ pin can be used to wake up the module in advance. 7 Mechanical Dimensions This chapter describes the mechanical dimensions of the module.
WSL05-A0_User_Manual Figure 8- 2 Module bottom dimensions (Bottom View) Figure 8- 3 Module side dimensions 7.
WSL05-A0_User_Manual Figure 8- 5 Bottom view of WSL05-A0 module These are design effect drawings of WSL05-A0 module. For more accurate pictures, please refer to the module that you get from Friendcom. 7.3 Packaging WSL05-A0 modules are packed in vacuum-sealed bags on delivery to guarantee a long shelf life. The bag should not be opened until the devices are ready to be soldered onto the application. Follow the same package of the modules again in case of opened for any reasons.
WSL05-A0_User_Manual 7.4 Storage WSL05-A0 is stored in a vacuum-sealed bag, the storage restrictions are listed below. 1) Shelf life in the vacuum-sealed bag: 12 months at <40ºC/90%RH. 2) After the vacuum-sealed bag is opened, devices that can be subjected directly to reflow soldering or other high temperature processes if the following conditions are met: Mounted within 168 hours at the factory environment of ≤30ºC/60%RH. Stored at <10%RH.
WSL05-A0_User_Manual OTAA Over-The-Air Activation PCB Printed Circuit Board RF Radio Frequency RTC Real Time Clock RSSI Received Signal Strength Indication SM Sleep Mode SMT Surface Mount Technology SPI Serial Peripheral Interface UART Universal asynchronous receiver-transmitter Page 58 / 58