wioe5 1.23299.1 (#1491)

* wioe5_p2p release 1.23299.1 Fri 09 May 2025 05:33:48 PM PDT

Initial release.

* wioe5_ham1 release 1.23299.1 Fri 09 May 2025 05:35:17 PM PDT

Initial release.
This commit is contained in:
pmunts
2025-05-13 03:17:01 -07:00
committed by GitHub
parent 4a179fb192
commit cc54f7d7b8
2 changed files with 176 additions and 0 deletions
@@ -0,0 +1,93 @@
name = "wioe5_ham1"
version = "1.23299.1"
description = "Wio-E5 LoRa Transceiver Module Device Driver"
website = "https://github.com/pmunts/libsimpleio"
authors = ["Philip Munts"]
maintainers = ["Philip Munts <phil@munts.net>"]
maintainers-logins = ["pmunts"]
licenses = "BSD-1-Clause"
long-description = """
Introduction
============
This crate provides the device driver package **`Wio_E5.Ham1`** for the
Seeed Studio [Wio-E5 LoRa Transceiver
Module](https://wiki.seeedstudio.com/LoRa-E5_STM32WLE5JC_Module)
operating in test *aka* P2P (so-called Peer to Peer or Point to Point)
broadcast mode.
See
[WioE5LoRaP2P.pdf](https://repo.munts.com/libsimpleio/doc/WioE5LoRaP2P.pdf)
for more information about the [LoRa wireless
system](https://www.semtech.com/lora/what-is-lora) and operating the
Wio-E5 module in P2P mode.
**`Wio_E5.Ham1`** is derived from **`Wio_E5.P2P`** (see crate
[wioe5_p2p](https://alire.ada.dev/crates/wioe5_p2p.html)). It reserves
the first twelve bytes of the payload for address information to
implement ***[Amateur
Radio](https://www.fcc.gov/wireless/bureau-divisions/mobility-division/amateur-radio-service)
Unicast Flavor #1***, which creates a amateur radio [Personal Area
Network](https://en.wikipedia.org/wiki/Personal_area_network), operated
under a *Technician* or higher license, in the [33-cm
band](https://en.wikipedia.org/wiki/33-centimeter_band) (902 to 928 MHz
in the United States, 915 to 928 MHz in New Zealand, and possible
allocations in other [ITU Region
2](https://w6hs.net/itu-region-2-member-countries) countries).
*The code for this crate has been extracted from the [Linux Simple I/O
Library project](https://github.com/pmunts/libsimpleio).*
API
===
The API for this device driver is documented in the
[Wio-E5.Ham1](https://github.com/pmunts/libsimpleio/blob/master/ada/devices/wio_e5-ham1.ads)
package specification.
**`Wio-E5.Ham1`** is a generic package that must be instantiated with
two **`Positive`** value parameters, for maximum payload size (1 to 241
bytes) and FIFO queue depth. The default values for the generic formal
parameters will prove satisfactory for most purposes. Depending on what
kind of data you are going to be sending, you might want reduce the
maximum payload size to match some other protocol, such as 64 bytes for
the [Remote I/O
Protocol](https://repo.munts.com/libsimpleio/doc/RemoteIOProtocol.pdf).
Minimal Test Program
====================
WITH Wio_E5.Ham1;
PROCEDURE HelloWorld IS
PACKAGE LoRa IS NEW Wio_E5.Ham1;
dev : LoRa.Device;
BEGIN
dev := LoRa.Create("/dev/ttyUSB0", 115200, "ZZ0ZZZ ", 1, 915.0);
dev.Send("Hello, World!", 2);
dev.Shutdown;
END HelloWorld;
More example programs are available at:
<https://github.com/pmunts/libsimpleio/tree/master/ada/programs/wioe5/ham1>.
"""
tags = ["embedded", "linux", "wioe5", "lora", "radio", "wireless", "ham"]
project-files = ["wioe5_ham1.gpr"]
[available."case(os)"]
'linux|windows' = true
"..." = false
[origin]
hashes = [
"sha256:67dafca874d48402ae6822cd2169947391979349cf530b6d5a11e4df299dfea7",
"sha512:131c2d156e9fda34bb0a668f0b2f19e885a2d5bd4526fd498e60d0ced766a52c5be9184c0a43c7ebb5b63d85fb394075a3ba1d789e7892e0ddf3fce6c3a61c8d",
]
url = "https://raw.githubusercontent.com/pmunts/alire-crates/c701905561cf32e3a66c3e55b4265e7273be5031/wioe5_ham1/wioe5_ham1-1.23299.1.tbz2"
@@ -0,0 +1,83 @@
name = "wioe5_p2p"
version = "1.23299.1"
description = "Wio-E5 LoRa Transceiver Module P2P Mode Device Driver"
website = "https://github.com/pmunts/libsimpleio"
authors = ["Philip Munts"]
maintainers = ["Philip Munts <phil@munts.net>"]
maintainers-logins = ["pmunts"]
licenses = "BSD-1-Clause"
long-description = """
Introduction
============
This crate provides the device driver package **`Wio_E5.P2P`** for the
Seeed Studio [Wio-E5 LoRa Transceiver
Module](https://wiki.seeedstudio.com/LoRa-E5_STM32WLE5JC_Module)
operating in test *aka* P2P (so-called Peer to Peer or Point to Point)
broadcast mode.
See
[WioE5LoRaP2P.pdf](https://repo.munts.com/libsimpleio/doc/WioE5LoRaP2P.pdf)
for more information about the [LoRa wireless
system](https://www.semtech.com/lora/what-is-lora) and operating the
Wio-E5 module in P2P mode.
See the related crate
[wioe5_ham1](https://alire.ada.dev/crates/wioe5_ham1.html).
*The code for this crate has been extracted from the [Linux Simple I/O
Library project](https://github.com/pmunts/libsimpleio).*
API
===
The API for this device driver is documented in the
[Wio-E5.P2P](https://github.com/pmunts/libsimpleio/blob/master/ada/devices/wio_e5-p2p.ads)
package specification.
**`Wio-E5.P2P`** is a generic package that must be instantiated with two
**`Positive`** value parameters, for maximum payload size (1 to 253
bytes) and FIFO queue depth. The default values for the generic formal
parameters will prove satisfactory for most purposes. Depending on what
kind of data you are going to be sending, you might want reduce the
maximum payload size to match some other protocol, such as 64 bytes for
the [Remote I/O
Protocol](https://repo.munts.com/libsimpleio/doc/RemoteIOProtocol.pdf).
Minimal Test Program
====================
WITH Wio_E5.P2P;
PROCEDURE HelloWorld IS
PACKAGE LoRa IS NEW Wio_E5.P2P;
dev : LoRa.Device;
BEGIN
dev := LoRa.Create("/dev/ttyUSB0", 115200, 915.0);
dev.Send("Hello, World!");
dev.Shutdown;
END HelloWorld;
More example programs are available at:
<https://github.com/pmunts/libsimpleio/tree/master/ada/programs/wioe5/p2p>.
"""
tags = ["embedded", "linux", "wioe5", "lora", "radio", "wireless"]
project-files = ["wioe5_p2p.gpr"]
[available."case(os)"]
'linux|macos|windows' = true
"..." = false
[origin]
hashes = [
"sha256:fd088599a949aebcfb26c6824563472f785416c17208b39ba871737f3940f328",
"sha512:1ba3eb2784f182d0324a54c595dde474f06530c1d544e4db54fbea5241a86c045f35374e2790ed350c957aa38cfcb1a52753aad3583d27205d43d62320e8565c",
]
url = "https://raw.githubusercontent.com/pmunts/alire-crates/acc637ae3604f7a1b9bcc8f6a420ffb76e6e8dd4/wioe5_p2p/wioe5_p2p-1.23299.1.tbz2"