mirror of
https://github.com/balkian/shinesp.git
synced 2024-11-01 06:31:42 +00:00
49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
# 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 (`led`).
|
|
To configure the board, just connect to that access point 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.
|
|
To get the IP of the board you have several options:
|
|
|
|
* Using the MDNS address: `esp8266.local`
|
|
* Get the IP from your router's configuration page
|
|
* The board prints the IP address it was given to the serial monitor
|
|
* Use nmap/zenmap/similar
|
|
|
|
# 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 on 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 0)
|
|
|
|
# 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
|