RYLR998 LoRa

Rylr998-lora®

Un programme Python pour des SMS à 2 voies avec le module Lora® de la bande de 33 cm RYLR998, soit avec: soit avec:

1. un Raspberry Pi 4, cinq fils et dix connecteurs GPIO féminins-féminins;
2. Ou, avec un PC et un convertisseur en série CP2102 USB 2.0 à TTL, quatre fils et huit connecteurs GPIO féminins.

Il n'y a pas de fils ici, seulement des appels d'E / S non bloquants asynchrones.

Remarque: Je recommande de connecter le RYLR998 à l'USB Reyax Ryls135 à 1,8 V / 3,3 V / 5V TTL UART Bridge, disponible sur Amazon. Avec ce matériel et un Raspberry Pi 4 (ou 5 - pas encore testé), le logiciel est compatible avec le logiciel d'appliance DiGIPI sans modification de /boot/config.txt .

AVERTISSEMENT: Windows nécessite windows-curses , qui n'implémente pas curses.set_escdelay() à partir de Python 3.11. Commentez cur.set_escdelay(1) dans display.py et exécutez à vos propres risques. La gestion du texte est irrégulière dans Windows, avec la fonction set_escdelay() manquante. Si vous exécutez sous Ubuntu ou Debian sous WSL2 dans Windows, vous n'aurez pas ce problème.

Usage

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

Exemple de ligne de commande

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

Dépendances des modules Python

• Python 3.10+
• rpi.gpio (sauf Windows)
• asyncio
• AioSerial 1.3.1+
• malédictions
• Windows-Curses en fonctionnant sur Windows. Remarque: set_escdelay () n'est pas implémenté. Courez à vos risques et périls !!

pip install asyncio et ainsi de suite devraient fonctionner.

Connexions GPIO directes pour le Raspberry Pi

Les connexions GPIO sont les suivantes:

• VDD à 3,3 V PIN physique 1 sur le GPIO
• RST à GPIO 4, broche physique 7
• TXD à GPIO 15 RXD1 C'est la broche physique 10
• RXD à GPIO 14 TXD1 C'est la broche physique 8
• GND à GND Physical Pin 9.

AVERTISSEMENT: vous tromper et vous pouvez faire frire votre Raspberry Pi 4 et votre module Reyax RylR998 Lora®. Je n'ai pas eu de problèmes, Knock Wood, mais la licence du MIT est livrée sans garantie. Vérifiez vos connexions! En aucun cas, n'appliquez 5V au module RYLR998 LORA®. Seulement 3,3 V.

Désactiver Bluetooth et activer UART1 (/ dev / ttys0)

1. Assurez-vous que le shell de connexion sur le port série est désactivé, mais le port série est activé. Dans sudo raspi-config , sélectionnez les options d'interfaçage, puis sélectionnez Serial. Répondez "Non" à "Souhaitez-vous qu'un shell de connexion soit accessible sur SERIAL?" et répondre "oui" à "si vous aimez l'activation du matériel de port série?".

2. Désactiver Bluetooth dans /boot/config.txt en ajoutant

disable-bt=1
enable-uart=1 

Désactiver le service Bluetooth avec

sudo systemctl disable hciuart.service

3. Activez uart1 avec l'installation de superposition d'arborescence de périphérique avant d'exécuter le code. Je fais cela dans /etc/rc.local avec

sudo dtoverlay uart1

Recommandé: Connexion à un PC avec un convertisseur en série USB 2.0 à TTL

Je recommande l'USB Reyax Ryls135 à 1,8 V / 3,3 V / 5V TTL UART Bridge, disponible auprès d'Amazon et d'autres fournisseurs.

Semblable au GPIO, seul VDD passe à la sortie 3,3 V du convertisseur; Rx et Tx sont échangés, comme d'habitude; Et GND va à GND. Voir les photos ci-dessous.

FAIRE

