mirror of
https://github.com/HendrikRauh/dmx-interface.git
synced 2025-05-19 10:32:56 +00:00
refactored readme
This commit is contained in:
parent
d9874bc79e
commit
ae62394935
5 changed files with 91 additions and 9 deletions
100
README.md
100
README.md
|
@ -1,21 +1,40 @@
|
||||||
# DMX-Interface
|
# DMX-Interface
|
||||||
|
|
||||||
Art-Net-Interface
|
> _Art-Net interface for controlling DMX devices via WiFi or Ethernet._
|
||||||
|
|
||||||
## Case
|
---
|
||||||
|
|
||||||
All print files (STL, STEP, X_T) can be found in [assets/case](/assets/case/). Alternatively you can view the project on [OnShape](https://cad.onshape.com/documents/7363818fd18bf0cbf094790e/w/52455282b39e47fbde5d0e53/e/9bec98aa83a813dc9a4d6ab2) where you can export the files in a format you like.
|
## 🛒 Parts
|
||||||
|
|
||||||

|
| Count | Part |
|
||||||
|
| ----- | ------------- |
|
||||||
|
| 1x | ESP32 |
|
||||||
|
| 2x | RS485 |
|
||||||
|
| 1x | W5500-ETH |
|
||||||
|
| 1x | LED-Button |
|
||||||
|
| 1x | ♂️-DMX-socket |
|
||||||
|
| 1x | ♀️-DMX-socket |
|
||||||
|
|
||||||
## Wiring
|
> Additionally you need: `some wires`, `soldering equipment`, `3D-printer`, `small screws`, `shrink tubing`, `hot glue gun`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📱 Implemented microcontrollers
|
||||||
|
|
||||||
|
- [x] Lolin S2 mini
|
||||||
|
- [ ] ESP 32 WROOM
|
||||||
|
- [ ] ESP 32 C3
|
||||||
|
|
||||||
|
> For other microcontrollers you may need to adjust the `platformio.ini`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔌 Wiring
|
||||||
|
|
||||||
|
You have to short-circuit `R0` on the RS485 boards to enable the termination resistor required for DMX before the first and after the last device in line.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
You have to short-circuit R0 on the RS485 boards to enable the termination resistor required for DMX before the first and after the last device in line.
|
|
||||||
|
|
||||||
## Pin usage
|
|
||||||
|
|
||||||
| GPIO | Usage |
|
| GPIO | Usage |
|
||||||
| ---- | -------------- |
|
| ---- | -------------- |
|
||||||
| GND | GND to others |
|
| GND | GND to others |
|
||||||
|
@ -33,3 +52,66 @@ You have to short-circuit R0 on the RS485 boards to enable the termination resis
|
||||||
| 35 | SPI MOS |
|
| 35 | SPI MOS |
|
||||||
| 36 | SPI SCK |
|
| 36 | SPI SCK |
|
||||||
| 37 | SPI MISO |
|
| 37 | SPI MISO |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Installation
|
||||||
|
|
||||||
|
1. make sure you have [PlatformIO](https://platformio.org/) installed
|
||||||
|
2. open the project folder in PlatformIO
|
||||||
|
3. click `Upload Filesystem Image`
|
||||||
|
4. click `Upload and Monitor`
|
||||||
|
5. 🏁 you are done 🎉
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📦 Case
|
||||||
|
|
||||||
|
All print files (STL, STEP, X_T) can be found in [assets/case](/assets/case/). Alternatively you can view the project on [OnShape](https://cad.onshape.com/documents/7363818fd18bf0cbf094790e/w/52455282b39e47fbde5d0e53/e/9bec98aa83a813dc9a4d6ab2) where you can export the files in a format you like.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 💡 Status LED
|
||||||
|
|
||||||
|
| LED | Description |
|
||||||
|
| --------------------------------- | ------------------------- |
|
||||||
|
|  | no power; LED deactivated |
|
||||||
|
|  | powered on; normal |
|
||||||
|
|  | startup; warning |
|
||||||
|
|  | resetting; error |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚙️ Default config
|
||||||
|
|
||||||
|
To reset the settings, hold down the button and connect the ESP to the power supply. As soon as the LED flashes quickly, the settings are reset.
|
||||||
|
|
||||||
|
| Setting | Value |
|
||||||
|
| -------------- | ------------------ |
|
||||||
|
| TYPE | WiFi AP |
|
||||||
|
| SSID | ChaosDMX-□□□□ |
|
||||||
|
| PASSWORD | mbgmbgmbg |
|
||||||
|
| IP-Address | 192.168.4.1 |
|
||||||
|
| DMX1 (Left) | OUTPUT; Universe 1 |
|
||||||
|
| DMX2 (Right) | INPUT; Universe 2 |
|
||||||
|
| LED Brightness | 10 % |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🤝 Contributing
|
||||||
|
|
||||||
|
Contributions, issues and feature requests are welcome!<br />Feel free to check the [issues page](https://github.com/HendrikRauh/dmx-interface/issues).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 👥 Authors
|
||||||
|
|
||||||
|
### [@HendrikRauh](https://github.com/HendrikRauh)
|
||||||
|
|
||||||
|
### [@RaffaelW](https://github.com/RaffaelW)
|
||||||
|
|
||||||
|
### [@psxde](https://github.com/psxde)
|
||||||
|
|
||||||
|
[Chaostreff Backnang](https://chaostreff-backnang.de/)
|
||||||
|
|
BIN
assets/led/fast.gif
Normal file
BIN
assets/led/fast.gif
Normal file
Binary file not shown.
After Width: | Height: | Size: 911 B |
BIN
assets/led/off.gif
Normal file
BIN
assets/led/off.gif
Normal file
Binary file not shown.
After Width: | Height: | Size: 423 B |
BIN
assets/led/slow.gif
Normal file
BIN
assets/led/slow.gif
Normal file
Binary file not shown.
After Width: | Height: | Size: 911 B |
BIN
assets/led/static.gif
Normal file
BIN
assets/led/static.gif
Normal file
Binary file not shown.
After Width: | Height: | Size: 521 B |
Loading…
Add table
Reference in a new issue