├── .gitignore
├── .vscode
    └── extensions.json
├── ESP-131GPIO
    ├── ESP-131GPIO.ino
    └── data
    │   ├── favicon.png
    │   └── index.html
├── README.md
├── _config.yml
├── images
    ├── Config.png
    ├── GPIORelay-Wiring.jpg
    ├── Relay.jpg
    ├── Status.png
    ├── Test.png
    └── Wemos.jpg
└── platformio.ini


/.gitignore:
--------------------------------------------------------------------------------
1 | .pio
2 | .vscode/.browse.c_cpp.db*
3 | .vscode/c_cpp_properties.json
4 | .vscode/launch.json
5 | .vscode/ipch
6 | 


--------------------------------------------------------------------------------
/.vscode/extensions.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     // See http://go.microsoft.com/fwlink/?LinkId=827846
 3 |     // for the documentation about the extensions.json format
 4 |     "recommendations": [
 5 |         "platformio.platformio-ide"
 6 |     ],
 7 |     "unwantedRecommendations": [
 8 |         "ms-vscode.cpptools-extension-pack"
 9 |     ]
10 | }
11 | 


--------------------------------------------------------------------------------
/ESP-131GPIO/ESP-131GPIO.ino:
--------------------------------------------------------------------------------
  1 | //https://github.com/garymueller/ESP-131GPIO
  2 | 
  3 | #include <Arduino.h>
  4 | 
  5 | #include <ESP8266WiFi.h>
  6 | #include <ESPAsyncE131.h>
  7 | #include <ESPAsyncWebServer.h>
  8 | #include <ESPAsyncDNSServer.h>
  9 | #include <LittleFS.h>
 10 | #include <ArduinoJson.h>
 11 | #include <vector>
 12 | 
 13 | using namespace std;
 14 | 
 15 | // ***** USER SETUP STUFF *****
 16 | String ssid = "SSID"; // replace with your SSID.
 17 | String password = "Password"; // replace with your password.
 18 | 
 19 | String CONFIG_FILE = "Config.json";
 20 | DynamicJsonDocument Config(1024);
 21 | AsyncWebServer server(80);
 22 | AsyncDNSServer dnsServer;
 23 | ESPAsyncE131 e131;
 24 | 
 25 | //for Wemos D1 R1 pins are 16,5,4,14,12,13,0,2
 26 | //vector<int> GpioVector{16,5,4,14,12,13,0,2};
 27 | //for Wemos D1 R2 pins are 16,5,4,0,2,14,12,13
 28 | vector<int> GpioVector{16,5,4,0,2,14,12,13};
 29 | int DigitalOn = HIGH;
 30 | int DigitalOff = LOW;
 31 | 
 32 | //Forward Declarations
 33 | String WebReplace(const String& var);
 34 | 
 35 | bool LoadConfig();
 36 | void SaveConfig(AsyncWebServerRequest* request);
 37 | 
 38 | void InitGpio();
 39 | void InitWifi();
 40 | void Init131();
 41 | void InitWeb();
 42 | 
 43 | /*
 44 |  * Sets up the initial state and starts sockets
 45 |  */
 46 | void setup() {
 47 |   Serial.begin(115200);
 48 |   delay(500);
 49 |   Serial.println("==============================");
 50 |   Serial.println("Start Setup");
 51 |   
 52 |   LoadConfig();
 53 | 
 54 |   InitGpio();
 55 | 
 56 |   InitWifi();
 57 | 
 58 |   Init131();
 59 | 
 60 |   InitWeb();
 61 | 
 62 |   Serial.println("Completed setup. Starting loop");
 63 |   Serial.println("==============================");
 64 | }
 65 | 
 66 | /*
 67 |  * Main Event Loop
 68 |  */
 69 | void loop() {
 70 |   e131_packet_t packet;
 71 |   bool Digital = Config["GPIO"]["digital"].as<bool>();
 72 |   int DigitalThreshold = Config["GPIO"]["digital_threshold"].as<int>();
 73 |   int ChannelOffset = Config["E131"]["channel_offset"].as<int>();
 74 | 
 75 |   while(!e131.isEmpty()) {
 76 |     e131.pull(&packet);     // Pull packet from ring buffer
 77 |     uint16_t num_channels = htons(packet.property_value_count) - 1;
 78 |     
 79 |     for(int GpioIndex = 0, ChannelIndex = ChannelOffset;
 80 |         GpioIndex < GpioVector.size() && ChannelIndex < num_channels; 
 81 |         ++GpioIndex, ++ChannelIndex) {
 82 |       
 83 |       uint16_t data = packet.property_values[ChannelIndex+1];
 84 |       if(Digital) {
 85 |         digitalWrite(GpioVector[GpioIndex], (data >= DigitalThreshold) ? DigitalOn : DigitalOff);
 86 |       } else {
 87 |         analogWrite(GpioVector[GpioIndex], data);
 88 |       }
 89 |       //Serial.printf("%d:%d:%d; ",GpioIndex,data,(data > DigitalThreshold) ? DigitalOn : DigitalOff);
 90 |     }//for loop
 91 |     //Serial.println("");
 92 |   }//! empty
 93 | }// end void loop 
 94 | 
 95 | 
 96 | /*
 97 |  * InitGpio
 98 |  */
 99 | void InitGpio()
