Telethings LoRa Node User Manual

Hide thumbs

Table Of Contents

Table of Contents

Quick Links

Download this manual

User Manual for Telethings LoRa

Lejlekuša bb

75320 Gračanica, Bosna i Hercegovina

Node

Tel: +387 35 700 209

Fax: +387 35 700 201

Mail: info@TeleThings.com

Web: www.telethings.com

Table of Contents

Need help?

Do you have a question about the LoRa Node and is the answer not in the manual?

Questions and answers

Summary of Contents for Telethings LoRa Node

Page 1 User Manual for Telethings LoRa Lejlekuša bb 75320 Gračanica, Bosna i Hercegovina Node Tel: +387 35 700 209 Fax: +387 35 700 201 Mail: info@TeleThings.com Web: www.telethings.com...
Page 2: Table Of Contents
Instalation Hardware and Software ................. 9 Introduction ....................... 9 Hardwer preparation ................... 9 Software preparation ..................12 Telethings Lora Node as programmable device with daughter board ......14 Instalation Hardware and Software ............... 14 Introduction ..................... 14 Hardware preparation ..................14 Software preparation ..................
Page 3: Introduction
INTRODUCTION This manual has been created in order to introduce the user with the Telethings LoRa module, i.e. its technical specifications and how to use it. Special attention will be given to the module as an AT Slave device, which is a programmable module installed on the Daughter board.
Page 4: Acronyms
- Non define OTAA - Over the air activation - Physical layer - Receiver RSSI - Received Signal Strength Indicator - Signal Noise Ratio - Serial Peripheral Interface - Telethings LoRa Node - Transmitter UART - Universal Asynchronous Receiver/Transmitter 3/33...
Page 5: Safe Operation
SAFE OPERATION To ensure that the Telethings LoRa Node device is reliable, the following conditions must be met: Do not install the device close to running water, do not wash it with water and other liquids! Do not install the device on unstable and vibrating surfaces, in order to prevent the...
Page 6: Product Overview
PRODUCT OVERVIEW Telethings Lora node Beta 1.0 is a device based on a low power STM32L071 microcontroller, and a sx1272 module. It has small dimensions and can respond to users' demands with very low power consumption (the consumption of a device when working in sleep mode is below 10 uA).
Page 7: Technical Features And Specification
TECHNICAL FEATURES AND SPECIFICATION Model Name Telethings LoRa Node Description LoRa Wireless Communication Module Hardware Semtech SX1272 - Low Power Long Range Transceiver STM32L071KBU6 - Ultra-low-power ARM Cortex-M0+ MCU with 128-Kbytes Flash, 32 MHz CPU Host Interface LPUART Power supply...
Page 8: Telethings Lora Node Pin Structure
DIO3_SX DIO2_SX TLN_PB6 TLN_PA3 TLN_PB7 TLN_PA2 RESET VDD_MCU TLN_PA1 TLN_PA0 Figure 2. Telethings LoRa Node pins structure TLN PINx PINx describe note Ground RESET SX Reset pin for sx1272 module NSS SX SPI Chip select MOSI SX SPI MOSI MISO SX...
Page 9 TLN PORTB/TLN PIN4 TLN PB5 TLN PORTB/TLN PIN5 TLN PB6 TLN PORTB/TLN PIN6 TLN PB7 TLN PORTB/TLN PIN7 Table 1. Table of Telethings LoRa Node pin describes TLN PORTx/TLN PINx UART GPIO TLN PA0 UART 4 TX TLN PA1 UART4 RX...
Page 10: Telethings Lora Node As At Slave Device
INSTALATION HARDWARE AND SOFTWARE INTRODUCTION Telethings LoRa Node in the function of the AT Slave device implies a module with already added firmware in order to perform the mentioned functionality. It is necessary to have some kind of master device, which should be connected to the module, in order for the module itself to perform its functionality.
Page 11 Figure 3. Solder the coaxial cable for antenna 1 VDD 2 GND Figure 4. Solder wires on GND pin i VDD pins 10/33...
Page 12 3 UART RX 4 UART TX 1 VDD 2 GND Figure 5. Solder wires on UART RX pin and UART TX pin Attention should also be paid to these changes if the Node is embedded on another master device. Assuming that all the changes have been made, the connection of the module with TTL (Figure 5) will follow, and it will represent the connection of the module to the computer.
Page 13: Software Preparation
Figure 6. Wire connection between TTL and Telethings LoRa Node SOFTWARE PREPARATION The following step is installation of an application through which commands will be sent to the node and monitor the responses to the commands, or their actions. There are several applications that can serve for these purposes, but we opted for Termite v3.1.
Page 14 Figure 7. Device Manager - Checking COM port of UART Debugger Open Termite v3.1 and check Termite settings. Figure 8. Termite settings Now hardware and software are prepared for action. 13/33...
Page 15: Telethings Lora Node As Programmable Device With Daughter Board
INSTALATION HARDWARE AND SOFTWARE INTRODUCTION The Telethings LoRa Node in the function of the programmable device implies a module that is factory-loaded on the development board, i.e. the so-called daughter board. As the name itself says, the module as such is subject to programming of the functionality as desired by the client.
Page 16: Software Preparation
SW DIO SW CLK 3,3V Figure 10. Pins for programing device But the first thing to do when it comes to hardware preparation of the device is to assemble the antenna on the device. SOFTWARE PREPARATION The main reference in this chapter will be to create and adjust a test project that uses the library and a few basic files that accompany the library.
Page 17 Figure 11. Creating test project in Atollic Studio Figure 12. Step 1. Setting project name and location for saving project 16/33...
Page 18 Figure 13. Step 2. Selecting STM32L071KB for hardware settings 17/33...
Page 19 Figure 14. Step 3. Selecting software settings Figure15. Step 4. Selecting hardware debug settings 18/33...
Page 20 Figure 16. Created project files Folders 'Drivers' and 'src' must be deleted, and then new folders 'LORA', 'MAIN' and 'OTHER' must be created, and then paste files into it as on Figure 17.. This folders and files organization is for test project, and folders can be named optional, and also organizing folders and files is optional.
Page 21 Figure 19. Add include path n every new added folder Figure 20. Confirm adding include path for folder 20/33...
Page 22 Figure 21. Selecting properties of project Figure 22. Folder paths which now don't exist must be deleted, the same thing applies for 'Language-S,s,asm' 21/33...
Page 23 Figure 23. Updated status with including path for folders Figure 24. In tab 'Symbols' new simbol 'NO_MAC_PRINTF' must be added 22/33...
Page 24 Figure 25. In tab 'Libraries', 'Telethings.Lora.Node.Library' must be added Figure 26. In tab 'Library Paths' path for library file must be added Now test application is ready for building. 23/33...
Page 25: Creating Aplication For Node On Ttn Site
Assuming user already got LoRa Gateway and account on TTN site, and is logged in, from now this document will be focused for LoRa Node Application. Figure 27. Main screen of ttn site Selecting 'Console' option by clicking on user's account name.
Page 26 Figure 28. Empty application interface on ttn site First screen, after clicking 'Console' option, should look like this on Figure 28., and then 'add application' should be selected. A form will open like on Figure 29. Figure 29. Form for creating Application for node 25/33...
Page 27 Figure 30. Filled with random data form for creating Application for node Figure 31. Exmaple of wrong input for Application ID 26/33...
Page 28 Form with data ('Application ID' and 'Description') must be filled and clicked on button 'Add application' Figure 32. Application ID already exist error try input another Application ID Figure 33. Application form for node Now, Application for Node is created and Application EUI is now available. 27/33...
Page 29 Figure 34. For registration of Node device on this site, 'register device' option should be clicked on screen. Figure 35. Application form for register node 28/33...
Page 30 Device EUI number must be entered. Device EUI can be aquired by calling AT command for device eui (AT+DEUI=?) (Figure 37.), or LoRa Node call function from library ' void lib_tln_lora_dev_eui(uint8_t * dev_eui);'. Figure 36. Application form for register node filled by test data Data 'Device ID' and 'Device EUI' must be filled in application form.
Page 31 Figure 38. Finally Application form for the node Now ABP join mode should be selected, and that can be done when user clicks on tab 'Settings' Figure 39. Option Setting 30/33...
Page 32 Selecting ABP mode instead OTAA. Figure 40. Selecting ABP activation mode instead OTAA mode Now in user's Node application, 'Network Session Key' and 'App Session key' will be available. Figure 41. Application form 31/33...
Page 33 Button for coppy key Button for changing key format Figure 42. Updated data on Application form Clicking on '<>' user can change key format, and can copy key by clicking on copy icon. Now the application is prepared and there are available keys which are needed for Node. After Application for Node is prepared, user should set keys to Node using library functions or using AT Commands, and program node functionality.
Page 34: Examples
For finding code examples look at documentation: - „LoRaNodeATCommands.pdf“ - „LoRaNodeLibraryFunctions.pdf“ REFERENCE https://www.thethingsnetwork.org/ „LoRaNodeLibraryFunctions.pdf“, Documentation for Telethings LoRa Node library „LoRaNodeATCommands.pdf“, Documentation for Telethings LoRa Node AT Commands „AN4967 Application note Examples of AT commands on I-CUBE-LRWAN“, Docummentation about AT commands...