Damian Gabino / Simple-LoRaWAN-Demo

A very easy to understand LoRaWAN-node code.

Dependencies:   LoRaWAN-lib SX1272Lib X_NUCLEO_IKS01A1 mbed

Important parameters:

• In comissioning.h: DevEUI, AppEUI, AppKEY, DevADR, NwksKEY, AppsKEY, OTAA and public network. Frequency and channel block to use, confirmed or unconfirmed messages, app port, app data size and OTAA and Tx duty cycles.

• In LoRaMac.h: Maximum payload and MAC commands length, receive delays, max FCNT, adr ack limit, timeout and delay, max ack retries, rssi threshold and sync words.

• In LoRaMac.cpp: Maximum payload, MAC commands and FRMpayload length.

• In LoRaMac-board.h: Tx power, data rates and band settings.

NOTE: Please refer to LoRaWAN regional parameters (page 12 for US band) to know which parameters you can modify.

system/utilities.h@0:60ff878b27b8, 2018-04-03 (annotated)

Committer:
dgabino
Date:
Tue Apr 03 17:09:34 2018 +0000
Revision:
0:60ff878b27b8
A simpler way to customize your LoRaWAN payload

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dgabino 0:60ff878b27b8 1 /*
dgabino 0:60ff878b27b8 2 / _____) _ | |
dgabino 0:60ff878b27b8 3 ( (____ _____ ____ _| |_ _____ ____| |__
dgabino 0:60ff878b27b8 4 \____ \| ___ | (_ _) ___ |/ ___) _ \
dgabino 0:60ff878b27b8 5 _____) ) ____| | | || |_| ____( (___| | | |
dgabino 0:60ff878b27b8 6 (______/|_____)_|_|_| \__)_____)\____)_| |_|
dgabino 0:60ff878b27b8 7 (C)2013 Semtech
dgabino 0:60ff878b27b8 8
dgabino 0:60ff878b27b8 9 Description: Helper functions implementation
dgabino 0:60ff878b27b8 10
dgabino 0:60ff878b27b8 11 License: Revised BSD License, see LICENSE.TXT file include in the project
dgabino 0:60ff878b27b8 12
dgabino 0:60ff878b27b8 13 Maintainer: Miguel Luis and Gregory Cristian
dgabino 0:60ff878b27b8 14 */
dgabino 0:60ff878b27b8 15 #ifndef __UTILITIES_H__
dgabino 0:60ff878b27b8 16 #define __UTILITIES_H__
dgabino 0:60ff878b27b8 17
dgabino 0:60ff878b27b8 18 /*!
dgabino 0:60ff878b27b8 19 * \brief Returns the minimum value betwen a and b
dgabino 0:60ff878b27b8 20 *
dgabino 0:60ff878b27b8 21 * \param [IN] a 1st value
dgabino 0:60ff878b27b8 22 * \param [IN] b 2nd value
dgabino 0:60ff878b27b8 23 * \retval minValue Minimum value
dgabino 0:60ff878b27b8 24 */
dgabino 0:60ff878b27b8 25 #define MIN( a, b ) ( ( ( a ) < ( b ) ) ? ( a ) : ( b ) )
dgabino 0:60ff878b27b8 26
dgabino 0:60ff878b27b8 27 /*!
dgabino 0:60ff878b27b8 28 * \brief Returns the maximum value betwen a and b
dgabino 0:60ff878b27b8 29 *
dgabino 0:60ff878b27b8 30 * \param [IN] a 1st value
dgabino 0:60ff878b27b8 31 * \param [IN] b 2nd value
dgabino 0:60ff878b27b8 32 * \retval maxValue Maximum value
dgabino 0:60ff878b27b8 33 */
dgabino 0:60ff878b27b8 34 #define MAX( a, b ) ( ( ( a ) > ( b ) ) ? ( a ) : ( b ) )
dgabino 0:60ff878b27b8 35
dgabino 0:60ff878b27b8 36 /*!
dgabino 0:60ff878b27b8 37 * \brief Returns 2 raised to the power of n
dgabino 0:60ff878b27b8 38 *
dgabino 0:60ff878b27b8 39 * \param [IN] n power value
dgabino 0:60ff878b27b8 40 * \retval result of raising 2 to the power n
dgabino 0:60ff878b27b8 41 */
dgabino 0:60ff878b27b8 42 #define POW2( n ) ( 1 << n )
dgabino 0:60ff878b27b8 43
dgabino 0:60ff878b27b8 44 /*!
dgabino 0:60ff878b27b8 45 * \brief Initializes the pseudo ramdom generator initial value
dgabino 0:60ff878b27b8 46 *
dgabino 0:60ff878b27b8 47 * \param [IN] seed Pseudo ramdom generator initial value
dgabino 0:60ff878b27b8 48 */
dgabino 0:60ff878b27b8 49 void srand1( uint32_t seed );
dgabino 0:60ff878b27b8 50
dgabino 0:60ff878b27b8 51 /*!
dgabino 0:60ff878b27b8 52 * \brief Computes a random number between min and max
dgabino 0:60ff878b27b8 53 *
dgabino 0:60ff878b27b8 54 * \param [IN] min range minimum value
dgabino 0:60ff878b27b8 55 * \param [IN] max range maximum value
dgabino 0:60ff878b27b8 56 * \retval random random value in range min..max
dgabino 0:60ff878b27b8 57 */
dgabino 0:60ff878b27b8 58 int32_t randr( int32_t min, int32_t max );
dgabino 0:60ff878b27b8 59
dgabino 0:60ff878b27b8 60 /*!
dgabino 0:60ff878b27b8 61 * \brief Copies size elements of src array to dst array
dgabino 0:60ff878b27b8 62 *
dgabino 0:60ff878b27b8 63 * \remark STM32 Standard memcpy function only works on pointers that are aligned
dgabino 0:60ff878b27b8 64 *
dgabino 0:60ff878b27b8 65 * \param [OUT] dst Destination array
dgabino 0:60ff878b27b8 66 * \param [IN] src Source array
dgabino 0:60ff878b27b8 67 * \param [IN] size Number of bytes to be copied
dgabino 0:60ff878b27b8 68 */
dgabino 0:60ff878b27b8 69 void memcpy1( uint8_t *dst, const uint8_t *src, uint16_t size );
dgabino 0:60ff878b27b8 70
dgabino 0:60ff878b27b8 71 /*!
dgabino 0:60ff878b27b8 72 * \brief Copies size elements of src array to dst array reversing the byte order
dgabino 0:60ff878b27b8 73 *
dgabino 0:60ff878b27b8 74 * \param [OUT] dst Destination array
dgabino 0:60ff878b27b8 75 * \param [IN] src Source array
dgabino 0:60ff878b27b8 76 * \param [IN] size Number of bytes to be copied
dgabino 0:60ff878b27b8 77 */
dgabino 0:60ff878b27b8 78 void memcpyr( uint8_t *dst, const uint8_t *src, uint16_t size );
dgabino 0:60ff878b27b8 79
dgabino 0:60ff878b27b8 80 /*!
dgabino 0:60ff878b27b8 81 * \brief Set size elements of dst array with value
dgabino 0:60ff878b27b8 82 *
dgabino 0:60ff878b27b8 83 * \remark STM32 Standard memset function only works on pointers that are aligned
dgabino 0:60ff878b27b8 84 *
dgabino 0:60ff878b27b8 85 * \param [OUT] dst Destination array
dgabino 0:60ff878b27b8 86 * \param [IN] value Default value
dgabino 0:60ff878b27b8 87 * \param [IN] size Number of bytes to be copied
dgabino 0:60ff878b27b8 88 */
dgabino 0:60ff878b27b8 89 void memset1( uint8_t *dst, uint8_t value, uint16_t size );
dgabino 0:60ff878b27b8 90
dgabino 0:60ff878b27b8 91 /*!
dgabino 0:60ff878b27b8 92 * \brief Converts a nibble to an hexadecimal character
dgabino 0:60ff878b27b8 93 *
dgabino 0:60ff878b27b8 94 * \param [IN] a Nibble to be converted
dgabino 0:60ff878b27b8 95 * \retval hexChar Converted hexadecimal character
dgabino 0:60ff878b27b8 96 */
dgabino 0:60ff878b27b8 97 int8_t Nibble2HexChar( uint8_t a );
dgabino 0:60ff878b27b8 98
dgabino 0:60ff878b27b8 99 #endif // __UTILITIES_H__