refactored readme

This commit is contained in:
Hendrik Rauh 2024-12-13 23:18:58 +01:00
parent d9874bc79e
commit ae62394935
5 changed files with 91 additions and 9 deletions

100
README.md
View file

@ -1,21 +1,40 @@
# 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
![Prusa Slicer with case loaded](/assets/case/Screenshot.png)
| 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.
![Circuit diagram](/assets/circuit/diagram.svg)
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 |
| ---- | -------------- |
| 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 |
| 36 | SPI SCK |
| 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.
![Prusa Slicer with case loaded](/assets/case/Screenshot.png)
---
## 💡 Status LED
| LED | Description |
| --------------------------------- | ------------------------- |
| ![off](/assets/led/off.gif) | no power; LED deactivated |
| ![static](/assets/led/static.gif) | powered on; normal |
| ![slow](/assets/led/slow.gif) | startup; warning |
| ![fast](/assets/led/fast.gif) | 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

Binary file not shown.

After

Width:  |  Height:  |  Size: 911 B

BIN
assets/led/off.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 423 B

BIN
assets/led/slow.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 911 B

BIN
assets/led/static.gif Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 521 B