lpp.c File Reference

Basic Low Power Payload (LPP) functionality. More...

#include <em_device.h>
#include <stdlib.h>
#include <stdint.h>
#include <stdbool.h>
#include "lpp.h"
#include "datatypes.h"
#include "debug_dbprint.h"

Go to the source code of this file.

Macros
#define	LPP_DIGITAL_INPUT   0x00
#define	LPP_ANALOG_INPUT   0x02
#define	LPP_TEMPERATURE   0x67
#define	LPP_HUMIDITY   0x68
#define	LPP_ACCELEROMETER   0x71
#define	LPP_PRESSURE   0x73
#define	LPP_DIGITAL_INPUT_SIZE   0x03
#define	LPP_ANALOG_INPUT_SIZE   0x04
#define	LPP_TEMPERATURE_SIZE   0x04
#define	LPP_HUMIDITY_SIZE   0x03
#define	LPP_ACCELEROMETER_SIZE   0x08
#define	LPP_PRESSURE_SIZE   0x04
#define	LPP_DIGITAL_INPUT_CHANNEL   0x01
#define	LPP_ANALOG_INPUT_CHANNEL   0x02
#define	LPP_TEMPERATURE_CHANNEL   0x03
#define	LPP_HUMIDITY_CHANNEL   0x04
#define	LPP_ACCELEROMETER_CHANNEL   0x05
#define	LPP_PRESSURE_CHANNEL   0x06
#define	LPP_VBAT_CHANNEL   0x10 /* 16 */
#define	LPP_TEMPERATURE_CHANNEL_INT   0x11 /* 17 */
#define	LPP_TEMPERATURE_CHANNEL_EXT   0x12 /* 18 */
#define	LPP_STORM_CHANNEL   0x13 /* 19 */
#define	LPP_CABLE_BROKEN_CHANNEL   0x14 /* 20 */
#define	LPP_STATUS_CHANNEL   0x15 /* 21 */

Functions
bool	LPP_InitBuffer (LPP_Buffer_t *b, uint8_t size)
void	LPP_ClearBuffer (LPP_Buffer_t *b)
void	LPP_FreeBuffer (LPP_Buffer_t *b)
bool	LPP_AddMeasurements (LPP_Buffer_t *b, MeasurementData_t data)
	Add measurement data to the LPP packet following the custom message convention to save bytes to send. More...
bool	LPP_AddStormDetected (LPP_Buffer_t *b, uint8_t stormDetected)
	Add a value to indicate that a storm has been detected to the LPP packet following the custom message convention. More...
bool	LPP_AddCableBroken (LPP_Buffer_t *b, uint8_t cableBroken)
	Add a value to indicate that the cable has been broken to the LPP packet following the custom message convention. More...
bool	LPP_AddStatus (LPP_Buffer_t *b, uint8_t status)
	Add a value to indicate a program status to the LPP packet following the custom message convention. More...
bool	LPP_deprecated_AddVBAT (LPP_Buffer_t *b, int16_t vbat)
	Add a battery voltage measurement to the LPP packet, disguised as an Analog Input packet (2 bytes). The channel is defined by LPP_VBAT_CHANNEL and is 0x10. More...
bool	LPP_deprecated_AddIntTemp (LPP_Buffer_t *b, int16_t intTemp)
	Add an internal temperature measurement (2 bytes) to the LPP packet. The channel is defined by LPP_TEMPERATURE_CHANNEL_INT and is 0x11. More...
bool	LPP_deprecated_AddExtTemp (LPP_Buffer_t *b, int16_t extTemp)
	Add an external temperature measurement (2 bytes) to the LPP packet. The channel is defined by LPP_TEMPERATURE_CHANNEL_EXT and is 0x12. More...
bool	LPP_deprecated_AddStormDetected (LPP_Buffer_t *b, uint8_t stormDetected)
	Add a storm value to the LPP packet, disguised as a Digital Input packet (1 byte). The channel is defined by LPP_STORM_CHANNEL and is 0x13. More...