100 | {
101 |   //initialize GPIO pins
102 |   for(int i = 0; i < GpioVector.size(); ++i)  {
103 |     pinMode(GpioVector[i], OUTPUT);
104 |     digitalWrite(GpioVector[i], DigitalOff);
105 |   }
106 | }
107 | 
108 | /*
109 |  * Loads the config from SPPS into the Config variable
110 |  */
111 | bool LoadConfig()
112 | {
113 |   // Initialize LittleFS
114 |   if(!LittleFS.begin()){
115 |     Serial.println("An Error has occurred while mounting LittleFS");
116 |     return false;
117 |   }
118 | 
119 |   File file = LittleFS.open(CONFIG_FILE, "r");
120 |   if (!file) {
121 |     //First Run, setup defaults
122 |     Config["network"]["hostname"] = "esps-" + String(ESP.getChipId(), HEX);
123 |     Config["network"]["ssid"] = ssid;
124 |     Config["network"]["password"] = password;
125 |     Config["network"]["static"] = false;
126 |     Config["network"]["static_ip"] = "192.168.1.100";
127 |     Config["network"]["static_netmask"] = "255.255.255.0";
128 |     Config["network"]["static_gateway"] = "192.168.1.1";
129 |     Config["network"]["access_point"] = true;
130 |     
131 |     Config["E131"]["multicast"] = "true";
132 |     Config["E131"]["universe"] = 1;
133 |     Config["E131"]["channel_offset"] = 0;
134 | 
135 |     Config["GPIO"]["digital"] = "true";
136 |     Config["GPIO"]["digital_threshold"] = 127;
137 |     Config["GPIO"]["digital_lowlevel"] = false;
138 |     
139 |   } else {
140 |     Serial.println("Loading Configuration File");
141 |     deserializeJson(Config, file);
142 |   }
143 | 
144 |   if(Config["GPIO"]["digital_lowlevel"].as<bool>()) {
145 |     DigitalOn = LOW;
146 |     DigitalOff = HIGH;
147 |   } else {
148 |     DigitalOn = HIGH;
149 |     DigitalOff = LOW;
150 |   }
151 | 
152 |   serializeJson(Config, Serial);Serial.println();
153 |   return true;
154 | }
155 | 
156 | void SaveConfig(AsyncWebServerRequest* request)
157 | {
158 |   Serial.println("Saving Configuration File");
159 |   
160 |   //debug
161 |   int params = request->params();
162 |   for(int i=0;i<params;i++){
163 |     AsyncWebParameter* p = request->getParam(i);
164 |     Serial.printf("Param: %s, %s\n", p->name().c_str(), p->value().c_str());
165 |   }
166 | 
167 |   //Validate Config
168 | 
169 |   Config["network"]["hostname"] = request->getParam("hostname",true)->value();
170 |   Config["network"]["ssid"] = request->getParam("ssid",true)->value();
171 |   Config["network"]["password"] = request->getParam("password",true)->value();
172 |   //checkbox status isnt always included if toggled off
173 |   Config["network"]["static"] = 
174 |     (request->hasParam("static",true) && (request->getParam("static",true)->value() == "on"));
175 |   Config["network"]["static_ip"] = request->getParam("static_ip",true)->value();
176 |   Config["network"]["static_netmask"] = request->getParam("static_netmask",true)->value();
177 |   Config["network"]["static_gateway"] = request->getParam("static_gateway",true)->value();
178 |   Config["network"]["access_point"] = 
179 |     (request->hasParam("access_point",true) && (request->getParam("access_point",true)->value() == "on"));
180 |   
181 |   //checkbox status isnt always included if toggled off
182 |   Config["E131"]["multicast"] = 
183 |     (request->hasParam("multicast",true) && (request->getParam("multicast",true)->value() == "on"));
184 |   Config["E131"]["universe"] = request->getParam("universe",true)->value();
185 |   Config["E131"]["channel_offset"] = request->getParam("channel_offset",true)->value();
186 | 
187 |   //checkbox status isnt always included if toggled off
188 |   Config["GPIO"]["digital"] =
189 |     (request->hasParam("digital",true) && (request->getParam("digital",true)->value() == "on"));
190 |   Config["GPIO"]["digital_threshold"] = request->getParam("digital_threshold",true)->value();
191 |   Config["GPIO"]["digital_lowlevel"] =
192 |     (request->hasParam("digital_lowlevel",true) && (request->getParam("digital_lowlevel",true)->value() == "on"));
193 | 
194 |   File file = LittleFS.open(CONFIG_FILE, "w");
195 |   if(file) {
196 |     serializeJson(Config, file);
197 |     serializeJson(Config, Serial);
198 |   }
199 | 
200 |   request->send(200);
201 |   ESP.restart();
202 | }
203 | 
204 | /*
205 |  * Initialiaze Wifi (DHCP/STATIC and Access Point)
206 |  */
207 | void InitWifi()
208 | {
209 |   // Switch to station mode and disconnect just in case
210 |   WiFi.mode(WIFI_STA);
211 |   WiFi.disconnect();
212 |   
213 |   WiFi.hostname(Config["network"]["hostname"].as<const char*>());
214 | 
215 |   //configure Static/DHCP
216 |   if(Config["network"]["static"].as<bool>()) {
217 |     IPAddress IP; IP.fromString(Config["network"]["static_ip"].as<String>());
218 |     IPAddress Netmask; Netmask.fromString(Config["network"]["static_netmask"].as<String>());
219 |     IPAddress Gateway; Gateway.fromString(Config["network"]["static_gateway"].as<String>());
220 | 
221 |     if(WiFi.config(IP, Netmask, Gateway)) {
222 |       Serial.println("Successfully configured static IP");
223 |     } else {
224 |       Serial.println("Failed to configure static IP");
225 |     }
226 |   } else {
227 |     Serial.println("Connecting with DHCP");
228 |   }
229 | 
230 |   //Connect
231 |   int Timeout = 15000;
232 |   WiFi.begin(Config["network"]["ssid"].as<String>(), Config["network"]["password"].as<String>());
233 |   if(WiFi.waitForConnectResult(Timeout) != WL_CONNECTED) {
234 |     if(Config["network"]["access_point"].as<bool>()) {
235 |       Serial.println("*** FAILED TO ASSOCIATE WITH AP, GOING SOFTAP ***");
236 |       WiFi.mode(WIFI_AP);
237 |       WiFi.softAP(Config["network"]["hostname"].as<String>());
238 |       dnsServer.start(53, "*", WiFi.softAPIP());
239 |     } else {
240 |       Serial.println(F("*** FAILED TO ASSOCIATE WITH AP, REBOOTING ***"));
241 |       ESP.restart();
242 |     }
243 |   } else {
244 |     Serial.printf("Connected as %s\n",WiFi.localIP().toString().c_str());
245 |   }
246 | 
247 |   WiFi.printDiag(Serial);
248 | }
249 | 
250 | void Init131()
251 | {
252 |   if(Config["E131"]["multicast"].as<bool>()) {
253 |     Serial.printf("Initializing Multicast with universe <%d>\n",Config["E131"]["universe"].as<int>());
254 |     e131.begin(E131_MULTICAST, Config["E131"]["universe"]);
255 |   } else {
256 |     Serial.println("Initializing Unicast");
257 |     e131.begin(E131_UNICAST);
258 |   }
259 | }
260 | 
261 | 
262 | /*
263 |  * Initializes the webserver
264 |  */
265 | void InitWeb()
266 | {
267 |   //enables redirect to /index.html on AP connection
268 |   server.onNotFound([](AsyncWebServerRequest *request){
269 |     request->send(LittleFS, "/index.html", String(), false, WebReplace);
270 |   });
271 | 
272 |   server.on("/", HTTP_GET, [](AsyncWebServerRequest *request){
273 |     request->send(LittleFS, "/index.html", String(), false, WebReplace);
274 |   });
275 |   server.on("/favicon.ico", HTTP_GET, [](AsyncWebServerRequest *request){
276 |     request->send(LittleFS, "/favicon.png", "image/png");
277 |   });
278 |   server.on("/SaveConfig", HTTP_POST, [](AsyncWebServerRequest *request){
279 |     SaveConfig(request);
280 |   });
281 |   server.on("/SetRelay", HTTP_GET, [](AsyncWebServerRequest *request){
282 |     int relay = request->getParam("relay")->value().toInt();
283 |     if(relay<0 || relay >= GpioVector.size()) {
284 |       Serial.println("SetRelay - Index out of range");
285 |       return;
286 |     }
287 |     digitalWrite(GpioVector[relay], (request->getParam("checked")->value() == "true") ? DigitalOn : DigitalOff);
288 |     request->send(200);
289 |   });
290 | 
291 |   server.begin();
292 | }
293 | 
294 | /*
295 |  * WebReplace:
296 |  * Substitutes variables inside of the html
297 |  */
298 | String WebReplace(const String& var)
299 | {
300 |   //Status Page
301 |   if (var == "SSID") {
302 |     return (String)WiFi.SSID();
303 |   } else if (var == "HOSTNAME") {
304 |     return (String)WiFi.hostname();
305 |   } else if (var == "IP") {  
306 |     if(WiFi.getMode() == WIFI_AP) {
307 |       return WiFi.softAPIP().toString();
308 |     } else {
309 |       return WiFi.localIP().toString();
310 |     }
311 |   } else if (var == "MAC") {
312 |     return (String)WiFi.macAddress();
313 |   } else if (var == "RSSI") {
314 |     return (String)WiFi.RSSI();
315 |   } else if (var == "HEAP") {
316 |     return (String)ESP.getFreeHeap();
317 |   } else if (var == "UPTIME") {
318 |     return String(millis());
319 |   } else if (var == "UNIVERSE") {
320 |     return Config["E131"]["universe"];
321 |   } else if (var == "PACKETS") {
322 |     return (String)e131.stats.num_packets;
323 |   } else if (var == "PACKET_ERR") {
324 |     return (String)e131.stats.packet_errors;
325 |   } else if (var == "LAST_IP") {
326 |     return e131.stats.last_clientIP.toString();
327 | 
328 |   //Configuration Page   
329 |   } else if (var == "CONFIG_HOSTNAME") {
330 |     return Config["network"]["hostname"];
331 |   } else if (var == "CONFIG_SSID") {
332 |     return Config["network"]["ssid"];
333 |   } else if (var == "CONFIG_PASSWORD") {
334 |     return Config["network"]["password"];
335 |   } else if (var == "CONFIG_AP") {
336 |     if(Config["network"]["access_point"].as<bool>())
337 |       return "checked";
338 |      else
339 |       return "";
340 |   } else if (var == "CONFIG_STATIC") {
341 |     if(Config["network"]["static"].as<bool>())
342 |       return "checked";
343 |      else
344 |       return "";
345 |   } else if (var == "CONFIG_STATIC_IP") {
346 |     return Config["network"]["static_ip"];
347 |   } else if (var == "CONFIG_STATIC_NETMASK") {
348 |     return Config["network"]["static_netmask"];
349 |   } else if (var == "CONFIG_STATIC_GATEWAY") {
350 |     return Config["network"]["static_gateway"];
351 |   } else if (var == "CONFIG_MULTICAST") {
352 |     if(Config["E131"]["multicast"].as<bool>())
353 |       return "checked";
354 |      else
355 |       return "";
356 |   } else if (var == "CONFIG_UNIVERSE") {
357 |     return Config["E131"]["universe"];
358 |   } else if (var == "CONFIG_CHANNEL_OFFSET") {
359 |     return Config["E131"]["channel_offset"];
360 |   } else if (var == "CONFIG_DIGITAL") {
361 |     if(Config["GPIO"]["digital"].as<bool>())
362 |       return "checked";
363 |      else
364 |       return "";
365 |   } else if (var == "CONFIG_THRESHOLD") {
366 |     return Config["GPIO"]["digital_threshold"];
367 |   } else if (var == "CONFIG_LOWLEVEL") {
368 |     if(Config["GPIO"]["digital_lowlevel"].as<bool>())
369 |       return "checked";
370 |      else
371 |       return "";
372 | 
373 |   //Relay Page
374 |   } else if (var == "RELAYS") {
375 |     String Relays = "";
376 |     for(int i = 0; i < GpioVector.size(); ++i) {
377 |       Relays += "<label>Relay "+String(i+1)+" ("+GpioVector[i]+")</label>";
378 |       Relays += "  <label class=\"switch\">";
379 |       Relays += "  <input type=\"checkbox\" ";
380 |       if(digitalRead(GpioVector[i]) == DigitalOn) {
381 |         Relays += "checked";
382 |       }
383 |       Relays += " onclick=\"fetch('SetRelay?relay="+String(i)+"&checked='+this.checked);\">";
384 |       Relays += "  <span class=\"slider round\"></span>";
385 |       Relays += "</label>";
386 |       Relays += "<br><br>";
387 |     }
388 |     return Relays;
389 |   }
390 |  
391 |   return var;
392 | }
393 | 


