This commit is contained in:
parent
3a841c5792
commit
a598d62523
40
README.md
40
README.md
@ -1,27 +1,23 @@
|
|||||||
[![Built with po-util](https://rawgit.com/nrobinson2000/po-util/master/images/built-with-po-util.svg)](https://po-util.com)
|
# Renderbug: An embedded art engine
|
||||||
|
|
||||||
# This repository is a [po-util](https://po-util.com) project
|
Renderbug is a fast, efficient, and beautiful LED art engine for the ESP32 and
|
||||||
|
other chipsets that are able to talk to WS2812b (aka Neopixel) RGB LEDs.
|
||||||
|
|
||||||
Po makes it easy to locally develop firmware for Particle devices, and supports the Particle Photon, P1, Electron, Core, Raspberry Pi, and Redbear Duo.
|
## Features
|
||||||
|
|
||||||
Your project’s C++ files go in the `firmware/` directory, and the binary will appear in the `bin/` directory.
|
- Fun to use
|
||||||
|
- Fast as hell
|
||||||
|
- Microkernel architecture
|
||||||
|
- Functional API
|
||||||
|
- JSON Configuration
|
||||||
|
- Live reconfiguration
|
||||||
|
- Connectivity over Serial, Bluetooth, MQTT, and others
|
||||||
|
- Tasklets for rendering, input, and background services
|
||||||
|
- Surface mapping and projection algorithms (batteries included)
|
||||||
|
- Automatic power management
|
||||||
|
- Sprites
|
||||||
|
- Native Home Assistant support over MQTT
|
||||||
|
|
||||||
To compile code, run `po DEVICE_TYPE build`, substituting `DEVICE_TYPE` with `photon`, `P1`, `electron`, `core`, `pi`, or `duo`.
|
## Demonstration
|
||||||
|
|
||||||
To compile and flash code, run `po DEVICE_TYPE flash`. Code is compiled and then flashed to your device over USB.
|
[![blazing fast LEDs](https://img.youtube.com/vi/VbPOKY6_bkc/maxresdefault.jpg)](https://www.youtube.com/shorts/VbPOKY6_bkc)
|
||||||
|
|
||||||
To clean the project, run `po DEVICE_TYPE clean`.
|
|
||||||
|
|
||||||
To flash a project over USB without rebuilding, run `po DEVICE_TYPE dfu`.
|
|
||||||
|
|
||||||
To upload a compiled project over the air run `po DEVICE ota DEVICE_NAME`, where `DEVICE_NAME` is the name of your device in the Particle cloud. **Note: You must be logged into particle-cli to use this feature. You can log into particle-cli with:**
|
|
||||||
|
|
||||||
```
|
|
||||||
particle login
|
|
||||||
```
|
|
||||||
|
|
||||||
For more help, run `man po`, or visit <https://docs.po-util.com/>
|
|
||||||
|
|
||||||
*By the way, po has tab completion. Try pressing [TAB] at any time to have arguments completed.*
|
|
||||||
|
|
||||||
Feel free to edit this README.md to make it more suitable for your project. **(I do ask that you please include the badge at the top though.)**
|
|
||||||
|
Loading…
Reference in New Issue
Block a user