From 28de70e73257779a0b7161dd5de6fafabe2edf62 Mon Sep 17 00:00:00 2001
From: Philipp Matthias Schaefer <philipp.matthias.schaefer@posteo.de>
Date: Thu, 26 Nov 2020 09:20:24 +0100
Subject: [PATCH 1/3] Remove unused variable

---
 source/arduino/door_status.ino | 2 --
 1 file changed, 2 deletions(-)

diff --git a/source/arduino/door_status.ino b/source/arduino/door_status.ino
index fd81a16..f5acb10 100644
--- a/source/arduino/door_status.ino
+++ b/source/arduino/door_status.ino
@@ -28,8 +28,6 @@ with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
 uint8_t OPEN = 1;
 uint8_t CLOSED = 0;
 
-int wifi_status = WL_IDLE_STATUS;
-
 WiFiUDP Udp;
 
 void setup() {

From 001c7cd5687d1796a05a5c103453115b2300c878 Mon Sep 17 00:00:00 2001
From: Philipp Matthias Schaefer <philipp.matthias.schaefer@posteo.de>
Date: Fri, 11 Dec 2020 14:18:46 +0100
Subject: [PATCH 2/3] Implement and document Arduino software

---
 .gitignore                                   |   2 +
 README.md                                    | 116 +++++++++++++++++--
 documentation/Makefile                       |  33 ++++++
 documentation/arduino.png                    | Bin 0 -> 16474 bytes
 documentation/arduino.tex                    |  55 +++++++++
 scripts/test_udp_api.py                      |  62 ++++++++++
 source/arduino/Makefile                      |  33 ++++++
 source/arduino/arduino.ino                   |  70 +++++++++++
 source/arduino/config.h                      |  11 +-
 source/arduino/matrix.cpp                    |  87 ++++++++++++++
 source/arduino/matrix.h                      |  33 ++++++
 source/arduino/sensor.cpp                    |  35 ++++++
 source/arduino/sensor.h                      |  29 +++++
 source/arduino/serial.cpp                    |  26 +++++
 source/arduino/serial.h                      |  22 ++++
 source/arduino/{door_status.ino => wifi.cpp} |  77 +++---------
 source/arduino/wifi.h                        |  27 +++++
 17 files changed, 648 insertions(+), 70 deletions(-)
 create mode 100644 .gitignore
 create mode 100644 documentation/Makefile
 create mode 100644 documentation/arduino.png
 create mode 100644 documentation/arduino.tex
 create mode 100755 scripts/test_udp_api.py
 create mode 100644 source/arduino/Makefile
 create mode 100644 source/arduino/arduino.ino
 create mode 100644 source/arduino/matrix.cpp
 create mode 100644 source/arduino/matrix.h
 create mode 100644 source/arduino/sensor.cpp
 create mode 100644 source/arduino/sensor.h
 create mode 100644 source/arduino/serial.cpp
 create mode 100644 source/arduino/serial.h
 rename source/arduino/{door_status.ino => wifi.cpp} (52%)
 create mode 100644 source/arduino/wifi.h

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..7274ad1
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+/documentation/build/
+/source/arduino/build/
diff --git a/README.md b/README.md
index ec54111..863398e 100644
--- a/README.md
+++ b/README.md
@@ -21,24 +21,126 @@ includes a field indicating whether the space is open or closed.
 
 ## Arduino
 
-## Python Script
+### Arduino: Hardware
+
+We measure the door's lock state using a reed switch. The switch is installed at
+the bottom of hole for the deadbolt and gets triggered by a magnet glued to the
+tip of the deadbolt.
+
+The reed switch is connected to pin 0 and ground on an Arduino MKR1000. The
+software sets up pin 0 (by default) with a pull up resistor. This prevents
+currents induced into the long wire between switch an Arduino to trigger the pin
+state.
+
+A second component connected to the MKR1000 is an Arduino MKR RGB Shield that
+provides a 7x12 RGB LED matrix. It is used to give visual feedback on the
+software's current state.
+
+While trying to connect to the configured WLAN, a vertical yellow line
+oscillates between both sides of the display. When connecting to the WLAN fails,
+a red cross is displayed. When the room is open all LEDs are green, and when it
+is closed all LEDs are turned off (nobody should be there to see it anyway).
+
+The following images is a schematic showing the connections between the three
+components mentioned.
+
+![a schematic of Arduino MKR1000 and all components physically connected to it, as described in the text](documentation/arduino.png)
+
+The Arduino is powered by a USB charger.
+
+If you need to change the schematic, adapt `documentation/arduino.tex` and run
+`make`. This requires the following software and TeX libraries to be installed
+on your systems:
+
+- pdflatex
+- convert from ImageMagick
+- tikz
+- circuitikz
+
+### Arduino: Setup and Configuration
+
+The sketch for our Arduino is located in `sources/arduino`. Before we flash the
+Arduino with the sketch, we should adapt `config.h`. We can use either the
+[Arduino IDE](https://www.arduino.cc/en/software) or the provided Makefile to
+verify or flash the sketch.
+
+For the Makefile to work,
+[Arduino CLI](https://arduino.github.io/arduino-cli/latest/) has to be
+installed. Use `make` for verification and `make install` to flash the board,
+which needs to be connected to our PC via USB cable.
+
+Verifying and flashing the sketch requires the installation of several
+libraries.
+
+First we need the core for the family of boards Arduino MKR1000
+belongs to: Arduino SAMD Boards (or `arduino:samd`). Installation instructions
+for [Arduino IDE](https://www.arduino.cc/en/guide/cores) and
+[Arduino CLI](https://arduino.github.io/arduino-cli/latest/commands/arduino-cli_core_install/)
+can be found in the respective documentation.
+
+Then we need to make sure the following libraries are installed:
+
+- ArduinoGraphics
+- Arduino_MKRRGB
+- uTimerLib
+- WiFi101
+
+Installed instructions for
+[Arduino IDE](https://www.arduino.cc/en/guide/libraries) and
+[Arduino CLI](https://arduino.github.io/arduino-cli/latest/commands/arduino-cli_lib_install/)
+can be found in the respective documentation.
+
+We assign a fixed IP address in the space's WiFi network to the Arduino's MAC
+address. The MAC address gets printed to `Serial` on each start up. Once
+connected to the configured WLAN, the IP address is also printed to `Serial`.
+(TODO: MENTION WHERE TO FIND DOCUMENTATION FOR OUR DHCPD.)
+
+### Arduino: UDP API
+
+Once the Arduino has started successfully, it listens on the configured port
+(see [sources/arduino/config.h](sources/arduino/config.h) for the default port)
+for UDP packets and answers each incoming packet with the state of the door. The
+state is encoded as a one byte integer, where `0` stands for closed and `1`
+stands for open.
+
+In `scripts` is the Python 3 script `test_udp_api.py`, which we use to test the
+UDP API. It takes an IP address and optionally a port, queries the Arduino, and
+prints out the result.
+
+## In-Space Service
+
+## Internet Service
 
-## API
 
 ## License
 
 The authors of the Arduino code license the code under the AGPL 3.0 (see
-`LICENSE.AGPL`). The respective authors are listed in the in the preambles of
-each source file.
+`LICENSE.AGPL`). The respective authors are listed in the preambles of each
+source file.
 
 ## Dependencies
 
+The creation of the schematic image depends on the following libraries:
+
+*TikZ* published by the copyright holders under the GPL 2, the Free
+Documentation License, and the LaTeX Project Public License 1.3c
+
+*Circuitikz* published by the copyright holders under the GPL 2 and the LaTeX
+Project Public License
+
 The Arduino code depends on the following libraries:
 
-_Arduino Core_ published by the copyright holders under the LGPL 2.1 or later.
+*Arduino SAMD Boards* published by the copyright holders under the LGPL 2.1 or later.
 
-_SPI Master Library for Arduino Zero_ published by the copyright holders under
+*SPI Master Library for Arduino Zero* published by the copyright holders under
 the LGPL 2.1 or later.
 
-_Library for Arduino WiFi Shield_ published by the copyright holders under the
+*ArduinoGraphics* published by the copyright holders under the LGPL 2.1 or
+later.
+
+*Arduino_MKRRGB* published by the copyright holders under the LGPL 2.1 or later.
+
+*uTimerLib* published by the copyright holders under the LGPL 3.
+
+*WiFi101* published by the copyright holders under the
 LGPL 2.1 or later.
diff --git a/documentation/Makefile b/documentation/Makefile
new file mode 100644
index 0000000..f4a2f05
--- /dev/null
+++ b/documentation/Makefile
@@ -0,0 +1,33 @@
+# Copyright (c):
+#
+# Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+#
+# This file is part of the KrautStatus' Arduino code.
+#
+# The Clean CommonMark library is free software: you can redistribute it and/or
+# modify it under the terms of the GNU Affero General Public License as
+# published by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# The Clean CommonMark library is distributed in the hope that it will be
+# useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
+# General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with the Clean CommonMark library. If not, see
+# <https://www.gnu.org/licenses/>.
+
+.PHONY: all clean
+
+all: arduino.png
+
+clean:
+	rm --recursive build
+
+arduino.png: arduino.tex build
+	pdflatex -output-directory build arduino
+	convert -density 300 build/arduino.pdf -trim -colorspace RGB arduino.png
+
+build:
+	mkdir --parents build
diff --git a/documentation/arduino.png b/documentation/arduino.png
new file mode 100644
index 0000000000000000000000000000000000000000..efa3f652e2a6bc9312afa60462220c056e0e944b
GIT binary patch
literal 16474
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
JFb^%>{5MK_*UbO`

literal 0
HcmV?d00001

diff --git a/documentation/arduino.tex b/documentation/arduino.tex
new file mode 100644
index 0000000..816564a
--- /dev/null
+++ b/documentation/arduino.tex
@@ -0,0 +1,55 @@
+\documentclass[border=1mm]{standalone}
+
+\usepackage{tikz}
+\usetikzlibrary{positioning}
+\usepackage{circuitikz}
+
+\begin{document}
+
+\begin{circuitikz}[
+  chip/.style = {
+    dipchip,
+    hide numbers,
+    no topmark,
+    external pins width=0,
+    num pins=14,
+  }]
+  \ctikzset{multipoles/dipchip/width=1.6}
+
+  % Arduino MKR1000
+  \node [chip] (MKR1000) {};
+  % align=center enables line breaks in node text
+  \node [align=center, rotate=90] at (MKR1000.center){Arduino\\MKR1000};
+
+  \draw (MKR1000.n) -- ++(0,1) node[vcc]{};
+  \draw (MKR1000.s) -- ++(0,-1) node[ground] {};
+
+  \node [right, font=\tiny] at (MKR1000.bpin 4) {0};
+
+  \node [left, font=\tiny] at (MKR1000.bpin 12) {VIN};
+  \node [left, font=\tiny] at (MKR1000.bpin 11) {A3};
+  \node [left, font=\tiny] at (MKR1000.bpin 10) {A4};
+
+  % Arduino MKR RGB Shield
+  \node[chip, right=of MKR1000] (RGB) {};
+  % align=center enables line breaks in node text
+  \node [align=center, rotate=90] at (RGB.center){Arduino\\MKR RGB Shield};
+
+  \draw (RGB.s) -- ++(0, -1) node[ground]{};
+
+  \node [right, font=\tiny] at (RGB.bpin 3) {VIN};
+  \node [right, font=\tiny] at (RGB.bpin 4) {A3};
+  \node [right, font=\tiny] at (RGB.bpin 5) {A4};
+
+  \draw (MKR1000.bpin 12) -- (RGB.bpin 3);
+  \draw (MKR1000.bpin 11) -- (RGB.bpin 4);
+  \draw (MKR1000.bpin 10) -- (RGB.bpin 5);
+
+  % Reed switch
+  \draw (MKR1000.bpin 4) -- ++(-1, 0) to [normal open switch, name=R] ++(0, -2.96) node[ground]{};
+
+  \node [rotate=90, above] at (R) {Reed Switch};
+\end{circuitikz}
+
+
+\end{document}
diff --git a/scripts/test_udp_api.py b/scripts/test_udp_api.py
new file mode 100755
index 0000000..ada9d0c
--- /dev/null
+++ b/scripts/test_udp_api.py
@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+"""
+Test KrautStatus's UDP API for a given IP and (optionally) port.
+"""
+
+import argparse
+import ipaddress
+import socket
+
+def port(string):
+    "Convert string to an unsigend integer that is a valid port number"
+    port = int(string)
+
+    if port < 0 or port > 65535:
+        raise ValueError()
+
+    return port
+
+def main():
+    parser = argparse.ArgumentParser(__doc__)
+
+    parser.add_argument("ip",
+                        metavar="IP",
+                        type=ipaddress.ip_address,
+                        help="IP address of the KrautStatus Arduino")
+
+    parser.add_argument("port",
+                        nargs="?",
+                        metavar="PORT",
+                        default=12345,
+                        type=port,
+                        help="port that the KrautStatus Arduino listens to")
+
+    args = parser.parse_args()
+
+
+    receiver = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    receiver.bind(('0.0.0.0', args.port))
+    print(f'Listening on 0.0.0.0:{args.port}.')
+
+    sender = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    # We do not use \0 or \1 here, so that we do not trigger ourselves when
+    # testing the script locally (127.0.0.1)
+    sender.sendto(b'\2', (str(args.ip), args.port))
+    print(f'Sent null byte to {args.ip}:{args.port}.')
+
+    while True:
+        status, address = receiver.recvfrom(1)
+
+        if not address[0] == str(args.ip):
+            continue
+
+        if status[0] == 0:
+            print('Responded: door closed')
+            return
+
+        if status[0] == 1:
+            print('Resondend: door open')
+            return
+
+if __name__ == "__main__":
+    main()
diff --git a/source/arduino/Makefile b/source/arduino/Makefile
new file mode 100644
index 0000000..0f54ea4
--- /dev/null
+++ b/source/arduino/Makefile
@@ -0,0 +1,33 @@
+# Copyright (c):
+#
+# Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+#
+# This file is part of the KrautStatus' Arduino code.
+#
+# The Clean CommonMark library is free software: you can redistribute it and/or
+# modify it under the terms of the GNU Affero General Public License as
+# published by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# The Clean CommonMark library is distributed in the hope that it will be
+# useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
+# General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with the Clean CommonMark library. If not, see
+# <https://www.gnu.org/licenses/>.
+
+.PHONY: all clean install
+
+all:
+	arduino-cli compile --fqbn arduino:samd:mkr1000
+
+clean:
+	rm --recursive build
+
+install:
+	PORT=$(arduino-cli board list | \
+	       grep arduino:samd:mkr1000 | \
+	       sed -e 's/ .*//g'); \
+	arduino-cli upload --fqbn arduino:samd:mkr1000 --port $$PORT
diff --git a/source/arduino/arduino.ino b/source/arduino/arduino.ino
new file mode 100644
index 0000000..f6a3477
--- /dev/null
+++ b/source/arduino/arduino.ino
@@ -0,0 +1,70 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+#include <SPI.h>
+#include <uTimerLib.h>
+
+#include "config.h"
+#include "matrix.h"
+#include "sensor.h"
+#include "serial.h"
+#include "wifi.h"
+
+const unsigned long int MATRIX_UPDATE_FREQUENCY = 1;
+
+void setup() {
+  serial_setup();
+  matrix_setup();
+
+  boolean wifi_result = matrix_show_scan_and_run(wifi_setup);
+  if (!wifi_result) {
+    matrix_show_failure();
+    while(true);
+  }
+
+  sensor_setup();
+
+  start_matrix_update();
+}
+
+void loop() {
+  int packetSize = Udp.parsePacket();
+  if (packetSize) {
+    Udp.beginPacket(Udp.remoteIP(), Udp.remotePort());
+    Udp.write(uint8_t(sensor_get_door_state()));
+    Udp.endPacket();
+  }
+}
+
+void start_matrix_update() {
+  TimerLib.setInterval_us(matrix_update, 1000000 / MATRIX_UPDATE_FREQUENCY);
+}
+
+void matrix_update() {
+  switch (sensor_get_door_state()) {
+  OPEN:
+    matrix_fill(GREEN);
+    break;
+  CLOSED:
+    matrix_fill(BLACK);
+    break;
+  }
+}
diff --git a/source/arduino/config.h b/source/arduino/config.h
index 49db287..2cb04dc 100644
--- a/source/arduino/config.h
+++ b/source/arduino/config.h
@@ -19,14 +19,15 @@ You should have received a copy of the GNU Affero General Public License along
 with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
 */
 
+#include <stdint.h>
+
 // SSID and password of the WiFi network to which we broadcast the door lock's
 // status.
-char SSID[] = "";
-char PASSWORD[] = "";
-
+const char SSID[] = "";
+const char PASSWORD[] = "";
 
 // Port on which to listen for status requests
-unsigned int PORT = 12345;
+const unsigned int SERVER_PORT = 12345;
 
 // Pin to which the reed switch is connected
-uint8_t REED_PIN = 0;
+const uint8_t SENSOR_PIN = 0;
diff --git a/source/arduino/matrix.cpp b/source/arduino/matrix.cpp
new file mode 100644
index 0000000..38f9ace
--- /dev/null
+++ b/source/arduino/matrix.cpp
@@ -0,0 +1,87 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+#include <ArduinoGraphics.h>
+#include <Arduino_MKRRGB.h>
+#include <uTimerLib.h>
+
+#include "matrix.h"
+
+
+const uint32_t RED    = COLOR(255,   0,   0);
+const uint32_t YELLOW = COLOR(255, 255,   0);
+
+const unsigned long int SCAN_UPDATE_FREQUENCY = 25;
+
+void matrix_setup() {
+  MATRIX.begin();
+}
+
+void matrix_show_failure() {
+  MATRIX.stroke(RED);
+  MATRIX.beginDraw();
+  MATRIX.clear();
+  MATRIX.line(0, 0, MATRIX.width() - 1, MATRIX.height() - 1);
+  MATRIX.line(0, MATRIX.height() - 1, MATRIX.width() - 1, 0);
+  MATRIX.endDraw();
+}
+
+uint8_t scan_timer = 0;
+
+void matrix_paint_scan() {
+  // We paint a vertical line that oscillates between the left and right border
+  // of the matrix. Going back and forth one pixel at a time gives us as period
+  // of
+  //     2 * width - 2
+  // because we do not want to remain at the borders for one tick.
+  scan_timer += 1;
+  scan_timer %= 2 * MATRIX.width() - 2;
+
+  uint8_t position = scan_timer;
+  if(position >= MATRIX.width())
+    position = 2 * MATRIX.width() - position - 2;
+
+  MATRIX.beginDraw();
+  MATRIX.clear();
+  MATRIX.line(position, 0, position, 6);
+  MATRIX.endDraw();
+}
+
+bool matrix_show_scan_and_run(bool(*thunk)()) {
+  MATRIX.stroke(YELLOW);
+  TimerLib.setInterval_us(matrix_paint_scan, 1000000 / SCAN_UPDATE_FREQUENCY);
+
+  bool result = thunk();
+
+  TimerLib.clearTimer();
+  MATRIX.beginDraw();
+  MATRIX.clear();
+  MATRIX.endDraw();
+
+  return result;
+}
+
+void matrix_fill(uint32_t color) {
+  MATRIX.fill(color);
+  MATRIX.beginDraw();
+  MATRIX.clear();
+  MATRIX.endDraw();
+}
diff --git a/source/arduino/matrix.h b/source/arduino/matrix.h
new file mode 100644
index 0000000..0b4029f
--- /dev/null
+++ b/source/arduino/matrix.h
@@ -0,0 +1,33 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+#define COLOR(r, g, b) (r << 16 | g << 8 | b)
+
+const uint32_t BLACK = COLOR(  0,   0,   0);
+const uint32_t GREEN = COLOR(  0, 255,   0);
+
+void matrix_setup();
+
+void matrix_show_failure();
+
+bool matrix_show_scan_and_run(bool(*)());
+
+void matrix_fill(uint32_t color);
diff --git a/source/arduino/sensor.cpp b/source/arduino/sensor.cpp
new file mode 100644
index 0000000..173b04a
--- /dev/null
+++ b/source/arduino/sensor.cpp
@@ -0,0 +1,35 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+#include <Arduino.h>
+
+#include "sensor.h"
+#include "config.h"
+
+void sensor_setup() {
+  pinMode(SENSOR_PIN, INPUT_PULLUP);
+}
+
+door_state sensor_get_door_state() {
+  if (digitalRead(SENSOR_PIN) == HIGH)
+    return OPEN;
+  return CLOSED;
+}
diff --git a/source/arduino/sensor.h b/source/arduino/sensor.h
new file mode 100644
index 0000000..e6e5d4b
--- /dev/null
+++ b/source/arduino/sensor.h
@@ -0,0 +1,29 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+typedef enum {
+  CLOSED = 0,
+  OPEN = 1
+} door_state;
+
+void sensor_setup();
+
+door_state sensor_get_door_state();
diff --git a/source/arduino/serial.cpp b/source/arduino/serial.cpp
new file mode 100644
index 0000000..d394e4d
--- /dev/null
+++ b/source/arduino/serial.cpp
@@ -0,0 +1,26 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+#include <SPI.h>
+
+void serial_setup() {
+  Serial.begin(9600);
+}
diff --git a/source/arduino/serial.h b/source/arduino/serial.h
new file mode 100644
index 0000000..4e9ed58
--- /dev/null
+++ b/source/arduino/serial.h
@@ -0,0 +1,22 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+void serial_setup();
diff --git a/source/arduino/door_status.ino b/source/arduino/wifi.cpp
similarity index 52%
rename from source/arduino/door_status.ino
rename to source/arduino/wifi.cpp
index f5acb10..a604d12 100644
--- a/source/arduino/door_status.ino
+++ b/source/arduino/wifi.cpp
@@ -25,82 +25,43 @@ with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
 
 #include "config.h"
 
-uint8_t OPEN = 1;
-uint8_t CLOSED = 0;
-
 WiFiUDP Udp;
 
-void setup() {
-  pinMode(REED_PIN, INPUT_PULLUP);
-
-  Serial.begin(9600);
-  while (!Serial);
+void print_mac_address() {
+  uint8_t mac[6];
+  WiFi.macAddress(mac);
+  Serial.print("MAC: ");
+  for(unsigned int i = 5; i > 0; --i) {
+    Serial.print(mac[i], HEX);
+    Serial.print(":");
+  }
+  Serial.println(mac[0], HEX);
+}
 
+boolean wifi_setup() {
   if (WiFi.status() == WL_NO_SHIELD) {
     Serial.println("No WiFI shield present");
-    // TODO: Create noShieldLoop with visual indication.
-    while (true);
+    return false;
   }
 
+  print_mac_address();
+
   while (true) {
-    // TODO: Visually indicate that we are trying to connect
     Serial.print("Connecting to SSID: ");
     Serial.println(SSID);
-    status = WiFi.begin(SSID, PASSWORD);
 
-    if (status == WL_CONNECTED) {
+    if (WiFi.begin(SSID, PASSWORD) == WL_CONNECTED) {
       break;
     }
 
-    // TODO: Visually indicate that we waiting for trying to connect again
     delay(10000);
   }
 
-  printNetworkInfo();
-
-}
-
-void loop() {
-  int reed_state = digitalRead(REED_PIN);
-
-  int packetSize = Udp.readPacket();
-  if (packetSize) {
-    Udp.beginPacket(udp.remoteIP(), Udp.remotePort());
-
-    if (reed_state == HIGH) {
-      Udp.write(CLOSED);
-    } else {
-      Udp.write(OPEN);
-    }
-
-    Udp.endPacket();
-  }
-  // TODO: Visually indicate open/closed state.
-}
-
-
-void printNetworkInfo() {
-
-  Serial.print("Connect to WiFi");
-
-  IPAddress ip = WiFi.localIP();
+  Serial.println("Connect to WiFi");
   Serial.print("IP Address: ");
-  Serial.println(ip);
+  Serial.println(WiFi.localIP());
 
-  byte mac[6];
-  WiFi.macAddress(mac);
-  Serial.print("MAC address: ");
-  for (int i = 5; i >= 0; --i) {
-    if (mac[i] < 16) {
-      Serial.print("0");
-    }
-
-    Serial.print(mac[i], HEX);
-
-    if (i > 0) {
-      Serial.print(":");
-    }
-  }
-  Serial.println();
+  Udp.begin(SERVER_PORT);
 
+  return true;
 }
diff --git a/source/arduino/wifi.h b/source/arduino/wifi.h
new file mode 100644
index 0000000..17185b6
--- /dev/null
+++ b/source/arduino/wifi.h
@@ -0,0 +1,27 @@
+/*
+Copyright (c):
+
+Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+
+This file is part of the KrautStatus' Arduino code.
+
+The Clean CommonMark library is free software: you can redistribute it and/or
+modify it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+The Clean CommonMark library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License
+for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with the Clean CommonMark library. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+#include <WiFi101.h>
+#include <WiFiUdp.h>
+
+extern WiFiUDP Udp;
+
+bool wifi_setup();

From d734f86979547b91f746ba4aa3d00c3de9248a36 Mon Sep 17 00:00:00 2001
From: Philipp Matthias Schaefer <philipp.matthias.schaefer@posteo.de>
Date: Mon, 28 Dec 2020 22:01:32 +0100
Subject: [PATCH 3/3] Add missing license header

---
 documentation/arduino.tex | 19 +++++++++++++++++++
 scripts/test_udp_api.py   | 19 +++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/documentation/arduino.tex b/documentation/arduino.tex
index 816564a..0ddf92f 100644
--- a/documentation/arduino.tex
+++ b/documentation/arduino.tex
@@ -1,3 +1,22 @@
+% Copyright (c):
+%
+% Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+%
+% This file is part of the KrautStatus' Arduino code.
+%
+% The Clean CommonMark library is free software: you can redistribute it and/or
+% modify it under the terms of the GNU Affero General Public License as
+% published by the Free Software Foundation, either version 3 of the License, or
+% (at your option) any later version.
+%
+% The Clean CommonMark library is distributed in the hope that it will be
+% useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
+% General Public License for more details.
+%
+% You should have received a copy of the GNU Affero General Public License along
+% with the Clean CommonMark library. If not, see
+% <https://www.gnu.org/licenses/>.
 \documentclass[border=1mm]{standalone}
 
 \usepackage{tikz}
diff --git a/scripts/test_udp_api.py b/scripts/test_udp_api.py
index ada9d0c..f0cc5a6 100755
--- a/scripts/test_udp_api.py
+++ b/scripts/test_udp_api.py
@@ -1,4 +1,23 @@
 #!/usr/bin/env python3
+# Copyright (c):
+#
+# Philipp Matthias Schäfer (philipp.matthias.schaefer@posteo.de), 2020
+#
+# This file is part of the KrautStatus' Arduino code.
+#
+# The Clean CommonMark library is free software: you can redistribute it and/or
+# modify it under the terms of the GNU Affero General Public License as
+# published by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# The Clean CommonMark library is distributed in the hope that it will be
+# useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero
+# General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with the Clean CommonMark library. If not, see
+# <https://www.gnu.org/licenses/>.
 """
 Test KrautStatus's UDP API for a given IP and (optionally) port.
 """