Skip to content

Commit

Permalink
improved docs
Browse files Browse the repository at this point in the history
  • Loading branch information
karurochari committed Sep 6, 2024
1 parent fe9c831 commit 0c617e9
Showing 1 changed file with 12 additions and 7 deletions.
19 changes: 12 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,17 @@
# serial-e22-lora
# ebyte-lora-ts

> [!CAUTION]
> Very much WIP and not documented. For reference, the [official documentation](https://www.cdebyte.com/products/E22-900T22U).
> So far only the `ebyte e22-900t22u` is supported, but other models only require minimal changes.
> It has not been tested yet on hardware. I just checked that serialization and de-serialization of configs are reversible in simple cases.
> So far only the `ebyte e22-900t22u` is supported, but other models can be easily added with minimal changes.
> It has been tested on hardware, but coverage is not full.
Library to configure and use lora devices like the `ebyte e22-900t22u` via typescript.
Be it to configure and use them from a [browser](https://developer.mozilla.org/en-US/docs/Web/API/SerialPort), or to implement a shell utility & replace the official one only available for windows.
This library is only handling the packet building & validation from/to json config files. This way it is kept fully portable for whatever runtime you might want to use.
This library provides some utility framework to configure and operate lora devices from **ebyte** via typescript.
The design goal of this library is to be platform-agnostic, so you might use it write a [webapp](https://developer.mozilla.org/en-US/docs/Web/API/SerialPort) or some portable CLI tool to replace the official one which is only available for windows.
This library is only handling the packet building & validation from/to json config files, you will have to provide `read` and `write` functions to support your serial device.

An equivalent native implementation is also planned, but it has low priority.
## Compatibility

- Node via `@serialport/bindings-cpp`, targetting most operating systems and architectures.
- Bun at the moment is not compatible with that node library, and I was not able to find any alternative for now.
- [QuickJS](https://github.com/quickjs-ng/quickjs) should work fine as long as you bring your own read/write.
- [Txiki](https://github.com/saghul/txiki.js) as well. I wrote a [serial module](https://github.com/KaruroChori/serial-txiki-module) a while back, this is expected to work.

0 comments on commit 0c617e9

Please sign in to comment.