LoRa communication platform module. More...

#include <LoRa.h>

Inheritance diagram for Loom_LoRa:

Public Member Functions
CONSTRUCTORS / DESTRUCTOR
	Loom_LoRa (LoomManager *device_manager, const uint16_t max_message_len=RH_RF95_MAX_MESSAGE_LEN, const uint8_t address=0, const uint8_t power_level=23, const uint8_t retry_count=3, const uint16_t retry_timeout=200)
	LoRa module constructor. More...

	Loom_LoRa (LoomManager *device_manager, JsonArrayConst p)
	Constructor that takes Json Array, extracts args and delegates to regular constructor. More...

	~Loom_LoRa ()=default
	Destructor. More...

OPERATION
void	add_config (JsonObject json) override
	Add configuration information to JsonObject. More...

void	power_up () override
	Turn on any hardware. More...

void	power_down () override
	Turn off any hardware. More...

PRINT INFORMATION
void	print_config () const override
	Display the configuration settings of the module. More...

GETTERS
uint8_t	get_address () const override
	Get the address of this device. More...

SETTERS
void	set_address (const uint8_t addr) override
	Set the address of this device. More...

Public Member Functions inherited from LoomCommPlat
	LoomCommPlat (LoomManager manager, const char module_name, const LoomModule::Type module_type, const uint16_t max_message_len)
	Constructor. More...

virtual	~LoomCommPlat ()=default
	Destructor. More...

virtual void	package (JsonObject json) override
	Package a modules measurements or state. More...

bool	receive_blocking (JsonObject json, uint max_wait_time)
	Receive, but block until packet received, or timeout reached. More...

bool	receive (JsonObject json)
	Build json from packet if any exists. More...

bool	receive_batch ()
	Receive and immediately create a batch file from JSON receieved. More...

bool	receive_batch_blocking (uint max_wait_time)
	Receive, and block until packet recieved or timeout, and immediately create a batch file from JSON receieved. More...

bool	receive ()
	Version of receive for use with LoomManager. More...

bool	receive_blocking (const uint max_wait_time)
	Version of receive_blocking for use with LoomManager. More...

JsonObject	pre_merge_receive_blocking (JsonObject json)
	Giving the header of the Package from the other board. More...

bool	merge_json (JsonObject json, const uint8_t loop)
	It will merge all the small packages into one big package. More...

bool	send (JsonObject json, const uint8_t destination)
	Send json to a specific address. More...

bool	send (const uint8_t destination)
	Version of send for use with LoomManager. More...

uint8_t	send_batch (const uint8_t destination, int delay_time)
	Sends all the jsons stored in the batch. More...

uint16_t	determine_json_size (JsonObject json)
	Return the size of the json to determing wether to send as split or not. More...

bool	split_send_notification (JsonObject json, const uint8_t destination)
	If the json is over 251, then it let the user the know that it will be sending small mulitple jsons with how many will it be splited into. More...

bool	split_send (JsonObject json, const uint8_t destination, const uint8_t index)
	The actual processing spliting into small json. More...

void	broadcast (JsonObject json)
	Broadcast data to all that can receive. More...

void	broadcast ()
	Version of send for use with LoomManager. More...

void	broadcast_batch (int delay_time)
	Broadcasts all the jsons stored in the batch. More...

virtual void	print_state () const override
	Display current state of the module. More...

float	get_drop_rate () const
	Get the packet drop rate since the start of operation. More...

float	get_last_ten_drop_rate () const
	Get the packet drop rate of the last ten send() calls. More...

Public Member Functions inherited from LoomModule
	LoomModule (LoomManager manager, const char module_name="Unknown", const Type module_type=Type::Unknown)
	Constructor. More...

virtual	~LoomModule ()=default
	Destructor. More...

virtual void	second_stage_ctor ()
	Second stage construction. More...

virtual bool	dispatch (JsonObject json)
	Route command to driver. More...

Type	get_module_type () const
	Get module type. More...

LoomManager *	get_device_manager () const
	Get the device manager class if linked. More...

void	get_module_name (char *buf) const
	Copy module name into buffer. More...

const char *	get_module_name () const
	Get module name. More...

Verbosity	get_print_verbosity () const
	Get print verbosity. More...

Verbosity	get_package_verbosity () const
	Get package verbosity. More...

bool	get_active () const
	Get whether or not the module should be treated as active. More...

Category	category () const
	Get the category of the module. More...

virtual void	link_device_manager (LoomManager *LM)
	Add pointer back to device manager. More...

void	set_print_verbosity (const Verbosity v)
	Set print verbosity Controlls level of detail included in debug prints. More...

void	set_package_verbosity (const Verbosity v)
	Set package verbosity. More...

void	set_active (const bool enable)
	Set whether or not the module should be treated as active. More...