--------------------------------------------------------------------------------
/ESP-131GPIO/data/favicon.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/garymueller/ESP-131GPIO/933761cbd7473b1b85fdf5d779e8774fdd164b3d/ESP-131GPIO/data/favicon.png


--------------------------------------------------------------------------------
/ESP-131GPIO/data/index.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html>
  3 | <title>%HOSTNAME%</title>
  4 | <head>
  5 | <meta name="viewport" content="width=device-width, initial-scale=1">
  6 | <style>
  7 | body {font-family: Arial;}
  8 | 
  9 | /* Style the tab */
 10 | .tab {
 11 |   overflow: hidden;
 12 |   border: 1px solid #ccc;
 13 |   background-color: #f1f1f1;
 14 | }
 15 | 
 16 | /* Style the buttons inside the tab */
 17 | .tab button {
 18 |   background-color: inherit;
 19 |   float: left;
 20 |   border: none;
 21 |   outline: none;
 22 |   cursor: pointer;
 23 |   padding: 14px 16px;
 24 |   transition: 0.3s;
 25 |   font-size: 17px;
 26 | }
 27 | 
 28 | /* Change background color of buttons on hover */
 29 | .tab button:hover {
 30 |   background-color: #ddd;
 31 | }
 32 | 
 33 | /* Create an active/current tablink class */
 34 | .tab button.active {
 35 |   background-color: #Fbb;
 36 | }
 37 | 
 38 | /* Style the tab content */
 39 | .tabcontent {
 40 |   display: none;
 41 |   padding: 6px 12px;
 42 |   border: 1px solid #ccc;
 43 |   border-top: none;
 44 | }
 45 | 
 46 | .switch {
 47 |   position: relative;
 48 |   display: inline-block;
 49 |   width: 50px;
 50 |   height: 24px;
 51 | }
 52 | 
 53 | .switch input { 
 54 |   opacity: 0;
 55 |   width: 0;
 56 |   height: 0;
 57 | }
 58 | 
 59 | .slider {
 60 |   position: absolute;
 61 |   cursor: pointer;
 62 |   top: 0;
 63 |   left: 0;
 64 |   right: 0;
 65 |   bottom: 0;
 66 |   background-color: #ccc;
 67 |   -webkit-transition: .1s;
 68 |   transition: .1s;
 69 | }
 70 | 
 71 | .slider:before {
 72 |   position: absolute;
 73 |   content: "";
 74 |   height: 16px;
 75 |   width: 16px;
 76 |   left: 4px;
 77 |   bottom: 4px;
 78 |   background-color: white;
 79 |   -webkit-transition: .1s;
 80 |   transition: .1s;
 81 | }
 82 | 
 83 | input:checked + .slider {
 84 |   background-color: #2196F3;
 85 | }
 86 | 
 87 | input:focus + .slider {
 88 |   box-shadow: 0 0 1px #2196F3;
 89 | }
 90 | 
 91 | input:checked + .slider:before {
 92 |   -webkit-transform: translateX(26px);
 93 |   -ms-transform: translateX(26px);
 94 |   transform: translateX(26px);
 95 | }
 96 | 
 97 | /* Rounded sliders */
 98 | .slider.round {
 99 |   border-radius: 34px;
100 | }
101 | 
102 | .slider.round:before {
103 |   border-radius: 50%%;
104 | }
105 | </style>
106 | </head>
107 | <body>
108 | 
109 | <h2>%HOSTNAME%</h2>
110 | 
111 | <div class="tab">
112 |   <button class="tablinks" onclick="openTab(event, 'Status')">Status</button>
113 |   <button class="tablinks" onclick="openTab(event, 'Config')">Config</button>
114 |   <button class="tablinks" onclick="openTab(event, 'Test')">Test</button>
115 | </div>
116 | 
117 | <div id="Status" class="tabcontent">
118 | <h4>Network Status</h4>
119 | <hr>
120 | 
121 | <table style="margin-left:10px">
122 |   <tr><td >SSID:</td>      <td>%SSID%</td></tr>
123 |   <tr><td >Hostname:</td>  <td>%HOSTNAME%</td></tr>
124 |   <tr><td >IP:</td>        <td>%IP%</td></tr>
125 |   <tr><td >MAC:</td>       <td>%MAC%</td></tr>
126 |   <tr><td >RSSI:</td>      <td>%RSSI%</td></tr>
127 |   <tr><td >Free Heap:</td> <td>%HEAP%</td></tr>
128 |   <tr><td >Up Time:</td>   <td><span id="uptime"></span></td></tr>
129 | </table>
130 | 
131 | <h4>E1.31 Status</h4>
132 | <hr>
133 | 
134 | <table style="margin-left:10px">
135 |   <tr><td >Universe:</td>      <td>%UNIVERSE%</td></tr>
136 |   <tr><td >Total Packets:</td> <td>%PACKETS%</td></tr>
137 |   <tr><td >Paket Errors:</td>  <td>%PACKET_ERR%</td></tr>
138 |   <tr><td >Last IP:</td>       <td>%LAST_IP%</td></tr>
139 | </table>
140 | 
141 | </div>
142 | 
143 | <div id="Config" class="tabcontent">
144 |   <form action="SaveConfig" method="post">
145 |   
146 |     <h4>Network</h4>
147 | 	
148 | 	<label for="hostname">HostName:</label>
149 |     <input type="text" id="hostname" name="hostname" value="%CONFIG_HOSTNAME%">
150 | 	<br><br>
151 | 	
152 | 	<label for="ssid">SSID:</label>
153 |     <input type="text" id="ssid" name="ssid" value="%CONFIG_SSID%">
154 | 	<br><br>
155 | 	
156 | 	<label for="password">Password:</label>
157 |     <input type="password" id="password" name="password" value="%CONFIG_PASSWORD%">
158 | 	<br><br>
159 |   
160 |     <label>Access Point Fallback:</label>
161 |     <input type="checkbox" id="access_point" name="access_point" %CONFIG_AP% title="Option will allow to fall back to access point mode in case of WIFI connection failure">
162 |     <br><br>
163 | 	
164 |     <label>Static:</label>
165 |     <input type="checkbox" id="static" name="static" %CONFIG_STATIC% onclick="document.getElementById('static_section').hidden = !this.checked;">
166 |     <br><br>
167 | 	
168 | 	<div id="static_section">
169 | 	
170 |       <label for="static_ip">IP:</label>
171 |       <input type="text" id="static_ip" name="static_ip" title="Static IP Address" value="%CONFIG_STATIC_IP%">
172 |       <br><br>
173 | 	  
174 | 	  <label for="static_netmask">Netmask:</label>
175 |       <input type="text" id="static_netmask" name="static_netmask" title="Static Netmask" value="%CONFIG_STATIC_NETMASK%">
176 |       <br><br>
177 | 	  
178 | 	  <label for="static_gateway">Gateway:</label>
179 |       <input type="text" id="static_gateway" name="static_gateway" title="Static Gateway" value="%CONFIG_STATIC_GATEWAY%">
180 |       <br><br>
181 | 	  
182 |     </div>
183 | 	
184 |   
185 |     <h4>E1.31</h4>
186 |     <hr>
187 | 
188 |     <label for="channel_start">Channel Offset:</label>
189 |     <input type="number" id="channel_offset" name="channel_offset" min="0" value="%CONFIG_CHANNEL_OFFSET%">
190 |     <br><br>
191 | 	  
192 |     <label>Multicast:</label>
193 |     <input type="checkbox" id="multicast" name="multicast" %CONFIG_MULTICAST% onclick="document.getElementById('universe_label').hidden = !this.checked;">
194 |     <br><br>
195 | 	
196 | 	<div id="universe_label">
197 |       <label for="universe">Universe:</label>
198 |       <input type="number" id="universe" name="universe" min="1" value="%CONFIG_UNIVERSE%">
199 |       <br><br>
200 |     </div>
201 | 
202 |     <h4>GPIO</h4>
203 |     <hr>
204 | 
205 | 	<label>Digital:</label>
206 | 	<input type="checkbox" id="digital" name="digital" %CONFIG_DIGITAL% onclick="document.getElementById('digital_threshold_div').hidden = !this.checked;">
207 | 	<br><br>
208 | 
209 | 	<div class=class="slidecontainer" id="digital_threshold_div">
210 |       <label for="digital_threshold">Digital Threshold:</label>
211 |       <input type="range" min="1" max="255" id="digital_threshold" name="digital_threshold" value="%CONFIG_THRESHOLD%" oninput="UpdateThreshold(value)">
212 |       <output for="digital_threshold" id="thresholdvalue"></output>
213 | 	  <br><br>
214 | 
215 | 	  <label>Low Level:</label>
216 | 	  <input type="checkbox" id="digital_lowlevel" name="digital_lowlevel" %CONFIG_LOWLEVEL% title="Option will secify Low Level trigger relays">
217 | 	  <br><br>
218 |     </div>
219 |     
220 |     <input type="submit" value="Submit" >
221 |   </form>
222 | </div>
223 | 
224 | <div id="Test" class="tabcontent">
225 |   
226 |   %RELAYS%
227 |  
228 | </div>
229 | 
230 | <script>
231 | function openTab(evt, Tab) {
232 |   var i, tabcontent, tablinks;
233 |   
234 |   tabcontent = document.getElementsByClassName("tabcontent");
235 |   for (i = 0; i < tabcontent.length; i++) {
236 |     tabcontent[i].style.display = "none";
237 |   }
238 |   
239 |   tablinks = document.getElementsByClassName("tablinks");
240 |   for (i = 0; i < tablinks.length; i++) {
241 |     tablinks[i].className = tablinks[i].className.replace(" active", "");
242 |   }
243 |   
244 |   document.getElementById(Tab).style.display = "block";
245 |   evt.currentTarget.className += " active";
246 | }
247 | 
248 | document.addEventListener( "DOMContentLoaded", function(){
249 |     document.removeEventListener( "DOMContentLoaded", arguments.callee, false );
250 | 	//starts with config tab open
251 |     openTab(event, 'Config');
252 | 	//forces checkbox click logic (ie div closure)
253 | 	document.getElementById("static").onclick();
254 | 	document.getElementById("multicast").onclick();
255 | 	document.getElementById("digital").onclick();
256 | 	document.getElementById("digital_threshold").oninput();
257 | }, false );
258 | 
259 | var UpdateTimer = setInterval(Update,1000);
260 | var PageLoadTime = Date.now();
261 | function Update() {
262 |   var ESPUptime = %UPTIME%;
263 |   var date = new Date(Date.now()-PageLoadTime+ESPUptime); 
264 |   
265 |   var str = Math.floor(date.getTime()/86400000) + " days, ";
266 |   str += ("0" + date.getUTCHours()).slice(-2) + ":";
267 |   str += ("0" + date.getUTCMinutes()).slice(-2) + ":";
268 |   str += ("0" + date.getUTCSeconds()).slice(-2);
269 |   document.getElementById("uptime").innerHTML = str;
270 | }			
271 | 
272 | function UpdateThreshold(val) {
273 | 	document.querySelector('#thresholdvalue').value = val;
274 | }
275 | </script>
276 |    
277 | </body>
278 | </html> 
279 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # ESP-131GPIO
 2 | 
 3 | This is arduino firmware that will listen to a E1.31 (sACN) data soure and will drive a boards GPIO pins. The firmware supports ESP8266 and is currently configured to support the WEMOS mini.  This was designed to drive relays for static christmas display lights being driven by Vixen, XLights or other application that output a E1.31 data stream. The board supports the following ...
 4 | 
 5 | * Web Interface
 6 |   * Status page
 7 |   * Configuration Page
 8 |     * Network
 9 |     * E131
10 |     * GPIO
11 |   * Test Page
12 | 
13 | * REST API - to set relay states through an external interface
14 |   * /SetRelay?relay=[0-#]&checked=[true|false]
15 | * Captive Portal (Optional) - Automatically start the arduino in access point mode if the WiFi settings aren't able to connect.
16 | * Digital/PWM support
17 | 
18 | # Hardware
19 | 
20 | [WeMos D1 Mini](https://www.amazon.com/IZOKEE-NodeMcu-Internet-Development-Compatible/dp/B076F52NQD)
21 | 
22 | <img src="images/Wemos.jpg" width="10%" height="10%">
23 | 
24 | [8-Channel 5V Solid State Relay](https://www.amazon.com/gp/product/B006J4G45G)
25 | 
26 | <img src="images/Relay.jpg" width="10%" height="10%">
27 | 
28 | # Wiring
29 | 
30 | <img src="images/GPIORelay-Wiring.jpg" width="50%" height="50%">
31 | 
32 | # Build Environments
33 | 
34 | There are 2 ways to build the software.  The first is to use the arduino ide and the second is to use platformio.  The required libraries for the arduino ide environment are listed below and must be installed in order to compile. The Platformio environment is a little easier to use as the libraries should automatically be downloaded and made available to the environment for you. 
35 | 
36 | [Arduino IDE](https://www.arduino.cc/en/main/software)
37 | 
38 | [Arduino 8266](https://github.com/esp8266/Arduino)
39 | 
40 | [arduino-esp8266littlefs-plugin](https://github.com/earlephilhower/arduino-esp8266littlefs-plugin/releases)
41 | 
42 | or
43 | 
44 | [Platformio](https://platformio.org/install)
45 | 
46 | # Arduino IDE Libraries
47 | [Arduino WiFi](https://www.arduino.cc/en/Reference/WiFi)
48 | 
49 | [Arduino JSON](https://arduinojson.org/)
50 | 
51 | [ESPAsyncE131](https://github.com/forkineye/ESPAsyncE131)
52 | 
53 | [ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer)
54 | 
55 | [ESPAsyncDNSServer](https://github.com/devyte/ESPAsyncDNSServer)
56 | 
57 | [ESPAsyncTCP](https://github.com/me-no-dev/ESPAsyncTCP)
58 | 
59 | [ESPAsyncUDP](https://github.com/me-no-dev/ESPAsyncUDP)
60 | 
61 | # Software Installation
62 | 
63 | Download and install the above build environments and libraries.  The build environments can be installed by downloading and installing the appropriate software.  The libraries can be installed through the ide with manage libraries.
64 | 
65 | # Firmware Installion
66 | 1. The Wemos requires you to jump pins D3 and GND to start the board into programming mode.  
67 | 2. Plug the arduino into your computers USB. 
68 | 3. Click the upload button to compile and transfer the firmware to the arduino. 
69 | 4. Then select the "ESP8266 LittleFS data upload" found under the tools menu. This will upload the data directory (html) to the arduino.
70 | 
71 | # Web Interface
72 | 
73 | <img src="images/Status.png" width="25%" height="25%">
74 | <img src="images/Config.png" width="25%" height="25%">
75 | <img src="images/Test.png" width="25%" height="25%">
76 | 
77 | # Acknowledgements
78 | I wish to thank the following individuals / groups were instrumental into helping make this project.
79 | * [Shelby Merrick](https://github.com/forkineye)
80 |   * [ESPixelStick](https://github.com/forkineye/ESPixelStick)
81 |   * [E131](https://github.com/forkineye/E131)
82 | * [doityourselfchistmas](http://doityourselfchristmas.com/forums/archive/index.php/t-51293.html)
83 | * many others with various examples, tutorials, etc.
84 | 


--------------------------------------------------------------------------------
/_config.yml:
--------------------------------------------------------------------------------
1 | theme: jekyll-theme-cayman


--------------------------------------------------------------------------------
/images/Config.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/garymueller/ESP-131GPIO/933761cbd7473b1b85fdf5d779e8774fdd164b3d/images/Config.png


--------------------------------------------------------------------------------
/images/GPIORelay-Wiring.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/garymueller/ESP-131GPIO/933761cbd7473b1b85fdf5d779e8774fdd164b3d/images/GPIORelay-Wiring.jpg


--------------------------------------------------------------------------------
/images/Relay.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/garymueller/ESP-131GPIO/933761cbd7473b1b85fdf5d779e8774fdd164b3d/images/Relay.jpg


--------------------------------------------------------------------------------
/images/Status.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/garymueller/ESP-131GPIO/933761cbd7473b1b85fdf5d779e8774fdd164b3d/images/Status.png


--------------------------------------------------------------------------------
/images/Test.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/garymueller/ESP-131GPIO/933761cbd7473b1b85fdf5d779e8774fdd164b3d/images/Test.png


--------------------------------------------------------------------------------
/images/Wemos.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/garymueller/ESP-131GPIO/933761cbd7473b1b85fdf5d779e8774fdd164b3d/images/Wemos.jpg


--------------------------------------------------------------------------------
/platformio.ini:
--------------------------------------------------------------------------------
 1 | [platformio]
 2 | src_dir = ./ESP-131GPIO
 3 | data_dir = ./ESP-131GPIO/data
 4 | 
 5 | [env]
 6 | upload_speed = 921600
 7 | monitor_speed = 115200
 8 | 
 9 | [esp8266]
10 | framework = arduino
11 | platform = espressif8266
12 | board_build.filesystem = littlefs
13 | lib_deps =
14 |   forkineye/ESPAsyncE131 @ ^1.0.4
15 |   ESP Async WebServer @ ^1.2.3
16 |   devyte/ESPAsyncDNSServer @ ^1.0.0
17 |   bblanchon/ArduinoJson @ ^6.19.4
18 | 
19 | [env:d1_mini]
20 | extends = esp8266
21 | board = d1_mini
22 | build_flags =
23 |     -D BOARD_NAME='"d1_mini"'
24 | 
25 | 
26 | 


--------------------------------------------------------------------------------