Merge pull request esp8266#648 from kzyapkov/avrisp

ESP8266AVRISP library

Author: igrr

libraries/ESP8266AVRISP/README.md

@@ -0,0 +1,57 @@
+# AVR In-System Programming over WiFi for ESP8266
+
+This library allows an ESP8266 module with the HSPI port available to become
+an AVR In-System Programmer.
+
+## Hardware
+
+The ESP8266 module connects to the AVR target chip via the standard 6-pin
+AVR "Recommended In-System Programming Interface Connector Layout" as seen
+in [AVR910](http://www.atmel.com/images/doc0943.pdf) among other places.
+
+If the AVR target is powered by a different Vcc than what powers your ESP8266
+chip, you **must provide voltage level shifting** or some other form of buffers.
+Exposing the pins of ESP8266 to anything larger than 3.6V will damage it.
+
+Connections are as follows:
+
+ESP8266 | AVR / SPI  
+--------|------------
+GPIO12  | MISO
+GPIO13  | MOSI
+GPIO14  | SCK
+any*    | RESET
+
+For RESET use a GPIO other than 0, 2 and 15 (bootselect pins), and apply an
+external pullup/down so that the target is normally running.
+
+## Usage
+
+See the included example. In short:
+
+```arduino
+
+// Create the programmer object
+ESP8266AVRISP avrprog(PORT, RESET_PIN)
+// ... with custom SPI frequency
+ESP8266AVRISP avrprog(PORT, RESET_PIN, 4e6)
+
+// Check current connection state, but don't perform any actions
+AVRISPState_t state = avrprog.update();
+
+// Serve the pending connection, execute STK500 commands
+AVRISPState_t state = avrprog.serve();
+```
+
+### License and Authors
+
+This library started off from the source of ArduinoISP "sketch" included with
+the Arduino IDE:
+
+    ArduinoISP version 04m3
+    Copyright (c) 2008-2011 Randall Bohn
+    If you require a license, see
+        http://www.opensource.org/licenses/bsd-license.php
+
+    Support for TCP on ESP8266
+    Copyright (c) Kiril Zyapkov <[email protected]>.

libraries/ESP8266AVRISP/examples/Arduino_Wifi_AVRISP/Arduino_Wifi_AVRISP.ino

@@ -0,0 +1,67 @@
+#include <SPI.h>
+#include <ESP8266WiFi.h>
+#include <ESP8266mDNS.h>
+#include <ESP8266AVRISP.h>
+
+const char* host = "esp8266-avrisp";
+const char* ssid = "**********";
+const char* pass = "**********";
+const uint16_t port = 328;
+const uint8_t reset_pin = 5;
+
+ESP8266AVRISP avrprog(port, reset_pin);
+
+void setup() {
+    Serial.begin(115200);
+    Serial.println("");
+    Serial.println("Arduino AVR-ISP over TCP");
+    avrprog.setReset(false); // let the AVR run
+
+    WiFi.begin(ssid, pass);
+    while (WiFi.waitForConnectResult() != WL_CONNECTED);
+
+    MDNS.begin(host);
+    MDNS.addService("avrisp", "tcp", port);
+
+    IPAddress local_ip = WiFi.localIP();
+    Serial.print("IP address: ");
+    Serial.println(local_ip);
+    Serial.println("Use your avrdude:");
+    Serial.print("avrdude -c arduino -p <device> -P net:");
+    Serial.print(local_ip);
+    Serial.print(":");
+    Serial.print(port);
+    Serial.println(" -t # or -U ...");
+
+    // listen for avrdudes
+    avrprog.begin();
+}
+
+void loop() {
+    static AVRISPState_t last_state = AVRISP_STATE_IDLE;
+    AVRISPState_t new_state = avrprog.update();
+    if (last_state != new_state) {
+        switch (new_state) {
+            case AVRISP_STATE_IDLE: {
+                Serial.printf("[AVRISP] now idle\r\n");
+                // Use the SPI bus for other purposes
+                break;
+            }
+            case AVRISP_STATE_PENDING: {
+                Serial.printf("[AVRISP] connection pending\r\n");
+                // Clean up your other purposes and prepare for programming mode
+                break;
+            }
+            case AVRISP_STATE_ACTIVE: {
+                Serial.printf("[AVRISP] programming mode\r\n");
+                // Stand by for completion
+                break;
+            }
+        }
+        last_state = new_state;
+    }
+    // Serve the client
+    if (last_state != AVRISP_STATE_IDLE) {
+        avrprog.serve();
+    }
+}

libraries/ESP8266AVRISP/library.properties

@@ -0,0 +1,9 @@
+name=ESP8266AVRISP
+version=1.0
+author=Kiril Zyapkov
+maintainer=Kiril Zyapkov <[email protected]>
+sentence=AVR In-System Programming over WiFi for ESP8266
+paragraph=This library allows programming 8-bit AVR ICSP targets via TCP over WiFi with ESP8266.
+category=Communication
+url=
+architectures=esp8266