RYLR998 LoRa

Rylr998-lora®

Un programa de Python para mensajes de texto de 2 vías con el módulo Lora® de la banda RYAX Rylr998 de 33 cm, ya sea con:

1. una Raspberry Pi 4, cinco cables y diez conectores GPIO femenino-mujer;
2. O, con una PC y un convertidor serie CP2102 USB 2.0 a TTL, cuatro cables y ocho conectores GPIO femeninos femeninos.

Aquí no hay hilos, solo llamadas de E/S sin bloqueo asíncrono.

Nota: Recomiendo conectar el RylR998 al Puente Reyax Ryls135 USB a 1.8V/3.3V/5V TTL UART UART, disponible en Amazon. Con este hardware y un Raspberry Pi 4 (o 5, aún aún probado), el software es compatible con el software DigIpi Appliance sin modificación de /boot/config.txt .

ADVERTENCIA: Windows requiere windows-curses , que no implementa curses.set_escdelay() a partir de Python 3.11. Comente cur.set_escdelay(1) en display.py y ejecute su propio riesgo. El manejo del texto es errático en Windows, con la función set_escdelay() falta. Si se ejecuta en Ubuntu o Debian bajo WSL2 en Windows, no tendrá este problema.

Uso

usage: rylr998.py [-h] [--debug] [--factory] [--noGPIO] [--addr [0..65535]] [--band [902250000..927750000]] [--pwr [0..22]]
                  [--mode [0 | 1 | 2,30..60000,30..60000]] [--netid [3..15 | 18]] [--parameter [7..11,7..9,1..4,4..24]] [--echo]
                  [--port [/dev/ttyS0../dev/ttyS999 | /dev/ttyUSB0../dev/ttyUSB999 | COM0..COM999]]
                  [--baud (300 | 1200 | 4800 | 9600 | 19200 | 28800 | 38400 | 57600 | 115200)]

options:
  -h , --help            show this help message and exit
  --debug               log DEBUG information
  --factory             Factory reset to manufacturer defaults. BAND: 915MHz, UART: 115200, Spreading Factor: 9, Bandwidth: 125kHz (7), Coding Rate:
                        1, Preamble Length: 12, Address: 0, Network ID: 18, CRFOP: 22
  --noGPIO              Do not use rPI.GPIO module even if available. Useful if using a USB to TTL converter with the RYLR998.

rylr998 config:
  --addr [0..65535]     Module address (0..65535). Default is 0
  --band [902250000..927750000]
                        Module frequency (902250000..927750000) in Hz. NOTE: the full 33cm ISM band limits 902 MHz and 928 MHz are guarded by the
                        maximum configurable bandwidth of 500 KHz (250 KHz on either side of the configured frequency). See PARAMETER for bandwidth
                        configuration. Default: 915000000
  --pwr [0..22]         RF pwr out (0..22) in dBm. Default: FACTORY setting of 22 or the last configured value.
  --mode [0 | 1 | 2,30..60000,30..60000]
                        Mode 0: transceiver mode. Mode 1: sleep mode. Mode 2,x,y: receive for x msec sleep for y msec and so on, indefinitely.
                        Default: 0
  --netid [3..15 | 18]    NETWORK ID. Note: PARAMETER values depend on NETWORK ID. Default: 18
  --parameter [7..11,7..9,1..4,4..24]
                        PARAMETER. Set the RF parameters Spreading Factor, Bandwidth, Coding Rate, Preamble. Spreading factor 7..11, default 9.
                        Bandwidth 7..9, where 7 is 125 KHz (only if spreading factor is in 7..9) ; 8 is 250 KHz (only if spreading factor is in
                        7..10) ; 9 is 500 KHz (only if spreading factor is in 7..11). Default bandwidth is 7. Coding rate is 1..4, default 4.
                        Preamble is 4..25 if the NETWORK ID is 18 ; otherwise the preamble must be 12. Default: 9,7,1,12
  --echo                Retransmit received message

serial port config:
  --port [/dev/ttyS0../dev/ttyS999 | /dev/ttyUSB0../dev/ttyUSB999 | COM0..COM999]
                        Serial port device name. Default: /dev/ttyS0
  --baud (300 | 1200 | 4800 | 9600 | 19200 | 28800 | 38400 | 57600 | 115200)
                        Serial port baudrate. Default: 115200

Línea de comando de ejemplo

pi@raspberrypi: ~ /RYLR998-LoRa$ python3 rylr998.py --pwr 22 --port /dev/ttyS0  --band 902687500  --netid 6

Dependencias del módulo de Python

• Python 3.10+
• RPI.GPIO (excepto Windows)
• asincio
• aioserial 1.3.1+
• maldiciones
• Windows corre si se ejecuta en Windows. NOTA: SET_ESCDELAY () no se implementa. Corre bajo su propio riesgo !!

pip install asyncio , etc., debería funcionar.

Conexiones directas de GPIO para Raspberry Pi

Las conexiones GPIO son las siguientes:

• VDD a 3.3V Pin físico 1 en el GPIO
• Primero a GPIO 4, PIN físico 7
• TXD a GPIO 15 RXD1 Este es un pin 10 físico 10
• RXD a GPIO 14 TXD1 Este es un pin 8 físico 8
• GND a GND PIN físico 9.

ADVERTENCIA: Haz esto mal y podrás freír tu Raspberry Pi 4 y tu módulo Reyax Rylr998 Lora®. No he tenido problemas, Knock Wood, pero la licencia del MIT no tiene garantía. ¡Revise sus conexiones! Bajo ninguna circunstancia, aplique 5V al módulo Rylr998 Lora®. Solo 3.3V.

