Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kasperl/toit-qubitro
Qubitro connector for the ESP32 based on the Toit language.
https://github.com/kasperl/toit-qubitro
esp32 qubitro toit
Last synced: about 2 months ago
JSON representation
Qubitro connector for the ESP32 based on the Toit language.
- Host: GitHub
- URL: https://github.com/kasperl/toit-qubitro
- Owner: kasperl
- License: mit
- Created: 2021-12-13T04:56:54.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-20T06:02:41.000Z (5 months ago)
- Last Synced: 2024-04-20T07:21:09.381Z (5 months ago)
- Topics: esp32, qubitro, toit
- Language: Toit
- Homepage:
- Size: 39.1 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Qubitro connector for the ESP32
Connect your devices to [Qubitro](https://www.qubitro.com/) and visualize your data in the
[Qubitro Portal](https://portal.qubitro.com/).
This [Toit](https://toitlang.org) package provides an easy and convenient way to
connect to Qubitro via MQTT from devices running on the ESP32-family of chips.
## Architecture
The Qubitro connector runs as a separate micro-service isolated from the rest of the
system through [Toit containers](https://github.com/toitlang/toit/discussions/869).
## Installing the Qubitro connector
To install the Qubitro connector service on your device, we recommend that you
use [Jaguar](https://github.com/toitlang/jaguar). Jaguar makes it easy to experiment
with the Qubitro services because it allows you to upload new services and
applications via WiFi without having to restart your device.
The Qubitro credentials easily be provided to the service at install time, so you
don't have to write it into your source code:
```sh
jag container install qubitro src/service.toit \
-D qubitro.device.id= \
-D qubitro.device.token=
```
This install the Qubitro connector service in a separate container and it sticks
around across device restarts:
```
$ jag container list
DEVICE IMAGE NAME
lunar-bet 3fb76dd5-5842-57ff-b19c-857669906b04 jaguar
lunar-bet d04371a2-bb38-54cb-9124-5e48d06ff3d1 qubitro
```
## Publishing data
Once the service is installed, you do not need to provide credentials to publish
data from individual applications, although you still can by providing arguments
to `qubitro.connect`. The code for publishing data is reasonably straight forward:
```
import qubitro
main:
client ::= qubitro.connect
10.repeat:
client.publish { "MyData": random 1000 }
sleep (Duration --s=2)
client.close
```
To run code like the above, you can use `jag run`:
```sh
jag run examples/publish.toit
```