LoryPlug/CPU SDK Manual Version: 1.
LoryPlug/CPU SDK Manual Revision History Revision Date Document Version Pages Description May 24, 2019 1.0 All New Copyright 2019 SystemBase Co., Ltd. All rights reserved. Website http://www.sysbas.com/ Tel 82-2-855-0501 Fax 82-2-855-0580 Daerung Post Tower-1, 16F, 288, Digital-ro, Guro-gu, Seoul, Republic of Korea Please contact our technical team(tech@sysbas.
LoryPlug/CPU SDK Manual This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications.
LoryPlug/CPU SDK Manual OEM/Integrators Installation Manual - The module is limited to OEM installation ONLY. - The OEM integrator is responsible for ensuring that the end-user has no manual instruction to remove or install module. - The module is limited to installation in mobile or fixed applications, according to Part 2.1091(b). - The OEM Integrator is still responsible for testing their end-product for any additional compliance requirements required with this module installed.
LoryPlug/CPU SDK Manual Contents 1. OVERVIEW ................................................................................................................. 6 2. FEATURES .................................................................................................................. 6 3. PACKAGE ................................................................................................................... 7 4. HARDWARE ................................................................................
LoryPlug/CPU SDK Manual 1. Overview The LoryPlug/CPU SDK is a programmable CPU module that allows users to develop LoRa-based End Devices. Users can easily develop End Devices with various sensors by using a source code (API and library) provided by the LoryPlug/CPU module. A variety of devices based on LoryNet platform provided by SystemBase allow remote monitoring and control to End Devices on the other side of the globe.
LoryPlug/CPU SDK Manual 3. Package Package Ordering Information LoryPlug/CPU LoryPlug/CPU v1.0.
LoryPlug/CPU SDK Manual 4. Hardware 4.
LoryPlug/CPU SDK Manual Category Item Specification System CPU ARM CORTEX-M3 Wired Interface Port UART*3, I2C*1, ADC*2, GPIO*6 Frequency Usable Frequency 917.3MHz, 917.9MHz, 918.5MHz, 919.1MHz, 919.7MHz, 920.3MHz, 920.7MHz, 920.9MHz, Display LED RDY, LINK Power Input 3.3V Connector B TO B MOLEX SD-53748-002 Operating Temperature -40℃ ~ +85℃ (-40℉ ~ +185℉) Conditions Humidity 5~95% Non-Condensing Wireless Interface 921.1MHz, 921.3MHz, 921.5MHz, 921.7MHz, 921.9MHz, 922.1MHz, 922.
LoryPlug/CPU SDK Manual 4.
LoryPlug/CPU SDK Manual 4.
LoryPlug/CPU SDK Manual Recommended Antenna Pattern - Recommended Antenna: hanwooltech, HW-920H-S Recommendation on matching circuit will be provided according to customer’s installation conditions. Sample base board example: Combine the module with the base board as shown in the image below. The antenna is soldered to the base board.
LoryPlug/CPU SDK Manual 5. Connection Guide This chapter describes the writing process and notes for user applications. The development and testing of the LoryPlug/CPU used IAR compiler and ST-LINK/V2 Debugger of IAR SYSTEMS. You can download the IAR compiler from the site below and use it for 30 days by authorizing a free license. Other development environment related matters are as follows. 5.1 Development Environment - Compiler : IAR 8.3 or above - Free version IAR Link: https://www.iar.
LoryPlug/CPU SDK Manual - Project: main folder of application program - Library: MCU library provided by STM - App : main source folder - LoryNet: LoryNet protocol engine and library sources - LoRa : LoRa communication port process source - Sensor : temperature/humidity sensor process source - Exe : folder where firmware is generated after compiling - List : memory map information of compiled binary code 5.
LoryPlug/CPU SDK Manual 5.4 Function Map The application included in the LoryPlug/CPU SDK is based on the LoryNet and the structure of the function is as follows: The application provided is composed of three processes (device, LoRa, sensor) and with the exception of device process, LoRa and sensor processes consists of four layers. The area users write is primarily the App Layer, where you receive and process data from the other party.
LoryPlug/CPU SDK Manual API Description - Initialize the settings used by the device itself on the first call. Main_Proc - Call Table_Layer every 1 second to view and read packets received. - The read packets are processed by App Layer, which is the user-writing area. - Call the LoRa, Sensor port process that belongs to itself. - Initialize the LoRa communication interface settings on the first call.
LoryPlug/CPU SDK Manual Get_Config - Read the operation setting information stored in Flash Memory within the MCU. - As Flash does not have basic information during the first startup after Factory_Default production, it is used to record the default values in Flash or resets to the factory defaults by Reset Switch.
LoryPlug/CPU SDK Manual 5.5 APIs This chapter introduces the various APIs that users can use to program by using LoryPlug/CPU SDK.
LoryPlug/CPU SDK Manual Erase_Main_Flash Function Format Erases the sector before writing data on Flash Memory in STM CPU void Erase_Main_Flash (uint32_t addr, int Sector_Ea) Parameter Addr Absolute address of Flash Memory Sector_Ea Number of sectors to erase (Size of a sector is 1K Bytes) Returns None Sleep_Mode Function Switch LoryPlug/CPU into Standby mode Format void Sleep_Mode () Parameter Returns None None Notice Sleep mode provided by SDK supports Standby mode as standard.
LoryPlug/CPU SDK Manual Parameter msec Returns None Time to wait (msec) Notice 20
LoryPlug/CPU SDK Manual 6. How to Use The compiler compiles the application sources provided by the LogPlug/CPU and converts them into binary files. This chapter provides example of the use of IAR Embedded Workbench IDE, the most commonly used compiler, and assumes that users’ PC has an IAR compiler installed. 6.1 To RUN IAR Compiler Run IAR IDE by double-clicking on "LoryPlug_SDK.ew" project file in the Project folder. Select Rebuild All in the Project column or press Ctrl+F7 to compile the source.
LoryPlug/CPU SDK Manual 6.2 Operation Test For operation test, you can check the operation status by connecting the debug port to PC. Run the communication emulator program on your PC and set the serial settings to 115.2Kbps, Parity None, 8 Bit Data, 1 Stop Bit. The LogPlug/CPU operation test can be run by changing/compiling/uploading the Defined Test_Mode value early in Main.c.
LoryPlug/CPU SDK Manual To change your ID to No. 255, type: myid=255 (Enter) The ID of the LogPlug/CPU must be used within the range of 10000000 to 16000000. To initialize the settings, type: default (Enter) Refer to Factory_CFG() function in main.c for initial values. To turn on encryption function, type: aes=1 (Enter) The AES Key value is set to the Default value if you do not change it.
LoryPlug/CPU SDK Manual When Test_Mode is set to 1, the following operating status is outputted via Debug Port: When Test_Mode is set to 0, the following operating status is outputted via Debug Port: Reads the sensor information and pass temperature/humidity information to destination 0xfffffe at a certain interval.