Desactivar Bluetooth y habilitar UART1 (/dev/ttys0)

1. Asegúrese de que el shell de inicio de sesión sobre el puerto serie esté deshabilitado, pero el puerto serie está habilitado. En sudo raspi-config , seleccione opciones de interfaz, luego seleccione Serial. Responda "No" a "¿Le gustaría que un shell de inicio de sesión sea accesible en serie?" Y responda "sí" a "¿Te gusta que el hardware del puerto serie sea habilitado?".

2. Desactivar Bluetooth en /boot/config.txt agregando

disable-bt=1
enable-uart=1 

Deshabilite el servicio Bluetooth con

sudo systemctl disable hciuart.service

3. Habilite uart1 con la instalación de superposición del árbol de dispositivos antes de ejecutar el código. Hago esto en /etc/rc.local con

sudo dtoverlay uart1

Recomendado: Conexión a una PC con un convertidor serial del módulo USB 2.0 a TTL

Recomiendo el puente Reyax Ryls135 USB a 1.8V/3.3V/5V TTL UART UART, disponible en Amazon y otros proveedores.

Similar al GPIO, solo VDD va a la salida de 3.3V del convertidor; RX y TX se intercambian, como de costumbre; Y GND va a GND. Vea las imágenes a continuación.

HACER

• Agregue el análisis de la función de reinicio AT+. HECHO.
• Reemplace asyncio.BoundedSemaphore() con una bandera booleana. HECHO. Una waitForReply booleana es suficiente.
• Traduce los códigos err = ## al texto. HECHO
• Muestra los parámetros de configuración. Hecho, al inicio.
• Un indicador VFO sería bueno (esto es casi una broma). HECHO
• Agregue el manejo de la tecla de función para cambiar los parámetros de configuración, como la frecuencia, NETID, etc.
• ¡Almacene las variables de respuesta al comando AT en la instancia del objeto RylR998! HECHO
• Pero tenga cuidado al cambiar los parámetros del puerto serie, ¡lo lamentará!
• La biblioteca Python Urwid podría usarse con la siguiente inicialización al comienzo de xcvr(...) :

 eloop = urwid . AsyncioEventLoop ( loop = asyncio . get_event_loop ())
uloop = urwid . MainLoop ( widget , event_loop = eloop )
uloop . start () # main_loop.py suggests using this instead of run().

e inmediatamente antes de raise KeyboardInterrupt dentro de la llamada xcvr(...)

 uloop . stop ()

• Podrías hacer que las ventanas sean recuperables. No sé.
• Reescribir en Micrypthon para el Adafruit M0 ...

Para no hacer

• ¡Sin hilos! Asyncio solamente.

Diseño de Markovian

• Toda la acción tiene lugar en el bucle principal, xcvr(stdscr) , un carácter de entrada a la vez, en función del estado y el carácter de entrada actual.
• La entrada significa teclado y entrada de puerto serie del módulo Reyax Rylr998.
• La entrada del teclado no es bloqueo y crudo, casi vegano.
• Se permite un personaje "vacío", de hecho, nos gustan los personajes vacíos.
• Salida de la pantalla de medios de salida (Cursos) y salida del puerto serie de los comandos AT al módulo Reyax Rylr998.
• La salida de pantalla no es un personaje a la vez. En lugar de llamar refresh() cuando cambia una ventana, llamamos win.noutrefresh() y establecemos un poco sucio.
• Si se establece el bit sucio, se llama curses.doupdate() y el bit sucio se restablece. Esta es una optimización.
• La salida del puerto en serie no puede ser un personaje a la vez, ya que los comandos AT completos deben enviarse al RylR998 a través del puerto serie.
• Recibir y analizar las respuestas de los comandos AT tiene prioridad sobre el envío de comandos AT, lo que incluye enviar texto.

Referencias

Brownlee, J., Ph.D. (2022). Python Asyncio Jump-start: programación asíncrona y E/S sin bloqueo con coroutinas (vol. 7, 7 vols., Serie de salto de acurrencia de Python). Consultado el 22 de enero de 2023 de https://superfastpython.com/python-asyncio-jump-start/ ISBN-13 979-8361197620

Maldiciones: manejo terminal para pantallas de células de caracteres

"Reyax Rylr998 Rylr498 Lora® AT Guía de comando" (C) 2021 Reyax Technology Co., Ltd. Recuperado el 22 de enero de 2023, de https://reyax.com//upload/products_download/download_file/lora_at_command_rylr998_rylr498_en.pdf

Marcas registradas

La marca y el logotipo de Lora® son marcas comerciales de Semtech Corporation o sus afiliados.

---

Esta captura de pantalla muestra una sesión de Mobaxter que ejecuta el programa rlyr998.py . El texto amarillo es el del remitente. El texto recibido es magenta. Cuando Rylr998.py detecta el texto recibido, el indicador "Lora" parpadea verde si el mensaje es lo suficientemente largo; La transmisión de texto parpadea el indicador "lora" rojo. Se muestran los valores ADDR (Dirección), RSSI y SNR del último mensaje recibido. Los mensajes de texto se limitan a 40 caracteres (en esta versión).

Descargo de responsabilidad

Este es un trabajo en progreso. Me tomo mi tiempo agregando funciones de visualización similar a IRC con la biblioteca de las maldiciones de Python lenta y deliberadamente con todo el perezoso, tan lentamente que sería despedido y en la lista negra si estuviera haciendo esto profesionalmente; Flugado y expulsado sin un título y una gran cantidad de préstamos de estudiantes privados depredadores a tasas de interés usuriosas si estaba en la universidad; y defundido y desfigurado si yo fuera académico. No estoy afiliado a Semtech Corporation.