You can set only the desidered parameter, the other will be set to default value.
configuration_to_set=Configuration('400T22D')configuration_to_set.ADDL=0x02configuration_to_set.ADDH=0x01configuration_to_set.CHAN=23configuration_to_set.SPED.airDataRate=AirDataRate.AIR_DATA_RATE_100_96configuration_to_set.SPED.uartParity=UARTParity.MODE_00_8N1configuration_to_set.SPED.uartBaudRate=UARTBaudRate.BPS_9600configuration_to_set.OPTION.transmissionPower=TransmissionPower('400T22D').\
get_transmission_power().POWER_10# or# configuration_to_set.OPTION.transmissionPower = TransmissionPower22.POWER_10configuration_to_set.OPTION.RSSIAmbientNoise=RssiAmbientNoiseEnable.RSSI_AMBIENT_NOISE_ENABLEDconfiguration_to_set.OPTION.subPacketSetting=SubPacketSetting.SPS_064_10configuration_to_set.TRANSMISSION_MODE.fixedTransmission=FixedTransmission.FIXED_TRANSMISSIONconfiguration_to_set.TRANSMISSION_MODE.WORPeriod=WorPeriod.WOR_1500_010configuration_to_set.TRANSMISSION_MODE.enableLBT=LbtEnableByte.LBT_DISABLEDconfiguration_to_set.TRANSMISSION_MODE.enableRSSI=RssiEnableByte.RSSI_ENABLEDconfiguration_to_set.CRYPT.CRYPT_H=1configuration_to_set.CRYPT.CRYPT_L=1# Set the new configuration on the LoRa module and print the updated configuration to the consolecode,confSetted=lora.set_configuration(configuration_to_set)
I create a CONSTANTS class for each parameter, here a list:
AirDataRate, UARTBaudRate, UARTParity, TransmissionPower, ForwardErrorCorrectionSwitch, WirelessWakeUpTime, IODriveMode, FixedTransmission
Send string message
Here an example of send data, you can pass a string
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: WOR microcontroller and Arduino shield
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: WOR microcontroller and WeMos D1 shield
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: WOR microcontroller and esp32 dev v1 shield
LLCC68
LoRa Smart Home (LLCC68) is a sub-GHz LoRa® RF Transceiver for medium-range indoor and indoor to outdoor wireless applications. SPI interface. Pin-to-pin is compatible with SX1262. SX1261, SX1262, SX1268, and LLCC68 are designed for long battery life with just 4.2 mA of active receive current consumption. The SX1261 can transmit up to +15 dBm, and the SX1262, SX1268, and LLCC68 can transmit up to +22 dBm with highly efficient integrated power amplifiers.
These devices support LoRa modulation for LPWAN use cases and (G)FSK modulation for legacy use cases. The devices are highly configurable to meet different application requirements for consumer use. The device provides LoRa modulation compatible with Semtech transceivers used by the LoRaWAN® specification released by the LoRa Alliance®. The radio is suitable for systems targeting compliance with radio regulations, including but not limited to ETSI EN 300 220, FCC CFR 47 Part 15, China regulatory requirements, and the Japanese ARIB T-108. Continuous frequency coverage from 150MHz to 960MHz allows the support of all major sub-GHz ISM bands around the world.
Features
The new LoRa spread spectrum modulation technology developed based on LLCC68, it brings a more extended communication distance and stronger anti-interference ability;
Support users to set the communication key by themselves, and it cannot be read, which significantly improves the confidentiality of user data;
Support LBT function, monitor the channel environment noise before sending, which significantly improves the communication success rate of the module in harsh environments;
Support RSSI signal strength indicator function for evaluating signal quality, improving communication network, and ranging;
Support air wakeup, that is ultra-low power consumption, suitable for battery-powered applications;
Support point to point transmission, broadcast transmission, channel sense;
Support deep sleep, the power consumption of the whole machine is about 5uA in this mode;
The module has built-in PA+LNA, and the communication distance can reach 5km under ideal conditions;
The parameters are saved after power-off, and the module will work according to the set parameters after power-on;
Efficient watchdog design, once an exception occurs, the module will automatically restart and continue to work according to the previous parameter settings;
Support the bit rate of2.4k~62.5kbps;
Support 3.0~5.5V power supply, power supply greater than 5V can guarantee the best performance;
Industrial standard design, supporting long-term use at -40~+85℃;
Comparison
LLCC68
SX1278-SX1276
Distance
> 11Km
8Km
Rate (LoRa)
1.76Kbps – 62.5Kbps
0.3Kbps – 19.2Kbps
Sleep power consumption
2µA
5µA
Library
Library for Ebyte LoRa E220 LLCC68 device for Arduino, esp32 or esp8266.
Pinout
Pin No.
Pin item
Pin direction
Pin application
1
M0
Input(weak pull-up)
Work with M1 & decide the four operating modes. Floating is not allowed; it can be ground.
2
M1
Input(weak pull-up)
Work with M0 & decide the four operating modes. Floating is not allowed; it can be ground.
3
RXD
Input
TTL UART inputs connect to external (MCU, PC) TXD output pin. It can be configured as open-drain or pull-up input.
4
TXD
Output
TTL UART outputs connect to external RXD (MCU, PC) input pin. Can be configured as open-drain or push-pull output
5
AUX
Output
To indicate the module’s working status & wake up the external MCU. During the procedure of self-check initialization, the pin outputs a low level. It can be configured as open-drain or push-pull output (floating is allowed).
6
VCC
Power supply 3V~5.5V DC
7
GND
Ground
As you can see, you can set various modes via M0 and M1 pins.
Mode
M1
M0
Explanation
Normal
0
0
UART and wireless channels are open, and transparent transmission is on
WOR Transmitter
0
1
WOR Transmitter
WOR Receiver
1
0
WOR Receiver (Supports wake up over air)
Deep sleep mode
1
1
The module goes to sleep (automatically wake up when configuring parameters)
Some pins can be used statically, but If you connect them to the microcontroller and configure them in the library, you gain in performance and can control all modes via software. Still, we are going to explain better next.
Fully connected schema
As I already said, It’s not essential to connect all pins to the microcontroller’s output; you can put M0 and M1 pins to HIGH or LOW to get the desired configuration. If you don’t connect AUX, the library set a reasonable delay to ensure that the operation is complete (If you have trouble with the device freezing, you must put a pull-up 4.7k resistor or better connect to the device. ).
AUX pin
When transmitting data can be used to wake up external MCU and return HIGH on data transfer finish.
When receiving, AUX goes LOW and returns HIGH when the buffer is empty.
It’s also used for self-checking to restore regular operation (on power-on and sleep/program mode).
esp8266
esp8266 connection schema is more straightforward because it works at the same voltage of logical communications (3.3v).
It’s essential to add a pull-up resistor (4,7Kohm) to get good stability.
E22
esp8266
M0
D7
M1
D6
TX
PIN D2 (PullUP 4,7KΩ)
RX
PIN D3 (PullUP 4,7KΩ)
AUX
PIN D5 (PullUP 4,7KΩ)
VCC
5V (but work with less power in 3.3v)
GND
GND
esp32
Similar connection schema for esp32, but for RX and TX, we use RX2 and TX2 because, by default, esp32 doesn’t have SoftwareSerial but has 3 Serial.
Instruction and assembly video on 6 part of the guide
Ebyte LoRa E220 LLCC68 device for Arduino, esp32 or esp8266: library
LoRa or Long Range wireless data telemetryis a technology pioneered by Semtech that operates at a lower frequency than NRF24L01 (433 MHz, 868 MHz, or 916 MHz against 2.4 GHz for the NRF24L01) but at thrice the distance (from 5000m to 11000m).
Information about data rate parity bit and Air data rate
02H
OPTION
Type of transmission, packet size, allow the special message
03H
CHAN
Communication channel(410M + CHAN*1M), default 17H (433MHz), valid only for 433MHz device check below to check the correct frequency of your device
04H
OPTION
Type of transmission, packet size, allow the special message
05H
TRANSMISSION_MODE
A lot of parameters that specify the transmission modality
06H
CRYPT
Encryption to avoid interception
07H
SPED detail
UART Parity bit: UART mode can be different between communication parties
UART parity bit
Constant value
8N1 (default)
MODE_00_8N1
8O1
MODE_01_8O1
8E1
MODE_10_8E1
8N1 (equal to 00)
MODE_11_8N1
UART baud rate: UART baud rate can be different between communication parties (but not reccomended). The UART baud rate has nothing to do with wireless transmission parameters & won’t affect the wireless transmit/receive features.
TTL UART baud rate(bps)
Constant value
1200
UART_BPS_1200
2400
UART_BPS_2400
4800
UART_BPS_4800
9600 (default)
UART_BPS_9600
19200
UART_BPS_19200
38400
UART_BPS_38400
57600
UART_BPS_57600
115200
UART_BPS_115200
Air data rate: The lower the air data rate, the longer the transmitting distance, better anti-interference performance, and longer transmitting time; the air data rate must be constant for both communication parties.
Air data rate(bps)
Constant value
2.4k
AIR_DATA_RATE_000_24
2.4k
AIR_DATA_RATE_001_24
2.4k (default)
AIR_DATA_RATE_010_24
4.8k
AIR_DATA_RATE_011_48
9.6k
AIR_DATA_RATE_100_96
19.2k
AIR_DATA_RATE_101_192
38.4k
AIR_DATA_RATE_110_384
62.5k
AIR_DATA_RATE_111_625
OPTION detail
Sub packet setting
This is the max length of the packet.
When the data is smaller than the subpacket length, the serial output of the receiving end is an uninterrupted continuous output. The receiving end serial port will output the subpacket when the data is larger than the subpacket length.
Packet size
Constant value
200bytes (default)
SPS_200_00
128bytes
SPS_128_01
64bytes
SPS_064_10
32bytes
SPS_032_11
RSSI Ambient noise enable
This command can enable/disable the management type of RSSI, and It’s essential to manage the remote configuration. Pay attention isn’t the RSSI parameter in the message.
When enabled, the C0, C1, C2, C3 commands can be sent in the transmitting mode or WOR transmitting mode to read the register. Register 0x00: Current ambient noise RSSI Register 0X01: RSSI when the data was received last time.
RSSI Ambient noise enable
Constant value
Enable
RSSI_AMBIENT_NOISE_ENABLED
Disable (default)
RSSI_AMBIENT_NOISE_DISABLED
Transmission power
You can change this set of constants by applying a define like so:
#define E220_22 // default value without set
Applicable for E220 with 22dBm as max power. Low power transmission is not recommended due to its low power supply efficiency.
Transmission power (approximation)
Constant value
22dBm (default)
POWER_22
17dBm
POWER_17
13dBm
POWER_13
10dBm
POWER_10
Applicable for E220 with 30dBm as max power. Low power transmission is not recommended due to its low power supply efficiency.
#define E220_30
Transmission power (approximation)
Constant value
30dBm (default)
POWER_30
27dBm
POWER_27
24dBm
POWER_24
21dBm
POWER_21
You can configure Channel frequency also with this define:
// One of
#define FREQUENCY_433
#define FREQUENCY_170
#define FREQUENCY_470
#define FREQUENCY_868
#define FREQUENCY_915
TRANSMISSION_MODE Detail
Enable RSSI
When enabled, the module receives wireless data, and it will follow an RSSI strength byte after output via the serial port TXD
Enable RSSI
Constant value
Enable
RSSI_ENABLED
Disable (default)
RSSI_DISABLED
Transmission type
Transmission mode: The first three bytes of each user’s data frame can be used as high/low address and channel in fixed transmission mode. The module changes its address and channel when transmitted. And it will revert to the original setting after completing the process.
Fixed transmission enabling bit
Constant value
Fixed transmission mode
FT_FIXED_TRANSMISSION
Transparent transmission mode (default)
FT_TRANSPARENT_TRANSMISSION
Monitor data before transmission
When enabled, wireless data will be monitored before it is transmitted, avoiding interference to a certain extent, but may cause data delay.
LBT enable byte
Constant value
Enable
LBT_ENABLED
Disable (default)
LBT_DISABLED
WOR cycle
If WOR is transmitting: after the WOR receiver receives the wireless data and outputs it through the serial port, it will wait for 1000ms before entering the WOR again. Users can input the serial port data and return it via wireless during this period. Each serial byte will be refreshed for 1000ms. Users must transmit the first byte within 1000ms.
Period T = (1 + WOR) * 500ms, maximum 4000ms, minimum 500ms
The longer the WOR monitoring interval period, the lower the average power consumption, but the greater the data delay
Both the transmitter and the receiver must be the same (very important).
Wireless wake-up time
Constant value
500ms
WAKE_UP_500
1000ms
WAKE_UP_1000
1500ms
WAKE_UP_1500
2000ms (default)
WAKE_UP_2000
2500ms
WAKE_UP_2500
3000ms
WAKE_UP_3000
3500ms
WAKE_UP_3500
4000ms
WAKE_UP_4000
Check buffer
First, we must introduce a simple but practical method to check if something is in the receiving buffer.
int available();
It’s simple to return how many bytes you have in the current stream.
Send receive messages
Normal transmission mode
Normal/Transparent transmission mode sends messages to all devices with the same address and channel.
Fixed transmission
Fixed transmission have more scenarios
Thanks
Now you have all information to do your work, but I think It’s important to show some real examples to understand better all the possibilities.
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: settings and basic usage
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: library
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: configuration
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: fixed transmission, broadcast, monitor, and RSSI
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: power saving and sending structured data
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: WOR microcontroller and Arduino shield
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: WOR microcontroller and WeMos D1 shield
Ebyte LoRa E220 device for Arduino, esp32 or esp8266: WOR microcontroller and esp32 dev v1 shield