bool	LPP_deprecated_AddCableBroken (LPP_Buffer_t *b, uint8_t cableBroken)
	Add a cable break value to the LPP packet, disguised as a Digital Input packet (1 byte). The channel is defined by LPP_CABLE_BROKEN_CHANNEL and is 0x14. More...
bool	LPP_deprecated_AddStatus (LPP_Buffer_t *b, uint8_t status)
	Add a status value to the LPP packet, disguised as a Digital Input packet (1 byte). The channel is defined by LPP_STATUS_CHANNEL and is 0x15. More...
bool	LPP_AddDigital (LPP_Buffer_t *b, uint8_t data)
bool	LPP_AddAnalog (LPP_Buffer_t *b, int16_t data)
bool	LPP_AddTemperature (LPP_Buffer_t *b, int16_t data)
bool	LPP_AddHumidity (LPP_Buffer_t *b, uint8_t data)
bool	LPP_AddAccelerometer (LPP_Buffer_t *b, int16_t x, int16_t y, int16_t z)
bool	LPP_AddPressure (LPP_Buffer_t *b, uint16_t data)

Detailed Description

Basic Low Power Payload (LPP) functionality.

Version

2.3

Author

Geoffrey Ottoy
Modified by Brecht Van Eeckhoudt

---

Versions

• v1.0: DRAMCO GitHub version (https://github.com/DRAMCO/EFM32-RN2483-LoRa-Node).
• v1.1: Added custom methods to add specific data to the LPP packet.
• v1.2: Merged methods to use less bytes when sending the data.
• v1.3: Updated documentation.
• v2.0: Updated version number.
• v2.1: Added extra dbprint debugging statements.
• v2.2: Fixed suboptimal buffer logic causing lockups after some runtime.
• v2.3: Chanced logic to clear the buffer before going to sleep.

Definition in file lpp.c.

Macro Definition Documentation

LPP_ACCELEROMETER

#define LPP_ACCELEROMETER   0x71

Definition at line 57 of file lpp.c.

LPP_ACCELEROMETER_CHANNEL

#define LPP_ACCELEROMETER_CHANNEL   0x05

Definition at line 73 of file lpp.c.

LPP_ACCELEROMETER_SIZE

#define LPP_ACCELEROMETER_SIZE   0x08

Definition at line 65 of file lpp.c.

LPP_ANALOG_INPUT

#define LPP_ANALOG_INPUT   0x02

Definition at line 54 of file lpp.c.

LPP_ANALOG_INPUT_CHANNEL

#define LPP_ANALOG_INPUT_CHANNEL   0x02

Definition at line 70 of file lpp.c.

LPP_ANALOG_INPUT_SIZE

#define LPP_ANALOG_INPUT_SIZE   0x04

Definition at line 62 of file lpp.c.

LPP_CABLE_BROKEN_CHANNEL

#define LPP_CABLE_BROKEN_CHANNEL   0x14 /* 20 */

Definition at line 81 of file lpp.c.

LPP_DIGITAL_INPUT

#define LPP_DIGITAL_INPUT   0x00

Definition at line 53 of file lpp.c.

LPP_DIGITAL_INPUT_CHANNEL

#define LPP_DIGITAL_INPUT_CHANNEL   0x01

Definition at line 69 of file lpp.c.

LPP_DIGITAL_INPUT_SIZE

#define LPP_DIGITAL_INPUT_SIZE   0x03

Definition at line 61 of file lpp.c.

LPP_HUMIDITY

#define LPP_HUMIDITY   0x68

Definition at line 56 of file lpp.c.

LPP_HUMIDITY_CHANNEL

#define LPP_HUMIDITY_CHANNEL   0x04

Definition at line 72 of file lpp.c.

LPP_HUMIDITY_SIZE

#define LPP_HUMIDITY_SIZE   0x03

Definition at line 64 of file lpp.c.

LPP_PRESSURE

#define LPP_PRESSURE   0x73

Definition at line 58 of file lpp.c.

LPP_PRESSURE_CHANNEL

#define LPP_PRESSURE_CHANNEL   0x06

Definition at line 74 of file lpp.c.

LPP_PRESSURE_SIZE

#define LPP_PRESSURE_SIZE   0x04

Definition at line 66 of file lpp.c.

LPP_STATUS_CHANNEL

#define LPP_STATUS_CHANNEL   0x15 /* 21 */

Definition at line 82 of file lpp.c.

LPP_STORM_CHANNEL

#define LPP_STORM_CHANNEL   0x13 /* 19 */

Definition at line 80 of file lpp.c.

LPP_TEMPERATURE

#define LPP_TEMPERATURE   0x67

Definition at line 55 of file lpp.c.

LPP_TEMPERATURE_CHANNEL

#define LPP_TEMPERATURE_CHANNEL   0x03

Definition at line 71 of file lpp.c.

LPP_TEMPERATURE_CHANNEL_EXT

#define LPP_TEMPERATURE_CHANNEL_EXT   0x12 /* 18 */

Definition at line 79 of file lpp.c.

LPP_TEMPERATURE_CHANNEL_INT

#define LPP_TEMPERATURE_CHANNEL_INT   0x11 /* 17 */

Definition at line 78 of file lpp.c.

LPP_TEMPERATURE_SIZE

#define LPP_TEMPERATURE_SIZE   0x04

Definition at line 63 of file lpp.c.

LPP_VBAT_CHANNEL

#define LPP_VBAT_CHANNEL   0x10 /* 16 */

Definition at line 77 of file lpp.c.

Function Documentation

LPP_AddAccelerometer()

bool LPP_AddAccelerometer	(	LPP_Buffer_t *	b,
		int16_t	x,
		int16_t	y,
		int16_t	z
	)

Definition at line 630 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if(space < LPP_ACCELEROMETER_SIZE){
        return (false);
    }

    b->buffer[b->fill++] = LPP_ACCELEROMETER_CHANNEL;
    b->buffer[b->fill++] = LPP_ACCELEROMETER;
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & x) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & x);
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & y) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & y);
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & z) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & z);

    return (true);
}

