1
0
mirror of https://github.com/balkian/shinesp.git synced 2024-10-31 22:31:41 +00:00
shinesp/README.md

43 lines
1.5 KiB
Markdown
Raw Normal View History

# RGB strip WiFi server
This server has been tested with:
* ws2812b LED strip
* WeMos ESP8266 board
# Instructions
The first time it boots, the board will create its own access point so you can configure the SSID and password.
To configure it, just connect to the `led` network and access the board either using its IP (it is the default gateway for the network) or its MDNS name (`esp8266.local`):
```
curl http://esp8266.local/credentials?ssid=mywifi&pass=mypassword
```
The board will then reboot and try to log in with the given credentials.
If the credentials were correct, the `led` network should have disappeared.
If it hasn't, try rebooting the board or debugging.
Once the board is connected to your router, you can start using the API of the board.
# API
* `/clear` clear WIFI credentials
* `/credentials?ssid=<SSID>&pass=<PASSWD>` Set the
* `/color?r=<R>&g=<G>&b=<B>` Set
* `/off` turn off the lights
* `/on` turn on the lights (using the last color and value)
* `/toggle` turn the lights if they are off, and vice versa
* `/white` set the color to white
* `/brightness?value=<VALUE>` set the brightness value (0-255)
* `/brightness/up` turn up the brightness (up to 255)
* `/brightness/down` turn down the brightness (down to 255)
# Debugging
You can use a serial monitor (e.g. in the Arduino IDE) to connect to the board.
# Over-the-air updates
You can connect to your board wirelessly and update its firmware using OTA updates.
To do so, follow this instructions: http://esp8266.github.io/Arduino/versions/2.0.0/doc/ota_updates/ota_updates.html