mirror of
https://github.com/HendrikRauh/dmx-interface.git
synced 2025-05-18 21:55:34 +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
|
||||
|
||||
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 |
|
||||
| ---- | -------------- |
|
||||
| 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.
|
||||
|
||||

|
||||
|
||||
---
|
||||
|
||||
## 💡 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