Linux_LoRaWAN

English |中文

[toc]

---

Introduction

• Implementation of LoRaWAN application under Linux, supporting LoRaWAN 1.0.2 protocolv
• Supports multiple frequency bands
• Build with cmake and easily add your own application code
• Support graphical interface for parameter configuration

---

install

1. First, you need to install make, camke, and gcc.
2. Download the source code locally.
3. Enter the build folder under the project and execute the following commands in sequence.

rm -rf *
cmake ..
make

4. After the execution is completed, an executable file will be generated in the bin folder.

use

1. After the execution is completed, an executable file will be generated in the bin folder.

make menuconfig

2. Enter the bin folder of the project and execute the startup command.

./demo

3. If you encounter Certificate verification failed, please refer to License Verification.

License Validation

1. Enter the folder of LoRaWAN executable files.

cd /home/lora/linux_lora/bin/

2. Execution ./demo

Certificate verification failed
Please provide a correct license! For more information:
http://www.heltec.cn/search/ 
ChipID=303030303337   

3. Open the address connection to obtain the license, enter the ChipID of the product obtained in the previous step, and you can obtain the required license.
4. Use the shell command make menuconfig to open the configuration interface, find the license input option, and enter the aforementioned license. Save and exit.

HelTec LoRaWAN license --->

---

Basic structure of the project

|-- bin
|-- build
|-- functional_module
|   |-- bmp180
|   |-- data_conversion
|   |-- fifo
|   |-- hdc1080
|   `-- lora
|-- hardware_driver
|   |-- gpio
|   |-- i2c
|   `-- spi
|-- lib
`-- project
    |-- config
    `-- main

---

Currently supporting frequency bands

• AS923 region
• AU915 region
• CN470 region
• CN779 region
• EU433 region
• EU868 region
• KR920 region
• IN865 region
• US915 region
• US915_HYBRID region
• AU915 SB2 region
• AS923 AS1 region
• AS923 AS2 region

---

Add your own functional modules

Taking bmp180 as an example

1. Add a new folder named bmp180 under the functional_module folder.

2. Add the following file in the bmp180 folder

   bmp180.c

   bmp180.h

   CMakeLists.txt

   README.md

3. Write source file and Header file content.

4. Write CMakeList.txt

aux_source_directory(. BMP180)
include_directories(${PROJECT_SOURCE_DIR}/hardware_driver/i2c)
link_directories(${PROJECT_SOURCE_DIR}/lib)
LINK_LIBRARIES(-lm)
add_library(bmp180 ${BMP180} )
target_link_libraries(bmp180 i2c )
target_include_directories(bmp180 PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

5. Write a README.md instruction document.

6. add in functional_module/CMakeLists.txt

   add_subdirectory(bmp180)
   

7. Add bmp180 in the link library option of project/main/CMakeLists.txt

   target_link_libraries(${PROJECT_NAME} fifo config lora hdc1080 bmp180 data_conversion)
   

8. Add your own Header file of bmp180 in main. c to call the bmp180 function.

---

Add graphical configuration interface options

1. Find the Kconfig file for the project and add it in the LORAWAN_APP_DATA menu bar

   config BMP180_DATA
       bool "bmp180"

2. Add to the LORAWAN_DATA_SELECTION menu bar in project/config/config.ini

   ;BMP180_DATA=3
   

   • The name of this option needs to be consistent with the options in Kconfig, both being BMP180_DATA.

   • The value of this option needs to be matched with the option to prepare data in main.c, and its values are all equal to 3

     typedef enum 
     {
         fixed_data =0,
         mkfifo_data,
         hdc1080_data,
         bmp180_data
     }data_selection_num;

3. In project/config/kconfig_lib/configini_to_kconfig.sh's #Configure LoRaWAN upload data selection add

   elif [ $DATA_SELECTION -eq 3 ];then
       echo "CONFIG_BMP180_DATA=y" >> $K_CONFIGFILE

   • configini_to_kconfig.sh will synchronize the C configuration file with the graphical interface configuration file.

4. The bmp180 configuration option added this time does not require modifying the project/config/kconfig_lib/kconfig_to_configini.sh file, as the previous synchronization options have already matched bmp180.

   • kconfig_to_configini.sh will synchronize the graphical interface configuration file to the C configuration file.

5. Add and read the config.ini file in project/main/main.c .

    data_selection = iniparser_getint(ini,"LORAWAN_DATA_SELECTION:data_selection",-1);

6. Use make menuconfig to configure the bmp180 option and save it. At this point, the data_selection=3 is read in main.c.

7. After adding, you can implement relevant functions through options in man.c.

---

Maintainer

@Quency-D

---

contribute

Thank you very much for joining! Raise an Issue or submit a Pull Request.

The standard Readme follows the Contributor Covenant code of conduct.

---

contributor

Thank you to the following people who participated in the project:

Luckybuyu 🎨

Aaron.Lee 💻

---

license

Apache License 2.0