LPP_AddAnalog()

bool LPP_AddAnalog	(	LPP_Buffer_t *	b,
		int16_t	data
	)

Definition at line 586 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if(space < LPP_ANALOG_INPUT_SIZE){
        return (false);
    }

    b->buffer[b->fill++] = LPP_ANALOG_INPUT_CHANNEL;
    b->buffer[b->fill++] = LPP_ANALOG_INPUT;
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & data) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & data);

    return (true);
}

LPP_AddCableBroken()

bool LPP_AddCableBroken	(	LPP_Buffer_t *	b,
		uint8_t	cableBroken
	)

Add a value to indicate that the cable has been broken to the LPP packet following the custom message convention.

This is what each added byte represents:

• byte 0: Amount of measurements (in this case always one)
• byte 1: Cable broken channel (LPP_CABLE_BROKEN_CHANNEL = 0x14)
• byte 2: LPP digital input type (LPP_DIGITAL_INPUT = 0x00)
• byte 3: The cableBroken value

We always need 4 bytes.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	cableBroken	The cable break value.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 317 of file lpp.c.

{
    /* Calculate free space in the buffer */
    uint8_t space = b->length - b->fill;

    /* Return `false` if we don't have the necessary space available */
    if (space < LPP_DIGITAL_INPUT_SIZE + 1) return (false); /* "+1": One extra byte for the amount of measurements */

    /* Fill the first byte with the amount of measurements (in this case always one) */
    b->buffer[b->fill++] = 0x01;

    /* Fill the next bytes following the default LPP packet convention */
    b->buffer[b->fill++] = LPP_CABLE_BROKEN_CHANNEL;
    b->buffer[b->fill++] = LPP_DIGITAL_INPUT;
    b->buffer[b->fill++] = cableBroken;

    return (true);
}

LPP_AddDigital()

bool LPP_AddDigital	(	LPP_Buffer_t *	b,
		uint8_t	data
	)

Definition at line 572 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if(space < LPP_DIGITAL_INPUT_SIZE){
        return (false);
    }

    b->buffer[b->fill++] = LPP_DIGITAL_INPUT_CHANNEL;
    b->buffer[b->fill++] = LPP_DIGITAL_INPUT;
    b->buffer[b->fill++] = data;

    return (true);
}

LPP_AddHumidity()

bool LPP_AddHumidity	(	LPP_Buffer_t *	b,
		uint8_t	data
	)

Definition at line 616 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if(space < LPP_HUMIDITY_SIZE){
        return (false);
    }

    b->buffer[b->fill++] = LPP_HUMIDITY_CHANNEL;
    b->buffer[b->fill++] = LPP_HUMIDITY;
    b->buffer[b->fill++] = data;

    return (true);
}

LPP_AddMeasurements()

bool LPP_AddMeasurements	(	LPP_Buffer_t *	b,
		MeasurementData_t	data
	)

Add measurement data to the LPP packet following the custom message convention to save bytes to send.

This is what each added byte represents, in the case of 2 measurements:

• byte 0: Amount of measurements
• byte 1: Battery voltage channel (LPP_VBAT_CHANNEL = 0x10)
• byte 2: LPP analog input type (LPP_ANALOG_INPUT = 0x02)
• byte 3-4: A battery voltage measurement
• byte 5-6: Another battery voltage measurement (in the case of 2 measurements)
• ...
• byte 7: Internal temperature channel (LPP_TEMPERATURE_CHANNEL_INT = 0x11)
• byte 8: LPP temperature type (LPP_TEMPERATURE = 0x67)
• byte 9-10: An internal temperature measurement
• byte 11-12: Another internal temperature measurement (in the case of 2 measurements)
• ...
• byte 13: External temperature channel (LPP_TEMPERATURE_CHANNEL_EXT = 0x12)
• byte 14: LPP temperature type (LPP_TEMPERATURE = 0x67)
• byte 15-16: An external temperature measurement
• byte 17-18: Another external temperature measurement (in the case of 2 measurements)
• ...

If we have 6 measurements we need 43 bytes:

• 1 byte to hold the amount of measurements
• 2 bytes to hold the battery voltage channel and LPP analog input type
• 6*2bytes to hold the battery voltage measurements
• 2 bytes to hold the internal temperature channel and LPP temperature type
• 6*2bytes to hold the internal temperature measurements
• 2 bytes to hold the external temperature channel and LPP temperature type
• 6*2bytes to hold the external temperature measurements

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	data	The struct which contains the measurements to send using LoRaWAN.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 182 of file lpp.c.

