Release v2.0.0-beta1

Author: miloszlagan

README.md

@@ -0,0 +1,24 @@
+![Husarnet logo](images/logo.svg)
+
+# Husarnet for Arduino ESP32
+
+Husarnet is a low latency, lightweight, privacy preserving P2P VPN. If you want
+to know more go to the [Husarnet's webpage](https://husarnet.com/) or directly
+to the [documentation page](https://docs.husarnet.com/).
+
+This repository only contains library code for the Arduino IDE. If you want
+to use Husarnet with the PlatformIO IDE, go to the [husarnet-esp32-platformio](https://github.com/husarnet/husarnet-esp32-platformio).
+
+Due to the way precompiled libraries work in Arduino the static library for each
+target must be placed in a seperate directory. Due to this `libhusarnet.a` is
+duplicated few times in different folders.
+
+## Installation and usage
+
+Coming soon...
+
+## Examples
+
+You'll find full examples in our [examples](examples) directory.
+
+Start with a [simple-webserver](examples/simple-webserver) for a fairly minimal example.

examples/simple-webserver/simple-webserver.ino

@@ -0,0 +1,60 @@
+#include <Arduino.h>
+#include <WiFi.h>
+#include <WebServer.h>
+#include <husarnet.h>
+
+// WiFi credentials
+#define WIFI_SSID = "wifi-network";
+#define WIFI_PASS = "wifi-password";
+
+// Husarnet credentials
+#define HOSTNAME = "esp32-arduino-webserver";
+#define JOIN_CODE = "xxxxxxxxxxxxxxxxxxxx";
+
+HusarnetClient husarnet;
+WebServer server(80);
+
+void handleRoot() {
+  server.send(200, "text/plain", "Hello Husarnet!");
+}
+
+void setup() {
+  Serial.begin(115200);
+
+  // Connect to the WiFi network
+  WiFi.mode(WIFI_STA);
+  WiFi.begin(WIFI_SSID, WIFI_PASS);
+  
+  Serial.println("Connecting to WiFi");
+  if (WiFi.waitForConnectResult() != WL_CONNECTED) {
+    Serial.printf("WiFi connection failure (err: %d)\n", WiFi.status());
+    delay(5000);
+    ESP.restart();
+  }
+
+  Serial.print("Local IP: ");
+  Serial.println(WiFi.localIP());
+
+  // Join the Husarnet network
+  husarnet.join(HOSTNAME, JOIN_CODE);
+
+  while(!husarnet.isJoined()) {
+    Serial.println("Waiting for Husarnet network...");
+    delay(1000);
+  }
+  Serial.println("Husarnet network joined");
+
+  Serial.print("Husarnet IP: ");
+  Serial.println(husarnet.getIpAddress().c_str());
+
+  // Start the web server
+  server.on("/", handleRoot);
+  server.begin();
+  Serial.println("HTTP server started");
+}
+
+void loop() {
+  // Handle incoming connections
+  server.handleClient();
+  delay(2);
+}

images/logo.svg

@@ -0,0 +1,10 @@
+name=Husarnet ESP32
+version=2.0.0-beta1
+author=Husarnet
+maintainer=Milosz Lagan, [email protected]
+sentence=Connect your devices using secure P2P network layer for robots and IoT.
+paragraph=Look at docs.husarnet.com for information how to configure your project!
+category=Communication
+url=https://husarnet.com/
+includes=husarnet.h
+precompiled=true