Skip to content

Latest commit

 

History

History
66 lines (45 loc) · 3.17 KB

README.md

File metadata and controls

66 lines (45 loc) · 3.17 KB
Raw

LoRa Basics Modem large file upload application example

Description

The application will automatically join a LoRaWAN network (see configuration).

Once a network is joined (i.e. when the corresponding event is triggered), the application will initialize a file transfer by calling smtc_modem_file_upload_init() and start it by calling smtc_modem_file_upload_start().

In this example, the file is a text in ASCII.

When the transfer is over, the event SMTC_MODEM_EVENT_UPLOADDONE will be triggered with a status indicating if LoRa Cloud acknowledged the reception (SMTC_MODEM_EVENT_UPLOADDONE_SUCCESSFUL) or not (SMTC_MODEM_EVENT_UPLOADDONE_ABORTED).

The application can relaunch the same file transfer as soon as the current one is over.

The file upload can be stopped anytime by calling smtc_modem_file_upload_reset().

Configuration

Several parameters can be updated in main_large_file_upload.h header file:

Constant Description Possible values Default Value
APP_SMTC_MODEM_LFU_CIPHER_MODE Large file upload encryption mode Any value of smtc_modem_file_upload_cipher_mode_t SMTC_MODEM_FILE_UPLOAD_NO_CIPHER
APP_SMTC_MODEM_LFU_SIZE Size in byte of the file to be uploaded [1,2048] 2048
APP_SMTC_MODEM_LFU_AVERAGE_DELAY Average delay in second between two uplinks uint32_t 30
APP_SMTC_MODEM_LFU_RELAUNCH Re-start a file upload session as soon as the previous is over {true, false} false

When compiling with arm-none-eabi-gcc toolchain, all these constant are configurable through command line with the EXTRAFLAGS. See README.md.

The text to be sent is the array named text.

Expected behavior

Here follow the steps that shall be seen in logs to indicate the expected behavior of the application:

Device starts and reset

 INFO: Modem Initialization

 INFO: ===== LoRa Basics Modem large file upload example =====
 (...)
 INFO: ###### ===== BASICS MODEM RESET EVENT ==== ######

Following this print you shall find application and parameter prints

Device joined the network

INFO: ###### ===== JOINED EVENT ==== ######

Upload starts

INFO: Launch a file upload session.
INFO: Initialize the file upload.

Downlink received from server indicating that file has been successfully uploaded

WARN: DM_FILE_DONE downlink
INFO: File upload DONE with server confirmation 
INFO: ###### ===== UPLOAD DONE EVENT ==== ######
Upload status: SMTC_MODEM_EVENT_UPLOADDONE_SUCCESSFUL