• Ajoutez l'analyse de la fonction AT + RESET. FAIT.
• Remplacez asyncio.BoundedSemaphore() par un drapeau booléen. FAIT. Un booléen waitForReply est suffisant.
• Traduire des codes ERR = ## en texte. FAIT
• Affichez les paramètres de configuration. Fait, au démarrage.
• Un indicateur VFO serait bien (c'est presque une blague). FAIT
• Ajoutez une gestion de la clé de fonction pour modifier les paramètres de configuration, tels que la fréquence, le netid, etc.
• Stockez les variables de réponse à la commande AT dans l'instance d'objet RylR998! FAIT
• Mais faites attention à changer les paramètres du port série - vous serez désolé!
• La bibliothèque Python Urwid pourrait être utilisée avec l'initialisation suivante au début 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().

et immédiatement avant de raise KeyboardInterrupt dans l'appel xcvr(...)

 uloop . stop ()

• Vous pouvez rendre les fenêtres redonnables. Je ne sais pas.
• Réécrivez-vous dans Micropython pour l'Adafruit M0 ...

Ne pas faire

• Pas de fils! Asyncio uniquement.

Design markovien

• Toute l'action se déroule dans la boucle principale, xcvr(stdscr) , un caractère d' entrée à la fois, en fonction de l'état et du caractère d'entrée actuel.
• L'entrée signifie le clavier et l'entrée du port série du module Reyax RylR998.
• L'entrée du clavier est non bloquante et brute - presque végétalienne.
• Un personnage "vide" est autorisé - en fait, nous aimons les personnages vides.
• La sortie signifie l'écran (maudits) sortie et le port série Sortie des commandes AT vers le module Reyax RYLR998.
• La sortie de l'écran n'est pas un caractère à la fois. Au lieu d'appeler refresh() Lorsqu'une fenêtre change, nous appelons win.noutrefresh() et définissez un peu sale.
• Si le bit sale est défini, curses.doupdate() est appelé et le bit sale est réinitialisé. Il s'agit d'une optimisation.
• La sortie du port série ne peut pas être un caractère à la fois, car les commandes complètes doivent être envoyées au RYLR998 via le port série.
• La réception et l'analyse des réponses des commandes AT ont priorité sur l'envoi sur les commandes, qui comprend l'envoi de SMS.

Références

Brownlee, J., Ph.D. (2022). Python Asyncio Jump-Start: Programmation asynchrone et E / S non bloquante avec Coroutines (Vol. 7, 7 Vols., Série de coups de démarrage de Python). Extrait le 22 janvier 2023 de https://superfastpython.com/python-asyncio-jump-start/ ISBN-13 979-8361197620

malédictions - Gestion des terminaux pour les affichages de cellules de caractère

"Reyax Rylr998 RyLR498 LORA® au guide de commande" (C) 2021 Reyax Technology CO., Ltd. Extrait le 22 janvier 2023 de https://reyax.com//upload/products_download/download_file/lora_at_command_rylr998_rylr498_en.pdf

Marques

La marque et le logo Lora® sont des marques de Semtech Corporation ou de ses affiliés.

---

Cette capture d'écran montre une session MobaxTerm exécutant le programme rlyr998.py . Le texte jaune est celui de l'expéditeur. Le texte reçu est magenta. Lorsque rylr998.py détecte le texte reçu, l'indicateur "LORA" clignote en vert si le message est assez long; La transmission du texte clignote l'indicateur "LORA" rouge. Les valeurs ADDR (adresse), RSSI et SNR du dernier message reçu sont affichées. Les messages texte sont limités à 40 caractères (dans cette version).

Clause de non-responsabilité

Ceci est un travail en cours. Je prends mon temps à ajouter des fonctions d'affichage de type IRC avec la bibliothèque Python Indies lentement et délibérément avec tous les paresseux, si lentement que je serais licencié et mis sur liste noire si je le faisais professionnellement; a échoué et expulsé sans diplôme et une cargaison de prêts d'étudiants privés prédateurs à des taux d'intérêt usuraires si j'étais au collège; et financé et défroqué si j'étais académicien. Je ne suis pas affilié à Semtech Corporation.