Protected Attributes
RH_RF95	driver
	Underlying rf95 object. More...

RHReliableDatagram	manager
	Manager for driver. More...

uint8_t	address
	Device Address (should this be part of LoomCommPlat? – maybe not as each platform handles addresses differently) More...

uint8_t	power_level
	Power level to send at. More...

uint8_t	retry_count
	Number of transmission retries allowed. More...

uint16_t	retry_timeout
	Delay between transmission retries (in milliseconds) More...

Protected Attributes inherited from LoomCommPlat
uint16_t	max_message_len
	The maximum message length. More...

int16_t	signal_strength
	RSSI for Lora (need to determine what the other platforms use) More...

StaticJsonDocument< 1500 >	messageJson
	Document to read incoming data into. More...

DynamicJsonDocument	mergeJson

uint32_t	total_packet_count

uint32_t	total_drop_count

bool	last_ten_dropped [10]

uint8_t	last_ten_dropped_idx

Protected Attributes inherited from LoomModule
const Type	module_type
	Module type. More...

LoomManager *	device_manager
	Pointer to manager. More...

const String	module_name_base
	The name of the module (Should have a DEFAULT but can be overriden if provided to constructor) More...

const char *	module_name

bool	active
	Whether or not the module should be treated as active. More...

Verbosity	print_verbosity
	Print verbosity. More...

Verbosity	package_verbosity
	Package verbosity. More...

RADIO IMPLEMENTATION
bool	receive_blocking_impl (JsonObject json, uint max_wait_time) override
	Receive, but block until packet received, or timeout reached. More...

bool	send_impl (JsonObject json, const uint8_t destination) override
	Send json to a specific address. More...

bool	send_raw (uint8_t *bytes, const uint8_t len, const uint8_t destination)
	Escape hatch for sending raw bytes. More...

bool	receive_blocking_raw (uint8_t *dest, const uint8_t maxlen, const uint max_wait_time)
	Escape hatch for receiving raw bytes. More...

Additional Inherited Members
Public Types inherited from LoomModule
enum	Type { Type::Unknown = 0, Type::Other =1000, Type::Interrupt_Manager, Type::Sleep_Manager, Type::Multiplexer, Type::NTP, Type::TempSync, Type::WarmUp_Manager, Type::Sensor =2000, Type::Analog, Type::Digital, Type::I2C =2100, Type::ADS1115, Type::AS7262, Type::AS7263, Type::AS7265X, Type::FXAS21002, Type::FXOS8700, Type::LIS3DH, Type::MB1232, Type::MMA8451, Type::MPU6050, Type::MS5803, Type::SHT31D, Type::TMP007, Type::TSL2561, Type::TSL2591, Type::ZXGesture, Type::STEMMA, Type::SDI12 =2200, Type::Decagon5TM, Type::DecagonGS3, Type::SPI =2300, Type::MAX31855, Type::MAX31856, Type::L_SERIAL =2400, Type::K30, Type::L_RTC =3000, Type::DS3231, Type::PCF8523, Type::Actuator =4000, Type::Neopixel, Type::Relay, Type::Servo, Type::Stepper, Type::LogPlat =5000, Type::OLED, Type::SDCARD, Type::BATCHSD, Type::CommPlat =6000, Type::LoRa, Type::nRF, Type::Bluetooth, Type::InternetPlat =7000, Type::Ethernet, Type::WiFi, Type::LTE, Type::PublishPlat =8000, Type::GoogleSheets, Type::MaxPub, Type::SpoolPub, Type::SubscribePlats =9000, Type::MaxSub }
	Enum to check against to when finding individual component managed by a LoomManager. More...

enum	Category { Category::Unknown =0, Category::Other =1, Category::Sensor =2, Category::L_RTC =3, Category::Actuator =4, Category::LogPlat =5, Category::CommPlat =6, Category::InternetPlat =7, Category::PublishPlat =8, Category::SubscribePlat =9 }
	Enum to classify modules. More...

Static Public Member Functions inherited from LoomModule
static const char *	enum_verbosity_string (const Verbosity v)
	Get string of name associated with verbosity enum. More...

static const char *	enum_category_string (const Category c)
	Get string of the category associated with a Category. More...

Protected Member Functions inherited from LoomCommPlat
virtual void	broadcast_impl (JsonObject json)
	Broadcast data to all that can receive. More...

bool	json_to_msgpack_buffer (JsonObjectConst json, char *buffer, const uint16_t max_len) const
	Serialize a JsonObject into a MessagePack buffer. More...

bool	msgpack_buffer_to_json (const char *buffer, JsonObject json)
	Deserialize a MessagePack buffer into a JsonObject. More...

void	add_packet_result (const bool did_drop)
	Add the result of a packet to the drop_rate tracker. More...