{
#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
    dbinfo("Started adding measurements...");
#endif /* DEBUG_DBPRINT */

    /* Calculate free space in the buffer */
    uint8_t space = b->length - b->fill;

    /* Calculate necessary space, first byte holds the amount of measurements */
    uint8_t necessarySpace = 1;

    /* Add space necessary for the battery voltage and internal and external temperature measurements.
     * (1 byte for the channel ID, 1 byte for the data type, 2 bytes for each measurement) */
    necessarySpace += 3*(2+(2*(data.index)));

    /* Return `false` if we don't have the necessary space available */
    if (space < necessarySpace) return (false);

    /* Fill the first byte with the amount of measurements */
    b->buffer[b->fill++] = data.index;

    /* Fill the next bytes with battery voltage measurements */
    b->buffer[b->fill++] = LPP_VBAT_CHANNEL;
    b->buffer[b->fill++] = LPP_ANALOG_INPUT;

    for (uint8_t i = 0; i < data.index; i++)
    {
        /* Convert battery voltage value (should represent 0.01 signed ) */
        int16_t batteryLPP = (int16_t)(round((float)data.voltage[i]/10));

        b->buffer[b->fill++] = (uint8_t)((0xFF00 & batteryLPP) >> 8);
        b->buffer[b->fill++] = (uint8_t)(0x00FF & batteryLPP);
    }

    /* Fill the next bytes with internal temperature measurements */
    b->buffer[b->fill++] = LPP_TEMPERATURE_CHANNEL_INT;
    b->buffer[b->fill++] = LPP_TEMPERATURE;

    for (uint8_t i = 0; i < data.index; i++)
    {
        /* Convert temperature sensor value (should represent 0.1 °C Signed MSB) */
        int16_t intTempLPP = (int16_t)(round((float)data.intTemp[i]/100));

        b->buffer[b->fill++] = (uint8_t)((0xFF00 & intTempLPP) >> 8);
        b->buffer[b->fill++] = (uint8_t)(0x00FF & intTempLPP);
    }

    /* Fill the next bytes with external temperature measurements */
    b->buffer[b->fill++] = LPP_TEMPERATURE_CHANNEL_EXT;
    b->buffer[b->fill++] = LPP_TEMPERATURE;

    for (uint8_t i = 0; i < data.index; i++)
    {
        /* Convert temperature sensor value (should represent 0.1 °C Signed MSB) */
        int16_t extTempLPP = (int16_t)(round((float)data.extTemp[i]/100));

        b->buffer[b->fill++] = (uint8_t)((0xFF00 & extTempLPP) >> 8);
        b->buffer[b->fill++] = (uint8_t)(0x00FF & extTempLPP);
    }

#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
    dbinfo("Measurements successfully added.");
#endif /* DEBUG_DBPRINT */

    return (true);
}

LPP_AddPressure()

bool LPP_AddPressure	(	LPP_Buffer_t *	b,
		uint16_t	data
	)

Definition at line 649 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if(space < LPP_PRESSURE_SIZE){
        return (false);
    }

    b->buffer[b->fill++] = LPP_PRESSURE_CHANNEL;
    b->buffer[b->fill++] = LPP_PRESSURE;
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & data) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & data);

    return (true);
}

LPP_AddStatus()

bool LPP_AddStatus	(	LPP_Buffer_t *	b,
		uint8_t	status
	)

Add a value to indicate a program status to the LPP packet following the custom message convention.

This is what each added byte represents:

• byte 0: Amount of measurements (in this case always one)
• byte 1: Status channel (LPP_STATUS_CHANNEL = 0x15)
• byte 2: LPP digital input type (LPP_DIGITAL_INPUT = 0x00)
• byte 3: The status value

We always need 4 bytes.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	status	The status value.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 360 of file lpp.c.

{
    /* Calculate free space in the buffer */
    uint8_t space = b->length - b->fill;

    /* Return `false` if we don't have the necessary space available */
    if (space < LPP_DIGITAL_INPUT_SIZE + 1) return (false); /* "+1": One extra byte for the amount of measurements */

    /* Fill the first byte with the amount of measurements (in this case always one) */
    b->buffer[b->fill++] = 0x01;

    /* Fill the next bytes following the default LPP packet convention */
    b->buffer[b->fill++] = LPP_STATUS_CHANNEL;
    b->buffer[b->fill++] = LPP_DIGITAL_INPUT;
    b->buffer[b->fill++] = status;

    return (true);
}

LPP_AddStormDetected()

bool LPP_AddStormDetected	(	LPP_Buffer_t *	b,
		uint8_t	stormDetected
	)

Add a value to indicate that a storm has been detected to the LPP packet following the custom message convention.

This is what each added byte represents:

• byte 0: Amount of measurements (in this case always one)
• byte 1: Storm detected channel (LPP_STORM_CHANNEL = 0x13)
• byte 2: LPP digital input type (LPP_DIGITAL_INPUT = 0x00)
• byte 3: The stormDetected value

We always need 4 bytes.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	stormDetected	If a storm is detected using the accelerometer or not.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 274 of file lpp.c.

{
    /* Calculate free space in the buffer */
    uint8_t space = b->length - b->fill;

    /* Return `false` if we don't have the necessary space available */
    if (space < LPP_DIGITAL_INPUT_SIZE + 1) return (false); /* "+1": One extra byte for the amount of measurements */

    /* Fill the first byte with the amount of measurements (in this case always one) */
    b->buffer[b->fill++] = 0x01;

    /* Fill the next bytes following the default LPP packet convention */
    b->buffer[b->fill++] = LPP_STORM_CHANNEL;
    b->buffer[b->fill++] = LPP_DIGITAL_INPUT;
    b->buffer[b->fill++] = stormDetected;

    return (true);
}

LPP_AddTemperature()

bool LPP_AddTemperature	(	LPP_Buffer_t *	b,
		int16_t	data
	)

Definition at line 601 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if(space < LPP_TEMPERATURE_SIZE){
        return (false);
    }

    b->buffer[b->fill++] = LPP_TEMPERATURE_CHANNEL;
    b->buffer[b->fill++] = LPP_TEMPERATURE;
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & data) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & data);

    return (true);
}

LPP_ClearBuffer()

void LPP_ClearBuffer

(

LPP_Buffer_t *

b

)

Definition at line 118 of file lpp.c.

{
    memset(b->buffer, 0, b->length);
    b->fill = 0;

#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
    dbinfo("> LPP buffer cleared.");
#endif /* DEBUG_DBPRINT */

}

LPP_deprecated_AddCableBroken()

bool LPP_deprecated_AddCableBroken	(	LPP_Buffer_t *	b,
		uint8_t	cableBroken
	)

Add a cable break value to the LPP packet, disguised as a Digital Input packet (1 byte). The channel is defined by LPP_CABLE_BROKEN_CHANNEL and is 0x14.

Deprecated:

This is a deprecated method following the standard LPP format to add data to the LPP packet. The method is kept here just in case.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	cableBroken	The cable break value.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 529 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if (space < LPP_DIGITAL_INPUT_SIZE) return (false);

    b->buffer[b->fill++] = LPP_CABLE_BROKEN_CHANNEL;
    b->buffer[b->fill++] = LPP_DIGITAL_INPUT;
    b->buffer[b->fill++] = cableBroken;

    return (true);
}

LPP_deprecated_AddExtTemp()

bool LPP_deprecated_AddExtTemp	(	LPP_Buffer_t *	b,
		int16_t	extTemp
	)

Add an external temperature measurement (2 bytes) to the LPP packet. The channel is defined by LPP_TEMPERATURE_CHANNEL_EXT and is 0x12.

Deprecated:

This is a deprecated method following the standard LPP format to add data to the LPP packet. In practice it uses too much bytes to send a lot of measurements at once. The method is kept here just in case.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	extTemp	The measured external temperature.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 466 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if (space < LPP_TEMPERATURE_SIZE) return (false);

    b->buffer[b->fill++] = LPP_TEMPERATURE_CHANNEL_EXT;
    b->buffer[b->fill++] = LPP_TEMPERATURE;
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & extTemp) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & extTemp);

    return (true);
}

LPP_deprecated_AddIntTemp()

bool LPP_deprecated_AddIntTemp	(	LPP_Buffer_t *	b,
		int16_t	intTemp
	)

Add an internal temperature measurement (2 bytes) to the LPP packet. The channel is defined by LPP_TEMPERATURE_CHANNEL_INT and is 0x11.

Deprecated:

This is a deprecated method following the standard LPP format to add data to the LPP packet. In practice it uses too much bytes to send a lot of measurements at once. The method is kept here just in case.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	intTemp	The measured internal temperature.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 433 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if (space < LPP_TEMPERATURE_SIZE) return (false);

    b->buffer[b->fill++] = LPP_TEMPERATURE_CHANNEL_INT;
    b->buffer[b->fill++] = LPP_TEMPERATURE;
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & intTemp) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & intTemp);

    return (true);
}

LPP_deprecated_AddStatus()

bool LPP_deprecated_AddStatus	(	LPP_Buffer_t *	b,
		uint8_t	status
	)

Add a status value to the LPP packet, disguised as a Digital Input packet (1 byte). The channel is defined by LPP_STATUS_CHANNEL and is 0x15.

Deprecated:

This is a deprecated method following the standard LPP format to add data to the LPP packet. The method is kept here just in case.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	status	The status value.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 560 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if (space < LPP_DIGITAL_INPUT_SIZE) return (false);

    b->buffer[b->fill++] = LPP_STATUS_CHANNEL;
    b->buffer[b->fill++] = LPP_DIGITAL_INPUT;
    b->buffer[b->fill++] = status;

    return (true);
}

LPP_deprecated_AddStormDetected()

bool LPP_deprecated_AddStormDetected	(	LPP_Buffer_t *	b,
		uint8_t	stormDetected
	)

Add a storm value to the LPP packet, disguised as a Digital Input packet (1 byte). The channel is defined by LPP_STORM_CHANNEL and is 0x13.

Deprecated:

This is a deprecated method following the standard LPP format to add data to the LPP packet. The method is kept here just in case.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	stormDetected	If a storm is detected using the accelerometer or not.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 498 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if (space < LPP_DIGITAL_INPUT_SIZE) return (false);

    b->buffer[b->fill++] = LPP_STORM_CHANNEL;
    b->buffer[b->fill++] = LPP_DIGITAL_INPUT;
    b->buffer[b->fill++] = stormDetected;

    return (true);
}

LPP_deprecated_AddVBAT()

bool LPP_deprecated_AddVBAT	(	LPP_Buffer_t *	b,
		int16_t	vbat
	)

Add a battery voltage measurement to the LPP packet, disguised as an Analog Input packet (2 bytes). The channel is defined by LPP_VBAT_CHANNEL and is 0x10.

Deprecated:

This is a deprecated method following the standard LPP format to add data to the LPP packet. In practice it uses too much bytes to send a lot of measurements at once. The method is kept here just in case.

Parameters

[in]	b	The pointer to the LPP pointer.
[in]	vbat	The measured battery voltage.

Returns

• true - Successfully added the data to the LoRaWAN packet.
• false - Couldn't add the data to the LoRaWAN packet.

Definition at line 400 of file lpp.c.

{
    uint8_t space = b->length - b->fill;
    if (space < LPP_ANALOG_INPUT_SIZE) return (false);

    b->buffer[b->fill++] = LPP_VBAT_CHANNEL;
    b->buffer[b->fill++] = LPP_ANALOG_INPUT;
    b->buffer[b->fill++] = (uint8_t)((0xFF00 & vbat) >> 8);
    b->buffer[b->fill++] = (uint8_t)(0x00FF & vbat);

    return (true);
}

LPP_FreeBuffer()

void LPP_FreeBuffer

(

LPP_Buffer_t *

b

)

Definition at line 129 of file lpp.c.

{
    if (b->buffer != NULL) free(b->buffer); /* This logic was previously in `LPP_ClearBuffer` */

#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
    dbinfo("> LPP buffer freed.");
#endif /* DEBUG_DBPRINT */

}

LPP_InitBuffer()

bool LPP_InitBuffer	(	LPP_Buffer_t *	b,
		uint8_t	size
	)

Definition at line 84 of file lpp.c.

{

#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
    dbinfo("Started initializing LPP buffer...");
#endif /* DEBUG_DBPRINT */

    // LPP_FreeBuffer(b); // Before: LPP_ClearBuffer(b);

    b->buffer = (uint8_t *) malloc(sizeof(uint8_t) * size);

#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
    dbinfo("> Memory allocated.");
#endif /* DEBUG_DBPRINT */

    if(b->buffer != NULL)
    {
        b->fill = 0;
        b->length = size;

#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
        dbinfo("LPP Buffer initialized (returned true).");
#endif /* DEBUG_DBPRINT */

        return (true);
    }

#if DEBUG_DBPRINT == 1 /* DEBUG_DBPRINT */
    dbwarn("LPP Buffer initialized (returned false).");
#endif /* DEBUG_DBPRINT */

    return (false);
}