| Name | ebyte-lora-e22 JSON |
| Version |
0.0.2
JSON |
| download |
| home_page | https://github.com/xreef/EByte_LoRa_E22_micropython_library |
| Summary | MicroPython LoRa EBYTE E22 device library complete and tested with Arduino SAMD, esp8266, esp32, Raspberry, rp2040 and STM32. sx1262/sx1268 |
| upload_time | 2023-04-18 14:13:24 |
| maintainer | Renzo Mischianti |
| docs_url | None |
| author | Renzo Mischianti |
| requires_python | >=3.7 |
| license | The MIT License (MIT) Copyright (c) 2017 Renzo Mischianti www.mischianti.org All right reserved. You may copy, alter and reuse this code in any way you like, but please leave reference to www.mischianti.org in your comments if you redistribute this code. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
| keywords |
lora
uart
ebyte
esp32
esp8266
stm32
samd
arduino
raspberry pi pico
rp2040
micropython
sx1262
sx1268
e22
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div>
<a href="https://www.mischianti.org/forums/forum/mischiantis-libraries/ebyte-lora-e22-uart-devices-sx1262-sx1268//"><img
src="https://github.com/xreef/LoRa_E22_Series_Library/raw/master/resources/buttonSupportForumEnglish.png" alt="Support forum EByte e32 English"
align="right"></a>
</div>
<div>
<a href="https://www.mischianti.org/it/forums/forum/le-librerie-di-mischianti/ebyte-e22-dispositivi-lora-uart-sx1262-sx1268/"><img
src="https://github.com/xreef/LoRa_E22_Series_Library/raw/master/resources/buttonSupportForumItaliano.png" alt="Forum supporto EByte e32 italiano"
align="right"></a>
</div>
#
# EBYTE LoRa E22 devices micropython library (SX1262, SX1268)
### Changelog
- 2023-04-18 0.0.2 Fix regular expression and better constant management
- 2023-03-21 0.0.1 Fully functional library
### Library usage
Here an example of constructor, you must pass the UART interface and (if you want, but It's reccomended)
the AUX pin, M0 and M1.
### Installation
To install the library execute the following command:
```bash
pip install ebyte-lora-e22
```
#### Initialization
```python
from lora_e22 import LoRaE22
from machine import UART
uart2 = UART(2)
lora = LoRaE22('400T22D', uart2, aux_pin=15, m0_pin=21, m1_pin=19)
```
#### Start the module transmission
```python
code = lora.begin()
print("Initialization: {}", ResponseStatusCode.get_description(code))
```
#### Get Configuration
```python
from lora_e22 import LoRaE22, print_configuration
from lora_e22_operation_constant import ResponseStatusCode
code, configuration = lora.get_configuration()
print("Retrieve configuration: {}", ResponseStatusCode.get_description(code))
print_configuration(configuration)
```
The result
```
# ----------------------------------------
# HEAD : 0xc1 0x0 0x9
#
# AddH : 0x0
# AddL : 0x0
#
# Chan : 23 -> 433
#
# SpeedParityBit : 0b0 -> 8N1 (Default)
# SpeedUARTDatte : 0b11 -> 9600bps (default)
# SpeedAirDataRate : 0b10 -> 2.4kbps (default)
#
# OptionSubPacketSett: 0b0 -> 240bytes (default)
# OptionTranPower : 0b0 -> 22dBm (Default)
# OptionRSSIAmbientNo: 0b0 -> Disabled (default)
#
# TransModeWORPeriod : 0b11 -> 2000ms (default)
# TransModeTransContr: 0b0 -> WOR Receiver (default)
# TransModeEnableLBT : 0b0 -> Disabled (default)
# TransModeEnableRSSI: 0b0 -> Disabled (default)
# TransModeEnabRepeat: 0b0 -> Disabled (default)
# TransModeFixedTrans: 0b0 -> Transparent transmission (default)
# ----------------------------------------
```
#### Set Configuration
You can set only the desidered parameter, the other will be set to default value.
```python
configuration_to_set = Configuration('400T22D')
configuration_to_set.ADDL = 0x02
configuration_to_set.ADDH = 0x01
configuration_to_set.CHAN = 23
configuration_to_set.NETID = 0
configuration_to_set.SPED.airDataRate = AirDataRate.AIR_DATA_RATE_100_96
configuration_to_set.SPED.uartParity = UARTParity.MODE_00_8N1
configuration_to_set.SPED.uartBaudRate = UARTBaudRate.BPS_9600
configuration_to_set.OPTION.subPacketSetting = SubPacketSetting.SPS_064_10
configuration_to_set.OPTION.transmissionPower = TransmissionPower('400T22D').\
get_transmission_power().POWER_10
# or
# configuration_to_set.OPTION.transmissionPower = TransmissionPower22.POWER_10
configuration_to_set.OPTION.RSSIAmbientNoise = RssiAmbientNoiseEnable.RSSI_AMBIENT_NOISE_ENABLED
configuration_to_set.TRANSMISSION_MODE.WORTransceiverControl = WorTransceiverControl.WOR_TRANSMITTER
configuration_to_set.TRANSMISSION_MODE.enableLBT = LbtEnableByte.LBT_DISABLED
configuration_to_set.TRANSMISSION_MODE.enableRSSI = RssiEnableByte.RSSI_ENABLED
configuration_to_set.TRANSMISSION_MODE.enableRepeater = RepeaterModeEnableByte.REPEATER_DISABLED
configuration_to_set.TRANSMISSION_MODE.fixedTransmission = FixedTransmission.FIXED_TRANSMISSION
configuration_to_set.TRANSMISSION_MODE.WORPeriod = WorPeriod.WOR_1500_010
configuration_to_set.CRYPT.CRYPT_H = 1
configuration_to_set.CRYPT.CRYPT_L = 1
# Set the new configuration on the LoRa module and print the updated configuration to the console
code, 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
```python
lora.send_transparent_message('pippo')
```
```python
lora.send_fixed_message(0, 2, 23, 'pippo')
```
Here the receiver code
```python
while True:
if lora.available() > 0:
code, value = lora.receive_message()
print(ResponseStatusCode.get_description(code))
print(value)
utime.sleep_ms(2000)
```
If you want receive RSSI also you must enable it in the configuration
```python
configuration_to_set.TRANSMISSION_MODE.enableRSSI = RssiEnableByte.RSSI_ENABLED
```
and set the flag to True in the receive_message method
```python
code, value, rssi = lora.receive_message(True)
```
Result
```
Success!
pippo
```
#### Send dictionary message
Here an example of send data, you can pass a dictionary
```python
lora.send_transparent_dict({'pippo': 'fixed', 'pippo2': 'fixed2'})
```
```python
lora.send_fixed_dict(0, 0x01, 23, {'pippo': 'fixed', 'pippo2': 'fixed2'})
```
Here the receiver code
```python
while True:
if lora.available() > 0:
code, value = lora.receive_dict()
print(ResponseStatusCode.get_description(code))
print(value)
print(value['pippo'])
utime.sleep_ms(2000)
```
if you want receive RSSI also you must enable it in the configuration
```python
configuration_to_set.TRANSMISSION_MODE.enableRSSI = RssiEnableByte.RSSI_ENABLED
```
and set the flag to True in the receive_dict method
```python
code, value, rssi = lora.receive_dict(True)
```
Result
```
Success!
{'pippo': 'fixed', 'pippo2': 'fixed2'}
fixed
```
# This is a porting of the Arduino library for EBYTE LoRa E22 devices to Micropython
# Soon a complete tutorial of the original library on my site www.mischianti.org
- [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: settings and basic usage](https://www.mischianti.org/2020/09/25/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-specs-and-basic-usage-1/)
- [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: library](https://www.mischianti.org/2021/01/28/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-library-part-2/)
- [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: configuration](https://www.mischianti.org/2022/03/29/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-configuration-3/)
- [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: fixed transmission and RSSI](https://www.mischianti.org/2022/04/04/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-fixed-transmission-broadcast-monitor-and-rssi-4/)
- [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: power saving and sending structured data](https://www.mischianti.org/2022/04/10/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-power-saving-wor-and-structured-data-5/)
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and Arduino shield
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and WeMos D1 shield
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and esp32 dev v1 shield
https://downloads.arduino.cc/libraries/logs/github.com/xreef/EByte_LoRa_E22_Series_Library/
# An Arduino UNO shield to simplify the use
You can order the PCB [here](https://www.pcbway.com/project/shareproject/LoRa_E32_Series_device_Arduino_shield.html)
Instruction and assembly video on 6 part of the guide
# An WeMos D1 shield to simplify the use
You can order the PCB [here](https://www.pcbway.com/project/shareproject/LoRa_E32_Series_device_WeMos_D1_mini_shield_RF_8km_range.html)
Instruction and assembly video on 6 part of the guide
# LoRa E22 (EBYTE LoRa sx1262/sx1268) series Library for Arduino, esp8266 and esp32-
I create a library to manage EBYTE E22 series of LoRa device, very powerfull, simple and cheap device.
LoRa or Long Range wireless data telemetry is a technology pioneered by Semtech that operates at a lower frequency than NRF24L01 (433 MHz, 868 MHz or 916 MHz agains 2.4 GHz for the NRF24L01) but at thrice the distance (from 4000m to 10000m).
LoRa E22
<p>You can find here <a href="https://s.click.aliexpress.com/e/_dSqbrK5" target="_blank">AliExpress (433MHz 4Km)</a> - <a href="https://s.click.aliexpress.com/e/_dTTkQtn" target="_blank">AliExpress (433MHz 10Km)</a></p>
Please refer to my article to get updated Schema
### Library
You can find my library here.
To download.
Click the DOWNLOADS button in the top right corner, rename the uncompressed folder LoRa_E22.
Check that the LoRa_E22 folder contains LoRa_E22.cpp and LoRa_E22.h.
Place the LoRa_E22 library folder your /libraries/ folder.
You may need to create the libraries subfolder if its your first library.
Restart the IDE.
#### Pinout
E22
<table class="wp-block-advgb-table advgb-table-frontend is-style-stripes" style="border-collapse:collapse"><thead><tr><th style="background-color:#8ed1fc">Pin No. </th><th style="background-color:#8ed1fc"> Pin item </th><th style="background-color:#8ed1fc"> Pin direction </th><th style="background-color:#8ed1fc"> Pin application </th></tr></thead><tbody><tr class="alt"><td>1</td><td>M0</td><td>Input（weak pull-up）</td><td>Work with M1 & decide the four operating modes.Floating is not allowed, can be ground.</td></tr><tr><td>2</td><td>M1</td><td>Input（weak pull-up）</td><td>Work with M0 & decide the four operating modes.Floating is not allowed, can be ground.</td></tr><tr class="alt"><td>3</td><td>RXD</td><td>Input</td><td>TTL UART inputs, connects to external (MCU, PC) TXD outputpin. Can be configured as open-drain or pull-up input.</td></tr><tr><td>4</td><td>TXD</td><td>Output</td><td>TTL UART outputs, connects to external RXD (MCU, PC) inputpin. Can be configured as open-drain or push-pull output</td></tr><tr class="alt"><td><br>5</td><td><br>AUX</td><td><br>Output</td><td>Per indicare lo stato di funzionamento del modulo e riattivare l’MCU esterno. Durante la procedura di inizializzazione di autocontrollo, il pin emette una bassa tensione. Può essere configurato come uscita open-drain o output push-pull (è consentito non metterlo a terra, ma se hai problemi, ad esempio ti si freeze il dispositivo è preferibile mettere una restistenza di pull-up da 4.7k o meglio collegarlo al dispositivo).</td></tr><tr><td>6</td><td>VCC</td><td><br></td><td style="vertical-align:middle">Power supply 2.3V~5.5V DC</td></tr><tr class="alt"><td>7</td><td>GND</td><td><br></td><td>Ground</td></tr></tbody></table>
As you can see you can set various modes via M0 and M1 pins.
<table class="wp-block-advgb-table advgb-table-frontend is-style-stripes"><thead><tr><th style="background-color:#8ed1fc"><strong>Mode</strong> </th><th style="background-color:#8ed1fc"><strong>M1</strong> </th><th style="background-color:#8ed1fc"><strong>M0</strong> </th><th style="background-color:#8ed1fc"><strong>Explanation</strong> </th></tr></thead><tbody><tr class="alt"><td>Normal</td><td>0</td><td>0</td><td>UART and wireless channel are open, transparent transmission is on (Supports configuration over air via special command)</td></tr><tr><td>WOR Mode</td><td>0</td><td>1</td><td>Can be defined as WOR transmitter and WOR receiver</td></tr><tr class="alt"><td>Configuration mode</td><td>1</td><td>0</td><td>Users can access the register through the serial port to
control the working state of the module</td></tr><tr><td>Deep sleep mode</td><td>1</td><td>1</td><td>Sleep mode</td></tr></tbody></table>
As you can see there are some pins that can be use in a static way, but If you connect It to the library you gain in performance and you can control all mode via software, but we are going to explain better next.
### Fully connected schema
As I already say It’s not important to connect all pin to the output of microcontroller, you can put M0 and M1 pins to HIGH or LOW to get desidered configuration, and **if you don’t connect AUX the library set a reasonable delay to be sure that the operation is complete**.
#### AUX pin
When transmitting data can be used to wake up external MCU and return HIGH on data transfer finish.
LoRa E22 AUX Pin on transmission
When receiving AUX going LOW and return HIGH when buffer is empty.
LoRa e22 AUX pin on reception
It’s also used for self checking to restore normal operation (on power-on and sleep/program mode).
LoRa e22 AUX pin on self-check
esp8266 connection schema is more simple because It work at the same voltage of logical communications (3.3v).
LoRa E22 TTL 100 Wemos D1 fully connected
It’s important to add pull-up resistor (4,7Kohm) to get good stability.
<figure class="wp-block-table is-style-stripes"><table><thead><tr class="alt"><th>E22</th><th>esp8266</th></tr></thead><tbody><tr><td>M0</td><td>D7</td></tr><tr class="alt"><td>M1</td><td>D6</td></tr><tr><td>TX</td><td>PIN D2 (PullUP 4,7KΩ)</td></tr><tr class="alt"><td>RX</td><td>PIN D3 (PullUP 4,7KΩ)</td></tr><tr><td>AUX</td><td>PIN D5 (PullUP 4,7KΩ)</td></tr><tr class="alt"><td>VCC</td><td>5V (but work with less power in 3.3v)</td></tr><tr><td>GND</td><td>GND</td></tr><tr class="alt"><td></td><td></td></tr></tbody></table></figure>
Similar connection schema for esp32, but for RX and TX we use RX2 and TX2, because by default esp32 doesn’t have SoftwareSerial but have 3 Serial.
Ebyte LoRa E22 device esp32 dev kit v1 breadboard full connection
<table><thead><tr><th>E22</th><th>esp32</th></tr></thead><tbody><tr class="alt"><td>M0</td><td>D21</td></tr><tr><td>M1</td><td>D19</td></tr><tr class="alt"><td>TX</td><td>PIN RX2 (PullUP 4,7KΩ)</td></tr><tr><td>RX</td><td>PIN TX3 (PullUP 4,7KΩ)</td></tr><tr class="alt"><td>AUX</td><td>PIN D18 (PullUP 4,7KΩ)</td></tr><tr><td>VCC</td><td>5V (but work with less power in 3.3v)</td></tr><tr class="alt"><td>GND</td><td>GND</td></tr><tr><td></td><td></td></tr></tbody></table>
#### Basic configuration option
<table class="wp-block-advgb-table advgb-table-frontend"><tbody><tr class="alt"><td style="background-color:#eeeeee">ADDH</td><td>High address byte of module (the default 00H)</td><td>00H-FFH</td></tr><tr><td style="background-color:#eeeeee">ADDL</td><td>Low address byte of module (the default 00H)</td><td>00H-FFH</td></tr><tr class="alt"><td style="background-color:#eeeeee">SPED</td><td>Information about data rate parity bit and Air data rate</td><td></td></tr><tr><td style="background-color:#eeeeee">CHAN</td><td>Communication channel（410M + CHAN*1M）, default 17H (433MHz), <strong>valid only for 433MHz device</strong> chek below to check the correct frequency of your device</td><td>00H-1FH</td></tr><tr class="alt"><td style="background-color:#eeeeee">OPTION</td><td>Type of transmission, packet size, allow special message</td><td></td></tr><tr><td style="background-color:#eeeeee">TRANSMISSION_MODE</td><td>A lot of parameter that specify the transmission modality</td><td></td></tr></tbody></table>
OPTION
Type of transmission, pull-up settings, wake-up time, FEC, Transmission power
#### SPED detail
UART Parity bit: _UART mode can be different between communication parties_
<table class="wp-block-advgb-table advgb-table-frontend"><tbody><tr class="alt"><td style="background-color:#8ed1fc">4</td><td style="background-color:#8ed1fc">3</td><td style="background-color:#8ed1fc">UART parity bit</td><td style="background-color:#fcb900">Constant value</td></tr><tr><td>0</td><td>0</td><td>8N1 (default)</td><td>MODE_00_8N1</td></tr><tr class="alt"><td>0</td><td>1</td><td>8O1</td><td>MODE_01_8O1</td></tr><tr><td>1</td><td>0</td><td>8 E1</td><td>MODE_10_8E1</td></tr><tr class="alt"><td>1</td><td>1</td><td>8N1 (equal to 00)</td><td>MODE_11_8N1</td></tr></tbody></table>
UART baud rate: UART baud rate can be different between communication parties, The UART baud rate has nothing to do with wireless transmission parameters & won’t affect the wireless transmit / receive features.
<table class="wp-block-advgb-table advgb-table-frontend"><tbody><tr><td style="background-color:#8ed1fc">7</td><td style="background-color:#8ed1fc">6</td><td style="background-color:#8ed1fc">5</td><td style="background-color:#8ed1fc">TTL UART baud rate（bps）</td><td style="background-color:#fcb900"> Constant value </td></tr><tr class="alt"><td>0</td><td>0</td><td>0</td><td>1200</td><td>UART_BPS_1200</td></tr><tr><td>0</td><td>0</td><td>1</td><td>2400</td><td>UART_BPS_2400</td></tr><tr class="alt"><td>0</td><td>1</td><td>0</td><td>4800</td><td>UART_BPS_4800</td></tr><tr><td>0</td><td>1</td><td>1</td><td>9600 (default)</td><td>UART_BPS_9600</td></tr><tr class="alt"><td>1</td><td>0</td><td>0</td><td>19200</td><td>UART_BPS_19200</td></tr><tr><td>1</td><td>0</td><td>1</td><td>38400</td><td>UART_BPS_38400</td></tr><tr class="alt"><td>1</td><td>1</td><td>0</td><td>57600</td><td>UART_BPS_57600</td></tr><tr><td>1</td><td>1</td><td>1</td><td>115200</td><td>UART_BPS_115200</td></tr></tbody></table>
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 keep the same for both communication parties.
<table class="wp-block-advgb-table advgb-table-frontend"><tbody><tr class="alt"><td style="background-color:#8ed1fc">2</td><td style="background-color:#8ed1fc">1</td><td style="background-color:#8ed1fc">0</td><td style="background-color:#8ed1fc">Air data rate（bps）</td><td style="background-color:#fcb900"> Constant value </td></tr><tr><td>0</td><td>0</td><td>0</td><td>0.3k</td><td>AIR_DATA_RATE_000_03</td></tr><tr class="alt"><td>0</td><td>0</td><td>1</td><td>1.2k</td><td>AIR_DATA_RATE_001_12</td></tr><tr><td>0</td><td>1</td><td>0</td><td>2.4k (default)</td><td>AIR_DATA_RATE_010_24</td></tr><tr class="alt"><td>0</td><td>1</td><td>1</td><td>4.8k</td><td>AIR_DATA_RATE_011_48</td></tr><tr><td>1</td><td>0</td><td>0</td><td>9.6k</td><td>AIR_DATA_RATE_100_96</td></tr><tr class="alt"><td>1</td><td>0</td><td>1</td><td>19.2k</td><td>AIR_DATA_RATE_101_192</td></tr><tr><td>1</td><td>1</td><td>0</td><td>38.4k</td><td>AIR_DATA_RATE_110_384</td></tr><tr class="alt"><td>1</td><td>1</td><td>1</td><td>62.5k</td><td>AIR_DATA_RATE_111_625</td></tr></tbody></table>
#### OPTION detail
####Sub packet setting
This is the max lenght of the packet.
When the data is smaller than the sub packet length, the serial output of the receiving end is an uninterrupted continuous output. When the data is larger than the sub packet length, the receiving end serial port will output the sub packet.
<table class="wp-block-advgb-table advgb-table-frontend"><tbody><tr><td style="background-color:#8ed1fc">7</td><td style="background-color:#8ed1fc">6</td><td style="background-color:#8ed1fc">Packet size</td><td style="background-color:#fcb900"> Constant value </td></tr><tr class="alt"><td>0</td><td>0</td><td>240bytes (default)</td><td>SPS_240_00</td></tr><tr><td>0</td><td>1</td><td>128bytes</td><td>SPS_128_01</td></tr><tr class="alt"><td>1</td><td>0</td><td>64bytes</td><td>SPS_064_10</td></tr><tr><td>1</td><td>1</td><td>32bytes</td><td>SPS_032_11</td></tr></tbody></table>
####RSSI Ambient noise enable
This command can enable/disable the management type of RSSI, It’s important to manage the remote configuration, pay attention isn’t the RSSI parameter in the message.
When enabled, the C0 C1 C2 C3 command 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.
<table class="wp-block-advgb-table advgb-table-frontend"><tbody><tr class="alt"><td style="background-color:#8ed1fc">5</td><td style="background-color:#8ed1fc">RSSI Ambient noise enable</td><td style="background-color:#fcb900"> Constant value </td></tr><tr><td>0</td><td>Enable</td><td>RSSI_AMBIENT_NOISE_ENABLED</td></tr><tr class="alt"><td>1</td><td>Disable (default)</td><td>RSSI_AMBIENT_NOISE_DISABLED</td></tr></tbody></table>
### 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
####Transmission type
Transmission mode: in fixed transmission mode, the first three bytes of each user’s data frame can be used as high/low address and channel. The module changes its address and channel when transmit. And it will revert to original setting after complete the process.
####Enable repeater function
####Monitor data before transmission
When enabled, wireless data will be monitored before it is transmitted, which can avoid interference to a certain extent, but may cause data delay.
####WOR
WOR transmitter: the module receiving and transmitting functions are turned on, and a wake-up code is added when transmitting data. Receiving is turned on.
WOR receiver: the module is unable to transmit data and works in WOR monitoring mode. The monitoring period is as follows (WOR cycle), which can save a lot of power.
####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 the 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).
### Send receive message
First we must introduce a simple but usefully method to check if something is in the receiving buffer
```cpp
int available();
```
It’s simply return how many bytes you have in the current stream.
#### Normal transmission mode
Normal/Transparent transmission mode is used to send messages to all device with same address and channel.
LoRa E22 transmitting scenarios, lines are channels
Fixed transmission have more scenarios
LoRa E22 transmitting scenarios, lines are channels
## Thanks
Now you have all information to do your work, but I think It’s important to show some realistic examples to undestand better all the possibility.
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: settings and basic usage
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: library
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: configuration
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: fixed transmission and RSSI
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: power saving and sending structured data
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: repeater mode and remote settings
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and Arduino shield
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and WeMos D1 shield
- Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and esp32 dev v1 shield
-
Raw data
{
"_id": null,
"home_page": "https://github.com/xreef/EByte_LoRa_E22_micropython_library",
"name": "ebyte-lora-e22",
"maintainer": "Renzo Mischianti",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "Renzo Mischianti <renzo@mischianti.org>",
"keywords": "LoRa,UART,EByte,esp32,esp8266,stm32,SAMD,Arduino,Raspberry Pi Pico,rp2040,MicroPython,sx1262,sx1268,e22",
"author": "Renzo Mischianti",
"author_email": "Renzo Mischianti <renzo@mischianti.org>",
"download_url": "https://files.pythonhosted.org/packages/1a/69/83ef5db538e83068c6bdb6ba51dd242a2974c1a6b9f04cc065fb15eb3f73/ebyte-lora-e22-0.0.2.tar.gz",
"platform": null,
"description": "<div>\r\n<a href=\"https://www.mischianti.org/forums/forum/mischiantis-libraries/ebyte-lora-e22-uart-devices-sx1262-sx1268//\"><img\r\n src=\"https://github.com/xreef/LoRa_E22_Series_Library/raw/master/resources/buttonSupportForumEnglish.png\" alt=\"Support forum EByte e32 English\"\r\n align=\"right\"></a>\r\n</div>\r\n<div>\r\n<a href=\"https://www.mischianti.org/it/forums/forum/le-librerie-di-mischianti/ebyte-e22-dispositivi-lora-uart-sx1262-sx1268/\"><img\r\n src=\"https://github.com/xreef/LoRa_E22_Series_Library/raw/master/resources/buttonSupportForumItaliano.png\" alt=\"Forum supporto EByte e32 italiano\"\r\n align=\"right\"></a>\r\n</div>\r\n\r\n#\r\n# EBYTE LoRa E22 devices micropython library (SX1262, SX1268)\r\n\r\n\r\n### Changelog\r\n - 2023-04-18 0.0.2 Fix regular expression and better constant management\r\n - 2023-03-21 0.0.1 Fully functional library\r\n\r\n### Library usage\r\nHere an example of constructor, you must pass the UART interface and (if you want, but It's reccomended)\r\nthe AUX pin, M0 and M1.\r\n\r\n### Installation\r\nTo install the library execute the following command:\r\n\r\n```bash\r\npip install ebyte-lora-e22\r\n```\r\n\r\n#### Initialization\r\n\r\n```python\r\nfrom lora_e22 import LoRaE22\r\nfrom machine import UART\r\n\r\nuart2 = UART(2)\r\nlora = LoRaE22('400T22D', uart2, aux_pin=15, m0_pin=21, m1_pin=19)\r\n```\r\n#### Start the module transmission\r\n\r\n```python\r\ncode = lora.begin()\r\nprint(\"Initialization: {}\", ResponseStatusCode.get_description(code))\r\n```\r\n\r\n#### Get Configuration\r\n\r\n```python\r\nfrom lora_e22 import LoRaE22, print_configuration\r\nfrom lora_e22_operation_constant import ResponseStatusCode\r\n\r\ncode, configuration = lora.get_configuration()\r\n\r\nprint(\"Retrieve configuration: {}\", ResponseStatusCode.get_description(code))\r\n\r\nprint_configuration(configuration)\r\n```\r\n\r\nThe result\r\n\r\n```\r\n# ----------------------------------------\r\n# HEAD : 0xc1 0x0 0x9\r\n#\r\n# AddH : 0x0\r\n# AddL : 0x0\r\n#\r\n# Chan : 23 -> 433\r\n#\r\n# SpeedParityBit : 0b0 -> 8N1 (Default)\r\n# SpeedUARTDatte : 0b11 -> 9600bps (default)\r\n# SpeedAirDataRate : 0b10 -> 2.4kbps (default)\r\n#\r\n# OptionSubPacketSett: 0b0 -> 240bytes (default)\r\n# OptionTranPower : 0b0 -> 22dBm (Default)\r\n# OptionRSSIAmbientNo: 0b0 -> Disabled (default)\r\n#\r\n# TransModeWORPeriod : 0b11 -> 2000ms (default)\r\n# TransModeTransContr: 0b0 -> WOR Receiver (default)\r\n# TransModeEnableLBT : 0b0 -> Disabled (default)\r\n# TransModeEnableRSSI: 0b0 -> Disabled (default)\r\n# TransModeEnabRepeat: 0b0 -> Disabled (default)\r\n# TransModeFixedTrans: 0b0 -> Transparent transmission (default)\r\n# ----------------------------------------\r\n```\r\n\r\n#### Set Configuration\r\n\r\nYou can set only the desidered parameter, the other will be set to default value.\r\n```python\r\nconfiguration_to_set = Configuration('400T22D')\r\nconfiguration_to_set.ADDL = 0x02\r\nconfiguration_to_set.ADDH = 0x01\r\nconfiguration_to_set.CHAN = 23\r\n\r\nconfiguration_to_set.NETID = 0\r\n\r\nconfiguration_to_set.SPED.airDataRate = AirDataRate.AIR_DATA_RATE_100_96\r\nconfiguration_to_set.SPED.uartParity = UARTParity.MODE_00_8N1\r\nconfiguration_to_set.SPED.uartBaudRate = UARTBaudRate.BPS_9600\r\n\r\nconfiguration_to_set.OPTION.subPacketSetting = SubPacketSetting.SPS_064_10\r\nconfiguration_to_set.OPTION.transmissionPower = TransmissionPower('400T22D').\\\r\n get_transmission_power().POWER_10\r\n# or\r\n# configuration_to_set.OPTION.transmissionPower = TransmissionPower22.POWER_10\r\nconfiguration_to_set.OPTION.RSSIAmbientNoise = RssiAmbientNoiseEnable.RSSI_AMBIENT_NOISE_ENABLED\r\n\r\nconfiguration_to_set.TRANSMISSION_MODE.WORTransceiverControl = WorTransceiverControl.WOR_TRANSMITTER\r\nconfiguration_to_set.TRANSMISSION_MODE.enableLBT = LbtEnableByte.LBT_DISABLED\r\nconfiguration_to_set.TRANSMISSION_MODE.enableRSSI = RssiEnableByte.RSSI_ENABLED\r\nconfiguration_to_set.TRANSMISSION_MODE.enableRepeater = RepeaterModeEnableByte.REPEATER_DISABLED\r\nconfiguration_to_set.TRANSMISSION_MODE.fixedTransmission = FixedTransmission.FIXED_TRANSMISSION\r\nconfiguration_to_set.TRANSMISSION_MODE.WORPeriod = WorPeriod.WOR_1500_010\r\n\r\nconfiguration_to_set.CRYPT.CRYPT_H = 1\r\nconfiguration_to_set.CRYPT.CRYPT_L = 1\r\n\r\n\r\n# Set the new configuration on the LoRa module and print the updated configuration to the console\r\ncode, confSetted = lora.set_configuration(configuration_to_set)\r\n```\r\n\r\nI create a CONSTANTS class for each parameter, here a list:\r\nAirDataRate, UARTBaudRate, UARTParity, TransmissionPower, ForwardErrorCorrectionSwitch, WirelessWakeUpTime, IODriveMode, FixedTransmission\r\n\r\n#### Send string message\r\n\r\nHere an example of send data, you can pass a string \r\n```python\r\nlora.send_transparent_message('pippo')\r\n```\r\n\r\n```python\r\nlora.send_fixed_message(0, 2, 23, 'pippo')\r\n```\r\nHere the receiver code\r\n```python\r\nwhile True:\r\n if lora.available() > 0:\r\n code, value = lora.receive_message()\r\n print(ResponseStatusCode.get_description(code))\r\n\r\n print(value)\r\n utime.sleep_ms(2000)\r\n```\r\n\r\nIf you want receive RSSI also you must enable it in the configuration\r\n```python\r\nconfiguration_to_set.TRANSMISSION_MODE.enableRSSI = RssiEnableByte.RSSI_ENABLED\r\n```\r\n\r\nand set the flag to True in the receive_message method\r\n```python\r\ncode, value, rssi = lora.receive_message(True)\r\n```\r\n\r\n\r\n\r\nResult\r\n\r\n```\r\nSuccess!\r\npippo\r\n```\r\n\r\n#### Send dictionary message\r\n\r\nHere an example of send data, you can pass a dictionary\r\n```python\r\nlora.send_transparent_dict({'pippo': 'fixed', 'pippo2': 'fixed2'})\r\n```\r\n\r\n```python\r\nlora.send_fixed_dict(0, 0x01, 23, {'pippo': 'fixed', 'pippo2': 'fixed2'})\r\n```\r\n\r\nHere the receiver code\r\n```python\r\nwhile True:\r\n if lora.available() > 0:\r\n code, value = lora.receive_dict()\r\n print(ResponseStatusCode.get_description(code))\r\n print(value)\r\n print(value['pippo'])\r\n utime.sleep_ms(2000)\r\n```\r\n\r\nif you want receive RSSI also you must enable it in the configuration\r\n```python\r\nconfiguration_to_set.TRANSMISSION_MODE.enableRSSI = RssiEnableByte.RSSI_ENABLED\r\n```\r\n\r\nand set the flag to True in the receive_dict method\r\n```python\r\ncode, value, rssi = lora.receive_dict(True)\r\n```\r\n\r\n\r\nResult\r\n\r\n```\r\nSuccess!\r\n{'pippo': 'fixed', 'pippo2': 'fixed2'}\r\nfixed\r\n```\r\n\r\n\r\n# This is a porting of the Arduino library for EBYTE LoRa E22 devices to Micropython\r\n\r\n\r\n# Soon a complete tutorial of the original library on my site www.mischianti.org\r\n\r\n - [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: settings and basic usage](https://www.mischianti.org/2020/09/25/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-specs-and-basic-usage-1/)\r\n - [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: library](https://www.mischianti.org/2021/01/28/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-library-part-2/)\r\n - [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: configuration](https://www.mischianti.org/2022/03/29/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-configuration-3/)\r\n - [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: fixed transmission and RSSI](https://www.mischianti.org/2022/04/04/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-fixed-transmission-broadcast-monitor-and-rssi-4/)\r\n - [Ebyte LoRa E22 device for Arduino, esp32 or esp8266: power saving and sending structured data](https://www.mischianti.org/2022/04/10/ebyte-lora-e22-device-for-arduino-esp32-or-esp8266-power-saving-wor-and-structured-data-5/)\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and Arduino shield\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and WeMos D1 shield\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and esp32 dev v1 shield\r\n\r\n\r\nhttps://downloads.arduino.cc/libraries/logs/github.com/xreef/EByte_LoRa_E22_Series_Library/\r\n\r\n# An Arduino UNO shield to simplify the use\r\n\r\n\r\nYou can order the PCB [here](https://www.pcbway.com/project/shareproject/LoRa_E32_Series_device_Arduino_shield.html) \r\n\r\nInstruction and assembly video on 6 part of the guide\r\n\r\n# An WeMos D1 shield to simplify the use\r\n\r\n\r\nYou can order the PCB [here](https://www.pcbway.com/project/shareproject/LoRa_E32_Series_device_WeMos_D1_mini_shield_RF_8km_range.html) \r\n\r\nInstruction and assembly video on 6 part of the guide\r\n\r\n\r\n\r\n# LoRa E22 (EBYTE LoRa sx1262/sx1268) series Library for Arduino, esp8266 and esp32-\r\n\r\nI create a library to manage EBYTE E22 series of LoRa device, very powerfull, simple and cheap device.\r\n\r\nLoRa or Long Range wireless data telemetry is a technology pioneered by Semtech that operates at a lower frequency than NRF24L01 (433 MHz, 868 MHz or 916 MHz agains 2.4 GHz for the NRF24L01) but at thrice the distance (from 4000m to 10000m).\r\n\r\n\r\n\r\nLoRa E22\r\n\r\n<p>You can find here <a href=\"https://s.click.aliexpress.com/e/_dSqbrK5\" target=\"_blank\">AliExpress (433MHz 4Km)</a> - <a href=\"https://s.click.aliexpress.com/e/_dTTkQtn\" target=\"_blank\">AliExpress (433MHz 10Km)</a></p>\r\n\r\nPlease refer to my article to get updated Schema\r\n\r\n### Library\r\n\r\nYou can find my library here.\r\n\r\nTo download.\r\n\r\nClick the DOWNLOADS button in the top right corner, rename the uncompressed folder LoRa_E22.\r\n\r\nCheck that the LoRa_E22 folder contains LoRa_E22.cpp and LoRa_E22.h.\r\n\r\nPlace the LoRa_E22 library folder your /libraries/ folder.\r\n\r\nYou may need to create the libraries subfolder if its your first library.\r\n\r\nRestart the IDE.\r\n\r\n#### Pinout\r\n\r\n\r\n\r\nE22 \r\n\r\n\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend is-style-stripes\" style=\"border-collapse:collapse\"><thead><tr><th style=\"background-color:#8ed1fc\">Pin No. </th><th style=\"background-color:#8ed1fc\"> Pin item </th><th style=\"background-color:#8ed1fc\"> Pin direction </th><th style=\"background-color:#8ed1fc\"> Pin application </th></tr></thead><tbody><tr class=\"alt\"><td>1</td><td>M0</td><td>Input\uff08weak pull-up\uff09</td><td>Work with M1 & decide the four operating modes.Floating is not allowed, can be ground.</td></tr><tr><td>2</td><td>M1</td><td>Input\uff08weak pull-up\uff09</td><td>Work with M0 & decide the four operating modes.Floating is not allowed, can be ground.</td></tr><tr class=\"alt\"><td>3</td><td>RXD</td><td>Input</td><td>TTL UART inputs, connects to external (MCU, PC) TXD outputpin. Can be configured as open-drain or pull-up input.</td></tr><tr><td>4</td><td>TXD</td><td>Output</td><td>TTL UART outputs, connects to external RXD (MCU, PC) inputpin. Can be configured as open-drain or push-pull output</td></tr><tr class=\"alt\"><td><br>5</td><td><br>AUX</td><td><br>Output</td><td>Per indicare lo stato di funzionamento del modulo e riattivare l\u2019MCU esterno. Durante la procedura di inizializzazione di autocontrollo, il pin emette una bassa tensione. Pu\u00f2 essere configurato come uscita open-drain o output push-pull (\u00e8 consentito non metterlo a terra, ma se hai problemi, ad esempio ti si freeze il dispositivo \u00e8 preferibile mettere una restistenza di pull-up da 4.7k o meglio collegarlo al dispositivo).</td></tr><tr><td>6</td><td>VCC</td><td><br></td><td style=\"vertical-align:middle\">Power supply 2.3V~5.5V DC</td></tr><tr class=\"alt\"><td>7</td><td>GND</td><td><br></td><td>Ground</td></tr></tbody></table>\r\n\r\nAs you can see you can set various modes via M0 and M1 pins.\r\n\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend is-style-stripes\"><thead><tr><th style=\"background-color:#8ed1fc\"><strong>Mode</strong> </th><th style=\"background-color:#8ed1fc\"><strong>M1</strong> </th><th style=\"background-color:#8ed1fc\"><strong>M0</strong> </th><th style=\"background-color:#8ed1fc\"><strong>Explanation</strong> </th></tr></thead><tbody><tr class=\"alt\"><td>Normal</td><td>0</td><td>0</td><td>UART and wireless channel are open, transparent transmission is on (Supports configuration over air via special command)</td></tr><tr><td>WOR Mode</td><td>0</td><td>1</td><td>Can be defined as WOR transmitter and WOR receiver</td></tr><tr class=\"alt\"><td>Configuration mode</td><td>1</td><td>0</td><td>Users can access the register through the serial port to\r\ncontrol the working state of the module</td></tr><tr><td>Deep sleep mode</td><td>1</td><td>1</td><td>Sleep mode</td></tr></tbody></table>\r\n\r\nAs you can see there are some pins that can be use in a static way, but If you connect It to the library you gain in performance and you can control all mode via software, but we are going to explain better next.\r\n\r\n### Fully connected schema\r\n\r\nAs I already say It\u2019s not important to connect all pin to the output of microcontroller, you can put M0 and M1 pins to HIGH or LOW to get desidered configuration, and **if you don\u2019t connect AUX the library set a reasonable delay to be sure that the operation is complete**.\r\n\r\n#### AUX pin\r\n\r\nWhen transmitting data can be used to wake up external MCU and return HIGH on data transfer finish.\r\n\r\n\r\n\r\nLoRa E22 AUX Pin on transmission\r\n\r\nWhen receiving AUX going LOW and return HIGH when buffer is empty.\r\n\r\n\r\n\r\nLoRa e22 AUX pin on reception\r\n\r\nIt\u2019s also used for self checking to restore normal operation (on power-on and sleep/program mode).\r\n\r\n\r\n\r\nLoRa e22 AUX pin on self-check\r\n\r\nesp8266 connection schema is more simple because It work at the same voltage of logical communications (3.3v).\r\n\r\n\r\n\r\nLoRa E22 TTL 100 Wemos D1 fully connected\r\n\r\nIt\u2019s important to add pull-up resistor (4,7Kohm) to get good stability.\r\n\r\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr class=\"alt\"><th>E22</th><th>esp8266</th></tr></thead><tbody><tr><td>M0</td><td>D7</td></tr><tr class=\"alt\"><td>M1</td><td>D6</td></tr><tr><td>TX</td><td>PIN D2 (PullUP 4,7K\u03a9)</td></tr><tr class=\"alt\"><td>RX</td><td>PIN D3 (PullUP 4,7K\u03a9)</td></tr><tr><td>AUX</td><td>PIN D5 (PullUP 4,7K\u03a9)</td></tr><tr class=\"alt\"><td>VCC</td><td>5V (but work with less power in 3.3v)</td></tr><tr><td>GND</td><td>GND</td></tr><tr class=\"alt\"><td></td><td></td></tr></tbody></table></figure>\r\n\r\nSimilar connection schema for esp32, but for RX and TX we use RX2 and TX2, because by default esp32 doesn\u2019t have SoftwareSerial but have 3 Serial.\r\n\r\n\r\n\r\nEbyte LoRa E22 device esp32 dev kit v1 breadboard full connection\r\n\r\n<table><thead><tr><th>E22</th><th>esp32</th></tr></thead><tbody><tr class=\"alt\"><td>M0</td><td>D21</td></tr><tr><td>M1</td><td>D19</td></tr><tr class=\"alt\"><td>TX</td><td>PIN RX2 (PullUP 4,7K\u03a9)</td></tr><tr><td>RX</td><td>PIN TX3 (PullUP 4,7K\u03a9)</td></tr><tr class=\"alt\"><td>AUX</td><td>PIN D18 (PullUP 4,7K\u03a9)</td></tr><tr><td>VCC</td><td>5V (but work with less power in 3.3v)</td></tr><tr class=\"alt\"><td>GND</td><td>GND</td></tr><tr><td></td><td></td></tr></tbody></table>\r\n\r\n\r\n\r\n\r\n\r\n#### Basic configuration option\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend\"><tbody><tr class=\"alt\"><td style=\"background-color:#eeeeee\">ADDH</td><td>High address byte of module (the default 00H)</td><td>00H-FFH</td></tr><tr><td style=\"background-color:#eeeeee\">ADDL</td><td>Low address byte of module (the default 00H)</td><td>00H-FFH</td></tr><tr class=\"alt\"><td style=\"background-color:#eeeeee\">SPED</td><td>Information about data rate parity bit and Air data rate</td><td></td></tr><tr><td style=\"background-color:#eeeeee\">CHAN</td><td>Communication channel\uff08410M + CHAN*1M\uff09, default 17H (433MHz), <strong>valid only for 433MHz device</strong> chek below to check the correct frequency of your device</td><td>00H-1FH</td></tr><tr class=\"alt\"><td style=\"background-color:#eeeeee\">OPTION</td><td>Type of transmission, packet size, allow special message</td><td></td></tr><tr><td style=\"background-color:#eeeeee\">TRANSMISSION_MODE</td><td>A lot of parameter that specify the transmission modality</td><td></td></tr></tbody></table>\r\n\r\nOPTION\r\n\r\nType of transmission, pull-up settings, wake-up time, FEC, Transmission power\r\n\r\n#### SPED detail\r\n\r\nUART Parity bit: _UART mode can be different between communication parties_\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend\"><tbody><tr class=\"alt\"><td style=\"background-color:#8ed1fc\">4</td><td style=\"background-color:#8ed1fc\">3</td><td style=\"background-color:#8ed1fc\">UART parity bit</td><td style=\"background-color:#fcb900\">Constant value</td></tr><tr><td>0</td><td>0</td><td>8N1 (default)</td><td>MODE_00_8N1</td></tr><tr class=\"alt\"><td>0</td><td>1</td><td>8O1</td><td>MODE_01_8O1</td></tr><tr><td>1</td><td>0</td><td>8 E1</td><td>MODE_10_8E1</td></tr><tr class=\"alt\"><td>1</td><td>1</td><td>8N1 (equal to 00)</td><td>MODE_11_8N1</td></tr></tbody></table>\r\n\r\nUART baud rate: UART baud rate can be different between communication parties, The UART baud rate has nothing to do with wireless transmission parameters & won\u2019t affect the wireless transmit / receive features.\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend\"><tbody><tr><td style=\"background-color:#8ed1fc\">7</td><td style=\"background-color:#8ed1fc\">6</td><td style=\"background-color:#8ed1fc\">5</td><td style=\"background-color:#8ed1fc\">TTL UART baud rate\uff08bps\uff09</td><td style=\"background-color:#fcb900\"> Constant value </td></tr><tr class=\"alt\"><td>0</td><td>0</td><td>0</td><td>1200</td><td>UART_BPS_1200</td></tr><tr><td>0</td><td>0</td><td>1</td><td>2400</td><td>UART_BPS_2400</td></tr><tr class=\"alt\"><td>0</td><td>1</td><td>0</td><td>4800</td><td>UART_BPS_4800</td></tr><tr><td>0</td><td>1</td><td>1</td><td>9600 (default)</td><td>UART_BPS_9600</td></tr><tr class=\"alt\"><td>1</td><td>0</td><td>0</td><td>19200</td><td>UART_BPS_19200</td></tr><tr><td>1</td><td>0</td><td>1</td><td>38400</td><td>UART_BPS_38400</td></tr><tr class=\"alt\"><td>1</td><td>1</td><td>0</td><td>57600</td><td>UART_BPS_57600</td></tr><tr><td>1</td><td>1</td><td>1</td><td>115200</td><td>UART_BPS_115200</td></tr></tbody></table>\r\n\r\nAir 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 keep the same for both communication parties.\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend\"><tbody><tr class=\"alt\"><td style=\"background-color:#8ed1fc\">2</td><td style=\"background-color:#8ed1fc\">1</td><td style=\"background-color:#8ed1fc\">0</td><td style=\"background-color:#8ed1fc\">Air data rate\uff08bps\uff09</td><td style=\"background-color:#fcb900\"> Constant value </td></tr><tr><td>0</td><td>0</td><td>0</td><td>0.3k</td><td>AIR_DATA_RATE_000_03</td></tr><tr class=\"alt\"><td>0</td><td>0</td><td>1</td><td>1.2k</td><td>AIR_DATA_RATE_001_12</td></tr><tr><td>0</td><td>1</td><td>0</td><td>2.4k (default)</td><td>AIR_DATA_RATE_010_24</td></tr><tr class=\"alt\"><td>0</td><td>1</td><td>1</td><td>4.8k</td><td>AIR_DATA_RATE_011_48</td></tr><tr><td>1</td><td>0</td><td>0</td><td>9.6k</td><td>AIR_DATA_RATE_100_96</td></tr><tr class=\"alt\"><td>1</td><td>0</td><td>1</td><td>19.2k</td><td>AIR_DATA_RATE_101_192</td></tr><tr><td>1</td><td>1</td><td>0</td><td>38.4k</td><td>AIR_DATA_RATE_110_384</td></tr><tr class=\"alt\"><td>1</td><td>1</td><td>1</td><td>62.5k</td><td>AIR_DATA_RATE_111_625</td></tr></tbody></table>\r\n\r\n#### OPTION detail\r\n\r\n####Sub packet setting\r\n\r\nThis is the max lenght of the packet.\r\n\r\nWhen the data is smaller than the sub packet length, the serial output of the receiving end is an uninterrupted continuous output. When the data is larger than the sub packet length, the receiving end serial port will output the sub packet.\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend\"><tbody><tr><td style=\"background-color:#8ed1fc\">7</td><td style=\"background-color:#8ed1fc\">6</td><td style=\"background-color:#8ed1fc\">Packet size</td><td style=\"background-color:#fcb900\"> Constant value </td></tr><tr class=\"alt\"><td>0</td><td>0</td><td>240bytes (default)</td><td>SPS_240_00</td></tr><tr><td>0</td><td>1</td><td>128bytes</td><td>SPS_128_01</td></tr><tr class=\"alt\"><td>1</td><td>0</td><td>64bytes</td><td>SPS_064_10</td></tr><tr><td>1</td><td>1</td><td>32bytes</td><td>SPS_032_11</td></tr></tbody></table>\r\n\r\n####RSSI Ambient noise enable\r\n\r\nThis command can enable/disable the management type of RSSI, It\u2019s important to manage the remote configuration, pay attention isn\u2019t the RSSI parameter in the message.\r\n\r\nWhen enabled, the C0 C1 C2 C3 command 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.\r\n\r\n<table class=\"wp-block-advgb-table advgb-table-frontend\"><tbody><tr class=\"alt\"><td style=\"background-color:#8ed1fc\">5</td><td style=\"background-color:#8ed1fc\">RSSI Ambient noise enable</td><td style=\"background-color:#fcb900\"> Constant value </td></tr><tr><td>0</td><td>Enable</td><td>RSSI_AMBIENT_NOISE_ENABLED</td></tr><tr class=\"alt\"><td>1</td><td>Disable (default)</td><td>RSSI_AMBIENT_NOISE_DISABLED</td></tr></tbody></table>\r\n\r\n### TRANSMISSION_MODE Detail\r\n\r\n####Enable RSSI\r\n\r\nWhen enabled, the module receives wireless data and it will follow an RSSI strength byte after output via the serial port TXD\r\n\r\n####Transmission type\r\n\r\nTransmission mode: in fixed transmission mode, the first three bytes of each user\u2019s data frame can be used as high/low address and channel. The module changes its address and channel when transmit. And it will revert to original setting after complete the process.\r\n\r\n####Enable repeater function\r\n\r\n####Monitor data before transmission\r\n\r\nWhen enabled, wireless data will be monitored before it is transmitted, which can avoid interference to a certain extent, but may cause data delay.\r\n\r\n####WOR\r\n\r\nWOR transmitter: the module receiving and transmitting functions are turned on, and a wake-up code is added when transmitting data. Receiving is turned on.\r\n\r\nWOR receiver: the module is unable to transmit data and works in WOR monitoring mode. The monitoring period is as follows (WOR cycle), which can save a lot of power.\r\n\r\n####WOR cycle\r\n\r\nIf 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 the wireless during this period. Each serial byte will be refreshed for 1000ms. Users must transmit the first byte within 1000ms.\r\n\r\n - Period T = (1 + WOR) * 500ms, maximum 4000ms, minimum 500ms\r\n - The longer the WOR monitoring interval period, the lower the average power consumption, but\r\nthe greater the data delay\r\n - Both the transmitter and the receiver must be the same (very important).\r\n\r\n\r\n\r\n### Send receive message\r\n\r\nFirst we must introduce a simple but usefully method to check if something is in the receiving buffer\r\n\r\n```cpp\r\nint available();\r\n```\r\n\r\nIt\u2019s simply return how many bytes you have in the current stream.\r\n\r\n#### Normal transmission mode\r\n\r\nNormal/Transparent transmission mode is used to send messages to all device with same address and channel.\r\n\r\n\r\n\r\nLoRa E22 transmitting scenarios, lines are channels\r\n\r\n\r\nFixed transmission have more scenarios\r\n\r\n\r\n\r\nLoRa E22 transmitting scenarios, lines are channels\r\n\r\n\r\n## Thanks\r\n\r\nNow you have all information to do your work, but I think It\u2019s important to show some realistic examples to undestand better all the possibility.\r\n\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: settings and basic usage\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: library\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: configuration\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: fixed transmission and RSSI\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: power saving and sending structured data\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: repeater mode and remote settings\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and Arduino shield\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and WeMos D1 shield\r\n - Ebyte LoRa E22 device for Arduino, esp32 or esp8266: WOR microcontroller and esp32 dev v1 shield\r\n\r\n-\r\n",
"bugtrack_url": null,
"license": "The MIT License (MIT) Copyright (c) 2017 Renzo Mischianti www.mischianti.org All right reserved. You may copy, alter and reuse this code in any way you like, but please leave reference to www.mischianti.org in your comments if you redistribute this code. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
"summary": "MicroPython LoRa EBYTE E22 device library complete and tested with Arduino SAMD, esp8266, esp32, Raspberry, rp2040 and STM32. sx1262/sx1268",
"version": "0.0.2",
"split_keywords": [
"lora",
"uart",
"ebyte",
"esp32",
"esp8266",
"stm32",
"samd",
"arduino",
"raspberry pi pico",
"rp2040",
"micropython",
"sx1262",
"sx1268",
"e22"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8ba073e478f69437721d16b2eb0d07efa4aabcbd9edc9de960ac2ff59ff3dcc4",
"md5": "15f8946423e31ad9ce8d3ad484fb37ff",
"sha256": "d1013675d2d5c231d6a50a78812036522e119979f418b7419a2d7314acf57a98"
},
"downloads": -1,
"filename": "ebyte_lora_e22-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "15f8946423e31ad9ce8d3ad484fb37ff",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 20271,
"upload_time": "2023-04-18T14:13:21",
"upload_time_iso_8601": "2023-04-18T14:13:21.714403Z",
"url": "https://files.pythonhosted.org/packages/8b/a0/73e478f69437721d16b2eb0d07efa4aabcbd9edc9de960ac2ff59ff3dcc4/ebyte_lora_e22-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1a6983ef5db538e83068c6bdb6ba51dd242a2974c1a6b9f04cc065fb15eb3f73",
"md5": "f4436049bd40c18956c8287eee01500d",
"sha256": "0269261f39020adf3b85dc6b54bc80f64d615b596a0c7cee8a956ebf03c3837b"
},
"downloads": -1,
"filename": "ebyte-lora-e22-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "f4436049bd40c18956c8287eee01500d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 26950,
"upload_time": "2023-04-18T14:13:24",
"upload_time_iso_8601": "2023-04-18T14:13:24.827731Z",
"url": "https://files.pythonhosted.org/packages/1a/69/83ef5db538e83068c6bdb6ba51dd242a2974c1a6b9f04cc065fb15eb3f73/ebyte-lora-e22-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-18 14:13:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "xreef",
"github_project": "EByte_LoRa_E22_micropython_library",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ebyte-lora-e22"
}