Protected Member Functions inherited from LoomModule
void	print_module_label () const
	Print the module name as a label. More...

Detailed Description

LoRa communication platform module.

Resources

Constructor & Destructor Documentation

Loom_LoRa::Loom_LoRa	(	LoomManager *	device_manager,
		const uint16_t	max_message_len = `RH_RF95_MAX_MESSAGE_LEN`,
		const uint8_t	address = `0`,
		const uint8_t	power_level = `23`,
		const uint8_t	retry_count = `3`,
		const uint16_t	retry_timeout = `200`
	)

LoRa module constructor.

Parameters

[in]	max_message_len	Set(Int) \| <255> \| {255("Max length")} \| The maximum possible message length
[in]	address	Int \| <01> \| [0-99] \| This device's LoRa address
[in]	power_level	Int \| <23> \| [5-23] \| Transmission power level, low to high power
[in]	retry_count	Int \| <3> \| [0-15] \| Max number of transmission retries
[in]	retry_timeout	Int \| <200>\| [20-500] \| Delay between retransmissions (ms)

Loom_LoRa::Loom_LoRa	(	LoomManager *	device_manager,
		JsonArrayConst	p
	)

Constructor that takes Json Array, extracts args and delegates to regular constructor.

Parameters

[in] p The array of constuctor args to expand

Loom_LoRa::~Loom_LoRa ( )

default

Destructor.

Member Function Documentation

void Loom_LoRa::add_config ( JsonObject json )

overridevirtual

Add configuration information to JsonObject.

LoomManager iterates over modules to build complete configuration

Parameters

[in] json Json configuration object to add to

Reimplemented from LoomModule.

uint8_t Loom_LoRa::get_address ( ) const

inlineoverridevirtual

Get the address of this device.

Each platform may have a different addressing scheme

Returns: The address of this device

Implements LoomCommPlat.

void Loom_LoRa::power_down ( )

overridevirtual

Turn off any hardware.

Reimplemented from LoomModule.

void Loom_LoRa::power_up ( )

overridevirtual

Turn on any hardware.

Reimplemented from LoomModule.

void Loom_LoRa::print_config ( ) const

overridevirtual

Display the configuration settings of the module.

Reimplemented from LoomCommPlat.

bool Loom_LoRa::receive_blocking_impl	(	JsonObject	json,
		uint	max_wait_time
	)

overrideprotectedvirtual

Receive, but block until packet received, or timeout reached.

Parameters

[out]	json	Json object to fill with incoming data
[in]	max_wait_time	Maximum number of milliseconds to block for (can be zero for non-blocking)

Returns: True if packet received

Reimplemented from LoomCommPlat.

bool Loom_LoRa::receive_blocking_raw	(	uint8_t *	dest,
		const uint8_t	maxlen,
		const uint	max_wait_time
	)

Escape hatch for receiving raw bytes.

Parameters

[out]	dest	Pointer to byte array to store data
[in]	maxlen	Maximum length of packet that can be recieved
[in]	max_wait_time	Maximum number of milliseconds to block for

bool Loom_LoRa::send_impl	(	JsonObject	json,
		const uint8_t	destination
	)

overrideprotectedvirtual

Send json to a specific address.

Parameters

[in]	json	Json package to send
[in]	destination	Device to send to

Returns: True if packet sent successfully

Reimplemented from LoomCommPlat.

bool Loom_LoRa::send_raw	(	uint8_t *	bytes,
		const uint8_t	len,
		const uint8_t	destination
	)

Escape hatch for sending raw bytes.

Parameters

[in]	raw	Bytes to send
[in]	len	Number of bytes to send (MUST be less than 251)
[in]	destination	Address of device to send to

Returns: True if packet sent successfully

void Loom_LoRa::set_address ( const uint8_t a )

overridevirtual

Set the address of this device.

Each platform may have a different addressing scheme. Changing the device's address is not recommended.

Parameters

[in] a The address to set this device to

Implements LoomCommPlat.

Member Data Documentation

uint8_t Loom_LoRa::address

protected

Device Address (should this be part of LoomCommPlat? – maybe not as each platform handles addresses differently)

RH_RF95 Loom_LoRa::driver

protected

Underlying rf95 object.

RHReliableDatagram Loom_LoRa::manager

protected

Manager for driver.

uint8_t Loom_LoRa::power_level

protected

Power level to send at.

uint8_t Loom_LoRa::retry_count

protected

Number of transmission retries allowed.

uint16_t Loom_LoRa::retry_timeout

protected

Delay between transmission retries (in milliseconds)

The documentation for this class was generated from the following files:

src/CommPlats/LoRa.h
src/CommPlats/LoRa.cpp

Public Member Functions

Protected Attributes

RADIO IMPLEMENTATION

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation