pmunts
f2e64c68f6
* muntsos_aarch64 release 10.4.0 Wed May 14 07:38:24 PM PDT 2025 Added wioe5_ham1, wioe5_ham2, and wioe5_p2p to the list of crates that are included in this one. * wioe5_p2p release 1.23340.1 Wed May 14 10:49:49 PM PDT 2025 Backported some improvements from wioe5_ham2. * wioe5_ham1 release 1.23340.1 Wed May 14 10:52:00 PM PDT 2025 Backported some improvements from wioe5_ham2. * wioe5_ham2 release 1.23340.1 Wed May 14 10:53:28 PM PDT 2025 Added new crate wioe5_ham2, for Amateur Radio Unicast Flavor #2.
91 lines
3.3 KiB
TOML
91 lines
3.3 KiB
TOML
name = "wioe5_ham1"
|
|
version = "1.23340.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/wioe5/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:f8a15bd3d3f84c115a435a43184bcd051a6e4ef16bf9d594505612122fc08ad4",
|
|
"sha512:4347114857752a569855be87b589038d66f43684402306f9859d6d260db255bef362de8001d431568a74ee301eff356327af78a2af803d61649b3bca2460025f",
|
|
]
|
|
url = "https://raw.githubusercontent.com/pmunts/alire-crates/1a403b346e0bbef15b9f4a8b2f7bb12a2fe2b827/wioe5_ham1/wioe5_ham1-1.23340.1.tbz2"
|
|
|