From 6c1ac6b18645395208b5a7fe81ef0d796ef78e3d Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 1 Mar 2013 14:59:41 -0400
Subject: [PATCH 001/296] First pass at WiFi shield support

---
 bin/dino                        | 51 ++++++++++++++------
 src/du_ethernet/du_ethernet.ino | 26 ++++++----
 src/du_wifi/du_wifi.ino         | 84 +++++++++++++++++++++++++++++++++
 3 files changed, 137 insertions(+), 24 deletions(-)
 create mode 100644 src/du_wifi/du_wifi.ino

diff --git a/bin/dino b/bin/dino
index 8b2ed790..7e04bd60 100755
--- a/bin/dino
+++ b/bin/dino
@@ -2,6 +2,10 @@
 require "pathname"
 require "fileutils"
 
+SERIAL   = "du"
+ETHERNET = "du_ethernet"
+WIFI     = "du_wifi"
+
 $options = {}
 $options[:sketch_names] = []
 
@@ -16,37 +20,50 @@ def usage
   $stderr.puts "Commands:"
   $stderr.puts "  generate-sketch SKETCH [options]"
   $stderr.puts
-  $stderr.puts "    Sketches:"
+  $stderr.puts "    Available sketches and options:"
+  $stderr.puts
   $stderr.puts "      serial"
+  $stderr.puts "        --baud BAUD"
+  $stderr.puts "        --debug"
+  $stderr.puts
   $stderr.puts "      ethernet"
+  $stderr.puts "        --mac XX:XX:XX:XX:XX:XX"
+  $stderr.puts "        --ip XXX.XXX.XXX.XXX"
+  $stderr.puts "        --port PORT"
+  $stderr.puts "        --debug"
   $stderr.puts
-  $stderr.puts "    Options:"
-  $stderr.puts "      --baud BAUD"
-  $stderr.puts "      --mac XX:XX:XX:XX:XX:XX"
-  $stderr.puts "      --ip XXX.XXX.XXX.XXX"
-  $stderr.puts "      --port PORT"
-  $stderr.puts "      --debug"
+  $stderr.puts "      wifi"
+  $stderr.puts "        --ssid SSID"
+  $stderr.puts "        --password PASSWORD"
+  $stderr.puts "        --port PORT"
+  $stderr.puts "        --debug"
   $stderr.puts
   exit(2)
 end
 
 # Command must be the first argument.
 $options[:command] = ARGV.shift
-usage if $options[:command].match /help/
+usage if $options[:command].match /help|usage/ 
 
 # Parse the rest loosely.
 loop do
   case ARGV[0]
     when 'serial'
-      ARGV.shift; $options[:sketch_names] << "du" unless $options[:sketch_names].include? "du"
+      ARGV.shift; $options[:sketch_names] << SERIAL unless $options[:sketch_names].include? SERIAL
     when 'ethernet'
-      ARGV.shift; $options[:sketch_names] << "du_ethernet" unless $options[:sketch_names].include? "du_ethernet"
+      ARGV.shift; $options[:sketch_names] << ETHERNET unless $options[:sketch_names].include? ETHERNET
+    when 'wifi'
+      ARGV.shift; $options[:sketch_names] << WIFI unless $options[:sketch_names].include? WIFI
     when '--baud'
       ARGV.shift; $options[:baud] = ARGV.shift
-   when '--mac'
+    when '--mac'
       ARGV.shift; $options[:mac] = ARGV.shift
     when '--ip'
       ARGV.shift; $options[:ip] = ARGV.shift
+    when '--ssid'
+      ARGV.shift; $options[:ssid] = ARGV.shift
+    when '--password'
+      ARGV.shift; $options[:password] = ARGV.shift
     when '--port'
       ARGV.shift; $options[:port] = ARGV.shift
     when '--debug'
@@ -75,17 +92,23 @@ $options[:sketch_names].each do |sketch_name|
   sketch = File.read(src_sketch)
 
   # Modify them based on the arguments.
-  if $options[:baud]
+  if $options[:baud] && sketch_name == SERIAL
     sketch.gsub! "115200", $options[:baud]
   end
-  if $options[:mac]
+  if $options[:mac] && sketch_name == ETHERNET
     octets = $options[:mac].split(':')
     bytes = octets.map { |o| "0x#{o.upcase}" }
     sketch.gsub! "{ 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 }", bytes.inspect.gsub("[", "{").gsub("]", "}").gsub("\"", "")
   end
-  if $options[:ip]
+  if $options[:ip] && sketch_name == ETHERNET
     sketch.gsub! "192,168,0,77", $options[:ip].gsub(".", ",")
   end
+  if $options[:ssid] && sketch_name == WIFI
+    sketch.gsub! "yourNetwork", $options[:ssid]
+  end
+  if $options[:password] && sketch_name == WIFI
+    sketch.gsub! "yourPassword", $options[:password]
+  end
   if $options[:port]
     sketch.gsub! "int port = 3466", "int port = #{$options[:port]}"
   end
diff --git a/src/du_ethernet/du_ethernet.ino b/src/du_ethernet/du_ethernet.ino
index fac9ba82..072c2556 100644
--- a/src/du_ethernet/du_ethernet.ino
+++ b/src/du_ethernet/du_ethernet.ino
@@ -13,7 +13,8 @@ EthernetClient client;
 char responseBuffer[65];
 
 
-// Dino.h doesn't handle TXRX. Setup a callback to receive the responses and buffer them.
+// Dino.h doesn't handle TXRX.
+// Setup a callback to buffer responses for writing.
 void bufferResponse(char *response) {
    if (strlen(responseBuffer) > 56 ) {
      writeResponses();
@@ -32,23 +33,28 @@ void writeResponses() {
     responseBuffer[0] = '\0';
 }
 
+void printEthernetStatus() {
+  // Print ethernet status.
+  Serial.print("IP Address: ");
+  Serial.println(Ethernet.localIP());
+  Serial.print("Port: ");
+  Serial.println(port);
+}
+
 
 void setup() {
+  // Start serial for debugging.
+  Serial.begin(9600);
+
   // Explicitly disable the SD card.
   pinMode(4,OUTPUT);
   digitalWrite(4,HIGH);
-  
+
   // Start up the network connection and server.
   Ethernet.begin(mac, ip);
   server.begin();
-    
-  // Start serial for debugging.
-  Serial.begin(9600);
-  Serial.print("Dino::TCP started at ");
-  Serial.print(Ethernet.localIP());
-  Serial.print(" on port ");
-  Serial.println(port);
-  
+  printEthernetStatus();
+
   // Attach the write callback.
   dino.setupWrite(writeCallback);
 }
diff --git a/src/du_wifi/du_wifi.ino b/src/du_wifi/du_wifi.ino
new file mode 100644
index 00000000..706b5ff2
--- /dev/null
+++ b/src/du_wifi/du_wifi.ino
@@ -0,0 +1,84 @@
+#include "Dino.h"
+#include <SPI.h>
+#include <WiFi.h>
+
+// Configure your WiFi options here. MAC address and IP address are not configurable.
+int port = 3466;
+char ssid [] = "yourNetwork";
+char pass [] = "yourPassword";
+int keyIndex = 0;
+int status = WL_IDLE_STATUS;
+
+Dino dino;
+WiFiServer server(port);
+WiFiClient client;
+char responseBuffer[65];
+
+
+// Dino.h doesn't handle TXRX.
+// Setup a callback to buffer responses for writing.
+void bufferResponse(char *response) {
+   if (strlen(responseBuffer) > 56 ) {
+     writeResponses();
+     strcpy(responseBuffer, response);
+   } else {
+     strcat(responseBuffer, response);
+   }
+   strcat(responseBuffer, "\n");
+}
+void (*writeCallback)(char *str) = bufferResponse;
+
+// Write the buffered responses to the client.
+void writeResponses() {
+  if (responseBuffer[0] != '\0')
+    client.write(responseBuffer);
+    responseBuffer[0] = '\0';
+}
+
+void printWifiStatus() {
+  Serial.print("SSID: ");
+  Serial.println(WiFi.SSID());
+  Serial.print("Signal Strength (RSSI):");
+  Serial.print(WiFi.RSSI());
+  Serial.println(" dBm");
+  Serial.print("IP Address: ");
+  Serial.println(WiFi.localIP());
+  Serial.print("Port: ");
+  Serial.println(port);
+}
+
+
+void setup() {
+  // Start serial for debugging.
+  Serial.begin(9600);
+
+  // Try to connect to the specified network.
+  while ( status != WL_CONNECTED) { 
+    Serial.print("Attempting to connect to SSID: ");
+    Serial.println(ssid);
+    status = WiFi.begin(ssid, pass);
+    delay(10000);
+  } 
+  
+  // Start the server.
+  server.begin();
+  printWifiStatus();
+
+  // Attach the write callback.
+  dino.setupWrite(writeCallback);
+}
+
+void loop() {
+  // Listen for connections.
+  client = server.available();
+  
+  // Handle a connection.
+  if (client) {
+    while (client.connected()) {
+      while (client.available()) dino.parse(client.read());
+      dino.updateListeners();
+      writeResponses();
+    }
+  }
+  client.stop();
+}

From 7f5fa3c5ee338ce7b354b5ae951ac5c3a376c946 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 26 Mar 2013 02:12:46 -0400
Subject: [PATCH 002/296] Parse arbitrary length messages sent to the Arduino.

---
 lib/dino/board.rb      | 13 +++++------
 lib/dino/tx_rx/base.rb |  2 +-
 spec/lib/board_spec.rb | 40 ++++++++++++++-------------------
 src/lib/Dino.cpp       | 51 +++++++++++++++++++++++++++++++++---------
 src/lib/Dino.h         | 26 +++++++++++----------
 5 files changed, 78 insertions(+), 54 deletions(-)

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index ad72eece..d04c33ee 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -17,12 +17,12 @@ def analog_divider=(value)
       unless [1, 2, 4, 8, 16, 32, 64, 128].include? value
         puts "Analog divider must be in 1, 2, 4, 8, 16, 32, 64, 128"
       else
-        write "9700#{normalize_value(value)}"
+        write "97.0.#{normalize_value(value)}"
       end
     end
 
     def heart_rate=(value)
-      write "9800#{normalize_value(value)}"
+      write "98.0.#{normalize_value(value)}"
     end
 
     def start_read
@@ -33,9 +33,8 @@ def stop_read
       @io.close_read
     end
 
-    def write(msg, opts = {})
-      formatted_msg = opts.delete(:no_wrap) ? msg : "!#{msg}."
-      @io.write(formatted_msg)
+    def write(msg)
+      @io.write("#{msg}\n")
     end
 
     def update(pin, msg)
@@ -68,7 +67,7 @@ def remove_analog_hardware(part)
 
     def set_pin_mode(pin, mode, pullup=nil)
       pin, value = normalize_pin(pin), normalize_value(mode == :out ? 0 : 1)
-      write("00#{pin}#{value}")
+      write("00.#{pin}.#{value}")
       set_pullup(pin, pullup) if mode == :in
     end
 
@@ -91,7 +90,7 @@ def set_pullup(pin, pullup)
     PIN_COMMANDS.each_key do |command|
       define_method(command) do |pin, value=nil|
         cmd = normalize_cmd(PIN_COMMANDS[command])
-        write "#{cmd}#{normalize_pin(pin)}#{normalize_value(value)}"
+        write "#{cmd}.#{normalize_pin(pin)}.#{normalize_value(value)}"
       end
     end
 
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 1e2def91..f43119d5 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -37,7 +37,7 @@ def handshake
         flush_read
         100.times do
           begin
-            write("!9000000.")
+            write("90.00.000\n")
             Timeout::timeout(0.1) do
               line = gets.to_s
               if line.match /ACK:/
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 8f954a6a..bbc79e27 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -83,9 +83,9 @@ def io_mock(methods = {})
 
       it 'should set the mode for the given pin to "in" and add a digital listener' do
         subject
-        subject.should_receive(:write).with("0012001")
-        subject.should_receive(:write).with("0112000")
-        subject.should_receive(:write).with("0512000")
+        subject.should_receive(:write).with("00.12.001")
+        subject.should_receive(:write).with("01.12.000")
+        subject.should_receive(:write).with("05.12.000")
         subject.add_digital_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
       end
     end
@@ -108,9 +108,9 @@ def io_mock(methods = {})
 
       it 'should set the mode for the given pin to "in" and add an analog listener' do
         subject
-        subject.should_receive(:write).with("0012001")
-        subject.should_receive(:write).with("0112000")
-        subject.should_receive(:write).with("0612000")
+        subject.should_receive(:write).with("00.12.001")
+        subject.should_receive(:write).with("01.12.000")
+        subject.should_receive(:write).with("06.12.000")
         subject.add_analog_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
       end
     end
@@ -145,75 +145,69 @@ def io_mock(methods = {})
         board.write('message').should == true
       end
 
-      it 'should wrap the message in a ! and a . by default' do
-        io_mock.should_receive(:write).with('!hello.')
+      it 'should append a new line to hte message' do
+        io_mock.should_receive(:write).with("hello\n")
         subject.write('hello')
       end
-
-      it 'should not wrap the message if no_wrap is set to true' do
-        board = Board.new(io_mock)
-        io_mock.should_receive(:write).with('hello')
-        board.write('hello', no_wrap: true)
-      end
     end
 
     describe '#digital_write' do
       it 'should append a append a write to the pin and value' do
-        io_mock.should_receive(:write).with('!0101003.')
+        io_mock.should_receive(:write).with("01.01.003\n")
         subject.digital_write(01, 003)
       end
     end
 
     describe '#digital_read' do
       it 'should tell the board to read once from the given pin' do
-        io_mock.should_receive(:write).with('!0213000.')
+        io_mock.should_receive(:write).with("02.13.000\n")
         subject.digital_read(13)
       end
     end
 
     describe '#analog_write' do
       it 'should append a append a write to the pin and value' do
-        io_mock.should_receive(:write).with('!0301003.')
+        io_mock.should_receive(:write).with("03.01.003\n")
         subject.analog_write(01, 003)
       end
     end
 
     describe '#analog_read' do
       it 'should tell the board to read once from the given pin' do
-        io_mock.should_receive(:write).with('!0413000.')
+        io_mock.should_receive(:write).with("04.13.000\n")
         subject.analog_read(13)
       end
     end
 
     describe '#digital_listen' do
       it 'should tell the board to continuously read from the given pin' do
-        io_mock.should_receive(:write).with('!0513000.')
+        io_mock.should_receive(:write).with("05.13.000\n")
         subject.digital_listen(13)
       end
     end
 
     describe '#analog_listen' do
       it 'should tell the board to continuously read from the given pin' do
-        io_mock.should_receive(:write).with('!0613000.')
+        io_mock.should_receive(:write).with("06.13.000\n")
         subject.analog_listen(13)
       end
     end
 
     describe '#stop_listener' do
       it 'should tell the board to stop sending values for the given pin' do
-        io_mock.should_receive(:write).with('!0713000.')
+        io_mock.should_receive(:write).with("07.13.000\n")
         subject.stop_listener(13)
       end
     end
 
     describe '#set_pin_mode' do
       it 'should send a value of 0 if the pin mode is set to out' do
-        io_mock.should_receive(:write).with('!0013000.')
+        io_mock.should_receive(:write).with("00.13.000\n")
         subject.set_pin_mode(13, :out)
       end
 
       it 'should send a value of 1 if the pin mode is set to in' do
-        io_mock.should_receive(:write).with('!0013001.')
+        io_mock.should_receive(:write).with("00.13.001\n")
         subject.set_pin_mode(13, :in)
       end
     end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 5c439f9c..7b786210 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -6,28 +6,56 @@
 #include "Dino.h"
 
 Dino::Dino(){
+  messageFragments[0] = cmdStr;
+  messageFragments[1] = pinStr;
+  messageFragments[2] = valStr;
+  messageFragments[3] = auxMsg;
   reset();
 }
 
 void Dino::parse(char c) {
-  if (c == '!') index = 0;        // Reset request
-  else if (c == '.') process();   // End request and process
-  else request[index++] = c;      // Append to request
+  // Handle escaped newlines.
+  if (backslash) {
+    if (c != '\n') append('\\');
+    append(c);
+    backslash = false;
+  }
+
+  // If EOL process and reset.
+  else if (c == '\n') {
+    append('\0');
+    process();
+    fragmentIndex = 0;
+    charIndex = 0;
+  }
+
+  // If fragment delimiter, terminate current fragment and move to next.
+  else if (c == '.') {
+    append('\0');
+    if (fragmentIndex < 3) fragmentIndex++;
+    charIndex = 0;
+  }
+
+  // Catch backslash so we can escape the next character.
+  else if (c == '\\') backslash = true;
+
+  // Else just append the character.
+  else append(c);
 }
 
-void Dino::process() {
-  response[0] = '\0';
 
-  // Parse the request.
-  strncpy(cmdStr, request, 2);      cmdStr[2] =  '\0';
-  strncpy(pinStr, request + 2, 2);  pinStr[2] =  '\0';
-  strncpy(valStr, request + 4, 3);  valStr[3] =  '\0';
+void Dino::append(char c) {
+  messageFragments[fragmentIndex][charIndex++] = c;
+}
+
+void Dino::process() {
   cmd = atoi(cmdStr);
   pin = atoi(pinStr);
   val = atoi(valStr);
+  response[0] = '\0';
 
   #ifdef debug
-   Serial.print("Received request - "); Serial.println(request);
+   // Serial.print("Received request - "); Serial.println(request);
    Serial.print("Command - ");          Serial.println(cmdStr);
    Serial.print("Pin - ");              Serial.println(pinStr);
    Serial.print("Value - ");            Serial.println(valStr);
@@ -229,7 +257,8 @@ void Dino::reset() {
   for (int i = 0; i < 22; i++) digitalListenerValues[i] = 2;
   for (int i = 0; i < 22; i++)  analogListeners[i] = false;
   lastUpdate = micros();
-  index = 0;
+  fragmentIndex = 0;
+  charIndex = 0;
   #ifdef debug
     Serial.println("Reset the board to defaults.  pin ");
   #endif
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index b05aeffc..e53d2184 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -33,24 +33,25 @@ class Dino {
     unsigned int loopCount;
     unsigned int analogDivider;
     
-    // Storage for enough analog and digital listeners for UNO or Nano board.
-    // Correspond to raw pin number by array index, and store boolean. false == disabled.
+    // Listeners correspond to raw pin number by array index, and store boolean. false == disabled.
     boolean analogListeners[PIN_COUNT];
     boolean digitalListeners[PIN_COUNT];
     
     // Keep track of the last read values for digital listeners. Only write responses when changed.
     byte digitalListenerValues[PIN_COUNT];
+
+    // Parsed message storage.
+    char cmdStr[5]; int cmd;
+    char pinStr[5]; int pin;
+    char valStr[5]; int val;
+    char auxMsg[256];
     
-    // Request storage.
-    char request[8];
-    int index;
-    char cmdStr[3];
-    byte cmd;
-    char pinStr[3];
-    byte pin;
-    char valStr[4];
-    int val;
-    
+    // Parser state storage.
+    char *messageFragments[4];
+    byte fragmentIndex;
+    int charIndex;
+    boolean backslash;
+
     // Value and response storage.
     int rval;
     char response[8];
@@ -75,6 +76,7 @@ class Dino {
     void setHeartRate          ();
 
     // Internal functions.
+    void append                 (char c);
     long timeSince              (long event);
     void updateDigitalListeners ();
     void updateAnalogListeners  ();

From 79197d0a9b9a748aa0d29e28c012833799ea1ae9 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 26 Mar 2013 02:58:33 -0400
Subject: [PATCH 003/296] Fix a parser error.

---
 src/lib/Dino.cpp | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 7b786210..ec98f9cd 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -30,10 +30,15 @@ void Dino::parse(char c) {
   }
 
   // If fragment delimiter, terminate current fragment and move to next.
+  // Unless we're in the extended message, then just append.
   else if (c == '.') {
-    append('\0');
-    if (fragmentIndex < 3) fragmentIndex++;
-    charIndex = 0;
+    if (fragmentIndex < 3) {
+      append('\0');
+      fragmentIndex++;
+      charIndex = 0;
+    } else {
+      append(c);
+    }
   }
 
   // Catch backslash so we can escape the next character.
@@ -43,7 +48,6 @@ void Dino::parse(char c) {
   else append(c);
 }
 
-
 void Dino::append(char c) {
   messageFragments[fragmentIndex][charIndex++] = c;
 }
@@ -55,7 +59,6 @@ void Dino::process() {
   response[0] = '\0';
 
   #ifdef debug
-   // Serial.print("Received request - "); Serial.println(request);
    Serial.print("Command - ");          Serial.println(cmdStr);
    Serial.print("Pin - ");              Serial.println(pinStr);
    Serial.print("Value - ");            Serial.println(valStr);

From b4c02b8123652cb4be589bbdf7ff5f7a44e2712e Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 26 Mar 2013 14:45:58 -0400
Subject: [PATCH 004/296] Add Message class

---
 examples/bench.rb        | 110 +++++++++++++++++++++++++++++++++++++++
 examples/benchmark.rb    |  69 ++++++++++++++++++++++++
 examples/load.rb         |  93 +++++++++++++++++++++++++++++++++
 lib/dino.rb              |   1 +
 lib/dino/board.rb        |  69 +++++++++---------------
 lib/dino/message.rb      |  32 ++++++++++++
 lib/dino/tx_rx/base.rb   |   2 +-
 spec/lib/board_spec.rb   |  91 ++++++++++++++++----------------
 spec/lib/message_spec.rb |  38 ++++++++++++++
 9 files changed, 412 insertions(+), 93 deletions(-)
 create mode 100644 examples/bench.rb
 create mode 100644 examples/benchmark.rb
 create mode 100644 examples/load.rb
 create mode 100644 lib/dino/message.rb
 create mode 100644 spec/lib/message_spec.rb

diff --git a/examples/bench.rb b/examples/bench.rb
new file mode 100644
index 00000000..14cf0d93
--- /dev/null
+++ b/examples/bench.rb
@@ -0,0 +1,110 @@
+#
+# This is a simple example to blink an led
+# every half a second
+#
+
+require File.expand_path('../../lib/dino', __FILE__)
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+
+# Keep a led blinking.
+led = Dino::Components::Led.new(pin: '13', board: board)
+led_thread = Thread.new do
+  [:on, :off].cycle do |switch|
+    led.send(switch)
+    sleep 0.5
+  end
+end
+
+# Keep a servo moving.
+servo = Dino::Components::Servo.new(pin: 9, board: board)
+servo_thread = Thread.new do
+  [0, 90].cycle do |pos|
+    servo.position = pos
+    sleep 0.3
+  end
+end
+
+# Keep a servo moving.
+servo2 = Dino::Components::Servo.new(pin: 10, board: board)
+servo_thread2 = Thread.new do
+  [0, 90].cycle do |pos|
+    servo2.position = pos
+    sleep 0.5
+  end
+end
+
+# Keep a servo moving.
+servo3 = Dino::Components::Servo.new(pin: 11, board: board)
+servo_thread3 = Thread.new do
+  [0, 90].cycle do |pos|
+    servo3.position = pos
+    sleep 0.5
+  end
+end
+
+
+
+$counter_analog = 0
+counter_digital = 0
+test_time = 5
+
+puts "Starting tests..."
+
+# Ranges of digital and analog pin numbers to read.
+digital_range = 2..5
+analog_range = 0..5
+
+digital_range.each do |digital_max|
+  analog_range.each do |analog_max|
+
+    # Define ranges for this test test.
+    digital_test_range = digital_range.min..digital_max
+    analog_test_range = analog_range.min..analog_max
+
+    # Setup hardware
+    analog_test_range.each do |pin|
+      eval "$sensor#{pin} = Dino::Components::Sensor.new(pin: 'A#{pin}', board: board)"
+      eval "$sensor#{pin}.when_data_received { $counter_analog = $counter_analog + 1 }"
+    end
+    digital_test_range.each do |pin|
+      eval "$digital#{pin} = Dino::Components::Button.new(pin: '#{pin}', board: board, pullup: true)"
+      eval "$digital#{pin}.up   { counter_digital = counter_digital + 1 }"
+      eval "$digital#{pin}.down { counter_digital = counter_digital + 1 }"
+    end
+
+    # Pre-test measurement
+    state1_digital = counter_digital
+    state1_analog = $counter_analog
+
+    # Wait
+    sleep test_time
+
+    # Post-test measurement
+    state2_digital = counter_digital
+    state2_analog = $counter_analog
+
+    # Calculation
+    diff_digital = state2_digital - state1_digital
+    diff_analog = state2_analog - state1_analog
+
+    # Print
+    print "#{digital_test_range.count}D/#{analog_test_range.count}A Components: "
+    print "#{diff_digital/(test_time * digital_test_range.count)}Hz"
+    print "/"
+    print "#{diff_analog/(test_time * analog_test_range.count)}Hz per component | "
+    puts  "#{(diff_digital + diff_analog)/(test_time)} responses/s overall"
+
+    # Remove hardware
+    analog_test_range.each do |pin|
+      board.remove_analog_hardware(eval "$sensor#{pin}")
+    end
+    digital_test_range.each do |pin|
+      board.remove_digital_hardware(eval "$digital#{pin}")
+    end
+  end
+end
+
+servo_thread.kill
+led_thread.kill
+
diff --git a/examples/benchmark.rb b/examples/benchmark.rb
new file mode 100644
index 00000000..fb6e7313
--- /dev/null
+++ b/examples/benchmark.rb
@@ -0,0 +1,69 @@
+#
+# This is a simple example to blink an led
+# every half a second
+#
+
+require File.expand_path('../../lib/dino', __FILE__)
+txrx = Dino::TxRx.new
+# txrx = Dino::TxRx::TCP.new("192.168.0.77")
+# txrx = Dino::TxRx::TCP.new("192.168.0.143", 3001) # ; txrx.io; sleep 5
+board = Dino::Board.new(txrx)
+
+txrx.write("!9800003.")
+
+# Warm up
+sleep 2
+
+counter_analog = 0
+counter_digital = 0
+count_analog_responses = Proc.new { counter_analog = counter_analog + 1 }
+test_time = 4
+
+puts "Starting tests..."
+
+(5..9).each do |digital_count|
+  (0..5).each do |analog_count|
+
+    # Setup hardware
+    (0..analog_count).each do |pin|
+      eval "$sensor#{pin} = Dino::Components::Sensor.new(pin: 'A#{pin}', board: board)"
+      eval "$sensor#{pin}.when_data_received(count_analog_responses)"
+    end
+    (5..digital_count).each do |pin|
+      eval "$digital#{pin} = Dino::Components::Button.new(pin: '#{pin}', board: board, pullup: true)"
+      eval "$digital#{pin}.up   { counter_digital = counter_digital + 1 }"
+      eval "$digital#{pin}.down { counter_digital = counter_digital + 1 }"
+    end
+    
+    # Pre-test measurement
+    state1_digital = counter_digital
+    state1_analog = counter_analog
+
+    # Wait
+    sleep test_time
+
+    # Post-test measurement
+    state2_digital = counter_digital
+    state2_analog = counter_analog
+
+    # Calculation
+    diff_digital = state2_digital - state1_digital
+    diff_analog = state2_analog - state1_analog
+
+    # Print
+    print "#{digital_count -4}D/#{analog_count + 1}A Components: "
+    print  "#{diff_digital/(test_time * (digital_count - 4))}Hz"
+    print "/"
+    print  "#{diff_analog/(test_time * (analog_count + 1))}Hz per component | "
+    puts  "#{(diff_digital + diff_analog)/(test_time)} responses/s overall"
+
+    # Remove hardware
+    (0..analog_count).each do |pin|
+      board.remove_analog_hardware(eval "$sensor#{pin}")
+    end
+    (5..digital_count).each do |pin|
+      board.remove_digital_hardware(eval "$digital#{pin}")
+    end
+  end
+end
+
diff --git a/examples/load.rb b/examples/load.rb
new file mode 100644
index 00000000..e70cb96e
--- /dev/null
+++ b/examples/load.rb
@@ -0,0 +1,93 @@
+#c
+# This is a simple example to blink an led
+# every half a second
+#
+
+require File.expand_path('../../lib/dino', __FILE__)
+# txrx = Dino::TxRx.new
+# txrx = Dino::TxRx::TCP.new("192.168.0.77")
+# txrx = Dino::TxRx::TCP.new("192.168.0.143", 3001) # ; txrx.io; sleep 5
+# board = Dino::Board.new(txrx)
+
+# txrx.write("!9800010.")
+
+
+
+board = Dino::Board.new(Dino::TxRx::Serial.new) #(device: "/dev/tty.usbserial-A9015AK7"))
+servo = Dino::Components::Servo.new(pin: 9, board: board)
+led = Dino::Components::Led.new(pin: '13', board: board)
+
+# board.heart_rate = 10
+# board.analog_divider = 8
+
+counter_analog = 0
+counter_digital = 0
+test_time = 2
+
+analog_count = 5
+digital_count = 6
+
+# led.pulse(0, 128)
+
+# Setup hardware
+(0..5).each do |pin|
+  eval "$sensor#{pin} = Dino::Components::Sensor.new(pin: 'A#{pin}', board: board)"
+  eval "$sensor#{pin}.when_data_received { counter_analog = counter_analog + 1 }"
+end
+(5..9).each do |pin|
+  eval "$digital#{pin} = Dino::Components::Button.new(pin: '#{pin}', board: board, pullup: true)"
+  eval "$digital#{pin}.up   { counter_digital = counter_digital + 1 }"
+  eval "$digital#{pin}.down { counter_digital = counter_digital + 1 }"
+end
+
+
+
+
+puts "Starting test..."
+start_time = Time.now
+
+loop do
+
+  40.times do
+    led.off
+    led.on
+  end
+
+  # [0, 90].each do |pos|
+  #   servo.position = pos
+  # end
+
+  # Pre-test measurement
+  state1_digital = counter_digital
+  state1_analog = counter_analog
+
+  # Wait
+  sleep test_time
+
+  # Post-test measurement
+  state2_digital = counter_digital
+  state2_analog = counter_analog
+
+  # Calculation
+  diff_digital = state2_digital - state1_digital
+  diff_analog = state2_analog - state1_analog
+
+  # Print
+  print "#{digital_count -1}D/#{analog_count + 1}A Components: "
+  print  "#{diff_digital/(test_time * (digital_count - 1))}Hz"
+  print "/"
+  print  "#{diff_analog/(test_time * (analog_count + 1))}Hz per component | "
+  puts  "#{(diff_digital + diff_analog)/(test_time)} responses/s overall"
+
+  print "Elapsed time: "
+  puts Time.now - start_time
+
+end
+
+# Remove hardware
+(0..5).each do |pin|
+  board.remove_analog_hardware(eval "$sensor#{pin}")
+end
+(5..10).each do |pin|
+  board.remove_digital_hardware(eval "$digital#{pin}")
+end
diff --git a/lib/dino.rb b/lib/dino.rb
index 9172c7c0..c7c3dfb1 100644
--- a/lib/dino.rb
+++ b/lib/dino.rb
@@ -1,5 +1,6 @@
 require 'dino/board_not_found'
 require 'dino/version'
+require 'dino/message'
 require 'dino/tx_rx'
 require 'dino/board'
 require 'dino/components'
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index d04c33ee..150a2cbc 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -2,6 +2,7 @@ module Dino
   class Board
     attr_reader :digital_hardware, :analog_hardware, :analog_zero
     LOW, HIGH = 000, 255
+    DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
     def initialize(io)
       @io, @digital_hardware, @analog_hardware = io, [], []
@@ -14,15 +15,15 @@ def handshake
     end
 
     def analog_divider=(value)
-      unless [1, 2, 4, 8, 16, 32, 64, 128].include? value
-        puts "Analog divider must be in 1, 2, 4, 8, 16, 32, 64, 128"
+      unless DIVIDERS.include? value
+        puts "Analog divider must be in #{DIVIDERS.inspect}"
       else
-        write "97.0.#{normalize_value(value)}"
+        write Dino::Message.encode(command: 97, value: value)
       end
     end
 
     def heart_rate=(value)
-      write "98.0.#{normalize_value(value)}"
+      write Dino::Message.encode(command: 98, value: value)
     end
 
     def start_read
@@ -34,12 +35,12 @@ def stop_read
     end
 
     def write(msg)
-      @io.write("#{msg}\n")
+      @io.write(msg)
     end
 
     def update(pin, msg)
       (@digital_hardware + @analog_hardware).each do |part|
-        part.update(msg) if normalize_pin(pin) == normalize_pin(part.pin)
+        part.update(msg) if convert_pin(pin) == convert_pin(part.pin)
       end
     end
 
@@ -55,7 +56,7 @@ def remove_digital_hardware(part)
     end
 
     def add_analog_hardware(part)
-      set_pin_mode(part.pin, :in)
+      set_pin_mode(part.pin, :in, part.pullup)
       analog_listen(part.pin)
       @analog_hardware << part
     end
@@ -66,58 +67,36 @@ def remove_analog_hardware(part)
     end
 
     def set_pin_mode(pin, mode, pullup=nil)
-      pin, value = normalize_pin(pin), normalize_value(mode == :out ? 0 : 1)
-      write("00.#{pin}.#{value}")
+      pin, value = convert_pin(pin), mode == :out ? 0 : 1
+      write Dino::Message.encode(command: 0, pin: pin, value: value)
       set_pullup(pin, pullup) if mode == :in
     end
 
     def set_pullup(pin, pullup)
+      pin = convert_pin(pin)
       pullup ? digital_write(pin, HIGH) : digital_write(pin, LOW)
     end
-      
+
     PIN_COMMANDS = {
-      digital_write:   '01',
-      digital_read:    '02',
-      analog_write:    '03',
-      analog_read:     '04',
-      digital_listen:  '05',
-      analog_listen:   '06',
-      stop_listener:   '07',
-      servo_toggle:    '08',
-      servo_write:     '09'
+      digital_write:   '1',
+      digital_read:    '2',
+      analog_write:    '3',
+      analog_read:     '4',
+      digital_listen:  '5',
+      analog_listen:   '6',
+      stop_listener:   '7',
+      servo_toggle:    '8',
+      servo_write:     '9'
     }
 
     PIN_COMMANDS.each_key do |command|
       define_method(command) do |pin, value=nil|
-        cmd = normalize_cmd(PIN_COMMANDS[command])
-        write "#{cmd}.#{normalize_pin(pin)}.#{normalize_value(value)}"
-      end
-    end
-
-    def normalize_pin(pin)
-      if pin.to_s.match /\Aa/i
-        int_pin = @analog_zero + pin.to_s.gsub(/\Aa/i, '').to_i
-      else
-        int_pin = pin
+        write Dino::Message.encode(command: PIN_COMMANDS[command], pin: convert_pin(pin), value: value)
       end
-      raise Exception.new('pin number must be in 0-99') if int_pin.to_i > 99
-      return normalize(int_pin, 2)
     end
 
-    def normalize_cmd(cmd)
-      raise Exception.new('commands can only be two digits') if cmd.to_s.length > 2
-      normalize(cmd, 2)
-    end
-
-    def normalize_value(value)
-      raise Exception.new('values are limited to three digits') if value.to_s.length > 3
-      normalize(value, 3)
-    end
-
-    private
-
-    def normalize(pin, spaces)
-      pin.to_s.rjust(spaces, '0')
+    def convert_pin(pin)
+      pin.to_s.match(/\Aa/i) ? @analog_zero + pin.to_s.gsub(/\Aa/i, '').to_i : pin.to_i
     end
   end
 end
\ No newline at end of file
diff --git a/lib/dino/message.rb b/lib/dino/message.rb
new file mode 100644
index 00000000..b1a95ce9
--- /dev/null
+++ b/lib/dino/message.rb
@@ -0,0 +1,32 @@
+module Dino
+  module Message
+    def self.encode(options={})
+      cmd = options[:command]
+      pin = options[:pin]
+      val = options[:value]
+      aux = options[:aux_message]
+
+      raise Exception.new('commands must be specified') unless cmd
+      raise Exception.new('commands can only be four digits') if cmd.to_s.length > 4
+      raise Exception.new('pins can only be four digits') if pin.to_s.length > 4
+      raise Exception.new('values can only be four digits') if val.to_s.length > 4
+      raise Exception.new('auxillary messages are limited to 255 characters') if aux.to_s.length > 255
+
+      message = "#{cmd}"
+      if pin
+        message << ".#{pin}"
+      end
+      if val
+        message << "." unless pin
+        message << ".#{val}"
+      end
+      if aux
+        message << "." unless pin
+        message << "." unless val
+        message << ".#{aux}"
+      end
+      message << "\n"
+      message
+    end
+  end
+end
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index f43119d5..6f9ab0c7 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -37,7 +37,7 @@ def handshake
         flush_read
         100.times do
           begin
-            write("90.00.000\n")
+            write Dino::Message.encode(command: 90)
             Timeout::timeout(0.1) do
               line = gets.to_s
               if line.match /ACK:/
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index bbc79e27..923977a4 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -29,9 +29,9 @@ def io_mock(methods = {})
     describe '#update' do
       context 'when the given pin connects to an analog hardware part' do
         it 'should call update with the message on the part' do
-          part = mock(:part, pin: 7)
+          part = mock(:part, pin: 7, pullup: nil)
           subject.add_analog_hardware(part)
-          other_part = mock(:part, pin: 9)
+          other_part = mock(:part, pin: 9, pullup: nil)
           subject.add_analog_hardware(other_part)
 
           part.should_receive(:update).with('wake up!')
@@ -82,11 +82,9 @@ def io_mock(methods = {})
       end
 
       it 'should set the mode for the given pin to "in" and add a digital listener' do
-        subject
-        subject.should_receive(:write).with("00.12.001")
-        subject.should_receive(:write).with("01.12.000")
-        subject.should_receive(:write).with("05.12.000")
-        subject.add_digital_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
+        subject.should_receive(:set_pin_mode).with(12, :in, nil)
+        subject.should_receive(:digital_listen).with(12)
+        subject.add_digital_hardware(mock(:part1, pin: 12, pullup: nil))
       end
     end
 
@@ -107,10 +105,8 @@ def io_mock(methods = {})
       end
 
       it 'should set the mode for the given pin to "in" and add an analog listener' do
-        subject
-        subject.should_receive(:write).with("00.12.001")
-        subject.should_receive(:write).with("01.12.000")
-        subject.should_receive(:write).with("06.12.000")
+        subject.should_receive(:set_pin_mode).with(12, :in, nil)
+        subject.should_receive(:analog_listen).with(12)
         subject.add_analog_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
       end
     end
@@ -144,106 +140,107 @@ def io_mock(methods = {})
         board = Board.new(io_mock(write: true))
         board.write('message').should == true
       end
-
-      it 'should append a new line to hte message' do
-        io_mock.should_receive(:write).with("hello\n")
-        subject.write('hello')
-      end
     end
 
     describe '#digital_write' do
-      it 'should append a append a write to the pin and value' do
-        io_mock.should_receive(:write).with("01.01.003\n")
+      it 'should write the value to the right pin' do
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 1, value: 3))
         subject.digital_write(01, 003)
       end
     end
 
     describe '#digital_read' do
       it 'should tell the board to read once from the given pin' do
-        io_mock.should_receive(:write).with("02.13.000\n")
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 2, pin: 13))
         subject.digital_read(13)
       end
     end
 
     describe '#analog_write' do
       it 'should append a append a write to the pin and value' do
-        io_mock.should_receive(:write).with("03.01.003\n")
-        subject.analog_write(01, 003)
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 3, pin: 1, value: 3))
+        subject.analog_write(01, 3)
       end
     end
 
     describe '#analog_read' do
       it 'should tell the board to read once from the given pin' do
-        io_mock.should_receive(:write).with("04.13.000\n")
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 4, pin: 13))
         subject.analog_read(13)
       end
     end
 
     describe '#digital_listen' do
       it 'should tell the board to continuously read from the given pin' do
-        io_mock.should_receive(:write).with("05.13.000\n")
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 5, pin: 13))
         subject.digital_listen(13)
       end
     end
 
     describe '#analog_listen' do
       it 'should tell the board to continuously read from the given pin' do
-        io_mock.should_receive(:write).with("06.13.000\n")
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 6, pin: 13))
         subject.analog_listen(13)
       end
     end
 
     describe '#stop_listener' do
       it 'should tell the board to stop sending values for the given pin' do
-        io_mock.should_receive(:write).with("07.13.000\n")
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 7, pin: 13))
         subject.stop_listener(13)
       end
     end
 
     describe '#set_pin_mode' do
       it 'should send a value of 0 if the pin mode is set to out' do
-        io_mock.should_receive(:write).with("00.13.000\n")
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 0))
         subject.set_pin_mode(13, :out)
       end
 
       it 'should send a value of 1 if the pin mode is set to in' do
-        io_mock.should_receive(:write).with("00.13.001\n")
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 1))
         subject.set_pin_mode(13, :in)
       end
-    end
 
-    describe '#handshake' do
-      it 'should tell the board to reset to defaults' do
-        io_mock.should_receive(:handshake)
-        subject.handshake
+      it 'should set the pullup correctly if mode is in' do
+        subject.should_receive(:set_pullup).with(13, nil)
+        subject.set_pin_mode(13, :in)
       end
-    end
 
-    describe '#normalize_pin' do
-      it 'should normalize numbers so they are two digits' do
-        subject.normalize_pin(1).should == '01'
+      it 'shouldnt affect the pullup if mode is out' do
+        subject.should_not_receive(:set_pullup).with(13, nil)
+        subject.set_pin_mode(13, :out)
       end
+    end
 
-      it 'should not normalize numbers that are already two digits' do
-        subject.normalize_pin(10).should == '10'
+    describe '#set_pullup' do
+      it 'should write high if pullup is enabled' do
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: Board::HIGH))
+        subject.set_pullup(13, true)
       end
 
-      it 'should raise if a number larger than two digits are given' do
-        expect { subject.normalize_pin(1000) }.to raise_exception 'pin number must be in 0-99'
+      it 'should write low if pullup is disabled' do
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: Board::LOW))
+        subject.set_pullup(13, false)
       end
     end
 
-    describe '#normalize_value' do
-      it 'should normalize numbers so they are three digits' do
-        subject.normalize_value(1).should == '001'
+    describe '#handshake' do
+      it 'should tell the board to reset to defaults' do
+        io_mock.should_receive(:handshake)
+        subject.handshake
       end
+    end
+
+    describe '#convert_pin' do
+      before(:each) { subject.instance_variable_set(:@analog_zero, 14) }
 
-      it 'should not normalize numbers that are already three digits' do
-        subject.normalize_value(10).should == '010'
+      it 'should convert alphanumeric pins to numbers' do
+        subject.convert_pin('A1').should == 15
       end
 
-      it 'should raise if a number larger than three digits are given' do
-        expect { subject.normalize_value(1000) }.to raise_exception 'values are limited to three digits'
+      it 'should leave numeric pins alone' do
+        subject.convert_pin('13').should == 13
       end
     end
   end
diff --git a/spec/lib/message_spec.rb b/spec/lib/message_spec.rb
new file mode 100644
index 00000000..aedf7e51
--- /dev/null
+++ b/spec/lib/message_spec.rb
@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+module Dino
+  describe Dino::Message do
+    describe '.encode' do
+
+      it 'should require a command' do
+        expect { Dino::Message.encode }.to raise_exception(/command/)
+        expect { Dino::Message.encode(command:90) }.to_not raise_exception
+      end
+
+      it 'should not allow commands longer than 4 digits' do
+        expect { Dino::Message.encode(command:90000) }.to raise_exception(/four/)
+      end
+
+      it 'should not allow pins longer than 4 digits' do
+        expect { Dino::Message.encode(command:90, pin:90000) }.to raise_exception(/four/)
+      end
+
+      it 'should not allow values longer than 4 digits' do
+        expect { Dino::Message.encode(command:90, value:90000) }.to raise_exception(/four/)
+      end
+
+      it 'should not allow values longer than 4 digits' do
+        expect { Dino::Message.encode(command:90, aux_message: "0" * 256) }.to raise_exception(/255/)
+      end
+
+      it 'should build messages correctly' do
+        Dino::Message.encode(command: 1, pin: 1, value: 1).should == "1.1.1\n"
+        Dino::Message.encode(command: 1, pin: 1).should == "1.1\n"
+        Dino::Message.encode(command: 1, value: 1).should == "1..1\n"
+        Dino::Message.encode(command: 1).should == "1\n"
+        Dino::Message.encode(command: 1, pin: 1, value: 1, aux_message: "Some Text").should == "1.1.1.Some Text\n"
+        Dino::Message.encode(command: 1, aux_message: "Some Text").should == "1...Some Text\n"
+      end
+    end
+  end
+end

From 7791be51b5b51669fcf3a3012cf234159b31732d Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 26 Mar 2013 14:53:42 -0400
Subject: [PATCH 005/296] Properly escape newlines in aux messages

---
 lib/dino/message.rb      | 1 +
 spec/lib/message_spec.rb | 4 ++++
 2 files changed, 5 insertions(+)

diff --git a/lib/dino/message.rb b/lib/dino/message.rb
index b1a95ce9..5fb272b3 100644
--- a/lib/dino/message.rb
+++ b/lib/dino/message.rb
@@ -5,6 +5,7 @@ def self.encode(options={})
       pin = options[:pin]
       val = options[:value]
       aux = options[:aux_message]
+      aux.gsub!("\n", "\\\n") if aux
 
       raise Exception.new('commands must be specified') unless cmd
       raise Exception.new('commands can only be four digits') if cmd.to_s.length > 4
diff --git a/spec/lib/message_spec.rb b/spec/lib/message_spec.rb
index aedf7e51..93521fc2 100644
--- a/spec/lib/message_spec.rb
+++ b/spec/lib/message_spec.rb
@@ -33,6 +33,10 @@ module Dino
         Dino::Message.encode(command: 1, pin: 1, value: 1, aux_message: "Some Text").should == "1.1.1.Some Text\n"
         Dino::Message.encode(command: 1, aux_message: "Some Text").should == "1...Some Text\n"
       end
+
+      it 'should insert a backslash before any newline inside the aux message' do
+        Dino::Message.encode(command: 1, aux_message: "line1\nline2").should == "1...line1\\\nline2\n"
+      end
     end
   end
 end

From f13ca051d644943b2ff9848edffb10aa11a6c8e0 Mon Sep 17 00:00:00 2001
From: Nathan Lilienthal <nathanlil13@me.com>
Date: Wed, 27 Mar 2013 11:42:33 -0400
Subject: [PATCH 006/296] rake and rspec should be defined in the gemspec, not
 Gemfile

---
 Gemfile      | 2 --
 dino.gemspec | 4 ++++
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/Gemfile b/Gemfile
index c5932198..50ec6f58 100644
--- a/Gemfile
+++ b/Gemfile
@@ -2,5 +2,3 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in dino.gemspec
 gemspec
-
-gem 'rspec'
diff --git a/dino.gemspec b/dino.gemspec
index 1d6cc65e..1be2b618 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -17,4 +17,8 @@ Gem::Specification.new do |gem|
   gem.executables   = ["dino"]
 
   gem.add_dependency 'serialport'
+  gem.add_dependency 'trollop'
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec'
 end

From cb2b600f4bb4fe8d0c91c474020a968695bdd037 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 29 Mar 2013 17:30:14 -0400
Subject: [PATCH 007/296] Better message construction

---
 lib/dino/message.rb      | 21 ++++++++-------------
 spec/lib/message_spec.rb |  1 +
 2 files changed, 9 insertions(+), 13 deletions(-)

diff --git a/lib/dino/message.rb b/lib/dino/message.rb
index 5fb272b3..d60c4b8a 100644
--- a/lib/dino/message.rb
+++ b/lib/dino/message.rb
@@ -13,21 +13,16 @@ def self.encode(options={})
       raise Exception.new('values can only be four digits') if val.to_s.length > 4
       raise Exception.new('auxillary messages are limited to 255 characters') if aux.to_s.length > 255
 
-      message = "#{cmd}"
-      if pin
-        message << ".#{pin}"
-      end
-      if val
-        message << "." unless pin
-        message << ".#{val}"
-      end
-      if aux
-        message << "." unless pin
-        message << "." unless val
-        message << ".#{aux}"
+      message = ""
+      [aux, val, pin].each do |fragment|
+        if fragment
+          message = ".#{fragment}" << message
+        elsif !message.empty?
+          message = "." << message
+        end
       end
+      message = "#{cmd}" << message
       message << "\n"
-      message
     end
   end
 end
diff --git a/spec/lib/message_spec.rb b/spec/lib/message_spec.rb
index 93521fc2..7a8db344 100644
--- a/spec/lib/message_spec.rb
+++ b/spec/lib/message_spec.rb
@@ -32,6 +32,7 @@ module Dino
         Dino::Message.encode(command: 1).should == "1\n"
         Dino::Message.encode(command: 1, pin: 1, value: 1, aux_message: "Some Text").should == "1.1.1.Some Text\n"
         Dino::Message.encode(command: 1, aux_message: "Some Text").should == "1...Some Text\n"
+        Dino::Message.encode(command: 1, value: 1, aux_message: "Some Text").should == "1..1.Some Text\n"
       end
 
       it 'should insert a backslash before any newline inside the aux message' do

From e2891b7f08fb5fa8cc7a2872124b3f899f744dc9 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 29 Mar 2013 18:27:45 -0400
Subject: [PATCH 008/296] Set up an empty DinoLCD class for @supherman to
 implement

---
 src/du/du.ino                   |  2 +-
 src/du_ethernet/du_ethernet.ino |  2 +-
 src/lib/Dino.cpp                | 11 +++++++++++
 src/lib/Dino.h                  |  2 ++
 src/lib/DinoLCD.cpp             | 21 +++++++++++++++++++++
 src/lib/DinoLCD.h               | 13 +++++++++++++
 6 files changed, 49 insertions(+), 2 deletions(-)
 create mode 100644 src/lib/DinoLCD.cpp
 create mode 100644 src/lib/DinoLCD.h

diff --git a/src/du/du.ino b/src/du/du.ino
index f9644621..df4331c7 100644
--- a/src/du/du.ino
+++ b/src/du/du.ino
@@ -1,5 +1,6 @@
 #include "Dino.h"
 #include <Servo.h>
+#include <LiquidCrystal.h>
 Dino dino;
 
 // Dino.h doesn't handle TXRX. Setup a function to tell it to write to Serial.
@@ -16,4 +17,3 @@ void loop() {
   dino.updateListeners();
   Serial.flush();
 }
-
diff --git a/src/du_ethernet/du_ethernet.ino b/src/du_ethernet/du_ethernet.ino
index 0ada8ca3..94bdcaee 100644
--- a/src/du_ethernet/du_ethernet.ino
+++ b/src/du_ethernet/du_ethernet.ino
@@ -2,6 +2,7 @@
 #include <SPI.h>
 #include <Ethernet.h>
 #include <Servo.h>
+#include <LiquidCrystal.h>
 
 // Configure your MAC address, IP address, and HTTP port here.
 byte mac[] = { 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 };
@@ -68,4 +69,3 @@ void loop() {
   }
   client.stop();
 }
-
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index ec98f9cd..a2573ddb 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -4,6 +4,7 @@
 
 #include "Arduino.h"
 #include "Dino.h"
+DinoLCD dinoLCD;
 
 Dino::Dino(){
   messageFragments[0] = cmdStr;
@@ -76,6 +77,7 @@ void Dino::process() {
     case 7:  removeListener      ();  break;
     case 8:  servoToggle         ();  break;
     case 9:  servoWrite          ();  break;
+    case 10: handleLCD           ();  break;
     case 90: reset               ();  break;
     case 97: setAnalogDivider    ();  break;
     case 98: setHeartRate        ();  break;
@@ -251,6 +253,15 @@ void Dino::servoWrite() {
   servos[pin - 2].write(val);
 }
 
+// CMD = 10
+// Write a value to the servo object.
+void Dino::handleLCD() {
+  #ifdef debug
+    Serial.print("DinoLCD command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
+  #endif
+  dinoLCD.process(val, auxMsg);
+}
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index e53d2184..e8a89dd0 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -7,6 +7,7 @@
 
 #include "Arduino.h"
 #include <Servo.h>
+#include "DinoLCD.h"
 
 // Allocate listener storage based on what board we're running.
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
@@ -71,6 +72,7 @@ class Dino {
     void removeListener        ();
     void servoToggle           ();
     void servoWrite            ();
+    void handleLCD             ();
     void reset                 ();
     void setAnalogDivider      ();
     void setHeartRate          ();
diff --git a/src/lib/DinoLCD.cpp b/src/lib/DinoLCD.cpp
new file mode 100644
index 00000000..fda37a35
--- /dev/null
+++ b/src/lib/DinoLCD.cpp
@@ -0,0 +1,21 @@
+#include "Arduino.h"
+#include "DinoLCD.h"
+
+LiquidCrystal lcd(12,11,5,4,3,2);
+
+DinoLCD::DinoLCD(){
+}
+
+void DinoLCD::process(int cmd, char *message) {
+   // Remove this test code and build your implementation here.
+   
+   // Dynamically set up the lcd.
+   LiquidCrystal newLCD(8, 9, 4, 5, 6, 7);
+   
+   // Start it up and write the mssage.
+   lcd = newLCD;
+   lcd.begin(16,2);
+   lcd.clear();
+   lcd.print(message);
+}
+
diff --git a/src/lib/DinoLCD.h b/src/lib/DinoLCD.h
new file mode 100644
index 00000000..b2520a4e
--- /dev/null
+++ b/src/lib/DinoLCD.h
@@ -0,0 +1,13 @@
+#ifndef DinoLCD_h
+#define DinoLCD_h
+
+#include "Arduino.h"
+#include <LiquidCrystal.h>
+
+class DinoLCD {
+  public:
+    DinoLCD();
+    void process(int cmd, char *message);
+};
+
+#endif

From 5bcde35e76ef25075c0b3a4a75ba2eada50da82e Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 29 Mar 2013 18:46:26 -0400
Subject: [PATCH 009/296] Update the CLI and WiFi sketch to work with the
 latest changes.

---
 bin/dino                | 27 ++++++++++++---------------
 src/du_wifi/du_wifi.ino |  2 ++
 2 files changed, 14 insertions(+), 15 deletions(-)

diff --git a/bin/dino b/bin/dino
index 7e04bd60..381c9bcf 100755
--- a/bin/dino
+++ b/bin/dino
@@ -79,17 +79,14 @@ error "No sketches or invalid sketches specified" if $options[:sketch_names].emp
 
 $options[:sketch_names].each do |sketch_name|
   # Define the sources.
-  sketch_dir = sketch_name
-  sketch_file = sketch_name + ".ino"
   src_dir = Pathname.new(__FILE__).realpath.to_s.chomp("/bin/dino") + "/src"
-  src_header = File.join src_dir, "lib", "Dino.h"
-  src_implementation = File.join src_dir, "lib", "Dino.cpp"
-  src_sketch = File.join src_dir, sketch_dir, sketch_file
+  sketch_dir = sketch_name
+  sketch_filename = sketch_name + ".ino"
+  lib_filenames = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp"]
 
   # Read the files.
-  header = File.read(src_header)
-  implementation = File.read(src_implementation)
-  sketch = File.read(src_sketch)
+  libs = lib_filenames.map { |f| File.read(File.join(src_dir, "lib", f)) }
+  sketch = File.read(File.join(src_dir, sketch_dir, sketch_filename))
 
   # Modify them based on the arguments.
   if $options[:baud] && sketch_name == SERIAL
@@ -113,19 +110,19 @@ $options[:sketch_names].each do |sketch_name|
     sketch.gsub! "int port = 3466", "int port = #{$options[:port]}"
   end
   if $options[:debug]
-    header.gsub! "// #define debug true", "#define debug true"
+    libs[0].gsub! "// #define debug true", "#define debug true"
   end
 
   # Define the destinations.
   working_dir = Dir.pwd
   dest_dir = File.join working_dir, sketch_dir
   Dir::mkdir dest_dir
-  dest_header = File.join dest_dir, "Dino.h"
-  dest_implementation = File.join dest_dir, "Dino.cpp"
-  dest_sketch = File.join dest_dir, sketch_file
+  dest_sketch = File.join(dest_dir, sketch_filename)
+  dest_libs = lib_filenames.map { |f| File.join(dest_dir, f)}
 
   # Write the files.
-  File.open(dest_header, 'w')         { |f| f.write header }
-  File.open(dest_implementation, 'w') { |f| f.write implementation }
-  File.open(dest_sketch, 'w')         { |f| f.write sketch }
+  File.open(dest_sketch, 'w') { |f| f.write sketch }
+  dest_libs.each_with_index do |file, index|
+    File.open(file, 'w') { |f| f.write libs[index]}
+  end
 end
\ No newline at end of file
diff --git a/src/du_wifi/du_wifi.ino b/src/du_wifi/du_wifi.ino
index 706b5ff2..e9ebfc0d 100644
--- a/src/du_wifi/du_wifi.ino
+++ b/src/du_wifi/du_wifi.ino
@@ -1,6 +1,8 @@
 #include "Dino.h"
 #include <SPI.h>
 #include <WiFi.h>
+#include <Servo.h>
+#include <LiquidCrystal.h>
 
 // Configure your WiFi options here. MAC address and IP address are not configurable.
 int port = 3466;

From 1b7b9f8d300d6259afca6cae766502d1e24baf43 Mon Sep 17 00:00:00 2001
From: Herman Moreno <herman.moreno@crowdint.com>
Date: Mon, 1 Apr 2013 12:08:49 -0600
Subject: [PATCH 010/296] Add LCD support

---
 examples/lcd/lcd.png            | Bin 0 -> 45332 bytes
 examples/lcd/lcd.rb             |  12 +++
 lib/dino/components.rb          |   1 +
 lib/dino/components/lcd.rb      |  80 +++++++++++++++++++
 spec/lib/components/lcd_spec.rb | 134 ++++++++++++++++++++++++++++++++
 src/lib/DinoLCD.cpp             |  57 +++++++++++---
 src/lib/DinoLCD.h               |   6 ++
 7 files changed, 280 insertions(+), 10 deletions(-)
 create mode 100644 examples/lcd/lcd.png
 create mode 100644 examples/lcd/lcd.rb
 create mode 100644 lib/dino/components/lcd.rb
 create mode 100644 spec/lib/components/lcd_spec.rb

diff --git a/examples/lcd/lcd.png b/examples/lcd/lcd.png
new file mode 100644
index 0000000000000000000000000000000000000000..1930763b9315aa6182d0582f1f509da697ab2714
GIT binary patch
literal 45332
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

literal 0
HcmV?d00001

diff --git a/examples/lcd/lcd.rb b/examples/lcd/lcd.rb
new file mode 100644
index 00000000..8f7131c1
--- /dev/null
+++ b/examples/lcd/lcd.rb
@@ -0,0 +1,12 @@
+#
+# This example writes "Hello World!" in the display
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+lcd = Dino::Components::LCD.new(board: board, pins: "12,11,5,4,3,2")
+
+lcd.begin(16,2)
+lcd.puts("Hello World!")
+sleep
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 234ecb99..8087415f 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -8,5 +8,6 @@ module Components
     autoload :Servo,      'dino/components/servo'
     autoload :Stepper,    'dino/components/stepper'
     autoload :IrReceiver, 'dino/components/ir_receiver'
+    autoload :LCD,        'dino/components/lcd'
   end
 end
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
new file mode 100644
index 00000000..30b74a97
--- /dev/null
+++ b/lib/dino/components/lcd.rb
@@ -0,0 +1,80 @@
+module Dino
+  module Components
+    class LCD < BaseComponent
+
+      def after_initialize(options)
+        board.write Dino::Message.encode command: 10, value: 0, aux_message: pins
+      end
+
+      def begin(cols, rows)
+        board.write Dino::Message.encode command: 10, value: 1, aux_message: "#{cols},#{rows}"
+        sleep 2
+      end
+
+      def clear
+        board.write Dino::Message.encode command: 10, value: 2
+      end
+
+      def home
+        board.write Dino::Message.encode command: 10, value: 3
+      end
+
+      def set_cursor(col, row)
+        board.write Dino::Message.encode command: 10, value: 4, aux_message: "#{col},#{row}"
+      end
+
+      def puts(string)
+        board.write Dino::Message.encode command: 10, value: 5, aux_message: string
+      end
+
+      def show_cursor
+        board.write Dino::Message.encode command: 10, value: 6
+      end
+
+      def hide_cursor
+        board.write Dino::Message.encode command: 10, value: 7
+      end
+
+      def blink
+        board.write Dino::Message.encode command: 10, value: 8
+      end
+
+      def no_blink
+        board.write Dino::Message.encode command: 10, value: 9
+      end
+
+      def on
+        board.write Dino::Message.encode command: 10, value: 10
+      end
+
+      def off
+        board.write Dino::Message.encode command: 10, value: 11
+      end
+
+      def scroll_left
+        board.write Dino::Message.encode command: 10, value: 12
+      end
+
+      def scroll_right
+        board.write Dino::Message.encode command: 10, value: 13
+      end
+
+      def enable_autoscroll
+        board.write Dino::Message.encode command: 10, value: 14
+      end
+
+      def disable_autoscroll
+        board.write Dino::Message.encode command: 10, value: 15
+      end
+
+      def left_to_right
+        board.write Dino::Message.encode command: 10, value: 16
+      end
+
+      def right_to_left
+        board.write Dino::Message.encode command: 10, value: 17
+      end
+
+    end
+  end
+end
diff --git a/spec/lib/components/lcd_spec.rb b/spec/lib/components/lcd_spec.rb
new file mode 100644
index 00000000..ee3503e6
--- /dev/null
+++ b/spec/lib/components/lcd_spec.rb
@@ -0,0 +1,134 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe LCD do
+      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
+      subject { LCD.new board: board, pins: '12,11,5,4,3,2' }
+
+      before do
+        board.should_receive(:write).with("10..0.12,11,5,4,3,2\n")
+      end
+
+      describe '#begin' do
+        it 'should initialize the display sending the command "10..1.16,2\n" to the board' do
+          board.should_receive(:write).with "10..1.16,2\n"
+          subject.should_receive(:sleep).with 2
+          subject.begin(16,2)
+        end
+      end
+
+      describe '#clear' do
+        it 'clears the display sending the command "10..2\n" to the board' do
+          board.should_receive(:write).with "10..2\n"
+          subject.clear
+        end
+      end
+
+      describe '#home' do
+        it 'Moves the cursor to the first position with the command "10..3\n"' do
+          board.should_receive(:write).with "10..3\n"
+          subject.home
+        end
+      end
+
+      describe '#set_cursor' do
+        it 'moves the cursor to the given position sending the command "10..4.0,1\n"' do
+          board.should_receive(:write).with "10..4.0,1\n"
+          subject.set_cursor(0,1)
+        end
+      end
+
+      describe '#puts' do
+        it 'prints a string in the display' do
+          board.should_receive(:write).with "10..5.AB\n"
+          subject.puts("AB")
+        end
+      end
+
+      describe '#show_cursor' do
+        it 'shows the cursor with the command "10..6\n"' do
+          board.should_receive(:write).with "10..6\n"
+          subject.show_cursor
+        end
+      end
+
+      describe '#hide_cursor' do
+        it 'hides the cursor with the command "10..7\n"' do
+          board.should_receive(:write).with "10..7\n"
+          subject.hide_cursor
+        end
+      end
+
+      describe '#blink' do
+        it 'shows a blinking cursor with the command "10..8\n"' do
+          board.should_receive(:write).with "10..8\n"
+          subject.blink
+        end
+      end
+
+      describe '#no_blink' do
+        it 'stops a blinking cursor with the command "10..9\n"' do
+          board.should_receive(:write).with "10..9\n"
+          subject.no_blink
+        end
+      end
+
+      describe '#on' do
+        it 'turn on the display with the command "10..10\n"' do
+          board.should_receive(:write).with "10..10\n"
+          subject.on
+        end
+      end
+
+      describe '#off' do
+        it 'turn off the display with the command "10..11\n"' do
+          board.should_receive(:write).with "10..11\n"
+          subject.off
+        end
+      end
+
+      describe '#scroll_left' do
+        it 'move the text in the display one position to the left  the command "10..12\n"' do
+          board.should_receive(:write).with "10..12\n"
+          subject.scroll_left
+        end
+      end
+
+      describe '#scroll_right' do
+        it 'move the text in the display one position to the right  the command "10..13\n"' do
+          board.should_receive(:write).with "10..13\n"
+          subject.scroll_right
+        end
+      end
+
+      describe '#enable_autoscroll' do
+        it 'enable autoscroll with the command "10..14\n"' do
+          board.should_receive(:write).with "10..14\n"
+          subject.enable_autoscroll
+        end
+      end
+
+      describe '#disable_autoscroll' do
+        it 'disable autoscroll with the command "10..15\n"' do
+          board.should_receive(:write).with "10..15\n"
+          subject.disable_autoscroll
+        end
+      end
+
+      describe '#left_to_right' do
+        it 'set the display writing to start from the left with the command "10..16\n"' do
+          board.should_receive(:write).with "10..16\n"
+          subject.left_to_right
+        end
+      end
+
+      describe '#right_to_left' do
+        it 'set the display writing to start from the right with the command "10..17\n"' do
+          board.should_receive(:write).with "10..17\n"
+          subject.right_to_left
+        end
+      end
+    end
+  end
+end
diff --git a/src/lib/DinoLCD.cpp b/src/lib/DinoLCD.cpp
index fda37a35..80a8a14f 100644
--- a/src/lib/DinoLCD.cpp
+++ b/src/lib/DinoLCD.cpp
@@ -6,16 +6,53 @@ LiquidCrystal lcd(12,11,5,4,3,2);
 DinoLCD::DinoLCD(){
 }
 
+int *DinoLCD::parse(char *aux){
+  int *values = new int[11];
+  char *str;
+  int index = 0;
+  while ((str = strsep(&aux, ",")) != NULL) {
+    values[index] = atoi(str);
+    index++;
+  }
+  return values;
+}
+
 void DinoLCD::process(int cmd, char *message) {
-   // Remove this test code and build your implementation here.
-   
-   // Dynamically set up the lcd.
-   LiquidCrystal newLCD(8, 9, 4, 5, 6, 7);
-   
-   // Start it up and write the mssage.
-   lcd = newLCD;
-   lcd.begin(16,2);
-   lcd.clear();
-   lcd.print(message);
+  switch(cmd) {
+    case 0:  setPins(message);           break;
+    case 1:  beginLCD(message);          break;
+    case 2:  lcd.clear();                break;
+    case 3:  lcd.home();                 break;
+    case 4:  setLCDCursor(message);      break;
+    case 5:  lcd.print(message);         break;
+    case 6:  lcd.cursor();               break;
+    case 7:  lcd.noCursor();             break;
+    case 8:  lcd.blink();                break;
+    case 9:  lcd.noBlink();              break;
+    case 10: lcd.display();              break;
+    case 11: lcd.noDisplay();            break;
+    case 12: lcd.scrollDisplayLeft();    break;
+    case 13: lcd.scrollDisplayRight();   break;
+    case 14: lcd.autoscroll();           break;
+    case 15: lcd.noAutoscroll();         break;
+    case 16: lcd.leftToRight();          break;
+    case 17: lcd.rightToLeft();          break;
+    default:                             break;
+  }
+}
+
+void DinoLCD::setPins(char *aux) {
+  int *pins = parse(aux);
+  LiquidCrystal newLCD(pins[0],pins[1],pins[2],pins[3],pins[4],pins[5]);
+  lcd = newLCD;
 }
 
+void DinoLCD::beginLCD(char *aux) {
+  int *values = parse(aux);
+  lcd.begin(values[0], values[1]);
+}
+
+void DinoLCD::setLCDCursor(char *aux) {
+  int *values = parse(aux);
+  lcd.setCursor(values[0], values[1]);
+}
diff --git a/src/lib/DinoLCD.h b/src/lib/DinoLCD.h
index b2520a4e..28cdf582 100644
--- a/src/lib/DinoLCD.h
+++ b/src/lib/DinoLCD.h
@@ -3,11 +3,17 @@
 
 #include "Arduino.h"
 #include <LiquidCrystal.h>
+#include <string.h>
 
 class DinoLCD {
   public:
     DinoLCD();
     void process(int cmd, char *message);
+  private:
+    int *parse(char *aux);
+    void setPins(char *aux);
+    void beginLCD(char *aux);
+    void setLCDCursor(char *aux);
 };
 
 #endif

From 6f778b8e19d3aa0a00df6fb3d5b272a16396e93d Mon Sep 17 00:00:00 2001
From: Herman Moreno <herman.moreno@crowdint.com>
Date: Mon, 1 Apr 2013 20:37:03 -0600
Subject: [PATCH 011/296] Allow 8bit mode

---
 examples/lcd/lcd.rb             |  5 ++++-
 lib/dino/components/lcd.rb      | 24 +++++++++++++++++++++++-
 spec/lib/components/lcd_spec.rb |  3 ++-
 src/lib/DinoLCD.cpp             | 14 ++++++++++++--
 src/lib/DinoLCD.h               |  1 +
 5 files changed, 42 insertions(+), 5 deletions(-)

diff --git a/examples/lcd/lcd.rb b/examples/lcd/lcd.rb
index 8f7131c1..3187cdf9 100644
--- a/examples/lcd/lcd.rb
+++ b/examples/lcd/lcd.rb
@@ -5,7 +5,10 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-lcd = Dino::Components::LCD.new(board: board, pins: "12,11,5,4,3,2")
+lcd = Dino::Components::LCD.new(
+          board: board,
+          pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 }
+)
 
 lcd.begin(16,2)
 lcd.puts("Hello World!")
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index 30b74a97..7f314d86 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -2,8 +2,22 @@ module Dino
   module Components
     class LCD < BaseComponent
 
+      # Initialize in 4 bits mode
+      #
+      # Dino::Componentes::LCD.new(
+      #       board: board,
+      #       pins: { rs: 12, enable: 11, d4: 4, d5: 5, d6: 6, d7: 7 }
+      # )
+      #
+      # Initialize in 8 bits mode
+      #
+      # Dino::Componentes::LCD.new(
+      #       board: board,
+      #       pins: { rs: 12, enable: 11, d0: 0, d1: 1, d2: 2, d3: 3, d4: 4, d5: 5, d6: 6, d7: 7 }
+      # )
+      #
       def after_initialize(options)
-        board.write Dino::Message.encode command: 10, value: 0, aux_message: pins
+        board.write Dino::Message.encode command: 10, value: 0, aux_message: encoded_pins
       end
 
       def begin(cols, rows)
@@ -75,6 +89,14 @@ def right_to_left
         board.write Dino::Message.encode command: 10, value: 17
       end
 
+      private
+
+      def encoded_pins
+        encoded = [pins[:rs], pins[:enable], pins[:d0],
+                   pins[:d1], pins[:d2], pins[:d3], pins[:d4],
+                   pins[:d5], pins[:d6], pins[:d7]]
+        encoded.compact.join(',')
+      end
     end
   end
 end
diff --git a/spec/lib/components/lcd_spec.rb b/spec/lib/components/lcd_spec.rb
index ee3503e6..3778f9d7 100644
--- a/spec/lib/components/lcd_spec.rb
+++ b/spec/lib/components/lcd_spec.rb
@@ -4,7 +4,8 @@ module Dino
   module Components
     describe LCD do
       let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
-      subject { LCD.new board: board, pins: '12,11,5,4,3,2' }
+
+      subject { LCD.new board: board, pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 } }
 
       before do
         board.should_receive(:write).with("10..0.12,11,5,4,3,2\n")
diff --git a/src/lib/DinoLCD.cpp b/src/lib/DinoLCD.cpp
index 80a8a14f..0c0bbabb 100644
--- a/src/lib/DinoLCD.cpp
+++ b/src/lib/DinoLCD.cpp
@@ -14,6 +14,7 @@ int *DinoLCD::parse(char *aux){
     values[index] = atoi(str);
     index++;
   }
+  parseSize = index;
   return values;
 }
 
@@ -43,8 +44,17 @@ void DinoLCD::process(int cmd, char *message) {
 
 void DinoLCD::setPins(char *aux) {
   int *pins = parse(aux);
-  LiquidCrystal newLCD(pins[0],pins[1],pins[2],pins[3],pins[4],pins[5]);
-  lcd = newLCD;
+  if(parseSize > 6) {
+    // 8 bits mode
+    LiquidCrystal newLCD(pins[0],pins[1],pins[2],pins[3],pins[4],pins[5],
+                         pins[6], pins[7], pins[8], pins[9]);
+    lcd = newLCD;
+  }
+  else {
+    // 4 bits mode
+    LiquidCrystal newLCD(pins[0],pins[1],pins[2],pins[3],pins[4],pins[5]);
+    lcd = newLCD;
+  }
 }
 
 void DinoLCD::beginLCD(char *aux) {
diff --git a/src/lib/DinoLCD.h b/src/lib/DinoLCD.h
index 28cdf582..a90629e2 100644
--- a/src/lib/DinoLCD.h
+++ b/src/lib/DinoLCD.h
@@ -14,6 +14,7 @@ class DinoLCD {
     void setPins(char *aux);
     void beginLCD(char *aux);
     void setLCDCursor(char *aux);
+    int parseSize;
 };
 
 #endif

From 02d47d86d04cedb3e455b37de1282701b8eca7fd Mon Sep 17 00:00:00 2001
From: Peter Hellberg <peter@c7.se>
Date: Tue, 21 May 2013 23:44:44 +0200
Subject: [PATCH 012/296] Switched to using .ruby-version, bumped the Ruby
 version to 2.0.0p195

---
 .ruby-version | 1 +
 .rvmrc        | 1 -
 2 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 .ruby-version
 delete mode 100644 .rvmrc

diff --git a/.ruby-version b/.ruby-version
new file mode 100644
index 00000000..95a5ad2d
--- /dev/null
+++ b/.ruby-version
@@ -0,0 +1 @@
+ruby-2.0.0-p195
diff --git a/.rvmrc b/.rvmrc
deleted file mode 100644
index 7757f1ea..00000000
--- a/.rvmrc
+++ /dev/null
@@ -1 +0,0 @@
-rvm use ruby-1.9.3@dino --create
\ No newline at end of file

From 93d2143abb1276e922cb5204d03beb880fbe995c Mon Sep 17 00:00:00 2001
From: Peter Hellberg <peter@c7.se>
Date: Wed, 22 May 2013 00:25:38 +0200
Subject: [PATCH 013/296] Added support for using a Seven Segment Display (SSD)

---
 examples/ssd/ssd.rb             |  18 +++++
 lib/dino/components.rb          |   1 +
 lib/dino/components/ssd.rb      | 117 ++++++++++++++++++++++++++++++++
 spec/lib/components/ssd_spec.rb |  93 +++++++++++++++++++++++++
 4 files changed, 229 insertions(+)
 create mode 100644 examples/ssd/ssd.rb
 create mode 100644 lib/dino/components/ssd.rb
 create mode 100644 spec/lib/components/ssd_spec.rb

diff --git a/examples/ssd/ssd.rb b/examples/ssd/ssd.rb
new file mode 100644
index 00000000..236c602d
--- /dev/null
+++ b/examples/ssd/ssd.rb
@@ -0,0 +1,18 @@
+#
+# This is an example of how to use the ssd class
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+ssd   = Dino::Components::SSD.new(
+  board: board,
+  pins:  [12,13,3,4,5,10,9],
+  anode: 11
+)
+
+# Turn off the ssd on exit
+trap("SIGINT") { exit !ssd.off }
+
+# Display each new line on the ssd
+loop { ssd.display(gets.chomp) }
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 8087415f..81f19fd4 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -6,6 +6,7 @@ module Components
     autoload :Sensor,     'dino/components/sensor'
     autoload :RgbLed,     'dino/components/rgb_led'
     autoload :Servo,      'dino/components/servo'
+    autoload :SSD,        'dino/components/ssd'
     autoload :Stepper,    'dino/components/stepper'
     autoload :IrReceiver, 'dino/components/ir_receiver'
     autoload :LCD,        'dino/components/lcd'
diff --git a/lib/dino/components/ssd.rb b/lib/dino/components/ssd.rb
new file mode 100644
index 00000000..448a19f1
--- /dev/null
+++ b/lib/dino/components/ssd.rb
@@ -0,0 +1,117 @@
+# Connect to the Arduino and
+# take control of the SSD
+#
+# ssd = SevenSegmentDisplay.new(
+#   board: Board.new(TxRx.new),
+#   pins:  [12,13,3,4,5,10,9],
+#   anode: 11
+# )
+
+module Dino
+  module Components
+    class SSD < BaseComponent
+      attr_reader :anode
+
+      def after_initialize(options={})
+        @anode = options[:anode]
+
+        raise Exception.new('anode must be specified') unless anode
+
+        # Set all pins to output
+        pins.each { |pin| set_pin_mode(pin, :out) }
+
+        # Clear the display
+        clear
+
+        # Turn on the display
+        on
+      end
+
+      def clear
+        7.times { |t| toggle t, 0 }
+      end
+
+      def display(char)
+        key = char.to_s.upcase
+
+        return scroll(key) if key.length > 1
+
+        # Make sure the ssd is turned on.
+        on
+
+        if chars = CHARACTERS[key]
+          chars.each_with_index { |s,i| toggle i, s }
+        else
+          clear
+        end
+      end
+
+      def on
+        digital_write anode, Board::HIGH
+      end
+
+      def off
+        digital_write anode, Board::LOW
+      end
+
+      CHARACTERS = {
+        '0' => [1,1,1,1,1,1,0],
+        '1' => [0,1,1,0,0,0,0],
+        '2' => [1,1,0,1,1,0,1],
+        '3' => [1,1,1,1,0,0,1],
+        '4' => [0,1,1,0,0,1,1],
+        '5' => [1,0,1,1,0,1,1],
+        '6' => [1,0,1,1,1,1,1],
+        '7' => [1,1,1,0,0,0,0],
+        '8' => [1,1,1,1,1,1,1],
+        '9' => [1,1,1,1,0,1,1],
+        ' ' => [0,0,0,0,0,0,0],
+        '_' => [0,0,0,1,0,0,0],
+        '-' => [0,0,0,0,0,0,1],
+        'A' => [1,1,1,0,1,1,1],
+        'B' => [0,0,1,1,1,1,1],
+        'C' => [0,0,0,1,1,0,1],
+        'D' => [0,1,1,1,1,0,1],
+        'E' => [1,0,0,1,1,1,1],
+        'F' => [1,0,0,0,1,1,1],
+        'G' => [1,0,1,1,1,1,0],
+        'H' => [0,0,1,0,1,1,1],
+        'I' => [0,0,1,0,0,0,0],
+        'J' => [0,1,1,1,1,0,0],
+        'K' => [1,0,1,0,1,1,1],
+        'L' => [0,0,0,1,1,1,0],
+        'M' => [1,1,1,0,1,1,0],
+        'N' => [0,0,1,0,1,0,1],
+        'O' => [0,0,1,1,1,0,1],
+        'P' => [1,1,0,0,1,1,1],
+        'Q' => [1,1,1,0,0,1,1],
+        'R' => [0,0,0,0,1,0,1],
+        'S' => [0,0,1,1,0,1,1],
+        'T' => [0,0,0,1,1,1,1],
+        'U' => [0,0,1,1,1,0,0],
+        'V' => [0,1,1,1,1,1,0],
+        'W' => [0,1,1,1,1,1,1],
+        'X' => [0,1,1,0,1,1,1],
+        'Y' => [0,1,1,1,0,1,1],
+        'Z' => [1,1,0,1,1,0,0],
+      }
+
+      private
+
+      def scroll(string)
+        string.chars.each do |chr|
+          off
+          sleep 0.05
+          display chr
+          sleep 0.5
+        end
+
+        clear
+      end
+
+      def toggle(number, state)
+        digital_write pins[number], state == 1 ? 0 : 1
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/ssd_spec.rb b/spec/lib/components/ssd_spec.rb
new file mode 100644
index 00000000..c6b0fc6d
--- /dev/null
+++ b/spec/lib/components/ssd_spec.rb
@@ -0,0 +1,93 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe SSD do
+      let(:anode) { 11 }
+      let(:pins)  { [12,13,3,4,5,10,9] }
+
+      let(:board) do
+        mock(:board, digital_write: true, set_pin_mode: true)
+      end
+
+      let(:ssd) do
+        SSD.new board: board, pins: pins, anode: anode
+      end
+
+      describe '#initialize' do
+        it 'should raise if it does not receive a pin' do
+          expect { SSD.new(board: board, anode: anode) }.to raise_exception
+        end
+
+        it 'should raise if it does not receive a board' do
+          expect { SSD.new(pins: pins, anode: anode) }.to raise_exception
+        end
+
+        it 'should raise if it does not receive a board' do
+          expect { SSD.new(board: board, pins: pins) }.to raise_exception
+        end
+
+        it 'should set the pins to out' do
+          pins.each do |pin|
+            board.should_receive(:set_pin_mode).with(pin, :out, nil)
+          end
+
+          ssd.after_initialize(anode: anode)
+        end
+
+        it "should clear the display" do
+          ssd.should_receive(:clear).once
+          ssd.after_initialize(anode: anode)
+        end
+
+        it "should turn on the display" do
+          ssd.should_receive(:on).once
+          ssd.after_initialize(anode: anode)
+        end
+      end
+
+      describe '#clear' do
+        it 'should toggle all the seven leds to off' do
+          ssd.should_receive(:toggle).exactly(7).with(anything, 0)
+          ssd.clear
+        end
+      end
+
+      describe '#on' do
+        it 'should turn the ssd on' do
+          board.should_receive(:digital_write).with(anode, Board::HIGH)
+          ssd.on
+        end
+      end
+
+      describe '#off' do
+        it 'should turn the ssd off' do
+          board.should_receive(:digital_write).with(anode, Board::LOW)
+          ssd.off
+        end
+      end
+
+      describe '#display' do
+        it "should scroll on multiple characters" do
+          ssd.should_receive(:scroll).with('FOO')
+          ssd.display('foo')
+        end
+
+        it "should make sure the ssd is turned on" do
+          ssd.should_receive(:on)
+          ssd.display(1)
+        end
+
+        it "should clear the display on unknown character" do
+          ssd.should_receive(:clear)
+          ssd.display('+')
+        end
+
+        it "should toggle all the segments in order to display a character" do
+          ssd.should_receive(:toggle).exactly(7)
+          ssd.display('7')
+        end
+      end
+    end
+  end
+end

From f50e0ce52419e46a7725e08114024a9540811070 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sat, 1 Jun 2013 01:38:29 -0400
Subject: [PATCH 014/296] Untested shift register support.

---
 lib/dino/components.rb                | 19 ++++---
 lib/dino/components/shift_register.rb | 31 +++++++++++
 src/lib/Dino.cpp                      | 13 ++++-
 src/lib/Dino.h                        | 79 ++++++++++++++-------------
 4 files changed, 94 insertions(+), 48 deletions(-)
 create mode 100644 lib/dino/components/shift_register.rb

diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 81f19fd4..8ddd6d32 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -1,14 +1,15 @@
 module Dino
   module Components
     require 'dino/components/base_component'
-    autoload :Led,        'dino/components/led'
-    autoload :Button,     'dino/components/button'
-    autoload :Sensor,     'dino/components/sensor'
-    autoload :RgbLed,     'dino/components/rgb_led'
-    autoload :Servo,      'dino/components/servo'
-    autoload :SSD,        'dino/components/ssd'
-    autoload :Stepper,    'dino/components/stepper'
-    autoload :IrReceiver, 'dino/components/ir_receiver'
-    autoload :LCD,        'dino/components/lcd'
+    autoload :Led,            'dino/components/led'
+    autoload :Button,         'dino/components/button'
+    autoload :Sensor,         'dino/components/sensor'
+    autoload :RgbLed,         'dino/components/rgb_led'
+    autoload :Servo,          'dino/components/servo'
+    autoload :SSD,            'dino/components/ssd'
+    autoload :Stepper,        'dino/components/stepper'
+    autoload :IrReceiver,     'dino/components/ir_receiver'
+    autoload :LCD,            'dino/components/lcd'
+    autoload :ShiftRegister,  'dino/components/shift_register'
   end
 end
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
new file mode 100644
index 00000000..4c04c08c
--- /dev/null
+++ b/lib/dino/components/shift_register.rb
@@ -0,0 +1,31 @@
+module Dino
+  module Components
+    class ShiftRegister < BaseComponent
+      # options = {board: my_board, pins: {latch: latch_pin, clock: clock_pin, data: data_pin}
+      def after_initialize(options={})
+        raise 'missing pins[:latch] pin' unless self.pins[:latch]
+        raise 'missing pins[:clock] pin' unless self.pins[:clock]
+        raise 'missing pins[:data] pin' unless self.pins[:data]
+
+        pins.each do |pin|
+          set_pin_mode(pin, :out)
+          analog_write(pin, Board::LOW)
+        end
+      end
+
+      def latch_off
+        digital_write(pins[:latch], Board::LOW)
+      end
+
+      def latch_on
+        digital_write(pins[:latch], Board::HIGH)
+      end
+
+      def write(byte)
+        latch_off
+        board.write(Dino::Message.encode command: 11, pin: convert_pin(pins[:data]), value: byte, aux_message: convert_pin(pins[:clock])})
+        latch_on
+      end
+    end
+  end
+end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 40ae423b..14cb016a 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -31,7 +31,7 @@ void Dino::parse(char c) {
   }
 
   // If fragment delimiter, terminate current fragment and move to next.
-  // Unless we're in the extended message, then just append.
+  // Unless we're in the auxillary message fragment, then just append.
   else if (c == '.') {
     if (fragmentIndex < 3) {
       append('\0');
@@ -78,6 +78,7 @@ void Dino::process() {
     case 8:  servoToggle         ();  break;
     case 9:  servoWrite          ();  break;
     case 10: handleLCD           ();  break;
+    case 11: shiftWrite          ();  break;
     case 90: reset               ();  break;
     case 97: setAnalogDivider    ();  break;
     case 98: setHeartRate        ();  break;
@@ -262,6 +263,16 @@ void Dino::handleLCD() {
   dinoLCD.process(val, auxMsg);
 }
 
+// CMD = 11
+// Write to a shift register.
+void Dino::shiftWrite() {
+  #ifdef debug
+    Serial.print("Shift write :"); Serial.print(val); Serial.print(" to pin "); Serial.print(pin); Serial.print(". Clock pin: "); Serial.println(auxMsg);
+  #endif
+  // auxMsg should be the clock pin.
+  shiftOut(pin, atoi(auxMsg), MSBFIRST, val);
+}
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index d56dfb87..28b084a9 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -26,64 +26,67 @@ class Dino {
     Dino();
     void setupWrite(void (*writeCallback)(char *str));
     void parse(char c);
-    void process();
     void updateListeners();
     
   private:
-    // Manage heartbeat and listeners.
-    long heartRate;
-    long lastUpdate;
-    unsigned int loopCount;
-    unsigned int analogDivider;
-    
-    // Listeners correspond to raw pin number by array index, and store boolean. false == disabled.
-    boolean analogListeners[PIN_COUNT];
-    boolean digitalListeners[PIN_COUNT];
+    // API-accessible functions.
+    void setMode               ();  //cmd = 0
+    void dWrite                ();  //cmd = 1
+    void dRead                 ();  //cmd = 2
+    void aWrite                ();  //cmd = 3
+    void aRead                 ();  //cmd = 4
+    void addDigitalListener    ();  //cmd = 5
+    void addAnalogListener     ();  //cmd = 6
+    void removeListener        ();  //cmd = 7
+    void servoToggle           ();  //cmd = 8
+    void servoWrite            ();  //cmd = 9
+    void handleLCD             ();  //cmd = 10
+    void shiftWrite            ();  //cmd = 11
+    void reset                 ();  //cmd = 90
+    void setAnalogDivider      ();  //cmd = 97
+    void setHeartRate          ();  //cmd = 98
+  
+    // Parser state storage and utility functions.
+    char *messageFragments[4];
+    byte fragmentIndex;
+    int charIndex;
+    boolean backslash;
+    void append(char c);
+    void process();
     
-    // Keep track of the last read values for digital listeners. Only write responses when changed.
-    byte digitalListenerValues[PIN_COUNT];
-
     // Parsed message storage.
     char cmdStr[5]; int cmd;
     char pinStr[5]; int pin;
     char valStr[5]; int val;
     char auxMsg[256];
-    
-    // Parser state storage.
-    char *messageFragments[4];
-    byte fragmentIndex;
-    int charIndex;
-    boolean backslash;
 
     // Value and response storage.
     int rval;
     char response[8];
+    
+    // Use a write callback from the main sketch to respond.
     void (*_writeCallback)(char *str);
     void writeResponse();
 
+    // Arduino native library variables.
     Servo servos[12];
 
-    // API-accessible functions.
-    void setMode               ();
-    void dWrite                (); 
-    void dRead                 ();
-    void aWrite                ();
-    void aRead                 ();
-    void addDigitalListener    ();
-    void addAnalogListener     ();
-    void removeListener        ();
-    void servoToggle           ();
-    void servoWrite            ();
-    void handleLCD             ();
-    void reset                 ();
-    void setAnalogDivider      ();
-    void setHeartRate          ();
+    // Internal timing variables and utility functions.
+    long heartRate;
+    long lastUpdate;
+    unsigned int loopCount;
+    unsigned int analogDivider;
+    long timeSince (long event);
+    
+    // Listeners correspond to raw pin number by array index, and store boolean. false == disabled.
+    boolean analogListeners[PIN_COUNT];
+    boolean digitalListeners[PIN_COUNT];
+    
+    // Keep track of the last read values for digital listeners. Only write responses when changed.
+    byte digitalListenerValues[PIN_COUNT];
 
-    // Internal functions.
-    void append                 (char c);
-    long timeSince              (long event);
+    // Listener update functions.
     void updateDigitalListeners ();
     void updateAnalogListeners  ();
 };
-
 #endif

From b9de1ba6b45ad24f1837f9a7934dbff4abb305e5 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sun, 2 Jun 2013 11:58:33 -0400
Subject: [PATCH 015/296] Simplify LCD initialization

---
 examples/lcd/lcd.rb             |  5 +++--
 lib/dino/components/lcd.rb      | 26 +++++++++++++-------------
 spec/lib/components/lcd_spec.rb | 11 ++---------
 3 files changed, 18 insertions(+), 24 deletions(-)

diff --git a/examples/lcd/lcd.rb b/examples/lcd/lcd.rb
index 3187cdf9..f6c04507 100644
--- a/examples/lcd/lcd.rb
+++ b/examples/lcd/lcd.rb
@@ -7,9 +7,10 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 lcd = Dino::Components::LCD.new(
           board: board,
-          pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 }
+          pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 },
+          cols: 16,
+          rows: 2
 )
 
-lcd.begin(16,2)
 lcd.puts("Hello World!")
 sleep
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index 7f314d86..b7cba3c7 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -6,23 +6,28 @@ class LCD < BaseComponent
       #
       # Dino::Componentes::LCD.new(
       #       board: board,
-      #       pins: { rs: 12, enable: 11, d4: 4, d5: 5, d6: 6, d7: 7 }
+      #       pins: { rs: 12, enable: 11, d4: 4, d5: 5, d6: 6, d7: 7 },
+      #       cols: 16,
+      #       rows: 2
       # )
       #
       # Initialize in 8 bits mode
       #
       # Dino::Componentes::LCD.new(
       #       board: board,
-      #       pins: { rs: 12, enable: 11, d0: 0, d1: 1, d2: 2, d3: 3, d4: 4, d5: 5, d6: 6, d7: 7 }
+      #       pins: { rs: 12, enable: 11, d0: 0, d1: 1, d2: 2, d3: 3, d4: 4, d5: 5, d6: 6, d7: 7 },
+      #       cols: 16,
+      #       rows: 2
       # )
       #
       def after_initialize(options)
         board.write Dino::Message.encode command: 10, value: 0, aux_message: encoded_pins
+        @cols, @rows = options[:cols], options[:rows]
+        board.write Dino::Message.encode command: 10, value: 1, aux_message: "#{@cols},#{@rows}"
       end
 
-      def begin(cols, rows)
-        board.write Dino::Message.encode command: 10, value: 1, aux_message: "#{cols},#{rows}"
-        sleep 2
+      def puts(string)
+        board.write Dino::Message.encode command: 10, value: 5, aux_message: string
       end
 
       def clear
@@ -37,10 +42,6 @@ def set_cursor(col, row)
         board.write Dino::Message.encode command: 10, value: 4, aux_message: "#{col},#{row}"
       end
 
-      def puts(string)
-        board.write Dino::Message.encode command: 10, value: 5, aux_message: string
-      end
-
       def show_cursor
         board.write Dino::Message.encode command: 10, value: 6
       end
@@ -92,10 +93,9 @@ def right_to_left
       private
 
       def encoded_pins
-        encoded = [pins[:rs], pins[:enable], pins[:d0],
-                   pins[:d1], pins[:d2], pins[:d3], pins[:d4],
-                   pins[:d5], pins[:d6], pins[:d7]]
-        encoded.compact.join(',')
+        [pins[:rs], pins[:enable], pins[:d0],
+         pins[:d1], pins[:d2], pins[:d3], pins[:d4],
+         pins[:d5], pins[:d6], pins[:d7]].compact.join(',')
       end
     end
   end
diff --git a/spec/lib/components/lcd_spec.rb b/spec/lib/components/lcd_spec.rb
index 3778f9d7..dc9b2991 100644
--- a/spec/lib/components/lcd_spec.rb
+++ b/spec/lib/components/lcd_spec.rb
@@ -5,18 +5,11 @@ module Components
     describe LCD do
       let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
 
-      subject { LCD.new board: board, pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 } }
+      subject { LCD.new board: board, pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 }, cols: 16, rows: 2 }
 
       before do
         board.should_receive(:write).with("10..0.12,11,5,4,3,2\n")
-      end
-
-      describe '#begin' do
-        it 'should initialize the display sending the command "10..1.16,2\n" to the board' do
-          board.should_receive(:write).with "10..1.16,2\n"
-          subject.should_receive(:sleep).with 2
-          subject.begin(16,2)
-        end
+        board.should_receive(:write).with("10..1.16,2\n")
       end
 
       describe '#clear' do

From 7f2bf5e7b432736afd6a2f61037c5270e7b00fa6 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 7 Jun 2013 12:31:44 -0400
Subject: [PATCH 016/296] Make sure aux messages convert to strings.

---
 lib/dino/message.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/message.rb b/lib/dino/message.rb
index d60c4b8a..c4e81be1 100644
--- a/lib/dino/message.rb
+++ b/lib/dino/message.rb
@@ -5,7 +5,7 @@ def self.encode(options={})
       pin = options[:pin]
       val = options[:value]
       aux = options[:aux_message]
-      aux.gsub!("\n", "\\\n") if aux
+      aux.to_s.gsub!("\n", "\\\n") if aux
 
       raise Exception.new('commands must be specified') unless cmd
       raise Exception.new('commands can only be four digits') if cmd.to_s.length > 4

From 271f626fb1cec9e900ea78cd72a0c5706fdc0693 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 7 Jun 2013 13:21:27 -0400
Subject: [PATCH 017/296] Use a non-standard port when testing to avoid hanging
 rspec

---
 spec/lib/tx_rx/tcp_spec.rb | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/spec/lib/tx_rx/tcp_spec.rb b/spec/lib/tx_rx/tcp_spec.rb
index 31c756f6..725b09f5 100644
--- a/spec/lib/tx_rx/tcp_spec.rb
+++ b/spec/lib/tx_rx/tcp_spec.rb
@@ -4,7 +4,7 @@ module Dino
   describe TxRx::TCP do
     before :each do
       @host = "127.0.0.1"
-      @port = 3466
+      @port = 3467
       @instance = TxRx::TCP.new(@host, @port)
     end
 
@@ -14,7 +14,7 @@ module Dino
       end
 
       it 'should return the TCPSocket if connected' do
-        @server = TCPServer.new 3466
+        @server = TCPServer.new @port
         @instance.io.should be_a TCPSocket
         @server.close
       end
@@ -27,7 +27,7 @@ module Dino
       end
 
       it 'should use the existing io instance if set' do
-        @server = TCPServer.new 3466
+        @server = TCPServer.new @port
         socket = @instance.io
         @instance.io.should be socket
         @server.close

From e6e14eb5dbdb53c38d388efd90d6f71f7c2bd896 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 7 Jun 2013 15:08:16 -0400
Subject: [PATCH 018/296] Tested shift register support. Supports multiple
 registers via array of bytes.

---
 examples/shift_register.rb                 | 17 +++++++
 lib/dino/components/shift_register.rb      | 14 +++--
 spec/lib/components/shift_register_spec.rb | 59 ++++++++++++++++++++++
 3 files changed, 86 insertions(+), 4 deletions(-)
 create mode 100644 examples/shift_register.rb
 create mode 100644 spec/lib/components/shift_register_spec.rb

diff --git a/examples/shift_register.rb b/examples/shift_register.rb
new file mode 100644
index 00000000..fe5945b6
--- /dev/null
+++ b/examples/shift_register.rb
@@ -0,0 +1,17 @@
+#
+# This is a simple example to write to a shift register.
+# Writing a byte of 255 sets all the output pins to high.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+shift_register = Dino::Components::ShiftRegister.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+
+# Write a single byte
+shift_register.write(255)
+
+# Write an array of bytes (for multiple registers).
+shift_register.write([255, 0])
+
+sleep
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index 4c04c08c..dddacbf2 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -7,9 +7,9 @@ def after_initialize(options={})
         raise 'missing pins[:clock] pin' unless self.pins[:clock]
         raise 'missing pins[:data] pin' unless self.pins[:data]
 
-        pins.each do |pin|
+        pins.each_value do |pin|
           set_pin_mode(pin, :out)
-          analog_write(pin, Board::LOW)
+          digital_write(pin, Board::LOW)
         end
       end
 
@@ -21,9 +21,15 @@ def latch_on
         digital_write(pins[:latch], Board::HIGH)
       end
 
-      def write(byte)
+      def write(bytes)
+        bytes = [bytes] unless bytes.class == Array
+        data_pin = board.convert_pin(pins[:data])
+        clock_pin = board.convert_pin(pins[:clock])
+
         latch_off
-        board.write(Dino::Message.encode command: 11, pin: convert_pin(pins[:data]), value: byte, aux_message: convert_pin(pins[:clock])})
+        bytes.each do |byte|
+          board.write Dino::Message.encode( command: 11, pin: data_pin, value: byte, aux_message: clock_pin)
+        end
         latch_on
       end
     end
diff --git a/spec/lib/components/shift_register_spec.rb b/spec/lib/components/shift_register_spec.rb
new file mode 100644
index 00000000..fc7a9202
--- /dev/null
+++ b/spec/lib/components/shift_register_spec.rb
@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe ShiftRegister do
+      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
+
+      subject { ShiftRegister.new board: board, pins: {clock: 12, data: 11, latch: 8} }
+
+      describe '#initialize' do
+        it 'should set all pins to out and low' do
+          board.should_receive(:set_pin_mode).with(12, :out, nil)
+          board.should_receive(:set_pin_mode).with(11, :out, nil)
+          board.should_receive(:set_pin_mode).with(8,  :out, nil)
+          board.should_receive(:digital_write).with(12, Board::LOW)
+          board.should_receive(:digital_write).with(11, Board::LOW)
+          board.should_receive(:digital_write).with(8,  Board::LOW)
+
+          ShiftRegister.new(pins: {clock: 12, data: 11, latch: 8}, board: board)
+        end
+      end
+
+      describe '#latch_off' do
+        it 'should set the latch pin low' do
+          board.should_receive(:digital_write).with(8, Board::LOW)
+
+          subject.latch_off
+        end
+      end
+
+      describe '#latch_off' do
+        it 'should set the latch pin high' do
+          board.should_receive(:digital_write).with(8, Board::HIGH)
+
+          subject.latch_on
+        end
+      end
+
+      describe '#write' do
+        it 'should write a single byte as value and clock pin as aux to the data pin' do
+          board.should_receive(:convert_pin).with(11) { |pin| pin }
+          board.should_receive(:convert_pin).with(12) { |pin| pin }
+          board.should_receive(:write).with "11.11.255.12\n"
+
+          subject.write(255)
+        end
+
+        it 'should write an array of bytes as value and clock pin as aux to the data pin' do
+          board.should_receive(:convert_pin).with(11) { |pin| pin }
+          board.should_receive(:convert_pin).with(12) { |pin| pin }
+          board.should_receive(:write).with "11.11.255.12\n"
+          board.should_receive(:write).with "11.11.0.12\n"
+
+          subject.write([255,0])
+        end
+      end
+    end
+  end
+end

From 6a5875e960ca445f6bd1aa2aba4b18b44e8cab61 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 7 Jun 2013 17:30:19 -0400
Subject: [PATCH 019/296] Remove some accidentally committed benchmarks.

---
 examples/bench.rb     | 110 ------------------------------------------
 examples/benchmark.rb |  69 --------------------------
 2 files changed, 179 deletions(-)
 delete mode 100644 examples/bench.rb
 delete mode 100644 examples/benchmark.rb

diff --git a/examples/bench.rb b/examples/bench.rb
deleted file mode 100644
index 14cf0d93..00000000
--- a/examples/bench.rb
+++ /dev/null
@@ -1,110 +0,0 @@
-#
-# This is a simple example to blink an led
-# every half a second
-#
-
-require File.expand_path('../../lib/dino', __FILE__)
-
-board = Dino::Board.new(Dino::TxRx::Serial.new)
-
-# Keep a led blinking.
-led = Dino::Components::Led.new(pin: '13', board: board)
-led_thread = Thread.new do
-  [:on, :off].cycle do |switch|
-    led.send(switch)
-    sleep 0.5
-  end
-end
-
-# Keep a servo moving.
-servo = Dino::Components::Servo.new(pin: 9, board: board)
-servo_thread = Thread.new do
-  [0, 90].cycle do |pos|
-    servo.position = pos
-    sleep 0.3
-  end
-end
-
-# Keep a servo moving.
-servo2 = Dino::Components::Servo.new(pin: 10, board: board)
-servo_thread2 = Thread.new do
-  [0, 90].cycle do |pos|
-    servo2.position = pos
-    sleep 0.5
-  end
-end
-
-# Keep a servo moving.
-servo3 = Dino::Components::Servo.new(pin: 11, board: board)
-servo_thread3 = Thread.new do
-  [0, 90].cycle do |pos|
-    servo3.position = pos
-    sleep 0.5
-  end
-end
-
-
-
-$counter_analog = 0
-counter_digital = 0
-test_time = 5
-
-puts "Starting tests..."
-
-# Ranges of digital and analog pin numbers to read.
-digital_range = 2..5
-analog_range = 0..5
-
-digital_range.each do |digital_max|
-  analog_range.each do |analog_max|
-
-    # Define ranges for this test test.
-    digital_test_range = digital_range.min..digital_max
-    analog_test_range = analog_range.min..analog_max
-
-    # Setup hardware
-    analog_test_range.each do |pin|
-      eval "$sensor#{pin} = Dino::Components::Sensor.new(pin: 'A#{pin}', board: board)"
-      eval "$sensor#{pin}.when_data_received { $counter_analog = $counter_analog + 1 }"
-    end
-    digital_test_range.each do |pin|
-      eval "$digital#{pin} = Dino::Components::Button.new(pin: '#{pin}', board: board, pullup: true)"
-      eval "$digital#{pin}.up   { counter_digital = counter_digital + 1 }"
-      eval "$digital#{pin}.down { counter_digital = counter_digital + 1 }"
-    end
-
-    # Pre-test measurement
-    state1_digital = counter_digital
-    state1_analog = $counter_analog
-
-    # Wait
-    sleep test_time
-
-    # Post-test measurement
-    state2_digital = counter_digital
-    state2_analog = $counter_analog
-
-    # Calculation
-    diff_digital = state2_digital - state1_digital
-    diff_analog = state2_analog - state1_analog
-
-    # Print
-    print "#{digital_test_range.count}D/#{analog_test_range.count}A Components: "
-    print "#{diff_digital/(test_time * digital_test_range.count)}Hz"
-    print "/"
-    print "#{diff_analog/(test_time * analog_test_range.count)}Hz per component | "
-    puts  "#{(diff_digital + diff_analog)/(test_time)} responses/s overall"
-
-    # Remove hardware
-    analog_test_range.each do |pin|
-      board.remove_analog_hardware(eval "$sensor#{pin}")
-    end
-    digital_test_range.each do |pin|
-      board.remove_digital_hardware(eval "$digital#{pin}")
-    end
-  end
-end
-
-servo_thread.kill
-led_thread.kill
-
diff --git a/examples/benchmark.rb b/examples/benchmark.rb
deleted file mode 100644
index fb6e7313..00000000
--- a/examples/benchmark.rb
+++ /dev/null
@@ -1,69 +0,0 @@
-#
-# This is a simple example to blink an led
-# every half a second
-#
-
-require File.expand_path('../../lib/dino', __FILE__)
-txrx = Dino::TxRx.new
-# txrx = Dino::TxRx::TCP.new("192.168.0.77")
-# txrx = Dino::TxRx::TCP.new("192.168.0.143", 3001) # ; txrx.io; sleep 5
-board = Dino::Board.new(txrx)
-
-txrx.write("!9800003.")
-
-# Warm up
-sleep 2
-
-counter_analog = 0
-counter_digital = 0
-count_analog_responses = Proc.new { counter_analog = counter_analog + 1 }
-test_time = 4
-
-puts "Starting tests..."
-
-(5..9).each do |digital_count|
-  (0..5).each do |analog_count|
-
-    # Setup hardware
-    (0..analog_count).each do |pin|
-      eval "$sensor#{pin} = Dino::Components::Sensor.new(pin: 'A#{pin}', board: board)"
-      eval "$sensor#{pin}.when_data_received(count_analog_responses)"
-    end
-    (5..digital_count).each do |pin|
-      eval "$digital#{pin} = Dino::Components::Button.new(pin: '#{pin}', board: board, pullup: true)"
-      eval "$digital#{pin}.up   { counter_digital = counter_digital + 1 }"
-      eval "$digital#{pin}.down { counter_digital = counter_digital + 1 }"
-    end
-    
-    # Pre-test measurement
-    state1_digital = counter_digital
-    state1_analog = counter_analog
-
-    # Wait
-    sleep test_time
-
-    # Post-test measurement
-    state2_digital = counter_digital
-    state2_analog = counter_analog
-
-    # Calculation
-    diff_digital = state2_digital - state1_digital
-    diff_analog = state2_analog - state1_analog
-
-    # Print
-    print "#{digital_count -4}D/#{analog_count + 1}A Components: "
-    print  "#{diff_digital/(test_time * (digital_count - 4))}Hz"
-    print "/"
-    print  "#{diff_analog/(test_time * (analog_count + 1))}Hz per component | "
-    puts  "#{(diff_digital + diff_analog)/(test_time)} responses/s overall"
-
-    # Remove hardware
-    (0..analog_count).each do |pin|
-      board.remove_analog_hardware(eval "$sensor#{pin}")
-    end
-    (5..digital_count).each do |pin|
-      board.remove_digital_hardware(eval "$digital#{pin}")
-    end
-  end
-end
-

From 1e2f4fc068db6549218569f93f560ca36bc60275 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sat, 8 Jun 2013 23:59:23 -0400
Subject: [PATCH 020/296] Set the heart rate in microseconds

---
 lib/dino/board.rb | 2 +-
 src/lib/Dino.cpp  | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 150a2cbc..2c140c4f 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -23,7 +23,7 @@ def analog_divider=(value)
     end
 
     def heart_rate=(value)
-      write Dino::Message.encode(command: 98, value: value)
+      write Dino::Message.encode(command: 98, aux_message: value)
     end
 
     def start_read
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 14cb016a..a61b579a 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -302,8 +302,7 @@ void Dino::setAnalogDivider() {
 // CMD = 98
 // Set the heart rate in milliseconds. Store it in microseconds.
 void Dino::setHeartRate() {
-  int rate = val;
-  heartRate = (rate * 1000);
+  heartRate = atoi(auxMsg);
   #ifdef debug
     Serial.print("Heart rate set to "); Serial.print(heartRate); Serial.println(" microseconds");
   #endif

From b782ff149d41a47343fb8e5305a401e0bbf05206 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sun, 9 Jun 2013 03:29:47 -0400
Subject: [PATCH 021/296] CLI update: Ruby module, UNIX-ey output, auto-upload
 on Macs

---
 bin/dino                                      | 135 ++----------------
 lib/dino/board.rb                             |   2 +-
 lib/dino/tx_rx.rb                             |   2 +-
 lib/dino/version.rb                           |   2 +-
 lib/dino_cli.rb                               |  21 +++
 lib/dino_cli/generator.rb                     |  82 +++++++++++
 lib/dino_cli/helper.rb                        |  42 ++++++
 lib/dino_cli/parser.rb                        |  60 ++++++++
 lib/dino_cli/uploader.rb                      |  19 +++
 .../du_ethernet.ino => dino_ethernet.ino}     |   0
 src/{du/du.ino => dino_serial.ino}            |   0
 src/{du_wifi/du_wifi.ino => dino_wifi.ino}    |   0
 12 files changed, 239 insertions(+), 126 deletions(-)
 create mode 100644 lib/dino_cli.rb
 create mode 100644 lib/dino_cli/generator.rb
 create mode 100644 lib/dino_cli/helper.rb
 create mode 100644 lib/dino_cli/parser.rb
 create mode 100644 lib/dino_cli/uploader.rb
 rename src/{du_ethernet/du_ethernet.ino => dino_ethernet.ino} (100%)
 rename src/{du/du.ino => dino_serial.ino} (100%)
 rename src/{du_wifi/du_wifi.ino => dino_wifi.ino} (100%)

diff --git a/bin/dino b/bin/dino
index 381c9bcf..63d5b20d 100755
--- a/bin/dino
+++ b/bin/dino
@@ -1,128 +1,17 @@
 #!/usr/bin/env ruby
-require "pathname"
-require "fileutils"
-
-SERIAL   = "du"
-ETHERNET = "du_ethernet"
-WIFI     = "du_wifi"
-
-$options = {}
-$options[:sketch_names] = []
-
-def error(message)
-  $stderr.puts "Error: " + message
-  usage
-end
-
-def usage
-  $stderr.puts "Usage: #{File.basename($0)} COMMAND [command-specific-options]"
-  $stderr.puts
-  $stderr.puts "Commands:"
-  $stderr.puts "  generate-sketch SKETCH [options]"
-  $stderr.puts
-  $stderr.puts "    Available sketches and options:"
-  $stderr.puts
-  $stderr.puts "      serial"
-  $stderr.puts "        --baud BAUD"
-  $stderr.puts "        --debug"
-  $stderr.puts
-  $stderr.puts "      ethernet"
-  $stderr.puts "        --mac XX:XX:XX:XX:XX:XX"
-  $stderr.puts "        --ip XXX.XXX.XXX.XXX"
-  $stderr.puts "        --port PORT"
-  $stderr.puts "        --debug"
-  $stderr.puts
-  $stderr.puts "      wifi"
-  $stderr.puts "        --ssid SSID"
-  $stderr.puts "        --password PASSWORD"
-  $stderr.puts "        --port PORT"
-  $stderr.puts "        --debug"
-  $stderr.puts
-  exit(2)
-end
+# encoding: UTF-8
 
-# Command must be the first argument.
-$options[:command] = ARGV.shift
-usage if $options[:command].match /help|usage/ 
-
-# Parse the rest loosely.
-loop do
-  case ARGV[0]
-    when 'serial'
-      ARGV.shift; $options[:sketch_names] << SERIAL unless $options[:sketch_names].include? SERIAL
-    when 'ethernet'
-      ARGV.shift; $options[:sketch_names] << ETHERNET unless $options[:sketch_names].include? ETHERNET
-    when 'wifi'
-      ARGV.shift; $options[:sketch_names] << WIFI unless $options[:sketch_names].include? WIFI
-    when '--baud'
-      ARGV.shift; $options[:baud] = ARGV.shift
-    when '--mac'
-      ARGV.shift; $options[:mac] = ARGV.shift
-    when '--ip'
-      ARGV.shift; $options[:ip] = ARGV.shift
-    when '--ssid'
-      ARGV.shift; $options[:ssid] = ARGV.shift
-    when '--password'
-      ARGV.shift; $options[:password] = ARGV.shift
-    when '--port'
-      ARGV.shift; $options[:port] = ARGV.shift
-    when '--debug'
-      ARGV.shift; $options[:debug] = true
-    when /^-/
-      error "Invalid argument '#{ARGV[0]}'"
-    else break
-  end
-end
-
-error "Invalid command '#{$options[:command]}'" unless $options[:command] == "generate-sketch"
-error "No sketches or invalid sketches specified" if $options[:sketch_names].empty?
-
-$options[:sketch_names].each do |sketch_name|
-  # Define the sources.
-  src_dir = Pathname.new(__FILE__).realpath.to_s.chomp("/bin/dino") + "/src"
-  sketch_dir = sketch_name
-  sketch_filename = sketch_name + ".ino"
-  lib_filenames = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp"]
-
-  # Read the files.
-  libs = lib_filenames.map { |f| File.read(File.join(src_dir, "lib", f)) }
-  sketch = File.read(File.join(src_dir, sketch_dir, sketch_filename))
+# Find myself
+require "pathname"
+bin_file = Pathname.new(__FILE__).realpath
 
-  # Modify them based on the arguments.
-  if $options[:baud] && sketch_name == SERIAL
-    sketch.gsub! "115200", $options[:baud]
-  end
-  if $options[:mac] && sketch_name == ETHERNET
-    octets = $options[:mac].split(':')
-    bytes = octets.map { |o| "0x#{o.upcase}" }
-    sketch.gsub! "{ 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 }", bytes.inspect.gsub("[", "{").gsub("]", "}").gsub("\"", "")
-  end
-  if $options[:ip] && sketch_name == ETHERNET
-    sketch.gsub! "192,168,0,77", $options[:ip].gsub(".", ",")
-  end
-  if $options[:ssid] && sketch_name == WIFI
-    sketch.gsub! "yourNetwork", $options[:ssid]
-  end
-  if $options[:password] && sketch_name == WIFI
-    sketch.gsub! "yourPassword", $options[:password]
-  end
-  if $options[:port]
-    sketch.gsub! "int port = 3466", "int port = #{$options[:port]}"
-  end
-  if $options[:debug]
-    libs[0].gsub! "// #define debug true", "#define debug true"
-  end
+# Make sure dino is in the load path
+$:.unshift File.expand_path("../../lib", bin_file)
 
-  # Define the destinations.
-  working_dir = Dir.pwd
-  dest_dir = File.join working_dir, sketch_dir
-  Dir::mkdir dest_dir
-  dest_sketch = File.join(dest_dir, sketch_filename)
-  dest_libs = lib_filenames.map { |f| File.join(dest_dir, f)}
+# Work out paths for the CLI
+working_dir = Dir.pwd
+src_dir = bin_file.to_s.chomp("/bin/dino") + "/src"
 
-  # Write the files.
-  File.open(dest_sketch, 'w') { |f| f.write sketch }
-  dest_libs.each_with_index do |file, index|
-    File.open(file, 'w') { |f| f.write libs[index]}
-  end
-end
\ No newline at end of file
+# Start the CLI
+require "dino_cli"
+DinoCLI.start(working_dir: working_dir, src_dir: src_dir, args: ARGV)
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 2c140c4f..94723fb0 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -99,4 +99,4 @@ def convert_pin(pin)
       pin.to_s.match(/\Aa/i) ? @analog_zero + pin.to_s.gsub(/\Aa/i, '').to_i : pin.to_i
     end
   end
-end
\ No newline at end of file
+end
diff --git a/lib/dino/tx_rx.rb b/lib/dino/tx_rx.rb
index 89c9d82f..d0399eae 100644
--- a/lib/dino/tx_rx.rb
+++ b/lib/dino/tx_rx.rb
@@ -8,4 +8,4 @@ def self.new(options={})
       self::Serial.new(options)
     end
   end
-end
\ No newline at end of file
+end
diff --git a/lib/dino/version.rb b/lib/dino/version.rb
index 53a79fa4..304dd5e5 100644
--- a/lib/dino/version.rb
+++ b/lib/dino/version.rb
@@ -1,3 +1,3 @@
 module Dino
-  VERSION = "0.11.2"
+  VERSION = "0.12.0"
 end
diff --git a/lib/dino_cli.rb b/lib/dino_cli.rb
new file mode 100644
index 00000000..c3d432dc
--- /dev/null
+++ b/lib/dino_cli.rb
@@ -0,0 +1,21 @@
+module DinoCLI
+	require "dino_cli/parser"
+	require "dino_cli/generator"
+	require "dino_cli/uploader"
+
+	COMMANDS = ["generate-sketch"]
+	SKETCHES = ["serial", "ethernet", "wifi"]
+	
+	def self.start(options={})
+		parsed_options = DinoCLI::Parser.run(options)
+
+		method = parsed_options[:command].gsub('-', '_').to_s
+		self.send method, options
+	end
+
+	def self.generate_sketch(options)
+		sketch_file = DinoCLI::Generator.run!(options)
+
+		options[:upload] ? DinoCLI::Uploader.run!(file: sketch_file) : $stdout.puts(sketch_file)
+	end
+end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
new file mode 100644
index 00000000..4f0d9742
--- /dev/null
+++ b/lib/dino_cli/generator.rb
@@ -0,0 +1,82 @@
+class DinoCLI::Generator
+  require "fileutils"
+  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp"]
+  attr_reader :options
+
+  def initialize(options={})
+    @options = options
+  end
+
+  def self.run!(options={})
+    instance = self.new(options)
+
+    instance.read
+    instance.modify
+    instance.write
+  end
+
+  def read
+    @libs = LIB_FILENAMES.map do |f| 
+      File.read(File.join(options[:src_dir], "lib", f))
+    end
+    @sketch = File.read File.join(options[:src_dir], sketch_filename)
+  end
+
+  def modify
+    if options[:baud] && serial?
+      @sketch.gsub! "115200", options[:baud]
+    end
+    if options[:mac] && ethernet?
+      octets = @options[:mac].split(':')
+      bytes = octets.map { |o| "0x#{o.upcase}" }
+      @sketch.gsub! "{ 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 }", bytes.inspect.gsub("[", "{").gsub("]", "}").gsub("\"", "")
+    end
+    if options[:ip] && ethernet?
+      @sketch.gsub! "192,168,0,77", options[:ip].gsub(".", ",")
+    end
+    if options[:ssid] && wifi?
+      @sketch.gsub! "yourNetwork", options[:ssid]
+    end
+    if options[:password] && wifi?
+      @sketch.gsub! "yourPassword", options[:password]
+    end
+    if options[:port]
+      @sketch.gsub! "int port = 3466", "int port = #{options[:port]}"
+    end
+    if options[:debug]
+      @libs[0].gsub! "// #define debug true", "#define debug true"
+    end
+  end
+
+  def write
+    sketch = File.join(output_dir, sketch_filename)
+    File.open(sketch, 'w') { |f| f.write @sketch }
+
+    libs = LIB_FILENAMES.map { |f| File.join(output_dir, f)}
+    libs.each_with_index do |file, index|
+      File.open(file, 'w') { |f| f.write @libs[index]}
+    end
+
+    sketch
+  end
+
+  def output_dir
+    @output_dir ||= make_output_dir
+  end
+
+  def make_output_dir
+    dir = File.join options[:working_dir], options[:sketch_name]
+    Dir::mkdir(dir) unless File.directory?(dir)
+    dir
+  end
+
+  %w(serial ethernet wifi).each do |sketch|
+    define_method("#{sketch}?") do
+      options[:sketch_name].match /#{sketch}/
+    end
+  end
+
+  def sketch_filename
+    "#{options[:sketch_name]}.ino"
+  end
+end
diff --git a/lib/dino_cli/helper.rb b/lib/dino_cli/helper.rb
new file mode 100644
index 00000000..fece1920
--- /dev/null
+++ b/lib/dino_cli/helper.rb
@@ -0,0 +1,42 @@
+module DinoCLI::Helper
+  def error(message)
+    $stderr.puts
+    $stderr.puts "Error: #{message}"
+    $stderr.puts
+    usage
+  end
+
+  def usage
+    $stderr.puts "Usage:"
+    $stderr.puts "  dino COMMAND [command-specific-options]"
+    $stderr.puts
+    $stderr.puts "Commands:"
+    $stderr.puts "  generate-sketch SKETCH [options]"
+    $stderr.puts
+    $stderr.puts "    Available sketches and options:"
+    $stderr.puts
+    $stderr.puts "      serial"
+    $stderr.puts "        --baud BAUD"
+    $stderr.puts "        --debug"
+    $stderr.puts "        --upload"
+    $stderr.puts
+    $stderr.puts "      ethernet"
+    $stderr.puts "        --mac XX:XX:XX:XX:XX:XX"
+    $stderr.puts "        --ip XXX.XXX.XXX.XXX"
+    $stderr.puts "        --port PORT"
+    $stderr.puts "        --debug"
+    $stderr.puts "        --upload"
+    $stderr.puts
+    $stderr.puts "      wifi"
+    $stderr.puts "        --ssid SSID"
+    $stderr.puts "        --password PASSWORD"
+    $stderr.puts "        --port PORT"
+    $stderr.puts "        --debug"
+    $stderr.puts "        --upload"
+    $stderr.puts
+    $stderr.puts "Note: Automatic upload requires Arduino IDE 1.5 or greater."
+    $stderr.puts "      Set your board type and serialport in the IDE first."
+    $stderr.puts
+    exit(2)
+  end
+end
diff --git a/lib/dino_cli/parser.rb b/lib/dino_cli/parser.rb
new file mode 100644
index 00000000..1af902a7
--- /dev/null
+++ b/lib/dino_cli/parser.rb
@@ -0,0 +1,60 @@
+class DinoCLI::Parser
+  require 'dino_cli/helper'
+  include DinoCLI::Helper
+
+  def initialize(options={})
+    @options = options
+  end
+
+  def self.run(options={})
+    self.new(options).parse
+  end
+
+  def parse
+    args = @options[:args].dup
+
+    # Command must be the first arg.
+    @options[:command] = args.shift
+    usage if @options[:command].match /help|usage/
+    error "Invalid command '#{@options[:command]}'"  unless DinoCLI::COMMANDS.include? @options[:command]
+
+    # Parse the rest loosely.
+    loop do
+      case args[0]
+        when 'serial'
+          args.shift; set_sketch("serial")
+        when 'ethernet'
+          args.shift; set_sketch("ethernet")
+        when 'wifi'
+          args.shift; set_sketch("wifi")
+        when '--baud'
+          args.shift; @options[:baud] = args.shift
+        when '--mac'
+          args.shift; @options[:mac] = args.shift
+        when '--ip'
+          args.shift; @options[:ip] = args.shift
+        when '--ssid'
+          args.shift; @options[:ssid] = args.shift
+        when '--password'
+          args.shift; @options[:password] = args.shift
+        when '--port'
+          args.shift; @options[:port] = args.shift
+        when '--debug'
+          args.shift; @options[:debug] = true
+        when '--upload'
+          args.shift; @options[:upload] = true
+        when /^-/
+          error "Invalid argument '#{ARGV[0]}'"
+        else break
+      end
+    end
+    error "No valid sketch specified" if @options[:sketch_name].nil?
+
+    @options
+  end
+
+  def set_sketch(name)
+    error "More than one sketch specified" unless @options[:sketch_name].nil?
+    @options[:sketch_name] = "dino_#{name}"
+  end
+end
diff --git a/lib/dino_cli/uploader.rb b/lib/dino_cli/uploader.rb
new file mode 100644
index 00000000..cd92df43
--- /dev/null
+++ b/lib/dino_cli/uploader.rb
@@ -0,0 +1,19 @@
+class DinoCLI::Uploader
+  attr_reader :options
+
+  def initialize(options={})
+    @options = options
+  end
+
+  def self.run!(options={})
+    instance = self.new(options)
+
+    instance.upload
+  end
+
+  def upload
+    if RUBY_PLATFORM.match /darwin/i
+      system("/Applications/Arduino.app/Contents/MacOS/JavaApplicationStub --upload '#{options[:file]}'")
+    end
+  end
+end
diff --git a/src/du_ethernet/du_ethernet.ino b/src/dino_ethernet.ino
similarity index 100%
rename from src/du_ethernet/du_ethernet.ino
rename to src/dino_ethernet.ino
diff --git a/src/du/du.ino b/src/dino_serial.ino
similarity index 100%
rename from src/du/du.ino
rename to src/dino_serial.ino
diff --git a/src/du_wifi/du_wifi.ino b/src/dino_wifi.ino
similarity index 100%
rename from src/du_wifi/du_wifi.ino
rename to src/dino_wifi.ino

From d73ae9918983ba2e6c222c84f5e8424d345a1345 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sun, 9 Jun 2013 15:01:57 -0400
Subject: [PATCH 022/296] Add CLI option to compile to .hex file

---
 lib/dino_cli.rb           | 36 ++++++++++++++++++++----------------
 lib/dino_cli/generator.rb |  9 +++++----
 lib/dino_cli/parser.rb    |  2 ++
 lib/dino_cli/uploader.rb  | 26 ++++++++++++++++++++++----
 4 files changed, 49 insertions(+), 24 deletions(-)

diff --git a/lib/dino_cli.rb b/lib/dino_cli.rb
index c3d432dc..bffe309e 100644
--- a/lib/dino_cli.rb
+++ b/lib/dino_cli.rb
@@ -1,21 +1,25 @@
 module DinoCLI
-	require "dino_cli/parser"
-	require "dino_cli/generator"
-	require "dino_cli/uploader"
+  require "dino_cli/parser"
+  require "dino_cli/generator"
+  require "dino_cli/uploader"
 
-	COMMANDS = ["generate-sketch"]
-	SKETCHES = ["serial", "ethernet", "wifi"]
-	
-	def self.start(options={})
-		parsed_options = DinoCLI::Parser.run(options)
+  COMMANDS = ["generate-sketch"]
+  SKETCHES = ["serial", "ethernet", "wifi"]
+  
+  def self.start(options={})
+    parsed_options = DinoCLI::Parser.run(options)
 
-		method = parsed_options[:command].gsub('-', '_').to_s
-		self.send method, options
-	end
+    method = parsed_options[:command].gsub('-', '_').to_s
+    self.send method, options
+  end
 
-	def self.generate_sketch(options)
-		sketch_file = DinoCLI::Generator.run!(options)
-
-		options[:upload] ? DinoCLI::Uploader.run!(file: sketch_file) : $stdout.puts(sketch_file)
-	end
+  def self.generate_sketch(options)
+    options = DinoCLI::Generator.run!(options)
+    
+    if options[:upload] || options[:compile]
+      DinoCLI::Uploader.run!(options)
+    else
+      $stdout.puts options[:sketch_file]
+    end
+  end
 end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 4f0d9742..fab3e36d 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,7 +1,7 @@
 class DinoCLI::Generator
   require "fileutils"
   LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp"]
-  attr_reader :options
+  attr_accessor :options
 
   def initialize(options={})
     @options = options
@@ -57,11 +57,12 @@ def write
       File.open(file, 'w') { |f| f.write @libs[index]}
     end
 
-    sketch
+    options[:sketch_file] = sketch
+    options
   end
 
   def output_dir
-    @output_dir ||= make_output_dir
+    options[:output_dir] ||= make_output_dir
   end
 
   def make_output_dir
@@ -77,6 +78,6 @@ def make_output_dir
   end
 
   def sketch_filename
-    "#{options[:sketch_name]}.ino"
+    options[:sketch_filename] ||= "#{options[:sketch_name]}.ino"
   end
 end
diff --git a/lib/dino_cli/parser.rb b/lib/dino_cli/parser.rb
index 1af902a7..87c76236 100644
--- a/lib/dino_cli/parser.rb
+++ b/lib/dino_cli/parser.rb
@@ -41,6 +41,8 @@ def parse
           args.shift; @options[:port] = args.shift
         when '--debug'
           args.shift; @options[:debug] = true
+        when '--compile'
+          args.shift; @options[:compile] = true
         when '--upload'
           args.shift; @options[:upload] = true
         when /^-/
diff --git a/lib/dino_cli/uploader.rb b/lib/dino_cli/uploader.rb
index cd92df43..d7d4327b 100644
--- a/lib/dino_cli/uploader.rb
+++ b/lib/dino_cli/uploader.rb
@@ -1,4 +1,6 @@
 class DinoCLI::Uploader
+  require "pathname"
+  require "fileutils"
   attr_reader :options
 
   def initialize(options={})
@@ -8,12 +10,28 @@ def initialize(options={})
   def self.run!(options={})
     instance = self.new(options)
 
-    instance.upload
+    if options[:upload]
+      instance.upload
+    elsif options[:compile]
+      instance.compile
+    end
+  end
+
+  def compile
+    output = `#{executable} --verify --verbose '#{options[:sketch_file]}'`
+
+    tmp_hex_file = output.match(/elf.*.hex/)[0].gsub("elf", "").lstrip
+    FileUtils::copy(tmp_hex_file, options[:output_dir])
+
+    hex_file = File.join(options[:output_dir], Pathname.new(tmp_hex_file).basename)
+    $stdout.puts hex_file
   end
 
   def upload
-    if RUBY_PLATFORM.match /darwin/i
-      system("/Applications/Arduino.app/Contents/MacOS/JavaApplicationStub --upload '#{options[:file]}'")
-    end
+    `#{executable} --upload '#{options[:sketch_file]}'"`
+  end
+
+  def executable
+    return "/Applications/Arduino.app/Contents/MacOS/JavaApplicationStub" if RUBY_PLATFORM.match(/darwin/i)
   end
 end

From 9cd72bc54ac9976ff485af7bf3bd4b5f960256f2 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 10 Jun 2013 22:11:16 -0400
Subject: [PATCH 023/296] Improved Sensor class: Keyed callbacks Use either
 listeners or instantaneous reading Better example at
 examples/sensor/sensor.rb

---
 examples/sensor/sensor.rb          | 33 ++++++++++--
 lib/dino/board.rb                  | 30 +++--------
 lib/dino/components/button.rb      |  5 +-
 lib/dino/components/sensor.rb      | 40 +++++++++++---
 lib/dino/message.rb                |  2 +-
 spec/lib/board_spec.rb             | 84 +++++++-----------------------
 spec/lib/components/button_spec.rb | 10 ++--
 spec/lib/components/sensor_spec.rb | 68 +++++++++++++++++-------
 8 files changed, 145 insertions(+), 127 deletions(-)

diff --git a/examples/sensor/sensor.rb b/examples/sensor/sensor.rb
index af2e88b4..768cfd11 100644
--- a/examples/sensor/sensor.rb
+++ b/examples/sensor/sensor.rb
@@ -8,10 +8,35 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
+board.analog_divider = 128
 sensor = Dino::Components::Sensor.new(pin: 'A0', board: board)
 
-sensor.when_data_received do |data|
-  puts data
-end
+# Single read with block as callback. Fires only once.
+sensor.read { |value| puts "Single read value: #{value}" }; sleep 1
 
-sleep
+# Continuous listen with block as callback. Fires every time data is received until #stop_listening is called.
+sensor.listen { |value| puts "Listening. Read value: #{value}" }; sleep 5
+
+# Stop listening. Automatically removes the callback from the #listen block.
+sensor.stop_listening; sleep 1
+
+# Add a persistent callback.
+sensor.on_data { |value| puts "Persistent callback: #{value}" }
+
+# Add a keyed callback.
+sensor.on_data(:test) { |value| puts "Keyed callback: #{value}"}
+
+# Single read. All callbacks fire, block given fires only once.
+sensor.read { |value| puts "#read block. Value: #{value}" }; sleep 1
+
+# Continuous listen. All callbacks added with #on_data continue to fire, plus the block.
+sensor.listen { |value| puts "#listen block. Value: #{value}" }; sleep 5
+
+# Stop listening. Automatically removes the callback from the #listen block.
+sensor.stop_listening
+
+# Remove callbacks keyed with :test.
+sensor.clear_callbacks(:test)
+
+# Remove all callbacks.
+sensor.clear_callbacks
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 94723fb0..be83cb05 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -1,16 +1,12 @@
 module Dino
   class Board
-    attr_reader :digital_hardware, :analog_hardware, :analog_zero
+    attr_reader :input_hardware, :analog_zero
     LOW, HIGH = 000, 255
     DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
     def initialize(io)
-      @io, @digital_hardware, @analog_hardware = io, [], []
+      @io, @input_hardware = io, []
       io.add_observer(self)
-      handshake
-    end
-
-    def handshake
       @analog_zero = @io.handshake
     end
 
@@ -39,31 +35,19 @@ def write(msg)
     end
 
     def update(pin, msg)
-      (@digital_hardware + @analog_hardware).each do |part|
+      @input_hardware.each do |part|
         part.update(msg) if convert_pin(pin) == convert_pin(part.pin)
       end
     end
 
-    def add_digital_hardware(part)
-      set_pin_mode(part.pin, :in, part.pullup)
-      digital_listen(part.pin)
-      @digital_hardware << part
-    end
-
-    def remove_digital_hardware(part)
-      stop_listener(part.pin)
-      @digital_hardware.delete(part)
-    end
-
-    def add_analog_hardware(part)
+    def add_input_hardware(part)
+      @input_hardware << part
       set_pin_mode(part.pin, :in, part.pullup)
-      analog_listen(part.pin)
-      @analog_hardware << part
     end
 
-    def remove_analog_hardware(part)
+    def remove_input_hardware(part)
       stop_listener(part.pin)
-      @analog_hardware.delete(part)
+      @input_hardware.delete(part)
     end
 
     def set_pin_mode(pin, mode, pullup=nil)
diff --git a/lib/dino/components/button.rb b/lib/dino/components/button.rb
index fdcbc06d..9df42225 100644
--- a/lib/dino/components/button.rb
+++ b/lib/dino/components/button.rb
@@ -7,8 +7,9 @@ class Button < BaseComponent
       def after_initialize(options={})
         @down_callbacks, @up_callbacks, @state = [], [], UP
 
-        self.board.add_digital_hardware(self)
-        self.board.start_read
+        board.add_input_hardware(self)
+        board.start_read
+        board.digital_listen(self.pin)
       end
 
       def down(&callback)
diff --git a/lib/dino/components/sensor.rb b/lib/dino/components/sensor.rb
index 485f389d..7dffc0ac 100644
--- a/lib/dino/components/sensor.rb
+++ b/lib/dino/components/sensor.rb
@@ -2,19 +2,45 @@ module Dino
   module Components
     class Sensor < BaseComponent
       def after_initialize(options={})
-        @data_callbacks = []
-        @board.add_analog_hardware(self)
-        @board.start_read
+        clear_callbacks
+        board.add_input_hardware(self)
+        board.start_read
       end
 
-      def when_data_received(&block)
-        @data_callbacks << block
+      def read(&block)
+        add_callback(:read, &block) if block_given?
+        board.analog_read(pin)
+      end
+
+      def listen(&block)
+        add_callback(:listen, &block) if block_given?
+        board.analog_listen(pin)
+      end
+
+      def stop_listening
+        board.stop_listener(pin)
+        clear_callbacks[:listen]
+      end
+
+      def add_callback(key=nil, &block)
+        key ||= :persistent
+        @callbacks[key] ||= []
+        @callbacks[key] << block
+      end
+
+      alias :on_data :add_callback
+
+      def clear_callbacks(key=nil)
+        key ? @callbacks[key] = nil : @callbacks = {}
       end
 
       def update(data)
-        @data_callbacks.each do |callback|
-          callback.call(data)
+        @callbacks.each_value do |array|
+          array.each do |callback|
+            callback.call(data)
+          end
         end
+        @callbacks[:read] = []
       end
     end
   end
diff --git a/lib/dino/message.rb b/lib/dino/message.rb
index c4e81be1..6dfa1930 100644
--- a/lib/dino/message.rb
+++ b/lib/dino/message.rb
@@ -7,7 +7,7 @@ def self.encode(options={})
       aux = options[:aux_message]
       aux.to_s.gsub!("\n", "\\\n") if aux
 
-      raise Exception.new('commands must be specified') unless cmd
+      raise Exception.new('command must be specified') unless cmd
       raise Exception.new('commands can only be four digits') if cmd.to_s.length > 4
       raise Exception.new('pins can only be four digits') if pin.to_s.length > 4
       raise Exception.new('values can only be four digits') if val.to_s.length > 4
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 923977a4..968885b8 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -27,32 +27,18 @@ def io_mock(methods = {})
     end
 
     describe '#update' do
-      context 'when the given pin connects to an analog hardware part' do
+      context 'when the given pin connects to input hardware part' do
         it 'should call update with the message on the part' do
           part = mock(:part, pin: 7, pullup: nil)
-          subject.add_analog_hardware(part)
+          subject.add_input_hardware(part)
           other_part = mock(:part, pin: 9, pullup: nil)
-          subject.add_analog_hardware(other_part)
+          subject.add_input_hardware(other_part)
 
           part.should_receive(:update).with('wake up!')
           subject.update(7, 'wake up!')
         end
       end
 
-      context 'when the given pin connects to an digital hardware part' do
-        it 'should call update with the message on the part' do
-          part = mock(:part, pin: 5, pullup: nil)
-          subject.add_digital_hardware(part)
-          other_part = mock(:part, pin: 11, pullup: nil)
-          subject.add_digital_hardware(other_part)
-
-          part.should_receive(:update).with('wake up!')
-          other_part.should_not_receive(:update).with('wake up!')
-
-          subject.update(5, 'wake up!')
-        end
-      end
-
       context 'when the given pin is not connected' do
         it 'should not do anything' do
           expect {
@@ -62,61 +48,34 @@ def io_mock(methods = {})
       end
     end
 
-    describe '#digital_hardware' do
-      it 'should initialize as empty' do
-        subject.digital_hardware.should == []
-      end
-    end
-
-    describe '#analog_hardware' do
+    describe '#input_hardware' do
       it 'should initialize as empty' do
-        subject.analog_hardware.should == []
+        subject.input_hardware.should == []
       end
     end
 
-    describe '#add_digital_hardware' do
+    describe '#add_input_hardware' do
       it 'should add digital hardware to the board' do
-        subject.add_digital_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
-        subject.add_digital_hardware(mock2 = mock(:part2, pin: 14, pullup: nil))
-        subject.digital_hardware.should =~ [mock1, mock2]
+        subject.add_input_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
+        subject.add_input_hardware(mock2 = mock(:part2, pin: 14, pullup: nil))
+        subject.input_hardware.should =~ [mock1, mock2]
       end
 
-      it 'should set the mode for the given pin to "in" and add a digital listener' do
+      it 'should set the mode for the given pin to "in"' do
         subject.should_receive(:set_pin_mode).with(12, :in, nil)
-        subject.should_receive(:digital_listen).with(12)
-        subject.add_digital_hardware(mock(:part1, pin: 12, pullup: nil))
+        subject.add_input_hardware(mock(:part1, pin: 12, pullup: nil))
       end
     end
 
-    describe '#remove_digital_hardware' do
-      it 'should remove the given part from the hardware of the board' do
+    describe '#remove_input_hardware' do
+      it 'should remove the given part from the hardware of the board and stop listening' do
         mock = mock(:part1, pin: 12, pullup: nil)
-        subject.add_digital_hardware(mock)
-        subject.remove_digital_hardware(mock)
-        subject.digital_hardware.should == []
-      end
-    end
-
-    describe '#add_analog_hardware' do
-      it 'should add analog hardware to the board' do
-        subject.add_analog_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
-        subject.add_analog_hardware(mock2 = mock(:part2, pin: 14, pullup: nil))
-        subject.analog_hardware.should =~ [mock1, mock2]
-      end
-
-      it 'should set the mode for the given pin to "in" and add an analog listener' do
-        subject.should_receive(:set_pin_mode).with(12, :in, nil)
-        subject.should_receive(:analog_listen).with(12)
-        subject.add_analog_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
-      end
-    end
+        subject.add_input_hardware(mock)
 
-    describe '#remove_analog_hardware' do
-      it 'should remove the given part from the hardware of the board' do
-        mock = mock(:part1, pin: 12, pullup: nil)
-        subject.add_analog_hardware(mock)
-        subject.remove_analog_hardware(mock)
-        subject.analog_hardware.should == []
+        subject.should_receive(:stop_listener).with(12)
+        subject.remove_input_hardware(mock)
+        
+        subject.input_hardware.should == []
       end
     end
 
@@ -225,13 +184,6 @@ def io_mock(methods = {})
       end
     end
 
-    describe '#handshake' do
-      it 'should tell the board to reset to defaults' do
-        io_mock.should_receive(:handshake)
-        subject.handshake
-      end
-    end
-
     describe '#convert_pin' do
       before(:each) { subject.instance_variable_set(:@analog_zero, 14) }
 
diff --git a/spec/lib/components/button_spec.rb b/spec/lib/components/button_spec.rb
index 052d7f7b..5eedfa05 100644
--- a/spec/lib/components/button_spec.rb
+++ b/spec/lib/components/button_spec.rb
@@ -16,16 +16,18 @@ module Components
           }.to raise_exception
         end
 
-        it 'should add itself to the board and start reading' do
+        it 'should add itself to the board, start read and digital listen' do
           board = mock(:board)
-          board.should_receive(:add_digital_hardware)
+          board.should_receive(:add_input_hardware)
           board.should_receive(:start_read)
-          Button.new(board: board, pin: 'a pin')
+          board.should_receive(:digital_listen).with(7)
+
+          Button.new(board: board, pin: 7)
         end
       end
 
       context 'callbacks' do
-        let(:board) { mock(:board, add_digital_hardware: true, start_read: true) }
+        let(:board) { mock(:board, add_input_hardware: true, start_read: true, digital_listen: true) }
         let(:button) {Button.new(board: board, pin: mock)}
         describe '#down' do
           it 'should add a callback to the down_callbacks array' do
diff --git a/spec/lib/components/sensor_spec.rb b/spec/lib/components/sensor_spec.rb
index 7767ab92..fb36fe1e 100644
--- a/spec/lib/components/sensor_spec.rb
+++ b/spec/lib/components/sensor_spec.rb
@@ -5,38 +5,66 @@ module Components
     describe Sensor do
 
       let(:board){mock(:board).as_null_object}
+      let(:sensor) {Sensor.new(board: board, pin: 7)}
 
       describe '#initalize' do
         it 'should raise if it does not receive a pin' do
-          expect {
-            Sensor.new(board: 'a board')
-          }.to raise_exception
+          expect { Sensor.new(board: board) }.to raise_exception
         end
 
         it 'should raise if it does not receive a board' do
-          expect {
-            Sensor.new(pin: 'a pin')
-          }.to raise_exception
+          expect { Sensor.new(pin: 7) }.to raise_exception
         end
 
-        it 'should add itself to the board and start reading' do
-          board.should_receive(:add_analog_hardware)
+        it 'should add itself to the board and start read' do
+          board.should_receive(:add_input_hardware)
           board.should_receive(:start_read)
-          Sensor.new(board: board, pin: 'a pin')
+          Sensor.new(board: board, pin: 7)
         end
 
-        it 'should initalize data_callbacks' do
-          sensor = Sensor.new(board: board, pin: 'a pin')
-          sensor.instance_variable_get(:@data_callbacks).should == []
+        it 'should initalize callbacks' do
+          sensor.instance_variable_get(:@callbacks).should == {}
         end
       end
 
-      describe '#when_data_received' do
-        
-        it "should add a callback to the list of callbacks" do
-          sensor = Sensor.new(board: board, pin: 'a pin')
-          sensor.when_data_received { "this is a block" }
-          sensor.instance_variable_get(:@data_callbacks).should_not be_empty
+      describe '#read' do
+        it 'should tell the board to read once' do
+          board.should_receive(:analog_read).with(7)
+          sensor.read
+        end
+
+        it 'should accept a callback as block and add to @callbacks[:read]'
+      end
+
+      describe '#listen' do
+        it 'should tell the board to start listening' do
+          board.should_receive(:analog_listen).with(7)
+          sensor.listen
+        end
+
+        it 'should accept a callback as block and add to @callbacks[:listen]'
+      end
+
+      describe '#add_callback' do
+        it 'should require a key'
+        it 'should add the block to the array corresponding to the key in the @callbacks hash'
+      end
+
+      describe '#clear_callbacks' do
+        it 'should clear all callbacks if called with no key' do
+          sensor.on_data { |data| puts data }
+          sensor.on_data(:test) { |data| puts data }
+          sensor.clear_callbacks
+          sensor.instance_variable_get(:@callbacks).should == {}
+        end
+
+        it 'should clear callbacks of a particular key if called with a key'
+      end
+
+      describe '#on_data' do 
+        it "should add a callback with the :persistent key" do
+          sensor.on_data { "this is a block" }
+          sensor.instance_variable_get(:@callbacks)[:persistent].should_not be_empty
         end
       end
 
@@ -46,10 +74,10 @@ module Components
           
           first_block_data = nil
           second_block_data = nil
-          sensor.when_data_received do |data|
+          sensor.on_data do |data|
             first_block_data = data
           end
-          sensor.when_data_received do |data|
+          sensor.on_data do |data|
             second_block_data = data
           end
 

From bf9261ddf2b19c35648a99c4aaa25a53b268f77e Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 11 Jun 2013 01:22:23 -0400
Subject: [PATCH 024/296] Dino::Components::Core - better core functionality to
 inherit from

---
 lib/dino/components.rb                     |  2 +-
 lib/dino/components/base_component.rb      | 44 ------------
 lib/dino/components/button.rb              | 50 +------------
 lib/dino/components/core.rb                | 10 +++
 lib/dino/components/core/analog_input.rb   | 21 ++++++
 lib/dino/components/core/base.rb           | 46 ++++++++++++
 lib/dino/components/core/digital_input.rb  | 41 +++++++++++
 lib/dino/components/core/input.rb          | 49 +++++++++++++
 lib/dino/components/core/output.rb         |  8 +++
 lib/dino/components/ir_receiver.rb         |  2 +-
 lib/dino/components/lcd.rb                 |  2 +-
 lib/dino/components/led.rb                 |  2 +-
 lib/dino/components/rgb_led.rb             |  2 +-
 lib/dino/components/sensor.rb              | 43 +-----------
 lib/dino/components/servo.rb               |  2 +-
 lib/dino/components/shift_register.rb      |  2 +-
 lib/dino/components/ssd.rb                 |  2 +-
 lib/dino/components/stepper.rb             |  2 +-
 spec/lib/components/base_component_spec.rb | 66 -----------------
 spec/lib/components/button_spec.rb         | 82 ++++++----------------
 spec/lib/components/core/base_spec.rb      | 65 +++++++++++++++++
 21 files changed, 273 insertions(+), 270 deletions(-)
 delete mode 100644 lib/dino/components/base_component.rb
 create mode 100644 lib/dino/components/core.rb
 create mode 100644 lib/dino/components/core/analog_input.rb
 create mode 100644 lib/dino/components/core/base.rb
 create mode 100644 lib/dino/components/core/digital_input.rb
 create mode 100644 lib/dino/components/core/input.rb
 create mode 100644 lib/dino/components/core/output.rb
 delete mode 100644 spec/lib/components/base_component_spec.rb
 create mode 100644 spec/lib/components/core/base_spec.rb

diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 8ddd6d32..7c06c3e7 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    require 'dino/components/base_component'
+    require 'dino/components/core'
     autoload :Led,            'dino/components/led'
     autoload :Button,         'dino/components/button'
     autoload :Sensor,         'dino/components/sensor'
diff --git a/lib/dino/components/base_component.rb b/lib/dino/components/base_component.rb
deleted file mode 100644
index 36236c3c..00000000
--- a/lib/dino/components/base_component.rb
+++ /dev/null
@@ -1,44 +0,0 @@
-module Dino
-  module Components
-    class BaseComponent
-      attr_reader :board, :pin, :pullup
-      alias :pins :pin
-
-      def initialize(options={})
-        self.board = options[:board]
-        self.pin = options[:pin] || options[:pins]
-        self.pullup = options[:pullup]
-
-        raise 'board and pin or pins are required for a component' if self.board.nil? || self.pin.nil?
-        after_initialize(options)
-      end
-
-      #
-      # As BaseComponent does a lot of work for you with regarding to setting up, it is
-      # best not to override #initialize and instead define an #after_initialize method
-      # within your subclass.
-      #
-      # @note This method should be implemented in the BaseComponent subclass.
-      #
-      def after_initialize(options={}) ; end
-
-      protected
-
-      attr_writer :board, :pin, :pullup
-      alias :pins= :pin=
-
-      def digital_write(pin=self.pin, value)
-        self.board.digital_write(pin, value)
-      end
-
-      def analog_write(pin=self.pin, value)
-        self.board.analog_write(pin, value)
-      end
-
-      def set_pin_mode(pin=self.pin, mode)
-        self.board.set_pin_mode(pin, mode, pullup)
-      end
-    end
-  end
-end
-
diff --git a/lib/dino/components/button.rb b/lib/dino/components/button.rb
index 9df42225..90b22cae 100644
--- a/lib/dino/components/button.rb
+++ b/lib/dino/components/button.rb
@@ -1,52 +1,8 @@
 module Dino
   module Components
-    class Button < BaseComponent
-      UP = "01"
-      DOWN = "00"
-
-      def after_initialize(options={})
-        @down_callbacks, @up_callbacks, @state = [], [], UP
-
-        board.add_input_hardware(self)
-        board.start_read
-        board.digital_listen(self.pin)
-      end
-
-      def down(&callback)
-        @down_callbacks << callback
-      end
-
-      def up(&callback)
-        @up_callbacks << callback
-      end
-
-      def update(data)
-        return if data == @state
-        @state = data
-
-        case data
-          when UP
-            button_up
-          when DOWN
-            button_down
-          else
-            return
-        end
-      end
-
-      private
-
-      def button_up
-        @up_callbacks.each do |callback|
-          callback.call
-        end
-      end
-
-      def button_down
-        @down_callbacks.each do |callback|
-          callback.call
-        end
-      end
+    class Button < Core::DigitalInput
+      alias :down :on_low
+      alias :up :on_high
     end
   end
 end
diff --git a/lib/dino/components/core.rb b/lib/dino/components/core.rb
new file mode 100644
index 00000000..aa0f11e4
--- /dev/null
+++ b/lib/dino/components/core.rb
@@ -0,0 +1,10 @@
+module Dino
+  module Components
+    module Core
+      require 'dino/components/core/base'
+      require 'dino/components/core/input'
+      require 'dino/components/core/analog_input'
+      require 'dino/components/core/digital_input'
+    end
+  end
+end
\ No newline at end of file
diff --git a/lib/dino/components/core/analog_input.rb b/lib/dino/components/core/analog_input.rb
new file mode 100644
index 00000000..b77b2b88
--- /dev/null
+++ b/lib/dino/components/core/analog_input.rb
@@ -0,0 +1,21 @@
+module Dino
+  module Components
+    module Core
+      class AnalogInput < Input
+        def read(&block)
+          super &block
+          board.analog_read(pin)
+        end
+
+        def listen(&block)
+          super &block
+          board.analog_listen(pin)
+        end
+      end
+
+      def update(data)
+        super(data.to_i)
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/core/base.rb b/lib/dino/components/core/base.rb
new file mode 100644
index 00000000..f4f8910f
--- /dev/null
+++ b/lib/dino/components/core/base.rb
@@ -0,0 +1,46 @@
+module Dino
+  module Components
+    module Core
+      class Base
+        attr_reader :board, :pin, :pullup
+        alias :pins :pin
+
+        def initialize(options={})
+          self.board = options[:board]
+          self.pin = options[:pin] || options[:pins]
+          self.pullup = options[:pullup]
+
+          raise 'board and pin or pins are required for a component' if self.board.nil? || self.pin.nil?
+          after_initialize(options)
+        end
+
+        #
+        # As BaseComponent does a lot of work for you with regarding to setting up, it is
+        # best not to override #initialize and instead define an #after_initialize method
+        # within your subclass.
+        #
+        # @note This method should be implemented in the BaseComponent subclass.
+        #
+        def after_initialize(options={}) ; end
+
+        protected
+
+        attr_writer :board, :pin, :pullup
+        alias :pins= :pin=
+
+        def digital_write(pin=self.pin, value)
+          self.board.digital_write(pin, value)
+        end
+
+        def analog_write(pin=self.pin, value)
+          self.board.analog_write(pin, value)
+        end
+
+        def set_pin_mode(pin=self.pin, mode)
+          self.board.set_pin_mode(pin, mode, pullup)
+        end
+      end
+    end
+  end
+end
+
diff --git a/lib/dino/components/core/digital_input.rb b/lib/dino/components/core/digital_input.rb
new file mode 100644
index 00000000..6fa16913
--- /dev/null
+++ b/lib/dino/components/core/digital_input.rb
@@ -0,0 +1,41 @@
+module Dino
+  module Components
+    module Core
+      class DigitalInput < Input
+        HIGH = 1
+        LOW = 0
+
+        def initialize(options={})
+          super options
+          listen
+        end
+
+        def read(&block)
+          super &block
+          board.digital_read(pin)
+        end
+
+        def listen(&block)
+          super &block
+          board.digital_listen(pin)
+        end
+
+        def on_high(&block)
+          add_callback(:high) do |data|
+            block.call(data) if data == HIGH
+          end
+        end
+
+        def on_low(&block)
+          add_callback(:low) do |data|
+            block.call(data) if data == LOW
+          end
+        end
+
+        def update(data)
+          super(@state = data.to_i)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/core/input.rb b/lib/dino/components/core/input.rb
new file mode 100644
index 00000000..09aec8be
--- /dev/null
+++ b/lib/dino/components/core/input.rb
@@ -0,0 +1,49 @@
+module Dino
+  module Components
+    module Core
+      class Input < Base
+        def initialize(options={})
+          super options
+
+          clear_callbacks
+          board.add_input_hardware(self)
+          board.start_read
+
+          after_initialize(options)
+        end
+
+        def read(&block)
+          add_callback(:read, &block) if block_given?
+        end
+
+        def listen(&block)
+          add_callback(:listen, &block) if block_given?
+        end
+
+        def stop_listening
+          board.stop_listener(pin)
+          clear_callbacks[:listen]
+        end
+
+        def add_callback(key=nil, &block)
+          key ||= :persistent
+          @callbacks[key] ||= []
+          @callbacks[key] << block
+        end
+
+        alias :on_data :add_callback
+
+        def clear_callbacks(key=nil)
+          key ? @callbacks[key] = nil : @callbacks = {}
+        end
+
+        def update(data)
+          @callbacks.each_value do |array|
+            array.each { |callback| callback.call(data) }
+          end
+          @callbacks[:read] = []
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/core/output.rb b/lib/dino/components/core/output.rb
new file mode 100644
index 00000000..50717f89
--- /dev/null
+++ b/lib/dino/components/core/output.rb
@@ -0,0 +1,8 @@
+module Dino
+  module Components
+    module Core
+      class Output < Base
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/ir_receiver.rb b/lib/dino/components/ir_receiver.rb
index f72ad11e..bd545ad4 100644
--- a/lib/dino/components/ir_receiver.rb
+++ b/lib/dino/components/ir_receiver.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class IrReceiver < BaseComponent
+    class IrReceiver < Core::Base
       STABLE = "01"
 
       def after_initialize(options={})
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index b7cba3c7..eda03940 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class LCD < BaseComponent
+    class LCD < Core::Base
 
       # Initialize in 4 bits mode
       #
diff --git a/lib/dino/components/led.rb b/lib/dino/components/led.rb
index f813b12d..343f8b03 100644
--- a/lib/dino/components/led.rb
+++ b/lib/dino/components/led.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class Led < BaseComponent
+    class Led < Core::Base
       def after_initialize(options={})
         set_pin_mode(:out)
         off
diff --git a/lib/dino/components/rgb_led.rb b/lib/dino/components/rgb_led.rb
index 1ba5c794..26c5f65e 100644
--- a/lib/dino/components/rgb_led.rb
+++ b/lib/dino/components/rgb_led.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class RgbLed < BaseComponent
+    class RgbLed < Core::Base
       # options = {board: my_board, pins: {red: red_pin, green: green_pin, blue: blue_pin}
       def after_initialize(options={})
         raise 'missing pins[:red] pin' unless self.pins[:red]
diff --git a/lib/dino/components/sensor.rb b/lib/dino/components/sensor.rb
index 7dffc0ac..ec96d532 100644
--- a/lib/dino/components/sensor.rb
+++ b/lib/dino/components/sensor.rb
@@ -1,47 +1,6 @@
 module Dino
   module Components
-    class Sensor < BaseComponent
-      def after_initialize(options={})
-        clear_callbacks
-        board.add_input_hardware(self)
-        board.start_read
-      end
-
-      def read(&block)
-        add_callback(:read, &block) if block_given?
-        board.analog_read(pin)
-      end
-
-      def listen(&block)
-        add_callback(:listen, &block) if block_given?
-        board.analog_listen(pin)
-      end
-
-      def stop_listening
-        board.stop_listener(pin)
-        clear_callbacks[:listen]
-      end
-
-      def add_callback(key=nil, &block)
-        key ||= :persistent
-        @callbacks[key] ||= []
-        @callbacks[key] << block
-      end
-
-      alias :on_data :add_callback
-
-      def clear_callbacks(key=nil)
-        key ? @callbacks[key] = nil : @callbacks = {}
-      end
-
-      def update(data)
-        @callbacks.each_value do |array|
-          array.each do |callback|
-            callback.call(data)
-          end
-        end
-        @callbacks[:read] = []
-      end
+    class Sensor < Core::AnalogInput      
     end
   end
 end
diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index 2a85dd3a..70dea259 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class Servo < BaseComponent
+    class Servo < Core::Base
       attr_reader :position
 
       def after_initialize(options={})
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index dddacbf2..dc83a2ca 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class ShiftRegister < BaseComponent
+    class ShiftRegister < Core::Base
       # options = {board: my_board, pins: {latch: latch_pin, clock: clock_pin, data: data_pin}
       def after_initialize(options={})
         raise 'missing pins[:latch] pin' unless self.pins[:latch]
diff --git a/lib/dino/components/ssd.rb b/lib/dino/components/ssd.rb
index 448a19f1..5231ab7a 100644
--- a/lib/dino/components/ssd.rb
+++ b/lib/dino/components/ssd.rb
@@ -9,7 +9,7 @@
 
 module Dino
   module Components
-    class SSD < BaseComponent
+    class SSD < Core::Base
       attr_reader :anode
 
       def after_initialize(options={})
diff --git a/lib/dino/components/stepper.rb b/lib/dino/components/stepper.rb
index 57f3607c..d292fa35 100644
--- a/lib/dino/components/stepper.rb
+++ b/lib/dino/components/stepper.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class Stepper < BaseComponent
+    class Stepper < Core::Base
 
       def after_initialize(options={})
         raise 'missing pins[:step] pin' unless self.pins[:step]
diff --git a/spec/lib/components/base_component_spec.rb b/spec/lib/components/base_component_spec.rb
deleted file mode 100644
index 689474e9..00000000
--- a/spec/lib/components/base_component_spec.rb
+++ /dev/null
@@ -1,66 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-
-    describe BaseComponent do
-
-      it 'should initialize with board and pin' do
-        pin = "a pin"
-        board = "a board"
-        component = BaseComponent.new(pin: pin, board: board)
-
-        component.pin.should == pin
-        component.board.should == board
-      end
-
-      it 'should assign pins' do
-        pins = {red: 'red', green: 'green', blue: 'blue'}
-        board = "a board"
-        component = BaseComponent.new(pins: pins, board: board)
-
-        component.pins.should == pins
-      end
-
-      it 'should require a pin or pins' do
-        expect {
-          BaseComponent.new(board: 'some board')
-        }.to raise_exception
-      end
-
-      it 'should require a board' do
-        expect {
-          BaseComponent.new(pin: 'some pin')
-        }.to raise_exception
-      end
-
-      context "when subclassed #after_initialize should be executed" do
-
-        class SpecComponent < BaseComponent
-
-          def sucessfully_initialized? ; @success ; end
-
-          def options ; @options ; end
-
-          def after_initialize(options={})
-            @success = true
-            @options = options
-          end
-        end
-
-        let(:options) { { pin: pin, board: board } }
-        let(:pin) { "a pin" }
-        let(:board) { "a board" }
-
-        it "should call #after_initialize with options" do
-          component = SpecComponent.new(options)
-          component.should be_sucessfully_initialized
-          component.options.should eq options
-        end
-
-      end
-
-    end
-  end
-end
-
diff --git a/spec/lib/components/button_spec.rb b/spec/lib/components/button_spec.rb
index 5eedfa05..65e7c9e7 100644
--- a/spec/lib/components/button_spec.rb
+++ b/spec/lib/components/button_spec.rb
@@ -30,90 +30,48 @@ module Components
         let(:board) { mock(:board, add_input_hardware: true, start_read: true, digital_listen: true) }
         let(:button) {Button.new(board: board, pin: mock)}
         describe '#down' do
-          it 'should add a callback to the down_callbacks array' do
+          it 'should add a callback to @callbacks[:low]' do
             callback = mock
             button.down do 
               callback.called
             end
-            down_callbacks = button.instance_variable_get(:@down_callbacks)
+            down_callbacks = button.instance_variable_get(:@callbacks)[:low]
             down_callbacks.size.should == 1
-            callback.should_receive(:called)
-            down_callbacks.first.call
           end
         end
 
         describe '#up' do
-          it 'should add a callback to the up_callbacks array' do
+          it 'should add a callback to @callbacks[:high]' do
             callback = mock
             button.up do 
               callback.called
             end
-            up_callbacks = button.instance_variable_get(:@up_callbacks)
+            up_callbacks = button.instance_variable_get(:@callbacks)[:high]
             up_callbacks.size.should == 1
-            callback.should_receive(:called)
-            up_callbacks.first.call
           end
         end
 
         describe '#update' do
-          it 'should call the down callbacks' do
-            callback_1 = mock
-            button.down do 
-              callback_1.called
-            end
+          it 'should call @callbacks[:high] only when HIGH' do
+            high_callback = mock
+            low_callback = mock
+            button.up   { high_callback.called }
+            button.down { low_callback.calles }
             
-            callback_2 = mock
-            button.down do 
-              callback_2.called
-            end
-            callback_1.should_receive(:called)
-            callback_2.should_receive(:called)
-            button.update(Button::DOWN)
+            high_callback.should_receive(:called)
+            low_callback.should_not_receive(:called)
+            button.update(1)
           end
 
-          it 'should call the up callbacks' do
-            callback_1 = mock
-            button.up do 
-              callback_1.called
-            end
+          it 'should call @callbacks[:low] only when LOW' do
+            high_callback = mock
+            low_callback = mock
+            button.up   { high_callback.called }
+            button.down { low_callback.called }
             
-            callback_2 = mock
-            button.up do 
-              callback_2.called
-            end
-
-            button.instance_variable_set(:@state, Button::DOWN)
-
-            callback_1.should_receive(:called)
-            callback_2.should_receive(:called)
-            button.update(Button::UP)
-          end
-
-          it 'should not call the callbacks if the state has not changed' do
-            callback = mock
-            button.up do
-              callback.called
-            end
-
-            callback.should_not_receive(:called)
-            button.update(Button::UP)
-            button.update(Button::UP)
-          end
-
-          it 'should not call the callbacks if the data is not UP or DOWN' do
-            callback_1 = mock
-            button.up do 
-              callback_1.called
-            end
-
-            callback_2 = mock
-            button.down do 
-              callback_2.called
-            end
-
-            callback_1.should_not_receive(:called)
-            callback_2.should_not_receive(:called)
-            button.update('foobarred')
+            high_callback.should_not_receive(:called)
+            low_callback.should_receive(:called)
+            button.update(0)
           end
         end
       end
diff --git a/spec/lib/components/core/base_spec.rb b/spec/lib/components/core/base_spec.rb
new file mode 100644
index 00000000..12184c13
--- /dev/null
+++ b/spec/lib/components/core/base_spec.rb
@@ -0,0 +1,65 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Core
+      describe Base do
+
+        it 'should initialize with board and pin' do
+          pin = "a pin"
+          board = "a board"
+          component = Base.new(pin: pin, board: board)
+
+          component.pin.should == pin
+          component.board.should == board
+        end
+
+        it 'should assign pins' do
+          pins = {red: 'red', green: 'green', blue: 'blue'}
+          board = "a board"
+          component = Base.new(pins: pins, board: board)
+
+          component.pins.should == pins
+        end
+
+        it 'should require a pin or pins' do
+          expect {
+            Base.new(board: 'some board')
+          }.to raise_exception
+        end
+
+        it 'should require a board' do
+          expect {
+            Base.new(pin: 'some pin')
+          }.to raise_exception
+        end
+
+        context "when subclassed #after_initialize should be executed" do
+
+          class SpecComponent < Base
+
+            def sucessfully_initialized? ; @success ; end
+
+            def options ; @options ; end
+
+            def after_initialize(options={})
+              @success = true
+              @options = options
+            end
+          end
+
+          let(:options) { { pin: pin, board: board } }
+          let(:pin) { "a pin" }
+          let(:board) { "a board" }
+
+          it "should call #after_initialize with options" do
+            component = SpecComponent.new(options)
+            component.should be_sucessfully_initialized
+            component.options.should eq options
+          end
+        end
+      end
+    end
+  end
+end
+

From ae5cc5564f37ec83dd4c584740d8276d40de7746 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 11 Jun 2013 01:52:14 -0400
Subject: [PATCH 025/296] Refactor LCD and IR receiver

---
 lib/dino/components/ir_receiver.rb | 27 ++--------
 lib/dino/components/lcd.rb         | 79 +++++++++---------------------
 2 files changed, 27 insertions(+), 79 deletions(-)

diff --git a/lib/dino/components/ir_receiver.rb b/lib/dino/components/ir_receiver.rb
index bd545ad4..ccbd10a2 100644
--- a/lib/dino/components/ir_receiver.rb
+++ b/lib/dino/components/ir_receiver.rb
@@ -1,30 +1,11 @@
 module Dino
   module Components
-    class IrReceiver < Core::Base
-      STABLE = "01"
-
-      def after_initialize(options={})
-        @flash_callbacks = []
-
-        self.board.add_digital_hardware(self)
-        self.board.start_read
-      end
-
-      def flash(callback)
-        @flash_callbacks << callback
-      end
+    class IrReceiver < Core::DigitalInput
+      alias :flash :on_low
 
       def update(data)
-        return if data == STABLE
-        light_flashed
-      end
-
-      private
-
-      def light_flashed
-        @flash_callbacks.each do |callback|
-          callback.call
-        end
+        return if data.to_i == HIGH
+        super data
       end
     end
   end
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index eda03940..eda2f15b 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -26,68 +26,35 @@ def after_initialize(options)
         board.write Dino::Message.encode command: 10, value: 1, aux_message: "#{@cols},#{@rows}"
       end
 
-      def puts(string)
-        board.write Dino::Message.encode command: 10, value: 5, aux_message: string
-      end
-
-      def clear
-        board.write Dino::Message.encode command: 10, value: 2
-      end
-
-      def home
-        board.write Dino::Message.encode command: 10, value: 3
+      LIBRARY_COMMANDS = {
+        clear:              '2',
+        home:               '3',
+        show_cursor:        '6',
+        hide_cursor:        '7',
+        blink:              '8',
+        no_blink:           '9',
+        on:                '10',
+        off:               '11',
+        scroll_left:       '12',
+        scroll_right:      '13',
+        enable_autoscroll: '14',
+        disable_autoscroll:'15',
+        left_to_right:     '16',
+        right_to_left:     '17'
+      }
+
+      LIBRARY_COMMANDS.each_pair do |command, command_id|
+        define_method(command) do
+          board.write Dino::Message.encode(command: 10, value: command_id)
+        end
       end
 
       def set_cursor(col, row)
         board.write Dino::Message.encode command: 10, value: 4, aux_message: "#{col},#{row}"
       end
 
-      def show_cursor
-        board.write Dino::Message.encode command: 10, value: 6
-      end
-
-      def hide_cursor
-        board.write Dino::Message.encode command: 10, value: 7
-      end
-
-      def blink
-        board.write Dino::Message.encode command: 10, value: 8
-      end
-
-      def no_blink
-        board.write Dino::Message.encode command: 10, value: 9
-      end
-
-      def on
-        board.write Dino::Message.encode command: 10, value: 10
-      end
-
-      def off
-        board.write Dino::Message.encode command: 10, value: 11
-      end
-
-      def scroll_left
-        board.write Dino::Message.encode command: 10, value: 12
-      end
-
-      def scroll_right
-        board.write Dino::Message.encode command: 10, value: 13
-      end
-
-      def enable_autoscroll
-        board.write Dino::Message.encode command: 10, value: 14
-      end
-
-      def disable_autoscroll
-        board.write Dino::Message.encode command: 10, value: 15
-      end
-
-      def left_to_right
-        board.write Dino::Message.encode command: 10, value: 16
-      end
-
-      def right_to_left
-        board.write Dino::Message.encode command: 10, value: 17
+      def puts(string)
+        board.write Dino::Message.encode command: 10, value: 5, aux_message: string
       end
 
       private

From c76feeaf80e807b8bd9a93de4c4c2ca5e0acd86e Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 12 Jun 2013 10:14:38 -0400
Subject: [PATCH 026/296] Refactor logic into Components::Core. Add
 Components::Core::MultiPin. Create complex components by using basic (one
 pin) components as proxies.

---
 examples/rgb_led/rgb_led.rb                   |   6 +-
 lib/dino/components/core.rb                   |   4 +-
 lib/dino/components/core/analog_input.rb      |  16 +-
 lib/dino/components/core/base.rb              |  39 +++--
 .../core/{input.rb => base_input.rb}          |  38 +++--
 lib/dino/components/core/base_output.rb       |  43 ++++++
 lib/dino/components/core/digital_input.rb     |  24 ++-
 lib/dino/components/core/multi_pin.rb         |  65 ++++++++
 lib/dino/components/core/output.rb            |   8 -
 lib/dino/components/lcd.rb                    |   2 +-
 lib/dino/components/led.rb                    |  16 +-
 lib/dino/components/rgb_led.rb                |  36 ++---
 lib/dino/components/servo.rb                  |  13 +-
 lib/dino/components/shift_register.rb         |  33 ++---
 lib/dino/components/ssd.rb                    |  22 ++-
 lib/dino/components/stepper.rb                |  23 ++-
 spec/lib/components/button_spec.rb            |  72 ---------
 spec/lib/components/core/analog_input_spec.rb |  28 ++++
 spec/lib/components/core/base_input_spec.rb   | 119 +++++++++++++++
 spec/lib/components/core/base_output_spec.rb  |  75 ++++++++++
 spec/lib/components/core/base_spec.rb         |  72 ++++-----
 .../lib/components/core/digital_input_spec.rb |  66 +++++++++
 spec/lib/components/core/multi_pin_spec.rb    |  78 ++++++++++
 spec/lib/components/led_spec.rb               |  42 ------
 spec/lib/components/rgb_led_spec.rb           | 139 ++++++------------
 spec/lib/components/sensor_spec.rb            |  82 -----------
 spec/lib/components/servo_spec.rb             |  34 ++---
 spec/lib/components/shift_register_spec.rb    |  46 ++----
 spec/lib/components/ssd_spec.rb               |  66 ++++-----
 spec/lib/components/stepper_spec.rb           |  60 +++-----
 30 files changed, 746 insertions(+), 621 deletions(-)
 rename lib/dino/components/core/{input.rb => base_input.rb} (56%)
 create mode 100644 lib/dino/components/core/base_output.rb
 create mode 100644 lib/dino/components/core/multi_pin.rb
 delete mode 100644 lib/dino/components/core/output.rb
 create mode 100644 spec/lib/components/core/analog_input_spec.rb
 create mode 100644 spec/lib/components/core/base_input_spec.rb
 create mode 100644 spec/lib/components/core/base_output_spec.rb
 create mode 100644 spec/lib/components/core/digital_input_spec.rb
 create mode 100644 spec/lib/components/core/multi_pin_spec.rb

diff --git a/examples/rgb_led/rgb_led.rb b/examples/rgb_led/rgb_led.rb
index 46c6693a..783ab52d 100644
--- a/examples/rgb_led/rgb_led.rb
+++ b/examples/rgb_led/rgb_led.rb
@@ -21,13 +21,13 @@
 loop do
   puts "DELAY: #{seconds = (delay / 1000.0)}"
   p 'red'
-  led.red
+  led.color = :red
   sleep(seconds)
-  led.blue
   p 'blue'
+  led.color = :blue
   sleep(seconds)
-  led.green
   p 'green'
+  led.color = :green
   sleep(seconds)
 end
 #led.color(224, 27, 106)
diff --git a/lib/dino/components/core.rb b/lib/dino/components/core.rb
index aa0f11e4..2ef4d795 100644
--- a/lib/dino/components/core.rb
+++ b/lib/dino/components/core.rb
@@ -2,9 +2,11 @@ module Dino
   module Components
     module Core
       require 'dino/components/core/base'
-      require 'dino/components/core/input'
+      require 'dino/components/core/multi_pin'
+      require 'dino/components/core/base_input'
       require 'dino/components/core/analog_input'
       require 'dino/components/core/digital_input'
+      require 'dino/components/core/base_output'
     end
   end
 end
\ No newline at end of file
diff --git a/lib/dino/components/core/analog_input.rb b/lib/dino/components/core/analog_input.rb
index b77b2b88..ba9b8f51 100644
--- a/lib/dino/components/core/analog_input.rb
+++ b/lib/dino/components/core/analog_input.rb
@@ -1,21 +1,15 @@
 module Dino
   module Components
     module Core
-      class AnalogInput < Input
-        def read(&block)
-          super &block
-          board.analog_read(pin)
+      class AnalogInput < BaseInput
+        def poll
+          board.analog_read(self.pin)
         end
 
-        def listen(&block)
-          super &block
-          board.analog_listen(pin)
+        def start_listening
+          board.analog_listen(self.pin)
         end
       end
-
-      def update(data)
-        super(data.to_i)
-      end
     end
   end
 end
diff --git a/lib/dino/components/core/base.rb b/lib/dino/components/core/base.rb
index f4f8910f..e9eec9fa 100644
--- a/lib/dino/components/core/base.rb
+++ b/lib/dino/components/core/base.rb
@@ -2,45 +2,40 @@ module Dino
   module Components
     module Core
       class Base
-        attr_reader :board, :pin, :pullup
-        alias :pins :pin
+        attr_reader :board, :pin, :mode, :pullup, :state
 
         def initialize(options={})
+          raise 'board and pin are required for a component' if options[:board].nil? || options[:pin].nil?
+
           self.board = options[:board]
-          self.pin = options[:pin] || options[:pins]
-          self.pullup = options[:pullup]
+          self.pin = board.convert_pin(options[:pin])
+          @pullup = options[:pullup]
 
-          raise 'board and pin or pins are required for a component' if self.board.nil? || self.pin.nil?
           after_initialize(options)
         end
 
+        protected
+
+        attr_writer :board, :pin
+
         #
-        # As BaseComponent does a lot of work for you with regarding to setting up, it is
-        # best not to override #initialize and instead define an #after_initialize method
-        # within your subclass.
+        # Components::Core::Base does a lot of setup work for you.
+        # Define #after_initialize in your subclass instead of overriding #initialize
         #
         # @note This method should be implemented in the BaseComponent subclass.
         #
         def after_initialize(options={}) ; end
 
-        protected
-
-        attr_writer :board, :pin, :pullup
-        alias :pins= :pin=
-
-        def digital_write(pin=self.pin, value)
-          self.board.digital_write(pin, value)
+        def mode=(mode)
+          @mode = mode
+          board.set_pin_mode(self.pin, mode, pullup)
         end
 
-        def analog_write(pin=self.pin, value)
-          self.board.analog_write(pin, value)
-        end
-
-        def set_pin_mode(pin=self.pin, mode)
-          self.board.set_pin_mode(pin, mode, pullup)
+        def pullup=(pullup)
+          @pullup = pullup
+          board.set_pullup(self.pin, pullup)
         end
       end
     end
   end
 end
-
diff --git a/lib/dino/components/core/input.rb b/lib/dino/components/core/base_input.rb
similarity index 56%
rename from lib/dino/components/core/input.rb
rename to lib/dino/components/core/base_input.rb
index 09aec8be..5d2dfe96 100644
--- a/lib/dino/components/core/input.rb
+++ b/lib/dino/components/core/base_input.rb
@@ -1,29 +1,37 @@
 module Dino
   module Components
     module Core
-      class Input < Base
+      class BaseInput < Base
+        attr_reader :state
+
         def initialize(options={})
           super options
 
-          clear_callbacks
+          remove_callbacks
+          self.mode = :in
           board.add_input_hardware(self)
           board.start_read
 
           after_initialize(options)
         end
-
+        
         def read(&block)
           add_callback(:read, &block) if block_given?
+          poll
         end
-
+        
         def listen(&block)
           add_callback(:listen, &block) if block_given?
+          start_listening
         end
 
-        def stop_listening
-          board.stop_listener(pin)
-          clear_callbacks[:listen]
-        end
+        #
+        # Define these in your subclass.
+        # Should correspond to Board#digital_read, Board#digital_listen for digital
+        # and Board#analog_read, Board#analog_listen for analog components. 
+        #
+        def poll ; end
+        def start_listening ; end
 
         def add_callback(key=nil, &block)
           key ||= :persistent
@@ -33,15 +41,23 @@ def add_callback(key=nil, &block)
 
         alias :on_data :add_callback
 
-        def clear_callbacks(key=nil)
+        def remove_callback(key=nil)
           key ? @callbacks[key] = nil : @callbacks = {}
         end
 
+        alias :remove_callbacks :remove_callback
+
+        def stop_listening
+          board.stop_listener(pin)
+          remove_callback :listen
+        end
+
         def update(data)
+          @state = data
           @callbacks.each_value do |array|
-            array.each { |callback| callback.call(data) }
+            array.each { |callback| callback.call(@state) }
           end
-          @callbacks[:read] = []
+          remove_callback :read
         end
       end
     end
diff --git a/lib/dino/components/core/base_output.rb b/lib/dino/components/core/base_output.rb
new file mode 100644
index 00000000..103f8977
--- /dev/null
+++ b/lib/dino/components/core/base_output.rb
@@ -0,0 +1,43 @@
+module Dino
+  module Components
+    module Core
+      class BaseOutput < Base
+        attr_reader :state
+
+        def initialize(options={})
+          super options
+
+          self.mode = :out
+          low
+        end
+
+        def digital_write(value)
+          board.digital_write(pin, @state = value)
+        end
+
+        def analog_write(value)
+          board.analog_write(pin, @state = value)
+        end
+
+        def write(value)
+          unless [Board::LOW, Board::HIGH].include? value
+            analog_write(value)
+          else
+            digital_write(value)
+          end
+        end
+
+        def low
+          digital_write Board::LOW
+        end
+
+        def high
+          digital_write Board::HIGH
+        end
+
+        alias :off :low
+        alias :on  :high
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/core/digital_input.rb b/lib/dino/components/core/digital_input.rb
index 6fa16913..74b72a83 100644
--- a/lib/dino/components/core/digital_input.rb
+++ b/lib/dino/components/core/digital_input.rb
@@ -1,40 +1,34 @@
 module Dino
   module Components
     module Core
-      class DigitalInput < Input
+      class DigitalInput < BaseInput
         HIGH = 1
         LOW = 0
 
         def initialize(options={})
-          super options
-          listen
+          super(options)
+          start_listening
         end
 
-        def read(&block)
-          super &block
-          board.digital_read(pin)
+        def poll
+          board.digital_read(self.pin)
         end
 
-        def listen(&block)
-          super &block
-          board.digital_listen(pin)
+        def start_listening
+          board.digital_listen(self.pin)
         end
 
         def on_high(&block)
           add_callback(:high) do |data|
-            block.call(data) if data == HIGH
+            block.call(data) if data.to_i == HIGH
           end
         end
 
         def on_low(&block)
           add_callback(:low) do |data|
-            block.call(data) if data == LOW
+            block.call(data) if data.to_i == LOW
           end
         end
-
-        def update(data)
-          super(@state = data.to_i)
-        end
       end
     end
   end
diff --git a/lib/dino/components/core/multi_pin.rb b/lib/dino/components/core/multi_pin.rb
new file mode 100644
index 00000000..23294583
--- /dev/null
+++ b/lib/dino/components/core/multi_pin.rb
@@ -0,0 +1,65 @@
+module Dino
+  module Components
+    module Core
+      class MultiPin
+        attr_reader :board, :pins, :pullups
+
+        def initialize(options={})
+          raise 'board and pins are required for a component' if options[:board].nil? || options[:pins].nil?
+
+          self.board = options[:board]
+          self.pins = options[:pins]
+          self.pullups = options[:pullups] || {}
+          
+          after_initialize(options)
+        end
+
+        def state
+          state = {}
+          pins.each_key do |pin|
+            state[pin] = self.send(pin).state
+          end
+          state
+        end
+
+        protected
+
+        attr_writer :board, :pins, :pullups
+
+        #
+        # @note This method should be implemented in your subclass.
+        #
+        def after_initialize(options={}) ; end
+
+        #
+        # Build complex components by proxying each pin to a basic, single pin component.
+        #
+        # Call #proxy with a hash like:
+        #   class MyComponent < MultiPin
+        #     proxy {lamp: Core::BaseOutput, motor: Core::BaseOutput}
+        #   end
+        #
+        # Checks the @pins hash for the pins corresponding to the keys like:
+        #   pins => {lamp: 9, motor: 10}  - No error
+        #   pins => {lamp: 9}             - Error raised
+        #
+        # It instantiates a new instance of the class passed in for each key in an instance variable.
+        # Sets up an attr_reader on the singleton class, so the proxy component can be accessed like:
+        #   my_component.lamp.on; my_component.motor.analog_write(128) 
+        # 
+        def proxy(proxies={})
+          proxies.each_pair do |key, klass|
+            raise "missing pins[:#{key}] pin" unless pins[key]
+
+            proxy_component = klass.new(board: board, pin: pins[key], pullup: pullups[key])
+            instance_variable_set("@#{key}", proxy_component)
+
+            singleton_class.class_eval { attr_reader key }
+          end
+        end
+
+        alias :proxies :proxy
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/core/output.rb b/lib/dino/components/core/output.rb
deleted file mode 100644
index 50717f89..00000000
--- a/lib/dino/components/core/output.rb
+++ /dev/null
@@ -1,8 +0,0 @@
-module Dino
-  module Components
-    module Core
-      class Output < Base
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index eda2f15b..f46dc4dc 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class LCD < Core::Base
+    class LCD < Core::MultiPin
 
       # Initialize in 4 bits mode
       #
diff --git a/lib/dino/components/led.rb b/lib/dino/components/led.rb
index 343f8b03..302d103d 100644
--- a/lib/dino/components/led.rb
+++ b/lib/dino/components/led.rb
@@ -1,18 +1,8 @@
 module Dino
   module Components
-    class Led < Core::Base
-      def after_initialize(options={})
-        set_pin_mode(:out)
-        off
-      end
-
-      def on
-        digital_write(Board::HIGH)
-      end
-
-      def off
-        digital_write(Board::LOW)
-      end
+    class Led < Core::BaseOutput
+      alias :on  :high
+      alias :off :low
     end
   end
 end
diff --git a/lib/dino/components/rgb_led.rb b/lib/dino/components/rgb_led.rb
index 26c5f65e..d91ddacd 100644
--- a/lib/dino/components/rgb_led.rb
+++ b/lib/dino/components/rgb_led.rb
@@ -1,16 +1,13 @@
 module Dino
   module Components
-    class RgbLed < Core::Base
+    class RgbLed < Core::MultiPin
+      #
       # options = {board: my_board, pins: {red: red_pin, green: green_pin, blue: blue_pin}
+      #
       def after_initialize(options={})
-        raise 'missing pins[:red] pin' unless self.pins[:red]
-        raise 'missing pins[:green] pin' unless self.pins[:green]
-        raise 'missing pins[:blue] pin' unless self.pins[:blue]
-
-        pins.each do |color, pin|
-          set_pin_mode(pin, :out)
-          analog_write(pin, Board::LOW)
-        end
+        proxies red:   Core::BaseOutput,
+                green: Core::BaseOutput,
+                blue:  Core::BaseOutput 
       end
 
       # Format: [R, G, B]
@@ -25,17 +22,22 @@ def after_initialize(options={})
         off:     [000, 000, 000]
       }
 
-      COLORS.each_key do |color|
-        define_method(color) do
-          analog_write(pins[:red], COLORS[color][0])
-          analog_write(pins[:green], COLORS[color][1])
-          analog_write(pins[:blue], COLORS[color][2])
-        end 
+      def write(array)
+        red.write   array[0]
+        green.write array[1]
+        blue.write  array[2]
+      end
+
+      def color=(color)
+        return write(color) if color.class == Array
+        
+        color = color.to_sym
+        write(COLORS[color]) if COLORS.include? color
       end
 
-      def blinky
+      def cycle
         [:red, :green, :blue].cycle do |color|
-          self.send(color)
+          self.color = color
           sleep(0.01)
         end
       end
diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index 70dea259..e0461d71 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -1,16 +1,17 @@
 module Dino
   module Components
-    class Servo < Core::Base
-      attr_reader :position
-
+    class Servo < Core::BaseOutput
       def after_initialize(options={})
-        set_pin_mode(:out)
         board.servo_toggle(pin, 1)
-        self.position = options[:position] || 0
       end
 
       def position=(value)
-        board.servo_write(pin, @position = angle(value))
+        @state = angle(value)
+        board.servo_write(pin, @state)
+      end
+
+      def position
+        @state
       end
 
       def angle(value)
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index dc83a2ca..11418c69 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -1,36 +1,23 @@
 module Dino
   module Components
-    class ShiftRegister < Core::Base
-      # options = {board: my_board, pins: {latch: latch_pin, clock: clock_pin, data: data_pin}
+    class ShiftRegister < Core::MultiPin
+      #
+      # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
+      #
       def after_initialize(options={})
-        raise 'missing pins[:latch] pin' unless self.pins[:latch]
-        raise 'missing pins[:clock] pin' unless self.pins[:clock]
-        raise 'missing pins[:data] pin' unless self.pins[:data]
-
-        pins.each_value do |pin|
-          set_pin_mode(pin, :out)
-          digital_write(pin, Board::LOW)
-        end
-      end
-
-      def latch_off
-        digital_write(pins[:latch], Board::LOW)
-      end
-
-      def latch_on
-        digital_write(pins[:latch], Board::HIGH)
+        proxy  clock: Core::BaseOutput,
+               latch: Core::BaseOutput,
+               data:  Core::BaseOutput
       end
 
       def write(bytes)
         bytes = [bytes] unless bytes.class == Array
-        data_pin = board.convert_pin(pins[:data])
-        clock_pin = board.convert_pin(pins[:clock])
 
-        latch_off
+        latch.low
         bytes.each do |byte|
-          board.write Dino::Message.encode( command: 11, pin: data_pin, value: byte, aux_message: clock_pin)
+          board.write Dino::Message.encode(command: 11, pin: data.pin, value: byte, aux_message: clock.pin)
         end
-        latch_on
+        latch.high
       end
     end
   end
diff --git a/lib/dino/components/ssd.rb b/lib/dino/components/ssd.rb
index 5231ab7a..edae8f79 100644
--- a/lib/dino/components/ssd.rb
+++ b/lib/dino/components/ssd.rb
@@ -9,26 +9,22 @@
 
 module Dino
   module Components
-    class SSD < Core::Base
+    class SSD < Core::MultiPin
       attr_reader :anode
 
       def after_initialize(options={})
-        @anode = options[:anode]
+        raise Exception.new('anode must be specified') unless options[:anode]
+        @anode = Core::BaseOutput.new(board: board, pin: options[:anode])
 
-        raise Exception.new('anode must be specified') unless anode
+        # Create a Core::BaseOutput for every pin.
+        @pins.map! { |pin| Core::BaseOutput.new(board: board, pin: pin) }
 
-        # Set all pins to output
-        pins.each { |pin| set_pin_mode(pin, :out) }
-
-        # Clear the display
         clear
-
-        # Turn on the display
         on
       end
 
       def clear
-        7.times { |t| toggle t, 0 }
+        7.times { |pin| toggle pin, 0 }
       end
 
       def display(char)
@@ -47,11 +43,11 @@ def display(char)
       end
 
       def on
-        digital_write anode, Board::HIGH
+        @anode.high
       end
 
       def off
-        digital_write anode, Board::LOW
+        @anode.low
       end
 
       CHARACTERS = {
@@ -110,7 +106,7 @@ def scroll(string)
       end
 
       def toggle(number, state)
-        digital_write pins[number], state == 1 ? 0 : 1
+        @pins[number].write (state == 1 ? 0 : 1)
       end
     end
   end
diff --git a/lib/dino/components/stepper.rb b/lib/dino/components/stepper.rb
index d292fa35..165d1ef1 100644
--- a/lib/dino/components/stepper.rb
+++ b/lib/dino/components/stepper.rb
@@ -1,26 +1,21 @@
 module Dino
   module Components
-    class Stepper < Core::Base
-
+    class Stepper < Core::MultiPin
       def after_initialize(options={})
-        raise 'missing pins[:step] pin' unless self.pins[:step]
-        raise 'missing pins[:direction] pin' unless self.pins[:direction]
-
-        set_pin_mode(pins[:step], :out)
-        set_pin_mode(pins[:direction], :out)
-        digital_write(pins[:step], Board::LOW)
+        proxies step:      Core::BaseOutput,
+                direction: Core::BaseOutput
       end
 
       def step_cc
-        digital_write(self.pins[:direction], Board::HIGH)
-        digital_write(self.pins[:step],      Board::HIGH)
-        digital_write(self.pins[:step],      Board::LOW)
+        direction.high
+        step.high
+        step.low
       end
 
       def step_cw
-        digital_write(self.pins[:direction], Board::LOW)
-        digital_write(self.pins[:step],      Board::HIGH)
-        digital_write(self.pins[:step],      Board::LOW)
+        direction.low
+        step.high
+        step.low
       end
     end
   end
diff --git a/spec/lib/components/button_spec.rb b/spec/lib/components/button_spec.rb
index 65e7c9e7..d9cc1e48 100644
--- a/spec/lib/components/button_spec.rb
+++ b/spec/lib/components/button_spec.rb
@@ -3,78 +3,6 @@
 module Dino
   module Components
     describe Button do
-      describe '#initialize' do
-        it 'should raise if it does not receive a pin' do
-          expect {
-            Button.new(board: 'a board')
-          }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
-          expect {
-            Button.new(pin: 'a pin')
-          }.to raise_exception
-        end
-
-        it 'should add itself to the board, start read and digital listen' do
-          board = mock(:board)
-          board.should_receive(:add_input_hardware)
-          board.should_receive(:start_read)
-          board.should_receive(:digital_listen).with(7)
-
-          Button.new(board: board, pin: 7)
-        end
-      end
-
-      context 'callbacks' do
-        let(:board) { mock(:board, add_input_hardware: true, start_read: true, digital_listen: true) }
-        let(:button) {Button.new(board: board, pin: mock)}
-        describe '#down' do
-          it 'should add a callback to @callbacks[:low]' do
-            callback = mock
-            button.down do 
-              callback.called
-            end
-            down_callbacks = button.instance_variable_get(:@callbacks)[:low]
-            down_callbacks.size.should == 1
-          end
-        end
-
-        describe '#up' do
-          it 'should add a callback to @callbacks[:high]' do
-            callback = mock
-            button.up do 
-              callback.called
-            end
-            up_callbacks = button.instance_variable_get(:@callbacks)[:high]
-            up_callbacks.size.should == 1
-          end
-        end
-
-        describe '#update' do
-          it 'should call @callbacks[:high] only when HIGH' do
-            high_callback = mock
-            low_callback = mock
-            button.up   { high_callback.called }
-            button.down { low_callback.calles }
-            
-            high_callback.should_receive(:called)
-            low_callback.should_not_receive(:called)
-            button.update(1)
-          end
-
-          it 'should call @callbacks[:low] only when LOW' do
-            high_callback = mock
-            low_callback = mock
-            button.up   { high_callback.called }
-            button.down { low_callback.called }
-            
-            high_callback.should_not_receive(:called)
-            low_callback.should_receive(:called)
-            button.update(0)
-          end
-        end
-      end
     end
   end
 end
diff --git a/spec/lib/components/core/analog_input_spec.rb b/spec/lib/components/core/analog_input_spec.rb
new file mode 100644
index 00000000..6be3c687
--- /dev/null
+++ b/spec/lib/components/core/analog_input_spec.rb
@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Core
+      describe AnalogInput do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board } }
+        subject { AnalogInput.new(options) }
+
+        describe '#poll' do
+          it 'should send #analog_read to the board with its pin' do
+            board.should_receive(:analog_read).with(subject.pin)
+            subject.read
+          end
+        end
+
+        describe '#start_listening' do
+          it 'should send #analog_listen to the board with its pin' do
+            board.should_receive(:analog_listen).with(subject.pin)
+            subject.start_listening
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/core/base_input_spec.rb b/spec/lib/components/core/base_input_spec.rb
new file mode 100644
index 00000000..b6f75c7b
--- /dev/null
+++ b/spec/lib/components/core/base_input_spec.rb
@@ -0,0 +1,119 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Core
+      describe BaseInput do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board } }
+        subject { BaseInput.new(options) }
+
+        describe '#initialize' do
+          it 'should add itself as input hardware, set mode to in and start read' do
+            board.should_receive(:set_pin_mode).with(14, :in, nil)
+            board.should_receive(:add_input_hardware)
+            board.should_receive(:start_read)
+
+            BaseInput.new(options)
+          end
+        end
+
+        context 'callbacks' do
+          describe '#add_callback' do
+            it 'should add a callback to the :persistent key if no key is given' do
+              subject.add_callback { mock }
+              subject.instance_variable_get(:@callbacks)[:persistent].should_not be_empty
+            end
+
+            it 'should add a callback to the key if a key is given' do
+              subject.add_callback(:test) { mock }
+              subject.instance_variable_get(:@callbacks)[:test].should_not be_empty
+            end
+          end
+
+          describe '#remove_callback' do
+            it 'should remove all callbacks if no key is given' do
+              subject.add_callback { mock }
+              subject.remove_callback
+
+              subject.instance_variable_get(:@callbacks).should == {}
+            end
+
+            it 'should remove callbacks for the given key if key is given' do
+              subject.add_callback { mock }
+              subject.add_callback(:test) { mock }
+              subject.remove_callback(:test)
+
+              subject.instance_variable_get(:@callbacks)[:test].should be_nil
+            end
+          end
+        end
+
+        context 'reading' do
+          describe '#read' do
+            it 'should add the block given as a callback to the :read key' do
+              subject.should_receive(:add_callback).with(:read)
+              subject.read { mock }
+            end
+
+            it 'should call #poll once' do
+              subject.should_receive(:poll)
+              subject.read
+            end
+          end
+
+          describe '#listen' do
+            it 'should add the block given as a callback to the :listen key' do
+              subject.should_receive(:add_callback).with(:listen)
+              subject.listen { mock }
+            end
+
+            it 'should call #start_listening' do
+              subject.should_receive(:start_listening)
+              subject.listen
+            end
+          end
+
+          describe '#stop_listening' do
+            it 'should tell the board to turn the listener off' do
+              board.should_receive(:stop_listener).with(subject.pin)
+              subject.stop_listening
+            end
+
+            it 'should remove all callbacks with the :listen key' do
+              subject.listen { mock }
+              subject.should_receive(:remove_callback).with(:listen)
+
+              subject.stop_listening
+            end
+          end
+        end
+
+        describe '#update' do
+          it 'should update @state' do
+            subject.update("something")
+            subject.instance_variable_get(:@state).should == "something"
+          end
+
+          it 'should call all callbacks passing in the given data' do
+            first_block_data = nil
+            second_block_data = nil
+            subject.add_callback { |data| first_block_data = data }
+            subject.add_callback { |data| second_block_data = data }
+
+            subject.update('Some data')
+            [first_block_data, second_block_data].each { |block_data| block_data.should == "Some data" }
+          end
+
+          it 'should remove any callbacks keyed with :read' do
+            subject.add_callback(:read) { |data| first_block_data = data }
+
+            subject.update("Some data")
+            subject.instance_variable_get(:@callbacks)[:read].should be_nil
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/core/base_output_spec.rb b/spec/lib/components/core/base_output_spec.rb
new file mode 100644
index 00000000..8552d604
--- /dev/null
+++ b/spec/lib/components/core/base_output_spec.rb
@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Core
+      describe BaseOutput do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board } }
+        subject { BaseOutput.new(options) }
+
+        before(:each) { subject }
+
+        describe '#initialize' do
+          it 'should set mode to out and go low' do
+            board.should_receive(:set_pin_mode).with(14, :out, nil)
+            board.should_receive(:digital_write).with(14, Board::LOW)
+
+            BaseOutput.new(options)
+          end
+        end
+
+        describe '#digital_write' do
+          it 'should update the @state instance variable and call #digital_write on the board' do
+            board.should_receive(:digital_write).with(subject.pin, Board::HIGH).once
+            
+            subject.digital_write(Board::HIGH)
+            subject.state.should == Board::HIGH
+          end
+        end
+
+        describe '#analog_write' do
+          it 'should update the @state instance variable and call #analog_write on the board' do
+            board.should_receive(:analog_write).with(subject.pin, 128).once
+            
+            subject.analog_write(128)
+            subject.state.should == 128
+          end
+        end
+
+        describe '#write' do
+          it 'should call #digital_write if value is HIGH' do
+            subject.should_receive(:digital_write).with(Board::HIGH)
+            subject.write(Board::HIGH)
+          end
+
+
+          it 'should call #digital_write if value is LOW' do
+            subject.should_receive(:digital_write).with(Board::LOW)
+            subject.write(Board::LOW)
+          end
+
+          it 'should call #analog_write if value is anything else' do
+            subject.should_receive(:analog_write).with(128)
+            subject.write(128)
+          end
+        end
+
+        describe '#high' do
+          it 'should call #digital_write with HIGH' do
+            subject.should_receive(:digital_write).with(Board::HIGH)
+            subject.high
+          end
+        end
+
+        describe '#low' do
+          it 'should call #digital_write with LOW' do
+            subject.should_receive(:digital_write).with(Board::LOW)
+            subject.low
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/core/base_spec.rb b/spec/lib/components/core/base_spec.rb
index 12184c13..61147f4b 100644
--- a/spec/lib/components/core/base_spec.rb
+++ b/spec/lib/components/core/base_spec.rb
@@ -4,40 +4,33 @@ module Dino
   module Components
     module Core
       describe Base do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board } }
+        subject { Base.new(options) }
+        
+        describe '#initialize' do
+          it 'should convert the pin to an integer' do
+            board.should_receive(:convert_pin).with(options[:pin])
 
-        it 'should initialize with board and pin' do
-          pin = "a pin"
-          board = "a board"
-          component = Base.new(pin: pin, board: board)
-
-          component.pin.should == pin
-          component.board.should == board
-        end
-
-        it 'should assign pins' do
-          pins = {red: 'red', green: 'green', blue: 'blue'}
-          board = "a board"
-          component = Base.new(pins: pins, board: board)
-
-          component.pins.should == pins
-        end
+            component = Base.new(options)
+          end
 
-        it 'should require a pin or pins' do
-          expect {
-            Base.new(board: 'some board')
-          }.to raise_exception
-        end
+          it 'should require a pin' do
+            expect {
+              Base.new(board: board)
+            }.to raise_exception
+          end
 
-        it 'should require a board' do
-          expect {
-            Base.new(pin: 'some pin')
-          }.to raise_exception
+          it 'should require a board' do
+            expect {
+              Base.new(pin: 'A0')
+            }.to raise_exception
+          end
         end
 
-        context "when subclassed #after_initialize should be executed" do
-
+        context "when subclassed" do
           class SpecComponent < Base
-
             def sucessfully_initialized? ; @success ; end
 
             def options ; @options ; end
@@ -48,18 +41,31 @@ def after_initialize(options={})
             end
           end
 
-          let(:options) { { pin: pin, board: board } }
-          let(:pin) { "a pin" }
-          let(:board) { "a board" }
-
           it "should call #after_initialize with options" do
             component = SpecComponent.new(options)
             component.should be_sucessfully_initialized
             component.options.should eq options
           end
         end
+
+        describe '#mode=' do
+          it 'should tell the board to set the pin mode' do
+            board.should_receive(:set_pin_mode).with(subject.pin, :out, nil)
+
+            subject.send(:mode=, :out)
+            subject.mode.should == :out 
+          end
+        end
+
+        describe '#pullup=' do
+          it 'should tell the board to set the pullup mode' do
+            board.should_receive(:set_pullup).with(subject.pin, true)
+
+            subject.send(:pullup=, true)
+            subject.pullup.should == true
+          end
+        end
       end
     end
   end
 end
-
diff --git a/spec/lib/components/core/digital_input_spec.rb b/spec/lib/components/core/digital_input_spec.rb
new file mode 100644
index 00000000..4a73ca63
--- /dev/null
+++ b/spec/lib/components/core/digital_input_spec.rb
@@ -0,0 +1,66 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Core
+      describe DigitalInput do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board } }
+        subject { DigitalInput.new(options) }
+
+        describe '#initialize' do
+          it 'should start listening immediately' do
+            board.should_receive(:digital_listen).with(14)
+
+            component = DigitalInput.new(options)
+          end
+        end
+
+        describe '#poll' do
+          it 'should send #digital_read to the board with its pin' do
+            board.should_receive(:digital_read).with(subject.pin)
+            subject.read
+          end
+        end
+
+        describe '#start_listening' do
+          it 'should send #digital_listen to the board with its pin' do
+            subject
+            subject.stop_listening
+            board.should_receive(:digital_listen).with(subject.pin)
+
+            subject.start_listening
+          end
+        end
+
+        context 'callbacks' do
+          before :each do
+            @low_callback = mock
+            @high_callback = mock
+            subject.on_low { @low_callback.called }
+            subject.on_high { @high_callback.called }
+          end
+
+          describe '#on_low' do
+            it 'should add a callback that only gets fired when LOW' do
+              @low_callback.should_receive(:called)
+              @high_callback.should_not_receive(:called)
+
+              subject.update(DigitalInput::LOW)
+            end 
+          end
+
+          describe '#on_high' do
+            it 'should add a callback that only gets fired when HIGH' do
+              @low_callback.should_not_receive(:called)
+              @high_callback.should_receive(:called)
+
+              subject.update(DigitalInput::HIGH)
+            end 
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/core/multi_pin_spec.rb b/spec/lib/components/core/multi_pin_spec.rb
new file mode 100644
index 00000000..8657f4e1
--- /dev/null
+++ b/spec/lib/components/core/multi_pin_spec.rb
@@ -0,0 +1,78 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Core
+      describe MultiPin do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pins: {red: 9, blue: 10}, board: board } }
+
+        describe '#initialize' do
+          it 'should require a pin' do
+            expect {
+              MultiPin.new(board: board)
+            }.to raise_exception
+          end
+
+          it 'should require a board' do
+            expect {
+              MultiPin.new(pins: options[:pins])
+            }.to raise_exception
+          end
+        end
+
+        context "when subclassed" do
+          class MPComponent < MultiPin
+            def sucessfully_initialized? ; @success ; end
+
+            def options ; @options ; end
+
+            def after_initialize(options={})
+              @success = true
+              @options = options
+              proxy red: BaseOutput, blue: BaseInput
+            end
+          end
+
+          it "should call #after_initialize with options" do
+            component = MPComponent.new(options)
+            component.should be_sucessfully_initialized
+            component.options.should eq options
+          end
+
+          describe '#proxy' do
+            it 'should raise if any of the required pins are missing' do
+              expect {
+                MPComponent.new(board: board, pins: {blue: 11})
+              }.to raise_exception(/red/)
+            end
+
+            it 'should create the right class of proxy component for each pin with the right options' do
+              BaseOutput.should_receive(:new).with({board: board, pin: options[:pins][:red], pullup: nil })
+              BaseInput.should_receive(:new).with({board: board, pin: options[:pins][:blue], pullup: true})
+
+              MPComponent.new options.merge(pullups: {blue: true})
+            end
+
+            it 'should assign the proxy commponent to the right instance variable' do
+              component = MPComponent.new(options)
+              component.red.class.should == BaseOutput
+              component.blue.class.should == BaseInput
+            end
+
+            describe '#states' do
+              it 'should return a hash corresponding to the state of each proxy component (pin)' do
+                component = MPComponent.new(options)
+                component.red.write(128)
+                component.blue.update(555)
+
+                component.state.should == {red: 128, blue: 555}
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/led_spec.rb b/spec/lib/components/led_spec.rb
index dd51c21c..9552e020 100644
--- a/spec/lib/components/led_spec.rb
+++ b/spec/lib/components/led_spec.rb
@@ -3,48 +3,6 @@
 module Dino
   module Components
     describe Led do
-      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
-
-      describe '#initialize' do
-        it 'should raise if it does not receive a pin' do
-          expect {
-            Led.new(board: board)
-          }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
-          expect {
-            Led.new(pins: {})
-          }.to raise_exception
-        end
-
-        it 'should set the pin to out' do
-          board.should_receive(:set_pin_mode).with(13, :out, nil)
-          Led.new(pin: 13, board: board)
-        end
-
-        it 'should set the pin to low' do
-          board.should_receive(:digital_write).with(13, Board::LOW)
-          Led.new(pin: 13, board: board)
-        end
-      end
-
-      describe '#on' do
-        it 'should send a high to the board with the pin' do
-          @led = Led.new(pin: 13, board: board)
-          board.should_receive(:digital_write).with(13, Board::HIGH)
-          @led.on
-        end
-      end
-
-      describe '#off' do
-        it 'should send a high to the board with the pin' do
-          @led = Led.new(pin: 13, board: board)
-          board.should_receive(:digital_write).with(13, Board::LOW)
-          @led.off
-        end
-      end
-
       describe '#blink' do
         it 'should turn the led off if it is on'
         it 'should not block'
diff --git a/spec/lib/components/rgb_led_spec.rb b/spec/lib/components/rgb_led_spec.rb
index 45ac741f..03e18fb6 100644
--- a/spec/lib/components/rgb_led_spec.rb
+++ b/spec/lib/components/rgb_led_spec.rb
@@ -3,119 +3,62 @@
 module Dino
   module Components
     describe RgbLed do
-      let(:board) { mock(:board, analog_write: true, set_pin_mode: true) }
-      let(:pins) { {red: 1, green: 2, blue: 3} }
-      let(:rgb) { RgbLed.new(pins: pins, board: board)}
+      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Board.new(txrx) }
+      let(:options) { { board: board, pins: {red: 1, green: 2, blue: 3} } }
+      subject { RgbLed.new(options) }
 
       describe '#initialize' do
-        it 'should raise if it does not receive a pin' do
-          expect {
-            RgbLed.new(board: 'a board')
-          }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
-          expect {
-            RgbLed.new(pins: pins)
-          }.to raise_exception
-        end
-
-        it 'should set the pin to out' do
-          board.should_receive(:set_pin_mode).with(1, :out, nil)
-          board.should_receive(:set_pin_mode).with(2, :out, nil)
-          board.should_receive(:set_pin_mode).with(3, :out, nil)
-
-          RgbLed.new(pins: pins, board: board)
-        end
-
-        it 'should set the pin to low' do
-          board.should_receive(:analog_write).with(1, Board::LOW)
-          board.should_receive(:analog_write).with(2, Board::LOW)
-          board.should_receive(:analog_write).with(3, Board::LOW)
-
-          RgbLed.new(pins: pins, board: board)
+        it 'should create a BaseOutput instance for each pin' do
+          led = RgbLed.new(options)
+          
+          led.red.class.should == Core::BaseOutput
+          led.green.class.should == Core::BaseOutput
+          led.blue.class.should == Core::BaseOutput
         end
       end
 
-      describe '#red' do
-        it 'should set red to high, blue and green to low' do
-          board.should_receive(:analog_write).with(1, Board::HIGH)
-          board.should_receive(:analog_write).with(2, Board::LOW)
-          board.should_receive(:analog_write).with(3, Board::LOW)
-          rgb.red
-        end
-      end
+      describe '#write' do
+        it 'should write the elements of the array to red, green and blue' do
+          subject.red.should_receive(:write).with(0)
+          subject.green.should_receive(:write).with(128)
+          subject.blue.should_receive(:write).with(0)
 
-      describe '#green' do
-        it 'should set green to high, red and blue to low' do
-          board.should_receive(:analog_write).with(1, Board::LOW)
-          board.should_receive(:analog_write).with(2, Board::HIGH)
-          board.should_receive(:analog_write).with(3, Board::LOW)
-          rgb.green
+          subject.write [0, 128, 0]
         end
       end
 
-      describe '#blue' do
-        it 'should set blue to high, red and green to low' do
-          board.should_receive(:analog_write).with(1, Board::LOW)
-          board.should_receive(:analog_write).with(2, Board::LOW)
-          board.should_receive(:analog_write).with(3, Board::HIGH)
-          rgb.blue
+      describe '#color=' do
+        it 'should write an array of values' do
+          subject.should_receive(:write).with([128, 0, 0])
+          subject.color = [128, 0, 0]
         end
-      end
-
-      describe '#cyan' do
-        it 'should set blue and green to high, red to low' do
-          board.should_receive(:analog_write).with(1, Board::LOW)
-          board.should_receive(:analog_write).with(2, Board::HIGH)
-          board.should_receive(:analog_write).with(3, Board::HIGH)
-          rgb.cyan
-        end
-      end
-
-      describe '#yellow' do
-        it 'should set red and green to high, blue to low' do
-          board.should_receive(:analog_write).with(1, Board::HIGH)
-          board.should_receive(:analog_write).with(2, Board::HIGH)
-          board.should_receive(:analog_write).with(3, Board::LOW)
-          rgb.yellow
-        end
-      end
-
-      describe '#magenta' do
-        it 'should set red and blue to high, green to low' do
-          board.should_receive(:analog_write).with(1, Board::HIGH)
-          board.should_receive(:analog_write).with(2, Board::LOW)
-          board.should_receive(:analog_write).with(3, Board::HIGH)
-          rgb.magenta
-        end
-      end
-
-      describe '#white' do
-        it 'should set all to high' do
-          board.should_receive(:analog_write).with(1, Board::HIGH)
-          board.should_receive(:analog_write).with(2, Board::HIGH)
-          board.should_receive(:analog_write).with(3, Board::HIGH)
-          rgb.white
-        end
-      end
 
-      describe '#off' do
-        it 'should set all to low' do
-          board.should_receive(:analog_write).with(1, Board::LOW)
-          board.should_receive(:analog_write).with(2, Board::LOW)
-          board.should_receive(:analog_write).with(3, Board::LOW)
-          rgb.off
+        it 'should look up named colors in COLORS whether passed in as symbol or string' do
+          colors = {
+            red:     [255, 000, 000],
+            green:   [000, 255, 000],
+            blue:    [000, 000, 255],
+            cyan:    [000, 255, 255],
+            yellow:  [255, 255, 000],
+            magenta: [255, 000, 255],
+            white:   [255, 255, 255],
+            off:     [000, 000, 000]
+          }
+          colors.each_value { |color| subject.should_receive(:write).with(color).twice }
+
+          colors.each_key { |key| subject.color = key }
+          colors.each_key { |key| subject.color = key.to_s }
         end
       end
 
-      describe '#blinky' do
-        it 'should set blue to high, red and green to low' do
+      describe '#cycle' do
+        it 'should cycle through the 3 base colors' do
           Array.any_instance.should_receive(:cycle).and_yield(:red).and_yield(:green).and_yield(:blue)
-          rgb.should_receive(:red)
-          rgb.should_receive(:green)
-          rgb.should_receive(:blue)
-          rgb.blinky
+          subject.should_receive(:color=).with(:red)
+          subject.should_receive(:color=).with(:green)
+          subject.should_receive(:color=).with(:blue)
+          subject.cycle
         end
       end
     end
diff --git a/spec/lib/components/sensor_spec.rb b/spec/lib/components/sensor_spec.rb
index fb36fe1e..589a4587 100644
--- a/spec/lib/components/sensor_spec.rb
+++ b/spec/lib/components/sensor_spec.rb
@@ -3,88 +3,6 @@
 module Dino
   module Components
     describe Sensor do
-
-      let(:board){mock(:board).as_null_object}
-      let(:sensor) {Sensor.new(board: board, pin: 7)}
-
-      describe '#initalize' do
-        it 'should raise if it does not receive a pin' do
-          expect { Sensor.new(board: board) }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
-          expect { Sensor.new(pin: 7) }.to raise_exception
-        end
-
-        it 'should add itself to the board and start read' do
-          board.should_receive(:add_input_hardware)
-          board.should_receive(:start_read)
-          Sensor.new(board: board, pin: 7)
-        end
-
-        it 'should initalize callbacks' do
-          sensor.instance_variable_get(:@callbacks).should == {}
-        end
-      end
-
-      describe '#read' do
-        it 'should tell the board to read once' do
-          board.should_receive(:analog_read).with(7)
-          sensor.read
-        end
-
-        it 'should accept a callback as block and add to @callbacks[:read]'
-      end
-
-      describe '#listen' do
-        it 'should tell the board to start listening' do
-          board.should_receive(:analog_listen).with(7)
-          sensor.listen
-        end
-
-        it 'should accept a callback as block and add to @callbacks[:listen]'
-      end
-
-      describe '#add_callback' do
-        it 'should require a key'
-        it 'should add the block to the array corresponding to the key in the @callbacks hash'
-      end
-
-      describe '#clear_callbacks' do
-        it 'should clear all callbacks if called with no key' do
-          sensor.on_data { |data| puts data }
-          sensor.on_data(:test) { |data| puts data }
-          sensor.clear_callbacks
-          sensor.instance_variable_get(:@callbacks).should == {}
-        end
-
-        it 'should clear callbacks of a particular key if called with a key'
-      end
-
-      describe '#on_data' do 
-        it "should add a callback with the :persistent key" do
-          sensor.on_data { "this is a block" }
-          sensor.instance_variable_get(:@callbacks)[:persistent].should_not be_empty
-        end
-      end
-
-      describe '#update' do
-        it 'should call all callbacks passing in the given data' do
-          sensor = Sensor.new(board: board, pin: 'a pin')
-          
-          first_block_data = nil
-          second_block_data = nil
-          sensor.on_data do |data|
-            first_block_data = data
-          end
-          sensor.on_data do |data|
-            second_block_data = data
-          end
-
-          sensor.update('Some data')
-          [first_block_data, second_block_data].each { |block_data| block_data.should == "Some data" }
-        end
-      end
     end
   end
 end
diff --git a/spec/lib/components/servo_spec.rb b/spec/lib/components/servo_spec.rb
index c96ab6be..10639774 100644
--- a/spec/lib/components/servo_spec.rb
+++ b/spec/lib/components/servo_spec.rb
@@ -3,29 +3,15 @@
 module Dino
   module Components
     describe Servo do
-      let(:board) { mock(:board, analog_write: true, set_pin_mode: true, servo_toggle: true, servo_write: true) }
+      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Board.new(txrx) }
+      let(:options) { { board: board, pin: 9 } }
+      subject { Servo.new(options)  }
 
       describe '#initialize' do
-        it 'should raise if it does not receive a pin' do
-          expect {
-            Servo.new(board: board)
-          }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
-          expect {
-            Servo.new(pin: 13)
-          }.to raise_exception
-        end
-
-        it 'should set the pins to out' do
-          board.should_receive(:set_pin_mode).with(13, :out, nil)
-          Servo.new(pin: 13, board: board)
-        end
-
-        it 'should set the inital position to 0' do
-          servo =  Servo.new(pin: 13, board: board)
-          servo.instance_variable_get(:@position).should == 0
+        it 'should toggle the servo library on for the pin' do
+          board.should_receive(:servo_toggle).with(options[:pin], 1)
+          subject
         end
       end
 
@@ -34,17 +20,17 @@ module Components
 
         it 'should set the position of the Servo' do
           servo.position = 90
-          servo.instance_variable_get(:@position).should == 90
+          servo.position.should == 90
         end
 
         it 'should let you write up to 180' do
           servo.position = 180
-          servo.instance_variable_get(:@position).should == 180
+          servo.position.should == 180
         end
 
         it 'should modulate when position > 180' do
           servo.position = 190
-          servo.instance_variable_get(:@position).should == 10
+          servo.position.should == 10
         end
 
         it 'should write the new position to the board' do
diff --git a/spec/lib/components/shift_register_spec.rb b/spec/lib/components/shift_register_spec.rb
index fc7a9202..7b38bbac 100644
--- a/spec/lib/components/shift_register_spec.rb
+++ b/spec/lib/components/shift_register_spec.rb
@@ -3,53 +3,35 @@
 module Dino
   module Components
     describe ShiftRegister do
-      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
-
-      subject { ShiftRegister.new board: board, pins: {clock: 12, data: 11, latch: 8} }
+      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Board.new(txrx) }
+      let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
+      subject { ShiftRegister.new(options)  }
 
       describe '#initialize' do
-        it 'should set all pins to out and low' do
-          board.should_receive(:set_pin_mode).with(12, :out, nil)
-          board.should_receive(:set_pin_mode).with(11, :out, nil)
-          board.should_receive(:set_pin_mode).with(8,  :out, nil)
-          board.should_receive(:digital_write).with(12, Board::LOW)
-          board.should_receive(:digital_write).with(11, Board::LOW)
-          board.should_receive(:digital_write).with(8,  Board::LOW)
-
-          ShiftRegister.new(pins: {clock: 12, data: 11, latch: 8}, board: board)
-        end
-      end
-
-      describe '#latch_off' do
-        it 'should set the latch pin low' do
-          board.should_receive(:digital_write).with(8, Board::LOW)
-
-          subject.latch_off
-        end
-      end
-
-      describe '#latch_off' do
-        it 'should set the latch pin high' do
-          board.should_receive(:digital_write).with(8, Board::HIGH)
-
-          subject.latch_on
+        it 'should create a BaseOutput instance for each pin' do
+          subject.clock.class.should == Core::BaseOutput
+          subject.latch.class.should == Core::BaseOutput
+          subject.data.class.should == Core::BaseOutput
         end
       end
 
       describe '#write' do
+        before(:each) { subject }
+
         it 'should write a single byte as value and clock pin as aux to the data pin' do
-          board.should_receive(:convert_pin).with(11) { |pin| pin }
-          board.should_receive(:convert_pin).with(12) { |pin| pin }
+          subject.latch.should_receive(:digital_write).with(Board::LOW)
           board.should_receive(:write).with "11.11.255.12\n"
+          subject.latch.should_receive(:digital_write).with(Board::HIGH)
 
           subject.write(255)
         end
 
         it 'should write an array of bytes as value and clock pin as aux to the data pin' do
-          board.should_receive(:convert_pin).with(11) { |pin| pin }
-          board.should_receive(:convert_pin).with(12) { |pin| pin }
+          subject.latch.should_receive(:digital_write).with(Board::LOW)
           board.should_receive(:write).with "11.11.255.12\n"
           board.should_receive(:write).with "11.11.0.12\n"
+          subject.latch.should_receive(:digital_write).with(Board::HIGH)
 
           subject.write([255,0])
         end
diff --git a/spec/lib/components/ssd_spec.rb b/spec/lib/components/ssd_spec.rb
index c6b0fc6d..ac0d90f8 100644
--- a/spec/lib/components/ssd_spec.rb
+++ b/spec/lib/components/ssd_spec.rb
@@ -3,89 +3,75 @@
 module Dino
   module Components
     describe SSD do
+      let(:txrx)  { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Board.new(txrx) }
       let(:anode) { 11 }
       let(:pins)  { [12,13,3,4,5,10,9] }
-
-      let(:board) do
-        mock(:board, digital_write: true, set_pin_mode: true)
-      end
-
-      let(:ssd) do
-        SSD.new board: board, pins: pins, anode: anode
-      end
+      subject   { SSD.new(board: board, pins: pins, anode: anode) }
 
       describe '#initialize' do
-        it 'should raise if it does not receive a pin' do
-          expect { SSD.new(board: board, anode: anode) }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
-          expect { SSD.new(pins: pins, anode: anode) }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
+        it 'should raise if it does not receive an anode' do
           expect { SSD.new(board: board, pins: pins) }.to raise_exception
         end
 
-        it 'should set the pins to out' do
-          pins.each do |pin|
-            board.should_receive(:set_pin_mode).with(pin, :out, nil)
-          end
+        it 'should create a Core::BaseOutput for the anode and each pin' do
+          subject
 
-          ssd.after_initialize(anode: anode)
+          subject.anode.class.should == Core::BaseOutput
+          subject.pins.each { |pin| pin.class.should == Core::BaseOutput}
         end
 
         it "should clear the display" do
-          ssd.should_receive(:clear).once
-          ssd.after_initialize(anode: anode)
+          SSD.any_instance.should_receive(:clear).once
+          SSD.new(board: board, pins: pins, anode: anode)
         end
 
         it "should turn on the display" do
-          ssd.should_receive(:on).once
-          ssd.after_initialize(anode: anode)
+          SSD.any_instance.should_receive(:on).once
+          SSD.new(board: board, pins: pins, anode: anode)
         end
       end
 
       describe '#clear' do
         it 'should toggle all the seven leds to off' do
-          ssd.should_receive(:toggle).exactly(7).with(anything, 0)
-          ssd.clear
+          subject.should_receive(:toggle).exactly(7).with(anything, 0)
+          subject.clear
         end
       end
 
       describe '#on' do
         it 'should turn the ssd on' do
-          board.should_receive(:digital_write).with(anode, Board::HIGH)
-          ssd.on
+          subject.anode.should_receive(:digital_write).with(Board::HIGH)
+          subject.on
         end
       end
 
       describe '#off' do
         it 'should turn the ssd off' do
-          board.should_receive(:digital_write).with(anode, Board::LOW)
-          ssd.off
+          subject.anode.should_receive(:digital_write).with(Board::LOW)
+          subject.off
         end
       end
 
       describe '#display' do
         it "should scroll on multiple characters" do
-          ssd.should_receive(:scroll).with('FOO')
-          ssd.display('foo')
+          subject.should_receive(:scroll).with('FOO')
+          subject.display('foo')
         end
 
         it "should make sure the ssd is turned on" do
-          ssd.should_receive(:on)
-          ssd.display(1)
+          subject.should_receive(:on)
+          subject.display(1)
         end
 
         it "should clear the display on unknown character" do
-          ssd.should_receive(:clear)
-          ssd.display('+')
+          subject.should_receive(:clear)
+          subject.display('+')
         end
 
         it "should toggle all the segments in order to display a character" do
-          ssd.should_receive(:toggle).exactly(7)
-          ssd.display('7')
+          subject.should_receive(:toggle).exactly(7)
+          subject.display('7')
         end
       end
     end
diff --git a/spec/lib/components/stepper_spec.rb b/spec/lib/components/stepper_spec.rb
index 013eee9d..a37e1b23 100644
--- a/spec/lib/components/stepper_spec.rb
+++ b/spec/lib/components/stepper_spec.rb
@@ -3,56 +3,36 @@
 module Dino
   module Components
     describe Stepper do
-      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
+      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Board.new(txrx) }
+      let(:options) { { pins: {step: 9, direction: 10}, board: board } }
 
-      describe '#initialize' do
-        it 'should raise if it does not receive a step pin' do
-          expect {
-            Stepper.new(board: board)
-          }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a direction pin' do
-          expect {
-            Stepper.new(board: board)
-          }.to raise_exception
-        end
-
-        it 'should raise if it does not receive a board' do
-          expect {
-            Stepper.new(pins: {step: 12, direction: 13})
-          }.to raise_exception
-        end
+      subject { Stepper.new(options) }
 
-        it 'should set the pins to out' do
-          board.should_receive(:set_pin_mode).with(13, :out, nil)
-          board.should_receive(:set_pin_mode).with(12, :out, nil)
-          Stepper.new(pins: {step: 13, direction: 12}, board: board)
-        end
-
-        it 'should set the step pin to low' do
-          board.should_receive(:digital_write).with(13, Board::LOW)
-          Stepper.new(pins: {step: 13, direction: 12}, board: board)
+      describe '#initialize' do
+        it 'should create a BaseOutput instance for each pin' do          
+          subject.step.class.should == Core::BaseOutput
+          subject.direction.class.should == Core::BaseOutput
         end
       end
 
       describe '#step_cc' do
-        it 'should send a high to the board with the pin' do
-          @stepper = Stepper.new(pins: {step: 13, direction: 12}, board: board)
-          board.should_receive(:digital_write).with(12, Board::HIGH)
-          board.should_receive(:digital_write).with(13, Board::HIGH)
-          board.should_receive(:digital_write).with(13, Board::LOW)
-          @stepper.step_cc
+        it 'should send high to the step pin with the direction pin high' do
+          subject.direction.should_receive(:digital_write).with(Board::HIGH)
+          subject.step.should_receive(:digital_write).with(Board::HIGH)
+          subject.step.should_receive(:digital_write).with(Board::LOW)
+
+          subject.step_cc
         end
       end
 
       describe '#step_cw' do
-        it 'should send a high to the board with the pin' do
-          @stepper = Stepper.new(pins: {step: 13, direction: 12}, board: board)
-          board.should_receive(:digital_write).with(12, Board::LOW)
-          board.should_receive(:digital_write).with(13, Board::HIGH)
-          board.should_receive(:digital_write).with(13, Board::LOW)
-          @stepper.step_cw
+        it 'should send high to the board with the direction pin low' do
+          subject.direction.should_receive(:digital_write).with(Board::LOW)
+          subject.step.should_receive(:digital_write).with(Board::HIGH)
+          subject.step.should_receive(:digital_write).with(Board::LOW)
+
+          subject.step_cw
         end
       end
     end

From 5fa9b9602f65bd4334d523d73e3361b5670420ff Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 12 Jun 2013 21:12:16 -0400
Subject: [PATCH 027/296] Core::Threaded mixin to provide components with a
 managed thread Updated LED example with non-blocking blink

---
 examples/led/led.rb                          |  17 ++-
 lib/dino/components.rb                       |   1 +
 lib/dino/components/core.rb                  |   1 +
 lib/dino/components/core/base_input.rb       |   2 -
 lib/dino/components/core/base_output.rb      |   7 +-
 lib/dino/components/core/threaded.rb         |  51 +++++++++
 lib/dino/components/led.rb                   |   8 +-
 lib/dino/components/relay.rb                 |   6 ++
 spec/lib/components/core/base_output_spec.rb |  16 +++
 spec/lib/components/core/threaded_spec.rb    | 104 +++++++++++++++++++
 spec/lib/components/led_spec.rb              |   4 -
 11 files changed, 204 insertions(+), 13 deletions(-)
 create mode 100644 lib/dino/components/core/threaded.rb
 create mode 100644 lib/dino/components/relay.rb
 create mode 100644 spec/lib/components/core/threaded_spec.rb

diff --git a/examples/led/led.rb b/examples/led/led.rb
index 9cc4182c..f7b8b7a7 100644
--- a/examples/led/led.rb
+++ b/examples/led/led.rb
@@ -8,7 +8,16 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 led = Dino::Components::Led.new(pin: 13, board: board)
 
-[:on, :off].cycle do |switch|
-  led.send(switch)
-  sleep 0.5
-end
+# Start blinking every half second.
+led.blink 0.5
+
+# Wait for 5 seconds. #blink does not block.
+sleep 5
+
+# Calling #on implicitly stops #blink.
+led.on
+sleep 5
+
+# Blink faster.
+led.blink 0.25
+sleep
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 7c06c3e7..6ff4354a 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -11,5 +11,6 @@ module Components
     autoload :IrReceiver,     'dino/components/ir_receiver'
     autoload :LCD,            'dino/components/lcd'
     autoload :ShiftRegister,  'dino/components/shift_register'
+    autoload :Relay,          'dino/components/relay'
   end
 end
diff --git a/lib/dino/components/core.rb b/lib/dino/components/core.rb
index 2ef4d795..f0eac0e8 100644
--- a/lib/dino/components/core.rb
+++ b/lib/dino/components/core.rb
@@ -3,6 +3,7 @@ module Components
     module Core
       require 'dino/components/core/base'
       require 'dino/components/core/multi_pin'
+      require 'dino/components/core/threaded'
       require 'dino/components/core/base_input'
       require 'dino/components/core/analog_input'
       require 'dino/components/core/digital_input'
diff --git a/lib/dino/components/core/base_input.rb b/lib/dino/components/core/base_input.rb
index 5d2dfe96..63dd48cb 100644
--- a/lib/dino/components/core/base_input.rb
+++ b/lib/dino/components/core/base_input.rb
@@ -2,8 +2,6 @@ module Dino
   module Components
     module Core
       class BaseInput < Base
-        attr_reader :state
-
         def initialize(options={})
           super options
 
diff --git a/lib/dino/components/core/base_output.rb b/lib/dino/components/core/base_output.rb
index 103f8977..c73d83d8 100644
--- a/lib/dino/components/core/base_output.rb
+++ b/lib/dino/components/core/base_output.rb
@@ -2,7 +2,8 @@ module Dino
   module Components
     module Core
       class BaseOutput < Base
-        attr_reader :state
+        include Threaded
+        interrupt_with :digital_write, :analog_write
 
         def initialize(options={})
           super options
@@ -35,6 +36,10 @@ def high
           digital_write Board::HIGH
         end
 
+        def toggle
+          state == Board::LOW ? high : low
+        end
+
         alias :off :low
         alias :on  :high
       end
diff --git a/lib/dino/components/core/threaded.rb b/lib/dino/components/core/threaded.rb
new file mode 100644
index 00000000..a1b20329
--- /dev/null
+++ b/lib/dino/components/core/threaded.rb
@@ -0,0 +1,51 @@
+module Dino
+  module Components
+    module Core
+      module Threaded
+        attr_reader :thread, :interrupts_enabled
+
+        def self.included(base)
+          base.extend(ClassMethods)
+        end
+
+        module ClassMethods
+          def interrupt_with(*args)
+            interrupts = self.class_eval('@@interrupts') rescue []
+            args.each { |a| interrupts << a }
+            self.class_variable_set(:@@interrupts, interrupts)
+          end
+        end
+
+        def threaded(&block)
+          stop_thread
+          enable_interrupts unless interrupts_enabled
+          @thread = Thread.new { block.call}
+        end
+
+        def threaded_loop(&block)
+          threaded do 
+            loop { block.call }
+          end
+        end
+
+        def stop_thread
+          @thread.kill if @thread
+        end
+
+        def enable_interrupts
+          interrupts = self.class.class_eval('@@interrupts')
+          interrupts.each do |method_name|
+            standard_method = self.method(method_name)
+
+            singleton_class.send(:define_method, method_name) do |*args|
+              stop_thread unless (Thread.current == @thread)
+              standard_method.call(*args)
+            end
+          end
+
+          @interrupts_enabled = true
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/led.rb b/lib/dino/components/led.rb
index 302d103d..b8f8dff8 100644
--- a/lib/dino/components/led.rb
+++ b/lib/dino/components/led.rb
@@ -1,8 +1,12 @@
 module Dino
   module Components
     class Led < Core::BaseOutput
-      alias :on  :high
-      alias :off :low
+      def blink(interval=0.5)
+        threaded_loop do 
+          toggle
+          sleep interval
+        end
+      end
     end
   end
 end
diff --git a/lib/dino/components/relay.rb b/lib/dino/components/relay.rb
new file mode 100644
index 00000000..3b285532
--- /dev/null
+++ b/lib/dino/components/relay.rb
@@ -0,0 +1,6 @@
+module Dino
+  module Components
+    class Relay < Core::BaseOutput
+    end
+  end
+end
diff --git a/spec/lib/components/core/base_output_spec.rb b/spec/lib/components/core/base_output_spec.rb
index 8552d604..5f166d10 100644
--- a/spec/lib/components/core/base_output_spec.rb
+++ b/spec/lib/components/core/base_output_spec.rb
@@ -69,6 +69,22 @@ module Core
             subject.low
           end
         end
+
+        describe '#toggle' do
+          it 'should call high if currently LOW' do
+            subject.low
+            subject.should_receive(:high)
+
+            subject.toggle
+          end
+
+          it 'should call LOW if anything else' do
+            subject.high
+            subject.should_receive(:low)
+
+            subject.toggle
+          end
+        end
       end
     end
   end
diff --git a/spec/lib/components/core/threaded_spec.rb b/spec/lib/components/core/threaded_spec.rb
new file mode 100644
index 00000000..4297428e
--- /dev/null
+++ b/spec/lib/components/core/threaded_spec.rb
@@ -0,0 +1,104 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Core
+      describe Threaded do
+        class ThreadedComponent
+          include Threaded
+          interrupt_with :interrupt_it
+          def interrupt_it; end
+          def dont_interrupt_it; end
+        end
+
+        subject { ThreadedComponent.new }
+
+        describe '#threaded' do
+          it 'should stop the existing thread' do
+            subject.should_receive(:stop_thread)
+            subject.threaded { mock }
+          end
+
+          it 'should enable interrupts on the first threaded call' do
+            subject.should_receive(:enable_interrupts).once
+            thread = subject.threaded { mock }
+          end
+
+          it 'should start a thread and call the block passed.' do
+            block = mock
+            Thread.should_receive(:new).once.and_yield
+            block.should_receive(:call)
+
+            subject.threaded { block.call }
+          end
+        end
+
+        describe '#stop_thread' do
+          it 'should kill the internal thread' do
+            subject.threaded { sleep }
+            subject.thread.should_receive(:kill)
+
+            subject.stop_thread
+          end
+        end
+
+        describe '#enable_interrupts' do
+          it 'should set @enable_interrupts to true' do
+            subject.enable_interrupts
+            subject.interrupts_enabled.should == true
+          end
+        end
+
+        context 'interrupts' do
+          it 'should make method names passed to #interrupt_with stop the internal thread' do
+            subject.threaded { sleep }
+            subject.should_receive(:stop_thread)
+
+            subject.interrupt_it
+          end
+
+          it 'should not make other methods stop the internal thread' do
+            subject.threaded { sleep }
+            subject.should_not_receive(:stop_thread)
+
+            subject.dont_interrupt_it
+          end
+        end
+
+        context 'with multiple threads' do
+          it 'should let other threads interrupt the internal thread' do
+            subject.threaded {sleep}
+            subject.should_receive(:stop_thread)
+
+            subject.interrupt_it
+          end
+
+          it 'should not let the internal thread interrupt itself' do
+            subject.should_receive(:interrupt_it).exactly(10).times
+            subject.should_not_receive(:stop_thread)
+
+            # Simulate being inside the internal thread.
+            subject.enable_interrupts
+            subject.instance_variable_set(:@thread, Thread.current)
+            10.times { subject.interrupt_it }
+          end
+        end
+
+        context 'when included and then subclassed' do
+          it 'should allow calling #interrupt_with again' do
+            class SubThreaded < ThreadedComponent
+              interrupt_with :stop_it
+              def stop_it; end
+            end
+
+            component = SubThreaded.new
+            component.threaded { sleep }
+            component.should_receive(:stop_thread)
+
+            component.stop_it
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/led_spec.rb b/spec/lib/components/led_spec.rb
index 9552e020..845c9eee 100644
--- a/spec/lib/components/led_spec.rb
+++ b/spec/lib/components/led_spec.rb
@@ -3,10 +3,6 @@
 module Dino
   module Components
     describe Led do
-      describe '#blink' do
-        it 'should turn the led off if it is on'
-        it 'should not block'
-      end
     end
   end
 end

From d93c624b1143ec5248297e02f3fba2552e9e3d9d Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sun, 23 Jun 2013 18:06:00 -0400
Subject: [PATCH 028/296] Fix listeners on MEGA. Due support with default
 12-bit analog read.

---
 lib/dino/components/core/threaded.rb |  2 +-
 src/lib/Dino.cpp                     | 16 ++++++++--------
 src/lib/Dino.h                       |  4 ++++
 3 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/lib/dino/components/core/threaded.rb b/lib/dino/components/core/threaded.rb
index a1b20329..a55c93fd 100644
--- a/lib/dino/components/core/threaded.rb
+++ b/lib/dino/components/core/threaded.rb
@@ -33,7 +33,7 @@ def stop_thread
         end
 
         def enable_interrupts
-          interrupts = self.class.class_eval('@@interrupts')
+          interrupts = self.class.class_eval('@@interrupts') rescue []
           interrupts.each do |method_name|
             standard_method = self.method(method_name)
 
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index a61b579a..519d3547 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -116,7 +116,7 @@ void Dino::updateListeners() {
   }
 }
 void Dino::updateDigitalListeners() {
-  for (int i = 0; i < 22; i++) {
+  for (int i = 0; i < PIN_COUNT; i++) {
     if (digitalListeners[i]) {
       pin = i;
       dRead();
@@ -128,7 +128,7 @@ void Dino::updateDigitalListeners() {
   }
 }
 void Dino::updateAnalogListeners() {
-  for (int i = 0; i < 22; i++) {
+  for (int i = 0; i < PIN_COUNT; i++) {
     if (analogListeners[i]) {
       pin = i;
       aRead();
@@ -275,18 +275,18 @@ void Dino::shiftWrite() {
 
 // CMD = 90
 void Dino::reset() {
+  #ifdef ANALOG_RESOLUTION
+    analogReadResolution(ANALOG_RESOLUTION);
+  #endif
   heartRate = 4000; // Default heartRate is ~4ms.
   loopCount = 0;
   analogDivider = 4; // Update analog listeners every ~16ms.
-  for (int i = 0; i < 22; i++) digitalListeners[i] = false;
-  for (int i = 0; i < 22; i++) digitalListenerValues[i] = 2;
-  for (int i = 0; i < 22; i++)  analogListeners[i] = false;
+  for (int i = 0; i < PIN_COUNT; i++) digitalListeners[i] = false;
+  for (int i = 0; i < PIN_COUNT; i++) digitalListenerValues[i] = 2;
+  for (int i = 0; i < PIN_COUNT; i++)  analogListeners[i] = false;
   lastUpdate = micros();
   fragmentIndex = 0;
   charIndex = 0;
-  #ifdef debug
-    Serial.println("Reset the board to defaults.  pin ");
-  #endif
   sprintf(response, "ACK:%02d", A0);
 }
 
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 28b084a9..af07d51c 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -13,6 +13,10 @@
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
 #  define PIN_COUNT 70
 #  define SERVO_OFFSET 22
+#elif defined(__SAM3X8E__)
+#  define PIN_COUNT 66
+#  define SERVO_OFFSET 22
+#  define ANALOG_RESOLUTION 12
 #else
 #  define PIN_COUNT 22
 #  define SERVO_OFFSET 2

From 7f522aa6dff09eb612ca7fad2308050c2e37e56d Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 24 Jun 2013 16:16:54 -0400
Subject: [PATCH 029/296] Full Due support: 12bit IO, DACs, use native ARM
 serial port by default

---
 lib/dino/board.rb                            | 42 +++++++++++++++++---
 lib/dino/components/core/base_input.rb       |  2 +-
 lib/dino/components/core/base_output.rb      |  8 ++--
 lib/dino/tx_rx/base.rb                       |  2 +-
 spec/lib/board_spec.rb                       | 12 +++++-
 spec/lib/components/core/base_input_spec.rb  |  4 +-
 spec/lib/components/core/base_output_spec.rb | 20 +++++-----
 spec/lib/components/shift_register_spec.rb   |  8 ++--
 spec/lib/components/ssd_spec.rb              |  4 +-
 spec/lib/components/stepper_spec.rb          | 12 +++---
 src/dino_serial.ino                          | 13 ++++--
 src/lib/Dino.cpp                             | 21 ++++++++--
 src/lib/Dino.h                               |  4 +-
 13 files changed, 105 insertions(+), 47 deletions(-)

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index be83cb05..5989cb08 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -1,13 +1,25 @@
 module Dino
   class Board
-    attr_reader :input_hardware, :analog_zero
-    LOW, HIGH = 000, 255
+    attr_reader :high, :low, :input_hardware, :analog_zero, :dac_zero
     DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
-    def initialize(io)
+    def initialize(io, options={})
+      @bits = options[:bits] || 8
       @io, @input_hardware = io, []
       io.add_observer(self)
-      @analog_zero = @io.handshake
+
+      @analog_zero, @dac_zero = @io.handshake.to_s.split(",").map { |pin| pin.to_i }
+      define_logic
+    end
+
+    def define_logic
+      @low      = 0
+      @high     = (2 ** @bits) - 1
+      self.analog_resolution = @bits
+    end
+
+    def analog_resolution=(value)
+      write Dino::Message.encode(command: 96, value: value)
     end
 
     def analog_divider=(value)
@@ -58,7 +70,7 @@ def set_pin_mode(pin, mode, pullup=nil)
 
     def set_pullup(pin, pullup)
       pin = convert_pin(pin)
-      pullup ? digital_write(pin, HIGH) : digital_write(pin, LOW)
+      pullup ? digital_write(pin, @high) : digital_write(pin, @low)
     end
 
     PIN_COMMANDS = {
@@ -79,8 +91,26 @@ def set_pullup(pin, pullup)
       end
     end
 
+    DIGITAL_REGEX = /\A\d+\z/i
+    ANALOG_REGEX = /\A(a)\d+\z/i
+    DAC_REGEX = /\A(dac)\d+\z/i
+
     def convert_pin(pin)
-      pin.to_s.match(/\Aa/i) ? @analog_zero + pin.to_s.gsub(/\Aa/i, '').to_i : pin.to_i
+      pin = pin.to_s
+
+      return pin.to_i             if pin.match(DIGITAL_REGEX)
+      return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
+      return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
+
+      nil
+    end
+
+    def analog_pin_to_i(pin)
+      @analog_zero + pin.gsub(/\Aa/i, '').to_i
+    end
+
+    def dac_pin_to_i(pin)
+      @dac_zero + pin.gsub(/\Aa/i, '').to_i
     end
   end
 end
diff --git a/lib/dino/components/core/base_input.rb b/lib/dino/components/core/base_input.rb
index 63dd48cb..b0092d6b 100644
--- a/lib/dino/components/core/base_input.rb
+++ b/lib/dino/components/core/base_input.rb
@@ -40,7 +40,7 @@ def add_callback(key=nil, &block)
         alias :on_data :add_callback
 
         def remove_callback(key=nil)
-          key ? @callbacks[key] = nil : @callbacks = {}
+          key ? @callbacks[key] = [] : @callbacks = {}
         end
 
         alias :remove_callbacks :remove_callback
diff --git a/lib/dino/components/core/base_output.rb b/lib/dino/components/core/base_output.rb
index c73d83d8..ca61ab25 100644
--- a/lib/dino/components/core/base_output.rb
+++ b/lib/dino/components/core/base_output.rb
@@ -21,7 +21,7 @@ def analog_write(value)
         end
 
         def write(value)
-          unless [Board::LOW, Board::HIGH].include? value
+          unless [board.low, board.high].include? value
             analog_write(value)
           else
             digital_write(value)
@@ -29,15 +29,15 @@ def write(value)
         end
 
         def low
-          digital_write Board::LOW
+          digital_write(board.low)
         end
 
         def high
-          digital_write Board::HIGH
+          digital_write(board.high)
         end
 
         def toggle
-          state == Board::LOW ? high : low
+          state == board.low ? high : low
         end
 
         alias :off :low
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index b0c117c3..43bea08f 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -42,7 +42,7 @@ def handshake
               line = gets.to_s
               if line.match /ACK:/
                 flush_read
-                return line.chop.split(/:/)[1].to_i
+                return line.chop.split(/:/)[1]
               end
             end
           rescue
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 968885b8..ea15832e 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -24,6 +24,14 @@ def io_mock(methods = {})
         io_mock.should_receive(:handshake)
         subject
       end
+
+      it 'should define the logic properly' do
+        subject.should_receive(:analog_resolution=).with(8)
+
+        subject.send(:initialize, io_mock)
+        subject.high.should == 255
+        subject.low.should == 0
+      end
     end
 
     describe '#update' do
@@ -174,12 +182,12 @@ def io_mock(methods = {})
 
     describe '#set_pullup' do
       it 'should write high if pullup is enabled' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: Board::HIGH))
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.high))
         subject.set_pullup(13, true)
       end
 
       it 'should write low if pullup is disabled' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: Board::LOW))
+        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.low))
         subject.set_pullup(13, false)
       end
     end
diff --git a/spec/lib/components/core/base_input_spec.rb b/spec/lib/components/core/base_input_spec.rb
index b6f75c7b..94deb03b 100644
--- a/spec/lib/components/core/base_input_spec.rb
+++ b/spec/lib/components/core/base_input_spec.rb
@@ -45,7 +45,7 @@ module Core
               subject.add_callback(:test) { mock }
               subject.remove_callback(:test)
 
-              subject.instance_variable_get(:@callbacks)[:test].should be_nil
+              subject.instance_variable_get(:@callbacks)[:test].should be_empty
             end
           end
         end
@@ -110,7 +110,7 @@ module Core
             subject.add_callback(:read) { |data| first_block_data = data }
 
             subject.update("Some data")
-            subject.instance_variable_get(:@callbacks)[:read].should be_nil
+            subject.instance_variable_get(:@callbacks)[:read].should be_empty
           end
         end
       end
diff --git a/spec/lib/components/core/base_output_spec.rb b/spec/lib/components/core/base_output_spec.rb
index 5f166d10..99c1e5fb 100644
--- a/spec/lib/components/core/base_output_spec.rb
+++ b/spec/lib/components/core/base_output_spec.rb
@@ -14,7 +14,7 @@ module Core
         describe '#initialize' do
           it 'should set mode to out and go low' do
             board.should_receive(:set_pin_mode).with(14, :out, nil)
-            board.should_receive(:digital_write).with(14, Board::LOW)
+            board.should_receive(:digital_write).with(14, board.low)
 
             BaseOutput.new(options)
           end
@@ -22,10 +22,10 @@ module Core
 
         describe '#digital_write' do
           it 'should update the @state instance variable and call #digital_write on the board' do
-            board.should_receive(:digital_write).with(subject.pin, Board::HIGH).once
+            board.should_receive(:digital_write).with(subject.pin, board.high).once
             
-            subject.digital_write(Board::HIGH)
-            subject.state.should == Board::HIGH
+            subject.digital_write(board.high)
+            subject.state.should == board.high
           end
         end
 
@@ -40,14 +40,14 @@ module Core
 
         describe '#write' do
           it 'should call #digital_write if value is HIGH' do
-            subject.should_receive(:digital_write).with(Board::HIGH)
-            subject.write(Board::HIGH)
+            subject.should_receive(:digital_write).with(board.high)
+            subject.write(board.high)
           end
 
 
           it 'should call #digital_write if value is LOW' do
-            subject.should_receive(:digital_write).with(Board::LOW)
-            subject.write(Board::LOW)
+            subject.should_receive(:digital_write).with(board.low)
+            subject.write(board.low)
           end
 
           it 'should call #analog_write if value is anything else' do
@@ -58,14 +58,14 @@ module Core
 
         describe '#high' do
           it 'should call #digital_write with HIGH' do
-            subject.should_receive(:digital_write).with(Board::HIGH)
+            subject.should_receive(:digital_write).with(board.high)
             subject.high
           end
         end
 
         describe '#low' do
           it 'should call #digital_write with LOW' do
-            subject.should_receive(:digital_write).with(Board::LOW)
+            subject.should_receive(:digital_write).with(board.low)
             subject.low
           end
         end
diff --git a/spec/lib/components/shift_register_spec.rb b/spec/lib/components/shift_register_spec.rb
index 7b38bbac..dce07888 100644
--- a/spec/lib/components/shift_register_spec.rb
+++ b/spec/lib/components/shift_register_spec.rb
@@ -20,18 +20,18 @@ module Components
         before(:each) { subject }
 
         it 'should write a single byte as value and clock pin as aux to the data pin' do
-          subject.latch.should_receive(:digital_write).with(Board::LOW)
+          subject.latch.should_receive(:digital_write).with(board.low)
           board.should_receive(:write).with "11.11.255.12\n"
-          subject.latch.should_receive(:digital_write).with(Board::HIGH)
+          subject.latch.should_receive(:digital_write).with(board.high)
 
           subject.write(255)
         end
 
         it 'should write an array of bytes as value and clock pin as aux to the data pin' do
-          subject.latch.should_receive(:digital_write).with(Board::LOW)
+          subject.latch.should_receive(:digital_write).with(board.low)
           board.should_receive(:write).with "11.11.255.12\n"
           board.should_receive(:write).with "11.11.0.12\n"
-          subject.latch.should_receive(:digital_write).with(Board::HIGH)
+          subject.latch.should_receive(:digital_write).with(board.high)
 
           subject.write([255,0])
         end
diff --git a/spec/lib/components/ssd_spec.rb b/spec/lib/components/ssd_spec.rb
index ac0d90f8..ec39205b 100644
--- a/spec/lib/components/ssd_spec.rb
+++ b/spec/lib/components/ssd_spec.rb
@@ -41,14 +41,14 @@ module Components
 
       describe '#on' do
         it 'should turn the ssd on' do
-          subject.anode.should_receive(:digital_write).with(Board::HIGH)
+          subject.anode.should_receive(:digital_write).with(board.high)
           subject.on
         end
       end
 
       describe '#off' do
         it 'should turn the ssd off' do
-          subject.anode.should_receive(:digital_write).with(Board::LOW)
+          subject.anode.should_receive(:digital_write).with(board.low)
           subject.off
         end
       end
diff --git a/spec/lib/components/stepper_spec.rb b/spec/lib/components/stepper_spec.rb
index a37e1b23..082388a7 100644
--- a/spec/lib/components/stepper_spec.rb
+++ b/spec/lib/components/stepper_spec.rb
@@ -18,9 +18,9 @@ module Components
 
       describe '#step_cc' do
         it 'should send high to the step pin with the direction pin high' do
-          subject.direction.should_receive(:digital_write).with(Board::HIGH)
-          subject.step.should_receive(:digital_write).with(Board::HIGH)
-          subject.step.should_receive(:digital_write).with(Board::LOW)
+          subject.direction.should_receive(:digital_write).with(board.high)
+          subject.step.should_receive(:digital_write).with(board.high)
+          subject.step.should_receive(:digital_write).with(board.low)
 
           subject.step_cc
         end
@@ -28,9 +28,9 @@ module Components
 
       describe '#step_cw' do
         it 'should send high to the board with the direction pin low' do
-          subject.direction.should_receive(:digital_write).with(Board::LOW)
-          subject.step.should_receive(:digital_write).with(Board::HIGH)
-          subject.step.should_receive(:digital_write).with(Board::LOW)
+          subject.direction.should_receive(:digital_write).with(board.low)
+          subject.step.should_receive(:digital_write).with(board.high)
+          subject.step.should_receive(:digital_write).with(board.low)
 
           subject.step_cw
         end
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index df4331c7..045a6646 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -3,8 +3,15 @@
 #include <LiquidCrystal.h>
 Dino dino;
 
+// Use the native serial port on the Arduino Due
+#if defined(__SAM3X8E__)
+  Serial_ serial = SerialUSB;
+#else
+  UARTClass serial = Serial;
+#endif
+
 // Dino.h doesn't handle TXRX. Setup a function to tell it to write to Serial.
-void writeResponse(char *response) { Serial.print(response); Serial.print("\n"); }
+void writeResponse(char *response) { serial.print(response); serial.print("\n"); }
 void (*writeCallback)(char *str) = writeResponse;
 
 void setup() {
@@ -13,7 +20,7 @@ void setup() {
 }
 
 void loop() {
-  while(Serial.available() > 0) dino.parse(Serial.read());
+  while(serial.available() > 0) dino.parse(serial.read());
   dino.updateListeners();
-  Serial.flush();
+  serial.flush();
 }
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 519d3547..3962f782 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -80,6 +80,7 @@ void Dino::process() {
     case 10: handleLCD           ();  break;
     case 11: shiftWrite          ();  break;
     case 90: reset               ();  break;
+    case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
     case 98: setHeartRate        ();  break;
     default:                          break;
@@ -275,9 +276,6 @@ void Dino::shiftWrite() {
 
 // CMD = 90
 void Dino::reset() {
-  #ifdef ANALOG_RESOLUTION
-    analogReadResolution(ANALOG_RESOLUTION);
-  #endif
   heartRate = 4000; // Default heartRate is ~4ms.
   loopCount = 0;
   analogDivider = 4; // Update analog listeners every ~16ms.
@@ -287,7 +285,22 @@ void Dino::reset() {
   lastUpdate = micros();
   fragmentIndex = 0;
   charIndex = 0;
-  sprintf(response, "ACK:%02d", A0);
+
+  #if defined(__SAM3X8E__)
+    sprintf(response, "ACK:%d,%d", A0, DAC0);
+  #else
+    sprintf(response, "ACK:%d", A0);
+  #endif
+}
+
+// CMD = 97
+// Set the analog read and write resolution.
+void Dino::setAnalogResolution() {
+  analogReadResolution(val);
+  analogWriteResolution(val);
+  #ifdef debug
+    Serial.print("Analog R/W resolution set to "); Serial.println(val);
+  #endif
 }
 
 // CMD = 97
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index af07d51c..2b3de085 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -16,7 +16,6 @@
 #elif defined(__SAM3X8E__)
 #  define PIN_COUNT 66
 #  define SERVO_OFFSET 22
-#  define ANALOG_RESOLUTION 12
 #else
 #  define PIN_COUNT 22
 #  define SERVO_OFFSET 2
@@ -47,6 +46,7 @@ class Dino {
     void handleLCD             ();  //cmd = 10
     void shiftWrite            ();  //cmd = 11
     void reset                 ();  //cmd = 90
+    void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
     void setHeartRate          ();  //cmd = 98
   
@@ -66,7 +66,7 @@ class Dino {
 
     // Value and response storage.
     int rval;
-    char response[8];
+    char response[16];
     
     // Use a write callback from the main sketch to respond.
     void (*_writeCallback)(char *str);

From 00c2e411775db104257879f7bd22884f8f49d2b4 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 24 Jun 2013 16:31:35 -0400
Subject: [PATCH 030/296] Fix a typo in the CLI uploader path

---
 lib/dino_cli/uploader.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino_cli/uploader.rb b/lib/dino_cli/uploader.rb
index d7d4327b..44ce1a16 100644
--- a/lib/dino_cli/uploader.rb
+++ b/lib/dino_cli/uploader.rb
@@ -28,7 +28,7 @@ def compile
   end
 
   def upload
-    `#{executable} --upload '#{options[:sketch_file]}'"`
+    `#{executable} --upload '#{options[:sketch_file]}'`
   end
 
   def executable

From f3d3ef4d44946b344292dc6139e9d1f62c8f62d8 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 25 Jun 2013 12:57:21 -0400
Subject: [PATCH 031/296] Fix sketches not compiling for AVR boards

---
 src/dino_serial.ino |  2 +-
 src/lib/Dino.cpp    | 10 ++++++----
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 045a6646..10e8d8ed 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -7,7 +7,7 @@ Dino dino;
 #if defined(__SAM3X8E__)
   Serial_ serial = SerialUSB;
 #else
-  UARTClass serial = Serial;
+  HardwareSerial serial = Serial;
 #endif
 
 // Dino.h doesn't handle TXRX. Setup a function to tell it to write to Serial.
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 3962f782..49c2cabf 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -296,10 +296,12 @@ void Dino::reset() {
 // CMD = 97
 // Set the analog read and write resolution.
 void Dino::setAnalogResolution() {
-  analogReadResolution(val);
-  analogWriteResolution(val);
-  #ifdef debug
-    Serial.print("Analog R/W resolution set to "); Serial.println(val);
+  #if defined(__SAM3X8E__)
+    analogReadResolution(val);
+    analogWriteResolution(val);
+    #ifdef debug
+      Serial.print("Analog R/W resolution set to "); Serial.println(val);
+    #endif
   #endif
 }
 

From 43a8fe9045b6e9b851d5f1f9a729e9d1ffdd91a7 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 26 Jun 2013 22:32:43 -0400
Subject: [PATCH 032/296] Simpler more reliable handshake

---
 lib/dino/tx_rx/base.rb   | 23 ++++++++---------------
 lib/dino/tx_rx/serial.rb |  8 --------
 2 files changed, 8 insertions(+), 23 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 43bea08f..42d65494 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -34,19 +34,12 @@ def write(message)
       end
 
       def handshake
-        flush_read
-        100.times do
-          begin
-            write Dino::Message.encode(command: 90)
-            Timeout::timeout(0.1) do
-              line = gets.to_s
-              if line.match /ACK:/
-                flush_read
-                return line.chop.split(/:/)[1]
-              end
-            end
-          rescue
-            nil
+        10.times do
+          write Dino::Message.encode(command: 90)
+          line = gets(1)
+          if line && line.match(/ACK:/)
+            flush_read
+            return line.chop.split(/:/)[1]
           end
         end
        raise BoardNotFound
@@ -56,8 +49,8 @@ def flush_read
         gets until gets == nil
       end
 
-      def gets
-        IO.select([io], nil, nil, 0.005) && io.gets
+      def gets(timeout=0.005)
+        IO.select([io], nil, nil, timeout) && io.gets
       end
     end
   end
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index 8999b70f..c52ff7c0 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -15,14 +15,6 @@ def io
         @io ||= connect
       end
 
-      def handshake
-        if on_windows?
-          io; sleep 3
-        end
-        
-        super
-      end
-
       private
 
       def connect

From c6a731878ad45b6b4f0fcfea65e88536e3495b73 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 8 Jul 2013 17:08:34 -0400
Subject: [PATCH 033/296] Make BaseInput#read block the main thread, add
 BaseInput#poll(interval, &block)

---
 examples/sensor/sensor.rb                     | 42 ++++++++++++-------
 lib/dino/board.rb                             |  1 +
 lib/dino/components/core/analog_input.rb      |  4 +-
 lib/dino/components/core/base_input.rb        | 41 +++++++++++-------
 lib/dino/components/core/digital_input.rb     |  6 +--
 lib/dino/tx_rx/base.rb                        |  1 +
 spec/lib/board_spec.rb                        |  9 +++-
 spec/lib/components/core/analog_input_spec.rb |  8 ++--
 spec/lib/components/core/base_input_spec.rb   | 28 ++++++++-----
 .../lib/components/core/digital_input_spec.rb | 10 ++---
 10 files changed, 92 insertions(+), 58 deletions(-)

diff --git a/examples/sensor/sensor.rb b/examples/sensor/sensor.rb
index 768cfd11..32a6872c 100644
--- a/examples/sensor/sensor.rb
+++ b/examples/sensor/sensor.rb
@@ -8,35 +8,45 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-board.analog_divider = 128
 sensor = Dino::Components::Sensor.new(pin: 'A0', board: board)
 
-# Single read with block as callback. Fires only once.
-sensor.read { |value| puts "Single read value: #{value}" }; sleep 1
+# Single read with block as callback. Blocks main thread.
+# Callback fires only once then is removed automatically.
+sensor.read { |value| puts "#{Time.now} Single read: #{value}" }
 
-# Continuous listen with block as callback. Fires every time data is received until #stop_listening is called.
-sensor.listen { |value| puts "Listening. Read value: #{value}" }; sleep 5
+# Poll the sensor every 1 second with block as callback. Does not block main thread.
+# Callback fires every time data is received until #stop is called.
+sensor.poll(1) { |value| puts "#{Time.now} Polling: #{value}" }
+sleep 5
+
+# Stop polling. Automatically removes the callback from the #poll block.
+sensor.stop
+
+# Continuous listen with block as callback. Fires every time data is received until #stop is called.
+sensor.listen { |value| puts "#{Time.now} Listening: #{value}" }
+sleep 0.5
 
 # Stop listening. Automatically removes the callback from the #listen block.
-sensor.stop_listening; sleep 1
+sensor.stop
 
 # Add a persistent callback.
-sensor.on_data { |value| puts "Persistent callback: #{value}" }
+sensor.on_data { |value| puts "#{Time.now} Persistent callback: #{value}" }
 
-# Add a keyed callback.
-sensor.on_data(:test) { |value| puts "Keyed callback: #{value}"}
+# Add a callback with a custom key.
+sensor.on_data(:test) { |value| puts "#{Time.now} Keyed callback: #{value}"}
 
-# Single read. All callbacks fire, block given fires only once.
-sensor.read { |value| puts "#read block. Value: #{value}" }; sleep 1
+# Single read again. Block given fires only once. Callbacks added with #on_data fire also.
+sensor.read { |value| puts "#{Time.now} Single read again: #{value}" }
 
-# Continuous listen. All callbacks added with #on_data continue to fire, plus the block.
-sensor.listen { |value| puts "#listen block. Value: #{value}" }; sleep 5
+# Continuous listen. Block fires each time. Callbacks added with #on_data continue to fire.
+sensor.listen { |value| puts "#{Time.now } Listening again: #{value}" }
+sleep 0.5
 
 # Stop listening. Automatically removes the callback from the #listen block.
-sensor.stop_listening
+sensor.stop
 
 # Remove callbacks keyed with :test.
-sensor.clear_callbacks(:test)
+sensor.remove_callbacks(:test)
 
 # Remove all callbacks.
-sensor.clear_callbacks
+sensor.remove_callbacks
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 5989cb08..eee126cc 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -53,6 +53,7 @@ def update(pin, msg)
     end
 
     def add_input_hardware(part)
+      start_read
       @input_hardware << part
       set_pin_mode(part.pin, :in, part.pullup)
     end
diff --git a/lib/dino/components/core/analog_input.rb b/lib/dino/components/core/analog_input.rb
index ba9b8f51..f15dc361 100644
--- a/lib/dino/components/core/analog_input.rb
+++ b/lib/dino/components/core/analog_input.rb
@@ -2,11 +2,11 @@ module Dino
   module Components
     module Core
       class AnalogInput < BaseInput
-        def poll
+        def _read
           board.analog_read(self.pin)
         end
 
-        def start_listening
+        def _listen
           board.analog_listen(self.pin)
         end
       end
diff --git a/lib/dino/components/core/base_input.rb b/lib/dino/components/core/base_input.rb
index b0092d6b..23b67f0a 100644
--- a/lib/dino/components/core/base_input.rb
+++ b/lib/dino/components/core/base_input.rb
@@ -2,54 +2,63 @@ module Dino
   module Components
     module Core
       class BaseInput < Base
+        include Threaded
+
         def initialize(options={})
           super options
 
           remove_callbacks
           self.mode = :in
           board.add_input_hardware(self)
-          board.start_read
 
           after_initialize(options)
         end
         
         def read(&block)
           add_callback(:read, &block) if block_given?
-          poll
+          _read
+          loop { break if @callbacks[:read].empty? }
         end
         
         def listen(&block)
           add_callback(:listen, &block) if block_given?
-          start_listening
+          _listen
+        end
+
+        def poll(interval, &block)
+          add_callback(:poll, &block) if block_given?
+          threaded_loop do
+            _read; sleep interval
+          end
+        end
+
+        def stop
+          stop_thread
+          board.stop_listener(pin)
+          remove_callback :listen; remove_callback :poll
         end
 
         #
-        # Define these in your subclass.
-        # Should correspond to Board#digital_read, Board#digital_listen for digital
-        # and Board#analog_read, Board#analog_listen for analog components. 
+        # Defined in DigitalInput and AnalogInput subclasses.
+        # _read corresponds to Board#digital_read and Board#analog_read respectively.
+        # _listen corresponds to Board#digital_listen and Board#analog_listen respectively
         #
-        def poll ; end
-        def start_listening ; end
+        def _read; end
+        def _listen; end
 
         def add_callback(key=nil, &block)
           key ||= :persistent
           @callbacks[key] ||= []
           @callbacks[key] << block
         end
-
-        alias :on_data :add_callback
-
+        
         def remove_callback(key=nil)
           key ? @callbacks[key] = [] : @callbacks = {}
         end
 
+        alias :on_data :add_callback
         alias :remove_callbacks :remove_callback
 
-        def stop_listening
-          board.stop_listener(pin)
-          remove_callback :listen
-        end
-
         def update(data)
           @state = data
           @callbacks.each_value do |array|
diff --git a/lib/dino/components/core/digital_input.rb b/lib/dino/components/core/digital_input.rb
index 74b72a83..da7666c0 100644
--- a/lib/dino/components/core/digital_input.rb
+++ b/lib/dino/components/core/digital_input.rb
@@ -7,14 +7,14 @@ class DigitalInput < BaseInput
 
         def initialize(options={})
           super(options)
-          start_listening
+          _listen
         end
 
-        def poll
+        def _read
           board.digital_read(self.pin)
         end
 
-        def start_listening
+        def _listen
           board.digital_listen(self.pin)
         end
 
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 42d65494..9401b47a 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -34,6 +34,7 @@ def write(message)
       end
 
       def handshake
+        flush_read
         10.times do
           write Dino::Message.encode(command: 90)
           line = gets(1)
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index ea15832e..34fe6ad2 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -3,7 +3,7 @@
 module Dino
   describe Dino::Board do
     def io_mock(methods = {})
-      @io ||= mock(:io, {write: nil, add_observer: nil, flush_read: nil, handshake: "14"}.merge(methods))
+      @io ||= mock(:io, {add_observer: true, handshake: 14, write: true, read: true, write: nil}.merge(methods))
     end
 
     subject { Board.new(io_mock) }
@@ -63,7 +63,12 @@ def io_mock(methods = {})
     end
 
     describe '#add_input_hardware' do
-      it 'should add digital hardware to the board' do
+      it 'should start the read thread' do
+        io_mock.should_receive(:read)
+        subject.add_input_hardware(mock(:part1, pin: 12, pullup: nil))
+      end
+
+      it 'should add input hardware to the board' do
         subject.add_input_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
         subject.add_input_hardware(mock2 = mock(:part2, pin: 14, pullup: nil))
         subject.input_hardware.should =~ [mock1, mock2]
diff --git a/spec/lib/components/core/analog_input_spec.rb b/spec/lib/components/core/analog_input_spec.rb
index 6be3c687..582dd847 100644
--- a/spec/lib/components/core/analog_input_spec.rb
+++ b/spec/lib/components/core/analog_input_spec.rb
@@ -9,17 +9,17 @@ module Core
         let(:options) { { pin: 'A0', board: board } }
         subject { AnalogInput.new(options) }
 
-        describe '#poll' do
+        describe '#_read' do
           it 'should send #analog_read to the board with its pin' do
             board.should_receive(:analog_read).with(subject.pin)
-            subject.read
+            subject._read
           end
         end
 
-        describe '#start_listening' do
+        describe '#_listen' do
           it 'should send #analog_listen to the board with its pin' do
             board.should_receive(:analog_listen).with(subject.pin)
-            subject.start_listening
+            subject._listen
           end
         end
       end
diff --git a/spec/lib/components/core/base_input_spec.rb b/spec/lib/components/core/base_input_spec.rb
index 94deb03b..d37281ab 100644
--- a/spec/lib/components/core/base_input_spec.rb
+++ b/spec/lib/components/core/base_input_spec.rb
@@ -13,7 +13,6 @@ module Core
           it 'should add itself as input hardware, set mode to in and start read' do
             board.should_receive(:set_pin_mode).with(14, :in, nil)
             board.should_receive(:add_input_hardware)
-            board.should_receive(:start_read)
 
             BaseInput.new(options)
           end
@@ -54,38 +53,47 @@ module Core
           describe '#read' do
             it 'should add the block given as a callback to the :read key' do
               subject.should_receive(:add_callback).with(:read)
+              subject.instance_variable_set(:@callbacks, {read: []})
               subject.read { mock }
             end
 
-            it 'should call #poll once' do
-              subject.should_receive(:poll)
+            it 'should call #_read once' do
+              subject.should_receive(:read)
               subject.read
             end
           end
 
+          describe '#poll' do
+            it 'should add the block given as a callback to the :poll key' do
+              subject.should_receive(:add_callback).with(:poll)
+              subject.poll(5) { mock }
+            end
+          end
+
           describe '#listen' do
             it 'should add the block given as a callback to the :listen key' do
               subject.should_receive(:add_callback).with(:listen)
               subject.listen { mock }
             end
 
-            it 'should call #start_listening' do
-              subject.should_receive(:start_listening)
+            it 'should call #_listen' do
+              subject.should_receive(:_listen)
               subject.listen
             end
           end
 
-          describe '#stop_listening' do
+          describe '#stop' do
             it 'should tell the board to turn the listener off' do
               board.should_receive(:stop_listener).with(subject.pin)
-              subject.stop_listening
+              subject.stop
             end
 
-            it 'should remove all callbacks with the :listen key' do
-              subject.listen { mock }
+            it 'should remove all callbacks from the :listen and :poll keys and stop the read thread' do
               subject.should_receive(:remove_callback).with(:listen)
+              subject.should_receive(:remove_callback).with(:poll)
+              subject.should_receive(:stop_thread)
 
-              subject.stop_listening
+              subject.stop
             end
           end
         end
diff --git a/spec/lib/components/core/digital_input_spec.rb b/spec/lib/components/core/digital_input_spec.rb
index 4a73ca63..684aa844 100644
--- a/spec/lib/components/core/digital_input_spec.rb
+++ b/spec/lib/components/core/digital_input_spec.rb
@@ -17,20 +17,20 @@ module Core
           end
         end
 
-        describe '#poll' do
+        describe '#_read' do
           it 'should send #digital_read to the board with its pin' do
             board.should_receive(:digital_read).with(subject.pin)
-            subject.read
+            subject._read
           end
         end
 
-        describe '#start_listening' do
+        describe '#_listen' do
           it 'should send #digital_listen to the board with its pin' do
             subject
-            subject.stop_listening
+            subject.stop
             board.should_receive(:digital_listen).with(subject.pin)
 
-            subject.start_listening
+            subject.listen
           end
         end
 

From 2c8e9db8b34d8f6d3dfe0de4efada6ebd1f3e536 Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Sun, 14 Jul 2013 15:53:11 -0400
Subject: [PATCH 034/296] failing attempt to bring softwareserial to dino

---
 src/dino_serial.ino    |  1 +
 src/lib/Dino.cpp       | 11 +++++++++++
 src/lib/Dino.h         |  2 ++
 src/lib/DinoSerial.cpp | 40 ++++++++++++++++++++++++++++++++++++++++
 src/lib/DinoSerial.h   | 18 ++++++++++++++++++
 5 files changed, 72 insertions(+)
 create mode 100644 src/lib/DinoSerial.cpp
 create mode 100644 src/lib/DinoSerial.h

diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 10e8d8ed..d75080bc 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -1,6 +1,7 @@
 #include "Dino.h"
 #include <Servo.h>
 #include <LiquidCrystal.h>
+#include <SoftwareSerial.h>
 Dino dino;
 
 // Use the native serial port on the Arduino Due
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 49c2cabf..d6cfdecb 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -5,6 +5,7 @@
 #include "Arduino.h"
 #include "Dino.h"
 DinoLCD dinoLCD;
+DinoSerial dinoSerial;
 
 Dino::Dino(){
   messageFragments[0] = cmdStr;
@@ -79,6 +80,7 @@ void Dino::process() {
     case 9:  servoWrite          ();  break;
     case 10: handleLCD           ();  break;
     case 11: shiftWrite          ();  break;
+    case 12: handleSerial        ();  break;
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
@@ -274,6 +276,15 @@ void Dino::shiftWrite() {
   shiftOut(pin, atoi(auxMsg), MSBFIRST, val);
 }
 
+// CMD = 12
+// Write a value to the servo object.
+void Dino::handleSerial() {
+  #ifdef debug
+    Serial.print("DinoSerial command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
+  #endif
+  dinoSerial.process(val, auxMsg);
+}
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 2b3de085..3da7ab96 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -8,6 +8,7 @@
 #include "Arduino.h"
 #include <Servo.h>
 #include "DinoLCD.h"
+#include "DinoSerial.h"
 
 // Allocate listener storage based on what board we're running.
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
@@ -45,6 +46,7 @@ class Dino {
     void servoWrite            ();  //cmd = 9
     void handleLCD             ();  //cmd = 10
     void shiftWrite            ();  //cmd = 11
+    void handleSerial          ();  //cmd = 12
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
new file mode 100644
index 00000000..5c57cf2f
--- /dev/null
+++ b/src/lib/DinoSerial.cpp
@@ -0,0 +1,40 @@
+#include "Arduino.h"
+#include "DinoSerial.h"
+
+SoftwareSerial serial(10,11);
+
+DinoSerial::DinoSerial(){
+}
+
+int *DinoSerial::parse(char *aux){
+  int *values = new int[11];
+  char *str;
+  int index = 0;
+  while ((str = strsep(&aux, ",")) != NULL) {
+    values[index] = atoi(str);
+    index++;
+  }
+  parseSize = index;
+  return values;
+}
+
+void DinoSerial::process(int cmd, char *message) {
+  switch(cmd) {
+    case 0:  setPins(message);           break;
+    case 1:  beginSerial(message);       break;
+    default:                             break;
+  }
+}
+
+void DinoSerial::setPins(char *aux) {
+  int *pins = parse(aux);
+  SoftwareSerial newSerial(pins[0],pins[1]);
+  serial = newSerial;
+
+}
+
+void DinoSerial::beginSerial(char *aux) {
+  int *values = parse(aux);
+  // set baud rate
+  serial.begin(values[0]);
+}
diff --git a/src/lib/DinoSerial.h b/src/lib/DinoSerial.h
new file mode 100644
index 00000000..91acc9cf
--- /dev/null
+++ b/src/lib/DinoSerial.h
@@ -0,0 +1,18 @@
+#ifndef DinoSerial_h
+#define DinoSerial_h
+
+#include "Arduino.h"
+#include <SoftwareSerial.h>
+
+class DinoSerial {
+  public:
+    DinoSerial();
+    void process(int cmd, char *message);
+  private:
+    int *parse(char *aux);
+    void setPins(char *aux);
+    void beginSerial(char *aux);
+    int parseSize;
+};
+
+#endif

From 25f1182c4f2ce63bf8cc8f231a7e1cb220991b48 Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Sun, 14 Jul 2013 16:02:13 -0400
Subject: [PATCH 035/296] there's the dummy mistake.

---
 src/lib/DinoSerial.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
index 5c57cf2f..48c457c7 100644
--- a/src/lib/DinoSerial.cpp
+++ b/src/lib/DinoSerial.cpp
@@ -1,7 +1,7 @@
 #include "Arduino.h"
 #include "DinoSerial.h"
 
-SoftwareSerial serial(10,11);
+SoftwareSerial softSerial(10,11);
 
 DinoSerial::DinoSerial(){
 }
@@ -29,12 +29,12 @@ void DinoSerial::process(int cmd, char *message) {
 void DinoSerial::setPins(char *aux) {
   int *pins = parse(aux);
   SoftwareSerial newSerial(pins[0],pins[1]);
-  serial = newSerial;
+  softSerial = newSerial;
 
 }
 
 void DinoSerial::beginSerial(char *aux) {
   int *values = parse(aux);
   // set baud rate
-  serial.begin(values[0]);
+  softSerial.begin(values[0]);
 }

From 6bca623425de4226830cd2fec5b56d93f1d4f379 Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Sun, 14 Jul 2013 16:03:36 -0400
Subject: [PATCH 036/296] Ignoring DS_Store files...

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index 29a849a7..973343b7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -19,3 +19,4 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+*DS_Store*

From 760cba4ee20c65d0e143eea801aeb092e1ec902d Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Mon, 15 Jul 2013 12:17:03 -0400
Subject: [PATCH 037/296] add the print and println methods, still untested

---
 src/lib/DinoSerial.cpp | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
index 48c457c7..bc6463a3 100644
--- a/src/lib/DinoSerial.cpp
+++ b/src/lib/DinoSerial.cpp
@@ -20,9 +20,11 @@ int *DinoSerial::parse(char *aux){
 
 void DinoSerial::process(int cmd, char *message) {
   switch(cmd) {
-    case 0:  setPins(message);           break;
-    case 1:  beginSerial(message);       break;
-    default:                             break;
+    case 0:  setPins(message);            break;
+    case 1:  beginSerial(message);        break;
+    case 2:  softSerial.print(message);   break;
+    case 3:  softserial.println(message); break;
+    default:                              break;
   }
 }
 
@@ -37,4 +39,4 @@ void DinoSerial::beginSerial(char *aux) {
   int *values = parse(aux);
   // set baud rate
   softSerial.begin(values[0]);
-}
+}
\ No newline at end of file

From a32fd5d489981eda20dc6ff30a35c64d7909528d Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Mon, 15 Jul 2013 22:32:09 -0400
Subject: [PATCH 038/296] very preliminary SoftwareSerial writing, and it
 works.

---
 lib/dino_cli/generator.rb |  2 +-
 src/lib/Dino.cpp          |  2 +-
 src/lib/Dino.h            |  2 ++
 src/lib/DinoSerial.cpp    | 12 +++++-------
 src/lib/DinoSerial.h      |  2 +-
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index fab3e36d..0ab0744e 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,6 +1,6 @@
 class DinoCLI::Generator
   require "fileutils"
-  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp"]
+  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h"]
   attr_accessor :options
 
   def initialize(options={})
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index d6cfdecb..d0aeeea5 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -277,7 +277,7 @@ void Dino::shiftWrite() {
 }
 
 // CMD = 12
-// Write a value to the servo object.
+// Control the SoftwareSerial.
 void Dino::handleSerial() {
   #ifdef debug
     Serial.print("DinoSerial command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 3da7ab96..f88b947f 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -5,6 +5,8 @@
 #ifndef Dino_h
 #define Dino_h
 
+#define debug
+
 #include "Arduino.h"
 #include <Servo.h>
 #include "DinoLCD.h"
diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
index bc6463a3..8ecffb9d 100644
--- a/src/lib/DinoSerial.cpp
+++ b/src/lib/DinoSerial.cpp
@@ -21,9 +21,9 @@ int *DinoSerial::parse(char *aux){
 void DinoSerial::process(int cmd, char *message) {
   switch(cmd) {
     case 0:  setPins(message);            break;
-    case 1:  beginSerial(message);        break;
+    case 1:  begin(message);              break;
     case 2:  softSerial.print(message);   break;
-    case 3:  softserial.println(message); break;
+    case 3:  softSerial.println(message); break;
     default:                              break;
   }
 }
@@ -32,11 +32,9 @@ void DinoSerial::setPins(char *aux) {
   int *pins = parse(aux);
   SoftwareSerial newSerial(pins[0],pins[1]);
   softSerial = newSerial;
-
 }
 
-void DinoSerial::beginSerial(char *aux) {
-  int *values = parse(aux);
-  // set baud rate
-  softSerial.begin(values[0]);
+void DinoSerial::begin(char *aux) {
+  int baud = atoi(aux);
+  softSerial.begin(baud);
 }
\ No newline at end of file
diff --git a/src/lib/DinoSerial.h b/src/lib/DinoSerial.h
index 91acc9cf..a4427767 100644
--- a/src/lib/DinoSerial.h
+++ b/src/lib/DinoSerial.h
@@ -11,7 +11,7 @@ class DinoSerial {
   private:
     int *parse(char *aux);
     void setPins(char *aux);
-    void beginSerial(char *aux);
+    void begin(char *aux);
     int parseSize;
 };
 

From 7d50e3d55ec2bdffc4e3f6b98a99084063d9302c Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Mon, 15 Jul 2013 22:33:11 -0400
Subject: [PATCH 039/296] whoops, didn't need to define debug for the commit

---
 src/lib/Dino.h | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index f88b947f..3da7ab96 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -5,8 +5,6 @@
 #ifndef Dino_h
 #define Dino_h
 
-#define debug
-
 #include "Arduino.h"
 #include <Servo.h>
 #include "DinoLCD.h"

From 4805ad26c5035475b8c8d74908fef837de688d91 Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Mon, 15 Jul 2013 22:40:37 -0400
Subject: [PATCH 040/296] initial component class for the softwareserial

---
 lib/dino/components/softserial.rb | 39 +++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 lib/dino/components/softserial.rb

diff --git a/lib/dino/components/softserial.rb b/lib/dino/components/softserial.rb
new file mode 100644
index 00000000..2dc86c4b
--- /dev/null
+++ b/lib/dino/components/softserial.rb
@@ -0,0 +1,39 @@
+module Dino
+  module Components
+    class SoftwareSerial < Core::MultiPin
+      COMMAND = 12
+      # Initialize
+      #
+      # Dino::Components::SoftwareSerial.new(
+      #       board: board,
+      #       pins: { rx:10, tx:11 },
+      #       baud: 9600
+      # )
+      #
+      def after_initialize(options)
+        board.write Dino::Message.encode command: COMMAND, value: 0, aux_message: encoded_pins
+        board.write Dino::Message.encode command: COMMAND, value: 1, aux_message: baud
+      end
+      
+      # A useful pattern to be implemented if needed
+      # LIBRARY_COMMANDS = {
+      # }
+
+      # LIBRARY_COMMANDS.each_pair do |command, command_id|
+      #   define_method(command) do
+      #     board.write Dino::Message.encode(command: 13, value: command_id)
+      #   end
+      # end
+
+      def puts(string)
+        board.write Dino::Message.encode command: COMMAND, value: 3, aux_message: string
+      end
+
+      private
+
+      def encoded_pins
+        [pins[:rx], pins[:tx]].compact.join(',')
+      end
+    end
+  end
+end

From 1aefab5d1100cc68f94f11920badc8c2253c4b3f Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Mon, 15 Jul 2013 22:44:56 -0400
Subject: [PATCH 041/296] autoload the serial

---
 lib/dino/components.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 6ff4354a..cd3d0ca4 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -12,5 +12,6 @@ module Components
     autoload :LCD,            'dino/components/lcd'
     autoload :ShiftRegister,  'dino/components/shift_register'
     autoload :Relay,          'dino/components/relay'
+    autoload :SoftwareSerial, 'dino/components/softserial'
   end
 end

From 5f7b9502727943da97e8d47327ea614e5b955ede Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Mon, 15 Jul 2013 22:45:10 -0400
Subject: [PATCH 042/296] softwareserial should track the baud

---
 lib/dino/components/softserial.rb | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/dino/components/softserial.rb b/lib/dino/components/softserial.rb
index 2dc86c4b..d0906929 100644
--- a/lib/dino/components/softserial.rb
+++ b/lib/dino/components/softserial.rb
@@ -1,6 +1,8 @@
 module Dino
   module Components
     class SoftwareSerial < Core::MultiPin
+      attr_accessor :baud
+
       COMMAND = 12
       # Initialize
       #
@@ -11,8 +13,9 @@ class SoftwareSerial < Core::MultiPin
       # )
       #
       def after_initialize(options)
+        self.baud = options[:baud]
         board.write Dino::Message.encode command: COMMAND, value: 0, aux_message: encoded_pins
-        board.write Dino::Message.encode command: COMMAND, value: 1, aux_message: baud
+        board.write Dino::Message.encode command: COMMAND, value: 1, aux_message: self.baud
       end
       
       # A useful pattern to be implemented if needed

From 0558f2cc44beefa8507371cad54bcb2d53ab68f2 Mon Sep 17 00:00:00 2001
From: Christian Carter <cdcarter@gmail.com>
Date: Mon, 15 Jul 2013 22:52:57 -0400
Subject: [PATCH 043/296] a spec for the current level of detail softserial has

---
 spec/lib/components/softwareserial_spec.rb | 23 ++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 spec/lib/components/softwareserial_spec.rb

diff --git a/spec/lib/components/softwareserial_spec.rb b/spec/lib/components/softwareserial_spec.rb
new file mode 100644
index 00000000..f318a74f
--- /dev/null
+++ b/spec/lib/components/softwareserial_spec.rb
@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe SoftwareSerial do
+      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
+
+      subject { SoftwareSerial.new board: board, pins: { rx: 10, tx: 11 }, baud: 4800 }
+
+      before do
+        board.should_receive(:write).with("12..0.10,11\n")
+        board.should_receive(:write).with("12..1.4800\n")
+      end
+
+      describe '#puts' do
+        it 'prints a string to the serial interface' do
+          board.should_receive(:write).with "12..3.Testing\n"
+          subject.puts("Testing")
+        end
+      end
+    end
+  end
+end
\ No newline at end of file

From 0891d2e89eb3b6d8183b6d6106b768a2e6967713 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sun, 18 Aug 2013 19:19:03 -0400
Subject: [PATCH 044/296] Don't depend on rbenv

---
 .ruby-version | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 .ruby-version

diff --git a/.ruby-version b/.ruby-version
deleted file mode 100644
index 95a5ad2d..00000000
--- a/.ruby-version
+++ /dev/null
@@ -1 +0,0 @@
-ruby-2.0.0-p195

From b020a37810ca6eff279d59d301d4afde2b3875ab Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sun, 18 Aug 2013 19:41:58 -0400
Subject: [PATCH 045/296] Update readme for 0.12

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c66e0c16..588dcfe3 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Dino 0.11.2
+# Dino 0.12.0
 [![Build Status](https://secure.travis-ci.org/austinbv/dino.png)](http://travis-ci.org/austinbv/dino)
 
 ## Get Started In No Time
@@ -11,6 +11,14 @@ Dino lets you start programming your Arduino with Ruby in minutes.
 gem install dino
 ```
 
+#### Download the Arduino IDE
+
+Dino is all about writing Ruby, but we'll need to upload some C code to the Arduino so we can talk to it. You'll need the [Arduino IDE](http://arduino.cc/en/Main/Software) for that. Even though it's still in beta, version 1.5 is recommended since it lets you upload from the command line.
+
+#### Connect your Arduino
+
+Connect your board with a USB cable. Open the Arduino IDE and pull down the `Tools` menu. Make sure you have the right type of board, and the correct serial port selected.
+
 #### Prepare the Bootstrapper
 
 Use the included command line tool to create a folder with the Arduino sketch you want to use and optionally configure it.

From bb51629d08b68bde77480eb5aa81acb254c74441 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 6 Sep 2013 22:32:15 -0400
Subject: [PATCH 046/296] Untested support for DHT11/DHT22 sensors

---
 lib/dino/board.rb          |   3 +-
 lib/dino/components.rb     |   1 +
 lib/dino/components/dht.rb |  39 +++++++
 lib/dino_cli/generator.rb  |   2 +-
 src/dino_ethernet.ino      |  11 +-
 src/dino_serial.ino        |   3 +-
 src/dino_wifi.ino          |  11 +-
 src/lib/DHT.cpp            | 207 +++++++++++++++++++++++++++++++++++++
 src/lib/DHT.h              |  96 +++++++++++++++++
 src/lib/Dino.cpp           |  28 ++++-
 src/lib/Dino.h             |   2 +
 11 files changed, 384 insertions(+), 19 deletions(-)
 create mode 100644 lib/dino/components/dht.rb
 create mode 100644 src/lib/DHT.cpp
 create mode 100644 src/lib/DHT.h

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index eee126cc..60a8fe45 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -83,7 +83,8 @@ def set_pullup(pin, pullup)
       analog_listen:   '6',
       stop_listener:   '7',
       servo_toggle:    '8',
-      servo_write:     '9'
+      servo_write:     '9',
+      dht_read:        '13'
     }
 
     PIN_COMMANDS.each_key do |command|
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index cd3d0ca4..1baf331d 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -13,5 +13,6 @@ module Components
     autoload :ShiftRegister,  'dino/components/shift_register'
     autoload :Relay,          'dino/components/relay'
     autoload :SoftwareSerial, 'dino/components/softserial'
+    autoload :SoftwareSerial, 'dino/components/dht'
   end
 end
diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
new file mode 100644
index 00000000..69a0e1ff
--- /dev/null
+++ b/lib/dino/components/dht.rb
@@ -0,0 +1,39 @@
+module Dino
+  module Components
+    module DHT
+      class Temperature < Core::BaseInput
+        #
+        # These components work too slowly to poll often enough for a listener.
+        #
+        def listen; end
+
+        def _read
+          board.dht_read(self.pin, 0)
+        end
+
+        def update(data)
+          return unless data.match /T/
+          data.gsub!('T', '')
+          super(data)
+        end
+      end
+
+      class Humidity < Core::BaseInput
+        #
+        # These components poll too slowly to poll often enough for a listener.
+        #
+        def listen; end
+
+        def _read
+          board.dht_read(self.pin, 1)
+        end
+
+        def update
+          return unless data.match /H/
+          data.gsub!('T', '')
+          super(data)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 0ab0744e..b5a234fc 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,6 +1,6 @@
 class DinoCLI::Generator
   require "fileutils"
-  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h"]
+  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h"]
   attr_accessor :options
 
   def initialize(options={})
diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index a63bd40a..d909e99a 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -3,6 +3,8 @@
 #include <Ethernet.h>
 #include <Servo.h>
 #include <LiquidCrystal.h>
+#include <SoftwareSerial.h>
+#include "DHT.h"
 
 // Configure your MAC address, IP address, and HTTP port here.
 byte mac[] = { 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 };
@@ -18,13 +20,8 @@ char responseBuffer[65];
 // Dino.h doesn't handle TXRX.
 // Setup a callback to buffer responses for writing.
 void bufferResponse(char *response) {
-   if (strlen(responseBuffer) > 56 ) {
-     writeResponses();
-     strcpy(responseBuffer, response);
-   } else {
-     strcat(responseBuffer, response);
-   }
-   strcat(responseBuffer, "\n");
+  if (strlen(responseBuffer) > 56 ) writeResponses();
+  strcpy(responseBuffer, response);
 }
 void (*writeCallback)(char *str) = bufferResponse;
 
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index d75080bc..c9a92e6e 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -2,6 +2,7 @@
 #include <Servo.h>
 #include <LiquidCrystal.h>
 #include <SoftwareSerial.h>
+#include "DHT.h"
 Dino dino;
 
 // Use the native serial port on the Arduino Due
@@ -12,7 +13,7 @@ Dino dino;
 #endif
 
 // Dino.h doesn't handle TXRX. Setup a function to tell it to write to Serial.
-void writeResponse(char *response) { serial.print(response); serial.print("\n"); }
+void writeResponse(char *response) { serial.print(response); }
 void (*writeCallback)(char *str) = writeResponse;
 
 void setup() {
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index e9ebfc0d..9387e85b 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -3,6 +3,8 @@
 #include <WiFi.h>
 #include <Servo.h>
 #include <LiquidCrystal.h>
+#include <SoftwareSerial.h>
+#include "DHT.h"
 
 // Configure your WiFi options here. MAC address and IP address are not configurable.
 int port = 3466;
@@ -20,13 +22,8 @@ char responseBuffer[65];
 // Dino.h doesn't handle TXRX.
 // Setup a callback to buffer responses for writing.
 void bufferResponse(char *response) {
-   if (strlen(responseBuffer) > 56 ) {
-     writeResponses();
-     strcpy(responseBuffer, response);
-   } else {
-     strcat(responseBuffer, response);
-   }
-   strcat(responseBuffer, "\n");
+  if (strlen(responseBuffer) > 56 ) writeResponses();
+  strcpy(responseBuffer, response);
 }
 void (*writeCallback)(char *str) = bufferResponse;
 
diff --git a/src/lib/DHT.cpp b/src/lib/DHT.cpp
new file mode 100644
index 00000000..90727246
--- /dev/null
+++ b/src/lib/DHT.cpp
@@ -0,0 +1,207 @@
+/******************************************************************
+  DHT Temperature & Humidity Sensor library for Arduino.
+
+  Features:
+  - Support for DHT11 and DHT22/AM2302/RHT03
+  - Auto detect sensor model
+  - Very low memory footprint
+  - Very small code
+
+  http://www.github.com/markruys/arduino-DHT
+
+  Written by Mark Ruys, mark@paracas.nl.
+
+  BSD license, check license.txt for more information.
+  All text above must be included in any redistribution.
+
+  Datasheets:
+  - http://www.micro4you.com/files/sensor/DHT11.pdf
+  - http://www.adafruit.com/datasheets/DHT22.pdf
+  - http://dlnmh9ip6v2uc.cloudfront.net/datasheets/Sensors/Weather/RHT03.pdf
+  - http://meteobox.tk/files/AM2302.pdf
+
+  Changelog:
+   2013-06-10: Initial version
+   2013-06-12: Refactored code
+   2013-07-01: Add a resetTimer method
+ ******************************************************************/
+
+#include "DHT.h"
+
+void DHT::setup(uint8_t pin, DHT_MODEL_t model)
+{
+  DHT::pin = pin;
+  DHT::model = model;
+  DHT::resetTimer(); // Make sure we do read the sensor in the next readSensor()
+
+  if ( model == AUTO_DETECT) {
+    DHT::model = DHT22;
+    readSensor();
+    if ( error == ERROR_TIMEOUT ) {
+      DHT::model = DHT11;
+      delay(1000);
+      // Warning: in case we auto detect a DHT11, you should wait at least 1000 msec
+      // before your first read request. Otherwise you will get a time out error.
+    }
+  }
+}
+
+void DHT::resetTimer()
+{
+  DHT::lastReadTime = millis() - 3000;
+}
+
+float DHT::getHumidity()
+{
+  readSensor();
+  return humidity;
+}
+
+float DHT::getTemperature()
+{
+  readSensor();
+  return temperature;
+}
+
+#ifndef OPTIMIZE_SRAM_SIZE
+
+const char* DHT::getStatusString()
+{
+  switch ( error ) {
+    case DHT::ERROR_TIMEOUT:
+      return "TIMEOUT";
+
+    case DHT::ERROR_CHECKSUM:
+      return "CHECKSUM";
+
+    default:
+      return "OK";
+  }
+}
+
+#else
+
+// At the expense of 26 bytes of extra PROGMEM, we save 11 bytes of
+// SRAM by using the following method:
+
+prog_char P_OK[]       PROGMEM = "OK";
+prog_char P_TIMEOUT[]  PROGMEM = "TIMEOUT";
+prog_char P_CHECKSUM[] PROGMEM = "CHECKSUM";
+
+const char *DHT::getStatusString() {
+  prog_char *c;
+  switch ( error ) {
+    case DHT::ERROR_CHECKSUM:
+      c = P_CHECKSUM; break;
+
+    case DHT::ERROR_TIMEOUT:
+      c = P_TIMEOUT; break;
+
+    default:
+      c = P_OK; break;
+  }
+
+  static char buffer[9];
+  strcpy_P(buffer, c);
+
+  return buffer;
+}
+
+#endif
+
+void DHT::readSensor()
+{
+  // Make sure we don't poll the sensor too often
+  // - Max sample rate DHT11 is 1 Hz   (duty cicle 1000 ms)
+  // - Max sample rate DHT22 is 0.5 Hz (duty cicle 2000 ms)
+  unsigned long startTime = millis();
+  if ( (unsigned long)(startTime - lastReadTime) < (model == DHT11 ? 999L : 1999L) ) {
+    return;
+  }
+  lastReadTime = startTime;
+
+  temperature = NAN;
+  humidity = NAN;
+
+  // Request sample
+
+  digitalWrite(pin, LOW); // Send start signal
+  pinMode(pin, OUTPUT);
+  if ( model == DHT11 ) {
+    delay(18);
+  }
+  else {
+    // This will fail for a DHT11 - that's how we can detect such a device
+    delayMicroseconds(800);
+  }
+
+  pinMode(pin, INPUT);
+  digitalWrite(pin, HIGH); // Switch bus to receive data
+
+  // We're going to read 83 edges:
+  // - First a FALLING, RISING, and FALLING edge for the start bit
+  // - Then 40 bits: RISING and then a FALLING edge per bit
+  // To keep our code simple, we accept any HIGH or LOW reading if it's max 85 usecs long
+
+  word rawHumidity;
+  word rawTemperature;
+  word data;
+
+  for ( int8_t i = -3 ; i < 2 * 40; i++ ) {
+    byte age;
+    startTime = micros();
+
+    do {
+      age = (unsigned long)(micros() - startTime);
+      if ( age > 90 ) {
+        error = ERROR_TIMEOUT;
+        return;
+      }
+    }
+    while ( digitalRead(pin) == (i & 1) ? HIGH : LOW );
+
+    if ( i >= 0 && (i & 1) ) {
+      // Now we are being fed our 40 bits
+      data <<= 1;
+
+      // A zero max 30 usecs, a one at least 68 usecs.
+      if ( age > 30 ) {
+        data |= 1; // we got a one
+      }
+    }
+
+    switch ( i ) {
+      case 31:
+        rawHumidity = data;
+        break;
+      case 63:
+        rawTemperature = data;
+        data = 0;
+        break;
+    }
+  }
+
+  // Verify checksum
+
+  if ( (byte)(((byte)rawHumidity) + (rawHumidity >> 8) + ((byte)rawTemperature) + (rawTemperature >> 8)) != data ) {
+    error = ERROR_CHECKSUM;
+    return;
+  }
+
+  // Store readings
+
+  if ( model == DHT11 ) {
+    humidity = rawHumidity >> 8;
+    temperature = rawTemperature >> 8;
+  }
+  else {
+    humidity = rawHumidity * 0.1;
+
+    if ( rawTemperature & 0x8000 ) {
+      rawTemperature = -(int16_t)(rawTemperature & 0x7FFF);
+    }
+    temperature = ((int16_t)rawTemperature) * 0.1;
+  }
+
+  error = ERROR_NONE;
+}
\ No newline at end of file
diff --git a/src/lib/DHT.h b/src/lib/DHT.h
new file mode 100644
index 00000000..bf6113a0
--- /dev/null
+++ b/src/lib/DHT.h
@@ -0,0 +1,96 @@
+/******************************************************************
+  DHT Temperature & Humidity Sensor library for Arduino.
+
+  Features:
+  - Support for DHT11 and DHT22/AM2302/RHT03
+  - Auto detect sensor model
+  - Very low memory footprint
+  - Very small code
+
+  http://www.github.com/markruys/arduino-DHT
+
+  Written by Mark Ruys, mark@paracas.nl.
+
+  BSD license, check license.txt for more information.
+  All text above must be included in any redistribution.
+
+  Datasheets:
+  - http://www.micro4you.com/files/sensor/DHT11.pdf
+  - http://www.adafruit.com/datasheets/DHT22.pdf
+  - http://dlnmh9ip6v2uc.cloudfront.net/datasheets/Sensors/Weather/RHT03.pdf
+  - http://meteobox.tk/files/AM2302.pdf
+
+  Changelog:
+   2013-06-10: Initial version
+   2013-06-12: Refactored code
+   2013-07-01: Add a resetTimer method
+ ******************************************************************/
+
+#ifndef dht_h
+#define dht_h
+
+#if ARDUINO < 100
+  #include <WProgram.h>
+#else
+  #include <Arduino.h>
+#endif
+
+class DHT
+{
+public:
+
+  typedef enum {
+    AUTO_DETECT,
+    DHT11,
+    DHT22,
+    AM2302,  // Packaged DHT22
+    RHT03    // Equivalent to DHT22
+  }
+  DHT_MODEL_t;
+
+  typedef enum {
+    ERROR_NONE = 0,
+    ERROR_TIMEOUT,
+    ERROR_CHECKSUM
+  }
+  DHT_ERROR_t;
+
+  void setup(uint8_t pin, DHT_MODEL_t model=AUTO_DETECT);
+  void resetTimer();
+
+  float getTemperature();
+  float getHumidity();
+
+  DHT_ERROR_t getStatus() { return error; };
+  const char* getStatusString();
+
+  DHT_MODEL_t getModel() { return model; }
+
+  int getMinimumSamplingPeriod() { return model == DHT11 ? 1000 : 2000; }
+
+  int8_t getNumberOfDecimalsTemperature() { return model == DHT11 ? 0 : 1; };
+  int8_t getLowerBoundTemperature() { return model == DHT11 ? 0 : -40; };
+  int8_t getUpperBoundTemperature() { return model == DHT11 ? 50 : 125; };
+
+  int8_t getNumberOfDecimalsHumidity() { return 0; };
+  int8_t getLowerBoundHumidity() { return model == DHT11 ? 20 : 0; };
+  int8_t getUpperBoundHumidity() { return model == DHT11 ? 90 : 100; };
+
+  static float toFahrenheit(float fromCelcius) { return 1.8 * fromCelcius + 32.0; };
+  static float toCelsius(float fromFahrenheit) { return (fromFahrenheit - 32.0) / 1.8; };
+
+  uint8_t pin;
+
+protected:
+  void readSensor();
+
+  float temperature;
+  float humidity;
+
+private:
+  DHT_MODEL_t model;
+  DHT_ERROR_t error;
+  unsigned long lastReadTime;
+};
+
+#endif /*dht_h*/
\ No newline at end of file
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index d0aeeea5..135952c1 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -6,6 +6,7 @@
 #include "Dino.h"
 DinoLCD dinoLCD;
 DinoSerial dinoSerial;
+DHT dht;
 
 Dino::Dino(){
   messageFragments[0] = cmdStr;
@@ -81,6 +82,7 @@ void Dino::process() {
     case 10: handleLCD           ();  break;
     case 11: shiftWrite          ();  break;
     case 12: handleSerial        ();  break;
+    case 13: handleDHT           ();  break;
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
@@ -105,10 +107,9 @@ void Dino::setupWrite(void (*writeCallback)(char *str)) {
 }
 void Dino::writeResponse() {
   _writeCallback(response);
+  _writeCallback("\n");
 }
 
-
-
 // LISTNENERS
 void Dino::updateListeners() {
   if (timeSince(lastUpdate) > heartRate || timeSince(lastUpdate) < 0) {
@@ -285,6 +286,29 @@ void Dino::handleSerial() {
   dinoSerial.process(val, auxMsg);
 }
 
+// CMD = 13
+// Read a DHT sensor
+void Dino::handleDHT() {
+  #ifdef debug
+    Serial.print("DinoDHT command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
+  #endif
+  if (pin != dht.pin) dht.setup(pin);
+  float reading;
+  char readingBuff[10];
+  char prefix;
+  if (val == 0) {
+    reading = dht.getTemperature();
+    prefix = 'T';
+  } else {
+    reading = dht.getHumidity();
+    prefix = 'H';
+  }
+  if (! isnan(reading)) {
+    dtostrf(reading, 6, 4, readingBuff);
+    sprintf(response, "%d:%c%s", pin, prefix, readingBuff);
+  }
+}
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 3da7ab96..cbd769e0 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -9,6 +9,7 @@
 #include <Servo.h>
 #include "DinoLCD.h"
 #include "DinoSerial.h"
+#include "DHT.h"
 
 // Allocate listener storage based on what board we're running.
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
@@ -47,6 +48,7 @@ class Dino {
     void handleLCD             ();  //cmd = 10
     void shiftWrite            ();  //cmd = 11
     void handleSerial          ();  //cmd = 12
+    void handleDHT             ();  //cmd = 13
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97

From eb997eef83fec44ab6d0d2cb9eca114e7b4e5cc5 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 6 Sep 2013 22:56:43 -0400
Subject: [PATCH 047/296] Fix stupid mistake

---
 lib/dino/components.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 1baf331d..301bd978 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -13,6 +13,6 @@ module Components
     autoload :ShiftRegister,  'dino/components/shift_register'
     autoload :Relay,          'dino/components/relay'
     autoload :SoftwareSerial, 'dino/components/softserial'
-    autoload :SoftwareSerial, 'dino/components/dht'
+    autoload :DHT,            'dino/components/dht'
   end
 end

From 3b4422de2c457b7e17802e784eecf25d19a02e64 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 8 Oct 2013 23:52:58 -0400
Subject: [PATCH 048/296] Fix DHT sensor class and add an example.

---
 examples/dht/dht.rb        | 20 ++++++++++++++++++++
 lib/dino/components/dht.rb | 10 +++++-----
 2 files changed, 25 insertions(+), 5 deletions(-)
 create mode 100644 examples/dht/dht.rb

diff --git a/examples/dht/dht.rb b/examples/dht/dht.rb
new file mode 100644
index 00000000..dc556e03
--- /dev/null
+++ b/examples/dht/dht.rb
@@ -0,0 +1,20 @@
+#
+# Example of how to use the DHT class for DHT 11 and DHT 22 sensors.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+
+# The temperature and humidity functions of the DHT sensors are
+# modelled separately, but both isntances can be set up on the same pin.
+temp = Dino::Components::DHT::Temperature.new(pin: 4, board: board)
+humidity = Dino::Components::DHT::Humidity.new(pin: 4, board: board)
+
+temp.read do |temperature|
+  puts "The temperature is #{temperature} degrees C"
+end
+
+humidity.read do |humidity|
+  puts "The relative humidity is #{humidity}%"
+end
diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
index 69a0e1ff..aa53543d 100644
--- a/lib/dino/components/dht.rb
+++ b/lib/dino/components/dht.rb
@@ -14,13 +14,13 @@ def _read
         def update(data)
           return unless data.match /T/
           data.gsub!('T', '')
-          super(data)
+          super(data.to_f)
         end
       end
 
       class Humidity < Core::BaseInput
         #
-        # These components poll too slowly to poll often enough for a listener.
+        # These components work too slowly to poll often enough for a listener.
         #
         def listen; end
 
@@ -28,10 +28,10 @@ def _read
           board.dht_read(self.pin, 1)
         end
 
-        def update
+        def update(data)
           return unless data.match /H/
-          data.gsub!('T', '')
-          super(data)
+          data.gsub!('H', '')
+          super(data.to_f)
         end
       end
     end

From 273272c592d0966bddbe72c67997b71649a0b51c Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 24 Dec 2013 23:26:31 -0400
Subject: [PATCH 049/296] =?UTF-8?q?Leonardo=20support.=20Closes=20#65.=20T?=
 =?UTF-8?q?emporarily=20disable=20things=20that=20don=E2=80=99t=20work=20o?=
 =?UTF-8?q?n=20Due.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/dino_serial.ino    | 27 ++++++++++++++++++++-------
 src/lib/Dino.cpp       | 15 ++++++++++++++-
 src/lib/Dino.h         |  7 ++++++-
 src/lib/DinoSerial.cpp |  7 ++++++-
 src/lib/DinoSerial.h   |  5 +++++
 5 files changed, 51 insertions(+), 10 deletions(-)

diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index c9a92e6e..f3edb943 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -1,28 +1,41 @@
 #include "Dino.h"
 #include <Servo.h>
 #include <LiquidCrystal.h>
-#include <SoftwareSerial.h>
 #include "DHT.h"
+
+// SoftwareSerial doesn't work on the Due yet.
+#if !defined(__SAM3X8E__)
+  #include <SoftwareSerial.h>
+#endif
+
 Dino dino;
 
-// Use the native serial port on the Arduino Due
+// Use 'serial' to reference the right interface depending on the device.
+// Uses native USB connection on the Due by default.
 #if defined(__SAM3X8E__)
-  Serial_ serial = SerialUSB;
+  Serial_ &serial = SerialUSB;
+#elif defined(__AVR_ATmega32U4__)
+  Serial_ &serial = Serial;
 #else
-  HardwareSerial serial = Serial;
+  HardwareSerial &serial = Serial;
 #endif
 
-// Dino.h doesn't handle TXRX. Setup a function to tell it to write to Serial.
+// Dino.h doesn't handle TXRX. Create a callback so it can write to serial.
 void writeResponse(char *response) { serial.print(response); }
 void (*writeCallback)(char *str) = writeResponse;
 
 void setup() {
-  Serial.begin(115200);
+  serial.begin(115200);
+  
+  // Wait for Leonardo serial port to connect.
+  #if defined(__AVR_ATmega32U4__)
+    while(!serial);
+  #endif
+
   dino.setupWrite(writeCallback);
 }
 
 void loop() {
   while(serial.available() > 0) dino.parse(serial.read());
   dino.updateListeners();
-  serial.flush();
 }
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 135952c1..eace6ba6 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -5,8 +5,12 @@
 #include "Arduino.h"
 #include "Dino.h"
 DinoLCD dinoLCD;
-DinoSerial dinoSerial;
 DHT dht;
+// SoftwareSerial doesn't work on the Due yet.
+#if !defined(__SAM3X8E__)
+  DinoSerial dinoSerial;
+#endif  
+
 
 Dino::Dino(){
   messageFragments[0] = cmdStr;
@@ -277,21 +281,28 @@ void Dino::shiftWrite() {
   shiftOut(pin, atoi(auxMsg), MSBFIRST, val);
 }
 
+
 // CMD = 12
 // Control the SoftwareSerial.
 void Dino::handleSerial() {
   #ifdef debug
     Serial.print("DinoSerial command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
   #endif
+  // SoftwareSerial doesn't work on the Due yet.
+  #if !defined(__SAM3X8E__)
   dinoSerial.process(val, auxMsg);
+  #endif
 }
 
+
 // CMD = 13
 // Read a DHT sensor
 void Dino::handleDHT() {
   #ifdef debug
     Serial.print("DinoDHT command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
   #endif
+  // dtostrf doesn't work on the Due yet.
+  #if !defined(__SAM3X8E__)
   if (pin != dht.pin) dht.setup(pin);
   float reading;
   char readingBuff[10];
@@ -307,8 +318,10 @@ void Dino::handleDHT() {
     dtostrf(reading, 6, 4, readingBuff);
     sprintf(response, "%d:%c%s", pin, prefix, readingBuff);
   }
+  #endif
 }
 
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index cbd769e0..7164eb21 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -8,9 +8,14 @@
 #include "Arduino.h"
 #include <Servo.h>
 #include "DinoLCD.h"
-#include "DinoSerial.h"
 #include "DHT.h"
 
+// SoftwareSerial doesn't work on the Due yet.
+#if !defined(__SAM3X8E__)
+  #include "DinoSerial.h"
+#endif
+
+
 // Allocate listener storage based on what board we're running.
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
 #  define PIN_COUNT 70
diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
index 8ecffb9d..068344b7 100644
--- a/src/lib/DinoSerial.cpp
+++ b/src/lib/DinoSerial.cpp
@@ -1,3 +1,6 @@
+// SoftwareSerial doesn't work on the Due yet.
+#if !defined(__SAM3X8E__)
+
 #include "Arduino.h"
 #include "DinoSerial.h"
 
@@ -37,4 +40,6 @@ void DinoSerial::setPins(char *aux) {
 void DinoSerial::begin(char *aux) {
   int baud = atoi(aux);
   softSerial.begin(baud);
-}
\ No newline at end of file
+}
+
+#endif
diff --git a/src/lib/DinoSerial.h b/src/lib/DinoSerial.h
index a4427767..5160bc72 100644
--- a/src/lib/DinoSerial.h
+++ b/src/lib/DinoSerial.h
@@ -1,3 +1,6 @@
+// SoftwareSerial doesn't work on the Due yet.
+#if !defined(__SAM3X8E__)
+
 #ifndef DinoSerial_h
 #define DinoSerial_h
 
@@ -16,3 +19,5 @@ class DinoSerial {
 };
 
 #endif
+
+#endif

From 6da2977c8d6e48fb0b1c336034344b339d50956b Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 24 Dec 2013 23:41:07 -0400
Subject: [PATCH 050/296] Disable software serial for Due on ethernet and wifi

---
 src/dino_ethernet.ino | 6 +++++-
 src/dino_wifi.ino     | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index d909e99a..1091c5db 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -3,9 +3,13 @@
 #include <Ethernet.h>
 #include <Servo.h>
 #include <LiquidCrystal.h>
-#include <SoftwareSerial.h>
 #include "DHT.h"
 
+// SoftwareSerial doesn't work on the Due yet.
+#if !defined(__SAM3X8E__)
+  #include <SoftwareSerial.h>
+#endif
+
 // Configure your MAC address, IP address, and HTTP port here.
 byte mac[] = { 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 };
 IPAddress ip(192,168,0,77);
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 9387e85b..50a16d3a 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -3,9 +3,13 @@
 #include <WiFi.h>
 #include <Servo.h>
 #include <LiquidCrystal.h>
-#include <SoftwareSerial.h>
 #include "DHT.h"
 
+// SoftwareSerial doesn't work on the Due yet.
+#if !defined(__SAM3X8E__)
+  #include <SoftwareSerial.h>
+#endif
+
 // Configure your WiFi options here. MAC address and IP address are not configurable.
 int port = 3466;
 char ssid [] = "yourNetwork";

From 0ae5261e137c18a7925f131c1d7941e5e2b7a21c Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Thu, 26 Dec 2013 15:39:11 -0400
Subject: [PATCH 051/296] =?UTF-8?q?Refactor=20all=20the=20components?=
 =?UTF-8?q?=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 lib/dino/board.rb                             |  21 ++-
 lib/dino/components.rb                        |   4 +-
 lib/dino/components/basic.rb                  |  10 ++
 lib/dino/components/basic/analog_input.rb     |  21 +++
 lib/dino/components/basic/analog_output.rb    |  21 +++
 .../{core => basic}/digital_input.rb          |  17 ++-
 lib/dino/components/basic/digital_output.rb   |  37 +++++
 lib/dino/components/button.rb                 |   4 +-
 lib/dino/components/core.rb                   |  13 --
 lib/dino/components/core/analog_input.rb      |  15 ---
 lib/dino/components/core/base.rb              |  41 ------
 lib/dino/components/core/base_input.rb        |  72 ----------
 lib/dino/components/core/base_output.rb       |  48 -------
 lib/dino/components/core/multi_pin.rb         |  65 ---------
 lib/dino/components/ir_receiver.rb            |   9 +-
 lib/dino/components/lcd.rb                    |   4 +-
 lib/dino/components/led.rb                    |   2 +-
 lib/dino/components/mixins.rb                 |  11 ++
 lib/dino/components/mixins/callbacks.rb       |  33 +++++
 lib/dino/components/mixins/listener.rb        |  26 ++++
 lib/dino/components/mixins/poller.rb          |  29 ++++
 lib/dino/components/mixins/reader.rb          |  20 +++
 .../components/{core => mixins}/threaded.rb   |  12 +-
 lib/dino/components/relay.rb                  |   2 +-
 lib/dino/components/rgb_led.rb                |  15 +--
 lib/dino/components/sensor.rb                 |   2 +-
 lib/dino/components/servo.rb                  |   9 +-
 lib/dino/components/setup.rb                  |  11 ++
 lib/dino/components/setup/base.rb             |  48 +++++++
 lib/dino/components/setup/input.rb            |  23 ++++
 lib/dino/components/setup/multi_pin.rb        |  93 +++++++++++++
 lib/dino/components/setup/output.rb           |  14 ++
 lib/dino/components/setup/single_pin.rb       |  27 ++++
 lib/dino/components/shift_register.rb         |  13 +-
 lib/dino/components/softserial.rb             |   3 +-
 lib/dino/components/ssd.rb                    |  97 ++++++-------
 lib/dino/components/stepper.rb                |  12 +-
 spec/lib/board_spec.rb                        |  57 +++-----
 .../{core => basic}/analog_input_spec.rb      |   2 +-
 .../{core => basic}/digital_input_spec.rb     |   5 +-
 spec/lib/components/button_spec.rb            |   8 --
 spec/lib/components/core/base_input_spec.rb   | 127 ------------------
 spec/lib/components/core/base_output_spec.rb  |  91 -------------
 spec/lib/components/core/base_spec.rb         |  71 ----------
 spec/lib/components/core/multi_pin_spec.rb    |  78 -----------
 spec/lib/components/core/threaded_spec.rb     | 104 --------------
 spec/lib/components/lcd_spec.rb               |  68 +++++-----
 spec/lib/components/led_spec.rb               |   1 +
 spec/lib/components/rgb_led_spec.rb           |   6 +-
 spec/lib/components/setup/base_spec.rb        |  28 ++++
 spec/lib/components/setup/input_spec.rb       |  44 ++++++
 spec/lib/components/setup/multi_pin_spec.rb   |  29 ++++
 spec/lib/components/setup/output_spec.rb      |  25 ++++
 spec/lib/components/setup/single_pin_spec.rb  |  37 +++++
 spec/lib/components/shift_register_spec.rb    |   6 +-
 spec/lib/components/softwareserial_spec.rb    |   3 +-
 spec/lib/components/ssd_spec.rb               |  32 ++---
 spec/lib/components/stepper_spec.rb           |   4 +-
 58 files changed, 781 insertions(+), 949 deletions(-)
 create mode 100644 lib/dino/components/basic.rb
 create mode 100644 lib/dino/components/basic/analog_input.rb
 create mode 100644 lib/dino/components/basic/analog_output.rb
 rename lib/dino/components/{core => basic}/digital_input.rb (69%)
 create mode 100644 lib/dino/components/basic/digital_output.rb
 delete mode 100644 lib/dino/components/core.rb
 delete mode 100644 lib/dino/components/core/analog_input.rb
 delete mode 100644 lib/dino/components/core/base.rb
 delete mode 100644 lib/dino/components/core/base_input.rb
 delete mode 100644 lib/dino/components/core/base_output.rb
 delete mode 100644 lib/dino/components/core/multi_pin.rb
 create mode 100644 lib/dino/components/mixins.rb
 create mode 100644 lib/dino/components/mixins/callbacks.rb
 create mode 100644 lib/dino/components/mixins/listener.rb
 create mode 100644 lib/dino/components/mixins/poller.rb
 create mode 100644 lib/dino/components/mixins/reader.rb
 rename lib/dino/components/{core => mixins}/threaded.rb (92%)
 create mode 100644 lib/dino/components/setup.rb
 create mode 100644 lib/dino/components/setup/base.rb
 create mode 100644 lib/dino/components/setup/input.rb
 create mode 100644 lib/dino/components/setup/multi_pin.rb
 create mode 100644 lib/dino/components/setup/output.rb
 create mode 100644 lib/dino/components/setup/single_pin.rb
 rename spec/lib/components/{core => basic}/analog_input_spec.rb (97%)
 rename spec/lib/components/{core => basic}/digital_input_spec.rb (96%)
 delete mode 100644 spec/lib/components/button_spec.rb
 delete mode 100644 spec/lib/components/core/base_input_spec.rb
 delete mode 100644 spec/lib/components/core/base_output_spec.rb
 delete mode 100644 spec/lib/components/core/base_spec.rb
 delete mode 100644 spec/lib/components/core/multi_pin_spec.rb
 delete mode 100644 spec/lib/components/core/threaded_spec.rb
 create mode 100644 spec/lib/components/setup/base_spec.rb
 create mode 100644 spec/lib/components/setup/input_spec.rb
 create mode 100644 spec/lib/components/setup/multi_pin_spec.rb
 create mode 100644 spec/lib/components/setup/output_spec.rb
 create mode 100644 spec/lib/components/setup/single_pin_spec.rb

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index eee126cc..cfc70519 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -1,11 +1,11 @@
 module Dino
   class Board
-    attr_reader :high, :low, :input_hardware, :analog_zero, :dac_zero
+    attr_reader :high, :low, :components, :analog_zero, :dac_zero
     DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
     def initialize(io, options={})
       @bits = options[:bits] || 8
-      @io, @input_hardware = io, []
+      @io, @components = io, []
       io.add_observer(self)
 
       @analog_zero, @dac_zero = @io.handshake.to_s.split(",").map { |pin| pin.to_i }
@@ -47,26 +47,23 @@ def write(msg)
     end
 
     def update(pin, msg)
-      @input_hardware.each do |part|
+      @components.each do |part|
         part.update(msg) if convert_pin(pin) == convert_pin(part.pin)
       end
     end
 
-    def add_input_hardware(part)
-      start_read
-      @input_hardware << part
-      set_pin_mode(part.pin, :in, part.pullup)
+    def add_component(component)
+      @components << component
     end
 
-    def remove_input_hardware(part)
-      stop_listener(part.pin)
-      @input_hardware.delete(part)
+    def remove_component(component)
+      stop_listener(component.pin)
+      @components.delete(component)
     end
 
-    def set_pin_mode(pin, mode, pullup=nil)
+    def set_pin_mode(pin, mode)
       pin, value = convert_pin(pin), mode == :out ? 0 : 1
       write Dino::Message.encode(command: 0, pin: pin, value: value)
-      set_pullup(pin, pullup) if mode == :in
     end
 
     def set_pullup(pin, pullup)
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index cd3d0ca4..c80915e8 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -1,6 +1,8 @@
 module Dino
   module Components
-    require 'dino/components/core'
+    require 'dino/components/setup'
+    require 'dino/components/mixins'
+    require 'dino/components/basic'
     autoload :Led,            'dino/components/led'
     autoload :Button,         'dino/components/button'
     autoload :Sensor,         'dino/components/sensor'
diff --git a/lib/dino/components/basic.rb b/lib/dino/components/basic.rb
new file mode 100644
index 00000000..79463819
--- /dev/null
+++ b/lib/dino/components/basic.rb
@@ -0,0 +1,10 @@
+module Dino
+  module Components
+    module Basic
+      require 'dino/components/basic/digital_output'
+      require 'dino/components/basic/analog_input'
+      require 'dino/components/basic/digital_input'
+      require 'dino/components/basic/analog_output'
+    end
+  end
+end
\ No newline at end of file
diff --git a/lib/dino/components/basic/analog_input.rb b/lib/dino/components/basic/analog_input.rb
new file mode 100644
index 00000000..3d46c6b3
--- /dev/null
+++ b/lib/dino/components/basic/analog_input.rb
@@ -0,0 +1,21 @@
+module Dino
+  module Components
+    module Basic
+      class AnalogInput
+        include Setup::SinglePin
+        include Setup::Input
+        include Mixins::Reader
+        include Mixins::Poller
+        include Mixins::Listener
+        
+        def _read
+          board.analog_read(self.pin)
+        end
+
+        def _listen
+          board.analog_listen(self.pin)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/basic/analog_output.rb b/lib/dino/components/basic/analog_output.rb
new file mode 100644
index 00000000..fd7a57db
--- /dev/null
+++ b/lib/dino/components/basic/analog_output.rb
@@ -0,0 +1,21 @@
+module Dino
+  module Components
+    module Basic
+      class AnalogOutput < DigitalOutput
+        interrupt_with :analog_write
+
+        def analog_write(value)
+          board.analog_write(pin, @state = value)
+        end
+
+        def write(value)
+          unless [board.low, board.high].include? value
+            analog_write(value)
+          else
+            digital_write(value)
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/core/digital_input.rb b/lib/dino/components/basic/digital_input.rb
similarity index 69%
rename from lib/dino/components/core/digital_input.rb
rename to lib/dino/components/basic/digital_input.rb
index da7666c0..23808aa1 100644
--- a/lib/dino/components/core/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -1,15 +1,20 @@
 module Dino
   module Components
-    module Core
-      class DigitalInput < BaseInput
-        HIGH = 1
-        LOW = 0
+    module Basic
+      class DigitalInput
+        include Setup::SinglePin
+        include Setup::Input
+        include Mixins::Reader
+        include Mixins::Poller
+        include Mixins::Listener
 
-        def initialize(options={})
-          super(options)
+        def after_initialize(options={})
           _listen
         end
 
+        HIGH = 1
+        LOW = 0
+
         def _read
           board.digital_read(self.pin)
         end
diff --git a/lib/dino/components/basic/digital_output.rb b/lib/dino/components/basic/digital_output.rb
new file mode 100644
index 00000000..13c88136
--- /dev/null
+++ b/lib/dino/components/basic/digital_output.rb
@@ -0,0 +1,37 @@
+module Dino
+  module Components
+    module Basic
+      class DigitalOutput
+        include Setup::SinglePin
+        include Setup::Output
+        include Mixins::Threaded
+        interrupt_with :digital_write
+
+        def after_initialize(options={})
+          low
+        end
+
+        def digital_write(value)
+          board.digital_write(pin, @state = value)
+        end
+
+        alias :write :digital_write
+
+        def low
+          digital_write(board.low)
+        end
+
+        def high
+          digital_write(board.high)
+        end
+
+        def toggle
+          state == board.low ? high : low
+        end
+
+        alias :off :low
+        alias :on  :high
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/button.rb b/lib/dino/components/button.rb
index 90b22cae..a70dbe31 100644
--- a/lib/dino/components/button.rb
+++ b/lib/dino/components/button.rb
@@ -1,8 +1,8 @@
 module Dino
   module Components
-    class Button < Core::DigitalInput
+    class Button < Basic::DigitalInput
       alias :down :on_low
-      alias :up :on_high
+      alias :up   :on_high
     end
   end
 end
diff --git a/lib/dino/components/core.rb b/lib/dino/components/core.rb
deleted file mode 100644
index f0eac0e8..00000000
--- a/lib/dino/components/core.rb
+++ /dev/null
@@ -1,13 +0,0 @@
-module Dino
-  module Components
-    module Core
-      require 'dino/components/core/base'
-      require 'dino/components/core/multi_pin'
-      require 'dino/components/core/threaded'
-      require 'dino/components/core/base_input'
-      require 'dino/components/core/analog_input'
-      require 'dino/components/core/digital_input'
-      require 'dino/components/core/base_output'
-    end
-  end
-end
\ No newline at end of file
diff --git a/lib/dino/components/core/analog_input.rb b/lib/dino/components/core/analog_input.rb
deleted file mode 100644
index f15dc361..00000000
--- a/lib/dino/components/core/analog_input.rb
+++ /dev/null
@@ -1,15 +0,0 @@
-module Dino
-  module Components
-    module Core
-      class AnalogInput < BaseInput
-        def _read
-          board.analog_read(self.pin)
-        end
-
-        def _listen
-          board.analog_listen(self.pin)
-        end
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/core/base.rb b/lib/dino/components/core/base.rb
deleted file mode 100644
index e9eec9fa..00000000
--- a/lib/dino/components/core/base.rb
+++ /dev/null
@@ -1,41 +0,0 @@
-module Dino
-  module Components
-    module Core
-      class Base
-        attr_reader :board, :pin, :mode, :pullup, :state
-
-        def initialize(options={})
-          raise 'board and pin are required for a component' if options[:board].nil? || options[:pin].nil?
-
-          self.board = options[:board]
-          self.pin = board.convert_pin(options[:pin])
-          @pullup = options[:pullup]
-
-          after_initialize(options)
-        end
-
-        protected
-
-        attr_writer :board, :pin
-
-        #
-        # Components::Core::Base does a lot of setup work for you.
-        # Define #after_initialize in your subclass instead of overriding #initialize
-        #
-        # @note This method should be implemented in the BaseComponent subclass.
-        #
-        def after_initialize(options={}) ; end
-
-        def mode=(mode)
-          @mode = mode
-          board.set_pin_mode(self.pin, mode, pullup)
-        end
-
-        def pullup=(pullup)
-          @pullup = pullup
-          board.set_pullup(self.pin, pullup)
-        end
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/core/base_input.rb b/lib/dino/components/core/base_input.rb
deleted file mode 100644
index 23b67f0a..00000000
--- a/lib/dino/components/core/base_input.rb
+++ /dev/null
@@ -1,72 +0,0 @@
-module Dino
-  module Components
-    module Core
-      class BaseInput < Base
-        include Threaded
-
-        def initialize(options={})
-          super options
-
-          remove_callbacks
-          self.mode = :in
-          board.add_input_hardware(self)
-
-          after_initialize(options)
-        end
-        
-        def read(&block)
-          add_callback(:read, &block) if block_given?
-          _read
-          loop { break if @callbacks[:read].empty? }
-        end
-        
-        def listen(&block)
-          add_callback(:listen, &block) if block_given?
-          _listen
-        end
-
-        def poll(interval, &block)
-          add_callback(:poll, &block) if block_given?
-          threaded_loop do
-            _read; sleep interval
-          end
-        end
-
-        def stop
-          stop_thread
-          board.stop_listener(pin)
-          remove_callback :listen; remove_callback :poll
-        end
-
-        #
-        # Defined in DigitalInput and AnalogInput subclasses.
-        # _read corresponds to Board#digital_read and Board#analog_read respectively.
-        # _listen corresponds to Board#digital_listen and Board#analog_listen respectively
-        #
-        def _read; end
-        def _listen; end
-
-        def add_callback(key=nil, &block)
-          key ||= :persistent
-          @callbacks[key] ||= []
-          @callbacks[key] << block
-        end
-        
-        def remove_callback(key=nil)
-          key ? @callbacks[key] = [] : @callbacks = {}
-        end
-
-        alias :on_data :add_callback
-        alias :remove_callbacks :remove_callback
-
-        def update(data)
-          @state = data
-          @callbacks.each_value do |array|
-            array.each { |callback| callback.call(@state) }
-          end
-          remove_callback :read
-        end
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/core/base_output.rb b/lib/dino/components/core/base_output.rb
deleted file mode 100644
index ca61ab25..00000000
--- a/lib/dino/components/core/base_output.rb
+++ /dev/null
@@ -1,48 +0,0 @@
-module Dino
-  module Components
-    module Core
-      class BaseOutput < Base
-        include Threaded
-        interrupt_with :digital_write, :analog_write
-
-        def initialize(options={})
-          super options
-
-          self.mode = :out
-          low
-        end
-
-        def digital_write(value)
-          board.digital_write(pin, @state = value)
-        end
-
-        def analog_write(value)
-          board.analog_write(pin, @state = value)
-        end
-
-        def write(value)
-          unless [board.low, board.high].include? value
-            analog_write(value)
-          else
-            digital_write(value)
-          end
-        end
-
-        def low
-          digital_write(board.low)
-        end
-
-        def high
-          digital_write(board.high)
-        end
-
-        def toggle
-          state == board.low ? high : low
-        end
-
-        alias :off :low
-        alias :on  :high
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/core/multi_pin.rb b/lib/dino/components/core/multi_pin.rb
deleted file mode 100644
index 23294583..00000000
--- a/lib/dino/components/core/multi_pin.rb
+++ /dev/null
@@ -1,65 +0,0 @@
-module Dino
-  module Components
-    module Core
-      class MultiPin
-        attr_reader :board, :pins, :pullups
-
-        def initialize(options={})
-          raise 'board and pins are required for a component' if options[:board].nil? || options[:pins].nil?
-
-          self.board = options[:board]
-          self.pins = options[:pins]
-          self.pullups = options[:pullups] || {}
-          
-          after_initialize(options)
-        end
-
-        def state
-          state = {}
-          pins.each_key do |pin|
-            state[pin] = self.send(pin).state
-          end
-          state
-        end
-
-        protected
-
-        attr_writer :board, :pins, :pullups
-
-        #
-        # @note This method should be implemented in your subclass.
-        #
-        def after_initialize(options={}) ; end
-
-        #
-        # Build complex components by proxying each pin to a basic, single pin component.
-        #
-        # Call #proxy with a hash like:
-        #   class MyComponent < MultiPin
-        #     proxy {lamp: Core::BaseOutput, motor: Core::BaseOutput}
-        #   end
-        #
-        # Checks the @pins hash for the pins corresponding to the keys like:
-        #   pins => {lamp: 9, motor: 10}  - No error
-        #   pins => {lamp: 9}             - Error raised
-        #
-        # It instantiates a new instance of the class passed in for each key in an instance variable.
-        # Sets up an attr_reader on the singleton class, so the proxy component can be accessed like:
-        #   my_component.lamp.on; my_component.motor.analog_write(128) 
-        # 
-        def proxy(proxies={})
-          proxies.each_pair do |key, klass|
-            raise "missing pins[:#{key}] pin" unless pins[key]
-
-            proxy_component = klass.new(board: board, pin: pins[key], pullup: pullups[key])
-            instance_variable_set("@#{key}", proxy_component)
-
-            singleton_class.class_eval { attr_reader key }
-          end
-        end
-
-        alias :proxies :proxy
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/ir_receiver.rb b/lib/dino/components/ir_receiver.rb
index ccbd10a2..5dcf44a0 100644
--- a/lib/dino/components/ir_receiver.rb
+++ b/lib/dino/components/ir_receiver.rb
@@ -1,12 +1,7 @@
 module Dino
   module Components
-    class IrReceiver < Core::DigitalInput
-      alias :flash :on_low
-
-      def update(data)
-        return if data.to_i == HIGH
-        super data
-      end
+    class IrReceiver < Basic::DigitalInput
+      alias :on_flash :on_low
     end
   end
 end
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index f46dc4dc..6d4d85b2 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -1,7 +1,9 @@
 module Dino
   module Components
-    class LCD < Core::MultiPin
+    class LCD
+      include Setup::MultiPin
 
+      require_pins :rs, :enable, :d4, :d5, :d6, :d7
       # Initialize in 4 bits mode
       #
       # Dino::Componentes::LCD.new(
diff --git a/lib/dino/components/led.rb b/lib/dino/components/led.rb
index b8f8dff8..ff917576 100644
--- a/lib/dino/components/led.rb
+++ b/lib/dino/components/led.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class Led < Core::BaseOutput
+    class Led < Basic::AnalogOutput
       def blink(interval=0.5)
         threaded_loop do 
           toggle
diff --git a/lib/dino/components/mixins.rb b/lib/dino/components/mixins.rb
new file mode 100644
index 00000000..f889b4e0
--- /dev/null
+++ b/lib/dino/components/mixins.rb
@@ -0,0 +1,11 @@
+module Dino
+  module Components
+    module Mixins
+      require 'dino/components/mixins/threaded'
+      require 'dino/components/mixins/callbacks'
+      require 'dino/components/mixins/reader'
+      require 'dino/components/mixins/poller'
+      require 'dino/components/mixins/listener'
+    end
+  end
+end
\ No newline at end of file
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
new file mode 100644
index 00000000..dd1006d1
--- /dev/null
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -0,0 +1,33 @@
+module Dino
+  module Components
+    module Mixins
+      module Callbacks
+        def callbacks
+          @callbacks ||= {}
+        end
+
+        def add_callback(key=:persistent, &block)
+          callbacks
+          @callbacks[key] ||= []
+          @callbacks[key] << block
+        end
+        
+        def remove_callback(key=nil)
+          callbacks
+          key ? @callbacks[key] = [] : @callbacks = {}
+        end
+
+        alias :on_data :add_callback
+        alias :remove_callbacks :remove_callback
+
+        def update(data)
+          @state = data
+          callbacks.each_value do |array|
+            array.each { |callback| callback.call(@state) }
+          end
+          remove_callback :read
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/mixins/listener.rb b/lib/dino/components/mixins/listener.rb
new file mode 100644
index 00000000..9e1e040e
--- /dev/null
+++ b/lib/dino/components/mixins/listener.rb
@@ -0,0 +1,26 @@
+module Dino
+  module Components
+    module Mixins
+      module Listener
+      	include Callbacks
+
+        def listen(&block)
+          stop
+          add_callback(:listen, &block) if block_given?
+          _listen
+        end
+
+        def stop
+          super if defined?(super)
+          board.stop_listener(pin)
+          remove_callbacks :listen
+        end
+
+        #
+        # Including component should define this to start a listener on the board.
+        #
+        def _listen; end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/mixins/poller.rb b/lib/dino/components/mixins/poller.rb
new file mode 100644
index 00000000..ac478a1f
--- /dev/null
+++ b/lib/dino/components/mixins/poller.rb
@@ -0,0 +1,29 @@
+module Dino
+  module Components
+    module Mixins
+      module Poller
+        include Reader
+        #
+        # Make sure Threaded is in the including class.
+        #
+        def self.included(base)
+          base.class_eval { include Threaded }
+        end
+
+        def poll(interval, &block)
+          stop
+          add_callback(:poll, &block) if block_given?
+          threaded_loop do
+            _read; sleep interval
+          end
+        end
+
+        def stop
+          super if defined?(super)
+          stop_thread
+          remove_callback :poll
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
new file mode 100644
index 00000000..89810135
--- /dev/null
+++ b/lib/dino/components/mixins/reader.rb
@@ -0,0 +1,20 @@
+module Dino
+  module Components
+    module Mixins
+      module Reader
+        include Callbacks
+
+        def read(&block)
+          add_callback(:read, &block) if block_given?
+          _read
+          loop { break if @callbacks[:read].empty? }
+        end
+        
+        #
+        # Including component should define this to perform a single read on the board.
+        #
+        def _read; end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/core/threaded.rb b/lib/dino/components/mixins/threaded.rb
similarity index 92%
rename from lib/dino/components/core/threaded.rb
rename to lib/dino/components/mixins/threaded.rb
index a55c93fd..be981dea 100644
--- a/lib/dino/components/core/threaded.rb
+++ b/lib/dino/components/mixins/threaded.rb
@@ -1,21 +1,21 @@
 module Dino
   module Components
-    module Core
+    module Mixins
       module Threaded
         attr_reader :thread, :interrupts_enabled
 
-        def self.included(base)
-          base.extend(ClassMethods)
-        end
-
         module ClassMethods
           def interrupt_with(*args)
             interrupts = self.class_eval('@@interrupts') rescue []
-            args.each { |a| interrupts << a }
+            interrupts = (interrupts + args).uniq
             self.class_variable_set(:@@interrupts, interrupts)
           end
         end
 
+        def self.included(base)
+          base.extend ClassMethods
+        end
+
         def threaded(&block)
           stop_thread
           enable_interrupts unless interrupts_enabled
diff --git a/lib/dino/components/relay.rb b/lib/dino/components/relay.rb
index 3b285532..066b81e4 100644
--- a/lib/dino/components/relay.rb
+++ b/lib/dino/components/relay.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class Relay < Core::BaseOutput
+    class Relay < Basic::DigitalOutput
     end
   end
 end
diff --git a/lib/dino/components/rgb_led.rb b/lib/dino/components/rgb_led.rb
index d91ddacd..2c92cc08 100644
--- a/lib/dino/components/rgb_led.rb
+++ b/lib/dino/components/rgb_led.rb
@@ -1,15 +1,12 @@
 module Dino
   module Components
-    class RgbLed < Core::MultiPin
-      #
-      # options = {board: my_board, pins: {red: red_pin, green: green_pin, blue: blue_pin}
-      #
-      def after_initialize(options={})
-        proxies red:   Core::BaseOutput,
-                green: Core::BaseOutput,
-                blue:  Core::BaseOutput 
-      end
+    class RgbLed
+      include Setup::MultiPin
 
+      proxy_pins red:   Basic::AnalogOutput,
+                 green: Basic::AnalogOutput,
+                 blue:  Basic::AnalogOutput 
+      
       # Format: [R, G, B]
       COLORS = {
         red:     [255, 000, 000],
diff --git a/lib/dino/components/sensor.rb b/lib/dino/components/sensor.rb
index ec96d532..4cb7f949 100644
--- a/lib/dino/components/sensor.rb
+++ b/lib/dino/components/sensor.rb
@@ -1,6 +1,6 @@
 module Dino
   module Components
-    class Sensor < Core::AnalogInput      
+    class Sensor < Basic::AnalogInput
     end
   end
 end
diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index e0461d71..f6902cf6 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -1,6 +1,9 @@
 module Dino
   module Components
-    class Servo < Core::BaseOutput
+    class Servo
+      include Setup::SinglePin
+      include Mixins::Threaded
+      
       def after_initialize(options={})
         board.servo_toggle(pin, 1)
       end
@@ -10,9 +13,7 @@ def position=(value)
         board.servo_write(pin, @state)
       end
 
-      def position
-        @state
-      end
+      alias :position :state
 
       def angle(value)
         value == 180 ? value : value % 180
diff --git a/lib/dino/components/setup.rb b/lib/dino/components/setup.rb
new file mode 100644
index 00000000..44af3b68
--- /dev/null
+++ b/lib/dino/components/setup.rb
@@ -0,0 +1,11 @@
+module Dino
+  module Components
+    module Setup
+      require 'dino/components/setup/base'
+      require 'dino/components/setup/single_pin'
+      require 'dino/components/setup/multi_pin'
+      require 'dino/components/setup/input'
+      require 'dino/components/setup/output'
+    end
+  end
+end
diff --git a/lib/dino/components/setup/base.rb b/lib/dino/components/setup/base.rb
new file mode 100644
index 00000000..acf53c6b
--- /dev/null
+++ b/lib/dino/components/setup/base.rb
@@ -0,0 +1,48 @@
+module Dino
+  module Components
+    module Setup
+      module Base
+        attr_reader :board, :state
+
+        def initialize(options={})
+          initialize_board(options)
+          initialize_pins(options)
+          register
+
+          after_initialize(options)
+        end
+
+        protected
+
+        attr_writer :board, :state
+
+        def initialize_board(options={})
+          raise 'a board is required for a component' unless options[:board]
+          self.board = options[:board]
+        end
+
+        def register
+          board.add_component(self)
+        end
+
+        def unregister
+          board.remove_component(self)
+        end
+
+        #
+        # Setup::Base just requires a board and adds the component to the list of components.
+        # Mix in other modules from Setup or define this method in your class to initialize the pin(s).
+        #
+        def initialize_pins(options={}) ; end
+        alias :initialize_pin :initialize_pins
+
+        #
+        # Define #after_initialize in your component class.
+        #
+        # @note This method should be implemented in the including class.
+        #
+        def after_initialize(options={}) ; end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/setup/input.rb b/lib/dino/components/setup/input.rb
new file mode 100644
index 00000000..b5a00557
--- /dev/null
+++ b/lib/dino/components/setup/input.rb
@@ -0,0 +1,23 @@
+module Dino
+  module Components
+    module Setup
+      module Input
+        attr_reader :pullup
+
+        def pullup=(pullup)
+          @pullup = pullup
+          board.set_pullup(self.pin, pullup)
+        end
+
+        protected
+
+        def initialize_pins(options={})
+          super(options)
+          self.mode = :in
+          self.pullup = options[:pullup]
+          board.start_read
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
new file mode 100644
index 00000000..0d1b89df
--- /dev/null
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -0,0 +1,93 @@
+module Dino
+  module Components
+    module Setup
+      module MultiPin
+        #
+        # Build complex components by modeling them as separate single pin subcomponents.
+        #
+        include Base
+        attr_reader :pins, :pullups, :proxies
+
+        #
+        # Return a hash with the state of each proxy component.
+        #
+        def state
+          hash = {}
+          proxies.each_key do |key|
+            hash[key] = self.proxies[key].state rescue nil
+          end
+          hash
+        end
+
+      protected
+        attr_writer :pins, :pullups, :proxies
+
+        def self.included(base)
+          base.extend ClassMethods
+        end
+
+        #
+        # A subcomponent's pin can be required, proxied, or both.
+        #
+        # Requiring a pin simply raises an error if a value for it is not specified in the options[:pins] hash.
+        # It will NOT automatically set up a subcomponent or do anything further.
+        # This can be useful for native libraries where modeling the pin as a subcomponent is not necessary.
+        # Or for components with pins that may be left disconnected.
+        #
+        # Proxying a pin automatically requires it, and specifies what single-pin component it should be modeled as.
+        # This module will automatically intialize the proxy component and store it in the @proxies instance variable.
+        # It also creates an attr_accessor on the singleton class for the subcomponent.
+        # The accessor and the hash element are both named using the pin's key from the options[:pins] hash.
+        #
+        # A proxied pin can be NOT required by including `optional: true` in the options hash passed to #proxy_pins.
+        # Please see the source for the SSD and RgbLed components for good examples of how all this works.
+        #
+        module ClassMethods
+          def require_pins(*args)
+            required_pins = self.class_eval('@@required_pins') rescue []
+            required_pins = (required_pins + args).uniq
+            self.class_variable_set(:@@required_pins, required_pins)
+          end
+          alias :require_pin :require_pins
+
+          def proxy_pins(options={})
+            if options[:optional]
+              options.reject! { |k| k == :optional }
+            else
+              options.reject! { |k| k == :optional } if (options[:optional] == false)
+              require_pins(*options.keys)
+            end
+
+            proxied_pins = self.class_eval('@@proxied_pins') rescue {}         
+            proxied_pins.merge!(options)
+            self.class_variable_set(:@@proxied_pins, proxied_pins)
+          end
+          alias :proxy_pin :proxy_pins
+        end
+
+        def initialize_pins(options={})
+          self.pins = options[:pins]
+          self.pullups = options[:pullups] || {}
+          self.proxies = {}
+          validate_pins
+          build_proxies
+        end
+
+        def validate_pins
+          required_pins = self.class.class_eval('@@required_pins') rescue []
+          required_pins.each { |key| raise "missing pins[:#{key}] pin" unless pins[key] }
+        end
+
+        def build_proxies
+          proxied_pins = self.class.class_eval('@@proxied_pins') rescue {}
+          proxied_pins.each_pair do |key, klass|
+            component = klass.new(board: board, pin: pins[key], pullup: pullups[key]) rescue nil
+            self.proxies[key] = component
+            instance_variable_set("@#{key}", component)
+            singleton_class.class_eval { attr_reader key }
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/setup/output.rb b/lib/dino/components/setup/output.rb
new file mode 100644
index 00000000..4ef8bca3
--- /dev/null
+++ b/lib/dino/components/setup/output.rb
@@ -0,0 +1,14 @@
+module Dino
+  module Components
+    module Setup
+      module Output
+        protected
+
+        def initialize_pins(options={})
+          super(options)
+          self.mode = :out
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/setup/single_pin.rb b/lib/dino/components/setup/single_pin.rb
new file mode 100644
index 00000000..6088b3e0
--- /dev/null
+++ b/lib/dino/components/setup/single_pin.rb
@@ -0,0 +1,27 @@
+module Dino
+  module Components
+    module Setup
+      module SinglePin
+        include Base
+        attr_reader :pin, :mode
+
+        protected
+
+        attr_writer :pin
+
+        #
+        # Require a single pin for single pin components.
+        #
+        def initialize_pins(options={})
+          raise 'a pin is required for this component' unless options[:pin]
+          self.pin = board.convert_pin(options[:pin])
+        end
+
+        def mode=(mode)
+          @mode = mode
+          board.set_pin_mode(self.pin, mode)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index 11418c69..85730234 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -1,15 +1,14 @@
 module Dino
   module Components
-    class ShiftRegister < Core::MultiPin
+    class ShiftRegister
       #
       # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
       #
-      def after_initialize(options={})
-        proxy  clock: Core::BaseOutput,
-               latch: Core::BaseOutput,
-               data:  Core::BaseOutput
-      end
-
+      include Setup::MultiPin      
+      proxy_pins  clock: Basic::DigitalOutput,
+                  latch: Basic::DigitalOutput,
+                  data:  Basic::DigitalOutput
+            
       def write(bytes)
         bytes = [bytes] unless bytes.class == Array
 
diff --git a/lib/dino/components/softserial.rb b/lib/dino/components/softserial.rb
index d0906929..1dd2db38 100644
--- a/lib/dino/components/softserial.rb
+++ b/lib/dino/components/softserial.rb
@@ -1,6 +1,7 @@
 module Dino
   module Components
-    class SoftwareSerial < Core::MultiPin
+    class SoftwareSerial
+      include Setup::MultiPin
       attr_accessor :baud
 
       COMMAND = 12
diff --git a/lib/dino/components/ssd.rb b/lib/dino/components/ssd.rb
index edae8f79..c363cd21 100644
--- a/lib/dino/components/ssd.rb
+++ b/lib/dino/components/ssd.rb
@@ -1,53 +1,52 @@
-# Connect to the Arduino and
-# take control of the SSD
-#
-# ssd = SevenSegmentDisplay.new(
-#   board: Board.new(TxRx.new),
-#   pins:  [12,13,3,4,5,10,9],
-#   anode: 11
-# )
-
 module Dino
   module Components
-    class SSD < Core::MultiPin
-      attr_reader :anode
-
+    class SSD
+      include Setup::MultiPin
+      
+      proxy_pins   cathode: Basic::DigitalOutput,
+                   anode:   Basic::DigitalOutput,
+                   optional: true
+
+      proxy_pins  a:     Basic::DigitalOutput,
+                  b:     Basic::DigitalOutput,
+                  c:     Basic::DigitalOutput,
+                  d:     Basic::DigitalOutput,
+                  e:     Basic::DigitalOutput,
+                  f:     Basic::DigitalOutput,
+                  g:     Basic::DigitalOutput
+
+      # ssd = SevenSegmentDisplay.new(
+      #   board: board,
+      #   pins:  {anode: 11, a: 12, b: 13, c: 3,d: 4,e: 5,f: 10,g: 9}
+      # )
       def after_initialize(options={})
-        raise Exception.new('anode must be specified') unless options[:anode]
-        @anode = Core::BaseOutput.new(board: board, pin: options[:anode])
-
-        # Create a Core::BaseOutput for every pin.
-        @pins.map! { |pin| Core::BaseOutput.new(board: board, pin: pin) }
-
-        clear
-        on
+        @segments = [a,b,c,d,e,f,g]
+        clear; on
       end
 
+      attr_reader :segments
+
       def clear
-        7.times { |pin| toggle pin, 0 }
+        segments.each do |pin|
+          pin.low if cathode
+          pin.high if anode
+        end
       end
 
       def display(char)
-        key = char.to_s.upcase
-
-        return scroll(key) if key.length > 1
-
-        # Make sure the ssd is turned on.
-        on
-
-        if chars = CHARACTERS[key]
-          chars.each_with_index { |s,i| toggle i, s }
-        else
-          clear
-        end
+        char = char.to_s
+        return scroll(char) if char.length > 1
+        off; write(char); on
       end
 
       def on
-        @anode.high
+        anode.high if anode
+        cathode.low if cathode
       end
 
       def off
-        @anode.low
+        anode.low if anode
+        cathode.high if cathode
       end
 
       CHARACTERS = {
@@ -82,7 +81,7 @@ def off
         'P' => [1,1,0,0,1,1,1],
         'Q' => [1,1,1,0,0,1,1],
         'R' => [0,0,0,0,1,0,1],
-        'S' => [0,0,1,1,0,1,1],
+        'S' => [1,0,1,1,0,1,1],
         'T' => [0,0,0,1,1,1,1],
         'U' => [0,0,1,1,1,0,0],
         'V' => [0,1,1,1,1,1,0],
@@ -94,19 +93,25 @@ def off
 
       private
 
-      def scroll(string)
-        string.chars.each do |chr|
-          off
-          sleep 0.05
-          display chr
-          sleep 0.5
+      def write(char)
+        bits = CHARACTERS[char.to_s.upcase]
+        unless bits
+          clear
+        else
+          bits.each_with_index do |bit, index|
+            if anode
+              bit == 0 ? bit = 1 : bit = 0
+            end
+            segments[index].write(bit) unless (segments[index].state == bit)
+          end
         end
-
-        clear
       end
 
-      def toggle(number, state)
-        @pins[number].write (state == 1 ? 0 : 1)
+      def scroll(string)
+        string.chars.each do |char|
+          display(char)
+          sleep(0.5)
+        end
       end
     end
   end
diff --git a/lib/dino/components/stepper.rb b/lib/dino/components/stepper.rb
index 165d1ef1..3f739f76 100644
--- a/lib/dino/components/stepper.rb
+++ b/lib/dino/components/stepper.rb
@@ -1,11 +1,11 @@
 module Dino
   module Components
-    class Stepper < Core::MultiPin
-      def after_initialize(options={})
-        proxies step:      Core::BaseOutput,
-                direction: Core::BaseOutput
-      end
-
+    class Stepper
+      include Setup::MultiPin 
+      
+      proxy_pins  step:      Basic::DigitalOutput,
+                  direction: Basic::DigitalOutput
+    
       def step_cc
         direction.high
         step.high
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 34fe6ad2..3b99785f 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -35,19 +35,19 @@ def io_mock(methods = {})
     end
 
     describe '#update' do
-      context 'when the given pin connects to input hardware part' do
-        it 'should call update with the message on the part' do
+      context 'when a component is connected to the pin' do
+        it 'should call update with the message on the component' do
           part = mock(:part, pin: 7, pullup: nil)
-          subject.add_input_hardware(part)
+          subject.add_component(part)
           other_part = mock(:part, pin: 9, pullup: nil)
-          subject.add_input_hardware(other_part)
+          subject.add_component(other_part)
 
           part.should_receive(:update).with('wake up!')
           subject.update(7, 'wake up!')
         end
       end
 
-      context 'when the given pin is not connected' do
+      context 'when a component is not connected to the pin' do
         it 'should not do anything' do
           expect {
             subject.update(5, 'wake up!')
@@ -56,39 +56,23 @@ def io_mock(methods = {})
       end
     end
 
-    describe '#input_hardware' do
-      it 'should initialize as empty' do
-        subject.input_hardware.should == []
+    describe '#add_component' do
+      it 'should add the component to the board' do
+        subject.add_component(mock1 = mock(:part1, pin: 12, pullup: nil))
+        subject.add_component(mock2 = mock(:part2, pin: 14, pullup: nil))
+        subject.components.should =~ [mock1, mock2]
       end
     end
 
-    describe '#add_input_hardware' do
-      it 'should start the read thread' do
-        io_mock.should_receive(:read)
-        subject.add_input_hardware(mock(:part1, pin: 12, pullup: nil))
-      end
-
-      it 'should add input hardware to the board' do
-        subject.add_input_hardware(mock1 = mock(:part1, pin: 12, pullup: nil))
-        subject.add_input_hardware(mock2 = mock(:part2, pin: 14, pullup: nil))
-        subject.input_hardware.should =~ [mock1, mock2]
-      end
-
-      it 'should set the mode for the given pin to "in"' do
-        subject.should_receive(:set_pin_mode).with(12, :in, nil)
-        subject.add_input_hardware(mock(:part1, pin: 12, pullup: nil))
-      end
-    end
-
-    describe '#remove_input_hardware' do
+    describe '#remove_component' do
       it 'should remove the given part from the hardware of the board and stop listening' do
         mock = mock(:part1, pin: 12, pullup: nil)
-        subject.add_input_hardware(mock)
+        subject.add_component(mock)
 
         subject.should_receive(:stop_listener).with(12)
-        subject.remove_input_hardware(mock)
+        subject.remove_component(mock)
         
-        subject.input_hardware.should == []
+        subject.components.should == []
       end
     end
 
@@ -114,6 +98,9 @@ def io_mock(methods = {})
       end
     end
 
+    #
+    # Board commands
+    #
     describe '#digital_write' do
       it 'should write the value to the right pin' do
         io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 1, value: 3))
@@ -173,16 +160,6 @@ def io_mock(methods = {})
         io_mock.should_receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 1))
         subject.set_pin_mode(13, :in)
       end
-
-      it 'should set the pullup correctly if mode is in' do
-        subject.should_receive(:set_pullup).with(13, nil)
-        subject.set_pin_mode(13, :in)
-      end
-
-      it 'shouldnt affect the pullup if mode is out' do
-        subject.should_not_receive(:set_pullup).with(13, nil)
-        subject.set_pin_mode(13, :out)
-      end
     end
 
     describe '#set_pullup' do
diff --git a/spec/lib/components/core/analog_input_spec.rb b/spec/lib/components/basic/analog_input_spec.rb
similarity index 97%
rename from spec/lib/components/core/analog_input_spec.rb
rename to spec/lib/components/basic/analog_input_spec.rb
index 582dd847..87f8c2b1 100644
--- a/spec/lib/components/core/analog_input_spec.rb
+++ b/spec/lib/components/basic/analog_input_spec.rb
@@ -2,7 +2,7 @@
 
 module Dino
   module Components
-    module Core
+    module Basic
       describe AnalogInput do
         let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
         let(:board) { Board.new(txrx) }
diff --git a/spec/lib/components/core/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
similarity index 96%
rename from spec/lib/components/core/digital_input_spec.rb
rename to spec/lib/components/basic/digital_input_spec.rb
index 684aa844..132d1c76 100644
--- a/spec/lib/components/core/digital_input_spec.rb
+++ b/spec/lib/components/basic/digital_input_spec.rb
@@ -2,7 +2,7 @@
 
 module Dino
   module Components
-    module Core
+    module Basic
       describe DigitalInput do
         let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
         let(:board) { Board.new(txrx) }
@@ -26,11 +26,10 @@ module Core
 
         describe '#_listen' do
           it 'should send #digital_listen to the board with its pin' do
-            subject
             subject.stop
             board.should_receive(:digital_listen).with(subject.pin)
 
-            subject.listen
+            subject._listen
           end
         end
 
diff --git a/spec/lib/components/button_spec.rb b/spec/lib/components/button_spec.rb
deleted file mode 100644
index d9cc1e48..00000000
--- a/spec/lib/components/button_spec.rb
+++ /dev/null
@@ -1,8 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe Button do
-    end
-  end
-end
diff --git a/spec/lib/components/core/base_input_spec.rb b/spec/lib/components/core/base_input_spec.rb
deleted file mode 100644
index d37281ab..00000000
--- a/spec/lib/components/core/base_input_spec.rb
+++ /dev/null
@@ -1,127 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Core
-      describe BaseInput do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
-        let(:options) { { pin: 'A0', board: board } }
-        subject { BaseInput.new(options) }
-
-        describe '#initialize' do
-          it 'should add itself as input hardware, set mode to in and start read' do
-            board.should_receive(:set_pin_mode).with(14, :in, nil)
-            board.should_receive(:add_input_hardware)
-
-            BaseInput.new(options)
-          end
-        end
-
-        context 'callbacks' do
-          describe '#add_callback' do
-            it 'should add a callback to the :persistent key if no key is given' do
-              subject.add_callback { mock }
-              subject.instance_variable_get(:@callbacks)[:persistent].should_not be_empty
-            end
-
-            it 'should add a callback to the key if a key is given' do
-              subject.add_callback(:test) { mock }
-              subject.instance_variable_get(:@callbacks)[:test].should_not be_empty
-            end
-          end
-
-          describe '#remove_callback' do
-            it 'should remove all callbacks if no key is given' do
-              subject.add_callback { mock }
-              subject.remove_callback
-
-              subject.instance_variable_get(:@callbacks).should == {}
-            end
-
-            it 'should remove callbacks for the given key if key is given' do
-              subject.add_callback { mock }
-              subject.add_callback(:test) { mock }
-              subject.remove_callback(:test)
-
-              subject.instance_variable_get(:@callbacks)[:test].should be_empty
-            end
-          end
-        end
-
-        context 'reading' do
-          describe '#read' do
-            it 'should add the block given as a callback to the :read key' do
-              subject.should_receive(:add_callback).with(:read)
-              subject.instance_variable_set(:@callbacks, {read: []})
-              subject.read { mock }
-            end
-
-            it 'should call #_read once' do
-              subject.should_receive(:read)
-              subject.read
-            end
-          end
-
-          describe '#poll' do
-            it 'should add the block given as a callback to the :poll key' do
-              subject.should_receive(:add_callback).with(:poll)
-              subject.poll(5) { mock }
-            end
-          end
-
-          describe '#listen' do
-            it 'should add the block given as a callback to the :listen key' do
-              subject.should_receive(:add_callback).with(:listen)
-              subject.listen { mock }
-            end
-
-            it 'should call #_listen' do
-              subject.should_receive(:_listen)
-              subject.listen
-            end
-          end
-
-          describe '#stop' do
-            it 'should tell the board to turn the listener off' do
-              board.should_receive(:stop_listener).with(subject.pin)
-              subject.stop
-            end
-
-            it 'should remove all callbacks from the :listen and :poll keys and stop the read thread' do
-              subject.should_receive(:remove_callback).with(:listen)
-              subject.should_receive(:remove_callback).with(:poll)
-              subject.should_receive(:stop_thread)
-
-              subject.stop
-            end
-          end
-        end
-
-        describe '#update' do
-          it 'should update @state' do
-            subject.update("something")
-            subject.instance_variable_get(:@state).should == "something"
-          end
-
-          it 'should call all callbacks passing in the given data' do
-            first_block_data = nil
-            second_block_data = nil
-            subject.add_callback { |data| first_block_data = data }
-            subject.add_callback { |data| second_block_data = data }
-
-            subject.update('Some data')
-            [first_block_data, second_block_data].each { |block_data| block_data.should == "Some data" }
-          end
-
-          it 'should remove any callbacks keyed with :read' do
-            subject.add_callback(:read) { |data| first_block_data = data }
-
-            subject.update("Some data")
-            subject.instance_variable_get(:@callbacks)[:read].should be_empty
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/core/base_output_spec.rb b/spec/lib/components/core/base_output_spec.rb
deleted file mode 100644
index 99c1e5fb..00000000
--- a/spec/lib/components/core/base_output_spec.rb
+++ /dev/null
@@ -1,91 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Core
-      describe BaseOutput do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
-        let(:options) { { pin: 'A0', board: board } }
-        subject { BaseOutput.new(options) }
-
-        before(:each) { subject }
-
-        describe '#initialize' do
-          it 'should set mode to out and go low' do
-            board.should_receive(:set_pin_mode).with(14, :out, nil)
-            board.should_receive(:digital_write).with(14, board.low)
-
-            BaseOutput.new(options)
-          end
-        end
-
-        describe '#digital_write' do
-          it 'should update the @state instance variable and call #digital_write on the board' do
-            board.should_receive(:digital_write).with(subject.pin, board.high).once
-            
-            subject.digital_write(board.high)
-            subject.state.should == board.high
-          end
-        end
-
-        describe '#analog_write' do
-          it 'should update the @state instance variable and call #analog_write on the board' do
-            board.should_receive(:analog_write).with(subject.pin, 128).once
-            
-            subject.analog_write(128)
-            subject.state.should == 128
-          end
-        end
-
-        describe '#write' do
-          it 'should call #digital_write if value is HIGH' do
-            subject.should_receive(:digital_write).with(board.high)
-            subject.write(board.high)
-          end
-
-
-          it 'should call #digital_write if value is LOW' do
-            subject.should_receive(:digital_write).with(board.low)
-            subject.write(board.low)
-          end
-
-          it 'should call #analog_write if value is anything else' do
-            subject.should_receive(:analog_write).with(128)
-            subject.write(128)
-          end
-        end
-
-        describe '#high' do
-          it 'should call #digital_write with HIGH' do
-            subject.should_receive(:digital_write).with(board.high)
-            subject.high
-          end
-        end
-
-        describe '#low' do
-          it 'should call #digital_write with LOW' do
-            subject.should_receive(:digital_write).with(board.low)
-            subject.low
-          end
-        end
-
-        describe '#toggle' do
-          it 'should call high if currently LOW' do
-            subject.low
-            subject.should_receive(:high)
-
-            subject.toggle
-          end
-
-          it 'should call LOW if anything else' do
-            subject.high
-            subject.should_receive(:low)
-
-            subject.toggle
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/core/base_spec.rb b/spec/lib/components/core/base_spec.rb
deleted file mode 100644
index 61147f4b..00000000
--- a/spec/lib/components/core/base_spec.rb
+++ /dev/null
@@ -1,71 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Core
-      describe Base do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
-        let(:options) { { pin: 'A0', board: board } }
-        subject { Base.new(options) }
-        
-        describe '#initialize' do
-          it 'should convert the pin to an integer' do
-            board.should_receive(:convert_pin).with(options[:pin])
-
-            component = Base.new(options)
-          end
-
-          it 'should require a pin' do
-            expect {
-              Base.new(board: board)
-            }.to raise_exception
-          end
-
-          it 'should require a board' do
-            expect {
-              Base.new(pin: 'A0')
-            }.to raise_exception
-          end
-        end
-
-        context "when subclassed" do
-          class SpecComponent < Base
-            def sucessfully_initialized? ; @success ; end
-
-            def options ; @options ; end
-
-            def after_initialize(options={})
-              @success = true
-              @options = options
-            end
-          end
-
-          it "should call #after_initialize with options" do
-            component = SpecComponent.new(options)
-            component.should be_sucessfully_initialized
-            component.options.should eq options
-          end
-        end
-
-        describe '#mode=' do
-          it 'should tell the board to set the pin mode' do
-            board.should_receive(:set_pin_mode).with(subject.pin, :out, nil)
-
-            subject.send(:mode=, :out)
-            subject.mode.should == :out 
-          end
-        end
-
-        describe '#pullup=' do
-          it 'should tell the board to set the pullup mode' do
-            board.should_receive(:set_pullup).with(subject.pin, true)
-
-            subject.send(:pullup=, true)
-            subject.pullup.should == true
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/core/multi_pin_spec.rb b/spec/lib/components/core/multi_pin_spec.rb
deleted file mode 100644
index 8657f4e1..00000000
--- a/spec/lib/components/core/multi_pin_spec.rb
+++ /dev/null
@@ -1,78 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Core
-      describe MultiPin do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
-        let(:options) { { pins: {red: 9, blue: 10}, board: board } }
-
-        describe '#initialize' do
-          it 'should require a pin' do
-            expect {
-              MultiPin.new(board: board)
-            }.to raise_exception
-          end
-
-          it 'should require a board' do
-            expect {
-              MultiPin.new(pins: options[:pins])
-            }.to raise_exception
-          end
-        end
-
-        context "when subclassed" do
-          class MPComponent < MultiPin
-            def sucessfully_initialized? ; @success ; end
-
-            def options ; @options ; end
-
-            def after_initialize(options={})
-              @success = true
-              @options = options
-              proxy red: BaseOutput, blue: BaseInput
-            end
-          end
-
-          it "should call #after_initialize with options" do
-            component = MPComponent.new(options)
-            component.should be_sucessfully_initialized
-            component.options.should eq options
-          end
-
-          describe '#proxy' do
-            it 'should raise if any of the required pins are missing' do
-              expect {
-                MPComponent.new(board: board, pins: {blue: 11})
-              }.to raise_exception(/red/)
-            end
-
-            it 'should create the right class of proxy component for each pin with the right options' do
-              BaseOutput.should_receive(:new).with({board: board, pin: options[:pins][:red], pullup: nil })
-              BaseInput.should_receive(:new).with({board: board, pin: options[:pins][:blue], pullup: true})
-
-              MPComponent.new options.merge(pullups: {blue: true})
-            end
-
-            it 'should assign the proxy commponent to the right instance variable' do
-              component = MPComponent.new(options)
-              component.red.class.should == BaseOutput
-              component.blue.class.should == BaseInput
-            end
-
-            describe '#states' do
-              it 'should return a hash corresponding to the state of each proxy component (pin)' do
-                component = MPComponent.new(options)
-                component.red.write(128)
-                component.blue.update(555)
-
-                component.state.should == {red: 128, blue: 555}
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/core/threaded_spec.rb b/spec/lib/components/core/threaded_spec.rb
deleted file mode 100644
index 4297428e..00000000
--- a/spec/lib/components/core/threaded_spec.rb
+++ /dev/null
@@ -1,104 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Core
-      describe Threaded do
-        class ThreadedComponent
-          include Threaded
-          interrupt_with :interrupt_it
-          def interrupt_it; end
-          def dont_interrupt_it; end
-        end
-
-        subject { ThreadedComponent.new }
-
-        describe '#threaded' do
-          it 'should stop the existing thread' do
-            subject.should_receive(:stop_thread)
-            subject.threaded { mock }
-          end
-
-          it 'should enable interrupts on the first threaded call' do
-            subject.should_receive(:enable_interrupts).once
-            thread = subject.threaded { mock }
-          end
-
-          it 'should start a thread and call the block passed.' do
-            block = mock
-            Thread.should_receive(:new).once.and_yield
-            block.should_receive(:call)
-
-            subject.threaded { block.call }
-          end
-        end
-
-        describe '#stop_thread' do
-          it 'should kill the internal thread' do
-            subject.threaded { sleep }
-            subject.thread.should_receive(:kill)
-
-            subject.stop_thread
-          end
-        end
-
-        describe '#enable_interrupts' do
-          it 'should set @enable_interrupts to true' do
-            subject.enable_interrupts
-            subject.interrupts_enabled.should == true
-          end
-        end
-
-        context 'interrupts' do
-          it 'should make method names passed to #interrupt_with stop the internal thread' do
-            subject.threaded { sleep }
-            subject.should_receive(:stop_thread)
-
-            subject.interrupt_it
-          end
-
-          it 'should not make other methods stop the internal thread' do
-            subject.threaded { sleep }
-            subject.should_not_receive(:stop_thread)
-
-            subject.dont_interrupt_it
-          end
-        end
-
-        context 'with multiple threads' do
-          it 'should let other threads interrupt the internal thread' do
-            subject.threaded {sleep}
-            subject.should_receive(:stop_thread)
-
-            subject.interrupt_it
-          end
-
-          it 'should not let the internal thread interrupt itself' do
-            subject.should_receive(:interrupt_it).exactly(10).times
-            subject.should_not_receive(:stop_thread)
-
-            # Simulate being inside the internal thread.
-            subject.enable_interrupts
-            subject.instance_variable_set(:@thread, Thread.current)
-            10.times { subject.interrupt_it }
-          end
-        end
-
-        context 'when included and then subclassed' do
-          it 'should allow calling #interrupt_with again' do
-            class SubThreaded < ThreadedComponent
-              interrupt_with :stop_it
-              def stop_it; end
-            end
-
-            component = SubThreaded.new
-            component.threaded { sleep }
-            component.should_receive(:stop_thread)
-
-            component.stop_it
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/lcd_spec.rb b/spec/lib/components/lcd_spec.rb
index dc9b2991..86b7468d 100644
--- a/spec/lib/components/lcd_spec.rb
+++ b/spec/lib/components/lcd_spec.rb
@@ -3,8 +3,8 @@
 module Dino
   module Components
     describe LCD do
-      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
-
+      let(:txrx)  { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Board.new(txrx) }
       subject { LCD.new board: board, pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 }, cols: 16, rows: 2 }
 
       before do
@@ -13,116 +13,116 @@ module Components
       end
 
       describe '#clear' do
-        it 'clears the display sending the command "10..2\n" to the board' do
-          board.should_receive(:write).with "10..2\n"
+        it 'clears the display' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 2)
           subject.clear
         end
       end
 
       describe '#home' do
-        it 'Moves the cursor to the first position with the command "10..3\n"' do
-          board.should_receive(:write).with "10..3\n"
+        it 'Moves the cursor to the first position' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 3)
           subject.home
         end
       end
 
       describe '#set_cursor' do
-        it 'moves the cursor to the given position sending the command "10..4.0,1\n"' do
-          board.should_receive(:write).with "10..4.0,1\n"
+        it 'moves the cursor to the given position' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 4, aux_message: "0,1")
           subject.set_cursor(0,1)
         end
       end
 
       describe '#puts' do
         it 'prints a string in the display' do
-          board.should_receive(:write).with "10..5.AB\n"
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 5, aux_message: "AB")
           subject.puts("AB")
         end
       end
 
       describe '#show_cursor' do
-        it 'shows the cursor with the command "10..6\n"' do
-          board.should_receive(:write).with "10..6\n"
+        it 'shows the cursor' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 6)
           subject.show_cursor
         end
       end
 
       describe '#hide_cursor' do
-        it 'hides the cursor with the command "10..7\n"' do
-          board.should_receive(:write).with "10..7\n"
+        it 'hides the cursor' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 7)
           subject.hide_cursor
         end
       end
 
       describe '#blink' do
-        it 'shows a blinking cursor with the command "10..8\n"' do
-          board.should_receive(:write).with "10..8\n"
+        it 'shows a blinking cursor' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 8)
           subject.blink
         end
       end
 
       describe '#no_blink' do
-        it 'stops a blinking cursor with the command "10..9\n"' do
-          board.should_receive(:write).with "10..9\n"
+        it 'stops a blinking cursor' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 9)
           subject.no_blink
         end
       end
 
       describe '#on' do
-        it 'turn on the display with the command "10..10\n"' do
-          board.should_receive(:write).with "10..10\n"
+        it 'turn on the display' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 10)
           subject.on
         end
       end
 
       describe '#off' do
-        it 'turn off the display with the command "10..11\n"' do
-          board.should_receive(:write).with "10..11\n"
+        it 'turn off the display' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 11)
           subject.off
         end
       end
 
       describe '#scroll_left' do
-        it 'move the text in the display one position to the left  the command "10..12\n"' do
-          board.should_receive(:write).with "10..12\n"
+        it 'move the text in the display one position to the left' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 12)
           subject.scroll_left
         end
       end
 
       describe '#scroll_right' do
-        it 'move the text in the display one position to the right  the command "10..13\n"' do
-          board.should_receive(:write).with "10..13\n"
+        it 'move the text in the display one position to the right' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 13)
           subject.scroll_right
         end
       end
 
       describe '#enable_autoscroll' do
-        it 'enable autoscroll with the command "10..14\n"' do
-          board.should_receive(:write).with "10..14\n"
+        it 'enable autoscroll' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 14)
           subject.enable_autoscroll
         end
       end
 
       describe '#disable_autoscroll' do
-        it 'disable autoscroll with the command "10..15\n"' do
-          board.should_receive(:write).with "10..15\n"
+        it 'disable autoscroll' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 15)
           subject.disable_autoscroll
         end
       end
 
       describe '#left_to_right' do
-        it 'set the display writing to start from the left with the command "10..16\n"' do
-          board.should_receive(:write).with "10..16\n"
+        it 'set the display writing to start from the left' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 16)
           subject.left_to_right
         end
       end
 
       describe '#right_to_left' do
-        it 'set the display writing to start from the right with the command "10..17\n"' do
-          board.should_receive(:write).with "10..17\n"
+        it 'set the display writing to start from the right' do
+          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 17)
           subject.right_to_left
         end
       end
     end
   end
-end
+end
\ No newline at end of file
diff --git a/spec/lib/components/led_spec.rb b/spec/lib/components/led_spec.rb
index 845c9eee..32317773 100644
--- a/spec/lib/components/led_spec.rb
+++ b/spec/lib/components/led_spec.rb
@@ -3,6 +3,7 @@
 module Dino
   module Components
     describe Led do
+      it 'should start blinking in a new thread at the given interval'
     end
   end
 end
diff --git a/spec/lib/components/rgb_led_spec.rb b/spec/lib/components/rgb_led_spec.rb
index 03e18fb6..ee31f4ab 100644
--- a/spec/lib/components/rgb_led_spec.rb
+++ b/spec/lib/components/rgb_led_spec.rb
@@ -12,9 +12,9 @@ module Components
         it 'should create a BaseOutput instance for each pin' do
           led = RgbLed.new(options)
           
-          led.red.class.should == Core::BaseOutput
-          led.green.class.should == Core::BaseOutput
-          led.blue.class.should == Core::BaseOutput
+          led.red.class.should == Basic::AnalogOutput
+          led.green.class.should == Basic::AnalogOutput
+          led.blue.class.should == Basic::AnalogOutput
         end
       end
 
diff --git a/spec/lib/components/setup/base_spec.rb b/spec/lib/components/setup/base_spec.rb
new file mode 100644
index 00000000..681a90a3
--- /dev/null
+++ b/spec/lib/components/setup/base_spec.rb
@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Setup
+      describe Base do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board } }
+        class BaseComponent; include Base; end
+        subject { BaseComponent.new(options) }
+        
+        describe '#initialize' do
+          it 'should require a board' do
+            expect {
+              BaseComponent.new(pin: 'A0')
+            }.to raise_exception
+          end
+
+          it 'should add itself to the board' do
+            board.should_receive(:add_component)
+            BaseComponent.new(options)
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/setup/input_spec.rb b/spec/lib/components/setup/input_spec.rb
new file mode 100644
index 00000000..7d7b47c5
--- /dev/null
+++ b/spec/lib/components/setup/input_spec.rb
@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Setup
+      describe Input do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board, pullup: true} }
+        class InputComponent
+          include SinglePin
+          include Input
+        end
+        subject { InputComponent.new(options) }
+
+        describe '#pullup=' do
+          it 'should tell the board to set the pullup mode correctly' do
+            subject
+            board.should_receive(:set_pullup).with(subject.pin, false)
+            subject.pullup = false
+            subject.pullup.should == false
+          end
+        end
+
+        describe '#initialize_pins' do
+          it 'should set the pin mode to in' do
+            board.should_receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :in)
+            subject
+          end
+
+          it 'should set the pulllup if included in options' do
+            board.should_receive(:set_pullup).with(subject.pin, true)
+            subject
+          end
+
+          it 'should tell the board to start reading' do
+            board.should_receive(:start_read)
+            subject
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/setup/multi_pin_spec.rb b/spec/lib/components/setup/multi_pin_spec.rb
new file mode 100644
index 00000000..e1fbe547
--- /dev/null
+++ b/spec/lib/components/setup/multi_pin_spec.rb
@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Setup
+      describe MultiPin do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pins: {red: 9, blue: 10}, board: board } }
+        class MultiPinComponent; include MultiPin; end
+        subject { MultiPinComponent.new(options) }
+
+        describe "::require_pins" do
+          it 'should add the pins to the @@required_pins class variable'
+        end
+
+        describe "::proxy_pins" do
+          it 'should also call ::require_pins unless the pins are optional'
+          it 'should add the pins to the @@proxied_pins class variable'
+        end
+
+        describe '#initialize' do
+          it 'should require every pin in the @@require_pin class variable'
+          it 'should create proxies for each of the pins in @@proxy_pins'
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/setup/output_spec.rb b/spec/lib/components/setup/output_spec.rb
new file mode 100644
index 00000000..9a85d28e
--- /dev/null
+++ b/spec/lib/components/setup/output_spec.rb
@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Setup
+      describe Input do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board, pullup: true} }
+        class OutputComponent
+          include SinglePin
+          include Output
+        end
+        subject { OutputComponent.new(options) }
+
+        describe '#initialize_pins' do
+         it 'should set the pin mode to in' do
+            board.should_receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :out)
+            subject
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/setup/single_pin_spec.rb b/spec/lib/components/setup/single_pin_spec.rb
new file mode 100644
index 00000000..34a57dc6
--- /dev/null
+++ b/spec/lib/components/setup/single_pin_spec.rb
@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Setup
+      describe SinglePin do
+        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+        let(:board) { Board.new(txrx) }
+        let(:options) { { pin: 'A0', board: board } }
+        class SinglePinComponent; include SinglePin; end
+        subject { SinglePinComponent.new(options) }
+        
+        describe '#initialize' do
+          it 'should require a pin' do
+            expect {
+              SinglePinComponent.new(board: board)
+            }.to raise_exception
+          end
+
+          it 'should convert the pin to an integer' do
+            board.should_receive(:convert_pin).with(options[:pin])
+            component = SinglePinComponent.new(options)
+          end
+        end
+
+        describe '#mode=' do
+          it 'should tell the board to set the pin mode' do
+            board.should_receive(:set_pin_mode).with(subject.pin, :out)
+
+            subject.send(:mode=, :out)
+            subject.mode.should == :out
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/shift_register_spec.rb b/spec/lib/components/shift_register_spec.rb
index dce07888..cd7f37dd 100644
--- a/spec/lib/components/shift_register_spec.rb
+++ b/spec/lib/components/shift_register_spec.rb
@@ -10,9 +10,9 @@ module Components
 
       describe '#initialize' do
         it 'should create a BaseOutput instance for each pin' do
-          subject.clock.class.should == Core::BaseOutput
-          subject.latch.class.should == Core::BaseOutput
-          subject.data.class.should == Core::BaseOutput
+          subject.clock.class.should == Basic::DigitalOutput
+          subject.latch.class.should == Basic::DigitalOutput
+          subject.data.class.should == Basic::DigitalOutput
         end
       end
 
diff --git a/spec/lib/components/softwareserial_spec.rb b/spec/lib/components/softwareserial_spec.rb
index f318a74f..e846e92b 100644
--- a/spec/lib/components/softwareserial_spec.rb
+++ b/spec/lib/components/softwareserial_spec.rb
@@ -3,7 +3,8 @@
 module Dino
   module Components
     describe SoftwareSerial do
-      let(:board) { mock(:board, digital_write: true, set_pin_mode: true) }
+      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Board.new(txrx) }
 
       subject { SoftwareSerial.new board: board, pins: { rx: 10, tx: 11 }, baud: 4800 }
 
diff --git a/spec/lib/components/ssd_spec.rb b/spec/lib/components/ssd_spec.rb
index ec39205b..f11e89ce 100644
--- a/spec/lib/components/ssd_spec.rb
+++ b/spec/lib/components/ssd_spec.rb
@@ -5,36 +5,33 @@ module Components
     describe SSD do
       let(:txrx)  { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
       let(:board) { Board.new(txrx) }
-      let(:anode) { 11 }
-      let(:pins)  { [12,13,3,4,5,10,9] }
-      subject   { SSD.new(board: board, pins: pins, anode: anode) }
+      let(:pins)  { {anode: 11, a: 12, b: 13, c: 3, d: 4, e: 5, f: 10, g: 9} }
+      subject   { SSD.new(board: board, pins: pins) }
 
       describe '#initialize' do
-        it 'should raise if it does not receive an anode' do
-          expect { SSD.new(board: board, pins: pins) }.to raise_exception
-        end
-
-        it 'should create a Core::BaseOutput for the anode and each pin' do
+        it 'should create a digital output for pins a-g' do
           subject
 
-          subject.anode.class.should == Core::BaseOutput
-          subject.pins.each { |pin| pin.class.should == Core::BaseOutput}
+          segments = [:a, :b, :c, :d, :e, :f, :g]
+          segments.each { |segment| subject.proxies[segment].class.should == Basic::DigitalOutput}
         end
 
         it "should clear the display" do
           SSD.any_instance.should_receive(:clear).once
-          SSD.new(board: board, pins: pins, anode: anode)
+          SSD.new(board: board, pins: pins)
         end
 
         it "should turn on the display" do
           SSD.any_instance.should_receive(:on).once
-          SSD.new(board: board, pins: pins, anode: anode)
+          SSD.new(board: board, pins: pins)
         end
       end
 
       describe '#clear' do
         it 'should toggle all the seven leds to off' do
-          subject.should_receive(:toggle).exactly(7).with(anything, 0)
+          segments = [:a, :b, :c, :d, :e, :f, :g]
+          segments.each { |segment| subject.proxies[segment].should_receive(:high) }
+
           subject.clear
         end
       end
@@ -55,7 +52,7 @@ module Components
 
       describe '#display' do
         it "should scroll on multiple characters" do
-          subject.should_receive(:scroll).with('FOO')
+          subject.should_receive(:scroll).with('foo')
           subject.display('foo')
         end
 
@@ -68,11 +65,10 @@ module Components
           subject.should_receive(:clear)
           subject.display('+')
         end
+      end
 
-        it "should toggle all the segments in order to display a character" do
-          subject.should_receive(:toggle).exactly(7)
-          subject.display('7')
-        end
+      describe 'with a cathode' do
+        it 'should invert the logic'
       end
     end
   end
diff --git a/spec/lib/components/stepper_spec.rb b/spec/lib/components/stepper_spec.rb
index 082388a7..f5017711 100644
--- a/spec/lib/components/stepper_spec.rb
+++ b/spec/lib/components/stepper_spec.rb
@@ -11,8 +11,8 @@ module Components
 
       describe '#initialize' do
         it 'should create a BaseOutput instance for each pin' do          
-          subject.step.class.should == Core::BaseOutput
-          subject.direction.class.should == Core::BaseOutput
+          subject.step.class.should == Basic::DigitalOutput
+          subject.direction.class.should == Basic::DigitalOutput
         end
       end
 

From d05788e0eb2e6dbff345a2fbc16aa0e4d330601e Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Thu, 26 Dec 2013 15:45:23 -0400
Subject: [PATCH 052/296] Update some examples

---
 examples/ir_receiver/ir_receiver.rb | 2 +-
 examples/rgb_led/rgb_led.rb         | 2 +-
 examples/ssd/ssd.rb                 | 3 +--
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/examples/ir_receiver/ir_receiver.rb b/examples/ir_receiver/ir_receiver.rb
index 8f82e520..3111f586 100644
--- a/examples/ir_receiver/ir_receiver.rb
+++ b/examples/ir_receiver/ir_receiver.rb
@@ -29,6 +29,6 @@
 end
 
 sleep 4
-ir.flash(flash)
+ir.on_flash(flash)
 
 sleep
diff --git a/examples/rgb_led/rgb_led.rb b/examples/rgb_led/rgb_led.rb
index 783ab52d..c72c4d51 100644
--- a/examples/rgb_led/rgb_led.rb
+++ b/examples/rgb_led/rgb_led.rb
@@ -12,7 +12,7 @@
 
 delay = 500.0
 
-potentiometer.when_data_received do |data|
+potentiometer.on_data do |data|
   sleep 0.5
   puts "DATA: #{delay = data.to_i}"
 end
diff --git a/examples/ssd/ssd.rb b/examples/ssd/ssd.rb
index 236c602d..898e78b3 100644
--- a/examples/ssd/ssd.rb
+++ b/examples/ssd/ssd.rb
@@ -7,8 +7,7 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 ssd   = Dino::Components::SSD.new(
   board: board,
-  pins:  [12,13,3,4,5,10,9],
-  anode: 11
+  pins:  { cathode: 10, a: 3, b: 4, c: 5, d: 6, e: 7, f: 8, g: 9 }
 )
 
 # Turn off the ssd on exit

From 313201f4c277a3ca9953670edc8dc0761be45af5 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Fri, 27 Dec 2013 01:17:31 -0400
Subject: [PATCH 053/296] Fix broken component tests

---
 .../lib/components/basic/analog_input_spec.rb |  3 +-
 .../components/basic/analog_output_spec.rb    | 40 ++++++++++++
 .../components/basic/digital_input_spec.rb    |  3 +-
 .../components/basic/digital_output_spec.rb   | 59 +++++++++++++++++
 spec/lib/components/lcd_spec.rb               |  3 +-
 spec/lib/components/rgb_led_spec.rb           |  3 +-
 spec/lib/components/servo_spec.rb             |  3 +-
 spec/lib/components/setup/base_spec.rb        | 10 +--
 spec/lib/components/setup/input_spec.rb       |  4 +-
 spec/lib/components/setup/multi_pin_spec.rb   | 65 ++++++++++++++++---
 spec/lib/components/setup/output_spec.rb      |  6 +-
 spec/lib/components/setup/single_pin_spec.rb  |  8 ++-
 spec/lib/components/shift_register_spec.rb    |  3 +-
 spec/lib/components/softwareserial_spec.rb    |  3 +-
 spec/lib/components/ssd_spec.rb               |  3 +-
 spec/lib/components/stepper_spec.rb           |  3 +-
 spec/spec_helper.rb                           | 11 +++-
 17 files changed, 189 insertions(+), 41 deletions(-)
 create mode 100644 spec/lib/components/basic/analog_output_spec.rb
 create mode 100644 spec/lib/components/basic/digital_output_spec.rb

diff --git a/spec/lib/components/basic/analog_input_spec.rb b/spec/lib/components/basic/analog_input_spec.rb
index 87f8c2b1..5b591fca 100644
--- a/spec/lib/components/basic/analog_input_spec.rb
+++ b/spec/lib/components/basic/analog_input_spec.rb
@@ -4,8 +4,7 @@ module Dino
   module Components
     module Basic
       describe AnalogInput do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
+        include BoardMock
         let(:options) { { pin: 'A0', board: board } }
         subject { AnalogInput.new(options) }
 
diff --git a/spec/lib/components/basic/analog_output_spec.rb b/spec/lib/components/basic/analog_output_spec.rb
new file mode 100644
index 00000000..0da24906
--- /dev/null
+++ b/spec/lib/components/basic/analog_output_spec.rb
@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Basic
+      describe AnalogOutput do
+      	include BoardMock
+      	let(:options) { { pin: '9', board: board } }
+        subject { AnalogOutput.new(options) }
+
+      	describe '#analog_write' do
+          it 'should update the @state instance variable and call #analog_write on the board' do
+            board.should_receive(:analog_write).with(subject.pin, 128).once
+            
+            subject.analog_write(128)
+            subject.state.should == 128
+          end
+        end
+
+        describe '#write' do
+          it 'should call #digital_write if value is HIGH' do
+            subject.should_receive(:digital_write).with(board.high)
+            subject.write(board.high)
+          end
+
+
+          it 'should call #digital_write if value is LOW' do
+            subject.should_receive(:digital_write).with(board.low)
+            subject.write(board.low)
+          end
+
+          it 'should call #analog_write if value is anything else' do
+            subject.should_receive(:analog_write).with(128)
+            subject.write(128)
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/basic/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
index 132d1c76..ef715cd9 100644
--- a/spec/lib/components/basic/digital_input_spec.rb
+++ b/spec/lib/components/basic/digital_input_spec.rb
@@ -4,8 +4,7 @@ module Dino
   module Components
     module Basic
       describe DigitalInput do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
+        include BoardMock
         let(:options) { { pin: 'A0', board: board } }
         subject { DigitalInput.new(options) }
 
diff --git a/spec/lib/components/basic/digital_output_spec.rb b/spec/lib/components/basic/digital_output_spec.rb
new file mode 100644
index 00000000..b378471e
--- /dev/null
+++ b/spec/lib/components/basic/digital_output_spec.rb
@@ -0,0 +1,59 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Basic
+      describe DigitalOutput do
+        include BoardMock
+        let(:options) { { pin: '13', board: board } }
+        subject { DigitalOutput.new(options) }
+
+        describe '#after_initialize' do
+          it 'should set mode to out and go low' do
+            board.should_receive(:digital_write).with(13, board.low)
+            DigitalOutput.new(options)
+          end
+        end
+
+        describe '#digital_write' do
+          it 'should update the @state instance variable and call #digital_write on the board' do
+            subject
+            board.should_receive(:digital_write).with(subject.pin, board.high).once
+            subject.digital_write(board.high)
+            subject.state.should == board.high
+          end
+        end
+
+        describe '#high' do
+          it 'should call #digital_write with HIGH' do
+            subject.should_receive(:digital_write).with(board.high)
+            subject.high
+          end
+        end
+
+        describe '#low' do
+          it 'should call #digital_write with LOW' do
+            subject.should_receive(:digital_write).with(board.low)
+            subject.low
+          end
+        end
+
+        describe '#toggle' do
+          it 'should call high if currently LOW' do
+            subject.low
+            subject.should_receive(:high)
+
+            subject.toggle
+          end
+
+          it 'should call LOW if anything else' do
+            subject.high
+            subject.should_receive(:low)
+
+            subject.toggle
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/lcd_spec.rb b/spec/lib/components/lcd_spec.rb
index 86b7468d..b6bf5509 100644
--- a/spec/lib/components/lcd_spec.rb
+++ b/spec/lib/components/lcd_spec.rb
@@ -3,8 +3,7 @@
 module Dino
   module Components
     describe LCD do
-      let(:txrx)  { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-      let(:board) { Board.new(txrx) }
+      include BoardMock
       subject { LCD.new board: board, pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 }, cols: 16, rows: 2 }
 
       before do
diff --git a/spec/lib/components/rgb_led_spec.rb b/spec/lib/components/rgb_led_spec.rb
index ee31f4ab..22dd8088 100644
--- a/spec/lib/components/rgb_led_spec.rb
+++ b/spec/lib/components/rgb_led_spec.rb
@@ -3,8 +3,7 @@
 module Dino
   module Components
     describe RgbLed do
-      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-      let(:board) { Board.new(txrx) }
+      include BoardMock
       let(:options) { { board: board, pins: {red: 1, green: 2, blue: 3} } }
       subject { RgbLed.new(options) }
 
diff --git a/spec/lib/components/servo_spec.rb b/spec/lib/components/servo_spec.rb
index 10639774..a8225e9c 100644
--- a/spec/lib/components/servo_spec.rb
+++ b/spec/lib/components/servo_spec.rb
@@ -3,8 +3,7 @@
 module Dino
   module Components
     describe Servo do
-      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-      let(:board) { Board.new(txrx) }
+      include BoardMock
       let(:options) { { board: board, pin: 9 } }
       subject { Servo.new(options)  }
 
diff --git a/spec/lib/components/setup/base_spec.rb b/spec/lib/components/setup/base_spec.rb
index 681a90a3..ddf19f8e 100644
--- a/spec/lib/components/setup/base_spec.rb
+++ b/spec/lib/components/setup/base_spec.rb
@@ -4,10 +4,12 @@ module Dino
   module Components
     module Setup
       describe Base do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
+        include BoardMock
         let(:options) { { pin: 'A0', board: board } }
-        class BaseComponent; include Base; end
+
+        class BaseComponent
+          include Base
+        end
         subject { BaseComponent.new(options) }
         
         describe '#initialize' do
@@ -17,7 +19,7 @@ class BaseComponent; include Base; end
             }.to raise_exception
           end
 
-          it 'should add itself to the board' do
+          it 'should register itself as a component on the board' do
             board.should_receive(:add_component)
             BaseComponent.new(options)
           end
diff --git a/spec/lib/components/setup/input_spec.rb b/spec/lib/components/setup/input_spec.rb
index 7d7b47c5..ae86375f 100644
--- a/spec/lib/components/setup/input_spec.rb
+++ b/spec/lib/components/setup/input_spec.rb
@@ -4,9 +4,9 @@ module Dino
   module Components
     module Setup
       describe Input do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
+        include BoardMock
         let(:options) { { pin: 'A0', board: board, pullup: true} }
+
         class InputComponent
           include SinglePin
           include Input
diff --git a/spec/lib/components/setup/multi_pin_spec.rb b/spec/lib/components/setup/multi_pin_spec.rb
index e1fbe547..db4b4fad 100644
--- a/spec/lib/components/setup/multi_pin_spec.rb
+++ b/spec/lib/components/setup/multi_pin_spec.rb
@@ -4,24 +4,69 @@ module Dino
   module Components
     module Setup
       describe MultiPin do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
-        let(:options) { { pins: {red: 9, blue: 10}, board: board } }
-        class MultiPinComponent; include MultiPin; end
+        include BoardMock
+        let(:options) { { pins: {one: 9, two: 10, maybe: 11}, board: board } }
+
+        class MultiPinComponent
+          include MultiPin
+          require_pin :one
+          proxy_pin   two:   Basic::DigitalOutput
+          proxy_pin   maybe: Basic::DigitalInput, optional: true
+        end
         subject { MultiPinComponent.new(options) }
 
         describe "::require_pins" do
-          it 'should add the pins to the @@required_pins class variable'
+          it 'should add required pins to the @@required_pins class variable' do
+            MultiPinComponent.class_eval('@@required_pins').should == [:one, :two]
+          end
         end
 
         describe "::proxy_pins" do
-          it 'should also call ::require_pins unless the pins are optional'
-          it 'should add the pins to the @@proxied_pins class variable'
+          it 'should automatically require the pin unless :optional is true' do
+            MultiPinComponent.class_eval('@@required_pins').should == [:one, :two]
+          end
+
+          it 'should add the pins to the @@proxied_pins class variable with the right classes' do
+            MultiPinComponent.class_eval('@@proxied_pins').should == {two: Basic::DigitalOutput, maybe: Basic::DigitalInput}
+          end
+        end
+
+        describe '#validate_pins' do
+          it 'should raise an error for any required pin that is missing' do
+            expect {
+              MultiPinComponent.new(board: board, pins: {one: 9, maybe: 11})
+            }.to raise_exception(/two/)
+          end
+
+          it 'should not raise errors for optional pins that are missing' do
+            expect {
+              MultiPinComponent.new(board: board, pins: {one: 9, two: 10})
+            }.to_not raise_exception
+          end
+        end
+
+        describe '#build_proxies' do
+          it 'should create the correct proxy subcomponents' do
+            subject.proxies[:two].class.should == Basic::DigitalOutput
+            subject.proxies[:maybe].class.should == Basic::DigitalInput
+          end
+
+          it 'should create an attr_accessor for each proxy' do
+            subject.two.class.should == Basic::DigitalOutput
+            subject.maybe.class.should == Basic::DigitalInput
+          end
+
+          it 'should attach the subcomponents to the right pins' do
+            subject.two.pin.should == 10
+            subject.maybe.pin.should == 11
+          end
         end
 
-        describe '#initialize' do
-          it 'should require every pin in the @@require_pin class variable'
-          it 'should create proxies for each of the pins in @@proxy_pins'
+        describe '#states' do
+          it 'should return a hash with the state of each subcomponent' do
+            subject.two.high
+            subject.state.should == {two: board.high, maybe: nil}
+          end
         end
       end
     end
diff --git a/spec/lib/components/setup/output_spec.rb b/spec/lib/components/setup/output_spec.rb
index 9a85d28e..d2925487 100644
--- a/spec/lib/components/setup/output_spec.rb
+++ b/spec/lib/components/setup/output_spec.rb
@@ -4,9 +4,9 @@ module Dino
   module Components
     module Setup
       describe Input do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
+        include BoardMock
         let(:options) { { pin: 'A0', board: board, pullup: true} }
+
         class OutputComponent
           include SinglePin
           include Output
@@ -14,7 +14,7 @@ class OutputComponent
         subject { OutputComponent.new(options) }
 
         describe '#initialize_pins' do
-         it 'should set the pin mode to in' do
+         it 'should set the pin mode to out' do
             board.should_receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :out)
             subject
           end
diff --git a/spec/lib/components/setup/single_pin_spec.rb b/spec/lib/components/setup/single_pin_spec.rb
index 34a57dc6..9e7a70e2 100644
--- a/spec/lib/components/setup/single_pin_spec.rb
+++ b/spec/lib/components/setup/single_pin_spec.rb
@@ -4,10 +4,12 @@ module Dino
   module Components
     module Setup
       describe SinglePin do
-        let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-        let(:board) { Board.new(txrx) }
+        include BoardMock
         let(:options) { { pin: 'A0', board: board } }
-        class SinglePinComponent; include SinglePin; end
+
+        class SinglePinComponent
+          include SinglePin
+        end
         subject { SinglePinComponent.new(options) }
         
         describe '#initialize' do
diff --git a/spec/lib/components/shift_register_spec.rb b/spec/lib/components/shift_register_spec.rb
index cd7f37dd..826f91ce 100644
--- a/spec/lib/components/shift_register_spec.rb
+++ b/spec/lib/components/shift_register_spec.rb
@@ -3,8 +3,7 @@
 module Dino
   module Components
     describe ShiftRegister do
-      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-      let(:board) { Board.new(txrx) }
+      include BoardMock
       let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
       subject { ShiftRegister.new(options)  }
 
diff --git a/spec/lib/components/softwareserial_spec.rb b/spec/lib/components/softwareserial_spec.rb
index e846e92b..05225b86 100644
--- a/spec/lib/components/softwareserial_spec.rb
+++ b/spec/lib/components/softwareserial_spec.rb
@@ -3,8 +3,7 @@
 module Dino
   module Components
     describe SoftwareSerial do
-      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-      let(:board) { Board.new(txrx) }
+      include BoardMock
 
       subject { SoftwareSerial.new board: board, pins: { rx: 10, tx: 11 }, baud: 4800 }
 
diff --git a/spec/lib/components/ssd_spec.rb b/spec/lib/components/ssd_spec.rb
index f11e89ce..fd3d6367 100644
--- a/spec/lib/components/ssd_spec.rb
+++ b/spec/lib/components/ssd_spec.rb
@@ -3,8 +3,7 @@
 module Dino
   module Components
     describe SSD do
-      let(:txrx)  { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-      let(:board) { Board.new(txrx) }
+      include BoardMock
       let(:pins)  { {anode: 11, a: 12, b: 13, c: 3, d: 4, e: 5, f: 10, g: 9} }
       subject   { SSD.new(board: board, pins: pins) }
 
diff --git a/spec/lib/components/stepper_spec.rb b/spec/lib/components/stepper_spec.rb
index f5017711..673420aa 100644
--- a/spec/lib/components/stepper_spec.rb
+++ b/spec/lib/components/stepper_spec.rb
@@ -3,8 +3,7 @@
 module Dino
   module Components
     describe Stepper do
-      let(:txrx) { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
-      let(:board) { Board.new(txrx) }
+      include BoardMock
       let(:options) { { pins: {step: 9, direction: 10}, board: board } }
 
       subject { Stepper.new(options) }
diff --git a/spec/spec_helper.rb b/spec/spec_helper.rb
index 3ed69bc3..48219c57 100644
--- a/spec/spec_helper.rb
+++ b/spec/spec_helper.rb
@@ -9,4 +9,13 @@ def self.redefine(const, value, opts={})
     opts[:on].send(:remove_const, const) if self.class.const_defined?(const)
     opts[:on].const_set(const, value)
   end
-end
\ No newline at end of file
+end
+
+module BoardMock
+  def self.included(base)
+    base.class_eval do 
+      let(:txrx)  { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:board) { Dino::Board.new(txrx) }
+    end
+  end
+end

From a6fd739b30260800ee3732af54578413dc6135c1 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 8 Jan 2014 08:32:23 -0400
Subject: [PATCH 054/296] Make DHT sensors work with recent changes.

---
 lib/dino/components/dht.rb | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
index aa53543d..872e54b1 100644
--- a/lib/dino/components/dht.rb
+++ b/lib/dino/components/dht.rb
@@ -1,11 +1,10 @@
 module Dino
   module Components
     module DHT
-      class Temperature < Core::BaseInput
-        #
-        # These components work too slowly to poll often enough for a listener.
-        #
-        def listen; end
+      class Temperature
+        include Setup::SinglePin
+        include Setup::Input
+        include Mixins::Poller
 
         def _read
           board.dht_read(self.pin, 0)
@@ -18,11 +17,10 @@ def update(data)
         end
       end
 
-      class Humidity < Core::BaseInput
-        #
-        # These components work too slowly to poll often enough for a listener.
-        #
-        def listen; end
+      class Humidity
+        include Setup::SinglePin
+        include Setup::Input
+        include Mixins::Poller
 
         def _read
           board.dht_read(self.pin, 1)

From 2dc293ce657448d74a68490cfa6f78de67835690 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 8 Jan 2014 09:05:33 -0400
Subject: [PATCH 055/296] Model shift register as a drop-in replacement for
 Board class. Added SSD example.

---
 examples/shift_register.rb            | 17 ++++++++--
 lib/dino/components/shift_register.rb | 45 +++++++++++++++++++++++++--
 2 files changed, 57 insertions(+), 5 deletions(-)

diff --git a/examples/shift_register.rb b/examples/shift_register.rb
index fe5945b6..ab916143 100644
--- a/examples/shift_register.rb
+++ b/examples/shift_register.rb
@@ -8,10 +8,21 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 shift_register = Dino::Components::ShiftRegister.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
 
+ssd   = Dino::Components::SSD.new(
+  board: shift_register,
+  pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
+)
+
+# Turn off the ssd on exit
+trap("SIGINT") { exit !ssd.off }
+
+# Display each new line on the ssd
+loop { ssd.display(gets.chomp) }
+
 # Write a single byte
-shift_register.write(255)
+# shift_register.write_byte(255)
 
 # Write an array of bytes (for multiple registers).
-shift_register.write([255, 0])
+# shift_register.write_bytes([255, 0])
 
-sleep
+# sleep
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index 85730234..9eb6ccd1 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -8,8 +8,47 @@ class ShiftRegister
       proxy_pins  clock: Basic::DigitalOutput,
                   latch: Basic::DigitalOutput,
                   data:  Basic::DigitalOutput
-            
-      def write(bytes)
+      
+      attr_reader :high, :low, :components
+
+      def after_initialize(options={})
+        @high = 1
+        @low = 0
+        @components = []
+
+        @state = [0,0,0,0,0,0,0,0]
+        write_state
+      end
+
+      def add_component(component)
+        @components << component
+      end
+
+      def remove_component(component)
+        @components.delete(component)
+      end
+
+      def convert_pin(pin)
+        pin = pin.to_i
+      end
+
+      def set_pin_mode(pin, mode)
+        nil
+      end
+
+      def digital_write(pin, value)
+        @state[pin] = value
+        write_state
+      end
+
+      alias :write :digital_write
+
+      def write_state
+        byte = @state.join("").reverse.to_i(2)
+        write_bytes(byte)
+      end
+
+      def write_bytes(bytes)
         bytes = [bytes] unless bytes.class == Array
 
         latch.low
@@ -18,6 +57,8 @@ def write(bytes)
         end
         latch.high
       end
+
+      alias :write_byte :write_bytes
     end
   end
 end

From c9f9d7f05e4e4bebc3cc8237afb48b1328d2ea74 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 13 Jan 2014 12:26:10 -0400
Subject: [PATCH 056/296] Put back the 3 second sleep for windows

---
 lib/dino/tx_rx/serial.rb | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index c52ff7c0..f1e2b4a9 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -15,6 +15,12 @@ def io
         @io ||= connect
       end
 
+      def handshake
+        io
+        sleep 3 if on_windows?
+        super
+      end
+
       private
 
       def connect

From d37e9523f6cad38a57517bdd832340533c0bd52e Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 24 Feb 2014 23:52:02 -0400
Subject: [PATCH 057/296] Quick and dirty Dallas temp sensor implementation

---
 examples/one_wire/ds18b20.rb   |  15 +
 lib/dino/board.rb              |   3 +-
 lib/dino/components.rb         |   1 +
 lib/dino/components/ds18b20.rb |  13 +
 lib/dino_cli/generator.rb      |   2 +-
 src/dino_ethernet.ino          |   1 +
 src/dino_serial.ino            |   1 +
 src/dino_wifi.ino              |   1 +
 src/lib/Dino.cpp               |  49 +++
 src/lib/Dino.h                 |   2 +
 src/lib/OneWire.cpp            | 557 +++++++++++++++++++++++++++++++++
 src/lib/OneWire.h              | 229 ++++++++++++++
 12 files changed, 872 insertions(+), 2 deletions(-)
 create mode 100644 examples/one_wire/ds18b20.rb
 create mode 100644 lib/dino/components/ds18b20.rb
 create mode 100644 src/lib/OneWire.cpp
 create mode 100644 src/lib/OneWire.h

diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
new file mode 100644
index 00000000..9a7ae8a4
--- /dev/null
+++ b/examples/one_wire/ds18b20.rb
@@ -0,0 +1,15 @@
+#
+# Example of how to use the Dallas DS18B20 temperature sensor.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+
+# The temperature and humidity functions of the DHT sensors are
+# modelled separately, but both isntances can be set up on the same pin.
+temp = Dino::Components::DS18B20.new(pin: 7, board: board)
+
+temp.read do |temperature|
+  puts "The temperature is #{temperature} degrees C"
+end
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index b80c9459..e3a1c95e 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -81,7 +81,8 @@ def set_pullup(pin, pullup)
       stop_listener:   '7',
       servo_toggle:    '8',
       servo_write:     '9',
-      dht_read:        '13'
+      dht_read:        '13',
+      ds18b20_read:    '15'
     }
 
     PIN_COMMANDS.each_key do |command|
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index d2f8c5da..bdbc86d7 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -16,5 +16,6 @@ module Components
     autoload :Relay,          'dino/components/relay'
     autoload :SoftwareSerial, 'dino/components/softserial'
     autoload :DHT,            'dino/components/dht'
+    autoload :DS18B20,        'dino/components/ds18b20'
   end
 end
diff --git a/lib/dino/components/ds18b20.rb b/lib/dino/components/ds18b20.rb
new file mode 100644
index 00000000..0ee1d385
--- /dev/null
+++ b/lib/dino/components/ds18b20.rb
@@ -0,0 +1,13 @@
+module Dino
+  module Components
+    class DS18B20
+      include Setup::SinglePin
+      include Setup::Input
+      include Mixins::Poller
+
+      def _read
+        board.ds18b20_read(self.pin, 0)
+      end
+    end
+  end
+end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index b5a234fc..89d71a63 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,6 +1,6 @@
 class DinoCLI::Generator
   require "fileutils"
-  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h"]
+  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h", "OneWire.h", "OneWire.cpp"]
   attr_accessor :options
 
   def initialize(options={})
diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index 1091c5db..737c2040 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -4,6 +4,7 @@
 #include <Servo.h>
 #include <LiquidCrystal.h>
 #include "DHT.h"
+#include "OneWire.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index f3edb943..e276e5d3 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -2,6 +2,7 @@
 #include <Servo.h>
 #include <LiquidCrystal.h>
 #include "DHT.h"
+#include "OneWire.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 50a16d3a..3a99e701 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -4,6 +4,7 @@
 #include <Servo.h>
 #include <LiquidCrystal.h>
 #include "DHT.h"
+#include "OneWire.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index eace6ba6..404c05ea 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -87,6 +87,7 @@ void Dino::process() {
     case 11: shiftWrite          ();  break;
     case 12: handleSerial        ();  break;
     case 13: handleDHT           ();  break;
+    case 15: ds18Read            ();  break;
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
@@ -321,6 +322,54 @@ void Dino::handleDHT() {
   #endif
 }
 
+void Dino::ds18Read() {
+  OneWire ds(pin);
+
+  byte data[12];
+  byte addr[8];
+  
+  if ( !ds.search(addr)) {
+    ds.reset_search();
+    return;
+   }
+
+  if ( OneWire::crc8( addr, 7) != addr[7]) {
+    // Serial.println("CRC is not valid!");
+    return;
+  }
+
+  if ( addr[0] != 0x10 && addr[0] != 0x28) {
+    // Serial.print("Device is not recognized");
+    return;
+  }
+
+  ds.reset();
+  ds.select(addr);
+  ds.write(0x44,1); // start conversion, with parasite power on at the end
+
+  byte present = ds.reset();
+  ds.select(addr);  
+  ds.write(0xBE); // Read Scratchpad
+
+  for (int i = 0; i < 9; i++) { // we need 9 bytes
+    data[i] = ds.read();
+  }
+ 
+  ds.reset_search();
+ 
+  byte MSB = data[1];
+  byte LSB = data[0];
+
+  float tempRead = ((MSB << 8) | LSB); //using two's compliment
+  float reading = tempRead / 16;
+  char readingBuff[10];
+
+  if (! isnan(reading)) {
+    dtostrf(reading, 6, 4, readingBuff);
+    sprintf(response, "%d:%s", pin, readingBuff);
+  }
+}
+
 
 // CMD = 90
 void Dino::reset() {
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 7164eb21..eb0364bf 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -9,6 +9,7 @@
 #include <Servo.h>
 #include "DinoLCD.h"
 #include "DHT.h"
+#include "OneWire.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
@@ -54,6 +55,7 @@ class Dino {
     void shiftWrite            ();  //cmd = 11
     void handleSerial          ();  //cmd = 12
     void handleDHT             ();  //cmd = 13
+    void ds18Read              ();  //cmd = 15
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
diff --git a/src/lib/OneWire.cpp b/src/lib/OneWire.cpp
new file mode 100644
index 00000000..631813f8
--- /dev/null
+++ b/src/lib/OneWire.cpp
@@ -0,0 +1,557 @@
+/*
+Copyright (c) 2007, Jim Studt  (original old version - many contributors since)
+
+The latest version of this library may be found at:
+  http://www.pjrc.com/teensy/td_libs_OneWire.html
+
+OneWire has been maintained by Paul Stoffregen (paul@pjrc.com) since
+January 2010.  At the time, it was in need of many bug fixes, but had
+been abandoned the original author (Jim Studt).  None of the known
+contributors were interested in maintaining OneWire.  Paul typically
+works on OneWire every 6 to 12 months.  Patches usually wait that
+long.  If anyone is interested in more actively maintaining OneWire,
+please contact Paul.
+
+Version 2.2:
+  Teensy 3.0 compatibility, Paul Stoffregen, paul@pjrc.com
+  Arduino Due compatibility, http://arduino.cc/forum/index.php?topic=141030
+  Fix DS18B20 example negative temperature
+  Fix DS18B20 example's low res modes, Ken Butcher
+  Improve reset timing, Mark Tillotson
+  Add const qualifiers, Bertrik Sikken
+  Add initial value input to crc16, Bertrik Sikken
+  Add target_search() function, Scott Roberts
+
+Version 2.1:
+  Arduino 1.0 compatibility, Paul Stoffregen
+  Improve temperature example, Paul Stoffregen
+  DS250x_PROM example, Guillermo Lovato
+  PIC32 (chipKit) compatibility, Jason Dangel, dangel.jason AT gmail.com
+  Improvements from Glenn Trewitt:
+  - crc16() now works
+  - check_crc16() does all of calculation/checking work.
+  - Added read_bytes() and write_bytes(), to reduce tedious loops.
+  - Added ds2408 example.
+  Delete very old, out-of-date readme file (info is here)
+
+Version 2.0: Modifications by Paul Stoffregen, January 2010:
+http://www.pjrc.com/teensy/td_libs_OneWire.html
+  Search fix from Robin James
+    http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1238032295/27#27
+  Use direct optimized I/O in all cases
+  Disable interrupts during timing critical sections
+    (this solves many random communication errors)
+  Disable interrupts during read-modify-write I/O
+  Reduce RAM consumption by eliminating unnecessary
+    variables and trimming many to 8 bits
+  Optimize both crc8 - table version moved to flash
+
+Modified to work with larger numbers of devices - avoids loop.
+Tested in Arduino 11 alpha with 12 sensors.
+26 Sept 2008 -- Robin James
+http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1238032295/27#27
+
+Updated to work with arduino-0008 and to include skip() as of
+2007/07/06. --RJL20
+
+Modified to calculate the 8-bit CRC directly, avoiding the need for
+the 256-byte lookup table to be loaded in RAM.  Tested in arduino-0010
+-- Tom Pollard, Jan 23, 2008
+
+Jim Studt's original library was modified by Josh Larios.
+
+Tom Pollard, pollard@alum.mit.edu, contributed around May 20, 2008
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Much of the code was inspired by Derek Yerger's code, though I don't
+think much of that remains.  In any event that was..
+    (copyleft) 2006 by Derek Yerger - Free to distribute freely.
+
+The CRC code was excerpted and inspired by the Dallas Semiconductor
+sample code bearing this copyright.
+//---------------------------------------------------------------------------
+// Copyright (C) 2000 Dallas Semiconductor Corporation, All Rights Reserved.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a
+// copy of this software and associated documentation files (the "Software"),
+// to deal in the Software without restriction, including without limitation
+// the rights to use, copy, modify, merge, publish, distribute, sublicense,
+// and/or sell copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included
+// in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY,  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+// IN NO EVENT SHALL DALLAS SEMICONDUCTOR BE LIABLE FOR ANY CLAIM, DAMAGES
+// OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+// Except as contained in this notice, the name of Dallas Semiconductor
+// shall not be used except as stated in the Dallas Semiconductor
+// Branding Policy.
+//--------------------------------------------------------------------------
+*/
+
+#include "OneWire.h"
+
+
+OneWire::OneWire(uint8_t pin)
+{
+	pinMode(pin, INPUT);
+	bitmask = PIN_TO_BITMASK(pin);
+	baseReg = PIN_TO_BASEREG(pin);
+#if ONEWIRE_SEARCH
+	reset_search();
+#endif
+}
+
+
+// Perform the onewire reset function.  We will wait up to 250uS for
+// the bus to come high, if it doesn't then it is broken or shorted
+// and we return a 0;
+//
+// Returns 1 if a device asserted a presence pulse, 0 otherwise.
+//
+uint8_t OneWire::reset(void)
+{
+	IO_REG_TYPE mask = bitmask;
+	volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg;
+	uint8_t r;
+	uint8_t retries = 125;
+
+	noInterrupts();
+	DIRECT_MODE_INPUT(reg, mask);
+	interrupts();
+	// wait until the wire is high... just in case
+	do {
+		if (--retries == 0) return 0;
+		delayMicroseconds(2);
+	} while ( !DIRECT_READ(reg, mask));
+
+	noInterrupts();
+	DIRECT_WRITE_LOW(reg, mask);
+	DIRECT_MODE_OUTPUT(reg, mask);	// drive output low
+	interrupts();
+	delayMicroseconds(480);
+	noInterrupts();
+	DIRECT_MODE_INPUT(reg, mask);	// allow it to float
+	delayMicroseconds(70);
+	r = !DIRECT_READ(reg, mask);
+	interrupts();
+	delayMicroseconds(410);
+	return r;
+}
+
+//
+// Write a bit. Port and bit is used to cut lookup time and provide
+// more certain timing.
+//
+void OneWire::write_bit(uint8_t v)
+{
+	IO_REG_TYPE mask=bitmask;
+	volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg;
+
+	if (v & 1) {
+		noInterrupts();
+		DIRECT_WRITE_LOW(reg, mask);
+		DIRECT_MODE_OUTPUT(reg, mask);	// drive output low
+		delayMicroseconds(10);
+		DIRECT_WRITE_HIGH(reg, mask);	// drive output high
+		interrupts();
+		delayMicroseconds(55);
+	} else {
+		noInterrupts();
+		DIRECT_WRITE_LOW(reg, mask);
+		DIRECT_MODE_OUTPUT(reg, mask);	// drive output low
+		delayMicroseconds(65);
+		DIRECT_WRITE_HIGH(reg, mask);	// drive output high
+		interrupts();
+		delayMicroseconds(5);
+	}
+}
+
+//
+// Read a bit. Port and bit is used to cut lookup time and provide
+// more certain timing.
+//
+uint8_t OneWire::read_bit(void)
+{
+	IO_REG_TYPE mask=bitmask;
+	volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg;
+	uint8_t r;
+
+	noInterrupts();
+	DIRECT_MODE_OUTPUT(reg, mask);
+	DIRECT_WRITE_LOW(reg, mask);
+	delayMicroseconds(3);
+	DIRECT_MODE_INPUT(reg, mask);	// let pin float, pull up will raise
+	delayMicroseconds(10);
+	r = DIRECT_READ(reg, mask);
+	interrupts();
+	delayMicroseconds(53);
+	return r;
+}
+
+//
+// Write a byte. The writing code uses the active drivers to raise the
+// pin high, if you need power after the write (e.g. DS18S20 in
+// parasite power mode) then set 'power' to 1, otherwise the pin will
+// go tri-state at the end of the write to avoid heating in a short or
+// other mishap.
+//
+void OneWire::write(uint8_t v, uint8_t power /* = 0 */) {
+    uint8_t bitMask;
+
+    for (bitMask = 0x01; bitMask; bitMask <<= 1) {
+	OneWire::write_bit( (bitMask & v)?1:0);
+    }
+    if ( !power) {
+	noInterrupts();
+	DIRECT_MODE_INPUT(baseReg, bitmask);
+	DIRECT_WRITE_LOW(baseReg, bitmask);
+	interrupts();
+    }
+}
+
+void OneWire::write_bytes(const uint8_t *buf, uint16_t count, bool power /* = 0 */) {
+  for (uint16_t i = 0 ; i < count ; i++)
+    write(buf[i]);
+  if (!power) {
+    noInterrupts();
+    DIRECT_MODE_INPUT(baseReg, bitmask);
+    DIRECT_WRITE_LOW(baseReg, bitmask);
+    interrupts();
+  }
+}
+
+//
+// Read a byte
+//
+uint8_t OneWire::read() {
+    uint8_t bitMask;
+    uint8_t r = 0;
+
+    for (bitMask = 0x01; bitMask; bitMask <<= 1) {
+	if ( OneWire::read_bit()) r |= bitMask;
+    }
+    return r;
+}
+
+void OneWire::read_bytes(uint8_t *buf, uint16_t count) {
+  for (uint16_t i = 0 ; i < count ; i++)
+    buf[i] = read();
+}
+
+//
+// Do a ROM select
+//
+void OneWire::select(const uint8_t rom[8])
+{
+    uint8_t i;
+
+    write(0x55);           // Choose ROM
+
+    for (i = 0; i < 8; i++) write(rom[i]);
+}
+
+//
+// Do a ROM skip
+//
+void OneWire::skip()
+{
+    write(0xCC);           // Skip ROM
+}
+
+void OneWire::depower()
+{
+	noInterrupts();
+	DIRECT_MODE_INPUT(baseReg, bitmask);
+	interrupts();
+}
+
+#if ONEWIRE_SEARCH
+
+//
+// You need to use this function to start a search again from the beginning.
+// You do not need to do it for the first search, though you could.
+//
+void OneWire::reset_search()
+{
+  // reset the search state
+  LastDiscrepancy = 0;
+  LastDeviceFlag = FALSE;
+  LastFamilyDiscrepancy = 0;
+  for(int i = 7; ; i--) {
+    ROM_NO[i] = 0;
+    if ( i == 0) break;
+  }
+}
+
+// Setup the search to find the device type 'family_code' on the next call
+// to search(*newAddr) if it is present.
+//
+void OneWire::target_search(uint8_t family_code)
+{
+   // set the search state to find SearchFamily type devices
+   ROM_NO[0] = family_code;
+   for (uint8_t i = 1; i < 8; i++)
+      ROM_NO[i] = 0;
+   LastDiscrepancy = 64;
+   LastFamilyDiscrepancy = 0;
+   LastDeviceFlag = FALSE;
+}
+
+//
+// Perform a search. If this function returns a '1' then it has
+// enumerated the next device and you may retrieve the ROM from the
+// OneWire::address variable. If there are no devices, no further
+// devices, or something horrible happens in the middle of the
+// enumeration then a 0 is returned.  If a new device is found then
+// its address is copied to newAddr.  Use OneWire::reset_search() to
+// start over.
+//
+// --- Replaced by the one from the Dallas Semiconductor web site ---
+//--------------------------------------------------------------------------
+// Perform the 1-Wire Search Algorithm on the 1-Wire bus using the existing
+// search state.
+// Return TRUE  : device found, ROM number in ROM_NO buffer
+//        FALSE : device not found, end of search
+//
+uint8_t OneWire::search(uint8_t *newAddr)
+{
+   uint8_t id_bit_number;
+   uint8_t last_zero, rom_byte_number, search_result;
+   uint8_t id_bit, cmp_id_bit;
+
+   unsigned char rom_byte_mask, search_direction;
+
+   // initialize for search
+   id_bit_number = 1;
+   last_zero = 0;
+   rom_byte_number = 0;
+   rom_byte_mask = 1;
+   search_result = 0;
+
+   // if the last call was not the last one
+   if (!LastDeviceFlag)
+   {
+      // 1-Wire reset
+      if (!reset())
+      {
+         // reset the search
+         LastDiscrepancy = 0;
+         LastDeviceFlag = FALSE;
+         LastFamilyDiscrepancy = 0;
+         return FALSE;
+      }
+
+      // issue the search command
+      write(0xF0);
+
+      // loop to do the search
+      do
+      {
+         // read a bit and its complement
+         id_bit = read_bit();
+         cmp_id_bit = read_bit();
+
+         // check for no devices on 1-wire
+         if ((id_bit == 1) && (cmp_id_bit == 1))
+            break;
+         else
+         {
+            // all devices coupled have 0 or 1
+            if (id_bit != cmp_id_bit)
+               search_direction = id_bit;  // bit write value for search
+            else
+            {
+               // if this discrepancy if before the Last Discrepancy
+               // on a previous next then pick the same as last time
+               if (id_bit_number < LastDiscrepancy)
+                  search_direction = ((ROM_NO[rom_byte_number] & rom_byte_mask) > 0);
+               else
+                  // if equal to last pick 1, if not then pick 0
+                  search_direction = (id_bit_number == LastDiscrepancy);
+
+               // if 0 was picked then record its position in LastZero
+               if (search_direction == 0)
+               {
+                  last_zero = id_bit_number;
+
+                  // check for Last discrepancy in family
+                  if (last_zero < 9)
+                     LastFamilyDiscrepancy = last_zero;
+               }
+            }
+
+            // set or clear the bit in the ROM byte rom_byte_number
+            // with mask rom_byte_mask
+            if (search_direction == 1)
+              ROM_NO[rom_byte_number] |= rom_byte_mask;
+            else
+              ROM_NO[rom_byte_number] &= ~rom_byte_mask;
+
+            // serial number search direction write bit
+            write_bit(search_direction);
+
+            // increment the byte counter id_bit_number
+            // and shift the mask rom_byte_mask
+            id_bit_number++;
+            rom_byte_mask <<= 1;
+
+            // if the mask is 0 then go to new SerialNum byte rom_byte_number and reset mask
+            if (rom_byte_mask == 0)
+            {
+                rom_byte_number++;
+                rom_byte_mask = 1;
+            }
+         }
+      }
+      while(rom_byte_number < 8);  // loop until through all ROM bytes 0-7
+
+      // if the search was successful then
+      if (!(id_bit_number < 65))
+      {
+         // search successful so set LastDiscrepancy,LastDeviceFlag,search_result
+         LastDiscrepancy = last_zero;
+
+         // check for last device
+         if (LastDiscrepancy == 0)
+            LastDeviceFlag = TRUE;
+
+         search_result = TRUE;
+      }
+   }
+
+   // if no device found then reset counters so next 'search' will be like a first
+   if (!search_result || !ROM_NO[0])
+   {
+      LastDiscrepancy = 0;
+      LastDeviceFlag = FALSE;
+      LastFamilyDiscrepancy = 0;
+      search_result = FALSE;
+   }
+   for (int i = 0; i < 8; i++) newAddr[i] = ROM_NO[i];
+   return search_result;
+  }
+
+#endif
+
+#if ONEWIRE_CRC
+// The 1-Wire CRC scheme is described in Maxim Application Note 27:
+// "Understanding and Using Cyclic Redundancy Checks with Maxim iButton Products"
+//
+
+#if ONEWIRE_CRC8_TABLE
+// This table comes from Dallas sample code where it is freely reusable,
+// though Copyright (C) 2000 Dallas Semiconductor Corporation
+static const uint8_t PROGMEM dscrc_table[] = {
+      0, 94,188,226, 97, 63,221,131,194,156,126, 32,163,253, 31, 65,
+    157,195, 33,127,252,162, 64, 30, 95,  1,227,189, 62, 96,130,220,
+     35,125,159,193, 66, 28,254,160,225,191, 93,  3,128,222, 60, 98,
+    190,224,  2, 92,223,129, 99, 61,124, 34,192,158, 29, 67,161,255,
+     70, 24,250,164, 39,121,155,197,132,218, 56,102,229,187, 89,  7,
+    219,133,103, 57,186,228,  6, 88, 25, 71,165,251,120, 38,196,154,
+    101, 59,217,135,  4, 90,184,230,167,249, 27, 69,198,152,122, 36,
+    248,166, 68, 26,153,199, 37,123, 58,100,134,216, 91,  5,231,185,
+    140,210, 48,110,237,179, 81, 15, 78, 16,242,172, 47,113,147,205,
+     17, 79,173,243,112, 46,204,146,211,141,111, 49,178,236, 14, 80,
+    175,241, 19, 77,206,144,114, 44,109, 51,209,143, 12, 82,176,238,
+     50,108,142,208, 83, 13,239,177,240,174, 76, 18,145,207, 45,115,
+    202,148,118, 40,171,245, 23, 73,  8, 86,180,234,105, 55,213,139,
+     87,  9,235,181, 54,104,138,212,149,203, 41,119,244,170, 72, 22,
+    233,183, 85, 11,136,214, 52,106, 43,117,151,201, 74, 20,246,168,
+    116, 42,200,150, 21, 75,169,247,182,232, 10, 84,215,137,107, 53};
+
+//
+// Compute a Dallas Semiconductor 8 bit CRC. These show up in the ROM
+// and the registers.  (note: this might better be done without to
+// table, it would probably be smaller and certainly fast enough
+// compared to all those delayMicrosecond() calls.  But I got
+// confused, so I use this table from the examples.)
+//
+uint8_t OneWire::crc8(const uint8_t *addr, uint8_t len)
+{
+	uint8_t crc = 0;
+
+	while (len--) {
+		crc = pgm_read_byte(dscrc_table + (crc ^ *addr++));
+	}
+	return crc;
+}
+#else
+//
+// Compute a Dallas Semiconductor 8 bit CRC directly.
+// this is much slower, but much smaller, than the lookup table.
+//
+uint8_t OneWire::crc8(const uint8_t *addr, uint8_t len)
+{
+	uint8_t crc = 0;
+	
+	while (len--) {
+		uint8_t inbyte = *addr++;
+		for (uint8_t i = 8; i; i--) {
+			uint8_t mix = (crc ^ inbyte) & 0x01;
+			crc >>= 1;
+			if (mix) crc ^= 0x8C;
+			inbyte >>= 1;
+		}
+	}
+	return crc;
+}
+#endif
+
+#if ONEWIRE_CRC16
+bool OneWire::check_crc16(const uint8_t* input, uint16_t len, const uint8_t* inverted_crc, uint16_t crc)
+{
+    crc = ~crc16(input, len, crc);
+    return (crc & 0xFF) == inverted_crc[0] && (crc >> 8) == inverted_crc[1];
+}
+
+uint16_t OneWire::crc16(const uint8_t* input, uint16_t len, uint16_t crc)
+{
+    static const uint8_t oddparity[16] =
+        { 0, 1, 1, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0 };
+
+    for (uint16_t i = 0 ; i < len ; i++) {
+      // Even though we're just copying a byte from the input,
+      // we'll be doing 16-bit computation with it.
+      uint16_t cdata = input[i];
+      cdata = (cdata ^ crc) & 0xff;
+      crc >>= 8;
+
+      if (oddparity[cdata & 0x0F] ^ oddparity[cdata >> 4])
+          crc ^= 0xC001;
+
+      cdata <<= 6;
+      crc ^= cdata;
+      cdata <<= 1;
+      crc ^= cdata;
+    }
+    return crc;
+}
+#endif
+
+#endif
diff --git a/src/lib/OneWire.h b/src/lib/OneWire.h
new file mode 100644
index 00000000..916c5290
--- /dev/null
+++ b/src/lib/OneWire.h
@@ -0,0 +1,229 @@
+#ifndef OneWire_h
+#define OneWire_h
+
+#include <inttypes.h>
+
+#if ARDUINO >= 100
+#include "Arduino.h"       // for delayMicroseconds, digitalPinToBitMask, etc
+#else
+#include "WProgram.h"      // for delayMicroseconds
+#include "pins_arduino.h"  // for digitalPinToBitMask, etc
+#endif
+
+// You can exclude certain features from OneWire.  In theory, this
+// might save some space.  In practice, the compiler automatically
+// removes unused code (technically, the linker, using -fdata-sections
+// and -ffunction-sections when compiling, and Wl,--gc-sections
+// when linking), so most of these will not result in any code size
+// reduction.  Well, unless you try to use the missing features
+// and redesign your program to not need them!  ONEWIRE_CRC8_TABLE
+// is the exception, because it selects a fast but large algorithm
+// or a small but slow algorithm.
+
+// you can exclude onewire_search by defining that to 0
+#ifndef ONEWIRE_SEARCH
+#define ONEWIRE_SEARCH 1
+#endif
+
+// You can exclude CRC checks altogether by defining this to 0
+#ifndef ONEWIRE_CRC
+#define ONEWIRE_CRC 1
+#endif
+
+// Select the table-lookup method of computing the 8-bit CRC
+// by setting this to 1.  The lookup table enlarges code size by
+// about 250 bytes.  It does NOT consume RAM (but did in very
+// old versions of OneWire).  If you disable this, a slower
+// but very compact algorithm is used.
+#ifndef ONEWIRE_CRC8_TABLE
+#define ONEWIRE_CRC8_TABLE 1
+#endif
+
+// You can allow 16-bit CRC checks by defining this to 1
+// (Note that ONEWIRE_CRC must also be 1.)
+#ifndef ONEWIRE_CRC16
+#define ONEWIRE_CRC16 1
+#endif
+
+#define FALSE 0
+#define TRUE  1
+
+// Platform specific I/O definitions
+
+#if defined(__AVR__)
+#define PIN_TO_BASEREG(pin)             (portInputRegister(digitalPinToPort(pin)))
+#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
+#define IO_REG_TYPE uint8_t
+#define IO_REG_ASM asm("r30")
+#define DIRECT_READ(base, mask)         (((*(base)) & (mask)) ? 1 : 0)
+#define DIRECT_MODE_INPUT(base, mask)   ((*((base)+1)) &= ~(mask))
+#define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+1)) |= (mask))
+#define DIRECT_WRITE_LOW(base, mask)    ((*((base)+2)) &= ~(mask))
+#define DIRECT_WRITE_HIGH(base, mask)   ((*((base)+2)) |= (mask))
+
+#elif defined(__MK20DX128__)
+#define PIN_TO_BASEREG(pin)             (portOutputRegister(pin))
+#define PIN_TO_BITMASK(pin)             (1)
+#define IO_REG_TYPE uint8_t
+#define IO_REG_ASM
+#define DIRECT_READ(base, mask)         (*((base)+512))
+#define DIRECT_MODE_INPUT(base, mask)   (*((base)+640) = 0)
+#define DIRECT_MODE_OUTPUT(base, mask)  (*((base)+640) = 1)
+#define DIRECT_WRITE_LOW(base, mask)    (*((base)+256) = 1)
+#define DIRECT_WRITE_HIGH(base, mask)   (*((base)+128) = 1)
+
+#elif defined(__SAM3X8E__)
+// Arduino 1.5.1 may have a bug in delayMicroseconds() on Arduino Due.
+// http://arduino.cc/forum/index.php/topic,141030.msg1076268.html#msg1076268
+// If you have trouble with OneWire on Arduino Due, please check the
+// status of delayMicroseconds() before reporting a bug in OneWire!
+#define PIN_TO_BASEREG(pin)             (&(digitalPinToPort(pin)->PIO_PER))
+#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
+#define IO_REG_TYPE uint32_t
+#define IO_REG_ASM
+#define DIRECT_READ(base, mask)         (((*((base)+15)) & (mask)) ? 1 : 0)
+#define DIRECT_MODE_INPUT(base, mask)   ((*((base)+5)) = (mask))
+#define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+4)) = (mask))
+#define DIRECT_WRITE_LOW(base, mask)    ((*((base)+13)) = (mask))
+#define DIRECT_WRITE_HIGH(base, mask)   ((*((base)+12)) = (mask))
+#ifndef PROGMEM
+#define PROGMEM
+#endif
+#ifndef pgm_read_byte
+#define pgm_read_byte(addr) (*(const uint8_t *)(addr))
+#endif
+
+#elif defined(__PIC32MX__)
+#define PIN_TO_BASEREG(pin)             (portModeRegister(digitalPinToPort(pin)))
+#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
+#define IO_REG_TYPE uint32_t
+#define IO_REG_ASM
+#define DIRECT_READ(base, mask)         (((*(base+4)) & (mask)) ? 1 : 0)  //PORTX + 0x10
+#define DIRECT_MODE_INPUT(base, mask)   ((*(base+2)) = (mask))            //TRISXSET + 0x08
+#define DIRECT_MODE_OUTPUT(base, mask)  ((*(base+1)) = (mask))            //TRISXCLR + 0x04
+#define DIRECT_WRITE_LOW(base, mask)    ((*(base+8+1)) = (mask))          //LATXCLR  + 0x24
+#define DIRECT_WRITE_HIGH(base, mask)   ((*(base+8+2)) = (mask))          //LATXSET + 0x28
+
+#else
+#error "Please define I/O register types here"
+#endif
+
+
+class OneWire
+{
+  private:
+    IO_REG_TYPE bitmask;
+    volatile IO_REG_TYPE *baseReg;
+
+#if ONEWIRE_SEARCH
+    // global search state
+    unsigned char ROM_NO[8];
+    uint8_t LastDiscrepancy;
+    uint8_t LastFamilyDiscrepancy;
+    uint8_t LastDeviceFlag;
+#endif
+
+  public:
+    OneWire( uint8_t pin);
+
+    // Perform a 1-Wire reset cycle. Returns 1 if a device responds
+    // with a presence pulse.  Returns 0 if there is no device or the
+    // bus is shorted or otherwise held low for more than 250uS
+    uint8_t reset(void);
+
+    // Issue a 1-Wire rom select command, you do the reset first.
+    void select(const uint8_t rom[8]);
+
+    // Issue a 1-Wire rom skip command, to address all on bus.
+    void skip(void);
+
+    // Write a byte. If 'power' is one then the wire is held high at
+    // the end for parasitically powered devices. You are responsible
+    // for eventually depowering it by calling depower() or doing
+    // another read or write.
+    void write(uint8_t v, uint8_t power = 0);
+
+    void write_bytes(const uint8_t *buf, uint16_t count, bool power = 0);
+
+    // Read a byte.
+    uint8_t read(void);
+
+    void read_bytes(uint8_t *buf, uint16_t count);
+
+    // Write a bit. The bus is always left powered at the end, see
+    // note in write() about that.
+    void write_bit(uint8_t v);
+
+    // Read a bit.
+    uint8_t read_bit(void);
+
+    // Stop forcing power onto the bus. You only need to do this if
+    // you used the 'power' flag to write() or used a write_bit() call
+    // and aren't about to do another read or write. You would rather
+    // not leave this powered if you don't have to, just in case
+    // someone shorts your bus.
+    void depower(void);
+
+#if ONEWIRE_SEARCH
+    // Clear the search state so that if will start from the beginning again.
+    void reset_search();
+
+    // Setup the search to find the device type 'family_code' on the next call
+    // to search(*newAddr) if it is present.
+    void target_search(uint8_t family_code);
+
+    // Look for the next device. Returns 1 if a new address has been
+    // returned. A zero might mean that the bus is shorted, there are
+    // no devices, or you have already retrieved all of them.  It
+    // might be a good idea to check the CRC to make sure you didn't
+    // get garbage.  The order is deterministic. You will always get
+    // the same devices in the same order.
+    uint8_t search(uint8_t *newAddr);
+#endif
+
+#if ONEWIRE_CRC
+    // Compute a Dallas Semiconductor 8 bit CRC, these are used in the
+    // ROM and scratchpad registers.
+    static uint8_t crc8(const uint8_t *addr, uint8_t len);
+
+#if ONEWIRE_CRC16
+    // Compute the 1-Wire CRC16 and compare it against the received CRC.
+    // Example usage (reading a DS2408):
+    //    // Put everything in a buffer so we can compute the CRC easily.
+    //    uint8_t buf[13];
+    //    buf[0] = 0xF0;    // Read PIO Registers
+    //    buf[1] = 0x88;    // LSB address
+    //    buf[2] = 0x00;    // MSB address
+    //    WriteBytes(net, buf, 3);    // Write 3 cmd bytes
+    //    ReadBytes(net, buf+3, 10);  // Read 6 data bytes, 2 0xFF, 2 CRC16
+    //    if (!CheckCRC16(buf, 11, &buf[11])) {
+    //        // Handle error.
+    //    }     
+    //          
+    // @param input - Array of bytes to checksum.
+    // @param len - How many bytes to use.
+    // @param inverted_crc - The two CRC16 bytes in the received data.
+    //                       This should just point into the received data,
+    //                       *not* at a 16-bit integer.
+    // @param crc - The crc starting value (optional)
+    // @return True, iff the CRC matches.
+    static bool check_crc16(const uint8_t* input, uint16_t len, const uint8_t* inverted_crc, uint16_t crc = 0);
+
+    // Compute a Dallas Semiconductor 16 bit CRC.  This is required to check
+    // the integrity of data received from many 1-Wire devices.  Note that the
+    // CRC computed here is *not* what you'll get from the 1-Wire network,
+    // for two reasons:
+    //   1) The CRC is transmitted bitwise inverted.
+    //   2) Depending on the endian-ness of your processor, the binary
+    //      representation of the two-byte return value may have a different
+    //      byte order than the two bytes you get from 1-Wire.
+    // @param input - Array of bytes to checksum.
+    // @param len - How many bytes to use.
+    // @param crc - The crc starting value (optional)
+    // @return The CRC16, as defined by Dallas Semiconductor.
+    static uint16_t crc16(const uint8_t* input, uint16_t len, uint16_t crc = 0);
+#endif
+#endif
+};
+
+#endif

From a23595474926f6f6e961a5167da94dfeec055942 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 8 Sep 2014 23:46:32 -0400
Subject: [PATCH 058/296] Support MS1, MS2, SLEEP and ENABLE features on the
 EasyDriver stepper board.

---
 lib/dino/components/stepper.rb | 52 +++++++++++++++++++++++++++++++---
 1 file changed, 48 insertions(+), 4 deletions(-)

diff --git a/lib/dino/components/stepper.rb b/lib/dino/components/stepper.rb
index 3f739f76..075104f6 100644
--- a/lib/dino/components/stepper.rb
+++ b/lib/dino/components/stepper.rb
@@ -2,18 +2,62 @@ module Dino
   module Components
     class Stepper
       include Setup::MultiPin 
-      
+
       proxy_pins  step:      Basic::DigitalOutput,
                   direction: Basic::DigitalOutput
-    
+
+      proxy_pins  ms1:       Basic::DigitalOutput,
+                  ms2:       Basic::DigitalOutput,
+                  enable:    Basic::DigitalOutput,
+                  sleep:     Basic::DigitalOutput,
+                  optional: true
+
+      def after_initialize(options={})
+        wake; on; divider = 8
+      end
+
+      def sleep_mode
+        sleep.low if pins[:sleep]
+      end
+
+      def wake
+        sleep.high if pins[:sleep]
+      end
+
+      def off
+        enable.high if pins[:enable]
+      end
+
+      def on
+        enable.low if pins[:enable]
+      end
+
+      def divider=(steps)
+        return unless (ms1 && ms2)
+        case steps.to_i
+        when 1
+          ms1.low; ms2.low
+        when 2
+          ms1.high; ms2.low
+        when 4
+          ms1.low; ms2.high
+        when 8
+          ms1.high; ms2.high
+        else
+          return
+        end
+        @divider = steps
+      end
+      attr_reader :divider
+
       def step_cc
-        direction.high
+        direction.high unless direction.high?
         step.high
         step.low
       end
 
       def step_cw
-        direction.low
+        direction.low unless direction.low?
         step.high
         step.low
       end

From f8802b6492bf7d2820916cc835787f783e08ba3a Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Tue, 9 Sep 2014 16:53:31 -0400
Subject: [PATCH 059/296] Add DigitalOutput#low?, high?, on?, off?

---
 lib/dino/components/basic/digital_output.rb | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/lib/dino/components/basic/digital_output.rb b/lib/dino/components/basic/digital_output.rb
index 13c88136..3a44e3f0 100644
--- a/lib/dino/components/basic/digital_output.rb
+++ b/lib/dino/components/basic/digital_output.rb
@@ -14,23 +14,31 @@ def after_initialize(options={})
         def digital_write(value)
           board.digital_write(pin, @state = value)
         end
-
         alias :write :digital_write
 
         def low
           digital_write(board.low)
         end
+        alias :off :low
+
+        def low?
+          state == board.low
+        end
+        alias :off? :low?
 
         def high
           digital_write(board.high)
         end
+        alias :on  :high
+
+        def high?
+          state == board.high
+        end
+        alias :on?  :high?
 
         def toggle
-          state == board.low ? high : low
+          board.low? ? high : low
         end
-
-        alias :off :low
-        alias :on  :high
       end
     end
   end

From 634846a1c8f78224657617f6ee8152e68b8ae7e3 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 29 Sep 2014 14:23:49 -0400
Subject: [PATCH 060/296] Call low? not board.low?

---
 lib/dino/components/basic/digital_output.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/components/basic/digital_output.rb b/lib/dino/components/basic/digital_output.rb
index 3a44e3f0..d34a702a 100644
--- a/lib/dino/components/basic/digital_output.rb
+++ b/lib/dino/components/basic/digital_output.rb
@@ -37,7 +37,7 @@ def high?
         alias :on?  :high?
 
         def toggle
-          board.low? ? high : low
+          low? ? high : low
         end
       end
     end

From dc38438bde68f2c61907ae050155cac76762e05a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 3 Jan 2015 19:53:15 -0400
Subject: [PATCH 061/296] Switched from serialport to rubyserial

---
 dino.gemspec             |  2 +-
 lib/dino/tx_rx/base.rb   | 46 +++++++++++++++++++++++-----------------
 lib/dino/tx_rx/serial.rb | 25 ++++++++++++----------
 lib/dino/tx_rx/tcp.rb    | 15 ++++++++++---
 4 files changed, 53 insertions(+), 35 deletions(-)

diff --git a/dino.gemspec b/dino.gemspec
index 1be2b618..96d54cb8 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -16,7 +16,7 @@ Gem::Specification.new do |gem|
   gem.version       = Dino::VERSION
   gem.executables   = ["dino"]
 
-  gem.add_dependency 'serialport'
+  gem.add_dependency 'rubyserial'
   gem.add_dependency 'trollop'
 
   gem.add_development_dependency 'rake'
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 9401b47a..abf2b4cb 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -6,6 +6,10 @@ module TxRx
     class Base
       include Observable
 
+      def io
+        @io ||= connect
+      end
+
       def read
         @thread ||= Thread.new do
           loop do
@@ -24,35 +28,37 @@ def close_read
         @thread = nil
       end
 
-      def write(message)
-        loop do
-          if IO.select(nil, [io], nil)
-            io.syswrite(message)
-            break
-          end
-        end
-      end
-
       def handshake
         flush_read
         10.times do
-          write Dino::Message.encode(command: 90)
-          line = gets(1)
-          if line && line.match(/ACK:/)
-            flush_read
-            return line.chop.split(/:/)[1]
+          begin
+            Timeout.timeout(1) do
+              write Dino::Message.encode(command: 90)
+              loop do
+                line = gets
+                if line && line.match(/ACK:/)
+                  flush_read
+                  return line.chop.split(/:/)[1]
+                end
+              end
+            end
+          rescue Timeout::Error
+            puts "Could not find board. Retrying..."
           end
         end
-       raise BoardNotFound
+        raise BoardNotFound
       end
 
+      def write(message); raise "#write should be defined in TxRX subclasses"; end
+
+    private
+
+      def connect(message); raise "#connect should be defined in TxRX subclasses"; end
+      def gets(message); raise "#gets should be defined in TxRX subclasses"; end
+
       def flush_read
         gets until gets == nil
       end
-
-      def gets(timeout=0.005)
-        IO.select([io], nil, nil, timeout) && io.gets
-      end
     end
   end
-end
\ No newline at end of file
+end
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index f1e2b4a9..3630fd1e 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -1,4 +1,4 @@
-require 'serialport'
+require 'rubyserial'
 
 module Dino
   module TxRx
@@ -11,20 +11,14 @@ def initialize(options={})
         @first_write = true
       end
 
-      def io
-        @io ||= connect
+      def write(message)
+        io.write(message)
       end
 
-      def handshake
-        io
-        sleep 3 if on_windows?
-        super
-      end
-
-      private
+    private
 
       def connect
-        tty_devices.each { |device| return SerialPort.new(device, @baud) rescue nil }
+        tty_devices.each { |device| return ::Serial.new(device, @baud) rescue nil }
         raise BoardNotFound
       end
 
@@ -37,6 +31,15 @@ def tty_devices
       def on_windows?
         RUBY_PLATFORM.match /mswin|mingw/i
       end
+
+      def gets(timeout=0)
+        buff = io.read(1)
+        return nil if buff.empty?
+        loop do
+          buff << io.read(1)
+          return buff if buff[-1] == "\n"
+        end
+      end
     end
   end
 end
diff --git a/lib/dino/tx_rx/tcp.rb b/lib/dino/tx_rx/tcp.rb
index f8e0b3d7..c8783135 100644
--- a/lib/dino/tx_rx/tcp.rb
+++ b/lib/dino/tx_rx/tcp.rb
@@ -7,10 +7,15 @@ def initialize(host, port=3466)
         @host, @port = host, port
       end
 
-      def io
-        @io ||= connect
+      def write(message)
+        loop do
+          if IO.select(nil, [io], nil)
+            io.syswrite(message)
+            break
+          end
+        end
       end
-
+    
     private
 
       def connect
@@ -18,6 +23,10 @@ def connect
       rescue
         raise BoardNotFound
       end
+
+      def gets(timeout=0.005)
+        IO.select([io], nil, nil, timeout) && io.gets
+      end
     end
   end
 end

From f6caf610332a0a581ee1a912868d797862545e3e Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 5 Jan 2015 09:33:14 -0400
Subject: [PATCH 062/296] Fix tests for rubyserial

---
 spec/lib/tx_rx/serial_spec.rb | 27 +++++++++++----------------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index d9a8a13c..e52f36d6 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -24,9 +24,9 @@ module Dino
           subject.should_receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
 
           # COM2 is chosen as available for this test.
-          SerialPort.should_receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise
-          SerialPort.should_receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = mock)
-          SerialPort.should_not_receive(:new).with("COM3", TxRx::Serial::BAUD)
+          ::Serial.should_receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise
+          ::Serial.should_receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = mock)
+          ::Serial.should_not_receive(:new).with("COM3", TxRx::Serial::BAUD)
 
           subject.io.should == mock_serial
           Constants.redefine(:RUBY_PLATFORM, original_platform, :on => Object)
@@ -38,8 +38,8 @@ module Dino
           subject.should_receive(:tty_devices).and_return(['/dev/ttyACM0', '/dev/tty.usbmodem1'])
 
           # /dev/ttyACM0 is chosen as available for this test.
-          SerialPort.should_receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial = mock)
-          SerialPort.should_not_receive(:new).with('/dev/tty.usbmodem1', TxRx::Serial::BAUD)
+          ::Serial.should_receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial = mock)
+          ::Serial.should_not_receive(:new).with('/dev/tty.usbmodem1', TxRx::Serial::BAUD)
 
           subject.io.should == mock_serial
         end
@@ -47,7 +47,7 @@ module Dino
 
       it 'should connect to the specified device at the specified baud rate' do
         subject.should_receive(:tty_devices).and_return(["/dev/ttyACM0"])
-        SerialPort.should_receive(:new).with('/dev/ttyACM0', 9600).and_return(mock_serial = mock)
+        ::Serial.should_receive(:new).with('/dev/ttyACM0', 9600).and_return(mock_serial = mock)
 
         subject.instance_variable_set(:@device, "/dev/ttyACM0")
         subject.instance_variable_set(:@baud, 9600)
@@ -57,14 +57,14 @@ module Dino
 
       it 'should use the existing io instance if set' do
         subject.should_receive(:tty_devices).once.and_return(['/dev/tty.ACM0', '/dev/tty.usbmodem1'])
-        SerialPort.stub(:new).and_return(mock_serial = mock)
+        ::Serial.stub(:new).and_return(mock_serial = mock)
 
         3.times { subject.io }
         subject.io.should == mock_serial
       end
 
       it 'should raise a BoardNotFound exception if there is no board connected' do
-        SerialPort.stub(:new).and_raise
+        ::Serial.stub(:new).and_raise
         expect { subject.io }.to raise_exception BoardNotFound
       end
     end
@@ -75,13 +75,10 @@ module Dino
         subject.read
       end
 
-      it 'should get messages from the device' do
-        subject.stub(:io).and_return(mock_serial = mock)
-
-        IO.should_receive(:select).and_return(true)
+      it 'should start a loop and notify observers on changes' do
         Thread.should_receive(:new).and_yield
         subject.should_receive(:loop).and_yield
-        mock_serial.should_receive(:gets).and_return("02:00\n")
+        subject.should_receive(:gets).and_return("02:00\n")
         subject.should_receive(:changed).and_return(true)
         subject.should_receive(:notify_observers).with('02','00')
 
@@ -100,10 +97,8 @@ module Dino
 
     describe '#write' do
       it 'should write to the device' do
-        IO.should_receive(:select).and_return(true)
-
         subject.stub(:io).and_return(mock_serial = mock)
-        mock_serial.should_receive(:syswrite).with('a message')
+        mock_serial.should_receive(:write).with('a message')
         subject.write('a message')
       end
     end

From c810478af2004ff484634c26d0a3dd28a09a89bf Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Mon, 5 Jan 2015 09:43:03 -0400
Subject: [PATCH 063/296] Change mock to double for rspec

---
 spec/lib/board_spec.rb                          | 14 +++++++-------
 spec/lib/components/basic/digital_input_spec.rb |  8 ++++----
 spec/lib/tx_rx/serial_spec.rb                   | 12 ++++++------
 spec/spec_helper.rb                             |  4 ++--
 4 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 3b99785f..5d9262f7 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -3,7 +3,7 @@
 module Dino
   describe Dino::Board do
     def io_mock(methods = {})
-      @io ||= mock(:io, {add_observer: true, handshake: 14, write: true, read: true, write: nil}.merge(methods))
+      @io ||= double(:io, {add_observer: true, handshake: 14, write: true, read: true, write: nil}.merge(methods))
     end
 
     subject { Board.new(io_mock) }
@@ -37,9 +37,9 @@ def io_mock(methods = {})
     describe '#update' do
       context 'when a component is connected to the pin' do
         it 'should call update with the message on the component' do
-          part = mock(:part, pin: 7, pullup: nil)
+          part = double(:part, pin: 7, pullup: nil)
           subject.add_component(part)
-          other_part = mock(:part, pin: 9, pullup: nil)
+          other_part = double(:part, pin: 9, pullup: nil)
           subject.add_component(other_part)
 
           part.should_receive(:update).with('wake up!')
@@ -58,20 +58,20 @@ def io_mock(methods = {})
 
     describe '#add_component' do
       it 'should add the component to the board' do
-        subject.add_component(mock1 = mock(:part1, pin: 12, pullup: nil))
-        subject.add_component(mock2 = mock(:part2, pin: 14, pullup: nil))
+        subject.add_component(mock1 = double(:part1, pin: 12, pullup: nil))
+        subject.add_component(mock2 = double(:part2, pin: 14, pullup: nil))
         subject.components.should =~ [mock1, mock2]
       end
     end
 
     describe '#remove_component' do
       it 'should remove the given part from the hardware of the board and stop listening' do
-        mock = mock(:part1, pin: 12, pullup: nil)
+        mock = double(:part1, pin: 12, pullup: nil)
         subject.add_component(mock)
 
         subject.should_receive(:stop_listener).with(12)
         subject.remove_component(mock)
-        
+
         subject.components.should == []
       end
     end
diff --git a/spec/lib/components/basic/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
index ef715cd9..a96d5422 100644
--- a/spec/lib/components/basic/digital_input_spec.rb
+++ b/spec/lib/components/basic/digital_input_spec.rb
@@ -34,8 +34,8 @@ module Basic
 
         context 'callbacks' do
           before :each do
-            @low_callback = mock
-            @high_callback = mock
+            @low_callback = double
+            @high_callback = double
             subject.on_low { @low_callback.called }
             subject.on_high { @high_callback.called }
           end
@@ -46,7 +46,7 @@ module Basic
               @high_callback.should_not_receive(:called)
 
               subject.update(DigitalInput::LOW)
-            end 
+            end
           end
 
           describe '#on_high' do
@@ -55,7 +55,7 @@ module Basic
               @high_callback.should_receive(:called)
 
               subject.update(DigitalInput::HIGH)
-            end 
+            end
           end
         end
       end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index e52f36d6..f03c46b1 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -25,7 +25,7 @@ module Dino
 
           # COM2 is chosen as available for this test.
           ::Serial.should_receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise
-          ::Serial.should_receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = mock)
+          ::Serial.should_receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = double)
           ::Serial.should_not_receive(:new).with("COM3", TxRx::Serial::BAUD)
 
           subject.io.should == mock_serial
@@ -38,7 +38,7 @@ module Dino
           subject.should_receive(:tty_devices).and_return(['/dev/ttyACM0', '/dev/tty.usbmodem1'])
 
           # /dev/ttyACM0 is chosen as available for this test.
-          ::Serial.should_receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial = mock)
+          ::Serial.should_receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial = double)
           ::Serial.should_not_receive(:new).with('/dev/tty.usbmodem1', TxRx::Serial::BAUD)
 
           subject.io.should == mock_serial
@@ -47,7 +47,7 @@ module Dino
 
       it 'should connect to the specified device at the specified baud rate' do
         subject.should_receive(:tty_devices).and_return(["/dev/ttyACM0"])
-        ::Serial.should_receive(:new).with('/dev/ttyACM0', 9600).and_return(mock_serial = mock)
+        ::Serial.should_receive(:new).with('/dev/ttyACM0', 9600).and_return(mock_serial = double)
 
         subject.instance_variable_set(:@device, "/dev/ttyACM0")
         subject.instance_variable_set(:@baud, 9600)
@@ -57,7 +57,7 @@ module Dino
 
       it 'should use the existing io instance if set' do
         subject.should_receive(:tty_devices).once.and_return(['/dev/tty.ACM0', '/dev/tty.usbmodem1'])
-        ::Serial.stub(:new).and_return(mock_serial = mock)
+        ::Serial.stub(:new).and_return(mock_serial = double)
 
         3.times { subject.io }
         subject.io.should == mock_serial
@@ -88,7 +88,7 @@ module Dino
 
     describe '#close_read' do
       it 'should kill the reading thread' do
-        subject.instance_variable_set(:@thread, mock_thread = mock)
+        subject.instance_variable_set(:@thread, mock_thread = double)
         Thread.should_receive(:kill).with(mock_thread)
         subject.read
         subject.close_read
@@ -97,7 +97,7 @@ module Dino
 
     describe '#write' do
       it 'should write to the device' do
-        subject.stub(:io).and_return(mock_serial = mock)
+        subject.stub(:io).and_return(mock_serial = double)
         mock_serial.should_receive(:write).with('a message')
         subject.write('a message')
       end
diff --git a/spec/spec_helper.rb b/spec/spec_helper.rb
index 48219c57..281f2af1 100644
--- a/spec/spec_helper.rb
+++ b/spec/spec_helper.rb
@@ -13,8 +13,8 @@ def self.redefine(const, value, opts={})
 
 module BoardMock
   def self.included(base)
-    base.class_eval do 
-      let(:txrx)  { mock(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+    base.class_eval do
+      let(:txrx)  { double(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
       let(:board) { Dino::Board.new(txrx) }
     end
   end

From 4f8a52270167e8631ed06cd3ce353964835af937 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 00:42:44 -0400
Subject: [PATCH 064/296] Remove upload/compile. Too much scope. Use shell
 scripts instead.

---
 lib/dino_cli.rb           | 19 +++++---------
 lib/dino_cli/generator.rb |  2 +-
 lib/dino_cli/helper.rb    | 54 +++++++++++++++++++--------------------
 lib/dino_cli/parser.rb    | 32 +++++++++++------------
 lib/dino_cli/uploader.rb  | 37 ---------------------------
 5 files changed, 49 insertions(+), 95 deletions(-)
 delete mode 100644 lib/dino_cli/uploader.rb

diff --git a/lib/dino_cli.rb b/lib/dino_cli.rb
index bffe309e..30d7a37c 100644
--- a/lib/dino_cli.rb
+++ b/lib/dino_cli.rb
@@ -1,25 +1,18 @@
 module DinoCLI
   require "dino_cli/parser"
   require "dino_cli/generator"
-  require "dino_cli/uploader"
 
-  COMMANDS = ["generate-sketch"]
+  TASKS    = ["sketch"]
   SKETCHES = ["serial", "ethernet", "wifi"]
-  
-  def self.start(options={})
-    parsed_options = DinoCLI::Parser.run(options)
 
-    method = parsed_options[:command].gsub('-', '_').to_s
+  def self.start(options={})
+    options = DinoCLI::Parser.run(options)
+    method = options[:task]
     self.send method, options
   end
 
-  def self.generate_sketch(options)
+  def self.sketch(options)
     options = DinoCLI::Generator.run!(options)
-    
-    if options[:upload] || options[:compile]
-      DinoCLI::Uploader.run!(options)
-    else
-      $stdout.puts options[:sketch_file]
-    end
+    $stdout.puts options[:sketch_file]
   end
 end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 89d71a63..b5a234fc 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,6 +1,6 @@
 class DinoCLI::Generator
   require "fileutils"
-  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h", "OneWire.h", "OneWire.cpp"]
+  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h"]
   attr_accessor :options
 
   def initialize(options={})
diff --git a/lib/dino_cli/helper.rb b/lib/dino_cli/helper.rb
index fece1920..2d30a1b2 100644
--- a/lib/dino_cli/helper.rb
+++ b/lib/dino_cli/helper.rb
@@ -8,34 +8,32 @@ def error(message)
 
   def usage
     $stderr.puts "Usage:"
-    $stderr.puts "  dino COMMAND [command-specific-options]"
-    $stderr.puts
-    $stderr.puts "Commands:"
-    $stderr.puts "  generate-sketch SKETCH [options]"
-    $stderr.puts
-    $stderr.puts "    Available sketches and options:"
-    $stderr.puts
-    $stderr.puts "      serial"
-    $stderr.puts "        --baud BAUD"
-    $stderr.puts "        --debug"
-    $stderr.puts "        --upload"
-    $stderr.puts
-    $stderr.puts "      ethernet"
-    $stderr.puts "        --mac XX:XX:XX:XX:XX:XX"
-    $stderr.puts "        --ip XXX.XXX.XXX.XXX"
-    $stderr.puts "        --port PORT"
-    $stderr.puts "        --debug"
-    $stderr.puts "        --upload"
-    $stderr.puts
-    $stderr.puts "      wifi"
-    $stderr.puts "        --ssid SSID"
-    $stderr.puts "        --password PASSWORD"
-    $stderr.puts "        --port PORT"
-    $stderr.puts "        --debug"
-    $stderr.puts "        --upload"
-    $stderr.puts
-    $stderr.puts "Note: Automatic upload requires Arduino IDE 1.5 or greater."
-    $stderr.puts "      Set your board type and serialport in the IDE first."
+    $stderr.puts "  dino task [options]"
+    $stderr.puts
+    $stderr.puts "Tasks:"
+    $stderr.puts "  sketch SKETCH [options]"
+    $stderr.puts
+    $stderr.puts "Available sketches and options for each sketch:"
+    $stderr.puts
+    $stderr.puts "  serial"
+    $stderr.puts "    -baud BAUD"
+    $stderr.puts "    -debug"
+    $stderr.puts
+    $stderr.puts "  ethernet"
+    $stderr.puts "    -mac XX:XX:XX:XX:XX:XX"
+    $stderr.puts "    -ip XXX.XXX.XXX.XXX"
+    $stderr.puts "    -port PORT"
+    $stderr.puts "    -debug"
+    $stderr.puts
+    $stderr.puts "  wifi"
+    $stderr.puts "    -ssid SSID"
+    $stderr.puts "    -password PASSWORD"
+    $stderr.puts "    -port PORT"
+    $stderr.puts "    -debug"
+    $stderr.puts
+    $stderr.puts "Example:"
+    $stderr.puts
+    $stderr.puts "  dino sketch serial -baud 9600"
     $stderr.puts
     exit(2)
   end
diff --git a/lib/dino_cli/parser.rb b/lib/dino_cli/parser.rb
index 87c76236..7e9217c9 100644
--- a/lib/dino_cli/parser.rb
+++ b/lib/dino_cli/parser.rb
@@ -11,12 +11,16 @@ def self.run(options={})
   end
 
   def parse
+    # Ensure we have arguments.
     args = @options[:args].dup
+    error("No arguments given") if args.empty?
 
-    # Command must be the first arg.
-    @options[:command] = args.shift
-    usage if @options[:command].match /help|usage/
-    error "Invalid command '#{@options[:command]}'"  unless DinoCLI::COMMANDS.include? @options[:command]
+    # Ensure task is the first argument
+    @options[:task] = args.shift
+    usage if @options[:task].match /help|usage/
+
+    # Ensure there's only one task
+    error "Invalid task '#{@options[:task]}'" unless DinoCLI::TASKS.include? @options[:task]
 
     # Parse the rest loosely.
     loop do
@@ -27,26 +31,22 @@ def parse
           args.shift; set_sketch("ethernet")
         when 'wifi'
           args.shift; set_sketch("wifi")
-        when '--baud'
+        when '-baud'
           args.shift; @options[:baud] = args.shift
-        when '--mac'
+        when '-mac'
           args.shift; @options[:mac] = args.shift
-        when '--ip'
+        when '-ip'
           args.shift; @options[:ip] = args.shift
-        when '--ssid'
+        when '-ssid'
           args.shift; @options[:ssid] = args.shift
-        when '--password'
+        when '-password'
           args.shift; @options[:password] = args.shift
-        when '--port'
+        when '-port'
           args.shift; @options[:port] = args.shift
-        when '--debug'
+        when '-debug'
           args.shift; @options[:debug] = true
-        when '--compile'
-          args.shift; @options[:compile] = true
-        when '--upload'
-          args.shift; @options[:upload] = true
         when /^-/
-          error "Invalid argument '#{ARGV[0]}'"
+          error "Invalid argument '#{args[0]}'"
         else break
       end
     end
diff --git a/lib/dino_cli/uploader.rb b/lib/dino_cli/uploader.rb
deleted file mode 100644
index 44ce1a16..00000000
--- a/lib/dino_cli/uploader.rb
+++ /dev/null
@@ -1,37 +0,0 @@
-class DinoCLI::Uploader
-  require "pathname"
-  require "fileutils"
-  attr_reader :options
-
-  def initialize(options={})
-    @options = options
-  end
-
-  def self.run!(options={})
-    instance = self.new(options)
-
-    if options[:upload]
-      instance.upload
-    elsif options[:compile]
-      instance.compile
-    end
-  end
-
-  def compile
-    output = `#{executable} --verify --verbose '#{options[:sketch_file]}'`
-
-    tmp_hex_file = output.match(/elf.*.hex/)[0].gsub("elf", "").lstrip
-    FileUtils::copy(tmp_hex_file, options[:output_dir])
-
-    hex_file = File.join(options[:output_dir], Pathname.new(tmp_hex_file).basename)
-    $stdout.puts hex_file
-  end
-
-  def upload
-    `#{executable} --upload '#{options[:sketch_file]}'`
-  end
-
-  def executable
-    return "/Applications/Arduino.app/Contents/MacOS/JavaApplicationStub" if RUBY_PLATFORM.match(/darwin/i)
-  end
-end

From 0dce1e110e111c0fcd241dece8a3ceda81b22f4b Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 11:08:49 -0400
Subject: [PATCH 065/296] Update the readme for new command line options

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 588dcfe3..60b988a0 100644
--- a/README.md
+++ b/README.md
@@ -25,10 +25,10 @@ Use the included command line tool to create a folder with the Arduino sketch yo
 
 ```shell
 # If connecting via serial, USB or ser2net, this is all you should need:
-dino generate-sketch serial
+dino sketch serial
 
 # If usng the ethernet shield, you'll want to specify unique MAC and IP addresses:
-dino generate-sketch ethernet --mac XX:XX:XX:XX:XX:XX --ip XXX.XXX.XXX.XXX
+dino sketch ethernet -mac XX:XX:XX:XX:XX:XX -ip XXX.XXX.XXX.XXX
 
 # For more options:
 dino help
@@ -38,7 +38,7 @@ __Note:__ Current Ethernet shields come with a sticker indicating the MAC addres
 
 #### Upload The Bootstrapper
 
-* Connect the Arduino to a USB port on your machine, regardless of which sketch you're using.
+* Connect the Arduino to a USB port on your machine, (even if using the ethernet sketch).
 * Open [the normal Arduino IDE](http://arduino.cc/en/Main/Software)
 * Open the `.ino` file in the sketch folder you just generated.
 * Click the upload button (an arrow).

From cc70a4d922baaeebd25a7a232204f542eea8a4c0 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 11:09:41 -0400
Subject: [PATCH 066/296] Notify when the board is connected

---
 lib/dino/tx_rx/base.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index abf2b4cb..5419fd70 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -37,6 +37,7 @@ def handshake
               loop do
                 line = gets
                 if line && line.match(/ACK:/)
+                  puts "Connected to board..."
                   flush_read
                   return line.chop.split(/:/)[1]
                 end

From e257d569c733a73eaa258f08dfc3d419d35bafad Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 11:11:01 -0400
Subject: [PATCH 067/296] Use a mutex when modifying callbacks to avoid
 modifying hash while it's being enumerated

---
 lib/dino/components/mixins/callbacks.rb | 31 ++++++++++++++-----------
 1 file changed, 18 insertions(+), 13 deletions(-)

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index dd1006d1..424a7bb9 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -2,30 +2,35 @@ module Dino
   module Components
     module Mixins
       module Callbacks
-        def callbacks
-          @callbacks ||= {}
+        def initialize
+          @callbacks = {}
+          @callback_mutex = Mutex.new
         end
 
         def add_callback(key=:persistent, &block)
-          callbacks
-          @callbacks[key] ||= []
-          @callbacks[key] << block
+          @callback_mutex.synchronize {
+            @callbacks[key] ||= []
+            @callbacks[key] << block
+          }
         end
-        
+
         def remove_callback(key=nil)
-          callbacks
-          key ? @callbacks[key] = [] : @callbacks = {}
+          @callback_mutex.synchronize {
+            key ? @new_callbacks[key] = [] : @new_callbacks = {}
+          }
         end
 
         alias :on_data :add_callback
         alias :remove_callbacks :remove_callback
 
         def update(data)
-          @state = data
-          callbacks.each_value do |array|
-            array.each { |callback| callback.call(@state) }
-          end
-          remove_callback :read
+          @callback_mutex.synchronize {
+            @state = data
+            callbacks.each_value do |array|
+              array.each { |callback| callback.call(@state) }
+            end
+            remove_callback :read
+          }
         end
       end
     end

From 4bb18092d9735086313c92b186f7bc9e24fe4131 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 11:12:58 -0400
Subject: [PATCH 068/296] Forgot to call super in initialize

---
 lib/dino/components/mixins/callbacks.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 424a7bb9..46527bef 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -3,6 +3,7 @@ module Components
     module Mixins
       module Callbacks
         def initialize
+          super
           @callbacks = {}
           @callback_mutex = Mutex.new
         end

From 8c5724c031606653f8fa68b8173709c03c3c349c Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 11:23:01 -0400
Subject: [PATCH 069/296] Use after_initalize instead

---
 lib/dino/components/mixins/callbacks.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 46527bef..5129f132 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -2,7 +2,7 @@ module Dino
   module Components
     module Mixins
       module Callbacks
-        def initialize
+        def after_initialize(options={})
           super
           @callbacks = {}
           @callback_mutex = Mutex.new

From 7fcf387132dbda80f7ae34d203e71cb113da7e9e Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 11:37:13 -0400
Subject: [PATCH 070/296] Fix error leftover from cloning callbacks

---
 lib/dino/components/mixins/callbacks.rb | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 5129f132..16da6723 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -17,7 +17,7 @@ def add_callback(key=:persistent, &block)
 
         def remove_callback(key=nil)
           @callback_mutex.synchronize {
-            key ? @new_callbacks[key] = [] : @new_callbacks = {}
+            key ? @callbacks[key] = [] : @callbacks = {}
           }
         end
 
@@ -25,13 +25,13 @@ def remove_callback(key=nil)
         alias :remove_callbacks :remove_callback
 
         def update(data)
+          @state = data
           @callback_mutex.synchronize {
-            @state = data
-            callbacks.each_value do |array|
+            @callbacks.each_value do |array|
               array.each { |callback| callback.call(@state) }
             end
-            remove_callback :read
           }
+          remove_callback :read
         end
       end
     end

From 55b4385ed10829b7e42b9418006782dc33c85983 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 18:29:58 -0400
Subject: [PATCH 071/296] Include a C library for the Due to compile

---
 src/lib/Dino.cpp | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 404c05ea..24d27699 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -4,13 +4,17 @@
 
 #include "Arduino.h"
 #include "Dino.h"
+#if defined(__SAM3X8E__)
+  #include <avr/dtostrf.h>
+#endif
+
 DinoLCD dinoLCD;
 DHT dht;
+
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
   DinoSerial dinoSerial;
-#endif  
-
+#endif
 
 Dino::Dino(){
   messageFragments[0] = cmdStr;
@@ -94,10 +98,10 @@ void Dino::process() {
     case 98: setHeartRate        ();  break;
     default:                          break;
   }
-  
+
   // Write the response.
   if (response[0] != '\0') writeResponse();
-  
+
   #ifdef debug
    Serial.print("Responded with - "); Serial.println(response);
    Serial.println();
@@ -132,7 +136,7 @@ void Dino::updateDigitalListeners() {
       if (rval != digitalListenerValues[i]) {
         digitalListenerValues[i] = rval;
         writeResponse();
-      } 
+      }
     }
   }
 }
@@ -187,7 +191,7 @@ void Dino::dWrite() {
 }
 
 // CMD = 02 // Digital Read
-void Dino::dRead() { 
+void Dino::dRead() {
   rval = digitalRead(pin);
   sprintf(response, "%02d:%02d", pin, rval);
 }
@@ -327,7 +331,7 @@ void Dino::ds18Read() {
 
   byte data[12];
   byte addr[8];
-  
+
   if ( !ds.search(addr)) {
     ds.reset_search();
     return;
@@ -348,15 +352,15 @@ void Dino::ds18Read() {
   ds.write(0x44,1); // start conversion, with parasite power on at the end
 
   byte present = ds.reset();
-  ds.select(addr);  
+  ds.select(addr);
   ds.write(0xBE); // Read Scratchpad
 
   for (int i = 0; i < 9; i++) { // we need 9 bytes
     data[i] = ds.read();
   }
- 
+
   ds.reset_search();
- 
+
   byte MSB = data[1];
   byte LSB = data[0];
 
@@ -419,4 +423,3 @@ void Dino::setHeartRate() {
     Serial.print("Heart rate set to "); Serial.print(heartRate); Serial.println(" microseconds");
   #endif
 }
-

From a0d923ce8d6b121d6de5caada2b25848aced4c2c Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Sat, 7 Feb 2015 21:54:50 -0400
Subject: [PATCH 072/296] Better behavior when using a shift register as a
 board proxy

---
 examples/load.rb                              | 93 -------------------
 examples/shift_register/shift_register.rb     | 17 ++++
 .../shift_register_ssd.rb}                    | 13 +--
 lib/dino/components/mixins.rb                 |  3 +-
 lib/dino/components/mixins/board_proxy.rb     | 31 +++++++
 lib/dino/components/shift_register.rb         | 71 +++++++-------
 6 files changed, 91 insertions(+), 137 deletions(-)
 delete mode 100644 examples/load.rb
 create mode 100644 examples/shift_register/shift_register.rb
 rename examples/{shift_register.rb => shift_register/shift_register_ssd.rb} (62%)
 create mode 100644 lib/dino/components/mixins/board_proxy.rb

diff --git a/examples/load.rb b/examples/load.rb
deleted file mode 100644
index e70cb96e..00000000
--- a/examples/load.rb
+++ /dev/null
@@ -1,93 +0,0 @@
-#c
-# This is a simple example to blink an led
-# every half a second
-#
-
-require File.expand_path('../../lib/dino', __FILE__)
-# txrx = Dino::TxRx.new
-# txrx = Dino::TxRx::TCP.new("192.168.0.77")
-# txrx = Dino::TxRx::TCP.new("192.168.0.143", 3001) # ; txrx.io; sleep 5
-# board = Dino::Board.new(txrx)
-
-# txrx.write("!9800010.")
-
-
-
-board = Dino::Board.new(Dino::TxRx::Serial.new) #(device: "/dev/tty.usbserial-A9015AK7"))
-servo = Dino::Components::Servo.new(pin: 9, board: board)
-led = Dino::Components::Led.new(pin: '13', board: board)
-
-# board.heart_rate = 10
-# board.analog_divider = 8
-
-counter_analog = 0
-counter_digital = 0
-test_time = 2
-
-analog_count = 5
-digital_count = 6
-
-# led.pulse(0, 128)
-
-# Setup hardware
-(0..5).each do |pin|
-  eval "$sensor#{pin} = Dino::Components::Sensor.new(pin: 'A#{pin}', board: board)"
-  eval "$sensor#{pin}.when_data_received { counter_analog = counter_analog + 1 }"
-end
-(5..9).each do |pin|
-  eval "$digital#{pin} = Dino::Components::Button.new(pin: '#{pin}', board: board, pullup: true)"
-  eval "$digital#{pin}.up   { counter_digital = counter_digital + 1 }"
-  eval "$digital#{pin}.down { counter_digital = counter_digital + 1 }"
-end
-
-
-
-
-puts "Starting test..."
-start_time = Time.now
-
-loop do
-
-  40.times do
-    led.off
-    led.on
-  end
-
-  # [0, 90].each do |pos|
-  #   servo.position = pos
-  # end
-
-  # Pre-test measurement
-  state1_digital = counter_digital
-  state1_analog = counter_analog
-
-  # Wait
-  sleep test_time
-
-  # Post-test measurement
-  state2_digital = counter_digital
-  state2_analog = counter_analog
-
-  # Calculation
-  diff_digital = state2_digital - state1_digital
-  diff_analog = state2_analog - state1_analog
-
-  # Print
-  print "#{digital_count -1}D/#{analog_count + 1}A Components: "
-  print  "#{diff_digital/(test_time * (digital_count - 1))}Hz"
-  print "/"
-  print  "#{diff_analog/(test_time * (analog_count + 1))}Hz per component | "
-  puts  "#{(diff_digital + diff_analog)/(test_time)} responses/s overall"
-
-  print "Elapsed time: "
-  puts Time.now - start_time
-
-end
-
-# Remove hardware
-(0..5).each do |pin|
-  board.remove_analog_hardware(eval "$sensor#{pin}")
-end
-(5..10).each do |pin|
-  board.remove_digital_hardware(eval "$digital#{pin}")
-end
diff --git a/examples/shift_register/shift_register.rb b/examples/shift_register/shift_register.rb
new file mode 100644
index 00000000..fe5945b6
--- /dev/null
+++ b/examples/shift_register/shift_register.rb
@@ -0,0 +1,17 @@
+#
+# This is a simple example to write to a shift register.
+# Writing a byte of 255 sets all the output pins to high.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+shift_register = Dino::Components::ShiftRegister.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+
+# Write a single byte
+shift_register.write(255)
+
+# Write an array of bytes (for multiple registers).
+shift_register.write([255, 0])
+
+sleep
diff --git a/examples/shift_register.rb b/examples/shift_register/shift_register_ssd.rb
similarity index 62%
rename from examples/shift_register.rb
rename to examples/shift_register/shift_register_ssd.rb
index ab916143..7af26409 100644
--- a/examples/shift_register.rb
+++ b/examples/shift_register/shift_register_ssd.rb
@@ -1,6 +1,7 @@
 #
-# This is a simple example to write to a shift register.
-# Writing a byte of 255 sets all the output pins to high.
+# This examples sets up a shift register, and an SSD that is connected to its 8 output pins.
+# The shift register is passed in as the 'board' when setting up the SSD.
+# The individual pins on the register are accessible by the SSD instance, so it works as usual.
 #
 require 'bundler/setup'
 require 'dino'
@@ -18,11 +19,3 @@
 
 # Display each new line on the ssd
 loop { ssd.display(gets.chomp) }
-
-# Write a single byte
-# shift_register.write_byte(255)
-
-# Write an array of bytes (for multiple registers).
-# shift_register.write_bytes([255, 0])
-
-# sleep
diff --git a/lib/dino/components/mixins.rb b/lib/dino/components/mixins.rb
index f889b4e0..6e8afe56 100644
--- a/lib/dino/components/mixins.rb
+++ b/lib/dino/components/mixins.rb
@@ -6,6 +6,7 @@ module Mixins
       require 'dino/components/mixins/reader'
       require 'dino/components/mixins/poller'
       require 'dino/components/mixins/listener'
+      require 'dino/components/mixins/board_proxy'
     end
   end
-end
\ No newline at end of file
+end
diff --git a/lib/dino/components/mixins/board_proxy.rb b/lib/dino/components/mixins/board_proxy.rb
new file mode 100644
index 00000000..30f7f6b8
--- /dev/null
+++ b/lib/dino/components/mixins/board_proxy.rb
@@ -0,0 +1,31 @@
+module Dino
+  module Components
+    module Mixins
+      module BoardProxy
+        def after_initialize(options={})
+          @high = 1
+          @low = 0
+          @components = []
+        end
+
+        attr_reader :high, :low, :components
+
+        def add_component(component)
+          @components << component
+        end
+
+        def remove_component(component)
+          @components.delete(component)
+        end
+
+        def convert_pin(pin)
+          pin = pin.to_i
+        end
+
+        def set_pin_mode(pin, mode)
+          nil
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index 9eb6ccd1..a0b18d13 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -4,61 +4,66 @@ class ShiftRegister
       #
       # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
       #
-      include Setup::MultiPin      
+      include Setup::MultiPin
       proxy_pins  clock: Basic::DigitalOutput,
                   latch: Basic::DigitalOutput,
                   data:  Basic::DigitalOutput
-      
-      attr_reader :high, :low, :components
 
       def after_initialize(options={})
-        @high = 1
-        @low = 0
-        @components = []
-
-        @state = [0,0,0,0,0,0,0,0]
+        @bytes = options[:bytes] || 1
+        @state = Array.new(@bytes*8) {|i| 0}
         write_state
+        super
       end
 
-      def add_component(component)
-        @components << component
+      def write_state
+        bytes = []
+        @state.each_slice(8) do |slice|
+          bytes << slice.join("").reverse.to_i(2)
+        end
+        write_bytes(bytes)
       end
 
-      def remove_component(component)
-        @components.delete(component)
+      def write_bytes(bytes)
+        latch.low
+        bytes.each do |byte|
+          board.write Dino::Message.encode(command: 11, pin: data.pin, value: byte, aux_message: clock.pin)
+        end
+        latch.high
       end
 
-      def convert_pin(pin)
-        pin = pin.to_i
-      end
+      alias :write_byte :write_bytes
 
-      def set_pin_mode(pin, mode)
-        nil
-      end
+      #
+      # Make the shift register behave like a board.
+      # We can use each output pin on it individually for digital out components.
+      # To set up component, use the register object as the 'board', and the corresponding pin numbers.
+      #
+      include Mixins::BoardProxy
+      include Mixins::Threaded
 
       def digital_write(pin, value)
+        @last_input = Time.now
         @state[pin] = value
-        write_state
+        start_write
       end
 
       alias :write :digital_write
 
-      def write_state
-        byte = @state.join("").reverse.to_i(2)
-        write_bytes(byte)
-      end
-
-      def write_bytes(bytes)
-        bytes = [bytes] unless bytes.class == Array
-
-        latch.low
-        bytes.each do |byte|
-          board.write Dino::Message.encode(command: 11, pin: data.pin, value: byte, aux_message: clock.pin)
+      #
+      # Wait until we have not had a digital_write for 1ms before writing to the board.
+      # Reduces the amount of wrting required for things like SSDs that change many bits in sequence.
+      #
+      def start_write
+        return if @thread
+        @last_output = Time.now
+        threaded_loop do
+          if ((Time.now - @last_input) > 0.001) && (@last_input > @last_output)
+            write_state
+            @last_output = Time.now
+          end
         end
-        latch.high
       end
-
-      alias :write_byte :write_bytes
     end
   end
 end

From 7fa7fcabf9964e92dc8c04b50d9b4f8961bfea99 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Fri, 20 Feb 2015 21:00:58 -0400
Subject: [PATCH 073/296] Test 2.0.0, 2.2.0 and jruby. Bare minimum work to get
 tests passing.

---
 .travis.yml                                   |  7 ++--
 lib/dino/components/shift_register.rb         |  9 +++--
 spec/lib/board_spec.rb                        | 13 ++++----
 .../components/basic/digital_input_spec.rb    | 33 ++++++++++---------
 spec/lib/components/setup/input_spec.rb       |  4 +--
 5 files changed, 34 insertions(+), 32 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 43351e51..96ba4de9 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,8 @@
 language: ruby
 rvm:
+  - 2.2.0
+  - 2.0.0
   - 1.9.3
-  - 1.9.2
-script: bundle exec rspec spec
\ No newline at end of file
+  - jruby-19mode
+
+script: bundle exec rspec spec
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index a0b18d13..7e09f105 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -24,20 +24,21 @@ def write_state
         write_bytes(bytes)
       end
 
-      def write_bytes(bytes)
+      def write_bytes(*bytes)
         latch.low
-        bytes.each do |byte|
+        bytes.flatten.each do |byte|
           board.write Dino::Message.encode(command: 11, pin: data.pin, value: byte, aux_message: clock.pin)
         end
         latch.high
       end
 
       alias :write_byte :write_bytes
+      alias :write :write_bytes
 
       #
       # Make the shift register behave like a board.
       # We can use each output pin on it individually for digital out components.
-      # To set up component, use the register object as the 'board', and the corresponding pin numbers.
+      # To instantiate a component, pass the register as a 'board' and the corresponding pin numbers on the register.
       #
       include Mixins::BoardProxy
       include Mixins::Threaded
@@ -48,8 +49,6 @@ def digital_write(pin, value)
         start_write
       end
 
-      alias :write :digital_write
-
       #
       # Wait until we have not had a digital_write for 1ms before writing to the board.
       # Reduces the amount of wrting required for things like SSDs that change many bits in sequence.
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 5d9262f7..2c9d161f 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -16,7 +16,7 @@ def io_mock(methods = {})
       end
 
       it 'should observe the io' do
-        io_mock.should_receive(:add_observer).with(subject)
+        expect(io_mock).to receive(:add_observer).with(subject)
         subject.send(:initialize, io_mock)
       end
 
@@ -26,11 +26,10 @@ def io_mock(methods = {})
       end
 
       it 'should define the logic properly' do
-        subject.should_receive(:analog_resolution=).with(8)
-
+        expect(subject).to receive(:analog_resolution=).with(8)
         subject.send(:initialize, io_mock)
-        subject.high.should == 255
-        subject.low.should == 0
+        expect(subject.high).to equal(255)
+        expect(subject.low).to equal(0)
       end
     end
 
@@ -164,12 +163,12 @@ def io_mock(methods = {})
 
     describe '#set_pullup' do
       it 'should write high if pullup is enabled' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.high))
+        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.high))
         subject.set_pullup(13, true)
       end
 
       it 'should write low if pullup is disabled' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.low))
+        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.low))
         subject.set_pullup(13, false)
       end
     end
diff --git a/spec/lib/components/basic/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
index a96d5422..8a2087c3 100644
--- a/spec/lib/components/basic/digital_input_spec.rb
+++ b/spec/lib/components/basic/digital_input_spec.rb
@@ -8,32 +8,33 @@ module Basic
         let(:options) { { pin: 'A0', board: board } }
         subject { DigitalInput.new(options) }
 
-        describe '#initialize' do
-          it 'should start listening immediately' do
-            board.should_receive(:digital_listen).with(14)
-
-            component = DigitalInput.new(options)
-          end
+        it 'should start listening immediately' do
+          expect(board).to receive(:digital_listen).with(14)
+          component = DigitalInput.new(options)
         end
 
         describe '#_read' do
-          it 'should send #digital_read to the board with its pin' do
-            board.should_receive(:digital_read).with(subject.pin)
+          it 'should call board#digital_read with its pin once' do
+            expect(board).to receive(:digital_read).with(subject.pin).once
             subject._read
           end
         end
 
         describe '#_listen' do
-          it 'should send #digital_listen to the board with its pin' do
-            subject.stop
-            board.should_receive(:digital_listen).with(subject.pin)
-
+          it 'should call board#digital_listen with its pin once' do
+            expect(board).to receive(:digital_listen).with(subject.pin).once
             subject._listen
           end
         end
 
         context 'callbacks' do
           before :each do
+            # Simulate the mutex
+            mutex = double
+            allow(mutex).to receive(:synchronize).and_yield
+            subject.instance_variable_set(:@callback_mutex, mutex)
+            subject.instance_variable_set(:@callbacks, {}) 
+
             @low_callback = double
             @high_callback = double
             subject.on_low { @low_callback.called }
@@ -42,8 +43,8 @@ module Basic
 
           describe '#on_low' do
             it 'should add a callback that only gets fired when LOW' do
-              @low_callback.should_receive(:called)
-              @high_callback.should_not_receive(:called)
+              expect(@low_callback).to receive(:called)
+              expect(@high_callback).not_to receive(:called)
 
               subject.update(DigitalInput::LOW)
             end
@@ -51,8 +52,8 @@ module Basic
 
           describe '#on_high' do
             it 'should add a callback that only gets fired when HIGH' do
-              @low_callback.should_not_receive(:called)
-              @high_callback.should_receive(:called)
+              expect(@high_callback).to receive(:called)
+              expect(@low_callback).not_to receive(:called)
 
               subject.update(DigitalInput::HIGH)
             end
diff --git a/spec/lib/components/setup/input_spec.rb b/spec/lib/components/setup/input_spec.rb
index ae86375f..ab1f71b7 100644
--- a/spec/lib/components/setup/input_spec.rb
+++ b/spec/lib/components/setup/input_spec.rb
@@ -29,8 +29,8 @@ class InputComponent
           end
 
           it 'should set the pulllup if included in options' do
-            board.should_receive(:set_pullup).with(subject.pin, true)
-            subject
+            expect(board).to receive(:set_pullup).with(subject.pin, true)
+            InputComponent.new(options)
           end
 
           it 'should tell the board to start reading' do

From ee937d39ba6d91ab31cebac35e8b37f78027427e Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sat, 21 Feb 2015 19:01:25 -0400
Subject: [PATCH 074/296] Better tests for Board. Move BoardNotFound into TxRx
 module.

---
 lib/dino.rb                                   |   1 -
 lib/dino/board.rb                             |  21 +-
 lib/dino/board_not_found.rb                   |   3 -
 lib/dino/tx_rx/base.rb                        |   2 +
 spec/lib/board_not_found_spec.rb              |   8 -
 spec/lib/board_spec.rb                        | 207 ++++++++++--------
 .../components/basic/digital_output_spec.rb   |   4 +-
 spec/lib/tx_rx/serial_spec.rb                 |   2 +-
 spec/lib/tx_rx/tcp_spec.rb                    |   2 +-
 spec/spec_helper.rb                           |   2 +-
 10 files changed, 131 insertions(+), 121 deletions(-)
 delete mode 100644 lib/dino/board_not_found.rb
 delete mode 100644 spec/lib/board_not_found_spec.rb

diff --git a/lib/dino.rb b/lib/dino.rb
index c7c3dfb1..b63aa07a 100644
--- a/lib/dino.rb
+++ b/lib/dino.rb
@@ -1,4 +1,3 @@
-require 'dino/board_not_found'
 require 'dino/version'
 require 'dino/message'
 require 'dino/tx_rx'
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index e3a1c95e..57f63c36 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -4,22 +4,18 @@ class Board
     DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
     def initialize(io, options={})
-      @bits = options[:bits] || 8
       @io, @components = io, []
       io.add_observer(self)
 
       @analog_zero, @dac_zero = @io.handshake.to_s.split(",").map { |pin| pin.to_i }
-      define_logic
-    end
-
-    def define_logic
-      @low      = 0
-      @high     = (2 ** @bits) - 1
-      self.analog_resolution = @bits
+      self.analog_resolution = options[:bits]
     end
 
     def analog_resolution=(value)
-      write Dino::Message.encode(command: 96, value: value)
+      @bits = value || 8
+      write Dino::Message.encode(command: 96, value: @bits)
+      @low  = 0
+      @high = (2 ** @bits) - 1
     end
 
     def analog_divider=(value)
@@ -97,12 +93,10 @@ def set_pullup(pin, pullup)
 
     def convert_pin(pin)
       pin = pin.to_s
-
       return pin.to_i             if pin.match(DIGITAL_REGEX)
       return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
       return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
-
-      nil
+      raise "Incorrect pin format"
     end
 
     def analog_pin_to_i(pin)
@@ -110,7 +104,8 @@ def analog_pin_to_i(pin)
     end
 
     def dac_pin_to_i(pin)
-      @dac_zero + pin.gsub(/\Aa/i, '').to_i
+      raise "The board did not specify any DAC pins" unless @dac_zero
+      @dac_zero + pin.gsub(/\Adac/i, '').to_i
     end
   end
 end
diff --git a/lib/dino/board_not_found.rb b/lib/dino/board_not_found.rb
deleted file mode 100644
index 808d86e2..00000000
--- a/lib/dino/board_not_found.rb
+++ /dev/null
@@ -1,3 +0,0 @@
-module Dino
-  class BoardNotFound < Exception; end
-end
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 5419fd70..edd85bba 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -3,6 +3,8 @@
 
 module Dino
   module TxRx
+    class BoardNotFound < StandardError; end
+    
     class Base
       include Observable
 
diff --git a/spec/lib/board_not_found_spec.rb b/spec/lib/board_not_found_spec.rb
deleted file mode 100644
index 8da605cb..00000000
--- a/spec/lib/board_not_found_spec.rb
+++ /dev/null
@@ -1,8 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  describe BoardNotFound do
-    it { should be }
-    it { should be_a Exception }
-  end
-end
\ No newline at end of file
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 2c9d161f..3fccbf9f 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -3,16 +3,14 @@
 module Dino
   describe Dino::Board do
     def io_mock(methods = {})
-      @io ||= double(:io, {add_observer: true, handshake: 14, write: true, read: true, write: nil}.merge(methods))
+      @io ||= double(:io, {add_observer: true, handshake: "14,20", write: true, read: true}.merge(methods))
     end
 
     subject { Board.new(io_mock) }
 
     describe '#initialize' do
-      it 'should take an io class' do
-        expect {
-          Board.new(io_mock)
-        }.to_not raise_exception
+      it 'should require an io object' do
+        expect { Board.new() }.to raise_exception
       end
 
       it 'should observe the io' do
@@ -21,167 +19,196 @@ def io_mock(methods = {})
       end
 
       it 'should initiate the handshake' do
-        io_mock.should_receive(:handshake)
+        expect(io_mock).to receive(:handshake)
         subject
       end
 
-      it 'should define the logic properly' do
-        expect(subject).to receive(:analog_resolution=).with(8)
-        subject.send(:initialize, io_mock)
-        expect(subject.high).to equal(255)
-        expect(subject.low).to equal(0)
+      it 'should set @analog_zero' do
+        expect(subject.analog_zero).to equal(14)
+      end
+
+      it 'should set @dac_zero' do
+        expect(subject.dac_zero).to equal(20)
+      end
+
+      it 'should set the analog resolution' do
+        board = Board.new(io_mock)
+        expect(board.low).to equal(0)
+        expect(board.high).to equal(255)
       end
     end
 
     describe '#update' do
-      context 'when a component is connected to the pin' do
-        it 'should call update with the message on the component' do
-          part = double(:part, pin: 7, pullup: nil)
-          subject.add_component(part)
-          other_part = double(:part, pin: 9, pullup: nil)
-          subject.add_component(other_part)
+      it 'should pass messages from a pin to the right part' do
+        subject.add_component(part1 = double(pin: 7))
+        subject.add_component(part2 = double(pin: 9))
 
-          part.should_receive(:update).with('wake up!')
-          subject.update(7, 'wake up!')
-        end
+        expect(part1).to receive(:update).with('wake up!')
+        expect(part2).to_not receive(:update).with('wake up!')
+        subject.update(7, 'wake up!')
       end
 
-      context 'when a component is not connected to the pin' do
-        it 'should not do anything' do
-          expect {
-            subject.update(5, 'wake up!')
-          }.to_not raise_exception
-        end
+      it 'should silently ignore messages from a pin if there is no part on it' do
+        expect { subject.update(5, 'wake up!') }.to_not raise_exception
       end
     end
 
     describe '#add_component' do
-      it 'should add the component to the board' do
-        subject.add_component(mock1 = double(:part1, pin: 12, pullup: nil))
-        subject.add_component(mock2 = double(:part2, pin: 14, pullup: nil))
-        subject.components.should =~ [mock1, mock2]
+      it 'should put the part in the components array' do
+        subject.add_component(part = double)
+        expect(subject.components).to include(part)
       end
     end
 
     describe '#remove_component' do
-      it 'should remove the given part from the hardware of the board and stop listening' do
-        mock = double(:part1, pin: 12, pullup: nil)
-        subject.add_component(mock)
-
-        subject.should_receive(:stop_listener).with(12)
-        subject.remove_component(mock)
-
-        subject.components.should == []
+      it 'should remove the part from the components array and stop listening' do
+        subject.add_component(part = double(pin: 12))
+        expect(subject).to receive(:stop_listener).with(12)
+        subject.remove_component(part)
+        expect(subject.components).to be_empty
       end
     end
 
     describe '#start_read' do
       it 'should tell the io to read' do
-        io_mock.should_receive(:read)
-        Board.new(io_mock).start_read
+        expect(io_mock).to receive(:read)
+        subject.start_read
       end
     end
 
     describe '#stop_read' do
       it 'should tell the io to read' do
-        io_mock.should_receive(:close_read)
-        Board.new(io_mock).stop_read
+        expect(io_mock).to receive(:close_read)
+        subject.stop_read
       end
     end
 
     describe '#write' do
-      it 'should return true if the write succeeds' do
-        @io = nil
-        board = Board.new(io_mock(write: true))
-        board.write('message').should == true
+      it 'should call #write on the io with the message' do
+        expect(io_mock).to receive(:write).with('message')
+        subject.write('message')
+      end
+    end
+
+    describe '#convert_pin' do
+      before(:each) { subject.instance_variable_set(:@analog_zero, 14) }
+
+      it 'should leave numeric pins as is' do
+        expect(subject.convert_pin '13').to equal(13)
+      end
+
+      it 'should convert analog pins to numeric form' do
+        expect(subject.convert_pin 'A1').to equal(15)
+      end
+
+      it 'should convert dac pins to numeric form' do
+        expect(subject.convert_pin 'DAC1').to equal(21)
+      end
+
+      it 'should raise if trying to convert a dac pin and the board has none' do
+        subject.instance_variable_set(:@dac_zero, nil)
+        expect { subject.convert_pin 'DAC1' }.to raise_exception(/dac/i)
+      end
+
+      it 'should raise if trying to convert a wrongly formatted pin' do
+        expect { subject.convert_pin 'ADC1' }.to raise_exception(/incorrect/i)
       end
     end
 
     #
-    # Board commands
+    # Board API Tests
     #
+    describe '#set_pin_mode' do
+      it 'should send a value of 0 if the pin mode is set to out' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 0))
+        subject.set_pin_mode(13, :out)
+      end
+
+      it 'should send a value of 1 if the pin mode is set to in' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 1))
+        subject.set_pin_mode(13, :in)
+      end
+    end
+
+    describe '#set_pullup' do
+      it 'should write high if pullup is enabled' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.high))
+        subject.set_pullup(13, true)
+      end
+
+      it 'should write low if pullup is disabled' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.low))
+        subject.set_pullup(13, false)
+      end
+    end
+
     describe '#digital_write' do
-      it 'should write the value to the right pin' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 1, pin: 1, value: 3))
-        subject.digital_write(01, 003)
+      it 'should digitalWrite the value to the pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 1, pin: 1, value: 255)
+        subject.digital_write(01, 255)
       end
     end
 
     describe '#digital_read' do
-      it 'should tell the board to read once from the given pin' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 2, pin: 13))
+      it 'should digitalRead once from the given pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 2, pin: 13)
         subject.digital_read(13)
       end
     end
 
     describe '#analog_write' do
-      it 'should append a append a write to the pin and value' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 3, pin: 1, value: 3))
+      it 'should analogWrite the value to the pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 3, pin: 1, value: 3)
         subject.analog_write(01, 3)
       end
     end
 
     describe '#analog_read' do
-      it 'should tell the board to read once from the given pin' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 4, pin: 13))
+      it 'should analogRead once from the given pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 4, pin: 13)
         subject.analog_read(13)
       end
     end
 
     describe '#digital_listen' do
-      it 'should tell the board to continuously read from the given pin' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 5, pin: 13))
+      it 'should start listening for a digital signal on the given pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 5, pin: 13)
         subject.digital_listen(13)
       end
     end
 
     describe '#analog_listen' do
-      it 'should tell the board to continuously read from the given pin' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 6, pin: 13))
+      it 'should start listening for an analog signal on the given pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 6, pin: 13)
         subject.analog_listen(13)
       end
     end
 
     describe '#stop_listener' do
-      it 'should tell the board to stop sending values for the given pin' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 7, pin: 13))
+      it 'should stop listening for any signal on the given pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 13)
         subject.stop_listener(13)
       end
     end
 
-    describe '#set_pin_mode' do
-      it 'should send a value of 0 if the pin mode is set to out' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 0))
-        subject.set_pin_mode(13, :out)
-      end
-
-      it 'should send a value of 1 if the pin mode is set to in' do
-        io_mock.should_receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 1))
-        subject.set_pin_mode(13, :in)
-      end
-    end
-
-    describe '#set_pullup' do
-      it 'should write high if pullup is enabled' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.high))
-        subject.set_pullup(13, true)
+    describe '#analog_resolution=' do
+      it 'should tell the board to change the resolution' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 96, value: 10)
+        subject.analog_resolution = 10
       end
 
-      it 'should write low if pullup is disabled' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.low))
-        subject.set_pullup(13, false)
+      it 'should set @bits' do
+        subject.analog_resolution = 12
+        expect(subject.instance_variable_get(:@bits)).to equal(12)
       end
-    end
-
-    describe '#convert_pin' do
-      before(:each) { subject.instance_variable_set(:@analog_zero, 14) }
 
-      it 'should convert alphanumeric pins to numbers' do
-        subject.convert_pin('A1').should == 15
-      end
+      it 'should set @high and @low correctly' do
+        subject.analog_resolution = 8
+        expect(subject.low).to equal(0)
+        expect(subject.high).to equal(255)
 
-      it 'should leave numeric pins alone' do
-        subject.convert_pin('13').should == 13
+        subject.analog_resolution = 10
+        expect(subject.high).to equal(1023)
       end
     end
   end
diff --git a/spec/lib/components/basic/digital_output_spec.rb b/spec/lib/components/basic/digital_output_spec.rb
index b378471e..2b578453 100644
--- a/spec/lib/components/basic/digital_output_spec.rb
+++ b/spec/lib/components/basic/digital_output_spec.rb
@@ -11,7 +11,7 @@ module Basic
         describe '#after_initialize' do
           it 'should set mode to out and go low' do
             board.should_receive(:digital_write).with(13, board.low)
-            DigitalOutput.new(options)
+            subject
           end
         end
 
@@ -42,14 +42,12 @@ module Basic
           it 'should call high if currently LOW' do
             subject.low
             subject.should_receive(:high)
-
             subject.toggle
           end
 
           it 'should call LOW if anything else' do
             subject.high
             subject.should_receive(:low)
-
             subject.toggle
           end
         end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index f03c46b1..fa930801 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -65,7 +65,7 @@ module Dino
 
       it 'should raise a BoardNotFound exception if there is no board connected' do
         ::Serial.stub(:new).and_raise
-        expect { subject.io }.to raise_exception BoardNotFound
+        expect { subject.io }.to raise_exception Dino::TxRx::BoardNotFound
       end
     end
 
diff --git a/spec/lib/tx_rx/tcp_spec.rb b/spec/lib/tx_rx/tcp_spec.rb
index 725b09f5..2b5f0d1f 100644
--- a/spec/lib/tx_rx/tcp_spec.rb
+++ b/spec/lib/tx_rx/tcp_spec.rb
@@ -10,7 +10,7 @@ module Dino
 
     describe "#connect" do
       it 'should raise a BoardNotFound exception if it cannot connect to the server' do
-        expect { @instance.io }.to raise_exception BoardNotFound
+        expect { @instance.io }.to raise_exception Dino::TxRx::BoardNotFound
       end
 
       it 'should return the TCPSocket if connected' do
diff --git a/spec/spec_helper.rb b/spec/spec_helper.rb
index 281f2af1..3ed0a269 100644
--- a/spec/spec_helper.rb
+++ b/spec/spec_helper.rb
@@ -14,7 +14,7 @@ def self.redefine(const, value, opts={})
 module BoardMock
   def self.included(base)
     base.class_eval do
-      let(:txrx)  { double(:txrx, add_observer: true, handshake: 14, write: true, read: true) }
+      let(:txrx)  { double(:txrx, add_observer: true, handshake: "14,20", write: true, read: true) }
       let(:board) { Dino::Board.new(txrx) }
     end
   end

From 1926aeb14b515de6dd758ab7f7ff6114da167877 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sun, 1 Mar 2015 09:57:44 -0400
Subject: [PATCH 075/296] Fix inheritance of initalize for callbacks module

---
 lib/dino/components/basic/digital_input.rb | 1 +
 lib/dino/components/mixins/callbacks.rb    | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index 23808aa1..d0788194 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -9,6 +9,7 @@ class DigitalInput
         include Mixins::Listener
 
         def after_initialize(options={})
+          super(options)
           _listen
         end
 
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 16da6723..eb3a1c3c 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -3,7 +3,7 @@ module Components
     module Mixins
       module Callbacks
         def after_initialize(options={})
-          super
+          super(options)
           @callbacks = {}
           @callback_mutex = Mutex.new
         end

From 57258fb2d64f890dafccc5e250966f8800e9bd8d Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Sun, 1 Mar 2015 17:05:11 -0400
Subject: [PATCH 076/296] Forgot to put back 5ms sleep in read thread to avoid
 high cpu usage

---
 lib/dino/tx_rx/base.rb | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index edd85bba..2b3d21a6 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -4,7 +4,7 @@
 module Dino
   module TxRx
     class BoardNotFound < StandardError; end
-    
+
     class Base
       include Observable
 
@@ -19,6 +19,8 @@ def read
             if line && line.match(/\A\d+:/)
               pin, message = line.chop.split(/:/)
               pin && message && changed && notify_observers(pin, message)
+            else
+              sleep 0.005
             end
           end
         end

From 52e7d1d05958fc3681bf92bb6bb5f360cf957138 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Mon, 2 Mar 2015 11:07:52 -0400
Subject: [PATCH 077/296] Make the read thread abort on exception. No more
 silently failing callbacks.

---
 lib/dino/tx_rx/base.rb | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 2b3d21a6..b87a31ba 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -24,6 +24,7 @@ def read
             end
           end
         end
+        @thread.abort_on_exception = true
       end
 
       def close_read

From 27ed24ab7c15cc33086335e6f84ac4483f6e22f5 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Mon, 2 Mar 2015 11:55:21 -0400
Subject: [PATCH 078/296] Separate Board#read for simpler testing

---
 lib/dino/tx_rx/base.rb        | 23 +++++++++++------------
 spec/lib/tx_rx/serial_spec.rb | 18 +++++++++---------
 2 files changed, 20 insertions(+), 21 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index b87a31ba..1eeee7be 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -12,19 +12,18 @@ def io
         @io ||= connect
       end
 
-      def read
-        @thread ||= Thread.new do
-          loop do
-            line = gets
-            if line && line.match(/\A\d+:/)
-              pin, message = line.chop.split(/:/)
-              pin && message && changed && notify_observers(pin, message)
-            else
-              sleep 0.005
-            end
-          end
+      def _read
+        line = gets
+        if line && line.match(/\A\d+:/)
+          pin, message = line.chop.split(/:/)
+          pin && message && changed && notify_observers(pin, message)
+        else
+          sleep 0.005
         end
-        @thread.abort_on_exception = true
+      end
+
+      def read
+        @thread ||= Thread.new { loop { _read } }.abort_on_exception = true
       end
 
       def close_read
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index fa930801..4948f4c3 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -69,19 +69,19 @@ module Dino
       end
     end
 
-    describe '#read' do
-      it 'should create a new thread' do
-        Thread.should_receive :new
-        subject.read
-      end
-
-      it 'should start a loop and notify observers on changes' do
-        Thread.should_receive(:new).and_yield
-        subject.should_receive(:loop).and_yield
+    describe '#_read' do
+      it 'should notify observers on change' do
         subject.should_receive(:gets).and_return("02:00\n")
         subject.should_receive(:changed).and_return(true)
         subject.should_receive(:notify_observers).with('02','00')
+        subject._read
+      end
+    end
 
+    describe '#read' do
+      it 'should create a new thread and start looping' do
+        Thread.should_receive(:new).and_yield.and_return(double("abort_on_exception=" => true))
+        subject.should_receive(:loop)
         subject.read
       end
     end

From c165218ddf1c6aa5f2711bf14141109f5936a611 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Mon, 2 Mar 2015 13:38:36 -0400
Subject: [PATCH 079/296] Expect all pins to be integer after component init.
 Add #pin to fix MultiPin components.

---
 lib/dino/board.rb                      | 2 +-
 lib/dino/components/setup/multi_pin.rb | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 57f63c36..01fab882 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -44,7 +44,7 @@ def write(msg)
 
     def update(pin, msg)
       @components.each do |part|
-        part.update(msg) if convert_pin(pin) == convert_pin(part.pin)
+        part.update(msg) if pin.to_i == part.pin
       end
     end
 
diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
index 0d1b89df..75c26e14 100644
--- a/lib/dino/components/setup/multi_pin.rb
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -6,7 +6,7 @@ module MultiPin
         # Build complex components by modeling them as separate single pin subcomponents.
         #
         include Base
-        attr_reader :pins, :pullups, :proxies
+        attr_reader :pin, :pins, :pullups, :proxies
 
         #
         # Return a hash with the state of each proxy component.
@@ -58,7 +58,7 @@ def proxy_pins(options={})
               require_pins(*options.keys)
             end
 
-            proxied_pins = self.class_eval('@@proxied_pins') rescue {}         
+            proxied_pins = self.class_eval('@@proxied_pins') rescue {}
             proxied_pins.merge!(options)
             self.class_variable_set(:@@proxied_pins, proxied_pins)
           end

From 6090ebbd87606c4a3198e45948e176c4c1aea471 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Mon, 2 Mar 2015 21:49:17 -0400
Subject: [PATCH 080/296] New rspec syntax for TxRx specs. Escape backslashes
 everywhere.

---
 lib/dino/message.rb           |   2 +-
 lib/dino/tx_rx/base.rb        |   6 +-
 lib/dino/tx_rx/serial.rb      |  20 +++++--
 spec/lib/message_spec.rb      |   6 +-
 spec/lib/tx_rx/serial_spec.rb | 108 ++++++++++++++++++----------------
 spec/lib/tx_rx/tcp_spec.rb    |   6 +-
 src/lib/Dino.cpp              |  31 +++++-----
 7 files changed, 101 insertions(+), 78 deletions(-)

diff --git a/lib/dino/message.rb b/lib/dino/message.rb
index 6dfa1930..af2b8531 100644
--- a/lib/dino/message.rb
+++ b/lib/dino/message.rb
@@ -5,7 +5,7 @@ def self.encode(options={})
       pin = options[:pin]
       val = options[:value]
       aux = options[:aux_message]
-      aux.to_s.gsub!("\n", "\\\n") if aux
+      aux = aux.to_s.gsub("\\","\\\\\\\\").gsub("\n", "\\\n") if aux
 
       raise Exception.new('command must be specified') unless cmd
       raise Exception.new('commands can only be four digits') if cmd.to_s.length > 4
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 1eeee7be..cb58b0c6 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -54,12 +54,12 @@ def handshake
         raise BoardNotFound
       end
 
-      def write(message); raise "#write should be defined in TxRX subclasses"; end
+      def write(message); raise "#write should be defined in TxRx subclasses"; end
 
     private
 
-      def connect(message); raise "#connect should be defined in TxRX subclasses"; end
-      def gets(message); raise "#gets should be defined in TxRX subclasses"; end
+      def connect(message); raise "#connect should be defined in TxRx subclasses"; end
+      def gets(message); raise "#gets should be defined in TxRx subclasses"; end
 
       def flush_read
         gets until gets == nil
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index 3630fd1e..de7a939e 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -8,7 +8,6 @@ class Serial < Base
       def initialize(options={})
         @device = options[:device]
         @baud = options[:baud] || BAUD
-        @first_write = true
       end
 
       def write(message)
@@ -33,11 +32,22 @@ def on_windows?
       end
 
       def gets(timeout=0)
-        buff = io.read(1)
-        return nil if buff.empty?
+        buff, escaped = "", false
         loop do
-          buff << io.read(1)
-          return buff if buff[-1] == "\n"
+          char = io.read(1)
+          if ["\n", "\\"].include? char
+            if escaped
+              buff << char
+              escaped = false
+            elsif (char == "\n")
+              return buff
+            elsif (char == "\\")
+              escaped = true
+            end
+          else
+            buff << char
+          end
+          return nil if (buff.empty? && !escaped)
         end
       end
     end
diff --git a/spec/lib/message_spec.rb b/spec/lib/message_spec.rb
index 7a8db344..99dd8aaa 100644
--- a/spec/lib/message_spec.rb
+++ b/spec/lib/message_spec.rb
@@ -35,9 +35,13 @@ module Dino
         Dino::Message.encode(command: 1, value: 1, aux_message: "Some Text").should == "1..1.Some Text\n"
       end
 
-      it 'should insert a backslash before any newline inside the aux message' do
+      it 'should escape newlines inside aux message' do
         Dino::Message.encode(command: 1, aux_message: "line1\nline2").should == "1...line1\\\nline2\n"
       end
+
+      it 'should escape backslashes inside aux message' do
+        Dino::Message.encode(command: 1, aux_message: "line1\\line2").should == "1...line1\\\\line2\n"
+      end
     end
   end
 end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index 4948f4c3..666cf608 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -2,86 +2,68 @@
 
 module Dino
   describe TxRx::Serial do
-    it { should be }
-
-    describe '#initialize' do
-      it 'should set first_write to true' do
-        TxRx::Serial.new.instance_variable_get(:@first_write).should == true
+    describe '#connect' do
+      it 'should use the specified device and baud rate from options hash' do
+        expect(::Serial).to receive(:new).with("/dev/ttyACM0", 9600).and_return(mock_serial = double)
+        txrx = Dino::TxRx::Serial.new(device: "/dev/ttyACM0", baud: 9600)
+        expect(txrx.io).to equal mock_serial
       end
 
-      it 'should set the device and buad if specified' do
-        txrx = TxRx::Serial.new({device: "/dev/ttyACM0", baud: 9600})
-        txrx.instance_variable_get(:@baud).should == 9600
-        txrx.instance_variable_get(:@device).should == "/dev/ttyACM0"
-      end
-    end
-
-    describe '#io' do
       context "on windows" do
-        it 'should instantiate a new SerialPort for the first available tty device' do
+        it 'should create a new ::Serial object for the connected COM port if non specified' do
+          # Simulate being on Windows
           original_platform = RUBY_PLATFORM
           Constants.redefine(:RUBY_PLATFORM, "mswin", :on => Object)
-          subject.should_receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
 
-          # COM2 is chosen as available for this test.
-          ::Serial.should_receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise
-          ::Serial.should_receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = double)
-          ::Serial.should_not_receive(:new).with("COM3", TxRx::Serial::BAUD)
+          # Simulate 3 COM ports with COM2 connected.
+          expect(subject).to receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
+          expect(::Serial).to receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise
+          expect(::Serial).to receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = double)
+          expect(::Serial).to_not receive(:new).with("COM3", TxRx::Serial::BAUD)
+          expect(subject.io).to equal(mock_serial)
 
-          subject.io.should == mock_serial
+          # Set platform back to original value
           Constants.redefine(:RUBY_PLATFORM, original_platform, :on => Object)
         end
       end
 
-      context "on unix" do
-        it 'should instantiate a new SerialPort for the first available tty device' do
-          subject.should_receive(:tty_devices).and_return(['/dev/ttyACM0', '/dev/tty.usbmodem1'])
-
-          # /dev/ttyACM0 is chosen as available for this test.
-          ::Serial.should_receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial = double)
-          ::Serial.should_not_receive(:new).with('/dev/tty.usbmodem1', TxRx::Serial::BAUD)
+      context "on *nix" do
+        it 'should create a new ::Serial for the first connected tty device if none specified' do
+          expect(subject).to receive(:tty_devices).and_return(['/dev/ttyACM0', '/dev/tty.usbmodem1'])
 
-          subject.io.should == mock_serial
+          # Simulate /dev/ttyACM0 connected.
+          expect(::Serial).to receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial = double)
+          expect(::Serial).to_not receive(:new).with('/dev/tty.usbmodem1', TxRx::Serial::BAUD)
+          expect(subject.io).to equal(mock_serial)
         end
       end
 
-      it 'should connect to the specified device at the specified baud rate' do
-        subject.should_receive(:tty_devices).and_return(["/dev/ttyACM0"])
-        ::Serial.should_receive(:new).with('/dev/ttyACM0', 9600).and_return(mock_serial = double)
-
-        subject.instance_variable_set(:@device, "/dev/ttyACM0")
-        subject.instance_variable_set(:@baud, 9600)
-
-        subject.io.should == mock_serial
-      end
-
       it 'should use the existing io instance if set' do
-        subject.should_receive(:tty_devices).once.and_return(['/dev/tty.ACM0', '/dev/tty.usbmodem1'])
-        ::Serial.stub(:new).and_return(mock_serial = double)
-
+        expect(subject).to receive(:tty_devices).once.and_return(['/dev/tty.ACM0'])
+        expect(::Serial).to receive(:new).and_return(mock_serial = double)
         3.times { subject.io }
         subject.io.should == mock_serial
       end
 
       it 'should raise a BoardNotFound exception if there is no board connected' do
-        ::Serial.stub(:new).and_raise
+        expect(::Serial).to receive(:new).at_least(:once).and_raise
         expect { subject.io }.to raise_exception Dino::TxRx::BoardNotFound
       end
     end
 
     describe '#_read' do
       it 'should notify observers on change' do
-        subject.should_receive(:gets).and_return("02:00\n")
-        subject.should_receive(:changed).and_return(true)
-        subject.should_receive(:notify_observers).with('02','00')
+        expect(subject).to receive(:gets).and_return("02:00\n")
+        expect(subject).to receive(:changed).and_return(true)
+        expect(subject).to receive(:notify_observers).with('02','00')
         subject._read
       end
     end
 
     describe '#read' do
       it 'should create a new thread and start looping' do
-        Thread.should_receive(:new).and_yield.and_return(double("abort_on_exception=" => true))
-        subject.should_receive(:loop)
+        expect(Thread).to receive(:new).and_yield.and_return(double("abort_on_exception=" => true))
+        expect(subject).to receive(:loop)
         subject.read
       end
     end
@@ -89,7 +71,7 @@ module Dino
     describe '#close_read' do
       it 'should kill the reading thread' do
         subject.instance_variable_set(:@thread, mock_thread = double)
-        Thread.should_receive(:kill).with(mock_thread)
+        expect(Thread).to receive(:kill).with(mock_thread)
         subject.read
         subject.close_read
       end
@@ -97,10 +79,36 @@ module Dino
 
     describe '#write' do
       it 'should write to the device' do
-        subject.stub(:io).and_return(mock_serial = double)
-        mock_serial.should_receive(:write).with('a message')
+        expect(subject).to receive(:io).and_return(mock_serial = double)
+        expect(mock_serial).to receive(:write).with('a message')
         subject.write('a message')
       end
     end
+
+    describe '#gets' do
+      it 'should read single characters until it hits a newline and strip it' do
+        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
+        expect(mock_serial).to receive(:read).exactly(5).times.with(1).and_return("l", "i", "n", "e", "\n")
+        expect(subject.send(:gets)).to eq("line")
+      end
+
+      it 'should catch escaped newlines' do
+        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
+        expect(mock_serial).to receive(:read).exactly(7).times.with(1).and_return("l", "1", "\\", "\n", "l", "2", "\n")
+        expect(subject.send(:gets)).to eq("l1\nl2")
+      end
+
+      it 'should return a blank string if there is just a newline' do
+        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
+        expect(mock_serial).to receive(:read).exactly(1).times.with(1).and_return("\n")
+        expect(subject.send(:gets)).to eq("")
+      end
+
+      it 'should allow escaped backslashes' do
+        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
+        expect(mock_serial).to receive(:read).exactly(3).times.with(1).and_return("\\", "\\", "\n")
+        expect(subject.send(:gets)).to eq("\\")
+      end
+    end
   end
 end
diff --git a/spec/lib/tx_rx/tcp_spec.rb b/spec/lib/tx_rx/tcp_spec.rb
index 2b5f0d1f..79be3998 100644
--- a/spec/lib/tx_rx/tcp_spec.rb
+++ b/spec/lib/tx_rx/tcp_spec.rb
@@ -15,21 +15,21 @@ module Dino
 
       it 'should return the TCPSocket if connected' do
         @server = TCPServer.new @port
-        @instance.io.should be_a TCPSocket
+        expect(@instance.io).to be_a(TCPSocket)
         @server.close
       end
     end
 
     describe '#io' do
       it 'should set io to a new TCPSocket with the specified host and port' do
-        TCPSocket.should_receive(:open).with(@host, @port)
+        expect(TCPSocket).to receive(:open).with(@host, @port)
         @instance.io
       end
 
       it 'should use the existing io instance if set' do
         @server = TCPServer.new @port
         socket = @instance.io
-        @instance.io.should be socket
+        expect(@instance.io).to equal(socket)
         @server.close
       end
     end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 24d27699..7cca89a1 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -25,19 +25,23 @@ Dino::Dino(){
 }
 
 void Dino::parse(char c) {
-  // Handle escaped newlines.
-  if (backslash) {
-    if (c != '\n') append('\\');
-    append(c);
-    backslash = false;
-  }
+  if ((c == '\n') || (c == '\\')) {
+    // If last char was a \, this \ or \n is escaped.
+    if(backslash){
+      append(c);
+      backslash = false;
+    }
+
+    // If EOL, process and reset.
+    else if (c == '\n'){
+      append('\0');
+      process();
+      fragmentIndex = 0;
+      charIndex = 0;
+    }
 
-  // If EOL process and reset.
-  else if (c == '\n') {
-    append('\0');
-    process();
-    fragmentIndex = 0;
-    charIndex = 0;
+    // Backslash is the escape character.
+    else if (c == '\\') backslash = true;
   }
 
   // If fragment delimiter, terminate current fragment and move to next.
@@ -52,9 +56,6 @@ void Dino::parse(char c) {
     }
   }
 
-  // Catch backslash so we can escape the next character.
-  else if (c == '\\') backslash = true;
-
   // Else just append the character.
   else append(c);
 }

From cf895f6d0df47d6b8af9990d1ec2ffc07c215f0f Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Mon, 2 Mar 2015 22:20:28 -0400
Subject: [PATCH 081/296] allow instead of expect. Trying to get test passing
 on travis.

---
 spec/lib/tx_rx/serial_spec.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index 666cf608..00826a2f 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -46,7 +46,7 @@ module Dino
       end
 
       it 'should raise a BoardNotFound exception if there is no board connected' do
-        expect(::Serial).to receive(:new).at_least(:once).and_raise
+        allow(::Serial).to receive(:new).and_raise
         expect { subject.io }.to raise_exception Dino::TxRx::BoardNotFound
       end
     end

From 3a8d73ca4d9da0bdc95537e8b23ba09df04b86fb Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Mon, 2 Mar 2015 23:30:56 -0400
Subject: [PATCH 082/296] Rspec 3.2 syntax for all tests

---
 .../lib/components/basic/analog_input_spec.rb |  4 +-
 .../components/basic/analog_output_spec.rb    | 12 +++---
 .../components/basic/digital_output_spec.rb   | 14 +++----
 spec/lib/components/lcd_spec.rb               | 38 +++++++++----------
 spec/lib/components/rgb_led_spec.rb           | 26 ++++++-------
 spec/lib/components/servo_spec.rb             | 11 +++---
 spec/lib/components/setup/base_spec.rb        |  4 +-
 spec/lib/components/setup/input_spec.rb       |  8 ++--
 spec/lib/components/setup/multi_pin_spec.rb   | 21 +++++-----
 spec/lib/components/setup/output_spec.rb      |  2 +-
 spec/lib/components/setup/single_pin_spec.rb  |  8 ++--
 spec/lib/components/shift_register_spec.rb    | 20 +++++-----
 spec/lib/components/softwareserial_spec.rb    |  8 ++--
 spec/lib/components/ssd_spec.rb               | 26 +++++++------
 spec/lib/components/stepper_spec.rb           | 18 ++++-----
 spec/lib/message_spec.rb                      | 18 ++++-----
 spec/lib/tx_rx/serial_spec.rb                 |  2 +-
 17 files changed, 121 insertions(+), 119 deletions(-)

diff --git a/spec/lib/components/basic/analog_input_spec.rb b/spec/lib/components/basic/analog_input_spec.rb
index 5b591fca..f5d95908 100644
--- a/spec/lib/components/basic/analog_input_spec.rb
+++ b/spec/lib/components/basic/analog_input_spec.rb
@@ -10,14 +10,14 @@ module Basic
 
         describe '#_read' do
           it 'should send #analog_read to the board with its pin' do
-            board.should_receive(:analog_read).with(subject.pin)
+            expect(board).to receive(:analog_read).with(subject.pin)
             subject._read
           end
         end
 
         describe '#_listen' do
           it 'should send #analog_listen to the board with its pin' do
-            board.should_receive(:analog_listen).with(subject.pin)
+            expect(board).to receive(:analog_listen).with(subject.pin)
             subject._listen
           end
         end
diff --git a/spec/lib/components/basic/analog_output_spec.rb b/spec/lib/components/basic/analog_output_spec.rb
index 0da24906..1d610320 100644
--- a/spec/lib/components/basic/analog_output_spec.rb
+++ b/spec/lib/components/basic/analog_output_spec.rb
@@ -10,27 +10,27 @@ module Basic
 
       	describe '#analog_write' do
           it 'should update the @state instance variable and call #analog_write on the board' do
-            board.should_receive(:analog_write).with(subject.pin, 128).once
-            
+            expect(board).to receive(:analog_write).with(subject.pin, 128).once
+
             subject.analog_write(128)
-            subject.state.should == 128
+            expect(subject.state).to eq(128)
           end
         end
 
         describe '#write' do
           it 'should call #digital_write if value is HIGH' do
-            subject.should_receive(:digital_write).with(board.high)
+            expect(subject).to receive(:digital_write).with(board.high)
             subject.write(board.high)
           end
 
 
           it 'should call #digital_write if value is LOW' do
-            subject.should_receive(:digital_write).with(board.low)
+            expect(subject).to receive(:digital_write).with(board.low)
             subject.write(board.low)
           end
 
           it 'should call #analog_write if value is anything else' do
-            subject.should_receive(:analog_write).with(128)
+            expect(subject).to receive(:analog_write).with(128)
             subject.write(128)
           end
         end
diff --git a/spec/lib/components/basic/digital_output_spec.rb b/spec/lib/components/basic/digital_output_spec.rb
index 2b578453..ad032cfc 100644
--- a/spec/lib/components/basic/digital_output_spec.rb
+++ b/spec/lib/components/basic/digital_output_spec.rb
@@ -10,7 +10,7 @@ module Basic
 
         describe '#after_initialize' do
           it 'should set mode to out and go low' do
-            board.should_receive(:digital_write).with(13, board.low)
+            expect(board).to receive(:digital_write).with(13, board.low)
             subject
           end
         end
@@ -18,22 +18,22 @@ module Basic
         describe '#digital_write' do
           it 'should update the @state instance variable and call #digital_write on the board' do
             subject
-            board.should_receive(:digital_write).with(subject.pin, board.high).once
+            expect(board).to receive(:digital_write).with(subject.pin, board.high).once
             subject.digital_write(board.high)
-            subject.state.should == board.high
+            expect(subject.state).to eq(board.high)
           end
         end
 
         describe '#high' do
           it 'should call #digital_write with HIGH' do
-            subject.should_receive(:digital_write).with(board.high)
+            expect(subject).to receive(:digital_write).with(board.high)
             subject.high
           end
         end
 
         describe '#low' do
           it 'should call #digital_write with LOW' do
-            subject.should_receive(:digital_write).with(board.low)
+            expect(subject).to receive(:digital_write).with(board.low)
             subject.low
           end
         end
@@ -41,13 +41,13 @@ module Basic
         describe '#toggle' do
           it 'should call high if currently LOW' do
             subject.low
-            subject.should_receive(:high)
+            expect(subject).to receive(:high)
             subject.toggle
           end
 
           it 'should call LOW if anything else' do
             subject.high
-            subject.should_receive(:low)
+            expect(subject).to receive(:low)
             subject.toggle
           end
         end
diff --git a/spec/lib/components/lcd_spec.rb b/spec/lib/components/lcd_spec.rb
index b6bf5509..9b909707 100644
--- a/spec/lib/components/lcd_spec.rb
+++ b/spec/lib/components/lcd_spec.rb
@@ -7,121 +7,121 @@ module Components
       subject { LCD.new board: board, pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 }, cols: 16, rows: 2 }
 
       before do
-        board.should_receive(:write).with("10..0.12,11,5,4,3,2\n")
-        board.should_receive(:write).with("10..1.16,2\n")
+        expect(board).to receive(:write).with("10..0.12,11,5,4,3,2\n")
+        expect(board).to receive(:write).with("10..1.16,2\n")
       end
 
       describe '#clear' do
         it 'clears the display' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 2)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 2)
           subject.clear
         end
       end
 
       describe '#home' do
         it 'Moves the cursor to the first position' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 3)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 3)
           subject.home
         end
       end
 
       describe '#set_cursor' do
         it 'moves the cursor to the given position' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 4, aux_message: "0,1")
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 4, aux_message: "0,1")
           subject.set_cursor(0,1)
         end
       end
 
       describe '#puts' do
         it 'prints a string in the display' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 5, aux_message: "AB")
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 5, aux_message: "AB")
           subject.puts("AB")
         end
       end
 
       describe '#show_cursor' do
         it 'shows the cursor' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 6)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 6)
           subject.show_cursor
         end
       end
 
       describe '#hide_cursor' do
         it 'hides the cursor' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 7)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 7)
           subject.hide_cursor
         end
       end
 
       describe '#blink' do
         it 'shows a blinking cursor' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 8)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 8)
           subject.blink
         end
       end
 
       describe '#no_blink' do
         it 'stops a blinking cursor' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 9)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 9)
           subject.no_blink
         end
       end
 
       describe '#on' do
         it 'turn on the display' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 10)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 10)
           subject.on
         end
       end
 
       describe '#off' do
         it 'turn off the display' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 11)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 11)
           subject.off
         end
       end
 
       describe '#scroll_left' do
         it 'move the text in the display one position to the left' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 12)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 12)
           subject.scroll_left
         end
       end
 
       describe '#scroll_right' do
         it 'move the text in the display one position to the right' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 13)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 13)
           subject.scroll_right
         end
       end
 
       describe '#enable_autoscroll' do
         it 'enable autoscroll' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 14)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 14)
           subject.enable_autoscroll
         end
       end
 
       describe '#disable_autoscroll' do
         it 'disable autoscroll' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 15)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 15)
           subject.disable_autoscroll
         end
       end
 
       describe '#left_to_right' do
         it 'set the display writing to start from the left' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 16)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 16)
           subject.left_to_right
         end
       end
 
       describe '#right_to_left' do
         it 'set the display writing to start from the right' do
-          board.should_receive(:write).with Dino::Message.encode(command: 10, value: 17)
+          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 17)
           subject.right_to_left
         end
       end
     end
   end
-end
\ No newline at end of file
+end
diff --git a/spec/lib/components/rgb_led_spec.rb b/spec/lib/components/rgb_led_spec.rb
index 22dd8088..12859ef6 100644
--- a/spec/lib/components/rgb_led_spec.rb
+++ b/spec/lib/components/rgb_led_spec.rb
@@ -10,18 +10,18 @@ module Components
       describe '#initialize' do
         it 'should create a BaseOutput instance for each pin' do
           led = RgbLed.new(options)
-          
-          led.red.class.should == Basic::AnalogOutput
-          led.green.class.should == Basic::AnalogOutput
-          led.blue.class.should == Basic::AnalogOutput
+
+          expect(led.red.class).to eq(Basic::AnalogOutput)
+          expect(led.green.class).to eq(Basic::AnalogOutput)
+          expect(led.blue.class).to eq(Basic::AnalogOutput)
         end
       end
 
       describe '#write' do
         it 'should write the elements of the array to red, green and blue' do
-          subject.red.should_receive(:write).with(0)
-          subject.green.should_receive(:write).with(128)
-          subject.blue.should_receive(:write).with(0)
+          expect(subject.red).to receive(:write).with(0)
+          expect(subject.green).to receive(:write).with(128)
+          expect(subject.blue).to receive(:write).with(0)
 
           subject.write [0, 128, 0]
         end
@@ -29,7 +29,7 @@ module Components
 
       describe '#color=' do
         it 'should write an array of values' do
-          subject.should_receive(:write).with([128, 0, 0])
+          expect(subject).to receive(:write).with([128, 0, 0])
           subject.color = [128, 0, 0]
         end
 
@@ -44,7 +44,7 @@ module Components
             white:   [255, 255, 255],
             off:     [000, 000, 000]
           }
-          colors.each_value { |color| subject.should_receive(:write).with(color).twice }
+          colors.each_value { |color| expect(subject).to receive(:write).with(color).twice }
 
           colors.each_key { |key| subject.color = key }
           colors.each_key { |key| subject.color = key.to_s }
@@ -53,10 +53,10 @@ module Components
 
       describe '#cycle' do
         it 'should cycle through the 3 base colors' do
-          Array.any_instance.should_receive(:cycle).and_yield(:red).and_yield(:green).and_yield(:blue)
-          subject.should_receive(:color=).with(:red)
-          subject.should_receive(:color=).with(:green)
-          subject.should_receive(:color=).with(:blue)
+          expect_any_instance_of(Array).to receive(:cycle).and_yield(:red).and_yield(:green).and_yield(:blue)
+          expect(subject).to receive(:color=).with(:red)
+          expect(subject).to receive(:color=).with(:green)
+          expect(subject).to receive(:color=).with(:blue)
           subject.cycle
         end
       end
diff --git a/spec/lib/components/servo_spec.rb b/spec/lib/components/servo_spec.rb
index a8225e9c..839b8ac2 100644
--- a/spec/lib/components/servo_spec.rb
+++ b/spec/lib/components/servo_spec.rb
@@ -9,7 +9,7 @@ module Components
 
       describe '#initialize' do
         it 'should toggle the servo library on for the pin' do
-          board.should_receive(:servo_toggle).with(options[:pin], 1)
+          expect(board).to receive(:servo_toggle).with(options[:pin], 1)
           subject
         end
       end
@@ -19,25 +19,24 @@ module Components
 
         it 'should set the position of the Servo' do
           servo.position = 90
-          servo.position.should == 90
+          expect(servo.position).to eq(90)
         end
 
         it 'should let you write up to 180' do
           servo.position = 180
-          servo.position.should == 180
+          expect(servo.position).to eq(180)
         end
 
         it 'should modulate when position > 180' do
           servo.position = 190
-          servo.position.should == 10
+          expect(servo.position).to eq(10)
         end
 
         it 'should write the new position to the board' do
-          board.should_receive(:servo_write).with(13, 10)
+          expect(board).to receive(:servo_write).with(13, 10)
           servo.position = 190
         end
       end
     end
   end
 end
-
diff --git a/spec/lib/components/setup/base_spec.rb b/spec/lib/components/setup/base_spec.rb
index ddf19f8e..b9164f1d 100644
--- a/spec/lib/components/setup/base_spec.rb
+++ b/spec/lib/components/setup/base_spec.rb
@@ -11,7 +11,7 @@ class BaseComponent
           include Base
         end
         subject { BaseComponent.new(options) }
-        
+
         describe '#initialize' do
           it 'should require a board' do
             expect {
@@ -20,7 +20,7 @@ class BaseComponent
           end
 
           it 'should register itself as a component on the board' do
-            board.should_receive(:add_component)
+            expect(board).to receive(:add_component)
             BaseComponent.new(options)
           end
         end
diff --git a/spec/lib/components/setup/input_spec.rb b/spec/lib/components/setup/input_spec.rb
index ab1f71b7..4e7c1df8 100644
--- a/spec/lib/components/setup/input_spec.rb
+++ b/spec/lib/components/setup/input_spec.rb
@@ -16,15 +16,15 @@ class InputComponent
         describe '#pullup=' do
           it 'should tell the board to set the pullup mode correctly' do
             subject
-            board.should_receive(:set_pullup).with(subject.pin, false)
+            expect(board).to receive(:set_pullup).with(subject.pin, false)
             subject.pullup = false
-            subject.pullup.should == false
+            expect(subject.pullup).to be(false)
           end
         end
 
         describe '#initialize_pins' do
           it 'should set the pin mode to in' do
-            board.should_receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :in)
+            expect(board).to receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :in)
             subject
           end
 
@@ -34,7 +34,7 @@ class InputComponent
           end
 
           it 'should tell the board to start reading' do
-            board.should_receive(:start_read)
+            expect(board).to receive(:start_read)
             subject
           end
         end
diff --git a/spec/lib/components/setup/multi_pin_spec.rb b/spec/lib/components/setup/multi_pin_spec.rb
index db4b4fad..c9645803 100644
--- a/spec/lib/components/setup/multi_pin_spec.rb
+++ b/spec/lib/components/setup/multi_pin_spec.rb
@@ -17,17 +17,17 @@ class MultiPinComponent
 
         describe "::require_pins" do
           it 'should add required pins to the @@required_pins class variable' do
-            MultiPinComponent.class_eval('@@required_pins').should == [:one, :two]
+            expect(MultiPinComponent.class_eval('@@required_pins')).to eq([:one, :two])
           end
         end
 
         describe "::proxy_pins" do
           it 'should automatically require the pin unless :optional is true' do
-            MultiPinComponent.class_eval('@@required_pins').should == [:one, :two]
+            expect(MultiPinComponent.class_eval('@@required_pins')).to eq([:one, :two])
           end
 
           it 'should add the pins to the @@proxied_pins class variable with the right classes' do
-            MultiPinComponent.class_eval('@@proxied_pins').should == {two: Basic::DigitalOutput, maybe: Basic::DigitalInput}
+            expect(MultiPinComponent.class_eval('@@proxied_pins')).to eq({two: Basic::DigitalOutput, maybe: Basic::DigitalInput})
           end
         end
 
@@ -47,25 +47,24 @@ class MultiPinComponent
 
         describe '#build_proxies' do
           it 'should create the correct proxy subcomponents' do
-            subject.proxies[:two].class.should == Basic::DigitalOutput
-            subject.proxies[:maybe].class.should == Basic::DigitalInput
+            expect(subject.proxies[:two].class).to equal(Basic::DigitalOutput)
+            expect(subject.proxies[:maybe].class).to equal(Basic::DigitalInput)
           end
 
           it 'should create an attr_accessor for each proxy' do
-            subject.two.class.should == Basic::DigitalOutput
-            subject.maybe.class.should == Basic::DigitalInput
+            expect(subject.two).to equal(subject.proxies[:two])
+            expect(subject.maybe).to equal(subject.proxies[:maybe])
           end
 
           it 'should attach the subcomponents to the right pins' do
-            subject.two.pin.should == 10
-            subject.maybe.pin.should == 11
-          end
+            expect(subject.two.pin).to eq(10)
+            expect(subject.maybe.pin).to eq(11)          end
         end
 
         describe '#states' do
           it 'should return a hash with the state of each subcomponent' do
             subject.two.high
-            subject.state.should == {two: board.high, maybe: nil}
+            expect(subject.state).to eq({two: board.high, maybe: nil})
           end
         end
       end
diff --git a/spec/lib/components/setup/output_spec.rb b/spec/lib/components/setup/output_spec.rb
index d2925487..8de06ff6 100644
--- a/spec/lib/components/setup/output_spec.rb
+++ b/spec/lib/components/setup/output_spec.rb
@@ -15,7 +15,7 @@ class OutputComponent
 
         describe '#initialize_pins' do
          it 'should set the pin mode to out' do
-            board.should_receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :out)
+            expect(board).to receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :out)
             subject
           end
         end
diff --git a/spec/lib/components/setup/single_pin_spec.rb b/spec/lib/components/setup/single_pin_spec.rb
index 9e7a70e2..d34c5584 100644
--- a/spec/lib/components/setup/single_pin_spec.rb
+++ b/spec/lib/components/setup/single_pin_spec.rb
@@ -11,7 +11,7 @@ class SinglePinComponent
           include SinglePin
         end
         subject { SinglePinComponent.new(options) }
-        
+
         describe '#initialize' do
           it 'should require a pin' do
             expect {
@@ -20,17 +20,17 @@ class SinglePinComponent
           end
 
           it 'should convert the pin to an integer' do
-            board.should_receive(:convert_pin).with(options[:pin])
+            expect(board).to receive(:convert_pin).with(options[:pin])
             component = SinglePinComponent.new(options)
           end
         end
 
         describe '#mode=' do
           it 'should tell the board to set the pin mode' do
-            board.should_receive(:set_pin_mode).with(subject.pin, :out)
+            expect(board).to receive(:set_pin_mode).with(subject.pin, :out)
 
             subject.send(:mode=, :out)
-            subject.mode.should == :out
+            expect(subject.mode).to eq(:out)
           end
         end
       end
diff --git a/spec/lib/components/shift_register_spec.rb b/spec/lib/components/shift_register_spec.rb
index 826f91ce..246ae490 100644
--- a/spec/lib/components/shift_register_spec.rb
+++ b/spec/lib/components/shift_register_spec.rb
@@ -9,9 +9,9 @@ module Components
 
       describe '#initialize' do
         it 'should create a BaseOutput instance for each pin' do
-          subject.clock.class.should == Basic::DigitalOutput
-          subject.latch.class.should == Basic::DigitalOutput
-          subject.data.class.should == Basic::DigitalOutput
+          expect(subject.clock.class).to eq(Basic::DigitalOutput)
+          expect(subject.latch.class).to eq(Basic::DigitalOutput)
+          expect(subject.data.class).to eq(Basic::DigitalOutput)
         end
       end
 
@@ -19,18 +19,18 @@ module Components
         before(:each) { subject }
 
         it 'should write a single byte as value and clock pin as aux to the data pin' do
-          subject.latch.should_receive(:digital_write).with(board.low)
-          board.should_receive(:write).with "11.11.255.12\n"
-          subject.latch.should_receive(:digital_write).with(board.high)
+          expect(subject.latch).to receive(:digital_write).with(board.low)
+          expect(board).to receive(:write).with "11.11.255.12\n"
+          expect(subject.latch).to receive(:digital_write).with(board.high)
 
           subject.write(255)
         end
 
         it 'should write an array of bytes as value and clock pin as aux to the data pin' do
-          subject.latch.should_receive(:digital_write).with(board.low)
-          board.should_receive(:write).with "11.11.255.12\n"
-          board.should_receive(:write).with "11.11.0.12\n"
-          subject.latch.should_receive(:digital_write).with(board.high)
+          expect(subject.latch).to receive(:digital_write).with(board.low)
+          expect(board).to receive(:write).with "11.11.255.12\n"
+          expect(board).to receive(:write).with "11.11.0.12\n"
+          expect(subject.latch).to receive(:digital_write).with(board.high)
 
           subject.write([255,0])
         end
diff --git a/spec/lib/components/softwareserial_spec.rb b/spec/lib/components/softwareserial_spec.rb
index 05225b86..440a2627 100644
--- a/spec/lib/components/softwareserial_spec.rb
+++ b/spec/lib/components/softwareserial_spec.rb
@@ -8,16 +8,16 @@ module Components
       subject { SoftwareSerial.new board: board, pins: { rx: 10, tx: 11 }, baud: 4800 }
 
       before do
-        board.should_receive(:write).with("12..0.10,11\n")
-        board.should_receive(:write).with("12..1.4800\n")
+        expect(board).to receive(:write).with("12..0.10,11\n")
+        expect(board).to receive(:write).with("12..1.4800\n")
       end
 
       describe '#puts' do
         it 'prints a string to the serial interface' do
-          board.should_receive(:write).with "12..3.Testing\n"
+          expect(board).to receive(:write).with "12..3.Testing\n"
           subject.puts("Testing")
         end
       end
     end
   end
-end
\ No newline at end of file
+end
diff --git a/spec/lib/components/ssd_spec.rb b/spec/lib/components/ssd_spec.rb
index fd3d6367..b5ead4f5 100644
--- a/spec/lib/components/ssd_spec.rb
+++ b/spec/lib/components/ssd_spec.rb
@@ -12,24 +12,28 @@ module Components
           subject
 
           segments = [:a, :b, :c, :d, :e, :f, :g]
-          segments.each { |segment| subject.proxies[segment].class.should == Basic::DigitalOutput}
+          segments.each do |segment|
+            expect(subject.proxies[segment].class).to equal(Basic::DigitalOutput)
+          end
         end
 
         it "should clear the display" do
-          SSD.any_instance.should_receive(:clear).once
-          SSD.new(board: board, pins: pins)
+          expect(subject).to receive(:clear).once
+          subject.send(:initialize, {board: board, pins: pins})
         end
 
         it "should turn on the display" do
-          SSD.any_instance.should_receive(:on).once
-          SSD.new(board: board, pins: pins)
+          expect(subject).to receive(:on).once
+          subject.send(:initialize, {board: board, pins: pins})
         end
       end
 
       describe '#clear' do
         it 'should toggle all the seven leds to off' do
           segments = [:a, :b, :c, :d, :e, :f, :g]
-          segments.each { |segment| subject.proxies[segment].should_receive(:high) }
+          segments.each do |segment|
+            expect(subject.proxies[segment]).to receive(:high)
+          end
 
           subject.clear
         end
@@ -37,31 +41,31 @@ module Components
 
       describe '#on' do
         it 'should turn the ssd on' do
-          subject.anode.should_receive(:digital_write).with(board.high)
+          expect(subject.anode).to receive(:digital_write).with(board.high)
           subject.on
         end
       end
 
       describe '#off' do
         it 'should turn the ssd off' do
-          subject.anode.should_receive(:digital_write).with(board.low)
+          expect(subject.anode).to receive(:digital_write).with(board.low)
           subject.off
         end
       end
 
       describe '#display' do
         it "should scroll on multiple characters" do
-          subject.should_receive(:scroll).with('foo')
+          expect(subject).to receive(:scroll).with('foo')
           subject.display('foo')
         end
 
         it "should make sure the ssd is turned on" do
-          subject.should_receive(:on)
+          expect(subject).to receive(:on)
           subject.display(1)
         end
 
         it "should clear the display on unknown character" do
-          subject.should_receive(:clear)
+          expect(subject).to receive(:clear)
           subject.display('+')
         end
       end
diff --git a/spec/lib/components/stepper_spec.rb b/spec/lib/components/stepper_spec.rb
index 673420aa..b4407123 100644
--- a/spec/lib/components/stepper_spec.rb
+++ b/spec/lib/components/stepper_spec.rb
@@ -9,17 +9,17 @@ module Components
       subject { Stepper.new(options) }
 
       describe '#initialize' do
-        it 'should create a BaseOutput instance for each pin' do          
-          subject.step.class.should == Basic::DigitalOutput
-          subject.direction.class.should == Basic::DigitalOutput
+        it 'should create a BaseOutput instance for each pin' do
+          expect(subject.step.class).to equal(Basic::DigitalOutput)
+          expect(subject.direction.class).to equal(Basic::DigitalOutput)
         end
       end
 
       describe '#step_cc' do
         it 'should send high to the step pin with the direction pin high' do
-          subject.direction.should_receive(:digital_write).with(board.high)
-          subject.step.should_receive(:digital_write).with(board.high)
-          subject.step.should_receive(:digital_write).with(board.low)
+          expect(subject.direction).to receive(:digital_write).with(board.high)
+          expect(subject.step).to receive(:digital_write).with(board.high)
+          expect(subject.step).to receive(:digital_write).with(board.low)
 
           subject.step_cc
         end
@@ -27,9 +27,9 @@ module Components
 
       describe '#step_cw' do
         it 'should send high to the board with the direction pin low' do
-          subject.direction.should_receive(:digital_write).with(board.low)
-          subject.step.should_receive(:digital_write).with(board.high)
-          subject.step.should_receive(:digital_write).with(board.low)
+          expect(subject.direction).to receive(:digital_write).with(board.low)
+          expect(subject.step).to receive(:digital_write).with(board.high)
+          expect(subject.step).to receive(:digital_write).with(board.low)
 
           subject.step_cw
         end
diff --git a/spec/lib/message_spec.rb b/spec/lib/message_spec.rb
index 99dd8aaa..4750f559 100644
--- a/spec/lib/message_spec.rb
+++ b/spec/lib/message_spec.rb
@@ -26,21 +26,21 @@ module Dino
       end
 
       it 'should build messages correctly' do
-        Dino::Message.encode(command: 1, pin: 1, value: 1).should == "1.1.1\n"
-        Dino::Message.encode(command: 1, pin: 1).should == "1.1\n"
-        Dino::Message.encode(command: 1, value: 1).should == "1..1\n"
-        Dino::Message.encode(command: 1).should == "1\n"
-        Dino::Message.encode(command: 1, pin: 1, value: 1, aux_message: "Some Text").should == "1.1.1.Some Text\n"
-        Dino::Message.encode(command: 1, aux_message: "Some Text").should == "1...Some Text\n"
-        Dino::Message.encode(command: 1, value: 1, aux_message: "Some Text").should == "1..1.Some Text\n"
+        expect(Dino::Message.encode command: 1, pin: 1, value: 1  ).to eq("1.1.1\n")
+        expect(Dino::Message.encode command: 1, pin: 1            ).to eq("1.1\n")
+        expect(Dino::Message.encode command: 1, value: 1          ).to eq("1..1\n")
+        expect(Dino::Message.encode command: 1                    ).to eq("1\n")
+        expect(Dino::Message.encode command: 1, pin: 1, value: 1, aux_message: "Some Text" ).to eq("1.1.1.Some Text\n")
+        expect(Dino::Message.encode command: 1, aux_message: "Some Text"                   ).to eq("1...Some Text\n")
+        expect(Dino::Message.encode command: 1, value: 1, aux_message: "Some Text"         ).to eq("1..1.Some Text\n")
       end
 
       it 'should escape newlines inside aux message' do
-        Dino::Message.encode(command: 1, aux_message: "line1\nline2").should == "1...line1\\\nline2\n"
+        expect(Dino::Message.encode command: 1, aux_message: "line1\nline2").to eq("1...line1\\\nline2\n")
       end
 
       it 'should escape backslashes inside aux message' do
-        Dino::Message.encode(command: 1, aux_message: "line1\\line2").should == "1...line1\\\\line2\n"
+        expect(Dino::Message.encode command: 1, aux_message: "line1\\line2").to eq("1...line1\\\\line2\n")
       end
     end
   end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index 00826a2f..5cc1535b 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -42,7 +42,7 @@ module Dino
         expect(subject).to receive(:tty_devices).once.and_return(['/dev/tty.ACM0'])
         expect(::Serial).to receive(:new).and_return(mock_serial = double)
         3.times { subject.io }
-        subject.io.should == mock_serial
+        expect(subject.io).to equal(mock_serial)
       end
 
       it 'should raise a BoardNotFound exception if there is no board connected' do

From 8976767ccc271b8482fd77c319a2060be3b28f15 Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Tue, 3 Mar 2015 00:21:17 -0400
Subject: [PATCH 083/296] Test the Callbacks mixin properly

---
 lib/dino/components/mixins/callbacks.rb       |  2 +-
 .../components/basic/digital_input_spec.rb    |  6 --
 spec/lib/components/mixins/callbacks_spec.rb  | 81 +++++++++++++++++++
 3 files changed, 82 insertions(+), 7 deletions(-)
 create mode 100644 spec/lib/components/mixins/callbacks_spec.rb

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index eb3a1c3c..8084ea24 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -3,7 +3,7 @@ module Components
     module Mixins
       module Callbacks
         def after_initialize(options={})
-          super(options)
+          super(options) if defined?(super)
           @callbacks = {}
           @callback_mutex = Mutex.new
         end
diff --git a/spec/lib/components/basic/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
index 8a2087c3..e4daad23 100644
--- a/spec/lib/components/basic/digital_input_spec.rb
+++ b/spec/lib/components/basic/digital_input_spec.rb
@@ -29,12 +29,6 @@ module Basic
 
         context 'callbacks' do
           before :each do
-            # Simulate the mutex
-            mutex = double
-            allow(mutex).to receive(:synchronize).and_yield
-            subject.instance_variable_set(:@callback_mutex, mutex)
-            subject.instance_variable_set(:@callbacks, {}) 
-
             @low_callback = double
             @high_callback = double
             subject.on_low { @low_callback.called }
diff --git a/spec/lib/components/mixins/callbacks_spec.rb b/spec/lib/components/mixins/callbacks_spec.rb
new file mode 100644
index 00000000..5f0186a6
--- /dev/null
+++ b/spec/lib/components/mixins/callbacks_spec.rb
@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Mixins
+      describe Callbacks do
+
+        class CallbackComponent
+          include Callbacks
+          def initialize; after_initialize; end
+        end
+        subject { CallbackComponent.new }
+
+        describe '#initialize' do
+          it 'should have an empty hash to hold callbacks' do
+            expect(subject.instance_variable_get :@callbacks).to eq({})
+          end
+
+          it 'should have a mutex to protect access to the hash' do
+            expect(subject.instance_variable_get(:@callback_mutex).class).to equal(Mutex)
+          end
+        end
+
+        describe '#add_callback' do
+          it 'should atomically add a callback to the hash' do
+            expect(subject.instance_variable_get :@callback_mutex).to receive(:synchronize).once.and_yield
+            callback = Proc.new{}
+            subject.add_callback(&callback)
+            expect(subject.instance_variable_get :@callbacks).to eq({persistent: [callback]})
+          end
+
+          it 'should add callbacks under arbitrary keys' do
+            callback = Proc.new{}
+            subject.add_callback(:key, &callback)
+            expect(subject.instance_variable_get :@callbacks).to eq({key: [callback]})
+          end
+        end
+
+        context 'with callbacks added' do
+          before :each do
+            @callback1 = Proc.new{}
+            @callback2 = Proc.new{}
+            subject.add_callback(&@callback1)
+            subject.add_callback(:read, &@callback2)
+          end
+
+          describe '#remove_callback' do
+            it 'should remove all callbacks if no key given' do
+              subject.remove_callbacks
+              expect(subject.instance_variable_get :@callbacks).to eq({})
+            end
+
+            it 'should remove only callbacks for a specific key given' do
+              subject.remove_callbacks(:read)
+              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq([])
+              expect(subject.instance_variable_get(:@callbacks)[:persistent]).to_not eq([])
+            end
+          end
+
+          describe '#update' do
+            it 'should set the @state variable' do
+              subject.update("thing")
+              expect(subject.instance_variable_get :@state).to eq("thing")
+            end
+
+            it 'should call all the callbacks' do
+              expect(@callback1).to receive(:call).once
+              expect(@callback2).to receive(:call).once
+              subject.update("data")
+            end
+
+            it 'should remove any callbacks saved with the key :read' do
+              subject.update("data")
+              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq([])
+            end
+          end
+        end
+      end
+    end
+  end
+end

From a00e3b4e0a49351a579e676014a8cba64e0561fe Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Tue, 3 Mar 2015 14:04:15 -0400
Subject: [PATCH 084/296] Don't need to #chop trailing \n from messages

---
 lib/dino/tx_rx/base.rb        | 4 ++--
 spec/lib/tx_rx/serial_spec.rb | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index cb58b0c6..fee04990 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -15,7 +15,7 @@ def io
       def _read
         line = gets
         if line && line.match(/\A\d+:/)
-          pin, message = line.chop.split(/:/)
+          pin, message = line.split(/:/)
           pin && message && changed && notify_observers(pin, message)
         else
           sleep 0.005
@@ -43,7 +43,7 @@ def handshake
                 if line && line.match(/ACK:/)
                   puts "Connected to board..."
                   flush_read
-                  return line.chop.split(/:/)[1]
+                  return line.split(/:/)[1]
                 end
               end
             end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index 5cc1535b..7a2eb07d 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -53,7 +53,7 @@ module Dino
 
     describe '#_read' do
       it 'should notify observers on change' do
-        expect(subject).to receive(:gets).and_return("02:00\n")
+        expect(subject).to receive(:gets).and_return("02:00")
         expect(subject).to receive(:changed).and_return(true)
         expect(subject).to receive(:notify_observers).with('02','00')
         subject._read

From 512e3186ac223ae7e998259e423894170fc9bd2c Mon Sep 17 00:00:00 2001
From: Vickash <vickashmahabir@gmail.com>
Date: Tue, 3 Mar 2015 14:26:08 -0400
Subject: [PATCH 085/296] TCP lines need \n removed though

---
 lib/dino/tx_rx/tcp.rb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/dino/tx_rx/tcp.rb b/lib/dino/tx_rx/tcp.rb
index c8783135..edeb1125 100644
--- a/lib/dino/tx_rx/tcp.rb
+++ b/lib/dino/tx_rx/tcp.rb
@@ -15,7 +15,7 @@ def write(message)
           end
         end
       end
-    
+
     private
 
       def connect
@@ -25,7 +25,7 @@ def connect
       end
 
       def gets(timeout=0.005)
-        IO.select([io], nil, nil, timeout) && io.gets
+        IO.select([io], nil, nil, timeout) && io.gets.gsub(/\n\z/, "")
       end
     end
   end

From 8858b6396945b8971ed6f1f75a20430dd5a71664 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 23 Mar 2016 17:20:03 -0400
Subject: [PATCH 086/296] Make sure one wire library gets copied when
 generating a sketch

---
 lib/dino_cli/generator.rb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index b5a234fc..6a2103d1 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,6 +1,6 @@
 class DinoCLI::Generator
   require "fileutils"
-  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h"]
+  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h", "OneWire.cpp", "OneWire.h"]
   attr_accessor :options
 
   def initialize(options={})
@@ -16,7 +16,7 @@ def self.run!(options={})
   end
 
   def read
-    @libs = LIB_FILENAMES.map do |f| 
+    @libs = LIB_FILENAMES.map do |f|
       File.read(File.join(options[:src_dir], "lib", f))
     end
     @sketch = File.read File.join(options[:src_dir], sketch_filename)

From 23921aa8b1097255e537b27990ef244a4f98115b Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 23 Mar 2016 17:20:18 -0400
Subject: [PATCH 087/296] Use latest version of one wire library

---
 src/lib/OneWire.cpp |  28 +++++++--
 src/lib/OneWire.h   | 148 +++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 169 insertions(+), 7 deletions(-)
 mode change 100644 => 100755 src/lib/OneWire.cpp
 mode change 100644 => 100755 src/lib/OneWire.h

diff --git a/src/lib/OneWire.cpp b/src/lib/OneWire.cpp
old mode 100644
new mode 100755
index 631813f8..efd69491
--- a/src/lib/OneWire.cpp
+++ b/src/lib/OneWire.cpp
@@ -12,6 +12,11 @@ works on OneWire every 6 to 12 months.  Patches usually wait that
 long.  If anyone is interested in more actively maintaining OneWire,
 please contact Paul.
 
+Version 2.3:
+  Unknonw chip fallback mode, Roger Clark
+  Teensy-LC compatibility, Paul Stoffregen
+  Search bug fix, Love Nystrom
+
 Version 2.2:
   Teensy 3.0 compatibility, Paul Stoffregen, paul@pjrc.com
   Arduino Due compatibility, http://arduino.cc/forum/index.php?topic=141030
@@ -339,7 +344,7 @@ void OneWire::target_search(uint8_t family_code)
 // Return TRUE  : device found, ROM number in ROM_NO buffer
 //        FALSE : device not found, end of search
 //
-uint8_t OneWire::search(uint8_t *newAddr)
+uint8_t OneWire::search(uint8_t *newAddr, bool search_mode /* = true */)
 {
    uint8_t id_bit_number;
    uint8_t last_zero, rom_byte_number, search_result;
@@ -368,7 +373,11 @@ uint8_t OneWire::search(uint8_t *newAddr)
       }
 
       // issue the search command
-      write(0xF0);
+      if (search_mode == true) {
+        write(0xF0);   // NORMAL SEARCH
+      } else {
+        write(0xEC);   // CONDITIONAL SEARCH
+      }
 
       // loop to do the search
       do
@@ -452,8 +461,9 @@ uint8_t OneWire::search(uint8_t *newAddr)
       LastDeviceFlag = FALSE;
       LastFamilyDiscrepancy = 0;
       search_result = FALSE;
+   } else {
+      for (int i = 0; i < 8; i++) newAddr[i] = ROM_NO[i];
    }
-   for (int i = 0; i < 8; i++) newAddr[i] = ROM_NO[i];
    return search_result;
   }
 
@@ -509,8 +519,11 @@ uint8_t OneWire::crc8(const uint8_t *addr, uint8_t len)
 uint8_t OneWire::crc8(const uint8_t *addr, uint8_t len)
 {
 	uint8_t crc = 0;
-	
+
 	while (len--) {
+#if defined(__AVR__)
+		crc = _crc_ibutton_update(crc, *addr++);
+#else
 		uint8_t inbyte = *addr++;
 		for (uint8_t i = 8; i; i--) {
 			uint8_t mix = (crc ^ inbyte) & 0x01;
@@ -518,6 +531,7 @@ uint8_t OneWire::crc8(const uint8_t *addr, uint8_t len)
 			if (mix) crc ^= 0x8C;
 			inbyte >>= 1;
 		}
+#endif
 	}
 	return crc;
 }
@@ -532,6 +546,11 @@ bool OneWire::check_crc16(const uint8_t* input, uint16_t len, const uint8_t* inv
 
 uint16_t OneWire::crc16(const uint8_t* input, uint16_t len, uint16_t crc)
 {
+#if defined(__AVR__)
+    for (uint16_t i = 0 ; i < len ; i++) {
+        crc = _crc16_update(crc, input[i]);
+    }
+#else
     static const uint8_t oddparity[16] =
         { 0, 1, 1, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0 };
 
@@ -550,6 +569,7 @@ uint16_t OneWire::crc16(const uint8_t* input, uint16_t len, uint16_t crc)
       cdata <<= 1;
       crc ^= cdata;
     }
+#endif
     return crc;
 }
 #endif
diff --git a/src/lib/OneWire.h b/src/lib/OneWire.h
old mode 100644
new mode 100755
index 916c5290..b66b7eba
--- a/src/lib/OneWire.h
+++ b/src/lib/OneWire.h
@@ -3,6 +3,10 @@
 
 #include <inttypes.h>
 
+#if defined(__AVR__)
+#include <util/crc16.h>
+#endif
+
 #if ARDUINO >= 100
 #include "Arduino.h"       // for delayMicroseconds, digitalPinToBitMask, etc
 #else
@@ -45,8 +49,12 @@
 #define ONEWIRE_CRC16 1
 #endif
 
+#ifndef FALSE
 #define FALSE 0
+#endif
+#ifndef TRUE
 #define TRUE  1
+#endif
 
 // Platform specific I/O definitions
 
@@ -61,7 +69,7 @@
 #define DIRECT_WRITE_LOW(base, mask)    ((*((base)+2)) &= ~(mask))
 #define DIRECT_WRITE_HIGH(base, mask)   ((*((base)+2)) |= (mask))
 
-#elif defined(__MK20DX128__)
+#elif defined(__MK20DX128__) || defined(__MK20DX256__) || defined(__MK66FX1M0__) || defined(__MK64FX512__)
 #define PIN_TO_BASEREG(pin)             (portOutputRegister(pin))
 #define PIN_TO_BITMASK(pin)             (1)
 #define IO_REG_TYPE uint8_t
@@ -72,6 +80,17 @@
 #define DIRECT_WRITE_LOW(base, mask)    (*((base)+256) = 1)
 #define DIRECT_WRITE_HIGH(base, mask)   (*((base)+128) = 1)
 
+#elif defined(__MKL26Z64__)
+#define PIN_TO_BASEREG(pin)             (portOutputRegister(pin))
+#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
+#define IO_REG_TYPE uint8_t
+#define IO_REG_ASM
+#define DIRECT_READ(base, mask)         ((*((base)+16) & (mask)) ? 1 : 0)
+#define DIRECT_MODE_INPUT(base, mask)   (*((base)+20) &= ~(mask))
+#define DIRECT_MODE_OUTPUT(base, mask)  (*((base)+20) |= (mask))
+#define DIRECT_WRITE_LOW(base, mask)    (*((base)+8) = (mask))
+#define DIRECT_WRITE_HIGH(base, mask)   (*((base)+4) = (mask))
+
 #elif defined(__SAM3X8E__)
 // Arduino 1.5.1 may have a bug in delayMicroseconds() on Arduino Due.
 // http://arduino.cc/forum/index.php/topic,141030.msg1076268.html#msg1076268
@@ -104,8 +123,131 @@
 #define DIRECT_WRITE_LOW(base, mask)    ((*(base+8+1)) = (mask))          //LATXCLR  + 0x24
 #define DIRECT_WRITE_HIGH(base, mask)   ((*(base+8+2)) = (mask))          //LATXSET + 0x28
 
+#elif defined(ARDUINO_ARCH_ESP8266)
+#define PIN_TO_BASEREG(pin)             ((volatile uint32_t*) GPO)
+#define PIN_TO_BITMASK(pin)             (1 << pin)
+#define IO_REG_TYPE uint32_t
+#define IO_REG_ASM
+#define DIRECT_READ(base, mask)         ((GPI & (mask)) ? 1 : 0)    //GPIO_IN_ADDRESS
+#define DIRECT_MODE_INPUT(base, mask)   (GPE &= ~(mask))            //GPIO_ENABLE_W1TC_ADDRESS
+#define DIRECT_MODE_OUTPUT(base, mask)  (GPE |= (mask))             //GPIO_ENABLE_W1TS_ADDRESS
+#define DIRECT_WRITE_LOW(base, mask)    (GPOC = (mask))             //GPIO_OUT_W1TC_ADDRESS
+#define DIRECT_WRITE_HIGH(base, mask)   (GPOS = (mask))             //GPIO_OUT_W1TS_ADDRESS
+
+#elif defined(__SAMD21G18A__)
+#define PIN_TO_BASEREG(pin)             portModeRegister(digitalPinToPort(pin))
+#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
+#define IO_REG_TYPE uint32_t
+#define IO_REG_ASM
+#define DIRECT_READ(base, mask)         (((*((base)+8)) & (mask)) ? 1 : 0)
+#define DIRECT_MODE_INPUT(base, mask)   ((*((base)+1)) = (mask))
+#define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+2)) = (mask))
+#define DIRECT_WRITE_LOW(base, mask)    ((*((base)+5)) = (mask))
+#define DIRECT_WRITE_HIGH(base, mask)   ((*((base)+6)) = (mask))
+
+#elif defined(RBL_NRF51822)
+#define PIN_TO_BASEREG(pin)             (0)
+#define PIN_TO_BITMASK(pin)             (pin)
+#define IO_REG_TYPE uint32_t
+#define IO_REG_ASM
+#define DIRECT_READ(base, pin)          nrf_gpio_pin_read(pin)
+#define DIRECT_WRITE_LOW(base, pin)     nrf_gpio_pin_clear(pin)
+#define DIRECT_WRITE_HIGH(base, pin)    nrf_gpio_pin_set(pin)
+#define DIRECT_MODE_INPUT(base, pin)    nrf_gpio_cfg_input(pin, NRF_GPIO_PIN_NOPULL)
+#define DIRECT_MODE_OUTPUT(base, pin)   nrf_gpio_cfg_output(pin)
+
+#elif defined(__arc__) /* Arduino101/Genuino101 specifics */
+
+#include "scss_registers.h"
+#include "portable.h"
+#include "avr/pgmspace.h"
+
+#define GPIO_ID(pin)			(g_APinDescription[pin].ulGPIOId)
+#define GPIO_TYPE(pin)			(g_APinDescription[pin].ulGPIOType)
+#define GPIO_BASE(pin)			(g_APinDescription[pin].ulGPIOBase)
+#define DIR_OFFSET_SS			0x01
+#define DIR_OFFSET_SOC			0x04
+#define EXT_PORT_OFFSET_SS		0x0A
+#define EXT_PORT_OFFSET_SOC		0x50
+
+/* GPIO registers base address */
+#define PIN_TO_BASEREG(pin)		((volatile uint32_t *)g_APinDescription[pin].ulGPIOBase)
+#define PIN_TO_BITMASK(pin)		pin
+#define IO_REG_TYPE			uint32_t
+#define IO_REG_ASM
+
+static inline __attribute__((always_inline))
+IO_REG_TYPE directRead(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
+{
+    IO_REG_TYPE ret;
+    if (SS_GPIO == GPIO_TYPE(pin)) {
+        ret = READ_ARC_REG(((IO_REG_TYPE)base + EXT_PORT_OFFSET_SS));
+    } else {
+        ret = MMIO_REG_VAL_FROM_BASE((IO_REG_TYPE)base, EXT_PORT_OFFSET_SOC);
+    }
+    return ((ret >> GPIO_ID(pin)) & 0x01);
+}
+
+static inline __attribute__((always_inline))
+void directModeInput(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
+{
+    if (SS_GPIO == GPIO_TYPE(pin)) {
+        WRITE_ARC_REG(READ_ARC_REG((((IO_REG_TYPE)base) + DIR_OFFSET_SS)) & ~(0x01 << GPIO_ID(pin)),
+			((IO_REG_TYPE)(base) + DIR_OFFSET_SS));
+    } else {
+        MMIO_REG_VAL_FROM_BASE((IO_REG_TYPE)base, DIR_OFFSET_SOC) &= ~(0x01 << GPIO_ID(pin));
+    }
+}
+
+static inline __attribute__((always_inline))
+void directModeOutput(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
+{
+    if (SS_GPIO == GPIO_TYPE(pin)) {
+        WRITE_ARC_REG(READ_ARC_REG(((IO_REG_TYPE)(base) + DIR_OFFSET_SS)) | (0x01 << GPIO_ID(pin)),
+			((IO_REG_TYPE)(base) + DIR_OFFSET_SS));
+    } else {
+        MMIO_REG_VAL_FROM_BASE((IO_REG_TYPE)base, DIR_OFFSET_SOC) |= (0x01 << GPIO_ID(pin));
+    }
+}
+
+static inline __attribute__((always_inline))
+void directWriteLow(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
+{
+    if (SS_GPIO == GPIO_TYPE(pin)) {
+        WRITE_ARC_REG(READ_ARC_REG(base) & ~(0x01 << GPIO_ID(pin)), base);
+    } else {
+        MMIO_REG_VAL(base) &= ~(0x01 << GPIO_ID(pin));
+    }
+}
+
+static inline __attribute__((always_inline))
+void directWriteHigh(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
+{
+    if (SS_GPIO == GPIO_TYPE(pin)) {
+        WRITE_ARC_REG(READ_ARC_REG(base) | (0x01 << GPIO_ID(pin)), base);
+    } else {
+        MMIO_REG_VAL(base) |= (0x01 << GPIO_ID(pin));
+    }
+}
+
+#define DIRECT_READ(base, pin)		directRead(base, pin)
+#define DIRECT_MODE_INPUT(base, pin)	directModeInput(base, pin)
+#define DIRECT_MODE_OUTPUT(base, pin)	directModeOutput(base, pin)
+#define DIRECT_WRITE_LOW(base, pin)	directWriteLow(base, pin)
+#define DIRECT_WRITE_HIGH(base, pin)	directWriteHigh(base, pin)
+
 #else
-#error "Please define I/O register types here"
+#define PIN_TO_BASEREG(pin)             (0)
+#define PIN_TO_BITMASK(pin)             (pin)
+#define IO_REG_TYPE unsigned int
+#define IO_REG_ASM
+#define DIRECT_READ(base, pin)          digitalRead(pin)
+#define DIRECT_WRITE_LOW(base, pin)     digitalWrite(pin, LOW)
+#define DIRECT_WRITE_HIGH(base, pin)    digitalWrite(pin, HIGH)
+#define DIRECT_MODE_INPUT(base, pin)    pinMode(pin,INPUT)
+#define DIRECT_MODE_OUTPUT(base, pin)   pinMode(pin,OUTPUT)
+#warning "OneWire. Fallback mode. Using API calls for pinMode,digitalRead and digitalWrite. Operation of this library is not guaranteed on this architecture."
+
 #endif
 
 
@@ -178,7 +320,7 @@ class OneWire
     // might be a good idea to check the CRC to make sure you didn't
     // get garbage.  The order is deterministic. You will always get
     // the same devices in the same order.
-    uint8_t search(uint8_t *newAddr);
+    uint8_t search(uint8_t *newAddr, bool search_mode = true);
 #endif
 
 #if ONEWIRE_CRC

From 5af5c1804f5c8a93e24962c3bbac1cc0cc211a35 Mon Sep 17 00:00:00 2001
From: Vickash Mahabir <vickashmahabir@gmail.com>
Date: Wed, 23 Mar 2016 17:20:43 -0400
Subject: [PATCH 088/296] Small hack to avoid string -> char* conversion
 deprecation in latest Arduino IDE

---
 src/lib/Dino.cpp |  3 ++-
 src/lib/Dino.h   | 13 +++++++------
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 7cca89a1..a54004c5 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -17,6 +17,7 @@ DHT dht;
 #endif
 
 Dino::Dino(){
+  newline[0] = '\n'; newline[1] = '\0';
   messageFragments[0] = cmdStr;
   messageFragments[1] = pinStr;
   messageFragments[2] = valStr;
@@ -117,7 +118,7 @@ void Dino::setupWrite(void (*writeCallback)(char *str)) {
 }
 void Dino::writeResponse() {
   _writeCallback(response);
-  _writeCallback("\n");
+  _writeCallback(newline);
 }
 
 // LISTNENERS
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index eb0364bf..b43733fb 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -38,7 +38,7 @@ class Dino {
     void setupWrite(void (*writeCallback)(char *str));
     void parse(char c);
     void updateListeners();
-    
+
   private:
     // API-accessible functions.
     void setMode               ();  //cmd = 0
@@ -60,7 +60,7 @@ class Dino {
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
     void setHeartRate          ();  //cmd = 98
-  
+
     // Parser state storage and utility functions.
     char *messageFragments[4];
     byte fragmentIndex;
@@ -68,7 +68,7 @@ class Dino {
     boolean backslash;
     void append(char c);
     void process();
-    
+
     // Parsed message storage.
     char cmdStr[5]; int cmd;
     char pinStr[5]; int pin;
@@ -78,7 +78,8 @@ class Dino {
     // Value and response storage.
     int rval;
     char response[16];
-    
+    char newline[2];
+
     // Use a write callback from the main sketch to respond.
     void (*_writeCallback)(char *str);
     void writeResponse();
@@ -92,11 +93,11 @@ class Dino {
     unsigned int loopCount;
     unsigned int analogDivider;
     long timeSince (long event);
-    
+
     // Listeners correspond to raw pin number by array index, and store boolean. false == disabled.
     boolean analogListeners[PIN_COUNT];
     boolean digitalListeners[PIN_COUNT];
-    
+
     // Keep track of the last read values for digital listeners. Only write responses when changed.
     byte digitalListenerValues[PIN_COUNT];
 

From a7f29b7711498fdb3be92e4e3489d9d16d333fc8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 11 Sep 2017 11:13:27 -0400
Subject: [PATCH 089/296] Add the modified IRremote library as a submodule

---
 .gitmodules                 | 3 +++
 src/vendor/Arduino-IRremote | 1 +
 2 files changed, 4 insertions(+)
 create mode 100644 .gitmodules
 create mode 160000 src/vendor/Arduino-IRremote

diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 00000000..ae49a950
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "src/vendor/Arduino-IRremote"]
+	path = src/vendor/Arduino-IRremote
+	url = https://github.com/vickash/Arduino-IRremote.git
diff --git a/src/vendor/Arduino-IRremote b/src/vendor/Arduino-IRremote
new file mode 160000
index 00000000..34fab166
--- /dev/null
+++ b/src/vendor/Arduino-IRremote
@@ -0,0 +1 @@
+Subproject commit 34fab166bb1021f050e80cfceb7acc0e01360a3e

From 76ad10264f927b392aa36ec575e62b87e0254606 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 11 Sep 2017 11:57:01 -0400
Subject: [PATCH 090/296] Arduino half of infrared send. Reorganize lib/vendor
 folders for sketches

---
 lib/dino_cli/generator.rb               | 24 +++++++++++++++++++++---
 src/lib/Dino.cpp                        |  9 +++++++++
 src/lib/Dino.h                          |  4 +++-
 src/{lib => vendor/DHT}/DHT.cpp         |  0
 src/{lib => vendor/DHT}/DHT.h           |  0
 src/{lib => vendor/OneWire}/OneWire.cpp |  0
 src/{lib => vendor/OneWire}/OneWire.h   |  0
 7 files changed, 33 insertions(+), 4 deletions(-)
 rename src/{lib => vendor/DHT}/DHT.cpp (100%)
 rename src/{lib => vendor/DHT}/DHT.h (100%)
 rename src/{lib => vendor/OneWire}/OneWire.cpp (100%)
 rename src/{lib => vendor/OneWire}/OneWire.h (100%)

diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 6a2103d1..78a2039e 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,6 +1,24 @@
 class DinoCLI::Generator
   require "fileutils"
-  LIB_FILENAMES = ["Dino.h", "Dino.cpp", "DinoLCD.h", "DinoLCD.cpp", "DinoSerial.cpp","DinoSerial.h", "DHT.cpp", "DHT.h", "OneWire.cpp", "OneWire.h"]
+  LIB_FILENAMES =  [
+                    "lib/Dino.cpp",
+                    "lib/Dino.h",
+                    "lib/DinoLCD.cpp",
+                    "lib/DinoLCD.h",
+                    "lib/DinoSerial.cpp",
+                    "lib/DinoSerial.h",
+
+                    "vendor/DHT/DHT.cpp",
+                    "vendor/DHT/DHT.h",
+                    "vendor/OneWire/OneWire.cpp",
+                    "vendor/OneWire/OneWire.h",
+                    "vendor/Arduino-IRremote/boarddefs.h",
+                    "vendor/Arduino-IRremote/IRremote.cpp",
+                    "vendor/Arduino-IRremote/IRremote.h",
+                    "vendor/Arduino-IRremote/IRremoteInt.h",
+                    "vendor/Arduino-IRremote/irSend.cpp"
+                  ]
+
   attr_accessor :options
 
   def initialize(options={})
@@ -17,7 +35,7 @@ def self.run!(options={})
 
   def read
     @libs = LIB_FILENAMES.map do |f|
-      File.read(File.join(options[:src_dir], "lib", f))
+      File.read(File.join(options[:src_dir], f))
     end
     @sketch = File.read File.join(options[:src_dir], sketch_filename)
   end
@@ -52,7 +70,7 @@ def write
     sketch = File.join(output_dir, sketch_filename)
     File.open(sketch, 'w') { |f| f.write @sketch }
 
-    libs = LIB_FILENAMES.map { |f| File.join(output_dir, f)}
+    libs = LIB_FILENAMES.map { |f| File.join(output_dir, f.split('/')[-1])}
     libs.each_with_index do |file, index|
       File.open(file, 'w') { |f| f.write @libs[index]}
     end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index a54004c5..98d708eb 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -10,6 +10,7 @@
 
 DinoLCD dinoLCD;
 DHT dht;
+IRsend irsend;
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
@@ -328,6 +329,8 @@ void Dino::handleDHT() {
   #endif
 }
 
+
+// CMD = 15
 void Dino::ds18Read() {
   OneWire ds(pin);
 
@@ -377,6 +380,12 @@ void Dino::ds18Read() {
 }
 
 
+// CMD = 16
+void Dino::irSend(){
+  irsend.sendRawChar(auxMsg, val);
+}
+
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index b43733fb..fd4ca166 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -10,6 +10,7 @@
 #include "DinoLCD.h"
 #include "DHT.h"
 #include "OneWire.h"
+#include "IRremote.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
@@ -56,6 +57,7 @@ class Dino {
     void handleSerial          ();  //cmd = 12
     void handleDHT             ();  //cmd = 13
     void ds18Read              ();  //cmd = 15
+    void irSend                ();  //cmd = 16
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
@@ -73,7 +75,7 @@ class Dino {
     char cmdStr[5]; int cmd;
     char pinStr[5]; int pin;
     char valStr[5]; int val;
-    char auxMsg[256];
+    char auxMsg[512];
 
     // Value and response storage.
     int rval;
diff --git a/src/lib/DHT.cpp b/src/vendor/DHT/DHT.cpp
similarity index 100%
rename from src/lib/DHT.cpp
rename to src/vendor/DHT/DHT.cpp
diff --git a/src/lib/DHT.h b/src/vendor/DHT/DHT.h
similarity index 100%
rename from src/lib/DHT.h
rename to src/vendor/DHT/DHT.h
diff --git a/src/lib/OneWire.cpp b/src/vendor/OneWire/OneWire.cpp
similarity index 100%
rename from src/lib/OneWire.cpp
rename to src/vendor/OneWire/OneWire.cpp
diff --git a/src/lib/OneWire.h b/src/vendor/OneWire/OneWire.h
similarity index 100%
rename from src/lib/OneWire.h
rename to src/vendor/OneWire/OneWire.h

From 0f6c39fdff988ac50cf7f4e0fee01b0dcf37c55c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 11 Sep 2017 11:57:31 -0400
Subject: [PATCH 091/296] Don't need DHT or OneWire includes at sketch level

---
 src/dino_ethernet.ino |  4 +---
 src/dino_serial.ino   |  4 +---
 src/dino_wifi.ino     | 10 ++++------
 3 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index 737c2040..e3da0652 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -3,8 +3,6 @@
 #include <Ethernet.h>
 #include <Servo.h>
 #include <LiquidCrystal.h>
-#include "DHT.h"
-#include "OneWire.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
@@ -66,7 +64,7 @@ void setup() {
 void loop() {
   // Listen for connections.
   client = server.available();
-  
+
   // Handle a connection.
   if (client) {
     while (client.connected()) {
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index e276e5d3..406e4216 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -1,8 +1,6 @@
 #include "Dino.h"
 #include <Servo.h>
 #include <LiquidCrystal.h>
-#include "DHT.h"
-#include "OneWire.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
@@ -27,7 +25,7 @@ void (*writeCallback)(char *str) = writeResponse;
 
 void setup() {
   serial.begin(115200);
-  
+
   // Wait for Leonardo serial port to connect.
   #if defined(__AVR_ATmega32U4__)
     while(!serial);
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 3a99e701..d519706f 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -3,8 +3,6 @@
 #include <WiFi.h>
 #include <Servo.h>
 #include <LiquidCrystal.h>
-#include "DHT.h"
-#include "OneWire.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
@@ -57,13 +55,13 @@ void setup() {
   Serial.begin(9600);
 
   // Try to connect to the specified network.
-  while ( status != WL_CONNECTED) { 
+  while ( status != WL_CONNECTED) {
     Serial.print("Attempting to connect to SSID: ");
     Serial.println(ssid);
     status = WiFi.begin(ssid, pass);
     delay(10000);
-  } 
-  
+  }
+
   // Start the server.
   server.begin();
   printWifiStatus();
@@ -75,7 +73,7 @@ void setup() {
 void loop() {
   // Listen for connections.
   client = server.available();
-  
+
   // Handle a connection.
   if (client) {
     while (client.connected()) {

From 66c4f1bd4aa1d7b783922d82053116157a5c84b1 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 11 Sep 2017 18:45:24 -0400
Subject: [PATCH 092/296] Forgot to actually call the infrared send function

---
 src/lib/Dino.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 98d708eb..d20e0b96 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -95,6 +95,7 @@ void Dino::process() {
     case 12: handleSerial        ();  break;
     case 13: handleDHT           ();  break;
     case 15: ds18Read            ();  break;
+    case 16: irSend              ();  break;
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;

From 3ad2e1262c524af9f75a0c99846b3f73b9e955a8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 11 Sep 2017 20:09:39 -0400
Subject: [PATCH 093/296] Remove need for sendRawChar since we can cast inside
 Dino.cpp. Still using a modified fork of the IR library to keep memory cost
 low.

---
 src/lib/Dino.cpp            | 2 +-
 src/vendor/Arduino-IRremote | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index d20e0b96..1da90a00 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -383,7 +383,7 @@ void Dino::ds18Read() {
 
 // CMD = 16
 void Dino::irSend(){
-  irsend.sendRawChar(auxMsg, val);
+  irsend.sendRaw((uint16_t*)&auxMsg[1], auxMsg[0], val);
 }
 
 
diff --git a/src/vendor/Arduino-IRremote b/src/vendor/Arduino-IRremote
index 34fab166..b6cbb73a 160000
--- a/src/vendor/Arduino-IRremote
+++ b/src/vendor/Arduino-IRremote
@@ -1 +1 @@
-Subproject commit 34fab166bb1021f050e80cfceb7acc0e01360a3e
+Subproject commit b6cbb73abc176f241942724a257c7217baeeee5d

From 9ebf8df10d1e6a130c5d543c2b080874a369bbd5 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 12 Sep 2017 12:20:31 -0400
Subject: [PATCH 094/296] Aux length to 512 like sketch. Allows up to 255 IR
 timings.

---
 lib/dino/message.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/message.rb b/lib/dino/message.rb
index af2b8531..91fa9959 100644
--- a/lib/dino/message.rb
+++ b/lib/dino/message.rb
@@ -11,7 +11,7 @@ def self.encode(options={})
       raise Exception.new('commands can only be four digits') if cmd.to_s.length > 4
       raise Exception.new('pins can only be four digits') if pin.to_s.length > 4
       raise Exception.new('values can only be four digits') if val.to_s.length > 4
-      raise Exception.new('auxillary messages are limited to 255 characters') if aux.to_s.length > 255
+      raise Exception.new('auxillary messages are limited to 512 characters') if aux.to_s.length > 512
 
       message = ""
       [aux, val, pin].each do |fragment|

From b89064c32db0cd6c6bd36e218b1aae1228b0db3f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 12 Sep 2017 14:14:02 -0400
Subject: [PATCH 095/296] Add infrared emitter Ruby class and example

---
 examples/ir_emitter/ir_emitter.rb | 55 +++++++++++++++++++++++++++++++
 lib/dino/components.rb            |  1 +
 lib/dino/components/ir_emitter.rb | 42 +++++++++++++++++++++++
 3 files changed, 98 insertions(+)
 create mode 100644 examples/ir_emitter/ir_emitter.rb
 create mode 100644 lib/dino/components/ir_emitter.rb

diff --git a/examples/ir_emitter/ir_emitter.rb b/examples/ir_emitter/ir_emitter.rb
new file mode 100644
index 00000000..8a82f564
--- /dev/null
+++ b/examples/ir_emitter/ir_emitter.rb
@@ -0,0 +1,55 @@
+#
+# This is a simple test of the IREmitter (infrared blaster) class.
+# It is based on part of "IRtest2" from the included Arduino library:
+#   https://github.com/z3t0/Arduino-IRremote/tree/master/examples
+#
+# To verify your emitter is working, you could flash "IRrecvDump2" from that
+# examples directory to a second board. With an IR receiver on the correct pin
+# of the board (see https://github.com/z3t0/Arduino-IRremote#hardware-specifications),
+# open a serial monitor at 9600 and check that it receives the signal sent by this script.
+#
+# If you don't have 2 boards, use "IRrecvDump2" to capture a code from a button
+# of a remote you have. Copy the raw code (long list of numbers in curly braces),
+# from the serial output, replace the curly braces with square brackets, and
+# those raw values are now compatible with Ruby and this script.
+#
+# Flash the dino sketch onto your board and connect the IR emitter.
+# Substitute a code you captured for the NEC example below.
+# The corresponding action should happen on your device, eg. "Power" on your TV.
+#
+# Both of these methods require you to have an IR receiver handy.
+# If you do not have one, there are IR codes in Raw format for many devices
+# available on sites like http://irdb.tk/codes/
+# When formatted as a string of numbers with + and - in front of each number,
+# you will need to convert them to the array format before use.
+#
+require 'bundler/setup'
+require 'dino'
+
+# Note: If testing with 2 boards connected to the same computer, you want to be
+# explicit about which serial device this script must use. The relevant
+# TxRx call is below, but commented out. Enable it and substitute the approriate
+# device  for the board that has the IR emitter connected and dino sketch loaded.
+txrx = Dino::TxRx::Serial.new
+# txrx = Dino::TxRx::Serial.new(device: "/dev/ttyACM0")
+board = Dino::Board.new(txrx)
+
+# Setting the IR emitter pin is currently unsupported.
+# Although the value gets passed to the board, it always uses the default pin
+# for your specfic board/chip, as defined by the library (in bold) at:
+# https://github.com/z3t0/Arduino-IRremote#hardware-specifications
+ir = Dino::Components::IREmitter.new(board: board, pin: 3)
+
+# This is the raw data corresponding to NEC 0x12345678
+code = [9000, 4500,
+        560, 560, 560, 560, 560, 560, 560, 1690,
+        560, 560, 560, 560, 560, 1690, 560, 560,
+        560, 560, 560, 560, 560, 1690, 560, 1690,
+        560, 560, 560, 1690, 560, 560, 560, 560,
+        560, 560, 560, 1690, 560, 560, 560, 1690,
+        560, 560, 560, 1690, 560, 1690, 560, 560,
+        560, 560, 560, 1690, 560, 1690, 560, 1690,
+        560, 1690, 560, 560, 560, 560, 560, 560,
+        560]
+
+ir.send(code)
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index bdbc86d7..4d2c2eec 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -17,5 +17,6 @@ module Components
     autoload :SoftwareSerial, 'dino/components/softserial'
     autoload :DHT,            'dino/components/dht'
     autoload :DS18B20,        'dino/components/ds18b20'
+    autoload :IREmitter,      'dino/components/ir_emitter'
   end
 end
diff --git a/lib/dino/components/ir_emitter.rb b/lib/dino/components/ir_emitter.rb
new file mode 100644
index 00000000..cfe16d3f
--- /dev/null
+++ b/lib/dino/components/ir_emitter.rb
@@ -0,0 +1,42 @@
+module Dino
+  module Components
+    class IREmitter < Basic::DigitalOutput
+      def send(pulses=[], options={})
+        raise Exception.new('infrared signals are limited to a total of 255 pulses (marks + ticks)') if pulses.length > 255
+        pulses.each do |p|
+          raise Exception.new('invalid infrared signal, please ensure all microsecond durations are integers') unless p.is_a? Integer
+          raise Exception.new('pulse lengths are limited to 65536 microseconds') if p > 65536
+        end
+
+        # Default to 38kHz
+        frequency = options[:freqency] || 38
+
+        message = Dino::Message.encode(
+          command: 16,
+          # Setting the IR emitter pin is currently unsupported.
+          # Although the value gets passed through, it always uses the default pin
+          # for your specfic board/chip, as defined by the library (in bold) at:
+          # https://github.com/z3t0/Arduino-IRremote#hardware-specifications
+          pin: pin,
+          value: frequency,
+          aux_message: pack(pulses)
+        )
+        board.write(message)
+      end
+
+      # Pack pulse lengths (in microseconds) into a string (byte array really) such that:
+      # 1) Each pulse length is converted to a little-endian unsigned 16-bit integer.
+      # 2) Each pulse occupies 2 consecutive bytes of the byte array.
+      # 3) The first pulse is at index 1 of the array, and subsequent pulses
+      #    start on consecutive odd-numbered indices.
+      # 4) The 0th byte of the array contains the total number of pulses (NOT bytes).
+      #
+      # This keeps compatbility with the aux format normally used for sending data as
+      # ASCII, but sends higher density binary data whch the IR library needs.
+      #
+      def pack(pulses=[])
+        "#{[pulses.count].pack('C')}#{pulses.pack('v*')}"
+      end
+    end
+  end
+end

From b43296967e1f1842d89f19c22528aa2fd58498d3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 12 Sep 2017 15:41:06 -0400
Subject: [PATCH 096/296] Patching in Piezo support by @MinasMazar from #74,
 since his repo is missing

---
 lib/dino/board.rb            |  7 +++++++
 lib/dino/components.rb       |  1 +
 lib/dino/components/piezo.rb | 23 +++++++++++++++++++++++
 src/lib/Dino.cpp             | 12 ++++++++++++
 src/lib/Dino.h               |  2 ++
 5 files changed, 45 insertions(+)
 create mode 100644 lib/dino/components/piezo.rb

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 01fab882..eb0760b1 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -79,6 +79,8 @@ def set_pullup(pin, pullup)
       servo_write:     '9',
       dht_read:        '13',
       ds18b20_read:    '15'
+      tone:            '20',
+      no_tone:         '21'
     }
 
     PIN_COMMANDS.each_key do |command|
@@ -87,6 +89,11 @@ def set_pullup(pin, pullup)
       end
     end
 
+    # Redefinition tone to accept duration.
+    def tone(pin, value, duration)
+      write Dino::Message.encode(command: PIN_COMMANDS[:tone], pin: convert_pin(pin), value: value, aux_message: duration)
+    end
+
     DIGITAL_REGEX = /\A\d+\z/i
     ANALOG_REGEX = /\A(a)\d+\z/i
     DAC_REGEX = /\A(dac)\d+\z/i
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 4d2c2eec..d1b5c4e3 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -18,5 +18,6 @@ module Components
     autoload :DHT,            'dino/components/dht'
     autoload :DS18B20,        'dino/components/ds18b20'
     autoload :IREmitter,      'dino/components/ir_emitter'
+    autoload :Piezo,          'dino/components/piezo'
   end
 end
diff --git a/lib/dino/components/piezo.rb b/lib/dino/components/piezo.rb
new file mode 100644
index 00000000..4896646b
--- /dev/null
+++ b/lib/dino/components/piezo.rb
@@ -0,0 +1,23 @@
+module Dino
+  module Components
+    class Piezo < Basic::AnalogOutput
+      include Setup::SinglePin
+      include Setup::Output
+      include Mixins::Threaded
+      interrupt_with :digital_write
+
+      def after_initialize(options={})
+        low
+      end
+
+      # Duration is in mills
+      def tone(value, duration = 500)
+        board.tone pin, value, duration
+      end
+
+      def no_tone
+        board.no_tone pin
+      end
+    end
+  end
+end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 1da90a00..208e6cc7 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -96,6 +96,8 @@ void Dino::process() {
     case 13: handleDHT           ();  break;
     case 15: ds18Read            ();  break;
     case 16: irSend              ();  break;
+    case 20: tone                ();  break;
+    case 21: noTone              ();  break;
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
@@ -386,6 +388,16 @@ void Dino::irSend(){
   irsend.sendRaw((uint16_t*)&auxMsg[1], auxMsg[0], val);
 }
 
+// CMD = 20
+void Dino::tone() {
+  unsigned int duration = atoi(auxMsg);
+  ::tone(pin, val, duration);
+}
+
+// CMD = 21
+void Dino::noTone() {
+   ::noTone(pin);
+}
 
 // CMD = 90
 void Dino::reset() {
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index fd4ca166..ada36cd6 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -58,6 +58,8 @@ class Dino {
     void handleDHT             ();  //cmd = 13
     void ds18Read              ();  //cmd = 15
     void irSend                ();  //cmd = 16
+    void tone                  ();  //cmd = 20
+    void noTone                ();  //cmd = 21
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97

From eebbc86a98013715e24297278afe78baa5e29be3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 12 Sep 2017 16:06:47 -0400
Subject: [PATCH 097/296] Fix aux message test and forgot a comma

---
 lib/dino/board.rb        | 2 +-
 spec/lib/message_spec.rb | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index eb0760b1..1e081663 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -78,7 +78,7 @@ def set_pullup(pin, pullup)
       servo_toggle:    '8',
       servo_write:     '9',
       dht_read:        '13',
-      ds18b20_read:    '15'
+      ds18b20_read:    '15',
       tone:            '20',
       no_tone:         '21'
     }
diff --git a/spec/lib/message_spec.rb b/spec/lib/message_spec.rb
index 4750f559..c8c5767e 100644
--- a/spec/lib/message_spec.rb
+++ b/spec/lib/message_spec.rb
@@ -21,8 +21,8 @@ module Dino
         expect { Dino::Message.encode(command:90, value:90000) }.to raise_exception(/four/)
       end
 
-      it 'should not allow values longer than 4 digits' do
-        expect { Dino::Message.encode(command:90, aux_message: "0" * 256) }.to raise_exception(/255/)
+      it 'should not allow aux messages longer than 512' do
+        expect { Dino::Message.encode(command:90, aux_message: "0" * 513) }.to raise_exception(/512/)
       end
 
       it 'should build messages correctly' do

From 3239ffc615eff31df8b3b49052c04aab6a643b81 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 12 Sep 2017 16:14:25 -0400
Subject: [PATCH 098/296] Testing Travis CI workaround

---
 .travis.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index 96ba4de9..4c6681f9 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,4 +1,8 @@
 language: ruby
+
+before_install:
+  - gem install bundler
+
 rvm:
   - 2.2.0
   - 2.0.0

From 3481ec20a9e501337d90286a007286cbc8268c23 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 24 Dec 2017 12:43:16 -0400
Subject: [PATCH 099/296] Update travis ruby version

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 4c6681f9..8499f94c 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -4,7 +4,7 @@ before_install:
   - gem install bundler
 
 rvm:
-  - 2.2.0
+  - 2.4.1
   - 2.0.0
   - 1.9.3
   - jruby-19mode

From 8bb60f77565dc3bc58c631d309493c8bbbfa6279 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 24 Dec 2017 12:45:42 -0400
Subject: [PATCH 100/296] Must cast IR length as uint8 or it hangs. Stub out
 tone for now because of timer conflict with IR emitter.

---
 src/lib/Dino.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 208e6cc7..663b748e 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -385,18 +385,18 @@ void Dino::ds18Read() {
 
 // CMD = 16
 void Dino::irSend(){
-  irsend.sendRaw((uint16_t*)&auxMsg[1], auxMsg[0], val);
+  irsend.sendRaw((uint16_t*)&auxMsg[1], (uint8_t)auxMsg[0], val);
 }
 
 // CMD = 20
 void Dino::tone() {
-  unsigned int duration = atoi(auxMsg);
-  ::tone(pin, val, duration);
+  //unsigned int duration = atoi(auxMsg);
+  //::tone(pin, val, duration);
 }
 
 // CMD = 21
 void Dino::noTone() {
-   ::noTone(pin);
+  //::noTone(pin);
 }
 
 // CMD = 90

From 2a9df8af55b1e09d903de9b4ddcf8731266b8cbb Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 24 Dec 2017 12:46:43 -0400
Subject: [PATCH 101/296] Fix spelling error in frequency option.

---
 lib/dino/components/ir_emitter.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/components/ir_emitter.rb b/lib/dino/components/ir_emitter.rb
index cfe16d3f..930b8823 100644
--- a/lib/dino/components/ir_emitter.rb
+++ b/lib/dino/components/ir_emitter.rb
@@ -9,7 +9,7 @@ def send(pulses=[], options={})
         end
 
         # Default to 38kHz
-        frequency = options[:freqency] || 38
+        frequency = options[:frequency] || 38
 
         message = Dino::Message.encode(
           command: 16,

From a732154e93effaf4beaa659ae3bdc99285754670 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 24 Dec 2017 12:47:18 -0400
Subject: [PATCH 102/296] Remove some unnecessary includes from the main sketch
 files.

---
 src/dino_ethernet.ino | 2 --
 src/dino_serial.ino   | 2 --
 src/dino_wifi.ino     | 2 --
 3 files changed, 6 deletions(-)

diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index e3da0652..40805e90 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -1,8 +1,6 @@
 #include "Dino.h"
 #include <SPI.h>
 #include <Ethernet.h>
-#include <Servo.h>
-#include <LiquidCrystal.h>
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 406e4216..becc210f 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -1,6 +1,4 @@
 #include "Dino.h"
-#include <Servo.h>
-#include <LiquidCrystal.h>
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index d519706f..704a058c 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -1,8 +1,6 @@
 #include "Dino.h"
 #include <SPI.h>
 #include <WiFi.h>
-#include <Servo.h>
-#include <LiquidCrystal.h>
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)

From 48a60eabe50bc0c833294c3c8497587e4f6fd1e1 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 24 Dec 2017 15:50:44 -0400
Subject: [PATCH 103/296] Clearer comments for how multi pin components work.

---
 lib/dino/components/setup/multi_pin.rb | 44 ++++++++++++++++----------
 1 file changed, 27 insertions(+), 17 deletions(-)

diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
index 75c26e14..01271f64 100644
--- a/lib/dino/components/setup/multi_pin.rb
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -3,7 +3,10 @@ module Components
     module Setup
       module MultiPin
         #
-        # Build complex components by modeling them as separate single pin subcomponents.
+        # Model complex components by allowing them to use multiple pins.
+        # Pins may be "required" or not, and "proxied" or not.
+        # Proxying a pin creates a single-pin component on that pin of the given
+        # class and stores it in @proxies.
         #
         include Base
         attr_reader :pin, :pins, :pullups, :proxies
@@ -26,23 +29,14 @@ def self.included(base)
           base.extend ClassMethods
         end
 
-        #
-        # A subcomponent's pin can be required, proxied, or both.
-        #
-        # Requiring a pin simply raises an error if a value for it is not specified in the options[:pins] hash.
-        # It will NOT automatically set up a subcomponent or do anything further.
-        # This can be useful for native libraries where modeling the pin as a subcomponent is not necessary.
-        # Or for components with pins that may be left disconnected.
-        #
-        # Proxying a pin automatically requires it, and specifies what single-pin component it should be modeled as.
-        # This module will automatically intialize the proxy component and store it in the @proxies instance variable.
-        # It also creates an attr_accessor on the singleton class for the subcomponent.
-        # The accessor and the hash element are both named using the pin's key from the options[:pins] hash.
-        #
-        # A proxied pin can be NOT required by including `optional: true` in the options hash passed to #proxy_pins.
-        # Please see the source for the SSD and RgbLed components for good examples of how all this works.
-        #
         module ClassMethods
+          #
+          # Requiring a pin simply raises an error if not specified in options[:pins].
+          # It will not automatically set up a subcomponent or do anything else.
+          # This is useful for calling Arduino-native libraries, where we need
+          # to say what pins we are using, but don't need to do more in Ruby.
+          # See the LCD component for an example.
+          #
           def require_pins(*args)
             required_pins = self.class_eval('@@required_pins') rescue []
             required_pins = (required_pins + args).uniq
@@ -50,6 +44,22 @@ def require_pins(*args)
           end
           alias :require_pin :require_pins
 
+          #
+          # Proxying a pin models it as a single-pin component and requires it.
+          # It can be made optional by adding `optional: true` to the hash.
+          #
+          # On initializing a multi-pin component, its proxy instances are
+          # created and stored in the @proxies variable. Call #proxies for access.
+          #
+          # Lastly, convenience methods for each proxy are defined on the singleton
+          # class of the multi-pin instance.
+          #
+          # For example, you can call `rgb_led.red` for the AnalogOutput
+          # instance that controls the red part of that RGB led.
+          #
+          # These method names correspond to the hash keys (pin names) defined in
+          # the class definition call to `proxy_pins`. See RgbLed class for examples.
+          #
           def proxy_pins(options={})
             if options[:optional]
               options.reject! { |k| k == :optional }

From d987b6684251238353499e8754247c19fa1857aa Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 24 Dec 2017 15:51:27 -0400
Subject: [PATCH 104/296] Better implementation of delayed write when shift
 register acts as a board.

---
 lib/dino/components/shift_register.rb | 73 ++++++++++++++++++---------
 1 file changed, 48 insertions(+), 25 deletions(-)

diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
index 7e09f105..777bfdff 100644
--- a/lib/dino/components/shift_register.rb
+++ b/lib/dino/components/shift_register.rb
@@ -9,22 +9,38 @@ class ShiftRegister
                   latch: Basic::DigitalOutput,
                   data:  Basic::DigitalOutput
 
+
       def after_initialize(options={})
+        #
+        # Before the register is used as a board proxy, we need to know how many
+        # bytes there are to map the register pins to virtual pins.
+        # Defaults to 1 byte. Ignore if writing to the register directly.
+        #
         @bytes = options[:bytes] || 1
+
+        #
+        # When used as a board proxy, store the state of each register
+        # output pins as a 0 or 1 in an array that is (@bytes * 8) long.
+        #
         @state = Array.new(@bytes*8) {|i| 0}
         write_state
-        super
-      end
 
-      def write_state
-        bytes = []
-        @state.each_slice(8) do |slice|
-          bytes << slice.join("").reverse.to_i(2)
-        end
-        write_bytes(bytes)
+        #
+        # When used as a board proxy, only write sate if @write_delay seconds
+        # has passed since last input. Looks better for things like SSDs
+        # where many bits may change in sequence, but not exactly the same time.
+        #
+        @write_delay = options[:write_delay] || 0.005
+
+        super
       end
 
+      #
+      # Send a single byte per message as text, so 255 as 3 bytes, not 1.
+      # Use this when writing values directly to the register.
+      #
       def write_bytes(*bytes)
+
         latch.low
         bytes.flatten.each do |byte|
           board.write Dino::Message.encode(command: 11, pin: data.pin, value: byte, aux_message: clock.pin)
@@ -36,32 +52,39 @@ def write_bytes(*bytes)
       alias :write :write_bytes
 
       #
-      # Make the shift register behave like a board.
-      # We can use each output pin on it individually for digital out components.
-      # To instantiate a component, pass the register as a 'board' and the corresponding pin numbers on the register.
+      # Make the shift register act as a board for components that just need
+      # digital output pins. To initialize a component, pass the register as a
+      # 'board' and pin numbers such that pin 0 is the 1st bit of the
+      # 1st regiser byte, pin 9 is the first bit of the second byte, and so on.
       #
       include Mixins::BoardProxy
-      include Mixins::Threaded
-
       def digital_write(pin, value)
-        @last_input = Time.now
         @state[pin] = value
-        start_write
+        delayed_write(@state)
+      end
+
+      #
+      # Do writes in a separate thread and with a small delay.
+      # Lets us catch multiple changed bits, like with an SSD.
+      #
+      include Mixins::Threaded
+      def delayed_write(state)
+        threaded do
+          sleep @write_delay
+          write_state if (state == @state)
+        end
       end
 
       #
-      # Wait until we have not had a digital_write for 1ms before writing to the board.
-      # Reduces the amount of wrting required for things like SSDs that change many bits in sequence.
+      # Convert state into array of 0-255 integers (each byte), then write normally.
       #
-      def start_write
-        return if @thread
-        @last_output = Time.now
-        threaded_loop do
-          if ((Time.now - @last_input) > 0.001) && (@last_input > @last_output)
-            write_state
-            @last_output = Time.now
-          end
+      def write_state
+        puts "wrote state"
+        bytes = []
+        @state.each_slice(8) do |slice|
+          bytes << slice.join("").reverse.to_i(2)
         end
+        write_bytes(bytes)
       end
     end
   end

From 97d09061b1da31eb8865d41c7b4527b1d78c438f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 25 Dec 2017 18:48:34 -0400
Subject: [PATCH 105/296] Use byte (8 bit uint) instead of char for auxmsg.
 Less casting when content is not text.

---
 src/lib/Dino.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index ada36cd6..e49dbe11 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -77,7 +77,7 @@ class Dino {
     char cmdStr[5]; int cmd;
     char pinStr[5]; int pin;
     char valStr[5]; int val;
-    char auxMsg[512];
+    byte auxMsg[512];
 
     // Value and response storage.
     int rval;

From 7b7ab86de98b4935c968e0e453481cf69f05b294 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 25 Dec 2017 19:41:00 -0400
Subject: [PATCH 106/296] Add shift register read to Arduino sketch. Prevent
 listeners from mutating main loop global vars. Ruby code in next commit.

---
 src/lib/Dino.cpp | 122 +++++++++++++++++++++++++++++++++--------------
 src/lib/Dino.h   |  38 ++++++++-------
 2 files changed, 106 insertions(+), 54 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 663b748e..860bcd46 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -80,24 +80,34 @@ void Dino::process() {
 
   // Call the command.
   switch(cmd) {
-    case 0:  setMode             ();  break;
-    case 1:  dWrite              ();  break;
-    case 2:  dRead               ();  break;
-    case 3:  aWrite              ();  break;
-    case 4:  aRead               ();  break;
-    case 5:  addDigitalListener  ();  break;
-    case 6:  addAnalogListener   ();  break;
-    case 7:  removeListener      ();  break;
-    case 8:  servoToggle         ();  break;
-    case 9:  servoWrite          ();  break;
-    case 10: handleLCD           ();  break;
-    case 11: shiftWrite          ();  break;
-    case 12: handleSerial        ();  break;
-    case 13: handleDHT           ();  break;
-    case 15: ds18Read            ();  break;
-    case 16: irSend              ();  break;
-    case 20: tone                ();  break;
-    case 21: noTone              ();  break;
+    case 0:  setMode             ();    break;
+    case 1:  dWrite              ();    break;
+    case 2:  dRead               (pin); break;
+    case 3:  aWrite              ();    break;
+    case 4:  aRead               (pin); break;
+    case 5:  addDigitalListener  ();    break;
+    case 6:  addAnalogListener   ();    break;
+    case 7:  removeListener      ();    break;
+    case 8:  servoToggle         ();    break;
+    case 9:  servoWrite          ();    break;
+    case 10: handleLCD           ();    break;
+    case 12: handleSerial        ();    break;
+    case 13: handleDHT           ();    break;
+    case 15: ds18Read            ();    break;
+    case 16: irSend              ();    break;
+    case 20: tone                ();    break;
+    case 21: noTone              ();    break;
+
+    // Request format for shift register read, write and add listener functions.
+    // pin        = data pin (int)
+    // val        = clock pin (int)
+    // auxMsg[0]  = latch pin (byte)
+    // auxMsg[1]  = send clock high before reading (byte) (0/1) (read func only)
+    // auxMsg[2]  = length (byte)
+    // auxMsg[3]+ = data (bytes) (write func only)
+    case 22: shiftWrite (pin, val, auxMsg[0], auxMsg[2], &auxMsg[3]);  break;
+    case 23: shiftRead  (pin, val, auxMsg[0], auxMsg[2], auxMsg[1]);   break;
+
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
@@ -115,7 +125,6 @@ void Dino::process() {
 }
 
 
-
 // WRITE CALLBACK
 void Dino::setupWrite(void (*writeCallback)(char *str)) {
   _writeCallback = writeCallback;
@@ -137,20 +146,19 @@ void Dino::updateListeners() {
 void Dino::updateDigitalListeners() {
   for (int i = 0; i < PIN_COUNT; i++) {
     if (digitalListeners[i]) {
-      pin = i;
-      dRead();
+      dRead(i);
       if (rval != digitalListenerValues[i]) {
         digitalListenerValues[i] = rval;
         writeResponse();
       }
     }
   }
+  shiftRead(14, 16, 15, 2, 1);
 }
 void Dino::updateAnalogListeners() {
   for (int i = 0; i < PIN_COUNT; i++) {
     if (analogListeners[i]) {
-      pin = i;
-      aRead();
+      aRead(i);
       writeResponse();
     }
   }
@@ -197,7 +205,7 @@ void Dino::dWrite() {
 }
 
 // CMD = 02 // Digital Read
-void Dino::dRead() {
+void Dino::dRead(int pin) {
   rval = digitalRead(pin);
   sprintf(response, "%02d:%02d", pin, rval);
 }
@@ -211,7 +219,7 @@ void Dino::aWrite() {
 }
 
 // CMD = 04 // Analog Read
-void Dino::aRead() {
+void Dino::aRead(int pin) {
   rval = analogRead(pin);
   sprintf(response, "%02d:%02d", pin, rval);
 }
@@ -282,16 +290,6 @@ void Dino::handleLCD() {
   dinoLCD.process(val, auxMsg);
 }
 
-// CMD = 11
-// Write to a shift register.
-void Dino::shiftWrite() {
-  #ifdef debug
-    Serial.print("Shift write :"); Serial.print(val); Serial.print(" to pin "); Serial.print(pin); Serial.print(". Clock pin: "); Serial.println(auxMsg);
-  #endif
-  // auxMsg should be the clock pin.
-  shiftOut(pin, atoi(auxMsg), MSBFIRST, val);
-}
-
 
 // CMD = 12
 // Control the SoftwareSerial.
@@ -385,7 +383,7 @@ void Dino::ds18Read() {
 
 // CMD = 16
 void Dino::irSend(){
-  irsend.sendRaw((uint16_t*)&auxMsg[1], (uint8_t)auxMsg[0], val);
+  irsend.sendRaw((uint16_t)&auxMsg[1], (uint8_t)auxMsg[0], val);
 }
 
 // CMD = 20
@@ -399,6 +397,58 @@ void Dino::noTone() {
   //::noTone(pin);
 }
 
+
+// CMD = 22
+// Write to a shift register.
+void Dino::shiftWrite(int dataPin, int clockPin, byte latchPin, byte len, byte data[]) {
+  // Set latch pin low to begin serial write.
+  digitalWrite(latchPin, LOW);
+
+  // Write one byte at a time.
+  for (uint8_t i = 0;  i < len;  i++) {
+    shiftOut(dataPin, clockPin, MSBFIRST, data[i]);
+  }
+
+  // Set latch pin high so register writes to parallel output.
+  digitalWrite(latchPin, HIGH);
+}
+
+
+// CMD = 23
+// Read from a shift register.
+void Dino::shiftRead(int dataPin, int clockPin, byte latchPin, byte len, byte clockHighFirst) {
+  // Send clock pin high if using a register that clocks on rising edges.
+  // If not, the MSB will not be read on those registers (always 1),
+  // and all other bits will be shifted by 1 towards the LSB.
+  if (clockHighFirst > 0) digitalWrite(clockPin, HIGH);
+
+  // Latch high to read parallel state, then low again to stop.
+  digitalWrite(latchPin, HIGH);
+  digitalWrite(latchPin, LOW);
+
+  // Send the pin number and the colon alone for now.
+  sprintf(response, "%02d:", dataPin);
+  _writeCallback(response);
+
+  for (byte i = 1;  i <= len;  i++) {
+    // Read a single byte from the register.
+    byte reading = shiftIn(dataPin, clockPin, LSBFIRST);
+
+    // If we're on the last byte, append \n. If not, append a comma, then write.
+    if (i == len) {
+      sprintf(response, "%03d\n", reading);
+    } else {
+      sprintf(response, "%03d,", dataPin);
+    }
+    _writeCallback(response);
+  }
+
+  // Leave latch pin high and clear response so main loop doesn't send anything.
+  digitalWrite(latchPin, HIGH);
+  response[0] = "\0";
+}
+
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index e49dbe11..2498d2a9 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -42,24 +42,26 @@ class Dino {
 
   private:
     // API-accessible functions.
-    void setMode               ();  //cmd = 0
-    void dWrite                ();  //cmd = 1
-    void dRead                 ();  //cmd = 2
-    void aWrite                ();  //cmd = 3
-    void aRead                 ();  //cmd = 4
-    void addDigitalListener    ();  //cmd = 5
-    void addAnalogListener     ();  //cmd = 6
-    void removeListener        ();  //cmd = 7
-    void servoToggle           ();  //cmd = 8
-    void servoWrite            ();  //cmd = 9
-    void handleLCD             ();  //cmd = 10
-    void shiftWrite            ();  //cmd = 11
-    void handleSerial          ();  //cmd = 12
-    void handleDHT             ();  //cmd = 13
-    void ds18Read              ();  //cmd = 15
-    void irSend                ();  //cmd = 16
-    void tone                  ();  //cmd = 20
-    void noTone                ();  //cmd = 21
+    void setMode               ();         //cmd = 0
+    void dWrite                ();         //cmd = 1
+    void dRead                 (int pin);  //cmd = 2
+    void aWrite                ();         //cmd = 3
+    void aRead                 (int pin);  //cmd = 4
+    void addDigitalListener    ();         //cmd = 5
+    void addAnalogListener     ();         //cmd = 6
+    void removeListener        ();         //cmd = 7
+    void servoToggle           ();         //cmd = 8
+    void servoWrite            ();         //cmd = 9
+    void handleLCD             ();         //cmd = 10
+    void shiftWrite            ();         //cmd = 11
+    void handleSerial          ();         //cmd = 12
+    void handleDHT             ();         //cmd = 13
+    void ds18Read              ();         //cmd = 15
+    void irSend                ();         //cmd = 16
+    void tone                  ();         //cmd = 20
+    void noTone                ();         //cmd = 21
+    void shiftWrite            (int dataPin, int clockPin, byte latchPin, byte len, byte data[]);         //cmd = 22
+    void shiftRead             (int dataPin, int clockPin, byte latchPin, byte len, byte clockHighFirst); //cmd = 23
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97

From a9a9907599f2cd37a9313f0f73271d9336b7b3aa Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 25 Dec 2017 21:02:39 -0400
Subject: [PATCH 107/296] Ruby implementation for shift register read, updated
 register write, and related bug fixes.

---
 examples/shift_register/shift_register_in.rb  |  19 +++
 ...hift_register.rb => shift_register_out.rb} |   2 +-
 examples/shift_register/shift_register_ssd.rb |   2 +-
 lib/dino/components.rb                        |  33 +++---
 lib/dino/components/mixins/board_proxy.rb     |   7 ++
 lib/dino/components/mixins/reader.rb          |   4 +-
 lib/dino/components/shift_register.rb         |  91 --------------
 lib/dino/components/shift_register_in.rb      | 112 ++++++++++++++++++
 lib/dino/components/shift_register_out.rb     |  92 ++++++++++++++
 src/lib/Dino.cpp                              |   5 +-
 10 files changed, 253 insertions(+), 114 deletions(-)
 create mode 100644 examples/shift_register/shift_register_in.rb
 rename examples/shift_register/{shift_register.rb => shift_register_out.rb} (76%)
 delete mode 100644 lib/dino/components/shift_register.rb
 create mode 100644 lib/dino/components/shift_register_in.rb
 create mode 100644 lib/dino/components/shift_register_out.rb

diff --git a/examples/shift_register/shift_register_in.rb b/examples/shift_register/shift_register_in.rb
new file mode 100644
index 00000000..696524a1
--- /dev/null
+++ b/examples/shift_register/shift_register_in.rb
@@ -0,0 +1,19 @@
+#
+# This is a simple example to write to a shift register.
+# Writing a byte of 255 sets all the output pins to high.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+shift_register = Dino::Components::ShiftRegisterIn.new(bytes: 1, clock_high_first: true, pins: {data: 14, latch: 15, clock: 16}, board: board)
+
+button = Dino::Components::Button.new(pin: 7, board: shift_register)
+
+button.down { puts "down"}
+button.up   { puts "up"  }
+
+loop do
+  button.read
+  sleep 0.1
+end
diff --git a/examples/shift_register/shift_register.rb b/examples/shift_register/shift_register_out.rb
similarity index 76%
rename from examples/shift_register/shift_register.rb
rename to examples/shift_register/shift_register_out.rb
index fe5945b6..5e157418 100644
--- a/examples/shift_register/shift_register.rb
+++ b/examples/shift_register/shift_register_out.rb
@@ -6,7 +6,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::ShiftRegister.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+shift_register = Dino::Components::ShiftRegisterOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
 
 # Write a single byte
 shift_register.write(255)
diff --git a/examples/shift_register/shift_register_ssd.rb b/examples/shift_register/shift_register_ssd.rb
index 7af26409..81737214 100644
--- a/examples/shift_register/shift_register_ssd.rb
+++ b/examples/shift_register/shift_register_ssd.rb
@@ -7,7 +7,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::ShiftRegister.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+shift_register = Dino::Components::ShiftRegisterOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
 
 ssd   = Dino::Components::SSD.new(
   board: shift_register,
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index d1b5c4e3..6114a33f 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -3,21 +3,22 @@ module Components
     require 'dino/components/setup'
     require 'dino/components/mixins'
     require 'dino/components/basic'
-    autoload :Led,            'dino/components/led'
-    autoload :Button,         'dino/components/button'
-    autoload :Sensor,         'dino/components/sensor'
-    autoload :RgbLed,         'dino/components/rgb_led'
-    autoload :Servo,          'dino/components/servo'
-    autoload :SSD,            'dino/components/ssd'
-    autoload :Stepper,        'dino/components/stepper'
-    autoload :IrReceiver,     'dino/components/ir_receiver'
-    autoload :LCD,            'dino/components/lcd'
-    autoload :ShiftRegister,  'dino/components/shift_register'
-    autoload :Relay,          'dino/components/relay'
-    autoload :SoftwareSerial, 'dino/components/softserial'
-    autoload :DHT,            'dino/components/dht'
-    autoload :DS18B20,        'dino/components/ds18b20'
-    autoload :IREmitter,      'dino/components/ir_emitter'
-    autoload :Piezo,          'dino/components/piezo'
+    autoload :Led,              'dino/components/led'
+    autoload :Button,           'dino/components/button'
+    autoload :Sensor,           'dino/components/sensor'
+    autoload :RgbLed,           'dino/components/rgb_led'
+    autoload :Servo,            'dino/components/servo'
+    autoload :SSD,              'dino/components/ssd'
+    autoload :Stepper,          'dino/components/stepper'
+    autoload :IrReceiver,       'dino/components/ir_receiver'
+    autoload :LCD,              'dino/components/lcd'
+    autoload :ShiftRegisterIn,  'dino/components/shift_register_in'
+    autoload :ShiftRegisterOut, 'dino/components/shift_register_out'
+    autoload :Relay,            'dino/components/relay'
+    autoload :SoftwareSerial,   'dino/components/softserial'
+    autoload :DHT,              'dino/components/dht'
+    autoload :DS18B20,          'dino/components/ds18b20'
+    autoload :IREmitter,        'dino/components/ir_emitter'
+    autoload :Piezo,            'dino/components/piezo'
   end
 end
diff --git a/lib/dino/components/mixins/board_proxy.rb b/lib/dino/components/mixins/board_proxy.rb
index 30f7f6b8..961a4753 100644
--- a/lib/dino/components/mixins/board_proxy.rb
+++ b/lib/dino/components/mixins/board_proxy.rb
@@ -3,6 +3,7 @@ module Components
     module Mixins
       module BoardProxy
         def after_initialize(options={})
+          super(options) if defined?(super)
           @high = 1
           @low = 0
           @components = []
@@ -25,6 +26,12 @@ def convert_pin(pin)
         def set_pin_mode(pin, mode)
           nil
         end
+
+        def set_pullup(pin, pullup)
+          nil
+        end
+
+        def start_read; end
       end
     end
   end
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index 89810135..6f3c90ff 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -7,9 +7,9 @@ module Reader
         def read(&block)
           add_callback(:read, &block) if block_given?
           _read
-          loop { break if @callbacks[:read].empty? }
+          loop { break if !@callbacks[:read] || @callbacks[:read].empty? }
         end
-        
+
         #
         # Including component should define this to perform a single read on the board.
         #
diff --git a/lib/dino/components/shift_register.rb b/lib/dino/components/shift_register.rb
deleted file mode 100644
index 777bfdff..00000000
--- a/lib/dino/components/shift_register.rb
+++ /dev/null
@@ -1,91 +0,0 @@
-module Dino
-  module Components
-    class ShiftRegister
-      #
-      # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
-      #
-      include Setup::MultiPin
-      proxy_pins  clock: Basic::DigitalOutput,
-                  latch: Basic::DigitalOutput,
-                  data:  Basic::DigitalOutput
-
-
-      def after_initialize(options={})
-        #
-        # Before the register is used as a board proxy, we need to know how many
-        # bytes there are to map the register pins to virtual pins.
-        # Defaults to 1 byte. Ignore if writing to the register directly.
-        #
-        @bytes = options[:bytes] || 1
-
-        #
-        # When used as a board proxy, store the state of each register
-        # output pins as a 0 or 1 in an array that is (@bytes * 8) long.
-        #
-        @state = Array.new(@bytes*8) {|i| 0}
-        write_state
-
-        #
-        # When used as a board proxy, only write sate if @write_delay seconds
-        # has passed since last input. Looks better for things like SSDs
-        # where many bits may change in sequence, but not exactly the same time.
-        #
-        @write_delay = options[:write_delay] || 0.005
-
-        super
-      end
-
-      #
-      # Send a single byte per message as text, so 255 as 3 bytes, not 1.
-      # Use this when writing values directly to the register.
-      #
-      def write_bytes(*bytes)
-
-        latch.low
-        bytes.flatten.each do |byte|
-          board.write Dino::Message.encode(command: 11, pin: data.pin, value: byte, aux_message: clock.pin)
-        end
-        latch.high
-      end
-
-      alias :write_byte :write_bytes
-      alias :write :write_bytes
-
-      #
-      # Make the shift register act as a board for components that just need
-      # digital output pins. To initialize a component, pass the register as a
-      # 'board' and pin numbers such that pin 0 is the 1st bit of the
-      # 1st regiser byte, pin 9 is the first bit of the second byte, and so on.
-      #
-      include Mixins::BoardProxy
-      def digital_write(pin, value)
-        @state[pin] = value
-        delayed_write(@state)
-      end
-
-      #
-      # Do writes in a separate thread and with a small delay.
-      # Lets us catch multiple changed bits, like with an SSD.
-      #
-      include Mixins::Threaded
-      def delayed_write(state)
-        threaded do
-          sleep @write_delay
-          write_state if (state == @state)
-        end
-      end
-
-      #
-      # Convert state into array of 0-255 integers (each byte), then write normally.
-      #
-      def write_state
-        puts "wrote state"
-        bytes = []
-        @state.each_slice(8) do |slice|
-          bytes << slice.join("").reverse.to_i(2)
-        end
-        write_bytes(bytes)
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/shift_register_in.rb b/lib/dino/components/shift_register_in.rb
new file mode 100644
index 00000000..5538f0c6
--- /dev/null
+++ b/lib/dino/components/shift_register_in.rb
@@ -0,0 +1,112 @@
+module Dino
+  module Components
+    class ShiftRegisterIn
+      #
+      # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
+      #
+      include Setup::MultiPin
+      proxy_pins  clock: Basic::DigitalOutput,
+                  latch: Basic::DigitalOutput,
+                  data:  Basic::AnalogInput
+
+      def after_initialize(options={})
+        #
+        # To use the register as a board proxy, we need to know how many
+        # bytes there are and map each bit to a virtual pin.
+        # Defaults to 1 byte. Ignore if writing to the register directly.
+        #
+        @bytes = options[:bytes] || 1
+
+        #
+        # When used as a board proxy, store the state of each register
+        # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
+        #
+        @state = Array.new(@bytes*8) {|i| 0}
+
+        #
+        # Certain registers which use rising edges for clock signals produce
+        # errors with the native Arduino shiftIn function unless you set the clock
+        # pin high before reading. Setting this instance var to 1 will include
+        # that instruction on every call to read or listen.
+        #
+        @clock_high_first = options[:clock_high_first] ? 1 : 0
+
+        super(options)
+        bubble_callbacks
+        enable_proxy
+      end
+
+      include Mixins::Callbacks
+      #
+      # Data will arrive on the data pin, similar to an analog read.
+      # Bubble it up to the register object (self) and then deal with it there.
+      #
+      def bubble_callbacks
+        proxies[:data].add_callback do |byte|
+          self.update(byte)
+        end
+      end
+
+      #
+      # Callbacks#update mostly works, but we need to convert the state from
+      # the format we get it in to an array of bits.
+      #
+      def update(message)
+        # Bytes arrive as numbers in text separated by commas.
+        # Convert them into a bit array matching @state before calling super.
+        bits = byte_array_to_bit_array(message.split(","))
+        super(bits)
+      end
+
+      #
+      # Convert an array of cached bytes into an array of integer 1s and 0s
+      # Convenient for bubbling to proxy components, but is used for all callbacks.
+      #
+      def byte_array_to_bit_array(byte_array)
+        byte_array.map do |byte|
+          byte.to_i.to_s(2).rjust(8, "0").split("")
+        end.flatten.map { |bit| bit.to_i }
+      end
+
+      def read
+        # Pack the extra parameters we need to send in the aux message then send.
+        aux = [latch.pin, @clock_high_first, @bytes]
+        aux = aux.pack('C*')
+        board.write Dino::Message.encode(command: 23, pin: data.pin, value: clock.pin, aux_message: aux)
+      end
+
+      #
+      # Make the register act as a board for components that need only digital
+      # input pins. Pass the register as a 'board' and pin numbers such that pin 0
+      # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
+      #
+      include Mixins::BoardProxy
+
+      def digital_read(pin)
+        read
+      end
+
+      def digital_listen(pin)
+        #
+        # Start the remote listener
+        # Need to implement this on Arduino.
+        #
+      end
+
+      #
+      # Mimic Board#update, but in a callback fired through Callbacks#update.
+      # This doesn't interfere with using the register directly,
+      # and doesn't fire if the board isn't acting as a proxy (no components).
+      #
+      def enable_proxy
+        self.add_callback(:board_proxy) do |bit_array|
+          bit_array.each_with_index do |value, pin|
+            @components.each do |part|
+              part.update(value) if pin.to_i == part.pin
+            end
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/shift_register_out.rb b/lib/dino/components/shift_register_out.rb
new file mode 100644
index 00000000..866272c4
--- /dev/null
+++ b/lib/dino/components/shift_register_out.rb
@@ -0,0 +1,92 @@
+module Dino
+  module Components
+    class ShiftRegisterOut
+      #
+      # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
+      #
+      include Setup::MultiPin
+      proxy_pins  clock: Basic::DigitalOutput,
+                  latch: Basic::DigitalOutput,
+                  data:  Basic::DigitalOutput
+
+      def after_initialize(options={})
+        #
+        # To use the register as a board proxy, we need to know how many
+        # bytes there are and map each bit to a virtual pin.
+        # Defaults to 1 byte. Ignore if writing to the register directly.
+        #
+        @bytes = options[:bytes] || 1
+
+        #
+        # When used as a board proxy, store the state of each register
+        # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
+        #
+        @state = Array.new(@bytes*8) {|i| 0}
+        write_state
+
+        #
+        # When used as a board proxy, only write sate if @write_delay seconds
+        # have passed since this object last got input. Better for things like SSDs
+        # where many bits change in sequence, but not at exactly the same time.
+        #
+        @write_delay = options[:write_delay] || 0.005
+
+        super(options)
+      end
+
+      #
+      # Send one or more bytes to the register. Clock and latch toggling
+      # are handled by the board, but we still must set mode in Ruby.
+      #
+      def write_bytes(*bytes)
+        aux = bytes.flatten
+        #
+        # Format request by putting 3 elements before the data bytes, so we get:
+        # [latch pin, (unused byte), number of data bytes, data byte 1, data byte 2...]
+        #
+        aux = [latch.pin, 0, aux.count].concat(aux)
+
+        # Pack into literal format for aux msg compatbility then send.
+        aux = aux.pack('C*')
+        board.write Dino::Message.encode(command: 22, pin: data.pin, value: clock.pin, aux_message: aux)
+      end
+
+      alias :write_byte :write_bytes
+      alias :write :write_bytes
+
+      #
+      # Make the register act as a board for components that need only digital
+      # output pins. Pass the register as a 'board' and pin numbers such that pin 0
+      # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
+      #
+      include Mixins::BoardProxy
+      def digital_write(pin, value)
+        @state[pin] = value
+        delayed_write(@state)
+      end
+
+      #
+      # If acting as board, do writes in a separate thread and with small delay.
+      # Lets us catch multiple changed bits, like when hosting an SSD.
+      #
+      include Mixins::Threaded
+      def delayed_write(state)
+        threaded do
+          sleep @write_delay
+          write_state if (state == @state)
+        end
+      end
+
+      #
+      # Convert bit state to array of 0-255 integers (bytes) then write normally.
+      #
+      def write_state
+        bytes = []
+        @state.each_slice(8) do |slice|
+          bytes << slice.join("").to_i(2)
+        end
+        write_bytes(bytes)
+      end
+    end
+  end
+end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 860bcd46..1633ff39 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -153,7 +153,6 @@ void Dino::updateDigitalListeners() {
       }
     }
   }
-  shiftRead(14, 16, 15, 2, 1);
 }
 void Dino::updateAnalogListeners() {
   for (int i = 0; i < PIN_COUNT; i++) {
@@ -406,7 +405,7 @@ void Dino::shiftWrite(int dataPin, int clockPin, byte latchPin, byte len, byte d
 
   // Write one byte at a time.
   for (uint8_t i = 0;  i < len;  i++) {
-    shiftOut(dataPin, clockPin, MSBFIRST, data[i]);
+    shiftOut(dataPin, clockPin, LSBFIRST, data[i]);
   }
 
   // Set latch pin high so register writes to parallel output.
@@ -438,7 +437,7 @@ void Dino::shiftRead(int dataPin, int clockPin, byte latchPin, byte len, byte cl
     if (i == len) {
       sprintf(response, "%03d\n", reading);
     } else {
-      sprintf(response, "%03d,", dataPin);
+      sprintf(response, "%03d,", reading);
     }
     _writeCallback(response);
   }

From 779c30dde7d96211bdd218fabc4fa52cd579c333 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 25 Dec 2017 21:08:59 -0400
Subject: [PATCH 108/296] Make callback thread update component state after
 running all callbacks instead of before.

Now you can compare the new state (callback parameter) to the old state (instance variable) inside callbacks.
---
 lib/dino/components/mixins/callbacks.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 8084ea24..8822fd3f 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -25,13 +25,13 @@ def remove_callback(key=nil)
         alias :remove_callbacks :remove_callback
 
         def update(data)
-          @state = data
           @callback_mutex.synchronize {
             @callbacks.each_value do |array|
               array.each { |callback| callback.call(@state) }
             end
           }
           remove_callback :read
+          @state = data
         end
       end
     end

From 7f941fa23ee489301ea4947f6eb309591a2dfc5c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 26 Dec 2017 16:32:48 -0400
Subject: [PATCH 109/296] Make sure callbacks get the news data, not the old
 state.

---
 lib/dino/components/mixins/callbacks.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 8822fd3f..a2661a65 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -27,7 +27,7 @@ def remove_callback(key=nil)
         def update(data)
           @callback_mutex.synchronize {
             @callbacks.each_value do |array|
-              array.each { |callback| callback.call(@state) }
+              array.each { |callback| callback.call(data) }
             end
           }
           remove_callback :read

From 76c53da49fc88449e9bbb6ca210d940139e997ef Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 26 Dec 2017 16:37:54 -0400
Subject: [PATCH 110/296] Fix shift register output tests.

---
 .../lib/components/shift_register_out_spec.rb | 35 ++++++++++++++++
 spec/lib/components/shift_register_spec.rb    | 40 -------------------
 2 files changed, 35 insertions(+), 40 deletions(-)
 create mode 100644 spec/lib/components/shift_register_out_spec.rb
 delete mode 100644 spec/lib/components/shift_register_spec.rb

diff --git a/spec/lib/components/shift_register_out_spec.rb b/spec/lib/components/shift_register_out_spec.rb
new file mode 100644
index 00000000..cf25d6d3
--- /dev/null
+++ b/spec/lib/components/shift_register_out_spec.rb
@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe ShiftRegisterOut do
+      include BoardMock
+      let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
+      subject { ShiftRegisterOut.new(options)  }
+
+      describe '#initialize' do
+        it 'should create a BaseOutput instance for each pin' do
+          expect(subject.clock.class).to eq(Basic::DigitalOutput)
+          expect(subject.latch.class).to eq(Basic::DigitalOutput)
+          expect(subject.data.class).to eq(Basic::DigitalOutput)
+        end
+      end
+
+      describe '#write' do
+        before(:each) { subject }
+
+        it 'should send message for single byte in the request format the board expects' do
+          expect(board).to receive(:write).with "22.11.12.#{[8,0,1,255].pack('C*')}\n"
+
+          subject.write(255)
+        end
+
+        it 'should send message for array of bytes in the request format the board expects' do
+          expect(board).to receive(:write).with "22.11.12.#{[8,0,2,255,0].pack('C*')}\n"
+
+          subject.write([255,0])
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/shift_register_spec.rb b/spec/lib/components/shift_register_spec.rb
deleted file mode 100644
index 246ae490..00000000
--- a/spec/lib/components/shift_register_spec.rb
+++ /dev/null
@@ -1,40 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe ShiftRegister do
-      include BoardMock
-      let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
-      subject { ShiftRegister.new(options)  }
-
-      describe '#initialize' do
-        it 'should create a BaseOutput instance for each pin' do
-          expect(subject.clock.class).to eq(Basic::DigitalOutput)
-          expect(subject.latch.class).to eq(Basic::DigitalOutput)
-          expect(subject.data.class).to eq(Basic::DigitalOutput)
-        end
-      end
-
-      describe '#write' do
-        before(:each) { subject }
-
-        it 'should write a single byte as value and clock pin as aux to the data pin' do
-          expect(subject.latch).to receive(:digital_write).with(board.low)
-          expect(board).to receive(:write).with "11.11.255.12\n"
-          expect(subject.latch).to receive(:digital_write).with(board.high)
-
-          subject.write(255)
-        end
-
-        it 'should write an array of bytes as value and clock pin as aux to the data pin' do
-          expect(subject.latch).to receive(:digital_write).with(board.low)
-          expect(board).to receive(:write).with "11.11.255.12\n"
-          expect(board).to receive(:write).with "11.11.0.12\n"
-          expect(subject.latch).to receive(:digital_write).with(board.high)
-
-          subject.write([255,0])
-        end
-      end
-    end
-  end
-end

From 70073ac3b6a0267b8b769da601a72be1a2016418 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 26 Dec 2017 17:22:18 -0400
Subject: [PATCH 111/296] Add tests for IR emitter and shift register in.

---
 examples/shift_register/shift_register_in.rb  |  2 +-
 lib/dino/components/shift_register_in.rb      |  4 +-
 spec/lib/components/ir_emitter_spec.rb        | 27 ++++++
 spec/lib/components/shift_register_in_spec.rb | 82 +++++++++++++++++++
 .../lib/components/shift_register_out_spec.rb |  2 +-
 5 files changed, 113 insertions(+), 4 deletions(-)
 create mode 100644 spec/lib/components/ir_emitter_spec.rb
 create mode 100644 spec/lib/components/shift_register_in_spec.rb

diff --git a/examples/shift_register/shift_register_in.rb b/examples/shift_register/shift_register_in.rb
index 696524a1..0b450504 100644
--- a/examples/shift_register/shift_register_in.rb
+++ b/examples/shift_register/shift_register_in.rb
@@ -6,7 +6,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::ShiftRegisterIn.new(bytes: 1, clock_high_first: true, pins: {data: 14, latch: 15, clock: 16}, board: board)
+shift_register = Dino::Components::ShiftRegisterIn.new(bytes: 1, preclock_high: true, pins: {data: 14, latch: 15, clock: 16}, board: board)
 
 button = Dino::Components::Button.new(pin: 7, board: shift_register)
 
diff --git a/lib/dino/components/shift_register_in.rb b/lib/dino/components/shift_register_in.rb
index 5538f0c6..ce314291 100644
--- a/lib/dino/components/shift_register_in.rb
+++ b/lib/dino/components/shift_register_in.rb
@@ -29,7 +29,7 @@ def after_initialize(options={})
         # pin high before reading. Setting this instance var to 1 will include
         # that instruction on every call to read or listen.
         #
-        @clock_high_first = options[:clock_high_first] ? 1 : 0
+        @preclock_high = options[:preclock_high] ? 1 : 0
 
         super(options)
         bubble_callbacks
@@ -70,7 +70,7 @@ def byte_array_to_bit_array(byte_array)
 
       def read
         # Pack the extra parameters we need to send in the aux message then send.
-        aux = [latch.pin, @clock_high_first, @bytes]
+        aux = [latch.pin, @preclock_high, @bytes]
         aux = aux.pack('C*')
         board.write Dino::Message.encode(command: 23, pin: data.pin, value: clock.pin, aux_message: aux)
       end
diff --git a/spec/lib/components/ir_emitter_spec.rb b/spec/lib/components/ir_emitter_spec.rb
new file mode 100644
index 00000000..f4331f41
--- /dev/null
+++ b/spec/lib/components/ir_emitter_spec.rb
@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe IREmitter do
+      include BoardMock
+      let(:options) { { board: board, pin: 3 } }
+      subject { IREmitter.new(options)  }
+
+      describe '#send' do
+        before(:each) { subject }
+
+        it 'should send messages in the request format the board expects' do
+          expect(board).to receive(:write).with "16.3.38.#{[4].pack('C')}#{[100,200,300,400].pack('v*')}\n"
+
+          subject.send([100,200,300,400])
+        end
+
+        it 'should put modulation frequency (kHz) in the value field if given as option to #send' do
+          expect(board).to receive(:write).with "16.3.40.#{[4].pack('C')}#{[100,200,300,400].pack('v*')}\n"
+
+          subject.send([100,200,300,400], frequency: 40)
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/shift_register_in_spec.rb b/spec/lib/components/shift_register_in_spec.rb
new file mode 100644
index 00000000..99b34365
--- /dev/null
+++ b/spec/lib/components/shift_register_in_spec.rb
@@ -0,0 +1,82 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe ShiftRegisterIn do
+      include BoardMock
+      let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
+      subject { ShiftRegisterIn.new(options)  }
+
+      describe '#initialize' do
+        it 'should create DigitalOutput instances for clock and latch pins' do
+          expect(subject.clock.class).to eq(Basic::DigitalOutput)
+          expect(subject.latch.class).to eq(Basic::DigitalOutput)
+        end
+
+        it 'should create an AnalogInput instance for data pin' do
+          expect(subject.data.class).to eq(Basic::AnalogInput)
+        end
+
+        it 'should set the number of bytes when given as option' do
+          subject = ShiftRegisterIn.new(options.merge(bytes:2))
+          expect(subject.instance_variable_get(:@bytes)).to eq(2)
+        end
+
+        it 'should default the preclock_high variable to 0' do
+          expect(subject.instance_variable_get(:@preclock_high)).to eq(0)
+        end
+
+        it 'should set @preclock_high to 1 if given anything other than 0' do
+          subject = ShiftRegisterIn.new(options.merge(preclock_high: :yes))
+          expect(subject.instance_variable_get(:@preclock_high)).to eq(1)
+        end
+      end
+
+      describe '#read' do
+        before(:each) { subject }
+
+        it 'should send message for single byte in the request format the board expects' do
+          expect(board).to receive(:write).with "23.11.12.#{[8,0,1].pack('C*')}\n"
+          subject.read
+        end
+
+        it 'should request the correct number of bytes to be read' do
+          subject = ShiftRegisterIn.new(options.merge(bytes: 2))
+          expect(board).to receive(:write).with "23.11.12.#{[8,0,2].pack('C*')}\n"
+          subject.read
+        end
+
+        it 'should request clock pin to go high before reading if set' do
+          subject = ShiftRegisterIn.new(options.merge(preclock_high: 1))
+          expect(board).to receive(:write).with "23.11.12.#{[8,1,1].pack('C*')}\n"
+          subject.read
+        end
+      end
+
+      describe '#update' do
+        before(:each) { subject }
+
+        it 'should bubble #update from the data pin up to itself' do
+          expect(subject).to receive(:update).once.with("127,255")
+          subject.data.update("127,255")
+        end
+
+        it 'should update @state with data converted to array of 0/1 integers' do
+          subject.update("127")
+          expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1])
+
+          subject = ShiftRegisterIn.new(options.merge(bytes: 2))
+          subject.update("127,255")
+          expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1])
+        end
+
+        it 'should pass data to the callbacks as an array of 0/1 integers' do
+          @callback = Proc.new{}
+          subject.add_callback(&@callback)
+          expect(@callback).to receive(:call).once.with([0,1,1,1,1,1,1,1])
+          subject.update("127")
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/shift_register_out_spec.rb b/spec/lib/components/shift_register_out_spec.rb
index cf25d6d3..68d85a51 100644
--- a/spec/lib/components/shift_register_out_spec.rb
+++ b/spec/lib/components/shift_register_out_spec.rb
@@ -8,7 +8,7 @@ module Components
       subject { ShiftRegisterOut.new(options)  }
 
       describe '#initialize' do
-        it 'should create a BaseOutput instance for each pin' do
+        it 'should create a DigitalOutput instance for each pin' do
           expect(subject.clock.class).to eq(Basic::DigitalOutput)
           expect(subject.latch.class).to eq(Basic::DigitalOutput)
           expect(subject.data.class).to eq(Basic::DigitalOutput)

From 39f085488a6899b888da6b8daabc2c4f6f4c71c9 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 27 Dec 2017 12:12:58 -0400
Subject: [PATCH 112/296] Move register classes into module. Receive on latch
 pin instead of data pin.

---
 .../shift_in.rb}                              |   2 +-
 .../shift_out.rb}                             |   2 +-
 .../shift_ssd.rb}                             |   2 +-
 lib/dino/components.rb                        |   3 +-
 lib/dino/components/register.rb               |   9 ++
 lib/dino/components/register/select.rb        |  25 ++++
 lib/dino/components/register/shift_in.rb      | 114 ++++++++++++++++++
 lib/dino/components/register/shift_out.rb     |  95 +++++++++++++++
 lib/dino/components/shift_register_in.rb      | 112 -----------------
 lib/dino/components/shift_register_out.rb     |  92 --------------
 spec/lib/components/register/select_spec.rb   |  35 ++++++
 spec/lib/components/register/shift_in_spec.rb |  87 +++++++++++++
 .../lib/components/register/shift_out_spec.rb |  40 ++++++
 spec/lib/components/shift_register_in_spec.rb |  82 -------------
 .../lib/components/shift_register_out_spec.rb |  35 ------
 src/lib/Dino.cpp                              |  21 ++--
 16 files changed, 420 insertions(+), 336 deletions(-)
 rename examples/{shift_register/shift_register_in.rb => register/shift_in.rb} (72%)
 rename examples/{shift_register/shift_register_out.rb => register/shift_out.rb} (75%)
 rename examples/{shift_register/shift_register_ssd.rb => register/shift_ssd.rb} (84%)
 create mode 100644 lib/dino/components/register.rb
 create mode 100644 lib/dino/components/register/select.rb
 create mode 100644 lib/dino/components/register/shift_in.rb
 create mode 100644 lib/dino/components/register/shift_out.rb
 delete mode 100644 lib/dino/components/shift_register_in.rb
 delete mode 100644 lib/dino/components/shift_register_out.rb
 create mode 100644 spec/lib/components/register/select_spec.rb
 create mode 100644 spec/lib/components/register/shift_in_spec.rb
 create mode 100644 spec/lib/components/register/shift_out_spec.rb
 delete mode 100644 spec/lib/components/shift_register_in_spec.rb
 delete mode 100644 spec/lib/components/shift_register_out_spec.rb

diff --git a/examples/shift_register/shift_register_in.rb b/examples/register/shift_in.rb
similarity index 72%
rename from examples/shift_register/shift_register_in.rb
rename to examples/register/shift_in.rb
index 0b450504..609f57ed 100644
--- a/examples/shift_register/shift_register_in.rb
+++ b/examples/register/shift_in.rb
@@ -6,7 +6,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::ShiftRegisterIn.new(bytes: 1, preclock_high: true, pins: {data: 14, latch: 15, clock: 16}, board: board)
+shift_register = Dino::Components::Register::ShiftIn.new(bytes: 1, preclock_high: true, pins: {data: 14, latch: 15, clock: 16}, board: board)
 
 button = Dino::Components::Button.new(pin: 7, board: shift_register)
 
diff --git a/examples/shift_register/shift_register_out.rb b/examples/register/shift_out.rb
similarity index 75%
rename from examples/shift_register/shift_register_out.rb
rename to examples/register/shift_out.rb
index 5e157418..adb770e1 100644
--- a/examples/shift_register/shift_register_out.rb
+++ b/examples/register/shift_out.rb
@@ -6,7 +6,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::ShiftRegisterOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+shift_register = Dino::Components::Register::ShiftOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
 
 # Write a single byte
 shift_register.write(255)
diff --git a/examples/shift_register/shift_register_ssd.rb b/examples/register/shift_ssd.rb
similarity index 84%
rename from examples/shift_register/shift_register_ssd.rb
rename to examples/register/shift_ssd.rb
index 81737214..4fe31a7e 100644
--- a/examples/shift_register/shift_register_ssd.rb
+++ b/examples/register/shift_ssd.rb
@@ -7,7 +7,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::ShiftRegisterOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+shift_register = Dino::Components::Register::ShiftOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
 
 ssd   = Dino::Components::SSD.new(
   board: shift_register,
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 6114a33f..eeceb214 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -3,6 +3,7 @@ module Components
     require 'dino/components/setup'
     require 'dino/components/mixins'
     require 'dino/components/basic'
+    require 'dino/components/register'
     autoload :Led,              'dino/components/led'
     autoload :Button,           'dino/components/button'
     autoload :Sensor,           'dino/components/sensor'
@@ -12,8 +13,6 @@ module Components
     autoload :Stepper,          'dino/components/stepper'
     autoload :IrReceiver,       'dino/components/ir_receiver'
     autoload :LCD,              'dino/components/lcd'
-    autoload :ShiftRegisterIn,  'dino/components/shift_register_in'
-    autoload :ShiftRegisterOut, 'dino/components/shift_register_out'
     autoload :Relay,            'dino/components/relay'
     autoload :SoftwareSerial,   'dino/components/softserial'
     autoload :DHT,              'dino/components/dht'
diff --git a/lib/dino/components/register.rb b/lib/dino/components/register.rb
new file mode 100644
index 00000000..7bfd9df6
--- /dev/null
+++ b/lib/dino/components/register.rb
@@ -0,0 +1,9 @@
+module Dino
+  module Components
+    module Register
+      require 'dino/components/register/select'
+      require 'dino/components/register/shift_in'
+      require 'dino/components/register/shift_out'
+    end
+  end
+end
diff --git a/lib/dino/components/register/select.rb b/lib/dino/components/register/select.rb
new file mode 100644
index 00000000..855f6814
--- /dev/null
+++ b/lib/dino/components/register/select.rb
@@ -0,0 +1,25 @@
+module Dino
+  module Components
+    module Register
+      class Select
+        #
+        # Register select is an active-low output pin, used to choose which
+        # register on a bus we're accessing. For input registers, the board
+        # sends readings prefixed with the register select pin number, since
+        # each register uses a unique select pin, while clock and data are shared.
+        #
+        # There is no need to write this pin directly, but it must be in output
+        # mode, and must follow the callback pattern to receive updates.
+        #
+        include Setup::SinglePin
+        include Setup::Output
+        include Mixins::Callbacks
+
+        def initialize_pins(options={})
+          super(options) if defined?(super)
+          board.start_read
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
new file mode 100644
index 00000000..9c1e2d2f
--- /dev/null
+++ b/lib/dino/components/register/shift_in.rb
@@ -0,0 +1,114 @@
+module Dino
+  module Components
+    module Register
+      class ShiftIn
+        #
+        # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
+        #
+        include Setup::MultiPin
+        proxy_pins  clock: Basic::DigitalOutput,
+                    data:  Basic::DigitalInput,
+                    latch: Register::Select
+
+        def after_initialize(options={})
+          #
+          # To use the register as a board proxy, we need to know how many
+          # bytes there are and map each bit to a virtual pin.
+          # Defaults to 1 byte. Ignore if writing to the register directly.
+          #
+          @bytes = options[:bytes] || 1
+
+          #
+          # When used as a board proxy, store the state of each register
+          # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
+          #
+          @state = Array.new(@bytes*8) {|i| 0}
+
+          #
+          # Certain registers which use rising edges for clock signals produce
+          # errors with the native Arduino shiftIn function unless you set the clock
+          # pin high before reading. Setting this instance var to 1 will include
+          # that instruction on every call to read or listen.
+          #
+          @preclock_high = options[:preclock_high] ? 1 : 0
+
+          super(options)
+          bubble_callbacks
+          enable_proxy
+        end
+
+        include Mixins::Callbacks
+        #
+        # Data will arrive on the data pin, similar to an analog read.
+        # Bubble it up to the register object (self) and then deal with it there.
+        #
+        def bubble_callbacks
+          proxies[:latch].add_callback do |byte|
+            self.update(byte)
+          end
+        end
+
+        #
+        # Callbacks#update mostly works, but we need to convert the state from
+        # the format we get it in to an array of bits.
+        #
+        def update(message)
+          # Bytes arrive as numbers in text separated by commas.
+          # Convert them into a bit array matching @state before calling super.
+          bits = byte_array_to_bit_array(message.split(","))
+          super(bits)
+        end
+
+        #
+        # Convert an array of cached bytes into an array of integer 1s and 0s
+        # Convenient for bubbling to proxy components, but is used for all callbacks.
+        #
+        def byte_array_to_bit_array(byte_array)
+          byte_array.map do |byte|
+            byte.to_i.to_s(2).rjust(8, "0").split("")
+          end.flatten.map { |bit| bit.to_i }
+        end
+
+        def read
+          # Pack the extra parameters we need to send in the aux message then send.
+          aux = [data.pin, clock.pin, @preclock_high]
+          aux = aux.pack('C*')
+          board.write Dino::Message.encode(command: 23, pin: latch.pin, value: @bytes, aux_message: aux)
+        end
+
+        #
+        # Make the register act as a board for components that need only digital
+        # input pins. Pass the register as a 'board' and pin numbers such that pin 0
+        # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
+        #
+        include Mixins::BoardProxy
+
+        def digital_read(pin)
+          read
+        end
+
+        def digital_listen(pin)
+          #
+          # Start the remote listener
+          # Need to implement this on Arduino.
+          #
+        end
+
+        #
+        # Mimic Board#update, but in a callback fired through Callbacks#update.
+        # This doesn't interfere with using the register directly,
+        # and doesn't fire if the board isn't acting as a proxy (no components).
+        #
+        def enable_proxy
+          self.add_callback(:board_proxy) do |bit_array|
+            bit_array.each_with_index do |value, pin|
+              @components.each do |part|
+                part.update(value) if pin.to_i == part.pin
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
new file mode 100644
index 00000000..c4180c9e
--- /dev/null
+++ b/lib/dino/components/register/shift_out.rb
@@ -0,0 +1,95 @@
+module Dino
+  module Components
+    module Register
+      class ShiftOut
+        #
+        # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
+        #
+        include Setup::MultiPin
+        proxy_pins  clock: Basic::DigitalOutput,
+                    latch: Register::Select,
+                    data:  Basic::DigitalOutput
+
+        def after_initialize(options={})
+          #
+          # To use the register as a board proxy, we need to know how many
+          # bytes there are and map each bit to a virtual pin.
+          # Defaults to 1 byte. Ignore if writing to the register directly.
+          #
+          @bytes = options[:bytes] || 1
+
+          #
+          # When used as a board proxy, store the state of each register
+          # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
+          #
+          @state = Array.new(@bytes*8) {|i| 0}
+          write_state
+
+          #
+          # When used as a board proxy, only write sate if @write_delay seconds
+          # have passed since this object last got input. Better for things like SSDs
+          # where many bits change in sequence, but not at exactly the same time.
+          #
+          @write_delay = options[:write_delay] || 0.005
+
+          super(options)
+        end
+
+        #
+        # Send one or more bytes to the register. Clock and latch toggling
+        # are handled by the board, but we still must set mode in Ruby.
+        #
+        def write_bytes(*bytes)
+          aux = bytes.flatten
+          length = aux.count
+          #
+          # Format request by putting 3 elements before the data bytes, so we get:
+          # [data pin, clock pin, unused byte, data byte 1, data byte 2...]
+          #
+          aux = [data.pin, clock.pin, 0].concat(aux)
+
+          # Pack into literal format for aux msg compatbility then send.
+          aux = aux.pack('C*')
+          board.write Dino::Message.encode(command: 22, pin: latch.pin, value: length, aux_message: aux)
+        end
+
+        alias :write_byte :write_bytes
+        alias :write :write_bytes
+
+        #
+        # Make the register act as a board for components that need only digital
+        # output pins. Pass the register as a 'board' and pin numbers such that pin 0
+        # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
+        #
+        include Mixins::BoardProxy
+        def digital_write(pin, value)
+          @state[pin] = value
+          delayed_write(@state)
+        end
+
+        #
+        # If acting as board, do writes in a separate thread and with small delay.
+        # Lets us catch multiple changed bits, like when hosting an SSD.
+        #
+        include Mixins::Threaded
+        def delayed_write(state)
+          threaded do
+            sleep @write_delay
+            write_state if (state == @state)
+          end
+        end
+
+        #
+        # Convert bit state to array of 0-255 integers (bytes) then write normally.
+        #
+        def write_state
+          bytes = []
+          @state.each_slice(8) do |slice|
+            bytes << slice.join("").to_i(2)
+          end
+          write_bytes(bytes)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/shift_register_in.rb b/lib/dino/components/shift_register_in.rb
deleted file mode 100644
index ce314291..00000000
--- a/lib/dino/components/shift_register_in.rb
+++ /dev/null
@@ -1,112 +0,0 @@
-module Dino
-  module Components
-    class ShiftRegisterIn
-      #
-      # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
-      #
-      include Setup::MultiPin
-      proxy_pins  clock: Basic::DigitalOutput,
-                  latch: Basic::DigitalOutput,
-                  data:  Basic::AnalogInput
-
-      def after_initialize(options={})
-        #
-        # To use the register as a board proxy, we need to know how many
-        # bytes there are and map each bit to a virtual pin.
-        # Defaults to 1 byte. Ignore if writing to the register directly.
-        #
-        @bytes = options[:bytes] || 1
-
-        #
-        # When used as a board proxy, store the state of each register
-        # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
-        #
-        @state = Array.new(@bytes*8) {|i| 0}
-
-        #
-        # Certain registers which use rising edges for clock signals produce
-        # errors with the native Arduino shiftIn function unless you set the clock
-        # pin high before reading. Setting this instance var to 1 will include
-        # that instruction on every call to read or listen.
-        #
-        @preclock_high = options[:preclock_high] ? 1 : 0
-
-        super(options)
-        bubble_callbacks
-        enable_proxy
-      end
-
-      include Mixins::Callbacks
-      #
-      # Data will arrive on the data pin, similar to an analog read.
-      # Bubble it up to the register object (self) and then deal with it there.
-      #
-      def bubble_callbacks
-        proxies[:data].add_callback do |byte|
-          self.update(byte)
-        end
-      end
-
-      #
-      # Callbacks#update mostly works, but we need to convert the state from
-      # the format we get it in to an array of bits.
-      #
-      def update(message)
-        # Bytes arrive as numbers in text separated by commas.
-        # Convert them into a bit array matching @state before calling super.
-        bits = byte_array_to_bit_array(message.split(","))
-        super(bits)
-      end
-
-      #
-      # Convert an array of cached bytes into an array of integer 1s and 0s
-      # Convenient for bubbling to proxy components, but is used for all callbacks.
-      #
-      def byte_array_to_bit_array(byte_array)
-        byte_array.map do |byte|
-          byte.to_i.to_s(2).rjust(8, "0").split("")
-        end.flatten.map { |bit| bit.to_i }
-      end
-
-      def read
-        # Pack the extra parameters we need to send in the aux message then send.
-        aux = [latch.pin, @preclock_high, @bytes]
-        aux = aux.pack('C*')
-        board.write Dino::Message.encode(command: 23, pin: data.pin, value: clock.pin, aux_message: aux)
-      end
-
-      #
-      # Make the register act as a board for components that need only digital
-      # input pins. Pass the register as a 'board' and pin numbers such that pin 0
-      # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
-      #
-      include Mixins::BoardProxy
-
-      def digital_read(pin)
-        read
-      end
-
-      def digital_listen(pin)
-        #
-        # Start the remote listener
-        # Need to implement this on Arduino.
-        #
-      end
-
-      #
-      # Mimic Board#update, but in a callback fired through Callbacks#update.
-      # This doesn't interfere with using the register directly,
-      # and doesn't fire if the board isn't acting as a proxy (no components).
-      #
-      def enable_proxy
-        self.add_callback(:board_proxy) do |bit_array|
-          bit_array.each_with_index do |value, pin|
-            @components.each do |part|
-              part.update(value) if pin.to_i == part.pin
-            end
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/shift_register_out.rb b/lib/dino/components/shift_register_out.rb
deleted file mode 100644
index 866272c4..00000000
--- a/lib/dino/components/shift_register_out.rb
+++ /dev/null
@@ -1,92 +0,0 @@
-module Dino
-  module Components
-    class ShiftRegisterOut
-      #
-      # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
-      #
-      include Setup::MultiPin
-      proxy_pins  clock: Basic::DigitalOutput,
-                  latch: Basic::DigitalOutput,
-                  data:  Basic::DigitalOutput
-
-      def after_initialize(options={})
-        #
-        # To use the register as a board proxy, we need to know how many
-        # bytes there are and map each bit to a virtual pin.
-        # Defaults to 1 byte. Ignore if writing to the register directly.
-        #
-        @bytes = options[:bytes] || 1
-
-        #
-        # When used as a board proxy, store the state of each register
-        # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
-        #
-        @state = Array.new(@bytes*8) {|i| 0}
-        write_state
-
-        #
-        # When used as a board proxy, only write sate if @write_delay seconds
-        # have passed since this object last got input. Better for things like SSDs
-        # where many bits change in sequence, but not at exactly the same time.
-        #
-        @write_delay = options[:write_delay] || 0.005
-
-        super(options)
-      end
-
-      #
-      # Send one or more bytes to the register. Clock and latch toggling
-      # are handled by the board, but we still must set mode in Ruby.
-      #
-      def write_bytes(*bytes)
-        aux = bytes.flatten
-        #
-        # Format request by putting 3 elements before the data bytes, so we get:
-        # [latch pin, (unused byte), number of data bytes, data byte 1, data byte 2...]
-        #
-        aux = [latch.pin, 0, aux.count].concat(aux)
-
-        # Pack into literal format for aux msg compatbility then send.
-        aux = aux.pack('C*')
-        board.write Dino::Message.encode(command: 22, pin: data.pin, value: clock.pin, aux_message: aux)
-      end
-
-      alias :write_byte :write_bytes
-      alias :write :write_bytes
-
-      #
-      # Make the register act as a board for components that need only digital
-      # output pins. Pass the register as a 'board' and pin numbers such that pin 0
-      # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
-      #
-      include Mixins::BoardProxy
-      def digital_write(pin, value)
-        @state[pin] = value
-        delayed_write(@state)
-      end
-
-      #
-      # If acting as board, do writes in a separate thread and with small delay.
-      # Lets us catch multiple changed bits, like when hosting an SSD.
-      #
-      include Mixins::Threaded
-      def delayed_write(state)
-        threaded do
-          sleep @write_delay
-          write_state if (state == @state)
-        end
-      end
-
-      #
-      # Convert bit state to array of 0-255 integers (bytes) then write normally.
-      #
-      def write_state
-        bytes = []
-        @state.each_slice(8) do |slice|
-          bytes << slice.join("").to_i(2)
-        end
-        write_bytes(bytes)
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/register/select_spec.rb b/spec/lib/components/register/select_spec.rb
new file mode 100644
index 00000000..b644780f
--- /dev/null
+++ b/spec/lib/components/register/select_spec.rb
@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Register
+      describe Select do
+        include BoardMock
+        let(:options) { { pin: '10', board: board } }
+        subject { Select.new(options) }
+
+        describe '#initialize' do
+          it 'should set mode to output' do
+            expect(board).to receive(:set_pin_mode).with(10, :out)
+            subject
+          end
+
+          it 'should start the board reading' do
+            expect(board).to receive(:start_read)
+            subject
+          end
+        end
+
+        describe '#update' do
+          it 'should respond to callbacks' do
+            subject
+            @callback = Proc.new{}
+            subject.add_callback(&@callback)
+            expect(@callback).to receive(:call).once.with("127")
+            subject.update("127")
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/register/shift_in_spec.rb b/spec/lib/components/register/shift_in_spec.rb
new file mode 100644
index 00000000..192c0b4d
--- /dev/null
+++ b/spec/lib/components/register/shift_in_spec.rb
@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Register
+      describe ShiftIn do
+        include BoardMock
+        let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
+        subject { ShiftIn.new(options)  }
+
+        describe '#initialize' do
+          it 'should create a DigitalOutput instance for clock pin' do
+            expect(subject.clock.class).to eq(Basic::DigitalOutput)
+          end
+
+          it 'should create a DigitalInput instance for data pin' do
+            expect(subject.data.class).to eq(Basic::DigitalInput)
+          end
+
+          it 'should create a Register::Select instance for latch pin' do
+            expect(subject.latch.class).to eq(Register::Select)
+          end
+
+          it 'should set the number of bytes when given as option' do
+            subject = ShiftIn.new(options.merge(bytes:2))
+            expect(subject.instance_variable_get(:@bytes)).to eq(2)
+          end
+
+          it 'should default the preclock_high variable to 0' do
+            expect(subject.instance_variable_get(:@preclock_high)).to eq(0)
+          end
+
+          it 'should set @preclock_high to 1 if given anything other than 0' do
+            subject = ShiftIn.new(options.merge(preclock_high: :yes))
+            expect(subject.instance_variable_get(:@preclock_high)).to eq(1)
+          end
+        end
+
+        describe '#read' do
+          before(:each) { subject }
+
+          it 'should send message for single byte in the request format the board expects' do
+            expect(board).to receive(:write).with "23.8.1.#{[11,12,0].pack('C*')}\n"
+            subject.read
+          end
+
+          it 'should request the correct number of bytes to be read' do
+            subject = ShiftIn.new(options.merge(bytes: 2))
+            expect(board).to receive(:write).with "23.8.2.#{[11,12,0].pack('C*')}\n"
+            subject.read
+          end
+
+          it 'should request clock pin to go high before reading if set' do
+            subject = ShiftIn.new(options.merge(preclock_high: 1))
+            expect(board).to receive(:write).with "23.8.1.#{[11,12,1].pack('C*')}\n"
+            subject.read
+          end
+        end
+
+        describe '#update' do
+          before(:each) { subject }
+
+          it 'should bubble #update from the latch pin up to itself' do
+            expect(subject).to receive(:update).once.with("127,255")
+            subject.latch.update("127,255")
+          end
+
+          it 'should update @state with data converted to array of 0/1 integers' do
+            subject.update("127")
+            expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1])
+
+            subject = ShiftIn.new(options.merge(bytes: 2))
+            subject.update("127,255")
+            expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1])
+          end
+
+          it 'should pass data to the callbacks as an array of 0/1 integers' do
+            @callback = Proc.new{}
+            subject.add_callback(&@callback)
+            expect(@callback).to receive(:call).once.with([0,1,1,1,1,1,1,1])
+            subject.update("127")
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/register/shift_out_spec.rb b/spec/lib/components/register/shift_out_spec.rb
new file mode 100644
index 00000000..bb7b5e37
--- /dev/null
+++ b/spec/lib/components/register/shift_out_spec.rb
@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Register
+      describe ShiftOut do
+        include BoardMock
+        let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
+        subject { ShiftOut.new(options)  }
+
+        describe '#initialize' do
+          it 'should create a DigitalOutput instance for clock and data pins' do
+            expect(subject.clock.class).to eq(Basic::DigitalOutput)
+            expect(subject.data.class).to eq(Basic::DigitalOutput)
+          end
+
+          it 'should create a Register::Select instance for latch pin' do
+            expect(subject.latch.class).to eq(Register::Select)
+          end
+        end
+
+        describe '#write' do
+          before(:each) { subject }
+
+          it 'should send message for single byte in the request format the board expects' do
+            expect(board).to receive(:write).with "22.8.1.#{[11,12,0,255].pack('C*')}\n"
+
+            subject.write(255)
+          end
+
+          it 'should send message for array of bytes in the request format the board expects' do
+            expect(board).to receive(:write).with "22.8.2.#{[11,12,0,255,0].pack('C*')}\n"
+
+            subject.write([255,0])
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/shift_register_in_spec.rb b/spec/lib/components/shift_register_in_spec.rb
deleted file mode 100644
index 99b34365..00000000
--- a/spec/lib/components/shift_register_in_spec.rb
+++ /dev/null
@@ -1,82 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe ShiftRegisterIn do
-      include BoardMock
-      let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
-      subject { ShiftRegisterIn.new(options)  }
-
-      describe '#initialize' do
-        it 'should create DigitalOutput instances for clock and latch pins' do
-          expect(subject.clock.class).to eq(Basic::DigitalOutput)
-          expect(subject.latch.class).to eq(Basic::DigitalOutput)
-        end
-
-        it 'should create an AnalogInput instance for data pin' do
-          expect(subject.data.class).to eq(Basic::AnalogInput)
-        end
-
-        it 'should set the number of bytes when given as option' do
-          subject = ShiftRegisterIn.new(options.merge(bytes:2))
-          expect(subject.instance_variable_get(:@bytes)).to eq(2)
-        end
-
-        it 'should default the preclock_high variable to 0' do
-          expect(subject.instance_variable_get(:@preclock_high)).to eq(0)
-        end
-
-        it 'should set @preclock_high to 1 if given anything other than 0' do
-          subject = ShiftRegisterIn.new(options.merge(preclock_high: :yes))
-          expect(subject.instance_variable_get(:@preclock_high)).to eq(1)
-        end
-      end
-
-      describe '#read' do
-        before(:each) { subject }
-
-        it 'should send message for single byte in the request format the board expects' do
-          expect(board).to receive(:write).with "23.11.12.#{[8,0,1].pack('C*')}\n"
-          subject.read
-        end
-
-        it 'should request the correct number of bytes to be read' do
-          subject = ShiftRegisterIn.new(options.merge(bytes: 2))
-          expect(board).to receive(:write).with "23.11.12.#{[8,0,2].pack('C*')}\n"
-          subject.read
-        end
-
-        it 'should request clock pin to go high before reading if set' do
-          subject = ShiftRegisterIn.new(options.merge(preclock_high: 1))
-          expect(board).to receive(:write).with "23.11.12.#{[8,1,1].pack('C*')}\n"
-          subject.read
-        end
-      end
-
-      describe '#update' do
-        before(:each) { subject }
-
-        it 'should bubble #update from the data pin up to itself' do
-          expect(subject).to receive(:update).once.with("127,255")
-          subject.data.update("127,255")
-        end
-
-        it 'should update @state with data converted to array of 0/1 integers' do
-          subject.update("127")
-          expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1])
-
-          subject = ShiftRegisterIn.new(options.merge(bytes: 2))
-          subject.update("127,255")
-          expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1])
-        end
-
-        it 'should pass data to the callbacks as an array of 0/1 integers' do
-          @callback = Proc.new{}
-          subject.add_callback(&@callback)
-          expect(@callback).to receive(:call).once.with([0,1,1,1,1,1,1,1])
-          subject.update("127")
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/shift_register_out_spec.rb b/spec/lib/components/shift_register_out_spec.rb
deleted file mode 100644
index 68d85a51..00000000
--- a/spec/lib/components/shift_register_out_spec.rb
+++ /dev/null
@@ -1,35 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe ShiftRegisterOut do
-      include BoardMock
-      let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
-      subject { ShiftRegisterOut.new(options)  }
-
-      describe '#initialize' do
-        it 'should create a DigitalOutput instance for each pin' do
-          expect(subject.clock.class).to eq(Basic::DigitalOutput)
-          expect(subject.latch.class).to eq(Basic::DigitalOutput)
-          expect(subject.data.class).to eq(Basic::DigitalOutput)
-        end
-      end
-
-      describe '#write' do
-        before(:each) { subject }
-
-        it 'should send message for single byte in the request format the board expects' do
-          expect(board).to receive(:write).with "22.11.12.#{[8,0,1,255].pack('C*')}\n"
-
-          subject.write(255)
-        end
-
-        it 'should send message for array of bytes in the request format the board expects' do
-          expect(board).to receive(:write).with "22.11.12.#{[8,0,2,255,0].pack('C*')}\n"
-
-          subject.write([255,0])
-        end
-      end
-    end
-  end
-end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 1633ff39..bf6bd6ba 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -99,14 +99,14 @@ void Dino::process() {
     case 21: noTone              ();    break;
 
     // Request format for shift register read, write and add listener functions.
-    // pin        = data pin (int)
-    // val        = clock pin (int)
-    // auxMsg[0]  = latch pin (byte)
-    // auxMsg[1]  = send clock high before reading (byte) (0/1) (read func only)
-    // auxMsg[2]  = length (byte)
+    // pin        = latch pin (int)
+    // val        = length (int)
+    // auxMsg[0]  = data pin (byte)
+    // auxMsg[1]  = clock pin (byte)
+    // auxMsg[2]  = send clock high before reading (byte) (0/1) (read func only)
     // auxMsg[3]+ = data (bytes) (write func only)
-    case 22: shiftWrite (pin, val, auxMsg[0], auxMsg[2], &auxMsg[3]);  break;
-    case 23: shiftRead  (pin, val, auxMsg[0], auxMsg[2], auxMsg[1]);   break;
+    case 22: shiftWrite (pin, val, auxMsg[0], auxMsg[1], &auxMsg[3]);  break;
+    case 23: shiftRead  (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);   break;
 
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
@@ -399,7 +399,7 @@ void Dino::noTone() {
 
 // CMD = 22
 // Write to a shift register.
-void Dino::shiftWrite(int dataPin, int clockPin, byte latchPin, byte len, byte data[]) {
+void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte data[]) {
   // Set latch pin low to begin serial write.
   digitalWrite(latchPin, LOW);
 
@@ -415,7 +415,7 @@ void Dino::shiftWrite(int dataPin, int clockPin, byte latchPin, byte len, byte d
 
 // CMD = 23
 // Read from a shift register.
-void Dino::shiftRead(int dataPin, int clockPin, byte latchPin, byte len, byte clockHighFirst) {
+void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
   // Send clock pin high if using a register that clocks on rising edges.
   // If not, the MSB will not be read on those registers (always 1),
   // and all other bits will be shifted by 1 towards the LSB.
@@ -426,7 +426,8 @@ void Dino::shiftRead(int dataPin, int clockPin, byte latchPin, byte len, byte cl
   digitalWrite(latchPin, LOW);
 
   // Send the pin number and the colon alone for now.
-  sprintf(response, "%02d:", dataPin);
+  // Send data as if coming from the latch pin.
+  sprintf(response, "%02d:", latchPin);
   _writeCallback(response);
 
   for (byte i = 1;  i <= len;  i++) {

From 8ecdd97cbde0304ba6ded77bab1502aa5be7c97d Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 27 Dec 2017 12:53:55 -0400
Subject: [PATCH 113/296] Extract register communication into child classes.

---
 lib/dino/components/register.rb           |  2 +
 lib/dino/components/register/input.rb     | 96 +++++++++++++++++++++++
 lib/dino/components/register/output.rb    | 71 +++++++++++++++++
 lib/dino/components/register/shift_in.rb  | 91 ++-------------------
 lib/dino/components/register/shift_out.rb | 78 ++----------------
 5 files changed, 182 insertions(+), 156 deletions(-)
 create mode 100644 lib/dino/components/register/input.rb
 create mode 100644 lib/dino/components/register/output.rb

diff --git a/lib/dino/components/register.rb b/lib/dino/components/register.rb
index 7bfd9df6..11bddd06 100644
--- a/lib/dino/components/register.rb
+++ b/lib/dino/components/register.rb
@@ -2,6 +2,8 @@ module Dino
   module Components
     module Register
       require 'dino/components/register/select'
+      require 'dino/components/register/input'
+      require 'dino/components/register/output'
       require 'dino/components/register/shift_in'
       require 'dino/components/register/shift_out'
     end
diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
new file mode 100644
index 00000000..1489ae24
--- /dev/null
+++ b/lib/dino/components/register/input.rb
@@ -0,0 +1,96 @@
+module Dino
+  module Components
+    module Register
+      class Input
+        include Setup::Base
+        include Mixins::Callbacks
+
+        def after_initialize(options={})
+          super(options) if defined?(super)
+          #
+          # To use the register as a board proxy, we need to know how many
+          # bytes there are and map each bit to a virtual pin.
+          # Defaults to 1 byte. Ignore if writing to the register directly.
+          #
+          @bytes = options[:bytes] || 1
+
+          #
+          # When used as a board proxy, store the state of each register
+          # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
+          #
+          @state = Array.new(@bytes*8) {|i| 0}
+
+          #
+          # Certain registers which use rising edges for clock signals produce
+          # errors with the native Arduino shiftIn function unless you set the clock
+          # pin high before reading. Setting this instance var to 1 will include
+          # that instruction on every call to read or listen.
+          #
+          @preclock_high = options[:preclock_high] ? 1 : 0
+
+          enable_proxy
+        end
+
+        #
+        # Callbacks#update mostly works, but we need to convert the state from
+        # comma delimited numbers into an array of bits first.
+        #
+        def update(message)
+          bits = byte_array_to_bit_array(message.split(","))
+          super(bits)
+        end
+
+        #
+        # Convert an array of cached bytes into an array of integer 1s and 0s
+        # Convenient for bubbling to proxy components, but is used for all callbacks.
+        #
+        def byte_array_to_bit_array(byte_array)
+          byte_array.map do |byte|
+            byte.to_i.to_s(2).rjust(8, "0").split("")
+          end.flatten.map { |bit| bit.to_i }
+        end
+
+        def read
+          raise 'define #read in child class depending on communication method'
+        end
+
+        def listen
+          raise 'define #listen in child class depending on communication method'
+        end
+
+        #
+        # Make the register act as a board for components that need only digital
+        # input pins. Pass the register as a 'board' and pin numbers such that pin 0
+        # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
+        #
+        include Mixins::BoardProxy
+
+        def digital_read(pin)
+          read
+        end
+
+        def digital_listen(pin)
+          #
+          # Start the remote listener
+          # Need to implement this on Arduino.
+          #
+        end
+
+        #
+        # Mimic Board#update, but in a callback fired through Callbacks#update.
+        # This doesn't interfere with using the register directly,
+        # and doesn't fire if the board isn't acting as a proxy (no components).
+        #
+        def enable_proxy
+          self.add_callback(:board_proxy) do |bit_array|
+            bit_array.each_with_index do |value, pin|
+              @components.each do |part|
+                part.update(value) if pin.to_i == part.pin
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/register/output.rb b/lib/dino/components/register/output.rb
new file mode 100644
index 00000000..f30e61b7
--- /dev/null
+++ b/lib/dino/components/register/output.rb
@@ -0,0 +1,71 @@
+module Dino
+  module Components
+    module Register
+      class Output
+        include Setup::Base
+
+        def after_initialize(options={})
+          super(options) if defined?(super)
+          #
+          # To use the register as a board proxy, we need to know how many
+          # bytes there are and map each bit to a virtual pin.
+          # Defaults to 1 byte. Ignore if writing to the register directly.
+          #
+          @bytes = options[:bytes] || 1
+
+          #
+          # When used as a board proxy, store the state of each register
+          # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
+          #
+          @state = Array.new(@bytes*8) {|i| 0}
+          write_state
+
+          #
+          # When used as a board proxy, only write sate if @write_delay seconds
+          # have passed since this object last got input. Better for things like SSDs
+          # where many bits change in sequence, but not at exactly the same time.
+          #
+          @write_delay = options[:write_delay] || 0.005
+        end
+
+        def write
+          raise 'define #write in child class based on communication method'
+        end
+
+        #
+        # Make the register act as a board for components that need only digital
+        # output pins. Pass the register as a 'board' and pin numbers such that pin 0
+        # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
+        #
+        include Mixins::BoardProxy
+        def digital_write(pin, value)
+          @state[pin] = value
+          delayed_write(@state)
+        end
+
+        #
+        # If acting as board, do writes in a separate thread and with small delay.
+        # Lets us catch multiple changed bits, like when hosting an SSD.
+        #
+        include Mixins::Threaded
+        def delayed_write(state)
+          threaded do
+            sleep @write_delay
+            write_state if (state == @state)
+          end
+        end
+
+        #
+        # Convert bit state to array of 0-255 integers (bytes) then write normally.
+        #
+        def write_state
+          bytes = []
+          @state.each_slice(8) do |slice|
+            bytes << slice.join("").to_i(2)
+          end
+          write(bytes)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 9c1e2d2f..65f0e904 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -1,7 +1,7 @@
 module Dino
   module Components
     module Register
-      class ShiftIn
+      class ShiftIn < Input
         #
         # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
@@ -10,38 +10,15 @@ class ShiftIn
                     data:  Basic::DigitalInput,
                     latch: Register::Select
 
+        #
+        # Data will arrive on the latch pin, similar to an analog read.
+        # Bubble it up to the register object (self), then deal with it there.
+        #
         def after_initialize(options={})
-          #
-          # To use the register as a board proxy, we need to know how many
-          # bytes there are and map each bit to a virtual pin.
-          # Defaults to 1 byte. Ignore if writing to the register directly.
-          #
-          @bytes = options[:bytes] || 1
-
-          #
-          # When used as a board proxy, store the state of each register
-          # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
-          #
-          @state = Array.new(@bytes*8) {|i| 0}
-
-          #
-          # Certain registers which use rising edges for clock signals produce
-          # errors with the native Arduino shiftIn function unless you set the clock
-          # pin high before reading. Setting this instance var to 1 will include
-          # that instruction on every call to read or listen.
-          #
-          @preclock_high = options[:preclock_high] ? 1 : 0
-
-          super(options)
+          super(options) if defined?(super)
           bubble_callbacks
-          enable_proxy
         end
 
-        include Mixins::Callbacks
-        #
-        # Data will arrive on the data pin, similar to an analog read.
-        # Bubble it up to the register object (self) and then deal with it there.
-        #
         def bubble_callbacks
           proxies[:latch].add_callback do |byte|
             self.update(byte)
@@ -49,65 +26,13 @@ def bubble_callbacks
         end
 
         #
-        # Callbacks#update mostly works, but we need to convert the state from
-        # the format we get it in to an array of bits.
+        # Read using the native shiftIn function of the Arduino library.
         #
-        def update(message)
-          # Bytes arrive as numbers in text separated by commas.
-          # Convert them into a bit array matching @state before calling super.
-          bits = byte_array_to_bit_array(message.split(","))
-          super(bits)
-        end
-
-        #
-        # Convert an array of cached bytes into an array of integer 1s and 0s
-        # Convenient for bubbling to proxy components, but is used for all callbacks.
-        #
-        def byte_array_to_bit_array(byte_array)
-          byte_array.map do |byte|
-            byte.to_i.to_s(2).rjust(8, "0").split("")
-          end.flatten.map { |bit| bit.to_i }
-        end
-
         def read
           # Pack the extra parameters we need to send in the aux message then send.
-          aux = [data.pin, clock.pin, @preclock_high]
-          aux = aux.pack('C*')
+          aux = [data.pin, clock.pin, @preclock_high].pack('C*')
           board.write Dino::Message.encode(command: 23, pin: latch.pin, value: @bytes, aux_message: aux)
         end
-
-        #
-        # Make the register act as a board for components that need only digital
-        # input pins. Pass the register as a 'board' and pin numbers such that pin 0
-        # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
-        #
-        include Mixins::BoardProxy
-
-        def digital_read(pin)
-          read
-        end
-
-        def digital_listen(pin)
-          #
-          # Start the remote listener
-          # Need to implement this on Arduino.
-          #
-        end
-
-        #
-        # Mimic Board#update, but in a callback fired through Callbacks#update.
-        # This doesn't interfere with using the register directly,
-        # and doesn't fire if the board isn't acting as a proxy (no components).
-        #
-        def enable_proxy
-          self.add_callback(:board_proxy) do |bit_array|
-            bit_array.each_with_index do |value, pin|
-              @components.each do |part|
-                part.update(value) if pin.to_i == part.pin
-              end
-            end
-          end
-        end
       end
     end
   end
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index c4180c9e..708033d1 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -1,7 +1,7 @@
 module Dino
   module Components
     module Register
-      class ShiftOut
+      class ShiftOut < Output
         #
         # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
@@ -10,85 +10,17 @@ class ShiftOut
                     latch: Register::Select,
                     data:  Basic::DigitalOutput
 
-        def after_initialize(options={})
-          #
-          # To use the register as a board proxy, we need to know how many
-          # bytes there are and map each bit to a virtual pin.
-          # Defaults to 1 byte. Ignore if writing to the register directly.
-          #
-          @bytes = options[:bytes] || 1
-
-          #
-          # When used as a board proxy, store the state of each register
-          # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
-          #
-          @state = Array.new(@bytes*8) {|i| 0}
-          write_state
-
-          #
-          # When used as a board proxy, only write sate if @write_delay seconds
-          # have passed since this object last got input. Better for things like SSDs
-          # where many bits change in sequence, but not at exactly the same time.
-          #
-          @write_delay = options[:write_delay] || 0.005
-
-          super(options)
-        end
-
         #
-        # Send one or more bytes to the register. Clock and latch toggling
-        # are handled by the board, but we still must set mode in Ruby.
+        # Write using the native shiftOut function of the Arduino library.
         #
-        def write_bytes(*bytes)
+        def write(*bytes)
           aux = bytes.flatten
           length = aux.count
-          #
-          # Format request by putting 3 elements before the data bytes, so we get:
-          # [data pin, clock pin, unused byte, data byte 1, data byte 2...]
-          #
-          aux = [data.pin, clock.pin, 0].concat(aux)
 
-          # Pack into literal format for aux msg compatbility then send.
-          aux = aux.pack('C*')
+          # Prepend parameters we need to send in the aux message then pack and send.
+          aux = [data.pin, clock.pin, 0].concat(aux).pack('C*')
           board.write Dino::Message.encode(command: 22, pin: latch.pin, value: length, aux_message: aux)
         end
-
-        alias :write_byte :write_bytes
-        alias :write :write_bytes
-
-        #
-        # Make the register act as a board for components that need only digital
-        # output pins. Pass the register as a 'board' and pin numbers such that pin 0
-        # is the 1st bit of the 1st byte, pin 9 is 1st bit of the 2nd byte, and so on.
-        #
-        include Mixins::BoardProxy
-        def digital_write(pin, value)
-          @state[pin] = value
-          delayed_write(@state)
-        end
-
-        #
-        # If acting as board, do writes in a separate thread and with small delay.
-        # Lets us catch multiple changed bits, like when hosting an SSD.
-        #
-        include Mixins::Threaded
-        def delayed_write(state)
-          threaded do
-            sleep @write_delay
-            write_state if (state == @state)
-          end
-        end
-
-        #
-        # Convert bit state to array of 0-255 integers (bytes) then write normally.
-        #
-        def write_state
-          bytes = []
-          @state.each_slice(8) do |slice|
-            bytes << slice.join("").to_i(2)
-          end
-          write_bytes(bytes)
-        end
       end
     end
   end

From 970443bf22e38fc045821d4cce5b30a9a9bcce11 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 27 Dec 2017 17:26:03 -0400
Subject: [PATCH 114/296] Add 1-way SPI read function and related shift
 register model.

---
 examples/register/shift_in.rb             | 21 ++++++--
 examples/register/shift_out.rb            |  7 +--
 examples/register/shift_ssd.rb            | 20 ++++---
 examples/register/spi_in.rb               | 40 ++++++++++++++
 lib/dino/components/register.rb           |  1 +
 lib/dino/components/register/input.rb     |  2 +-
 lib/dino/components/register/output.rb    |  2 +-
 lib/dino/components/register/shift_in.rb  |  3 +-
 lib/dino/components/register/shift_out.rb |  3 +-
 lib/dino/components/register/spi_in.rb    | 32 +++++++++++
 lib/dino_cli/generator.rb                 |  5 +-
 src/lib/Dino.cpp                          | 66 +++++++++++++++++++++--
 src/lib/Dino.h                            |  7 ++-
 13 files changed, 183 insertions(+), 26 deletions(-)
 create mode 100644 examples/register/spi_in.rb
 create mode 100644 lib/dino/components/register/spi_in.rb

diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index 609f57ed..4293bfb3 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -1,14 +1,27 @@
 #
-# This is a simple example to write to a shift register.
-# Writing a byte of 255 sets all the output pins to high.
+# Example showing how to read an input shift register using Arduino's "shiftIn".
+#
+# The register implements #digital_read and other methods expected by Components,
+# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+#
+# The Button object is created by passing the register instead of the board, and
+# the register's parallel output pin that the button is connected to.
+#
+# Note: preclock_high must be set to true if using TI CD4021B register or similar.
+# This should apply to any register which outputs on a rising clock edge.
+# Change as needed.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::Register::ShiftIn.new(bytes: 1, preclock_high: true, pins: {data: 14, latch: 15, clock: 16}, board: board)
 
-button = Dino::Components::Button.new(pin: 7, board: shift_register)
+shift_register = Dino::Components::Register::ShiftIn.new  board: board,
+                                                          pins: {latch: 10, data: 12, clock: 13},
+                                                          preclock_high: true,
+                                                          bytes: 1
+
+button = Dino::Components::Button.new(pin: 0, board: shift_register)
 
 button.down { puts "down"}
 button.up   { puts "up"  }
diff --git a/examples/register/shift_out.rb b/examples/register/shift_out.rb
index adb770e1..eefdd95a 100644
--- a/examples/register/shift_out.rb
+++ b/examples/register/shift_out.rb
@@ -1,12 +1,13 @@
 #
-# This is a simple example to write to a shift register.
-# Writing a byte of 255 sets all the output pins to high.
+# Example showing how to set up an output shift register.
+# Multiple bytes may be written in one operation.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::Register::ShiftOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+shift_register = Dino::Components::Register::ShiftOut.new  board: board,
+                                                           pins: {latch: 9, data: 11, clock: 13}
 
 # Write a single byte
 shift_register.write(255)
diff --git a/examples/register/shift_ssd.rb b/examples/register/shift_ssd.rb
index 4fe31a7e..19a3e6dd 100644
--- a/examples/register/shift_ssd.rb
+++ b/examples/register/shift_ssd.rb
@@ -1,18 +1,22 @@
 #
-# This examples sets up a shift register, and an SSD that is connected to its 8 output pins.
-# The shift register is passed in as the 'board' when setting up the SSD.
-# The individual pins on the register are accessible by the SSD instance, so it works as usual.
+# Example showing how to use an output shift register to drive a seven segment display.
+#
+# The register implements #digital_write and other methods expected by Components,
+# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+#
+# The SSD object is created by passing the register instead of the board, and
+# the registers's parallel pin number that each SSD pin is connected to.
+#
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::Register::ShiftOut.new(pins: {data: 11, latch: 8, clock: 12}, board: board)
+shift_register = Dino::Components::Register::ShiftOut.new  board: board,
+                                                           pins: {data: 6, clock: 7, latch: 8}
 
-ssd   = Dino::Components::SSD.new(
-  board: shift_register,
-  pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
-)
+ssd = Dino::Components::SSD.new   board: shift_register,
+                                  pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
 
 # Turn off the ssd on exit
 trap("SIGINT") { exit !ssd.off }
diff --git a/examples/register/spi_in.rb b/examples/register/spi_in.rb
new file mode 100644
index 00000000..308e6007
--- /dev/null
+++ b/examples/register/spi_in.rb
@@ -0,0 +1,40 @@
+#
+# Example showing how to read an input shift register using SPI.
+#
+# The register implements #digital_read and other methods expected by Components,
+# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+#
+# The Button object is created by passing the register instead of the board, and
+# the register's parallel output pin that the button is connected to.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+
+#
+# Pin 10 is default slave select on Arduino UNO. Connect to register "latch" input.
+# Register data and clock pins go to 12 (MISO) and 13 respectively on the Arduino UNO.
+#
+# Clock and data pins do not need to be given when using SPI, since they are
+# predetermined based on the board you are using, and dealt with by the library.
+# But they still must be connected. The exact pins vary depending on the board,
+# and a reference can be found here: https://www.arduino.cc/en/Reference/SPI
+#
+# SPI mode and frequency are specific to a TI CD4021B register. Change as needed.
+#
+shift_register = Dino::Components::Register::SPIIn.new  board: board,
+                                                        pin: 10,
+                                                        bytes: 1,
+                                                        spi_mode: 3,
+                                                        frequency: 3000000
+
+button = Dino::Components::Button.new(pin: 0, board: shift_register)
+
+button.down { puts "down"}
+button.up   { puts "up"  }
+
+loop do
+  button.read
+  sleep 0.1
+end
diff --git a/lib/dino/components/register.rb b/lib/dino/components/register.rb
index 11bddd06..6da9383e 100644
--- a/lib/dino/components/register.rb
+++ b/lib/dino/components/register.rb
@@ -6,6 +6,7 @@ module Register
       require 'dino/components/register/output'
       require 'dino/components/register/shift_in'
       require 'dino/components/register/shift_out'
+      require 'dino/components/register/spi_in'
     end
   end
 end
diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index 1489ae24..8f5768d2 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -1,7 +1,7 @@
 module Dino
   module Components
     module Register
-      class Input
+      module Input
         include Setup::Base
         include Mixins::Callbacks
 
diff --git a/lib/dino/components/register/output.rb b/lib/dino/components/register/output.rb
index f30e61b7..25fbb451 100644
--- a/lib/dino/components/register/output.rb
+++ b/lib/dino/components/register/output.rb
@@ -1,7 +1,7 @@
 module Dino
   module Components
     module Register
-      class Output
+      module Output
         include Setup::Base
 
         def after_initialize(options={})
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 65f0e904..68dc2476 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -1,7 +1,8 @@
 module Dino
   module Components
     module Register
-      class ShiftIn < Input
+      class ShiftIn
+        include Input
         #
         # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index 708033d1..5a4b80ae 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -1,7 +1,8 @@
 module Dino
   module Components
     module Register
-      class ShiftOut < Output
+      class ShiftOut
+        include Output
         #
         # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
new file mode 100644
index 00000000..7c0773c4
--- /dev/null
+++ b/lib/dino/components/register/spi_in.rb
@@ -0,0 +1,32 @@
+module Dino
+  module Components
+    module Register
+      class SPIIn < Select
+        #
+        # options = {board: my_board, pin: slave_select_pin}
+        #
+        include Input
+
+        def after_initialize(options={})
+          super(options) if defined?(super)
+
+          # Save SPI device settings in instance variables.
+          @spi_mode  = options[:spi_mode]  || 0
+
+          # No default value for clock frequency.
+          raise 'SPI clock rate (Hz) required in :frequency option' unless options[:frequency]
+          @frequency = options[:frequency]
+        end
+
+        #
+        # Read using a call to the native SPI library.
+        #
+        def read
+          # Pack the extra parameters we need to send in the aux message then send.
+          aux = "#{[@spi_mode].pack('C')}#{[@frequency].pack('V')}"
+          board.write Dino::Message.encode(command: 25, pin: pin, value: @bytes, aux_message: aux)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 78a2039e..09e25b3e 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,8 +1,8 @@
 class DinoCLI::Generator
   require "fileutils"
   LIB_FILENAMES =  [
-                    "lib/Dino.cpp",
                     "lib/Dino.h",
+                    "lib/Dino.cpp",
                     "lib/DinoLCD.cpp",
                     "lib/DinoLCD.h",
                     "lib/DinoSerial.cpp",
@@ -64,6 +64,9 @@ def modify
     if options[:debug]
       @libs[0].gsub! "// #define debug true", "#define debug true"
     end
+    unless serial?
+      @libs[0].gsub! "#define TXRX_SPI false", "#define TXRX_SPI true"
+    end
   end
 
   def write
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index bf6bd6ba..6b9f6c29 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -98,7 +98,7 @@ void Dino::process() {
     case 20: tone                ();    break;
     case 21: noTone              ();    break;
 
-    // Request format for shift register read, write and add listener functions.
+    // Request format for shift register functions.
     // pin        = latch pin (int)
     // val        = length (int)
     // auxMsg[0]  = data pin (byte)
@@ -108,6 +108,14 @@ void Dino::process() {
     case 22: shiftWrite (pin, val, auxMsg[0], auxMsg[1], &auxMsg[3]);  break;
     case 23: shiftRead  (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);   break;
 
+    // Request format for single direction SPI functions.
+    // pin         = slave select pin (int)
+    // val         = length (int)
+    // auxMsg[0]   = SPI mode (byte)
+    // auxMsg[1-4] = clock frequency (uint32_t as 4 bytes)
+    // auxMsg[5]+  = data (bytes) (write func only)
+    case 25: readSPI    (pin, val, auxMsg[0], (uint32_t)auxMsg[1]); break;
+
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
@@ -425,12 +433,12 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
   digitalWrite(latchPin, HIGH);
   digitalWrite(latchPin, LOW);
 
-  // Send the pin number and the colon alone for now.
-  // Send data as if coming from the latch pin.
+  // Send data as if coming from the latch pin so it's easy to identify.
+  // Start with just pin number and : for now.
   sprintf(response, "%02d:", latchPin);
   _writeCallback(response);
 
-  for (byte i = 1;  i <= len;  i++) {
+  for (int i = 1;  i <= len;  i++) {
     // Read a single byte from the register.
     byte reading = shiftIn(dataPin, clockPin, LSBFIRST);
 
@@ -449,6 +457,56 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
 }
 
 
+// CMD = 25
+// Read from an SPI device.
+void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
+  // Start the SPI library if it isn't already being used by the main sketch.
+  SPI.begin();
+
+  // Set the mode we want.
+  switch(spiMode) {
+    case 0:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE0)); break;
+    case 1:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE1)); break;
+    case 2:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE2)); break;
+    case 3:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE3)); break;
+  }
+
+  // Select the device.
+  digitalWrite(selectPin, LOW);
+
+  // Send data as if coming from the slave select pin so it's easy to identify.
+  // Start with just pin number and : for now.
+  sprintf(response, "%02d:", selectPin);
+  _writeCallback(response);
+
+  for (int i = 1;  i <= len;  i++) {
+    // Read a single byte from the register.
+    byte reading = SPI.transfer(i);
+
+    // If we're on the last byte, append \n. If not, append a comma, then write.
+    if (i == len) {
+      sprintf(response, "%03d\n", reading);
+    } else {
+      sprintf(response, "%03d,", reading);
+    }
+    _writeCallback(response);
+  }
+
+  // End the SPI transaction, and then library if not in use by main sketch.
+  SPI.endTransaction();
+
+  // TXRX_SPI is set to false in Dino.h.
+  // CLI generator will auto set to true for any sketch other than serial.
+  #if !(TXRX_SPI)
+    SPI.end();
+  #endif
+
+  // Leave select high and clear response so main loop doesn't send anything.
+  digitalWrite(selectPin, HIGH);
+  response[0] = "\0";
+}
+
+
 // CMD = 90
 void Dino::reset() {
   heartRate = 4000; // Default heartRate is ~4ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 2498d2a9..30c678dc 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -4,9 +4,11 @@
 
 #ifndef Dino_h
 #define Dino_h
+#define TXRX_SPI false
 
 #include "Arduino.h"
 #include <Servo.h>
+#include <SPI.h>
 #include "DinoLCD.h"
 #include "DHT.h"
 #include "OneWire.h"
@@ -60,8 +62,9 @@ class Dino {
     void irSend                ();         //cmd = 16
     void tone                  ();         //cmd = 20
     void noTone                ();         //cmd = 21
-    void shiftWrite            (int dataPin, int clockPin, byte latchPin, byte len, byte data[]);         //cmd = 22
-    void shiftRead             (int dataPin, int clockPin, byte latchPin, byte len, byte clockHighFirst); //cmd = 23
+    void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte data[]);         //cmd = 22
+    void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 23
+    void readSPI               (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 25
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97

From c2e4a1a99216e0b8e53e78fd2c237211501d8693 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 27 Dec 2017 17:35:51 -0400
Subject: [PATCH 115/296] Always write 0s when SPI read-only.

---
 src/lib/Dino.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 6b9f6c29..44003663 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -481,7 +481,7 @@ void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
 
   for (int i = 1;  i <= len;  i++) {
     // Read a single byte from the register.
-    byte reading = SPI.transfer(i);
+    byte reading = SPI.transfer(0x00);
 
     // If we're on the last byte, append \n. If not, append a comma, then write.
     if (i == len) {

From 90fa23bafdafe4d8c7628582d5f1b996ceac4b02 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 27 Dec 2017 20:12:35 -0400
Subject: [PATCH 116/296] Add 1-way SPI register write and SSD example to go
 with.

---
 examples/register/shift_ssd.rb            |  2 +-
 examples/register/spi_ssd.rb              | 27 +++++++++++++++
 lib/dino/components/register.rb           |  1 +
 lib/dino/components/register/output.rb    |  1 +
 lib/dino/components/register/shift_in.rb  |  3 ++
 lib/dino/components/register/shift_out.rb |  8 +++--
 lib/dino/components/register/spi_in.rb    |  8 +++--
 lib/dino/components/register/spi_out.rb   | 38 +++++++++++++++++++++
 src/lib/Dino.cpp                          | 41 +++++++++++++++++++++--
 src/lib/Dino.h                            |  3 +-
 10 files changed, 124 insertions(+), 8 deletions(-)
 create mode 100644 examples/register/spi_ssd.rb
 create mode 100644 lib/dino/components/register/spi_out.rb

diff --git a/examples/register/shift_ssd.rb b/examples/register/shift_ssd.rb
index 19a3e6dd..58e77e9e 100644
--- a/examples/register/shift_ssd.rb
+++ b/examples/register/shift_ssd.rb
@@ -13,7 +13,7 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 shift_register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                           pins: {data: 6, clock: 7, latch: 8}
+                                                           pins: {data: 12, clock: 13, latch: 9}
 
 ssd = Dino::Components::SSD.new   board: shift_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
diff --git a/examples/register/spi_ssd.rb b/examples/register/spi_ssd.rb
new file mode 100644
index 00000000..0a05e014
--- /dev/null
+++ b/examples/register/spi_ssd.rb
@@ -0,0 +1,27 @@
+#
+# Example showing how to use an output shift register to drive a seven segment display.
+#
+# The register implements #digital_write and other methods expected by Components,
+# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+#
+# The SSD object is created by passing the register instead of the board, and
+# the registers's parallel pin number that each SSD pin is connected to.
+#
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+shift_register = Dino::Components::Register::SPIOut.new  board: board,
+                                                         pin: 9,
+                                                         frequency: 3000000,
+                                                         spi_mode: 3
+
+ssd = Dino::Components::SSD.new   board: shift_register,
+                                 pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
+
+# Turn off the ssd on exit
+trap("SIGINT") { exit !ssd.off }
+
+# Display each new line on the ssd
+loop { ssd.display(gets.chomp) }
diff --git a/lib/dino/components/register.rb b/lib/dino/components/register.rb
index 6da9383e..e9a91b04 100644
--- a/lib/dino/components/register.rb
+++ b/lib/dino/components/register.rb
@@ -7,6 +7,7 @@ module Register
       require 'dino/components/register/shift_in'
       require 'dino/components/register/shift_out'
       require 'dino/components/register/spi_in'
+      require 'dino/components/register/spi_out'
     end
   end
 end
diff --git a/lib/dino/components/register/output.rb b/lib/dino/components/register/output.rb
index 25fbb451..16f9bc96 100644
--- a/lib/dino/components/register/output.rb
+++ b/lib/dino/components/register/output.rb
@@ -39,6 +39,7 @@ def write
         #
         include Mixins::BoardProxy
         def digital_write(pin, value)
+          # puts @state.inspect
           @state[pin] = value
           delayed_write(@state)
         end
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 68dc2476..cd1f6d45 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -4,6 +4,9 @@ module Register
       class ShiftIn
         include Input
         #
+        # Model registers that use the arduino shift functions as multi-pin
+        # components, specifying clock, data and latch pins.
+        #
         # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
         include Setup::MultiPin
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index 5a4b80ae..b2e53efa 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -4,12 +4,16 @@ module Register
       class ShiftOut
         include Output
         #
+        # Model registers that use the arduino shift functions as multi-pin
+        # components, specifying clock, data and latch pins.
+        #
         # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
         include Setup::MultiPin
         proxy_pins  clock: Basic::DigitalOutput,
-                    latch: Register::Select,
-                    data:  Basic::DigitalOutput
+                    data:  Basic::DigitalOutput,
+                    latch: Register::Select
+
 
         #
         # Write using the native shiftOut function of the Arduino library.
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 7c0773c4..0329d91f 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -2,10 +2,13 @@ module Dino
   module Components
     module Register
       class SPIIn < Select
+        include Input
+        #
+        # Model SPI registers as single pin. Data comes back on the select pin,
+        # so just inherit from Select.
         #
         # options = {board: my_board, pin: slave_select_pin}
         #
-        include Input
 
         def after_initialize(options={})
           super(options) if defined?(super)
@@ -23,7 +26,8 @@ def after_initialize(options={})
         #
         def read
           # Pack the extra parameters we need to send in the aux message then send.
-          aux = "#{[@spi_mode].pack('C')}#{[@frequency].pack('V')}"
+          start_address = 0
+          aux = "#{[start_address, @spi_mode].pack('C*')}#{[@frequency].pack('V')}"
           board.write Dino::Message.encode(command: 25, pin: pin, value: @bytes, aux_message: aux)
         end
       end
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
new file mode 100644
index 00000000..2b5310d2
--- /dev/null
+++ b/lib/dino/components/register/spi_out.rb
@@ -0,0 +1,38 @@
+module Dino
+  module Components
+    module Register
+      class SPIOut < Select
+        include Output
+        #
+        # Model SPI registers as single pin. Data comes back on the select pin,
+        # so just inherit from Select.
+        #
+        # options = {board: my_board, pin: slave_select_pin}
+        #
+
+        def after_initialize(options={})
+          # Save SPI device settings in instance variables.
+          @spi_mode  = options[:spi_mode] || 0
+
+          # No default value for clock frequency.
+          raise 'SPI clock rate (Hz) required in :frequency option' unless options[:frequency]
+          @frequency = options[:frequency]
+
+          super(options) if defined?(super)
+        end
+
+        #
+        # Write using a call to the native SPI library.
+        #
+        def write(*bytes)
+          # Pack the extra parameters we need to send in the aux message then send.
+          aux = bytes.flatten
+          length = aux.count
+          aux = "#{[@spi_mode].pack('C')}#{[@frequency].pack('V')}#{aux.pack('C*')}"
+
+          board.write Dino::Message.encode(command: 24, pin: pin, value: length, aux_message: aux)
+        end
+      end
+    end
+  end
+end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 44003663..fdee54b5 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -114,7 +114,8 @@ void Dino::process() {
     // auxMsg[0]   = SPI mode (byte)
     // auxMsg[1-4] = clock frequency (uint32_t as 4 bytes)
     // auxMsg[5]+  = data (bytes) (write func only)
-    case 25: readSPI    (pin, val, auxMsg[0], (uint32_t)auxMsg[1]); break;
+    case 24: writeSPI   (pin, val, auxMsg[0], (uint32_t)auxMsg[1], &auxMsg[5]); break;
+    case 25: readSPI    (pin, val, auxMsg[0], (uint32_t)auxMsg[1]            ); break;
 
     case 90: reset               ();  break;
     case 96: setAnalogResolution ();  break;
@@ -407,7 +408,7 @@ void Dino::noTone() {
 
 // CMD = 22
 // Write to a shift register.
-void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte data[]) {
+void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte *data) {
   // Set latch pin low to begin serial write.
   digitalWrite(latchPin, LOW);
 
@@ -457,6 +458,42 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
 }
 
 
+// CMD = 24
+// Write to an SPI device.
+void Dino::writeSPI(int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data) {
+  // Start the SPI library if it isn't already being used by the main sketch.
+  SPI.begin();
+
+  // Set the mode we want.
+  switch(spiMode) {
+    case 0:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE0)); break;
+    case 1:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE1)); break;
+    case 2:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE2)); break;
+    case 3:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE3)); break;
+  }
+
+  // Select the device.
+  digitalWrite(selectPin, LOW);
+
+  // Write one byte at a time.
+  for (uint8_t i = 0;  i < len;  i++) {
+    SPI.transfer(data[i]);
+  }
+
+  // End the SPI transaction, and then library if not in use by main sketch.
+  SPI.endTransaction();
+
+  // TXRX_SPI is set to false in Dino.h.
+  // CLI generator will auto set to true for any sketch other than serial.
+  #if !(TXRX_SPI)
+    SPI.end();
+  #endif
+
+  // Leave select high.
+  digitalWrite(selectPin, HIGH);
+}
+
+
 // CMD = 25
 // Read from an SPI device.
 void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 30c678dc..75efe8c4 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -62,8 +62,9 @@ class Dino {
     void irSend                ();         //cmd = 16
     void tone                  ();         //cmd = 20
     void noTone                ();         //cmd = 21
-    void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte data[]);         //cmd = 22
+    void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte *data);          //cmd = 22
     void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 23
+    void writeSPI              (int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data);     //cmd = 24
     void readSPI               (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 25
     void reset                 ();  //cmd = 90
     void setAnalogResolution   ();  //cmd = 96

From 6d6e9a27d087af7685973cd9c5cf968ab8091d6a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 29 Dec 2017 21:58:13 -0400
Subject: [PATCH 117/296] Add software flow control for data transmitted to the
 board.

---
 examples/register/spi_ssd.rb  |  2 +-
 lib/dino/board.rb             |  1 +
 lib/dino/tx_rx/base.rb        | 86 +++++++++++++++++++++++++++++------
 lib/dino/tx_rx/serial.rb      |  9 ++--
 lib/dino/tx_rx/tcp.rb         | 18 ++++----
 spec/lib/tx_rx/serial_spec.rb |  5 +-
 src/dino_ethernet.ino         | 27 ++++++++++-
 src/dino_serial.ino           | 30 +++++++++++-
 src/dino_wifi.ino             | 28 +++++++++++-
 9 files changed, 174 insertions(+), 32 deletions(-)

diff --git a/examples/register/spi_ssd.rb b/examples/register/spi_ssd.rb
index 0a05e014..079e0915 100644
--- a/examples/register/spi_ssd.rb
+++ b/examples/register/spi_ssd.rb
@@ -18,7 +18,7 @@
                                                          spi_mode: 3
 
 ssd = Dino::Components::SSD.new   board: shift_register,
-                                 pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
+                                  pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
 
 # Turn off the ssd on exit
 trap("SIGINT") { exit !ssd.off }
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 1e081663..8098dec4 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -9,6 +9,7 @@ def initialize(io, options={})
 
       @analog_zero, @dac_zero = @io.handshake.to_s.split(",").map { |pin| pin.to_i }
       self.analog_resolution = options[:bits]
+      start_read
     end
 
     def analog_resolution=(value)
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index fee04990..4600817f 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -7,21 +7,12 @@ class BoardNotFound < StandardError; end
 
     class Base
       include Observable
+      BOARD_BUFFER = 60
 
       def io
         @io ||= connect
       end
 
-      def _read
-        line = gets
-        if line && line.match(/\A\d+:/)
-          pin, message = line.split(/:/)
-          pin && message && changed && notify_observers(pin, message)
-        else
-          sleep 0.005
-        end
-      end
-
       def read
         @thread ||= Thread.new { loop { _read } }.abort_on_exception = true
       end
@@ -32,17 +23,23 @@ def close_read
         @thread = nil
       end
 
+      def write(message)
+        @write_mutex.synchronize { synced_write(message) }
+      end
+
       def handshake
+        initialize_flow_control
         flush_read
-        10.times do
+        10.times do |retries|
           begin
             Timeout.timeout(1) do
               write Dino::Message.encode(command: 90)
               loop do
                 line = gets
                 if line && line.match(/ACK:/)
-                  puts "Connected to board..."
                   flush_read
+                  ignore_retry_bytes(retries)
+                  puts "Connected to board..."
                   return line.split(/:/)[1]
                 end
               end
@@ -54,10 +51,71 @@ def handshake
         raise BoardNotFound
       end
 
-      def write(message); raise "#write should be defined in TxRx subclasses"; end
-
     private
 
+      def synced_write(message)
+        puts "currently #{@transit_bytes} in transit"
+        message = message.split("")
+        loop do
+          @flow_control.synchronize do
+            bytes = BOARD_BUFFER - @transit_bytes
+            break unless bytes > 0
+
+            bytes = message.length if (message.length < bytes)
+            fragment = String.new
+            bytes.times { fragment << message.shift }
+            io.write(fragment)
+            @transit_bytes = @transit_bytes + bytes
+          end
+          return if message.empty?
+          sleep 0.005
+        end
+      end
+
+      def io_write(message); raise "#io_write should be defined in TxRx subclasses"; end
+
+      def _read
+        line = gets
+        line ? process_line(line) : sleep(0.005)
+      end
+
+      def process_line(line)
+        if line.match(/\A\d+:/)
+          pin, message = line.split(/:/)
+          pin && message && changed && notify_observers(pin, message)
+        elsif line.match(/\ARCV:/)
+          # This is acknowledgement from the board that bytes have been read
+          # out of the hardware buffer, freeing up that space.
+          # Subtract from the transit bytes so #synced_write can send more data.
+          remove_transit_bytes(line.split(/:/)[1].to_i)
+        end
+      end
+
+      def initialize_flow_control
+        @flow_control  ||= Mutex.new
+        @write_mutex   ||= Mutex.new
+        @transit_bytes ||= 0
+      end
+
+      def transit_bytes
+        @flow_control.synchronize { @transit_bytes }
+      end
+
+      def add_transit_bytes(value)
+        @flow_control.synchronize { @transit_bytes = @transit_bytes + value }
+      end
+
+      def remove_transit_bytes(value)
+        @flow_control.synchronize { @transit_bytes = @transit_bytes - value }
+      end
+
+      # Subtract bytes for failed handshakes from the total in transit bytes.
+      # The board will never acknowledge these.
+      def ignore_retry_bytes(retries)
+        retry_bytes = Dino::Message.encode(command: 90).length * retries
+        remove_transit_bytes(retry_bytes)
+      end
+
       def connect(message); raise "#connect should be defined in TxRx subclasses"; end
       def gets(message); raise "#gets should be defined in TxRx subclasses"; end
 
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index de7a939e..f61a6363 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -10,13 +10,10 @@ def initialize(options={})
         @baud = options[:baud] || BAUD
       end
 
-      def write(message)
-        io.write(message)
-      end
-
     private
 
       def connect
+        # ::Serial calls the rubyserial gem here.
         tty_devices.each { |device| return ::Serial.new(device, @baud) rescue nil }
         raise BoardNotFound
       end
@@ -31,6 +28,10 @@ def on_windows?
         RUBY_PLATFORM.match /mswin|mingw/i
       end
 
+      def io_write(message)
+        io.write(message)
+      end
+
       def gets(timeout=0)
         buff, escaped = "", false
         loop do
diff --git a/lib/dino/tx_rx/tcp.rb b/lib/dino/tx_rx/tcp.rb
index edeb1125..d9610775 100644
--- a/lib/dino/tx_rx/tcp.rb
+++ b/lib/dino/tx_rx/tcp.rb
@@ -7,15 +7,6 @@ def initialize(host, port=3466)
         @host, @port = host, port
       end
 
-      def write(message)
-        loop do
-          if IO.select(nil, [io], nil)
-            io.syswrite(message)
-            break
-          end
-        end
-      end
-
     private
 
       def connect
@@ -24,6 +15,15 @@ def connect
         raise BoardNotFound
       end
 
+      def io_write(message)
+        loop do
+          if IO.select(nil, [io], nil)
+            io.syswrite(message)
+            break
+          end
+        end
+      end
+
       def gets(timeout=0.005)
         IO.select([io], nil, nil, timeout) && io.gets.gsub(/\n\z/, "")
       end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index 7a2eb07d..3608a181 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -56,7 +56,7 @@ module Dino
         expect(subject).to receive(:gets).and_return("02:00")
         expect(subject).to receive(:changed).and_return(true)
         expect(subject).to receive(:notify_observers).with('02','00')
-        subject._read
+        subject.send(:_read)
       end
     end
 
@@ -81,8 +81,11 @@ module Dino
       it 'should write to the device' do
         expect(subject).to receive(:io).and_return(mock_serial = double)
         expect(mock_serial).to receive(:write).with('a message')
+        subject.send(:initialize_flow_control)
         subject.write('a message')
       end
+
+      it 'should break up messages larger than the board input buffer'
     end
 
     describe '#gets' do
diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index 40805e90..e2abb425 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -59,6 +59,20 @@ void setup() {
   dino.setupWrite(writeCallback);
 }
 
+
+// Keep count of bytes as we receive them and send a dino message with how many.
+uint8_t rcvBytes  = 0;
+uint8_t rcvBuffer = 60;
+long    lastRcv   = micros();
+long    rcvWindow = 1000000;
+
+void acknowledge() {
+  client.write("RCV:");
+  client.write(rcvBytes);
+  client.write("\n");
+  rcvBytes = 0;
+}
+
 void loop() {
   // Listen for connections.
   client = server.available();
@@ -66,7 +80,18 @@ void loop() {
   // Handle a connection.
   if (client) {
     while (client.connected()) {
-      while (client.available()) dino.parse(client.read());
+      while (client.available()){
+        dino.parse(client.read());
+
+        // Acknowledge when we've received as many bytes as the serial input buffer.
+        lastRcv = micros();
+        rcvBytes ++;
+        if (rcvBytes == rcvBuffer) acknowledge();
+      }
+
+      // Also acknowledge when the last byte received goes outside the receive window.
+      if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
+
       dino.updateListeners();
       writeResponses();
     }
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index becc210f..06046473 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -17,6 +17,7 @@ Dino dino;
   HardwareSerial &serial = Serial;
 #endif
 
+
 // Dino.h doesn't handle TXRX. Create a callback so it can write to serial.
 void writeResponse(char *response) { serial.print(response); }
 void (*writeCallback)(char *str) = writeResponse;
@@ -32,7 +33,34 @@ void setup() {
   dino.setupWrite(writeCallback);
 }
 
+
+// Keep count of bytes as we receive them and send a dino message with how many.
+uint8_t rcvBytes  = 0;
+uint8_t rcvBuffer = 60;
+long    lastRcv   = micros();
+long    rcvWindow = 1000000;
+
+void acknowledge() {
+  serial.print("RCV:");
+  serial.print(rcvBytes);
+  serial.print("\n");
+  rcvBytes = 0;
+}
+
+
 void loop() {
-  while(serial.available() > 0) dino.parse(serial.read());
+  while(serial.available() > 0) {
+    dino.parse(serial.read());
+
+    // Acknowledge when we've received as many bytes as the serial input buffer.
+    lastRcv = micros();
+    rcvBytes ++;
+    if (rcvBytes == rcvBuffer) acknowledge();
+  }
+
+  // Also acknowledge when the last byte received goes outside the receive window.
+  if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
+
+  // Run dino's listeners.
   dino.updateListeners();
 }
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 704a058c..edb436c3 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -68,6 +68,21 @@ void setup() {
   dino.setupWrite(writeCallback);
 }
 
+
+// Keep count of bytes as we receive them and send a dino message with how many.
+uint8_t rcvBytes  = 0;
+uint8_t rcvBuffer = 60;
+long    lastRcv   = micros();
+long    rcvWindow = 1000000;
+
+void acknowledge() {
+  client.write("RCV:");
+  client.write(rcvBytes);
+  client.write("\n");
+  rcvBytes = 0;
+}
+
+
 void loop() {
   // Listen for connections.
   client = server.available();
@@ -75,7 +90,18 @@ void loop() {
   // Handle a connection.
   if (client) {
     while (client.connected()) {
-      while (client.available()) dino.parse(client.read());
+      while (client.available()){
+        dino.parse(client.read());
+
+        // Acknowledge when we've received as many bytes as the serial input buffer.
+        lastRcv = micros();
+        rcvBytes ++;
+        if (rcvBytes == rcvBuffer) acknowledge();
+      }
+
+      // Also acknowledge when the last byte received goes outside the receive window.
+      if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
+
       dino.updateListeners();
       writeResponses();
     }

From 451fcdce87cae306e6ddfd79346c2ea86605e6a1 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 29 Dec 2017 22:44:12 -0400
Subject: [PATCH 118/296] Forgot to remove a debugging line.

---
 lib/dino/tx_rx/base.rb | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 4600817f..3f0d16de 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -54,7 +54,6 @@ def handshake
     private
 
       def synced_write(message)
-        puts "currently #{@transit_bytes} in transit"
         message = message.split("")
         loop do
           @flow_control.synchronize do

From e437a10b5be36b189fe5586bae3f1350a1e4837d Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 30 Dec 2017 01:40:31 -0400
Subject: [PATCH 119/296] Add listeners for shift and SPI registers.

---
 examples/button/button.rb                    |   3 +
 examples/register/shift_in.rb                |   8 +-
 examples/register/spi_combined.rb            |  41 +++++++
 examples/register/spi_in.rb                  |   8 +-
 lib/dino/components/mixins/callbacks.rb      |   5 +-
 lib/dino/components/mixins/reader.rb         |   2 +-
 lib/dino/components/register/input.rb        |  73 +++++++++--
 lib/dino/components/register/shift_in.rb     |  11 ++
 lib/dino/components/register/spi_in.rb       |  14 ++-
 spec/lib/components/mixins/callbacks_spec.rb |   6 +-
 src/lib/Dino.cpp                             | 122 ++++++++++++++++---
 src/lib/Dino.h                               |  41 ++++++-
 12 files changed, 290 insertions(+), 44 deletions(-)
 create mode 100644 examples/register/spi_combined.rb

diff --git a/examples/button/button.rb b/examples/button/button.rb
index 4f9f0d31..eadecf7f 100644
--- a/examples/button/button.rb
+++ b/examples/button/button.rb
@@ -18,4 +18,7 @@
   puts "button up"
 end
 
+# Force callbacks to run at least once for the initial state.
+button.read
+
 sleep
diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index 4293bfb3..64ce1521 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -26,7 +26,7 @@
 button.down { puts "down"}
 button.up   { puts "up"  }
 
-loop do
-  button.read
-  sleep 0.1
-end
+# Force callbacks to run at least once for the initial state.
+button.read
+
+sleep
diff --git a/examples/register/spi_combined.rb b/examples/register/spi_combined.rb
new file mode 100644
index 00000000..32bfa994
--- /dev/null
+++ b/examples/register/spi_combined.rb
@@ -0,0 +1,41 @@
+#
+# Example showing how to use an output shift register to drive a seven segment display.
+#
+# The register implements #digital_write and other methods expected by Components,
+# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+#
+# The SSD object is created by passing the register instead of the board, and
+# the registers's parallel pin number that each SSD pin is connected to.
+#
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+output_register = Dino::Components::Register::SPIOut.new  board: board,
+                                                          pin: 9,
+                                                          frequency: 3000000,
+                                                          spi_mode: 3
+
+ssd = Dino::Components::SSD.new   board: output_register,
+                                  pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
+
+input_register = Dino::Components::Register::SPIIn.new  board: board,
+                                                        pin: 10,
+                                                        bytes: 1,
+                                                        spi_mode: 3,
+                                                        frequency: 3000000
+
+button = Dino::Components::Button.new(pin: 0, board: input_register)
+
+button.down { puts "down"}
+button.up   { puts "up"  }
+
+# Force callbacks to run at least once for the initial state.
+button.read
+
+# Turn off the ssd on exit
+trap("SIGINT") { exit !ssd.off }
+
+# Display each new line on the ssd
+loop { ssd.display(gets.chomp) }
diff --git a/examples/register/spi_in.rb b/examples/register/spi_in.rb
index 308e6007..6bacdd9c 100644
--- a/examples/register/spi_in.rb
+++ b/examples/register/spi_in.rb
@@ -34,7 +34,7 @@
 button.down { puts "down"}
 button.up   { puts "up"  }
 
-loop do
-  button.read
-  sleep 0.1
-end
+# Force callbacks to run at least once for the initial state.
+button.read
+
+sleep
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index a2661a65..15253360 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -17,7 +17,7 @@ def add_callback(key=:persistent, &block)
 
         def remove_callback(key=nil)
           @callback_mutex.synchronize {
-            key ? @callbacks[key] = [] : @callbacks = {}
+            key ? @callbacks.delete(key) : @callbacks = {}
           }
         end
 
@@ -29,8 +29,9 @@ def update(data)
             @callbacks.each_value do |array|
               array.each { |callback| callback.call(data) }
             end
+            # Remove the special :read callback while still inside the lock.
+            @callbacks.delete(:read)
           }
-          remove_callback :read
           @state = data
         end
       end
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index 6f3c90ff..285a6eca 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -7,7 +7,7 @@ module Reader
         def read(&block)
           add_callback(:read, &block) if block_given?
           _read
-          loop { break if !@callbacks[:read] || @callbacks[:read].empty? }
+          loop { break if !@callbacks[:read] }
         end
 
         #
diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index 8f5768d2..48dc4dac 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -20,6 +20,13 @@ def after_initialize(options={})
           #
           @state = Array.new(@bytes*8) {|i| 0}
 
+          #
+          # Keep track of whether anything is listening or reading a specific pin.
+          # This might be separate from whether a component is attached or not.
+          #
+          @reading_pins   = Array.new(@bytes*8) {|i| false}
+          @listening_pins = Array.new(@bytes*8) {|i| false}
+
           #
           # Certain registers which use rising edges for clock signals produce
           # errors with the native Arduino shiftIn function unless you set the clock
@@ -32,12 +39,28 @@ def after_initialize(options={})
         end
 
         #
-        # Callbacks#update mostly works, but we need to convert the state from
-        # comma delimited numbers into an array of bits first.
+        # Override Callbacks#update to make sure we handle :force_update
+        # within the main mutex lock.
         #
         def update(message)
           bits = byte_array_to_bit_array(message.split(","))
-          super(bits)
+
+          @callback_mutex.synchronize {
+            #
+            # The Arduino code does not de-duplicate repeated state.
+            # Do it here, but if a :force_update callback exists, run anyway.
+            #
+            if (bits != @state)|| @callbacks[:force_update]
+              @callbacks.each_value do |array|
+                array.each { |callback| callback.call(bits) }
+              end
+            end
+
+            # Remove both :read and :force update while inside the lock.
+            @callbacks.delete(:read)
+            @callbacks.delete(:force_update)
+          }
+          @state = bits
         end
 
         #
@@ -66,18 +89,37 @@ def listen
         include Mixins::BoardProxy
 
         def digital_read(pin)
-          read
+          #
+          # Remember what pin was read and force callbacks to run next update.
+          #
+          add_callback(:force_update) { Proc.new{} }
+          @reading_pins[pin] = true
+
+          # Don't actually call #read if already listening.
+          read unless any_listening
         end
 
         def digital_listen(pin)
-          #
-          # Start the remote listener
-          # Need to implement this on Arduino.
-          #
+          listen unless any_listening
+          @listening_pins[pin] = true
+        end
+
+        def stop_listener(pin)
+          @listening_pins[pin] = false
+          stop unless any_listening
+        end
+
+        def any_listening
+          @listening_pins.each { |p| return true if p }
+          false
+        end
+
+        def stop
+          raise 'define #stop in child class to stop the listener'
         end
 
         #
-        # Mimic Board#update, but in a callback fired through Callbacks#update.
+        # Mimic Board#update, but in a callback fired through #update.
         # This doesn't interfere with using the register directly,
         # and doesn't fire if the board isn't acting as a proxy (no components).
         #
@@ -85,11 +127,22 @@ def enable_proxy
           self.add_callback(:board_proxy) do |bit_array|
             bit_array.each_with_index do |value, pin|
               @components.each do |part|
-                part.update(value) if pin.to_i == part.pin
+                update_component(part, pin, value) if pin == part.pin
               end
+              @reading_pins[pin] = false
             end
           end
         end
+
+        def update_component(part, pin, value)
+          # Update if component is listening and value has changed.
+          if @listening_pins[pin] && (value != @state[pin])
+            part.update(value)
+          # Also update if the component forced a read.
+          elsif @reading_pins[pin] && @callbacks[:force_update]
+            part.update(value)
+          end
+        end
       end
     end
   end
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index cd1f6d45..c6c65779 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -37,6 +37,17 @@ def read
           aux = [data.pin, clock.pin, @preclock_high].pack('C*')
           board.write Dino::Message.encode(command: 23, pin: latch.pin, value: @bytes, aux_message: aux)
         end
+
+        def listen
+          # Pack the extra parameters we need to send in the aux message then send.
+          aux = [data.pin, clock.pin, @preclock_high].pack('C*')
+          board.write Dino::Message.encode(command: 26, pin: latch.pin, value: @bytes, aux_message: aux)
+        end
+
+        def stop
+          # Just need to send the latch pin to stop listening.
+          board.write Dino::Message.encode(command: 28, pin: latch.pin)
+        end
       end
     end
   end
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 0329d91f..4f7cb5de 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -3,13 +3,13 @@ module Components
     module Register
       class SPIIn < Select
         include Input
+
         #
         # Model SPI registers as single pin. Data comes back on the select pin,
         # so just inherit from Select.
         #
         # options = {board: my_board, pin: slave_select_pin}
         #
-
         def after_initialize(options={})
           super(options) if defined?(super)
 
@@ -30,6 +30,18 @@ def read
           aux = "#{[start_address, @spi_mode].pack('C*')}#{[@frequency].pack('V')}"
           board.write Dino::Message.encode(command: 25, pin: pin, value: @bytes, aux_message: aux)
         end
+
+        def listen
+          # Pack the extra parameters we need to send in the aux message then send.
+          start_address = 0
+          aux = "#{[start_address, @spi_mode].pack('C*')}#{[@frequency].pack('V')}"
+          board.write Dino::Message.encode(command: 27, pin: pin, value: @bytes, aux_message: aux)
+        end
+
+        def stop
+          # Just need to send the select pin to stop listening.
+          board.write Dino::Message.encode(command: 28, pin: pin)
+        end
       end
     end
   end
diff --git a/spec/lib/components/mixins/callbacks_spec.rb b/spec/lib/components/mixins/callbacks_spec.rb
index 5f0186a6..cbc23595 100644
--- a/spec/lib/components/mixins/callbacks_spec.rb
+++ b/spec/lib/components/mixins/callbacks_spec.rb
@@ -52,8 +52,8 @@ def initialize; after_initialize; end
 
             it 'should remove only callbacks for a specific key given' do
               subject.remove_callbacks(:read)
-              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq([])
-              expect(subject.instance_variable_get(:@callbacks)[:persistent]).to_not eq([])
+              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq(nil)
+              expect(subject.instance_variable_get(:@callbacks)[:persistent]).to_not eq(nil)
             end
           end
 
@@ -71,7 +71,7 @@ def initialize; after_initialize; end
 
             it 'should remove any callbacks saved with the key :read' do
               subject.update("data")
-              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq([])
+              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq(nil)
             end
           end
         end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index fdee54b5..6e7cfd79 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -107,7 +107,6 @@ void Dino::process() {
     // auxMsg[3]+ = data (bytes) (write func only)
     case 22: shiftWrite (pin, val, auxMsg[0], auxMsg[1], &auxMsg[3]);  break;
     case 23: shiftRead  (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);   break;
-
     // Request format for single direction SPI functions.
     // pin         = slave select pin (int)
     // val         = length (int)
@@ -116,8 +115,16 @@ void Dino::process() {
     // auxMsg[5]+  = data (bytes) (write func only)
     case 24: writeSPI   (pin, val, auxMsg[0], (uint32_t)auxMsg[1], &auxMsg[5]); break;
     case 25: readSPI    (pin, val, auxMsg[0], (uint32_t)auxMsg[1]            ); break;
+    // These add listeners for both shift in and SPI registers.
+    // They mirror the read function interfaces of the respective devices.
+    case 26: addShiftListener(pin, val, auxMsg[0], auxMsg[1], auxMsg[2]); break;
+    case 27: addSPIListener  (pin, val, auxMsg[0], (uint32_t)auxMsg[1]);  break;
+    // This removes either type of listener and frees its space in the cache.
+    // The only input it needs is the select/latch pin.
+    case 28: removeRegisterListener();
 
     case 90: reset               ();  break;
+    case 95: setAnalogDivider    ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
     case 98: setHeartRate        ();  break;
@@ -149,7 +156,8 @@ void Dino::updateListeners() {
     lastUpdate = micros();
     loopCount++;
     updateDigitalListeners();
-    if (loopCount % analogDivider == 0) updateAnalogListeners();
+    if (loopCount % registerDivider == 0) updateRegisterListeners();
+    if (loopCount % analogDivider   == 0) updateAnalogListeners();
   }
 }
 void Dino::updateDigitalListeners() {
@@ -163,6 +171,25 @@ void Dino::updateDigitalListeners() {
     }
   }
 }
+void Dino::updateRegisterListeners() {
+  for (int i = 0; i < SPI_LISTENER_COUNT; i++) {
+    if (spiListeners[i].enabled) {
+      readSPI(spiListeners[i].selectPin,
+              spiListeners[i].len,
+              spiListeners[i].spiMode,
+              spiListeners[i].clockRate);
+    }
+  }
+  for (int i = 0; i < SHIFT_LISTENER_COUNT; i++) {
+    if (shiftListeners[i].enabled) {
+      shiftRead(shiftListeners[i].latchPin,
+                shiftListeners[i].len,
+                shiftListeners[i].dataPin,
+                shiftListeners[i].clockPin,
+                shiftListeners[i].clockHighFirst);
+    }
+  }
+}
 void Dino::updateAnalogListeners() {
   for (int i = 0; i < PIN_COUNT; i++) {
     if (analogListeners[i]) {
@@ -543,18 +570,82 @@ void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
   response[0] = "\0";
 }
 
+// CMD = 26
+// Start listening to a register using the Arduino shiftIn function.
+// Overwrite the first disabled listener in the struct array.
+void Dino::addShiftListener(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
+  for (int i = 0;  i < SHIFT_LISTENER_COUNT;  i++) {
+    if (shiftListeners[i].enabled == false) {
+      shiftListeners[i] = {
+        latchPin,
+        len,
+        dataPin,
+        clockPin,
+        clockHighFirst,
+        true
+      };
+      return;
+    } else {
+    // Should send some kind of error if all are in use.
+    }
+  }
+}
+
+// CMD = 26
+// Start listening to an SPI register.
+// Overwrite the first disabled listener in the struct array.
+void Dino::addSPIListener(int selectPin, int len, byte spiMode, uint32_t clockRate) {
+  for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
+    if (spiListeners[i].enabled == false) {
+      spiListeners[i] = {
+        selectPin,
+        len,
+        spiMode,
+        clockRate,
+        true
+      };
+      return;
+    } else {
+    // Should send some kind of error if all are in use.
+    }
+  }
+}
+
+
+// CMD = 27
+// Send a number for a select/latch pin to remove either type of register listener.
+void Dino::removeRegisterListener() {
+  for (int i = 0;  i < SHIFT_LISTENER_COUNT;  i++) {
+    if (shiftListeners[i].latchPin == pin) {
+      shiftListeners[i].enabled = false;
+    }
+  }
+  for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
+    if (spiListeners[i].selectPin == pin) {
+      spiListeners[i].enabled = false;
+    }
+  }
+}
+
 
 // CMD = 90
 void Dino::reset() {
-  heartRate = 4000; // Default heartRate is ~4ms.
-  loopCount = 0;
-  analogDivider = 4; // Update analog listeners every ~16ms.
+  // Clear the analog and digital pin listeners.
   for (int i = 0; i < PIN_COUNT; i++) digitalListeners[i] = false;
   for (int i = 0; i < PIN_COUNT; i++) digitalListenerValues[i] = 2;
-  for (int i = 0; i < PIN_COUNT; i++)  analogListeners[i] = false;
-  lastUpdate = micros();
+  for (int i = 0; i < PIN_COUNT; i++) analogListeners[i] = false;
+
+  // Disable the register listeners.
+  for (int i = 0; i < SHIFT_LISTENER_COUNT; i++) shiftListeners[i].enabled = false;
+  for (int i = 0; i < SPI_LISTENER_COUNT; i++)   spiListeners[i].enabled = false;
+
+  heartRate = 4000; // Update digital listeners every ~4ms.
+  analogDivider   = 4; // Update analog listeners every ~16ms.
+  registerDivider = 2; // Update register listeners every ~8ms.
   fragmentIndex = 0;
   charIndex = 0;
+  loopCount = 0;
+  lastUpdate = micros();
 
   #if defined(__SAM3X8E__)
     sprintf(response, "ACK:%d,%d", A0, DAC0);
@@ -563,15 +654,18 @@ void Dino::reset() {
   #endif
 }
 
-// CMD = 97
+// CMD = 95
+// Set the register read divider. Powers of 2 up to 128 are valid.
+void Dino::setRegisterDivider() {
+  registerDivider = val;
+}
+
+// CMD = 96
 // Set the analog read and write resolution.
 void Dino::setAnalogResolution() {
   #if defined(__SAM3X8E__)
     analogReadResolution(val);
     analogWriteResolution(val);
-    #ifdef debug
-      Serial.print("Analog R/W resolution set to "); Serial.println(val);
-    #endif
   #endif
 }
 
@@ -579,16 +673,10 @@ void Dino::setAnalogResolution() {
 // Set the analog divider. Powers of 2 up to 128 are valid.
 void Dino::setAnalogDivider() {
   analogDivider = val;
-  #ifdef debug
-    Serial.print("Analog divider set to "); Serial.println(analogDivider);
-  #endif
 }
 
 // CMD = 98
 // Set the heart rate in milliseconds. Store it in microseconds.
 void Dino::setHeartRate() {
   heartRate = atoi(auxMsg);
-  #ifdef debug
-    Serial.print("Heart rate set to "); Serial.print(heartRate); Serial.println(" microseconds");
-  #endif
 }
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 75efe8c4..f6c730a3 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -32,6 +32,10 @@
 #  define SERVO_OFFSET 2
 #endif
 
+// Allocate listener storage for serial registers.
+#define SPI_LISTENER_COUNT 4
+#define SHIFT_LISTENER_COUNT 4
+
 // Uncomment this line to enable debugging mode.
 // #define debug true
 
@@ -66,11 +70,21 @@ class Dino {
     void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 23
     void writeSPI              (int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data);     //cmd = 24
     void readSPI               (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 25
+    void addShiftListener      (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 26
+    void addSPIListener        (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 27
+    void removeRegisterListener();                                                                         //cmd = 28
     void reset                 ();  //cmd = 90
+    void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
     void setHeartRate          ();  //cmd = 98
 
+    // Serial flow control variables.
+    uint8_t rcvBytes = 0;
+    uint8_t rcvBuffer = 60;
+    long    lastRcv = micros();
+    long    rcvWindow  = 1000000;
+
     // Parser state storage and utility functions.
     char *messageFragments[4];
     byte fragmentIndex;
@@ -102,17 +116,40 @@ class Dino {
     long lastUpdate;
     unsigned int loopCount;
     unsigned int analogDivider;
+    unsigned int registerDivider;
     long timeSince (long event);
 
     // Listeners correspond to raw pin number by array index, and store boolean. false == disabled.
     boolean analogListeners[PIN_COUNT];
     boolean digitalListeners[PIN_COUNT];
 
+    // Create listeners for SPI registers.
+    struct spiListener{
+      byte     selectPin;
+      byte     len;
+      byte     spiMode;
+      uint32_t clockRate;
+      boolean  enabled;
+    };
+    spiListener spiListeners[SPI_LISTENER_COUNT];
+
+    // Create listeners for ShiftIn registers.
+    struct shiftListener{
+      byte     latchPin;
+      byte     len;
+      byte     dataPin;
+      byte     clockPin;
+      byte     clockHighFirst;
+      boolean  enabled;
+    };
+    shiftListener shiftListeners[SHIFT_LISTENER_COUNT];
+
     // Keep track of the last read values for digital listeners. Only write responses when changed.
     byte digitalListenerValues[PIN_COUNT];
 
     // Listener update functions.
-    void updateDigitalListeners ();
-    void updateAnalogListeners  ();
+    void updateDigitalListeners  ();
+    void updateRegisterListeners ();
+    void updateAnalogListeners   ();
 };
 #endif

From c796776004a4aab6a6bb8559bb7dc378166471fa Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 30 Dec 2017 21:08:00 -0400
Subject: [PATCH 120/296] Only split board messages on the fist colon. Allows
 colon in values.

---
 lib/dino/tx_rx/base.rb        | 2 +-
 spec/lib/tx_rx/serial_spec.rb | 7 +++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 3f0d16de..b38486d8 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -80,7 +80,7 @@ def _read
 
       def process_line(line)
         if line.match(/\A\d+:/)
-          pin, message = line.split(/:/)
+          pin, message = line.split(":", 2)
           pin && message && changed && notify_observers(pin, message)
         elsif line.match(/\ARCV:/)
           # This is acknowledgement from the board that bytes have been read
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index 3608a181..bdb03cb0 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -58,6 +58,13 @@ module Dino
         expect(subject).to receive(:notify_observers).with('02','00')
         subject.send(:_read)
       end
+
+      it 'should not split messages into more than 2 parts on :' do
+        expect(subject).to receive(:gets).and_return("02:00:00")
+        expect(subject).to receive(:changed).and_return(true)
+        expect(subject).to receive(:notify_observers).with('02','00:00')
+        subject.send(:_read)
+      end
     end
 
     describe '#read' do

From 55af6a901e896bcf478f8c988f5a453aefbc8eea Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 31 Dec 2017 01:12:28 -0400
Subject: [PATCH 121/296] Add I2C functions to arduino sketch.

---
 .gitmodules               |   3 +
 lib/dino_cli/generator.rb |   5 +-
 src/lib/Dino.cpp          | 136 ++++++++++++++++++++++++++++++++++----
 src/lib/Dino.h            |  10 ++-
 4 files changed, 138 insertions(+), 16 deletions(-)

diff --git a/.gitmodules b/.gitmodules
index ae49a950..2d2f614d 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,3 +1,6 @@
 [submodule "src/vendor/Arduino-IRremote"]
 	path = src/vendor/Arduino-IRremote
 	url = https://github.com/vickash/Arduino-IRremote.git
+[submodule "src/vendor/I2C-Master-Library"]
+	path = src/vendor/I2C-Master-Library
+	url = https://github.com/vickash/I2C-Master-Library.git
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 09e25b3e..eb8f3b2c 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -16,7 +16,10 @@ class DinoCLI::Generator
                     "vendor/Arduino-IRremote/IRremote.cpp",
                     "vendor/Arduino-IRremote/IRremote.h",
                     "vendor/Arduino-IRremote/IRremoteInt.h",
-                    "vendor/Arduino-IRremote/irSend.cpp"
+                    "vendor/Arduino-IRremote/irSend.cpp",
+
+                    "vendor/I2C-Master-Library/I2C.h",
+                    "vendor/I2C-Master-Library/I2C.cpp"
                   ]
 
   attr_accessor :options
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 6e7cfd79..33767c3d 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -26,7 +26,7 @@ Dino::Dino(){
   reset();
 }
 
-void Dino::parse(char c) {
+void Dino::parse(byte c) {
   if ((c == '\n') || (c == '\\')) {
     // If last char was a \, this \ or \n is escaped.
     if(backslash){
@@ -62,7 +62,7 @@ void Dino::parse(char c) {
   else append(c);
 }
 
-void Dino::append(char c) {
+void Dino::append(byte c) {
   messageFragments[fragmentIndex][charIndex++] = c;
 }
 
@@ -123,6 +123,13 @@ void Dino::process() {
     // The only input it needs is the select/latch pin.
     case 28: removeRegisterListener();
 
+    // I2C functions.
+    case 30: i2cBegin            ();  break;
+    case 31: i2cEnd              ();  break;
+    case 32: i2cScan             ();  break;
+    case 33: i2cWrite            ();  break;
+    case 34: i2cRead             ();  break;
+
     case 90: reset               ();  break;
     case 95: setAnalogDivider    ();  break;
     case 96: setAnalogResolution ();  break;
@@ -242,7 +249,7 @@ void Dino::dWrite() {
 // CMD = 02 // Digital Read
 void Dino::dRead(int pin) {
   rval = digitalRead(pin);
-  sprintf(response, "%02d:%02d", pin, rval);
+  sprintf(response, "%d:%d", pin, rval);
 }
 
 // CMD = 03 // Analog (PWM) Write
@@ -256,7 +263,7 @@ void Dino::aWrite() {
 // CMD = 04 // Analog Read
 void Dino::aRead(int pin) {
   rval = analogRead(pin);
-  sprintf(response, "%02d:%02d", pin, rval);
+  sprintf(response, "%d:%d", pin, rval);
 }
 
 // CMD = 05
@@ -463,7 +470,7 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
 
   // Send data as if coming from the latch pin so it's easy to identify.
   // Start with just pin number and : for now.
-  sprintf(response, "%02d:", latchPin);
+  sprintf(response, "%d:", latchPin);
   _writeCallback(response);
 
   for (int i = 1;  i <= len;  i++) {
@@ -472,16 +479,16 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
 
     // If we're on the last byte, append \n. If not, append a comma, then write.
     if (i == len) {
-      sprintf(response, "%03d\n", reading);
+      sprintf(response, "%d\n", reading);
     } else {
-      sprintf(response, "%03d,", reading);
+      sprintf(response, "%d,", reading);
     }
     _writeCallback(response);
   }
 
   // Leave latch pin high and clear response so main loop doesn't send anything.
   digitalWrite(latchPin, HIGH);
-  response[0] = "\0";
+  response[0] = '\0';
 }
 
 
@@ -540,7 +547,7 @@ void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
 
   // Send data as if coming from the slave select pin so it's easy to identify.
   // Start with just pin number and : for now.
-  sprintf(response, "%02d:", selectPin);
+  sprintf(response, "%d:", selectPin);
   _writeCallback(response);
 
   for (int i = 1;  i <= len;  i++) {
@@ -549,9 +556,9 @@ void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
 
     // If we're on the last byte, append \n. If not, append a comma, then write.
     if (i == len) {
-      sprintf(response, "%03d\n", reading);
+      sprintf(response, "%d\n", reading);
     } else {
-      sprintf(response, "%03d,", reading);
+      sprintf(response, "%d,", reading);
     }
     _writeCallback(response);
   }
@@ -567,7 +574,7 @@ void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
 
   // Leave select high and clear response so main loop doesn't send anything.
   digitalWrite(selectPin, HIGH);
-  response[0] = "\0";
+  response[0] = '\0';
 }
 
 // CMD = 26
@@ -628,6 +635,109 @@ void Dino::removeRegisterListener() {
 }
 
 
+// CMD = 30
+// Start I2C communication.
+void Dino::i2cBegin() {
+  I2c.begin();
+  // I2c.setSpeed(??);
+  // I2c.pullup(??);
+  // I2c.timeOut(??);
+  sprintf(response, "%d:I2C:1", SDA);
+}
+
+
+// CMD = 31
+// Stop I2C communication.
+void Dino::i2cEnd() {
+  I2c.end();
+  sprintf(response, "%d:I2C:0", SDA);
+}
+
+
+// CMD = 32
+// Scan for I2C devices.
+//
+// WARNING: This takes a long time! Try to record the device addresses
+// results and put them into your code.
+//
+// Returns each found address as if a separate reading from SDA pin, eg. "18:104".
+// Returns 128 as if read from SDA pin for search complete, eg. "18:128".
+// Returns 255 as if read from SDA pin for I2C errors, eg. "18:255".
+//
+void Dino::i2cScan() {
+  uint8_t address = 0;
+  while (address < 128) {
+    // Scan for the next device.
+    address = I2c.scanOne(address);
+
+    // Write whatever we get including address space end or errors.
+    sprintf(response, "%d:%d", SDA, address);
+    writeResponse();
+    address++;
+  }
+  // Clear the response to make sure it doesn't get sent twice.
+  response[0] = '\0';
+}
+
+
+// CMD = 33
+// Write to an I2C device.
+// All parameters need to be sent in binary in the auxMsg.
+//
+// auxMsg[0]  = device address
+// auxMsg[1]  = register start address
+// auxMsg[2]  = number of bytes
+// auxMsg[3]+ = data
+//
+// Limited to 255 bytes. Validate on remote end.
+//
+void Dino::i2cWrite() {
+  I2c.write(auxMsg[0], auxMsg[1], &auxMsg[3], auxMsg[2]);
+}
+
+
+// CMD = 34
+// Read from an I2C device.
+// All params need to be sent in binary in the auxMsg.
+//
+// auxMsg[0]  = device address
+// auxMsg[1]  = register start address
+// auxMsg[2]  = number of bytes
+//
+// Streams data back in comma delimited ASCII decimal for now,
+// matching shiftRead and readSPI. Limited to 32 bytes by I2C library buffer.
+// Validate on remote end.
+//
+void Dino::i2cRead() {
+  // Force length to be min 1, max 32.
+  if (auxMsg[2] > 32) auxMsg[2] = 32;
+  if (auxMsg[2] == 0) auxMsg[2] =  1;
+
+  // Read all the bytes into the library buffer.
+  I2c.read(auxMsg[0], auxMsg[1], auxMsg[2]);
+
+  // Send back the SDA pin, the device address, and start register address first.
+  sprintf(response, "%d:%d:%d:", SDA, auxMsg[0], auxMsg[1]);
+  _writeCallback(response);
+
+  // Send back the data bytes.
+  uint8_t currentByte = 0;
+  while(I2c.available()){
+    currentByte++;
+    // Append comma, but \n for last byte, then write.
+    if (currentByte == auxMsg[2]){
+      sprintf(response, "%d\n", I2c.receive());
+    } else {
+      sprintf(response, "%d,", I2c.receive());
+    }
+    _writeCallback(response);
+  }
+
+  // Clear the response to make sure it doesn't get sent twice.
+  response[0] = '\0';
+}
+
+
 // CMD = 90
 void Dino::reset() {
   // Clear the analog and digital pin listeners.
@@ -637,7 +747,7 @@ void Dino::reset() {
 
   // Disable the register listeners.
   for (int i = 0; i < SHIFT_LISTENER_COUNT; i++) shiftListeners[i].enabled = false;
-  for (int i = 0; i < SPI_LISTENER_COUNT; i++)   spiListeners[i].enabled = false;
+  for (int i = 0; i < SPI_LISTENER_COUNT;   i++) spiListeners[i].enabled = false;
 
   heartRate = 4000; // Update digital listeners every ~4ms.
   analogDivider   = 4; // Update analog listeners every ~16ms.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index f6c730a3..fb53adc2 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -13,6 +13,7 @@
 #include "DHT.h"
 #include "OneWire.h"
 #include "IRremote.h"
+#include "I2C.h"
 
 // SoftwareSerial doesn't work on the Due yet.
 #if !defined(__SAM3X8E__)
@@ -43,7 +44,7 @@ class Dino {
   public:
     Dino();
     void setupWrite(void (*writeCallback)(char *str));
-    void parse(char c);
+    void parse(byte c);
     void updateListeners();
 
   private:
@@ -73,6 +74,11 @@ class Dino {
     void addShiftListener      (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 26
     void addSPIListener        (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 27
     void removeRegisterListener();                                                                         //cmd = 28
+    void i2cBegin              (); //cmd = 30
+    void i2cEnd                (); //cmd = 31
+    void i2cScan               (); //cmd = 32
+    void i2cWrite              (); //cmd = 33
+    void i2cRead               (); //cmd = 34
     void reset                 ();  //cmd = 90
     void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
@@ -90,7 +96,7 @@ class Dino {
     byte fragmentIndex;
     int charIndex;
     boolean backslash;
-    void append(char c);
+    void append(byte c);
     void process();
 
     // Parsed message storage.

From b88f1dd4e95e511fd72faeb919852d5d697803e2 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 31 Dec 2017 01:22:43 -0400
Subject: [PATCH 122/296] =?UTF-8?q?Missing=20gitlink=20for=20I2C=20library?=
 =?UTF-8?q?=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/vendor/I2C-Master-Library | 1 +
 1 file changed, 1 insertion(+)
 create mode 160000 src/vendor/I2C-Master-Library

diff --git a/src/vendor/I2C-Master-Library b/src/vendor/I2C-Master-Library
new file mode 160000
index 00000000..32d3fd72
--- /dev/null
+++ b/src/vendor/I2C-Master-Library
@@ -0,0 +1 @@
+Subproject commit 32d3fd7253e6b39d7674b843435fb9e4160a1619

From 13e84f71f4c5c33cd5a313ad6edbf677b8218db4 Mon Sep 17 00:00:00 2001
From: vickash <vickash@atlantia.local>
Date: Fri, 5 Jan 2018 11:24:27 -0400
Subject: [PATCH 123/296] Ack bytes received by board more often. Minor sketch
 cleanup.

---
 examples/register/shift_ssd.rb |  2 +-
 src/dino_ethernet.ino          |  9 +----
 src/dino_serial.ino            |  9 +----
 src/dino_wifi.ino              |  9 +----
 src/lib/Dino.cpp               | 74 ++++++++++++++++++++--------------
 src/lib/Dino.h                 |  8 +---
 6 files changed, 52 insertions(+), 59 deletions(-)

diff --git a/examples/register/shift_ssd.rb b/examples/register/shift_ssd.rb
index 58e77e9e..6bfd0e82 100644
--- a/examples/register/shift_ssd.rb
+++ b/examples/register/shift_ssd.rb
@@ -13,7 +13,7 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 shift_register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                           pins: {data: 12, clock: 13, latch: 9}
+                                                           pins: {data: 11, clock: 13, latch: 9}
 
 ssd = Dino::Components::SSD.new   board: shift_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index e2abb425..d5de3e36 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -2,11 +2,6 @@
 #include <SPI.h>
 #include <Ethernet.h>
 
-// SoftwareSerial doesn't work on the Due yet.
-#if !defined(__SAM3X8E__)
-  #include <SoftwareSerial.h>
-#endif
-
 // Configure your MAC address, IP address, and HTTP port here.
 byte mac[] = { 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 };
 IPAddress ip(192,168,0,77);
@@ -62,7 +57,7 @@ void setup() {
 
 // Keep count of bytes as we receive them and send a dino message with how many.
 uint8_t rcvBytes  = 0;
-uint8_t rcvBuffer = 60;
+uint8_t rcvThreshold = 30;
 long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
@@ -86,7 +81,7 @@ void loop() {
         // Acknowledge when we've received as many bytes as the serial input buffer.
         lastRcv = micros();
         rcvBytes ++;
-        if (rcvBytes == rcvBuffer) acknowledge();
+        if (rcvBytes == rcvThreshold) acknowledge();
       }
 
       // Also acknowledge when the last byte received goes outside the receive window.
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 06046473..70cf652e 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -1,10 +1,5 @@
 #include "Dino.h"
 
-// SoftwareSerial doesn't work on the Due yet.
-#if !defined(__SAM3X8E__)
-  #include <SoftwareSerial.h>
-#endif
-
 Dino dino;
 
 // Use 'serial' to reference the right interface depending on the device.
@@ -36,7 +31,7 @@ void setup() {
 
 // Keep count of bytes as we receive them and send a dino message with how many.
 uint8_t rcvBytes  = 0;
-uint8_t rcvBuffer = 60;
+uint8_t rcvThreshold = 30;
 long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
@@ -55,7 +50,7 @@ void loop() {
     // Acknowledge when we've received as many bytes as the serial input buffer.
     lastRcv = micros();
     rcvBytes ++;
-    if (rcvBytes == rcvBuffer) acknowledge();
+    if (rcvBytes == rcvThreshold) acknowledge();
   }
 
   // Also acknowledge when the last byte received goes outside the receive window.
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index edb436c3..17807eb1 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -2,11 +2,6 @@
 #include <SPI.h>
 #include <WiFi.h>
 
-// SoftwareSerial doesn't work on the Due yet.
-#if !defined(__SAM3X8E__)
-  #include <SoftwareSerial.h>
-#endif
-
 // Configure your WiFi options here. MAC address and IP address are not configurable.
 int port = 3466;
 char ssid [] = "yourNetwork";
@@ -71,7 +66,7 @@ void setup() {
 
 // Keep count of bytes as we receive them and send a dino message with how many.
 uint8_t rcvBytes  = 0;
-uint8_t rcvBuffer = 60;
+uint8_t rcvThreshold = 30;
 long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
@@ -96,7 +91,7 @@ void loop() {
         // Acknowledge when we've received as many bytes as the serial input buffer.
         lastRcv = micros();
         rcvBytes ++;
-        if (rcvBytes == rcvBuffer) acknowledge();
+        if (rcvBytes == rcvThreshold) acknowledge();
       }
 
       // Also acknowledge when the last byte received goes outside the receive window.
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 33767c3d..f2c4ee22 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -73,9 +73,9 @@ void Dino::process() {
   response[0] = '\0';
 
   #ifdef debug
-   Serial.print("Command - ");          Serial.println(cmdStr);
-   Serial.print("Pin - ");              Serial.println(pinStr);
-   Serial.print("Value - ");            Serial.println(valStr);
+   Serial.print("Received - Command: "); Serial.print(cmdStr);
+   Serial.print(" Pin: ");               Serial.print(pinStr);
+   Serial.print(" Value: ");             Serial.print(valStr); Serial.print("\n")
   #endif
 
   // Call the command.
@@ -142,8 +142,7 @@ void Dino::process() {
   if (response[0] != '\0') writeResponse();
 
   #ifdef debug
-   Serial.print("Responded with - "); Serial.println(response);
-   Serial.println();
+   Serial.print("Responded with - "); Serial.print(response); Serial.print("\n\n");
   #endif
 }
 
@@ -211,89 +210,104 @@ long Dino::timeSince(long event) {
 }
 
 
-
 // API FUNCTIONS
-// CMD = 00 // Pin Mode
+
+// CMD = 00
+// Set a pin to output (0), or input (1).
 void Dino::setMode() {
   if (val == 0) {
     removeListener();
     pinMode(pin, OUTPUT);
-    #ifdef debug
-      Serial.print("Set pin "); Serial.print(pin); Serial.print(" to "); Serial.println("OUTPUT mode");
-    #endif
   }
   else {
     pinMode(pin, INPUT);
-    #ifdef debug
-      Serial.print("Set pin "); Serial.print(pin); Serial.print(" to "); Serial.println("INPTUT mode");
-    #endif
   }
+
+  #ifdef debug
+    Serial.print("Called Dino::setMode()\n");
+  #endif
 }
 
-// CMD = 01 // Digital Write
+// CMD = 01
+// Write a digital output pin. 0 for LOW, 1 or >0 for HIGH.
 void Dino::dWrite() {
   if (val == 0) {
     digitalWrite(pin, LOW);
-    #ifdef debug
-      Serial.print("Digital write "); Serial.print(LOW); Serial.print(" to pin "); Serial.println(pin);
-    #endif
   }
   else {
     digitalWrite(pin, HIGH);
-    #ifdef debug
-      Serial.print("Digital write "); Serial.print(HIGH); Serial.print(" to pin "); Serial.println(pin);
-    #endif
   }
+
+  #ifdef debug
+    Serial.print("Called Dino::dWrite()\n");
+  #endif
 }
 
-// CMD = 02 // Digital Read
+// CMD = 02
+// Read a digital input pin. 0 for LOW, 1 for HIGH.
 void Dino::dRead(int pin) {
   rval = digitalRead(pin);
   sprintf(response, "%d:%d", pin, rval);
+
+  #ifdef debug
+    Serial.print("Called Dino::dRead()\n");
+  #endif
 }
 
-// CMD = 03 // Analog (PWM) Write
+// CMD = 03
+// Write an analog output pin. 0 for LOW, up to 255 for HIGH @ 8-bit resolution.
 void Dino::aWrite() {
   analogWrite(pin,val);
+
   #ifdef debug
-    Serial.print("Analog write "); Serial.print(val); Serial.print(" to pin "); Serial.println(pin);
+    Serial.print("Called Dino::aWrite()\n");
   #endif
 }
 
-// CMD = 04 // Analog Read
+// CMD = 04
+// Read an analog input pin. 0 for LOW, up to 1023 for HIGH @ 10-bit resolution.
 void Dino::aRead(int pin) {
   rval = analogRead(pin);
   sprintf(response, "%d:%d", pin, rval);
+
+  #ifdef debug
+    Serial.print("Called Dino::aRead()\n");
+  #endif
 }
 
 // CMD = 05
-// Listen for a digital signal on any pin.
+// Set a flag to periodically read a digital pin without further requests.
+// Runs around other requests in the main loop. Only sends value when changed.
 void Dino::addDigitalListener() {
   removeListener();
   digitalListeners[pin] = true;
   digitalListenerValues[pin] = 2;
+
   #ifdef debug
-    Serial.print("Added digital listener on pin "); Serial.println(pin);
+    Serial.print("Called Dino::addDigitalListener()\n");
   #endif
 }
 
 // CMD = 06
-// Listen for an analog signal on analog pins only.
+// Set a flag to periodically read an analog pin without further requests.
+// Runs around other requests in the main loop. Sends value on every read.
 void Dino::addAnalogListener() {
   removeListener();
   analogListeners[pin] = true;
+
   #ifdef debug
-    Serial.print("Added analog listener on pin "); Serial.println(pin);
+    Serial.print("Called Dino::addAnalogListener()\n");
   #endif
 }
 
 // CMD = 07
-// Remove analog and digital listeners from any pin.
+// Remove analog and digital listen flags on the pin.
 void Dino::removeListener() {
   analogListeners[pin] = false;
   digitalListeners[pin] = false;
+
   #ifdef debug
-    Serial.print("Removed listeners on pin "); Serial.println(pin);
+    Serial.print("Called Dino::removeListener()\n");
   #endif
 }
 
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index fb53adc2..96b549ab 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -84,13 +84,7 @@ class Dino {
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
     void setHeartRate          ();  //cmd = 98
-
-    // Serial flow control variables.
-    uint8_t rcvBytes = 0;
-    uint8_t rcvBuffer = 60;
-    long    lastRcv = micros();
-    long    rcvWindow  = 1000000;
-
+    
     // Parser state storage and utility functions.
     char *messageFragments[4];
     byte fragmentIndex;

From 3ebd05101622bbbf0d1ed1836b4a0abb0fb1ce0c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 5 Jan 2018 19:42:51 -0400
Subject: [PATCH 124/296] Split into many cpp files. Toggle features with 1
 #define.

---
 lib/dino/board.rb                             |  10 +-
 lib/dino/components/register/shift_in.rb      |   6 +-
 lib/dino/components/register/shift_out.rb     |   2 +-
 lib/dino/components/register/spi_in.rb        |   6 +-
 lib/dino/components/register/spi_out.rb       |   2 +-
 lib/dino_cli/generator.rb                     |  17 +-
 spec/lib/components/register/shift_in_spec.rb |   6 +-
 .../lib/components/register/shift_out_spec.rb |   4 +-
 src/lib/Dino.cpp                              | 767 +++---------------
 src/lib/Dino.h                                | 172 ++--
 src/lib/DinoBugWorkaround.cpp                 |  24 +
 src/lib/DinoCoreIO.cpp                        | 136 ++++
 src/lib/DinoDHT.cpp                           |  41 +
 src/lib/DinoI2C.cpp                           | 112 +++
 src/lib/DinoIROut.cpp                         |  16 +
 src/lib/DinoIncludes.cpp                      |  34 +
 src/lib/DinoOneWire.cpp                       |  62 ++
 src/lib/DinoSPI.cpp                           | 153 ++++
 src/lib/DinoSerial.cpp                        |   5 -
 src/lib/DinoSerial.h                          |   5 -
 src/lib/DinoServo.cpp                         |  73 ++
 src/lib/DinoShift.cpp                         | 133 +++
 src/lib/DinoTone.cpp                          |  18 +
 23 files changed, 1043 insertions(+), 761 deletions(-)
 create mode 100644 src/lib/DinoBugWorkaround.cpp
 create mode 100644 src/lib/DinoCoreIO.cpp
 create mode 100644 src/lib/DinoDHT.cpp
 create mode 100644 src/lib/DinoI2C.cpp
 create mode 100644 src/lib/DinoIROut.cpp
 create mode 100644 src/lib/DinoIncludes.cpp
 create mode 100644 src/lib/DinoOneWire.cpp
 create mode 100644 src/lib/DinoSPI.cpp
 create mode 100644 src/lib/DinoServo.cpp
 create mode 100644 src/lib/DinoShift.cpp
 create mode 100644 src/lib/DinoTone.cpp

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 8098dec4..3dce145a 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -69,6 +69,7 @@ def set_pullup(pin, pullup)
     end
 
     PIN_COMMANDS = {
+      # set_pin_mode:  '0'
       digital_write:   '1',
       digital_read:    '2',
       analog_write:    '3',
@@ -78,10 +79,15 @@ def set_pullup(pin, pullup)
       stop_listener:   '7',
       servo_toggle:    '8',
       servo_write:     '9',
+      # LCD            '10'
+      # Unused         '11'
+      # SoftSerial     '12'
       dht_read:        '13',
+      # HCSR04         '14'
       ds18b20_read:    '15',
-      tone:            '20',
-      no_tone:         '21'
+      # IR send:       '16'
+      tone:            '17',
+      no_tone:         '18'
     }
 
     PIN_COMMANDS.each_key do |command|
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index c6c65779..5e1aace0 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -35,18 +35,18 @@ def bubble_callbacks
         def read
           # Pack the extra parameters we need to send in the aux message then send.
           aux = [data.pin, clock.pin, @preclock_high].pack('C*')
-          board.write Dino::Message.encode(command: 23, pin: latch.pin, value: @bytes, aux_message: aux)
+          board.write Dino::Message.encode(command: 22, pin: latch.pin, value: @bytes, aux_message: aux)
         end
 
         def listen
           # Pack the extra parameters we need to send in the aux message then send.
           aux = [data.pin, clock.pin, @preclock_high].pack('C*')
-          board.write Dino::Message.encode(command: 26, pin: latch.pin, value: @bytes, aux_message: aux)
+          board.write Dino::Message.encode(command: 23, pin: latch.pin, value: @bytes, aux_message: aux)
         end
 
         def stop
           # Just need to send the latch pin to stop listening.
-          board.write Dino::Message.encode(command: 28, pin: latch.pin)
+          board.write Dino::Message.encode(command: 24, pin: latch.pin)
         end
       end
     end
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index b2e53efa..c8e2d005 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -24,7 +24,7 @@ def write(*bytes)
 
           # Prepend parameters we need to send in the aux message then pack and send.
           aux = [data.pin, clock.pin, 0].concat(aux).pack('C*')
-          board.write Dino::Message.encode(command: 22, pin: latch.pin, value: length, aux_message: aux)
+          board.write Dino::Message.encode(command: 21, pin: latch.pin, value: length, aux_message: aux)
         end
       end
     end
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 4f7cb5de..87d11099 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -28,19 +28,19 @@ def read
           # Pack the extra parameters we need to send in the aux message then send.
           start_address = 0
           aux = "#{[start_address, @spi_mode].pack('C*')}#{[@frequency].pack('V')}"
-          board.write Dino::Message.encode(command: 25, pin: pin, value: @bytes, aux_message: aux)
+          board.write Dino::Message.encode(command: 27, pin: pin, value: @bytes, aux_message: aux)
         end
 
         def listen
           # Pack the extra parameters we need to send in the aux message then send.
           start_address = 0
           aux = "#{[start_address, @spi_mode].pack('C*')}#{[@frequency].pack('V')}"
-          board.write Dino::Message.encode(command: 27, pin: pin, value: @bytes, aux_message: aux)
+          board.write Dino::Message.encode(command: 28, pin: pin, value: @bytes, aux_message: aux)
         end
 
         def stop
           # Just need to send the select pin to stop listening.
-          board.write Dino::Message.encode(command: 28, pin: pin)
+          board.write Dino::Message.encode(command: 29, pin: pin)
         end
       end
     end
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index 2b5310d2..96645e9f 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -30,7 +30,7 @@ def write(*bytes)
           length = aux.count
           aux = "#{[@spi_mode].pack('C')}#{[@frequency].pack('V')}#{aux.pack('C*')}"
 
-          board.write Dino::Message.encode(command: 24, pin: pin, value: length, aux_message: aux)
+          board.write Dino::Message.encode(command: 26, pin: pin, value: length, aux_message: aux)
         end
       end
     end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index eb8f3b2c..87bd7e78 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -3,10 +3,23 @@ class DinoCLI::Generator
   LIB_FILENAMES =  [
                     "lib/Dino.h",
                     "lib/Dino.cpp",
+                    "lib/DinoCoreIO.cpp",
+                    "lib/DinoIncludes.cpp",
                     "lib/DinoLCD.cpp",
                     "lib/DinoLCD.h",
                     "lib/DinoSerial.cpp",
                     "lib/DinoSerial.h",
+                    "lib/DinoServo.cpp",
+                    "lib/DinoDHT.cpp",
+                    "lib/DinoOneWire.cpp",
+                    "lib/DinoIROut.cpp",
+                    "lib/DinoTone.cpp",
+                    "lib/DinoShift.cpp",
+                    "lib/DinoSPI.cpp",
+                    "lib/DinoI2C.cpp",
+
+                    # See explanation at top of src/lib/DinoBugWorkaround.cpp
+                    "lib/DinoBugWorkaround.cpp",
 
                     "vendor/DHT/DHT.cpp",
                     "vendor/DHT/DHT.h",
@@ -65,10 +78,10 @@ def modify
       @sketch.gsub! "int port = 3466", "int port = #{options[:port]}"
     end
     if options[:debug]
-      @libs[0].gsub! "// #define debug true", "#define debug true"
+      @libs[0].gsub! "// #define debug",    "#define debug"
     end
     unless serial?
-      @libs[0].gsub! "#define TXRX_SPI false", "#define TXRX_SPI true"
+      @libs[0].gsub! "// #define TXRX_SPI", "#define TXRX_SPI"
     end
   end
 
diff --git a/spec/lib/components/register/shift_in_spec.rb b/spec/lib/components/register/shift_in_spec.rb
index 192c0b4d..ac6c3aa1 100644
--- a/spec/lib/components/register/shift_in_spec.rb
+++ b/spec/lib/components/register/shift_in_spec.rb
@@ -40,19 +40,19 @@ module Register
           before(:each) { subject }
 
           it 'should send message for single byte in the request format the board expects' do
-            expect(board).to receive(:write).with "23.8.1.#{[11,12,0].pack('C*')}\n"
+            expect(board).to receive(:write).with "22.8.1.#{[11,12,0].pack('C*')}\n"
             subject.read
           end
 
           it 'should request the correct number of bytes to be read' do
             subject = ShiftIn.new(options.merge(bytes: 2))
-            expect(board).to receive(:write).with "23.8.2.#{[11,12,0].pack('C*')}\n"
+            expect(board).to receive(:write).with "22.8.2.#{[11,12,0].pack('C*')}\n"
             subject.read
           end
 
           it 'should request clock pin to go high before reading if set' do
             subject = ShiftIn.new(options.merge(preclock_high: 1))
-            expect(board).to receive(:write).with "23.8.1.#{[11,12,1].pack('C*')}\n"
+            expect(board).to receive(:write).with "22.8.1.#{[11,12,1].pack('C*')}\n"
             subject.read
           end
         end
diff --git a/spec/lib/components/register/shift_out_spec.rb b/spec/lib/components/register/shift_out_spec.rb
index bb7b5e37..a5104f65 100644
--- a/spec/lib/components/register/shift_out_spec.rb
+++ b/spec/lib/components/register/shift_out_spec.rb
@@ -23,13 +23,13 @@ module Register
           before(:each) { subject }
 
           it 'should send message for single byte in the request format the board expects' do
-            expect(board).to receive(:write).with "22.8.1.#{[11,12,0,255].pack('C*')}\n"
+            expect(board).to receive(:write).with "21.8.1.#{[11,12,0,255].pack('C*')}\n"
 
             subject.write(255)
           end
 
           it 'should send message for array of bytes in the request format the board expects' do
-            expect(board).to receive(:write).with "22.8.2.#{[11,12,0,255,0].pack('C*')}\n"
+            expect(board).to receive(:write).with "21.8.2.#{[11,12,0,255,0].pack('C*')}\n"
 
             subject.write([255,0])
           end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index f2c4ee22..9bbb92ef 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -1,24 +1,9 @@
 /*
   Library for dino ruby gem.
 */
-
-#include "Arduino.h"
 #include "Dino.h"
-#if defined(__SAM3X8E__)
-  #include <avr/dtostrf.h>
-#endif
-
-DinoLCD dinoLCD;
-DHT dht;
-IRsend irsend;
-
-// SoftwareSerial doesn't work on the Due yet.
-#if !defined(__SAM3X8E__)
-  DinoSerial dinoSerial;
-#endif
 
 Dino::Dino(){
-  newline[0] = '\n'; newline[1] = '\0';
   messageFragments[0] = cmdStr;
   messageFragments[1] = pinStr;
   messageFragments[2] = valStr;
@@ -67,9 +52,9 @@ void Dino::append(byte c) {
 }
 
 void Dino::process() {
-  cmd = atoi(cmdStr);
-  pin = atoi(pinStr);
-  val = atoi(valStr);
+  cmd = atoi((char *)cmdStr);
+  pin = atoi((char *)pinStr);
+  val = atoi((char *)valStr);
   response[0] = '\0';
 
   #ifdef debug
@@ -80,6 +65,10 @@ void Dino::process() {
 
   // Call the command.
   switch(cmd) {
+    // See explanation at top of DinoBugWorkaround.cpp
+    case 999999: bugWorkaround   ();  break;
+
+    // Implemented in this file.
     case 0:  setMode             ();    break;
     case 1:  dWrite              ();    break;
     case 2:  dRead               (pin); break;
@@ -88,53 +77,77 @@ void Dino::process() {
     case 5:  addDigitalListener  ();    break;
     case 6:  addAnalogListener   ();    break;
     case 7:  removeListener      ();    break;
+
+    // Implemented in DinoServo.cpp
+    #ifdef DINO_SERVO
     case 8:  servoToggle         ();    break;
     case 9:  servoWrite          ();    break;
+    #endif
+
+    // Implemented in DinoLCD.cpp
+    #ifdef DINO_LCD
     case 10: handleLCD           ();    break;
+    #endif
+
+    // Implemented in DinoSerial.cpp
+    #ifdef DINO_SERIAL
     case 12: handleSerial        ();    break;
-    case 13: handleDHT           ();    break;
+    #endif
+
+    // Implemented in DinoDHT.cpp
+    #ifdef DINO_DHT
+    case 13: dhtRead             ();    break;
+    #endif
+
+    // Implemented in DinoOneWire.cpp
+    #ifdef DINO_ONE_WIRE
     case 15: ds18Read            ();    break;
+    #endif
+
+    // Implemented in DinoIROut.cpp
+    #ifdef DINO_IR_OUT
     case 16: irSend              ();    break;
-    case 20: tone                ();    break;
-    case 21: noTone              ();    break;
-
-    // Request format for shift register functions.
-    // pin        = latch pin (int)
-    // val        = length (int)
-    // auxMsg[0]  = data pin (byte)
-    // auxMsg[1]  = clock pin (byte)
-    // auxMsg[2]  = send clock high before reading (byte) (0/1) (read func only)
-    // auxMsg[3]+ = data (bytes) (write func only)
-    case 22: shiftWrite (pin, val, auxMsg[0], auxMsg[1], &auxMsg[3]);  break;
-    case 23: shiftRead  (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);   break;
-    // Request format for single direction SPI functions.
-    // pin         = slave select pin (int)
-    // val         = length (int)
-    // auxMsg[0]   = SPI mode (byte)
-    // auxMsg[1-4] = clock frequency (uint32_t as 4 bytes)
-    // auxMsg[5]+  = data (bytes) (write func only)
-    case 24: writeSPI   (pin, val, auxMsg[0], (uint32_t)auxMsg[1], &auxMsg[5]); break;
-    case 25: readSPI    (pin, val, auxMsg[0], (uint32_t)auxMsg[1]            ); break;
-    // These add listeners for both shift in and SPI registers.
-    // They mirror the read function interfaces of the respective devices.
-    case 26: addShiftListener(pin, val, auxMsg[0], auxMsg[1], auxMsg[2]); break;
-    case 27: addSPIListener  (pin, val, auxMsg[0], (uint32_t)auxMsg[1]);  break;
-    // This removes either type of listener and frees its space in the cache.
-    // The only input it needs is the select/latch pin.
-    case 28: removeRegisterListener();
-
-    // I2C functions.
-    case 30: i2cBegin            ();  break;
-    case 31: i2cEnd              ();  break;
-    case 32: i2cScan             ();  break;
-    case 33: i2cWrite            ();  break;
-    case 34: i2cRead             ();  break;
+    #endif
 
+    // Implemented in DinoTone.cpp
+    #ifdef DINO_TONE
+    case 17: tone                ();    break;
+    case 18: noTone              ();    break;
+    #endif
+
+    // Implemented in DinoShift.cpp
+    #ifdef DINO_SHIFT
+    case 21: shiftWrite          (pin, val, auxMsg[0], auxMsg[1], &auxMsg[3]); break;
+    case 22: shiftRead           (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);  break;
+    case 23: addShiftListener    (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);  break;
+    case 24: removeShiftListener ();                                           break;
+    #endif
+
+    // Implemented in DinoSPI.cpp
+    #ifdef DINO_SPI
+    case 26: spiWrite         (pin, val, auxMsg[0], (uint32_t)auxMsg[1], &auxMsg[5]); break;
+    case 27: spiRead          (pin, val, auxMsg[0], (uint32_t)auxMsg[1]            ); break;
+    case 28: addSpiListener   (pin, val, auxMsg[0], (uint32_t)auxMsg[1]);             break;
+    case 29: removeSpiListener();                                                     break;
+    #endif
+
+    // Implemented in DinoI2C.cpp
+    #ifdef DINO_I2C
+    case 31: i2cBegin            ();  break;
+    case 32: i2cEnd              ();  break;
+    case 33: i2cScan             ();  break;
+    case 34: i2cWrite            ();  break;
+    case 35: i2cRead             ();  break;
+    #endif
+
+    // Implemented in this file.
     case 90: reset               ();  break;
     case 95: setAnalogDivider    ();  break;
     case 96: setAnalogResolution ();  break;
     case 97: setAnalogDivider    ();  break;
     case 98: setHeartRate        ();  break;
+
+    // Should send a "feature not implemented" message as default.
     default:                          break;
   }
 
@@ -147,623 +160,67 @@ void Dino::process() {
 }
 
 
-// WRITE CALLBACK
+// Let the sketch pass a function that it wants us to use to write output.
+// Store it as a callback and call that when we need to write.
 void Dino::setupWrite(void (*writeCallback)(char *str)) {
   _writeCallback = writeCallback;
 }
+
+
+// Write the response variable using the callback function from the sketch.
+// Always terminate with a newline.
 void Dino::writeResponse() {
   _writeCallback(response);
-  _writeCallback(newline);
+  _writeCallback("\n");
 }
 
-// LISTNENERS
-void Dino::updateListeners() {
-  if (timeSince(lastUpdate) > heartRate || timeSince(lastUpdate) < 0) {
-    lastUpdate = micros();
-    loopCount++;
-    updateDigitalListeners();
-    if (loopCount % registerDivider == 0) updateRegisterListeners();
-    if (loopCount % analogDivider   == 0) updateAnalogListeners();
-  }
-}
-void Dino::updateDigitalListeners() {
-  for (int i = 0; i < PIN_COUNT; i++) {
-    if (digitalListeners[i]) {
-      dRead(i);
-      if (rval != digitalListenerValues[i]) {
-        digitalListenerValues[i] = rval;
-        writeResponse();
-      }
-    }
-  }
-}
-void Dino::updateRegisterListeners() {
-  for (int i = 0; i < SPI_LISTENER_COUNT; i++) {
-    if (spiListeners[i].enabled) {
-      readSPI(spiListeners[i].selectPin,
-              spiListeners[i].len,
-              spiListeners[i].spiMode,
-              spiListeners[i].clockRate);
-    }
-  }
-  for (int i = 0; i < SHIFT_LISTENER_COUNT; i++) {
-    if (shiftListeners[i].enabled) {
-      shiftRead(shiftListeners[i].latchPin,
-                shiftListeners[i].len,
-                shiftListeners[i].dataPin,
-                shiftListeners[i].clockPin,
-                shiftListeners[i].clockHighFirst);
-    }
-  }
-}
-void Dino::updateAnalogListeners() {
-  for (int i = 0; i < PIN_COUNT; i++) {
-    if (analogListeners[i]) {
-      aRead(i);
-      writeResponse();
-    }
-  }
-}
+
+// Convenience wrapper to keep track of time since last read for listeners.
 long Dino::timeSince(long event) {
  long time = micros() - event;
  return time;
 }
 
 
-// API FUNCTIONS
-
-// CMD = 00
-// Set a pin to output (0), or input (1).
-void Dino::setMode() {
-  if (val == 0) {
-    removeListener();
-    pinMode(pin, OUTPUT);
-  }
-  else {
-    pinMode(pin, INPUT);
-  }
-
-  #ifdef debug
-    Serial.print("Called Dino::setMode()\n");
-  #endif
-}
-
-// CMD = 01
-// Write a digital output pin. 0 for LOW, 1 or >0 for HIGH.
-void Dino::dWrite() {
-  if (val == 0) {
-    digitalWrite(pin, LOW);
-  }
-  else {
-    digitalWrite(pin, HIGH);
-  }
-
-  #ifdef debug
-    Serial.print("Called Dino::dWrite()\n");
-  #endif
-}
-
-// CMD = 02
-// Read a digital input pin. 0 for LOW, 1 for HIGH.
-void Dino::dRead(int pin) {
-  rval = digitalRead(pin);
-  sprintf(response, "%d:%d", pin, rval);
-
-  #ifdef debug
-    Serial.print("Called Dino::dRead()\n");
-  #endif
-}
-
-// CMD = 03
-// Write an analog output pin. 0 for LOW, up to 255 for HIGH @ 8-bit resolution.
-void Dino::aWrite() {
-  analogWrite(pin,val);
-
-  #ifdef debug
-    Serial.print("Called Dino::aWrite()\n");
-  #endif
-}
-
-// CMD = 04
-// Read an analog input pin. 0 for LOW, up to 1023 for HIGH @ 10-bit resolution.
-void Dino::aRead(int pin) {
-  rval = analogRead(pin);
-  sprintf(response, "%d:%d", pin, rval);
-
-  #ifdef debug
-    Serial.print("Called Dino::aRead()\n");
-  #endif
-}
-
-// CMD = 05
-// Set a flag to periodically read a digital pin without further requests.
-// Runs around other requests in the main loop. Only sends value when changed.
-void Dino::addDigitalListener() {
-  removeListener();
-  digitalListeners[pin] = true;
-  digitalListenerValues[pin] = 2;
-
-  #ifdef debug
-    Serial.print("Called Dino::addDigitalListener()\n");
-  #endif
-}
-
-// CMD = 06
-// Set a flag to periodically read an analog pin without further requests.
-// Runs around other requests in the main loop. Sends value on every read.
-void Dino::addAnalogListener() {
-  removeListener();
-  analogListeners[pin] = true;
-
-  #ifdef debug
-    Serial.print("Called Dino::addAnalogListener()\n");
-  #endif
-}
-
-// CMD = 07
-// Remove analog and digital listen flags on the pin.
-void Dino::removeListener() {
-  analogListeners[pin] = false;
-  digitalListeners[pin] = false;
-
-  #ifdef debug
-    Serial.print("Called Dino::removeListener()\n");
-  #endif
-}
+// Every heartRate microseconds, read the digital listeners and send values if changed.
+// Analog listeners use a divider to run at a fraction of that frequency.
+// Register listeners (Shift, I2C and SPI) all share a second divider value.
+// Analog and register listeners always send values even if not changed.
+// See Dino::reset for default timings.
+void Dino::updateListeners() {
+  if (timeSince(lastUpdate) > heartRate || timeSince(lastUpdate) < 0) {
+    // Digital Listeners
+    lastUpdate = micros();
+    loopCount++;
+    updateDigitalListeners();
 
-// CMD = 08
-// Attach the servo object to pin or detach it.
-void Dino::servoToggle() {
-  if (val == 0) {
-    #ifdef debug
-      Serial.print("Detaching servo"); Serial.print(" on pin "); Serial.println(pin);
+    // Register Listeners
+    #ifdef DINO_SHIFT
+      if (loopCount % registerDivider == 0) updateShiftListeners();
     #endif
-    servos[pin - SERVO_OFFSET].detach();
-  }
-  else {
-    #ifdef debug
-      Serial.print("Attaching servo"); Serial.print(" on pin "); Serial.println(pin);
+    #ifdef DINO_SPI
+      if (loopCount % registerDivider == 0) updateSpiListeners();
     #endif
-    servos[pin - SERVO_OFFSET].attach(pin);
-  }
-}
-
-// CMD = 09
-// Write a value to the servo object.
-void Dino::servoWrite() {
-  #ifdef debug
-    Serial.print("Servo write "); Serial.print(val); Serial.print(" to pin "); Serial.println(pin);
-  #endif
-  servos[pin - SERVO_OFFSET].write(val);
-}
-
-// CMD = 10
-// Write a value to the servo object.
-void Dino::handleLCD() {
-  #ifdef debug
-    Serial.print("DinoLCD command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
-  #endif
-  dinoLCD.process(val, auxMsg);
-}
-
-
-// CMD = 12
-// Control the SoftwareSerial.
-void Dino::handleSerial() {
-  #ifdef debug
-    Serial.print("DinoSerial command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
-  #endif
-  // SoftwareSerial doesn't work on the Due yet.
-  #if !defined(__SAM3X8E__)
-  dinoSerial.process(val, auxMsg);
-  #endif
-}
-
-
-// CMD = 13
-// Read a DHT sensor
-void Dino::handleDHT() {
-  #ifdef debug
-    Serial.print("DinoDHT command: "); Serial.print(val); Serial.print(" with data: "); Serial.println(auxMsg);
-  #endif
-  // dtostrf doesn't work on the Due yet.
-  #if !defined(__SAM3X8E__)
-  if (pin != dht.pin) dht.setup(pin);
-  float reading;
-  char readingBuff[10];
-  char prefix;
-  if (val == 0) {
-    reading = dht.getTemperature();
-    prefix = 'T';
-  } else {
-    reading = dht.getHumidity();
-    prefix = 'H';
-  }
-  if (! isnan(reading)) {
-    dtostrf(reading, 6, 4, readingBuff);
-    sprintf(response, "%d:%c%s", pin, prefix, readingBuff);
-  }
-  #endif
-}
-
-
-// CMD = 15
-void Dino::ds18Read() {
-  OneWire ds(pin);
-
-  byte data[12];
-  byte addr[8];
-
-  if ( !ds.search(addr)) {
-    ds.reset_search();
-    return;
-   }
 
-  if ( OneWire::crc8( addr, 7) != addr[7]) {
-    // Serial.println("CRC is not valid!");
-    return;
-  }
-
-  if ( addr[0] != 0x10 && addr[0] != 0x28) {
-    // Serial.print("Device is not recognized");
-    return;
-  }
-
-  ds.reset();
-  ds.select(addr);
-  ds.write(0x44,1); // start conversion, with parasite power on at the end
-
-  byte present = ds.reset();
-  ds.select(addr);
-  ds.write(0xBE); // Read Scratchpad
-
-  for (int i = 0; i < 9; i++) { // we need 9 bytes
-    data[i] = ds.read();
-  }
-
-  ds.reset_search();
-
-  byte MSB = data[1];
-  byte LSB = data[0];
-
-  float tempRead = ((MSB << 8) | LSB); //using two's compliment
-  float reading = tempRead / 16;
-  char readingBuff[10];
-
-  if (! isnan(reading)) {
-    dtostrf(reading, 6, 4, readingBuff);
-    sprintf(response, "%d:%s", pin, readingBuff);
-  }
-}
-
-
-// CMD = 16
-void Dino::irSend(){
-  irsend.sendRaw((uint16_t)&auxMsg[1], (uint8_t)auxMsg[0], val);
-}
-
-// CMD = 20
-void Dino::tone() {
-  //unsigned int duration = atoi(auxMsg);
-  //::tone(pin, val, duration);
-}
-
-// CMD = 21
-void Dino::noTone() {
-  //::noTone(pin);
-}
-
-
-// CMD = 22
-// Write to a shift register.
-void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte *data) {
-  // Set latch pin low to begin serial write.
-  digitalWrite(latchPin, LOW);
-
-  // Write one byte at a time.
-  for (uint8_t i = 0;  i < len;  i++) {
-    shiftOut(dataPin, clockPin, LSBFIRST, data[i]);
-  }
-
-  // Set latch pin high so register writes to parallel output.
-  digitalWrite(latchPin, HIGH);
-}
-
-
-// CMD = 23
-// Read from a shift register.
-void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
-  // Send clock pin high if using a register that clocks on rising edges.
-  // If not, the MSB will not be read on those registers (always 1),
-  // and all other bits will be shifted by 1 towards the LSB.
-  if (clockHighFirst > 0) digitalWrite(clockPin, HIGH);
-
-  // Latch high to read parallel state, then low again to stop.
-  digitalWrite(latchPin, HIGH);
-  digitalWrite(latchPin, LOW);
-
-  // Send data as if coming from the latch pin so it's easy to identify.
-  // Start with just pin number and : for now.
-  sprintf(response, "%d:", latchPin);
-  _writeCallback(response);
-
-  for (int i = 1;  i <= len;  i++) {
-    // Read a single byte from the register.
-    byte reading = shiftIn(dataPin, clockPin, LSBFIRST);
-
-    // If we're on the last byte, append \n. If not, append a comma, then write.
-    if (i == len) {
-      sprintf(response, "%d\n", reading);
-    } else {
-      sprintf(response, "%d,", reading);
-    }
-    _writeCallback(response);
-  }
-
-  // Leave latch pin high and clear response so main loop doesn't send anything.
-  digitalWrite(latchPin, HIGH);
-  response[0] = '\0';
-}
-
-
-// CMD = 24
-// Write to an SPI device.
-void Dino::writeSPI(int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data) {
-  // Start the SPI library if it isn't already being used by the main sketch.
-  SPI.begin();
-
-  // Set the mode we want.
-  switch(spiMode) {
-    case 0:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE0)); break;
-    case 1:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE1)); break;
-    case 2:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE2)); break;
-    case 3:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE3)); break;
-  }
-
-  // Select the device.
-  digitalWrite(selectPin, LOW);
-
-  // Write one byte at a time.
-  for (uint8_t i = 0;  i < len;  i++) {
-    SPI.transfer(data[i]);
-  }
-
-  // End the SPI transaction, and then library if not in use by main sketch.
-  SPI.endTransaction();
-
-  // TXRX_SPI is set to false in Dino.h.
-  // CLI generator will auto set to true for any sketch other than serial.
-  #if !(TXRX_SPI)
-    SPI.end();
-  #endif
-
-  // Leave select high.
-  digitalWrite(selectPin, HIGH);
-}
-
-
-// CMD = 25
-// Read from an SPI device.
-void Dino::readSPI(int selectPin, int len, byte spiMode, uint32_t clockRate) {
-  // Start the SPI library if it isn't already being used by the main sketch.
-  SPI.begin();
-
-  // Set the mode we want.
-  switch(spiMode) {
-    case 0:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE0)); break;
-    case 1:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE1)); break;
-    case 2:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE2)); break;
-    case 3:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE3)); break;
-  }
-
-  // Select the device.
-  digitalWrite(selectPin, LOW);
-
-  // Send data as if coming from the slave select pin so it's easy to identify.
-  // Start with just pin number and : for now.
-  sprintf(response, "%d:", selectPin);
-  _writeCallback(response);
-
-  for (int i = 1;  i <= len;  i++) {
-    // Read a single byte from the register.
-    byte reading = SPI.transfer(0x00);
-
-    // If we're on the last byte, append \n. If not, append a comma, then write.
-    if (i == len) {
-      sprintf(response, "%d\n", reading);
-    } else {
-      sprintf(response, "%d,", reading);
-    }
-    _writeCallback(response);
-  }
-
-  // End the SPI transaction, and then library if not in use by main sketch.
-  SPI.endTransaction();
-
-  // TXRX_SPI is set to false in Dino.h.
-  // CLI generator will auto set to true for any sketch other than serial.
-  #if !(TXRX_SPI)
-    SPI.end();
-  #endif
-
-  // Leave select high and clear response so main loop doesn't send anything.
-  digitalWrite(selectPin, HIGH);
-  response[0] = '\0';
-}
-
-// CMD = 26
-// Start listening to a register using the Arduino shiftIn function.
-// Overwrite the first disabled listener in the struct array.
-void Dino::addShiftListener(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
-  for (int i = 0;  i < SHIFT_LISTENER_COUNT;  i++) {
-    if (shiftListeners[i].enabled == false) {
-      shiftListeners[i] = {
-        latchPin,
-        len,
-        dataPin,
-        clockPin,
-        clockHighFirst,
-        true
-      };
-      return;
-    } else {
-    // Should send some kind of error if all are in use.
-    }
-  }
-}
-
-// CMD = 26
-// Start listening to an SPI register.
-// Overwrite the first disabled listener in the struct array.
-void Dino::addSPIListener(int selectPin, int len, byte spiMode, uint32_t clockRate) {
-  for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
-    if (spiListeners[i].enabled == false) {
-      spiListeners[i] = {
-        selectPin,
-        len,
-        spiMode,
-        clockRate,
-        true
-      };
-      return;
-    } else {
-    // Should send some kind of error if all are in use.
-    }
-  }
-}
-
-
-// CMD = 27
-// Send a number for a select/latch pin to remove either type of register listener.
-void Dino::removeRegisterListener() {
-  for (int i = 0;  i < SHIFT_LISTENER_COUNT;  i++) {
-    if (shiftListeners[i].latchPin == pin) {
-      shiftListeners[i].enabled = false;
-    }
-  }
-  for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
-    if (spiListeners[i].selectPin == pin) {
-      spiListeners[i].enabled = false;
-    }
-  }
-}
-
-
-// CMD = 30
-// Start I2C communication.
-void Dino::i2cBegin() {
-  I2c.begin();
-  // I2c.setSpeed(??);
-  // I2c.pullup(??);
-  // I2c.timeOut(??);
-  sprintf(response, "%d:I2C:1", SDA);
-}
-
-
-// CMD = 31
-// Stop I2C communication.
-void Dino::i2cEnd() {
-  I2c.end();
-  sprintf(response, "%d:I2C:0", SDA);
-}
-
-
-// CMD = 32
-// Scan for I2C devices.
-//
-// WARNING: This takes a long time! Try to record the device addresses
-// results and put them into your code.
-//
-// Returns each found address as if a separate reading from SDA pin, eg. "18:104".
-// Returns 128 as if read from SDA pin for search complete, eg. "18:128".
-// Returns 255 as if read from SDA pin for I2C errors, eg. "18:255".
-//
-void Dino::i2cScan() {
-  uint8_t address = 0;
-  while (address < 128) {
-    // Scan for the next device.
-    address = I2c.scanOne(address);
-
-    // Write whatever we get including address space end or errors.
-    sprintf(response, "%d:%d", SDA, address);
-    writeResponse();
-    address++;
-  }
-  // Clear the response to make sure it doesn't get sent twice.
-  response[0] = '\0';
-}
-
-
-// CMD = 33
-// Write to an I2C device.
-// All parameters need to be sent in binary in the auxMsg.
-//
-// auxMsg[0]  = device address
-// auxMsg[1]  = register start address
-// auxMsg[2]  = number of bytes
-// auxMsg[3]+ = data
-//
-// Limited to 255 bytes. Validate on remote end.
-//
-void Dino::i2cWrite() {
-  I2c.write(auxMsg[0], auxMsg[1], &auxMsg[3], auxMsg[2]);
-}
-
-
-// CMD = 34
-// Read from an I2C device.
-// All params need to be sent in binary in the auxMsg.
-//
-// auxMsg[0]  = device address
-// auxMsg[1]  = register start address
-// auxMsg[2]  = number of bytes
-//
-// Streams data back in comma delimited ASCII decimal for now,
-// matching shiftRead and readSPI. Limited to 32 bytes by I2C library buffer.
-// Validate on remote end.
-//
-void Dino::i2cRead() {
-  // Force length to be min 1, max 32.
-  if (auxMsg[2] > 32) auxMsg[2] = 32;
-  if (auxMsg[2] == 0) auxMsg[2] =  1;
-
-  // Read all the bytes into the library buffer.
-  I2c.read(auxMsg[0], auxMsg[1], auxMsg[2]);
-
-  // Send back the SDA pin, the device address, and start register address first.
-  sprintf(response, "%d:%d:%d:", SDA, auxMsg[0], auxMsg[1]);
-  _writeCallback(response);
-
-  // Send back the data bytes.
-  uint8_t currentByte = 0;
-  while(I2c.available()){
-    currentByte++;
-    // Append comma, but \n for last byte, then write.
-    if (currentByte == auxMsg[2]){
-      sprintf(response, "%d\n", I2c.receive());
-    } else {
-      sprintf(response, "%d,", I2c.receive());
-    }
-    _writeCallback(response);
+    // Analog Listeners
+    if (loopCount % analogDivider   == 0) updateAnalogListeners();
   }
-
-  // Clear the response to make sure it doesn't get sent twice.
-  response[0] = '\0';
 }
 
 
 // CMD = 90
 void Dino::reset() {
-  // Clear the analog and digital pin listeners.
-  for (int i = 0; i < PIN_COUNT; i++) digitalListeners[i] = false;
-  for (int i = 0; i < PIN_COUNT; i++) digitalListenerValues[i] = 2;
-  for (int i = 0; i < PIN_COUNT; i++) analogListeners[i] = false;
-
-  // Disable the register listeners.
-  for (int i = 0; i < SHIFT_LISTENER_COUNT; i++) shiftListeners[i].enabled = false;
-  for (int i = 0; i < SPI_LISTENER_COUNT;   i++) spiListeners[i].enabled = false;
+  // Disable all the types of listeners.
+  clearDigitalListeners();
+  clearAnalogListeners();
+  #ifdef DINO_SPI
+    clearSpiListeners();
+  #endif
+  #ifdef DINO_SHIFT
+    clearShiftListeners();
+  #endif
 
-  heartRate = 4000; // Update digital listeners every ~4ms.
+  heartRate = 4000;    // Update digital listeners every ~4ms.
   analogDivider   = 4; // Update analog listeners every ~16ms.
   registerDivider = 2; // Update register listeners every ~8ms.
   fragmentIndex = 0;
@@ -778,12 +235,17 @@ void Dino::reset() {
   #endif
 }
 
+
 // CMD = 95
 // Set the register read divider. Powers of 2 up to 128 are valid.
 void Dino::setRegisterDivider() {
   registerDivider = val;
+  #ifdef debug
+    Serial.print("Called Dino::setRegisterDivider()\n");
+  #endif
 }
 
+
 // CMD = 96
 // Set the analog read and write resolution.
 void Dino::setAnalogResolution() {
@@ -791,16 +253,27 @@ void Dino::setAnalogResolution() {
     analogReadResolution(val);
     analogWriteResolution(val);
   #endif
+  #ifdef debug
+    Serial.print("Called Dino::setAnalogResolution()\n");
+  #endif
 }
 
+
 // CMD = 97
 // Set the analog divider. Powers of 2 up to 128 are valid.
 void Dino::setAnalogDivider() {
   analogDivider = val;
+  #ifdef debug
+    Serial.print("Called Dino::setAnalogDivider()\n");
+  #endif
 }
 
+
 // CMD = 98
 // Set the heart rate in milliseconds. Store it in microseconds.
 void Dino::setHeartRate() {
-  heartRate = atoi(auxMsg);
+  heartRate = atoi((char *)auxMsg);
+  #ifdef debug
+    Serial.print("Called Dino::setHeartRate()\n");
+  #endif
 }
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 96b549ab..36ffb57d 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -1,45 +1,38 @@
 /*
   Library for dino ruby gem.
 */
-
 #ifndef Dino_h
 #define Dino_h
-#define TXRX_SPI false
-
-#include "Arduino.h"
-#include <Servo.h>
-#include <SPI.h>
-#include "DinoLCD.h"
-#include "DHT.h"
-#include "OneWire.h"
-#include "IRremote.h"
-#include "I2C.h"
-
-// SoftwareSerial doesn't work on the Due yet.
-#if !defined(__SAM3X8E__)
-  #include "DinoSerial.h"
-#endif
+#include <Arduino.h>
 
+// If using Wi-Fi or Ethernet shield, uncomment this to let the SPI library know.
+// #define TXRX_SPI
 
-// Allocate listener storage based on what board we're running.
+// Uncomment this line to enable debugging mode.
+// #define debug
+
+// Comment these out to exclude default features.
+// Arduino Due cannot use: SERIAL, IR, TONE, I2C
+#define DINO_SERVO
+#define DINO_LCD
+#define DINO_SERIAL
+#define DINO_DHT
+#define DINO_ONE_WIRE
+#define DINO_IR_OUT
+// #define DINO_TONE
+#define DINO_SHIFT
+#define DINO_SPI
+#define DINO_I2C
+
+// Figure out how many pins our hardware has.
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
 #  define PIN_COUNT 70
-#  define SERVO_OFFSET 22
 #elif defined(__SAM3X8E__)
 #  define PIN_COUNT 66
-#  define SERVO_OFFSET 22
 #else
 #  define PIN_COUNT 22
-#  define SERVO_OFFSET 2
 #endif
 
-// Allocate listener storage for serial registers.
-#define SPI_LISTENER_COUNT 4
-#define SHIFT_LISTENER_COUNT 4
-
-// Uncomment this line to enable debugging mode.
-// #define debug true
-
 class Dino {
   public:
     Dino();
@@ -48,45 +41,78 @@ class Dino {
     void updateListeners();
 
   private:
-    // API-accessible functions.
+    // Functions with a cmd value can be called through the remote API.
+
+    // See explanation at top of DinoBugWorkaround.cpp
+    void bugWorkaround();
+
+    // Core IO Functions
     void setMode               ();         //cmd = 0
     void dWrite                ();         //cmd = 1
     void dRead                 (int pin);  //cmd = 2
     void aWrite                ();         //cmd = 3
     void aRead                 (int pin);  //cmd = 4
+
+    // Core IO Listeners
     void addDigitalListener    ();         //cmd = 5
     void addAnalogListener     ();         //cmd = 6
     void removeListener        ();         //cmd = 7
+    void updateDigitalListeners();
+    void updateAnalogListeners ();
+    void clearDigitalListeners ();
+    void clearAnalogListeners  ();
+    // Listener State and Storage
+    // Array indices mapped to board pins. true = listener enabled on that pin.
+    // Cache last value for digital listeners and only send on change.
+    boolean analogListeners[PIN_COUNT];
+    boolean digitalListeners[PIN_COUNT];
+    byte digitalListenerValues[PIN_COUNT];
+
+    // Included Libraries
     void servoToggle           ();         //cmd = 8
     void servoWrite            ();         //cmd = 9
     void handleLCD             ();         //cmd = 10
-    void shiftWrite            ();         //cmd = 11
     void handleSerial          ();         //cmd = 12
-    void handleDHT             ();         //cmd = 13
+    void dhtRead               ();         //cmd = 13
     void ds18Read              ();         //cmd = 15
     void irSend                ();         //cmd = 16
-    void tone                  ();         //cmd = 20
-    void noTone                ();         //cmd = 21
-    void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte *data);          //cmd = 22
-    void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 23
-    void writeSPI              (int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data);     //cmd = 24
-    void readSPI               (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 25
-    void addShiftListener      (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 26
-    void addSPIListener        (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 27
-    void removeRegisterListener();                                                                         //cmd = 28
-    void i2cBegin              (); //cmd = 30
-    void i2cEnd                (); //cmd = 31
-    void i2cScan               (); //cmd = 32
-    void i2cWrite              (); //cmd = 33
-    void i2cRead               (); //cmd = 34
+    void tone                  ();         //cmd = 17
+    void noTone                ();         //cmd = 18
+
+    // Shift Registers
+    void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte *data);          //cmd = 21
+    void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 22
+    void addShiftListener      (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 23
+    void removeShiftListener   ();                                                                         //cmd = 24
+    void updateShiftListeners    ();
+    void clearShiftListeners     ();
+
+    // SPI
+    void spiBegin              (byte spiMode, uint32_t clockRate);
+    void spiEnd                ();
+    void spiWrite              (int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data);     //cmd = 26
+    void spiRead               (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 27
+    void addSpiListener        (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 28
+    void removeSpiListener     ();                                                                         //cmd = 29
+    void updateSpiListeners    ();
+    void clearSpiListeners     ();
+
+    // I2C
+    void i2cBegin              (); //cmd = 31
+    void i2cEnd                (); //cmd = 32
+    void i2cScan               (); //cmd = 33
+    void i2cWrite              (); //cmd = 34
+    void i2cRead               (); //cmd = 35
+
+    // API access to timings, resolutions and reset.
     void reset                 ();  //cmd = 90
     void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
     void setHeartRate          ();  //cmd = 98
-    
+
     // Parser state storage and utility functions.
-    char *messageFragments[4];
+    byte *messageFragments[4];
     byte fragmentIndex;
     int charIndex;
     boolean backslash;
@@ -94,23 +120,28 @@ class Dino {
     void process();
 
     // Parsed message storage.
-    char cmdStr[5]; int cmd;
-    char pinStr[5]; int pin;
-    char valStr[5]; int val;
-    byte auxMsg[512];
+    byte cmdStr[5]; int cmd;
+    byte pinStr[5]; int pin;
+    byte valStr[5]; int val;
+    // Scale aux message allocation based on enabled features.
+    #if defined(DINO_IR_OUT)
+      byte auxMsg[528];
+    #elif defined(DINO_SHIFT) || defined(DINO_SPI) || defined (DINO_I2C)
+      byte auxMsg[272];
+    #elif defined (DINO_LCD)
+      byte auxMsg[144];
+    #else
+      byte auxMsg[48];
+    #endif
 
     // Value and response storage.
     int rval;
     char response[16];
-    char newline[2];
 
     // Use a write callback from the main sketch to respond.
     void (*_writeCallback)(char *str);
     void writeResponse();
 
-    // Arduino native library variables.
-    Servo servos[12];
-
     // Internal timing variables and utility functions.
     long heartRate;
     long lastUpdate;
@@ -118,38 +149,5 @@ class Dino {
     unsigned int analogDivider;
     unsigned int registerDivider;
     long timeSince (long event);
-
-    // Listeners correspond to raw pin number by array index, and store boolean. false == disabled.
-    boolean analogListeners[PIN_COUNT];
-    boolean digitalListeners[PIN_COUNT];
-
-    // Create listeners for SPI registers.
-    struct spiListener{
-      byte     selectPin;
-      byte     len;
-      byte     spiMode;
-      uint32_t clockRate;
-      boolean  enabled;
-    };
-    spiListener spiListeners[SPI_LISTENER_COUNT];
-
-    // Create listeners for ShiftIn registers.
-    struct shiftListener{
-      byte     latchPin;
-      byte     len;
-      byte     dataPin;
-      byte     clockPin;
-      byte     clockHighFirst;
-      boolean  enabled;
-    };
-    shiftListener shiftListeners[SHIFT_LISTENER_COUNT];
-
-    // Keep track of the last read values for digital listeners. Only write responses when changed.
-    byte digitalListenerValues[PIN_COUNT];
-
-    // Listener update functions.
-    void updateDigitalListeners  ();
-    void updateRegisterListeners ();
-    void updateAnalogListeners   ();
 };
 #endif
diff --git a/src/lib/DinoBugWorkaround.cpp b/src/lib/DinoBugWorkaround.cpp
new file mode 100644
index 00000000..cd7dc5e3
--- /dev/null
+++ b/src/lib/DinoBugWorkaround.cpp
@@ -0,0 +1,24 @@
+//
+// After refactoring there's a strange gcc bug referencing the first
+// instance of sprintf in Dino.cpp, only when compiling for the 328p/Uno/Nano/Mini.
+//
+// It only occurs when trying to exlude all the new .cpp files by commenting
+// out the #define lines at the top of Dino.h. At least one needed to be left in
+// to avoid the error.
+//
+// Narrowed it down to the following:
+// Must declare a function in a separate .cpp file.
+// That function must mutate some instance variable in Dino.
+// That function must be one of the switch options in the Dino::process case statement.
+//
+// This file is a stub to meet those requirements.
+// Leaving this in until sprintf usage is replaced or bug is fixed.
+//
+// Similar issues:
+// https://github.com/arduino/Arduino/issues/3972
+// https://github.com/CongducPham/LowCostLoRaGw/issues/28
+//
+#include "Dino.h"
+void Dino::bugWorkaround() {
+  rval = 0;
+}
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
new file mode 100644
index 00000000..a18ecf94
--- /dev/null
+++ b/src/lib/DinoCoreIO.cpp
@@ -0,0 +1,136 @@
+#include "Dino.h"
+
+// CMD = 00
+// Set a pin to output (0), or input (1).
+void Dino::setMode() {
+  if (val == 0) {
+    removeListener();
+    pinMode(pin, OUTPUT);
+  }
+  else {
+    pinMode(pin, INPUT);
+  }
+
+  #ifdef debug
+    Serial.print("Called Dino::setMode()\n");
+  #endif
+}
+
+// CMD = 01
+// Write a digital output pin. 0 for LOW, 1 or >0 for HIGH.
+void Dino::dWrite() {
+  if (val == 0) {
+    digitalWrite(pin, LOW);
+  }
+  else {
+    digitalWrite(pin, HIGH);
+  }
+
+  #ifdef debug
+    Serial.print("Called Dino::dWrite()\n");
+  #endif
+}
+
+// CMD = 02
+// Read a digital input pin. 0 for LOW, 1 for HIGH.
+void Dino::dRead(int pin) {
+  rval = digitalRead(pin);
+  sprintf(response, "%d:%d", pin, rval);
+
+  #ifdef debug
+    Serial.print("Called Dino::dRead()\n");
+  #endif
+}
+
+// CMD = 03
+// Write an analog output pin. 0 for LOW, up to 255 for HIGH @ 8-bit resolution.
+void Dino::aWrite() {
+  analogWrite(pin,val);
+
+  #ifdef debug
+    Serial.print("Called Dino::aWrite()\n");
+  #endif
+}
+
+// CMD = 04
+// Read an analog input pin. 0 for LOW, up to 1023 for HIGH @ 10-bit resolution.
+void Dino::aRead(int pin) {
+  rval = analogRead(pin);
+  sprintf(response, "%d:%d", pin, rval);
+
+  #ifdef debug
+    Serial.print("Called Dino::aRead()\n");
+  #endif
+}
+
+// CMD = 05
+// Set a flag to periodically read a digital pin without further requests.
+// Runs around other requests in the main loop. Only sends value when changed.
+void Dino::addDigitalListener() {
+  removeListener();
+  digitalListeners[pin] = true;
+  digitalListenerValues[pin] = 2;
+
+  #ifdef debug
+    Serial.print("Called Dino::addDigitalListener()\n");
+  #endif
+}
+
+// CMD = 06
+// Set a flag to periodically read an analog pin without further requests.
+// Runs around other requests in the main loop. Sends value on every read.
+void Dino::addAnalogListener() {
+  removeListener();
+  analogListeners[pin] = true;
+
+  #ifdef debug
+    Serial.print("Called Dino::addAnalogListener()\n");
+  #endif
+}
+
+// CMD = 07
+// Remove analog and digital listen flags on the pin.
+void Dino::removeListener() {
+  analogListeners[pin] = false;
+  digitalListeners[pin] = false;
+
+  #ifdef debug
+    Serial.print("Called Dino::removeListener()\n");
+  #endif
+}
+
+// Gets called by Dino::updateListeners to run listeners in the main loop.
+// Reads each digital listen pin and sends value if changed from last read.
+void Dino::updateDigitalListeners() {
+  for (int i = 0; i < PIN_COUNT; i++) {
+    if (digitalListeners[i]) {
+      dRead(i);
+      if (rval != digitalListenerValues[i]) {
+        digitalListenerValues[i] = rval;
+        writeResponse();
+      }
+    }
+  }
+}
+
+// Gets called by Dino::updateListeners to run listeners in the main loop.
+// Reads each analog listen pin and sends value always. Does not store last value.
+void Dino::updateAnalogListeners() {
+  for (int i = 0; i < PIN_COUNT; i++) {
+    if (analogListeners[i]) {
+      aRead(i);
+      writeResponse();
+    }
+  }
+}
+
+// Gets called by Dino::reset to clear all digital listeners.
+void Dino::clearDigitalListeners(){
+  for (int i = 0; i < PIN_COUNT; i++) digitalListeners[i] = false;
+  for (int i = 0; i < PIN_COUNT; i++) digitalListenerValues[i] = 2;
+}
+
+// Gets called by Dino::reset to clear all analog listeners.
+void Dino::clearAnalogListeners(){
+  for (int i = 0; i < PIN_COUNT; i++) analogListeners[i] = false;
+}
diff --git a/src/lib/DinoDHT.cpp b/src/lib/DinoDHT.cpp
new file mode 100644
index 00000000..43b56090
--- /dev/null
+++ b/src/lib/DinoDHT.cpp
@@ -0,0 +1,41 @@
+//
+// This file adds to the Dino class only if DINO_DHT is defined in Dino.h.
+// Should not be included in sketch for Arduino Due yet.
+//
+#include "Dino.h"
+#ifdef DINO_DHT
+
+// Include dtostrf for ARM.
+#if defined(__SAM3X8E__)
+  #include <avr/dtostrf.h>
+#endif
+
+// Include the DHT library and create an instance.
+#include "DHT.h"
+DHT dht;
+
+// CMD = 13
+// Read a DHT sensor
+void Dino::dhtRead() {
+  if (pin != dht.pin) dht.setup(pin);
+  float reading;
+  char readingBuff[10];
+  char prefix;
+  if (val == 0) {
+    reading = dht.getTemperature();
+    prefix = 'T';
+  } else {
+    reading = dht.getHumidity();
+    prefix = 'H';
+  }
+  if (! isnan(reading)) {
+    dtostrf(reading, 6, 4, readingBuff);
+    sprintf(response, "%d:%c%s", pin, prefix, readingBuff);
+  }
+
+  #ifdef debug
+    Serial.print("Called Dino::dhtRead()\n");
+  #endif
+}
+
+#endif
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
new file mode 100644
index 00000000..f808f000
--- /dev/null
+++ b/src/lib/DinoI2C.cpp
@@ -0,0 +1,112 @@
+//
+// This file adds to the Dino class only if DINO_I2C is defined in Dino.h.
+//
+#include "Dino.h"
+#ifdef DINO_I2C
+
+#include "I2C.h"
+
+
+// CMD = 31
+// Start I2C communication.
+void Dino::i2cBegin() {
+  I2c.begin();
+  // I2c.setSpeed(??);
+  // I2c.pullup(??);
+  // I2c.timeOut(??);
+  sprintf(response, "%d:I2C:1", SDA);
+}
+
+
+// CMD = 32
+// Stop I2C communication.
+void Dino::i2cEnd() {
+  I2c.end();
+  sprintf(response, "%d:I2C:0", SDA);
+}
+
+
+// CMD = 33
+// Scan for I2C devices.
+//
+// WARNING: This takes a long time! Try to record the device addresses
+// results and put them into your code.
+//
+// Returns each found address as if a separate reading from SDA pin, eg. "18:104".
+// Returns 128 as if read from SDA pin for search complete, eg. "18:128".
+// Returns 255 as if read from SDA pin for I2C errors, eg. "18:255".
+//
+void Dino::i2cScan() {
+  uint8_t address = 0;
+  while (address < 128) {
+    // Scan for the next device.
+    address = I2c.scanOne(address);
+
+    // Write whatever we get including address space end or errors.
+    sprintf(response, "%d:%d", SDA, address);
+    writeResponse();
+    address++;
+  }
+  // Clear the response to make sure it doesn't get sent twice.
+  response[0] = '\0';
+}
+
+
+// CMD = 34
+// Write to an I2C device.
+// All parameters need to be sent in binary in the auxMsg.
+//
+// auxMsg[0]  = device address
+// auxMsg[1]  = register start address
+// auxMsg[2]  = number of bytes
+// auxMsg[3]+ = data
+//
+// Limited to 255 bytes. Validate on remote end.
+//
+void Dino::i2cWrite() {
+  I2c.write(auxMsg[0], auxMsg[1], &auxMsg[3], auxMsg[2]);
+}
+
+
+// CMD = 35
+// Read from an I2C device.
+// All params need to be sent in binary in the auxMsg.
+//
+// auxMsg[0]  = device address
+// auxMsg[1]  = register start address
+// auxMsg[2]  = number of bytes
+//
+// Streams data back in comma delimited ASCII decimal for now,
+// matching shiftRead and readSPI. Limited to 32 bytes by I2C library buffer.
+// Validate on remote end.
+//
+void Dino::i2cRead() {
+  // Force length to be min 1, max 32.
+  if (auxMsg[2] > 32) auxMsg[2] = 32;
+  if (auxMsg[2] == 0) auxMsg[2] =  1;
+
+  // Read all the bytes into the library buffer.
+  I2c.read(auxMsg[0], auxMsg[1], auxMsg[2]);
+
+  // Send back the SDA pin, the device address, and start register address first.
+  sprintf(response, "%d:%d:%d:", SDA, auxMsg[0], auxMsg[1]);
+  _writeCallback(response);
+
+  // Send back the data bytes.
+  uint8_t currentByte = 0;
+  while(I2c.available()){
+    currentByte++;
+    // Append comma, but \n for last byte, then write.
+    if (currentByte == auxMsg[2]){
+      sprintf(response, "%d\n", I2c.receive());
+    } else {
+      sprintf(response, "%d,", I2c.receive());
+    }
+    _writeCallback(response);
+  }
+
+  // Clear the response to make sure it doesn't get sent twice.
+  response[0] = '\0';
+}
+
+#endif
diff --git a/src/lib/DinoIROut.cpp b/src/lib/DinoIROut.cpp
new file mode 100644
index 00000000..9ba67395
--- /dev/null
+++ b/src/lib/DinoIROut.cpp
@@ -0,0 +1,16 @@
+//
+// This file adds to the Dino class only if DINO_IR_OUT is defined in Dino.h.
+//
+#include "Dino.h"
+#ifdef DINO_IR_OUT
+
+#include "IRremote.h"
+IRsend infraredOut;
+
+// CMD = 16
+// Send an infrared signal.
+void Dino::irSend(){
+  infraredOut.sendRaw((uint16_t)&auxMsg[1], (uint8_t)auxMsg[0], val);
+}
+
+#endif
diff --git a/src/lib/DinoIncludes.cpp b/src/lib/DinoIncludes.cpp
new file mode 100644
index 00000000..bf36c614
--- /dev/null
+++ b/src/lib/DinoIncludes.cpp
@@ -0,0 +1,34 @@
+//
+// This file should implement features where Dino simply passes input to classes
+// that require a static instance to be defined in Dino's scope.
+//
+#include "Dino.h"
+
+#ifdef DINO_LCD
+  #include "DinoLCD.h"
+  DinoLCD dinoLCD;
+
+  // CMD = 10
+  // Pass aux message to the LCD library for processing.
+  void Dino::handleLCD() {
+    dinoLCD.process(val, (char *)auxMsg);
+    #ifdef debug
+      Serial.print("Called Dino::handleLCD()\n");
+    #endif
+  }
+#endif
+
+
+#ifdef DINO_SERIAL
+  #include "DinoSerial.h"
+  DinoSerial dinoSerial;
+
+  // CMD = 12
+  // Pass aux message to the software serial library for processing.
+  void Dino::handleSerial() {
+    dinoSerial.process(val, auxMsg);
+    #ifdef debug
+      Serial.print("Called Dino::handleSerial()\n");
+    #endif
+  }
+#endif
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
new file mode 100644
index 00000000..fa1e6155
--- /dev/null
+++ b/src/lib/DinoOneWire.cpp
@@ -0,0 +1,62 @@
+//
+// This file adds to the Dino class only if DINO_ONE_WIRE is defined in Dino.h.
+//
+#include "Dino.h"
+#ifdef DINO_ONE_WIRE
+
+// Include dtostrf for ARM.
+#if defined(__SAM3X8E__)
+  #include <avr/dtostrf.h>
+#endif
+#include "OneWire.h"
+
+// CMD = 15
+void Dino::ds18Read() {
+  OneWire ds(pin);
+
+  byte data[12];
+  byte addr[8];
+
+  if ( !ds.search(addr)) {
+    ds.reset_search();
+    return;
+   }
+
+  if ( OneWire::crc8( addr, 7) != addr[7]) {
+    // Serial.println("CRC is not valid!");
+    return;
+  }
+
+  if ( addr[0] != 0x10 && addr[0] != 0x28) {
+    // Serial.print("Device is not recognized");
+    return;
+  }
+
+  ds.reset();
+  ds.select(addr);
+  ds.write(0x44,1); // start conversion, with parasite power on at the end
+
+  byte present = ds.reset();
+  ds.select(addr);
+  ds.write(0xBE); // Read Scratchpad
+
+  for (int i = 0; i < 9; i++) { // we need 9 bytes
+    data[i] = ds.read();
+  }
+
+  ds.reset_search();
+
+  byte MSB = data[1];
+  byte LSB = data[0];
+
+  float tempRead = ((MSB << 8) | LSB); //using two's compliment
+  float reading = tempRead / 16;
+  char readingBuff[10];
+
+  if (! isnan(reading)) {
+    dtostrf(reading, 6, 4, readingBuff);
+    sprintf(response, "%d:%s", pin, readingBuff);
+  }
+}
+
+#endif
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
new file mode 100644
index 00000000..35e05c5d
--- /dev/null
+++ b/src/lib/DinoSPI.cpp
@@ -0,0 +1,153 @@
+//
+// This file adds to the Dino class only if DINO_SPI is defined in Dino.h.
+//
+#include "Dino.h"
+#ifdef DINO_SPI
+
+#include <SPI.h>
+
+// Define listeners for SPI registers.
+#define SPI_LISTENER_COUNT 4
+struct SpiListener{
+  byte     selectPin;
+  byte     len;
+  byte     spiMode;
+  uint32_t clockRate;
+  boolean  enabled;
+};
+SpiListener spiListeners[SPI_LISTENER_COUNT];
+
+
+// Convenience wrapper for SPI.begin
+void Dino::spiBegin(byte spiMode, uint32_t clockRate){
+  SPI.begin();
+  // Should make LSB/MSB optional.
+  switch(spiMode) {
+    case 0:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE0)); break;
+    case 1:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE1)); break;
+    case 2:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE2)); break;
+    case 3:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE3)); break;
+  }
+}
+
+
+// Convenience wrapper for SPI.end
+void Dino::spiEnd(){
+  SPI.endTransaction();
+  // If the sketch is using SPI for TxRx (Wi-Fi/Ethernet) we don't want to end.
+  // CLI generator will define TXRX_SPI in Dino.h for those cases.
+  #ifndef TXRX_SPI
+    SPI.end();
+  #endif
+}
+
+
+//
+// Request format for single direction SPI API functions.
+// pin         = slave select pin (int)
+// val         = length (int)
+// auxMsg[0]   = SPI mode (byte)
+// auxMsg[1-4] = clock frequency (uint32_t as 4 bytes)
+// auxMsg[5]+  = data (bytes) (write func only)
+//
+// CMD = 26
+// Write to an SPI device.
+void Dino::spiWrite(int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data) {
+  spiBegin(spiMode, clockRate);
+
+  // Select the device.
+  digitalWrite(selectPin, LOW);
+
+  // Write one byte at a time.
+  for (uint8_t i = 0;  i < len;  i++) {
+    SPI.transfer(data[i]);
+  }
+  spiEnd();
+
+  // Leave select high.
+  digitalWrite(selectPin, HIGH);
+}
+
+
+// CMD = 27
+// Read from an SPI device.
+void Dino::spiRead(int selectPin, int len, byte spiMode, uint32_t clockRate) {
+  spiBegin(spiMode, clockRate);
+
+  // Select the device.
+  digitalWrite(selectPin, LOW);
+
+  // Send data as if coming from the slave select pin so it's easy to identify.
+  // Start with just pin number and : for now.
+  sprintf(response, "%d:", selectPin);
+  _writeCallback(response);
+
+  for (int i = 1;  i <= len;  i++) {
+    // Read a single byte from the register.
+    byte reading = SPI.transfer(0x00);
+
+    // If we're on the last byte, append \n. If not, append a comma, then write.
+    if (i == len) {
+      sprintf(response, "%d\n", reading);
+    } else {
+      sprintf(response, "%d,", reading);
+    }
+    _writeCallback(response);
+  }
+  spiEnd();
+
+  // Leave select high and clear response so main loop doesn't send anything.
+  digitalWrite(selectPin, HIGH);
+  response[0] = '\0';
+}
+
+// CMD = 28
+// Start listening to an SPI register.
+// Overwrite the first disabled listener in the struct array.
+void Dino::addSpiListener(int selectPin, int len, byte spiMode, uint32_t clockRate) {
+  for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
+    if (spiListeners[i].enabled == false) {
+      spiListeners[i] = {
+        selectPin,
+        len,
+        spiMode,
+        clockRate,
+        true
+      };
+      return;
+    } else {
+    // Should send some kind of error if all are in use.
+    }
+  }
+}
+
+// CMD = 29
+// Send a number for a select pin to remove an SPI register listener.
+void Dino::removeSpiListener(){
+  for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
+    if (spiListeners[i].selectPin == pin) {
+      spiListeners[i].enabled = false;
+    }
+  }
+}
+
+
+// Gets called by Dino::updateListeners to run listeners in the main loop.
+void Dino::updateSpiListeners(){
+  for (int i = 0; i < SPI_LISTENER_COUNT; i++) {
+    if (spiListeners[i].enabled) {
+      spiRead(spiListeners[i].selectPin,
+              spiListeners[i].len,
+              spiListeners[i].spiMode,
+              spiListeners[i].clockRate);
+    }
+  }
+}
+
+
+// Gets called by Dino::reset to clear all listeners.
+void Dino::clearSpiListeners(){
+  for (int i = 0; i < SPI_LISTENER_COUNT; i++) spiListeners[i].enabled = false;
+}
+
+#endif
diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
index 068344b7..8e1dfec4 100644
--- a/src/lib/DinoSerial.cpp
+++ b/src/lib/DinoSerial.cpp
@@ -1,6 +1,3 @@
-// SoftwareSerial doesn't work on the Due yet.
-#if !defined(__SAM3X8E__)
-
 #include "Arduino.h"
 #include "DinoSerial.h"
 
@@ -41,5 +38,3 @@ void DinoSerial::begin(char *aux) {
   int baud = atoi(aux);
   softSerial.begin(baud);
 }
-
-#endif
diff --git a/src/lib/DinoSerial.h b/src/lib/DinoSerial.h
index 5160bc72..a4427767 100644
--- a/src/lib/DinoSerial.h
+++ b/src/lib/DinoSerial.h
@@ -1,6 +1,3 @@
-// SoftwareSerial doesn't work on the Due yet.
-#if !defined(__SAM3X8E__)
-
 #ifndef DinoSerial_h
 #define DinoSerial_h
 
@@ -19,5 +16,3 @@ class DinoSerial {
 };
 
 #endif
-
-#endif
diff --git a/src/lib/DinoServo.cpp b/src/lib/DinoServo.cpp
new file mode 100644
index 00000000..e3735af4
--- /dev/null
+++ b/src/lib/DinoServo.cpp
@@ -0,0 +1,73 @@
+//
+// This file adds to the Dino class only if DINO_SERVO is defined in Dino.h.
+//
+#include "Dino.h"
+#ifdef DINO_SERVO
+
+#include <Servo.h>
+
+// Maximum 12 servos on most boards. Could be up to 48 on Arduino Mega.
+#define SERVO_COUNT 12
+
+// Create an array of wrapper structs that link pins to servo objects.
+struct ServoWrapper{
+  byte     pin;
+  boolean  active;
+  Servo    servo;
+};
+ServoWrapper servos[SERVO_COUNT];
+
+// CMD = 08
+// Attach a free servo object to the specified pin.
+void Dino::servoToggle() {
+  // Search by pin for in use servo object, detatch and set inactive.
+  if (val == 0) {
+    for (int i = 0;  i < SERVO_COUNT;  i++) {
+      if (servos[i].pin == pin) {
+        servos[i].servo.detach();
+        servos[i].active = false;
+      }
+    }
+  }
+  // Search by pin for in use servo object, attach and set active.
+  else {
+    boolean found = false;
+    for (int i = 0;  i < SERVO_COUNT;  i++) {
+      if (servos[i].pin == pin) {
+        found = true;
+        servos[i].servo.attach(pin);
+        servos[i].active = true;
+      }
+    }
+    // If it doesn't exist, use the first inactive object.
+    if (found == false) {
+      for (int i = 0;  i < SERVO_COUNT;  i++) {
+        if (servos[i].active == false) {
+          servos[i].servo.attach(pin);
+          servos[i].active = true;
+        }
+      }
+    }
+  }
+
+  #ifdef debug
+    Serial.print("Called Dino::servoToggle()\n");
+  #endif
+}
+
+// CMD = 09
+// Write a value to the servo object.
+void Dino::servoWrite() {
+  // Find servo by pin and write value to it.
+  for (int i = 0;  i < SERVO_COUNT;  i++) {
+    if (servos[i].pin == pin) {
+      servos[i].servo.write(val);
+    }
+  }
+
+  #ifdef debug
+    Serial.print("Called Dino::servoWrite()\n");
+  #endif
+}
+
+#endif
diff --git a/src/lib/DinoShift.cpp b/src/lib/DinoShift.cpp
new file mode 100644
index 00000000..f5788dae
--- /dev/null
+++ b/src/lib/DinoShift.cpp
@@ -0,0 +1,133 @@
+//
+// This file adds to the Dino class only if DINO_SHIFT is defined in Dino.h.
+//
+#include "Dino.h"
+#ifdef DINO_SHIFT
+
+// Define listeners for ShiftIn registers.
+#define SHIFT_LISTENER_COUNT 4
+struct shiftListener{
+  byte     latchPin;
+  byte     len;
+  byte     dataPin;
+  byte     clockPin;
+  byte     clockHighFirst;
+  boolean  enabled;
+};
+shiftListener shiftListeners[SHIFT_LISTENER_COUNT];
+
+
+//
+// Request format for shift register API functions.
+// pin        = latch pin (int)
+// val        = length (int)
+// auxMsg[0]  = data pin (byte)
+// auxMsg[1]  = clock pin (byte)
+// auxMsg[2]  = send clock high before reading (byte) (0/1) (read func only)
+// auxMsg[3]+ = data (bytes) (write func only)
+//
+// CMD = 21
+// Write to a shift register.
+void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte *data) {
+  // Set latch pin low to begin serial write.
+  digitalWrite(latchPin, LOW);
+
+  // Write one byte at a time.
+  for (uint8_t i = 0;  i < len;  i++) {
+    shiftOut(dataPin, clockPin, LSBFIRST, data[i]);
+  }
+
+  // Set latch pin high so register writes to parallel output.
+  digitalWrite(latchPin, HIGH);
+}
+
+
+// CMD = 22
+// Read from a shift register.
+void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
+  // Send clock pin high if using a register that clocks on rising edges.
+  // If not, the MSB will not be read on those registers (always 1),
+  // and all other bits will be shifted by 1 towards the LSB.
+  if (clockHighFirst > 0) digitalWrite(clockPin, HIGH);
+
+  // Latch high to read parallel state, then low again to stop.
+  digitalWrite(latchPin, HIGH);
+  digitalWrite(latchPin, LOW);
+
+  // Send data as if coming from the latch pin so it's easy to identify.
+  // Start with just pin number and : for now.
+  sprintf(response, "%d:", latchPin);
+  _writeCallback(response);
+
+  for (int i = 1;  i <= len;  i++) {
+    // Read a single byte from the register.
+    byte reading = shiftIn(dataPin, clockPin, LSBFIRST);
+
+    // If we're on the last byte, append \n. If not, append a comma, then write.
+    if (i == len) {
+      sprintf(response, "%d\n", reading);
+    } else {
+      sprintf(response, "%d,", reading);
+    }
+    _writeCallback(response);
+  }
+
+  // Leave latch pin high and clear response so main loop doesn't send anything.
+  digitalWrite(latchPin, HIGH);
+  response[0] = '\0';
+}
+
+
+// CMD = 23
+// Start listening to a register using the Arduino shiftIn function.
+// Overwrite the first disabled listener in the struct array.
+void Dino::addShiftListener(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
+  for (int i = 0;  i < SHIFT_LISTENER_COUNT;  i++) {
+    if (shiftListeners[i].enabled == false) {
+      shiftListeners[i] = {
+        latchPin,
+        len,
+        dataPin,
+        clockPin,
+        clockHighFirst,
+        true
+      };
+      return;
+    } else {
+    // Should send some kind of error if all are in use.
+    }
+  }
+}
+
+
+// CMD = 24
+// Send a number for a latch pin to remove a shift register listener.
+void Dino::removeShiftListener() {
+  for (int i = 0;  i < SHIFT_LISTENER_COUNT;  i++) {
+    if (shiftListeners[i].latchPin == pin) {
+      shiftListeners[i].enabled = false;
+    }
+  }
+}
+
+
+// Gets called by Dino::updateListeners to run listeners in the main loop.
+void Dino::updateShiftListeners() {
+  for (int i = 0; i < SHIFT_LISTENER_COUNT; i++) {
+    if (shiftListeners[i].enabled) {
+      shiftRead(shiftListeners[i].latchPin,
+                shiftListeners[i].len,
+                shiftListeners[i].dataPin,
+                shiftListeners[i].clockPin,
+                shiftListeners[i].clockHighFirst);
+    }
+  }
+}
+
+
+// Gets called by Dino::reset to clear all listeners.
+void Dino::clearShiftListeners() {
+  for (int i = 0; i < SHIFT_LISTENER_COUNT; i++) shiftListeners[i].enabled = false;
+}
+
+#endif
diff --git a/src/lib/DinoTone.cpp b/src/lib/DinoTone.cpp
new file mode 100644
index 00000000..e15caf3f
--- /dev/null
+++ b/src/lib/DinoTone.cpp
@@ -0,0 +1,18 @@
+//
+// This file adds to the Dino class only if DINO_TONE is defined in Dino.h.
+//
+#include "Dino.h"
+#ifdef DINO_TONE
+
+// CMD = 20
+void Dino::tone() {
+  unsigned int duration = atoi((char*)auxMsg);
+  ::tone(pin, val, duration);
+}
+
+// CMD = 21
+void Dino::noTone() {
+  ::noTone(pin);
+}
+
+#endif

From 88d9deb71d5ef21cba8a98a596a25cdd8e287165 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 5 Jan 2018 19:44:17 -0400
Subject: [PATCH 125/296] Map serial properly on the ATtiny85.

---
 src/dino_serial.ino | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 70cf652e..9869158f 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -8,6 +8,8 @@ Dino dino;
   Serial_ &serial = SerialUSB;
 #elif defined(__AVR_ATmega32U4__)
   Serial_ &serial = Serial;
+#elif defined(__AVR_ATtiny85__)
+  TinyDebugSerial &serial = Serial;
 #else
   HardwareSerial &serial = Serial;
 #endif

From ab8ec6b1884deab6e61b1e276583f7005e4431f8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 5 Jan 2018 21:12:09 -0400
Subject: [PATCH 126/296] preclock_high only matters for shift, not SPI.

---
 lib/dino/components/register/input.rb    | 8 --------
 lib/dino/components/register/shift_in.rb | 9 +++++++++
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index 48dc4dac..58e22496 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -27,14 +27,6 @@ def after_initialize(options={})
           @reading_pins   = Array.new(@bytes*8) {|i| false}
           @listening_pins = Array.new(@bytes*8) {|i| false}
 
-          #
-          # Certain registers which use rising edges for clock signals produce
-          # errors with the native Arduino shiftIn function unless you set the clock
-          # pin high before reading. Setting this instance var to 1 will include
-          # that instruction on every call to read or listen.
-          #
-          @preclock_high = options[:preclock_high] ? 1 : 0
-
           enable_proxy
         end
 
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 5e1aace0..a9344a63 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -20,6 +20,15 @@ class ShiftIn
         #
         def after_initialize(options={})
           super(options) if defined?(super)
+
+          #
+          # Certain registers which use rising edges for clock signals produce
+          # errors with the native Arduino shiftIn function unless you set the clock
+          # pin high before reading. Setting this instance var to 1 will include
+          # that instruction on every call to read or listen.
+          #
+          @preclock_high = options[:preclock_high] ? 1 : 0
+
           bubble_callbacks
         end
 

From be48d68ca7a0565f1db9bb1901172c934619cb3c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 6 Jan 2018 17:24:29 -0400
Subject: [PATCH 127/296] More useful info and errors during connect/handshake

---
 lib/dino/tx_rx/base.rb        | 71 ++++++++++++++++++++---------------
 lib/dino/tx_rx/serial.rb      | 27 +++++++++++--
 spec/lib/tx_rx/serial_spec.rb |  8 ++--
 spec/lib/tx_rx/tcp_spec.rb    |  4 +-
 4 files changed, 69 insertions(+), 41 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index b38486d8..0ea2c49e 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -3,11 +3,16 @@
 
 module Dino
   module TxRx
-    class BoardNotFound < StandardError; end
+    class SerialConnectError < StandardError; end
+    class TCPConnectError    < StandardError; end
+    class HandshakeError     < StandardError; end
+    class RxFlushTimeout     < StandardError; end
 
     class Base
       include Observable
       BOARD_BUFFER = 60
+      HANDSHAKE_TRIES = 3
+      HANDSHAKE_TIMEOUT = 2
 
       def io
         @io ||= connect
@@ -30,29 +35,38 @@ def write(message)
       def handshake
         initialize_flow_control
         flush_read
-        10.times do |retries|
-          begin
-            Timeout.timeout(1) do
-              write Dino::Message.encode(command: 90)
-              loop do
-                line = gets
-                if line && line.match(/ACK:/)
-                  flush_read
-                  ignore_retry_bytes(retries)
-                  puts "Connected to board..."
-                  return line.split(/:/)[1]
-                end
+        HANDSHAKE_TRIES.times do |retries|
+          Timeout.timeout(HANDSHAKE_TIMEOUT) do
+            print "Sending handshake to: #{self.to_s}... "
+            write Dino::Message.encode(command: 90)
+            loop do
+              line = gets
+              if line && line.match(/\AACK:/)
+                flush_read
+                ignore_retry_bytes(retries)
+                puts "Acknowledged. Hardware ready...\n\n"
+                return line.split(":", 2)[1]
               end
             end
-          rescue Timeout::Error
-            puts "Could not find board. Retrying..."
           end
+        rescue Timeout::Error
+          print "No response, "
+          puts (retries + 1 < HANDSHAKE_TRIES ? "retrying..." : "exiting...")
+          next
         end
-        raise BoardNotFound
+        raise HandshakeError, "Connected to wrong device, or device not running dino"
       end
 
     private
 
+      def flush_read
+        Timeout.timeout(5) do
+          gets until gets == nil
+        end
+      rescue Timeout::Error
+        raise RxFlushTimeout "Cannot read from device, or device not running dino"
+      end
+
       def synced_write(message)
         message = message.split("")
         loop do
@@ -71,7 +85,9 @@ def synced_write(message)
         end
       end
 
-      def io_write(message); raise "#io_write should be defined in TxRx subclasses"; end
+      def connect(message); raise "#connect should be defined in TxRx subclasses"; end
+      def gets(message);    raise "#gets should be defined in TxRx subclasses";    end
+      def _write(message);  raise "#_write should be defined in TxRx subclasses";  end
 
       def _read
         line = gets
@@ -90,6 +106,13 @@ def process_line(line)
         end
       end
 
+      # Subtract bytes for failed handshakes from the total in transit bytes.
+      # The board likely reset, dropping these bytes, and causing the retries.
+      def ignore_retry_bytes(retries)
+        retry_bytes = Dino::Message.encode(command: 90).length * retries
+        remove_transit_bytes(retry_bytes)
+      end
+
       def initialize_flow_control
         @flow_control  ||= Mutex.new
         @write_mutex   ||= Mutex.new
@@ -107,20 +130,6 @@ def add_transit_bytes(value)
       def remove_transit_bytes(value)
         @flow_control.synchronize { @transit_bytes = @transit_bytes - value }
       end
-
-      # Subtract bytes for failed handshakes from the total in transit bytes.
-      # The board will never acknowledge these.
-      def ignore_retry_bytes(retries)
-        retry_bytes = Dino::Message.encode(command: 90).length * retries
-        remove_transit_bytes(retry_bytes)
-      end
-
-      def connect(message); raise "#connect should be defined in TxRx subclasses"; end
-      def gets(message); raise "#gets should be defined in TxRx subclasses"; end
-
-      def flush_read
-        gets until gets == nil
-      end
     end
   end
 end
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index f61a6363..6ddd4acb 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -10,12 +10,31 @@ def initialize(options={})
         @baud = options[:baud] || BAUD
       end
 
+      def to_s
+        "#{@device} @ #{@baud} baud"
+      end
+
     private
 
       def connect
-        # ::Serial calls the rubyserial gem here.
-        tty_devices.each { |device| return ::Serial.new(device, @baud) rescue nil }
-        raise BoardNotFound
+        tty_devices.each do |device|
+          @device = device
+          print "Trying serial device: #{self.to_s}... "
+          connection = ::Serial.new(@device, @baud)
+          puts "Connected"
+          return connection
+        rescue RubySerial::Exception => error
+          handle_error(error); next
+        end
+        raise SerialConnectError, "Could not connect to a serial device."
+      end
+
+      def handle_error(error)
+        if error.message == "EBUSY"
+          puts "Device Busy! (EBUSY)"
+        else
+          puts "RubySerial Error (#{error.message})"
+        end
       end
 
       def tty_devices
@@ -28,7 +47,7 @@ def on_windows?
         RUBY_PLATFORM.match /mswin|mingw/i
       end
 
-      def io_write(message)
+      def _write(message)
         io.write(message)
       end
 
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index bdb03cb0..ed772379 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -17,7 +17,7 @@ module Dino
 
           # Simulate 3 COM ports with COM2 connected.
           expect(subject).to receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
-          expect(::Serial).to receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise
+          expect(::Serial).to receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise(RubySerial::Exception)
           expect(::Serial).to receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = double)
           expect(::Serial).to_not receive(:new).with("COM3", TxRx::Serial::BAUD)
           expect(subject.io).to equal(mock_serial)
@@ -45,9 +45,9 @@ module Dino
         expect(subject.io).to equal(mock_serial)
       end
 
-      it 'should raise a BoardNotFound exception if there is no board connected' do
-        allow(::Serial).to receive(:new).and_raise
-        expect { subject.io }.to raise_exception Dino::TxRx::BoardNotFound
+      it 'should raise SerialConnectError if it cannot connect to a board' do
+        allow(::Serial).to receive(:new).and_raise(RubySerial::Exception)
+        expect { subject.io }.to raise_exception Dino::TxRx::SerialConnectError
       end
     end
 
diff --git a/spec/lib/tx_rx/tcp_spec.rb b/spec/lib/tx_rx/tcp_spec.rb
index 79be3998..c610bf3a 100644
--- a/spec/lib/tx_rx/tcp_spec.rb
+++ b/spec/lib/tx_rx/tcp_spec.rb
@@ -9,8 +9,8 @@ module Dino
     end
 
     describe "#connect" do
-      it 'should raise a BoardNotFound exception if it cannot connect to the server' do
-        expect { @instance.io }.to raise_exception Dino::TxRx::BoardNotFound
+      it 'should raise a TCPConnectError exception if it cannot connect to the server' do
+        expect { @instance.io }.to raise_exception Dino::TxRx::TCPConnectError
       end
 
       it 'should return the TCPSocket if connected' do

From baa98fade4bd70934cb38a613a84e7c584533361 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 6 Jan 2018 17:25:48 -0400
Subject: [PATCH 128/296] Aux msg always 40 bytes if targeting ATmega168

---
 src/lib/Dino.h | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 36ffb57d..5363ec03 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -84,8 +84,8 @@ class Dino {
     void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 22
     void addShiftListener      (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 23
     void removeShiftListener   ();                                                                         //cmd = 24
-    void updateShiftListeners    ();
-    void clearShiftListeners     ();
+    void updateShiftListeners  ();
+    void clearShiftListeners   ();
 
     // SPI
     void spiBegin              (byte spiMode, uint32_t clockRate);
@@ -123,15 +123,19 @@ class Dino {
     byte cmdStr[5]; int cmd;
     byte pinStr[5]; int pin;
     byte valStr[5]; int val;
-    // Scale aux message allocation based on enabled features.
-    #if defined(DINO_IR_OUT)
-      byte auxMsg[528];
-    #elif defined(DINO_SHIFT) || defined(DINO_SPI) || defined (DINO_I2C)
-      byte auxMsg[272];
-    #elif defined (DINO_LCD)
-      byte auxMsg[144];
+    // Scale aux message allocation based on enabled features and chip.
+    #if !defined (__AVR_ATmega168__)
+      #if defined(DINO_IR_OUT)
+        byte auxMsg[528];
+      #elif defined(DINO_SHIFT) || defined(DINO_SPI) || defined (DINO_I2C)
+        byte auxMsg[272];
+      #elif defined (DINO_LCD)
+        byte auxMsg[144];
+      #else
+        byte auxMsg[48];
+      #endif
     #else
-      byte auxMsg[48];
+      byte auxMsg[40];
     #endif
 
     // Value and response storage.

From d9bd9db04d704f1acd6c74c09bffaec181b64aa5 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 6 Jan 2018 17:36:04 -0400
Subject: [PATCH 129/296] =?UTF-8?q?Need=20to=20wrap=20Timeout=20in=20begin?=
 =?UTF-8?q?=20apparently=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 lib/dino/tx_rx/base.rb | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 0ea2c49e..4e5970a0 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -36,23 +36,25 @@ def handshake
         initialize_flow_control
         flush_read
         HANDSHAKE_TRIES.times do |retries|
-          Timeout.timeout(HANDSHAKE_TIMEOUT) do
-            print "Sending handshake to: #{self.to_s}... "
-            write Dino::Message.encode(command: 90)
-            loop do
-              line = gets
-              if line && line.match(/\AACK:/)
-                flush_read
-                ignore_retry_bytes(retries)
-                puts "Acknowledged. Hardware ready...\n\n"
-                return line.split(":", 2)[1]
+          begin
+            Timeout.timeout(HANDSHAKE_TIMEOUT) do
+              print "Sending handshake to: #{self.to_s}... "
+              write Dino::Message.encode(command: 90)
+              loop do
+                line = gets
+                if line && line.match(/\AACK:/)
+                  flush_read
+                  ignore_retry_bytes(retries)
+                  puts "Acknowledged. Hardware ready...\n\n"
+                  return line.split(":", 2)[1]
+                end
               end
             end
+          rescue Timeout::Error
+            print "No response, "
+            puts (retries + 1 < HANDSHAKE_TRIES ? "retrying..." : "exiting...")
+            next
           end
-        rescue Timeout::Error
-          print "No response, "
-          puts (retries + 1 < HANDSHAKE_TRIES ? "retrying..." : "exiting...")
-          next
         end
         raise HandshakeError, "Connected to wrong device, or device not running dino"
       end

From bb4e0fb4fc0a11a6bd99d2821b8f477e81aa40a5 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 6 Jan 2018 17:37:11 -0400
Subject: [PATCH 130/296] Forgot TCP file in earlier commits

---
 lib/dino/tx_rx/tcp.rb | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/lib/dino/tx_rx/tcp.rb b/lib/dino/tx_rx/tcp.rb
index d9610775..f9da020a 100644
--- a/lib/dino/tx_rx/tcp.rb
+++ b/lib/dino/tx_rx/tcp.rb
@@ -7,15 +7,21 @@ def initialize(host, port=3466)
         @host, @port = host, port
       end
 
-    private
+      def to_s
+        "#{@host}:#{@port}"
+      end
 
+    private
       def connect
-        Timeout::timeout(10) { TCPSocket.open(@host, @port) }
-      rescue
-        raise BoardNotFound
+        print "Connecting to TCP at: #{self.to_s}... "
+        connection = Timeout::timeout(10) { TCPSocket.open @host, @port }
+        puts "Connected"
+        connection
+      rescue => error
+        raise TCPConnectError, error.message
       end
 
-      def io_write(message)
+      def _write(message)
         loop do
           if IO.select(nil, [io], nil)
             io.syswrite(message)

From cd675bbd82323a44549de5f033cb5cc626c89a55 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 6 Jan 2018 18:07:04 -0400
Subject: [PATCH 131/296] Fix tests for ruby < 2.5.0 and require rubyserial ~>
 0.5.0.

---
 dino.gemspec                  |  3 +--
 lib/dino/tx_rx/serial.rb      | 17 ++++++++++-------
 spec/lib/tx_rx/serial_spec.rb |  4 ++--
 3 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/dino.gemspec b/dino.gemspec
index 96d54cb8..23d14b9d 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -16,8 +16,7 @@ Gem::Specification.new do |gem|
   gem.version       = Dino::VERSION
   gem.executables   = ["dino"]
 
-  gem.add_dependency 'rubyserial'
-  gem.add_dependency 'trollop'
+  gem.add_dependency 'rubyserial', '~> 0.5.0'
 
   gem.add_development_dependency 'rake'
   gem.add_development_dependency 'rspec'
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index 6ddd4acb..7a2adca1 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -18,13 +18,16 @@ def to_s
 
       def connect
         tty_devices.each do |device|
-          @device = device
-          print "Trying serial device: #{self.to_s}... "
-          connection = ::Serial.new(@device, @baud)
-          puts "Connected"
-          return connection
-        rescue RubySerial::Exception => error
-          handle_error(error); next
+          begin
+            @device = device
+            print "Trying serial device: #{self.to_s}... "
+            connection = ::Serial.new(@device, @baud)
+            puts "Connected"
+            return connection
+          rescue RubySerial::Error => error
+            puts error
+            handle_error(error); next
+          end
         end
         raise SerialConnectError, "Could not connect to a serial device."
       end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index ed772379..1bfb8b3b 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -17,7 +17,7 @@ module Dino
 
           # Simulate 3 COM ports with COM2 connected.
           expect(subject).to receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
-          expect(::Serial).to receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise(RubySerial::Exception)
+          expect(::Serial).to receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise(RubySerial::Error)
           expect(::Serial).to receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = double)
           expect(::Serial).to_not receive(:new).with("COM3", TxRx::Serial::BAUD)
           expect(subject.io).to equal(mock_serial)
@@ -46,7 +46,7 @@ module Dino
       end
 
       it 'should raise SerialConnectError if it cannot connect to a board' do
-        allow(::Serial).to receive(:new).and_raise(RubySerial::Exception)
+        allow(::Serial).to receive(:new).and_raise(RubySerial::Error)
         expect { subject.io }.to raise_exception Dino::TxRx::SerialConnectError
       end
     end

From a69be546883e8277a66ad672d52511428075f935 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 6 Jan 2018 21:31:13 -0400
Subject: [PATCH 132/296] Update CLI to target different boards

---
 bin/dino                  |  17 ++++--
 lib/dino_cli.rb           |   4 +-
 lib/dino_cli/generator.rb | 114 +++++++++++++++++++++++---------------
 lib/dino_cli/helper.rb    |  39 ++++---------
 lib/dino_cli/packages.rb  | 100 +++++++++++++++++++++++++++++++++
 lib/dino_cli/parser.rb    |  13 ++++-
 lib/dino_cli/targets.rb   |  16 ++++++
 lib/dino_cli/targets.txt  |  60 ++++++++++++++++++++
 lib/dino_cli/usage.txt    |  34 ++++++++++++
 src/lib/Dino.h            |  20 +------
 src/lib/DinoDefines.h     |  17 ++++++
 src/lib/DinoSerial.cpp    |   2 +
 src/lib/DinoSerial.h      |   2 +
 13 files changed, 336 insertions(+), 102 deletions(-)
 create mode 100644 lib/dino_cli/packages.rb
 create mode 100644 lib/dino_cli/targets.rb
 create mode 100644 lib/dino_cli/targets.txt
 create mode 100644 lib/dino_cli/usage.txt
 create mode 100644 src/lib/DinoDefines.h

diff --git a/bin/dino b/bin/dino
index 63d5b20d..dbe3caae 100755
--- a/bin/dino
+++ b/bin/dino
@@ -5,13 +5,18 @@
 require "pathname"
 bin_file = Pathname.new(__FILE__).realpath
 
-# Make sure dino is in the load path
-$:.unshift File.expand_path("../../lib", bin_file)
-
-# Work out paths for the CLI
-working_dir = Dir.pwd
+# Find everything else
 src_dir = bin_file.to_s.chomp("/bin/dino") + "/src"
+lib_dir = bin_file.to_s.chomp("/bin/dino") + "/lib"
+cli_dir = bin_file.to_s.chomp("/bin/dino") + "/lib/dino_cli"
+working_dir = Dir.pwd
+
+# Make sure dino is in the load path
+$:.unshift lib_dir
 
 # Start the CLI
 require "dino_cli"
-DinoCLI.start(working_dir: working_dir, src_dir: src_dir, args: ARGV)
+DinoCLI.start working_dir: working_dir,
+              src_dir: src_dir,
+              cli_dir: cli_dir,
+              args: ARGV
diff --git a/lib/dino_cli.rb b/lib/dino_cli.rb
index 30d7a37c..03e4621a 100644
--- a/lib/dino_cli.rb
+++ b/lib/dino_cli.rb
@@ -12,7 +12,7 @@ def self.start(options={})
   end
 
   def self.sketch(options)
-    options = DinoCLI::Generator.run!(options)
-    $stdout.puts options[:sketch_file]
+    result = DinoCLI::Generator.run!(options)
+    $stdout.puts result[:sketch_file]
   end
 end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 87bd7e78..26853d4d 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -1,62 +1,56 @@
 class DinoCLI::Generator
   require "fileutils"
-  LIB_FILENAMES =  [
-                    "lib/Dino.h",
-                    "lib/Dino.cpp",
-                    "lib/DinoCoreIO.cpp",
-                    "lib/DinoIncludes.cpp",
-                    "lib/DinoLCD.cpp",
-                    "lib/DinoLCD.h",
-                    "lib/DinoSerial.cpp",
-                    "lib/DinoSerial.h",
-                    "lib/DinoServo.cpp",
-                    "lib/DinoDHT.cpp",
-                    "lib/DinoOneWire.cpp",
-                    "lib/DinoIROut.cpp",
-                    "lib/DinoTone.cpp",
-                    "lib/DinoShift.cpp",
-                    "lib/DinoSPI.cpp",
-                    "lib/DinoI2C.cpp",
-
-                    # See explanation at top of src/lib/DinoBugWorkaround.cpp
-                    "lib/DinoBugWorkaround.cpp",
-
-                    "vendor/DHT/DHT.cpp",
-                    "vendor/DHT/DHT.h",
-                    "vendor/OneWire/OneWire.cpp",
-                    "vendor/OneWire/OneWire.h",
-                    "vendor/Arduino-IRremote/boarddefs.h",
-                    "vendor/Arduino-IRremote/IRremote.cpp",
-                    "vendor/Arduino-IRremote/IRremote.h",
-                    "vendor/Arduino-IRremote/IRremoteInt.h",
-                    "vendor/Arduino-IRremote/irSend.cpp",
-
-                    "vendor/I2C-Master-Library/I2C.h",
-                    "vendor/I2C-Master-Library/I2C.cpp"
-                  ]
-
+  require "dino_cli/packages"
+  require "dino_cli/targets"
   attr_accessor :options
 
   def initialize(options={})
     @options = options
+    append_target
+  end
+
+  def append_target
+    # Default to generating the mega sketch.
+    options[:target] = :mega unless options[:target]
+    # Preserve the source sketch name, since we need to copy that file.
+    options[:src_sketch_name] = options[:sketch_name].dup
+    # Append the target to the output sketch name/folder when not using :mega.
+    options[:sketch_name] << "_#{options[:target]}" unless options[:target] == :mega
   end
 
   def self.run!(options={})
     instance = self.new(options)
 
     instance.read
-    instance.modify
+    instance.target_config
+    instance.user_config
     instance.write
   end
 
   def read
-    @libs = LIB_FILENAMES.map do |f|
-      File.read(File.join(options[:src_dir], f))
+    # Start by just copying the PACKAGES hash.
+    @packages = PACKAGES
+
+    # Now replace each filepath with a hash containing the filepath and contents.
+    @packages.each_key do |k|
+      @packages[k][:files].map! do |f|
+        contents = File.read(File.join(options[:src_dir], f))
+        # If the file is in src/vendor, it gets wrapped in an #ifdef
+        # corresponding to the package directive. The entire package can now
+        # be toggled in DinoDefines.h. Without this, IDE would try to compile anyway.
+        if f.match /\Avendor/
+          directive = @packages[k][:directive]
+          contents = "#include \"DinoDefines.h\"\n#ifdef #{directive}\n" << contents << "\n#endif\n"
+        end
+        { path: f, contents: contents }
+      end
     end
-    @sketch = File.read File.join(options[:src_dir], sketch_filename)
+
+    # Read in the sketch itself.
+    @sketch = File.read File.join(options[:src_dir], "#{options[:src_sketch_name]}.ino")
   end
 
-  def modify
+  def user_config
     if options[:baud] && serial?
       @sketch.gsub! "115200", options[:baud]
     end
@@ -78,22 +72,50 @@ def modify
       @sketch.gsub! "int port = 3466", "int port = #{options[:port]}"
     end
     if options[:debug]
-      @libs[0].gsub! "// #define debug",    "#define debug"
+      define("debug")
     end
     unless serial?
-      @libs[0].gsub! "// #define TXRX_SPI", "#define TXRX_SPI"
+      define("TXRX_SPI")
+    end
+  end
+
+  def target_config
+    target_packages = TARGETS[options[:target]]
+    target_packages.each do |t|
+      directive = PACKAGES[t][:directive]
+      define(directive) if directive
+    end
+  end
+
+  def define(directive)
+    gsub_defines "// #define #{directive}", "#define #{directive}"
+  end
+
+  # Run gsub! on contents of src/lib/Dino.h specifically.
+  def gsub_defines(from, to)
+    @packages[:core][:files].each do |f|
+      if f[:path] == "lib/DinoDefines.h"
+        f[:contents].gsub!(from, to)
+      end
     end
   end
 
   def write
+    # Write the sketch itself first.
     sketch = File.join(output_dir, sketch_filename)
     File.open(sketch, 'w') { |f| f.write @sketch }
 
-    libs = LIB_FILENAMES.map { |f| File.join(output_dir, f.split('/')[-1])}
-    libs.each_with_index do |file, index|
-      File.open(file, 'w') { |f| f.write @libs[index]}
+    # Go through the @packages hash and copy all the source files regardless of target.
+    # Append source file basename to the output dir to get output file path.
+    # Then write the file contents to the destination path.
+    @packages.each_key do |k|
+      @packages[k][:files].each do |file|
+        dest_path = File.join(output_dir, file[:path].split('/')[-1])
+        File.open(dest_path, 'w') { |f| f.write file[:contents] }
+      end
     end
 
+    # Return the location of the sketch file.
     options[:sketch_file] = sketch
     options
   end
@@ -115,6 +137,6 @@ def make_output_dir
   end
 
   def sketch_filename
-    options[:sketch_filename] ||= "#{options[:sketch_name]}.ino"
+    "#{options[:sketch_name]}.ino"
   end
 end
diff --git a/lib/dino_cli/helper.rb b/lib/dino_cli/helper.rb
index 2d30a1b2..3ea1b46f 100644
--- a/lib/dino_cli/helper.rb
+++ b/lib/dino_cli/helper.rb
@@ -1,39 +1,22 @@
 module DinoCLI::Helper
-  def error(message)
+  def error(message, help=:usage)
     $stderr.puts
     $stderr.puts "Error: #{message}"
     $stderr.puts
-    usage
+    usage if help == :usage
+    targets if help == :targets
   end
 
   def usage
-    $stderr.puts "Usage:"
-    $stderr.puts "  dino task [options]"
+    text = File.read(File.join(@options[:cli_dir], "usage.txt"))
+    $stderr.print text
     $stderr.puts
-    $stderr.puts "Tasks:"
-    $stderr.puts "  sketch SKETCH [options]"
-    $stderr.puts
-    $stderr.puts "Available sketches and options for each sketch:"
-    $stderr.puts
-    $stderr.puts "  serial"
-    $stderr.puts "    -baud BAUD"
-    $stderr.puts "    -debug"
-    $stderr.puts
-    $stderr.puts "  ethernet"
-    $stderr.puts "    -mac XX:XX:XX:XX:XX:XX"
-    $stderr.puts "    -ip XXX.XXX.XXX.XXX"
-    $stderr.puts "    -port PORT"
-    $stderr.puts "    -debug"
-    $stderr.puts
-    $stderr.puts "  wifi"
-    $stderr.puts "    -ssid SSID"
-    $stderr.puts "    -password PASSWORD"
-    $stderr.puts "    -port PORT"
-    $stderr.puts "    -debug"
-    $stderr.puts
-    $stderr.puts "Example:"
-    $stderr.puts
-    $stderr.puts "  dino sketch serial -baud 9600"
+    exit(2)
+  end
+
+  def targets
+    text = File.read(File.join(@options[:cli_dir], "targets.txt"))
+    $stderr.print text
     $stderr.puts
     exit(2)
   end
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
new file mode 100644
index 00000000..15ea1d98
--- /dev/null
+++ b/lib/dino_cli/packages.rb
@@ -0,0 +1,100 @@
+class DinoCLI::Generator
+PACKAGES = {
+  # These files are always included when building a sketch.
+  core: {
+    description: "Core Dino Library",
+    directive: nil,
+    files: [
+      "lib/Dino.h",
+      "lib/DinoDefines.h",
+      "lib/Dino.cpp",
+      "lib/DinoCoreIO.cpp",
+      "lib/DinoIncludes.cpp",
+      "lib/DinoBugWorkaround.cpp",  # See explanation at top of file.
+    ]
+  },
+  servo: {
+    description: "Servo support",
+    directive: "DINO_LCD",
+    files: [
+      "lib/DinoServo.cpp",
+    ]
+  },
+  tone: {
+    description: "Tone support",
+    directive: "DINO_TONE",
+    files: [
+      "lib/DinoTone.cpp",
+    ]
+  },
+  shift: {
+    description: "Shift Register support",
+    directive: "DINO_SHIFT",
+    files: [
+      "lib/DinoShift.cpp",
+    ]
+  },
+  spi: {
+    description: "SPI support",
+    directive: "DINO_SPI",
+    files: [
+      "lib/DinoSPI.cpp",
+    ]
+  },
+  lcd: {
+    description: "LCD based on Arduino LiquidCrystal",
+    directive: "DINO_LCD",
+    files: [
+      "lib/DinoLCD.cpp",
+      "lib/DinoLCD.h",
+    ]
+  },
+  dht: {
+    description: "Read DHT temp/humidity sensors",
+    directive: "DINO_DHT",
+    files: [
+      "lib/DinoDHT.cpp",
+      "vendor/DHT/DHT.cpp",
+      "vendor/DHT/DHT.h",
+    ]
+  },
+  serial: {
+    description: "Software serial output",
+    directive: "DINO_SERIAL",
+    files: [
+      "lib/DinoSerial.cpp",
+      "lib/DinoSerial.h",
+    ]
+  },
+  ir_out: {
+    description: "Transmit infrared signals",
+    directive: "DINO_IR_OUT",
+    files: [
+      "lib/DinoIROut.cpp",
+      "vendor/Arduino-IRremote/boarddefs.h",
+      "vendor/Arduino-IRremote/IRremote.cpp",
+      "vendor/Arduino-IRremote/IRremote.h",
+      "vendor/Arduino-IRremote/IRremoteInt.h",
+      "vendor/Arduino-IRremote/irSend.cpp",
+    ]
+  },
+  one_wire: {
+    description: "OneWire bus support (Just DS18B20 for now)",
+    directive: "DINO_ONE_WIRE",
+    files: [
+      "lib/DinoOneWire.cpp",
+      "vendor/OneWire/OneWire.cpp",
+      "vendor/OneWire/OneWire.h",
+    ]
+  },
+  i2c: {
+    description: "I2C device support",
+    directive: "DINO_I2C",
+    files: [
+      "lib/DinoI2C.cpp",
+      "vendor/I2C-Master-Library/I2C.h",
+      "vendor/I2C-Master-Library/I2C.cpp",
+    ]
+  }
+}
+end
diff --git a/lib/dino_cli/parser.rb b/lib/dino_cli/parser.rb
index 7e9217c9..a2c578f4 100644
--- a/lib/dino_cli/parser.rb
+++ b/lib/dino_cli/parser.rb
@@ -15,9 +15,12 @@ def parse
     args = @options[:args].dup
     error("No arguments given") if args.empty?
 
-    # Ensure task is the first argument
+    # Ensure task is the first argument.
     @options[:task] = args.shift
+
+    # If the task is a help command, just run it, don't return.
     usage if @options[:task].match /help|usage/
+    targets if @options[:task].match /targets/
 
     # Ensure there's only one task
     error "Invalid task '#{@options[:task]}'" unless DinoCLI::TASKS.include? @options[:task]
@@ -33,6 +36,8 @@ def parse
           args.shift; set_sketch("wifi")
         when '-baud'
           args.shift; @options[:baud] = args.shift
+        when '-target'
+          args.shift; set_target(args.shift)
         when '-mac'
           args.shift; @options[:mac] = args.shift
         when '-ip'
@@ -59,4 +64,10 @@ def set_sketch(name)
     error "More than one sketch specified" unless @options[:sketch_name].nil?
     @options[:sketch_name] = "dino_#{name}"
   end
+
+  def set_target(target)
+    targets = DinoCLI::Generator::TARGETS.each_key.map{|a| a.to_s}
+    error "Invalid target '#{target}'", :targets unless targets.include?(target)
+    @options[:target] = target.to_sym
+  end
 end
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
new file mode 100644
index 00000000..92d029f8
--- /dev/null
+++ b/lib/dino_cli/targets.rb
@@ -0,0 +1,16 @@
+class DinoCLI::Generator
+  TARGETS = {
+    # Default target always includes all packages.
+    # Tone temporarily disabled due to timer conflict.
+    mega: PACKAGES.each_key.map {|k| k} - [:tone],
+
+    # Core is core.
+    core: [:core],
+
+    # Specific features for the old mega168 chips.
+    mega168: [:core, :servo, :lcd, :spi, :i2c],
+
+    # ARM includes everytyhing except specific incompatibilities.
+    arm: PACKAGES.each_key.map {|k| k} - [:serial, :tone, :ir_out, :i2c],
+  }
+end
diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
new file mode 100644
index 00000000..b5082cda
--- /dev/null
+++ b/lib/dino_cli/targets.txt
@@ -0,0 +1,60 @@
+
+  Valid targets:
+
+    mega (default)
+
+      Covers the popular Atmel chips on Arduino boards listed below, and many more.
+      This is the primary target and all features will be included. Default setting.
+
+      Chips:  ATmega328p, ATmega32u4, ATmega1280, ATmega2560
+      Boards: UNO, Nano, Mini, Ethernet
+              Leonardo, Micro, Esplora, Leonardo ETH
+              Mega 1280, Mega 2560, Mega ADK
+              Most Lilypads (excluding ones with an ATmega168)
+
+    core
+
+      This includes only the core feature set of dino:
+        Set Pin Mode
+        Digital Read/Write/Listen
+        Analog Read/Write/Listen
+
+      This is useful if you're getting errors when trying to upload, want to
+      include specific features by hand, trying to squeeze onto something with
+      low memory, or testing a new chip. This is the smallest the dino sketch
+      can get for now, and should be universally compatible.
+
+    mega168
+
+      This specifically targets the older ATmega168 chip used in early Arduinos.
+      They have half the RAM and flash available, so we need to cut the sketch down.
+      Beyond core IO functionality, it ONLY includes the following features:
+          Servo, LCD, SPI, I2C
+
+      Chips:  ATmega168
+      Boards: Duemilanove, Diecimila, Pro, Pro Mini
+              (Later versions of these may carry an ATmega328)
+
+      Note: While you can generate this sketch using any communication type,
+      it will only fit on the board when generated for serial communication.
+      There is not enough memory available for Wi-Fi or Ethernet. You can
+      try the core target to tradeoff the features for networking.
+
+      Note: Aux message length is always limited to 40 bytes on this chip.
+
+    arm
+
+      This is the same as mega, but omits libraries specifically known to be
+      incompatible with the Atmel SAMD (ARM Cortex M0) chips. Use this when
+      you need to load a sketch on the Arduino Due or similar boards.
+      This option excludes the following features:
+          Serial, Tone, IR Out, I2C
+
+      Chips:  AT91SAM3X8E
+      Boards: Due
+
+  NOTE: While different targets include different libraries, you can manually
+  control which libraries are included at compile time by editing DinoDefines.h.
+  All the library files (even the unused ones) are copied to the destination sketch
+  folder to enable this. Uncomment a corresponding #define in DinoDefines.h to
+  include a library in the sketch. Comment it out to exclude that library.
diff --git a/lib/dino_cli/usage.txt b/lib/dino_cli/usage.txt
new file mode 100644
index 00000000..5e4202a7
--- /dev/null
+++ b/lib/dino_cli/usage.txt
@@ -0,0 +1,34 @@
+
+  Usage:
+    dino task [options]
+
+  Tasks:
+    sketch SKETCH [options]
+    help
+    targets
+
+  Global options:
+
+    -target TARGET    (default: mega. Run 'dino targets' for more info)
+    -debug            (default: off)
+
+  Available sketches and sketch for each sketch:
+
+    serial
+      -baud BAUD    (default: 115200)
+
+    ethernet
+      -mac XX:XX:XX:XX:XX:XX    (required)
+      -ip XXX.XXX.XXX.XXX       (required, no DHCP)
+      -port PORT                (default: 3466)
+
+    wifi
+      -ssid SSID            (required)
+      -password PASSWORD    (required)
+      -port PORT            (default: 3466)
+
+  Examples:
+
+    dino sketch ethernet -mac 12:34:56:78:90:12 - ip 192.168.1.2
+    dino sketch serial -baud 57600
+    dino sketch serial -baud 9600 -target core
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 5363ec03..e4c92168 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -4,25 +4,7 @@
 #ifndef Dino_h
 #define Dino_h
 #include <Arduino.h>
-
-// If using Wi-Fi or Ethernet shield, uncomment this to let the SPI library know.
-// #define TXRX_SPI
-
-// Uncomment this line to enable debugging mode.
-// #define debug
-
-// Comment these out to exclude default features.
-// Arduino Due cannot use: SERIAL, IR, TONE, I2C
-#define DINO_SERVO
-#define DINO_LCD
-#define DINO_SERIAL
-#define DINO_DHT
-#define DINO_ONE_WIRE
-#define DINO_IR_OUT
-// #define DINO_TONE
-#define DINO_SHIFT
-#define DINO_SPI
-#define DINO_I2C
+#include "DinoDefines.h"
 
 // Figure out how many pins our hardware has.
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
diff --git a/src/lib/DinoDefines.h b/src/lib/DinoDefines.h
new file mode 100644
index 00000000..8e630eed
--- /dev/null
+++ b/src/lib/DinoDefines.h
@@ -0,0 +1,17 @@
+// If using Wi-Fi or Ethernet shield, uncomment this to let the SPI library know.
+// #define TXRX_SPI
+
+// Uncomment this line to enable debugging mode.
+// #define debug
+
+// Uncomment these to include features beyond core features.
+// #define DINO_SERVO
+// #define DINO_LCD
+// #define DINO_SERIAL
+// #define DINO_DHT
+// #define DINO_ONE_WIRE
+// #define DINO_IR_OUT
+// #define DINO_TONE
+// #define DINO_SHIFT
+// #define DINO_SPI
+// #define DINO_I2C
diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
index 8e1dfec4..9efb7995 100644
--- a/src/lib/DinoSerial.cpp
+++ b/src/lib/DinoSerial.cpp
@@ -1,3 +1,4 @@
+#ifdef DINO_SERIAL
 #include "Arduino.h"
 #include "DinoSerial.h"
 
@@ -38,3 +39,4 @@ void DinoSerial::begin(char *aux) {
   int baud = atoi(aux);
   softSerial.begin(baud);
 }
+#endif
diff --git a/src/lib/DinoSerial.h b/src/lib/DinoSerial.h
index a4427767..f74c0058 100644
--- a/src/lib/DinoSerial.h
+++ b/src/lib/DinoSerial.h
@@ -1,3 +1,4 @@
+#ifdef DINO_SERIAL
 #ifndef DinoSerial_h
 #define DinoSerial_h
 
@@ -16,3 +17,4 @@ class DinoSerial {
 };
 
 #endif
+#endif

From b908bcfcc57c730a88709fb07d94f59e63ce2fa4 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 6 Jan 2018 22:44:31 -0400
Subject: [PATCH 133/296] Make all external libraries submodules. Fix a couple
 #ifdefs.

---
 .gitmodules                    |   6 +
 lib/dino_cli/packages.rb       |   4 +-
 src/lib/DinoDHT.cpp            |   3 +-
 src/lib/DinoLCD.cpp            |   3 +
 src/lib/DinoLCD.h              |   3 +
 src/lib/DinoSerial.cpp         |   1 +
 src/lib/DinoSerial.h           |   1 +
 src/vendor/DHT/DHT.cpp         | 207 ---------------------------------
 src/vendor/DHT/DHT.h           |  96 ---------------
 src/vendor/OneWire/OneWire.cpp |  38 ++++--
 src/vendor/OneWire/OneWire.h   | 196 +++++++++++++++++++++++++++++--
 src/vendor/arduino-DHT         |   1 +
 12 files changed, 233 insertions(+), 326 deletions(-)
 delete mode 100644 src/vendor/DHT/DHT.cpp
 delete mode 100644 src/vendor/DHT/DHT.h
 mode change 100755 => 100644 src/vendor/OneWire/OneWire.cpp
 mode change 100755 => 100644 src/vendor/OneWire/OneWire.h
 create mode 160000 src/vendor/arduino-DHT

diff --git a/.gitmodules b/.gitmodules
index 2d2f614d..47bcd249 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -4,3 +4,9 @@
 [submodule "src/vendor/I2C-Master-Library"]
 	path = src/vendor/I2C-Master-Library
 	url = https://github.com/vickash/I2C-Master-Library.git
+[submodule "src/vendor/arduino-DHT"]
+	path = src/vendor/arduino-DHT
+	url = https://github.com/markruys/arduino-DHT.git
+[submodule "src/vendor/OneWire"]
+	path = src/vendor/OneWire
+	url = https://github.com/PaulStoffregen/OneWire.git
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index 15ea1d98..5bb654fe 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -54,8 +54,8 @@ class DinoCLI::Generator
     directive: "DINO_DHT",
     files: [
       "lib/DinoDHT.cpp",
-      "vendor/DHT/DHT.cpp",
-      "vendor/DHT/DHT.h",
+      "vendor/arduino-DHT/DHT.cpp",
+      "vendor/arduino-DHT/DHT.h",
     ]
   },
   serial: {
diff --git a/src/lib/DinoDHT.cpp b/src/lib/DinoDHT.cpp
index 43b56090..7a29e1c8 100644
--- a/src/lib/DinoDHT.cpp
+++ b/src/lib/DinoDHT.cpp
@@ -17,7 +17,8 @@ DHT dht;
 // CMD = 13
 // Read a DHT sensor
 void Dino::dhtRead() {
-  if (pin != dht.pin) dht.setup(pin);
+  // if (pin != dht.pin)
+  dht.setup(pin);
   float reading;
   char readingBuff[10];
   char prefix;
diff --git a/src/lib/DinoLCD.cpp b/src/lib/DinoLCD.cpp
index 0c0bbabb..d705565c 100644
--- a/src/lib/DinoLCD.cpp
+++ b/src/lib/DinoLCD.cpp
@@ -1,3 +1,5 @@
+#include "Dino.h"
+#ifdef DINO_LCD
 #include "Arduino.h"
 #include "DinoLCD.h"
 
@@ -66,3 +68,4 @@ void DinoLCD::setLCDCursor(char *aux) {
   int *values = parse(aux);
   lcd.setCursor(values[0], values[1]);
 }
+#endif
diff --git a/src/lib/DinoLCD.h b/src/lib/DinoLCD.h
index a90629e2..49657dba 100644
--- a/src/lib/DinoLCD.h
+++ b/src/lib/DinoLCD.h
@@ -1,3 +1,5 @@
+#include "Dino.h"
+#ifdef DINO_LCD
 #ifndef DinoLCD_h
 #define DinoLCD_h
 
@@ -18,3 +20,4 @@ class DinoLCD {
 };
 
 #endif
+#endif
diff --git a/src/lib/DinoSerial.cpp b/src/lib/DinoSerial.cpp
index 9efb7995..f39ddde0 100644
--- a/src/lib/DinoSerial.cpp
+++ b/src/lib/DinoSerial.cpp
@@ -1,3 +1,4 @@
+#include "Dino.h"
 #ifdef DINO_SERIAL
 #include "Arduino.h"
 #include "DinoSerial.h"
diff --git a/src/lib/DinoSerial.h b/src/lib/DinoSerial.h
index f74c0058..9cc3a85a 100644
--- a/src/lib/DinoSerial.h
+++ b/src/lib/DinoSerial.h
@@ -1,3 +1,4 @@
+#include "Dino.h"
 #ifdef DINO_SERIAL
 #ifndef DinoSerial_h
 #define DinoSerial_h
diff --git a/src/vendor/DHT/DHT.cpp b/src/vendor/DHT/DHT.cpp
deleted file mode 100644
index 90727246..00000000
--- a/src/vendor/DHT/DHT.cpp
+++ /dev/null
@@ -1,207 +0,0 @@
-/******************************************************************
-  DHT Temperature & Humidity Sensor library for Arduino.
-
-  Features:
-  - Support for DHT11 and DHT22/AM2302/RHT03
-  - Auto detect sensor model
-  - Very low memory footprint
-  - Very small code
-
-  http://www.github.com/markruys/arduino-DHT
-
-  Written by Mark Ruys, mark@paracas.nl.
-
-  BSD license, check license.txt for more information.
-  All text above must be included in any redistribution.
-
-  Datasheets:
-  - http://www.micro4you.com/files/sensor/DHT11.pdf
-  - http://www.adafruit.com/datasheets/DHT22.pdf
-  - http://dlnmh9ip6v2uc.cloudfront.net/datasheets/Sensors/Weather/RHT03.pdf
-  - http://meteobox.tk/files/AM2302.pdf
-
-  Changelog:
-   2013-06-10: Initial version
-   2013-06-12: Refactored code
-   2013-07-01: Add a resetTimer method
- ******************************************************************/
-
-#include "DHT.h"
-
-void DHT::setup(uint8_t pin, DHT_MODEL_t model)
-{
-  DHT::pin = pin;
-  DHT::model = model;
-  DHT::resetTimer(); // Make sure we do read the sensor in the next readSensor()
-
-  if ( model == AUTO_DETECT) {
-    DHT::model = DHT22;
-    readSensor();
-    if ( error == ERROR_TIMEOUT ) {
-      DHT::model = DHT11;
-      delay(1000);
-      // Warning: in case we auto detect a DHT11, you should wait at least 1000 msec
-      // before your first read request. Otherwise you will get a time out error.
-    }
-  }
-}
-
-void DHT::resetTimer()
-{
-  DHT::lastReadTime = millis() - 3000;
-}
-
-float DHT::getHumidity()
-{
-  readSensor();
-  return humidity;
-}
-
-float DHT::getTemperature()
-{
-  readSensor();
-  return temperature;
-}
-
-#ifndef OPTIMIZE_SRAM_SIZE
-
-const char* DHT::getStatusString()
-{
-  switch ( error ) {
-    case DHT::ERROR_TIMEOUT:
-      return "TIMEOUT";
-
-    case DHT::ERROR_CHECKSUM:
-      return "CHECKSUM";
-
-    default:
-      return "OK";
-  }
-}
-
-#else
-
-// At the expense of 26 bytes of extra PROGMEM, we save 11 bytes of
-// SRAM by using the following method:
-
-prog_char P_OK[]       PROGMEM = "OK";
-prog_char P_TIMEOUT[]  PROGMEM = "TIMEOUT";
-prog_char P_CHECKSUM[] PROGMEM = "CHECKSUM";
-
-const char *DHT::getStatusString() {
-  prog_char *c;
-  switch ( error ) {
-    case DHT::ERROR_CHECKSUM:
-      c = P_CHECKSUM; break;
-
-    case DHT::ERROR_TIMEOUT:
-      c = P_TIMEOUT; break;
-
-    default:
-      c = P_OK; break;
-  }
-
-  static char buffer[9];
-  strcpy_P(buffer, c);
-
-  return buffer;
-}
-
-#endif
-
-void DHT::readSensor()
-{
-  // Make sure we don't poll the sensor too often
-  // - Max sample rate DHT11 is 1 Hz   (duty cicle 1000 ms)
-  // - Max sample rate DHT22 is 0.5 Hz (duty cicle 2000 ms)
-  unsigned long startTime = millis();
-  if ( (unsigned long)(startTime - lastReadTime) < (model == DHT11 ? 999L : 1999L) ) {
-    return;
-  }
-  lastReadTime = startTime;
-
-  temperature = NAN;
-  humidity = NAN;
-
-  // Request sample
-
-  digitalWrite(pin, LOW); // Send start signal
-  pinMode(pin, OUTPUT);
-  if ( model == DHT11 ) {
-    delay(18);
-  }
-  else {
-    // This will fail for a DHT11 - that's how we can detect such a device
-    delayMicroseconds(800);
-  }
-
-  pinMode(pin, INPUT);
-  digitalWrite(pin, HIGH); // Switch bus to receive data
-
-  // We're going to read 83 edges:
-  // - First a FALLING, RISING, and FALLING edge for the start bit
-  // - Then 40 bits: RISING and then a FALLING edge per bit
-  // To keep our code simple, we accept any HIGH or LOW reading if it's max 85 usecs long
-
-  word rawHumidity;
-  word rawTemperature;
-  word data;
-
-  for ( int8_t i = -3 ; i < 2 * 40; i++ ) {
-    byte age;
-    startTime = micros();
-
-    do {
-      age = (unsigned long)(micros() - startTime);
-      if ( age > 90 ) {
-        error = ERROR_TIMEOUT;
-        return;
-      }
-    }
-    while ( digitalRead(pin) == (i & 1) ? HIGH : LOW );
-
-    if ( i >= 0 && (i & 1) ) {
-      // Now we are being fed our 40 bits
-      data <<= 1;
-
-      // A zero max 30 usecs, a one at least 68 usecs.
-      if ( age > 30 ) {
-        data |= 1; // we got a one
-      }
-    }
-
-    switch ( i ) {
-      case 31:
-        rawHumidity = data;
-        break;
-      case 63:
-        rawTemperature = data;
-        data = 0;
-        break;
-    }
-  }
-
-  // Verify checksum
-
-  if ( (byte)(((byte)rawHumidity) + (rawHumidity >> 8) + ((byte)rawTemperature) + (rawTemperature >> 8)) != data ) {
-    error = ERROR_CHECKSUM;
-    return;
-  }
-
-  // Store readings
-
-  if ( model == DHT11 ) {
-    humidity = rawHumidity >> 8;
-    temperature = rawTemperature >> 8;
-  }
-  else {
-    humidity = rawHumidity * 0.1;
-
-    if ( rawTemperature & 0x8000 ) {
-      rawTemperature = -(int16_t)(rawTemperature & 0x7FFF);
-    }
-    temperature = ((int16_t)rawTemperature) * 0.1;
-  }
-
-  error = ERROR_NONE;
-}
\ No newline at end of file
diff --git a/src/vendor/DHT/DHT.h b/src/vendor/DHT/DHT.h
deleted file mode 100644
index bf6113a0..00000000
--- a/src/vendor/DHT/DHT.h
+++ /dev/null
@@ -1,96 +0,0 @@
-/******************************************************************
-  DHT Temperature & Humidity Sensor library for Arduino.
-
-  Features:
-  - Support for DHT11 and DHT22/AM2302/RHT03
-  - Auto detect sensor model
-  - Very low memory footprint
-  - Very small code
-
-  http://www.github.com/markruys/arduino-DHT
-
-  Written by Mark Ruys, mark@paracas.nl.
-
-  BSD license, check license.txt for more information.
-  All text above must be included in any redistribution.
-
-  Datasheets:
-  - http://www.micro4you.com/files/sensor/DHT11.pdf
-  - http://www.adafruit.com/datasheets/DHT22.pdf
-  - http://dlnmh9ip6v2uc.cloudfront.net/datasheets/Sensors/Weather/RHT03.pdf
-  - http://meteobox.tk/files/AM2302.pdf
-
-  Changelog:
-   2013-06-10: Initial version
-   2013-06-12: Refactored code
-   2013-07-01: Add a resetTimer method
- ******************************************************************/
-
-#ifndef dht_h
-#define dht_h
-
-#if ARDUINO < 100
-  #include <WProgram.h>
-#else
-  #include <Arduino.h>
-#endif
-
-class DHT
-{
-public:
-
-  typedef enum {
-    AUTO_DETECT,
-    DHT11,
-    DHT22,
-    AM2302,  // Packaged DHT22
-    RHT03    // Equivalent to DHT22
-  }
-  DHT_MODEL_t;
-
-  typedef enum {
-    ERROR_NONE = 0,
-    ERROR_TIMEOUT,
-    ERROR_CHECKSUM
-  }
-  DHT_ERROR_t;
-
-  void setup(uint8_t pin, DHT_MODEL_t model=AUTO_DETECT);
-  void resetTimer();
-
-  float getTemperature();
-  float getHumidity();
-
-  DHT_ERROR_t getStatus() { return error; };
-  const char* getStatusString();
-
-  DHT_MODEL_t getModel() { return model; }
-
-  int getMinimumSamplingPeriod() { return model == DHT11 ? 1000 : 2000; }
-
-  int8_t getNumberOfDecimalsTemperature() { return model == DHT11 ? 0 : 1; };
-  int8_t getLowerBoundTemperature() { return model == DHT11 ? 0 : -40; };
-  int8_t getUpperBoundTemperature() { return model == DHT11 ? 50 : 125; };
-
-  int8_t getNumberOfDecimalsHumidity() { return 0; };
-  int8_t getLowerBoundHumidity() { return model == DHT11 ? 20 : 0; };
-  int8_t getUpperBoundHumidity() { return model == DHT11 ? 90 : 100; };
-
-  static float toFahrenheit(float fromCelcius) { return 1.8 * fromCelcius + 32.0; };
-  static float toCelsius(float fromFahrenheit) { return (fromFahrenheit - 32.0) / 1.8; };
-
-  uint8_t pin;
-
-protected:
-  void readSensor();
-
-  float temperature;
-  float humidity;
-
-private:
-  DHT_MODEL_t model;
-  DHT_ERROR_t error;
-  unsigned long lastReadTime;
-};
-
-#endif /*dht_h*/
\ No newline at end of file
diff --git a/src/vendor/OneWire/OneWire.cpp b/src/vendor/OneWire/OneWire.cpp
old mode 100755
new mode 100644
index efd69491..5c9945d5
--- a/src/vendor/OneWire/OneWire.cpp
+++ b/src/vendor/OneWire/OneWire.cpp
@@ -5,15 +5,35 @@ The latest version of this library may be found at:
   http://www.pjrc.com/teensy/td_libs_OneWire.html
 
 OneWire has been maintained by Paul Stoffregen (paul@pjrc.com) since
-January 2010.  At the time, it was in need of many bug fixes, but had
+January 2010.
+
+DO NOT EMAIL for technical support, especially not for ESP chips!
+All project support questions must be posted on public forums
+relevant to the board or chips used.  If using Arduino, post on
+Arduino's forum.  If using ESP, post on the ESP community forums.
+There is ABSOLUTELY NO TECH SUPPORT BY PRIVATE EMAIL!
+
+Github's issue tracker for OneWire should be used only to report
+specific bugs.  DO NOT request project support via Github.  All
+project and tech support questions must be posted on forums, not
+github issues.  If you experience a problem and you are not
+absolutely sure it's an issue with the library, ask on a forum
+first.  Only use github to report issues after experts have
+confirmed the issue is with OneWire rather than your project.
+
+Back in 2010, OneWire was in need of many bug fixes, but had
 been abandoned the original author (Jim Studt).  None of the known
 contributors were interested in maintaining OneWire.  Paul typically
 works on OneWire every 6 to 12 months.  Patches usually wait that
 long.  If anyone is interested in more actively maintaining OneWire,
-please contact Paul.
+please contact Paul (this is pretty much the only reason to use
+private email about OneWire).
+
+OneWire is now very mature code.  No changes other than adding
+definitions for newer hardware support are anticipated.
 
 Version 2.3:
-  Unknonw chip fallback mode, Roger Clark
+  Unknown chip fallback mode, Roger Clark
   Teensy-LC compatibility, Paul Stoffregen
   Search bug fix, Love Nystrom
 
@@ -141,8 +161,8 @@ OneWire::OneWire(uint8_t pin)
 //
 uint8_t OneWire::reset(void)
 {
-	IO_REG_TYPE mask = bitmask;
-	volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg;
+	IO_REG_TYPE mask IO_REG_MASK_ATTR = bitmask;
+	volatile IO_REG_TYPE *reg IO_REG_BASE_ATTR = baseReg;
 	uint8_t r;
 	uint8_t retries = 125;
 
@@ -175,8 +195,8 @@ uint8_t OneWire::reset(void)
 //
 void OneWire::write_bit(uint8_t v)
 {
-	IO_REG_TYPE mask=bitmask;
-	volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg;
+	IO_REG_TYPE mask IO_REG_MASK_ATTR = bitmask;
+	volatile IO_REG_TYPE *reg IO_REG_BASE_ATTR = baseReg;
 
 	if (v & 1) {
 		noInterrupts();
@@ -203,8 +223,8 @@ void OneWire::write_bit(uint8_t v)
 //
 uint8_t OneWire::read_bit(void)
 {
-	IO_REG_TYPE mask=bitmask;
-	volatile IO_REG_TYPE *reg IO_REG_ASM = baseReg;
+	IO_REG_TYPE mask IO_REG_MASK_ATTR = bitmask;
+	volatile IO_REG_TYPE *reg IO_REG_BASE_ATTR = baseReg;
 	uint8_t r;
 
 	noInterrupts();
diff --git a/src/vendor/OneWire/OneWire.h b/src/vendor/OneWire/OneWire.h
old mode 100755
new mode 100644
index b66b7eba..c394f1d0
--- a/src/vendor/OneWire/OneWire.h
+++ b/src/vendor/OneWire/OneWire.h
@@ -62,7 +62,8 @@
 #define PIN_TO_BASEREG(pin)             (portInputRegister(digitalPinToPort(pin)))
 #define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
 #define IO_REG_TYPE uint8_t
-#define IO_REG_ASM asm("r30")
+#define IO_REG_BASE_ATTR asm("r30")
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, mask)         (((*(base)) & (mask)) ? 1 : 0)
 #define DIRECT_MODE_INPUT(base, mask)   ((*((base)+1)) &= ~(mask))
 #define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+1)) |= (mask))
@@ -73,7 +74,8 @@
 #define PIN_TO_BASEREG(pin)             (portOutputRegister(pin))
 #define PIN_TO_BITMASK(pin)             (1)
 #define IO_REG_TYPE uint8_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR __attribute__ ((unused))
 #define DIRECT_READ(base, mask)         (*((base)+512))
 #define DIRECT_MODE_INPUT(base, mask)   (*((base)+640) = 0)
 #define DIRECT_MODE_OUTPUT(base, mask)  (*((base)+640) = 1)
@@ -84,14 +86,15 @@
 #define PIN_TO_BASEREG(pin)             (portOutputRegister(pin))
 #define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
 #define IO_REG_TYPE uint8_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, mask)         ((*((base)+16) & (mask)) ? 1 : 0)
 #define DIRECT_MODE_INPUT(base, mask)   (*((base)+20) &= ~(mask))
 #define DIRECT_MODE_OUTPUT(base, mask)  (*((base)+20) |= (mask))
 #define DIRECT_WRITE_LOW(base, mask)    (*((base)+8) = (mask))
 #define DIRECT_WRITE_HIGH(base, mask)   (*((base)+4) = (mask))
 
-#elif defined(__SAM3X8E__)
+#elif defined(__SAM3X8E__) || defined(__SAM3A8C__) || defined(__SAM3A4C__)
 // Arduino 1.5.1 may have a bug in delayMicroseconds() on Arduino Due.
 // http://arduino.cc/forum/index.php/topic,141030.msg1076268.html#msg1076268
 // If you have trouble with OneWire on Arduino Due, please check the
@@ -99,7 +102,8 @@
 #define PIN_TO_BASEREG(pin)             (&(digitalPinToPort(pin)->PIO_PER))
 #define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
 #define IO_REG_TYPE uint32_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, mask)         (((*((base)+15)) & (mask)) ? 1 : 0)
 #define DIRECT_MODE_INPUT(base, mask)   ((*((base)+5)) = (mask))
 #define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+4)) = (mask))
@@ -116,7 +120,8 @@
 #define PIN_TO_BASEREG(pin)             (portModeRegister(digitalPinToPort(pin)))
 #define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
 #define IO_REG_TYPE uint32_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, mask)         (((*(base+4)) & (mask)) ? 1 : 0)  //PORTX + 0x10
 #define DIRECT_MODE_INPUT(base, mask)   ((*(base+2)) = (mask))            //TRISXSET + 0x08
 #define DIRECT_MODE_OUTPUT(base, mask)  ((*(base+1)) = (mask))            //TRISXCLR + 0x04
@@ -124,21 +129,128 @@
 #define DIRECT_WRITE_HIGH(base, mask)   ((*(base+8+2)) = (mask))          //LATXSET + 0x28
 
 #elif defined(ARDUINO_ARCH_ESP8266)
+// Special note: I depend on the ESP community to maintain these definitions and
+// submit good pull requests.  I can not answer any ESP questions or help you
+// resolve any problems related to ESP chips.  Please do not contact me and please
+// DO NOT CREATE GITHUB ISSUES for ESP support.  All ESP questions must be asked
+// on ESP community forums.
 #define PIN_TO_BASEREG(pin)             ((volatile uint32_t*) GPO)
 #define PIN_TO_BITMASK(pin)             (1 << pin)
 #define IO_REG_TYPE uint32_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, mask)         ((GPI & (mask)) ? 1 : 0)    //GPIO_IN_ADDRESS
 #define DIRECT_MODE_INPUT(base, mask)   (GPE &= ~(mask))            //GPIO_ENABLE_W1TC_ADDRESS
 #define DIRECT_MODE_OUTPUT(base, mask)  (GPE |= (mask))             //GPIO_ENABLE_W1TS_ADDRESS
 #define DIRECT_WRITE_LOW(base, mask)    (GPOC = (mask))             //GPIO_OUT_W1TC_ADDRESS
 #define DIRECT_WRITE_HIGH(base, mask)   (GPOS = (mask))             //GPIO_OUT_W1TS_ADDRESS
 
+#elif defined(ARDUINO_ARCH_ESP32)
+#include <driver/rtc_io.h>
+#define PIN_TO_BASEREG(pin)             (0)
+#define PIN_TO_BITMASK(pin)             (pin)
+#define IO_REG_TYPE uint32_t
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
+
+static inline __attribute__((always_inline))
+IO_REG_TYPE directRead(IO_REG_TYPE pin)
+{
+    if ( pin < 32 )
+        return (GPIO.in >> pin) & 0x1;
+    else if ( pin < 40 )
+        return (GPIO.in1.val >> (pin - 32)) & 0x1;
+
+    return 0;
+}
+
+static inline __attribute__((always_inline))
+void directWriteLow(IO_REG_TYPE pin)
+{
+    if ( pin < 32 )
+        GPIO.out_w1tc = ((uint32_t)1 << pin);
+    else if ( pin < 34 )
+        GPIO.out1_w1tc.val = ((uint32_t)1 << (pin - 32));
+}
+
+static inline __attribute__((always_inline))
+void directWriteHigh(IO_REG_TYPE pin)
+{
+    if ( pin < 32 )
+        GPIO.out_w1ts = ((uint32_t)1 << pin);
+    else if ( pin < 34 )
+        GPIO.out1_w1ts.val = ((uint32_t)1 << (pin - 32));
+}
+
+static inline __attribute__((always_inline))
+void directModeInput(IO_REG_TYPE pin)
+{
+    if ( digitalPinIsValid(pin) )
+    {
+        uint32_t rtc_reg(rtc_gpio_desc[pin].reg);
+
+        if ( rtc_reg ) // RTC pins PULL settings
+        {
+            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].mux);
+            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].pullup | rtc_gpio_desc[pin].pulldown);
+        }
+
+        if ( pin < 32 )
+            GPIO.enable_w1tc = ((uint32_t)1 << pin);
+        else
+            GPIO.enable1_w1tc.val = ((uint32_t)1 << (pin - 32));
+
+        uint32_t pinFunction((uint32_t)2 << FUN_DRV_S); // what are the drivers?
+        pinFunction |= FUN_IE; // input enable but required for output as well?
+        pinFunction |= ((uint32_t)2 << MCU_SEL_S);
+
+        ESP_REG(DR_REG_IO_MUX_BASE + esp32_gpioMux[pin].reg) = pinFunction;
+
+        GPIO.pin[pin].val = 0;
+    }
+}
+
+static inline __attribute__((always_inline))
+void directModeOutput(IO_REG_TYPE pin)
+{
+    if ( digitalPinIsValid(pin) && pin <= 33 ) // pins above 33 can be only inputs
+    {
+        uint32_t rtc_reg(rtc_gpio_desc[pin].reg);
+
+        if ( rtc_reg ) // RTC pins PULL settings
+        {
+            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].mux);
+            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].pullup | rtc_gpio_desc[pin].pulldown);
+        }
+
+        if ( pin < 32 )
+            GPIO.enable_w1ts = ((uint32_t)1 << pin);
+        else // already validated to pins <= 33
+            GPIO.enable1_w1ts.val = ((uint32_t)1 << (pin - 32));
+
+        uint32_t pinFunction((uint32_t)2 << FUN_DRV_S); // what are the drivers?
+        pinFunction |= FUN_IE; // input enable but required for output as well?
+        pinFunction |= ((uint32_t)2 << MCU_SEL_S);
+
+        ESP_REG(DR_REG_IO_MUX_BASE + esp32_gpioMux[pin].reg) = pinFunction;
+
+        GPIO.pin[pin].val = 0;
+    }
+}
+
+#define DIRECT_READ(base, pin)          directRead(pin)
+#define DIRECT_WRITE_LOW(base, pin)     directWriteLow(pin)
+#define DIRECT_WRITE_HIGH(base, pin)    directWriteHigh(pin)
+#define DIRECT_MODE_INPUT(base, pin)    directModeInput(pin)
+#define DIRECT_MODE_OUTPUT(base, pin)   directModeOutput(pin)
+#warning "ESP32 OneWire testing"
+
 #elif defined(__SAMD21G18A__)
 #define PIN_TO_BASEREG(pin)             portModeRegister(digitalPinToPort(pin))
 #define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
 #define IO_REG_TYPE uint32_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, mask)         (((*((base)+8)) & (mask)) ? 1 : 0)
 #define DIRECT_MODE_INPUT(base, mask)   ((*((base)+1)) = (mask))
 #define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+2)) = (mask))
@@ -149,7 +261,8 @@
 #define PIN_TO_BASEREG(pin)             (0)
 #define PIN_TO_BITMASK(pin)             (pin)
 #define IO_REG_TYPE uint32_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, pin)          nrf_gpio_pin_read(pin)
 #define DIRECT_WRITE_LOW(base, pin)     nrf_gpio_pin_clear(pin)
 #define DIRECT_WRITE_HIGH(base, pin)    nrf_gpio_pin_set(pin)
@@ -174,7 +287,8 @@
 #define PIN_TO_BASEREG(pin)		((volatile uint32_t *)g_APinDescription[pin].ulGPIOBase)
 #define PIN_TO_BITMASK(pin)		pin
 #define IO_REG_TYPE			uint32_t
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 
 static inline __attribute__((always_inline))
 IO_REG_TYPE directRead(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
@@ -236,11 +350,71 @@ void directWriteHigh(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
 #define DIRECT_WRITE_LOW(base, pin)	directWriteLow(base, pin)
 #define DIRECT_WRITE_HIGH(base, pin)	directWriteHigh(base, pin)
 
+#elif defined(__riscv)
+
+/*
+ * Tested on highfive1
+ *
+ * Stable results are achieved operating in the
+ * two high speed modes of the highfive1.  It
+ * seems to be less reliable in slow mode.
+ */
+#define PIN_TO_BASEREG(pin)             (0)
+#define PIN_TO_BITMASK(pin)             digitalPinToBitMask(pin)
+#define IO_REG_TYPE uint32_t
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
+
+static inline __attribute__((always_inline))
+IO_REG_TYPE directRead(IO_REG_TYPE mask)
+{
+    return ((GPIO_REG(GPIO_INPUT_VAL) & mask) != 0) ? 1 : 0;
+}
+
+static inline __attribute__((always_inline))
+void directModeInput(IO_REG_TYPE mask)
+{
+    GPIO_REG(GPIO_OUTPUT_XOR)  &= ~mask;
+    GPIO_REG(GPIO_IOF_EN)      &= ~mask;
+
+    GPIO_REG(GPIO_INPUT_EN)  |=  mask;
+    GPIO_REG(GPIO_OUTPUT_EN) &= ~mask;
+}
+
+static inline __attribute__((always_inline))
+void directModeOutput(IO_REG_TYPE mask)
+{
+    GPIO_REG(GPIO_OUTPUT_XOR)  &= ~mask;
+    GPIO_REG(GPIO_IOF_EN)      &= ~mask;
+
+    GPIO_REG(GPIO_INPUT_EN)  &= ~mask;
+    GPIO_REG(GPIO_OUTPUT_EN) |=  mask;
+}
+
+static inline __attribute__((always_inline))
+void directWriteLow(IO_REG_TYPE mask)
+{
+    GPIO_REG(GPIO_OUTPUT_VAL) &= ~mask;
+}
+
+static inline __attribute__((always_inline))
+void directWriteHigh(IO_REG_TYPE mask)
+{
+    GPIO_REG(GPIO_OUTPUT_VAL) |= mask;
+}
+
+#define DIRECT_READ(base, mask)          directRead(mask)
+#define DIRECT_WRITE_LOW(base, mask)     directWriteLow(mask)
+#define DIRECT_WRITE_HIGH(base, mask)    directWriteHigh(mask)
+#define DIRECT_MODE_INPUT(base, mask)    directModeInput(mask)
+#define DIRECT_MODE_OUTPUT(base, mask)   directModeOutput(mask)
+
 #else
 #define PIN_TO_BASEREG(pin)             (0)
 #define PIN_TO_BITMASK(pin)             (pin)
 #define IO_REG_TYPE unsigned int
-#define IO_REG_ASM
+#define IO_REG_BASE_ATTR
+#define IO_REG_MASK_ATTR
 #define DIRECT_READ(base, pin)          digitalRead(pin)
 #define DIRECT_WRITE_LOW(base, pin)     digitalWrite(pin, LOW)
 #define DIRECT_WRITE_HIGH(base, pin)    digitalWrite(pin, HIGH)
diff --git a/src/vendor/arduino-DHT b/src/vendor/arduino-DHT
new file mode 160000
index 00000000..cd24ce3c
--- /dev/null
+++ b/src/vendor/arduino-DHT
@@ -0,0 +1 @@
+Subproject commit cd24ce3ca32fe0caf05d6c21565c8d5605860a08

From e5de289fc6f598a1d81e6420d97cb3575e8b6984 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 10:53:16 -0400
Subject: [PATCH 134/296] Remove OneWire submodule

---
 .gitmodules | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/.gitmodules b/.gitmodules
index 47bcd249..e0acf3cd 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -7,6 +7,3 @@
 [submodule "src/vendor/arduino-DHT"]
 	path = src/vendor/arduino-DHT
 	url = https://github.com/markruys/arduino-DHT.git
-[submodule "src/vendor/OneWire"]
-	path = src/vendor/OneWire
-	url = https://github.com/PaulStoffregen/OneWire.git

From dc71fc9dcb8c890dbdce13b558a27c08b87ccf8b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 10:54:00 -0400
Subject: [PATCH 135/296] Remove OneWire submodule files

---
 src/vendor/OneWire/OneWire.cpp | 597 ---------------------------------
 src/vendor/OneWire/OneWire.h   | 545 ------------------------------
 2 files changed, 1142 deletions(-)
 delete mode 100644 src/vendor/OneWire/OneWire.cpp
 delete mode 100644 src/vendor/OneWire/OneWire.h

diff --git a/src/vendor/OneWire/OneWire.cpp b/src/vendor/OneWire/OneWire.cpp
deleted file mode 100644
index 5c9945d5..00000000
--- a/src/vendor/OneWire/OneWire.cpp
+++ /dev/null
@@ -1,597 +0,0 @@
-/*
-Copyright (c) 2007, Jim Studt  (original old version - many contributors since)
-
-The latest version of this library may be found at:
-  http://www.pjrc.com/teensy/td_libs_OneWire.html
-
-OneWire has been maintained by Paul Stoffregen (paul@pjrc.com) since
-January 2010.
-
-DO NOT EMAIL for technical support, especially not for ESP chips!
-All project support questions must be posted on public forums
-relevant to the board or chips used.  If using Arduino, post on
-Arduino's forum.  If using ESP, post on the ESP community forums.
-There is ABSOLUTELY NO TECH SUPPORT BY PRIVATE EMAIL!
-
-Github's issue tracker for OneWire should be used only to report
-specific bugs.  DO NOT request project support via Github.  All
-project and tech support questions must be posted on forums, not
-github issues.  If you experience a problem and you are not
-absolutely sure it's an issue with the library, ask on a forum
-first.  Only use github to report issues after experts have
-confirmed the issue is with OneWire rather than your project.
-
-Back in 2010, OneWire was in need of many bug fixes, but had
-been abandoned the original author (Jim Studt).  None of the known
-contributors were interested in maintaining OneWire.  Paul typically
-works on OneWire every 6 to 12 months.  Patches usually wait that
-long.  If anyone is interested in more actively maintaining OneWire,
-please contact Paul (this is pretty much the only reason to use
-private email about OneWire).
-
-OneWire is now very mature code.  No changes other than adding
-definitions for newer hardware support are anticipated.
-
-Version 2.3:
-  Unknown chip fallback mode, Roger Clark
-  Teensy-LC compatibility, Paul Stoffregen
-  Search bug fix, Love Nystrom
-
-Version 2.2:
-  Teensy 3.0 compatibility, Paul Stoffregen, paul@pjrc.com
-  Arduino Due compatibility, http://arduino.cc/forum/index.php?topic=141030
-  Fix DS18B20 example negative temperature
-  Fix DS18B20 example's low res modes, Ken Butcher
-  Improve reset timing, Mark Tillotson
-  Add const qualifiers, Bertrik Sikken
-  Add initial value input to crc16, Bertrik Sikken
-  Add target_search() function, Scott Roberts
-
-Version 2.1:
-  Arduino 1.0 compatibility, Paul Stoffregen
-  Improve temperature example, Paul Stoffregen
-  DS250x_PROM example, Guillermo Lovato
-  PIC32 (chipKit) compatibility, Jason Dangel, dangel.jason AT gmail.com
-  Improvements from Glenn Trewitt:
-  - crc16() now works
-  - check_crc16() does all of calculation/checking work.
-  - Added read_bytes() and write_bytes(), to reduce tedious loops.
-  - Added ds2408 example.
-  Delete very old, out-of-date readme file (info is here)
-
-Version 2.0: Modifications by Paul Stoffregen, January 2010:
-http://www.pjrc.com/teensy/td_libs_OneWire.html
-  Search fix from Robin James
-    http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1238032295/27#27
-  Use direct optimized I/O in all cases
-  Disable interrupts during timing critical sections
-    (this solves many random communication errors)
-  Disable interrupts during read-modify-write I/O
-  Reduce RAM consumption by eliminating unnecessary
-    variables and trimming many to 8 bits
-  Optimize both crc8 - table version moved to flash
-
-Modified to work with larger numbers of devices - avoids loop.
-Tested in Arduino 11 alpha with 12 sensors.
-26 Sept 2008 -- Robin James
-http://www.arduino.cc/cgi-bin/yabb2/YaBB.pl?num=1238032295/27#27
-
-Updated to work with arduino-0008 and to include skip() as of
-2007/07/06. --RJL20
-
-Modified to calculate the 8-bit CRC directly, avoiding the need for
-the 256-byte lookup table to be loaded in RAM.  Tested in arduino-0010
--- Tom Pollard, Jan 23, 2008
-
-Jim Studt's original library was modified by Josh Larios.
-
-Tom Pollard, pollard@alum.mit.edu, contributed around May 20, 2008
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-Much of the code was inspired by Derek Yerger's code, though I don't
-think much of that remains.  In any event that was..
-    (copyleft) 2006 by Derek Yerger - Free to distribute freely.
-
-The CRC code was excerpted and inspired by the Dallas Semiconductor
-sample code bearing this copyright.
-//---------------------------------------------------------------------------
-// Copyright (C) 2000 Dallas Semiconductor Corporation, All Rights Reserved.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a
-// copy of this software and associated documentation files (the "Software"),
-// to deal in the Software without restriction, including without limitation
-// the rights to use, copy, modify, merge, publish, distribute, sublicense,
-// and/or sell copies of the Software, and to permit persons to whom the
-// Software is furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included
-// in all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-// MERCHANTABILITY,  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-// IN NO EVENT SHALL DALLAS SEMICONDUCTOR BE LIABLE FOR ANY CLAIM, DAMAGES
-// OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-// OTHER DEALINGS IN THE SOFTWARE.
-//
-// Except as contained in this notice, the name of Dallas Semiconductor
-// shall not be used except as stated in the Dallas Semiconductor
-// Branding Policy.
-//--------------------------------------------------------------------------
-*/
-
-#include "OneWire.h"
-
-
-OneWire::OneWire(uint8_t pin)
-{
-	pinMode(pin, INPUT);
-	bitmask = PIN_TO_BITMASK(pin);
-	baseReg = PIN_TO_BASEREG(pin);
-#if ONEWIRE_SEARCH
-	reset_search();
-#endif
-}
-
-
-// Perform the onewire reset function.  We will wait up to 250uS for
-// the bus to come high, if it doesn't then it is broken or shorted
-// and we return a 0;
-//
-// Returns 1 if a device asserted a presence pulse, 0 otherwise.
-//
-uint8_t OneWire::reset(void)
-{
-	IO_REG_TYPE mask IO_REG_MASK_ATTR = bitmask;
-	volatile IO_REG_TYPE *reg IO_REG_BASE_ATTR = baseReg;
-	uint8_t r;
-	uint8_t retries = 125;
-
-	noInterrupts();
-	DIRECT_MODE_INPUT(reg, mask);
-	interrupts();
-	// wait until the wire is high... just in case
-	do {
-		if (--retries == 0) return 0;
-		delayMicroseconds(2);
-	} while ( !DIRECT_READ(reg, mask));
-
-	noInterrupts();
-	DIRECT_WRITE_LOW(reg, mask);
-	DIRECT_MODE_OUTPUT(reg, mask);	// drive output low
-	interrupts();
-	delayMicroseconds(480);
-	noInterrupts();
-	DIRECT_MODE_INPUT(reg, mask);	// allow it to float
-	delayMicroseconds(70);
-	r = !DIRECT_READ(reg, mask);
-	interrupts();
-	delayMicroseconds(410);
-	return r;
-}
-
-//
-// Write a bit. Port and bit is used to cut lookup time and provide
-// more certain timing.
-//
-void OneWire::write_bit(uint8_t v)
-{
-	IO_REG_TYPE mask IO_REG_MASK_ATTR = bitmask;
-	volatile IO_REG_TYPE *reg IO_REG_BASE_ATTR = baseReg;
-
-	if (v & 1) {
-		noInterrupts();
-		DIRECT_WRITE_LOW(reg, mask);
-		DIRECT_MODE_OUTPUT(reg, mask);	// drive output low
-		delayMicroseconds(10);
-		DIRECT_WRITE_HIGH(reg, mask);	// drive output high
-		interrupts();
-		delayMicroseconds(55);
-	} else {
-		noInterrupts();
-		DIRECT_WRITE_LOW(reg, mask);
-		DIRECT_MODE_OUTPUT(reg, mask);	// drive output low
-		delayMicroseconds(65);
-		DIRECT_WRITE_HIGH(reg, mask);	// drive output high
-		interrupts();
-		delayMicroseconds(5);
-	}
-}
-
-//
-// Read a bit. Port and bit is used to cut lookup time and provide
-// more certain timing.
-//
-uint8_t OneWire::read_bit(void)
-{
-	IO_REG_TYPE mask IO_REG_MASK_ATTR = bitmask;
-	volatile IO_REG_TYPE *reg IO_REG_BASE_ATTR = baseReg;
-	uint8_t r;
-
-	noInterrupts();
-	DIRECT_MODE_OUTPUT(reg, mask);
-	DIRECT_WRITE_LOW(reg, mask);
-	delayMicroseconds(3);
-	DIRECT_MODE_INPUT(reg, mask);	// let pin float, pull up will raise
-	delayMicroseconds(10);
-	r = DIRECT_READ(reg, mask);
-	interrupts();
-	delayMicroseconds(53);
-	return r;
-}
-
-//
-// Write a byte. The writing code uses the active drivers to raise the
-// pin high, if you need power after the write (e.g. DS18S20 in
-// parasite power mode) then set 'power' to 1, otherwise the pin will
-// go tri-state at the end of the write to avoid heating in a short or
-// other mishap.
-//
-void OneWire::write(uint8_t v, uint8_t power /* = 0 */) {
-    uint8_t bitMask;
-
-    for (bitMask = 0x01; bitMask; bitMask <<= 1) {
-	OneWire::write_bit( (bitMask & v)?1:0);
-    }
-    if ( !power) {
-	noInterrupts();
-	DIRECT_MODE_INPUT(baseReg, bitmask);
-	DIRECT_WRITE_LOW(baseReg, bitmask);
-	interrupts();
-    }
-}
-
-void OneWire::write_bytes(const uint8_t *buf, uint16_t count, bool power /* = 0 */) {
-  for (uint16_t i = 0 ; i < count ; i++)
-    write(buf[i]);
-  if (!power) {
-    noInterrupts();
-    DIRECT_MODE_INPUT(baseReg, bitmask);
-    DIRECT_WRITE_LOW(baseReg, bitmask);
-    interrupts();
-  }
-}
-
-//
-// Read a byte
-//
-uint8_t OneWire::read() {
-    uint8_t bitMask;
-    uint8_t r = 0;
-
-    for (bitMask = 0x01; bitMask; bitMask <<= 1) {
-	if ( OneWire::read_bit()) r |= bitMask;
-    }
-    return r;
-}
-
-void OneWire::read_bytes(uint8_t *buf, uint16_t count) {
-  for (uint16_t i = 0 ; i < count ; i++)
-    buf[i] = read();
-}
-
-//
-// Do a ROM select
-//
-void OneWire::select(const uint8_t rom[8])
-{
-    uint8_t i;
-
-    write(0x55);           // Choose ROM
-
-    for (i = 0; i < 8; i++) write(rom[i]);
-}
-
-//
-// Do a ROM skip
-//
-void OneWire::skip()
-{
-    write(0xCC);           // Skip ROM
-}
-
-void OneWire::depower()
-{
-	noInterrupts();
-	DIRECT_MODE_INPUT(baseReg, bitmask);
-	interrupts();
-}
-
-#if ONEWIRE_SEARCH
-
-//
-// You need to use this function to start a search again from the beginning.
-// You do not need to do it for the first search, though you could.
-//
-void OneWire::reset_search()
-{
-  // reset the search state
-  LastDiscrepancy = 0;
-  LastDeviceFlag = FALSE;
-  LastFamilyDiscrepancy = 0;
-  for(int i = 7; ; i--) {
-    ROM_NO[i] = 0;
-    if ( i == 0) break;
-  }
-}
-
-// Setup the search to find the device type 'family_code' on the next call
-// to search(*newAddr) if it is present.
-//
-void OneWire::target_search(uint8_t family_code)
-{
-   // set the search state to find SearchFamily type devices
-   ROM_NO[0] = family_code;
-   for (uint8_t i = 1; i < 8; i++)
-      ROM_NO[i] = 0;
-   LastDiscrepancy = 64;
-   LastFamilyDiscrepancy = 0;
-   LastDeviceFlag = FALSE;
-}
-
-//
-// Perform a search. If this function returns a '1' then it has
-// enumerated the next device and you may retrieve the ROM from the
-// OneWire::address variable. If there are no devices, no further
-// devices, or something horrible happens in the middle of the
-// enumeration then a 0 is returned.  If a new device is found then
-// its address is copied to newAddr.  Use OneWire::reset_search() to
-// start over.
-//
-// --- Replaced by the one from the Dallas Semiconductor web site ---
-//--------------------------------------------------------------------------
-// Perform the 1-Wire Search Algorithm on the 1-Wire bus using the existing
-// search state.
-// Return TRUE  : device found, ROM number in ROM_NO buffer
-//        FALSE : device not found, end of search
-//
-uint8_t OneWire::search(uint8_t *newAddr, bool search_mode /* = true */)
-{
-   uint8_t id_bit_number;
-   uint8_t last_zero, rom_byte_number, search_result;
-   uint8_t id_bit, cmp_id_bit;
-
-   unsigned char rom_byte_mask, search_direction;
-
-   // initialize for search
-   id_bit_number = 1;
-   last_zero = 0;
-   rom_byte_number = 0;
-   rom_byte_mask = 1;
-   search_result = 0;
-
-   // if the last call was not the last one
-   if (!LastDeviceFlag)
-   {
-      // 1-Wire reset
-      if (!reset())
-      {
-         // reset the search
-         LastDiscrepancy = 0;
-         LastDeviceFlag = FALSE;
-         LastFamilyDiscrepancy = 0;
-         return FALSE;
-      }
-
-      // issue the search command
-      if (search_mode == true) {
-        write(0xF0);   // NORMAL SEARCH
-      } else {
-        write(0xEC);   // CONDITIONAL SEARCH
-      }
-
-      // loop to do the search
-      do
-      {
-         // read a bit and its complement
-         id_bit = read_bit();
-         cmp_id_bit = read_bit();
-
-         // check for no devices on 1-wire
-         if ((id_bit == 1) && (cmp_id_bit == 1))
-            break;
-         else
-         {
-            // all devices coupled have 0 or 1
-            if (id_bit != cmp_id_bit)
-               search_direction = id_bit;  // bit write value for search
-            else
-            {
-               // if this discrepancy if before the Last Discrepancy
-               // on a previous next then pick the same as last time
-               if (id_bit_number < LastDiscrepancy)
-                  search_direction = ((ROM_NO[rom_byte_number] & rom_byte_mask) > 0);
-               else
-                  // if equal to last pick 1, if not then pick 0
-                  search_direction = (id_bit_number == LastDiscrepancy);
-
-               // if 0 was picked then record its position in LastZero
-               if (search_direction == 0)
-               {
-                  last_zero = id_bit_number;
-
-                  // check for Last discrepancy in family
-                  if (last_zero < 9)
-                     LastFamilyDiscrepancy = last_zero;
-               }
-            }
-
-            // set or clear the bit in the ROM byte rom_byte_number
-            // with mask rom_byte_mask
-            if (search_direction == 1)
-              ROM_NO[rom_byte_number] |= rom_byte_mask;
-            else
-              ROM_NO[rom_byte_number] &= ~rom_byte_mask;
-
-            // serial number search direction write bit
-            write_bit(search_direction);
-
-            // increment the byte counter id_bit_number
-            // and shift the mask rom_byte_mask
-            id_bit_number++;
-            rom_byte_mask <<= 1;
-
-            // if the mask is 0 then go to new SerialNum byte rom_byte_number and reset mask
-            if (rom_byte_mask == 0)
-            {
-                rom_byte_number++;
-                rom_byte_mask = 1;
-            }
-         }
-      }
-      while(rom_byte_number < 8);  // loop until through all ROM bytes 0-7
-
-      // if the search was successful then
-      if (!(id_bit_number < 65))
-      {
-         // search successful so set LastDiscrepancy,LastDeviceFlag,search_result
-         LastDiscrepancy = last_zero;
-
-         // check for last device
-         if (LastDiscrepancy == 0)
-            LastDeviceFlag = TRUE;
-
-         search_result = TRUE;
-      }
-   }
-
-   // if no device found then reset counters so next 'search' will be like a first
-   if (!search_result || !ROM_NO[0])
-   {
-      LastDiscrepancy = 0;
-      LastDeviceFlag = FALSE;
-      LastFamilyDiscrepancy = 0;
-      search_result = FALSE;
-   } else {
-      for (int i = 0; i < 8; i++) newAddr[i] = ROM_NO[i];
-   }
-   return search_result;
-  }
-
-#endif
-
-#if ONEWIRE_CRC
-// The 1-Wire CRC scheme is described in Maxim Application Note 27:
-// "Understanding and Using Cyclic Redundancy Checks with Maxim iButton Products"
-//
-
-#if ONEWIRE_CRC8_TABLE
-// This table comes from Dallas sample code where it is freely reusable,
-// though Copyright (C) 2000 Dallas Semiconductor Corporation
-static const uint8_t PROGMEM dscrc_table[] = {
-      0, 94,188,226, 97, 63,221,131,194,156,126, 32,163,253, 31, 65,
-    157,195, 33,127,252,162, 64, 30, 95,  1,227,189, 62, 96,130,220,
-     35,125,159,193, 66, 28,254,160,225,191, 93,  3,128,222, 60, 98,
-    190,224,  2, 92,223,129, 99, 61,124, 34,192,158, 29, 67,161,255,
-     70, 24,250,164, 39,121,155,197,132,218, 56,102,229,187, 89,  7,
-    219,133,103, 57,186,228,  6, 88, 25, 71,165,251,120, 38,196,154,
-    101, 59,217,135,  4, 90,184,230,167,249, 27, 69,198,152,122, 36,
-    248,166, 68, 26,153,199, 37,123, 58,100,134,216, 91,  5,231,185,
-    140,210, 48,110,237,179, 81, 15, 78, 16,242,172, 47,113,147,205,
-     17, 79,173,243,112, 46,204,146,211,141,111, 49,178,236, 14, 80,
-    175,241, 19, 77,206,144,114, 44,109, 51,209,143, 12, 82,176,238,
-     50,108,142,208, 83, 13,239,177,240,174, 76, 18,145,207, 45,115,
-    202,148,118, 40,171,245, 23, 73,  8, 86,180,234,105, 55,213,139,
-     87,  9,235,181, 54,104,138,212,149,203, 41,119,244,170, 72, 22,
-    233,183, 85, 11,136,214, 52,106, 43,117,151,201, 74, 20,246,168,
-    116, 42,200,150, 21, 75,169,247,182,232, 10, 84,215,137,107, 53};
-
-//
-// Compute a Dallas Semiconductor 8 bit CRC. These show up in the ROM
-// and the registers.  (note: this might better be done without to
-// table, it would probably be smaller and certainly fast enough
-// compared to all those delayMicrosecond() calls.  But I got
-// confused, so I use this table from the examples.)
-//
-uint8_t OneWire::crc8(const uint8_t *addr, uint8_t len)
-{
-	uint8_t crc = 0;
-
-	while (len--) {
-		crc = pgm_read_byte(dscrc_table + (crc ^ *addr++));
-	}
-	return crc;
-}
-#else
-//
-// Compute a Dallas Semiconductor 8 bit CRC directly.
-// this is much slower, but much smaller, than the lookup table.
-//
-uint8_t OneWire::crc8(const uint8_t *addr, uint8_t len)
-{
-	uint8_t crc = 0;
-
-	while (len--) {
-#if defined(__AVR__)
-		crc = _crc_ibutton_update(crc, *addr++);
-#else
-		uint8_t inbyte = *addr++;
-		for (uint8_t i = 8; i; i--) {
-			uint8_t mix = (crc ^ inbyte) & 0x01;
-			crc >>= 1;
-			if (mix) crc ^= 0x8C;
-			inbyte >>= 1;
-		}
-#endif
-	}
-	return crc;
-}
-#endif
-
-#if ONEWIRE_CRC16
-bool OneWire::check_crc16(const uint8_t* input, uint16_t len, const uint8_t* inverted_crc, uint16_t crc)
-{
-    crc = ~crc16(input, len, crc);
-    return (crc & 0xFF) == inverted_crc[0] && (crc >> 8) == inverted_crc[1];
-}
-
-uint16_t OneWire::crc16(const uint8_t* input, uint16_t len, uint16_t crc)
-{
-#if defined(__AVR__)
-    for (uint16_t i = 0 ; i < len ; i++) {
-        crc = _crc16_update(crc, input[i]);
-    }
-#else
-    static const uint8_t oddparity[16] =
-        { 0, 1, 1, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0 };
-
-    for (uint16_t i = 0 ; i < len ; i++) {
-      // Even though we're just copying a byte from the input,
-      // we'll be doing 16-bit computation with it.
-      uint16_t cdata = input[i];
-      cdata = (cdata ^ crc) & 0xff;
-      crc >>= 8;
-
-      if (oddparity[cdata & 0x0F] ^ oddparity[cdata >> 4])
-          crc ^= 0xC001;
-
-      cdata <<= 6;
-      crc ^= cdata;
-      cdata <<= 1;
-      crc ^= cdata;
-    }
-#endif
-    return crc;
-}
-#endif
-
-#endif
diff --git a/src/vendor/OneWire/OneWire.h b/src/vendor/OneWire/OneWire.h
deleted file mode 100644
index c394f1d0..00000000
--- a/src/vendor/OneWire/OneWire.h
+++ /dev/null
@@ -1,545 +0,0 @@
-#ifndef OneWire_h
-#define OneWire_h
-
-#include <inttypes.h>
-
-#if defined(__AVR__)
-#include <util/crc16.h>
-#endif
-
-#if ARDUINO >= 100
-#include "Arduino.h"       // for delayMicroseconds, digitalPinToBitMask, etc
-#else
-#include "WProgram.h"      // for delayMicroseconds
-#include "pins_arduino.h"  // for digitalPinToBitMask, etc
-#endif
-
-// You can exclude certain features from OneWire.  In theory, this
-// might save some space.  In practice, the compiler automatically
-// removes unused code (technically, the linker, using -fdata-sections
-// and -ffunction-sections when compiling, and Wl,--gc-sections
-// when linking), so most of these will not result in any code size
-// reduction.  Well, unless you try to use the missing features
-// and redesign your program to not need them!  ONEWIRE_CRC8_TABLE
-// is the exception, because it selects a fast but large algorithm
-// or a small but slow algorithm.
-
-// you can exclude onewire_search by defining that to 0
-#ifndef ONEWIRE_SEARCH
-#define ONEWIRE_SEARCH 1
-#endif
-
-// You can exclude CRC checks altogether by defining this to 0
-#ifndef ONEWIRE_CRC
-#define ONEWIRE_CRC 1
-#endif
-
-// Select the table-lookup method of computing the 8-bit CRC
-// by setting this to 1.  The lookup table enlarges code size by
-// about 250 bytes.  It does NOT consume RAM (but did in very
-// old versions of OneWire).  If you disable this, a slower
-// but very compact algorithm is used.
-#ifndef ONEWIRE_CRC8_TABLE
-#define ONEWIRE_CRC8_TABLE 1
-#endif
-
-// You can allow 16-bit CRC checks by defining this to 1
-// (Note that ONEWIRE_CRC must also be 1.)
-#ifndef ONEWIRE_CRC16
-#define ONEWIRE_CRC16 1
-#endif
-
-#ifndef FALSE
-#define FALSE 0
-#endif
-#ifndef TRUE
-#define TRUE  1
-#endif
-
-// Platform specific I/O definitions
-
-#if defined(__AVR__)
-#define PIN_TO_BASEREG(pin)             (portInputRegister(digitalPinToPort(pin)))
-#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
-#define IO_REG_TYPE uint8_t
-#define IO_REG_BASE_ATTR asm("r30")
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, mask)         (((*(base)) & (mask)) ? 1 : 0)
-#define DIRECT_MODE_INPUT(base, mask)   ((*((base)+1)) &= ~(mask))
-#define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+1)) |= (mask))
-#define DIRECT_WRITE_LOW(base, mask)    ((*((base)+2)) &= ~(mask))
-#define DIRECT_WRITE_HIGH(base, mask)   ((*((base)+2)) |= (mask))
-
-#elif defined(__MK20DX128__) || defined(__MK20DX256__) || defined(__MK66FX1M0__) || defined(__MK64FX512__)
-#define PIN_TO_BASEREG(pin)             (portOutputRegister(pin))
-#define PIN_TO_BITMASK(pin)             (1)
-#define IO_REG_TYPE uint8_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR __attribute__ ((unused))
-#define DIRECT_READ(base, mask)         (*((base)+512))
-#define DIRECT_MODE_INPUT(base, mask)   (*((base)+640) = 0)
-#define DIRECT_MODE_OUTPUT(base, mask)  (*((base)+640) = 1)
-#define DIRECT_WRITE_LOW(base, mask)    (*((base)+256) = 1)
-#define DIRECT_WRITE_HIGH(base, mask)   (*((base)+128) = 1)
-
-#elif defined(__MKL26Z64__)
-#define PIN_TO_BASEREG(pin)             (portOutputRegister(pin))
-#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
-#define IO_REG_TYPE uint8_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, mask)         ((*((base)+16) & (mask)) ? 1 : 0)
-#define DIRECT_MODE_INPUT(base, mask)   (*((base)+20) &= ~(mask))
-#define DIRECT_MODE_OUTPUT(base, mask)  (*((base)+20) |= (mask))
-#define DIRECT_WRITE_LOW(base, mask)    (*((base)+8) = (mask))
-#define DIRECT_WRITE_HIGH(base, mask)   (*((base)+4) = (mask))
-
-#elif defined(__SAM3X8E__) || defined(__SAM3A8C__) || defined(__SAM3A4C__)
-// Arduino 1.5.1 may have a bug in delayMicroseconds() on Arduino Due.
-// http://arduino.cc/forum/index.php/topic,141030.msg1076268.html#msg1076268
-// If you have trouble with OneWire on Arduino Due, please check the
-// status of delayMicroseconds() before reporting a bug in OneWire!
-#define PIN_TO_BASEREG(pin)             (&(digitalPinToPort(pin)->PIO_PER))
-#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
-#define IO_REG_TYPE uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, mask)         (((*((base)+15)) & (mask)) ? 1 : 0)
-#define DIRECT_MODE_INPUT(base, mask)   ((*((base)+5)) = (mask))
-#define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+4)) = (mask))
-#define DIRECT_WRITE_LOW(base, mask)    ((*((base)+13)) = (mask))
-#define DIRECT_WRITE_HIGH(base, mask)   ((*((base)+12)) = (mask))
-#ifndef PROGMEM
-#define PROGMEM
-#endif
-#ifndef pgm_read_byte
-#define pgm_read_byte(addr) (*(const uint8_t *)(addr))
-#endif
-
-#elif defined(__PIC32MX__)
-#define PIN_TO_BASEREG(pin)             (portModeRegister(digitalPinToPort(pin)))
-#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
-#define IO_REG_TYPE uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, mask)         (((*(base+4)) & (mask)) ? 1 : 0)  //PORTX + 0x10
-#define DIRECT_MODE_INPUT(base, mask)   ((*(base+2)) = (mask))            //TRISXSET + 0x08
-#define DIRECT_MODE_OUTPUT(base, mask)  ((*(base+1)) = (mask))            //TRISXCLR + 0x04
-#define DIRECT_WRITE_LOW(base, mask)    ((*(base+8+1)) = (mask))          //LATXCLR  + 0x24
-#define DIRECT_WRITE_HIGH(base, mask)   ((*(base+8+2)) = (mask))          //LATXSET + 0x28
-
-#elif defined(ARDUINO_ARCH_ESP8266)
-// Special note: I depend on the ESP community to maintain these definitions and
-// submit good pull requests.  I can not answer any ESP questions or help you
-// resolve any problems related to ESP chips.  Please do not contact me and please
-// DO NOT CREATE GITHUB ISSUES for ESP support.  All ESP questions must be asked
-// on ESP community forums.
-#define PIN_TO_BASEREG(pin)             ((volatile uint32_t*) GPO)
-#define PIN_TO_BITMASK(pin)             (1 << pin)
-#define IO_REG_TYPE uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, mask)         ((GPI & (mask)) ? 1 : 0)    //GPIO_IN_ADDRESS
-#define DIRECT_MODE_INPUT(base, mask)   (GPE &= ~(mask))            //GPIO_ENABLE_W1TC_ADDRESS
-#define DIRECT_MODE_OUTPUT(base, mask)  (GPE |= (mask))             //GPIO_ENABLE_W1TS_ADDRESS
-#define DIRECT_WRITE_LOW(base, mask)    (GPOC = (mask))             //GPIO_OUT_W1TC_ADDRESS
-#define DIRECT_WRITE_HIGH(base, mask)   (GPOS = (mask))             //GPIO_OUT_W1TS_ADDRESS
-
-#elif defined(ARDUINO_ARCH_ESP32)
-#include <driver/rtc_io.h>
-#define PIN_TO_BASEREG(pin)             (0)
-#define PIN_TO_BITMASK(pin)             (pin)
-#define IO_REG_TYPE uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-
-static inline __attribute__((always_inline))
-IO_REG_TYPE directRead(IO_REG_TYPE pin)
-{
-    if ( pin < 32 )
-        return (GPIO.in >> pin) & 0x1;
-    else if ( pin < 40 )
-        return (GPIO.in1.val >> (pin - 32)) & 0x1;
-
-    return 0;
-}
-
-static inline __attribute__((always_inline))
-void directWriteLow(IO_REG_TYPE pin)
-{
-    if ( pin < 32 )
-        GPIO.out_w1tc = ((uint32_t)1 << pin);
-    else if ( pin < 34 )
-        GPIO.out1_w1tc.val = ((uint32_t)1 << (pin - 32));
-}
-
-static inline __attribute__((always_inline))
-void directWriteHigh(IO_REG_TYPE pin)
-{
-    if ( pin < 32 )
-        GPIO.out_w1ts = ((uint32_t)1 << pin);
-    else if ( pin < 34 )
-        GPIO.out1_w1ts.val = ((uint32_t)1 << (pin - 32));
-}
-
-static inline __attribute__((always_inline))
-void directModeInput(IO_REG_TYPE pin)
-{
-    if ( digitalPinIsValid(pin) )
-    {
-        uint32_t rtc_reg(rtc_gpio_desc[pin].reg);
-
-        if ( rtc_reg ) // RTC pins PULL settings
-        {
-            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].mux);
-            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].pullup | rtc_gpio_desc[pin].pulldown);
-        }
-
-        if ( pin < 32 )
-            GPIO.enable_w1tc = ((uint32_t)1 << pin);
-        else
-            GPIO.enable1_w1tc.val = ((uint32_t)1 << (pin - 32));
-
-        uint32_t pinFunction((uint32_t)2 << FUN_DRV_S); // what are the drivers?
-        pinFunction |= FUN_IE; // input enable but required for output as well?
-        pinFunction |= ((uint32_t)2 << MCU_SEL_S);
-
-        ESP_REG(DR_REG_IO_MUX_BASE + esp32_gpioMux[pin].reg) = pinFunction;
-
-        GPIO.pin[pin].val = 0;
-    }
-}
-
-static inline __attribute__((always_inline))
-void directModeOutput(IO_REG_TYPE pin)
-{
-    if ( digitalPinIsValid(pin) && pin <= 33 ) // pins above 33 can be only inputs
-    {
-        uint32_t rtc_reg(rtc_gpio_desc[pin].reg);
-
-        if ( rtc_reg ) // RTC pins PULL settings
-        {
-            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].mux);
-            ESP_REG(rtc_reg) = ESP_REG(rtc_reg) & ~(rtc_gpio_desc[pin].pullup | rtc_gpio_desc[pin].pulldown);
-        }
-
-        if ( pin < 32 )
-            GPIO.enable_w1ts = ((uint32_t)1 << pin);
-        else // already validated to pins <= 33
-            GPIO.enable1_w1ts.val = ((uint32_t)1 << (pin - 32));
-
-        uint32_t pinFunction((uint32_t)2 << FUN_DRV_S); // what are the drivers?
-        pinFunction |= FUN_IE; // input enable but required for output as well?
-        pinFunction |= ((uint32_t)2 << MCU_SEL_S);
-
-        ESP_REG(DR_REG_IO_MUX_BASE + esp32_gpioMux[pin].reg) = pinFunction;
-
-        GPIO.pin[pin].val = 0;
-    }
-}
-
-#define DIRECT_READ(base, pin)          directRead(pin)
-#define DIRECT_WRITE_LOW(base, pin)     directWriteLow(pin)
-#define DIRECT_WRITE_HIGH(base, pin)    directWriteHigh(pin)
-#define DIRECT_MODE_INPUT(base, pin)    directModeInput(pin)
-#define DIRECT_MODE_OUTPUT(base, pin)   directModeOutput(pin)
-#warning "ESP32 OneWire testing"
-
-#elif defined(__SAMD21G18A__)
-#define PIN_TO_BASEREG(pin)             portModeRegister(digitalPinToPort(pin))
-#define PIN_TO_BITMASK(pin)             (digitalPinToBitMask(pin))
-#define IO_REG_TYPE uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, mask)         (((*((base)+8)) & (mask)) ? 1 : 0)
-#define DIRECT_MODE_INPUT(base, mask)   ((*((base)+1)) = (mask))
-#define DIRECT_MODE_OUTPUT(base, mask)  ((*((base)+2)) = (mask))
-#define DIRECT_WRITE_LOW(base, mask)    ((*((base)+5)) = (mask))
-#define DIRECT_WRITE_HIGH(base, mask)   ((*((base)+6)) = (mask))
-
-#elif defined(RBL_NRF51822)
-#define PIN_TO_BASEREG(pin)             (0)
-#define PIN_TO_BITMASK(pin)             (pin)
-#define IO_REG_TYPE uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, pin)          nrf_gpio_pin_read(pin)
-#define DIRECT_WRITE_LOW(base, pin)     nrf_gpio_pin_clear(pin)
-#define DIRECT_WRITE_HIGH(base, pin)    nrf_gpio_pin_set(pin)
-#define DIRECT_MODE_INPUT(base, pin)    nrf_gpio_cfg_input(pin, NRF_GPIO_PIN_NOPULL)
-#define DIRECT_MODE_OUTPUT(base, pin)   nrf_gpio_cfg_output(pin)
-
-#elif defined(__arc__) /* Arduino101/Genuino101 specifics */
-
-#include "scss_registers.h"
-#include "portable.h"
-#include "avr/pgmspace.h"
-
-#define GPIO_ID(pin)			(g_APinDescription[pin].ulGPIOId)
-#define GPIO_TYPE(pin)			(g_APinDescription[pin].ulGPIOType)
-#define GPIO_BASE(pin)			(g_APinDescription[pin].ulGPIOBase)
-#define DIR_OFFSET_SS			0x01
-#define DIR_OFFSET_SOC			0x04
-#define EXT_PORT_OFFSET_SS		0x0A
-#define EXT_PORT_OFFSET_SOC		0x50
-
-/* GPIO registers base address */
-#define PIN_TO_BASEREG(pin)		((volatile uint32_t *)g_APinDescription[pin].ulGPIOBase)
-#define PIN_TO_BITMASK(pin)		pin
-#define IO_REG_TYPE			uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-
-static inline __attribute__((always_inline))
-IO_REG_TYPE directRead(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
-{
-    IO_REG_TYPE ret;
-    if (SS_GPIO == GPIO_TYPE(pin)) {
-        ret = READ_ARC_REG(((IO_REG_TYPE)base + EXT_PORT_OFFSET_SS));
-    } else {
-        ret = MMIO_REG_VAL_FROM_BASE((IO_REG_TYPE)base, EXT_PORT_OFFSET_SOC);
-    }
-    return ((ret >> GPIO_ID(pin)) & 0x01);
-}
-
-static inline __attribute__((always_inline))
-void directModeInput(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
-{
-    if (SS_GPIO == GPIO_TYPE(pin)) {
-        WRITE_ARC_REG(READ_ARC_REG((((IO_REG_TYPE)base) + DIR_OFFSET_SS)) & ~(0x01 << GPIO_ID(pin)),
-			((IO_REG_TYPE)(base) + DIR_OFFSET_SS));
-    } else {
-        MMIO_REG_VAL_FROM_BASE((IO_REG_TYPE)base, DIR_OFFSET_SOC) &= ~(0x01 << GPIO_ID(pin));
-    }
-}
-
-static inline __attribute__((always_inline))
-void directModeOutput(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
-{
-    if (SS_GPIO == GPIO_TYPE(pin)) {
-        WRITE_ARC_REG(READ_ARC_REG(((IO_REG_TYPE)(base) + DIR_OFFSET_SS)) | (0x01 << GPIO_ID(pin)),
-			((IO_REG_TYPE)(base) + DIR_OFFSET_SS));
-    } else {
-        MMIO_REG_VAL_FROM_BASE((IO_REG_TYPE)base, DIR_OFFSET_SOC) |= (0x01 << GPIO_ID(pin));
-    }
-}
-
-static inline __attribute__((always_inline))
-void directWriteLow(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
-{
-    if (SS_GPIO == GPIO_TYPE(pin)) {
-        WRITE_ARC_REG(READ_ARC_REG(base) & ~(0x01 << GPIO_ID(pin)), base);
-    } else {
-        MMIO_REG_VAL(base) &= ~(0x01 << GPIO_ID(pin));
-    }
-}
-
-static inline __attribute__((always_inline))
-void directWriteHigh(volatile IO_REG_TYPE *base, IO_REG_TYPE pin)
-{
-    if (SS_GPIO == GPIO_TYPE(pin)) {
-        WRITE_ARC_REG(READ_ARC_REG(base) | (0x01 << GPIO_ID(pin)), base);
-    } else {
-        MMIO_REG_VAL(base) |= (0x01 << GPIO_ID(pin));
-    }
-}
-
-#define DIRECT_READ(base, pin)		directRead(base, pin)
-#define DIRECT_MODE_INPUT(base, pin)	directModeInput(base, pin)
-#define DIRECT_MODE_OUTPUT(base, pin)	directModeOutput(base, pin)
-#define DIRECT_WRITE_LOW(base, pin)	directWriteLow(base, pin)
-#define DIRECT_WRITE_HIGH(base, pin)	directWriteHigh(base, pin)
-
-#elif defined(__riscv)
-
-/*
- * Tested on highfive1
- *
- * Stable results are achieved operating in the
- * two high speed modes of the highfive1.  It
- * seems to be less reliable in slow mode.
- */
-#define PIN_TO_BASEREG(pin)             (0)
-#define PIN_TO_BITMASK(pin)             digitalPinToBitMask(pin)
-#define IO_REG_TYPE uint32_t
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-
-static inline __attribute__((always_inline))
-IO_REG_TYPE directRead(IO_REG_TYPE mask)
-{
-    return ((GPIO_REG(GPIO_INPUT_VAL) & mask) != 0) ? 1 : 0;
-}
-
-static inline __attribute__((always_inline))
-void directModeInput(IO_REG_TYPE mask)
-{
-    GPIO_REG(GPIO_OUTPUT_XOR)  &= ~mask;
-    GPIO_REG(GPIO_IOF_EN)      &= ~mask;
-
-    GPIO_REG(GPIO_INPUT_EN)  |=  mask;
-    GPIO_REG(GPIO_OUTPUT_EN) &= ~mask;
-}
-
-static inline __attribute__((always_inline))
-void directModeOutput(IO_REG_TYPE mask)
-{
-    GPIO_REG(GPIO_OUTPUT_XOR)  &= ~mask;
-    GPIO_REG(GPIO_IOF_EN)      &= ~mask;
-
-    GPIO_REG(GPIO_INPUT_EN)  &= ~mask;
-    GPIO_REG(GPIO_OUTPUT_EN) |=  mask;
-}
-
-static inline __attribute__((always_inline))
-void directWriteLow(IO_REG_TYPE mask)
-{
-    GPIO_REG(GPIO_OUTPUT_VAL) &= ~mask;
-}
-
-static inline __attribute__((always_inline))
-void directWriteHigh(IO_REG_TYPE mask)
-{
-    GPIO_REG(GPIO_OUTPUT_VAL) |= mask;
-}
-
-#define DIRECT_READ(base, mask)          directRead(mask)
-#define DIRECT_WRITE_LOW(base, mask)     directWriteLow(mask)
-#define DIRECT_WRITE_HIGH(base, mask)    directWriteHigh(mask)
-#define DIRECT_MODE_INPUT(base, mask)    directModeInput(mask)
-#define DIRECT_MODE_OUTPUT(base, mask)   directModeOutput(mask)
-
-#else
-#define PIN_TO_BASEREG(pin)             (0)
-#define PIN_TO_BITMASK(pin)             (pin)
-#define IO_REG_TYPE unsigned int
-#define IO_REG_BASE_ATTR
-#define IO_REG_MASK_ATTR
-#define DIRECT_READ(base, pin)          digitalRead(pin)
-#define DIRECT_WRITE_LOW(base, pin)     digitalWrite(pin, LOW)
-#define DIRECT_WRITE_HIGH(base, pin)    digitalWrite(pin, HIGH)
-#define DIRECT_MODE_INPUT(base, pin)    pinMode(pin,INPUT)
-#define DIRECT_MODE_OUTPUT(base, pin)   pinMode(pin,OUTPUT)
-#warning "OneWire. Fallback mode. Using API calls for pinMode,digitalRead and digitalWrite. Operation of this library is not guaranteed on this architecture."
-
-#endif
-
-
-class OneWire
-{
-  private:
-    IO_REG_TYPE bitmask;
-    volatile IO_REG_TYPE *baseReg;
-
-#if ONEWIRE_SEARCH
-    // global search state
-    unsigned char ROM_NO[8];
-    uint8_t LastDiscrepancy;
-    uint8_t LastFamilyDiscrepancy;
-    uint8_t LastDeviceFlag;
-#endif
-
-  public:
-    OneWire( uint8_t pin);
-
-    // Perform a 1-Wire reset cycle. Returns 1 if a device responds
-    // with a presence pulse.  Returns 0 if there is no device or the
-    // bus is shorted or otherwise held low for more than 250uS
-    uint8_t reset(void);
-
-    // Issue a 1-Wire rom select command, you do the reset first.
-    void select(const uint8_t rom[8]);
-
-    // Issue a 1-Wire rom skip command, to address all on bus.
-    void skip(void);
-
-    // Write a byte. If 'power' is one then the wire is held high at
-    // the end for parasitically powered devices. You are responsible
-    // for eventually depowering it by calling depower() or doing
-    // another read or write.
-    void write(uint8_t v, uint8_t power = 0);
-
-    void write_bytes(const uint8_t *buf, uint16_t count, bool power = 0);
-
-    // Read a byte.
-    uint8_t read(void);
-
-    void read_bytes(uint8_t *buf, uint16_t count);
-
-    // Write a bit. The bus is always left powered at the end, see
-    // note in write() about that.
-    void write_bit(uint8_t v);
-
-    // Read a bit.
-    uint8_t read_bit(void);
-
-    // Stop forcing power onto the bus. You only need to do this if
-    // you used the 'power' flag to write() or used a write_bit() call
-    // and aren't about to do another read or write. You would rather
-    // not leave this powered if you don't have to, just in case
-    // someone shorts your bus.
-    void depower(void);
-
-#if ONEWIRE_SEARCH
-    // Clear the search state so that if will start from the beginning again.
-    void reset_search();
-
-    // Setup the search to find the device type 'family_code' on the next call
-    // to search(*newAddr) if it is present.
-    void target_search(uint8_t family_code);
-
-    // Look for the next device. Returns 1 if a new address has been
-    // returned. A zero might mean that the bus is shorted, there are
-    // no devices, or you have already retrieved all of them.  It
-    // might be a good idea to check the CRC to make sure you didn't
-    // get garbage.  The order is deterministic. You will always get
-    // the same devices in the same order.
-    uint8_t search(uint8_t *newAddr, bool search_mode = true);
-#endif
-
-#if ONEWIRE_CRC
-    // Compute a Dallas Semiconductor 8 bit CRC, these are used in the
-    // ROM and scratchpad registers.
-    static uint8_t crc8(const uint8_t *addr, uint8_t len);
-
-#if ONEWIRE_CRC16
-    // Compute the 1-Wire CRC16 and compare it against the received CRC.
-    // Example usage (reading a DS2408):
-    //    // Put everything in a buffer so we can compute the CRC easily.
-    //    uint8_t buf[13];
-    //    buf[0] = 0xF0;    // Read PIO Registers
-    //    buf[1] = 0x88;    // LSB address
-    //    buf[2] = 0x00;    // MSB address
-    //    WriteBytes(net, buf, 3);    // Write 3 cmd bytes
-    //    ReadBytes(net, buf+3, 10);  // Read 6 data bytes, 2 0xFF, 2 CRC16
-    //    if (!CheckCRC16(buf, 11, &buf[11])) {
-    //        // Handle error.
-    //    }     
-    //          
-    // @param input - Array of bytes to checksum.
-    // @param len - How many bytes to use.
-    // @param inverted_crc - The two CRC16 bytes in the received data.
-    //                       This should just point into the received data,
-    //                       *not* at a 16-bit integer.
-    // @param crc - The crc starting value (optional)
-    // @return True, iff the CRC matches.
-    static bool check_crc16(const uint8_t* input, uint16_t len, const uint8_t* inverted_crc, uint16_t crc = 0);
-
-    // Compute a Dallas Semiconductor 16 bit CRC.  This is required to check
-    // the integrity of data received from many 1-Wire devices.  Note that the
-    // CRC computed here is *not* what you'll get from the 1-Wire network,
-    // for two reasons:
-    //   1) The CRC is transmitted bitwise inverted.
-    //   2) Depending on the endian-ness of your processor, the binary
-    //      representation of the two-byte return value may have a different
-    //      byte order than the two bytes you get from 1-Wire.
-    // @param input - Array of bytes to checksum.
-    // @param len - How many bytes to use.
-    // @param crc - The crc starting value (optional)
-    // @return The CRC16, as defined by Dallas Semiconductor.
-    static uint16_t crc16(const uint8_t* input, uint16_t len, uint16_t crc = 0);
-#endif
-#endif
-};
-
-#endif

From 99c4100c6da15b2e82d460b3357d8f17fb153289 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 10:54:37 -0400
Subject: [PATCH 136/296] Readd OneWire submodule cleanly

---
 .gitmodules        | 3 +++
 src/vendor/OneWire | 1 +
 2 files changed, 4 insertions(+)
 create mode 160000 src/vendor/OneWire

diff --git a/.gitmodules b/.gitmodules
index e0acf3cd..47bcd249 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -7,3 +7,6 @@
 [submodule "src/vendor/arduino-DHT"]
 	path = src/vendor/arduino-DHT
 	url = https://github.com/markruys/arduino-DHT.git
+[submodule "src/vendor/OneWire"]
+	path = src/vendor/OneWire
+	url = https://github.com/PaulStoffregen/OneWire.git
diff --git a/src/vendor/OneWire b/src/vendor/OneWire
new file mode 160000
index 00000000..ebc5f7f5
--- /dev/null
+++ b/src/vendor/OneWire
@@ -0,0 +1 @@
+Subproject commit ebc5f7f503b7be9c3772c3c131d86d7080cc77cf

From 60c03f7a8a6d783ba1f6346ecdf6d65c7e3c556f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 14:17:17 -0400
Subject: [PATCH 137/296] Ignore backslashes that don't escape anything

---
 lib/dino/tx_rx/serial.rb |  1 +
 src/lib/Dino.cpp         | 12 ++++++++----
 src/lib/Dino.h           |  2 +-
 3 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index 7a2adca1..98968075 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -68,6 +68,7 @@ def gets(timeout=0)
               escaped = true
             end
           else
+            escaped = false
             buff << char
           end
           return nil if (buff.empty? && !escaped)
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 9bbb92ef..e5cccba6 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -14,9 +14,9 @@ Dino::Dino(){
 void Dino::parse(byte c) {
   if ((c == '\n') || (c == '\\')) {
     // If last char was a \, this \ or \n is escaped.
-    if(backslash){
+    if(escaping){
       append(c);
-      backslash = false;
+      escaping = false;
     }
 
     // If EOL, process and reset.
@@ -28,13 +28,14 @@ void Dino::parse(byte c) {
     }
 
     // Backslash is the escape character.
-    else if (c == '\\') backslash = true;
+    else if (c == '\\') escaping = true;
   }
 
   // If fragment delimiter, terminate current fragment and move to next.
   // Unless we're in the auxillary message fragment, then just append.
   else if (c == '.') {
     if (fragmentIndex < 3) {
+      escaping = false;
       append('\0');
       fragmentIndex++;
       charIndex = 0;
@@ -44,7 +45,10 @@ void Dino::parse(byte c) {
   }
 
   // Else just append the character.
-  else append(c);
+  else {
+    escaping = false;
+    append(c);
+  }
 }
 
 void Dino::append(byte c) {
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index e4c92168..0a620590 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -97,7 +97,7 @@ class Dino {
     byte *messageFragments[4];
     byte fragmentIndex;
     int charIndex;
-    boolean backslash;
+    boolean escaping;
     void append(byte c);
     void process();
 

From e3ca5f0b7e6479b5a3f8921860f13ef4f02ab7c1 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 15:28:32 -0400
Subject: [PATCH 138/296] No more sprintf,dtostrf. Pass a Stream class to dino.

---
 examples/dht/dht.rb            | 19 +++++++--------
 lib/dino/components/dht.rb     | 43 +++++++++++++---------------------
 lib/dino/components/ds18b20.rb |  2 +-
 src/dino_serial.ino            | 29 ++++++++++-------------
 src/lib/Dino.cpp               | 43 +++++++++++++++-------------------
 src/lib/Dino.h                 | 17 ++++++++------
 src/lib/DinoCoreIO.cpp         | 20 ++++++++++++----
 src/lib/DinoDHT.cpp            | 31 ++++++++++--------------
 src/lib/DinoI2C.cpp            | 39 ++++++++++++++++--------------
 src/lib/DinoOneWire.cpp        | 10 ++++----
 src/lib/DinoSPI.cpp            | 17 +++++---------
 src/lib/DinoShift.cpp          | 17 +++++---------
 12 files changed, 133 insertions(+), 154 deletions(-)

diff --git a/examples/dht/dht.rb b/examples/dht/dht.rb
index dc556e03..e08d0d17 100644
--- a/examples/dht/dht.rb
+++ b/examples/dht/dht.rb
@@ -5,16 +5,15 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
+dht = Dino::Components::DHT.new(pin: 7, board: board)
 
-# The temperature and humidity functions of the DHT sensors are
-# modelled separately, but both isntances can be set up on the same pin.
-temp = Dino::Components::DHT::Temperature.new(pin: 4, board: board)
-humidity = Dino::Components::DHT::Humidity.new(pin: 4, board: board)
-
-temp.read do |temperature|
-  puts "The temperature is #{temperature} degrees C"
+# The DHT class pre-processes raw data from the board. When it reaches callbacks
+# it's already hash of :temperature and :humidity keys, both with Float values.
+dht.add_callback do |data|
+  puts "The temperature is #{data[:temperature]} degrees Celsius"
+  puts "The relative humidity is #{data[:humidity]}%"
 end
 
-humidity.read do |humidity|
-  puts "The relative humidity is #{humidity}%"
-end
+# Read it every 10 seconds.
+dht.poll(10)
+sleep
diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
index 872e54b1..72a22d2d 100644
--- a/lib/dino/components/dht.rb
+++ b/lib/dino/components/dht.rb
@@ -1,36 +1,25 @@
 module Dino
   module Components
-    module DHT
-      class Temperature
-        include Setup::SinglePin
-        include Setup::Input
-        include Mixins::Poller
+    class DHT
+      include Setup::SinglePin
+      include Setup::Input
+      include Mixins::Poller
 
-        def _read
-          board.dht_read(self.pin, 0)
-        end
-
-        def update(data)
-          return unless data.match /T/
-          data.gsub!('T', '')
-          super(data.to_f)
-        end
+      def after_initialize(options={})
+        super(options) if defined?(super)
+        @state = {temperature: nil, humidity: nil}
       end
 
-      class Humidity
-        include Setup::SinglePin
-        include Setup::Input
-        include Mixins::Poller
-
-        def _read
-          board.dht_read(self.pin, 1)
-        end
+      def _read
+        board.dht_read(self.pin)
+      end
 
-        def update(data)
-          return unless data.match /H/
-          data.gsub!('H', '')
-          super(data.to_f)
-        end
+      # Process raw data from the board before running Callbacks#update.
+      # super will write to @state after running callbacks.
+      def update(data)
+        t, h = data.split(",")
+        reading = { temperature: t.to_f, humidity: h.to_f }
+        super(reading)
       end
     end
   end
diff --git a/lib/dino/components/ds18b20.rb b/lib/dino/components/ds18b20.rb
index 0ee1d385..1651b74e 100644
--- a/lib/dino/components/ds18b20.rb
+++ b/lib/dino/components/ds18b20.rb
@@ -6,7 +6,7 @@ class DS18B20
       include Mixins::Poller
 
       def _read
-        board.ds18b20_read(self.pin, 0)
+        board.ds18b20_read(self.pin)
       end
     end
   end
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 9869158f..c7741ae6 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -2,32 +2,29 @@
 
 Dino dino;
 
-// Use 'serial' to reference the right interface depending on the device.
+// Use 'serial' as a pointer to the serial interface depending on device.
 // Uses native USB connection on the Due by default.
 #if defined(__SAM3X8E__)
-  Serial_ &serial = SerialUSB;
+  Serial_* serial = &SerialUSB;
 #elif defined(__AVR_ATmega32U4__)
-  Serial_ &serial = Serial;
+  Serial_* serial = &Serial;
 #elif defined(__AVR_ATtiny85__)
-  TinyDebugSerial &serial = Serial;
+  TinyDebugSerial* serial = &Serial;
 #else
-  HardwareSerial &serial = Serial;
+  HardwareSerial* serial = &Serial;
 #endif
 
 
-// Dino.h doesn't handle TXRX. Create a callback so it can write to serial.
-void writeResponse(char *response) { serial.print(response); }
-void (*writeCallback)(char *str) = writeResponse;
-
 void setup() {
-  serial.begin(115200);
+  serial->begin(115200);
 
   // Wait for Leonardo serial port to connect.
   #if defined(__AVR_ATmega32U4__)
     while(!serial);
   #endif
 
-  dino.setupWrite(writeCallback);
+  // Pass the serial pointer to dino, so it can write too.
+  dino.setOutputStream(serial);
 }
 
 
@@ -38,16 +35,16 @@ long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
 void acknowledge() {
-  serial.print("RCV:");
-  serial.print(rcvBytes);
-  serial.print("\n");
+  serial->print("RCV:");
+  serial->print(rcvBytes);
+  serial->print("\n");
   rcvBytes = 0;
 }
 
 
 void loop() {
-  while(serial.available() > 0) {
-    dino.parse(serial.read());
+  while(serial->available() > 0) {
+    dino.parse(serial->read());
 
     // Acknowledge when we've received as many bytes as the serial input buffer.
     lastRcv = micros();
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index e5cccba6..3f7b6ab8 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -8,9 +8,10 @@ Dino::Dino(){
   messageFragments[1] = pinStr;
   messageFragments[2] = valStr;
   messageFragments[3] = auxMsg;
-  reset();
+  resetState();
 }
 
+
 void Dino::parse(byte c) {
   if ((c == '\n') || (c == '\\')) {
     // If last char was a \, this \ or \n is escaped.
@@ -59,7 +60,6 @@ void Dino::process() {
   cmd = atoi((char *)cmdStr);
   pin = atoi((char *)pinStr);
   val = atoi((char *)valStr);
-  response[0] = '\0';
 
   #ifdef debug
    Serial.print("Received - Command: "); Serial.print(cmdStr);
@@ -155,27 +155,16 @@ void Dino::process() {
     default:                          break;
   }
 
-  // Write the response.
-  if (response[0] != '\0') writeResponse();
-
   #ifdef debug
    Serial.print("Responded with - "); Serial.print(response); Serial.print("\n\n");
   #endif
 }
 
 
-// Let the sketch pass a function that it wants us to use to write output.
-// Store it as a callback and call that when we need to write.
-void Dino::setupWrite(void (*writeCallback)(char *str)) {
-  _writeCallback = writeCallback;
-}
-
-
-// Write the response variable using the callback function from the sketch.
-// Always terminate with a newline.
-void Dino::writeResponse() {
-  _writeCallback(response);
-  _writeCallback("\n");
+// Expect the sketch to pass a pointer to something that inherits from Stream.
+// Store it and call ->print, ->write, etc on it to send data.
+void Dino::setOutputStream(Stream* callback){
+  stream = callback;
 }
 
 
@@ -214,6 +203,19 @@ void Dino::updateListeners() {
 
 // CMD = 90
 void Dino::reset() {
+  resetState();
+
+  stream->print("ACK:");
+  stream->print(A0);
+  #if defined(__SAM3X8E__)
+    stream->print(',');
+    stream->print(DAC0);
+  #endif
+  stream->print('\n');
+}
+
+
+void Dino::resetState() {
   // Disable all the types of listeners.
   clearDigitalListeners();
   clearAnalogListeners();
@@ -223,7 +225,6 @@ void Dino::reset() {
   #ifdef DINO_SHIFT
     clearShiftListeners();
   #endif
-
   heartRate = 4000;    // Update digital listeners every ~4ms.
   analogDivider   = 4; // Update analog listeners every ~16ms.
   registerDivider = 2; // Update register listeners every ~8ms.
@@ -231,12 +232,6 @@ void Dino::reset() {
   charIndex = 0;
   loopCount = 0;
   lastUpdate = micros();
-
-  #if defined(__SAM3X8E__)
-    sprintf(response, "ACK:%d,%d", A0, DAC0);
-  #else
-    sprintf(response, "ACK:%d", A0);
-  #endif
 }
 
 
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 0a620590..ba3473f8 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -18,7 +18,7 @@
 class Dino {
   public:
     Dino();
-    void setupWrite(void (*writeCallback)(char *str));
+    void setOutputStream(Stream* callback);
     void parse(byte c);
     void updateListeners();
 
@@ -88,6 +88,7 @@ class Dino {
 
     // API access to timings, resolutions and reset.
     void reset                 ();  //cmd = 90
+    void resetState            ();
     void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
     void setAnalogDivider      ();  //cmd = 97
@@ -99,12 +100,15 @@ class Dino {
     int charIndex;
     boolean escaping;
     void append(byte c);
+
+    // Mostly a switch statement that decides what to run.
     void process();
 
     // Parsed message storage.
     byte cmdStr[5]; int cmd;
     byte pinStr[5]; int pin;
     byte valStr[5]; int val;
+
     // Scale aux message allocation based on enabled features and chip.
     #if !defined (__AVR_ATmega168__)
       #if defined(DINO_IR_OUT)
@@ -120,13 +124,12 @@ class Dino {
       byte auxMsg[40];
     #endif
 
-    // Value and response storage.
-    int rval;
-    char response[16];
+    // Save a pointer to any stream so we can call ->print and ->write on it.
+    Stream* stream;
 
-    // Use a write callback from the main sketch to respond.
-    void (*_writeCallback)(char *str);
-    void writeResponse();
+    // Storage and response func for features following the pin:rval pattern.
+    int rval;
+    void coreResponse();
 
     // Internal timing variables and utility functions.
     long heartRate;
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index a18ecf94..6d01bd82 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -35,7 +35,7 @@ void Dino::dWrite() {
 // Read a digital input pin. 0 for LOW, 1 for HIGH.
 void Dino::dRead(int pin) {
   rval = digitalRead(pin);
-  sprintf(response, "%d:%d", pin, rval);
+  coreResponse();
 
   #ifdef debug
     Serial.print("Called Dino::dRead()\n");
@@ -56,13 +56,25 @@ void Dino::aWrite() {
 // Read an analog input pin. 0 for LOW, up to 1023 for HIGH @ 10-bit resolution.
 void Dino::aRead(int pin) {
   rval = analogRead(pin);
-  sprintf(response, "%d:%d", pin, rval);
+  coreResponse();
 
   #ifdef debug
     Serial.print("Called Dino::aRead()\n");
   #endif
 }
 
+
+// Send current value of pin and reading value (rval), following the protocol.
+// This is for core reads and listeners, but can be used for any function
+// following the pin:rval pattern. Set those variables correctly before calling.
+void Dino::coreResponse(){
+  stream->print(pin);
+  stream->print(':');
+  stream->print(rval);
+  stream->print('\n');
+}
+
+
 // CMD = 05
 // Set a flag to periodically read a digital pin without further requests.
 // Runs around other requests in the main loop. Only sends value when changed.
@@ -107,7 +119,7 @@ void Dino::updateDigitalListeners() {
       dRead(i);
       if (rval != digitalListenerValues[i]) {
         digitalListenerValues[i] = rval;
-        writeResponse();
+        coreResponse();
       }
     }
   }
@@ -119,7 +131,7 @@ void Dino::updateAnalogListeners() {
   for (int i = 0; i < PIN_COUNT; i++) {
     if (analogListeners[i]) {
       aRead(i);
-      writeResponse();
+      coreResponse();
     }
   }
 }
diff --git a/src/lib/DinoDHT.cpp b/src/lib/DinoDHT.cpp
index 7a29e1c8..6f9e38f6 100644
--- a/src/lib/DinoDHT.cpp
+++ b/src/lib/DinoDHT.cpp
@@ -5,11 +5,6 @@
 #include "Dino.h"
 #ifdef DINO_DHT
 
-// Include dtostrf for ARM.
-#if defined(__SAM3X8E__)
-  #include <avr/dtostrf.h>
-#endif
-
 // Include the DHT library and create an instance.
 #include "DHT.h"
 DHT dht;
@@ -17,22 +12,20 @@ DHT dht;
 // CMD = 13
 // Read a DHT sensor
 void Dino::dhtRead() {
+  // Can't access pin to check this in latest DHT library.
+  // Assuming safe to repeatedly call setup for now.
   // if (pin != dht.pin)
   dht.setup(pin);
-  float reading;
-  char readingBuff[10];
-  char prefix;
-  if (val == 0) {
-    reading = dht.getTemperature();
-    prefix = 'T';
-  } else {
-    reading = dht.getHumidity();
-    prefix = 'H';
-  }
-  if (! isnan(reading)) {
-    dtostrf(reading, 6, 4, readingBuff);
-    sprintf(response, "%d:%c%s", pin, prefix, readingBuff);
-  }
+
+  // Always read both values
+  float temperature = dht.getTemperature();
+  float humidity = dht.getHumidity();
+
+  stream->print(pin); stream->print(':');
+  // Send the values as a comma delimited printed decimals with 1dp precision.
+  stream->print(temperature, 1); stream->print(',');
+  stream->print(humidity, 1);
+  stream->print('\n');
 
   #ifdef debug
     Serial.print("Called Dino::dhtRead()\n");
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
index f808f000..6052deba 100644
--- a/src/lib/DinoI2C.cpp
+++ b/src/lib/DinoI2C.cpp
@@ -14,7 +14,11 @@ void Dino::i2cBegin() {
   // I2c.setSpeed(??);
   // I2c.pullup(??);
   // I2c.timeOut(??);
-  sprintf(response, "%d:I2C:1", SDA);
+
+  // This format could be better.
+  stream->print(SDA);   stream->print(':');
+  stream->print("I2C"); stream->print(':');
+  stream->print('1');   stream->print('\n');
 }
 
 
@@ -22,7 +26,11 @@ void Dino::i2cBegin() {
 // Stop I2C communication.
 void Dino::i2cEnd() {
   I2c.end();
-  sprintf(response, "%d:I2C:0", SDA);
+
+  // This format could be better.
+  stream->print(SDA);   stream->print(':');
+  stream->print("I2C"); stream->print(':');
+  stream->print('0');   stream->print('\n');
 }
 
 
@@ -43,12 +51,12 @@ void Dino::i2cScan() {
     address = I2c.scanOne(address);
 
     // Write whatever we get including address space end or errors.
-    sprintf(response, "%d:%d", SDA, address);
-    writeResponse();
+    stream->print(SDA);     stream->print(':');
+    stream->print(address); stream->print('\n');
+
+    // Increment address before scanning again.
     address++;
   }
-  // Clear the response to make sure it doesn't get sent twice.
-  response[0] = '\0';
 }
 
 
@@ -89,24 +97,19 @@ void Dino::i2cRead() {
   I2c.read(auxMsg[0], auxMsg[1], auxMsg[2]);
 
   // Send back the SDA pin, the device address, and start register address first.
-  sprintf(response, "%d:%d:%d:", SDA, auxMsg[0], auxMsg[1]);
-  _writeCallback(response);
+  stream->print(SDA);       stream->print(':');
+  stream->print(auxMsg[0]); stream->print(':');
+  stream->print(auxMsg[1]); stream->print(':');
 
   // Send back the data bytes.
   uint8_t currentByte = 0;
   while(I2c.available()){
     currentByte++;
-    // Append comma, but \n for last byte, then write.
-    if (currentByte == auxMsg[2]){
-      sprintf(response, "%d\n", I2c.receive());
-    } else {
-      sprintf(response, "%d,", I2c.receive());
-    }
-    _writeCallback(response);
-  }
 
-  // Clear the response to make sure it doesn't get sent twice.
-  response[0] = '\0';
+    // Get a byte from the I2C buffer, print it, then comma or \n if last byte.
+    stream->print(I2c.receive());
+    stream->print((currentByte == auxMsg[2]) ? '\n' : ',');
+  }
 }
 
 #endif
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
index fa1e6155..d157a88a 100644
--- a/src/lib/DinoOneWire.cpp
+++ b/src/lib/DinoOneWire.cpp
@@ -4,10 +4,6 @@
 #include "Dino.h"
 #ifdef DINO_ONE_WIRE
 
-// Include dtostrf for ARM.
-#if defined(__SAM3X8E__)
-  #include <avr/dtostrf.h>
-#endif
 #include "OneWire.h"
 
 // CMD = 15
@@ -54,8 +50,10 @@ void Dino::ds18Read() {
   char readingBuff[10];
 
   if (! isnan(reading)) {
-    dtostrf(reading, 6, 4, readingBuff);
-    sprintf(response, "%d:%s", pin, readingBuff);
+    stream->print(pin);
+    stream->print(':');
+    stream->print(reading, 4);
+    stream->print('\n');
   }
 }
 
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 35e05c5d..a5669ac2 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -79,26 +79,21 @@ void Dino::spiRead(int selectPin, int len, byte spiMode, uint32_t clockRate) {
 
   // Send data as if coming from the slave select pin so it's easy to identify.
   // Start with just pin number and : for now.
-  sprintf(response, "%d:", selectPin);
-  _writeCallback(response);
+  stream->print(selectPin);
+  stream->print(':');
 
   for (int i = 1;  i <= len;  i++) {
     // Read a single byte from the register.
     byte reading = SPI.transfer(0x00);
 
-    // If we're on the last byte, append \n. If not, append a comma, then write.
-    if (i == len) {
-      sprintf(response, "%d\n", reading);
-    } else {
-      sprintf(response, "%d,", reading);
-    }
-    _writeCallback(response);
+    // Print it, then a comma or \n if it's the last byte.
+    stream->print(reading);
+    stream->print((i==len) ? '\n' : ',');
   }
   spiEnd();
 
-  // Leave select high and clear response so main loop doesn't send anything.
+  // Leave select high.
   digitalWrite(selectPin, HIGH);
-  response[0] = '\0';
 }
 
 // CMD = 28
diff --git a/src/lib/DinoShift.cpp b/src/lib/DinoShift.cpp
index f5788dae..a3945dc0 100644
--- a/src/lib/DinoShift.cpp
+++ b/src/lib/DinoShift.cpp
@@ -56,25 +56,20 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
 
   // Send data as if coming from the latch pin so it's easy to identify.
   // Start with just pin number and : for now.
-  sprintf(response, "%d:", latchPin);
-  _writeCallback(response);
+  stream->print(latchPin);
+  stream->print(':');
 
   for (int i = 1;  i <= len;  i++) {
     // Read a single byte from the register.
     byte reading = shiftIn(dataPin, clockPin, LSBFIRST);
 
-    // If we're on the last byte, append \n. If not, append a comma, then write.
-    if (i == len) {
-      sprintf(response, "%d\n", reading);
-    } else {
-      sprintf(response, "%d,", reading);
-    }
-    _writeCallback(response);
+    // Print it, then a comma or \n if it's the last byte.
+    stream->print(reading);
+    stream->print((i==len) ? '\n' : ',');
   }
 
-  // Leave latch pin high and clear response so main loop doesn't send anything.
+  // Leave latch pin high.
   digitalWrite(latchPin, HIGH);
-  response[0] = '\0';
 }
 
 

From 359adc448a581f29f06ce1d69f3c45dc2ae5ee36 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 15:40:41 -0400
Subject: [PATCH 139/296] Fix how coreResponse works with listeners

---
 src/lib/Dino.h         |  7 +++----
 src/lib/DinoCoreIO.cpp | 12 +++++-------
 2 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index ba3473f8..09a25326 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -49,6 +49,9 @@ class Dino {
     boolean analogListeners[PIN_COUNT];
     boolean digitalListeners[PIN_COUNT];
     byte digitalListenerValues[PIN_COUNT];
+    // Storage and response func for features following the pin:rval pattern.
+    int rval;
+    void coreResponse(int p, int v);
 
     // Included Libraries
     void servoToggle           ();         //cmd = 8
@@ -127,10 +130,6 @@ class Dino {
     // Save a pointer to any stream so we can call ->print and ->write on it.
     Stream* stream;
 
-    // Storage and response func for features following the pin:rval pattern.
-    int rval;
-    void coreResponse();
-
     // Internal timing variables and utility functions.
     long heartRate;
     long lastUpdate;
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index 6d01bd82..5e363397 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -35,7 +35,7 @@ void Dino::dWrite() {
 // Read a digital input pin. 0 for LOW, 1 for HIGH.
 void Dino::dRead(int pin) {
   rval = digitalRead(pin);
-  coreResponse();
+  coreResponse(pin, rval);
 
   #ifdef debug
     Serial.print("Called Dino::dRead()\n");
@@ -56,7 +56,7 @@ void Dino::aWrite() {
 // Read an analog input pin. 0 for LOW, up to 1023 for HIGH @ 10-bit resolution.
 void Dino::aRead(int pin) {
   rval = analogRead(pin);
-  coreResponse();
+  coreResponse(pin, rval);
 
   #ifdef debug
     Serial.print("Called Dino::aRead()\n");
@@ -67,10 +67,10 @@ void Dino::aRead(int pin) {
 // Send current value of pin and reading value (rval), following the protocol.
 // This is for core reads and listeners, but can be used for any function
 // following the pin:rval pattern. Set those variables correctly before calling.
-void Dino::coreResponse(){
-  stream->print(pin);
+void Dino::coreResponse(int p, int v){
+  stream->print(p);
   stream->print(':');
-  stream->print(rval);
+  stream->print(v);
   stream->print('\n');
 }
 
@@ -119,7 +119,6 @@ void Dino::updateDigitalListeners() {
       dRead(i);
       if (rval != digitalListenerValues[i]) {
         digitalListenerValues[i] = rval;
-        coreResponse();
       }
     }
   }
@@ -131,7 +130,6 @@ void Dino::updateAnalogListeners() {
   for (int i = 0; i < PIN_COUNT; i++) {
     if (analogListeners[i]) {
       aRead(i);
-      coreResponse();
     }
   }
 }

From 2384b141f02743bc8d6bec247e4b6772ebcb1223 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 17:17:57 -0400
Subject: [PATCH 140/296] Get ethernet and wifi? working with new Stream write
 method.

---
 src/dino_ethernet.ino | 29 ++++++-----------------------
 src/dino_wifi.ino     | 27 +++++----------------------
 2 files changed, 11 insertions(+), 45 deletions(-)

diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index d5de3e36..0915d5fe 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -10,24 +10,8 @@ int port = 3466;
 Dino dino;
 EthernetServer server(port);
 EthernetClient client;
-char responseBuffer[65];
 
 
-// Dino.h doesn't handle TXRX.
-// Setup a callback to buffer responses for writing.
-void bufferResponse(char *response) {
-  if (strlen(responseBuffer) > 56 ) writeResponses();
-  strcpy(responseBuffer, response);
-}
-void (*writeCallback)(char *str) = bufferResponse;
-
-// Write the buffered responses to the client.
-void writeResponses() {
-  if (responseBuffer[0] != '\0')
-    client.write(responseBuffer);
-    responseBuffer[0] = '\0';
-}
-
 void printEthernetStatus() {
   // Print ethernet status.
   Serial.print("IP Address: ");
@@ -50,8 +34,8 @@ void setup() {
   server.begin();
   printEthernetStatus();
 
-  // Attach the write callback.
-  dino.setupWrite(writeCallback);
+  // Pass a client pointer to dino, so it can write too.
+  dino.setOutputStream(&client);
 }
 
 
@@ -62,9 +46,9 @@ long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
 void acknowledge() {
-  client.write("RCV:");
-  client.write(rcvBytes);
-  client.write("\n");
+  client.print("RCV:");
+  client.print(rcvBytes);
+  client.print("\n");
   rcvBytes = 0;
 }
 
@@ -85,10 +69,9 @@ void loop() {
       }
 
       // Also acknowledge when the last byte received goes outside the receive window.
-      if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
+      if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvThreshold)) acknowledge();
 
       dino.updateListeners();
-      writeResponses();
     }
   }
   client.stop();
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 17807eb1..752f0039 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -12,24 +12,8 @@ int status = WL_IDLE_STATUS;
 Dino dino;
 WiFiServer server(port);
 WiFiClient client;
-char responseBuffer[65];
 
 
-// Dino.h doesn't handle TXRX.
-// Setup a callback to buffer responses for writing.
-void bufferResponse(char *response) {
-  if (strlen(responseBuffer) > 56 ) writeResponses();
-  strcpy(responseBuffer, response);
-}
-void (*writeCallback)(char *str) = bufferResponse;
-
-// Write the buffered responses to the client.
-void writeResponses() {
-  if (responseBuffer[0] != '\0')
-    client.write(responseBuffer);
-    responseBuffer[0] = '\0';
-}
-
 void printWifiStatus() {
   Serial.print("SSID: ");
   Serial.println(WiFi.SSID());
@@ -59,8 +43,8 @@ void setup() {
   server.begin();
   printWifiStatus();
 
-  // Attach the write callback.
-  dino.setupWrite(writeCallback);
+  // Pass a client pointer to dino, so it can write too.
+  dino.setOutputStream(&client);
 }
 
 
@@ -71,9 +55,9 @@ long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
 void acknowledge() {
-  client.write("RCV:");
-  client.write(rcvBytes);
-  client.write("\n");
+  client.print("RCV:");
+  client.print(rcvBytes);
+  client.print("\n");
   rcvBytes = 0;
 }
 
@@ -98,7 +82,6 @@ void loop() {
       if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
 
       dino.updateListeners();
-      writeResponses();
     }
   }
   client.stop();

From 776b23749b686b6d739cbf76c9e274d0e926a0d3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 17:34:41 -0400
Subject: [PATCH 141/296] Upgrade the ATMega168 target. Minor CLI bug fix.

---
 lib/dino_cli/packages.rb |  2 +-
 lib/dino_cli/targets.rb  |  4 ++--
 lib/dino_cli/targets.txt | 20 +++++++++++++-------
 src/lib/Dino.h           | 22 +++++++++-------------
 src/lib/DinoServo.cpp    | 10 ++++++++--
 5 files changed, 33 insertions(+), 25 deletions(-)

diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index 5bb654fe..ddecccad 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -15,7 +15,7 @@ class DinoCLI::Generator
   },
   servo: {
     description: "Servo support",
-    directive: "DINO_LCD",
+    directive: "DINO_SERVO",
     files: [
       "lib/DinoServo.cpp",
     ]
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 92d029f8..bcd81edb 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -8,8 +8,8 @@ class DinoCLI::Generator
     core: [:core],
 
     # Specific features for the old mega168 chips.
-    mega168: [:core, :servo, :lcd, :spi, :i2c],
-
+    mega168: [:core, :servo, :dht, :one_wire, :ir_out, :spi, :i2c],
+    
     # ARM includes everytyhing except specific incompatibilities.
     arm: PACKAGES.each_key.map {|k| k} - [:serial, :tone, :ir_out, :i2c],
   }
diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
index b5082cda..b49870ca 100644
--- a/lib/dino_cli/targets.txt
+++ b/lib/dino_cli/targets.txt
@@ -28,26 +28,32 @@
 
       This specifically targets the older ATmega168 chip used in early Arduinos.
       They have half the RAM and flash available, so we need to cut the sketch down.
-      Beyond core IO functionality, it ONLY includes the following features:
-          Servo, LCD, SPI, I2C
+      This option includes core functionality AND:
+          Servo (6 maxmium), DHT, OneWire, IR Out, SPI, I2C
 
       Chips:  ATmega168
       Boards: Duemilanove, Diecimila, Pro, Pro Mini
               (Later versions of these may carry an ATmega328)
 
       Note: While you can generate this sketch using any communication type,
-      it will only fit on the board when generated for serial communication.
+      it will only fit on the ATmega168 when generated for serial communication.
       There is not enough memory available for Wi-Fi or Ethernet. You can
-      try the core target to tradeoff the features for networking.
+      try the core target to tradeoff features for networking instead.
 
-      Note: Aux message length is always limited to 40 bytes on this chip.
+      You can also try to create a serial over Wi-Fi bridge with:
+      https://github.com/jeelabs/esp-link, if you have an ESP8266 handy.
+
+      Note: Aux message is always limited to 264 bytes or less for the ATmega168.
+            Servo count is always limited to 6 (normally 12) for the ATmega168 chip.
+            These limits apply regardless of using this build target, as long as
+            a board with that chip is selected in the IDE.
 
     arm
 
       This is the same as mega, but omits libraries specifically known to be
       incompatible with the Atmel SAMD (ARM Cortex M0) chips. Use this when
       you need to load a sketch on the Arduino Due or similar boards.
-      This option excludes the following features:
+      This option includes all features EXCEPT:
           Serial, Tone, IR Out, I2C
 
       Chips:  AT91SAM3X8E
@@ -57,4 +63,4 @@
   control which libraries are included at compile time by editing DinoDefines.h.
   All the library files (even the unused ones) are copied to the destination sketch
   folder to enable this. Uncomment a corresponding #define in DinoDefines.h to
-  include a library in the sketch. Comment it out to exclude that library.
+  include everything needed for that library. Comment it out to exclude the library.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 09a25326..fe47fc9a 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -108,21 +108,17 @@ class Dino {
     void process();
 
     // Parsed message storage.
-    byte cmdStr[5]; int cmd;
-    byte pinStr[5]; int pin;
-    byte valStr[5]; int val;
+    byte cmdStr[4]; int cmd;
+    byte pinStr[4]; int pin;
+    byte valStr[4]; int val;
 
     // Scale aux message allocation based on enabled features and chip.
-    #if !defined (__AVR_ATmega168__)
-      #if defined(DINO_IR_OUT)
-        byte auxMsg[528];
-      #elif defined(DINO_SHIFT) || defined(DINO_SPI) || defined (DINO_I2C)
-        byte auxMsg[272];
-      #elif defined (DINO_LCD)
-        byte auxMsg[144];
-      #else
-        byte auxMsg[48];
-      #endif
+    #if defined(DINO_IR_OUT) && !defined (__AVR_ATmega168__)
+      byte auxMsg[528];
+    #elif defined(DINO_SHIFT) || defined(DINO_SPI) || defined (DINO_I2C)
+      byte auxMsg[264];
+    #elif defined (DINO_LCD)
+      byte auxMsg[136];
     #else
       byte auxMsg[40];
     #endif
diff --git a/src/lib/DinoServo.cpp b/src/lib/DinoServo.cpp
index e3735af4..195503e4 100644
--- a/src/lib/DinoServo.cpp
+++ b/src/lib/DinoServo.cpp
@@ -6,8 +6,14 @@
 
 #include <Servo.h>
 
-// Maximum 12 servos on most boards. Could be up to 48 on Arduino Mega.
-#define SERVO_COUNT 12
+// 12 servos on most boards. 6 on the ATmega168.
+// Could be up to 48 on Arduino Mega.
+#if defined (__AVR_ATmega168__)
+  #define SERVO_COUNT 6
+#else
+  #define SERVO_COUNT 12
+#endif
+
 
 // Create an array of wrapper structs that link pins to servo objects.
 struct ServoWrapper{

From 1f8b60f341827507281dcc9b3f01ed1a6a55767b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 7 Jan 2018 17:45:09 -0400
Subject: [PATCH 142/296] Fix tone timer by removing unused IRRemote.cpp. Give
 mega168 tone too.

---
 lib/dino_cli/packages.rb | 1 -
 lib/dino_cli/targets.rb  | 7 +++----
 lib/dino_cli/targets.txt | 2 +-
 3 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index ddecccad..eb7c758c 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -72,7 +72,6 @@ class DinoCLI::Generator
     files: [
       "lib/DinoIROut.cpp",
       "vendor/Arduino-IRremote/boarddefs.h",
-      "vendor/Arduino-IRremote/IRremote.cpp",
       "vendor/Arduino-IRremote/IRremote.h",
       "vendor/Arduino-IRremote/IRremoteInt.h",
       "vendor/Arduino-IRremote/irSend.cpp",
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index bcd81edb..9a34148d 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -1,15 +1,14 @@
 class DinoCLI::Generator
   TARGETS = {
     # Default target always includes all packages.
-    # Tone temporarily disabled due to timer conflict.
-    mega: PACKAGES.each_key.map {|k| k} - [:tone],
+    mega: PACKAGES.each_key.map {|k| k},
 
     # Core is core.
     core: [:core],
 
     # Specific features for the old mega168 chips.
-    mega168: [:core, :servo, :dht, :one_wire, :ir_out, :spi, :i2c],
-    
+    mega168: [:core, :servo, :dht, :one_wire, :ir_out, :tone, :spi, :i2c],
+
     # ARM includes everytyhing except specific incompatibilities.
     arm: PACKAGES.each_key.map {|k| k} - [:serial, :tone, :ir_out, :i2c],
   }
diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
index b49870ca..49087ca7 100644
--- a/lib/dino_cli/targets.txt
+++ b/lib/dino_cli/targets.txt
@@ -29,7 +29,7 @@
       This specifically targets the older ATmega168 chip used in early Arduinos.
       They have half the RAM and flash available, so we need to cut the sketch down.
       This option includes core functionality AND:
-          Servo (6 maxmium), DHT, OneWire, IR Out, SPI, I2C
+          Servo (6 maxmium), DHT, OneWire, IR Out, Tone, SPI, I2C
 
       Chips:  ATmega168
       Boards: Duemilanove, Diecimila, Pro, Pro Mini

From 1c2335ba5a5bb2a877f28a8614cb1f2d5cd85a51 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 8 Jan 2018 14:36:28 -0400
Subject: [PATCH 143/296] Make Board#high 1 not 255. Added Board#analog_high
 for that.

---
 lib/dino/board.rb                               |  5 +++--
 lib/dino/components/basic/analog_output.rb      |  8 +++++---
 lib/dino/components/basic/digital_input.rb      | 10 +++++-----
 lib/dino/components/basic/digital_output.rb     |  3 +++
 spec/lib/board_spec.rb                          | 13 +++++++++----
 spec/lib/components/basic/analog_output_spec.rb |  7 +++----
 spec/lib/components/basic/digital_input_spec.rb |  4 ++--
 7 files changed, 30 insertions(+), 20 deletions(-)

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 3dce145a..60d7c575 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -1,6 +1,6 @@
 module Dino
   class Board
-    attr_reader :high, :low, :components, :analog_zero, :dac_zero
+    attr_reader :high, :low, :analog_high, :components, :analog_zero, :dac_zero
     DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
     def initialize(io, options={})
@@ -16,7 +16,8 @@ def analog_resolution=(value)
       @bits = value || 8
       write Dino::Message.encode(command: 96, value: @bits)
       @low  = 0
-      @high = (2 ** @bits) - 1
+      @high = 1
+      @analog_high = (2 ** @bits) - 1
     end
 
     def analog_divider=(value)
diff --git a/lib/dino/components/basic/analog_output.rb b/lib/dino/components/basic/analog_output.rb
index fd7a57db..6277d163 100644
--- a/lib/dino/components/basic/analog_output.rb
+++ b/lib/dino/components/basic/analog_output.rb
@@ -9,10 +9,12 @@ def analog_write(value)
         end
 
         def write(value)
-          unless [board.low, board.high].include? value
-            analog_write(value)
+          if value == board.low
+            digital_write(board.low)
+          elsif value == board.analog_high
+            digital_write(board.high)
           else
-            digital_write(value)
+            analog_write(value)
           end
         end
       end
diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index d0788194..912f1690 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -13,9 +13,6 @@ def after_initialize(options={})
           _listen
         end
 
-        HIGH = 1
-        LOW = 0
-
         def _read
           board.digital_read(self.pin)
         end
@@ -26,15 +23,18 @@ def _listen
 
         def on_high(&block)
           add_callback(:high) do |data|
-            block.call(data) if data.to_i == HIGH
+            block.call(data) if data.to_i == board.high
           end
         end
 
         def on_low(&block)
           add_callback(:low) do |data|
-            block.call(data) if data.to_i == LOW
+            block.call(data) if data.to_i == board.low
           end
         end
+
+        def high?; state == board.high end
+        def low?;  state == board.low  end
       end
     end
   end
diff --git a/lib/dino/components/basic/digital_output.rb b/lib/dino/components/basic/digital_output.rb
index 13c88136..3b3be84d 100644
--- a/lib/dino/components/basic/digital_output.rb
+++ b/lib/dino/components/basic/digital_output.rb
@@ -31,6 +31,9 @@ def toggle
 
         alias :off :low
         alias :on  :high
+
+        def high?; state == board.high end
+        def low?;  state == board.low  end
       end
     end
   end
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 3fccbf9f..1b941ba0 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -31,10 +31,15 @@ def io_mock(methods = {})
         expect(subject.dac_zero).to equal(20)
       end
 
-      it 'should set the analog resolution' do
+      it 'should set digital high and low' do
         board = Board.new(io_mock)
         expect(board.low).to equal(0)
-        expect(board.high).to equal(255)
+        expect(board.high).to equal(1)
+      end
+
+      it 'should set analog high separately' do
+        board = Board.new(io_mock)
+        expect(board.analog_high).to equal(255)
       end
     end
 
@@ -205,10 +210,10 @@ def io_mock(methods = {})
       it 'should set @high and @low correctly' do
         subject.analog_resolution = 8
         expect(subject.low).to equal(0)
-        expect(subject.high).to equal(255)
+        expect(subject.analog_high).to equal(255)
 
         subject.analog_resolution = 10
-        expect(subject.high).to equal(1023)
+        expect(subject.analog_high).to equal(1023)
       end
     end
   end
diff --git a/spec/lib/components/basic/analog_output_spec.rb b/spec/lib/components/basic/analog_output_spec.rb
index 1d610320..ea2eaf07 100644
--- a/spec/lib/components/basic/analog_output_spec.rb
+++ b/spec/lib/components/basic/analog_output_spec.rb
@@ -18,13 +18,12 @@ module Basic
         end
 
         describe '#write' do
-          it 'should call #digital_write if value is HIGH' do
+          it 'should call #digital_write with board.high if value is board.analog_high' do
             expect(subject).to receive(:digital_write).with(board.high)
-            subject.write(board.high)
+            subject.write(board.analog_high)
           end
 
-
-          it 'should call #digital_write if value is LOW' do
+          it 'should call #digital_write with board.low if value is board.low' do
             expect(subject).to receive(:digital_write).with(board.low)
             subject.write(board.low)
           end
diff --git a/spec/lib/components/basic/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
index e4daad23..56f62e2c 100644
--- a/spec/lib/components/basic/digital_input_spec.rb
+++ b/spec/lib/components/basic/digital_input_spec.rb
@@ -40,7 +40,7 @@ module Basic
               expect(@low_callback).to receive(:called)
               expect(@high_callback).not_to receive(:called)
 
-              subject.update(DigitalInput::LOW)
+              subject.update(board.low)
             end
           end
 
@@ -49,7 +49,7 @@ module Basic
               expect(@high_callback).to receive(:called)
               expect(@low_callback).not_to receive(:called)
 
-              subject.update(DigitalInput::HIGH)
+              subject.update(board.high)
             end
           end
         end

From 03b6bac7591bf60003370a438c9112d7e62b2229 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 9 Jan 2018 18:27:50 -0400
Subject: [PATCH 144/296] Improve bandwidth with soft flow control. Cleanup
 `TxRx#synced_write`

---
 lib/dino/tx_rx/base.rb | 28 ++++++++++++++--------------
 src/dino_ethernet.ino  |  2 +-
 src/dino_serial.ino    |  2 +-
 src/dino_wifi.ino      |  2 +-
 4 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 4e5970a0..f4cf87b3 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -8,9 +8,11 @@ class TCPConnectError    < StandardError; end
     class HandshakeError     < StandardError; end
     class RxFlushTimeout     < StandardError; end
 
+    attr_accessor :sent_bytes
+
     class Base
       include Observable
-      BOARD_BUFFER = 60
+      BOARD_BUFFER = 64
       HANDSHAKE_TRIES = 3
       HANDSHAKE_TIMEOUT = 2
 
@@ -33,6 +35,7 @@ def write(message)
       end
 
       def handshake
+        @sent_bytes = 0
         initialize_flow_control
         flush_read
         HANDSHAKE_TRIES.times do |retries|
@@ -70,20 +73,17 @@ def flush_read
       end
 
       def synced_write(message)
-        message = message.split("")
-        loop do
-          @flow_control.synchronize do
-            bytes = BOARD_BUFFER - @transit_bytes
-            break unless bytes > 0
-
-            bytes = message.length if (message.length < bytes)
-            fragment = String.new
-            bytes.times { fragment << message.shift }
+        @sent_bytes += message.length
+        while message && !message.empty?
+          bytes = BOARD_BUFFER - transit_bytes
+          if bytes > 0
+            fragment = message[0..(bytes-1)]
+            message  = message[bytes..-1]
             io.write(fragment)
-            @transit_bytes = @transit_bytes + bytes
+            add_transit_bytes(fragment.length)
+          else
+            sleep 0.0005
           end
-          return if message.empty?
-          sleep 0.005
         end
       end
 
@@ -93,7 +93,7 @@ def _write(message);  raise "#_write should be defined in TxRx subclasses";  end
 
       def _read
         line = gets
-        line ? process_line(line) : sleep(0.005)
+        line ? process_line(line) : sleep(0.001)
       end
 
       def process_line(line)
diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index 0915d5fe..73232469 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -41,7 +41,7 @@ void setup() {
 
 // Keep count of bytes as we receive them and send a dino message with how many.
 uint8_t rcvBytes  = 0;
-uint8_t rcvThreshold = 30;
+uint8_t rcvThreshold = 64;
 long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index c7741ae6..c8b0b1bb 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -30,7 +30,7 @@ void setup() {
 
 // Keep count of bytes as we receive them and send a dino message with how many.
 uint8_t rcvBytes  = 0;
-uint8_t rcvThreshold = 30;
+uint8_t rcvThreshold = 64;
 long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 752f0039..6901efcf 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -50,7 +50,7 @@ void setup() {
 
 // Keep count of bytes as we receive them and send a dino message with how many.
 uint8_t rcvBytes  = 0;
-uint8_t rcvThreshold = 30;
+uint8_t rcvThreshold = 64;
 long    lastRcv   = micros();
 long    rcvWindow = 1000000;
 

From 2490a8d0cd0aee7c7183783d7bca05064e50bfbe Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 9 Jan 2018 18:30:00 -0400
Subject: [PATCH 145/296] Fix digital listeners always sending. Broken while
 removing sprintf usage.

---
 src/lib/DinoCoreIO.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index 5e363397..adac92f5 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -116,9 +116,10 @@ void Dino::removeListener() {
 void Dino::updateDigitalListeners() {
   for (int i = 0; i < PIN_COUNT; i++) {
     if (digitalListeners[i]) {
-      dRead(i);
+      rval = digitalRead(i);
       if (rval != digitalListenerValues[i]) {
         digitalListenerValues[i] = rval;
+        coreResponse(i, rval);
       }
     }
   }

From 65f9bd5cc574fa2e2accba98ddd7e33d18486484 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 13 Jan 2018 13:06:00 -0400
Subject: [PATCH 146/296] Call micros only once when updating listeners.
 Stronger typing.

---
 src/lib/Dino.cpp | 12 +++---------
 src/lib/Dino.h   | 11 +++++------
 2 files changed, 8 insertions(+), 15 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 3f7b6ab8..d2c4d343 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -168,22 +168,16 @@ void Dino::setOutputStream(Stream* callback){
 }
 
 
-// Convenience wrapper to keep track of time since last read for listeners.
-long Dino::timeSince(long event) {
- long time = micros() - event;
- return time;
-}
-
-
 // Every heartRate microseconds, read the digital listeners and send values if changed.
 // Analog listeners use a divider to run at a fraction of that frequency.
 // Register listeners (Shift, I2C and SPI) all share a second divider value.
 // Analog and register listeners always send values even if not changed.
 // See Dino::reset for default timings.
 void Dino::updateListeners() {
-  if (timeSince(lastUpdate) > heartRate || timeSince(lastUpdate) < 0) {
+  unsigned long now = micros();
+  if ((now - lastUpdate) > heartRate) {
     // Digital Listeners
-    lastUpdate = micros();
+    lastUpdate = now;
     loopCount++;
     updateDigitalListeners();
 
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index fe47fc9a..fd77e98f 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -127,11 +127,10 @@ class Dino {
     Stream* stream;
 
     // Internal timing variables and utility functions.
-    long heartRate;
-    long lastUpdate;
-    unsigned int loopCount;
-    unsigned int analogDivider;
-    unsigned int registerDivider;
-    long timeSince (long event);
+    unsigned long heartRate;
+    unsigned long lastUpdate;
+    byte loopCount;
+    byte analogDivider;
+    byte registerDivider;
 };
 #endif

From 78fb692bbbd8b2914f85fc631d3fd932549e0076 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 13 Jan 2018 13:07:05 -0400
Subject: [PATCH 147/296] Refactor acknowledgement out of sketch into Dino.cpp

---
 src/dino_ethernet.ino | 37 ++++++--------------------------
 src/dino_serial.ino   | 49 ++++++++-----------------------------------
 src/dino_wifi.ino     | 39 ++++++----------------------------
 src/lib/Dino.cpp      | 25 ++++++++++++++++++++++
 src/lib/Dino.h        | 21 +++++++++++++------
 5 files changed, 61 insertions(+), 110 deletions(-)

diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index 73232469..aec9362b 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -33,46 +33,21 @@ void setup() {
   Ethernet.begin(mac, ip);
   server.begin();
   printEthernetStatus();
-
-  // Pass a client pointer to dino, so it can write too.
-  dino.setOutputStream(&client);
 }
 
 
-// Keep count of bytes as we receive them and send a dino message with how many.
-uint8_t rcvBytes  = 0;
-uint8_t rcvThreshold = 64;
-long    lastRcv   = micros();
-long    rcvWindow = 1000000;
-
-void acknowledge() {
-  client.print("RCV:");
-  client.print(rcvBytes);
-  client.print("\n");
-  rcvBytes = 0;
-}
-
 void loop() {
   // Listen for connections.
   client = server.available();
 
+  // Pass the stream to dino so it can read/write.
+  dino.setOutputStream(&client);
+
   // Handle a connection.
   if (client) {
-    while (client.connected()) {
-      while (client.available()){
-        dino.parse(client.read());
-
-        // Acknowledge when we've received as many bytes as the serial input buffer.
-        lastRcv = micros();
-        rcvBytes ++;
-        if (rcvBytes == rcvThreshold) acknowledge();
-      }
-
-      // Also acknowledge when the last byte received goes outside the receive window.
-      if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvThreshold)) acknowledge();
-
-      dino.updateListeners();
-    }
+    while (client.connected()) dino.run();
   }
+
+  // End the connection.
   client.stop();
 }
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index c8b0b1bb..3c3eceaf 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -2,59 +2,28 @@
 
 Dino dino;
 
-// Use 'serial' as a pointer to the serial interface depending on device.
-// Uses native USB connection on the Due by default.
+// Define 'serial' as the serial interface on teh device that we want to use.
+// Defaults to Native USB port on the Due.
 #if defined(__SAM3X8E__)
-  Serial_* serial = &SerialUSB;
-#elif defined(__AVR_ATmega32U4__)
-  Serial_* serial = &Serial;
-#elif defined(__AVR_ATtiny85__)
-  TinyDebugSerial* serial = &Serial;
+#define serial SerialUSB
+//#define serial Serial
 #else
-  HardwareSerial* serial = &Serial;
+#define serial Serial
 #endif
 
 
 void setup() {
-  serial->begin(115200);
+  serial.begin(115200);
 
   // Wait for Leonardo serial port to connect.
   #if defined(__AVR_ATmega32U4__)
     while(!serial);
   #endif
 
-  // Pass the serial pointer to dino, so it can write too.
-  dino.setOutputStream(serial);
+  // Pass the stream to dino so it can read/write.
+  dino.setOutputStream(&serial);
 }
 
-
-// Keep count of bytes as we receive them and send a dino message with how many.
-uint8_t rcvBytes  = 0;
-uint8_t rcvThreshold = 64;
-long    lastRcv   = micros();
-long    rcvWindow = 1000000;
-
-void acknowledge() {
-  serial->print("RCV:");
-  serial->print(rcvBytes);
-  serial->print("\n");
-  rcvBytes = 0;
-}
-
-
 void loop() {
-  while(serial->available() > 0) {
-    dino.parse(serial->read());
-
-    // Acknowledge when we've received as many bytes as the serial input buffer.
-    lastRcv = micros();
-    rcvBytes ++;
-    if (rcvBytes == rcvThreshold) acknowledge();
-  }
-
-  // Also acknowledge when the last byte received goes outside the receive window.
-  if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
-
-  // Run dino's listeners.
-  dino.updateListeners();
+  dino.run();
 }
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 6901efcf..2a48a402 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -42,47 +42,20 @@ void setup() {
   // Start the server.
   server.begin();
   printWifiStatus();
-
-  // Pass a client pointer to dino, so it can write too.
-  dino.setOutputStream(&client);
 }
 
-
-// Keep count of bytes as we receive them and send a dino message with how many.
-uint8_t rcvBytes  = 0;
-uint8_t rcvThreshold = 64;
-long    lastRcv   = micros();
-long    rcvWindow = 1000000;
-
-void acknowledge() {
-  client.print("RCV:");
-  client.print(rcvBytes);
-  client.print("\n");
-  rcvBytes = 0;
-}
-
-
 void loop() {
   // Listen for connections.
   client = server.available();
 
+  // Pass the stream to dino so it can read/write.
+  dino.setOutputStream(&client);
+
   // Handle a connection.
   if (client) {
-    while (client.connected()) {
-      while (client.available()){
-        dino.parse(client.read());
-
-        // Acknowledge when we've received as many bytes as the serial input buffer.
-        lastRcv = micros();
-        rcvBytes ++;
-        if (rcvBytes == rcvThreshold) acknowledge();
-      }
-
-      // Also acknowledge when the last byte received goes outside the receive window.
-      if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
-
-      dino.updateListeners();
-    }
+    while (client.connected()) dino.run();
   }
+
+  // End the connection.
   client.stop();
 }
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index d2c4d343..ee366a1d 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -12,6 +12,31 @@ Dino::Dino(){
 }
 
 
+void Dino::acknowledge() {
+  stream->print("RCV:");
+  stream->print(rcvBytes);
+  stream->print("\n");
+  rcvBytes = 0;
+}
+
+void Dino::run(){
+  while(stream->available() > 0) {
+    parse(stream->read());
+
+    // Acknowledge when we've received as many bytes as the serial input buffer.
+    lastRcv = micros();
+    rcvBytes ++;
+    if (rcvBytes == rcvThreshold) acknowledge();
+  }
+
+  // Also acknowledge when the last byte received goes outside the receive window.
+  if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
+
+  // Run dino's listeners.
+  updateListeners();
+}
+
+
 void Dino::parse(byte c) {
   if ((c == '\n') || (c == '\\')) {
     // If last char was a \, this \ or \n is escaped.
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index fd77e98f..51756a4a 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -19,15 +19,18 @@ class Dino {
   public:
     Dino();
     void setOutputStream(Stream* callback);
-    void parse(byte c);
-    void updateListeners();
+    void run();
 
   private:
-    // Functions with a cmd value can be called through the remote API.
+    // Main loop functions.
+    void acknowledge();
+    void parse(byte c);
+    void process();
 
     // See explanation at top of DinoBugWorkaround.cpp
     void bugWorkaround();
 
+    // Functions with a cmd value can be called through the remote API.
     // Core IO Functions
     void setMode               ();         //cmd = 0
     void dWrite                ();         //cmd = 1
@@ -39,16 +42,19 @@ class Dino {
     void addDigitalListener    ();         //cmd = 5
     void addAnalogListener     ();         //cmd = 6
     void removeListener        ();         //cmd = 7
+    void updateListeners();
     void updateDigitalListeners();
     void updateAnalogListeners ();
     void clearDigitalListeners ();
     void clearAnalogListeners  ();
+
     // Listener State and Storage
     // Array indices mapped to board pins. true = listener enabled on that pin.
     // Cache last value for digital listeners and only send on change.
     boolean analogListeners[PIN_COUNT];
     boolean digitalListeners[PIN_COUNT];
     byte digitalListenerValues[PIN_COUNT];
+
     // Storage and response func for features following the pin:rval pattern.
     int rval;
     void coreResponse(int p, int v);
@@ -104,9 +110,6 @@ class Dino {
     boolean escaping;
     void append(byte c);
 
-    // Mostly a switch statement that decides what to run.
-    void process();
-
     // Parsed message storage.
     byte cmdStr[4]; int cmd;
     byte pinStr[4]; int pin;
@@ -132,5 +135,11 @@ class Dino {
     byte loopCount;
     byte analogDivider;
     byte registerDivider;
+
+    // Keep count of bytes as we receive them and send a dino message with how many.
+    uint8_t rcvBytes  = 0;
+    uint8_t rcvThreshold = 64;
+    unsigned long lastRcv = micros();
+    long long rcvWindow = 1000000;
 };
 #endif

From e8453ae7c0fd99bdfbee2003f22591d7c9a264f3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 13 Jan 2018 21:47:52 -0400
Subject: [PATCH 148/296] More flow control improvements.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Handshake uses Observable, and board doesn’t acknowledge handshake bytes, so we just reset buffer to 0 after handshake.
Scale tx and rx poll intervals based on ratio of successful reads/writes to rx/tx sleeps.
Refactored flow control and handshake into their own modules.r
---
 lib/dino/board.rb                           |  13 +-
 lib/dino/components/register/select.rb      |   1 -
 lib/dino/components/setup/input.rb          |   1 -
 lib/dino/tx_rx.rb                           |   2 +
 lib/dino/tx_rx/base.rb                      | 123 ++++-------------
 lib/dino/tx_rx/flow_control.rb              | 144 ++++++++++++++++++++
 lib/dino/tx_rx/handshake.rb                 |  48 +++++++
 lib/dino/tx_rx/serial.rb                    |  50 +++----
 lib/dino/tx_rx/tcp.rb                       |   9 +-
 spec/lib/board_spec.rb                      |  14 --
 spec/lib/components/register/select_spec.rb |   5 -
 spec/lib/components/setup/input_spec.rb     |   5 -
 spec/lib/tx_rx/serial_spec.rb               | 105 ++++++++------
 spec/lib/tx_rx/tcp_spec.rb                  |  10 +-
 src/lib/Dino.cpp                            |  12 +-
 15 files changed, 328 insertions(+), 214 deletions(-)
 create mode 100644 lib/dino/tx_rx/flow_control.rb
 create mode 100644 lib/dino/tx_rx/handshake.rb

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 60d7c575..864f7661 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -5,11 +5,10 @@ class Board
 
     def initialize(io, options={})
       @io, @components = io, []
-      io.add_observer(self)
-
       @analog_zero, @dac_zero = @io.handshake.to_s.split(",").map { |pin| pin.to_i }
+
+      io.add_observer(self)
       self.analog_resolution = options[:bits]
-      start_read
     end
 
     def analog_resolution=(value)
@@ -32,14 +31,6 @@ def heart_rate=(value)
       write Dino::Message.encode(command: 98, aux_message: value)
     end
 
-    def start_read
-      @io.read
-    end
-
-    def stop_read
-      @io.close_read
-    end
-
     def write(msg)
       @io.write(msg)
     end
diff --git a/lib/dino/components/register/select.rb b/lib/dino/components/register/select.rb
index 855f6814..6abe23ee 100644
--- a/lib/dino/components/register/select.rb
+++ b/lib/dino/components/register/select.rb
@@ -17,7 +17,6 @@ class Select
 
         def initialize_pins(options={})
           super(options) if defined?(super)
-          board.start_read
         end
       end
     end
diff --git a/lib/dino/components/setup/input.rb b/lib/dino/components/setup/input.rb
index b5a00557..6553224b 100644
--- a/lib/dino/components/setup/input.rb
+++ b/lib/dino/components/setup/input.rb
@@ -15,7 +15,6 @@ def initialize_pins(options={})
           super(options)
           self.mode = :in
           self.pullup = options[:pullup]
-          board.start_read
         end
       end
     end
diff --git a/lib/dino/tx_rx.rb b/lib/dino/tx_rx.rb
index d0399eae..a5983ad2 100644
--- a/lib/dino/tx_rx.rb
+++ b/lib/dino/tx_rx.rb
@@ -1,5 +1,7 @@
 module Dino
   module TxRx
+    require 'dino/tx_rx/flow_control'
+    require 'dino/tx_rx/handshake'
     require 'dino/tx_rx/base'
     require 'dino/tx_rx/serial'
     require 'dino/tx_rx/tcp'
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index f4cf87b3..bf823132 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -8,130 +8,53 @@ class TCPConnectError    < StandardError; end
     class HandshakeError     < StandardError; end
     class RxFlushTimeout     < StandardError; end
 
-    attr_accessor :sent_bytes
-
     class Base
       include Observable
-      BOARD_BUFFER = 64
-      HANDSHAKE_TRIES = 3
-      HANDSHAKE_TIMEOUT = 2
-
-      def io
-        @io ||= connect
+      # Let the methods in FlowControl wrap subclass methods too.
+      def self.inherited(subclass)
+        subclass.prepend FlowControl
       end
+      include Handshake
 
-      def read
-        @thread ||= Thread.new { loop { _read } }.abort_on_exception = true
-      end
+      def read(message);  raise "#read should be defined in TxRx subclasses";  end
+      def write(message); raise "#write should be defined in TxRx subclasses"; end
 
-      def close_read
-        return nil if @thread.nil?
-        Thread.kill(@thread)
-        @thread = nil
-      end
+    private
 
-      def write(message)
-        @write_mutex.synchronize { synced_write(message) }
+      def io
+        @io ||= connect
       end
 
-      def handshake
-        @sent_bytes = 0
-        initialize_flow_control
-        flush_read
-        HANDSHAKE_TRIES.times do |retries|
-          begin
-            Timeout.timeout(HANDSHAKE_TIMEOUT) do
-              print "Sending handshake to: #{self.to_s}... "
-              write Dino::Message.encode(command: 90)
-              loop do
-                line = gets
-                if line && line.match(/\AACK:/)
-                  flush_read
-                  ignore_retry_bytes(retries)
-                  puts "Acknowledged. Hardware ready...\n\n"
-                  return line.split(":", 2)[1]
-                end
-              end
-            end
-          rescue Timeout::Error
-            print "No response, "
-            puts (retries + 1 < HANDSHAKE_TRIES ? "retrying..." : "exiting...")
-            next
-          end
-        end
-        raise HandshakeError, "Connected to wrong device, or device not running dino"
+      def io_reset
+        flush_read; stop_read; start_read
       end
 
-    private
+      def connect(message); raise "#connect should be defined in TxRx subclasses"; end
 
       def flush_read
-        Timeout.timeout(5) do
-          gets until gets == nil
-        end
-      rescue Timeout::Error
+        Timeout.timeout(5) { read until read == nil }
+        rescue Timeout::Error
         raise RxFlushTimeout "Cannot read from device, or device not running dino"
       end
 
-      def synced_write(message)
-        @sent_bytes += message.length
-        while message && !message.empty?
-          bytes = BOARD_BUFFER - transit_bytes
-          if bytes > 0
-            fragment = message[0..(bytes-1)]
-            message  = message[bytes..-1]
-            io.write(fragment)
-            add_transit_bytes(fragment.length)
-          else
-            sleep 0.0005
-          end
-        end
+      def start_read
+        @thread ||= Thread.new { loop { read_and_process } }.abort_on_exception = true
       end
 
-      def connect(message); raise "#connect should be defined in TxRx subclasses"; end
-      def gets(message);    raise "#gets should be defined in TxRx subclasses";    end
-      def _write(message);  raise "#_write should be defined in TxRx subclasses";  end
-
-      def _read
-        line = gets
-        line ? process_line(line) : sleep(0.001)
+      def stop_read
+        return nil if @thread.nil?
+        Thread.kill(@thread)
+        @thread = nil
       end
 
-      def process_line(line)
+      def read_and_process(message); raise "#read_and_process should be defined in FlowControl module"; end
+
+      def process(line)
         if line.match(/\A\d+:/)
           pin, message = line.split(":", 2)
           pin && message && changed && notify_observers(pin, message)
-        elsif line.match(/\ARCV:/)
-          # This is acknowledgement from the board that bytes have been read
-          # out of the hardware buffer, freeing up that space.
-          # Subtract from the transit bytes so #synced_write can send more data.
-          remove_transit_bytes(line.split(/:/)[1].to_i)
         end
       end
-
-      # Subtract bytes for failed handshakes from the total in transit bytes.
-      # The board likely reset, dropping these bytes, and causing the retries.
-      def ignore_retry_bytes(retries)
-        retry_bytes = Dino::Message.encode(command: 90).length * retries
-        remove_transit_bytes(retry_bytes)
-      end
-
-      def initialize_flow_control
-        @flow_control  ||= Mutex.new
-        @write_mutex   ||= Mutex.new
-        @transit_bytes ||= 0
-      end
-
-      def transit_bytes
-        @flow_control.synchronize { @transit_bytes }
-      end
-
-      def add_transit_bytes(value)
-        @flow_control.synchronize { @transit_bytes = @transit_bytes + value }
-      end
-
-      def remove_transit_bytes(value)
-        @flow_control.synchronize { @transit_bytes = @transit_bytes - value }
-      end
     end
   end
 end
diff --git a/lib/dino/tx_rx/flow_control.rb b/lib/dino/tx_rx/flow_control.rb
new file mode 100644
index 00000000..d5a727b4
--- /dev/null
+++ b/lib/dino/tx_rx/flow_control.rb
@@ -0,0 +1,144 @@
+module Dino
+  module TxRx
+    module FlowControl
+      BOARD_BUFFER = 64
+      SLEEP_UPDATE_INTERVAL = 0.1
+      SLEEP_MIN = 0.00015625
+      SLEEP_MAX = 0.01
+
+      def initialize(*args)
+        reset_flow_control
+        super(*args)
+      end
+
+      def write(message)
+        add_write_call
+        @write_mutex.synchronize do
+          while message && !message.empty?
+            bytes = reserve_bytes(message.length)
+            if bytes > 0
+              fragment = message[0..(bytes-1)]
+              message = message[bytes..-1]
+              super(fragment)
+            else
+              tx_wait
+            end
+          end
+        end
+      end
+
+      # Keep the transit mutex lock for as little time as possible this way.
+      def reserve_bytes(length)
+        @transit_mutex.synchronize do
+          available = BOARD_BUFFER - @transit_bytes
+          reserved = (length > available) ? available : length
+          @transit_bytes += reserved
+          reserved
+        end
+      end
+
+    private
+
+      def reset_flow_control
+        @write_mutex    ||= Mutex.new
+        @transit_mutex  ||= Mutex.new
+        @tx_sleep_mutex ||= Mutex.new
+        @rx_sleep_mutex ||= Mutex.new
+        @transit_mutex.synchronize { @transit_bytes = 0 }
+
+        @tx_sleep_mutex.synchronize do
+          @tx_sleep        = SLEEP_MAX
+          @write_calls     = 0
+          @tx_sleep_calls  = 0
+        end
+
+        @rx_sleep_mutex.synchronize do
+          @rx_sleep        = SLEEP_MAX
+          @read_lines      = 0
+          @rx_sleep_calls  = 0
+        end
+
+        @last_interval_update = Time.now
+      end
+
+      def read_and_process
+        line = read
+
+        if line && line.match(/\AACK:/)
+          # Handle handshake responses by passing to the observing HandshakeAttempt.
+          # Also pass self so it can detach itself when done.
+          changed && notify_observers(self, line.split(":", 2)[1])
+          # Empty transit counter since ACK: won't also send RCV:
+          @transit_mutex.synchronize { @transit_bytes = 0 }
+        elsif line && line.match(/\ARCV:/)
+          remove_transit_bytes(line.split(/:/)[1].to_i)
+        elsif line
+          process(line)
+        else
+          rx_wait
+        end
+
+        add_read_line if line
+        update_sleep_intervals
+      end
+
+      def update_sleep_intervals
+        if (Time.now - @last_interval_update > SLEEP_UPDATE_INTERVAL)
+          @last_interval_update = Time.now
+          update_rx_sleep_interval
+          update_tx_sleep_interval
+        end
+      end
+
+      def update_tx_sleep_interval
+        @tx_sleep_mutex.synchronize do
+          if (@write_calls > 0) && (@tx_sleep_calls.to_f/@write_calls.to_f > 0.1)
+            @tx_sleep /= 2 if (@tx_sleep > SLEEP_MIN)
+          else
+            @tx_sleep *= 2 if (@tx_sleep < SLEEP_MAX)
+          end
+          @write_calls = 0
+          @tx_sleep_calls = 0
+        end
+      end
+
+      def update_rx_sleep_interval
+        @rx_sleep_mutex.synchronize do
+          if (@read_lines > 0) && (@read_lines.to_f/@rx_sleep_calls.to_f > 0.01)
+            @rx_sleep /= 2 if (@rx_sleep > SLEEP_MIN)
+          else
+            @rx_sleep *= 2 if (@rx_sleep < SLEEP_MAX)
+          end
+          @read_lines = 0
+          @rx_sleep_calls = 0
+        end
+      end
+
+      def add_write_call
+        @tx_sleep_mutex.synchronize { @write_calls += 1 }
+      end
+
+      def add_read_line
+        @rx_sleep_mutex.synchronize { @read_lines += 1 }
+      end
+
+      def rx_wait
+        @rx_sleep_mutex.synchronize { @rx_sleep_calls += 1 }
+        sleep @rx_sleep
+      end
+
+      def tx_wait
+        @tx_sleep_mutex.synchronize { @tx_sleep_calls += 1 }
+        sleep @tx_sleep
+      end
+
+      def add_transit_bytes(value)
+        @transit_mutex.synchronize { @transit_bytes = @transit_bytes + value }
+      end
+
+      def remove_transit_bytes(value)
+        @transit_mutex.synchronize { @transit_bytes = @transit_bytes - value }
+      end
+    end
+  end
+end
diff --git a/lib/dino/tx_rx/handshake.rb b/lib/dino/tx_rx/handshake.rb
new file mode 100644
index 00000000..9b2361a4
--- /dev/null
+++ b/lib/dino/tx_rx/handshake.rb
@@ -0,0 +1,48 @@
+module Dino
+  module TxRx
+    class HandshakeAttempt
+      attr_reader :acknowledged, :result
+      def initialize
+        @acknowledged = false
+        @result = nil
+      end
+
+      def update(sender, result)
+        @acknowledged = true
+        sender.delete_observer(self)
+        @result = result
+      end
+    end
+
+    module Handshake
+      HANDSHAKE_TRIES = 3
+      HANDSHAKE_TIMEOUT = 2
+
+      def handshake
+        io_reset
+        HANDSHAKE_TRIES.times do |retries|
+          begin
+            print "Sending handshake to: #{self.to_s}... "
+            self.add_observer(attempt = HandshakeAttempt.new)
+            write Dino::Message.encode(command: 90)
+
+            Timeout.timeout(HANDSHAKE_TIMEOUT) do
+              loop do
+                if attempt.acknowledged
+                  puts "Acknowledged. Hardware ready...\n\n"
+                  return attempt.result
+                end
+              end
+            end
+          rescue Timeout::Error
+            self.delete_observer(attempt)
+            print "No response, "
+            puts (retries + 1 < HANDSHAKE_TRIES ? "retrying..." : "exiting...")
+            next
+          end
+        end
+        raise HandshakeError, "Connected to wrong device, or device not running dino"
+      end
+    end
+  end
+end
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index 98968075..e5b18ad2 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -14,6 +14,31 @@ def to_s
         "#{@device} @ #{@baud} baud"
       end
 
+      def write(message)
+        io.write(message)
+      end
+
+      def read
+        buff, escaped = "", false
+        loop do
+          char = io.read(1)
+          if ["\n", "\\"].include? char
+            if escaped
+              buff << char
+              escaped = false
+            elsif (char == "\n")
+              return buff
+            elsif (char == "\\")
+              escaped = true
+            end
+          else
+            escaped = false
+            buff << char
+          end
+          return nil if (buff.empty? && !escaped)
+        end
+      end
+
     private
 
       def connect
@@ -49,31 +74,6 @@ def tty_devices
       def on_windows?
         RUBY_PLATFORM.match /mswin|mingw/i
       end
-
-      def _write(message)
-        io.write(message)
-      end
-
-      def gets(timeout=0)
-        buff, escaped = "", false
-        loop do
-          char = io.read(1)
-          if ["\n", "\\"].include? char
-            if escaped
-              buff << char
-              escaped = false
-            elsif (char == "\n")
-              return buff
-            elsif (char == "\\")
-              escaped = true
-            end
-          else
-            escaped = false
-            buff << char
-          end
-          return nil if (buff.empty? && !escaped)
-        end
-      end
     end
   end
 end
diff --git a/lib/dino/tx_rx/tcp.rb b/lib/dino/tx_rx/tcp.rb
index f9da020a..a75ad170 100644
--- a/lib/dino/tx_rx/tcp.rb
+++ b/lib/dino/tx_rx/tcp.rb
@@ -12,6 +12,7 @@ def to_s
       end
 
     private
+
       def connect
         print "Connecting to TCP at: #{self.to_s}... "
         connection = Timeout::timeout(10) { TCPSocket.open @host, @port }
@@ -21,17 +22,17 @@ def connect
         raise TCPConnectError, error.message
       end
 
-      def _write(message)
+      def write(message)
         loop do
-          if IO.select(nil, [io], nil)
+          if IO.select(nil, [io], nil, 0)
             io.syswrite(message)
             break
           end
         end
       end
 
-      def gets(timeout=0.005)
-        IO.select([io], nil, nil, timeout) && io.gets.gsub(/\n\z/, "")
+      def read
+        IO.select([io], nil, nil, 0) && io.gets.gsub(/\n\z/, "")
       end
     end
   end
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 1b941ba0..93dc81a7 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -74,20 +74,6 @@ def io_mock(methods = {})
       end
     end
 
-    describe '#start_read' do
-      it 'should tell the io to read' do
-        expect(io_mock).to receive(:read)
-        subject.start_read
-      end
-    end
-
-    describe '#stop_read' do
-      it 'should tell the io to read' do
-        expect(io_mock).to receive(:close_read)
-        subject.stop_read
-      end
-    end
-
     describe '#write' do
       it 'should call #write on the io with the message' do
         expect(io_mock).to receive(:write).with('message')
diff --git a/spec/lib/components/register/select_spec.rb b/spec/lib/components/register/select_spec.rb
index b644780f..3a15edb3 100644
--- a/spec/lib/components/register/select_spec.rb
+++ b/spec/lib/components/register/select_spec.rb
@@ -13,11 +13,6 @@ module Register
             expect(board).to receive(:set_pin_mode).with(10, :out)
             subject
           end
-
-          it 'should start the board reading' do
-            expect(board).to receive(:start_read)
-            subject
-          end
         end
 
         describe '#update' do
diff --git a/spec/lib/components/setup/input_spec.rb b/spec/lib/components/setup/input_spec.rb
index 4e7c1df8..817cdea5 100644
--- a/spec/lib/components/setup/input_spec.rb
+++ b/spec/lib/components/setup/input_spec.rb
@@ -32,11 +32,6 @@ class InputComponent
             expect(board).to receive(:set_pullup).with(subject.pin, true)
             InputComponent.new(options)
           end
-
-          it 'should tell the board to start reading' do
-            expect(board).to receive(:start_read)
-            subject
-          end
         end
       end
     end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index 1bfb8b3b..bcd017fd 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -2,11 +2,27 @@
 
 module Dino
   describe TxRx::Serial do
+    def mock_tty
+      @mock_tty ||= "/dev/mock_serial"
+    end
+
+    def mock_serial
+      @mock_serial ||= double("serial", read: "", write: nil)
+    end
+
+    subject {
+      Dino::TxRx::Serial.new
+    }
+
+    def io_instance
+      subject.send(:io)
+    end
+
     describe '#connect' do
       it 'should use the specified device and baud rate from options hash' do
-        expect(::Serial).to receive(:new).with("/dev/ttyACM0", 9600).and_return(mock_serial = double)
+        expect(::Serial).to receive(:new).with("/dev/ttyACM0", 9600).and_return(mock_serial)
         txrx = Dino::TxRx::Serial.new(device: "/dev/ttyACM0", baud: 9600)
-        expect(txrx.io).to equal mock_serial
+        expect(txrx.send(:io)).to equal mock_serial
       end
 
       context "on windows" do
@@ -16,11 +32,13 @@ module Dino
           Constants.redefine(:RUBY_PLATFORM, "mswin", :on => Object)
 
           # Simulate 3 COM ports with COM2 connected.
-          expect(subject).to receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
+          expect_any_instance_of(TxRx::Serial).to receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
           expect(::Serial).to receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise(RubySerial::Error)
-          expect(::Serial).to receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial = double)
+          expect(::Serial).to receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial)
           expect(::Serial).to_not receive(:new).with("COM3", TxRx::Serial::BAUD)
-          expect(subject.io).to equal(mock_serial)
+
+          txrx = TxRx::Serial.new
+          expect(txrx.send(:io)).to equal(mock_serial)
 
           # Set platform back to original value
           Constants.redefine(:RUBY_PLATFORM, original_platform, :on => Object)
@@ -29,96 +47,103 @@ module Dino
 
       context "on *nix" do
         it 'should create a new ::Serial for the first connected tty device if none specified' do
-          expect(subject).to receive(:tty_devices).and_return(['/dev/ttyACM0', '/dev/tty.usbmodem1'])
-
           # Simulate /dev/ttyACM0 connected.
-          expect(::Serial).to receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial = double)
+          expect_any_instance_of(TxRx::Serial).to receive(:tty_devices).and_return(['/dev/ttyACM0', '/dev/tty.usbmodem1'])
+          expect(::Serial).to receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial)
           expect(::Serial).to_not receive(:new).with('/dev/tty.usbmodem1', TxRx::Serial::BAUD)
-          expect(subject.io).to equal(mock_serial)
-        end
-      end
 
-      it 'should use the existing io instance if set' do
-        expect(subject).to receive(:tty_devices).once.and_return(['/dev/tty.ACM0'])
-        expect(::Serial).to receive(:new).and_return(mock_serial = double)
-        3.times { subject.io }
-        expect(subject.io).to equal(mock_serial)
+          txrx = TxRx::Serial.new
+          expect(txrx.send(:io)).to equal(mock_serial)
+        end
       end
 
       it 'should raise SerialConnectError if it cannot connect to a board' do
         allow(::Serial).to receive(:new).and_raise(RubySerial::Error)
-        expect { subject.io }.to raise_exception Dino::TxRx::SerialConnectError
+        expect { TxRx::Serial.new.send(:io) }.to raise_exception Dino::TxRx::SerialConnectError
+      end
+    end
+
+    describe '#io_reset' do
+      it 'should call flush read, stop read, and start read' do
+        expect(subject).to receive(:flush_read).and_return true
+        expect(subject).to receive(:stop_read).and_return true
+        expect(subject).to receive(:start_read).and_return true
+        subject.send(:io_reset)
       end
     end
 
-    describe '#_read' do
+    describe '#read_and_process' do
       it 'should notify observers on change' do
-        expect(subject).to receive(:gets).and_return("02:00")
+        expect(subject).to receive(:read).and_return("02:00")
         expect(subject).to receive(:changed).and_return(true)
         expect(subject).to receive(:notify_observers).with('02','00')
-        subject.send(:_read)
+        subject.send(:read_and_process)
       end
 
       it 'should not split messages into more than 2 parts on :' do
-        expect(subject).to receive(:gets).and_return("02:00:00")
+        expect(subject).to receive(:read).and_return("02:00:00")
         expect(subject).to receive(:changed).and_return(true)
         expect(subject).to receive(:notify_observers).with('02','00:00')
-        subject.send(:_read)
+        subject.send(:read_and_process)
       end
     end
 
-    describe '#read' do
+    describe '#start_read' do
       it 'should create a new thread and start looping' do
         expect(Thread).to receive(:new).and_yield.and_return(double("abort_on_exception=" => true))
         expect(subject).to receive(:loop)
-        subject.read
+        subject.send(:start_read)
       end
     end
 
-    describe '#close_read' do
+    describe '#stop_read' do
       it 'should kill the reading thread' do
         subject.instance_variable_set(:@thread, mock_thread = double)
         expect(Thread).to receive(:kill).with(mock_thread)
-        subject.read
-        subject.close_read
+        subject.send(:start_read)
+        subject.send(:stop_read)
       end
     end
 
     describe '#write' do
       it 'should write to the device' do
-        expect(subject).to receive(:io).and_return(mock_serial = double)
+        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial)
         expect(mock_serial).to receive(:write).with('a message')
-        subject.send(:initialize_flow_control)
         subject.write('a message')
       end
-
       it 'should break up messages larger than the board input buffer'
     end
 
-    describe '#gets' do
+    describe '#read' do
+      before :each do
+        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial)
+      end
+
       it 'should read single characters until it hits a newline and strip it' do
-        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
         expect(mock_serial).to receive(:read).exactly(5).times.with(1).and_return("l", "i", "n", "e", "\n")
-        expect(subject.send(:gets)).to eq("line")
+        expect(subject.send(:read)).to eq("line")
       end
 
       it 'should catch escaped newlines' do
-        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
         expect(mock_serial).to receive(:read).exactly(7).times.with(1).and_return("l", "1", "\\", "\n", "l", "2", "\n")
-        expect(subject.send(:gets)).to eq("l1\nl2")
+        expect(subject.send(:read)).to eq("l1\nl2")
       end
 
       it 'should return a blank string if there is just a newline' do
-        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
         expect(mock_serial).to receive(:read).exactly(1).times.with(1).and_return("\n")
-        expect(subject.send(:gets)).to eq("")
+        expect(subject.send(:read)).to eq("")
       end
 
       it 'should allow escaped backslashes' do
-        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial = double)
-        expect(mock_serial).to receive(:read).exactly(3).times.with(1).and_return("\\", "\\", "\n")
-        expect(subject.send(:gets)).to eq("\\")
+        expect(io_instance).to receive(:read).exactly(3).times.with(1).and_return("\\", "\\", "\n")
+        expect(subject.send(:read)).to eq("\\")
       end
     end
+
+    describe '#handshake' do
+      it 'should call #io_reset'
+      it 'should write again after timeout'
+      it 'should return the value from the ACK'
+    end
   end
 end
diff --git a/spec/lib/tx_rx/tcp_spec.rb b/spec/lib/tx_rx/tcp_spec.rb
index c610bf3a..e2424564 100644
--- a/spec/lib/tx_rx/tcp_spec.rb
+++ b/spec/lib/tx_rx/tcp_spec.rb
@@ -10,12 +10,12 @@ module Dino
 
     describe "#connect" do
       it 'should raise a TCPConnectError exception if it cannot connect to the server' do
-        expect { @instance.io }.to raise_exception Dino::TxRx::TCPConnectError
+        expect { @instance.send :io }.to raise_exception Dino::TxRx::TCPConnectError
       end
 
       it 'should return the TCPSocket if connected' do
         @server = TCPServer.new @port
-        expect(@instance.io).to be_a(TCPSocket)
+        expect(@instance.send :io).to be_a(TCPSocket)
         @server.close
       end
     end
@@ -23,13 +23,13 @@ module Dino
     describe '#io' do
       it 'should set io to a new TCPSocket with the specified host and port' do
         expect(TCPSocket).to receive(:open).with(@host, @port)
-        @instance.io
+        @instance.send :io
       end
 
       it 'should use the existing io instance if set' do
         @server = TCPServer.new @port
-        socket = @instance.io
-        expect(@instance.io).to equal(socket)
+        socket = @instance.send :io
+        expect(@instance.send :io).to equal(socket)
         @server.close
       end
     end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index ee366a1d..8a591d22 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -20,14 +20,17 @@ void Dino::acknowledge() {
 }
 
 void Dino::run(){
+  boolean gotByte = false;
+
   while(stream->available() > 0) {
+    gotByte = true;
+    rcvBytes ++;
     parse(stream->read());
 
-    // Acknowledge when we've received as many bytes as the serial input buffer.
-    lastRcv = micros();
-    rcvBytes ++;
+    // Acknowledge when we've received as many bytes as the serial input buffer
     if (rcvBytes == rcvThreshold) acknowledge();
   }
+  if (gotByte) lastRcv = micros();
 
   // Also acknowledge when the last byte received goes outside the receive window.
   if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
@@ -224,6 +227,9 @@ void Dino::updateListeners() {
 void Dino::reset() {
   resetState();
 
+  // Reset this so we never send RCV: along with ACK:
+  rcvBytes = 0;
+
   stream->print("ACK:");
   stream->print(A0);
   #if defined(__SAM3X8E__)

From eeebd6b3a9a5a088d8c47f93c377319a4022cdaf Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 13 Jan 2018 22:38:56 -0400
Subject: [PATCH 149/296] Fix bug causing first servo pin used to be assigned
 to all objects.

---
 src/lib/DinoServo.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/lib/DinoServo.cpp b/src/lib/DinoServo.cpp
index 195503e4..6691e353 100644
--- a/src/lib/DinoServo.cpp
+++ b/src/lib/DinoServo.cpp
@@ -43,6 +43,7 @@ void Dino::servoToggle() {
         found = true;
         servos[i].servo.attach(pin);
         servos[i].active = true;
+        break;
       }
     }
     // If it doesn't exist, use the first inactive object.
@@ -51,6 +52,7 @@ void Dino::servoToggle() {
         if (servos[i].active == false) {
           servos[i].servo.attach(pin);
           servos[i].active = true;
+          break;
         }
       }
     }

From e316a26f64bebe40909c9ca4a800164f3cac292b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 14 Jan 2018 01:46:54 -0400
Subject: [PATCH 150/296] Give every listener its own divider and just tick
 every 1ms instead.

---
 lib/dino/board.rb      |  56 +++++++++++++-------
 spec/lib/board_spec.rb |  25 +++++++--
 src/dino_serial.ino    |   5 +-
 src/lib/Dino.cpp       |  71 ++++++++-----------------
 src/lib/Dino.h         |  52 ++++++++++---------
 src/lib/DinoCoreIO.cpp | 114 ++++++++++++++++++++---------------------
 6 files changed, 169 insertions(+), 154 deletions(-)

diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 864f7661..1bb583cd 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -6,9 +6,8 @@ class Board
     def initialize(io, options={})
       @io, @components = io, []
       @analog_zero, @dac_zero = @io.handshake.to_s.split(",").map { |pin| pin.to_i }
-
       io.add_observer(self)
-      self.analog_resolution = options[:bits]
+      self.analog_resolution = options[:bits] || 8
     end
 
     def analog_resolution=(value)
@@ -19,18 +18,6 @@ def analog_resolution=(value)
       @analog_high = (2 ** @bits) - 1
     end
 
-    def analog_divider=(value)
-      unless DIVIDERS.include? value
-        puts "Analog divider must be in #{DIVIDERS.inspect}"
-      else
-        write Dino::Message.encode(command: 97, value: value)
-      end
-    end
-
-    def heart_rate=(value)
-      write Dino::Message.encode(command: 98, aux_message: value)
-    end
-
     def write(msg)
       @io.write(msg)
     end
@@ -66,9 +53,9 @@ def set_pullup(pin, pullup)
       digital_read:    '2',
       analog_write:    '3',
       analog_read:     '4',
-      digital_listen:  '5',
-      analog_listen:   '6',
-      stop_listener:   '7',
+      # unused:        '5',
+      # unused:        '6',
+      set_listener:    '7',
       servo_toggle:    '8',
       servo_write:     '9',
       # LCD            '10'
@@ -79,7 +66,7 @@ def set_pullup(pin, pullup)
       ds18b20_read:    '15',
       # IR send:       '16'
       tone:            '17',
-      no_tone:         '18'
+      no_tone:         '18',
     }
 
     PIN_COMMANDS.each_key do |command|
@@ -93,6 +80,39 @@ def tone(pin, value, duration)
       write Dino::Message.encode(command: PIN_COMMANDS[:tone], pin: convert_pin(pin), value: value, aux_message: duration)
     end
 
+    def set_listener(pin, state=:off, options={})
+      mode    = options[:mode]    || :digital
+      divider = options[:divider] || 8
+
+      unless [:digital, :analog].include? mode
+        raise "Mode must be either digital or analog"
+      end
+      unless DIVIDERS.include? divider
+        raise "Listener divider must be in #{DIVIDERS.inspect}"
+      end
+
+      # Create a bit mask for the settings we want to use. Gets sent in value.
+      mask = 0
+      mask |= 0b10000000 if (state == :on)
+      mask |= 0b01000000 if (mode == :analog)
+      mask |= Math.log2(divider).to_i
+
+      write Dino::Message.encode(command: PIN_COMMANDS[:set_listener], pin: convert_pin(pin), value: mask)
+    end
+
+    # Implement the simpler methods by wrapping set_listener with old defaults.
+    def digital_listen(pin, divider=4)
+      set_listener(pin, :on, mode: :digital, divider: divider)
+    end
+
+    def analog_listen(pin, divider=16)
+      set_listener(pin, :on, mode: :analog, divider: divider)
+    end
+
+    def stop_listener(pin)
+      set_listener(pin, :off)
+    end
+
     DIGITAL_REGEX = /\A\d+\z/i
     ANALOG_REGEX = /\A(a)\d+\z/i
     DAC_REGEX = /\A(dac)\d+\z/i
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index 93dc81a7..e549759e 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -161,23 +161,42 @@ def io_mock(methods = {})
       end
     end
 
+    describe '#set_listener' do
+      it 'should set the right pin' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b00000011)
+        subject.set_listener(11, :off)
+      end
+      it 'should set the right mode' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b01000011)
+        subject.set_listener(11, :off, mode: :analog)
+      end
+      it 'should set the right state' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b11000011)
+        subject.set_listener(11, :on, mode: :analog)
+      end
+      it 'should set the right divider' do
+        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b11000000)
+        subject.set_listener(11, :on, mode: :analog, divider: 1)
+      end
+    end
+
     describe '#digital_listen' do
       it 'should start listening for a digital signal on the given pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 5, pin: 13)
+        expect(subject).to receive(:set_listener).with(13, :on, mode: :digital, divider: 4)
         subject.digital_listen(13)
       end
     end
 
     describe '#analog_listen' do
       it 'should start listening for an analog signal on the given pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 6, pin: 13)
+        expect(subject).to receive(:set_listener).with(13, :on, mode: :analog, divider: 16)
         subject.analog_listen(13)
       end
     end
 
     describe '#stop_listener' do
       it 'should stop listening for any signal on the given pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 13)
+        expect(subject).to receive(:set_listener).with(13, :off)
         subject.stop_listener(13)
       end
     end
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 3c3eceaf..a89ddf72 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -2,8 +2,9 @@
 
 Dino dino;
 
-// Define 'serial' as the serial interface on teh device that we want to use.
-// Defaults to Native USB port on the Due.
+// Define 'serial' as the serial interface we want to use.
+// Defaults to Native USB port on the Due, whatever class "Serial" is on everything else.
+// Classes need to inherit from Stream to be compatible with the Dino library.
 #if defined(__SAM3X8E__)
 #define serial SerialUSB
 //#define serial Serial
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 8a591d22..e350c68f 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -106,9 +106,7 @@ void Dino::process() {
     case 2:  dRead               (pin); break;
     case 3:  aWrite              ();    break;
     case 4:  aRead               (pin); break;
-    case 5:  addDigitalListener  ();    break;
-    case 6:  addAnalogListener   ();    break;
-    case 7:  removeListener      ();    break;
+    case 7:  setListener         ();    break;
 
     // Implemented in DinoServo.cpp
     #ifdef DINO_SERVO
@@ -174,10 +172,8 @@ void Dino::process() {
 
     // Implemented in this file.
     case 90: reset               ();  break;
-    case 95: setAnalogDivider    ();  break;
+    case 95: setRegisterDivider  ();  break;
     case 96: setAnalogResolution ();  break;
-    case 97: setAnalogDivider    ();  break;
-    case 98: setHeartRate        ();  break;
 
     // Should send a "feature not implemented" message as default.
     default:                          break;
@@ -195,30 +191,30 @@ void Dino::setOutputStream(Stream* callback){
   stream = callback;
 }
 
-
-// Every heartRate microseconds, read the digital listeners and send values if changed.
-// Analog listeners use a divider to run at a fraction of that frequency.
-// Register listeners (Shift, I2C and SPI) all share a second divider value.
+//
+// Every 1000 microseconds count a tick and call the listeners.
+// Each core listener has its own divider, so it can read every
+// 1, 2, 4, 8, 16, 32, 64 or 128 ticks, independent of the others.
+//
+// Register listeners are still on a global divider for now.
 // Analog and register listeners always send values even if not changed.
-// See Dino::reset for default timings.
+// Digital listeners only send values on change.
+//
 void Dino::updateListeners() {
   unsigned long now = micros();
-  if ((now - lastUpdate) > heartRate) {
-    // Digital Listeners
-    lastUpdate = now;
-    loopCount++;
-    updateDigitalListeners();
+  if ((now - lastTick) > 1000) {
+    lastTick = now;
+    tickCount++;
+
+    updateCoreListeners(tickCount);
 
     // Register Listeners
     #ifdef DINO_SHIFT
-      if (loopCount % registerDivider == 0) updateShiftListeners();
+      if (tickCount % registerDivider == 0) updateShiftListeners();
     #endif
     #ifdef DINO_SPI
-      if (loopCount % registerDivider == 0) updateSpiListeners();
+      if (tickCount % registerDivider == 0) updateSpiListeners();
     #endif
-
-    // Analog Listeners
-    if (loopCount % analogDivider   == 0) updateAnalogListeners();
   }
 }
 
@@ -241,22 +237,19 @@ void Dino::reset() {
 
 
 void Dino::resetState() {
-  // Disable all the types of listeners.
-  clearDigitalListeners();
-  clearAnalogListeners();
+  clearCoreListeners();
+  lastActiveListener = 0;
   #ifdef DINO_SPI
     clearSpiListeners();
   #endif
   #ifdef DINO_SHIFT
     clearShiftListeners();
   #endif
-  heartRate = 4000;    // Update digital listeners every ~4ms.
-  analogDivider   = 4; // Update analog listeners every ~16ms.
-  registerDivider = 2; // Update register listeners every ~8ms.
+  registerDivider = 8; // Update register listeners every ~8ms.
   fragmentIndex = 0;
   charIndex = 0;
-  loopCount = 0;
-  lastUpdate = micros();
+  tickCount = 0;
+  lastTick = micros();
 }
 
 
@@ -281,23 +274,3 @@ void Dino::setAnalogResolution() {
     Serial.print("Called Dino::setAnalogResolution()\n");
   #endif
 }
-
-
-// CMD = 97
-// Set the analog divider. Powers of 2 up to 128 are valid.
-void Dino::setAnalogDivider() {
-  analogDivider = val;
-  #ifdef debug
-    Serial.print("Called Dino::setAnalogDivider()\n");
-  #endif
-}
-
-
-// CMD = 98
-// Set the heart rate in milliseconds. Store it in microseconds.
-void Dino::setHeartRate() {
-  heartRate = atoi((char *)auxMsg);
-  #ifdef debug
-    Serial.print("Called Dino::setHeartRate()\n");
-  #endif
-}
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 51756a4a..81c27c96 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -39,21 +39,29 @@ class Dino {
     void aRead                 (int pin);  //cmd = 4
 
     // Core IO Listeners
-    void addDigitalListener    ();         //cmd = 5
-    void addAnalogListener     ();         //cmd = 6
-    void removeListener        ();         //cmd = 7
-    void updateListeners();
-    void updateDigitalListeners();
-    void updateAnalogListeners ();
-    void clearDigitalListeners ();
-    void clearAnalogListeners  ();
-
-    // Listener State and Storage
-    // Array indices mapped to board pins. true = listener enabled on that pin.
-    // Cache last value for digital listeners and only send on change.
-    boolean analogListeners[PIN_COUNT];
-    boolean digitalListeners[PIN_COUNT];
-    byte digitalListenerValues[PIN_COUNT];
+    void setListener           ();         //cmd = 7
+    void updateListeners       ();
+    void updateCoreListeners   (byte tickCount);
+    void digitalListenerUpdate (byte index);
+    void clearCoreListeners    ();
+
+    //
+    // Store listeners as a 2 dimensional array where each gets 2 bytes, such that:
+    //
+    // byte 0, bit 7   : 1 for listener enabled, 0 for listener disabled.
+    // byte 0, bit 6   : 1 for analog listener, 0 for digital listener.
+    // byte 0, bit 5   : storage for digital listener state
+    // byte 0, bits 4-3: unused
+    // byte 0, bits 2-0: timing divider exponent specific to this pin, 2^0 through 2^8
+    //
+    // byte 1          : pin number
+    //
+    byte listeners [PIN_COUNT][2];
+
+    // Track the highest number listener that's active.
+    byte lastActiveListener;
+    // Map 2's exponents for dividers to save time.
+    const byte dividerMap[8] = {1, 2, 4, 8, 16, 32, 64, 128};
 
     // Storage and response func for features following the pin:rval pattern.
     int rval;
@@ -100,8 +108,6 @@ class Dino {
     void resetState            ();
     void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
-    void setAnalogDivider      ();  //cmd = 97
-    void setHeartRate          ();  //cmd = 98
 
     // Parser state storage and utility functions.
     byte *messageFragments[4];
@@ -111,9 +117,9 @@ class Dino {
     void append(byte c);
 
     // Parsed message storage.
-    byte cmdStr[4]; int cmd;
-    byte pinStr[4]; int pin;
-    byte valStr[4]; int val;
+    byte cmdStr[4]; byte cmd;
+    byte pinStr[4]; byte pin;
+    byte valStr[4]; byte val;
 
     // Scale aux message allocation based on enabled features and chip.
     #if defined(DINO_IR_OUT) && !defined (__AVR_ATmega168__)
@@ -130,10 +136,8 @@ class Dino {
     Stream* stream;
 
     // Internal timing variables and utility functions.
-    unsigned long heartRate;
-    unsigned long lastUpdate;
-    byte loopCount;
-    byte analogDivider;
+    unsigned long lastTick;
+    byte tickCount;
     byte registerDivider;
 
     // Keep count of bytes as we receive them and send a dino message with how many.
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index adac92f5..acd18790 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -4,7 +4,6 @@
 // Set a pin to output (0), or input (1).
 void Dino::setMode() {
   if (val == 0) {
-    removeListener();
     pinMode(pin, OUTPUT);
   }
   else {
@@ -74,74 +73,73 @@ void Dino::coreResponse(int p, int v){
   stream->print('\n');
 }
 
-
-// CMD = 05
-// Set a flag to periodically read a digital pin without further requests.
-// Runs around other requests in the main loop. Only sends value when changed.
-void Dino::addDigitalListener() {
-  removeListener();
-  digitalListeners[pin] = true;
-  digitalListenerValues[pin] = 2;
-
-  #ifdef debug
-    Serial.print("Called Dino::addDigitalListener()\n");
-  #endif
-}
-
-// CMD = 06
-// Set a flag to periodically read an analog pin without further requests.
-// Runs around other requests in the main loop. Sends value on every read.
-void Dino::addAnalogListener() {
-  removeListener();
-  analogListeners[pin] = true;
-
-  #ifdef debug
-    Serial.print("Called Dino::addAnalogListener()\n");
-  #endif
-}
-
 // CMD = 07
-// Remove analog and digital listen flags on the pin.
-void Dino::removeListener() {
-  analogListeners[pin] = false;
-  digitalListeners[pin] = false;
-
-  #ifdef debug
-    Serial.print("Called Dino::removeListener()\n");
-  #endif
-}
+// Set a listener ON or OFF, or change its type, or divider.
+// Takes settings as binary stored in val from the parser and applies
+// them to an existing listener if pin was already used, or first inactive.
+void Dino::setListener(){
+  boolean found = false;
+  // Check if previously assigned a listener to this pin and re-use.
+  for(byte i=0; i<PIN_COUNT; i++){
+    if (listeners[i][1] == pin){
+      listeners[i][0] = val;
+      found = true;
+      break;
+    }
+  }
 
-// Gets called by Dino::updateListeners to run listeners in the main loop.
-// Reads each digital listen pin and sends value if changed from last read.
-void Dino::updateDigitalListeners() {
-  for (int i = 0; i < PIN_COUNT; i++) {
-    if (digitalListeners[i]) {
-      rval = digitalRead(i);
-      if (rval != digitalListenerValues[i]) {
-        digitalListenerValues[i] = rval;
-        coreResponse(i, rval);
+  // If this pin wasn't used before, take the fist inactive one.
+  if (!found){
+    for(byte i=0; i<PIN_COUNT; i++){
+      if (bitRead(listeners[i][0], 7) == 0){
+        listeners[i][0] = val;
+        listeners[i][1] = pin;
+        break;
       }
     }
   }
+
+  // Update the last active listener whenever we make a change.
+  for(byte i=0; i<PIN_COUNT; i++){
+    if (bitRead(listeners[i][0], 7) == 1){
+      lastActiveListener = i;
+    }
+  }
 }
 
-// Gets called by Dino::updateListeners to run listeners in the main loop.
-// Reads each analog listen pin and sends value always. Does not store last value.
-void Dino::updateAnalogListeners() {
-  for (int i = 0; i < PIN_COUNT; i++) {
-    if (analogListeners[i]) {
-      aRead(i);
+void Dino::updateCoreListeners(byte tickCount){
+  for (byte i = 0; i <= lastActiveListener; i++){
+    // Check if active.
+    if (bitRead(listeners[i][0], 7) == 1){
+      // Check if to update it on this tick.
+      byte exponent = 0b111 & listeners[i][0];
+      byte divider = dividerMap[exponent];
+      if(tickCount % divider == 0){
+        // Check if digital or analog.
+        if (bitRead(listeners[i][0], 6) == 1){
+          aRead(listeners[i][1]);
+        } else {
+          digitalListenerUpdate(i);
+        }
+      }
     }
   }
 }
 
-// Gets called by Dino::reset to clear all digital listeners.
-void Dino::clearDigitalListeners(){
-  for (int i = 0; i < PIN_COUNT; i++) digitalListeners[i] = false;
-  for (int i = 0; i < PIN_COUNT; i++) digitalListenerValues[i] = 2;
+void Dino::digitalListenerUpdate(byte i){
+  rval = digitalRead(listeners[i][1]);
+  // Previous state is stored in the 5th bit of the first byte.
+  // If changed, update it and send the message.
+  if (rval != bitRead(listeners[i][0], 5)){
+    bitWrite(listeners[i][0], 5, rval);
+    coreResponse(listeners[i][1], rval);
+  }
 }
 
-// Gets called by Dino::reset to clear all analog listeners.
-void Dino::clearAnalogListeners(){
-  for (int i = 0; i < PIN_COUNT; i++) analogListeners[i] = false;
+// Gets called by Dino::reset to clear all core listeners.
+void Dino::clearCoreListeners(){
+  for (int i = 0; i < PIN_COUNT; i++){
+    listeners[i][0] = 0;
+    listeners[i][1] = 0;
+  }
 }

From 326f12983f41bb7d7438cc42b987b1407bcd89c3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 14 Jan 2018 02:53:17 -0400
Subject: [PATCH 151/296] Add rotary encoder component by polling @1ms with the
 new listeners.

---
 examples/rotary_encoder/rotary_encoder.rb     | 17 +++++++++++
 lib/dino/components.rb                        |  1 +
 lib/dino/components/basic/analog_input.rb     |  5 ++--
 lib/dino/components/basic/digital_input.rb    |  5 ++--
 lib/dino/components/mixins/listener.rb        |  4 +--
 lib/dino/components/rotary_encoder.rb         | 29 +++++++++++++++++++
 .../lib/components/basic/analog_input_spec.rb |  2 +-
 .../components/basic/digital_input_spec.rb    |  4 +--
 8 files changed, 58 insertions(+), 9 deletions(-)
 create mode 100644 examples/rotary_encoder/rotary_encoder.rb
 create mode 100644 lib/dino/components/rotary_encoder.rb

diff --git a/examples/rotary_encoder/rotary_encoder.rb b/examples/rotary_encoder/rotary_encoder.rb
new file mode 100644
index 00000000..2dc2085f
--- /dev/null
+++ b/examples/rotary_encoder/rotary_encoder.rb
@@ -0,0 +1,17 @@
+#
+# Example of a smiple rotary encoder polling at ~1ms.
+# Not as precise as using an interrupt and hardware debounce, but should be OK
+# at lower speeds. 1ms polling is kind of a free software debounce anyway?
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+encoder = Dino::Components::RotaryEncoder.new board: board,
+                                              pins:{ data: 4, clock: 5 }
+
+encoder.add_callback do |data|
+  puts "Encoder position: #{data}"
+end
+
+sleep
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index eeceb214..e1a62fd0 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -19,5 +19,6 @@ module Components
     autoload :DS18B20,          'dino/components/ds18b20'
     autoload :IREmitter,        'dino/components/ir_emitter'
     autoload :Piezo,            'dino/components/piezo'
+    autoload :RotaryEncoder,    'dino/components/rotary_encoder'
   end
 end
diff --git a/lib/dino/components/basic/analog_input.rb b/lib/dino/components/basic/analog_input.rb
index 3d46c6b3..5e3ebb08 100644
--- a/lib/dino/components/basic/analog_input.rb
+++ b/lib/dino/components/basic/analog_input.rb
@@ -12,8 +12,9 @@ def _read
           board.analog_read(self.pin)
         end
 
-        def _listen
-          board.analog_listen(self.pin)
+        def _listen(divider=16)
+          divider ||= 16
+          board.analog_listen(self.pin, divider)
         end
       end
     end
diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index 912f1690..db24b99b 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -17,8 +17,9 @@ def _read
           board.digital_read(self.pin)
         end
 
-        def _listen
-          board.digital_listen(self.pin)
+        def _listen(divider=4)
+          divider ||= 4
+          board.digital_listen(self.pin, divider)
         end
 
         def on_high(&block)
diff --git a/lib/dino/components/mixins/listener.rb b/lib/dino/components/mixins/listener.rb
index 9e1e040e..9db58fbb 100644
--- a/lib/dino/components/mixins/listener.rb
+++ b/lib/dino/components/mixins/listener.rb
@@ -4,10 +4,10 @@ module Mixins
       module Listener
       	include Callbacks
 
-        def listen(&block)
+        def listen(divider=nil, &block)
           stop
           add_callback(:listen, &block) if block_given?
-          _listen
+          _listen(divider)
         end
 
         def stop
diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
new file mode 100644
index 00000000..53e45006
--- /dev/null
+++ b/lib/dino/components/rotary_encoder.rb
@@ -0,0 +1,29 @@
+module Dino
+  module Components
+    class RotaryEncoder
+      include Setup::MultiPin
+      include Mixins::Callbacks
+
+      proxy_pins data: Basic::DigitalInput,
+                 clock: Basic::DigitalInput
+
+      def after_initialize(options={})
+        super(options) if defined?(super)
+        @state = 0
+
+        # Stop the default behavior of the DigitalInput instances.
+        clock.stop; data.stop;
+        clock.listen(1); data.listen(1)
+        sleep 0.5
+
+        start
+      end
+
+      def start
+        proxies[:clock].add_callback do |clock_state|
+          (data.state == clock_state) ? self.update(@state + 1) : self.update(@state - 1)
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/basic/analog_input_spec.rb b/spec/lib/components/basic/analog_input_spec.rb
index f5d95908..69ae26b8 100644
--- a/spec/lib/components/basic/analog_input_spec.rb
+++ b/spec/lib/components/basic/analog_input_spec.rb
@@ -17,7 +17,7 @@ module Basic
 
         describe '#_listen' do
           it 'should send #analog_listen to the board with its pin' do
-            expect(board).to receive(:analog_listen).with(subject.pin)
+            expect(board).to receive(:analog_listen).with(subject.pin, 16)
             subject._listen
           end
         end
diff --git a/spec/lib/components/basic/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
index 56f62e2c..dd82fde2 100644
--- a/spec/lib/components/basic/digital_input_spec.rb
+++ b/spec/lib/components/basic/digital_input_spec.rb
@@ -9,7 +9,7 @@ module Basic
         subject { DigitalInput.new(options) }
 
         it 'should start listening immediately' do
-          expect(board).to receive(:digital_listen).with(14)
+          expect(board).to receive(:digital_listen).with(14, 4)
           component = DigitalInput.new(options)
         end
 
@@ -22,7 +22,7 @@ module Basic
 
         describe '#_listen' do
           it 'should call board#digital_listen with its pin once' do
-            expect(board).to receive(:digital_listen).with(subject.pin).once
+            expect(board).to receive(:digital_listen).with(subject.pin, 4).once
             subject._listen
           end
         end

From 98cdd4ece63c55d5419c36035c6955c8733923a1 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 14 Jan 2018 17:30:53 -0400
Subject: [PATCH 152/296] RotaryEncoder tracks position in degrees. Add Mac
 volume control example.

Minor changes to MultiPin and Callbacks so they work better together. Classes can now mutate the value before it gets passed to callbacks, and override the automatic state update after callbacks, without overriding #update entirely. RotaryEncoder class does both.
---
 examples/rotary_encoder/rotary_encoder.rb     | 12 ++--
 .../rotary_encoder_mac_volume.rb              | 57 +++++++++++++++++++
 lib/dino/components/mixins/callbacks.rb       | 31 +++++++++-
 lib/dino/components/rotary_encoder.rb         | 49 +++++++++++++---
 lib/dino/components/setup/multi_pin.rb        |  3 +-
 spec/lib/components/setup/multi_pin_spec.rb   |  4 +-
 6 files changed, 140 insertions(+), 16 deletions(-)
 create mode 100644 examples/rotary_encoder/rotary_encoder_mac_volume.rb

diff --git a/examples/rotary_encoder/rotary_encoder.rb b/examples/rotary_encoder/rotary_encoder.rb
index 2dc2085f..e5a26af3 100644
--- a/examples/rotary_encoder/rotary_encoder.rb
+++ b/examples/rotary_encoder/rotary_encoder.rb
@@ -1,17 +1,21 @@
 #
 # Example of a smiple rotary encoder polling at ~1ms.
-# Not as precise as using an interrupt and hardware debounce, but should be OK
-# at lower speeds. 1ms polling is kind of a free software debounce anyway?
+#
+# WARNING: This method is not precise at all. Please do not use it for anything
+# that requires all steps to be read for precise positioning or high speed.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 encoder = Dino::Components::RotaryEncoder.new board: board,
-                                              pins:{ data: 4, clock: 5 }
+                                              pins:{ clock: 4, data: 5 },
+                                              divider: 1, # (default) read approx every divider ms
+                                              steps: 30   # (default) steps / revolution
 
 encoder.add_callback do |data|
-  puts "Encoder position: #{data}"
+  puts "Encoder position: #{data[:position]}°"
+  puts "Encoder change: #{data[:change]}"
 end
 
 sleep
diff --git a/examples/rotary_encoder/rotary_encoder_mac_volume.rb b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
new file mode 100644
index 00000000..bc80a479
--- /dev/null
+++ b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
@@ -0,0 +1,57 @@
+#
+# Example of a smiple rotary encoder polling at ~1ms.
+#
+# WARNING: This method is not precise at all. Please do not use it for anything
+# that requires all steps to be read for precise positioning or high speed.
+#
+# Works well enough for making knobs like this example though.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+encoder = Dino::Components::RotaryEncoder.new board: board,
+                                              pins:{ clock: 4, data: 5 },
+                                              divider: 1, # (default) read approx every divider ms
+                                              steps: 30   # (default) steps / revolution
+
+# Set up a pseudo terminal with osascript (AppleScript) in interactive mode.
+# Calling a separate script each update is too slow.
+class AppleVolumeWrapper
+  require 'pty'
+  require 'expect'
+
+  def initialize
+    @in, @out, pid = PTY.spawn('osascript -i')
+    @in.expect(/>> /) # Terminal ready.
+  end
+
+  def get
+    @out.write("output volume of (get volume settings)\r\n")
+    @in.expect(/=> (\d+)\r\n/)[1].to_i
+  end
+
+  def set(value)
+    @out.write("set volume output volume #{value}\r\n")
+    @in.expect(/>> /)
+  end
+end
+
+volume = AppleVolumeWrapper.new
+puts "Current volume: #{volume.get}%"
+
+# Some values from 0-100 aren't applied so the encoder gets stuck in a
+# small range if we write every step. Track when a step has no effect
+# and apply it later with this.
+unused_steps = 0
+
+encoder.add_callback do |update|
+  value = volume.get + update[:change] + unused_steps
+  value = 0 if value < 0
+  value = 100 if value > 100
+  volume.set(value)
+  unused_steps = value - volume.get
+  puts "Current volume: #{volume.get}%"
+end
+
+sleep
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 15253360..1f9757e3 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -25,13 +25,40 @@ def remove_callback(key=nil)
         alias :remove_callbacks :remove_callback
 
         def update(data)
-          @callback_mutex.synchronize {
+          data = pre_callback_filter(data)
+          @callback_mutex.synchronize do
             @callbacks.each_value do |array|
               array.each { |callback| callback.call(data) }
             end
             # Remove the special :read callback while still inside the lock.
             @callbacks.delete(:read)
-          }
+          end
+          update_self(data)
+        end
+
+        #
+        # Values received by #update are usually idempotent, i.e. the new state
+        # of the component, and can pass to callbacks as-is. But some components
+        # input a state change instead. Eg. rotary encoders with +1 or -1 steps.
+        #
+        # To maintain the pattern of callbacks receiving new state, while leaving
+        # old state in the instance variable for comparison, we may want to
+        # calculate the new state from a change input, and pass that instead.
+        # Override this method to do so. See RotaryEncoder class for an example.
+        #
+        def pre_callback_filter(data)
+          data
+        end
+
+        #
+        # Assign data to @state automatically after callbacks by default.
+        #
+        # Override this to add behavior not matching this pattern, such as
+        # components where data cannot be directly assigned to @state.
+        # Eg. data is a hash, and value from a specific key reflects @state.
+        # See RotaryEncoder class for an example.
+        #
+        def update_self(data)
           @state = data
         end
       end
diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index 53e45006..45293166 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -7,23 +7,58 @@ class RotaryEncoder
       proxy_pins data: Basic::DigitalInput,
                  clock: Basic::DigitalInput
 
+      attr_reader :position, :steps, :degrees_per_step
+      alias :position :state
+
       def after_initialize(options={})
         super(options) if defined?(super)
-        @state = 0
 
-        # Stop the default behavior of the DigitalInput instances.
-        clock.stop; data.stop;
-        clock.listen(1); data.listen(1)
-        sleep 0.5
+        # Default to listening every tick (1ms / 1kHz)
+        divider = options[:divider] || 1
+        clock.listen(divider)
+        data.listen(divider)
+
+        # Setup to track position in degrees.
+        @steps = options[:steps] || 30
+        @degrees_per_step = (360 / steps).to_f
+        @state = 0.0
 
         start
       end
 
       def start
-        proxies[:clock].add_callback do |clock_state|
-          (data.state == clock_state) ? self.update(@state + 1) : self.update(@state - 1)
+        clock.add_callback do |clock_state|
+          (data.state == clock_state) ? self.update(-1) : self.update(1)
         end
       end
+
+      #
+      # Callbacks#update calls these before and after callbacks respectively.
+      #
+      # Take data (+/- 1 step change) and calculate new position (state) in degrees.
+      # Leave old position in @state for now, so callbacks can compare to it.
+      #
+      # Return a hash with the new :position and pass through :change, overriding
+      # the data param we took, which would have passed directly to callbacks.
+      # Callbacks can use either :position (degrees) or :change (steps).
+      #
+      def pre_callback_filter(data)
+        data = { change: data,
+                 position: (state + (data * degrees_per_step)) % 360 }
+      end
+      #
+      # Callbacks run now, receiving only the value of #pre_callback_filter
+      #
+      # After callbacks, set @state to the position calculated earlier.
+      # This method also receives the value of #pre_callback_filter.
+      #
+      def update_self(data)
+        @state = data[:position]
+      end
+
+      def reset_position
+        @callbacks_mutex.synchronize { @state = 0 }
+      end
     end
   end
 end
diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
index 01271f64..cfd1aab0 100644
--- a/lib/dino/components/setup/multi_pin.rb
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -14,7 +14,7 @@ module MultiPin
         #
         # Return a hash with the state of each proxy component.
         #
-        def state
+        def proxy_states
           hash = {}
           proxies.each_key do |key|
             hash[key] = self.proxies[key].state rescue nil
@@ -23,6 +23,7 @@ def state
         end
 
       protected
+
         attr_writer :pins, :pullups, :proxies
 
         def self.included(base)
diff --git a/spec/lib/components/setup/multi_pin_spec.rb b/spec/lib/components/setup/multi_pin_spec.rb
index c9645803..e1d815c4 100644
--- a/spec/lib/components/setup/multi_pin_spec.rb
+++ b/spec/lib/components/setup/multi_pin_spec.rb
@@ -61,10 +61,10 @@ class MultiPinComponent
             expect(subject.maybe.pin).to eq(11)          end
         end
 
-        describe '#states' do
+        describe '#proxy_states' do
           it 'should return a hash with the state of each subcomponent' do
             subject.two.high
-            expect(subject.state).to eq({two: board.high, maybe: nil})
+            expect(subject.proxy_states).to eq({two: board.high, maybe: nil})
           end
         end
       end

From b6908a1f28e6911e180a694d1c63f86cd995abe8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 16 Jan 2018 00:29:22 -0400
Subject: [PATCH 153/296] Add ESP8266 with most features. Uses GPIO numbered
 pins. Minor cleanup.

---
 lib/dino.rb                    |  2 +
 lib/dino/tx_rx/base.rb         | 35 +++++++++++++-----
 lib/dino/tx_rx/flow_control.rb | 12 +++---
 lib/dino/tx_rx/serial.rb       |  1 -
 lib/dino/tx_rx/tcp.rb          |  9 +++--
 lib/dino_cli/targets.rb        |  7 +++-
 spec/lib/tx_rx/serial_spec.rb  |  6 +--
 src/dino_ethernet.ino          |  4 +-
 src/dino_serial.ino            |  9 ++---
 src/dino_wifi.ino              | 67 ++++++++++++++++++++++++----------
 10 files changed, 100 insertions(+), 52 deletions(-)

diff --git a/lib/dino.rb b/lib/dino.rb
index b63aa07a..9a6ed2ec 100644
--- a/lib/dino.rb
+++ b/lib/dino.rb
@@ -1,3 +1,5 @@
+Thread.abort_on_exception = true
+
 require 'dino/version'
 require 'dino/message'
 require 'dino/tx_rx'
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index bf823132..db90297f 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -10,14 +10,21 @@ class RxFlushTimeout     < StandardError; end
 
     class Base
       include Observable
+      include Handshake
       # Let the methods in FlowControl wrap subclass methods too.
       def self.inherited(subclass)
-        subclass.prepend FlowControl
+        subclass.send(:prepend, FlowControl)
       end
-      include Handshake
 
-      def read(message);  raise "#read should be defined in TxRx subclasses";  end
-      def write(message); raise "#write should be defined in TxRx subclasses"; end
+      def read(message)
+        raise NotImplementedError
+          .new("#{self.class.name}#read not defined in Dino::TxRx subclass")
+      end
+
+      def write(message)
+        raise NotImplementedError
+          .new("#{self.class.name}#write not defined in Dino::TxRx subclass")
+      end
 
     private
 
@@ -25,11 +32,16 @@ def io
         @io ||= connect
       end
 
-      def io_reset
-        flush_read; stop_read; start_read
+      def connect
+        raise NotImplementedError
+          .new("#{self.class.name}#connect not defined in Dino::TxRx subclass")
       end
 
-      def connect(message); raise "#connect should be defined in TxRx subclasses"; end
+      def io_reset
+        flush_read
+        stop_read
+        start_read
+      end
 
       def flush_read
         Timeout.timeout(5) { read until read == nil }
@@ -38,7 +50,7 @@ def flush_read
       end
 
       def start_read
-        @thread ||= Thread.new { loop { read_and_process } }.abort_on_exception = true
+        @thread ||= Thread.new { loop { read_and_parse } }
       end
 
       def stop_read
@@ -47,9 +59,12 @@ def stop_read
         @thread = nil
       end
 
-      def read_and_process(message); raise "#read_and_process should be defined in FlowControl module"; end
+      def read_and_parse
+        raise NotImplementedError
+          .new("#{self.class.name}#read_and_parse not defined in Dino::TxRx::FlowControl")
+      end
 
-      def process(line)
+      def parse(line)
         if line.match(/\A\d+:/)
           pin, message = line.split(":", 2)
           pin && message && changed && notify_observers(pin, message)
diff --git a/lib/dino/tx_rx/flow_control.rb b/lib/dino/tx_rx/flow_control.rb
index d5a727b4..8436c38e 100644
--- a/lib/dino/tx_rx/flow_control.rb
+++ b/lib/dino/tx_rx/flow_control.rb
@@ -7,10 +7,11 @@ module FlowControl
       SLEEP_MAX = 0.01
 
       def initialize(*args)
-        reset_flow_control
         super(*args)
+        reset_flow_control
       end
 
+      # Split messages to use available buffer, and wrap #write in a mutex.
       def write(message)
         add_write_call
         @write_mutex.synchronize do
@@ -61,19 +62,18 @@ def reset_flow_control
         @last_interval_update = Time.now
       end
 
-      def read_and_process
+      def read_and_parse
         line = read
 
         if line && line.match(/\AACK:/)
-          # Handle handshake responses by passing to the observing HandshakeAttempt.
-          # Also pass self so it can detach itself when done.
+          # A HandshakeAttempt is observing. Also pass self so it can stop.
           changed && notify_observers(self, line.split(":", 2)[1])
-          # Empty transit counter since ACK: won't also send RCV:
+          # Empty @transit_bytes. ACK: means the board reset its counter too.
           @transit_mutex.synchronize { @transit_bytes = 0 }
         elsif line && line.match(/\ARCV:/)
           remove_transit_bytes(line.split(/:/)[1].to_i)
         elsif line
-          process(line)
+          parse(line)
         else
           rx_wait
         end
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index e5b18ad2..44554744 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -50,7 +50,6 @@ def connect
             puts "Connected"
             return connection
           rescue RubySerial::Error => error
-            puts error
             handle_error(error); next
           end
         end
diff --git a/lib/dino/tx_rx/tcp.rb b/lib/dino/tx_rx/tcp.rb
index a75ad170..df8eb31f 100644
--- a/lib/dino/tx_rx/tcp.rb
+++ b/lib/dino/tx_rx/tcp.rb
@@ -3,8 +3,9 @@
 module Dino
   module TxRx
     class TCP < Base
-      def initialize(host, port=3466)
-        @host, @port = host, port
+      def initialize(host="127.0.0.1", port=3466)
+        @host = host
+        @port = port
       end
 
       def to_s
@@ -15,7 +16,9 @@ def to_s
 
       def connect
         print "Connecting to TCP at: #{self.to_s}... "
-        connection = Timeout::timeout(10) { TCPSocket.open @host, @port }
+        connection = Timeout::timeout(10) do
+          TCPSocket.open(@host, @port)
+        end
         puts "Connected"
         connection
       rescue => error
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 9a34148d..b9a3d1f5 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -1,7 +1,7 @@
 class DinoCLI::Generator
   TARGETS = {
     # Default target always includes all packages.
-    mega: PACKAGES.each_key.map {|k| k},
+    mega: PACKAGES.each_key.to_a,
 
     # Core is core.
     core: [:core],
@@ -10,6 +10,9 @@ class DinoCLI::Generator
     mega168: [:core, :servo, :dht, :one_wire, :ir_out, :tone, :spi, :i2c],
 
     # ARM includes everytyhing except specific incompatibilities.
-    arm: PACKAGES.each_key.map {|k| k} - [:serial, :tone, :ir_out, :i2c],
+    arm: PACKAGES.each_key.to_a - [:serial, :tone, :ir_out, :i2c],
+
+    # A surprising amount "just works" on the ESP, notably not LCD.
+    esp8266: PACKAGES.each_key.to_a - [:lcd, :serial, :ir_out, :i2c],
   }
 end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
index bcd017fd..421a167f 100644
--- a/spec/lib/tx_rx/serial_spec.rb
+++ b/spec/lib/tx_rx/serial_spec.rb
@@ -72,19 +72,19 @@ def io_instance
       end
     end
 
-    describe '#read_and_process' do
+    describe '#read_and_parse' do
       it 'should notify observers on change' do
         expect(subject).to receive(:read).and_return("02:00")
         expect(subject).to receive(:changed).and_return(true)
         expect(subject).to receive(:notify_observers).with('02','00')
-        subject.send(:read_and_process)
+        subject.send(:read_and_parse)
       end
 
       it 'should not split messages into more than 2 parts on :' do
         expect(subject).to receive(:read).and_return("02:00:00")
         expect(subject).to receive(:changed).and_return(true)
         expect(subject).to receive(:notify_observers).with('02','00:00')
-        subject.send(:read_and_process)
+        subject.send(:read_and_parse)
       end
     end
 
diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index aec9362b..cc762432 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -13,7 +13,6 @@ EthernetClient client;
 
 
 void printEthernetStatus() {
-  // Print ethernet status.
   Serial.print("IP Address: ");
   Serial.println(Ethernet.localIP());
   Serial.print("Port: ");
@@ -23,7 +22,8 @@ void printEthernetStatus() {
 
 void setup() {
   // Start serial for debugging.
-  Serial.begin(9600);
+  Serial.begin(115200);
+  while(!serial);
 
   // Explicitly disable the SD card.
   pinMode(4,OUTPUT);
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index a89ddf72..1c890f07 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -14,14 +14,11 @@ Dino dino;
 
 
 void setup() {
+  // Wait for serial ready.
   serial.begin(115200);
+  while(!serial);
 
-  // Wait for Leonardo serial port to connect.
-  #if defined(__AVR_ATmega32U4__)
-    while(!serial);
-  #endif
-
-  // Pass the stream to dino so it can read/write.
+  // Pass serial stream to dino so it can read/write.
   dino.setOutputStream(&serial);
 }
 
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 2a48a402..38c95807 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -1,20 +1,35 @@
 #include "Dino.h"
-#include <SPI.h>
-#include <WiFi.h>
+#ifdef ESP8266
+  #include <ESP8266WiFi.h>
+  #define LED_PIN 2
+#else
+  #include <SPI.h>
+  #include <WiFi.h>
+  #define LED_PIN 13
+#endif
 
-// Configure your WiFi options here. MAC address and IP address are not configurable.
+// Configure your WiFi options here. IP address are not configurable. Uses DHCP.
 int port = 3466;
-char ssid [] = "yourNetwork";
-char pass [] = "yourPassword";
-int keyIndex = 0;
-int status = WL_IDLE_STATUS;
+char* ssid = "yourNetwork";
+char* pass = "yourPassword";
 
 Dino dino;
 WiFiServer server(port);
 WiFiClient client;
 
 
+// Use the built in LED to indicate WiFi status.
+void indicate(byte value) {
+ #ifdef ESP8266
+   digitalWrite(LED_PIN, !value);
+ #else
+  digitalWrite(LED_PIN, value);
+ #endif
+}
+
+
 void printWifiStatus() {
+  Serial.println("Connected");
   Serial.print("SSID: ");
   Serial.println(WiFi.SSID());
   Serial.print("Signal Strength (RSSI):");
@@ -22,29 +37,43 @@ void printWifiStatus() {
   Serial.println(" dBm");
   Serial.print("IP Address: ");
   Serial.println(WiFi.localIP());
-  Serial.print("Port: ");
+  Serial.print("Dino TCP Port: ");
   Serial.println(port);
+  indicate(true);
+}
+
+
+void connect(){
+  Serial.print("Attempting to connect to SSID: ");
+  Serial.print(ssid);
+  WiFi.begin(ssid, pass);
+  while (WiFi.status() != WL_CONNECTED) {
+    delay(500);
+    Serial.print(".");
+  }
+  printWifiStatus();
 }
 
 
 void setup() {
+  pinMode(LED_PIN, OUTPUT);
+
   // Start serial for debugging.
-  Serial.begin(9600);
-
-  // Try to connect to the specified network.
-  while ( status != WL_CONNECTED) {
-    Serial.print("Attempting to connect to SSID: ");
-    Serial.println(ssid);
-    status = WiFi.begin(ssid, pass);
-    delay(10000);
-  }
+  Serial.begin(115200);
+  while(!Serial);
 
-  // Start the server.
+  connect();
   server.begin();
-  printWifiStatus();
 }
 
+
 void loop() {
+  // Reconnect if we've lost WiFi..
+  if (WiFi.status() != WL_CONNECTED){
+    indicate(false);
+    connect();
+  }
+
   // Listen for connections.
   client = server.available();
 

From 910ad64b6eb93a66b67c5833d77b0118a87535e2 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 18 Jan 2018 22:07:58 -0400
Subject: [PATCH 154/296] Return #read value. Test coverage for all component
 mixin behavior.

Drop support for ruby < 2.0.0.
---
 .travis.yml                                  |   1 -
 lib/dino/components/mixins/listener.rb       |  15 ++-
 lib/dino/components/mixins/poller.rb         |  11 +-
 lib/dino/components/mixins/reader.rb         |  14 ++-
 lib/dino/components/mixins/threaded.rb       |   6 +-
 lib/dino/components/setup/input.rb           |   4 +
 spec/lib/components/mixins/callbacks_spec.rb |  30 ++++--
 spec/lib/components/mixins/listener_spec.rb  |  57 ++++++++++
 spec/lib/components/mixins/poller_spec.rb    |  65 ++++++++++++
 spec/lib/components/mixins/reader_spec.rb    |  77 ++++++++++++++
 spec/lib/components/mixins/threaded_spec.rb  | 105 +++++++++++++++++++
 11 files changed, 358 insertions(+), 27 deletions(-)
 create mode 100644 spec/lib/components/mixins/listener_spec.rb
 create mode 100644 spec/lib/components/mixins/poller_spec.rb
 create mode 100644 spec/lib/components/mixins/reader_spec.rb
 create mode 100644 spec/lib/components/mixins/threaded_spec.rb

diff --git a/.travis.yml b/.travis.yml
index 8499f94c..171ae6bb 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -6,7 +6,6 @@ before_install:
 rvm:
   - 2.4.1
   - 2.0.0
-  - 1.9.3
   - jruby-19mode
 
 script: bundle exec rspec spec
diff --git a/lib/dino/components/mixins/listener.rb b/lib/dino/components/mixins/listener.rb
index 9db58fbb..88e07835 100644
--- a/lib/dino/components/mixins/listener.rb
+++ b/lib/dino/components/mixins/listener.rb
@@ -12,14 +12,19 @@ def listen(divider=nil, &block)
 
         def stop
           super if defined?(super)
-          board.stop_listener(pin)
+          _stop_listen
           remove_callbacks :listen
         end
 
-        #
-        # Including component should define this to start a listener on the board.
-        #
-        def _listen; end
+        def _listen
+          raise NotImplementedError
+            .new("#{self.class.name}#_listen is not defined.")
+        end
+
+        def _stop_listen
+          raise NotImplementedError
+            .new("#{self.class.name}#_stop_listen is not defined.")
+        end
       end
     end
   end
diff --git a/lib/dino/components/mixins/poller.rb b/lib/dino/components/mixins/poller.rb
index ac478a1f..35b17938 100644
--- a/lib/dino/components/mixins/poller.rb
+++ b/lib/dino/components/mixins/poller.rb
@@ -3,14 +3,9 @@ module Components
     module Mixins
       module Poller
         include Reader
-        #
-        # Make sure Threaded is in the including class.
-        #
-        def self.included(base)
-          base.class_eval { include Threaded }
-        end
+        include Threaded
 
-        def poll(interval, &block)
+        def poll(interval=1, &block)
           stop
           add_callback(:poll, &block) if block_given?
           threaded_loop do
@@ -21,7 +16,7 @@ def poll(interval, &block)
         def stop
           super if defined?(super)
           stop_thread
-          remove_callback :poll
+          remove_callbacks :poll
         end
       end
     end
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index 285a6eca..03ad8aec 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -6,14 +6,20 @@ module Reader
 
         def read(&block)
           add_callback(:read, &block) if block_given?
+
+          value = nil
+          add_callback(:read) { |data| value = data }
+
           _read
           loop { break if !@callbacks[:read] }
+
+          value
         end
 
-        #
-        # Including component should define this to perform a single read on the board.
-        #
-        def _read; end
+        def _read
+          raise NotImplementedError
+            .new("#{self.class.name}#_read is not defined.")
+        end
       end
     end
   end
diff --git a/lib/dino/components/mixins/threaded.rb b/lib/dino/components/mixins/threaded.rb
index be981dea..bcfe3f4f 100644
--- a/lib/dino/components/mixins/threaded.rb
+++ b/lib/dino/components/mixins/threaded.rb
@@ -19,12 +19,12 @@ def self.included(base)
         def threaded(&block)
           stop_thread
           enable_interrupts unless interrupts_enabled
-          @thread = Thread.new { block.call}
+          @thread = Thread.new(&block)
         end
 
         def threaded_loop(&block)
-          threaded do 
-            loop { block.call }
+          threaded do
+            loop(&block)
           end
         end
 
diff --git a/lib/dino/components/setup/input.rb b/lib/dino/components/setup/input.rb
index 6553224b..f2dfbfb6 100644
--- a/lib/dino/components/setup/input.rb
+++ b/lib/dino/components/setup/input.rb
@@ -16,6 +16,10 @@ def initialize_pins(options={})
           self.mode = :in
           self.pullup = options[:pullup]
         end
+
+        def _stop_listen
+          board.stop_listener(pin)
+        end
       end
     end
   end
diff --git a/spec/lib/components/mixins/callbacks_spec.rb b/spec/lib/components/mixins/callbacks_spec.rb
index cbc23595..54941442 100644
--- a/spec/lib/components/mixins/callbacks_spec.rb
+++ b/spec/lib/components/mixins/callbacks_spec.rb
@@ -50,7 +50,7 @@ def initialize; after_initialize; end
               expect(subject.instance_variable_get :@callbacks).to eq({})
             end
 
-            it 'should remove only callbacks for a specific key given' do
+            it 'should remove only callbacks the given key if given' do
               subject.remove_callbacks(:read)
               expect(subject.instance_variable_get(:@callbacks)[:read]).to eq(nil)
               expect(subject.instance_variable_get(:@callbacks)[:persistent]).to_not eq(nil)
@@ -58,11 +58,6 @@ def initialize; after_initialize; end
           end
 
           describe '#update' do
-            it 'should set the @state variable' do
-              subject.update("thing")
-              expect(subject.instance_variable_get :@state).to eq("thing")
-            end
-
             it 'should call all the callbacks' do
               expect(@callback1).to receive(:call).once
               expect(@callback2).to receive(:call).once
@@ -74,6 +69,29 @@ def initialize; after_initialize; end
               expect(subject.instance_variable_get(:@callbacks)[:read]).to eq(nil)
             end
           end
+
+
+          describe '#pre_callback_filter' do
+            it 'should mutate data being passed to callbacks' do
+              class FilteredComponent < CallbackComponent
+                def pre_callback_filter(data)
+                  "dino: #{data}"
+                end
+              end
+              callback = Proc.new{|data| data}
+              subject = FilteredComponent.new
+              subject.add_callback(&callback)
+              expect(callback).to receive(:call).with("dino: dino")
+              subject.update("dino")
+            end
+          end
+
+          describe '#update_self' do
+            it 'should set the @state variable' do
+              subject.update("dino")
+              expect(subject.instance_variable_get :@state).to eq("dino")
+            end
+          end
         end
       end
     end
diff --git a/spec/lib/components/mixins/listener_spec.rb b/spec/lib/components/mixins/listener_spec.rb
new file mode 100644
index 00000000..7dc92b86
--- /dev/null
+++ b/spec/lib/components/mixins/listener_spec.rb
@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Mixins
+      describe Poller do
+
+        class ListenComponent
+          include Listener
+          def _listen(divider=nil); end
+          def _stop_listen; end
+          def initialize; after_initialize; end
+        end
+
+        subject { ListenComponent.new }
+
+        describe '#initialize' do
+          it 'should automatically include Callbacks' do
+            expect(subject.class.ancestors).to include(Callbacks)
+          end
+        end
+
+        describe '#listen' do
+          it 'should call #stop' do
+            expect(subject).to receive(:stop)
+            subject.listen
+          end
+
+          it 'should call #_listen' do
+            expect(subject).to receive(:_listen)
+            subject.listen
+          end
+
+          it 'should add a given block as callback with :listen key' do
+            callback = Proc.new{}
+            expect(subject).to receive(:add_callback).with(:listen) do |&block|
+              expect(block).to eq(callback)
+            end
+            subject.listen(&callback)
+          end
+        end
+
+        describe '#stop' do
+          it 'should call #_stop_listen' do
+            expect(subject).to receive(:_listen)
+            subject.listen
+          end
+
+          it 'should remove all callbacks with the :listen key' do
+            expect(subject).to receive(:remove_callbacks).with(:listen)
+            subject.stop
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/mixins/poller_spec.rb b/spec/lib/components/mixins/poller_spec.rb
new file mode 100644
index 00000000..e87ddc7f
--- /dev/null
+++ b/spec/lib/components/mixins/poller_spec.rb
@@ -0,0 +1,65 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Mixins
+      describe Poller do
+
+        class PollComponent
+          include Poller
+          def _read; end
+          def initialize; after_initialize; end
+        end
+
+        subject { PollComponent.new }
+
+        describe '#initialize' do
+          it 'should automatically include Callbacks' do
+            expect(subject.class.ancestors).to include(Threaded)
+            expect(subject.class.ancestors).to include(Reader)
+          end
+        end
+
+        describe '#poll' do
+          it 'should call #stop' do
+            expect(subject).to receive(:stop)
+            subject.poll
+          end
+
+          it 'should add a given block as callback with :poll key' do
+            callback = Proc.new{}
+            expect(subject).to receive(:add_callback).with(:poll) do |&block|
+              expect(block).to eq(callback)
+            end
+            subject.poll(&callback)
+          end
+
+          it 'should start a new thread' do
+            expect(subject).to receive(:threaded_loop)
+            subject.poll
+            subject.stop
+          end
+
+          it 'should call #_read repeatedly' do
+            expect(subject).to receive(:_read).at_least(:twice)
+            subject.poll(0.01)
+            sleep 0.1
+            subject.stop
+          end
+        end
+
+        describe '#stop' do
+          it 'should not override the call to Threaded#stop_thread' do
+            expect(subject).to receive(:stop_thread)
+            subject.stop
+          end
+
+          it 'should remove any callbacks with the :poll key' do
+            expect(subject).to receive(:remove_callbacks).with(:poll)
+            subject.stop
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/mixins/reader_spec.rb b/spec/lib/components/mixins/reader_spec.rb
new file mode 100644
index 00000000..8f92eb23
--- /dev/null
+++ b/spec/lib/components/mixins/reader_spec.rb
@@ -0,0 +1,77 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Mixins
+      describe Reader do
+
+        class ReadComponent
+          include Reader
+          def _read; end
+          def initialize; after_initialize; end
+        end
+
+        subject { ReadComponent.new }
+
+        def read_callbacks
+          subject.instance_variable_get(:@callbacks)[:read]
+        end
+
+        def inject(data, wait_for_callbacks = true)
+          Thread.new do
+            if wait_for_callbacks
+              while (!read_callbacks) do; sleep 0.01; end
+            end
+            loop do
+              sleep 0.01
+              subject.update(data)
+              break unless read_callbacks
+            end
+          end
+        end
+
+        describe '#initialize' do
+          it 'should automatically include Callbacks' do
+            expect(ReadComponent.ancestors).to include(Callbacks)
+          end
+        end
+
+        describe '#read' do
+          it 'should call #_read exactly once' do
+            expect(subject).to receive(:_read).exactly(1).times
+            inject(1)
+            subject.read
+          end
+
+          it 'should add the given block as a callback with key :read' do
+            callback = Proc.new{}
+
+            # expect(subject).to receive(:add_callback).with(:read, &callback)
+            # would just be too easy?
+            blocks = []
+            allow(subject).to receive(:add_callback).with(:read) do |&block|
+              blocks << block
+              expect(blocks).to include(callback)
+            end
+
+            inject(1)
+            subject.read(&callback)
+          end
+
+          it 'should run the given callback exactly once' do
+            callback = Proc.new{}
+            expect(callback).to receive(:call).exactly(1).times
+            inject(1)
+            subject.read(&callback)
+            inject(1, false)
+          end
+
+          it 'should return the read value' do
+            inject("Hello")
+            expect(subject.read).to eq("Hello")
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
new file mode 100644
index 00000000..6874a781
--- /dev/null
+++ b/spec/lib/components/mixins/threaded_spec.rb
@@ -0,0 +1,105 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module Mixins
+      describe Threaded do
+
+        class ThreadedComponent
+          include Threaded
+          def foo(str="test")
+            @bar = str
+          end
+          attr_reader :bar
+          interrupt_with :foo
+        end
+
+        subject { ThreadedComponent.new }
+
+        describe 'ClassMethods' do
+          it 'should add methods to interrupt the thread using #interrupt_with' do
+            ThreadedComponent.class_variable_get(:@@interrupts).should eq [:foo]
+          end
+        end
+
+        describe '#threaded' do
+          it 'should stop any existing thread' do
+            expect(subject).to receive(:stop_thread)
+            subject.threaded do; end
+          end
+
+          it 'should enable interrupts' do
+            expect(subject).to receive(:enable_interrupts)
+            subject.threaded do; end
+          end
+
+          it 'should start a new thread that calls the given block' do
+            async = Proc.new {}
+            expect(Thread).to receive(:new) do |&block|
+              expect(block).to eq(async)
+            end
+            subject.threaded(&async)
+          end
+
+          it 'should store in @thread' do
+            thread = Thread.current
+            async = Proc.new { thread = Thread.current }
+            subject.threaded(&async)
+            sleep 0.25
+            expect(subject.instance_variable_get :@thread).to eq thread
+          end
+        end
+
+        describe '#threaded_loop' do
+          it 'should loop the block in the thread' do
+            async = Proc.new {}
+            expect(subject).to receive(:loop) do |&block|
+              expect(block).to eq(async)
+            end
+
+            subject.threaded_loop(&async)
+            sleep 0.25
+            subject.stop_thread
+          end
+        end
+
+        describe '#stop_thread' do
+          it 'should kill the thread' do
+            subject.threaded { sleep }
+            expect(subject.instance_variable_get :@thread).to receive(:kill)
+            subject.stop_thread
+          end
+        end
+
+        describe '#enable_interrupts' do
+          it 'should override the given method on the singleton class only' do
+            second_part = ThreadedComponent.new
+            before_class = second_part.method(:foo)
+            before_instance = subject.method(:foo)
+
+            subject.enable_interrupts
+            after_class = second_part.method(:foo)
+            after_instance = subject.method(:foo)
+
+            expect(after_class).to eq(before_class)
+            expect(after_instance).to_not eq(before_instance)
+          end
+
+          it 'should pass arguments through to the original method' do
+            subject.enable_interrupts
+            subject.foo("dino")
+            expect(subject.bar).to eq("dino")
+          end
+        end
+
+        describe 'calling an interrupt' do
+          it 'should stop the thread' do
+            subject.threaded { sleep }
+            expect(subject).to receive(:stop_thread)
+            subject.foo
+          end
+        end
+      end
+    end
+  end
+end

From 42177cb4410e1f066426a2ae856e0f2d60907a08 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 23 Jan 2018 22:28:56 -0400
Subject: [PATCH 155/296] Cleaner IR code. Uses unmodified libs, works on
 ESP8266 now

---
 .gitmodules                                 |  5 ++++-
 lib/dino_cli/generator.rb                   |  3 +++
 lib/dino_cli/packages.rb                    | 13 ++++++++++++
 lib/dino_cli/targets.rb                     |  2 +-
 spec/lib/components/mixins/threaded_spec.rb | 17 ++++++++++-----
 src/lib/DinoIROut.cpp                       | 23 +++++++++++++++++----
 src/vendor/Arduino-IRremote                 |  2 +-
 src/vendor/IRremoteESP8266                  |  1 +
 src/vendor/OneWire                          |  2 +-
 9 files changed, 55 insertions(+), 13 deletions(-)
 create mode 160000 src/vendor/IRremoteESP8266

diff --git a/.gitmodules b/.gitmodules
index 47bcd249..e48ee19d 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,6 +1,6 @@
 [submodule "src/vendor/Arduino-IRremote"]
 	path = src/vendor/Arduino-IRremote
-	url = https://github.com/vickash/Arduino-IRremote.git
+	url = https://github.com/z3t0/Arduino-IRremote.git
 [submodule "src/vendor/I2C-Master-Library"]
 	path = src/vendor/I2C-Master-Library
 	url = https://github.com/vickash/I2C-Master-Library.git
@@ -10,3 +10,6 @@
 [submodule "src/vendor/OneWire"]
 	path = src/vendor/OneWire
 	url = https://github.com/PaulStoffregen/OneWire.git
+[submodule "src/vendor/IRremoteESP8266"]
+	path = src/vendor/IRremoteESP8266
+	url = https://github.com/markszabo/IRremoteESP8266.git
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 26853d4d..e3ab73ec 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -41,6 +41,9 @@ def read
         if f.match /\Avendor/
           directive = @packages[k][:directive]
           contents = "#include \"DinoDefines.h\"\n#ifdef #{directive}\n" << contents << "\n#endif\n"
+
+          # Hack to workaround /util folder includes in latest OneWire library.
+          contents.gsub!("util/OneWire_direct_gpio.h", "OneWire_direct_gpio.h") if f.match /OneWire/
         end
         { path: f, contents: contents }
       end
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index eb7c758c..bf156d89 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -77,6 +77,18 @@ class DinoCLI::Generator
       "vendor/Arduino-IRremote/irSend.cpp",
     ]
   },
+  ir_out_esp8266: {
+    description: "Transmit infrared signals with the ESP8266",
+    directive: "DINO_IR_OUT",
+    files: [
+      "lib/DinoIROut.cpp",
+      "vendor/IRremoteESP8266/src/IRremoteESP8266.h",
+      "vendor/IRremoteESP8266/src/IRsend.h",
+      "vendor/IRremoteESP8266/src/IRsend.cpp",
+      "vendor/IRremoteESP8266/src/IRtimer.h",
+      "vendor/IRremoteESP8266/src/IRtimer.cpp",
+    ]
+  },
   one_wire: {
     description: "OneWire bus support (Just DS18B20 for now)",
     directive: "DINO_ONE_WIRE",
@@ -84,6 +96,7 @@ class DinoCLI::Generator
       "lib/DinoOneWire.cpp",
       "vendor/OneWire/OneWire.cpp",
       "vendor/OneWire/OneWire.h",
+      "vendor/OneWire/util/OneWire_direct_gpio.h",
     ]
   },
   i2c: {
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index b9a3d1f5..65f4e167 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -13,6 +13,6 @@ class DinoCLI::Generator
     arm: PACKAGES.each_key.to_a - [:serial, :tone, :ir_out, :i2c],
 
     # A surprising amount "just works" on the ESP, notably not LCD.
-    esp8266: PACKAGES.each_key.to_a - [:lcd, :serial, :ir_out, :i2c],
+    esp8266: PACKAGES.each_key.to_a - [:lcd, :serial, :ir_out, :i2c] + [:ir_out_esp8266],
   }
 end
diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
index 6874a781..bcd689f6 100644
--- a/spec/lib/components/mixins/threaded_spec.rb
+++ b/spec/lib/components/mixins/threaded_spec.rb
@@ -45,21 +45,26 @@ def foo(str="test")
             thread = Thread.current
             async = Proc.new { thread = Thread.current }
             subject.threaded(&async)
-            sleep 0.25
-            expect(subject.instance_variable_get :@thread).to eq thread
+            while(!subject.instance_variable_get :@thread) do; end
+            expect(subject.instance_variable_get :@thread).to_not eq(thread)
           end
         end
 
         describe '#threaded_loop' do
           it 'should loop the block in the thread' do
-            async = Proc.new {}
+            main_thread = Thread.current
+            async_thread = Thread.current
+            async = Proc.new { async_thread = Thread.current}
+
+            expect(async).to receive(:call).and_call_original
             expect(subject).to receive(:loop) do |&block|
               expect(block).to eq(async)
-            end
+            end.and_yield
 
             subject.threaded_loop(&async)
-            sleep 0.25
+            while(main_thread == async_thread) do; end
             subject.stop_thread
+            expect(main_thread).to_not eq(async_thread)
           end
         end
 
@@ -86,8 +91,10 @@ def foo(str="test")
           end
 
           it 'should pass arguments through to the original method' do
+            original = subject.method(:foo)
             subject.enable_interrupts
             subject.foo("dino")
+            expect(original).to_not eq(subject.method(:foo))
             expect(subject.bar).to eq("dino")
           end
         end
diff --git a/src/lib/DinoIROut.cpp b/src/lib/DinoIROut.cpp
index 9ba67395..a9172c8a 100644
--- a/src/lib/DinoIROut.cpp
+++ b/src/lib/DinoIROut.cpp
@@ -4,13 +4,28 @@
 #include "Dino.h"
 #ifdef DINO_IR_OUT
 
-#include "IRremote.h"
-IRsend infraredOut;
+#ifdef ESP8266
+  #include "IRremoteESP8266.h"
+  #include "Irsend.h"
+  IRsend infraredOut(2);
+#else
+  #include "IRremote.h"
+  IRsend infraredOut;
+#endif
 
 // CMD = 16
 // Send an infrared signal.
 void Dino::irSend(){
-  infraredOut.sendRaw((uint16_t)&auxMsg[1], (uint8_t)auxMsg[0], val);
-}
+  infraredOut.enableIROut(val);
 
+  for (int i=0; i<(uint8_t)auxMsg[0]; i++){
+    uint16_t pulse = ((uint16_t)auxMsg[(i*2)+2] << 8) | auxMsg[(i*2)+1];
+    if ((i % 2) == 0) {
+      infraredOut.mark(pulse);
+    } else {
+      infraredOut.space(pulse);
+    }
+  }
+  infraredOut.space(0);
+}
 #endif
diff --git a/src/vendor/Arduino-IRremote b/src/vendor/Arduino-IRremote
index b6cbb73a..96186317 160000
--- a/src/vendor/Arduino-IRremote
+++ b/src/vendor/Arduino-IRremote
@@ -1 +1 @@
-Subproject commit b6cbb73abc176f241942724a257c7217baeeee5d
+Subproject commit 96186317b251c04da595159402f80538c0be5eed
diff --git a/src/vendor/IRremoteESP8266 b/src/vendor/IRremoteESP8266
new file mode 160000
index 00000000..fce4ccf0
--- /dev/null
+++ b/src/vendor/IRremoteESP8266
@@ -0,0 +1 @@
+Subproject commit fce4ccf0bd58eb7e0d905ee279eeccdca6ba1e69
diff --git a/src/vendor/OneWire b/src/vendor/OneWire
index ebc5f7f5..ac0ea9a7 160000
--- a/src/vendor/OneWire
+++ b/src/vendor/OneWire
@@ -1 +1 @@
-Subproject commit ebc5f7f503b7be9c3772c3c131d86d7080cc77cf
+Subproject commit ac0ea9a7fc266b2d709532fcb1269ffe5fcbbb46

From 46f11dff71bacf931675e6a4ea822b9221d0b325 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 24 Jan 2018 13:26:43 -0400
Subject: [PATCH 156/296] Copy dependency sources when building gem

---
 dino.gemspec | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/dino.gemspec b/dino.gemspec
index 23d14b9d..171b28fc 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -10,6 +10,24 @@ Gem::Specification.new do |gem|
   gem.homepage      = 'https://github.com/austinbv/dino'
 
   gem.files         = `git ls-files`.split($\)
+
+  # Copy full submodule contents into the gem when building.
+  # Credit:
+  # https://gist.github.com/mattconnolly/5875987#file-gem-with-git-submodules-gemspec
+  #
+  # get an array of submodule dirs by executing 'pwd' inside each submodule
+  gem_dir = File.expand_path(File.dirname(__FILE__)) + "/"
+  `git submodule --quiet foreach pwd`.split($\).each do |submodule_path|
+    Dir.chdir(submodule_path) do
+      submodule_relative_path = submodule_path.sub gem_dir, ""
+      # issue git ls-files in submodule's directory and
+      # prepend the submodule path to create absolute file paths
+      `git ls-files`.split($\).each do |filename|
+        gem.files << "#{submodule_relative_path}/#{filename}"
+      end
+    end
+  end
+
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.name          = "dino"
   gem.require_paths = ["lib"]

From 0b65a3531c037529ae68a36f6724c411fddfb374 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 29 Jan 2018 21:14:19 -0400
Subject: [PATCH 157/296] Dynamic IR pin for ESP8266 since it bitbangs carrier
 frequency anyway.

---
 src/lib/DinoIROut.cpp | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/lib/DinoIROut.cpp b/src/lib/DinoIROut.cpp
index a9172c8a..4847de35 100644
--- a/src/lib/DinoIROut.cpp
+++ b/src/lib/DinoIROut.cpp
@@ -7,7 +7,6 @@
 #ifdef ESP8266
   #include "IRremoteESP8266.h"
   #include "Irsend.h"
-  IRsend infraredOut(2);
 #else
   #include "IRremote.h"
   IRsend infraredOut;
@@ -16,6 +15,10 @@
 // CMD = 16
 // Send an infrared signal.
 void Dino::irSend(){
+  #ifdef ESP8266
+    IRsend infraredOut(pin);
+  #endif
+
   infraredOut.enableIROut(val);
 
   for (int i=0; i<(uint8_t)auxMsg[0]; i++){

From 54e2462218bf8bf65a534a93c3217a9746c0d4f3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 3 Feb 2018 14:18:56 -0400
Subject: [PATCH 158/296] Handle targets/exclusion when building sketch

---
 lib/dino_cli/generator.rb | 21 +++++++++++++++------
 lib/dino_cli/packages.rb  |  5 ++---
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index e3ab73ec..94c6885b 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -108,13 +108,22 @@ def write
     sketch = File.join(output_dir, sketch_filename)
     File.open(sketch, 'w') { |f| f.write @sketch }
 
-    # Go through the @packages hash and copy all the source files regardless of target.
-    # Append source file basename to the output dir to get output file path.
-    # Then write the file contents to the destination path.
+    # Go through the @packages hash and copy source files.
+    # Exclude only for target hardware incompatibility.
+    # Eg. ESP8266 IR library is different and incompatible with AVR version.
     @packages.each_key do |k|
-      @packages[k][:files].each do |file|
-        dest_path = File.join(output_dir, file[:path].split('/')[-1])
-        File.open(dest_path, 'w') { |f| f.write file[:contents] }
+      # Check if the package should be included for this target.
+      package = @packages[k]
+      targeted = !package[:target] || package[:target].include?(options[:target])
+      excluded = package[:exclude] && package[:exclude].include?(options[:target])
+
+      # Append source file basename to the output dir to get output file path.
+      # Then write the file contents to the destination path.
+      if (targeted && !excluded)
+        package[:files].each do |file|
+          dest_path = File.join(output_dir, file[:path].split('/')[-1])
+          File.open(dest_path, 'w') { |f| f.write file[:contents] }
+        end
       end
     end
 
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index bf156d89..fc486460 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -69,6 +69,7 @@ class DinoCLI::Generator
   ir_out: {
     description: "Transmit infrared signals",
     directive: "DINO_IR_OUT",
+    exclude: [:esp8266],
     files: [
       "lib/DinoIROut.cpp",
       "vendor/Arduino-IRremote/boarddefs.h",
@@ -80,6 +81,7 @@ class DinoCLI::Generator
   ir_out_esp8266: {
     description: "Transmit infrared signals with the ESP8266",
     directive: "DINO_IR_OUT",
+    target: [:esp8266],
     files: [
       "lib/DinoIROut.cpp",
       "vendor/IRremoteESP8266/src/IRremoteESP8266.h",
@@ -94,9 +96,6 @@ class DinoCLI::Generator
     directive: "DINO_ONE_WIRE",
     files: [
       "lib/DinoOneWire.cpp",
-      "vendor/OneWire/OneWire.cpp",
-      "vendor/OneWire/OneWire.h",
-      "vendor/OneWire/util/OneWire_direct_gpio.h",
     ]
   },
   i2c: {

From 57292688f927333c9c63349dbe3d0722690979f7 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 3 Feb 2018 17:16:43 -0400
Subject: [PATCH 159/296] Ruby based OneWire with only the timing functions in
 C. Remove external library.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Only implemented DS18B20 so far, but full bus support should be easy now since it’s pure Ruby.
---
 .gitmodules                         |   3 -
 examples/one_wire/ds18b20.rb        |  18 +++--
 lib/dino/components/ds18b20.rb      | 115 ++++++++++++++++++++++++++-
 spec/lib/components/ds18b20_spec.rb |  20 +++++
 src/lib/Dino.cpp                    |  13 +--
 src/lib/Dino.h                      |   9 ++-
 src/lib/DinoOneWire.cpp             | 119 ++++++++++++++++++----------
 src/vendor/OneWire                  |   1 -
 8 files changed, 240 insertions(+), 58 deletions(-)
 create mode 100644 spec/lib/components/ds18b20_spec.rb
 delete mode 160000 src/vendor/OneWire

diff --git a/.gitmodules b/.gitmodules
index e48ee19d..bb452163 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -7,9 +7,6 @@
 [submodule "src/vendor/arduino-DHT"]
 	path = src/vendor/arduino-DHT
 	url = https://github.com/markruys/arduino-DHT.git
-[submodule "src/vendor/OneWire"]
-	path = src/vendor/OneWire
-	url = https://github.com/PaulStoffregen/OneWire.git
 [submodule "src/vendor/IRremoteESP8266"]
 	path = src/vendor/IRremoteESP8266
 	url = https://github.com/markszabo/IRremoteESP8266.git
diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index 9a7ae8a4..0f428b1e 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -5,11 +5,19 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
+ds18b20 = Dino::Components::DS18B20.new(pin: 16, board: board)
 
-# The temperature and humidity functions of the DHT sensors are
-# modelled separately, but both isntances can be set up on the same pin.
-temp = Dino::Components::DS18B20.new(pin: 7, board: board)
+ds18b20.poll(5) do |reading|
+  # Start each reading line with a timestamp.
+  print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
 
-temp.read do |temperature|
-  puts "The temperature is #{temperature} degrees C"
+  if reading[:crc_error]
+    puts "CRC check failed for this reading!"
+  else
+    # Print converted temperature in degrees C and F and raw 9 bytes from sensor.
+    print "#{reading[:c]} \xC2\xB0C / #{reading[:f]} \xC2\xB0F / "
+    puts "Raw: #{reading[:raw].inspect}"
+  end
 end
+
+sleep
diff --git a/lib/dino/components/ds18b20.rb b/lib/dino/components/ds18b20.rb
index 1651b74e..5df5a5ff 100644
--- a/lib/dino/components/ds18b20.rb
+++ b/lib/dino/components/ds18b20.rb
@@ -2,11 +2,122 @@ module Dino
   module Components
     class DS18B20
       include Setup::SinglePin
-      include Setup::Input
       include Mixins::Poller
+      attr_reader :resolution
+
+      def after_initialize(options={})
+        super(options) if defined?(super)
+        # default to 12 bit resolution here.
+      end
+
+      def resolution=
+        # send commands to set resolution and store in instance variable
+      end
+
+      def pre_callback_filter(data)
+        # Data will be 9 comma delimited bytes as ASCII numbers for now.
+        bytes = data.split(",").map{|b| b.to_i}
+        return {crc_error: true} unless crc_check(bytes)
+
+        # Decode temperature from first 2 bytes.
+        # Returns hash with C and F values.
+        decode(bytes[1], bytes[0]).merge(raw: bytes, crc_error: false)
+      end
+
+      # Just store Celsius in @state?
+      def self_update(hash)
+        @state = hash[:c]
+      end
+
+      def crc_check(bytes)
+        puts bytes.inspect
+        crc = 0b00000000
+
+        # Last byte IS the read CRC, so just use the first 8.
+        bytes.take(8).each do |byte|
+          # LSB first
+          for bit in (0..7)
+            # XOR current bit with the LSB of the CRC.
+            xor = byte[bit] ^ crc[0]
+            # XOR CRC bits 3 and 4 with first XOR result, then move right.
+            crc = crc ^ ((xor * (2 ** 3)) | (xor * (2 ** 4)))
+            crc = crc >> 1
+            # Write first XOR result to the now empty MSB of the CRC.
+            crc = crc | (xor * (2 ** 7)) # crc[7] = xor
+          end
+        end
+
+        # Check against read CRC.
+        crc == bytes.last
+      end
+
+      def decode(high_byte, low_byte)
+        # Make one 16 bit value to work with.
+        value = high_byte << 8 | low_byte
+
+        # Two's complement, so if MSB is 1, value is -ve degrees C.
+        negative = (value[15] == 1)
+
+        # Get magnitude. Will reset sign after.
+        value = (value ^ 0b1111_1111_1111_1111) + 1 if negative
+
+        # Expand the exponents. LSB is 2^-4.
+        celsius = 0.0
+        exp = -4
+        for bit in (0..10)
+          celsius = celsius + (2.0 ** (exp+bit)) if (value[bit] == 1)
+        end
+        celsius = -celsius if negative
+        farenheit = (celsius * 1.8 + 32).round(4)
+        {c: celsius, f: farenheit}
+      end
 
       def _read
-        board.ds18b20_read(self.pin)
+        # bus.synchronize do
+        reset
+        skip_rom
+        convert
+        # end
+
+        # Wait for A/D conversion in Ruby. Won't block the bus or the board.
+        # Should scale inversely with resolution. Divide by 2 per bit of resolution.
+        sleep(0.75)
+
+        # bus.synchronize do
+        reset
+        skip_rom
+        scratch_read
+        bus_read(9)
+        # end
+      end
+
+      def reset
+        board.write Dino::Message.encode(command: 41, pin: pin)
+      end
+
+      def bus_read(num_bytes)
+        board.write Dino::Message.encode(command: 44, pin: pin, value: num_bytes)
+      end
+
+      def scratch_read
+        write(0xBE)
+      end
+
+      def skip_rom
+        write(0xCC)
+      end
+
+      def convert
+        write(0x44)
+      end
+
+      def write(*bytes)
+        bytes = bytes.flatten
+        raise ArgumentError, "wrong number of arguments (given 0, expected at least 1)" if bytes.empty?
+
+        length = bytes.length
+        bytes = bytes.pack('C*')
+        board.write Dino::Message.encode(command: 43, pin: pin, value: length, aux_message: bytes)
       end
     end
   end
diff --git a/spec/lib/components/ds18b20_spec.rb b/spec/lib/components/ds18b20_spec.rb
new file mode 100644
index 00000000..aa5e354d
--- /dev/null
+++ b/spec/lib/components/ds18b20_spec.rb
@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    describe DS18B20 do
+      include BoardMock
+      let(:options) { { board: board, pin: 7 } }
+      subject { DS18B20.new(options)  }
+
+      describe '#decode' do
+        it 'should decode values matching the datasheet and convert C to F' do
+          expect(subject.decode(0b0000_0111, 0b1101_0000)).to eq(c: 125, f: 257)
+          expect(subject.decode(0b0000_0000, 0b0000_0000)).to eq(c: 0, f: 32)
+          expect(subject.decode(0b1111_1111, 0b0101_1110)).to eq(c: -10.125, f: 13.775)
+          expect(subject.decode(0b1111_1100, 0b1001_0000)).to eq(c: -55, f: -67)
+        end
+      end
+    end
+  end
+end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index e350c68f..13bc8915 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -129,11 +129,6 @@ void Dino::process() {
     case 13: dhtRead             ();    break;
     #endif
 
-    // Implemented in DinoOneWire.cpp
-    #ifdef DINO_ONE_WIRE
-    case 15: ds18Read            ();    break;
-    #endif
-
     // Implemented in DinoIROut.cpp
     #ifdef DINO_IR_OUT
     case 16: irSend              ();    break;
@@ -170,6 +165,14 @@ void Dino::process() {
     case 35: i2cRead             ();  break;
     #endif
 
+    // Implemented in DinoOneWire.cpp
+    #ifdef DINO_ONE_WIRE
+    case 41: owReset             ();  break;
+    case 42: owSearch            ();  break;
+    case 43: owWrite             ();  break;
+    case 44: owRead              ();  break;
+    #endif
+
     // Implemented in this file.
     case 90: reset               ();  break;
     case 95: setRegisterDivider  ();  break;
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 81c27c96..469e34de 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -73,7 +73,6 @@ class Dino {
     void handleLCD             ();         //cmd = 10
     void handleSerial          ();         //cmd = 12
     void dhtRead               ();         //cmd = 13
-    void ds18Read              ();         //cmd = 15
     void irSend                ();         //cmd = 16
     void tone                  ();         //cmd = 17
     void noTone                ();         //cmd = 18
@@ -103,6 +102,14 @@ class Dino {
     void i2cWrite              (); //cmd = 34
     void i2cRead               (); //cmd = 35
 
+    // One Wire
+    void owReset               (); //cmd = 41
+    void owSearch              (); //cmd = 42
+    void owWrite               (); //cmd = 43
+    void owRead                (); //cmd = 44
+    void owWriteBit            (byte b);
+    byte owReadBit             ();
+
     // API access to timings, resolutions and reset.
     void reset                 ();  //cmd = 90
     void resetState            ();
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
index d157a88a..aaba627c 100644
--- a/src/lib/DinoOneWire.cpp
+++ b/src/lib/DinoOneWire.cpp
@@ -1,60 +1,97 @@
 //
-// This file adds to the Dino class only if DINO_ONE_WIRE is defined in Dino.h.
+// This file contains low-level functions to get precise (enough)
+// timing required for using the Dallas/Maxim 1-Wire protocol.
+// Higher level logic is handled in Ruby.
 //
 #include "Dino.h"
 #ifdef DINO_ONE_WIRE
 
-#include "OneWire.h"
-
-// CMD = 15
-void Dino::ds18Read() {
-  OneWire ds(pin);
-
-  byte data[12];
-  byte addr[8];
+void Dino::owReset(){
+  // bool present;
+  pinMode(pin, OUTPUT);
+  digitalWrite(pin, LOW);
+  delayMicroseconds(500);
+  pinMode(pin, INPUT);
+  delayMicroseconds(80);
+  // present = !digitalRead(pin);
+  delayMicroseconds(420);
+  // send presence value here
+}
 
-  if ( !ds.search(addr)) {
-    ds.reset_search();
-    return;
-   }
+void Dino::owSearch(){
+}
 
-  if ( OneWire::crc8( addr, 7) != addr[7]) {
-    // Serial.println("CRC is not valid!");
-    return;
+// CMD = 43
+// Write to the OneWire bus.
+//
+// val = number of bytes to write
+// auxMsg[0] = first byte of data and so on...
+// Limited to 255 bytes. Validate on remote end.
+//
+void Dino::owWrite(){
+  byte b;
+  for(byte i=0; i<val; i++){
+    b = auxMsg[i];
+    for(byte j=0; j<8; j++){
+      owWriteBit(bitRead(b, j));
+    }
   }
+}
 
-  if ( addr[0] != 0x10 && addr[0] != 0x28) {
-    // Serial.print("Device is not recognized");
-    return;
-  }
+void Dino::owWriteBit(byte b){
+  // Write slot always starts with pulling the bus low for at least 1us.
+  pinMode(pin, OUTPUT);
+  digitalWrite(pin, LOW);
+  delayMicroseconds(1);
 
-  ds.reset();
-  ds.select(addr);
-  ds.write(0x44,1); // start conversion, with parasite power on at the end
+  // If 1, release so the bus idles high, and wait out the 60us write slot.
+  if(b == 1){
+    pinMode(pin, INPUT);
+    delayMicroseconds(59);
+  // If 0, keep it low for the rest of the 60us write slot, then release.
+  } else {
+    delayMicroseconds(59);
+    pinMode(pin, INPUT);
+  }
+  // Minimum 1us recovery time after each slot.
+  delayMicroseconds(1);
+}
 
-  byte present = ds.reset();
-  ds.select(addr);
-  ds.write(0xBE); // Read Scratchpad
+// CMD = 44
+// Read bytes from the OneWire bus.
+//
+// val = number of bytes to read
+void Dino::owRead(){
+  byte b;
+  // Start with the pin that the bus is on and the colon.
+  stream->print(pin); stream->print(':');
 
-  for (int i = 0; i < 9; i++) { // we need 9 bytes
-    data[i] = ds.read();
+  // Print each byte read, followed by a comma, or newline for last byte.
+  for(byte i=0; i<val; i++){
+    for(byte j=0; j<8; j++){
+      bitWrite(b, j, owReadBit());
+    }
+    stream->print(b);
+    stream->print((i == (val-1)) ? '\n' : ',');
   }
+}
 
-  ds.reset_search();
+byte Dino::owReadBit(){
+  byte b;
+  // Pull low for at least 1us to start a read time slot, then release.
+  pinMode(pin, OUTPUT);
+  digitalWrite(pin, LOW);
+  delayMicroseconds(1);
+  pinMode(pin, INPUT);
 
-  byte MSB = data[1];
-  byte LSB = data[0];
+  // Wait for the slave to write to the bus. It should hold for up to 15us.
+  delayMicroseconds(5);
 
-  float tempRead = ((MSB << 8) | LSB); //using two's compliment
-  float reading = tempRead / 16;
-  char readingBuff[10];
+  // If slave pulled the bus high, the bit a 1, else 0.
+  b = digitalRead(pin);
 
-  if (! isnan(reading)) {
-    stream->print(pin);
-    stream->print(':');
-    stream->print(reading, 4);
-    stream->print('\n');
-  }
+  // Wait out the 60us window + recovery time.
+  delayMicroseconds(55);
+  return b;
 }
-
 #endif
diff --git a/src/vendor/OneWire b/src/vendor/OneWire
deleted file mode 160000
index ac0ea9a7..00000000
--- a/src/vendor/OneWire
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit ac0ea9a7fc266b2d709532fcb1269ffe5fcbbb46

From 43e7dea876fecb491b60109d6a8528fe03d57cdb Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 3 Feb 2018 23:50:06 -0400
Subject: [PATCH 160/296] Parasite power detection/support. Extract Bus
 interface.

---
 examples/one_wire/ds18b20.rb                |  24 +++-
 lib/dino/components.rb                      |   2 +-
 lib/dino/components/ds18b20.rb              | 124 --------------------
 lib/dino/components/mixins.rb               |   1 +
 lib/dino/components/mixins/board_proxy.rb   |  13 +-
 lib/dino/components/mixins/bus.rb           |  27 +++++
 lib/dino/components/mixins/poller.rb        |   4 +-
 lib/dino/components/mixins/reader.rb        |   4 +-
 lib/dino/components/onewire.rb              |  10 ++
 lib/dino/components/onewire/bus.rb          |  50 ++++++++
 lib/dino/components/onewire/constants.rb    |  17 +++
 lib/dino/components/onewire/ds18b20.rb      |  85 ++++++++++++++
 lib/dino/components/onewire/helper.rb       |  29 +++++
 spec/lib/components/ds18b20_spec.rb         |  20 ----
 spec/lib/components/onewire/ds18b20_spec.rb |  22 ++++
 src/lib/DinoOneWire.cpp                     |  12 +-
 16 files changed, 279 insertions(+), 165 deletions(-)
 delete mode 100644 lib/dino/components/ds18b20.rb
 create mode 100644 lib/dino/components/mixins/bus.rb
 create mode 100644 lib/dino/components/onewire.rb
 create mode 100644 lib/dino/components/onewire/bus.rb
 create mode 100644 lib/dino/components/onewire/constants.rb
 create mode 100644 lib/dino/components/onewire/ds18b20.rb
 create mode 100644 lib/dino/components/onewire/helper.rb
 delete mode 100644 spec/lib/components/ds18b20_spec.rb
 create mode 100644 spec/lib/components/onewire/ds18b20_spec.rb

diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index 0f428b1e..dd2e889c 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -5,17 +5,33 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-ds18b20 = Dino::Components::DS18B20.new(pin: 16, board: board)
+bus = Dino::Components::OneWire::Bus.new(pin:16, board: board)
+ds18b20 = Dino::Components::OneWire::DS18B20.new(board: bus)
 
+# Bus can detect if a device is using parasite power, but not WHICH devices.
+if bus.parasite_power
+  puts "Parasite power detected..."; puts
+end
+
+# Blocking read that returns the read value.
+temp = ds18b20.read[:celsius]
+puts "Single read: #{temp} \xC2\xB0C"
+
+# Read the most recent value from the component's @state variable.
+sleep 0.5
+temp = ds18b20.state[:celsius]
+puts "Read from last state: #{temp} \xC2\xB0C"
+
+# Poll the sensor every 5 seconds with a callback showing C, F and raw bytes.
+puts
+puts "Start polling..."
 ds18b20.poll(5) do |reading|
-  # Start each reading line with a timestamp.
   print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
 
   if reading[:crc_error]
     puts "CRC check failed for this reading!"
   else
-    # Print converted temperature in degrees C and F and raw 9 bytes from sensor.
-    print "#{reading[:c]} \xC2\xB0C / #{reading[:f]} \xC2\xB0F / "
+    print "#{reading[:celsius]} \xC2\xB0C / #{reading[:farenheit]} \xC2\xB0F / "
     puts "Raw: #{reading[:raw].inspect}"
   end
 end
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index e1a62fd0..c4260b74 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -16,9 +16,9 @@ module Components
     autoload :Relay,            'dino/components/relay'
     autoload :SoftwareSerial,   'dino/components/softserial'
     autoload :DHT,              'dino/components/dht'
-    autoload :DS18B20,          'dino/components/ds18b20'
     autoload :IREmitter,        'dino/components/ir_emitter'
     autoload :Piezo,            'dino/components/piezo'
     autoload :RotaryEncoder,    'dino/components/rotary_encoder'
+    autoload :OneWire,          'dino/components/onewire'
   end
 end
diff --git a/lib/dino/components/ds18b20.rb b/lib/dino/components/ds18b20.rb
deleted file mode 100644
index 5df5a5ff..00000000
--- a/lib/dino/components/ds18b20.rb
+++ /dev/null
@@ -1,124 +0,0 @@
-module Dino
-  module Components
-    class DS18B20
-      include Setup::SinglePin
-      include Mixins::Poller
-      attr_reader :resolution
-
-      def after_initialize(options={})
-        super(options) if defined?(super)
-        # default to 12 bit resolution here.
-      end
-
-      def resolution=
-        # send commands to set resolution and store in instance variable
-      end
-
-      def pre_callback_filter(data)
-        # Data will be 9 comma delimited bytes as ASCII numbers for now.
-        bytes = data.split(",").map{|b| b.to_i}
-        return {crc_error: true} unless crc_check(bytes)
-
-        # Decode temperature from first 2 bytes.
-        # Returns hash with C and F values.
-        decode(bytes[1], bytes[0]).merge(raw: bytes, crc_error: false)
-      end
-
-      # Just store Celsius in @state?
-      def self_update(hash)
-        @state = hash[:c]
-      end
-
-      def crc_check(bytes)
-        puts bytes.inspect
-        crc = 0b00000000
-
-        # Last byte IS the read CRC, so just use the first 8.
-        bytes.take(8).each do |byte|
-          # LSB first
-          for bit in (0..7)
-            # XOR current bit with the LSB of the CRC.
-            xor = byte[bit] ^ crc[0]
-            # XOR CRC bits 3 and 4 with first XOR result, then move right.
-            crc = crc ^ ((xor * (2 ** 3)) | (xor * (2 ** 4)))
-            crc = crc >> 1
-            # Write first XOR result to the now empty MSB of the CRC.
-            crc = crc | (xor * (2 ** 7)) # crc[7] = xor
-          end
-        end
-
-        # Check against read CRC.
-        crc == bytes.last
-      end
-
-      def decode(high_byte, low_byte)
-        # Make one 16 bit value to work with.
-        value = high_byte << 8 | low_byte
-
-        # Two's complement, so if MSB is 1, value is -ve degrees C.
-        negative = (value[15] == 1)
-
-        # Get magnitude. Will reset sign after.
-        value = (value ^ 0b1111_1111_1111_1111) + 1 if negative
-
-        # Expand the exponents. LSB is 2^-4.
-        celsius = 0.0
-        exp = -4
-        for bit in (0..10)
-          celsius = celsius + (2.0 ** (exp+bit)) if (value[bit] == 1)
-        end
-        celsius = -celsius if negative
-        farenheit = (celsius * 1.8 + 32).round(4)
-        {c: celsius, f: farenheit}
-      end
-
-      def _read
-        # bus.synchronize do
-        reset
-        skip_rom
-        convert
-        # end
-
-        # Wait for A/D conversion in Ruby. Won't block the bus or the board.
-        # Should scale inversely with resolution. Divide by 2 per bit of resolution.
-        sleep(0.75)
-
-        # bus.synchronize do
-        reset
-        skip_rom
-        scratch_read
-        bus_read(9)
-        # end
-      end
-
-      def reset
-        board.write Dino::Message.encode(command: 41, pin: pin)
-      end
-
-      def bus_read(num_bytes)
-        board.write Dino::Message.encode(command: 44, pin: pin, value: num_bytes)
-      end
-
-      def scratch_read
-        write(0xBE)
-      end
-
-      def skip_rom
-        write(0xCC)
-      end
-
-      def convert
-        write(0x44)
-      end
-
-      def write(*bytes)
-        bytes = bytes.flatten
-        raise ArgumentError, "wrong number of arguments (given 0, expected at least 1)" if bytes.empty?
-
-        length = bytes.length
-        bytes = bytes.pack('C*')
-        board.write Dino::Message.encode(command: 43, pin: pin, value: length, aux_message: bytes)
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/mixins.rb b/lib/dino/components/mixins.rb
index 6e8afe56..9dfe8b26 100644
--- a/lib/dino/components/mixins.rb
+++ b/lib/dino/components/mixins.rb
@@ -6,6 +6,7 @@ module Mixins
       require 'dino/components/mixins/reader'
       require 'dino/components/mixins/poller'
       require 'dino/components/mixins/listener'
+      require 'dino/components/mixins/bus'
       require 'dino/components/mixins/board_proxy'
     end
   end
diff --git a/lib/dino/components/mixins/board_proxy.rb b/lib/dino/components/mixins/board_proxy.rb
index 961a4753..a256b3be 100644
--- a/lib/dino/components/mixins/board_proxy.rb
+++ b/lib/dino/components/mixins/board_proxy.rb
@@ -2,22 +2,15 @@ module Dino
   module Components
     module Mixins
       module BoardProxy
+        include Bus
+
         def after_initialize(options={})
           super(options) if defined?(super)
           @high = 1
           @low = 0
-          @components = []
         end
 
-        attr_reader :high, :low, :components
-
-        def add_component(component)
-          @components << component
-        end
-
-        def remove_component(component)
-          @components.delete(component)
-        end
+        attr_reader :high, :low
 
         def convert_pin(pin)
           pin = pin.to_i
diff --git a/lib/dino/components/mixins/bus.rb b/lib/dino/components/mixins/bus.rb
new file mode 100644
index 00000000..b1c80974
--- /dev/null
+++ b/lib/dino/components/mixins/bus.rb
@@ -0,0 +1,27 @@
+module Dino
+  module Components
+    module Mixins
+      module Bus
+        #
+        # Behavior mixin for any component that tracks multiple other components
+        # attached to it, matching Board, but without the full Board interface.
+        # See OneWire::Bus class for an example.
+        #
+        def after_initialize(options={})
+          super(options) if defined?(super)
+          @components = []
+        end
+
+        attr_reader :components
+
+        def add_component(component)
+          @components << component
+        end
+
+        def remove_component(component)
+          @components.delete(component)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/mixins/poller.rb b/lib/dino/components/mixins/poller.rb
index 35b17938..c90e622b 100644
--- a/lib/dino/components/mixins/poller.rb
+++ b/lib/dino/components/mixins/poller.rb
@@ -5,11 +5,11 @@ module Poller
         include Reader
         include Threaded
 
-        def poll(interval=1, &block)
+        def poll(interval=1, *args, &block)
           stop
           add_callback(:poll, &block) if block_given?
           threaded_loop do
-            _read; sleep interval
+            _read(*args); sleep interval
           end
         end
 
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index 03ad8aec..4c1a4038 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -4,13 +4,13 @@ module Mixins
       module Reader
         include Callbacks
 
-        def read(&block)
+        def read(*args, &block)
           add_callback(:read, &block) if block_given?
 
           value = nil
           add_callback(:read) { |data| value = data }
 
-          _read
+          _read(*args)
           loop { break if !@callbacks[:read] }
 
           value
diff --git a/lib/dino/components/onewire.rb b/lib/dino/components/onewire.rb
new file mode 100644
index 00000000..3a4bd8c4
--- /dev/null
+++ b/lib/dino/components/onewire.rb
@@ -0,0 +1,10 @@
+module Dino
+  module Components
+    module OneWire
+      require 'dino/components/onewire/constants'
+      require 'dino/components/onewire/helper'
+      require 'dino/components/onewire/bus'
+      require 'dino/components/onewire/ds18b20'
+    end
+  end
+end
diff --git a/lib/dino/components/onewire/bus.rb b/lib/dino/components/onewire/bus.rb
new file mode 100644
index 00000000..ccdac631
--- /dev/null
+++ b/lib/dino/components/onewire/bus.rb
@@ -0,0 +1,50 @@
+module Dino
+  module Components
+    module OneWire
+      class Bus < Basic::DigitalOutput
+        include Mixins::Bus
+        include Mixins::Reader
+
+        attr_reader :parasite_power, :mutex
+
+        def after_initialize(options = {})
+          super(options) if defined?(super)
+          @mutex = Mutex.new
+          read_power_supply
+        end
+
+        def read_power_supply
+          sleep 0.1
+          reset
+          write(SKIP_ROM, READ_POWER_SUPPLY)
+          byte = read(1)
+          @parasite_power = (byte.to_i[0] == 0) ? true : false
+        end
+
+        def reset
+          board.write Dino::Message.encode(command: 41, pin: pin)
+        end
+
+        def _read(num_bytes)
+          board.write Dino::Message.encode(command: 44, pin: pin, value: num_bytes)
+        end
+
+        def write(*bytes)
+          bytes = bytes.flatten
+          raise ArgumentError, "wrong number of arguments (given 0, expected at least 1)" if bytes.empty?
+
+          length = bytes.length
+          raise Exception.new('max 127 bytes for single OneWire write') if length > 127
+
+          # Set flag if last byte is a command requiring parasite power after it.
+          if parasite_power && [CONVERT_T, COPY_SCRATCH].include?(bytes.last)
+            length = length | 0b10000000
+          end
+
+          bytes = bytes.pack('C*')
+          board.write Dino::Message.encode(command: 43, pin: pin, value: length, aux_message: bytes)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/onewire/constants.rb b/lib/dino/components/onewire/constants.rb
new file mode 100644
index 00000000..0e62c976
--- /dev/null
+++ b/lib/dino/components/onewire/constants.rb
@@ -0,0 +1,17 @@
+module Dino
+  module Components
+    module OneWire
+      READ_POWER_SUPPLY = 0xB4
+      CONVERT_T         = 0x44
+      SEARCH_ROM        = 0xF0
+      READ_ROM          = 0x33
+      SKIP_ROM          = 0xCC
+      MATCH_ROM         = 0x55
+      ALARM_SEARCH      = 0xEC
+      READ_SCRATCH      = 0xBE
+      WRITE_SCRATCH     = 0x4E
+      COPY_SCRATCH      = 0x48
+      RECALL_EEPROM     = 0xB8
+    end
+  end
+end
diff --git a/lib/dino/components/onewire/ds18b20.rb b/lib/dino/components/onewire/ds18b20.rb
new file mode 100644
index 00000000..936b32ca
--- /dev/null
+++ b/lib/dino/components/onewire/ds18b20.rb
@@ -0,0 +1,85 @@
+module Dino
+  module Components
+    module OneWire
+      class DS18B20
+        include Setup::Base
+        include Mixins::Poller
+        attr_reader :resolution, :parasite_power
+
+        alias  :bus :board
+
+        def after_initialize(options={})
+          super(options) if defined?(super)
+          # Should set only if given as parameter.
+          # If not, read from sensor and leave as is.
+          self.resolution = 12
+        end
+
+        def resolution
+          # Read scratchpad and resolution from sensor here.
+        end
+
+        def resolution=(bits)
+          raise 'Invalid resolution for DS18B20 sensor' if (bits > 12 || bits < 9)
+          @resolution = bits
+          # Send commands to set resolution here.
+          @convert_time = 0.75 / (13 - bits)
+        end
+
+        def _read
+          bus.mutex.synchronize do
+            bus.reset
+            bus.write(SKIP_ROM, CONVERT_T)
+            sleep @convert_time if bus.parasite_power
+          end
+
+          sleep @convert_time unless bus.parasite_power
+          data = nil
+
+          bus.mutex.synchronize do
+            bus.reset
+            bus.write(SKIP_ROM, READ_SCRATCH)
+            data = bus.read(9)
+          end
+
+          # Once we got data, free the bus and run callbacks ourselves.
+          self.update(data)
+        end
+
+        #
+        # Data comes in as 9 comma delimited bytes in ASCII numbers.
+        # First 2 bytes are a coded little-endian number containing degrees C.
+        # Check CRC first. If good, decode and pass on degrees C, F and raw data.
+        #
+        def pre_callback_filter(data)
+          bytes = data.split(",").map{|b| b.to_i}
+          return {crc_error: true} unless Helper.crc_check(bytes)
+
+          decode(bytes[1], bytes[0]).merge(raw: bytes)
+        end
+
+        #
+        # Temperature is the first 16 bits (2 bytes of 9 read), little-endian.
+        # It's a sign-extended two's complement 11-bit decimal, where LSB is the
+        # 2^-4 exponent, up through 2^6 for bit 11. The 5 MSBs repeat the sign.
+        #
+        def decode(high_byte, low_byte)
+          # Concatenate to 16-bit and reverse two's complement if necessary.
+          value = high_byte << 8 | low_byte
+          negative = (value[15] == 1)
+          value = (value ^ 0xFFFF) + 1 if negative
+
+          # Expand the exponents, restore sign, and convert to Farenheit.
+          celsius = 0.0; exp = -4
+          for bit in (0..10)
+            celsius = celsius + (2.0 ** (exp+bit)) if (value[bit] == 1)
+          end
+          celsius = -celsius if negative
+          farenheit = (celsius * 1.8 + 32).round(4)
+
+          {celsius: celsius, farenheit: farenheit}
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/onewire/helper.rb b/lib/dino/components/onewire/helper.rb
new file mode 100644
index 00000000..5fedcfc0
--- /dev/null
+++ b/lib/dino/components/onewire/helper.rb
@@ -0,0 +1,29 @@
+module Dino
+  module Components
+    module OneWire
+      class Helper
+        #
+        # CRC is a single byte. Start with it set to 0. Move through first 8
+        # bytes in the order read, but bitwise LSBFIRST. For each bit:
+        #    1) XOR the bit with the current LSB of CRC
+        #    2) XOR the result of #1 with the bits at indices 3 and 4 of CRC.
+        #    3) Bitshift the CRC right by 1
+        #    4) Write the result of #1 to the now empty MSB of the CRC
+        # After 64 bits, the CRC is valid if it matches the 9th of the read data.
+        #
+        def self.crc_check(bytes)
+          crc = 0b00000000
+          bytes.take(bytes.length - 1).each do |byte|
+            for bit in (0..7)
+              xor = byte[bit] ^ crc[0]
+              crc = crc ^ ((xor * (2 ** 3)) | (xor * (2 ** 4)))
+              crc = crc >> 1
+              crc = crc | (xor * (2 ** 7))
+            end
+          end
+          crc == bytes.last
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/components/ds18b20_spec.rb b/spec/lib/components/ds18b20_spec.rb
deleted file mode 100644
index aa5e354d..00000000
--- a/spec/lib/components/ds18b20_spec.rb
+++ /dev/null
@@ -1,20 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe DS18B20 do
-      include BoardMock
-      let(:options) { { board: board, pin: 7 } }
-      subject { DS18B20.new(options)  }
-
-      describe '#decode' do
-        it 'should decode values matching the datasheet and convert C to F' do
-          expect(subject.decode(0b0000_0111, 0b1101_0000)).to eq(c: 125, f: 257)
-          expect(subject.decode(0b0000_0000, 0b0000_0000)).to eq(c: 0, f: 32)
-          expect(subject.decode(0b1111_1111, 0b0101_1110)).to eq(c: -10.125, f: 13.775)
-          expect(subject.decode(0b1111_1100, 0b1001_0000)).to eq(c: -55, f: -67)
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/onewire/ds18b20_spec.rb b/spec/lib/components/onewire/ds18b20_spec.rb
new file mode 100644
index 00000000..4a0a3099
--- /dev/null
+++ b/spec/lib/components/onewire/ds18b20_spec.rb
@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module OneWire
+      describe DS18B20 do
+        include BoardMock
+        let(:options) { { board: board, pin: 7 } }
+        subject { DS18B20.new(options)  }
+
+        describe '#decode' do
+          it 'should decode values matching the datasheet and convert C to F' do
+            expect(subject.decode(0b0000_0111, 0b1101_0000)).to eq(celsius: 125, farenheit: 257)
+            expect(subject.decode(0b0000_0000, 0b0000_0000)).to eq(celsius: 0, farenheit: 32)
+            expect(subject.decode(0b1111_1111, 0b0101_1110)).to eq(celsius: -10.125, farenheit: 13.775)
+            expect(subject.decode(0b1111_1100, 0b1001_0000)).to eq(celsius: -55, farenheit: -67)
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
index aaba627c..a1f98836 100644
--- a/src/lib/DinoOneWire.cpp
+++ b/src/lib/DinoOneWire.cpp
@@ -24,11 +24,14 @@ void Dino::owSearch(){
 // CMD = 43
 // Write to the OneWire bus.
 //
-// val = number of bytes to write
+// val = number of bytes to write + parasite power condition OR-ed into MSB.
 // auxMsg[0] = first byte of data and so on...
-// Limited to 255 bytes. Validate on remote end.
+// Limited to 127 bytes. Validate on remote end.
 //
 void Dino::owWrite(){
+  bool parasite = bitRead(val, 7);
+  bitClear(val, 7);
+
   byte b;
   for(byte i=0; i<val; i++){
     b = auxMsg[i];
@@ -36,6 +39,11 @@ void Dino::owWrite(){
       owWriteBit(bitRead(b, j));
     }
   }
+
+  if (parasite) {
+    pinMode(pin, OUTPUT);
+    digitalWrite(pin, HIGH);
+  }
 }
 
 void Dino::owWriteBit(byte b){

From 61da7cc5c278baf676ae3a757b75f050161e248b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 4 Feb 2018 00:06:58 -0400
Subject: [PATCH 161/296] Cleanup one wire file names. Clearer code for
 parasite power detect.

---
 lib/dino/components.rb                       |  2 +-
 lib/dino/components/one_wire.rb              | 10 +++
 lib/dino/components/one_wire/bus.rb          | 54 +++++++++++++
 lib/dino/components/one_wire/constants.rb    | 17 ++++
 lib/dino/components/one_wire/ds18b20.rb      | 85 ++++++++++++++++++++
 lib/dino/components/one_wire/helper.rb       | 29 +++++++
 lib/dino/components/onewire.rb               | 10 ---
 spec/lib/components/one_wire/ds18b20_spec.rb | 22 +++++
 8 files changed, 218 insertions(+), 11 deletions(-)
 create mode 100644 lib/dino/components/one_wire.rb
 create mode 100644 lib/dino/components/one_wire/bus.rb
 create mode 100644 lib/dino/components/one_wire/constants.rb
 create mode 100644 lib/dino/components/one_wire/ds18b20.rb
 create mode 100644 lib/dino/components/one_wire/helper.rb
 delete mode 100644 lib/dino/components/onewire.rb
 create mode 100644 spec/lib/components/one_wire/ds18b20_spec.rb

diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index c4260b74..8a58195f 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -19,6 +19,6 @@ module Components
     autoload :IREmitter,        'dino/components/ir_emitter'
     autoload :Piezo,            'dino/components/piezo'
     autoload :RotaryEncoder,    'dino/components/rotary_encoder'
-    autoload :OneWire,          'dino/components/onewire'
+    autoload :OneWire,          'dino/components/one_wire'
   end
 end
diff --git a/lib/dino/components/one_wire.rb b/lib/dino/components/one_wire.rb
new file mode 100644
index 00000000..3929599c
--- /dev/null
+++ b/lib/dino/components/one_wire.rb
@@ -0,0 +1,10 @@
+module Dino
+  module Components
+    module OneWire
+      require 'dino/components/one_wire/constants'
+      require 'dino/components/one_wire/helper'
+      require 'dino/components/one_wire/bus'
+      require 'dino/components/one_wire/ds18b20'
+    end
+  end
+end
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
new file mode 100644
index 00000000..bc5aeeb2
--- /dev/null
+++ b/lib/dino/components/one_wire/bus.rb
@@ -0,0 +1,54 @@
+module Dino
+  module Components
+    module OneWire
+      class Bus
+        include Setup::SinglePin
+        include Mixins::Bus
+        include Mixins::Reader
+
+        attr_reader :parasite_power, :mutex
+
+        def after_initialize(options = {})
+          super(options) if defined?(super)
+          @mutex = Mutex.new
+          read_power_supply
+        end
+
+        def read_power_supply
+          self.mode = :out
+          board.digital_write(self.pin, board.low)
+          sleep 0.1
+
+          reset
+          write(SKIP_ROM, READ_POWER_SUPPLY)
+          byte = read(1)
+          @parasite_power = (byte.to_i[0] == 0) ? true : false
+        end
+
+        def reset
+          board.write Dino::Message.encode(command: 41, pin: pin)
+        end
+
+        def _read(num_bytes)
+          board.write Dino::Message.encode(command: 44, pin: pin, value: num_bytes)
+        end
+
+        def write(*bytes)
+          bytes = bytes.flatten
+          raise ArgumentError, "wrong number of arguments (given 0, expected at least 1)" if bytes.empty?
+
+          length = bytes.length
+          raise Exception.new('max 127 bytes for single OneWire write') if length > 127
+
+          # Set flag if last byte is a command requiring parasite power after it.
+          if parasite_power && [CONVERT_T, COPY_SCRATCH].include?(bytes.last)
+            length = length | 0b10000000
+          end
+
+          bytes = bytes.pack('C*')
+          board.write Dino::Message.encode(command: 43, pin: pin, value: length, aux_message: bytes)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/one_wire/constants.rb b/lib/dino/components/one_wire/constants.rb
new file mode 100644
index 00000000..0e62c976
--- /dev/null
+++ b/lib/dino/components/one_wire/constants.rb
@@ -0,0 +1,17 @@
+module Dino
+  module Components
+    module OneWire
+      READ_POWER_SUPPLY = 0xB4
+      CONVERT_T         = 0x44
+      SEARCH_ROM        = 0xF0
+      READ_ROM          = 0x33
+      SKIP_ROM          = 0xCC
+      MATCH_ROM         = 0x55
+      ALARM_SEARCH      = 0xEC
+      READ_SCRATCH      = 0xBE
+      WRITE_SCRATCH     = 0x4E
+      COPY_SCRATCH      = 0x48
+      RECALL_EEPROM     = 0xB8
+    end
+  end
+end
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
new file mode 100644
index 00000000..936b32ca
--- /dev/null
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -0,0 +1,85 @@
+module Dino
+  module Components
+    module OneWire
+      class DS18B20
+        include Setup::Base
+        include Mixins::Poller
+        attr_reader :resolution, :parasite_power
+
+        alias  :bus :board
+
+        def after_initialize(options={})
+          super(options) if defined?(super)
+          # Should set only if given as parameter.
+          # If not, read from sensor and leave as is.
+          self.resolution = 12
+        end
+
+        def resolution
+          # Read scratchpad and resolution from sensor here.
+        end
+
+        def resolution=(bits)
+          raise 'Invalid resolution for DS18B20 sensor' if (bits > 12 || bits < 9)
+          @resolution = bits
+          # Send commands to set resolution here.
+          @convert_time = 0.75 / (13 - bits)
+        end
+
+        def _read
+          bus.mutex.synchronize do
+            bus.reset
+            bus.write(SKIP_ROM, CONVERT_T)
+            sleep @convert_time if bus.parasite_power
+          end
+
+          sleep @convert_time unless bus.parasite_power
+          data = nil
+
+          bus.mutex.synchronize do
+            bus.reset
+            bus.write(SKIP_ROM, READ_SCRATCH)
+            data = bus.read(9)
+          end
+
+          # Once we got data, free the bus and run callbacks ourselves.
+          self.update(data)
+        end
+
+        #
+        # Data comes in as 9 comma delimited bytes in ASCII numbers.
+        # First 2 bytes are a coded little-endian number containing degrees C.
+        # Check CRC first. If good, decode and pass on degrees C, F and raw data.
+        #
+        def pre_callback_filter(data)
+          bytes = data.split(",").map{|b| b.to_i}
+          return {crc_error: true} unless Helper.crc_check(bytes)
+
+          decode(bytes[1], bytes[0]).merge(raw: bytes)
+        end
+
+        #
+        # Temperature is the first 16 bits (2 bytes of 9 read), little-endian.
+        # It's a sign-extended two's complement 11-bit decimal, where LSB is the
+        # 2^-4 exponent, up through 2^6 for bit 11. The 5 MSBs repeat the sign.
+        #
+        def decode(high_byte, low_byte)
+          # Concatenate to 16-bit and reverse two's complement if necessary.
+          value = high_byte << 8 | low_byte
+          negative = (value[15] == 1)
+          value = (value ^ 0xFFFF) + 1 if negative
+
+          # Expand the exponents, restore sign, and convert to Farenheit.
+          celsius = 0.0; exp = -4
+          for bit in (0..10)
+            celsius = celsius + (2.0 ** (exp+bit)) if (value[bit] == 1)
+          end
+          celsius = -celsius if negative
+          farenheit = (celsius * 1.8 + 32).round(4)
+
+          {celsius: celsius, farenheit: farenheit}
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
new file mode 100644
index 00000000..5fedcfc0
--- /dev/null
+++ b/lib/dino/components/one_wire/helper.rb
@@ -0,0 +1,29 @@
+module Dino
+  module Components
+    module OneWire
+      class Helper
+        #
+        # CRC is a single byte. Start with it set to 0. Move through first 8
+        # bytes in the order read, but bitwise LSBFIRST. For each bit:
+        #    1) XOR the bit with the current LSB of CRC
+        #    2) XOR the result of #1 with the bits at indices 3 and 4 of CRC.
+        #    3) Bitshift the CRC right by 1
+        #    4) Write the result of #1 to the now empty MSB of the CRC
+        # After 64 bits, the CRC is valid if it matches the 9th of the read data.
+        #
+        def self.crc_check(bytes)
+          crc = 0b00000000
+          bytes.take(bytes.length - 1).each do |byte|
+            for bit in (0..7)
+              xor = byte[bit] ^ crc[0]
+              crc = crc ^ ((xor * (2 ** 3)) | (xor * (2 ** 4)))
+              crc = crc >> 1
+              crc = crc | (xor * (2 ** 7))
+            end
+          end
+          crc == bytes.last
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/onewire.rb b/lib/dino/components/onewire.rb
deleted file mode 100644
index 3a4bd8c4..00000000
--- a/lib/dino/components/onewire.rb
+++ /dev/null
@@ -1,10 +0,0 @@
-module Dino
-  module Components
-    module OneWire
-      require 'dino/components/onewire/constants'
-      require 'dino/components/onewire/helper'
-      require 'dino/components/onewire/bus'
-      require 'dino/components/onewire/ds18b20'
-    end
-  end
-end
diff --git a/spec/lib/components/one_wire/ds18b20_spec.rb b/spec/lib/components/one_wire/ds18b20_spec.rb
new file mode 100644
index 00000000..4a0a3099
--- /dev/null
+++ b/spec/lib/components/one_wire/ds18b20_spec.rb
@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module OneWire
+      describe DS18B20 do
+        include BoardMock
+        let(:options) { { board: board, pin: 7 } }
+        subject { DS18B20.new(options)  }
+
+        describe '#decode' do
+          it 'should decode values matching the datasheet and convert C to F' do
+            expect(subject.decode(0b0000_0111, 0b1101_0000)).to eq(celsius: 125, farenheit: 257)
+            expect(subject.decode(0b0000_0000, 0b0000_0000)).to eq(celsius: 0, farenheit: 32)
+            expect(subject.decode(0b1111_1111, 0b0101_1110)).to eq(celsius: -10.125, farenheit: 13.775)
+            expect(subject.decode(0b1111_1100, 0b1001_0000)).to eq(celsius: -55, farenheit: -67)
+          end
+        end
+      end
+    end
+  end
+end

From ea206093e82f516d119c3af701466990c5dce7d6 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 4 Feb 2018 00:09:26 -0400
Subject: [PATCH 162/296] Missing deletions from last commit?

---
 lib/dino/components/onewire/bus.rb          | 50 ------------
 lib/dino/components/onewire/constants.rb    | 17 -----
 lib/dino/components/onewire/ds18b20.rb      | 85 ---------------------
 lib/dino/components/onewire/helper.rb       | 29 -------
 spec/lib/components/onewire/ds18b20_spec.rb | 22 ------
 5 files changed, 203 deletions(-)
 delete mode 100644 lib/dino/components/onewire/bus.rb
 delete mode 100644 lib/dino/components/onewire/constants.rb
 delete mode 100644 lib/dino/components/onewire/ds18b20.rb
 delete mode 100644 lib/dino/components/onewire/helper.rb
 delete mode 100644 spec/lib/components/onewire/ds18b20_spec.rb

diff --git a/lib/dino/components/onewire/bus.rb b/lib/dino/components/onewire/bus.rb
deleted file mode 100644
index ccdac631..00000000
--- a/lib/dino/components/onewire/bus.rb
+++ /dev/null
@@ -1,50 +0,0 @@
-module Dino
-  module Components
-    module OneWire
-      class Bus < Basic::DigitalOutput
-        include Mixins::Bus
-        include Mixins::Reader
-
-        attr_reader :parasite_power, :mutex
-
-        def after_initialize(options = {})
-          super(options) if defined?(super)
-          @mutex = Mutex.new
-          read_power_supply
-        end
-
-        def read_power_supply
-          sleep 0.1
-          reset
-          write(SKIP_ROM, READ_POWER_SUPPLY)
-          byte = read(1)
-          @parasite_power = (byte.to_i[0] == 0) ? true : false
-        end
-
-        def reset
-          board.write Dino::Message.encode(command: 41, pin: pin)
-        end
-
-        def _read(num_bytes)
-          board.write Dino::Message.encode(command: 44, pin: pin, value: num_bytes)
-        end
-
-        def write(*bytes)
-          bytes = bytes.flatten
-          raise ArgumentError, "wrong number of arguments (given 0, expected at least 1)" if bytes.empty?
-
-          length = bytes.length
-          raise Exception.new('max 127 bytes for single OneWire write') if length > 127
-
-          # Set flag if last byte is a command requiring parasite power after it.
-          if parasite_power && [CONVERT_T, COPY_SCRATCH].include?(bytes.last)
-            length = length | 0b10000000
-          end
-
-          bytes = bytes.pack('C*')
-          board.write Dino::Message.encode(command: 43, pin: pin, value: length, aux_message: bytes)
-        end
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/onewire/constants.rb b/lib/dino/components/onewire/constants.rb
deleted file mode 100644
index 0e62c976..00000000
--- a/lib/dino/components/onewire/constants.rb
+++ /dev/null
@@ -1,17 +0,0 @@
-module Dino
-  module Components
-    module OneWire
-      READ_POWER_SUPPLY = 0xB4
-      CONVERT_T         = 0x44
-      SEARCH_ROM        = 0xF0
-      READ_ROM          = 0x33
-      SKIP_ROM          = 0xCC
-      MATCH_ROM         = 0x55
-      ALARM_SEARCH      = 0xEC
-      READ_SCRATCH      = 0xBE
-      WRITE_SCRATCH     = 0x4E
-      COPY_SCRATCH      = 0x48
-      RECALL_EEPROM     = 0xB8
-    end
-  end
-end
diff --git a/lib/dino/components/onewire/ds18b20.rb b/lib/dino/components/onewire/ds18b20.rb
deleted file mode 100644
index 936b32ca..00000000
--- a/lib/dino/components/onewire/ds18b20.rb
+++ /dev/null
@@ -1,85 +0,0 @@
-module Dino
-  module Components
-    module OneWire
-      class DS18B20
-        include Setup::Base
-        include Mixins::Poller
-        attr_reader :resolution, :parasite_power
-
-        alias  :bus :board
-
-        def after_initialize(options={})
-          super(options) if defined?(super)
-          # Should set only if given as parameter.
-          # If not, read from sensor and leave as is.
-          self.resolution = 12
-        end
-
-        def resolution
-          # Read scratchpad and resolution from sensor here.
-        end
-
-        def resolution=(bits)
-          raise 'Invalid resolution for DS18B20 sensor' if (bits > 12 || bits < 9)
-          @resolution = bits
-          # Send commands to set resolution here.
-          @convert_time = 0.75 / (13 - bits)
-        end
-
-        def _read
-          bus.mutex.synchronize do
-            bus.reset
-            bus.write(SKIP_ROM, CONVERT_T)
-            sleep @convert_time if bus.parasite_power
-          end
-
-          sleep @convert_time unless bus.parasite_power
-          data = nil
-
-          bus.mutex.synchronize do
-            bus.reset
-            bus.write(SKIP_ROM, READ_SCRATCH)
-            data = bus.read(9)
-          end
-
-          # Once we got data, free the bus and run callbacks ourselves.
-          self.update(data)
-        end
-
-        #
-        # Data comes in as 9 comma delimited bytes in ASCII numbers.
-        # First 2 bytes are a coded little-endian number containing degrees C.
-        # Check CRC first. If good, decode and pass on degrees C, F and raw data.
-        #
-        def pre_callback_filter(data)
-          bytes = data.split(",").map{|b| b.to_i}
-          return {crc_error: true} unless Helper.crc_check(bytes)
-
-          decode(bytes[1], bytes[0]).merge(raw: bytes)
-        end
-
-        #
-        # Temperature is the first 16 bits (2 bytes of 9 read), little-endian.
-        # It's a sign-extended two's complement 11-bit decimal, where LSB is the
-        # 2^-4 exponent, up through 2^6 for bit 11. The 5 MSBs repeat the sign.
-        #
-        def decode(high_byte, low_byte)
-          # Concatenate to 16-bit and reverse two's complement if necessary.
-          value = high_byte << 8 | low_byte
-          negative = (value[15] == 1)
-          value = (value ^ 0xFFFF) + 1 if negative
-
-          # Expand the exponents, restore sign, and convert to Farenheit.
-          celsius = 0.0; exp = -4
-          for bit in (0..10)
-            celsius = celsius + (2.0 ** (exp+bit)) if (value[bit] == 1)
-          end
-          celsius = -celsius if negative
-          farenheit = (celsius * 1.8 + 32).round(4)
-
-          {celsius: celsius, farenheit: farenheit}
-        end
-      end
-    end
-  end
-end
diff --git a/lib/dino/components/onewire/helper.rb b/lib/dino/components/onewire/helper.rb
deleted file mode 100644
index 5fedcfc0..00000000
--- a/lib/dino/components/onewire/helper.rb
+++ /dev/null
@@ -1,29 +0,0 @@
-module Dino
-  module Components
-    module OneWire
-      class Helper
-        #
-        # CRC is a single byte. Start with it set to 0. Move through first 8
-        # bytes in the order read, but bitwise LSBFIRST. For each bit:
-        #    1) XOR the bit with the current LSB of CRC
-        #    2) XOR the result of #1 with the bits at indices 3 and 4 of CRC.
-        #    3) Bitshift the CRC right by 1
-        #    4) Write the result of #1 to the now empty MSB of the CRC
-        # After 64 bits, the CRC is valid if it matches the 9th of the read data.
-        #
-        def self.crc_check(bytes)
-          crc = 0b00000000
-          bytes.take(bytes.length - 1).each do |byte|
-            for bit in (0..7)
-              xor = byte[bit] ^ crc[0]
-              crc = crc ^ ((xor * (2 ** 3)) | (xor * (2 ** 4)))
-              crc = crc >> 1
-              crc = crc | (xor * (2 ** 7))
-            end
-          end
-          crc == bytes.last
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/onewire/ds18b20_spec.rb b/spec/lib/components/onewire/ds18b20_spec.rb
deleted file mode 100644
index 4a0a3099..00000000
--- a/spec/lib/components/onewire/ds18b20_spec.rb
+++ /dev/null
@@ -1,22 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module OneWire
-      describe DS18B20 do
-        include BoardMock
-        let(:options) { { board: board, pin: 7 } }
-        subject { DS18B20.new(options)  }
-
-        describe '#decode' do
-          it 'should decode values matching the datasheet and convert C to F' do
-            expect(subject.decode(0b0000_0111, 0b1101_0000)).to eq(celsius: 125, farenheit: 257)
-            expect(subject.decode(0b0000_0000, 0b0000_0000)).to eq(celsius: 0, farenheit: 32)
-            expect(subject.decode(0b1111_1111, 0b0101_1110)).to eq(celsius: -10.125, farenheit: 13.775)
-            expect(subject.decode(0b1111_1100, 0b1001_0000)).to eq(celsius: -55, farenheit: -67)
-          end
-        end
-      end
-    end
-  end
-end

From 16e3be4142757857164b0771c4da6d2f3f26862f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 5 Feb 2018 00:04:16 -0400
Subject: [PATCH 163/296] Add OneWire auto search and identify

---
 examples/one_wire/ds18b20.rb                 |  35 ++++---
 lib/dino/components/mixins/reader.rb         |   6 +-
 lib/dino/components/one_wire/bus.rb          |  64 ++++++++++-
 lib/dino/components/one_wire/ds18b20.rb      |  48 +++++++--
 lib/dino/components/one_wire/helper.rb       | 105 ++++++++++++++++++-
 spec/lib/components/one_wire/ds18b20_spec.rb |   2 +-
 src/lib/DinoOneWire.cpp                      |  44 ++++++++
 7 files changed, 274 insertions(+), 30 deletions(-)

diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index dd2e889c..a2948264 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -6,27 +6,30 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 bus = Dino::Components::OneWire::Bus.new(pin:16, board: board)
-ds18b20 = Dino::Components::OneWire::DS18B20.new(board: bus)
 
-# Bus can detect if a device is using parasite power, but not WHICH devices.
+# The bus does parasite power detection on startup.
+# It can tell that parasite power is in use, but not by WHICH devices.
 if bus.parasite_power
   puts "Parasite power detected..."; puts
 end
 
-# Blocking read that returns the read value.
-temp = ds18b20.read[:celsius]
-puts "Single read: #{temp} \xC2\xB0C"
+# The bus automatically searches when initialized. It finds the address of
+# every device, identifies the device type and matching Ruby class, storing here.
+puts "Found #{bus.found_devices.count} devices on the bus:"
+puts bus.found_devices.inspect; puts
 
-# Read the most recent value from the component's @state variable.
-sleep 0.5
-temp = ds18b20.state[:celsius]
-puts "Read from last state: #{temp} \xC2\xB0C"
+# We can use the search results to setup instances of the device classes.
+ds18b20s = []
+bus.found_devices.each do |d|
+  if d[:class] == Dino::Components::OneWire::DS18B20
+    ds18b20s << Dino::Components::OneWire::DS18B20.new(board: bus, address: d[:address])
+  end
+end
 
-# Poll the sensor every 5 seconds with a callback showing C, F and raw bytes.
-puts
-puts "Start polling..."
-ds18b20.poll(5) do |reading|
+#  Format a reading for printing on a line.
+def print_reading(reading, sensor, i)
   print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
+  print "index: #{i}, serial# :#{sensor.serial} "
 
   if reading[:crc_error]
     puts "CRC check failed for this reading!"
@@ -36,4 +39,8 @@
   end
 end
 
-sleep
+# Read the temp from each sensor in a simple loop.
+loop do
+  ds18b20s.each_with_index { |s,i| print_reading(s.read, s, i) }
+  sleep 5
+end
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index 4c1a4038..8749258c 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -11,11 +11,15 @@ def read(*args, &block)
           add_callback(:read) { |data| value = data }
 
           _read(*args)
-          loop { break if !@callbacks[:read] }
+          block_until_read
 
           value
         end
 
+        def block_until_read
+          loop { break if !@callbacks[:read] }
+        end
+
         def _read
           raise NotImplementedError
             .new("#{self.class.name}#_read is not defined.")
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index bc5aeeb2..88aa6cfa 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -6,15 +6,77 @@ class Bus
         include Mixins::Bus
         include Mixins::Reader
 
-        attr_reader :parasite_power, :mutex
+        attr_reader :found_devices, :parasite_power, :mutex
 
         def after_initialize(options = {})
           super(options) if defined?(super)
           @mutex = Mutex.new
+          @found_devices = []
           read_power_supply
+          search
         end
 
+        def search
+          branch_mask = 0
+          high_discrepancy = 0
+
+          loop do
+            self.add_callback(:read) do |result|
+              #
+              # We get a device hash (class and ROM address) as a parsed result,
+              # plus the bit index of the highest discrepancy from the last run.
+              #
+              device, high_discrepancy = Helper.parse_search_result(result)
+              @found_devices << device
+            end
+            _search(branch_mask)
+            block_until_read
+
+            #
+            # Since we're zero-indexed unlike the datasheet, this is when the
+            # search ends. There's no discrepancy left even at the lowest bit.
+            #
+            break if high_discrepancy == - 1
+
+            #
+            # If high_discrepancy was not a forced 1 last time, do it next time.
+            # This way we go as deep as possible into each new branch first.
+            #
+            if branch_mask[high_discrepancy] == 0
+              branch_mask = branch_mask | (2 ** high_discrepancy)
+            end
+
+            #
+            # Clear bits above high_discrepancy so we don't repeat branches.
+            # When high_discrepancy < MSB of branch_mask, this moves us
+            # one node closer to the root and finishing the search.
+            #
+            unset_mask = 0xFFFFFFFFFFFFFFFF >> (63 - high_discrepancy)
+            branch_mask = branch_mask & unset_mask
+          end
+
+          # Just to be safe...
+          @found_devices = @found_devices.uniq
+        end
+
+        #
+        # Reset the bus, then send the search command, along with a 64-bit
+        # mask of bits to write 1 for.
+        #
+        def _search(high_mask)
+          reset
+          write(SEARCH_ROM)
+          board.write Dino::Message.encode command: 42,
+                                           pin: pin,
+                                           aux_message: [high_mask].pack('<Q')
+        end
+
+        #
+        # Drive low, then send READ_POWER_SUPPLY instruction, and read 1 byte.
+        # Any device using parasite power will pull the lowest bit to 0.
+        #
         def read_power_supply
+          # Inconsistent readings without this.
           self.mode = :out
           board.digital_write(self.pin, board.low)
           sleep 0.1
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index 936b32ca..10009819 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -4,8 +4,10 @@ module OneWire
       class DS18B20
         include Setup::Base
         include Mixins::Poller
-        attr_reader :resolution, :parasite_power
 
+        FAMILY_CODE = 0x28
+
+        attr_reader :resolution, :address
         alias  :bus :board
 
         def after_initialize(options={})
@@ -13,12 +15,19 @@ def after_initialize(options={})
           # Should set only if given as parameter.
           # If not, read from sensor and leave as is.
           self.resolution = 12
+
+          raise "missing ROM address for 1-Wire device, try searching first" unless options[:address]
+          @address = options[:address]
         end
 
         def resolution
           # Read scratchpad and resolution from sensor here.
         end
 
+        def serial
+          Helper.address_to_serial(self.address)
+        end
+
         def resolution=(bits)
           raise 'Invalid resolution for DS18B20 sensor' if (bits > 12 || bits < 9)
           @resolution = bits
@@ -26,24 +35,43 @@ def resolution=(bits)
           @convert_time = 0.75 / (13 - bits)
         end
 
-        def _read
+        #
+        # If we're the only device on the bus, save time by skipping ROM match.
+        #
+        def identify
+          bus.reset
+          if bus.found_devices == 1
+            bus.write(SKIP_ROM)
+          else
+            bus.write(MATCH_ROM)
+            bus.write(Helper.address_to_bytes(self.address))
+          end
+        end
+
+        def convert
           bus.mutex.synchronize do
-            bus.reset
-            bus.write(SKIP_ROM, CONVERT_T)
+            identify
+            bus.write(CONVERT_T)
             sleep @convert_time if bus.parasite_power
           end
-
           sleep @convert_time unless bus.parasite_power
-          data = nil
+        end
 
+        def read_scratch
+          data = nil
           bus.mutex.synchronize do
-            bus.reset
-            bus.write(SKIP_ROM, READ_SCRATCH)
+            identify
+            bus.write(READ_SCRATCH)
             data = bus.read(9)
           end
+          data
+        end
 
-          # Once we got data, free the bus and run callbacks ourselves.
-          self.update(data)
+        def _read
+          convert
+          reading = read_scratch
+          # This runs callbacks in our thread instead of the callback thread...
+          self.update(reading)
         end
 
         #
diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
index 5fedcfc0..86efe1ab 100644
--- a/lib/dino/components/one_wire/helper.rb
+++ b/lib/dino/components/one_wire/helper.rb
@@ -3,15 +3,40 @@ module Components
     module OneWire
       class Helper
         #
-        # CRC is a single byte. Start with it set to 0. Move through first 8
-        # bytes in the order read, but bitwise LSBFIRST. For each bit:
+        # Convert a 64-bit ROM address in Integer form to an array of bytes.
+        #
+        def self.address_to_bytes(address)
+          [address].pack('<Q').split("").map(&:ord)
+        end
+
+        #
+        # Convert the 48 bit serial number out of a 64-bit address into printable hex.
+        #
+        def self.address_to_serial(address)
+          address >> 8
+          address.to_s(16)
+        end
+
+        #
+        # CRC is the last byte of any message. Start with it set to 0. Move through
+        # the n-1 data bytes LSBYTE FIRST, but bitwise LSBFIRST. For each bit:
         #    1) XOR the bit with the current LSB of CRC
         #    2) XOR the result of #1 with the bits at indices 3 and 4 of CRC.
         #    3) Bitshift the CRC right by 1
         #    4) Write the result of #1 to the now empty MSB of the CRC
         # After 64 bits, the CRC is valid if it matches the 9th of the read data.
         #
-        def self.crc_check(bytes)
+        def self.crc_check(data)
+          #
+          # Sensor data will usually be an array of bytes, but for checking
+          # things like ROM addresses, we may receive a 64-bit Integer.
+          #
+          if data.class == Integer
+            bytes = address_to_bytes(data)
+          else
+            bytes = data
+          end
+
           crc = 0b00000000
           bytes.take(bytes.length - 1).each do |byte|
             for bit in (0..7)
@@ -23,6 +48,80 @@ def self.crc_check(bytes)
           end
           crc == bytes.last
         end
+
+        #
+        # This separates a search result, checks result for device disconnection,
+        # matches the family byte of the address to a Component class if one exists,
+        # and looks for the highest index discrepancy to continue the search.
+        #
+        def self.parse_search_result(str)
+          address, complement = self.split_search_result(str)
+
+          #
+          # If any address-complement bit-pair is 1-1, either no device is
+          # present on the bus, or a device was disconnected during the search.
+          #
+          if (address & complement) > 0
+            raise "OneWire device not connected or disconnected during search"
+          end
+
+          #
+          # LS byte of the address holds the family code.
+          # Lookup against implemented classes. Nil if no match.
+          #
+          klass = self.family_lookup(address & 0x00000000000000FF)
+
+          #
+          # XOR-ing address with complement gives a 0 bit at each discrepancy.
+          # XOR again with 64 1s to flip to 1s. Ruby truncates leading 0 bits,
+          # so MSB is the highest discrepancy. Result is -1 for no discrepancy.
+          #
+          # Note: The board only sends back discrepancies which we did not
+          # set to 1 on the last search! This does not track all known
+          # discrepancies in the address space, but gives us what we need:
+          # The highest discrepancy that we didn't write a 1 for last time.
+          #
+          new_discrepancies = (address ^ complement) ^ 0xFFFFFFFFFFFFFFFF
+          high_discrepancy = new_discrepancies.bit_length - 1
+          
+          [{class: klass, address: address}, high_discrepancy]
+        end
+
+        #
+        # A search result is a comma separated list of 8 byte-pairs.
+        # Each pair is an address byte, dash (-) separator, and complement byte.
+        # Pairs are ordered LS byte first. Reverse to MS for easier bitshift.
+        #
+        def self.split_search_result(str)
+          byte_pairs = str.split(",")
+          address = 0
+          complement = 0
+
+          byte_pairs.reverse.each do |pair|
+            address_byte, complement_byte = pair.split("-").map(&:to_i)
+            address = (address << 8) | address_byte
+            complement = (complement << 8) | complement_byte
+          end
+
+          if crc_check(address)
+            return [address, complement]
+          else
+            raise "CRC error for device address on OneWire bus"
+          end
+        end
+
+        #
+        # Define FAMILY_CODE in a slave class to get it identified during search.
+        #
+        def self.family_lookup(family_code)
+          OneWire.constants.each do |const|
+            obj = OneWire.const_get(const)
+            if (obj.is_a? Class) && (obj.const_defined? "FAMILY_CODE")
+              return obj if obj::FAMILY_CODE == family_code
+            end
+          end
+          return nil
+        end
       end
     end
   end
diff --git a/spec/lib/components/one_wire/ds18b20_spec.rb b/spec/lib/components/one_wire/ds18b20_spec.rb
index 4a0a3099..55dc3cc1 100644
--- a/spec/lib/components/one_wire/ds18b20_spec.rb
+++ b/spec/lib/components/one_wire/ds18b20_spec.rb
@@ -5,7 +5,7 @@ module Components
     module OneWire
       describe DS18B20 do
         include BoardMock
-        let(:options) { { board: board, pin: 7 } }
+        let(:options) { { board: board, pin: 7, address: 0xFFFFFFFFFFFFFFFF}}
         subject { DS18B20.new(options)  }
 
         describe '#decode' do
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
index a1f98836..41406df7 100644
--- a/src/lib/DinoOneWire.cpp
+++ b/src/lib/DinoOneWire.cpp
@@ -6,6 +6,10 @@
 #include "Dino.h"
 #ifdef DINO_ONE_WIRE
 
+
+// CMD = 41
+// Reset the OneWire bus and optionally return a presence value if val > 0.
+//
 void Dino::owReset(){
   // bool present;
   pinMode(pin, OUTPUT);
@@ -18,7 +22,45 @@ void Dino::owReset(){
   // send presence value here
 }
 
+// CMD = 42
+// Read a 64-bit address and complement, echoing the address bits unless there's
+// a discrepancy, then we check the branch mask in auxMsg to decide what to do.
+//
 void Dino::owSearch(){
+  byte addr;
+  byte comp;
+
+  // Start with the pin that the bus is on and the colon.
+  stream->print(pin); stream->print(':');
+
+  // Print each byte read, followed by a comma, or newline for last byte.
+  for(byte i=0; i<8; i++){
+    for(byte j=0; j<8; j++){
+      bitWrite(addr, j, owReadBit());
+      bitWrite(comp, j, owReadBit());
+
+      // If there is a discrepancy, first 8 bytes of auxMsg is a branch mask.
+      // These are bits we must write 1 for since we're searching that branch.
+      // Also set the address bit to 1, but don't touch the complement.
+      // This 'corrupts' the check for discrepancies we already new about,
+      // but we're tracking that remotely anyway.
+      //
+      if(bitRead(auxMsg[i], j) == 1){
+        owWriteBit(1);
+        bitWrite(addr, j, 1);
+
+      // If we're don't already know about the discrepancy, behave normally
+      // so it shows up on the next search.
+      //
+      } else {
+        owWriteBit(bitRead(addr, j));
+      }
+    }
+    stream->print(addr);
+    stream->print("-");
+    stream->print(comp);
+    stream->print((i == 7) ? '\n' : ',');
+  }
 }
 
 // CMD = 43
@@ -29,6 +71,7 @@ void Dino::owSearch(){
 // Limited to 127 bytes. Validate on remote end.
 //
 void Dino::owWrite(){
+  // Check and clear parasite flag masked into array length.
   bool parasite = bitRead(val, 7);
   bitClear(val, 7);
 
@@ -40,6 +83,7 @@ void Dino::owWrite(){
     }
   }
 
+  // Drive bus high to feed the parasite capacitor after writing if necessary.
   if (parasite) {
     pinMode(pin, OUTPUT);
     digitalWrite(pin, HIGH);

From 6f1eff777e2d1905499b90a0de435670bc3d415b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 5 Feb 2018 12:52:34 -0400
Subject: [PATCH 164/296] Use a known working jruby version for travis.

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 171ae6bb..0627979d 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -6,6 +6,6 @@ before_install:
 rvm:
   - 2.4.1
   - 2.0.0
-  - jruby-19mode
+  - jruby-9.1.15.0
 
 script: bundle exec rspec spec

From 7d12609584e66f6492acb65b69a52bf462bf9fc0 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 5 Feb 2018 13:03:39 -0400
Subject: [PATCH 165/296] Test 1-Wire search algorithm by simulating the bus in
 Ruby.

---
 lib/dino/components/one_wire/bus.rb           |  22 ++-
 lib/dino/components/one_wire/helper.rb        |  10 +-
 spec/lib/components/one_wire/ds18b20_spec.rb  |   4 +-
 .../components/one_wire/enumerator_spec.rb    | 138 ++++++++++++++++++
 4 files changed, 160 insertions(+), 14 deletions(-)
 create mode 100644 spec/lib/components/one_wire/enumerator_spec.rb

diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index 88aa6cfa..eac27e41 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -61,14 +61,14 @@ def search
 
         #
         # Reset the bus, then send the search command, along with a 64-bit
-        # mask of bits to write 1 for.
+        # mask of bits to write 1 to force the search into a specific branch.
         #
-        def _search(high_mask)
+        def _search(branch_mask)
           reset
           write(SEARCH_ROM)
           board.write Dino::Message.encode command: 42,
                                            pin: pin,
-                                           aux_message: [high_mask].pack('<Q')
+                                           aux_message: [branch_mask].pack('<Q')
         end
 
         #
@@ -97,18 +97,24 @@ def _read(num_bytes)
 
         def write(*bytes)
           bytes = bytes.flatten
-          raise ArgumentError, "wrong number of arguments (given 0, expected at least 1)" if bytes.empty?
+          if bytes.empty?
+            raise ArgumentError, "0 bytes given (expected at least 1)"
+          end
 
           length = bytes.length
-          raise Exception.new('max 127 bytes for single OneWire write') if length > 127
+          if length > 127
+            raise ArgumentError, 'too many bytes given (expected at most 127)'
+          end
 
-          # Set flag if last byte is a command requiring parasite power after it.
+          # Set flag in high bit of length if last command needs parasite power.
           if parasite_power && [CONVERT_T, COPY_SCRATCH].include?(bytes.last)
             length = length | 0b10000000
           end
 
-          bytes = bytes.pack('C*')
-          board.write Dino::Message.encode(command: 43, pin: pin, value: length, aux_message: bytes)
+          board.write Dino::Message.encode command: 43,
+                                           pin: pin,
+                                           value: length,
+                                           aux_message: bytes.pack('C*')
         end
       end
     end
diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
index 86efe1ab..6f2b4c42 100644
--- a/lib/dino/components/one_wire/helper.rb
+++ b/lib/dino/components/one_wire/helper.rb
@@ -3,17 +3,19 @@ module Components
     module OneWire
       class Helper
         #
-        # Convert a 64-bit ROM address in Integer form to an array of bytes.
+        # Convert 64-bit Integer ROM address to array of 8 LSByte first bytes.
         #
         def self.address_to_bytes(address)
           [address].pack('<Q').split("").map(&:ord)
         end
 
         #
-        # Convert the 48 bit serial number out of a 64-bit address into printable hex.
+        # Remove the MSByte (CRC) and LSByte (family code) from a ROM address
+        # to get the device's 48-bit serial number and convert to hex.
         #
         def self.address_to_serial(address)
-          address >> 8
+          address = address & 0x00FFFFFFFFFFFFFF
+          address = address >> 8
           address.to_s(16)
         end
 
@@ -83,7 +85,7 @@ def self.parse_search_result(str)
           #
           new_discrepancies = (address ^ complement) ^ 0xFFFFFFFFFFFFFFFF
           high_discrepancy = new_discrepancies.bit_length - 1
-          
+
           [{class: klass, address: address}, high_discrepancy]
         end
 
diff --git a/spec/lib/components/one_wire/ds18b20_spec.rb b/spec/lib/components/one_wire/ds18b20_spec.rb
index 55dc3cc1..ab697f92 100644
--- a/spec/lib/components/one_wire/ds18b20_spec.rb
+++ b/spec/lib/components/one_wire/ds18b20_spec.rb
@@ -5,8 +5,8 @@ module Components
     module OneWire
       describe DS18B20 do
         include BoardMock
-        let(:options) { { board: board, pin: 7, address: 0xFFFFFFFFFFFFFFFF}}
-        subject { DS18B20.new(options)  }
+        let(:bus) { double.as_null_object }
+        subject   { DS18B20.new(board: bus, address: 0xFFFFFFFFFFFFFFFF) }
 
         describe '#decode' do
           it 'should decode values matching the datasheet and convert C to F' do
diff --git a/spec/lib/components/one_wire/enumerator_spec.rb b/spec/lib/components/one_wire/enumerator_spec.rb
new file mode 100644
index 00000000..a4111d0c
--- /dev/null
+++ b/spec/lib/components/one_wire/enumerator_spec.rb
@@ -0,0 +1,138 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module OneWire
+      #
+      # State machine simulating a bus during address search. Initialize with n for
+      # n devices with random (CRC-invalid) addresses. Call #reset before each search.
+      #
+      class BusSimulator
+        def initialize(device_count)
+          @devices = []
+          device_count.times do
+            @devices << { rom: rand(2**64), in_search: true }
+          end
+          @devices = @devices.uniq
+          @index = -1
+        end
+
+        def addresses
+          @addresses ||= @devices.map { |d| d[:rom] }
+        end
+
+        def reset
+          @devices.each { |d| d[:in_search] = true }
+          @index = -1
+        end
+
+        def read_address_bit
+          bit = 1
+          @index = @index + 1
+          @devices.each do |d|
+            if d[:in_search]
+              bit = bit & d[:rom][@index]
+            end
+          end
+          bit
+        end
+
+        def read_complement_bit
+          bit = 1
+          @devices.each do |d|
+            if d[:in_search]
+              comp = d[:rom][@index] ^ 1
+              bit = bit & comp
+            end
+          end
+          bit
+        end
+
+        def write_bit(bit)
+          @devices.each do |d|
+            d[:in_search] = false unless d[:rom][@index] == bit
+          end
+        end
+      end
+
+      #
+      # Class wrapper for Ruby version of the C++ serach function running on the board.
+      # Hopefully that doesn't change...
+      #
+      class BoardSimulator
+        def initialize(simulator)
+          @simulator = simulator
+        end
+
+        def reset
+          @simulator.reset
+        end
+
+        def search(branch_mask)
+          output_string = ""
+          (0..7).each do |i|
+            addr = 0
+            comp = 0
+            (0..7).each do |j|
+              # Read bit and complement from simulator.
+              addr_bit = @simulator.read_address_bit
+              comp_bit = @simulator.read_complement_bit
+
+              # Set them in variable.
+              addr = addr | (addr_bit * (2 ** j))
+              comp = comp | (comp_bit * (2 ** j))
+
+              # Override address bit to a 1 in variable if 1 in mask.
+              # Write whatever addr_bit ends up being back to the simulator.
+              if branch_mask[(i*8) + j] == 1
+                @simulator.write_bit(1)
+                addr = addr | (1 * (2 ** j))
+              else
+                @simulator.write_bit(addr_bit)
+              end
+            end
+
+            output_string << addr.to_s << "-" << comp.to_s
+            output_string << "," if (i != 7 ) # No \n. TxRx strips it IRL.
+          end
+          output_string
+        end
+      end
+
+      #
+      # Monkeypatch Bus to search the board sim instead of a real board.
+      #
+      class Bus
+        def initialize(options={})
+          @board_sim = BoardSimulator.new(options[:simulator])
+          super(options)
+        end
+
+        def _search(branch_mask)
+          @board_sim.reset
+          result = @board_sim.search(branch_mask)
+          # Manually call #update to simulate callback thread.
+          self.update(result)
+        end
+      end
+
+      describe Bus do
+        include BoardMock
+        describe '#search' do
+          it 'should find all the addresses' do
+            # Ignore CRC since the simulator uses random addresses.
+            allow(OneWire::Helper).to receive(:crc_check).and_return true
+            allow_any_instance_of(Bus).to receive(:read_power_supply).and_return false
+
+            # This gets slow really fast... 256 seems fine.
+            sim = BusSimulator.new(256)
+            bus = Bus.new(board: board, pin: 7, simulator: sim)
+
+            found_addresses = bus.found_devices.map { |d| d[:address] }
+            expect(found_addresses.sort).to eq(sim.addresses.sort)
+          end
+        end
+      end
+    end
+  end
+end

From ec113b46f09372a2132cd8773249e1f322a766d1 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 13 Feb 2018 15:55:41 -0400
Subject: [PATCH 166/296] Extract command API from components into a module.

Now Components only call methods on their Board rather than composing, validating, and writing messages themselves.
Also finished 1-Wire implementation but incomplete test coverage.
---
 examples/one_wire/ds18b20.rb                  |  24 ++--
 examples/register/shift_in.rb                 |   4 +-
 lib/dino.rb                                   |   1 +
 lib/dino/api.rb                               |  13 +++
 lib/dino/api/core.rb                          |  76 ++++++++++++
 lib/dino/api/dht.rb                           |  12 ++
 lib/dino/api/helper.rb                        |  51 +++++++++
 lib/dino/api/infrared.rb                      |  19 +++
 lib/dino/api/one_wire.rb                      |  38 ++++++
 lib/dino/api/servo.rb                         |  19 +++
 lib/dino/api/shift_io.rb                      |  45 ++++++++
 lib/dino/api/spi.rb                           |  39 +++++++
 lib/dino/api/tone.rb                          |  18 +++
 lib/dino/board.rb                             |  85 ++------------
 lib/dino/components/dht.rb                    |  10 +-
 lib/dino/components/ir_emitter.rb             |  40 ++-----
 lib/dino/components/mixins/board_proxy.rb     |   2 +-
 lib/dino/components/mixins/bus.rb             |   2 +-
 lib/dino/components/mixins/callbacks.rb       |   2 +-
 lib/dino/components/one_wire.rb               |   2 +
 lib/dino/components/one_wire/bus.rb           | 103 ++++-------------
 .../components/one_wire/bus_enumerator.rb     | 106 +++++++++++++++++
 lib/dino/components/one_wire/ds18b20.rb       | 108 ++++++++----------
 lib/dino/components/one_wire/helper.rb        |  95 +--------------
 lib/dino/components/one_wire/slave.rb         |  76 ++++++++++++
 lib/dino/components/piezo.rb                  |   4 +-
 lib/dino/components/register/shift_in.rb      |  50 ++++----
 lib/dino/components/register/shift_out.rb     |  14 +--
 lib/dino/components/register/spi_in.rb        |  33 ++----
 lib/dino/components/register/spi_out.rb       |  25 ++--
 lib/dino/components/rotary_encoder.rb         |   9 +-
 lib/dino/components/servo.rb                  |   4 +-
 lib/dino/components/setup/base.rb             |  13 +--
 lib/dino/components/setup/input.rb            |   1 +
 lib/dino/components/setup/multi_pin.rb        |  21 ++--
 lib/dino/components/setup/output.rb           |   1 +
 lib/dino/components/setup/single_pin.rb       |   5 +-
 spec/lib/components/mixins/callbacks_spec.rb  |   1 +
 spec/lib/components/mixins/listener_spec.rb   |   1 +
 spec/lib/components/mixins/poller_spec.rb     |   1 +
 spec/lib/components/mixins/reader_spec.rb     |   1 +
 spec/lib/components/mixins/threaded_spec.rb   |   6 +-
 spec/lib/components/one_wire/ds18b20_spec.rb  |  16 ++-
 .../components/one_wire/enumerator_spec.rb    |  12 +-
 spec/lib/components/register/shift_in_spec.rb |  12 +-
 spec/lib/components/servo_spec.rb             |   2 +-
 src/lib/DinoCoreIO.cpp                        |   4 +-
 src/lib/DinoOneWire.cpp                       |  50 ++++----
 48 files changed, 757 insertions(+), 519 deletions(-)
 create mode 100644 lib/dino/api.rb
 create mode 100644 lib/dino/api/core.rb
 create mode 100644 lib/dino/api/dht.rb
 create mode 100644 lib/dino/api/helper.rb
 create mode 100644 lib/dino/api/infrared.rb
 create mode 100644 lib/dino/api/one_wire.rb
 create mode 100644 lib/dino/api/servo.rb
 create mode 100644 lib/dino/api/shift_io.rb
 create mode 100644 lib/dino/api/spi.rb
 create mode 100644 lib/dino/api/tone.rb
 create mode 100644 lib/dino/components/one_wire/bus_enumerator.rb
 create mode 100644 lib/dino/components/one_wire/slave.rb

diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index a2948264..5745aecb 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -7,34 +7,44 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 bus = Dino::Components::OneWire::Bus.new(pin:16, board: board)
 
-# The bus does parasite power detection on startup.
+# The bus detects parasite power automatically when initialized.
 # It can tell that parasite power is in use, but not by WHICH devices.
 if bus.parasite_power
   puts "Parasite power detected..."; puts
 end
 
-# The bus automatically searches when initialized. It finds the address of
-# every device, identifies the device type and matching Ruby class, storing here.
-puts "Found #{bus.found_devices.count} devices on the bus:"
+# Call #device_present to reset the bus and return presence pulse as a boolean.
+if bus.device_present
+  puts "Devices present on bus..."; puts
+else
+  puts "No devices present on bus... Quitting..."
+  return
+end
+
+# Calling #search finds connected devices and stores them in #found_devices.
+# Each hash contains a device's ROM address and matching Ruby class if one exists.
+bus.search
+count = bus.found_devices.count
+puts "Found #{count} device#{'s' if count > 1} on the bus:"
 puts bus.found_devices.inspect; puts
 
 # We can use the search results to setup instances of the device classes.
 ds18b20s = []
 bus.found_devices.each do |d|
   if d[:class] == Dino::Components::OneWire::DS18B20
-    ds18b20s << Dino::Components::OneWire::DS18B20.new(board: bus, address: d[:address])
+    ds18b20s << d[:class].new(bus: bus, address: d[:address])
   end
 end
 
 #  Format a reading for printing on a line.
 def print_reading(reading, sensor, i)
   print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
-  print "index: #{i}, serial# :#{sensor.serial} "
+  print "Serial(HEX): #{sensor.serial_number} | Res: #{sensor.resolution} bits | "
 
   if reading[:crc_error]
     puts "CRC check failed for this reading!"
   else
-    print "#{reading[:celsius]} \xC2\xB0C / #{reading[:farenheit]} \xC2\xB0F / "
+    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:farenheit]} \xC2\xB0F | "
     puts "Raw: #{reading[:raw].inspect}"
   end
 end
diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index 64ce1521..03576c03 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -7,7 +7,7 @@
 # The Button object is created by passing the register instead of the board, and
 # the register's parallel output pin that the button is connected to.
 #
-# Note: preclock_high must be set to true if using TI CD4021B register or similar.
+# Note: rising_clock must be set to true if using TI CD4021B register or similar.
 # This should apply to any register which outputs on a rising clock edge.
 # Change as needed.
 #
@@ -18,7 +18,7 @@
 
 shift_register = Dino::Components::Register::ShiftIn.new  board: board,
                                                           pins: {latch: 10, data: 12, clock: 13},
-                                                          preclock_high: true,
+                                                          rising_clock: true,
                                                           bytes: 1
 
 button = Dino::Components::Button.new(pin: 0, board: shift_register)
diff --git a/lib/dino.rb b/lib/dino.rb
index 9a6ed2ec..a77f369f 100644
--- a/lib/dino.rb
+++ b/lib/dino.rb
@@ -2,6 +2,7 @@
 
 require 'dino/version'
 require 'dino/message'
+require 'dino/api'
 require 'dino/tx_rx'
 require 'dino/board'
 require 'dino/components'
diff --git a/lib/dino/api.rb b/lib/dino/api.rb
new file mode 100644
index 00000000..61fac8ff
--- /dev/null
+++ b/lib/dino/api.rb
@@ -0,0 +1,13 @@
+module Dino
+  module API
+    require 'dino/api/helper'
+    require 'dino/api/core'
+    require 'dino/api/dht'
+    require 'dino/api/infrared'
+    require 'dino/api/one_wire'
+    require 'dino/api/servo'
+    require 'dino/api/shift_io'
+    require 'dino/api/spi'
+    require 'dino/api/tone'
+  end
+end
diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
new file mode 100644
index 00000000..8ef13a32
--- /dev/null
+++ b/lib/dino/api/core.rb
@@ -0,0 +1,76 @@
+module Dino
+  module API
+    module Core
+      include Helper
+
+      DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
+
+      # CMD = 0
+      def set_pin_mode(pin, mode)
+        pin, value = convert_pin(pin), mode == :out ? 0 : 1
+        write Dino::Message.encode command: 0,
+                                   pin: convert_pin(pin),
+                                   value: value
+      end
+
+      # CMD = 1
+      def digital_write(pin,value)
+        write Message.encode command: 1, pin: convert_pin(pin), value: value
+      end
+
+      # CMD = 2
+      def digital_read(pin)
+        write Message.encode command: 2, pin: convert_pin(pin)
+      end
+
+      # CMD = 3
+      def analog_write(pin,value)
+        write Message.encode command: 3, pin: convert_pin(pin), value: value
+      end
+
+      # CMD = 4
+      def analog_read(pin)
+        write Message.encode command: 4, pin: convert_pin(pin)
+      end
+
+      def set_pullup(pin, pullup)
+        pin = convert_pin(pin)
+        pullup ? digital_write(pin, @high) : digital_write(pin, @low)
+      end
+
+      # CMD = 7
+      def set_listener(pin, state=:off, options={})
+        mode    = options[:mode]    || :digital
+        divider = options[:divider] || 8
+
+        unless [:digital, :analog].include? mode
+          raise "Mode must be either digital or analog"
+        end
+        unless DIVIDERS.include? divider
+          raise "Listener divider must be in #{DIVIDERS.inspect}"
+        end
+
+        # Create a bit mask for the settings we want to use. Gets sent in value.
+        mask = 0
+        mask |= 0b10000000 if (state == :on)
+        mask |= 0b01000000 if (mode == :analog)
+        mask |= Math.log2(divider).to_i
+
+        write Message.encode(command: 7, pin: convert_pin(pin), value: mask)
+      end
+
+      # Convenience methods by wrapping set_listener with old defaults.
+      def digital_listen(pin, divider=4)
+        set_listener(pin, :on, mode: :digital, divider: divider)
+      end
+
+      def analog_listen(pin, divider=16)
+        set_listener(pin, :on, mode: :analog, divider: divider)
+      end
+
+      def stop_listener(pin)
+        set_listener(pin, :off)
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/dht.rb b/lib/dino/api/dht.rb
new file mode 100644
index 00000000..413db961
--- /dev/null
+++ b/lib/dino/api/dht.rb
@@ -0,0 +1,12 @@
+module Dino
+  module API
+    module DHT
+      include Helper
+
+      # CMD = 13
+      def dht_read(pin)
+        write Message.encode command: 13, pin: convert_pin(pin)
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/helper.rb b/lib/dino/api/helper.rb
new file mode 100644
index 00000000..982d66c7
--- /dev/null
+++ b/lib/dino/api/helper.rb
@@ -0,0 +1,51 @@
+module Dino
+  module API
+    module Helper
+      #
+      # Microcontrollers have different aux message limits based on available RAM.
+      # Board should set @aux_limit from handshake. Default to safe minimum.
+      #
+      def aux_limit
+        @aux_limit || 527 # Should default to 39, but this isn't in handshake yet.
+      end
+
+      def write(message)
+        raise NotImplementedError
+          .new("#{self.class.name}#write not defined in Board subclass")
+      end
+
+      def pack(type, data, options={})
+        # Always pack as little endian.
+        template =  case type
+                    when :uint64  then 'Q<*'
+                    when :uint32  then 'L<*'
+                    when :uint16  then 'S<*'
+                    when :uint8   then 'C*'
+                    else raise ArgumentError "unsupported pack format '#{type}'"
+                    end
+
+        # Can pass a single integer to get packed if we always [] then flatten.
+        str = [data].flatten.pack(template)
+
+        # Pad right with null bytes if asked.
+        if options[:pad] && options[:pad] > str.length
+          (options[:pad] - str.length).times do
+            str = str + "\x00"
+          end
+        end
+
+        # Minimum 1 whether or not :min is given as an option.
+        if str.length < (options[:min] || 1)
+          raise ArgumentError, "too few bytes given (expected at least #{options[:min]})"
+        end
+
+        # Max should probably always be set to avoid overruning aux message RAM.
+        if options[:max] && str.length > options[:max]
+          raise ArgumentError, "too many bytes given (expected at most #{options[:max]})"
+        end
+
+        str
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/infrared.rb b/lib/dino/api/infrared.rb
new file mode 100644
index 00000000..bdaa0ff5
--- /dev/null
+++ b/lib/dino/api/infrared.rb
@@ -0,0 +1,19 @@
+module Dino
+  module API
+    module Infrared
+      include Helper
+
+      def infrared_send(pin, frequency, pulses)
+        # Need to start using length - 1, but doesn't work on board yet.
+        # 0 = 1 pulse, 255 = 256 pulses.
+        length = pack :uint8,  pulses.length,  max: 1
+        bytes  = pack :uint16, pulses, min: 1, max: 512
+
+        write Message.encode command: 16,
+                             pin: convert_pin(pin),
+                             value: frequency,
+                             aux_message: length + bytes
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/one_wire.rb b/lib/dino/api/one_wire.rb
new file mode 100644
index 00000000..4b253534
--- /dev/null
+++ b/lib/dino/api/one_wire.rb
@@ -0,0 +1,38 @@
+module Dino
+  module API
+    module OneWire
+      include Helper
+
+      def one_wire_reset(pin, value=0)
+        write Message.encode command: 41,
+                             pin: convert_pin(pin),
+                             value: value
+      end
+
+      def one_wire_search(pin, branch_mask)
+        write Message.encode command: 42,
+                             pin: convert_pin(pin),
+                             aux_message: pack(:uint64, branch_mask, max: 8)
+      end
+
+      def one_wire_write(pin, parasite_power, *data)
+        bytes  = pack :uint8, data, min: 1, max: 127 # Should be 128 with 0 = 1.
+
+        # Set high bit of length if the bus must drive high after write.
+        length = bytes.length
+        length = length | 0b10000000 if parasite_power
+
+        write Message.encode command: 43,
+                             pin: convert_pin(pin),
+                             value: length,
+                             aux_message: bytes
+      end
+
+      def one_wire_read(pin, num_bytes)
+        write Message.encode command: 44,
+                             pin: convert_pin(pin),
+                             value: num_bytes
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/servo.rb b/lib/dino/api/servo.rb
new file mode 100644
index 00000000..baae5b0e
--- /dev/null
+++ b/lib/dino/api/servo.rb
@@ -0,0 +1,19 @@
+module Dino
+  module API
+    module Servo
+      include Helper
+
+      def servo_toggle(pin, value=:off)
+        write Message.encode command: 8,
+                             pin: convert_pin(pin),
+                             value: (value == :off) ? 0 : 1
+      end
+
+      def servo_write(pin, value=0)
+        write Message.encode command: 9,
+                             pin: convert_pin(pin),
+                             value: value
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/shift_io.rb b/lib/dino/api/shift_io.rb
new file mode 100644
index 00000000..f1f2b3de
--- /dev/null
+++ b/lib/dino/api/shift_io.rb
@@ -0,0 +1,45 @@
+module Dino
+  module API
+    module ShiftIO
+      include Helper
+
+      def shift_settings(data, clock, preclock_high=false)
+        preclock_high = preclock_high ? 1 : 0
+        pack :uint8, [convert_pin(data), convert_pin(clock), preclock_high]
+      end
+
+      def shift_write(latch, data, clock, byte_array, options={})
+        settings = shift_settings(data, clock)
+        limit = aux_limit - settings.length
+        bytes = pack :uint8,
+                     byte_array,
+                     max: (limit < 256) ? limit : 256
+
+        write Message.encode command: 21,
+                             pin: convert_pin(latch),
+                             value: bytes.length, # Should be length-1 so 0 = 1 byte, 255 = 256 bytes
+                             aux_message: settings + bytes
+      end
+
+      def shift_read(latch, data, clock, num_bytes, options={})
+        settings = shift_settings(data, clock, options[:preclock_high])
+        write Message.encode command: 22,
+                             pin: convert_pin(latch),
+                             value: num_bytes, # Should be num-1 so 0 = 1 byte, 255 = 256 bytes
+                             aux_message: settings
+      end
+
+      def shift_listen(latch, data, clock, num_bytes, options={})
+        settings = shift_settings(data, clock, options[:preclock_high])
+        write Message.encode command: 23,
+                             pin: convert_pin(latch),
+                             value: num_bytes, # Should be num-1 so 0 = 1 byte, 255 = 256 bytes
+                             aux_message: settings
+      end
+
+      def shift_stop(latch)
+        write Message.encode command: 24, pin: convert_pin(latch)
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/spi.rb b/lib/dino/api/spi.rb
new file mode 100644
index 00000000..7aadeecb
--- /dev/null
+++ b/lib/dino/api/spi.rb
@@ -0,0 +1,39 @@
+module Dino
+  module API
+    module SPI
+      include Helper
+
+      def spi_settings(mode, frequency)
+        pack(:uint8, [0, mode]) + pack(:uint32, [frequency])
+      end
+
+      # Listener can store up to 8 bytes to get written each time, read up to 256.
+      def spi_write(pin, mode, frequency, bytes)
+        settings = spi_settings(mode, frequency)
+        bytes = pack(:uint8, bytes)
+        write Message.encode command: 26,
+                             pin: pin,
+                             value: bytes.length,
+                             aux_message: settings + bytes
+      end
+
+      def spi_read(pin, mode, frequency, num_bytes)
+        write Message.encode command: 27,
+                             pin: pin,
+                             value: num_bytes,
+                             aux_message: spi_settings(mode, frequency)
+      end
+
+      def spi_listen(pin, mode, frequency, num_bytes)
+        write Message.encode command: 28,
+                             pin: pin,
+                             value: num_bytes,
+                             aux_message: spi_settings(mode, frequency)
+      end
+
+      def spi_stop(pin)
+        write Message.encode command: 29, pin: pin
+      end
+    end
+  end
+end
diff --git a/lib/dino/api/tone.rb b/lib/dino/api/tone.rb
new file mode 100644
index 00000000..4b59bd42
--- /dev/null
+++ b/lib/dino/api/tone.rb
@@ -0,0 +1,18 @@
+module Dino
+  module API
+    module Tone
+      include Helper
+
+      def tone(pin, value, duration)
+        write Dino::Message.encode command: 17,
+                                   pin: convert_pin(pin),
+                                   value: value,
+                                   aux_message: duration
+      end
+
+      def no_tone(pin)
+        write Message.encode command: 18, pin: convert_pin(pin)
+      end
+    end
+  end
+end
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index 1bb583cd..d07deaec 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -1,7 +1,14 @@
 module Dino
   class Board
+    include API::Core
+    include API::Servo
+    include API::ShiftIO
+    include API::SPI
+    include API::Infrared
+    include API::OneWire
+    include API::Tone
+
     attr_reader :high, :low, :analog_high, :components, :analog_zero, :dac_zero
-    DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
     def initialize(io, options={})
       @io, @components = io, []
@@ -37,82 +44,6 @@ def remove_component(component)
       @components.delete(component)
     end
 
-    def set_pin_mode(pin, mode)
-      pin, value = convert_pin(pin), mode == :out ? 0 : 1
-      write Dino::Message.encode(command: 0, pin: pin, value: value)
-    end
-
-    def set_pullup(pin, pullup)
-      pin = convert_pin(pin)
-      pullup ? digital_write(pin, @high) : digital_write(pin, @low)
-    end
-
-    PIN_COMMANDS = {
-      # set_pin_mode:  '0'
-      digital_write:   '1',
-      digital_read:    '2',
-      analog_write:    '3',
-      analog_read:     '4',
-      # unused:        '5',
-      # unused:        '6',
-      set_listener:    '7',
-      servo_toggle:    '8',
-      servo_write:     '9',
-      # LCD            '10'
-      # Unused         '11'
-      # SoftSerial     '12'
-      dht_read:        '13',
-      # HCSR04         '14'
-      ds18b20_read:    '15',
-      # IR send:       '16'
-      tone:            '17',
-      no_tone:         '18',
-    }
-
-    PIN_COMMANDS.each_key do |command|
-      define_method(command) do |pin, value=nil|
-        write Dino::Message.encode(command: PIN_COMMANDS[command], pin: convert_pin(pin), value: value)
-      end
-    end
-
-    # Redefinition tone to accept duration.
-    def tone(pin, value, duration)
-      write Dino::Message.encode(command: PIN_COMMANDS[:tone], pin: convert_pin(pin), value: value, aux_message: duration)
-    end
-
-    def set_listener(pin, state=:off, options={})
-      mode    = options[:mode]    || :digital
-      divider = options[:divider] || 8
-
-      unless [:digital, :analog].include? mode
-        raise "Mode must be either digital or analog"
-      end
-      unless DIVIDERS.include? divider
-        raise "Listener divider must be in #{DIVIDERS.inspect}"
-      end
-
-      # Create a bit mask for the settings we want to use. Gets sent in value.
-      mask = 0
-      mask |= 0b10000000 if (state == :on)
-      mask |= 0b01000000 if (mode == :analog)
-      mask |= Math.log2(divider).to_i
-
-      write Dino::Message.encode(command: PIN_COMMANDS[:set_listener], pin: convert_pin(pin), value: mask)
-    end
-
-    # Implement the simpler methods by wrapping set_listener with old defaults.
-    def digital_listen(pin, divider=4)
-      set_listener(pin, :on, mode: :digital, divider: divider)
-    end
-
-    def analog_listen(pin, divider=16)
-      set_listener(pin, :on, mode: :analog, divider: divider)
-    end
-
-    def stop_listener(pin)
-      set_listener(pin, :off)
-    end
-
     DIGITAL_REGEX = /\A\d+\z/i
     ANALOG_REGEX = /\A(a)\d+\z/i
     DAC_REGEX = /\A(dac)\d+\z/i
diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
index 72a22d2d..c804d12b 100644
--- a/lib/dino/components/dht.rb
+++ b/lib/dino/components/dht.rb
@@ -6,7 +6,7 @@ class DHT
       include Mixins::Poller
 
       def after_initialize(options={})
-        super(options) if defined?(super)
+        super(options)
         @state = {temperature: nil, humidity: nil}
       end
 
@@ -14,12 +14,10 @@ def _read
         board.dht_read(self.pin)
       end
 
-      # Process raw data from the board before running Callbacks#update.
-      # super will write to @state after running callbacks.
-      def update(data)
+      # Process raw data from the board before running #update.
+      def pre_callback_filter(data)
         t, h = data.split(",")
-        reading = { temperature: t.to_f, humidity: h.to_f }
-        super(reading)
+        { temperature: t.to_f, humidity: h.to_f }
       end
     end
   end
diff --git a/lib/dino/components/ir_emitter.rb b/lib/dino/components/ir_emitter.rb
index 930b8823..39e57aa3 100644
--- a/lib/dino/components/ir_emitter.rb
+++ b/lib/dino/components/ir_emitter.rb
@@ -2,40 +2,20 @@ module Dino
   module Components
     class IREmitter < Basic::DigitalOutput
       def send(pulses=[], options={})
-        raise Exception.new('infrared signals are limited to a total of 255 pulses (marks + ticks)') if pulses.length > 255
-        pulses.each do |p|
-          raise Exception.new('invalid infrared signal, please ensure all microsecond durations are integers') unless p.is_a? Integer
-          raise Exception.new('pulse lengths are limited to 65536 microseconds') if p > 65536
+        if pulses.length > 256 || pulses.length < 1
+          raise ArgumentError, 'wrong number of IR pulses (expected 1 to 256)'
         end
 
-        # Default to 38kHz
-        frequency = options[:frequency] || 38
+        pulses.each_with_index do |pulse, index|
+          raise ArgumentError, 'non Numeric data in IR signal' unless pulse.is_a? Numeric
+          pulses[index] = pulse.round unless pulse.is_a? Integer
+          raise ArgumentError 'pulse too long (max 65536 microsec)' if pulse > 65536
+        end
 
-        message = Dino::Message.encode(
-          command: 16,
-          # Setting the IR emitter pin is currently unsupported.
-          # Although the value gets passed through, it always uses the default pin
-          # for your specfic board/chip, as defined by the library (in bold) at:
-          # https://github.com/z3t0/Arduino-IRremote#hardware-specifications
-          pin: pin,
-          value: frequency,
-          aux_message: pack(pulses)
-        )
-        board.write(message)
-      end
+        # Default to 38kHz.
+        frequency = options[:frequency] || 38
 
-      # Pack pulse lengths (in microseconds) into a string (byte array really) such that:
-      # 1) Each pulse length is converted to a little-endian unsigned 16-bit integer.
-      # 2) Each pulse occupies 2 consecutive bytes of the byte array.
-      # 3) The first pulse is at index 1 of the array, and subsequent pulses
-      #    start on consecutive odd-numbered indices.
-      # 4) The 0th byte of the array contains the total number of pulses (NOT bytes).
-      #
-      # This keeps compatbility with the aux format normally used for sending data as
-      # ASCII, but sends higher density binary data whch the IR library needs.
-      #
-      def pack(pulses=[])
-        "#{[pulses.count].pack('C')}#{pulses.pack('v*')}"
+        board.infrared_send(pin, frequency, pulses)
       end
     end
   end
diff --git a/lib/dino/components/mixins/board_proxy.rb b/lib/dino/components/mixins/board_proxy.rb
index a256b3be..5b79590d 100644
--- a/lib/dino/components/mixins/board_proxy.rb
+++ b/lib/dino/components/mixins/board_proxy.rb
@@ -5,7 +5,7 @@ module BoardProxy
         include Bus
 
         def after_initialize(options={})
-          super(options) if defined?(super)
+          super(options)
           @high = 1
           @low = 0
         end
diff --git a/lib/dino/components/mixins/bus.rb b/lib/dino/components/mixins/bus.rb
index b1c80974..d44c16df 100644
--- a/lib/dino/components/mixins/bus.rb
+++ b/lib/dino/components/mixins/bus.rb
@@ -8,7 +8,7 @@ module Bus
         # See OneWire::Bus class for an example.
         #
         def after_initialize(options={})
-          super(options) if defined?(super)
+          super(options)
           @components = []
         end
 
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 1f9757e3..1893bb93 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -3,7 +3,7 @@ module Components
     module Mixins
       module Callbacks
         def after_initialize(options={})
-          super(options) if defined?(super)
+          super(options)
           @callbacks = {}
           @callback_mutex = Mutex.new
         end
diff --git a/lib/dino/components/one_wire.rb b/lib/dino/components/one_wire.rb
index 3929599c..823ef49a 100644
--- a/lib/dino/components/one_wire.rb
+++ b/lib/dino/components/one_wire.rb
@@ -4,6 +4,8 @@ module OneWire
       require 'dino/components/one_wire/constants'
       require 'dino/components/one_wire/helper'
       require 'dino/components/one_wire/bus'
+      require 'dino/components/one_wire/bus_enumerator'
+      require 'dino/components/one_wire/slave'
       require 'dino/components/one_wire/ds18b20'
     end
   end
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index eac27e41..89f956e6 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -9,112 +9,49 @@ class Bus
         attr_reader :found_devices, :parasite_power, :mutex
 
         def after_initialize(options = {})
-          super(options) if defined?(super)
+          super(options)
           @mutex = Mutex.new
           @found_devices = []
           read_power_supply
-          search
-        end
-
-        def search
-          branch_mask = 0
-          high_discrepancy = 0
-
-          loop do
-            self.add_callback(:read) do |result|
-              #
-              # We get a device hash (class and ROM address) as a parsed result,
-              # plus the bit index of the highest discrepancy from the last run.
-              #
-              device, high_discrepancy = Helper.parse_search_result(result)
-              @found_devices << device
-            end
-            _search(branch_mask)
-            block_until_read
-
-            #
-            # Since we're zero-indexed unlike the datasheet, this is when the
-            # search ends. There's no discrepancy left even at the lowest bit.
-            #
-            break if high_discrepancy == - 1
-
-            #
-            # If high_discrepancy was not a forced 1 last time, do it next time.
-            # This way we go as deep as possible into each new branch first.
-            #
-            if branch_mask[high_discrepancy] == 0
-              branch_mask = branch_mask | (2 ** high_discrepancy)
-            end
-
-            #
-            # Clear bits above high_discrepancy so we don't repeat branches.
-            # When high_discrepancy < MSB of branch_mask, this moves us
-            # one node closer to the root and finishing the search.
-            #
-            unset_mask = 0xFFFFFFFFFFFFFFFF >> (63 - high_discrepancy)
-            branch_mask = branch_mask & unset_mask
-          end
-
-          # Just to be safe...
-          @found_devices = @found_devices.uniq
-        end
-
-        #
-        # Reset the bus, then send the search command, along with a 64-bit
-        # mask of bits to write 1 to force the search into a specific branch.
-        #
-        def _search(branch_mask)
-          reset
-          write(SEARCH_ROM)
-          board.write Dino::Message.encode command: 42,
-                                           pin: pin,
-                                           aux_message: [branch_mask].pack('<Q')
         end
 
-        #
-        # Drive low, then send READ_POWER_SUPPLY instruction, and read 1 byte.
-        # Any device using parasite power will pull the lowest bit to 0.
+        # Without driving low first, results are inconsistent.
+        # Only the first (LS) bit matters, but it's easier to read a whole byte.
         #
         def read_power_supply
-          # Inconsistent readings without this.
-          self.mode = :out
+          board.set_pin_mode(self.pin, :out)
           board.digital_write(self.pin, board.low)
           sleep 0.1
 
           reset
           write(SKIP_ROM, READ_POWER_SUPPLY)
           byte = read(1)
+
           @parasite_power = (byte.to_i[0] == 0) ? true : false
         end
 
         def reset
-          board.write Dino::Message.encode(command: 41, pin: pin)
-        end
-
-        def _read(num_bytes)
-          board.write Dino::Message.encode(command: 44, pin: pin, value: num_bytes)
+          board.one_wire_reset(pin)
         end
 
-        def write(*bytes)
-          bytes = bytes.flatten
-          if bytes.empty?
-            raise ArgumentError, "0 bytes given (expected at least 1)"
+        def device_present
+          present = false
+          self.add_callback(:read) do |result|
+            present = (result.to_i == 0) ? true : false
           end
 
-          length = bytes.length
-          if length > 127
-            raise ArgumentError, 'too many bytes given (expected at most 127)'
-          end
+          board.one_wire_reset(pin, 1)
+          block_until_read
+          present
+        end
 
-          # Set flag in high bit of length if last command needs parasite power.
-          if parasite_power && [CONVERT_T, COPY_SCRATCH].include?(bytes.last)
-            length = length | 0b10000000
-          end
+        def _read(num_bytes)
+          board.one_wire_read(pin, num_bytes)
+        end
 
-          board.write Dino::Message.encode command: 43,
-                                           pin: pin,
-                                           value: length,
-                                           aux_message: bytes.pack('C*')
+        def write(*bytes)
+          pp = parasite_power && [CONVERT_T, COPY_SCRATCH].include?(bytes.last)
+          board.one_wire_write(pin, pp, bytes)
         end
       end
     end
diff --git a/lib/dino/components/one_wire/bus_enumerator.rb b/lib/dino/components/one_wire/bus_enumerator.rb
new file mode 100644
index 00000000..fba17e5e
--- /dev/null
+++ b/lib/dino/components/one_wire/bus_enumerator.rb
@@ -0,0 +1,106 @@
+module Dino
+  module Components
+    module OneWire
+      class Bus
+        # 1 bits in mask set discrepancies to 1. 0 leaves bit as read from bus.
+        def _search(branch_mask)
+          reset
+          write(SEARCH_ROM)
+          board.one_wire_search(pin, branch_mask)
+        end
+
+        def search
+          @found_devices = []
+          branch_mask = 0
+          high_discrepancy = 0
+
+          loop do
+            self.add_callback(:read) do |result|
+              device, high_discrepancy = parse_search_result(result)
+              @found_devices << device
+            end
+
+            _search(branch_mask)
+            block_until_read
+
+            # No untested discrepancies left. End the search.
+            break if high_discrepancy == - 1
+
+            # If high_discrepancy was not forced 1 last iteration, do it next.
+            # i.e. Go as deep as possible into each branch found then back out.
+            #
+            if branch_mask[high_discrepancy] == 0
+              branch_mask = branch_mask | (2 ** high_discrepancy)
+            end
+
+            # Clear bits above high_discrepancy so we don't repeat branches.
+            # When high_discrepancy < MSB of branch_mask, this moves us
+            # one node out, closer to the root, and finishing the search.
+            #
+            unset_mask = 0xFFFFFFFFFFFFFFFF >> (63 - high_discrepancy)
+            branch_mask = branch_mask & unset_mask
+          end
+        end
+
+        def parse_search_result(result)
+          address, complement = split_search_result(result)
+
+          raise "CRC error during OneWire search" unless Helper.crc_check(address)
+
+          if (address & complement) > 0
+            raise "OneWire device not connected or disconnected during search"
+          end
+
+          #
+          # XOR address with complement to give a 0 at each discrepancy.
+          # XOR again with 64 1s to flip, so each discrepancy is a 1 instead.
+          #
+          new_discrepancies = (address ^ complement) ^ 0xFFFFFFFFFFFFFFFF
+
+          #
+          # Note: Discrepancies forced to 1 in an iteration will not show up as
+          # discrepancies when parsing the result from that iteration. The board
+          # will have read 0-0 from the bus, but we told it to override the
+          # address bit to a 1, so we get back (1-0), as if no discrepancy.
+          #
+          # This is OK. We only want the highest discrepancy we did not set to 1.
+          #
+          high_discrepancy = new_discrepancies.bit_length - 1
+
+          # LSByte of address is product family. Check for existing class.
+          klass = family_lookup(address & 0x00000000000000FF)
+
+          [{class: klass, address: address}, high_discrepancy]
+        end
+
+        # Search result is a comma separated list of 8 byte-pairs. Each pair is
+        # formatted "addressByte-compByte". Pairs are ordered LS byte first.
+        #
+        def split_search_result(str)
+          byte_pairs = str.split(",")
+          address = 0
+          complement = 0
+
+          byte_pairs.reverse.each do |pair|
+            address_byte, complement_byte = pair.split("-").map(&:to_i)
+            address = (address << 8) | address_byte
+            complement = (complement << 8) | complement_byte
+          end
+
+          [address, complement]
+        end
+
+        # Set FAMILY_CODE in slave class to get it identified during search.
+        def family_lookup(family_code)
+          OneWire.constants.each do |const|
+            obj = OneWire.const_get(const)
+            if (obj.is_a? Class) && (obj.const_defined? "FAMILY_CODE")
+              return obj if obj::FAMILY_CODE == family_code
+            end
+          end
+          return nil
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index 10009819..8c285d73 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -1,112 +1,94 @@
 module Dino
   module Components
     module OneWire
-      class DS18B20
-        include Setup::Base
+      class DS18B20 < Slave
         include Mixins::Poller
-
         FAMILY_CODE = 0x28
 
-        attr_reader :resolution, :address
-        alias  :bus :board
-
-        def after_initialize(options={})
-          super(options) if defined?(super)
-          # Should set only if given as parameter.
-          # If not, read from sensor and leave as is.
-          self.resolution = 12
-
-          raise "missing ROM address for 1-Wire device, try searching first" unless options[:address]
-          @address = options[:address]
-        end
-
+        # Scratch read specifically for the resolution if not set yet.
         def resolution
-          # Read scratchpad and resolution from sensor here.
-        end
-
-        def serial
-          Helper.address_to_serial(self.address)
+          @resolution ||= decode_resolution read_scratch(9)
         end
 
         def resolution=(bits)
-          raise 'Invalid resolution for DS18B20 sensor' if (bits > 12 || bits < 9)
+          raise ArgumentError 'Invalid DS18B20 resolution' if (bits > 12 || bits < 9)
+
           @resolution = bits
-          # Send commands to set resolution here.
-          @convert_time = 0.75 / (13 - bits)
+          scratch = read_scratch(9).split(",").map(&:to_i)
+
+          unless decode_resolution(scratch) == @resolution
+            settings = scratch[2..4]
+            offset = @resolution - 9
+            settings[2] = 0b00011111 | (offset << 5)
+            write_scratch(settings)
+            copy_scratch
+          end
+
+          set_convert_time
         end
 
-        #
-        # If we're the only device on the bus, save time by skipping ROM match.
-        #
-        def identify
-          bus.reset
-          if bus.found_devices == 1
-            bus.write(SKIP_ROM)
-          else
-            bus.write(MATCH_ROM)
-            bus.write(Helper.address_to_bytes(self.address))
-          end
+        def set_convert_time
+          @convert_time = 0.75 / (2 ** (12 - @resolution))
         end
 
         def convert
-          bus.mutex.synchronize do
-            identify
+          @convert_time ||= 0.75
+          atomically do
+            match
             bus.write(CONVERT_T)
             sleep @convert_time if bus.parasite_power
           end
           sleep @convert_time unless bus.parasite_power
         end
 
-        def read_scratch
-          data = nil
-          bus.mutex.synchronize do
-            identify
-            bus.write(READ_SCRATCH)
-            data = bus.read(9)
-          end
-          data
-        end
-
         def _read
           convert
-          reading = read_scratch
           # This runs callbacks in our thread instead of the callback thread...
-          self.update(reading)
+          self.update(read_scratch(9))
         end
 
-        #
-        # Data comes in as 9 comma delimited bytes in ASCII numbers.
-        # First 2 bytes are a coded little-endian number containing degrees C.
-        # Check CRC first. If good, decode and pass on degrees C, F and raw data.
-        #
         def pre_callback_filter(data)
+          # Data is 9 comma delimited numbers in ASCII, representing bytes.
           bytes = data.split(",").map{|b| b.to_i}
           return {crc_error: true} unless Helper.crc_check(bytes)
 
-          decode(bytes[1], bytes[0]).merge(raw: bytes)
+          # Update resolution and conversion time each read.
+          @resolution = decode_resolution(bytes)
+          set_convert_time
+
+          decode_temp(bytes).merge(raw: bytes)
         end
 
         #
         # Temperature is the first 16 bits (2 bytes of 9 read), little-endian.
-        # It's a sign-extended two's complement 11-bit decimal, where LSB is the
-        # 2^-4 exponent, up through 2^6 for bit 11. The 5 MSBs repeat the sign.
+        # It's a sign-extended two's complement 12-bit decimal, where LSB is the
+        # 2^-4 exponent, up through 2^6 for next 10 bits. 5 MSBs repeat the sign.
         #
-        def decode(high_byte, low_byte)
-          # Concatenate to 16-bit and reverse two's complement if necessary.
-          value = high_byte << 8 | low_byte
+        def decode_temp(bytes)
+          # Get magnitude without sign.
+          value = bytes[1] << 8 | bytes[0]
           negative = (value[15] == 1)
           value = (value ^ 0xFFFF) + 1 if negative
 
-          # Expand the exponents, restore sign, and convert to Farenheit.
-          celsius = 0.0; exp = -4
+          celsius = 0.0
+          exp = -4
           for bit in (0..10)
-            celsius = celsius + (2.0 ** (exp+bit)) if (value[bit] == 1)
+            if (value[bit] == 1)
+              celsius = celsius + (2.0 ** (exp+bit))
+            end
           end
+
           celsius = -celsius if negative
           farenheit = (celsius * 1.8 + 32).round(4)
 
           {celsius: celsius, farenheit: farenheit}
         end
+
+        def decode_resolution(bytes)
+          config_byte = bytes[4]
+          offset = config_byte >> 5
+          offset + 9
+        end
       end
     end
   end
diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
index 6f2b4c42..8f1aa32a 100644
--- a/lib/dino/components/one_wire/helper.rb
+++ b/lib/dino/components/one_wire/helper.rb
@@ -2,32 +2,15 @@ module Dino
   module Components
     module OneWire
       class Helper
+
         #
         # Convert 64-bit Integer ROM address to array of 8 LSByte first bytes.
         #
         def self.address_to_bytes(address)
-          [address].pack('<Q').split("").map(&:ord)
+          [address].pack('Q<').split("").map(&:ord)
         end
 
-        #
-        # Remove the MSByte (CRC) and LSByte (family code) from a ROM address
-        # to get the device's 48-bit serial number and convert to hex.
-        #
-        def self.address_to_serial(address)
-          address = address & 0x00FFFFFFFFFFFFFF
-          address = address >> 8
-          address.to_s(16)
-        end
 
-        #
-        # CRC is the last byte of any message. Start with it set to 0. Move through
-        # the n-1 data bytes LSBYTE FIRST, but bitwise LSBFIRST. For each bit:
-        #    1) XOR the bit with the current LSB of CRC
-        #    2) XOR the result of #1 with the bits at indices 3 and 4 of CRC.
-        #    3) Bitshift the CRC right by 1
-        #    4) Write the result of #1 to the now empty MSB of the CRC
-        # After 64 bits, the CRC is valid if it matches the 9th of the read data.
-        #
         def self.crc_check(data)
           #
           # Sensor data will usually be an array of bytes, but for checking
@@ -50,80 +33,6 @@ def self.crc_check(data)
           end
           crc == bytes.last
         end
-
-        #
-        # This separates a search result, checks result for device disconnection,
-        # matches the family byte of the address to a Component class if one exists,
-        # and looks for the highest index discrepancy to continue the search.
-        #
-        def self.parse_search_result(str)
-          address, complement = self.split_search_result(str)
-
-          #
-          # If any address-complement bit-pair is 1-1, either no device is
-          # present on the bus, or a device was disconnected during the search.
-          #
-          if (address & complement) > 0
-            raise "OneWire device not connected or disconnected during search"
-          end
-
-          #
-          # LS byte of the address holds the family code.
-          # Lookup against implemented classes. Nil if no match.
-          #
-          klass = self.family_lookup(address & 0x00000000000000FF)
-
-          #
-          # XOR-ing address with complement gives a 0 bit at each discrepancy.
-          # XOR again with 64 1s to flip to 1s. Ruby truncates leading 0 bits,
-          # so MSB is the highest discrepancy. Result is -1 for no discrepancy.
-          #
-          # Note: The board only sends back discrepancies which we did not
-          # set to 1 on the last search! This does not track all known
-          # discrepancies in the address space, but gives us what we need:
-          # The highest discrepancy that we didn't write a 1 for last time.
-          #
-          new_discrepancies = (address ^ complement) ^ 0xFFFFFFFFFFFFFFFF
-          high_discrepancy = new_discrepancies.bit_length - 1
-
-          [{class: klass, address: address}, high_discrepancy]
-        end
-
-        #
-        # A search result is a comma separated list of 8 byte-pairs.
-        # Each pair is an address byte, dash (-) separator, and complement byte.
-        # Pairs are ordered LS byte first. Reverse to MS for easier bitshift.
-        #
-        def self.split_search_result(str)
-          byte_pairs = str.split(",")
-          address = 0
-          complement = 0
-
-          byte_pairs.reverse.each do |pair|
-            address_byte, complement_byte = pair.split("-").map(&:to_i)
-            address = (address << 8) | address_byte
-            complement = (complement << 8) | complement_byte
-          end
-
-          if crc_check(address)
-            return [address, complement]
-          else
-            raise "CRC error for device address on OneWire bus"
-          end
-        end
-
-        #
-        # Define FAMILY_CODE in a slave class to get it identified during search.
-        #
-        def self.family_lookup(family_code)
-          OneWire.constants.each do |const|
-            obj = OneWire.const_get(const)
-            if (obj.is_a? Class) && (obj.const_defined? "FAMILY_CODE")
-              return obj if obj::FAMILY_CODE == family_code
-            end
-          end
-          return nil
-        end
       end
     end
   end
diff --git a/lib/dino/components/one_wire/slave.rb b/lib/dino/components/one_wire/slave.rb
new file mode 100644
index 00000000..1b0b1ab2
--- /dev/null
+++ b/lib/dino/components/one_wire/slave.rb
@@ -0,0 +1,76 @@
+module Dino
+  module Components
+    module OneWire
+      class Slave
+        include Setup::Base
+        attr_reader :address
+        alias  :bus :board
+
+        #
+        # Remove the MSByte (CRC) and LSByte (family code) from slave's ROM
+        # address to get a printable 48-bit serial number in hex.
+        #
+        def serial_number
+          address = @address & 0x00FFFFFFFFFFFFFF
+          address = address >> 8
+          address.to_s(16).rjust(12, "0")
+        end
+
+        def initialize(options={})
+          options[:board] ||= options[:bus]
+          super(options)
+        end
+
+        def after_initialize(options={})
+          super(options)
+          unless options[:address]
+            raise ArgumentError, 'missing 1-Wire slave ROM address; try searching first'
+          end
+          @address = options[:address]
+        end
+
+        def read_scratch(num_bytes)
+          atomically do
+            match
+            bus.write(READ_SCRATCH)
+            bus.read(num_bytes)
+          end
+        end
+
+        def write_scratch(bytes)
+          atomically do
+            match
+            bus.write(WRITE_SCRATCH)
+            bus.write(bytes)
+          end
+        end
+
+        def copy_scratch
+          atomically do
+            match
+            bus.write(COPY_SCRATCH)
+            sleep 0.02
+            bus.reset if bus.parasite_power
+          end
+        end
+
+        def atomically(&block)
+          bus.mutex.synchronize do
+            block.call
+          end
+        end
+
+        def match
+          bus.reset
+          # Skip ROM match if only one device on the bus.
+          if bus.found_devices == 1
+            bus.write(SKIP_ROM)
+          else
+            bus.write(MATCH_ROM)
+            bus.write(Helper.address_to_bytes(self.address))
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/piezo.rb b/lib/dino/components/piezo.rb
index 4896646b..c1f558e2 100644
--- a/lib/dino/components/piezo.rb
+++ b/lib/dino/components/piezo.rb
@@ -12,11 +12,11 @@ def after_initialize(options={})
 
       # Duration is in mills
       def tone(value, duration = 500)
-        board.tone pin, value, duration
+        board.tone(pin, value, duration)
       end
 
       def no_tone
-        board.no_tone pin
+        board.no_tone(pin)
       end
     end
   end
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index a9344a63..226106ab 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -7,55 +7,51 @@ class ShiftIn
         # Model registers that use the arduino shift functions as multi-pin
         # components, specifying clock, data and latch pins.
         #
-        # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
+        # options = board: my_board,
+        #           pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
         include Setup::MultiPin
         proxy_pins  clock: Basic::DigitalOutput,
                     data:  Basic::DigitalInput,
                     latch: Register::Select
 
-        #
-        # Data will arrive on the latch pin, similar to an analog read.
-        # Bubble it up to the register object (self), then deal with it there.
-        #
         def after_initialize(options={})
-          super(options) if defined?(super)
+          super(options)
+          self.rising_clock = options[:rising_clock]
+          bubble_callbacks
+        end
 
-          #
-          # Certain registers which use rising edges for clock signals produce
-          # errors with the native Arduino shiftIn function unless you set the clock
-          # pin high before reading. Setting this instance var to 1 will include
-          # that instruction on every call to read or listen.
-          #
-          @preclock_high = options[:preclock_high] ? 1 : 0
+        #
+        # Some registers use rising edges for clock signals. Unless we pull clock
+        # pin high before each read, bits in the value will be out of position.
+        # Set this once and future calls to #read and #listen will do it.
+        #
+        attr_reader :rising_clock
 
-          bubble_callbacks
+        def rising_clock=(value)
+          @rising_clock = [0, nil, false].include?(value) ? false : true
         end
 
+        # Reads come through the latch pin. Bubble them up to ourselves.
         def bubble_callbacks
           proxies[:latch].add_callback do |byte|
             self.update(byte)
           end
         end
 
-        #
-        # Read using the native shiftIn function of the Arduino library.
-        #
-        def read
-          # Pack the extra parameters we need to send in the aux message then send.
-          aux = [data.pin, clock.pin, @preclock_high].pack('C*')
-          board.write Dino::Message.encode(command: 22, pin: latch.pin, value: @bytes, aux_message: aux)
+        def read(num_bytes=@bytes)
+          board.shift_read latch.pin, data.pin, clock.pin, num_bytes,
+                           preclock_high: rising_clock
         end
 
-        def listen
-          # Pack the extra parameters we need to send in the aux message then send.
-          aux = [data.pin, clock.pin, @preclock_high].pack('C*')
-          board.write Dino::Message.encode(command: 23, pin: latch.pin, value: @bytes, aux_message: aux)
+        # Untested
+        def listen(num_bytes=@bytes)
+          board.shift_listen latch.pin, data.pin, clock.pin, num_bytes,
+                             preclock_high: rising_clock
         end
 
         def stop
-          # Just need to send the latch pin to stop listening.
-          board.write Dino::Message.encode(command: 24, pin: latch.pin)
+          board.shift_stop(latch.pin)
         end
       end
     end
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index c8e2d005..b3de0fc4 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -7,24 +7,16 @@ class ShiftOut
         # Model registers that use the arduino shift functions as multi-pin
         # components, specifying clock, data and latch pins.
         #
-        # options = {board: my_board, pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
+        # options = board: my_board,
+        #           pins: {clock: clock_pin, latch: latch_pin, data: data_pin}
         #
         include Setup::MultiPin
         proxy_pins  clock: Basic::DigitalOutput,
                     data:  Basic::DigitalOutput,
                     latch: Register::Select
 
-
-        #
-        # Write using the native shiftOut function of the Arduino library.
-        #
         def write(*bytes)
-          aux = bytes.flatten
-          length = aux.count
-
-          # Prepend parameters we need to send in the aux message then pack and send.
-          aux = [data.pin, clock.pin, 0].concat(aux).pack('C*')
-          board.write Dino::Message.encode(command: 21, pin: latch.pin, value: length, aux_message: aux)
+          board.shift_write(latch.pin, data.pin, clock.pin, bytes)
         end
       end
     end
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 87d11099..fa4836e5 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -1,46 +1,37 @@
 module Dino
   module Components
     module Register
+      #
+      # Model SPI registers as single pin. Data comes back on the select pin,
+      # so just inherit from Select.
+      #
+      # options = {board: my_board, pin: slave_select_pin}
+      #
       class SPIIn < Select
         include Input
 
-        #
-        # Model SPI registers as single pin. Data comes back on the select pin,
-        # so just inherit from Select.
-        #
-        # options = {board: my_board, pin: slave_select_pin}
-        #
+        attr_reader :spi_mode, :frequency
+
         def after_initialize(options={})
           super(options) if defined?(super)
 
-          # Save SPI device settings in instance variables.
-          @spi_mode  = options[:spi_mode]  || 0
+          @spi_mode  = options[:spi_mode] || 0
 
           # No default value for clock frequency.
           raise 'SPI clock rate (Hz) required in :frequency option' unless options[:frequency]
           @frequency = options[:frequency]
         end
 
-        #
-        # Read using a call to the native SPI library.
-        #
         def read
-          # Pack the extra parameters we need to send in the aux message then send.
-          start_address = 0
-          aux = "#{[start_address, @spi_mode].pack('C*')}#{[@frequency].pack('V')}"
-          board.write Dino::Message.encode(command: 27, pin: pin, value: @bytes, aux_message: aux)
+          board.spi_read(pin, spi_mode, frequency, @bytes)
         end
 
         def listen
-          # Pack the extra parameters we need to send in the aux message then send.
-          start_address = 0
-          aux = "#{[start_address, @spi_mode].pack('C*')}#{[@frequency].pack('V')}"
-          board.write Dino::Message.encode(command: 28, pin: pin, value: @bytes, aux_message: aux)
+          board.spi_listen(pin, spi_mode, frequency, @bytes)
         end
 
         def stop
-          # Just need to send the select pin to stop listening.
-          board.write Dino::Message.encode(command: 29, pin: pin)
+          board.spi_stop(pin)
         end
       end
     end
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index 96645e9f..292776d0 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -1,17 +1,18 @@
 module Dino
   module Components
     module Register
+      #
+      # Model SPI registers as single pin. Data comes back on the select pin,
+      # so just inherit from Select.
+      #
+      # options = {board: my_board, pin: slave_select_pin}
+      #
       class SPIOut < Select
         include Output
-        #
-        # Model SPI registers as single pin. Data comes back on the select pin,
-        # so just inherit from Select.
-        #
-        # options = {board: my_board, pin: slave_select_pin}
-        #
+
+        attr_reader :spi_mode, :frequency
 
         def after_initialize(options={})
-          # Save SPI device settings in instance variables.
           @spi_mode  = options[:spi_mode] || 0
 
           # No default value for clock frequency.
@@ -21,16 +22,8 @@ def after_initialize(options={})
           super(options) if defined?(super)
         end
 
-        #
-        # Write using a call to the native SPI library.
-        #
         def write(*bytes)
-          # Pack the extra parameters we need to send in the aux message then send.
-          aux = bytes.flatten
-          length = aux.count
-          aux = "#{[@spi_mode].pack('C')}#{[@frequency].pack('V')}#{aux.pack('C*')}"
-
-          board.write Dino::Message.encode(command: 26, pin: pin, value: length, aux_message: aux)
+          board.spi_write(pin, spi_mode, frequency, bytes.flatten)
         end
       end
     end
diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index 45293166..09fc222e 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -11,7 +11,7 @@ class RotaryEncoder
       alias :position :state
 
       def after_initialize(options={})
-        super(options) if defined?(super)
+        super(options)
 
         # Default to listening every tick (1ms / 1kHz)
         divider = options[:divider] || 1
@@ -40,17 +40,16 @@ def start
       #
       # Return a hash with the new :position and pass through :change, overriding
       # the data param we took, which would have passed directly to callbacks.
-      # Callbacks can use either :position (degrees) or :change (steps).
+      # Callbacks can use either :position (in degrees) or :change (in steps).
       #
       def pre_callback_filter(data)
-        data = { change: data,
-                 position: (state + (data * degrees_per_step)) % 360 }
+        { change: data, position: (state + (data * degrees_per_step)) % 360 }
       end
       #
       # Callbacks run now, receiving only the value of #pre_callback_filter
       #
       # After callbacks, set @state to the position calculated earlier.
-      # This method also receives the value of #pre_callback_filter.
+      # This method also receives the result of #pre_callback_filter.
       #
       def update_self(data)
         @state = data[:position]
diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index f6902cf6..9e2a77f5 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -3,9 +3,9 @@ module Components
     class Servo
       include Setup::SinglePin
       include Mixins::Threaded
-      
+
       def after_initialize(options={})
-        board.servo_toggle(pin, 1)
+        board.servo_toggle(pin, :on)
       end
 
       def position=(value)
diff --git a/lib/dino/components/setup/base.rb b/lib/dino/components/setup/base.rb
index acf53c6b..053569f6 100644
--- a/lib/dino/components/setup/base.rb
+++ b/lib/dino/components/setup/base.rb
@@ -8,7 +8,6 @@ def initialize(options={})
           initialize_board(options)
           initialize_pins(options)
           register
-
           after_initialize(options)
         end
 
@@ -30,18 +29,14 @@ def unregister
         end
 
         #
-        # Setup::Base just requires a board and adds the component to the list of components.
-        # Mix in other modules from Setup or define this method in your class to initialize the pin(s).
+        # Setup::Base only requires a board. Mix in modules from Setup or define
+        # this method in your class to use pins.
         #
         def initialize_pins(options={}) ; end
         alias :initialize_pin :initialize_pins
 
-        #
-        # Define #after_initialize in your component class.
-        #
-        # @note This method should be implemented in the including class.
-        #
-        def after_initialize(options={}) ; end
+        # Override in components. Call super when inheriting or mixing in.
+        def after_initialize(options={}); end
       end
     end
   end
diff --git a/lib/dino/components/setup/input.rb b/lib/dino/components/setup/input.rb
index f2dfbfb6..1349f438 100644
--- a/lib/dino/components/setup/input.rb
+++ b/lib/dino/components/setup/input.rb
@@ -2,6 +2,7 @@ module Dino
   module Components
     module Setup
       module Input
+        include SinglePin
         attr_reader :pullup
 
         def pullup=(pullup)
diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
index cfd1aab0..9a0baa2d 100644
--- a/lib/dino/components/setup/multi_pin.rb
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -11,9 +11,7 @@ module MultiPin
         include Base
         attr_reader :pin, :pins, :pullups, :proxies
 
-        #
         # Return a hash with the state of each proxy component.
-        #
         def proxy_states
           hash = {}
           proxies.each_key do |key|
@@ -32,11 +30,10 @@ def self.included(base)
 
         module ClassMethods
           #
-          # Requiring a pin simply raises an error if not specified in options[:pins].
+          # Requiring a pin simply raises an error if missing from options[:pins].
           # It will not automatically set up a subcomponent or do anything else.
           # This is useful for calling Arduino-native libraries, where we need
           # to say what pins we are using, but don't need to do more in Ruby.
-          # See the LCD component for an example.
           #
           def require_pins(*args)
             required_pins = self.class_eval('@@required_pins') rescue []
@@ -49,17 +46,15 @@ def require_pins(*args)
           # Proxying a pin models it as a single-pin component and requires it.
           # It can be made optional by adding `optional: true` to the hash.
           #
-          # On initializing a multi-pin component, its proxy instances are
-          # created and stored in the @proxies variable. Call #proxies for access.
-          #
-          # Lastly, convenience methods for each proxy are defined on the singleton
-          # class of the multi-pin instance.
+          # When instancing a multi-pin component, its proxy instances are
+          # created and stored in @proxies, readable via `#proxies`.
           #
-          # For example, you can call `rgb_led.red` for the AnalogOutput
-          # instance that controls the red part of that RGB led.
+          # A convenience method for each proxy is defined on the singleton
+          # class of the multi-pin instance. For example, `rgb_led.red` returns
+          # the AnalogOutput instance for the red part of that specific RGB LED.
           #
-          # These method names correspond to the hash keys (pin names) defined in
-          # the class definition call to `proxy_pins`. See RgbLed class for examples.
+          # Method names match the hash keys (pin names) used when calling
+          # '::proxy_pins' in the class definition. See RgbLed class for examples.
           #
           def proxy_pins(options={})
             if options[:optional]
diff --git a/lib/dino/components/setup/output.rb b/lib/dino/components/setup/output.rb
index 4ef8bca3..aaba505d 100644
--- a/lib/dino/components/setup/output.rb
+++ b/lib/dino/components/setup/output.rb
@@ -2,6 +2,7 @@ module Dino
   module Components
     module Setup
       module Output
+        include SinglePin
         protected
 
         def initialize_pins(options={})
diff --git a/lib/dino/components/setup/single_pin.rb b/lib/dino/components/setup/single_pin.rb
index 6088b3e0..09e2f4ed 100644
--- a/lib/dino/components/setup/single_pin.rb
+++ b/lib/dino/components/setup/single_pin.rb
@@ -9,9 +9,6 @@ module SinglePin
 
         attr_writer :pin
 
-        #
-        # Require a single pin for single pin components.
-        #
         def initialize_pins(options={})
           raise 'a pin is required for this component' unless options[:pin]
           self.pin = board.convert_pin(options[:pin])
@@ -19,7 +16,7 @@ def initialize_pins(options={})
 
         def mode=(mode)
           @mode = mode
-          board.set_pin_mode(self.pin, mode)
+          board.set_pin_mode(pin, mode)
         end
       end
     end
diff --git a/spec/lib/components/mixins/callbacks_spec.rb b/spec/lib/components/mixins/callbacks_spec.rb
index 54941442..188bbf75 100644
--- a/spec/lib/components/mixins/callbacks_spec.rb
+++ b/spec/lib/components/mixins/callbacks_spec.rb
@@ -6,6 +6,7 @@ module Mixins
       describe Callbacks do
 
         class CallbackComponent
+          include Setup::Base
           include Callbacks
           def initialize; after_initialize; end
         end
diff --git a/spec/lib/components/mixins/listener_spec.rb b/spec/lib/components/mixins/listener_spec.rb
index 7dc92b86..fc8e5c5d 100644
--- a/spec/lib/components/mixins/listener_spec.rb
+++ b/spec/lib/components/mixins/listener_spec.rb
@@ -6,6 +6,7 @@ module Mixins
       describe Poller do
 
         class ListenComponent
+          include Setup::Base
           include Listener
           def _listen(divider=nil); end
           def _stop_listen; end
diff --git a/spec/lib/components/mixins/poller_spec.rb b/spec/lib/components/mixins/poller_spec.rb
index e87ddc7f..cfafcaeb 100644
--- a/spec/lib/components/mixins/poller_spec.rb
+++ b/spec/lib/components/mixins/poller_spec.rb
@@ -6,6 +6,7 @@ module Mixins
       describe Poller do
 
         class PollComponent
+          include Setup::Base
           include Poller
           def _read; end
           def initialize; after_initialize; end
diff --git a/spec/lib/components/mixins/reader_spec.rb b/spec/lib/components/mixins/reader_spec.rb
index 8f92eb23..66b7e63f 100644
--- a/spec/lib/components/mixins/reader_spec.rb
+++ b/spec/lib/components/mixins/reader_spec.rb
@@ -6,6 +6,7 @@ module Mixins
       describe Reader do
 
         class ReadComponent
+          include Setup::Base
           include Reader
           def _read; end
           def initialize; after_initialize; end
diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
index bcd689f6..51296368 100644
--- a/spec/lib/components/mixins/threaded_spec.rb
+++ b/spec/lib/components/mixins/threaded_spec.rb
@@ -4,8 +4,10 @@ module Dino
   module Components
     module Mixins
       describe Threaded do
+        include BoardMock
 
         class ThreadedComponent
+          include Setup::Base
           include Threaded
           def foo(str="test")
             @bar = str
@@ -14,7 +16,7 @@ def foo(str="test")
           interrupt_with :foo
         end
 
-        subject { ThreadedComponent.new }
+        subject { ThreadedComponent.new(board: board) }
 
         describe 'ClassMethods' do
           it 'should add methods to interrupt the thread using #interrupt_with' do
@@ -78,7 +80,7 @@ def foo(str="test")
 
         describe '#enable_interrupts' do
           it 'should override the given method on the singleton class only' do
-            second_part = ThreadedComponent.new
+            second_part = ThreadedComponent.new(board: board)
             before_class = second_part.method(:foo)
             before_instance = subject.method(:foo)
 
diff --git a/spec/lib/components/one_wire/ds18b20_spec.rb b/spec/lib/components/one_wire/ds18b20_spec.rb
index ab697f92..0be629a7 100644
--- a/spec/lib/components/one_wire/ds18b20_spec.rb
+++ b/spec/lib/components/one_wire/ds18b20_spec.rb
@@ -6,14 +6,18 @@ module OneWire
       describe DS18B20 do
         include BoardMock
         let(:bus) { double.as_null_object }
-        subject   { DS18B20.new(board: bus, address: 0xFFFFFFFFFFFFFFFF) }
+        subject   { DS18B20.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF) }
 
-        describe '#decode' do
+        describe '#decode_temp' do
           it 'should decode values matching the datasheet and convert C to F' do
-            expect(subject.decode(0b0000_0111, 0b1101_0000)).to eq(celsius: 125, farenheit: 257)
-            expect(subject.decode(0b0000_0000, 0b0000_0000)).to eq(celsius: 0, farenheit: 32)
-            expect(subject.decode(0b1111_1111, 0b0101_1110)).to eq(celsius: -10.125, farenheit: 13.775)
-            expect(subject.decode(0b1111_1100, 0b1001_0000)).to eq(celsius: -55, farenheit: -67)
+            expect(subject.decode_temp([0b1101_0000,0b0000_0111]))
+              .to eq(celsius: 125, farenheit: 257)
+            expect(subject.decode_temp([0b0000_0000,0b0000_0000]))
+              .to eq(celsius: 0, farenheit: 32)
+            expect(subject.decode_temp([0b0101_1110,0b1111_1111]))
+              .to eq(celsius: -10.125, farenheit: 13.775)
+            expect(subject.decode_temp([0b1001_0000,0b1111_1100]))
+              .to eq(celsius: -55, farenheit: -67)
           end
         end
       end
diff --git a/spec/lib/components/one_wire/enumerator_spec.rb b/spec/lib/components/one_wire/enumerator_spec.rb
index a4111d0c..14dc675b 100644
--- a/spec/lib/components/one_wire/enumerator_spec.rb
+++ b/spec/lib/components/one_wire/enumerator_spec.rb
@@ -83,7 +83,7 @@ def search(branch_mask)
               comp = comp | (comp_bit * (2 ** j))
 
               # Override address bit to a 1 in variable if 1 in mask.
-              # Write whatever addr_bit ends up being back to the simulator.
+              # Write whatever addr_bit ends up being back to the bus simulator.
               if branch_mask[(i*8) + j] == 1
                 @simulator.write_bit(1)
                 addr = addr | (1 * (2 ** j))
@@ -104,7 +104,7 @@ def search(branch_mask)
       #
       class Bus
         def initialize(options={})
-          @board_sim = BoardSimulator.new(options[:simulator])
+          @board_sim = options[:board_sim]
           super(options)
         end
 
@@ -125,11 +125,13 @@ def _search(branch_mask)
             allow_any_instance_of(Bus).to receive(:read_power_supply).and_return false
 
             # This gets slow really fast... 256 seems fine.
-            sim = BusSimulator.new(256)
-            bus = Bus.new(board: board, pin: 7, simulator: sim)
+            bus_sim = BusSimulator.new(256)
+            board_sim = BoardSimulator.new(bus_sim)
+            bus = Bus.new(board: board, pin: 7, board_sim: board_sim)
+            bus.search
 
             found_addresses = bus.found_devices.map { |d| d[:address] }
-            expect(found_addresses.sort).to eq(sim.addresses.sort)
+            expect(found_addresses.sort).to eq(bus_sim.addresses.sort)
           end
         end
       end
diff --git a/spec/lib/components/register/shift_in_spec.rb b/spec/lib/components/register/shift_in_spec.rb
index ac6c3aa1..407eb581 100644
--- a/spec/lib/components/register/shift_in_spec.rb
+++ b/spec/lib/components/register/shift_in_spec.rb
@@ -26,13 +26,13 @@ module Register
             expect(subject.instance_variable_get(:@bytes)).to eq(2)
           end
 
-          it 'should default the preclock_high variable to 0' do
-            expect(subject.instance_variable_get(:@preclock_high)).to eq(0)
+          it 'should default the rising_clock variable to 0' do
+            expect(subject.instance_variable_get(:@rising_clock)).to eq(false)
           end
 
-          it 'should set @preclock_high to 1 if given anything other than 0' do
-            subject = ShiftIn.new(options.merge(preclock_high: :yes))
-            expect(subject.instance_variable_get(:@preclock_high)).to eq(1)
+          it 'should set @rising_clock to true if given anything other than false' do
+            subject = ShiftIn.new(options.merge(rising_clock: :yes))
+            expect(subject.instance_variable_get(:@rising_clock)).to eq(true)
           end
         end
 
@@ -51,7 +51,7 @@ module Register
           end
 
           it 'should request clock pin to go high before reading if set' do
-            subject = ShiftIn.new(options.merge(preclock_high: 1))
+            subject = ShiftIn.new(options.merge(rising_clock: 1))
             expect(board).to receive(:write).with "22.8.1.#{[11,12,1].pack('C*')}\n"
             subject.read
           end
diff --git a/spec/lib/components/servo_spec.rb b/spec/lib/components/servo_spec.rb
index 839b8ac2..e52e1644 100644
--- a/spec/lib/components/servo_spec.rb
+++ b/spec/lib/components/servo_spec.rb
@@ -9,7 +9,7 @@ module Components
 
       describe '#initialize' do
         it 'should toggle the servo library on for the pin' do
-          expect(board).to receive(:servo_toggle).with(options[:pin], 1)
+          expect(board).to receive(:servo_toggle).with(options[:pin], :on)
           subject
         end
       end
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index acd18790..7fb24df1 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -75,8 +75,8 @@ void Dino::coreResponse(int p, int v){
 
 // CMD = 07
 // Set a listener ON or OFF, or change its type, or divider.
-// Takes settings as binary stored in val from the parser and applies
-// them to an existing listener if pin was already used, or first inactive.
+// Takes settings as mask stored in val and applies to existing listener
+// if pin was already used, or first inactive. See Dino.h for mask structure.
 void Dino::setListener(){
   boolean found = false;
   // Check if previously assigned a listener to this pin and re-use.
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
index 41406df7..70a56aeb 100644
--- a/src/lib/DinoOneWire.cpp
+++ b/src/lib/DinoOneWire.cpp
@@ -8,56 +8,58 @@
 
 
 // CMD = 41
-// Reset the OneWire bus and optionally return a presence value if val > 0.
+// Reset the OneWire bus and return a presence value only if requested.
 //
 void Dino::owReset(){
-  // bool present;
+  byte present;
   pinMode(pin, OUTPUT);
   digitalWrite(pin, LOW);
   delayMicroseconds(500);
   pinMode(pin, INPUT);
   delayMicroseconds(80);
-  // present = !digitalRead(pin);
+  present = digitalRead(pin);
   delayMicroseconds(420);
-  // send presence value here
+  if(val>0) coreResponse(pin, present);
 }
 
 // CMD = 42
-// Read a 64-bit address and complement, echoing the address bits unless there's
-// a discrepancy, then we check the branch mask in auxMsg to decide what to do.
+// Read a 64-bit address and complement, echoing each address bit to the bus,
+// unless we are searching a branch that has that bit set to 1, then echo 1.
 //
 void Dino::owSearch(){
   byte addr;
   byte comp;
 
-  // Start with the pin that the bus is on and the colon.
+  // Start streaming the message.
   stream->print(pin); stream->print(':');
 
-  // Print each byte read, followed by a comma, or newline for last byte.
   for(byte i=0; i<8; i++){
     for(byte j=0; j<8; j++){
       bitWrite(addr, j, owReadBit());
       bitWrite(comp, j, owReadBit());
 
-      // If there is a discrepancy, first 8 bytes of auxMsg is a branch mask.
-      // These are bits we must write 1 for since we're searching that branch.
-      // Also set the address bit to 1, but don't touch the complement.
-      // This 'corrupts' the check for discrepancies we already new about,
-      // but we're tracking that remotely anyway.
+      // First 8 bytes of auxMsg is a 64-bit branch mask. Any bit set to 1 says
+      // that we're searching a branch with that bit set to 1, and must force
+      // it to be 1 on this pass. Write 1 to both the address bit and the bus.
+      //
+      // We also do not change the complement bit from 0, Even though the bus
+      // said 0/0, we are sending back 1/0, hiding discrepancies we are testing,
+      // only sending those that appeared this time, which is what we care about.
       //
       if(bitRead(auxMsg[i], j) == 1){
         owWriteBit(1);
         bitWrite(addr, j, 1);
 
-      // If we're don't already know about the discrepancy, behave normally
-      // so it shows up on the next search.
+      // Whether there was no "1-branch" marked for this bit, or there is no
+      // discrepancy at all, just echo address bit to the bus. We compare
+      // addr/comp remotely to find discrepancies for future passes.
       //
       } else {
         owWriteBit(bitRead(addr, j));
       }
     }
     stream->print(addr);
-    stream->print("-");
+    stream->print('-');
     stream->print(comp);
     stream->print((i == 7) ? '\n' : ',');
   }
@@ -66,12 +68,12 @@ void Dino::owSearch(){
 // CMD = 43
 // Write to the OneWire bus.
 //
-// val = number of bytes to write + parasite power condition OR-ed into MSB.
+// val = number of bytes to write + parasite power condition flag in MSB.
 // auxMsg[0] = first byte of data and so on...
-// Limited to 127 bytes. Validate on remote end.
+// Limited to 127 bytes. Validate remotely.
 //
 void Dino::owWrite(){
-  // Check and clear parasite flag masked into array length.
+  // Check and clear parasite flag.
   bool parasite = bitRead(val, 7);
   bitClear(val, 7);
 
@@ -113,9 +115,11 @@ void Dino::owWriteBit(byte b){
 // Read bytes from the OneWire bus.
 //
 // val = number of bytes to read
+//
 void Dino::owRead(){
   byte b;
-  // Start with the pin that the bus is on and the colon.
+
+  // Start streaming the message.
   stream->print(pin); stream->print(':');
 
   // Print each byte read, followed by a comma, or newline for last byte.
@@ -130,7 +134,7 @@ void Dino::owRead(){
 
 byte Dino::owReadBit(){
   byte b;
-  // Pull low for at least 1us to start a read time slot, then release.
+  // Pull low for at least 1us to start a read slot, then release.
   pinMode(pin, OUTPUT);
   digitalWrite(pin, LOW);
   delayMicroseconds(1);
@@ -139,10 +143,10 @@ byte Dino::owReadBit(){
   // Wait for the slave to write to the bus. It should hold for up to 15us.
   delayMicroseconds(5);
 
-  // If slave pulled the bus high, the bit a 1, else 0.
+  // If slave pulled the bus high, the bit is a 1, else 0.
   b = digitalRead(pin);
 
-  // Wait out the 60us window + recovery time.
+  // Wait out the 60us read slot + recovery time.
   delayMicroseconds(55);
   return b;
 }

From 5725af1efa1ec5d02a8042d78ee2d665d41fe243 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 13 Feb 2018 16:08:26 -0400
Subject: [PATCH 167/296] =?UTF-8?q?Don=E2=80=99t=20use=20Fixnum#bit=5Fleng?=
 =?UTF-8?q?th=20to=20keep=20Ruby=202.0=20compatibility.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 lib/dino/components/one_wire/bus_enumerator.rb | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/dino/components/one_wire/bus_enumerator.rb b/lib/dino/components/one_wire/bus_enumerator.rb
index fba17e5e..0b69da91 100644
--- a/lib/dino/components/one_wire/bus_enumerator.rb
+++ b/lib/dino/components/one_wire/bus_enumerator.rb
@@ -65,7 +65,9 @@ def parse_search_result(result)
           #
           # This is OK. We only want the highest discrepancy we did not set to 1.
           #
-          high_discrepancy = new_discrepancies.bit_length - 1
+          # high_discrepancy = new_discrepancies.bit_length - 1
+          high_discrepancy = -1
+          (0..63).each { |i| high_discrepancy = i if new_discrepancies[i] == 1 }
 
           # LSByte of address is product family. Check for existing class.
           klass = family_lookup(address & 0x00000000000000FF)

From f4b01e0f38579e679dd06e3c491ca1dab6caba6b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 13 Feb 2018 16:21:50 -0400
Subject: [PATCH 168/296] Trying to fix jruby tests

---
 spec/lib/components/mixins/threaded_spec.rb | 47 ++++++++++++---------
 1 file changed, 26 insertions(+), 21 deletions(-)

diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
index 51296368..1538acc3 100644
--- a/spec/lib/components/mixins/threaded_spec.rb
+++ b/spec/lib/components/mixins/threaded_spec.rb
@@ -45,67 +45,72 @@ def foo(str="test")
 
           it 'should store in @thread' do
             thread = Thread.current
-            async = Proc.new { thread = Thread.current }
-            subject.threaded(&async)
-            while(!subject.instance_variable_get :@thread) do; end
-            expect(subject.instance_variable_get :@thread).to_not eq(thread)
+            component = subject
+            component.threaded {}
+            while(!component.instance_variable_get :@thread) do; end
+            expect(component.instance_variable_get :@thread).to_not eq(thread)
           end
         end
 
         describe '#threaded_loop' do
           it 'should loop the block in the thread' do
+            component = subject
             main_thread = Thread.current
             async_thread = Thread.current
             async = Proc.new { async_thread = Thread.current}
 
             expect(async).to receive(:call).and_call_original
-            expect(subject).to receive(:loop) do |&block|
+            expect(component).to receive(:loop) do |&block|
               expect(block).to eq(async)
             end.and_yield
 
-            subject.threaded_loop(&async)
+            component.threaded_loop(&async)
             while(main_thread == async_thread) do; end
-            subject.stop_thread
+            component.stop_thread
             expect(main_thread).to_not eq(async_thread)
           end
         end
 
         describe '#stop_thread' do
           it 'should kill the thread' do
-            subject.threaded { sleep }
-            expect(subject.instance_variable_get :@thread).to receive(:kill)
-            subject.stop_thread
+            component = subject
+            component.threaded { sleep }
+            expect(component.instance_variable_get :@thread).to receive(:kill)
+            component.stop_thread
           end
         end
 
         describe '#enable_interrupts' do
           it 'should override the given method on the singleton class only' do
+            first_part = subject
             second_part = ThreadedComponent.new(board: board)
             before_class = second_part.method(:foo)
-            before_instance = subject.method(:foo)
+            before_instance = first_part.method(:foo)
 
-            subject.enable_interrupts
+            first_part.enable_interrupts
             after_class = second_part.method(:foo)
-            after_instance = subject.method(:foo)
+            after_instance = first_part.method(:foo)
 
             expect(after_class).to eq(before_class)
             expect(after_instance).to_not eq(before_instance)
           end
 
           it 'should pass arguments through to the original method' do
-            original = subject.method(:foo)
-            subject.enable_interrupts
-            subject.foo("dino")
-            expect(original).to_not eq(subject.method(:foo))
-            expect(subject.bar).to eq("dino")
+            component = subject
+            original = component.method(:foo)
+            component.enable_interrupts
+            component.foo("dino")
+            expect(original).to_not eq(component.method(:foo))
+            expect(component.bar).to eq("dino")
           end
         end
 
         describe 'calling an interrupt' do
           it 'should stop the thread' do
-            subject.threaded { sleep }
-            expect(subject).to receive(:stop_thread)
-            subject.foo
+            component = subject
+            component.threaded { sleep }
+            expect(component).to receive(:stop_thread)
+            component.foo
           end
         end
       end

From 1a09b98d5bc227c799e83dfbfab59e52f544645f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 13 Feb 2018 16:32:49 -0400
Subject: [PATCH 169/296] =?UTF-8?q?Trying=20to=20get=202.0.0=20and=20jruby?=
 =?UTF-8?q?=20to=20agree=E2=80=A6.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 spec/lib/components/mixins/threaded_spec.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
index 1538acc3..eace7eac 100644
--- a/spec/lib/components/mixins/threaded_spec.rb
+++ b/spec/lib/components/mixins/threaded_spec.rb
@@ -60,7 +60,7 @@ def foo(str="test")
             async = Proc.new { async_thread = Thread.current}
 
             expect(async).to receive(:call).and_call_original
-            expect(component).to receive(:loop) do |&block|
+            allow_any_instance_of(ThreadedComponent).to receive(:loop) do |&block|
               expect(block).to eq(async)
             end.and_yield
 

From f2587bef17da595c5151f790d58bbfd76d43575b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 13 Feb 2018 16:38:19 -0400
Subject: [PATCH 170/296] Maybe no sleep in wait loops is the real problem?

---
 spec/lib/components/mixins/threaded_spec.rb | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
index eace7eac..ec586f91 100644
--- a/spec/lib/components/mixins/threaded_spec.rb
+++ b/spec/lib/components/mixins/threaded_spec.rb
@@ -47,7 +47,7 @@ def foo(str="test")
             thread = Thread.current
             component = subject
             component.threaded {}
-            while(!component.instance_variable_get :@thread) do; end
+            while(!component.instance_variable_get :@thread) do; sleep 0.05; end
             expect(component.instance_variable_get :@thread).to_not eq(thread)
           end
         end
@@ -60,12 +60,12 @@ def foo(str="test")
             async = Proc.new { async_thread = Thread.current}
 
             expect(async).to receive(:call).and_call_original
-            allow_any_instance_of(ThreadedComponent).to receive(:loop) do |&block|
+            expect(component).to receive(:loop) do |&block|
               expect(block).to eq(async)
             end.and_yield
 
             component.threaded_loop(&async)
-            while(main_thread == async_thread) do; end
+            while(main_thread == async_thread) do; sleep 0.05; end
             component.stop_thread
             expect(main_thread).to_not eq(async_thread)
           end

From 234fd1f4c90913a8980b71bbbdc2d578aeb9c7f3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 13 Feb 2018 16:51:06 -0400
Subject: [PATCH 171/296] =?UTF-8?q?RSpec=20is=20so=20great=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 spec/lib/components/mixins/threaded_spec.rb | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
index ec586f91..3b761946 100644
--- a/spec/lib/components/mixins/threaded_spec.rb
+++ b/spec/lib/components/mixins/threaded_spec.rb
@@ -54,20 +54,19 @@ def foo(str="test")
 
         describe '#threaded_loop' do
           it 'should loop the block in the thread' do
-            component = subject
-            main_thread = Thread.current
-            async_thread = Thread.current
-            async = Proc.new { async_thread = Thread.current}
+            @mutex = Mutex.new
+            @count = 0
 
-            expect(async).to receive(:call).and_call_original
-            expect(component).to receive(:loop) do |&block|
-              expect(block).to eq(async)
-            end.and_yield
+            component = subject
+            component.threaded_loop do
+              @mutex.synchronize do
+                @count = @count + 1
+              end
+            end
 
-            component.threaded_loop(&async)
-            while(main_thread == async_thread) do; sleep 0.05; end
+            while(@mutex.synchronize{ @count } < 2) do; sleep 0.05; end
             component.stop_thread
-            expect(main_thread).to_not eq(async_thread)
+            expect(@count).to be > 1
           end
         end
 

From d102c029ec4ba10812ed88f7073303a3b2a4a569 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 13 Feb 2018 19:34:43 -0400
Subject: [PATCH 172/296] Comment cleanup, 1-Wire fixes, tests.

---
 lib/dino/components/dht.rb                    |   1 -
 lib/dino/components/ir_emitter.rb             |   2 -
 lib/dino/components/mixins/bus.rb             |   3 +
 lib/dino/components/one_wire/bus.rb           |   5 +-
 .../components/one_wire/bus_enumerator.rb     |  32 ++---
 lib/dino/components/one_wire/ds18b20.rb       |  23 ++--
 lib/dino/components/one_wire/helper.rb        |   9 --
 lib/dino/components/one_wire/slave.rb         |  30 +++--
 lib/dino/components/rotary_encoder.rb         |   2 -
 lib/dino/components/setup/base.rb             |   5 +-
 lib/dino/tx_rx/flow_control.rb                |   3 +-
 lib/dino_cli/generator.rb                     |   5 +-
 spec/lib/components/one_wire/ds18b20_spec.rb  |  42 +++++-
 spec/lib/components/one_wire/slave_spec.rb    | 125 ++++++++++++++++++
 14 files changed, 212 insertions(+), 75 deletions(-)
 create mode 100644 spec/lib/components/one_wire/slave_spec.rb

diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
index c804d12b..cf3f91d9 100644
--- a/lib/dino/components/dht.rb
+++ b/lib/dino/components/dht.rb
@@ -14,7 +14,6 @@ def _read
         board.dht_read(self.pin)
       end
 
-      # Process raw data from the board before running #update.
       def pre_callback_filter(data)
         t, h = data.split(",")
         { temperature: t.to_f, humidity: h.to_f }
diff --git a/lib/dino/components/ir_emitter.rb b/lib/dino/components/ir_emitter.rb
index 39e57aa3..687c3d17 100644
--- a/lib/dino/components/ir_emitter.rb
+++ b/lib/dino/components/ir_emitter.rb
@@ -12,9 +12,7 @@ def send(pulses=[], options={})
           raise ArgumentError 'pulse too long (max 65536 microsec)' if pulse > 65536
         end
 
-        # Default to 38kHz.
         frequency = options[:frequency] || 38
-
         board.infrared_send(pin, frequency, pulses)
       end
     end
diff --git a/lib/dino/components/mixins/bus.rb b/lib/dino/components/mixins/bus.rb
index d44c16df..d597958f 100644
--- a/lib/dino/components/mixins/bus.rb
+++ b/lib/dino/components/mixins/bus.rb
@@ -7,9 +7,12 @@ module Bus
         # attached to it, matching Board, but without the full Board interface.
         # See OneWire::Bus class for an example.
         #
+        attr_reader :mutex
+
         def after_initialize(options={})
           super(options)
           @components = []
+          @mutex = Mutex.new
         end
 
         attr_reader :components
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index 89f956e6..8ae0eef1 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -6,17 +6,16 @@ class Bus
         include Mixins::Bus
         include Mixins::Reader
 
-        attr_reader :found_devices, :parasite_power, :mutex
+        attr_reader :found_devices, :parasite_power
 
         def after_initialize(options = {})
           super(options)
-          @mutex = Mutex.new
           @found_devices = []
           read_power_supply
         end
 
         # Without driving low first, results are inconsistent.
-        # Only the first (LS) bit matters, but it's easier to read a whole byte.
+        # Only first (LS) bit matters, but we can only read whole bytes.
         #
         def read_power_supply
           board.set_pin_mode(self.pin, :out)
diff --git a/lib/dino/components/one_wire/bus_enumerator.rb b/lib/dino/components/one_wire/bus_enumerator.rb
index 0b69da91..2d7eb45a 100644
--- a/lib/dino/components/one_wire/bus_enumerator.rb
+++ b/lib/dino/components/one_wire/bus_enumerator.rb
@@ -2,7 +2,7 @@ module Dino
   module Components
     module OneWire
       class Bus
-        # 1 bits in mask set discrepancies to 1. 0 leaves bit as read from bus.
+        # 1 bits in mask force discrepancies to 1. 0 leaves bit as read from bus.
         def _search(branch_mask)
           reset
           write(SEARCH_ROM)
@@ -23,15 +23,13 @@ def search
             _search(branch_mask)
             block_until_read
 
-            # No untested discrepancies left. End the search.
+            # No unsearched discrepancies left.
             break if high_discrepancy == - 1
 
-            # If high_discrepancy was not forced 1 last iteration, do it next.
+            # Force highest new discrepancy to 1 on the next search.
             # i.e. Go as deep as possible into each branch found then back out.
             #
-            if branch_mask[high_discrepancy] == 0
-              branch_mask = branch_mask | (2 ** high_discrepancy)
-            end
+            branch_mask = branch_mask | (2 ** high_discrepancy)
 
             # Clear bits above high_discrepancy so we don't repeat branches.
             # When high_discrepancy < MSB of branch_mask, this moves us
@@ -51,25 +49,15 @@ def parse_search_result(result)
             raise "OneWire device not connected or disconnected during search"
           end
 
-          #
-          # XOR address with complement to give a 0 at each discrepancy.
-          # XOR again with 64 1s to flip, so each discrepancy is a 1 instead.
-          #
-          new_discrepancies = (address ^ complement) ^ 0xFFFFFFFFFFFFFFFF
-
-          #
-          # Note: Discrepancies forced to 1 in an iteration will not show up as
-          # discrepancies when parsing the result from that iteration. The board
-          # will have read 0-0 from the bus, but we told it to override the
-          # address bit to a 1, so we get back (1-0), as if no discrepancy.
-          #
-          # This is OK. We only want the highest discrepancy we did not set to 1.
-          #
+          # Gives 0 at every discrepancy we didn't write 1 for on this search.
+          new_discrepancies = address ^ complement
+
+          # Newer rubies:
           # high_discrepancy = new_discrepancies.bit_length - 1
           high_discrepancy = -1
-          (0..63).each { |i| high_discrepancy = i if new_discrepancies[i] == 1 }
+          (0..63).each { |i| high_discrepancy = i if new_discrepancies[i] == 0 }
 
-          # LSByte of address is product family. Check for existing class.
+          # LSByte of address is product family.
           klass = family_lookup(address & 0x00000000000000FF)
 
           [{class: klass, address: address}, high_discrepancy]
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index 8c285d73..6fc8196c 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -2,10 +2,9 @@ module Dino
   module Components
     module OneWire
       class DS18B20 < Slave
-        include Mixins::Poller
+
         FAMILY_CODE = 0x28
 
-        # Scratch read specifically for the resolution if not set yet.
         def resolution
           @resolution ||= decode_resolution read_scratch(9)
         end
@@ -32,7 +31,9 @@ def set_convert_time
         end
 
         def convert
-          @convert_time ||= 0.75
+          @resolution ||= 12
+          set_convert_time
+
           atomically do
             match
             bus.write(CONVERT_T)
@@ -43,18 +44,15 @@ def convert
 
         def _read
           convert
-          # This runs callbacks in our thread instead of the callback thread...
-          self.update(read_scratch(9))
+          read_scratch(9)
         end
 
         def pre_callback_filter(data)
           # Data is 9 comma delimited numbers in ASCII, representing bytes.
-          bytes = data.split(",").map{|b| b.to_i}
+          bytes = data.split(",").map{ |b| b.to_i }
           return {crc_error: true} unless Helper.crc_check(bytes)
 
-          # Update resolution and conversion time each read.
           @resolution = decode_resolution(bytes)
-          set_convert_time
 
           decode_temp(bytes).merge(raw: bytes)
         end
@@ -65,15 +63,14 @@ def pre_callback_filter(data)
         # 2^-4 exponent, up through 2^6 for next 10 bits. 5 MSBs repeat the sign.
         #
         def decode_temp(bytes)
-          # Get magnitude without sign.
-          value = bytes[1] << 8 | bytes[0]
-          negative = (value[15] == 1)
-          value = (value ^ 0xFFFF) + 1 if negative
+          magnitude = bytes[1] << 8 | bytes[0]
+          negative = (magnitude[15] == 1)
+          magnitude = (magnitude ^ 0xFFFF) + 1 if negative
 
           celsius = 0.0
           exp = -4
           for bit in (0..10)
-            if (value[bit] == 1)
+            if (magnitude[bit] == 1)
               celsius = celsius + (2.0 ** (exp+bit))
             end
           end
diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
index 8f1aa32a..b4fcbd29 100644
--- a/lib/dino/components/one_wire/helper.rb
+++ b/lib/dino/components/one_wire/helper.rb
@@ -2,20 +2,11 @@ module Dino
   module Components
     module OneWire
       class Helper
-
-        #
-        # Convert 64-bit Integer ROM address to array of 8 LSByte first bytes.
-        #
         def self.address_to_bytes(address)
           [address].pack('Q<').split("").map(&:ord)
         end
 
-
         def self.crc_check(data)
-          #
-          # Sensor data will usually be an array of bytes, but for checking
-          # things like ROM addresses, we may receive a 64-bit Integer.
-          #
           if data.class == Integer
             bytes = address_to_bytes(data)
           else
diff --git a/lib/dino/components/one_wire/slave.rb b/lib/dino/components/one_wire/slave.rb
index 1b0b1ab2..3e170be1 100644
--- a/lib/dino/components/one_wire/slave.rb
+++ b/lib/dino/components/one_wire/slave.rb
@@ -3,19 +3,10 @@ module Components
     module OneWire
       class Slave
         include Setup::Base
+        include Mixins::Poller
         attr_reader :address
         alias  :bus :board
 
-        #
-        # Remove the MSByte (CRC) and LSByte (family code) from slave's ROM
-        # address to get a printable 48-bit serial number in hex.
-        #
-        def serial_number
-          address = @address & 0x00FFFFFFFFFFFFFF
-          address = address >> 8
-          address.to_s(16).rjust(12, "0")
-        end
-
         def initialize(options={})
           options[:board] ||= options[:bus]
           super(options)
@@ -31,13 +22,15 @@ def after_initialize(options={})
 
         def read_scratch(num_bytes)
           atomically do
+            # Bubble a single bus callback up to self, bound by this lock.
+            bus.add_callback(:read) { |data| self.update(data) }
             match
             bus.write(READ_SCRATCH)
             bus.read(num_bytes)
           end
         end
 
-        def write_scratch(bytes)
+        def write_scratch(*bytes)
           atomically do
             match
             bus.write(WRITE_SCRATCH)
@@ -62,14 +55,25 @@ def atomically(&block)
 
         def match
           bus.reset
-          # Skip ROM match if only one device on the bus.
-          if bus.found_devices == 1
+          if bus.found_devices.count < 2
             bus.write(SKIP_ROM)
           else
             bus.write(MATCH_ROM)
             bus.write(Helper.address_to_bytes(self.address))
           end
         end
+
+        def serial_number
+          @serial_number ||= extract_serial
+        end
+
+        def extract_serial
+          # Remove CRC.
+          address = @address & 0x00FFFFFFFFFFFFFF
+          # Remove family code.
+          address = address >> 8
+          address.to_s(16).rjust(12, "0")
+        end
       end
     end
   end
diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index 09fc222e..14d03aff 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -13,12 +13,10 @@ class RotaryEncoder
       def after_initialize(options={})
         super(options)
 
-        # Default to listening every tick (1ms / 1kHz)
         divider = options[:divider] || 1
         clock.listen(divider)
         data.listen(divider)
 
-        # Setup to track position in degrees.
         @steps = options[:steps] || 30
         @degrees_per_step = (360 / steps).to_f
         @state = 0.0
diff --git a/lib/dino/components/setup/base.rb b/lib/dino/components/setup/base.rb
index 053569f6..d194c255 100644
--- a/lib/dino/components/setup/base.rb
+++ b/lib/dino/components/setup/base.rb
@@ -28,9 +28,8 @@ def unregister
           board.remove_component(self)
         end
 
-        #
-        # Setup::Base only requires a board. Mix in modules from Setup or define
-        # this method in your class to use pins.
+        # Setup::Base only requires a board.
+        # Include modules from Setup or override this to use pins.
         #
         def initialize_pins(options={}) ; end
         alias :initialize_pin :initialize_pins
diff --git a/lib/dino/tx_rx/flow_control.rb b/lib/dino/tx_rx/flow_control.rb
index 8436c38e..1010dcb1 100644
--- a/lib/dino/tx_rx/flow_control.rb
+++ b/lib/dino/tx_rx/flow_control.rb
@@ -11,7 +11,6 @@ def initialize(*args)
         reset_flow_control
       end
 
-      # Split messages to use available buffer, and wrap #write in a mutex.
       def write(message)
         add_write_call
         @write_mutex.synchronize do
@@ -68,7 +67,7 @@ def read_and_parse
         if line && line.match(/\AACK:/)
           # A HandshakeAttempt is observing. Also pass self so it can stop.
           changed && notify_observers(self, line.split(":", 2)[1])
-          # Empty @transit_bytes. ACK: means the board reset its counter too.
+          # ACK: means the board reset its counter. Reset ours.
           @transit_mutex.synchronize { @transit_bytes = 0 }
         elsif line && line.match(/\ARCV:/)
           remove_transit_bytes(line.split(/:/)[1].to_i)
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 94c6885b..d2004536 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -10,11 +10,9 @@ def initialize(options={})
   end
 
   def append_target
-    # Default to generating the mega sketch.
     options[:target] = :mega unless options[:target]
     # Preserve the source sketch name, since we need to copy that file.
     options[:src_sketch_name] = options[:sketch_name].dup
-    # Append the target to the output sketch name/folder when not using :mega.
     options[:sketch_name] << "_#{options[:target]}" unless options[:target] == :mega
   end
 
@@ -28,10 +26,9 @@ def self.run!(options={})
   end
 
   def read
-    # Start by just copying the PACKAGES hash.
     @packages = PACKAGES
 
-    # Now replace each filepath with a hash containing the filepath and contents.
+    # Replace each filepath with a hash containing the filepath and contents.
     @packages.each_key do |k|
       @packages[k][:files].map! do |f|
         contents = File.read(File.join(options[:src_dir], f))
diff --git a/spec/lib/components/one_wire/ds18b20_spec.rb b/spec/lib/components/one_wire/ds18b20_spec.rb
index 0be629a7..277d7e94 100644
--- a/spec/lib/components/one_wire/ds18b20_spec.rb
+++ b/spec/lib/components/one_wire/ds18b20_spec.rb
@@ -5,7 +5,7 @@ module Components
     module OneWire
       describe DS18B20 do
         include BoardMock
-        let(:bus) { double.as_null_object }
+        let(:bus) { double(mutex: Mutex.new).as_null_object }
         subject   { DS18B20.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF) }
 
         describe '#decode_temp' do
@@ -20,6 +20,46 @@ module OneWire
               .to eq(celsius: -55, farenheit: -67)
           end
         end
+
+        describe '#decode_resolution' do
+          it 'should get the resolution from the entire scratchpad' do
+            expect(subject.decode_resolution([0,0,0,0,0b01100000])).to eq(12)
+            expect(subject.decode_resolution([0,0,0,0,0b01000000])).to eq(11)
+            expect(subject.decode_resolution([0,0,0,0,0b00100000])).to eq(10)
+            expect(subject.decode_resolution([0,0,0,0,0b00000000])).to eq(9)
+          end
+        end
+
+        describe '#convert' do
+          it 'should be atomic' do
+            expect(subject).to receive(:atomically).exactly(1).times
+            subject.convert
+          end
+
+          it 'should match first' do
+            expect(subject).to receive(:atomically).exactly(1).times
+            subject.convert
+          end
+
+          it 'should send the command' do
+            expect(bus).to receive(:write).with(0x44)
+            subject.convert
+          end
+
+          it 'should set the sleep time to default on first conversion' do
+            subject.convert
+            expect(subject.instance_variable_get(:@convert_time)).to eq(0.75)
+          end
+
+          it 'should sleep for the conversion time' do
+            subject.convert
+            expect(subject).to receive(:sleep).with(subject.instance_variable_get(:@convert_time))
+            subject.convert
+          end
+
+          it 'should sleep inside the mutex lock if parasite power in use'
+          it 'should sleep outside the mutex lock if parasite power not in use'
+        end
       end
     end
   end
diff --git a/spec/lib/components/one_wire/slave_spec.rb b/spec/lib/components/one_wire/slave_spec.rb
new file mode 100644
index 00000000..aa96c5fa
--- /dev/null
+++ b/spec/lib/components/one_wire/slave_spec.rb
@@ -0,0 +1,125 @@
+require 'spec_helper'
+
+module Dino
+  module Components
+    module OneWire
+      describe Slave do
+        include BoardMock
+        let(:bus) { double(mutex: Mutex.new).as_null_object }
+        subject   { Slave.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF) }
+
+        describe '#after_initialize' do
+          it 'should require an address' do
+            expect { Slave.new(bus: bus) }.to raise_error
+          end
+        end
+
+        describe '#atomically' do
+          it 'should happen inside the mutex lock' do
+            expect(bus.mutex).to receive(:synchronize)
+            subject.atomically {}
+          end
+
+          it 'should take a block and call it exactly once' do
+            block = Proc.new {}
+            expect(block).to receive(:call).exactly(1).times
+            subject.atomically(&block)
+          end
+        end
+
+        describe '#match' do
+          it 'should NOT be atomic' do
+            expect(subject).to receive(:atomically).exactly(0).times
+            subject.match
+          end
+
+          it 'should reset the bus' do
+            expect(bus).to receive(:reset)
+            subject.match
+          end
+
+          it 'should skip rom if it is the only device on the bus' do
+            expect(bus).to receive(:write).with(0xCC)
+            subject.match
+          end
+
+          it 'should try to match ROM, then send its ROM if not alone on the bus' do
+            # Just needs to be an array of anything > 1.
+            bus.stub(:found_devices) { [1,2] }
+            expect(bus).to receive(:write).with(0x55)
+            expect(bus).to receive(:write).with([255,255,255,255,255,255,255,255])
+            device = Slave.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF)
+            device.match
+          end
+        end
+
+        describe '#copy_scratch' do
+          it 'should be atomic' do
+            expect(subject).to receive(:atomically).exactly(1).times
+            subject.copy_scratch
+          end
+
+          it 'should call #match' do
+            expect(subject).to receive(:match).exactly(1).times
+            subject.copy_scratch
+          end
+
+          it 'should send the command' do
+            expect(bus).to receive(:write).with(0x48)
+            subject.copy_scratch
+          end
+
+          it 'should reset the bus after if parasite power is in use' do
+            bus.stub(:parasite_power) { true }
+            expect(bus).to receive(:reset).exactly(2).times
+            subject.copy_scratch
+          end
+        end
+
+        describe '#read_scratch' do
+          it 'should be atomic' do
+            expect(subject).to receive(:atomically).exactly(1).times
+            subject.read_scratch(9)
+          end
+
+          it 'should call #match' do
+            expect(subject).to receive(:match).exactly(1).times
+            subject.read_scratch(9)
+          end
+
+          it 'should send the command' do
+            expect(bus).to receive(:write).with(0xBE)
+            subject.read_scratch(9)
+          end
+
+          it 'should read the right number of bytes' do
+            expect(bus).to receive(:read).with(9)
+            subject.read_scratch(9)
+          end
+        end
+
+        describe '#write_scratch' do
+          it 'should be atomic' do
+            expect(subject).to receive(:atomically).exactly(1).times
+            subject.write_scratch([1])
+          end
+
+          it 'should call #match' do
+            expect(subject).to receive(:match).exactly(1).times
+            subject.write_scratch(1)
+          end
+
+          it 'should send the command' do
+            expect(bus).to receive(:write).with(0x4E)
+            subject.write_scratch(1)
+          end
+
+          it 'should write the data' do
+            expect(bus).to receive(:write).with([1,2,3])
+            subject.write_scratch(1,2,3)
+          end
+        end
+      end
+    end
+  end
+end

From 1694632863700cc5c1c014395336527a11f686b6 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 15 Feb 2018 11:57:00 -0400
Subject: [PATCH 173/296] More 1-Wire refactoring

---
 lib/dino/components/one_wire/ds18b20.rb | 54 +++++++++----------------
 lib/dino/components/one_wire/slave.rb   | 31 +++++++++-----
 2 files changed, 39 insertions(+), 46 deletions(-)

diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index 6fc8196c..cedac9d0 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -2,28 +2,28 @@ module Dino
   module Components
     module OneWire
       class DS18B20 < Slave
-
         FAMILY_CODE = 0x28
 
+        def scratch
+          @state ? @state[:raw] : read_scratch(9)
+        end
+
         def resolution
-          @resolution ||= decode_resolution read_scratch(9)
+          @resolution ||= decode_resolution(scratch)
         end
 
         def resolution=(bits)
-          raise ArgumentError 'Invalid DS18B20 resolution' if (bits > 12 || bits < 9)
-
-          @resolution = bits
-          scratch = read_scratch(9).split(",").map(&:to_i)
-
-          unless decode_resolution(scratch) == @resolution
-            settings = scratch[2..4]
-            offset = @resolution - 9
-            settings[2] = 0b00011111 | (offset << 5)
-            write_scratch(settings)
-            copy_scratch
+          unless (9..12).include?(bits)
+            raise ArgumentError, 'Invalid DS18B20 resolution, expected 9 to 12'
           end
 
-          set_convert_time
+          return bits if decode_resolution(scratch) == bits
+
+          eeprom = scratch[2..4]
+          eeprom[2] = 0b00011111 | ((bits - 9) << 5)
+          write_scratch(eeprom)
+          copy_scratch
+          @resolution = bits
         end
 
         def set_convert_time
@@ -44,14 +44,11 @@ def convert
 
         def _read
           convert
-          read_scratch(9)
+          read_scratch(9) { |data| self.update(data) }
         end
 
-        def pre_callback_filter(data)
-          # Data is 9 comma delimited numbers in ASCII, representing bytes.
-          bytes = data.split(",").map{ |b| b.to_i }
-          return {crc_error: true} unless Helper.crc_check(bytes)
-
+        def pre_callback_filter(bytes)
+          return { crc_error: true } unless Helper.crc_check(bytes)
           @resolution = decode_resolution(bytes)
 
           decode_temp(bytes).merge(raw: bytes)
@@ -59,23 +56,10 @@ def pre_callback_filter(data)
 
         #
         # Temperature is the first 16 bits (2 bytes of 9 read), little-endian.
-        # It's a sign-extended two's complement 12-bit decimal, where LSB is the
-        # 2^-4 exponent, up through 2^6 for next 10 bits. 5 MSBs repeat the sign.
+        # It's a signed, 2's complement, little-endian decimal with 2^-4 exp.
         #
         def decode_temp(bytes)
-          magnitude = bytes[1] << 8 | bytes[0]
-          negative = (magnitude[15] == 1)
-          magnitude = (magnitude ^ 0xFFFF) + 1 if negative
-
-          celsius = 0.0
-          exp = -4
-          for bit in (0..10)
-            if (magnitude[bit] == 1)
-              celsius = celsius + (2.0 ** (exp+bit))
-            end
-          end
-
-          celsius = -celsius if negative
+          celsius = bytes[0..1].pack('C*').unpack('s<')[0] * (2.0 ** -4)
           farenheit = (celsius * 1.8 + 32).round(4)
 
           {celsius: celsius, farenheit: farenheit}
diff --git a/lib/dino/components/one_wire/slave.rb b/lib/dino/components/one_wire/slave.rb
index 3e170be1..bceef808 100644
--- a/lib/dino/components/one_wire/slave.rb
+++ b/lib/dino/components/one_wire/slave.rb
@@ -14,19 +14,26 @@ def initialize(options={})
 
         def after_initialize(options={})
           super(options)
+
           unless options[:address]
-            raise ArgumentError, 'missing 1-Wire slave ROM address; try searching first'
+            raise ArgumentError,
+                  'missing 1-Wire slave ROM address; try Bus#search first'
           end
           @address = options[:address]
         end
 
-        def read_scratch(num_bytes)
+        def read_scratch(num_bytes, &block)
           atomically do
-            # Bubble a single bus callback up to self, bound by this lock.
-            bus.add_callback(:read) { |data| self.update(data) }
+            # Bubble bus callback while still in the lock.
+            if block_given?
+              bus.add_callback(:read) do |data|
+                block.call data.split(",").map(&:to_i)
+              end
+            end
+
             match
             bus.write(READ_SCRATCH)
-            bus.read(num_bytes)
+            bus.read(num_bytes).split(",").map(&:to_i)
           end
         end
 
@@ -42,7 +49,7 @@ def copy_scratch
           atomically do
             match
             bus.write(COPY_SCRATCH)
-            sleep 0.02
+            sleep 0.05
             bus.reset if bus.parasite_power
           end
         end
@@ -59,19 +66,21 @@ def match
             bus.write(SKIP_ROM)
           else
             bus.write(MATCH_ROM)
-            bus.write(Helper.address_to_bytes(self.address))
+            bus.write(address_bytes)
           end
         end
 
+        def address_bytes
+          Helper.address_to_bytes(self.address)
+        end
+
         def serial_number
           @serial_number ||= extract_serial
         end
 
         def extract_serial
-          # Remove CRC.
-          address = @address & 0x00FFFFFFFFFFFFFF
-          # Remove family code.
-          address = address >> 8
+          # Remove CRC & family code.
+          address = (@address & 0x00FFFFFFFFFFFFFF) >> 8
           address.to_s(16).rjust(12, "0")
         end
       end

From 5c9ff4c26d76b5e2136cfe8d7566698d6a3de7b2 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 15 Feb 2018 16:49:14 -0400
Subject: [PATCH 174/296] Default SPI access to 2-way, listeners read only.

Selecting MSBFIRST or LSBFIRST bit order now works.
---
 lib/dino/api/helper.rb                  |   3 +-
 lib/dino/api/spi.rb                     |  55 ++++++++-----
 lib/dino/components/register/input.rb   |   2 +-
 lib/dino/components/register/spi_in.rb  |   4 +-
 lib/dino/components/register/spi_out.rb |   2 +-
 src/lib/Dino.cpp                        |   7 +-
 src/lib/Dino.h                          |   9 +--
 src/lib/DinoSPI.cpp                     | 103 ++++++++++++------------
 8 files changed, 99 insertions(+), 86 deletions(-)

diff --git a/lib/dino/api/helper.rb b/lib/dino/api/helper.rb
index 982d66c7..a534fabd 100644
--- a/lib/dino/api/helper.rb
+++ b/lib/dino/api/helper.rb
@@ -34,8 +34,7 @@ def pack(type, data, options={})
           end
         end
 
-        # Minimum 1 whether or not :min is given as an option.
-        if str.length < (options[:min] || 1)
+        if options[:min] && str.length < options[:min]
           raise ArgumentError, "too few bytes given (expected at least #{options[:min]})"
         end
 
diff --git a/lib/dino/api/spi.rb b/lib/dino/api/spi.rb
index 7aadeecb..430f0ac3 100644
--- a/lib/dino/api/spi.rb
+++ b/lib/dino/api/spi.rb
@@ -3,36 +3,53 @@ module API
     module SPI
       include Helper
 
-      def spi_settings(mode, frequency)
-        pack(:uint8, [0, mode]) + pack(:uint32, [frequency])
+      def spi_header(options)
+        options[:mode]       ||= 0
+        options[:frequency]  ||= 3000000
+        options[:bit_order]  ||= :lsbfirst
+        raise ArgumentError,
+              'invalid SPI mode' unless (0..3).include? options[:mode]
+
+        # Flag unused high bit of mode if we need to transfer MSBFIRST.
+        settings = options[:mode]
+        settings = settings | 0b10000000 if options[:bit_order] == :msbfirst
+
+        uint8 = pack(:uint8, [settings, options[:read], options[:write].length])
+        uint8 + pack(:uint32, options[:frequency])
       end
 
-      # Listener can store up to 8 bytes to get written each time, read up to 256.
-      def spi_write(pin, mode, frequency, bytes)
-        settings = spi_settings(mode, frequency)
-        bytes = pack(:uint8, bytes)
+      # CMD = 26
+      def spi_transfer(pin, options={})
+        options[:read] ||= 0
+        if options[:write]
+          options[:write] = [options[:write]].flatten
+        else
+          options[:write] = []
+        end
+
+        return if (options[:read] == 0) && (options[:write].empty?)
+
+        header = spi_header(options)
         write Message.encode command: 26,
                              pin: pin,
-                             value: bytes.length,
-                             aux_message: settings + bytes
+                             aux_message: header + pack(:uint8, options[:write])
       end
 
-      def spi_read(pin, mode, frequency, num_bytes)
-        write Message.encode command: 27,
-                             pin: pin,
-                             value: num_bytes,
-                             aux_message: spi_settings(mode, frequency)
-      end
+      # CMD = 27
+      def spi_listen(pin, options={})
+        raise ArgumentError,
+              'no SPI bytes to read' unless (options[:read] > 0)
+        options[:write] = []
 
-      def spi_listen(pin, mode, frequency, num_bytes)
-        write Message.encode command: 28,
+        header = spi_header(options)
+        write Message.encode command: 27,
                              pin: pin,
-                             value: num_bytes,
-                             aux_message: spi_settings(mode, frequency)
+                             aux_message: header
       end
 
+      # CMD = 28
       def spi_stop(pin)
-        write Message.encode command: 29, pin: pin
+        write Message.encode command: 28, pin: pin
       end
     end
   end
diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index 58e22496..bd92a8c2 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -91,7 +91,7 @@ def digital_read(pin)
           read unless any_listening
         end
 
-        def digital_listen(pin)
+        def digital_listen(pin, divider)
           listen unless any_listening
           @listening_pins[pin] = true
         end
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index fa4836e5..3bcfc41b 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -23,11 +23,11 @@ def after_initialize(options={})
         end
 
         def read
-          board.spi_read(pin, spi_mode, frequency, @bytes)
+          board.spi_transfer(pin, mode: spi_mode, frequency: frequency, read: @bytes)
         end
 
         def listen
-          board.spi_listen(pin, spi_mode, frequency, @bytes)
+          board.spi_listen(pin, mode: spi_mode, frequency: frequency, read: @bytes)
         end
 
         def stop
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index 292776d0..727c7a58 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -23,7 +23,7 @@ def after_initialize(options={})
         end
 
         def write(*bytes)
-          board.spi_write(pin, spi_mode, frequency, bytes.flatten)
+          board.spi_transfer(pin, mode: spi_mode, frequency: frequency, write: bytes.flatten)
         end
       end
     end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 13bc8915..4bd9c0e5 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -150,10 +150,9 @@ void Dino::process() {
 
     // Implemented in DinoSPI.cpp
     #ifdef DINO_SPI
-    case 26: spiWrite         (pin, val, auxMsg[0], (uint32_t)auxMsg[1], &auxMsg[5]); break;
-    case 27: spiRead          (pin, val, auxMsg[0], (uint32_t)auxMsg[1]            ); break;
-    case 28: addSpiListener   (pin, val, auxMsg[0], (uint32_t)auxMsg[1]);             break;
-    case 29: removeSpiListener();                                                     break;
+    case 26: spiTransfer      (pin, auxMsg[0], auxMsg[1], auxMsg[2], (uint32_t)auxMsg[3], &auxMsg[7]); break;
+    case 27: addSpiListener   (pin, auxMsg[0], auxMsg[1], 0,         (uint32_t)auxMsg[3]);             break;
+    case 28: removeSpiListener();                                                                      break;
     #endif
 
     // Implemented in DinoI2C.cpp
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 469e34de..8361243e 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -86,12 +86,11 @@ class Dino {
     void clearShiftListeners   ();
 
     // SPI
-    void spiBegin              (byte spiMode, uint32_t clockRate);
+    void spiBegin              (byte settings, uint32_t clockRate);
     void spiEnd                ();
-    void spiWrite              (int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data);     //cmd = 26
-    void spiRead               (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 27
-    void addSpiListener        (int selectPin, int len, byte spiMode, uint32_t clockRate);                 //cmd = 28
-    void removeSpiListener     ();                                                                         //cmd = 29
+    void spiTransfer           (int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate, byte *data);  //cmd = 26
+    void addSpiListener        (int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate);              //cmd = 27
+    void removeSpiListener     ();                                                                                          //cmd = 28
     void updateSpiListeners    ();
     void clearSpiListeners     ();
 
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index a5669ac2..877df7bb 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -10,8 +10,8 @@
 #define SPI_LISTENER_COUNT 4
 struct SpiListener{
   byte     selectPin;
+  byte     settings;
   byte     len;
-  byte     spiMode;
   uint32_t clockRate;
   boolean  enabled;
 };
@@ -19,15 +19,20 @@ SpiListener spiListeners[SPI_LISTENER_COUNT];
 
 
 // Convenience wrapper for SPI.begin
-void Dino::spiBegin(byte spiMode, uint32_t clockRate){
+void Dino::spiBegin(byte settings, uint32_t clockRate){
   SPI.begin();
-  // Should make LSB/MSB optional.
-  switch(spiMode) {
-    case 0:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE0)); break;
-    case 1:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE1)); break;
-    case 2:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE2)); break;
-    case 3:  SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE3)); break;
+
+  byte bitOrder;
+  if bitRead(settings, 7) {
+    bitOrder = MSBFIRST;
+  } else {
+    bitOrder = LSBFIRST;
   }
+
+  byte mode = settings;
+  bitClear(mode, 7);
+
+  SPI.beginTransaction(SPISettings(clockRate, bitOrder, mode));
 }
 
 
@@ -43,52 +48,43 @@ void Dino::spiEnd(){
 
 
 //
-// Request format for single direction SPI API functions.
+// Request format for SPI 2-way transfers
 // pin         = slave select pin (int)
-// val         = length (int)
-// auxMsg[0]   = SPI mode (byte)
-// auxMsg[1-4] = clock frequency (uint32_t as 4 bytes)
-// auxMsg[5]+  = data (bytes) (write func only)
+// val         = empty
+// auxMsg[0]   = SPI settings. 2 LSB = SPI mode. Bit 7 = MSB(1) / LSB(0).
+// auxMsg[1]   = write length (number of bytes)
+// auxMsg[2]   = read length  (number of bytes)
+// auxMsg[3-6] = clock frequency (uint32_t as 4 bytes)
+//
+// auxMsg[7]+  = data (bytes) (write only)
 //
 // CMD = 26
 // Write to an SPI device.
-void Dino::spiWrite(int selectPin, int len, byte spiMode, uint32_t clockRate, byte *data) {
-  spiBegin(spiMode, clockRate);
+void Dino::spiTransfer(int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate, byte *data) {
 
-  // Select the device.
+  spiBegin(settings, clockRate);
   digitalWrite(selectPin, LOW);
 
-  // Write one byte at a time.
-  for (uint8_t i = 0;  i < len;  i++) {
-    SPI.transfer(data[i]);
+  if (rLength > 0) {
+    // Stream read bytes as if coming from select pin for easy identification.
+    stream->print(selectPin);
+    stream->print(':');
   }
-  spiEnd();
 
-  // Leave select high.
-  digitalWrite(selectPin, HIGH);
-}
-
-
-// CMD = 27
-// Read from an SPI device.
-void Dino::spiRead(int selectPin, int len, byte spiMode, uint32_t clockRate) {
-  spiBegin(spiMode, clockRate);
+  for (byte i = 0;  (i < rLength || i < wLength);  i++) {
+    byte b;
 
-  // Select the device.
-  digitalWrite(selectPin, LOW);
-
-  // Send data as if coming from the slave select pin so it's easy to identify.
-  // Start with just pin number and : for now.
-  stream->print(selectPin);
-  stream->print(':');
-
-  for (int i = 1;  i <= len;  i++) {
-    // Read a single byte from the register.
-    byte reading = SPI.transfer(0x00);
+    if (i < wLength) {
+      b = SPI.transfer(data[i]);
+    } else {
+      b = SPI.transfer(0x00);
+    }
 
-    // Print it, then a comma or \n if it's the last byte.
-    stream->print(reading);
-    stream->print((i==len) ? '\n' : ',');
+    if (i < rLength) {
+      // Print read byte, then a comma or \n if it's the last read byte.
+      stream->print(b);
+      stream->print((i+1 == rLength) ? '\n' : ',');
+    }
   }
   spiEnd();
 
@@ -96,16 +92,17 @@ void Dino::spiRead(int selectPin, int len, byte spiMode, uint32_t clockRate) {
   digitalWrite(selectPin, HIGH);
 }
 
-// CMD = 28
+
+// CMD = 27
 // Start listening to an SPI register.
 // Overwrite the first disabled listener in the struct array.
-void Dino::addSpiListener(int selectPin, int len, byte spiMode, uint32_t clockRate) {
+void Dino::addSpiListener(int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate) {
   for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
     if (spiListeners[i].enabled == false) {
       spiListeners[i] = {
         selectPin,
-        len,
-        spiMode,
+        settings,
+        rLength,
         clockRate,
         true
       };
@@ -116,7 +113,7 @@ void Dino::addSpiListener(int selectPin, int len, byte spiMode, uint32_t clockRa
   }
 }
 
-// CMD = 29
+// CMD = 28
 // Send a number for a select pin to remove an SPI register listener.
 void Dino::removeSpiListener(){
   for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
@@ -131,10 +128,12 @@ void Dino::removeSpiListener(){
 void Dino::updateSpiListeners(){
   for (int i = 0; i < SPI_LISTENER_COUNT; i++) {
     if (spiListeners[i].enabled) {
-      spiRead(spiListeners[i].selectPin,
-              spiListeners[i].len,
-              spiListeners[i].spiMode,
-              spiListeners[i].clockRate);
+      spiTransfer(spiListeners[i].selectPin,
+                  spiListeners[i].settings,
+                  spiListeners[i].len,
+                  0,
+                  spiListeners[i].clockRate,
+                  {});
     }
   }
 }

From ba1f936dfc684ca30f210818936c015bf219057b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 15 Feb 2018 18:32:51 -0400
Subject: [PATCH 175/296] Minor cleanup of C functionss for shift and SPI
 listen.

---
 src/lib/Dino.cpp      |  8 ++++----
 src/lib/Dino.h        |  4 ++--
 src/lib/DinoSPI.cpp   | 19 ++++++-------------
 src/lib/DinoShift.cpp | 14 +++++++-------
 4 files changed, 19 insertions(+), 26 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 4bd9c0e5..f53e7480 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -144,15 +144,15 @@ void Dino::process() {
     #ifdef DINO_SHIFT
     case 21: shiftWrite          (pin, val, auxMsg[0], auxMsg[1], &auxMsg[3]); break;
     case 22: shiftRead           (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);  break;
-    case 23: addShiftListener    (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);  break;
-    case 24: removeShiftListener ();                                           break;
+    case 23: addShiftListener    ();  break;
+    case 24: removeShiftListener ();  break;
     #endif
 
     // Implemented in DinoSPI.cpp
     #ifdef DINO_SPI
     case 26: spiTransfer      (pin, auxMsg[0], auxMsg[1], auxMsg[2], (uint32_t)auxMsg[3], &auxMsg[7]); break;
-    case 27: addSpiListener   (pin, auxMsg[0], auxMsg[1], 0,         (uint32_t)auxMsg[3]);             break;
-    case 28: removeSpiListener();                                                                      break;
+    case 27: addSpiListener   ();  break;
+    case 28: removeSpiListener();  break;
     #endif
 
     // Implemented in DinoI2C.cpp
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 8361243e..29d965f2 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -80,7 +80,7 @@ class Dino {
     // Shift Registers
     void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte *data);          //cmd = 21
     void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 22
-    void addShiftListener      (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 23
+    void addShiftListener      ();                                                                         //cmd = 23
     void removeShiftListener   ();                                                                         //cmd = 24
     void updateShiftListeners  ();
     void clearShiftListeners   ();
@@ -89,7 +89,7 @@ class Dino {
     void spiBegin              (byte settings, uint32_t clockRate);
     void spiEnd                ();
     void spiTransfer           (int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate, byte *data);  //cmd = 26
-    void addSpiListener        (int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate);              //cmd = 27
+    void addSpiListener        ();                                                                                          //cmd = 27
     void removeSpiListener     ();                                                                                          //cmd = 28
     void updateSpiListeners    ();
     void clearSpiListeners     ();
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 877df7bb..fe62aa0b 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -17,7 +17,6 @@ struct SpiListener{
 };
 SpiListener spiListeners[SPI_LISTENER_COUNT];
 
-
 // Convenience wrapper for SPI.begin
 void Dino::spiBegin(byte settings, uint32_t clockRate){
   SPI.begin();
@@ -35,7 +34,6 @@ void Dino::spiBegin(byte settings, uint32_t clockRate){
   SPI.beginTransaction(SPISettings(clockRate, bitOrder, mode));
 }
 
-
 // Convenience wrapper for SPI.end
 void Dino::spiEnd(){
   SPI.endTransaction();
@@ -46,7 +44,6 @@ void Dino::spiEnd(){
   #endif
 }
 
-
 //
 // Request format for SPI 2-way transfers
 // pin         = slave select pin (int)
@@ -92,18 +89,17 @@ void Dino::spiTransfer(int selectPin, byte settings, byte rLength, byte wLength,
   digitalWrite(selectPin, HIGH);
 }
 
-
 // CMD = 27
 // Start listening to an SPI register.
-// Overwrite the first disabled listener in the struct array.
-void Dino::addSpiListener(int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate) {
+void Dino::addSpiListener() {
   for (int i = 0;  i < SPI_LISTENER_COUNT;  i++) {
+    // Overwrite the first disabled listener in the struct array.
     if (spiListeners[i].enabled == false) {
       spiListeners[i] = {
-        selectPin,
-        settings,
-        rLength,
-        clockRate,
+        pin,
+        auxMsg[0],
+        auxMsg[1],
+        (uint32_t)auxMsg[3],
         true
       };
       return;
@@ -123,7 +119,6 @@ void Dino::removeSpiListener(){
   }
 }
 
-
 // Gets called by Dino::updateListeners to run listeners in the main loop.
 void Dino::updateSpiListeners(){
   for (int i = 0; i < SPI_LISTENER_COUNT; i++) {
@@ -138,10 +133,8 @@ void Dino::updateSpiListeners(){
   }
 }
 
-
 // Gets called by Dino::reset to clear all listeners.
 void Dino::clearSpiListeners(){
   for (int i = 0; i < SPI_LISTENER_COUNT; i++) spiListeners[i].enabled = false;
 }
-
 #endif
diff --git a/src/lib/DinoShift.cpp b/src/lib/DinoShift.cpp
index a3945dc0..1f7d33da 100644
--- a/src/lib/DinoShift.cpp
+++ b/src/lib/DinoShift.cpp
@@ -75,16 +75,16 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
 
 // CMD = 23
 // Start listening to a register using the Arduino shiftIn function.
-// Overwrite the first disabled listener in the struct array.
-void Dino::addShiftListener(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
+void Dino::addShiftListener() {
   for (int i = 0;  i < SHIFT_LISTENER_COUNT;  i++) {
+    // Overwrite the first disabled listener in the struct array.
     if (shiftListeners[i].enabled == false) {
       shiftListeners[i] = {
-        latchPin,
-        len,
-        dataPin,
-        clockPin,
-        clockHighFirst,
+        pin,
+        val,
+        auxMsg[0],
+        auxMsg[1],
+        auxMsg[2],
         true
       };
       return;

From 428e592f1ca6abbd0ddf411f699f5adcbfb4d621 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 16 Feb 2018 10:32:06 -0400
Subject: [PATCH 176/296] Revert I2C to built in Wire library for
 compatibility.

Added Ruby I2C interface.
I2C works on ESP8266 and ARM chips now.
Minor fixes to SPI and package manager for ARM to compile.
Removed external I2C library.
---
 .gitmodules                                   |   3 -
 lib/dino/api.rb                               |   1 +
 lib/dino/api/i2c.rb                           |  28 ++++
 lib/dino/board.rb                             |   1 +
 .../components/one_wire/bus_enumerator.rb     |   7 +-
 lib/dino_cli/generator.rb                     |   2 +-
 lib/dino_cli/packages.rb                      |   4 +-
 lib/dino_cli/targets.rb                       |  12 +-
 src/lib/Dino.cpp                              |   4 +-
 src/lib/Dino.h                                |   3 +-
 src/lib/DinoI2C.cpp                           | 122 +++++++-----------
 src/lib/DinoSPI.cpp                           |  15 +--
 src/vendor/I2C-Master-Library                 |   1 -
 13 files changed, 96 insertions(+), 107 deletions(-)
 create mode 100644 lib/dino/api/i2c.rb
 delete mode 160000 src/vendor/I2C-Master-Library

diff --git a/.gitmodules b/.gitmodules
index bb452163..9ae081fb 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,9 +1,6 @@
 [submodule "src/vendor/Arduino-IRremote"]
 	path = src/vendor/Arduino-IRremote
 	url = https://github.com/z3t0/Arduino-IRremote.git
-[submodule "src/vendor/I2C-Master-Library"]
-	path = src/vendor/I2C-Master-Library
-	url = https://github.com/vickash/I2C-Master-Library.git
 [submodule "src/vendor/arduino-DHT"]
 	path = src/vendor/arduino-DHT
 	url = https://github.com/markruys/arduino-DHT.git
diff --git a/lib/dino/api.rb b/lib/dino/api.rb
index 61fac8ff..8d10255a 100644
--- a/lib/dino/api.rb
+++ b/lib/dino/api.rb
@@ -3,6 +3,7 @@ module API
     require 'dino/api/helper'
     require 'dino/api/core'
     require 'dino/api/dht'
+    require 'dino/api/i2c'
     require 'dino/api/infrared'
     require 'dino/api/one_wire'
     require 'dino/api/servo'
diff --git a/lib/dino/api/i2c.rb b/lib/dino/api/i2c.rb
new file mode 100644
index 00000000..ac1ff66f
--- /dev/null
+++ b/lib/dino/api/i2c.rb
@@ -0,0 +1,28 @@
+module Dino
+  module API
+    module I2C
+      include Helper
+
+      # CMD = 33
+      def i2c_search
+        write Message.encode command: 33
+      end
+
+      # CMD = 34
+      def i2c_write(slave_address, data=[], options={})
+        aux = pack :uint8, [slave_address, data.length, data].flatten
+        write Message.encode command: 34,
+                             value: options[:repeated_start] ? 1 : 0,
+                             aux_message: aux
+      end
+
+      # CMD = 35
+      def i2c_read(slave_address, register_start, num_bytes, options={})
+        aux = pack :uint8, [slave_address, register_start, num_bytes]
+        write Message.encode command: 35,
+                             value: options[:repeated_start] ? 1 : 0,
+                             aux_message: aux
+      end
+    end
+  end
+end
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index d07deaec..a474b4d7 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -1,6 +1,7 @@
 module Dino
   class Board
     include API::Core
+    include API::I2C
     include API::Servo
     include API::ShiftIO
     include API::SPI
diff --git a/lib/dino/components/one_wire/bus_enumerator.rb b/lib/dino/components/one_wire/bus_enumerator.rb
index 2d7eb45a..30ff5560 100644
--- a/lib/dino/components/one_wire/bus_enumerator.rb
+++ b/lib/dino/components/one_wire/bus_enumerator.rb
@@ -2,7 +2,6 @@ module Dino
   module Components
     module OneWire
       class Bus
-        # 1 bits in mask force discrepancies to 1. 0 leaves bit as read from bus.
         def _search(branch_mask)
           reset
           write(SEARCH_ROM)
@@ -24,9 +23,9 @@ def search
             block_until_read
 
             # No unsearched discrepancies left.
-            break if high_discrepancy == - 1
+            break if high_discrepancy == -1
 
-            # Force highest new discrepancy to 1 on the next search.
+            # Force highest new discrepancy to be a 1 on the next search.
             # i.e. Go as deep as possible into each branch found then back out.
             #
             branch_mask = branch_mask | (2 ** high_discrepancy)
@@ -52,8 +51,6 @@ def parse_search_result(result)
           # Gives 0 at every discrepancy we didn't write 1 for on this search.
           new_discrepancies = address ^ complement
 
-          # Newer rubies:
-          # high_discrepancy = new_discrepancies.bit_length - 1
           high_discrepancy = -1
           (0..63).each { |i| high_discrepancy = i if new_discrepancies[i] == 0 }
 
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index d2004536..0a3b1ba8 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -111,7 +111,7 @@ def write
     @packages.each_key do |k|
       # Check if the package should be included for this target.
       package = @packages[k]
-      targeted = !package[:target] || package[:target].include?(options[:target])
+      targeted = !package[:only] || package[:only].include?(options[:target])
       excluded = package[:exclude] && package[:exclude].include?(options[:target])
 
       # Append source file basename to the output dir to get output file path.
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index fc486460..96d39de8 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -81,7 +81,7 @@ class DinoCLI::Generator
   ir_out_esp8266: {
     description: "Transmit infrared signals with the ESP8266",
     directive: "DINO_IR_OUT",
-    target: [:esp8266],
+    only: [:esp8266],
     files: [
       "lib/DinoIROut.cpp",
       "vendor/IRremoteESP8266/src/IRremoteESP8266.h",
@@ -103,8 +103,6 @@ class DinoCLI::Generator
     directive: "DINO_I2C",
     files: [
       "lib/DinoI2C.cpp",
-      "vendor/I2C-Master-Library/I2C.h",
-      "vendor/I2C-Master-Library/I2C.cpp",
     ]
   }
 }
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 65f4e167..043a2bd0 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -1,7 +1,11 @@
 class DinoCLI::Generator
+  STANDARD_PACKAGES = PACKAGES.each_key.map do |package|
+                        package unless PACKAGES[package][:only]
+                      end.compact
+
   TARGETS = {
-    # Default target always includes all packages.
-    mega: PACKAGES.each_key.to_a,
+    # Default target includes all standard package.
+    mega: STANDARD_PACKAGES,
 
     # Core is core.
     core: [:core],
@@ -10,9 +14,9 @@ class DinoCLI::Generator
     mega168: [:core, :servo, :dht, :one_wire, :ir_out, :tone, :spi, :i2c],
 
     # ARM includes everytyhing except specific incompatibilities.
-    arm: PACKAGES.each_key.to_a - [:serial, :tone, :ir_out, :i2c],
+    arm: STANDARD_PACKAGES - [:serial, :tone, :ir_out],
 
     # A surprising amount "just works" on the ESP, notably not LCD.
-    esp8266: PACKAGES.each_key.to_a - [:lcd, :serial, :ir_out, :i2c] + [:ir_out_esp8266],
+    esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp8266],
   }
 end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index f53e7480..7cd17cbc 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -157,9 +157,7 @@ void Dino::process() {
 
     // Implemented in DinoI2C.cpp
     #ifdef DINO_I2C
-    case 31: i2cBegin            ();  break;
-    case 32: i2cEnd              ();  break;
-    case 33: i2cScan             ();  break;
+    case 33: i2cSearch           ();  break;
     case 34: i2cWrite            ();  break;
     case 35: i2cRead             ();  break;
     #endif
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 29d965f2..a6c6e9bf 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -96,8 +96,7 @@ class Dino {
 
     // I2C
     void i2cBegin              (); //cmd = 31
-    void i2cEnd                (); //cmd = 32
-    void i2cScan               (); //cmd = 33
+    void i2cSearch             (); //cmd = 33
     void i2cWrite              (); //cmd = 34
     void i2cRead               (); //cmd = 35
 
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
index 6052deba..8a475a8e 100644
--- a/src/lib/DinoI2C.cpp
+++ b/src/lib/DinoI2C.cpp
@@ -4,112 +4,82 @@
 #include "Dino.h"
 #ifdef DINO_I2C
 
-#include "I2C.h"
+#include <Wire.h>
 
+bool i2cStarted = false;
 
-// CMD = 31
-// Start I2C communication.
+// Only start the Wire class if not already started.
+// Lazy initialization in case user wants to use I2C pins for something else.
 void Dino::i2cBegin() {
-  I2c.begin();
-  // I2c.setSpeed(??);
-  // I2c.pullup(??);
-  // I2c.timeOut(??);
-
-  // This format could be better.
-  stream->print(SDA);   stream->print(':');
-  stream->print("I2C"); stream->print(':');
-  stream->print('1');   stream->print('\n');
-}
-
-
-// CMD = 32
-// Stop I2C communication.
-void Dino::i2cEnd() {
-  I2c.end();
-
-  // This format could be better.
-  stream->print(SDA);   stream->print(':');
-  stream->print("I2C"); stream->print(':');
-  stream->print('0');   stream->print('\n');
+  if (!i2cStarted) {
+    Wire.begin();
+    i2cStarted = true;
+  }
 }
 
-
 // CMD = 33
-// Scan for I2C devices.
-//
-// WARNING: This takes a long time! Try to record the device addresses
-// results and put them into your code.
-//
-// Returns each found address as if a separate reading from SDA pin, eg. "18:104".
-// Returns 128 as if read from SDA pin for search complete, eg. "18:128".
-// Returns 255 as if read from SDA pin for I2C errors, eg. "18:255".
-//
-void Dino::i2cScan() {
-  uint8_t address = 0;
-  while (address < 128) {
-    // Scan for the next device.
-    address = I2c.scanOne(address);
-
-    // Write whatever we get including address space end or errors.
-    stream->print(SDA);     stream->print(':');
-    stream->print(address); stream->print('\n');
-
-    // Increment address before scanning again.
-    address++;
+// Ask each address for a single byte to see if it exists on the bus.
+void Dino::i2cSearch() {
+  stream->print(SDA);
+
+  i2cBegin();
+  for (byte i = 0x08; i < 0x78;  i++) {
+    Wire.requestFrom(i, 1);
+    if (Wire.available()){
+      stream->print(':'); stream->print(i);
+      while(Wire.available()) Wire.read();
+    }
   }
-}
 
+  stream->print('\n');
+}
 
 // CMD = 34
-// Write to an I2C device.
-// All parameters need to be sent in binary in the auxMsg.
+// Write to an I2C device. All params as binary in auxMsg.
 //
+// val        = repeated starts?
 // auxMsg[0]  = device address
-// auxMsg[1]  = register start address
-// auxMsg[2]  = number of bytes
-// auxMsg[3]+ = data
+// auxMsg[1]  = number of bytes
+// auxMsg[2]+ = data
 //
-// Limited to 255 bytes. Validate on remote end.
+// Max 256 bytes. Validate remotely.
 //
 void Dino::i2cWrite() {
-  I2c.write(auxMsg[0], auxMsg[1], &auxMsg[3], auxMsg[2]);
+  i2cBegin();
+  Wire.beginTransmission(auxMsg[0]);
+  Wire.write(&auxMsg[2], auxMsg[1]);
+  Wire.endTransmission(val);
 }
 
-
 // CMD = 35
-// Read from an I2C device.
-// All params need to be sent in binary in the auxMsg.
+// Read from an I2C device. All params as binary in auxMsg.
 //
+// val        = repeated starts?
 // auxMsg[0]  = device address
-// auxMsg[1]  = register start address
+// auxMsg[1]  = start register address
 // auxMsg[2]  = number of bytes
 //
-// Streams data back in comma delimited ASCII decimal for now,
-// matching shiftRead and readSPI. Limited to 32 bytes by I2C library buffer.
-// Validate on remote end.
+// Max 32 bytes, limited by Wire library buffer. Validate remotely.
 //
 void Dino::i2cRead() {
-  // Force length to be min 1, max 32.
   if (auxMsg[2] > 32) auxMsg[2] = 32;
-  if (auxMsg[2] == 0) auxMsg[2] =  1;
-
-  // Read all the bytes into the library buffer.
-  I2c.read(auxMsg[0], auxMsg[1], auxMsg[2]);
 
-  // Send back the SDA pin, the device address, and start register address first.
-  stream->print(SDA);       stream->print(':');
-  stream->print(auxMsg[0]); stream->print(':');
-  stream->print(auxMsg[1]); stream->print(':');
+  i2cBegin();
+  Wire.beginTransmission(auxMsg[0]);
+  Wire.write(auxMsg[1]);
+  Wire.endTransmission(val); // Add repeated start option here.
+  Wire.requestFrom(auxMsg[0], auxMsg[2], val);
 
-  // Send back the data bytes.
+  // Send data as if coming from SDA pin. Implement a bus lock remotely.
+  // Fail silently if no bytes read / invalid device address.
+  if(Wire.available()){
+    stream->print(SDA); stream->print(':');
+  }
   uint8_t currentByte = 0;
-  while(I2c.available()){
+  while(Wire.available()){
     currentByte++;
-
-    // Get a byte from the I2C buffer, print it, then comma or \n if last byte.
-    stream->print(I2c.receive());
+    stream->print(Wire.read());
     stream->print((currentByte == auxMsg[2]) ? '\n' : ',');
   }
 }
-
 #endif
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index fe62aa0b..2a2292a4 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -21,17 +21,15 @@ SpiListener spiListeners[SPI_LISTENER_COUNT];
 void Dino::spiBegin(byte settings, uint32_t clockRate){
   SPI.begin();
 
-  byte bitOrder;
-  if bitRead(settings, 7) {
-    bitOrder = MSBFIRST;
-  } else {
-    bitOrder = LSBFIRST;
-  }
-
+  bool msbfirst = bitRead(settings, 7);
   byte mode = settings;
   bitClear(mode, 7);
 
-  SPI.beginTransaction(SPISettings(clockRate, bitOrder, mode));
+  if (msbfirst) {
+    SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, mode));
+  } else {
+    SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, mode));
+  }
 }
 
 // Convenience wrapper for SPI.end
@@ -58,7 +56,6 @@ void Dino::spiEnd(){
 // CMD = 26
 // Write to an SPI device.
 void Dino::spiTransfer(int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate, byte *data) {
-
   spiBegin(settings, clockRate);
   digitalWrite(selectPin, LOW);
 
diff --git a/src/vendor/I2C-Master-Library b/src/vendor/I2C-Master-Library
deleted file mode 160000
index 32d3fd72..00000000
--- a/src/vendor/I2C-Master-Library
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 32d3fd7253e6b39d7674b843435fb9e4160a1619

From a755926d9965aaae4be46a8906f94e6cc1d7ab49 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 11:14:48 -0400
Subject: [PATCH 177/296] Reader#read_using(method, &block). Other minor fixes.

Call arbitrary methods/procs to send commands to the board, then block until  a value is read, pre-filtered and returned, just like #read.
---
 lib/dino/api/core.rb                          |  4 +-
 lib/dino/api/i2c.rb                           | 14 ++++--
 lib/dino/components/mixins.rb                 |  3 +-
 lib/dino/components/mixins/board_proxy.rb     |  2 +-
 lib/dino/components/mixins/bus_master.rb      | 26 ++++++++++
 lib/dino/components/mixins/bus_slave.rb       | 33 +++++++++++++
 lib/dino/components/mixins/callbacks.rb       | 29 +++--------
 lib/dino/components/mixins/poller.rb          |  6 ++-
 lib/dino/components/mixins/reader.rb          |  9 +++-
 lib/dino/components/one_wire/bus.rb           | 48 ++++++++++---------
 .../components/one_wire/bus_enumerator.rb     | 19 +++-----
 lib/dino/components/one_wire/ds18b20.rb       |  5 +-
 lib/dino/components/one_wire/slave.rb         | 35 ++------------
 lib/dino/components/register/shift_in.rb      |  1 -
 .../components/one_wire/enumerator_spec.rb    |  2 +-
 src/lib/DinoI2C.cpp                           | 18 ++++---
 src/lib/DinoOneWire.cpp                       |  2 +-
 17 files changed, 143 insertions(+), 113 deletions(-)
 create mode 100644 lib/dino/components/mixins/bus_master.rb
 create mode 100644 lib/dino/components/mixins/bus_slave.rb

diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index 8ef13a32..146e6fef 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -50,11 +50,9 @@ def set_listener(pin, state=:off, options={})
           raise "Listener divider must be in #{DIVIDERS.inspect}"
         end
 
-        # Create a bit mask for the settings we want to use. Gets sent in value.
-        mask = 0
+        mask  = Math.log2(divider).to_i
         mask |= 0b10000000 if (state == :on)
         mask |= 0b01000000 if (mode == :analog)
-        mask |= Math.log2(divider).to_i
 
         write Message.encode(command: 7, pin: convert_pin(pin), value: mask)
       end
diff --git a/lib/dino/api/i2c.rb b/lib/dino/api/i2c.rb
index ac1ff66f..6815b157 100644
--- a/lib/dino/api/i2c.rb
+++ b/lib/dino/api/i2c.rb
@@ -9,18 +9,22 @@ def i2c_search
       end
 
       # CMD = 34
-      def i2c_write(slave_address, data=[], options={})
-        aux = pack :uint8, [slave_address, data.length, data].flatten
+      def i2c_write(address, bytes=[], options={})
+        aux = pack :uint8, [address, bytes.length, bytes].flatten
         write Message.encode command: 34,
                              value: options[:repeated_start] ? 1 : 0,
                              aux_message: aux
       end
 
       # CMD = 35
-      def i2c_read(slave_address, register_start, num_bytes, options={})
-        aux = pack :uint8, [slave_address, register_start, num_bytes]
+      def i2c_read(address, register, num_bytes, options={})
+        aux = pack :uint8, [address, register, num_bytes]
+
+        settings = options[:repeated_start] ? 1 : 0
+        settings = settings | 0b10 unless register
+
         write Message.encode command: 35,
-                             value: options[:repeated_start] ? 1 : 0,
+                             value: settings,
                              aux_message: aux
       end
     end
diff --git a/lib/dino/components/mixins.rb b/lib/dino/components/mixins.rb
index 9dfe8b26..7e8cfe53 100644
--- a/lib/dino/components/mixins.rb
+++ b/lib/dino/components/mixins.rb
@@ -6,7 +6,8 @@ module Mixins
       require 'dino/components/mixins/reader'
       require 'dino/components/mixins/poller'
       require 'dino/components/mixins/listener'
-      require 'dino/components/mixins/bus'
+      require 'dino/components/mixins/bus_master'
+      require 'dino/components/mixins/bus_slave'
       require 'dino/components/mixins/board_proxy'
     end
   end
diff --git a/lib/dino/components/mixins/board_proxy.rb b/lib/dino/components/mixins/board_proxy.rb
index 5b79590d..b18b6ab0 100644
--- a/lib/dino/components/mixins/board_proxy.rb
+++ b/lib/dino/components/mixins/board_proxy.rb
@@ -2,7 +2,7 @@ module Dino
   module Components
     module Mixins
       module BoardProxy
-        include Bus
+        include BusMaster
 
         def after_initialize(options={})
           super(options)
diff --git a/lib/dino/components/mixins/bus_master.rb b/lib/dino/components/mixins/bus_master.rb
new file mode 100644
index 00000000..a94514bc
--- /dev/null
+++ b/lib/dino/components/mixins/bus_master.rb
@@ -0,0 +1,26 @@
+module Dino
+  module Components
+    module Mixins
+      module BusMaster
+        attr_reader :mutex
+
+        def after_initialize(options={})
+          super(options)
+          @components = []
+          @mutex = Mutex.new
+        end
+
+        # Essential part of board interface that components need.
+        attr_reader :components
+
+        def add_component(component)
+          @components << component
+        end
+
+        def remove_component(component)
+          @components.delete(component)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/mixins/bus_slave.rb b/lib/dino/components/mixins/bus_slave.rb
new file mode 100644
index 00000000..2cc5fc7c
--- /dev/null
+++ b/lib/dino/components/mixins/bus_slave.rb
@@ -0,0 +1,33 @@
+module Dino
+  module Components
+    module Mixins
+      module BusSlave
+        include Setup::Base
+
+        attr_reader :address
+        alias  :bus :board
+
+        def initialize(options={})
+          options[:board] ||= options[:bus]
+          super(options)
+        end
+
+        def after_initialize(options={})
+          super(options)
+
+          unless options[:address]
+            raise ArgumentError,
+                  'missing Slave device address; try Bus#search first'
+          end
+          @address = options[:address]
+        end
+
+        def atomically(&block)
+          bus.mutex.synchronize do
+            block.call
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 1893bb93..cfcbf51f 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -9,16 +9,16 @@ def after_initialize(options={})
         end
 
         def add_callback(key=:persistent, &block)
-          @callback_mutex.synchronize {
+          @callback_mutex.synchronize do
             @callbacks[key] ||= []
             @callbacks[key] << block
-          }
+          end
         end
 
         def remove_callback(key=nil)
-          @callback_mutex.synchronize {
+          @callback_mutex.synchronize do
             key ? @callbacks.delete(key) : @callbacks = {}
-          }
+          end
         end
 
         alias :on_data :add_callback
@@ -36,28 +36,13 @@ def update(data)
           update_self(data)
         end
 
-        #
-        # Values received by #update are usually idempotent, i.e. the new state
-        # of the component, and can pass to callbacks as-is. But some components
-        # input a state change instead. Eg. rotary encoders with +1 or -1 steps.
-        #
-        # To maintain the pattern of callbacks receiving new state, while leaving
-        # old state in the instance variable for comparison, we may want to
-        # calculate the new state from a change input, and pass that instead.
-        # Override this method to do so. See RotaryEncoder class for an example.
-        #
+        # Override this to process data before passing to callbacks.
         def pre_callback_filter(data)
           data
         end
 
-        #
-        # Assign data to @state automatically after callbacks by default.
-        #
-        # Override this to add behavior not matching this pattern, such as
-        # components where data cannot be directly assigned to @state.
-        # Eg. data is a hash, and value from a specific key reflects @state.
-        # See RotaryEncoder class for an example.
-        #
+        # Set @state to the value passed to callbacks after running them all.
+        # Override if some other behavior is needed.
         def update_self(data)
           @state = data
         end
diff --git a/lib/dino/components/mixins/poller.rb b/lib/dino/components/mixins/poller.rb
index c90e622b..3af630aa 100644
--- a/lib/dino/components/mixins/poller.rb
+++ b/lib/dino/components/mixins/poller.rb
@@ -5,11 +5,13 @@ module Poller
         include Reader
         include Threaded
 
-        def poll(interval=1, *args, &block)
+        def poll(interval=1, &block)
           stop
           add_callback(:poll, &block) if block_given?
+
           threaded_loop do
-            _read(*args); sleep interval
+            _read
+            sleep interval
           end
         end
 
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index 8749258c..ef332c9e 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -4,18 +4,23 @@ module Mixins
       module Reader
         include Callbacks
 
-        def read(*args, &block)
+        def read_using(method, &block)
           add_callback(:read, &block) if block_given?
 
+          # Block and catches read value for return, AFTER the pre-filter.
           value = nil
           add_callback(:read) { |data| value = data }
 
-          _read(*args)
+          method.call
           block_until_read
 
           value
         end
 
+        def read(&block)
+          read_using(self.method(:_read), &block)
+        end
+
         def block_until_read
           loop { break if !@callbacks[:read] }
         end
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index 8ae0eef1..75ed0947 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -3,7 +3,7 @@ module Components
     module OneWire
       class Bus
         include Setup::SinglePin
-        include Mixins::Bus
+        include Mixins::BusMaster
         include Mixins::Reader
 
         attr_reader :found_devices, :parasite_power
@@ -14,38 +14,40 @@ def after_initialize(options = {})
           read_power_supply
         end
 
-        # Without driving low first, results are inconsistent.
-        # Only first (LS) bit matters, but we can only read whole bytes.
-        #
         def read_power_supply
-          board.set_pin_mode(self.pin, :out)
-          board.digital_write(self.pin, board.low)
-          sleep 0.1
-
-          reset
-          write(SKIP_ROM, READ_POWER_SUPPLY)
-          byte = read(1)
-
-          @parasite_power = (byte.to_i[0] == 0) ? true : false
+          mutex.synchronize do
+            # Without driving low first, results are inconsistent.
+            board.set_pin_mode(self.pin, :out)
+            board.digital_write(self.pin, board.low)
+            sleep 0.1
+
+            reset
+            write(SKIP_ROM, READ_POWER_SUPPLY)
+
+            # Only LSBIT matters, but we can only read whole bytes.
+            byte = read(1)
+            @parasite_power = (byte[0] == 0) ? true : false
+          end
         end
 
-        def reset
-          board.one_wire_reset(pin)
+        def pre_callback_filter(bytes)
+          bytes = bytes.split(",").map(&:to_i)
+          bytes.length > 1 ? bytes : bytes[0]
         end
 
         def device_present
-          present = false
-          self.add_callback(:read) do |result|
-            present = (result.to_i == 0) ? true : false
+          mutex.synchronize do
+            byte = read_using -> { reset(1) }
+            (byte == 0) ? true : false
           end
+        end
 
-          board.one_wire_reset(pin, 1)
-          block_until_read
-          present
+        def reset(get_presence=0)
+          board.one_wire_reset(pin, get_presence)
         end
 
-        def _read(num_bytes)
-          board.one_wire_read(pin, num_bytes)
+        def read(num_bytes)
+          read_using -> { board.one_wire_read(pin, num_bytes) }
         end
 
         def write(*bytes)
diff --git a/lib/dino/components/one_wire/bus_enumerator.rb b/lib/dino/components/one_wire/bus_enumerator.rb
index 30ff5560..92515bc5 100644
--- a/lib/dino/components/one_wire/bus_enumerator.rb
+++ b/lib/dino/components/one_wire/bus_enumerator.rb
@@ -14,14 +14,11 @@ def search
           high_discrepancy = 0
 
           loop do
-            self.add_callback(:read) do |result|
+            read_using -> { _search(branch_mask) } do |result|
               device, high_discrepancy = parse_search_result(result)
               @found_devices << device
             end
 
-            _search(branch_mask)
-            block_until_read
-
             # No unsearched discrepancies left.
             break if high_discrepancy == -1
 
@@ -60,18 +57,14 @@ def parse_search_result(result)
           [{class: klass, address: address}, high_discrepancy]
         end
 
-        # Search result is a comma separated list of 8 byte-pairs. Each pair is
-        # formatted "addressByte-compByte". Pairs are ordered LS byte first.
-        #
-        def split_search_result(str)
-          byte_pairs = str.split(",")
+        # Result is 16 bytes, 8 byte address and complement interleaved LSByte first.
+        def split_search_result(data)
           address = 0
           complement = 0
 
-          byte_pairs.reverse.each do |pair|
-            address_byte, complement_byte = pair.split("-").map(&:to_i)
-            address = (address << 8) | address_byte
-            complement = (complement << 8) | complement_byte
+          data.reverse.each_slice(2) do |comp_byte, addr_byte|
+            address = (address << 8) | addr_byte
+            complement = (complement << 8) | comp_byte
           end
 
           [address, complement]
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index cedac9d0..bcd1c35e 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -44,7 +44,10 @@ def convert
 
         def _read
           convert
-          read_scratch(9) { |data| self.update(data) }
+          data = read_scratch(9)
+
+          self.update(data)
+          pre_callback_filter(data)
         end
 
         def pre_callback_filter(bytes)
diff --git a/lib/dino/components/one_wire/slave.rb b/lib/dino/components/one_wire/slave.rb
index bceef808..fbac3c06 100644
--- a/lib/dino/components/one_wire/slave.rb
+++ b/lib/dino/components/one_wire/slave.rb
@@ -2,38 +2,17 @@ module Dino
   module Components
     module OneWire
       class Slave
-        include Setup::Base
+        include Mixins::BusSlave
         include Mixins::Poller
+
         attr_reader :address
         alias  :bus :board
 
-        def initialize(options={})
-          options[:board] ||= options[:bus]
-          super(options)
-        end
-
-        def after_initialize(options={})
-          super(options)
-
-          unless options[:address]
-            raise ArgumentError,
-                  'missing 1-Wire slave ROM address; try Bus#search first'
-          end
-          @address = options[:address]
-        end
-
-        def read_scratch(num_bytes, &block)
+        def read_scratch(num_bytes)
           atomically do
-            # Bubble bus callback while still in the lock.
-            if block_given?
-              bus.add_callback(:read) do |data|
-                block.call data.split(",").map(&:to_i)
-              end
-            end
-
             match
             bus.write(READ_SCRATCH)
-            bus.read(num_bytes).split(",").map(&:to_i)
+            bus.read(num_bytes)
           end
         end
 
@@ -54,12 +33,6 @@ def copy_scratch
           end
         end
 
-        def atomically(&block)
-          bus.mutex.synchronize do
-            block.call
-          end
-        end
-
         def match
           bus.reset
           if bus.found_devices.count < 2
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 226106ab..deec557d 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -44,7 +44,6 @@ def read(num_bytes=@bytes)
                            preclock_high: rising_clock
         end
 
-        # Untested
         def listen(num_bytes=@bytes)
           board.shift_listen latch.pin, data.pin, clock.pin, num_bytes,
                              preclock_high: rising_clock
diff --git a/spec/lib/components/one_wire/enumerator_spec.rb b/spec/lib/components/one_wire/enumerator_spec.rb
index 14dc675b..2628a1c0 100644
--- a/spec/lib/components/one_wire/enumerator_spec.rb
+++ b/spec/lib/components/one_wire/enumerator_spec.rb
@@ -92,7 +92,7 @@ def search(branch_mask)
               end
             end
 
-            output_string << addr.to_s << "-" << comp.to_s
+            output_string << addr.to_s << "," << comp.to_s
             output_string << "," if (i != 7 ) # No \n. TxRx strips it IRL.
           end
           output_string
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
index 8a475a8e..316f1fc8 100644
--- a/src/lib/DinoI2C.cpp
+++ b/src/lib/DinoI2C.cpp
@@ -63,17 +63,23 @@ void Dino::i2cWrite() {
 //
 void Dino::i2cRead() {
   if (auxMsg[2] > 32) auxMsg[2] = 32;
-
+  byte repeatedStart = bitRead(val, 0);
   i2cBegin();
-  Wire.beginTransmission(auxMsg[0]);
-  Wire.write(auxMsg[1]);
-  Wire.endTransmission(val); // Add repeated start option here.
-  Wire.requestFrom(auxMsg[0], auxMsg[2], val);
 
-  // Send data as if coming from SDA pin. Implement a bus lock remotely.
+  // Bit 1 of val is flag for whether to write register address first or not.
+  if (bitRead(val, 1)) {
+    Wire.beginTransmission(auxMsg[0]);
+    Wire.write(auxMsg[1]);
+    Wire.endTransmission(repeatedStart);
+  }
+
+  Wire.requestFrom(auxMsg[0], auxMsg[2], repeatedStart);
+
+  // Send data as if coming from SDA pin. Prefix with device adddress.
   // Fail silently if no bytes read / invalid device address.
   if(Wire.available()){
     stream->print(SDA); stream->print(':');
+    stream->print(auxMsg[0]); stream->print('-');
   }
   uint8_t currentByte = 0;
   while(Wire.available()){
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
index 70a56aeb..d762b0c6 100644
--- a/src/lib/DinoOneWire.cpp
+++ b/src/lib/DinoOneWire.cpp
@@ -59,7 +59,7 @@ void Dino::owSearch(){
       }
     }
     stream->print(addr);
-    stream->print('-');
+    stream->print(',');
     stream->print(comp);
     stream->print((i == 7) ? '\n' : ',');
   }

From 9bb37f8d01c869e4f2a63f2dc138bb00f073ae22 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 11:16:07 -0400
Subject: [PATCH 178/296] =?UTF-8?q?Missing=20deletion=20from=20last=20comm?=
 =?UTF-8?q?it=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 lib/dino/components/mixins/bus.rb | 30 ------------------------------
 1 file changed, 30 deletions(-)
 delete mode 100644 lib/dino/components/mixins/bus.rb

diff --git a/lib/dino/components/mixins/bus.rb b/lib/dino/components/mixins/bus.rb
deleted file mode 100644
index d597958f..00000000
--- a/lib/dino/components/mixins/bus.rb
+++ /dev/null
@@ -1,30 +0,0 @@
-module Dino
-  module Components
-    module Mixins
-      module Bus
-        #
-        # Behavior mixin for any component that tracks multiple other components
-        # attached to it, matching Board, but without the full Board interface.
-        # See OneWire::Bus class for an example.
-        #
-        attr_reader :mutex
-
-        def after_initialize(options={})
-          super(options)
-          @components = []
-          @mutex = Mutex.new
-        end
-
-        attr_reader :components
-
-        def add_component(component)
-          @components << component
-        end
-
-        def remove_component(component)
-          @components.delete(component)
-        end
-      end
-    end
-  end
-end

From e6ccc348f8e30382760d9ddedab0cf8c2ca144d3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 12:00:55 -0400
Subject: [PATCH 179/296] #read_scratch should take blocks to keep callbacks in
 their thread.

Added Poller#poll_using(method, &block), to match Reader#poll_using.
---
 lib/dino/components/mixins/poller.rb    | 8 ++++++--
 lib/dino/components/one_wire/ds18b20.rb | 5 +----
 lib/dino/components/one_wire/slave.rb   | 3 ++-
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/lib/dino/components/mixins/poller.rb b/lib/dino/components/mixins/poller.rb
index 3af630aa..770ff6f4 100644
--- a/lib/dino/components/mixins/poller.rb
+++ b/lib/dino/components/mixins/poller.rb
@@ -5,16 +5,20 @@ module Poller
         include Reader
         include Threaded
 
-        def poll(interval=1, &block)
+        def poll_using(method, interval=1, &block)
           stop
           add_callback(:poll, &block) if block_given?
 
           threaded_loop do
-            _read
+            method.call
             sleep interval
           end
         end
 
+        def poll(interval=1, &block)
+          poll_using(self.method(:_read), interval, &block)
+        end
+
         def stop
           super if defined?(super)
           stop_thread
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index bcd1c35e..cedac9d0 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -44,10 +44,7 @@ def convert
 
         def _read
           convert
-          data = read_scratch(9)
-
-          self.update(data)
-          pre_callback_filter(data)
+          read_scratch(9) { |data| self.update(data) }
         end
 
         def pre_callback_filter(bytes)
diff --git a/lib/dino/components/one_wire/slave.rb b/lib/dino/components/one_wire/slave.rb
index fbac3c06..370ba1b4 100644
--- a/lib/dino/components/one_wire/slave.rb
+++ b/lib/dino/components/one_wire/slave.rb
@@ -8,8 +8,9 @@ class Slave
         attr_reader :address
         alias  :bus :board
 
-        def read_scratch(num_bytes)
+        def read_scratch(num_bytes, &block)
           atomically do
+            bus.add_callback(:read, &block) if block_given?
             match
             bus.write(READ_SCRATCH)
             bus.read(num_bytes)

From 8b8a5fe7bcba08f55ea6ea2599ae0378a7aa3470 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 13:36:06 -0400
Subject: [PATCH 180/296] I2C bus, slave and DS3231 RTC example.

---
 dino.gemspec                      |  1 +
 examples/i2c/ds3231.rb            | 23 +++++++++++++
 lib/dino/api/i2c.rb               | 10 ++++--
 lib/dino/components.rb            |  2 ++
 lib/dino/components/i2c.rb        |  9 ++++++
 lib/dino/components/i2c/bus.rb    | 54 +++++++++++++++++++++++++++++++
 lib/dino/components/i2c/ds3231.rb | 33 +++++++++++++++++++
 lib/dino/components/i2c/slave.rb  | 22 +++++++++++++
 8 files changed, 151 insertions(+), 3 deletions(-)
 create mode 100644 examples/i2c/ds3231.rb
 create mode 100644 lib/dino/components/i2c.rb
 create mode 100644 lib/dino/components/i2c/bus.rb
 create mode 100644 lib/dino/components/i2c/ds3231.rb
 create mode 100644 lib/dino/components/i2c/slave.rb

diff --git a/dino.gemspec b/dino.gemspec
index 171b28fc..d2f2a53b 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -35,6 +35,7 @@ Gem::Specification.new do |gem|
   gem.executables   = ["dino"]
 
   gem.add_dependency 'rubyserial', '~> 0.5.0'
+  gem.add_dependency 'bcd', '~> 0.3.0'
 
   gem.add_development_dependency 'rake'
   gem.add_development_dependency 'rspec'
diff --git a/examples/i2c/ds3231.rb b/examples/i2c/ds3231.rb
new file mode 100644
index 00000000..7c5a3be8
--- /dev/null
+++ b/examples/i2c/ds3231.rb
@@ -0,0 +1,23 @@
+#
+# Somewhat pointless example to ensure I2C is working. Sets the time on a
+# connected DS3231 real-time-clock and reads it back every 5 seconds.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+
+# For now you need to pass in the SDA pin of the I2C interface Arduino/Wire uses.
+# Most Arduinos: A4
+# Leonardo: 2
+# Due and Mega: 20
+# ESP8266 : 4 (D2 on WeMos/NodeMCU = GPIO 4 on the ESP8266 itself)
+bus = Dino::Components::I2C::Bus.new(board: board, pin: 4)
+rtc = Dino::Components::I2C::DS3231.new(bus: bus, address: 104)
+
+rtc.time = Time.now
+
+loop do
+  puts rtc.time
+  sleep 5
+end
diff --git a/lib/dino/api/i2c.rb b/lib/dino/api/i2c.rb
index 6815b157..17d833ea 100644
--- a/lib/dino/api/i2c.rb
+++ b/lib/dino/api/i2c.rb
@@ -18,11 +18,15 @@ def i2c_write(address, bytes=[], options={})
 
       # CMD = 35
       def i2c_read(address, register, num_bytes, options={})
-        aux = pack :uint8, [address, register, num_bytes]
-
         settings = options[:repeated_start] ? 1 : 0
-        settings = settings | 0b10 unless register
 
+        # Won't write anything if no start register was given.
+        unless register
+          settings = settings | 0b10
+          register = 0
+        end
+
+        aux = pack :uint8, [address, register, num_bytes]
         write Message.encode command: 35,
                              value: settings,
                              aux_message: aux
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 8a58195f..b345a97a 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -4,6 +4,8 @@ module Components
     require 'dino/components/mixins'
     require 'dino/components/basic'
     require 'dino/components/register'
+    require 'dino/components/spi'
+    require 'dino/components/i2c'
     autoload :Led,              'dino/components/led'
     autoload :Button,           'dino/components/button'
     autoload :Sensor,           'dino/components/sensor'
diff --git a/lib/dino/components/i2c.rb b/lib/dino/components/i2c.rb
new file mode 100644
index 00000000..51986738
--- /dev/null
+++ b/lib/dino/components/i2c.rb
@@ -0,0 +1,9 @@
+module Dino
+  module Components
+    module I2C
+      require 'dino/components/i2c/bus'
+      require 'dino/components/i2c/slave'
+      require 'dino/components/i2c/ds3231'
+    end
+  end
+end
diff --git a/lib/dino/components/i2c/bus.rb b/lib/dino/components/i2c/bus.rb
new file mode 100644
index 00000000..06ef013a
--- /dev/null
+++ b/lib/dino/components/i2c/bus.rb
@@ -0,0 +1,54 @@
+module Dino
+  module Components
+    module I2C
+      class Bus
+        include Setup::SinglePin
+        include Mixins::BusMaster
+        include Mixins::Reader
+
+        attr_reader :found_devices
+
+        def after_initialize(options={})
+          super(options)
+          bubble_callbacks
+        end
+
+        def search
+          addresses = read_using -> { board.i2c_search }
+          @found_devices = addresses.split(":").map(&:to_i)
+        end
+
+        def write(address, bytes=[], options={})
+          board.i2c_write(address, bytes, options)
+        end
+
+        def read(*args)
+          read_using -> { _read(*args) }
+        end
+
+        def _read(address, register, num_bytes=1, options={})
+          board.i2c_read(address, register, num_bytes, options)
+        end
+
+        def bubble_callbacks
+          add_callback(:bus_master) do |str|
+            if str.match /d*-/
+              address, data = str.split("-")
+              address = address.to_i
+              data = data.split(",").map(&:to_i)
+              update_component({address: address, data: data})
+            end
+          end
+        end
+
+        def update_component(hash)
+          @components.each do |component|
+            if component.address == hash[:address]
+              component.update(hash[:data])
+            end
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/i2c/ds3231.rb b/lib/dino/components/i2c/ds3231.rb
new file mode 100644
index 00000000..04400448
--- /dev/null
+++ b/lib/dino/components/i2c/ds3231.rb
@@ -0,0 +1,33 @@
+module Dino
+  module Components
+    module I2C
+      class DS3231 < Slave
+        require 'bcd'
+
+        def pre_callback_filter(bytes)
+          t = bytes.map { |b| BCD.encode(b) }
+          Time.new t[6]+ 1970, t[5], t[4], t[2], t[1], t[0]
+        end
+
+        def time
+          # Return of read_bytes is still unfiltered string from the bus...
+          read_using -> { read_bytes(nil, 7) }
+          @state
+        end
+
+        def time=(time)
+          bytes = [ 0,
+                    BCD.decode(time.sec),
+                    BCD.decode(time.min),
+                    BCD.decode(time.hour),
+                    BCD.decode(time.strftime('%u').to_i),
+                    BCD.decode(time.day),
+                    BCD.decode(time.month),
+                    BCD.decode(time.year - 1970) ]
+          write(bytes)
+          time
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/i2c/slave.rb b/lib/dino/components/i2c/slave.rb
new file mode 100644
index 00000000..14cf1e14
--- /dev/null
+++ b/lib/dino/components/i2c/slave.rb
@@ -0,0 +1,22 @@
+module Dino
+  module Components
+    module I2C
+      class Slave
+        include Mixins::BusSlave
+        include Mixins::Poller
+
+        def repeated_start
+          false
+        end
+
+        def write(bytes=[])
+          bus.write(address, bytes, repeated_start: repeated_start)
+        end
+
+        def read_bytes(register, num_bytes=1)
+          bus.read(address, register, num_bytes, repeated_start: repeated_start)
+        end
+      end
+    end
+  end
+end

From bd83e3576f1ccc79f44c9b47199256c5e23271f9 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 15:02:36 -0400
Subject: [PATCH 181/296] Bug fix and test for analog and digital listeners

---
 examples/register/shift_out.rb                 | 12 ++++++++----
 lib/dino/components/basic/analog_input.rb      |  8 ++++----
 lib/dino/components/basic/digital_input.rb     |  6 +++---
 lib/dino/components/i2c/ds3231.rb              |  2 +-
 lib/dino/components/mixins/listener.rb         | 12 +-----------
 lib/dino/components/one_wire/slave.rb          |  4 ++--
 lib/dino/components/setup/input.rb             | 12 ++++++------
 spec/lib/components/basic/analog_input_spec.rb | 10 +++++++++-
 spec/lib/components/mixins/listener_spec.rb    |  6 +++---
 9 files changed, 37 insertions(+), 35 deletions(-)

diff --git a/examples/register/shift_out.rb b/examples/register/shift_out.rb
index eefdd95a..6729d0df 100644
--- a/examples/register/shift_out.rb
+++ b/examples/register/shift_out.rb
@@ -6,13 +6,17 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-shift_register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                           pins: {latch: 9, data: 11, clock: 13}
+register = Dino::Components::Register::ShiftOut.new  board: board,
+                                                     pins: {latch: 9, data: 11, clock: 13}
 
 # Write a single byte
-shift_register.write(255)
+register.write(255)
 
 # Write an array of bytes (for multiple registers).
-shift_register.write([255, 0])
+register.write([255, 0])
+
+# Register can behave as a BoardProxy, with components addressable directly.
+led = Dino::Components::Led.new(board: register, pin: 0)
+led.blink 1
 
 sleep
diff --git a/lib/dino/components/basic/analog_input.rb b/lib/dino/components/basic/analog_input.rb
index 5e3ebb08..ff977c43 100644
--- a/lib/dino/components/basic/analog_input.rb
+++ b/lib/dino/components/basic/analog_input.rb
@@ -7,14 +7,14 @@ class AnalogInput
         include Mixins::Reader
         include Mixins::Poller
         include Mixins::Listener
-        
+
         def _read
-          board.analog_read(self.pin)
+          board.analog_read(pin)
         end
 
         def _listen(divider=16)
-          divider ||= 16
-          board.analog_listen(self.pin, divider)
+          @divider ||= 16
+          board.analog_listen(pin, @divider)
         end
       end
     end
diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index db24b99b..002125fb 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -14,12 +14,12 @@ def after_initialize(options={})
         end
 
         def _read
-          board.digital_read(self.pin)
+          board.digital_read(pin)
         end
 
         def _listen(divider=4)
-          divider ||= 4
-          board.digital_listen(self.pin, divider)
+          @divider ||= 4
+          board.digital_listen(pin, @divider)
         end
 
         def on_high(&block)
diff --git a/lib/dino/components/i2c/ds3231.rb b/lib/dino/components/i2c/ds3231.rb
index 04400448..4185cee4 100644
--- a/lib/dino/components/i2c/ds3231.rb
+++ b/lib/dino/components/i2c/ds3231.rb
@@ -6,7 +6,7 @@ class DS3231 < Slave
 
         def pre_callback_filter(bytes)
           t = bytes.map { |b| BCD.encode(b) }
-          Time.new t[6]+ 1970, t[5], t[4], t[2], t[1], t[0]
+          Time.new t[6] + 1970, t[5], t[4], t[2], t[1], t[0]
         end
 
         def time
diff --git a/lib/dino/components/mixins/listener.rb b/lib/dino/components/mixins/listener.rb
index 88e07835..da450e03 100644
--- a/lib/dino/components/mixins/listener.rb
+++ b/lib/dino/components/mixins/listener.rb
@@ -12,19 +12,9 @@ def listen(divider=nil, &block)
 
         def stop
           super if defined?(super)
-          _stop_listen
+          _stop_listener
           remove_callbacks :listen
         end
-
-        def _listen
-          raise NotImplementedError
-            .new("#{self.class.name}#_listen is not defined.")
-        end
-
-        def _stop_listen
-          raise NotImplementedError
-            .new("#{self.class.name}#_stop_listen is not defined.")
-        end
       end
     end
   end
diff --git a/lib/dino/components/one_wire/slave.rb b/lib/dino/components/one_wire/slave.rb
index 370ba1b4..4df09665 100644
--- a/lib/dino/components/one_wire/slave.rb
+++ b/lib/dino/components/one_wire/slave.rb
@@ -54,8 +54,8 @@ def serial_number
 
         def extract_serial
           # Remove CRC & family code.
-          address = (@address & 0x00FFFFFFFFFFFFFF) >> 8
-          address.to_s(16).rjust(12, "0")
+          serial = (@address & 0x00FFFFFFFFFFFFFF) >> 8
+          serial.to_s(16).rjust(12, "0")
         end
       end
     end
diff --git a/lib/dino/components/setup/input.rb b/lib/dino/components/setup/input.rb
index 1349f438..8362b12a 100644
--- a/lib/dino/components/setup/input.rb
+++ b/lib/dino/components/setup/input.rb
@@ -3,24 +3,24 @@ module Components
     module Setup
       module Input
         include SinglePin
-        attr_reader :pullup
+        attr_reader :pullup, :divider
 
         def pullup=(pullup)
           @pullup = pullup
           board.set_pullup(self.pin, pullup)
         end
 
-        protected
+        def _stop_listener
+          board.stop_listener(pin)
+        end
 
+      protected
+      
         def initialize_pins(options={})
           super(options)
           self.mode = :in
           self.pullup = options[:pullup]
         end
-
-        def _stop_listen
-          board.stop_listener(pin)
-        end
       end
     end
   end
diff --git a/spec/lib/components/basic/analog_input_spec.rb b/spec/lib/components/basic/analog_input_spec.rb
index 69ae26b8..e5c438d6 100644
--- a/spec/lib/components/basic/analog_input_spec.rb
+++ b/spec/lib/components/basic/analog_input_spec.rb
@@ -16,11 +16,19 @@ module Basic
         end
 
         describe '#_listen' do
-          it 'should send #analog_listen to the board with its pin' do
+          it 'should send #analog_listen to the board with its pin and divider' do
             expect(board).to receive(:analog_listen).with(subject.pin, 16)
             subject._listen
           end
         end
+
+
+        describe '#_stop_listener' do
+          it 'should send #stop_listener to the board with its pin' do
+            expect(board).to receive(:stop_listener).with(subject.pin)
+            subject._stop_listener
+          end
+        end
       end
     end
   end
diff --git a/spec/lib/components/mixins/listener_spec.rb b/spec/lib/components/mixins/listener_spec.rb
index fc8e5c5d..bb24b60e 100644
--- a/spec/lib/components/mixins/listener_spec.rb
+++ b/spec/lib/components/mixins/listener_spec.rb
@@ -9,7 +9,7 @@ class ListenComponent
           include Setup::Base
           include Listener
           def _listen(divider=nil); end
-          def _stop_listen; end
+          def _stop_listener; end
           def initialize; after_initialize; end
         end
 
@@ -42,8 +42,8 @@ def initialize; after_initialize; end
         end
 
         describe '#stop' do
-          it 'should call #_stop_listen' do
-            expect(subject).to receive(:_listen)
+          it 'should call #_stop_listener' do
+            expect(subject).to receive(:_stop_listener)
             subject.listen
           end
 

From 75dbc5feb9c0d267d34b7c1144cee4decaed24e0 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 15:18:55 -0400
Subject: [PATCH 182/296] Remove misleading IrReceiver. Just an active low
 digital in.

---
 examples/ir_receiver/ir_receiver.rb | 34 -----------------------------
 lib/dino/components.rb              |  3 +--
 lib/dino/components/ir_receiver.rb  |  7 ------
 3 files changed, 1 insertion(+), 43 deletions(-)
 delete mode 100644 examples/ir_receiver/ir_receiver.rb
 delete mode 100644 lib/dino/components/ir_receiver.rb

diff --git a/examples/ir_receiver/ir_receiver.rb b/examples/ir_receiver/ir_receiver.rb
deleted file mode 100644
index 3111f586..00000000
--- a/examples/ir_receiver/ir_receiver.rb
+++ /dev/null
@@ -1,34 +0,0 @@
-#
-# This is an example of how to use the button class
-# You must register helpers and have the main thread
-# sleep or in someway keep running or your program
-# will exit before any callbacks can be called
-#
-require 'bundler/setup'
-require 'dino'
-
-board = Dino::Board.new(Dino::TxRx::Serial.new)
-ir = Dino::Components::IrReceiver.new(pin: 2, board: board)
-led = Dino::Components::Led.new(pin: 13, board: board)
-
-n = 0
-
-flash = Proc.new do
-  n += 1
-  puts "light flash #{n}"
-end
-
-sleep 2
-Thread.new do
-  loop do
-    led.on
-    sleep 0.01
-    led.off
-    sleep 0.01
-  end
-end
-
-sleep 4
-ir.on_flash(flash)
-
-sleep
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index b345a97a..f8221d63 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -4,7 +4,7 @@ module Components
     require 'dino/components/mixins'
     require 'dino/components/basic'
     require 'dino/components/register'
-    require 'dino/components/spi'
+    # require 'dino/components/spi'
     require 'dino/components/i2c'
     autoload :Led,              'dino/components/led'
     autoload :Button,           'dino/components/button'
@@ -13,7 +13,6 @@ module Components
     autoload :Servo,            'dino/components/servo'
     autoload :SSD,              'dino/components/ssd'
     autoload :Stepper,          'dino/components/stepper'
-    autoload :IrReceiver,       'dino/components/ir_receiver'
     autoload :LCD,              'dino/components/lcd'
     autoload :Relay,            'dino/components/relay'
     autoload :SoftwareSerial,   'dino/components/softserial'
diff --git a/lib/dino/components/ir_receiver.rb b/lib/dino/components/ir_receiver.rb
deleted file mode 100644
index 5dcf44a0..00000000
--- a/lib/dino/components/ir_receiver.rb
+++ /dev/null
@@ -1,7 +0,0 @@
-module Dino
-  module Components
-    class IrReceiver < Basic::DigitalInput
-      alias :on_flash :on_low
-    end
-  end
-end

From a0e1c9835ca28aa98ed38258682261b920316c68 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 17:41:04 -0400
Subject: [PATCH 183/296] ESP8266 class with pin mapping. Get aux limit in
 handshake.

---
 examples/i2c/ds3231.rb    | 16 ++++++---
 lib/dino/api/helper.rb    | 13 --------
 lib/dino/board.rb         | 70 ++++-----------------------------------
 lib/dino/board/base.rb    | 49 +++++++++++++++++++++++++++
 lib/dino/board/default.rb | 35 ++++++++++++++++++++
 lib/dino/board/esp8266.rb | 63 +++++++++++++++++++++++++++++++++++
 spec/lib/board_spec.rb    |  6 +++-
 spec/spec_helper.rb       |  5 ++-
 src/lib/Dino.cpp          |  2 ++
 src/lib/Dino.h            |  9 ++---
 10 files changed, 180 insertions(+), 88 deletions(-)
 create mode 100644 lib/dino/board/base.rb
 create mode 100644 lib/dino/board/default.rb
 create mode 100644 lib/dino/board/esp8266.rb

diff --git a/examples/i2c/ds3231.rb b/examples/i2c/ds3231.rb
index 7c5a3be8..f19f4481 100644
--- a/examples/i2c/ds3231.rb
+++ b/examples/i2c/ds3231.rb
@@ -7,11 +7,17 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 
-# For now you need to pass in the SDA pin of the I2C interface Arduino/Wire uses.
-# Most Arduinos: A4
-# Leonardo: 2
-# Due and Mega: 20
-# ESP8266 : 4 (D2 on WeMos/NodeMCU = GPIO 4 on the ESP8266 itself)
+# Only pass in the SDA pin of the I2C bus. SCL (clock) pin MUST be properly
+# connected for things to work, but we don't need to control it.
+#
+# Most Arduinos: SDA = 'A4'   SCL = 'A5'
+# Leonardo:      SDA =   2    SCL =   3
+# Due and Mega:  SDA =  20    SCL =  21
+# ESP8266 :      SDA =   4    SCL =   5
+#
+# On the ESP8266, 'D2' and 'D1' also map to SDA and SCL respectively.
+# This is for convenience when working with common development boards.
+#
 bus = Dino::Components::I2C::Bus.new(board: board, pin: 4)
 rtc = Dino::Components::I2C::DS3231.new(bus: bus, address: 104)
 
diff --git a/lib/dino/api/helper.rb b/lib/dino/api/helper.rb
index a534fabd..3692a8c9 100644
--- a/lib/dino/api/helper.rb
+++ b/lib/dino/api/helper.rb
@@ -1,19 +1,6 @@
 module Dino
   module API
     module Helper
-      #
-      # Microcontrollers have different aux message limits based on available RAM.
-      # Board should set @aux_limit from handshake. Default to safe minimum.
-      #
-      def aux_limit
-        @aux_limit || 527 # Should default to 39, but this isn't in handshake yet.
-      end
-
-      def write(message)
-        raise NotImplementedError
-          .new("#{self.class.name}#write not defined in Board subclass")
-      end
-
       def pack(type, data, options={})
         # Always pack as little endian.
         template =  case type
diff --git a/lib/dino/board.rb b/lib/dino/board.rb
index a474b4d7..80c585cc 100644
--- a/lib/dino/board.rb
+++ b/lib/dino/board.rb
@@ -1,69 +1,11 @@
 module Dino
-  class Board
-    include API::Core
-    include API::I2C
-    include API::Servo
-    include API::ShiftIO
-    include API::SPI
-    include API::Infrared
-    include API::OneWire
-    include API::Tone
+  module Board
+    require 'dino/board/base'
+    require 'dino/board/default'
+    require 'dino/board/esp8266'
 
-    attr_reader :high, :low, :analog_high, :components, :analog_zero, :dac_zero
-
-    def initialize(io, options={})
-      @io, @components = io, []
-      @analog_zero, @dac_zero = @io.handshake.to_s.split(",").map { |pin| pin.to_i }
-      io.add_observer(self)
-      self.analog_resolution = options[:bits] || 8
-    end
-
-    def analog_resolution=(value)
-      @bits = value || 8
-      write Dino::Message.encode(command: 96, value: @bits)
-      @low  = 0
-      @high = 1
-      @analog_high = (2 ** @bits) - 1
-    end
-
-    def write(msg)
-      @io.write(msg)
-    end
-
-    def update(pin, msg)
-      @components.each do |part|
-        part.update(msg) if pin.to_i == part.pin
-      end
-    end
-
-    def add_component(component)
-      @components << component
-    end
-
-    def remove_component(component)
-      stop_listener(component.pin)
-      @components.delete(component)
-    end
-
-    DIGITAL_REGEX = /\A\d+\z/i
-    ANALOG_REGEX = /\A(a)\d+\z/i
-    DAC_REGEX = /\A(dac)\d+\z/i
-
-    def convert_pin(pin)
-      pin = pin.to_s
-      return pin.to_i             if pin.match(DIGITAL_REGEX)
-      return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
-      return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
-      raise "Incorrect pin format"
-    end
-
-    def analog_pin_to_i(pin)
-      @analog_zero + pin.gsub(/\Aa/i, '').to_i
-    end
-
-    def dac_pin_to_i(pin)
-      raise "The board did not specify any DAC pins" unless @dac_zero
-      @dac_zero + pin.gsub(/\Adac/i, '').to_i
+    def self.new(options={})
+      self::Default.new(options)
     end
   end
 end
diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
new file mode 100644
index 00000000..1dcda3d2
--- /dev/null
+++ b/lib/dino/board/base.rb
@@ -0,0 +1,49 @@
+module Dino
+  module Board
+    class Base
+      attr_reader :high, :low, :analog_high, :components, :analog_zero, :dac_zero
+
+      def initialize(io, options={})
+        @io, @components = io, []
+
+        ack = io.handshake.split(",").map { |num| num.to_i }
+        @aux_limit, @analog_zero, @dac_zero = ack
+
+        io.add_observer(self)
+        self.analog_resolution = options[:bits] || 8
+      end
+
+      def analog_resolution=(value)
+        @bits = value || 8
+        write Dino::Message.encode(command: 96, value: @bits)
+        @low  = 0
+        @high = 1
+        @analog_high = (2 ** @bits) - 1
+      end
+
+      # Aux limits differ per board depending on RAM, 39 is the safe minimum.
+      def aux_limit
+        @aux_limit ||= 39
+      end
+
+      def write(msg)
+        @io.write(msg)
+      end
+
+      def update(pin, msg)
+        @components.each do |part|
+          part.update(msg) if pin.to_i == part.pin
+        end
+      end
+
+      def add_component(component)
+        @components << component
+      end
+
+      def remove_component(component)
+        stop_listener(component.pin)
+        @components.delete(component)
+      end
+    end
+  end
+end
diff --git a/lib/dino/board/default.rb b/lib/dino/board/default.rb
new file mode 100644
index 00000000..9bcd0d03
--- /dev/null
+++ b/lib/dino/board/default.rb
@@ -0,0 +1,35 @@
+module Dino
+  module Board
+    class Default < Base
+      include API::Core
+      include API::I2C
+      include API::Servo
+      include API::ShiftIO
+      include API::SPI
+      include API::Infrared
+      include API::OneWire
+      include API::Tone
+
+      DIGITAL_REGEX = /\A\d+\z/i
+      ANALOG_REGEX = /\A(a)\d+\z/i
+      DAC_REGEX = /\A(dac)\d+\z/i
+
+      def convert_pin(pin)
+        pin = pin.to_s
+        return pin.to_i             if pin.match(DIGITAL_REGEX)
+        return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
+        return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
+        raise "Incorrect pin format"
+      end
+
+      def analog_pin_to_i(pin)
+        @analog_zero + pin.gsub(/\Aa/i, '').to_i
+      end
+
+      def dac_pin_to_i(pin)
+        raise "The board did not specify any DAC pins" unless @dac_zero
+        @dac_zero + pin.gsub(/\Adac/i, '').to_i
+      end
+    end
+  end
+end
diff --git a/lib/dino/board/esp8266.rb b/lib/dino/board/esp8266.rb
new file mode 100644
index 00000000..2de6fb24
--- /dev/null
+++ b/lib/dino/board/esp8266.rb
@@ -0,0 +1,63 @@
+module Dino
+  module Board
+    class ESP8266 < Base
+      include API::Core
+      include API::I2C
+      include API::Servo
+      include API::ShiftIO
+      include API::SPI
+      include API::Infrared
+      include API::OneWire
+      include API::Tone
+
+
+      DIGITAL_REGEX = /\Ad\d+\z/i
+      ANALOG_REGEX  = /\A(a)\d+\z/i
+      RAW_REGEX     = /\A\d+\z/i
+      GPIO_REGEX    = /\A(gpio)\d+\z/i
+
+      D_PIN_MAP = {
+        0  => 16,
+        1  => 5,
+        2  => 4,
+        3  => 0,
+        4  => 2,
+        5  => 14,
+        6  => 12,
+        7  => 13,
+        8  => 15,
+        9  => 3,   # Serial RXD
+        10 => 1,   # Serial TXD
+      }
+
+      def convert_pin(pin)
+        pin = pin.to_s
+        return pin.to_i              if pin.match(RAW_REGEX)
+        return gpio_pin_to_i(pin)    if pin.match(GPIO_REGEX)
+        return analog_pin_to_i(pin)  if pin.match(ANALOG_REGEX)
+        return digital_pin_to_i(pin) if pin.match(DIGITAL_REGEX)
+        raise "Incorrect pin format"
+      end
+
+      # Only one analog in on the ESP8266, GPIO 17.
+      def analog_pin_to_i(pin)
+        gpio = pin.gsub(/\Aa/i, '').to_i
+        raise "Invalid analog input pin" unless gpio == 0
+        17
+      end
+
+      def gpio_pin_to_i(pin)
+        gpio = pin.gsub(/\Agpio/i, '').to_i
+        raise "Invalid GPIO input pin" if (gpio < 0 || gpio > 17)
+        gpio
+      end
+
+      def digital_pin_to_i(pin)
+        d_index = pin.gsub(/\Ad/i, '').to_i
+        gpio = D_PIN_MAP[d_index]
+        raise "Invalid D pin" unless gpio
+        gpio
+      end
+    end
+  end
+end
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
index e549759e..381fbb07 100644
--- a/spec/lib/board_spec.rb
+++ b/spec/lib/board_spec.rb
@@ -3,7 +3,11 @@
 module Dino
   describe Dino::Board do
     def io_mock(methods = {})
-      @io ||= double(:io, {add_observer: true, handshake: "14,20", write: true, read: true}.merge(methods))
+      @io ||= double :io, { add_observer: true,
+                            handshake: "528,14,20",
+                            write: true,
+                            read: true
+                          }.merge(methods)
     end
 
     subject { Board.new(io_mock) }
diff --git a/spec/spec_helper.rb b/spec/spec_helper.rb
index 3ed0a269..a31b7943 100644
--- a/spec/spec_helper.rb
+++ b/spec/spec_helper.rb
@@ -14,7 +14,10 @@ def self.redefine(const, value, opts={})
 module BoardMock
   def self.included(base)
     base.class_eval do
-      let(:txrx)  { double(:txrx, add_observer: true, handshake: "14,20", write: true, read: true) }
+      let(:txrx)  { double :txrx, add_observer: true,
+                                  handshake: "528,14,20",
+                                  write: true,
+                                  read: true }
       let(:board) { Dino::Board.new(txrx) }
     end
   end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 7cd17cbc..dd7af541 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -227,6 +227,8 @@ void Dino::reset() {
   rcvBytes = 0;
 
   stream->print("ACK:");
+  stream->print(AUX_SIZE);
+  stream->print(',');
   stream->print(A0);
   #if defined(__SAM3X8E__)
     stream->print(',');
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index a6c6e9bf..743ee1c8 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -128,14 +128,15 @@ class Dino {
 
     // Scale aux message allocation based on enabled features and chip.
     #if defined(DINO_IR_OUT) && !defined (__AVR_ATmega168__)
-      byte auxMsg[528];
+    #  define AUX_SIZE 528
     #elif defined(DINO_SHIFT) || defined(DINO_SPI) || defined (DINO_I2C)
-      byte auxMsg[264];
+    #  define AUX_SIZE 264
     #elif defined (DINO_LCD)
-      byte auxMsg[136];
+    #  define AUX_SIZE 136
     #else
-      byte auxMsg[40];
+    #  define AUX_SIZE 40
     #endif
+    byte auxMsg[AUX_SIZE];
 
     // Save a pointer to any stream so we can call ->print and ->write on it.
     Stream* stream;

From db5b9bde28809050c241043467a248cd538097fa Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 17:58:28 -0400
Subject: [PATCH 184/296] Append current dino version to generated sketches.

---
 lib/dino_cli/generator.rb | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 0a3b1ba8..af02ecb9 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -2,6 +2,7 @@ class DinoCLI::Generator
   require "fileutils"
   require "dino_cli/packages"
   require "dino_cli/targets"
+  require "dino/version"
   attr_accessor :options
 
   def initialize(options={})
@@ -14,6 +15,7 @@ def append_target
     # Preserve the source sketch name, since we need to copy that file.
     options[:src_sketch_name] = options[:sketch_name].dup
     options[:sketch_name] << "_#{options[:target]}" unless options[:target] == :mega
+    options[:sketch_name] << "_#{::Dino::VERSION}"
   end
 
   def self.run!(options={})

From 4b575c5cfefa8054577e4226421a716c7e5bf1ae Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 17 Feb 2018 18:34:21 -0400
Subject: [PATCH 185/296] Trap interrupt and reset the board.

---
 lib/dino/tx_rx/base.rb | 33 +++++++++++----------------------
 1 file changed, 11 insertions(+), 22 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index db90297f..972d7de0 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -11,32 +11,17 @@ class RxFlushTimeout     < StandardError; end
     class Base
       include Observable
       include Handshake
-      # Let the methods in FlowControl wrap subclass methods too.
+      # We need the methods in FlowControl to wrap subclass methods too.
       def self.inherited(subclass)
         subclass.send(:prepend, FlowControl)
       end
 
-      def read(message)
-        raise NotImplementedError
-          .new("#{self.class.name}#read not defined in Dino::TxRx subclass")
-      end
-
-      def write(message)
-        raise NotImplementedError
-          .new("#{self.class.name}#write not defined in Dino::TxRx subclass")
-      end
-
     private
 
       def io
         @io ||= connect
       end
 
-      def connect
-        raise NotImplementedError
-          .new("#{self.class.name}#connect not defined in Dino::TxRx subclass")
-      end
-
       def io_reset
         flush_read
         stop_read
@@ -50,7 +35,16 @@ def flush_read
       end
 
       def start_read
-        @thread ||= Thread.new { loop { read_and_parse } }
+        @thread ||= Thread.new  do
+          trap("INT") do
+            io.write("\n90\n")
+            raise Interrupt
+          end
+
+          loop do
+            read_and_parse
+          end
+        end
       end
 
       def stop_read
@@ -59,11 +53,6 @@ def stop_read
         @thread = nil
       end
 
-      def read_and_parse
-        raise NotImplementedError
-          .new("#{self.class.name}#read_and_parse not defined in Dino::TxRx::FlowControl")
-      end
-
       def parse(line)
         if line.match(/\A\d+:/)
           pin, message = line.split(":", 2)

From 4d1a3332e17bbeb2b57584d0206e1cbc0f027498 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 18 Feb 2018 14:08:50 -0400
Subject: [PATCH 186/296] DHT temp/RH sensor implementation in mostly Ruby.

Uses a (new) generic function on the board to pull the pin low for reset, then read pulse lengths (between rising/falling edges) sent by the sensor. Pulse durations get sent to Ruby for decoding. Removed DHT library.
---
 .gitmodules                                   |  3 --
 examples/dht/dht.rb                           | 17 +++---
 lib/dino/api/core.rb                          | 18 +++++++
 lib/dino/components/dht.rb                    | 37 ++++++++++---
 .../components/one_wire/bus_enumerator.rb     |  2 +-
 lib/dino_cli/packages.rb                      |  9 ----
 lib/dino_cli/targets.rb                       |  2 +-
 src/lib/Dino.cpp                              |  8 +--
 src/lib/Dino.h                                |  2 +-
 src/lib/DinoCoreIO.cpp                        | 52 +++++++++++++++++++
 src/lib/DinoDHT.cpp                           | 35 -------------
 src/vendor/arduino-DHT                        |  1 -
 12 files changed, 115 insertions(+), 71 deletions(-)
 delete mode 100644 src/lib/DinoDHT.cpp
 delete mode 160000 src/vendor/arduino-DHT

diff --git a/.gitmodules b/.gitmodules
index 9ae081fb..d1468cc8 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,9 +1,6 @@
 [submodule "src/vendor/Arduino-IRremote"]
 	path = src/vendor/Arduino-IRremote
 	url = https://github.com/z3t0/Arduino-IRremote.git
-[submodule "src/vendor/arduino-DHT"]
-	path = src/vendor/arduino-DHT
-	url = https://github.com/markruys/arduino-DHT.git
 [submodule "src/vendor/IRremoteESP8266"]
 	path = src/vendor/IRremoteESP8266
 	url = https://github.com/markszabo/IRremoteESP8266.git
diff --git a/examples/dht/dht.rb b/examples/dht/dht.rb
index e08d0d17..113e71c9 100644
--- a/examples/dht/dht.rb
+++ b/examples/dht/dht.rb
@@ -4,16 +4,21 @@
 require 'bundler/setup'
 require 'dino'
 
-board = Dino::Board.new(Dino::TxRx::Serial.new)
+board = Dino::Board.new(Dino::TxRx::Serial.new(device: "/dev/cu.usbmodem1431"))
 dht = Dino::Components::DHT.new(pin: 7, board: board)
 
 # The DHT class pre-processes raw data from the board. When it reaches callbacks
 # it's already hash of :temperature and :humidity keys, both with Float values.
-dht.add_callback do |data|
-  puts "The temperature is #{data[:temperature]} degrees Celsius"
-  puts "The relative humidity is #{data[:humidity]}%"
+dht.add_callback do |reading|
+  print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
+  if reading[:error]
+    puts "Error: #{reading[:error]}"
+  else
+    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:farenheit]} \xC2\xB0F | "
+    puts "#{reading[:humidity]}% relative humidity"
+  end
 end
 
-# Read it every 10 seconds.
-dht.poll(10)
+# Read it every 5 seconds.
+dht.poll(5)
 sleep
diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index 146e6fef..bbda7e56 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -69,6 +69,24 @@ def analog_listen(pin, divider=16)
       def stop_listener(pin)
         set_listener(pin, :off)
       end
+
+      def pulse_read(pin, options={})
+        reset       = options[:reset] || false
+        reset_time  = options[:reset_time] || 0
+        pulse_limit = options[:pulse_limit] || 100
+        timeout     = options[:timeout] || 200
+
+        settings = reset ? 1 : 0
+        settings = settings | 0b10 if reset == high
+
+        aux = pack :uint16, [reset_time, timeout]
+        aux << pack(:uint8, pulse_limit)
+
+        write Message.encode command: 11,
+                             pin: convert_pin(pin),
+                             value: settings,
+                             aux_message: aux
+      end
     end
   end
 end
diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
index cf3f91d9..46438eae 100644
--- a/lib/dino/components/dht.rb
+++ b/lib/dino/components/dht.rb
@@ -5,18 +5,39 @@ class DHT
       include Setup::Input
       include Mixins::Poller
 
-      def after_initialize(options={})
-        super(options)
-        @state = {temperature: nil, humidity: nil}
-      end
-
       def _read
-        board.dht_read(self.pin)
+        board.pulse_read(pin, reset: board.low, reset_time: 1000, pulse_limit: 84)
       end
 
       def pre_callback_filter(data)
-        t, h = data.split(",")
-        { temperature: t.to_f, humidity: h.to_f }
+        decode(data.split(",").map(&:to_i))
+      end
+
+      def decode(data)
+        data = data.last(81)
+        return { error: 'missing data' } unless data.length == 81
+        data = data[0..79]
+
+        bytes = []
+        data.each_slice(16) do |b|
+          byte = 0b00000000
+          b.each_slice(2) do |x,y|
+            bit = (y<x) ? 0 : 1
+            byte = (byte << 1) | bit
+          end
+          bytes << byte
+        end
+        return { error: 'CRC failure' } unless crc(bytes)
+
+        celsius   = ((bytes[2] << 8) | bytes[3]).to_f / 10
+        humidity  = ((bytes[0] << 8) | bytes[1]).to_f / 10
+        farenheit = (celsius * 1.8 + 32).round(1)
+
+        { celsius: celsius, farenheit: farenheit, humidity: humidity }
+      end
+
+      def crc(bytes)
+        bytes[0..3].reduce(0, :+) & 0xFF == bytes[4]
       end
     end
   end
diff --git a/lib/dino/components/one_wire/bus_enumerator.rb b/lib/dino/components/one_wire/bus_enumerator.rb
index 92515bc5..a4f6fc6e 100644
--- a/lib/dino/components/one_wire/bus_enumerator.rb
+++ b/lib/dino/components/one_wire/bus_enumerator.rb
@@ -52,7 +52,7 @@ def parse_search_result(result)
           (0..63).each { |i| high_discrepancy = i if new_discrepancies[i] == 0 }
 
           # LSByte of address is product family.
-          klass = family_lookup(address & 0x00000000000000FF)
+          klass = family_lookup(address & 0xFF)
 
           [{class: klass, address: address}, high_discrepancy]
         end
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index 96d39de8..8dc06c35 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -49,15 +49,6 @@ class DinoCLI::Generator
       "lib/DinoLCD.h",
     ]
   },
-  dht: {
-    description: "Read DHT temp/humidity sensors",
-    directive: "DINO_DHT",
-    files: [
-      "lib/DinoDHT.cpp",
-      "vendor/arduino-DHT/DHT.cpp",
-      "vendor/arduino-DHT/DHT.h",
-    ]
-  },
   serial: {
     description: "Software serial output",
     directive: "DINO_SERIAL",
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 043a2bd0..1e9d4ea8 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -11,7 +11,7 @@ class DinoCLI::Generator
     core: [:core],
 
     # Specific features for the old mega168 chips.
-    mega168: [:core, :servo, :dht, :one_wire, :ir_out, :tone, :spi, :i2c],
+    mega168: [:core, :servo, :one_wire, :ir_out, :tone, :spi, :i2c],
 
     # ARM includes everytyhing except specific incompatibilities.
     arm: STANDARD_PACKAGES - [:serial, :tone, :ir_out],
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index dd7af541..70a0dca5 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -100,13 +100,14 @@ void Dino::process() {
     // See explanation at top of DinoBugWorkaround.cpp
     case 999999: bugWorkaround   ();  break;
 
-    // Implemented in this file.
+    // Implemented in DinoCoreIO.cpp
     case 0:  setMode             ();    break;
     case 1:  dWrite              ();    break;
     case 2:  dRead               (pin); break;
     case 3:  aWrite              ();    break;
     case 4:  aRead               (pin); break;
     case 7:  setListener         ();    break;
+    case 11: pulseRead           ();    break;
 
     // Implemented in DinoServo.cpp
     #ifdef DINO_SERVO
@@ -124,11 +125,6 @@ void Dino::process() {
     case 12: handleSerial        ();    break;
     #endif
 
-    // Implemented in DinoDHT.cpp
-    #ifdef DINO_DHT
-    case 13: dhtRead             ();    break;
-    #endif
-
     // Implemented in DinoIROut.cpp
     #ifdef DINO_IR_OUT
     case 16: irSend              ();    break;
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 743ee1c8..a31e778b 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -71,8 +71,8 @@ class Dino {
     void servoToggle           ();         //cmd = 8
     void servoWrite            ();         //cmd = 9
     void handleLCD             ();         //cmd = 10
+    void pulseRead             ();         //cmd = 11
     void handleSerial          ();         //cmd = 12
-    void dhtRead               ();         //cmd = 13
     void irSend                ();         //cmd = 16
     void tone                  ();         //cmd = 17
     void noTone                ();         //cmd = 18
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index 7fb24df1..a9f4bf01 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -143,3 +143,55 @@ void Dino::clearCoreListeners(){
     listeners[i][1] = 0;
   }
 }
+
+//
+// Rapidly polls a digital input looking for rising or falling edges,
+// recording the time in microseconds between consecutive edges.
+// There is an optional reset at the beginning if the pin must be held opposite
+// to its idle state to trigger a reading.
+//
+// Max 65535 microseconds reset time.
+// Max 255 microseconds per pulse (between 2 consecutive edges).
+// Max 255 pulses counted.
+//
+// val bit 0   : whether to reset the line first or not (0 = no, 1 = yes)
+// val bit 1   : direction to pull the line (0 = low, 1 = high)
+// auxMsg[0-1] : unsigned 16-bit reset duration
+// auxMsg[2-3] : unsigned 16-bit pulse read timeout (in milliseconds)
+// auxMsg[4]   : unsigned 8-bit pulse count limit
+// auxMsg[8] + : reserved as output buffer, will be overwritten
+//
+void Dino::pulseRead(){
+  // Reset
+  if (bitRead(val, 0)) {
+    uint16_t resetTime = (auxMsg[1] << 8) | auxMsg[0];
+    pinMode(pin, OUTPUT);
+    digitalWrite(pin, bitRead(val, 1));
+    delayMicroseconds(resetTime);
+  }
+  pinMode(pin, INPUT);
+  byte state = digitalRead(pin);
+
+  uint16_t timeout = (auxMsg[3] << 8) | auxMsg[2];
+  byte pulseCount = 0;
+
+  uint32_t start = millis();
+  uint32_t lastWrite = micros();
+
+  while ((millis() - start < timeout) && (pulseCount < auxMsg[4])) {
+    if (digitalRead(pin) != state){
+      uint32_t now = micros();
+      pulseCount++;
+      auxMsg[pulseCount+8] = now - lastWrite;
+      lastWrite = now;
+      state = state ^ 1;
+    }
+  }
+
+  stream->print(pin); stream->print(':');
+  for (byte i=1; i<=pulseCount; i++){
+    stream->print(auxMsg[i+8]);
+    stream->print((i == pulseCount) ? '\n' : ',');
+  }
+  if (pulseCount == 0) stream->print('\n');
+}
diff --git a/src/lib/DinoDHT.cpp b/src/lib/DinoDHT.cpp
deleted file mode 100644
index 6f9e38f6..00000000
--- a/src/lib/DinoDHT.cpp
+++ /dev/null
@@ -1,35 +0,0 @@
-//
-// This file adds to the Dino class only if DINO_DHT is defined in Dino.h.
-// Should not be included in sketch for Arduino Due yet.
-//
-#include "Dino.h"
-#ifdef DINO_DHT
-
-// Include the DHT library and create an instance.
-#include "DHT.h"
-DHT dht;
-
-// CMD = 13
-// Read a DHT sensor
-void Dino::dhtRead() {
-  // Can't access pin to check this in latest DHT library.
-  // Assuming safe to repeatedly call setup for now.
-  // if (pin != dht.pin)
-  dht.setup(pin);
-
-  // Always read both values
-  float temperature = dht.getTemperature();
-  float humidity = dht.getHumidity();
-
-  stream->print(pin); stream->print(':');
-  // Send the values as a comma delimited printed decimals with 1dp precision.
-  stream->print(temperature, 1); stream->print(',');
-  stream->print(humidity, 1);
-  stream->print('\n');
-
-  #ifdef debug
-    Serial.print("Called Dino::dhtRead()\n");
-  #endif
-}
-
-#endif
diff --git a/src/vendor/arduino-DHT b/src/vendor/arduino-DHT
deleted file mode 160000
index cd24ce3c..00000000
--- a/src/vendor/arduino-DHT
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit cd24ce3ca32fe0caf05d6c21565c8d5605860a08

From 03f454e1522d0a09d56f944d836fb30819471a4b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 22 Feb 2018 10:35:45 -0400
Subject: [PATCH 187/296] Bunch of small fixes.

---
 lib/dino/api/spi.rb                          | 10 ++--------
 lib/dino/board/base.rb                       |  2 ++
 lib/dino/board/default.rb                    |  1 -
 lib/dino/board/esp8266.rb                    |  2 --
 lib/dino/components/i2c/bus.rb               |  2 +-
 lib/dino/components/mixins/board_proxy.rb    | 20 ++++++++------------
 lib/dino/components/one_wire/ds18b20.rb      |  8 ++++----
 lib/dino/components/register/spi_in.rb       |  9 +++------
 lib/dino/components/register/spi_out.rb      |  7 ++-----
 spec/lib/components/one_wire/ds18b20_spec.rb |  8 ++++----
 src/lib/DinoDefines.h                        |  1 -
 11 files changed, 26 insertions(+), 44 deletions(-)

diff --git a/lib/dino/api/spi.rb b/lib/dino/api/spi.rb
index 430f0ac3..b023c0d8 100644
--- a/lib/dino/api/spi.rb
+++ b/lib/dino/api/spi.rb
@@ -21,11 +21,7 @@ def spi_header(options)
       # CMD = 26
       def spi_transfer(pin, options={})
         options[:read] ||= 0
-        if options[:write]
-          options[:write] = [options[:write]].flatten
-        else
-          options[:write] = []
-        end
+        options[:write] = [options[:write]].flatten.compact || []
 
         return if (options[:read] == 0) && (options[:write].empty?)
 
@@ -37,9 +33,7 @@ def spi_transfer(pin, options={})
 
       # CMD = 27
       def spi_listen(pin, options={})
-        raise ArgumentError,
-              'no SPI bytes to read' unless (options[:read] > 0)
-        options[:write] = []
+        raise ArgumentError, 'no SPI bytes to read' unless (options[:read] > 0)
 
         header = spi_header(options)
         write Message.encode command: 27,
diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index 1dcda3d2..d70c6aa1 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -1,6 +1,8 @@
 module Dino
   module Board
     class Base
+      include API::Core
+
       attr_reader :high, :low, :analog_high, :components, :analog_zero, :dac_zero
 
       def initialize(io, options={})
diff --git a/lib/dino/board/default.rb b/lib/dino/board/default.rb
index 9bcd0d03..076a5121 100644
--- a/lib/dino/board/default.rb
+++ b/lib/dino/board/default.rb
@@ -1,7 +1,6 @@
 module Dino
   module Board
     class Default < Base
-      include API::Core
       include API::I2C
       include API::Servo
       include API::ShiftIO
diff --git a/lib/dino/board/esp8266.rb b/lib/dino/board/esp8266.rb
index 2de6fb24..a50fbd53 100644
--- a/lib/dino/board/esp8266.rb
+++ b/lib/dino/board/esp8266.rb
@@ -1,7 +1,6 @@
 module Dino
   module Board
     class ESP8266 < Base
-      include API::Core
       include API::I2C
       include API::Servo
       include API::ShiftIO
@@ -10,7 +9,6 @@ class ESP8266 < Base
       include API::OneWire
       include API::Tone
 
-
       DIGITAL_REGEX = /\Ad\d+\z/i
       ANALOG_REGEX  = /\A(a)\d+\z/i
       RAW_REGEX     = /\A\d+\z/i
diff --git a/lib/dino/components/i2c/bus.rb b/lib/dino/components/i2c/bus.rb
index 06ef013a..6e9496fc 100644
--- a/lib/dino/components/i2c/bus.rb
+++ b/lib/dino/components/i2c/bus.rb
@@ -33,7 +33,7 @@ def _read(address, register, num_bytes=1, options={})
         def bubble_callbacks
           add_callback(:bus_master) do |str|
             if str.match /d*-/
-              address, data = str.split("-")
+              address, data = str.split("-", 2)
               address = address.to_i
               data = data.split(",").map(&:to_i)
               update_component({address: address, data: data})
diff --git a/lib/dino/components/mixins/board_proxy.rb b/lib/dino/components/mixins/board_proxy.rb
index b18b6ab0..cf9395ec 100644
--- a/lib/dino/components/mixins/board_proxy.rb
+++ b/lib/dino/components/mixins/board_proxy.rb
@@ -4,25 +4,21 @@ module Mixins
       module BoardProxy
         include BusMaster
 
-        def after_initialize(options={})
-          super(options)
-          @high = 1
-          @low = 0
+        def high
+          1
         end
 
-        attr_reader :high, :low
+        def low
+          0
+        end
 
         def convert_pin(pin)
-          pin = pin.to_i
+          pin.to_i
         end
 
-        def set_pin_mode(pin, mode)
-          nil
-        end
+        def set_pin_mode(pin, mode); end
 
-        def set_pullup(pin, pullup)
-          nil
-        end
+        def set_pullup(pin, pullup); end
 
         def start_read; end
       end
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index cedac9d0..8aaf0245 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -51,14 +51,14 @@ def pre_callback_filter(bytes)
           return { crc_error: true } unless Helper.crc_check(bytes)
           @resolution = decode_resolution(bytes)
 
-          decode_temp(bytes).merge(raw: bytes)
+          decode_temperature(bytes).merge(raw: bytes)
         end
 
         #
-        # Temperature is the first 16 bits (2 bytes of 9 read), little-endian.
-        # It's a signed, 2's complement, little-endian decimal with 2^-4 exp.
+        # Temperature is the first 16 bits (2 bytes of 9 read).
+        # It's a signed, 2's complement, little-endian decimal. LSB = 2 ^ -4.
         #
-        def decode_temp(bytes)
+        def decode_temperature(bytes)
           celsius = bytes[0..1].pack('C*').unpack('s<')[0] * (2.0 ** -4)
           farenheit = (celsius * 1.8 + 32).round(4)
 
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 3bcfc41b..36298543 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -14,12 +14,9 @@ class SPIIn < Select
 
         def after_initialize(options={})
           super(options) if defined?(super)
-
-          @spi_mode  = options[:spi_mode] || 0
-
-          # No default value for clock frequency.
-          raise 'SPI clock rate (Hz) required in :frequency option' unless options[:frequency]
-          @frequency = options[:frequency]
+          
+          @spi_mode  = options[:spi_mode]  || 0
+          @frequency = options[:frequency] || 3000000
         end
 
         def read
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index 727c7a58..14cf87af 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -13,11 +13,8 @@ class SPIOut < Select
         attr_reader :spi_mode, :frequency
 
         def after_initialize(options={})
-          @spi_mode  = options[:spi_mode] || 0
-
-          # No default value for clock frequency.
-          raise 'SPI clock rate (Hz) required in :frequency option' unless options[:frequency]
-          @frequency = options[:frequency]
+          @spi_mode  = options[:spi_mode]  || 0
+          @frequency = options[:frequency] || 3000000
 
           super(options) if defined?(super)
         end
diff --git a/spec/lib/components/one_wire/ds18b20_spec.rb b/spec/lib/components/one_wire/ds18b20_spec.rb
index 277d7e94..a5ca702c 100644
--- a/spec/lib/components/one_wire/ds18b20_spec.rb
+++ b/spec/lib/components/one_wire/ds18b20_spec.rb
@@ -10,13 +10,13 @@ module OneWire
 
         describe '#decode_temp' do
           it 'should decode values matching the datasheet and convert C to F' do
-            expect(subject.decode_temp([0b1101_0000,0b0000_0111]))
+            expect(subject.decode_temperature([0b1101_0000,0b0000_0111]))
               .to eq(celsius: 125, farenheit: 257)
-            expect(subject.decode_temp([0b0000_0000,0b0000_0000]))
+            expect(subject.decode_temperature([0b0000_0000,0b0000_0000]))
               .to eq(celsius: 0, farenheit: 32)
-            expect(subject.decode_temp([0b0101_1110,0b1111_1111]))
+            expect(subject.decode_temperature([0b0101_1110,0b1111_1111]))
               .to eq(celsius: -10.125, farenheit: 13.775)
-            expect(subject.decode_temp([0b1001_0000,0b1111_1100]))
+            expect(subject.decode_temperature([0b1001_0000,0b1111_1100]))
               .to eq(celsius: -55, farenheit: -67)
           end
         end
diff --git a/src/lib/DinoDefines.h b/src/lib/DinoDefines.h
index 8e630eed..daca06b6 100644
--- a/src/lib/DinoDefines.h
+++ b/src/lib/DinoDefines.h
@@ -8,7 +8,6 @@
 // #define DINO_SERVO
 // #define DINO_LCD
 // #define DINO_SERIAL
-// #define DINO_DHT
 // #define DINO_ONE_WIRE
 // #define DINO_IR_OUT
 // #define DINO_TONE

From 14b353245a71ddaedd790f8ac83554b507f52096 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 22 Feb 2018 14:10:38 -0400
Subject: [PATCH 188/296] =?UTF-8?q?Pin=20wasn=E2=80=99t=20being=20set=20to?=
 =?UTF-8?q?=20ID=20servo=20&=20write=20microseconds=20instead=20now.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 lib/dino/api/servo.rb                    | 11 +++++++---
 lib/dino/components/mixins/bus_master.rb |  9 +++-----
 lib/dino/components/servo.rb             | 28 +++++++++++++++++++-----
 src/lib/DinoServo.cpp                    | 11 +++++++---
 4 files changed, 42 insertions(+), 17 deletions(-)

diff --git a/lib/dino/api/servo.rb b/lib/dino/api/servo.rb
index baae5b0e..487c4185 100644
--- a/lib/dino/api/servo.rb
+++ b/lib/dino/api/servo.rb
@@ -3,16 +3,21 @@ module API
     module Servo
       include Helper
 
-      def servo_toggle(pin, value=:off)
+      def servo_toggle(pin, value=:off, options={})
+        options[:min] ||= 544
+        options[:max] ||= 2400
+        aux = pack :uint16, [options[:min], options[:max]]
+
         write Message.encode command: 8,
                              pin: convert_pin(pin),
-                             value: (value == :off) ? 0 : 1
+                             value: (value == :off) ? 0 : 1,
+                             aux: aux
       end
 
       def servo_write(pin, value=0)
         write Message.encode command: 9,
                              pin: convert_pin(pin),
-                             value: value
+                             aux_message: pack(:uint16, value)
       end
     end
   end
diff --git a/lib/dino/components/mixins/bus_master.rb b/lib/dino/components/mixins/bus_master.rb
index a94514bc..731ffb4e 100644
--- a/lib/dino/components/mixins/bus_master.rb
+++ b/lib/dino/components/mixins/bus_master.rb
@@ -2,18 +2,15 @@ module Dino
   module Components
     module Mixins
       module BusMaster
-        attr_reader :mutex
-
-        def after_initialize(options={})
-          super(options)
-          @components = []
-          @mutex = Mutex.new
+        def mutex
+          @mutex ||= Mutex.new
         end
 
         # Essential part of board interface that components need.
         attr_reader :components
 
         def add_component(component)
+          @components ||= []
           @components << component
         end
 
diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index 9e2a77f5..07eb77f3 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -5,18 +5,36 @@ class Servo
       include Mixins::Threaded
 
       def after_initialize(options={})
-        board.servo_toggle(pin, :on)
+        super(options)
+        @min = options[:min] || 544
+        @max = options[:max] || 2400
+        attach
+      end
+
+      def attach
+        board.servo_toggle(pin, :on, min: @min, max: @max)
+      end
+
+      def detach
+        board.servo_toggle(pin, :off, min: @min, max: @max)
       end
 
       def position=(value)
-        @state = angle(value)
-        board.servo_write(pin, @state)
+        value = value % 180 unless value == 180
+
+        microseconds = ((value.to_f / 180) * (@max - @min)) + @min
+        board.servo_write(pin, microseconds.ceil)
+
+        @state = value
       end
 
+      alias :angle=   :position=
+      alias :angle    :state
       alias :position :state
 
-      def angle(value)
-        value == 180 ? value : value % 180
+      def write_microseconds(value)
+        raise 'invalud microsecond value' if value > @max || value < @min
+        board.servo_write(pin, value)
       end
     end
   end
diff --git a/src/lib/DinoServo.cpp b/src/lib/DinoServo.cpp
index 6691e353..631d0225 100644
--- a/src/lib/DinoServo.cpp
+++ b/src/lib/DinoServo.cpp
@@ -38,10 +38,13 @@ void Dino::servoToggle() {
   // Search by pin for in use servo object, attach and set active.
   else {
     boolean found = false;
+    uint16_t min = (auxMsg[1] << 8) | auxMsg[0];
+    uint16_t max = (auxMsg[3] << 8) | auxMsg[2];
+
     for (int i = 0;  i < SERVO_COUNT;  i++) {
       if (servos[i].pin == pin) {
         found = true;
-        servos[i].servo.attach(pin);
+        servos[i].servo.attach(pin, min, max);
         servos[i].active = true;
         break;
       }
@@ -50,8 +53,9 @@ void Dino::servoToggle() {
     if (found == false) {
       for (int i = 0;  i < SERVO_COUNT;  i++) {
         if (servos[i].active == false) {
-          servos[i].servo.attach(pin);
+          servos[i].servo.attach(pin, min, max);
           servos[i].active = true;
+          servos[i].pin = pin;
           break;
         }
       }
@@ -69,7 +73,8 @@ void Dino::servoWrite() {
   // Find servo by pin and write value to it.
   for (int i = 0;  i < SERVO_COUNT;  i++) {
     if (servos[i].pin == pin) {
-      servos[i].servo.write(val);
+      uint16_t us = (auxMsg[1] << 8) | auxMsg[0];
+      servos[i].servo.writeMicroseconds(us);
     }
   }
 

From 2b2cc8d5d3256e036764690aba2afabd097efad8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 22 Feb 2018 14:30:43 -0400
Subject: [PATCH 189/296] Add Servo#speed= for continuous rotation servos.

Maps from range -100..100 to @min..@max (minimum and maximum specified microsecond pulse values for the servo).
---
 lib/dino/components/servo.rb | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index 07eb77f3..3eb609ad 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -28,9 +28,19 @@ def position=(value)
         @state = value
       end
 
+      def speed=(value)
+        raise 'invalud speed value' if value > 100 || value < -100
+
+        microseconds = (((value.to_f + 100) / 200) * (@max - @min)) + @min
+        board.servo_write(pin, microseconds.ceil)
+
+        @state = value
+      end
+
       alias :angle=   :position=
       alias :angle    :state
       alias :position :state
+      alias :speed    :state
 
       def write_microseconds(value)
         raise 'invalud microsecond value' if value > @max || value < @min

From 2d44bad90403b214319a9aafed0ec9b98f732d1a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 8 Mar 2018 13:24:31 -0400
Subject: [PATCH 190/296] Switch from RSpec to MiniTest

---
 .travis.yml                                   |   2 +-
 Rakefile                                      |  13 +-
 dino.gemspec                                  |   2 +-
 examples/rgb_led/rgb_led.rb                   |   2 +-
 lib/dino/api/core.rb                          |   6 +-
 lib/dino/board/base.rb                        |   8 +-
 lib/dino/board/default.rb                     |   4 +-
 lib/dino/board/esp8266.rb                     |   8 +-
 lib/dino/components.rb                        |   2 +-
 lib/dino/components/basic/analog_input.rb     |   2 +-
 lib/dino/components/basic/digital_input.rb    |   2 +-
 lib/dino/components/i2c/bus.rb                |   6 +-
 lib/dino/components/lcd.rb                    |  28 +--
 lib/dino/components/mixins/bus_master.rb      |   9 +-
 lib/dino/components/mixins/callbacks.rb       |  28 ++-
 lib/dino/components/mixins/poller.rb          |   2 +-
 lib/dino/components/one_wire/bus.rb           |   3 +-
 .../components/one_wire/bus_enumerator.rb     |   4 +
 lib/dino/components/one_wire/slave.rb         |   2 +-
 lib/dino/components/register/input.rb         |   4 +-
 lib/dino/components/rgb_led.rb                |  15 +-
 lib/dino/components/servo.rb                  |   4 +-
 lib/dino/components/setup/base.rb             |  18 +-
 lib/dino/components/setup/multi_pin.rb        |   4 +-
 lib/dino/components/setup/single_pin.rb       |   7 +-
 lib/dino/components/stepper.rb                |   8 +-
 lib/dino/message.rb                           |  19 +-
 spec/lib/board_spec.rb                        | 229 ------------------
 .../lib/components/basic/analog_input_spec.rb |  35 ---
 .../components/basic/analog_output_spec.rb    |  39 ---
 .../components/basic/digital_input_spec.rb    |  59 -----
 .../components/basic/digital_output_spec.rb   |  57 -----
 spec/lib/components/ir_emitter_spec.rb        |  27 ---
 spec/lib/components/lcd_spec.rb               | 127 ----------
 spec/lib/components/led_spec.rb               |   9 -
 spec/lib/components/mixins/callbacks_spec.rb  | 100 --------
 spec/lib/components/mixins/listener_spec.rb   |  58 -----
 spec/lib/components/mixins/poller_spec.rb     |  66 -----
 spec/lib/components/mixins/reader_spec.rb     |  78 ------
 spec/lib/components/mixins/threaded_spec.rb   | 118 ---------
 spec/lib/components/one_wire/ds18b20_spec.rb  |  66 -----
 .../components/one_wire/enumerator_spec.rb    | 140 -----------
 spec/lib/components/one_wire/slave_spec.rb    | 125 ----------
 spec/lib/components/register/select_spec.rb   |  30 ---
 spec/lib/components/register/shift_in_spec.rb |  87 -------
 .../lib/components/register/shift_out_spec.rb |  40 ---
 spec/lib/components/rgb_led_spec.rb           |  65 -----
 spec/lib/components/sensor_spec.rb            |   8 -
 spec/lib/components/servo_spec.rb             |  42 ----
 spec/lib/components/setup/base_spec.rb        |  30 ---
 spec/lib/components/setup/input_spec.rb       |  39 ---
 spec/lib/components/setup/multi_pin_spec.rb   |  73 ------
 spec/lib/components/setup/output_spec.rb      |  25 --
 spec/lib/components/setup/single_pin_spec.rb  |  39 ---
 spec/lib/components/softwareserial_spec.rb    |  23 --
 spec/lib/components/ssd_spec.rb               |  78 ------
 spec/lib/components/stepper_spec.rb           |  39 ---
 spec/lib/message_spec.rb                      |  47 ----
 spec/lib/tx_rx/serial_spec.rb                 | 149 ------------
 spec/lib/tx_rx/tcp_spec.rb                    |  37 ---
 spec/spec_helper.rb                           |  24 --
 src/lib/Dino.cpp                              |   1 +
 test/api/core_test.rb                         | 136 +++++++++++
 test/board_mock.rb                            |   8 +
 test/board_test.rb                            | 113 +++++++++
 test/components/basic/analog_input_test.rb    |  40 +++
 test/components/basic/analog_output_test.rb   |  41 ++++
 test/components/basic/digital_input_test.rb   |  61 +++++
 test/components/basic/digital_output_test.rb  |  59 +++++
 test/components/ir_emitter_test.rb            |  29 +++
 test/components/lcd_test.rb                   |  49 ++++
 test/components/led_test.rb                   |  21 ++
 test/components/mixins/callbacks_test.rb      |  77 ++++++
 test/components/mixins/listener_test.rb       |  57 +++++
 test/components/mixins/poller_test.rb         |  66 +++++
 test/components/mixins/reader_test.rb         |  56 +++++
 test/components/mixins/threaded_test.rb       | 100 ++++++++
 test/components/one_wire/ds18b20_test.rb      |  80 ++++++
 test/components/one_wire/enumerator_test.rb   | 141 +++++++++++
 test/components/one_wire/helper_test.rb       |   1 +
 test/components/one_wire/slave_test.rb        | 151 ++++++++++++
 test/components/register/select_test.rb       |  26 ++
 test/components/register/shift_in_test.rb     |  70 ++++++
 test/components/register/shift_out_test.rb    |  33 +++
 test/components/rgb_led_test.rb               |  66 +++++
 test/components/servo_test.rb                 |  63 +++++
 test/components/setup/base_test.rb            |  22 ++
 test/components/setup/input_test.rb           |  42 ++++
 test/components/setup/multi_pin_test.rb       |  61 +++++
 test/components/setup/output_test.rb          |  25 ++
 test/components/setup/single_pin_test.rb      |  21 ++
 test/components/software_serial_test.rb       |  33 +++
 test/components/ssd_test.rb                   |  82 +++++++
 test/components/stepper_test.rb               |  49 ++++
 test/message_test.rb                          |  44 ++++
 test/test_helper.rb                           |  29 +++
 test/txrx/serial_test.rb                      | 159 ++++++++++++
 test/txrx/tcp_test.rb                         |  43 ++++
 test/txrx_mock.rb                             |  10 +
 99 files changed, 2290 insertions(+), 2295 deletions(-)
 delete mode 100644 spec/lib/board_spec.rb
 delete mode 100644 spec/lib/components/basic/analog_input_spec.rb
 delete mode 100644 spec/lib/components/basic/analog_output_spec.rb
 delete mode 100644 spec/lib/components/basic/digital_input_spec.rb
 delete mode 100644 spec/lib/components/basic/digital_output_spec.rb
 delete mode 100644 spec/lib/components/ir_emitter_spec.rb
 delete mode 100644 spec/lib/components/lcd_spec.rb
 delete mode 100644 spec/lib/components/led_spec.rb
 delete mode 100644 spec/lib/components/mixins/callbacks_spec.rb
 delete mode 100644 spec/lib/components/mixins/listener_spec.rb
 delete mode 100644 spec/lib/components/mixins/poller_spec.rb
 delete mode 100644 spec/lib/components/mixins/reader_spec.rb
 delete mode 100644 spec/lib/components/mixins/threaded_spec.rb
 delete mode 100644 spec/lib/components/one_wire/ds18b20_spec.rb
 delete mode 100644 spec/lib/components/one_wire/enumerator_spec.rb
 delete mode 100644 spec/lib/components/one_wire/slave_spec.rb
 delete mode 100644 spec/lib/components/register/select_spec.rb
 delete mode 100644 spec/lib/components/register/shift_in_spec.rb
 delete mode 100644 spec/lib/components/register/shift_out_spec.rb
 delete mode 100644 spec/lib/components/rgb_led_spec.rb
 delete mode 100644 spec/lib/components/sensor_spec.rb
 delete mode 100644 spec/lib/components/servo_spec.rb
 delete mode 100644 spec/lib/components/setup/base_spec.rb
 delete mode 100644 spec/lib/components/setup/input_spec.rb
 delete mode 100644 spec/lib/components/setup/multi_pin_spec.rb
 delete mode 100644 spec/lib/components/setup/output_spec.rb
 delete mode 100644 spec/lib/components/setup/single_pin_spec.rb
 delete mode 100644 spec/lib/components/softwareserial_spec.rb
 delete mode 100644 spec/lib/components/ssd_spec.rb
 delete mode 100644 spec/lib/components/stepper_spec.rb
 delete mode 100644 spec/lib/message_spec.rb
 delete mode 100644 spec/lib/tx_rx/serial_spec.rb
 delete mode 100644 spec/lib/tx_rx/tcp_spec.rb
 delete mode 100644 spec/spec_helper.rb
 create mode 100644 test/api/core_test.rb
 create mode 100644 test/board_mock.rb
 create mode 100644 test/board_test.rb
 create mode 100644 test/components/basic/analog_input_test.rb
 create mode 100644 test/components/basic/analog_output_test.rb
 create mode 100644 test/components/basic/digital_input_test.rb
 create mode 100644 test/components/basic/digital_output_test.rb
 create mode 100644 test/components/ir_emitter_test.rb
 create mode 100644 test/components/lcd_test.rb
 create mode 100644 test/components/led_test.rb
 create mode 100644 test/components/mixins/callbacks_test.rb
 create mode 100644 test/components/mixins/listener_test.rb
 create mode 100644 test/components/mixins/poller_test.rb
 create mode 100644 test/components/mixins/reader_test.rb
 create mode 100644 test/components/mixins/threaded_test.rb
 create mode 100644 test/components/one_wire/ds18b20_test.rb
 create mode 100644 test/components/one_wire/enumerator_test.rb
 create mode 100644 test/components/one_wire/helper_test.rb
 create mode 100644 test/components/one_wire/slave_test.rb
 create mode 100644 test/components/register/select_test.rb
 create mode 100644 test/components/register/shift_in_test.rb
 create mode 100644 test/components/register/shift_out_test.rb
 create mode 100644 test/components/rgb_led_test.rb
 create mode 100644 test/components/servo_test.rb
 create mode 100644 test/components/setup/base_test.rb
 create mode 100644 test/components/setup/input_test.rb
 create mode 100644 test/components/setup/multi_pin_test.rb
 create mode 100644 test/components/setup/output_test.rb
 create mode 100644 test/components/setup/single_pin_test.rb
 create mode 100644 test/components/software_serial_test.rb
 create mode 100644 test/components/ssd_test.rb
 create mode 100644 test/components/stepper_test.rb
 create mode 100644 test/message_test.rb
 create mode 100644 test/test_helper.rb
 create mode 100644 test/txrx/serial_test.rb
 create mode 100644 test/txrx/tcp_test.rb
 create mode 100644 test/txrx_mock.rb

diff --git a/.travis.yml b/.travis.yml
index 0627979d..46f3b26c 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -8,4 +8,4 @@ rvm:
   - 2.0.0
   - jruby-9.1.15.0
 
-script: bundle exec rspec spec
+script: bundle exec rake test
diff --git a/Rakefile b/Rakefile
index 133cb3ef..9ff320d9 100644
--- a/Rakefile
+++ b/Rakefile
@@ -1,10 +1,11 @@
 #!/usr/bin/env rake
 require "bundler/gem_tasks"
+require 'rake/testtask'
 
-task :default => [:spec]
-
-require 'rspec/core/rake_task'
-desc "Run specs"
-RSpec::Core::RakeTask.new do |t|
-  t.pattern = 'spec/**/*_spec.rb'
+task :default => [:test]
+Rake::TestTask.new do |t|
+  t.libs << "lib"
+  t.libs << "test"
+  t.warning = false
+  t.test_files = FileList['test/**/*_test.rb']
 end
diff --git a/dino.gemspec b/dino.gemspec
index d2f2a53b..7d9d24cb 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -38,5 +38,5 @@ Gem::Specification.new do |gem|
   gem.add_dependency 'bcd', '~> 0.3.0'
 
   gem.add_development_dependency 'rake'
-  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'minitest'
 end
diff --git a/examples/rgb_led/rgb_led.rb b/examples/rgb_led/rgb_led.rb
index c72c4d51..20e45031 100644
--- a/examples/rgb_led/rgb_led.rb
+++ b/examples/rgb_led/rgb_led.rb
@@ -6,7 +6,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-led = Dino::Components::RgbLed.new(pins: {red: 11, green: 10, blue: 9}, board: board)
+led = Dino::Components::RGBLed.new(pins: {red: 11, green: 10, blue: 9}, board: board)
 potentiometer = Dino::Components::Sensor.new(pin: 'A0', board: board)
 
 
diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index bbda7e56..14eadb3a 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -8,9 +8,9 @@ module Core
       # CMD = 0
       def set_pin_mode(pin, mode)
         pin, value = convert_pin(pin), mode == :out ? 0 : 1
-        write Dino::Message.encode command: 0,
-                                   pin: convert_pin(pin),
-                                   value: value
+        write Message.encode command: 0,
+                             pin: convert_pin(pin),
+                             value: value
       end
 
       # CMD = 1
diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index d70c6aa1..df99bc38 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -10,13 +10,19 @@ def initialize(io, options={})
 
         ack = io.handshake.split(",").map { |num| num.to_i }
         @aux_limit, @analog_zero, @dac_zero = ack
+        # Leave room for null termination.
+        @aux_limit = @aux_limit - 1
 
         io.add_observer(self)
         self.analog_resolution = options[:bits] || 8
       end
 
+      def analog_resolution
+        @bits ||= 8
+      end
+
       def analog_resolution=(value)
-        @bits = value || 8
+        @bits = value
         write Dino::Message.encode(command: 96, value: @bits)
         @low  = 0
         @high = 1
diff --git a/lib/dino/board/default.rb b/lib/dino/board/default.rb
index 076a5121..57d19b91 100644
--- a/lib/dino/board/default.rb
+++ b/lib/dino/board/default.rb
@@ -18,7 +18,7 @@ def convert_pin(pin)
         return pin.to_i             if pin.match(DIGITAL_REGEX)
         return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
         return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
-        raise "Incorrect pin format"
+        raise ArgumentError, "incorrect pin format"
       end
 
       def analog_pin_to_i(pin)
@@ -26,7 +26,7 @@ def analog_pin_to_i(pin)
       end
 
       def dac_pin_to_i(pin)
-        raise "The board did not specify any DAC pins" unless @dac_zero
+        raise ArgumentError, "board does not specify DAC pins" unless @dac_zero
         @dac_zero + pin.gsub(/\Adac/i, '').to_i
       end
     end
diff --git a/lib/dino/board/esp8266.rb b/lib/dino/board/esp8266.rb
index a50fbd53..7ebca523 100644
--- a/lib/dino/board/esp8266.rb
+++ b/lib/dino/board/esp8266.rb
@@ -34,26 +34,26 @@ def convert_pin(pin)
         return gpio_pin_to_i(pin)    if pin.match(GPIO_REGEX)
         return analog_pin_to_i(pin)  if pin.match(ANALOG_REGEX)
         return digital_pin_to_i(pin) if pin.match(DIGITAL_REGEX)
-        raise "Incorrect pin format"
+        raise ArgumentError, "incorrect pin format"
       end
 
       # Only one analog in on the ESP8266, GPIO 17.
       def analog_pin_to_i(pin)
         gpio = pin.gsub(/\Aa/i, '').to_i
-        raise "Invalid analog input pin" unless gpio == 0
+        raise ArgumentError, "invalid analog input pin" unless gpio == 0
         17
       end
 
       def gpio_pin_to_i(pin)
         gpio = pin.gsub(/\Agpio/i, '').to_i
-        raise "Invalid GPIO input pin" if (gpio < 0 || gpio > 17)
+        raise ArgumentError, "invalid GPIO pin" if (gpio < 0 || gpio > 17)
         gpio
       end
 
       def digital_pin_to_i(pin)
         d_index = pin.gsub(/\Ad/i, '').to_i
         gpio = D_PIN_MAP[d_index]
-        raise "Invalid D pin" unless gpio
+        raise ArgumentError, "invalid D pin" unless gpio
         gpio
       end
     end
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index f8221d63..a29c5a45 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -9,7 +9,7 @@ module Components
     autoload :Led,              'dino/components/led'
     autoload :Button,           'dino/components/button'
     autoload :Sensor,           'dino/components/sensor'
-    autoload :RgbLed,           'dino/components/rgb_led'
+    autoload :RGBLed,           'dino/components/rgb_led'
     autoload :Servo,            'dino/components/servo'
     autoload :SSD,              'dino/components/ssd'
     autoload :Stepper,          'dino/components/stepper'
diff --git a/lib/dino/components/basic/analog_input.rb b/lib/dino/components/basic/analog_input.rb
index ff977c43..86b3c54b 100644
--- a/lib/dino/components/basic/analog_input.rb
+++ b/lib/dino/components/basic/analog_input.rb
@@ -13,7 +13,7 @@ def _read
         end
 
         def _listen(divider=16)
-          @divider ||= 16
+          @divider = divider || 16
           board.analog_listen(pin, @divider)
         end
       end
diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index 002125fb..3ef4558a 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -18,7 +18,7 @@ def _read
         end
 
         def _listen(divider=4)
-          @divider ||= 4
+          @divider = divider || 4
           board.digital_listen(pin, @divider)
         end
 
diff --git a/lib/dino/components/i2c/bus.rb b/lib/dino/components/i2c/bus.rb
index 6e9496fc..c36db726 100644
--- a/lib/dino/components/i2c/bus.rb
+++ b/lib/dino/components/i2c/bus.rb
@@ -19,7 +19,7 @@ def search
         end
 
         def write(address, bytes=[], options={})
-          board.i2c_write(address, bytes, options)
+          board.i2c_write(address, [bytes].flatten, options)
         end
 
         def read(*args)
@@ -32,7 +32,7 @@ def _read(address, register, num_bytes=1, options={})
 
         def bubble_callbacks
           add_callback(:bus_master) do |str|
-            if str.match /d*-/
+            if str.match(/d*-/)
               address, data = str.split("-", 2)
               address = address.to_i
               data = data.split(",").map(&:to_i)
@@ -42,7 +42,7 @@ def bubble_callbacks
         end
 
         def update_component(hash)
-          @components.each do |component|
+          components.each do |component|
             if component.address == hash[:address]
               component.update(hash[:data])
             end
diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index 6d4d85b2..81778671 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -29,20 +29,20 @@ def after_initialize(options)
       end
 
       LIBRARY_COMMANDS = {
-        clear:              '2',
-        home:               '3',
-        show_cursor:        '6',
-        hide_cursor:        '7',
-        blink:              '8',
-        no_blink:           '9',
-        on:                '10',
-        off:               '11',
-        scroll_left:       '12',
-        scroll_right:      '13',
-        enable_autoscroll: '14',
-        disable_autoscroll:'15',
-        left_to_right:     '16',
-        right_to_left:     '17'
+        clear:              2,
+        home:               3,
+        show_cursor:        6,
+        hide_cursor:        7,
+        blink:              8,
+        no_blink:           9,
+        on:                10,
+        off:               11,
+        scroll_left:       12,
+        scroll_right:      13,
+        enable_autoscroll: 14,
+        disable_autoscroll:15,
+        left_to_right:     16,
+        right_to_left:     17
       }
 
       LIBRARY_COMMANDS.each_pair do |command, command_id|
diff --git a/lib/dino/components/mixins/bus_master.rb b/lib/dino/components/mixins/bus_master.rb
index 731ffb4e..3cddfa41 100644
--- a/lib/dino/components/mixins/bus_master.rb
+++ b/lib/dino/components/mixins/bus_master.rb
@@ -7,15 +7,16 @@ def mutex
         end
 
         # Essential part of board interface that components need.
-        attr_reader :components
+        def components
+          @components ||= []
+        end
 
         def add_component(component)
-          @components ||= []
-          @components << component
+          components << component
         end
 
         def remove_component(component)
-          @components.delete(component)
+          components.delete(component)
         end
       end
     end
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index cfcbf51f..13b84f27 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -2,6 +2,9 @@ module Dino
   module Components
     module Mixins
       module Callbacks
+        attr_reader :callback_mutex, :callbacks
+        attr_writer :callbacks
+
         def after_initialize(options={})
           super(options)
           @callbacks = {}
@@ -9,14 +12,14 @@ def after_initialize(options={})
         end
 
         def add_callback(key=:persistent, &block)
-          @callback_mutex.synchronize do
+          callback_mutex.synchronize do
             @callbacks[key] ||= []
             @callbacks[key] << block
           end
         end
 
         def remove_callback(key=nil)
-          @callback_mutex.synchronize do
+          callback_mutex.synchronize do
             key ? @callbacks.delete(key) : @callbacks = {}
           end
         end
@@ -26,13 +29,17 @@ def remove_callback(key=nil)
 
         def update(data)
           data = pre_callback_filter(data)
-          @callback_mutex.synchronize do
-            @callbacks.each_value do |array|
-              array.each { |callback| callback.call(data) }
+
+          callback_mutex.synchronize do
+            callbacks.each_value do |array|
+              array.each do |callback|
+                callback.call(data)
+              end
             end
-            # Remove the special :read callback while still inside the lock.
-            @callbacks.delete(:read)
+            # Remove special :read callback before unlocking.
+            callbacks.delete(:read)
           end
+
           update_self(data)
         end
 
@@ -41,10 +48,9 @@ def pre_callback_filter(data)
           data
         end
 
-        # Set @state to the value passed to callbacks after running them all.
-        # Override if some other behavior is needed.
-        def update_self(data)
-          @state = data
+        # Override if behavior other than @state = filtered data is needed.
+        def update_self(filtered_data)
+          self.state = filtered_data
         end
       end
     end
diff --git a/lib/dino/components/mixins/poller.rb b/lib/dino/components/mixins/poller.rb
index 770ff6f4..8f9fb4b9 100644
--- a/lib/dino/components/mixins/poller.rb
+++ b/lib/dino/components/mixins/poller.rb
@@ -16,7 +16,7 @@ def poll_using(method, interval=1, &block)
         end
 
         def poll(interval=1, &block)
-          poll_using(self.method(:_read), interval, &block)
+          poll_using(method(:_read), interval, &block)
         end
 
         def stop
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index 75ed0947..7b3b81b6 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -6,11 +6,10 @@ class Bus
         include Mixins::BusMaster
         include Mixins::Reader
 
-        attr_reader :found_devices, :parasite_power
+        attr_reader :parasite_power
 
         def after_initialize(options = {})
           super(options)
-          @found_devices = []
           read_power_supply
         end
 
diff --git a/lib/dino/components/one_wire/bus_enumerator.rb b/lib/dino/components/one_wire/bus_enumerator.rb
index a4f6fc6e..bf277377 100644
--- a/lib/dino/components/one_wire/bus_enumerator.rb
+++ b/lib/dino/components/one_wire/bus_enumerator.rb
@@ -8,6 +8,10 @@ def _search(branch_mask)
           board.one_wire_search(pin, branch_mask)
         end
 
+        def found_devices
+          @found_devices ||= []
+        end
+
         def search
           @found_devices = []
           branch_mask = 0
diff --git a/lib/dino/components/one_wire/slave.rb b/lib/dino/components/one_wire/slave.rb
index 4df09665..ab92f7db 100644
--- a/lib/dino/components/one_wire/slave.rb
+++ b/lib/dino/components/one_wire/slave.rb
@@ -21,7 +21,7 @@ def write_scratch(*bytes)
           atomically do
             match
             bus.write(WRITE_SCRATCH)
-            bus.write(bytes)
+            bus.write(*bytes)
           end
         end
 
diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index bd92a8c2..3a7f670d 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -5,6 +5,8 @@ module Input
         include Setup::Base
         include Mixins::Callbacks
 
+        attr_reader :bytes
+
         def after_initialize(options={})
           super(options) if defined?(super)
           #
@@ -118,7 +120,7 @@ def stop
         def enable_proxy
           self.add_callback(:board_proxy) do |bit_array|
             bit_array.each_with_index do |value, pin|
-              @components.each do |part|
+              components.each do |part|
                 update_component(part, pin, value) if pin == part.pin
               end
               @reading_pins[pin] = false
diff --git a/lib/dino/components/rgb_led.rb b/lib/dino/components/rgb_led.rb
index 2c92cc08..5ba14252 100644
--- a/lib/dino/components/rgb_led.rb
+++ b/lib/dino/components/rgb_led.rb
@@ -1,12 +1,12 @@
 module Dino
   module Components
-    class RgbLed
+    class RGBLed
       include Setup::MultiPin
 
       proxy_pins red:   Basic::AnalogOutput,
                  green: Basic::AnalogOutput,
-                 blue:  Basic::AnalogOutput 
-      
+                 blue:  Basic::AnalogOutput
+
       # Format: [R, G, B]
       COLORS = {
         red:     [255, 000, 000],
@@ -27,17 +27,10 @@ def write(array)
 
       def color=(color)
         return write(color) if color.class == Array
-        
+
         color = color.to_sym
         write(COLORS[color]) if COLORS.include? color
       end
-
-      def cycle
-        [:red, :green, :blue].cycle do |color|
-          self.color = color
-          sleep(0.01)
-        end
-      end
     end
   end
 end
diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index 3eb609ad..4768347a 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -23,7 +23,7 @@ def position=(value)
         value = value % 180 unless value == 180
 
         microseconds = ((value.to_f / 180) * (@max - @min)) + @min
-        board.servo_write(pin, microseconds.ceil)
+        board.servo_write(pin, microseconds.round)
 
         @state = value
       end
@@ -32,7 +32,7 @@ def speed=(value)
         raise 'invalud speed value' if value > 100 || value < -100
 
         microseconds = (((value.to_f + 100) / 200) * (@max - @min)) + @min
-        board.servo_write(pin, microseconds.ceil)
+        board.servo_write(pin, microseconds.round)
 
         @state = value
       end
diff --git a/lib/dino/components/setup/base.rb b/lib/dino/components/setup/base.rb
index d194c255..802ef181 100644
--- a/lib/dino/components/setup/base.rb
+++ b/lib/dino/components/setup/base.rb
@@ -2,9 +2,14 @@ module Dino
   module Components
     module Setup
       module Base
-        attr_reader :board, :state
+        attr_reader :board
+
+        def state
+          @state_mutex.synchronize { @state }
+        end
 
         def initialize(options={})
+          @state_mutex = Mutex.new
           initialize_board(options)
           initialize_pins(options)
           register
@@ -13,11 +18,16 @@ def initialize(options={})
 
         protected
 
-        attr_writer :board, :state
+        def state=(value)
+          @state_mutex.synchronize { @state = value }
+        end
 
         def initialize_board(options={})
-          raise 'a board is required for a component' unless options[:board]
-          self.board = options[:board]
+          if options[:board]
+            @board = options[:board]
+          else
+            raise ArgumentError, 'a board is required for a component'
+          end
         end
 
         def register
diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
index 9a0baa2d..9cf1c440 100644
--- a/lib/dino/components/setup/multi_pin.rb
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -81,7 +81,9 @@ def initialize_pins(options={})
 
         def validate_pins
           required_pins = self.class.class_eval('@@required_pins') rescue []
-          required_pins.each { |key| raise "missing pins[:#{key}] pin" unless pins[key] }
+          required_pins.each do |key|
+            raise ArgumentError, 'missing pins[:#{key}] pin' unless pins[key]
+          end
         end
 
         def build_proxies
diff --git a/lib/dino/components/setup/single_pin.rb b/lib/dino/components/setup/single_pin.rb
index 09e2f4ed..4ae5286f 100644
--- a/lib/dino/components/setup/single_pin.rb
+++ b/lib/dino/components/setup/single_pin.rb
@@ -10,8 +10,11 @@ module SinglePin
         attr_writer :pin
 
         def initialize_pins(options={})
-          raise 'a pin is required for this component' unless options[:pin]
-          self.pin = board.convert_pin(options[:pin])
+          if options[:pin]
+            self.pin = options[:pin]
+          else
+            raise ArgumentError, 'a pin is required for this component'
+          end
         end
 
         def mode=(mode)
diff --git a/lib/dino/components/stepper.rb b/lib/dino/components/stepper.rb
index 3f739f76..4d355535 100644
--- a/lib/dino/components/stepper.rb
+++ b/lib/dino/components/stepper.rb
@@ -1,11 +1,11 @@
 module Dino
   module Components
     class Stepper
-      include Setup::MultiPin 
-      
+      include Setup::MultiPin
+
       proxy_pins  step:      Basic::DigitalOutput,
                   direction: Basic::DigitalOutput
-    
+
       def step_cc
         direction.high
         step.high
@@ -17,6 +17,8 @@ def step_cw
         step.high
         step.low
       end
+
+      alias :step_ccw :step_cc
     end
   end
 end
diff --git a/lib/dino/message.rb b/lib/dino/message.rb
index 91fa9959..67fa9445 100644
--- a/lib/dino/message.rb
+++ b/lib/dino/message.rb
@@ -1,5 +1,7 @@
 module Dino
   module Message
+    BYTE_RANGE = (0..255)
+
     def self.encode(options={})
       cmd = options[:command]
       pin = options[:pin]
@@ -7,11 +9,18 @@ def self.encode(options={})
       aux = options[:aux_message]
       aux = aux.to_s.gsub("\\","\\\\\\\\").gsub("\n", "\\\n") if aux
 
-      raise Exception.new('command must be specified') unless cmd
-      raise Exception.new('commands can only be four digits') if cmd.to_s.length > 4
-      raise Exception.new('pins can only be four digits') if pin.to_s.length > 4
-      raise Exception.new('values can only be four digits') if val.to_s.length > 4
-      raise Exception.new('auxillary messages are limited to 512 characters') if aux.to_s.length > 512
+      unless cmd && BYTE_RANGE.include?(cmd)
+        raise ArgumentError, 'command missing or not integer in range 0 to 255'
+      end
+      if pin && !BYTE_RANGE.include?(pin)
+        raise ArgumentError, 'pin must be integer in range 0 to 255'
+      end
+      if val && !BYTE_RANGE.include?(val)
+        raise ArgumentError, 'value must be integer in range 0 to 255'
+      end
+      if aux.to_s.length > 512
+        raise ArgumentError, 'auxillary messages are limited to 512 characters'
+      end
 
       message = ""
       [aux, val, pin].each do |fragment|
diff --git a/spec/lib/board_spec.rb b/spec/lib/board_spec.rb
deleted file mode 100644
index 381fbb07..00000000
--- a/spec/lib/board_spec.rb
+++ /dev/null
@@ -1,229 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  describe Dino::Board do
-    def io_mock(methods = {})
-      @io ||= double :io, { add_observer: true,
-                            handshake: "528,14,20",
-                            write: true,
-                            read: true
-                          }.merge(methods)
-    end
-
-    subject { Board.new(io_mock) }
-
-    describe '#initialize' do
-      it 'should require an io object' do
-        expect { Board.new() }.to raise_exception
-      end
-
-      it 'should observe the io' do
-        expect(io_mock).to receive(:add_observer).with(subject)
-        subject.send(:initialize, io_mock)
-      end
-
-      it 'should initiate the handshake' do
-        expect(io_mock).to receive(:handshake)
-        subject
-      end
-
-      it 'should set @analog_zero' do
-        expect(subject.analog_zero).to equal(14)
-      end
-
-      it 'should set @dac_zero' do
-        expect(subject.dac_zero).to equal(20)
-      end
-
-      it 'should set digital high and low' do
-        board = Board.new(io_mock)
-        expect(board.low).to equal(0)
-        expect(board.high).to equal(1)
-      end
-
-      it 'should set analog high separately' do
-        board = Board.new(io_mock)
-        expect(board.analog_high).to equal(255)
-      end
-    end
-
-    describe '#update' do
-      it 'should pass messages from a pin to the right part' do
-        subject.add_component(part1 = double(pin: 7))
-        subject.add_component(part2 = double(pin: 9))
-
-        expect(part1).to receive(:update).with('wake up!')
-        expect(part2).to_not receive(:update).with('wake up!')
-        subject.update(7, 'wake up!')
-      end
-
-      it 'should silently ignore messages from a pin if there is no part on it' do
-        expect { subject.update(5, 'wake up!') }.to_not raise_exception
-      end
-    end
-
-    describe '#add_component' do
-      it 'should put the part in the components array' do
-        subject.add_component(part = double)
-        expect(subject.components).to include(part)
-      end
-    end
-
-    describe '#remove_component' do
-      it 'should remove the part from the components array and stop listening' do
-        subject.add_component(part = double(pin: 12))
-        expect(subject).to receive(:stop_listener).with(12)
-        subject.remove_component(part)
-        expect(subject.components).to be_empty
-      end
-    end
-
-    describe '#write' do
-      it 'should call #write on the io with the message' do
-        expect(io_mock).to receive(:write).with('message')
-        subject.write('message')
-      end
-    end
-
-    describe '#convert_pin' do
-      before(:each) { subject.instance_variable_set(:@analog_zero, 14) }
-
-      it 'should leave numeric pins as is' do
-        expect(subject.convert_pin '13').to equal(13)
-      end
-
-      it 'should convert analog pins to numeric form' do
-        expect(subject.convert_pin 'A1').to equal(15)
-      end
-
-      it 'should convert dac pins to numeric form' do
-        expect(subject.convert_pin 'DAC1').to equal(21)
-      end
-
-      it 'should raise if trying to convert a dac pin and the board has none' do
-        subject.instance_variable_set(:@dac_zero, nil)
-        expect { subject.convert_pin 'DAC1' }.to raise_exception(/dac/i)
-      end
-
-      it 'should raise if trying to convert a wrongly formatted pin' do
-        expect { subject.convert_pin 'ADC1' }.to raise_exception(/incorrect/i)
-      end
-    end
-
-    #
-    # Board API Tests
-    #
-    describe '#set_pin_mode' do
-      it 'should send a value of 0 if the pin mode is set to out' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 0))
-        subject.set_pin_mode(13, :out)
-      end
-
-      it 'should send a value of 1 if the pin mode is set to in' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 0, pin: 13, value: 1))
-        subject.set_pin_mode(13, :in)
-      end
-    end
-
-    describe '#set_pullup' do
-      it 'should write high if pullup is enabled' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.high))
-        subject.set_pullup(13, true)
-      end
-
-      it 'should write low if pullup is disabled' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode(command: 1, pin: 13, value: subject.low))
-        subject.set_pullup(13, false)
-      end
-    end
-
-    describe '#digital_write' do
-      it 'should digitalWrite the value to the pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 1, pin: 1, value: 255)
-        subject.digital_write(01, 255)
-      end
-    end
-
-    describe '#digital_read' do
-      it 'should digitalRead once from the given pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 2, pin: 13)
-        subject.digital_read(13)
-      end
-    end
-
-    describe '#analog_write' do
-      it 'should analogWrite the value to the pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 3, pin: 1, value: 3)
-        subject.analog_write(01, 3)
-      end
-    end
-
-    describe '#analog_read' do
-      it 'should analogRead once from the given pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 4, pin: 13)
-        subject.analog_read(13)
-      end
-    end
-
-    describe '#set_listener' do
-      it 'should set the right pin' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b00000011)
-        subject.set_listener(11, :off)
-      end
-      it 'should set the right mode' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b01000011)
-        subject.set_listener(11, :off, mode: :analog)
-      end
-      it 'should set the right state' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b11000011)
-        subject.set_listener(11, :on, mode: :analog)
-      end
-      it 'should set the right divider' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 7, pin: 11, value: 0b11000000)
-        subject.set_listener(11, :on, mode: :analog, divider: 1)
-      end
-    end
-
-    describe '#digital_listen' do
-      it 'should start listening for a digital signal on the given pin' do
-        expect(subject).to receive(:set_listener).with(13, :on, mode: :digital, divider: 4)
-        subject.digital_listen(13)
-      end
-    end
-
-    describe '#analog_listen' do
-      it 'should start listening for an analog signal on the given pin' do
-        expect(subject).to receive(:set_listener).with(13, :on, mode: :analog, divider: 16)
-        subject.analog_listen(13)
-      end
-    end
-
-    describe '#stop_listener' do
-      it 'should stop listening for any signal on the given pin' do
-        expect(subject).to receive(:set_listener).with(13, :off)
-        subject.stop_listener(13)
-      end
-    end
-
-    describe '#analog_resolution=' do
-      it 'should tell the board to change the resolution' do
-        expect(io_mock).to receive(:write).with(Dino::Message.encode command: 96, value: 10)
-        subject.analog_resolution = 10
-      end
-
-      it 'should set @bits' do
-        subject.analog_resolution = 12
-        expect(subject.instance_variable_get(:@bits)).to equal(12)
-      end
-
-      it 'should set @high and @low correctly' do
-        subject.analog_resolution = 8
-        expect(subject.low).to equal(0)
-        expect(subject.analog_high).to equal(255)
-
-        subject.analog_resolution = 10
-        expect(subject.analog_high).to equal(1023)
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/basic/analog_input_spec.rb b/spec/lib/components/basic/analog_input_spec.rb
deleted file mode 100644
index e5c438d6..00000000
--- a/spec/lib/components/basic/analog_input_spec.rb
+++ /dev/null
@@ -1,35 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Basic
-      describe AnalogInput do
-        include BoardMock
-        let(:options) { { pin: 'A0', board: board } }
-        subject { AnalogInput.new(options) }
-
-        describe '#_read' do
-          it 'should send #analog_read to the board with its pin' do
-            expect(board).to receive(:analog_read).with(subject.pin)
-            subject._read
-          end
-        end
-
-        describe '#_listen' do
-          it 'should send #analog_listen to the board with its pin and divider' do
-            expect(board).to receive(:analog_listen).with(subject.pin, 16)
-            subject._listen
-          end
-        end
-
-
-        describe '#_stop_listener' do
-          it 'should send #stop_listener to the board with its pin' do
-            expect(board).to receive(:stop_listener).with(subject.pin)
-            subject._stop_listener
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/basic/analog_output_spec.rb b/spec/lib/components/basic/analog_output_spec.rb
deleted file mode 100644
index ea2eaf07..00000000
--- a/spec/lib/components/basic/analog_output_spec.rb
+++ /dev/null
@@ -1,39 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Basic
-      describe AnalogOutput do
-      	include BoardMock
-      	let(:options) { { pin: '9', board: board } }
-        subject { AnalogOutput.new(options) }
-
-      	describe '#analog_write' do
-          it 'should update the @state instance variable and call #analog_write on the board' do
-            expect(board).to receive(:analog_write).with(subject.pin, 128).once
-
-            subject.analog_write(128)
-            expect(subject.state).to eq(128)
-          end
-        end
-
-        describe '#write' do
-          it 'should call #digital_write with board.high if value is board.analog_high' do
-            expect(subject).to receive(:digital_write).with(board.high)
-            subject.write(board.analog_high)
-          end
-
-          it 'should call #digital_write with board.low if value is board.low' do
-            expect(subject).to receive(:digital_write).with(board.low)
-            subject.write(board.low)
-          end
-
-          it 'should call #analog_write if value is anything else' do
-            expect(subject).to receive(:analog_write).with(128)
-            subject.write(128)
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/basic/digital_input_spec.rb b/spec/lib/components/basic/digital_input_spec.rb
deleted file mode 100644
index dd82fde2..00000000
--- a/spec/lib/components/basic/digital_input_spec.rb
+++ /dev/null
@@ -1,59 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Basic
-      describe DigitalInput do
-        include BoardMock
-        let(:options) { { pin: 'A0', board: board } }
-        subject { DigitalInput.new(options) }
-
-        it 'should start listening immediately' do
-          expect(board).to receive(:digital_listen).with(14, 4)
-          component = DigitalInput.new(options)
-        end
-
-        describe '#_read' do
-          it 'should call board#digital_read with its pin once' do
-            expect(board).to receive(:digital_read).with(subject.pin).once
-            subject._read
-          end
-        end
-
-        describe '#_listen' do
-          it 'should call board#digital_listen with its pin once' do
-            expect(board).to receive(:digital_listen).with(subject.pin, 4).once
-            subject._listen
-          end
-        end
-
-        context 'callbacks' do
-          before :each do
-            @low_callback = double
-            @high_callback = double
-            subject.on_low { @low_callback.called }
-            subject.on_high { @high_callback.called }
-          end
-
-          describe '#on_low' do
-            it 'should add a callback that only gets fired when LOW' do
-              expect(@low_callback).to receive(:called)
-              expect(@high_callback).not_to receive(:called)
-
-              subject.update(board.low)
-            end
-          end
-
-          describe '#on_high' do
-            it 'should add a callback that only gets fired when HIGH' do
-              expect(@high_callback).to receive(:called)
-              expect(@low_callback).not_to receive(:called)
-
-              subject.update(board.high)
-            end
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/basic/digital_output_spec.rb b/spec/lib/components/basic/digital_output_spec.rb
deleted file mode 100644
index ad032cfc..00000000
--- a/spec/lib/components/basic/digital_output_spec.rb
+++ /dev/null
@@ -1,57 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Basic
-      describe DigitalOutput do
-        include BoardMock
-        let(:options) { { pin: '13', board: board } }
-        subject { DigitalOutput.new(options) }
-
-        describe '#after_initialize' do
-          it 'should set mode to out and go low' do
-            expect(board).to receive(:digital_write).with(13, board.low)
-            subject
-          end
-        end
-
-        describe '#digital_write' do
-          it 'should update the @state instance variable and call #digital_write on the board' do
-            subject
-            expect(board).to receive(:digital_write).with(subject.pin, board.high).once
-            subject.digital_write(board.high)
-            expect(subject.state).to eq(board.high)
-          end
-        end
-
-        describe '#high' do
-          it 'should call #digital_write with HIGH' do
-            expect(subject).to receive(:digital_write).with(board.high)
-            subject.high
-          end
-        end
-
-        describe '#low' do
-          it 'should call #digital_write with LOW' do
-            expect(subject).to receive(:digital_write).with(board.low)
-            subject.low
-          end
-        end
-
-        describe '#toggle' do
-          it 'should call high if currently LOW' do
-            subject.low
-            expect(subject).to receive(:high)
-            subject.toggle
-          end
-
-          it 'should call LOW if anything else' do
-            subject.high
-            expect(subject).to receive(:low)
-            subject.toggle
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/ir_emitter_spec.rb b/spec/lib/components/ir_emitter_spec.rb
deleted file mode 100644
index f4331f41..00000000
--- a/spec/lib/components/ir_emitter_spec.rb
+++ /dev/null
@@ -1,27 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe IREmitter do
-      include BoardMock
-      let(:options) { { board: board, pin: 3 } }
-      subject { IREmitter.new(options)  }
-
-      describe '#send' do
-        before(:each) { subject }
-
-        it 'should send messages in the request format the board expects' do
-          expect(board).to receive(:write).with "16.3.38.#{[4].pack('C')}#{[100,200,300,400].pack('v*')}\n"
-
-          subject.send([100,200,300,400])
-        end
-
-        it 'should put modulation frequency (kHz) in the value field if given as option to #send' do
-          expect(board).to receive(:write).with "16.3.40.#{[4].pack('C')}#{[100,200,300,400].pack('v*')}\n"
-
-          subject.send([100,200,300,400], frequency: 40)
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/lcd_spec.rb b/spec/lib/components/lcd_spec.rb
deleted file mode 100644
index 9b909707..00000000
--- a/spec/lib/components/lcd_spec.rb
+++ /dev/null
@@ -1,127 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe LCD do
-      include BoardMock
-      subject { LCD.new board: board, pins: { rs: 12, enable: 11, d4: 5, d5: 4, d6: 3, d7: 2 }, cols: 16, rows: 2 }
-
-      before do
-        expect(board).to receive(:write).with("10..0.12,11,5,4,3,2\n")
-        expect(board).to receive(:write).with("10..1.16,2\n")
-      end
-
-      describe '#clear' do
-        it 'clears the display' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 2)
-          subject.clear
-        end
-      end
-
-      describe '#home' do
-        it 'Moves the cursor to the first position' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 3)
-          subject.home
-        end
-      end
-
-      describe '#set_cursor' do
-        it 'moves the cursor to the given position' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 4, aux_message: "0,1")
-          subject.set_cursor(0,1)
-        end
-      end
-
-      describe '#puts' do
-        it 'prints a string in the display' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 5, aux_message: "AB")
-          subject.puts("AB")
-        end
-      end
-
-      describe '#show_cursor' do
-        it 'shows the cursor' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 6)
-          subject.show_cursor
-        end
-      end
-
-      describe '#hide_cursor' do
-        it 'hides the cursor' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 7)
-          subject.hide_cursor
-        end
-      end
-
-      describe '#blink' do
-        it 'shows a blinking cursor' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 8)
-          subject.blink
-        end
-      end
-
-      describe '#no_blink' do
-        it 'stops a blinking cursor' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 9)
-          subject.no_blink
-        end
-      end
-
-      describe '#on' do
-        it 'turn on the display' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 10)
-          subject.on
-        end
-      end
-
-      describe '#off' do
-        it 'turn off the display' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 11)
-          subject.off
-        end
-      end
-
-      describe '#scroll_left' do
-        it 'move the text in the display one position to the left' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 12)
-          subject.scroll_left
-        end
-      end
-
-      describe '#scroll_right' do
-        it 'move the text in the display one position to the right' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 13)
-          subject.scroll_right
-        end
-      end
-
-      describe '#enable_autoscroll' do
-        it 'enable autoscroll' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 14)
-          subject.enable_autoscroll
-        end
-      end
-
-      describe '#disable_autoscroll' do
-        it 'disable autoscroll' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 15)
-          subject.disable_autoscroll
-        end
-      end
-
-      describe '#left_to_right' do
-        it 'set the display writing to start from the left' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 16)
-          subject.left_to_right
-        end
-      end
-
-      describe '#right_to_left' do
-        it 'set the display writing to start from the right' do
-          expect(board).to receive(:write).with Dino::Message.encode(command: 10, value: 17)
-          subject.right_to_left
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/led_spec.rb b/spec/lib/components/led_spec.rb
deleted file mode 100644
index 32317773..00000000
--- a/spec/lib/components/led_spec.rb
+++ /dev/null
@@ -1,9 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe Led do
-      it 'should start blinking in a new thread at the given interval'
-    end
-  end
-end
diff --git a/spec/lib/components/mixins/callbacks_spec.rb b/spec/lib/components/mixins/callbacks_spec.rb
deleted file mode 100644
index 188bbf75..00000000
--- a/spec/lib/components/mixins/callbacks_spec.rb
+++ /dev/null
@@ -1,100 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Mixins
-      describe Callbacks do
-
-        class CallbackComponent
-          include Setup::Base
-          include Callbacks
-          def initialize; after_initialize; end
-        end
-        subject { CallbackComponent.new }
-
-        describe '#initialize' do
-          it 'should have an empty hash to hold callbacks' do
-            expect(subject.instance_variable_get :@callbacks).to eq({})
-          end
-
-          it 'should have a mutex to protect access to the hash' do
-            expect(subject.instance_variable_get(:@callback_mutex).class).to equal(Mutex)
-          end
-        end
-
-        describe '#add_callback' do
-          it 'should atomically add a callback to the hash' do
-            expect(subject.instance_variable_get :@callback_mutex).to receive(:synchronize).once.and_yield
-            callback = Proc.new{}
-            subject.add_callback(&callback)
-            expect(subject.instance_variable_get :@callbacks).to eq({persistent: [callback]})
-          end
-
-          it 'should add callbacks under arbitrary keys' do
-            callback = Proc.new{}
-            subject.add_callback(:key, &callback)
-            expect(subject.instance_variable_get :@callbacks).to eq({key: [callback]})
-          end
-        end
-
-        context 'with callbacks added' do
-          before :each do
-            @callback1 = Proc.new{}
-            @callback2 = Proc.new{}
-            subject.add_callback(&@callback1)
-            subject.add_callback(:read, &@callback2)
-          end
-
-          describe '#remove_callback' do
-            it 'should remove all callbacks if no key given' do
-              subject.remove_callbacks
-              expect(subject.instance_variable_get :@callbacks).to eq({})
-            end
-
-            it 'should remove only callbacks the given key if given' do
-              subject.remove_callbacks(:read)
-              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq(nil)
-              expect(subject.instance_variable_get(:@callbacks)[:persistent]).to_not eq(nil)
-            end
-          end
-
-          describe '#update' do
-            it 'should call all the callbacks' do
-              expect(@callback1).to receive(:call).once
-              expect(@callback2).to receive(:call).once
-              subject.update("data")
-            end
-
-            it 'should remove any callbacks saved with the key :read' do
-              subject.update("data")
-              expect(subject.instance_variable_get(:@callbacks)[:read]).to eq(nil)
-            end
-          end
-
-
-          describe '#pre_callback_filter' do
-            it 'should mutate data being passed to callbacks' do
-              class FilteredComponent < CallbackComponent
-                def pre_callback_filter(data)
-                  "dino: #{data}"
-                end
-              end
-              callback = Proc.new{|data| data}
-              subject = FilteredComponent.new
-              subject.add_callback(&callback)
-              expect(callback).to receive(:call).with("dino: dino")
-              subject.update("dino")
-            end
-          end
-
-          describe '#update_self' do
-            it 'should set the @state variable' do
-              subject.update("dino")
-              expect(subject.instance_variable_get :@state).to eq("dino")
-            end
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/mixins/listener_spec.rb b/spec/lib/components/mixins/listener_spec.rb
deleted file mode 100644
index bb24b60e..00000000
--- a/spec/lib/components/mixins/listener_spec.rb
+++ /dev/null
@@ -1,58 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Mixins
-      describe Poller do
-
-        class ListenComponent
-          include Setup::Base
-          include Listener
-          def _listen(divider=nil); end
-          def _stop_listener; end
-          def initialize; after_initialize; end
-        end
-
-        subject { ListenComponent.new }
-
-        describe '#initialize' do
-          it 'should automatically include Callbacks' do
-            expect(subject.class.ancestors).to include(Callbacks)
-          end
-        end
-
-        describe '#listen' do
-          it 'should call #stop' do
-            expect(subject).to receive(:stop)
-            subject.listen
-          end
-
-          it 'should call #_listen' do
-            expect(subject).to receive(:_listen)
-            subject.listen
-          end
-
-          it 'should add a given block as callback with :listen key' do
-            callback = Proc.new{}
-            expect(subject).to receive(:add_callback).with(:listen) do |&block|
-              expect(block).to eq(callback)
-            end
-            subject.listen(&callback)
-          end
-        end
-
-        describe '#stop' do
-          it 'should call #_stop_listener' do
-            expect(subject).to receive(:_stop_listener)
-            subject.listen
-          end
-
-          it 'should remove all callbacks with the :listen key' do
-            expect(subject).to receive(:remove_callbacks).with(:listen)
-            subject.stop
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/mixins/poller_spec.rb b/spec/lib/components/mixins/poller_spec.rb
deleted file mode 100644
index cfafcaeb..00000000
--- a/spec/lib/components/mixins/poller_spec.rb
+++ /dev/null
@@ -1,66 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Mixins
-      describe Poller do
-
-        class PollComponent
-          include Setup::Base
-          include Poller
-          def _read; end
-          def initialize; after_initialize; end
-        end
-
-        subject { PollComponent.new }
-
-        describe '#initialize' do
-          it 'should automatically include Callbacks' do
-            expect(subject.class.ancestors).to include(Threaded)
-            expect(subject.class.ancestors).to include(Reader)
-          end
-        end
-
-        describe '#poll' do
-          it 'should call #stop' do
-            expect(subject).to receive(:stop)
-            subject.poll
-          end
-
-          it 'should add a given block as callback with :poll key' do
-            callback = Proc.new{}
-            expect(subject).to receive(:add_callback).with(:poll) do |&block|
-              expect(block).to eq(callback)
-            end
-            subject.poll(&callback)
-          end
-
-          it 'should start a new thread' do
-            expect(subject).to receive(:threaded_loop)
-            subject.poll
-            subject.stop
-          end
-
-          it 'should call #_read repeatedly' do
-            expect(subject).to receive(:_read).at_least(:twice)
-            subject.poll(0.01)
-            sleep 0.1
-            subject.stop
-          end
-        end
-
-        describe '#stop' do
-          it 'should not override the call to Threaded#stop_thread' do
-            expect(subject).to receive(:stop_thread)
-            subject.stop
-          end
-
-          it 'should remove any callbacks with the :poll key' do
-            expect(subject).to receive(:remove_callbacks).with(:poll)
-            subject.stop
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/mixins/reader_spec.rb b/spec/lib/components/mixins/reader_spec.rb
deleted file mode 100644
index 66b7e63f..00000000
--- a/spec/lib/components/mixins/reader_spec.rb
+++ /dev/null
@@ -1,78 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Mixins
-      describe Reader do
-
-        class ReadComponent
-          include Setup::Base
-          include Reader
-          def _read; end
-          def initialize; after_initialize; end
-        end
-
-        subject { ReadComponent.new }
-
-        def read_callbacks
-          subject.instance_variable_get(:@callbacks)[:read]
-        end
-
-        def inject(data, wait_for_callbacks = true)
-          Thread.new do
-            if wait_for_callbacks
-              while (!read_callbacks) do; sleep 0.01; end
-            end
-            loop do
-              sleep 0.01
-              subject.update(data)
-              break unless read_callbacks
-            end
-          end
-        end
-
-        describe '#initialize' do
-          it 'should automatically include Callbacks' do
-            expect(ReadComponent.ancestors).to include(Callbacks)
-          end
-        end
-
-        describe '#read' do
-          it 'should call #_read exactly once' do
-            expect(subject).to receive(:_read).exactly(1).times
-            inject(1)
-            subject.read
-          end
-
-          it 'should add the given block as a callback with key :read' do
-            callback = Proc.new{}
-
-            # expect(subject).to receive(:add_callback).with(:read, &callback)
-            # would just be too easy?
-            blocks = []
-            allow(subject).to receive(:add_callback).with(:read) do |&block|
-              blocks << block
-              expect(blocks).to include(callback)
-            end
-
-            inject(1)
-            subject.read(&callback)
-          end
-
-          it 'should run the given callback exactly once' do
-            callback = Proc.new{}
-            expect(callback).to receive(:call).exactly(1).times
-            inject(1)
-            subject.read(&callback)
-            inject(1, false)
-          end
-
-          it 'should return the read value' do
-            inject("Hello")
-            expect(subject.read).to eq("Hello")
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/mixins/threaded_spec.rb b/spec/lib/components/mixins/threaded_spec.rb
deleted file mode 100644
index 3b761946..00000000
--- a/spec/lib/components/mixins/threaded_spec.rb
+++ /dev/null
@@ -1,118 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Mixins
-      describe Threaded do
-        include BoardMock
-
-        class ThreadedComponent
-          include Setup::Base
-          include Threaded
-          def foo(str="test")
-            @bar = str
-          end
-          attr_reader :bar
-          interrupt_with :foo
-        end
-
-        subject { ThreadedComponent.new(board: board) }
-
-        describe 'ClassMethods' do
-          it 'should add methods to interrupt the thread using #interrupt_with' do
-            ThreadedComponent.class_variable_get(:@@interrupts).should eq [:foo]
-          end
-        end
-
-        describe '#threaded' do
-          it 'should stop any existing thread' do
-            expect(subject).to receive(:stop_thread)
-            subject.threaded do; end
-          end
-
-          it 'should enable interrupts' do
-            expect(subject).to receive(:enable_interrupts)
-            subject.threaded do; end
-          end
-
-          it 'should start a new thread that calls the given block' do
-            async = Proc.new {}
-            expect(Thread).to receive(:new) do |&block|
-              expect(block).to eq(async)
-            end
-            subject.threaded(&async)
-          end
-
-          it 'should store in @thread' do
-            thread = Thread.current
-            component = subject
-            component.threaded {}
-            while(!component.instance_variable_get :@thread) do; sleep 0.05; end
-            expect(component.instance_variable_get :@thread).to_not eq(thread)
-          end
-        end
-
-        describe '#threaded_loop' do
-          it 'should loop the block in the thread' do
-            @mutex = Mutex.new
-            @count = 0
-
-            component = subject
-            component.threaded_loop do
-              @mutex.synchronize do
-                @count = @count + 1
-              end
-            end
-
-            while(@mutex.synchronize{ @count } < 2) do; sleep 0.05; end
-            component.stop_thread
-            expect(@count).to be > 1
-          end
-        end
-
-        describe '#stop_thread' do
-          it 'should kill the thread' do
-            component = subject
-            component.threaded { sleep }
-            expect(component.instance_variable_get :@thread).to receive(:kill)
-            component.stop_thread
-          end
-        end
-
-        describe '#enable_interrupts' do
-          it 'should override the given method on the singleton class only' do
-            first_part = subject
-            second_part = ThreadedComponent.new(board: board)
-            before_class = second_part.method(:foo)
-            before_instance = first_part.method(:foo)
-
-            first_part.enable_interrupts
-            after_class = second_part.method(:foo)
-            after_instance = first_part.method(:foo)
-
-            expect(after_class).to eq(before_class)
-            expect(after_instance).to_not eq(before_instance)
-          end
-
-          it 'should pass arguments through to the original method' do
-            component = subject
-            original = component.method(:foo)
-            component.enable_interrupts
-            component.foo("dino")
-            expect(original).to_not eq(component.method(:foo))
-            expect(component.bar).to eq("dino")
-          end
-        end
-
-        describe 'calling an interrupt' do
-          it 'should stop the thread' do
-            component = subject
-            component.threaded { sleep }
-            expect(component).to receive(:stop_thread)
-            component.foo
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/one_wire/ds18b20_spec.rb b/spec/lib/components/one_wire/ds18b20_spec.rb
deleted file mode 100644
index a5ca702c..00000000
--- a/spec/lib/components/one_wire/ds18b20_spec.rb
+++ /dev/null
@@ -1,66 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module OneWire
-      describe DS18B20 do
-        include BoardMock
-        let(:bus) { double(mutex: Mutex.new).as_null_object }
-        subject   { DS18B20.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF) }
-
-        describe '#decode_temp' do
-          it 'should decode values matching the datasheet and convert C to F' do
-            expect(subject.decode_temperature([0b1101_0000,0b0000_0111]))
-              .to eq(celsius: 125, farenheit: 257)
-            expect(subject.decode_temperature([0b0000_0000,0b0000_0000]))
-              .to eq(celsius: 0, farenheit: 32)
-            expect(subject.decode_temperature([0b0101_1110,0b1111_1111]))
-              .to eq(celsius: -10.125, farenheit: 13.775)
-            expect(subject.decode_temperature([0b1001_0000,0b1111_1100]))
-              .to eq(celsius: -55, farenheit: -67)
-          end
-        end
-
-        describe '#decode_resolution' do
-          it 'should get the resolution from the entire scratchpad' do
-            expect(subject.decode_resolution([0,0,0,0,0b01100000])).to eq(12)
-            expect(subject.decode_resolution([0,0,0,0,0b01000000])).to eq(11)
-            expect(subject.decode_resolution([0,0,0,0,0b00100000])).to eq(10)
-            expect(subject.decode_resolution([0,0,0,0,0b00000000])).to eq(9)
-          end
-        end
-
-        describe '#convert' do
-          it 'should be atomic' do
-            expect(subject).to receive(:atomically).exactly(1).times
-            subject.convert
-          end
-
-          it 'should match first' do
-            expect(subject).to receive(:atomically).exactly(1).times
-            subject.convert
-          end
-
-          it 'should send the command' do
-            expect(bus).to receive(:write).with(0x44)
-            subject.convert
-          end
-
-          it 'should set the sleep time to default on first conversion' do
-            subject.convert
-            expect(subject.instance_variable_get(:@convert_time)).to eq(0.75)
-          end
-
-          it 'should sleep for the conversion time' do
-            subject.convert
-            expect(subject).to receive(:sleep).with(subject.instance_variable_get(:@convert_time))
-            subject.convert
-          end
-
-          it 'should sleep inside the mutex lock if parasite power in use'
-          it 'should sleep outside the mutex lock if parasite power not in use'
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/one_wire/enumerator_spec.rb b/spec/lib/components/one_wire/enumerator_spec.rb
deleted file mode 100644
index 2628a1c0..00000000
--- a/spec/lib/components/one_wire/enumerator_spec.rb
+++ /dev/null
@@ -1,140 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module OneWire
-      #
-      # State machine simulating a bus during address search. Initialize with n for
-      # n devices with random (CRC-invalid) addresses. Call #reset before each search.
-      #
-      class BusSimulator
-        def initialize(device_count)
-          @devices = []
-          device_count.times do
-            @devices << { rom: rand(2**64), in_search: true }
-          end
-          @devices = @devices.uniq
-          @index = -1
-        end
-
-        def addresses
-          @addresses ||= @devices.map { |d| d[:rom] }
-        end
-
-        def reset
-          @devices.each { |d| d[:in_search] = true }
-          @index = -1
-        end
-
-        def read_address_bit
-          bit = 1
-          @index = @index + 1
-          @devices.each do |d|
-            if d[:in_search]
-              bit = bit & d[:rom][@index]
-            end
-          end
-          bit
-        end
-
-        def read_complement_bit
-          bit = 1
-          @devices.each do |d|
-            if d[:in_search]
-              comp = d[:rom][@index] ^ 1
-              bit = bit & comp
-            end
-          end
-          bit
-        end
-
-        def write_bit(bit)
-          @devices.each do |d|
-            d[:in_search] = false unless d[:rom][@index] == bit
-          end
-        end
-      end
-
-      #
-      # Class wrapper for Ruby version of the C++ serach function running on the board.
-      # Hopefully that doesn't change...
-      #
-      class BoardSimulator
-        def initialize(simulator)
-          @simulator = simulator
-        end
-
-        def reset
-          @simulator.reset
-        end
-
-        def search(branch_mask)
-          output_string = ""
-          (0..7).each do |i|
-            addr = 0
-            comp = 0
-            (0..7).each do |j|
-              # Read bit and complement from simulator.
-              addr_bit = @simulator.read_address_bit
-              comp_bit = @simulator.read_complement_bit
-
-              # Set them in variable.
-              addr = addr | (addr_bit * (2 ** j))
-              comp = comp | (comp_bit * (2 ** j))
-
-              # Override address bit to a 1 in variable if 1 in mask.
-              # Write whatever addr_bit ends up being back to the bus simulator.
-              if branch_mask[(i*8) + j] == 1
-                @simulator.write_bit(1)
-                addr = addr | (1 * (2 ** j))
-              else
-                @simulator.write_bit(addr_bit)
-              end
-            end
-
-            output_string << addr.to_s << "," << comp.to_s
-            output_string << "," if (i != 7 ) # No \n. TxRx strips it IRL.
-          end
-          output_string
-        end
-      end
-
-      #
-      # Monkeypatch Bus to search the board sim instead of a real board.
-      #
-      class Bus
-        def initialize(options={})
-          @board_sim = options[:board_sim]
-          super(options)
-        end
-
-        def _search(branch_mask)
-          @board_sim.reset
-          result = @board_sim.search(branch_mask)
-          # Manually call #update to simulate callback thread.
-          self.update(result)
-        end
-      end
-
-      describe Bus do
-        include BoardMock
-        describe '#search' do
-          it 'should find all the addresses' do
-            # Ignore CRC since the simulator uses random addresses.
-            allow(OneWire::Helper).to receive(:crc_check).and_return true
-            allow_any_instance_of(Bus).to receive(:read_power_supply).and_return false
-
-            # This gets slow really fast... 256 seems fine.
-            bus_sim = BusSimulator.new(256)
-            board_sim = BoardSimulator.new(bus_sim)
-            bus = Bus.new(board: board, pin: 7, board_sim: board_sim)
-            bus.search
-
-            found_addresses = bus.found_devices.map { |d| d[:address] }
-            expect(found_addresses.sort).to eq(bus_sim.addresses.sort)
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/one_wire/slave_spec.rb b/spec/lib/components/one_wire/slave_spec.rb
deleted file mode 100644
index aa96c5fa..00000000
--- a/spec/lib/components/one_wire/slave_spec.rb
+++ /dev/null
@@ -1,125 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module OneWire
-      describe Slave do
-        include BoardMock
-        let(:bus) { double(mutex: Mutex.new).as_null_object }
-        subject   { Slave.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF) }
-
-        describe '#after_initialize' do
-          it 'should require an address' do
-            expect { Slave.new(bus: bus) }.to raise_error
-          end
-        end
-
-        describe '#atomically' do
-          it 'should happen inside the mutex lock' do
-            expect(bus.mutex).to receive(:synchronize)
-            subject.atomically {}
-          end
-
-          it 'should take a block and call it exactly once' do
-            block = Proc.new {}
-            expect(block).to receive(:call).exactly(1).times
-            subject.atomically(&block)
-          end
-        end
-
-        describe '#match' do
-          it 'should NOT be atomic' do
-            expect(subject).to receive(:atomically).exactly(0).times
-            subject.match
-          end
-
-          it 'should reset the bus' do
-            expect(bus).to receive(:reset)
-            subject.match
-          end
-
-          it 'should skip rom if it is the only device on the bus' do
-            expect(bus).to receive(:write).with(0xCC)
-            subject.match
-          end
-
-          it 'should try to match ROM, then send its ROM if not alone on the bus' do
-            # Just needs to be an array of anything > 1.
-            bus.stub(:found_devices) { [1,2] }
-            expect(bus).to receive(:write).with(0x55)
-            expect(bus).to receive(:write).with([255,255,255,255,255,255,255,255])
-            device = Slave.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF)
-            device.match
-          end
-        end
-
-        describe '#copy_scratch' do
-          it 'should be atomic' do
-            expect(subject).to receive(:atomically).exactly(1).times
-            subject.copy_scratch
-          end
-
-          it 'should call #match' do
-            expect(subject).to receive(:match).exactly(1).times
-            subject.copy_scratch
-          end
-
-          it 'should send the command' do
-            expect(bus).to receive(:write).with(0x48)
-            subject.copy_scratch
-          end
-
-          it 'should reset the bus after if parasite power is in use' do
-            bus.stub(:parasite_power) { true }
-            expect(bus).to receive(:reset).exactly(2).times
-            subject.copy_scratch
-          end
-        end
-
-        describe '#read_scratch' do
-          it 'should be atomic' do
-            expect(subject).to receive(:atomically).exactly(1).times
-            subject.read_scratch(9)
-          end
-
-          it 'should call #match' do
-            expect(subject).to receive(:match).exactly(1).times
-            subject.read_scratch(9)
-          end
-
-          it 'should send the command' do
-            expect(bus).to receive(:write).with(0xBE)
-            subject.read_scratch(9)
-          end
-
-          it 'should read the right number of bytes' do
-            expect(bus).to receive(:read).with(9)
-            subject.read_scratch(9)
-          end
-        end
-
-        describe '#write_scratch' do
-          it 'should be atomic' do
-            expect(subject).to receive(:atomically).exactly(1).times
-            subject.write_scratch([1])
-          end
-
-          it 'should call #match' do
-            expect(subject).to receive(:match).exactly(1).times
-            subject.write_scratch(1)
-          end
-
-          it 'should send the command' do
-            expect(bus).to receive(:write).with(0x4E)
-            subject.write_scratch(1)
-          end
-
-          it 'should write the data' do
-            expect(bus).to receive(:write).with([1,2,3])
-            subject.write_scratch(1,2,3)
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/register/select_spec.rb b/spec/lib/components/register/select_spec.rb
deleted file mode 100644
index 3a15edb3..00000000
--- a/spec/lib/components/register/select_spec.rb
+++ /dev/null
@@ -1,30 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Register
-      describe Select do
-        include BoardMock
-        let(:options) { { pin: '10', board: board } }
-        subject { Select.new(options) }
-
-        describe '#initialize' do
-          it 'should set mode to output' do
-            expect(board).to receive(:set_pin_mode).with(10, :out)
-            subject
-          end
-        end
-
-        describe '#update' do
-          it 'should respond to callbacks' do
-            subject
-            @callback = Proc.new{}
-            subject.add_callback(&@callback)
-            expect(@callback).to receive(:call).once.with("127")
-            subject.update("127")
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/register/shift_in_spec.rb b/spec/lib/components/register/shift_in_spec.rb
deleted file mode 100644
index 407eb581..00000000
--- a/spec/lib/components/register/shift_in_spec.rb
+++ /dev/null
@@ -1,87 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Register
-      describe ShiftIn do
-        include BoardMock
-        let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
-        subject { ShiftIn.new(options)  }
-
-        describe '#initialize' do
-          it 'should create a DigitalOutput instance for clock pin' do
-            expect(subject.clock.class).to eq(Basic::DigitalOutput)
-          end
-
-          it 'should create a DigitalInput instance for data pin' do
-            expect(subject.data.class).to eq(Basic::DigitalInput)
-          end
-
-          it 'should create a Register::Select instance for latch pin' do
-            expect(subject.latch.class).to eq(Register::Select)
-          end
-
-          it 'should set the number of bytes when given as option' do
-            subject = ShiftIn.new(options.merge(bytes:2))
-            expect(subject.instance_variable_get(:@bytes)).to eq(2)
-          end
-
-          it 'should default the rising_clock variable to 0' do
-            expect(subject.instance_variable_get(:@rising_clock)).to eq(false)
-          end
-
-          it 'should set @rising_clock to true if given anything other than false' do
-            subject = ShiftIn.new(options.merge(rising_clock: :yes))
-            expect(subject.instance_variable_get(:@rising_clock)).to eq(true)
-          end
-        end
-
-        describe '#read' do
-          before(:each) { subject }
-
-          it 'should send message for single byte in the request format the board expects' do
-            expect(board).to receive(:write).with "22.8.1.#{[11,12,0].pack('C*')}\n"
-            subject.read
-          end
-
-          it 'should request the correct number of bytes to be read' do
-            subject = ShiftIn.new(options.merge(bytes: 2))
-            expect(board).to receive(:write).with "22.8.2.#{[11,12,0].pack('C*')}\n"
-            subject.read
-          end
-
-          it 'should request clock pin to go high before reading if set' do
-            subject = ShiftIn.new(options.merge(rising_clock: 1))
-            expect(board).to receive(:write).with "22.8.1.#{[11,12,1].pack('C*')}\n"
-            subject.read
-          end
-        end
-
-        describe '#update' do
-          before(:each) { subject }
-
-          it 'should bubble #update from the latch pin up to itself' do
-            expect(subject).to receive(:update).once.with("127,255")
-            subject.latch.update("127,255")
-          end
-
-          it 'should update @state with data converted to array of 0/1 integers' do
-            subject.update("127")
-            expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1])
-
-            subject = ShiftIn.new(options.merge(bytes: 2))
-            subject.update("127,255")
-            expect(subject.instance_variable_get(:@state)).to eq([0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1])
-          end
-
-          it 'should pass data to the callbacks as an array of 0/1 integers' do
-            @callback = Proc.new{}
-            subject.add_callback(&@callback)
-            expect(@callback).to receive(:call).once.with([0,1,1,1,1,1,1,1])
-            subject.update("127")
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/register/shift_out_spec.rb b/spec/lib/components/register/shift_out_spec.rb
deleted file mode 100644
index a5104f65..00000000
--- a/spec/lib/components/register/shift_out_spec.rb
+++ /dev/null
@@ -1,40 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Register
-      describe ShiftOut do
-        include BoardMock
-        let(:options) { { board: board, pins: {clock: 12, data: 11, latch: 8} } }
-        subject { ShiftOut.new(options)  }
-
-        describe '#initialize' do
-          it 'should create a DigitalOutput instance for clock and data pins' do
-            expect(subject.clock.class).to eq(Basic::DigitalOutput)
-            expect(subject.data.class).to eq(Basic::DigitalOutput)
-          end
-
-          it 'should create a Register::Select instance for latch pin' do
-            expect(subject.latch.class).to eq(Register::Select)
-          end
-        end
-
-        describe '#write' do
-          before(:each) { subject }
-
-          it 'should send message for single byte in the request format the board expects' do
-            expect(board).to receive(:write).with "21.8.1.#{[11,12,0,255].pack('C*')}\n"
-
-            subject.write(255)
-          end
-
-          it 'should send message for array of bytes in the request format the board expects' do
-            expect(board).to receive(:write).with "21.8.2.#{[11,12,0,255,0].pack('C*')}\n"
-
-            subject.write([255,0])
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/rgb_led_spec.rb b/spec/lib/components/rgb_led_spec.rb
deleted file mode 100644
index 12859ef6..00000000
--- a/spec/lib/components/rgb_led_spec.rb
+++ /dev/null
@@ -1,65 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe RgbLed do
-      include BoardMock
-      let(:options) { { board: board, pins: {red: 1, green: 2, blue: 3} } }
-      subject { RgbLed.new(options) }
-
-      describe '#initialize' do
-        it 'should create a BaseOutput instance for each pin' do
-          led = RgbLed.new(options)
-
-          expect(led.red.class).to eq(Basic::AnalogOutput)
-          expect(led.green.class).to eq(Basic::AnalogOutput)
-          expect(led.blue.class).to eq(Basic::AnalogOutput)
-        end
-      end
-
-      describe '#write' do
-        it 'should write the elements of the array to red, green and blue' do
-          expect(subject.red).to receive(:write).with(0)
-          expect(subject.green).to receive(:write).with(128)
-          expect(subject.blue).to receive(:write).with(0)
-
-          subject.write [0, 128, 0]
-        end
-      end
-
-      describe '#color=' do
-        it 'should write an array of values' do
-          expect(subject).to receive(:write).with([128, 0, 0])
-          subject.color = [128, 0, 0]
-        end
-
-        it 'should look up named colors in COLORS whether passed in as symbol or string' do
-          colors = {
-            red:     [255, 000, 000],
-            green:   [000, 255, 000],
-            blue:    [000, 000, 255],
-            cyan:    [000, 255, 255],
-            yellow:  [255, 255, 000],
-            magenta: [255, 000, 255],
-            white:   [255, 255, 255],
-            off:     [000, 000, 000]
-          }
-          colors.each_value { |color| expect(subject).to receive(:write).with(color).twice }
-
-          colors.each_key { |key| subject.color = key }
-          colors.each_key { |key| subject.color = key.to_s }
-        end
-      end
-
-      describe '#cycle' do
-        it 'should cycle through the 3 base colors' do
-          expect_any_instance_of(Array).to receive(:cycle).and_yield(:red).and_yield(:green).and_yield(:blue)
-          expect(subject).to receive(:color=).with(:red)
-          expect(subject).to receive(:color=).with(:green)
-          expect(subject).to receive(:color=).with(:blue)
-          subject.cycle
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/sensor_spec.rb b/spec/lib/components/sensor_spec.rb
deleted file mode 100644
index 589a4587..00000000
--- a/spec/lib/components/sensor_spec.rb
+++ /dev/null
@@ -1,8 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe Sensor do
-    end
-  end
-end
diff --git a/spec/lib/components/servo_spec.rb b/spec/lib/components/servo_spec.rb
deleted file mode 100644
index e52e1644..00000000
--- a/spec/lib/components/servo_spec.rb
+++ /dev/null
@@ -1,42 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe Servo do
-      include BoardMock
-      let(:options) { { board: board, pin: 9 } }
-      subject { Servo.new(options)  }
-
-      describe '#initialize' do
-        it 'should toggle the servo library on for the pin' do
-          expect(board).to receive(:servo_toggle).with(options[:pin], :on)
-          subject
-        end
-      end
-
-      describe '#position' do
-        let(:servo) {servo =  Servo.new(pin: 13, board: board)}
-
-        it 'should set the position of the Servo' do
-          servo.position = 90
-          expect(servo.position).to eq(90)
-        end
-
-        it 'should let you write up to 180' do
-          servo.position = 180
-          expect(servo.position).to eq(180)
-        end
-
-        it 'should modulate when position > 180' do
-          servo.position = 190
-          expect(servo.position).to eq(10)
-        end
-
-        it 'should write the new position to the board' do
-          expect(board).to receive(:servo_write).with(13, 10)
-          servo.position = 190
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/setup/base_spec.rb b/spec/lib/components/setup/base_spec.rb
deleted file mode 100644
index b9164f1d..00000000
--- a/spec/lib/components/setup/base_spec.rb
+++ /dev/null
@@ -1,30 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Setup
-      describe Base do
-        include BoardMock
-        let(:options) { { pin: 'A0', board: board } }
-
-        class BaseComponent
-          include Base
-        end
-        subject { BaseComponent.new(options) }
-
-        describe '#initialize' do
-          it 'should require a board' do
-            expect {
-              BaseComponent.new(pin: 'A0')
-            }.to raise_exception
-          end
-
-          it 'should register itself as a component on the board' do
-            expect(board).to receive(:add_component)
-            BaseComponent.new(options)
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/setup/input_spec.rb b/spec/lib/components/setup/input_spec.rb
deleted file mode 100644
index 817cdea5..00000000
--- a/spec/lib/components/setup/input_spec.rb
+++ /dev/null
@@ -1,39 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Setup
-      describe Input do
-        include BoardMock
-        let(:options) { { pin: 'A0', board: board, pullup: true} }
-
-        class InputComponent
-          include SinglePin
-          include Input
-        end
-        subject { InputComponent.new(options) }
-
-        describe '#pullup=' do
-          it 'should tell the board to set the pullup mode correctly' do
-            subject
-            expect(board).to receive(:set_pullup).with(subject.pin, false)
-            subject.pullup = false
-            expect(subject.pullup).to be(false)
-          end
-        end
-
-        describe '#initialize_pins' do
-          it 'should set the pin mode to in' do
-            expect(board).to receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :in)
-            subject
-          end
-
-          it 'should set the pulllup if included in options' do
-            expect(board).to receive(:set_pullup).with(subject.pin, true)
-            InputComponent.new(options)
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/setup/multi_pin_spec.rb b/spec/lib/components/setup/multi_pin_spec.rb
deleted file mode 100644
index e1d815c4..00000000
--- a/spec/lib/components/setup/multi_pin_spec.rb
+++ /dev/null
@@ -1,73 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Setup
-      describe MultiPin do
-        include BoardMock
-        let(:options) { { pins: {one: 9, two: 10, maybe: 11}, board: board } }
-
-        class MultiPinComponent
-          include MultiPin
-          require_pin :one
-          proxy_pin   two:   Basic::DigitalOutput
-          proxy_pin   maybe: Basic::DigitalInput, optional: true
-        end
-        subject { MultiPinComponent.new(options) }
-
-        describe "::require_pins" do
-          it 'should add required pins to the @@required_pins class variable' do
-            expect(MultiPinComponent.class_eval('@@required_pins')).to eq([:one, :two])
-          end
-        end
-
-        describe "::proxy_pins" do
-          it 'should automatically require the pin unless :optional is true' do
-            expect(MultiPinComponent.class_eval('@@required_pins')).to eq([:one, :two])
-          end
-
-          it 'should add the pins to the @@proxied_pins class variable with the right classes' do
-            expect(MultiPinComponent.class_eval('@@proxied_pins')).to eq({two: Basic::DigitalOutput, maybe: Basic::DigitalInput})
-          end
-        end
-
-        describe '#validate_pins' do
-          it 'should raise an error for any required pin that is missing' do
-            expect {
-              MultiPinComponent.new(board: board, pins: {one: 9, maybe: 11})
-            }.to raise_exception(/two/)
-          end
-
-          it 'should not raise errors for optional pins that are missing' do
-            expect {
-              MultiPinComponent.new(board: board, pins: {one: 9, two: 10})
-            }.to_not raise_exception
-          end
-        end
-
-        describe '#build_proxies' do
-          it 'should create the correct proxy subcomponents' do
-            expect(subject.proxies[:two].class).to equal(Basic::DigitalOutput)
-            expect(subject.proxies[:maybe].class).to equal(Basic::DigitalInput)
-          end
-
-          it 'should create an attr_accessor for each proxy' do
-            expect(subject.two).to equal(subject.proxies[:two])
-            expect(subject.maybe).to equal(subject.proxies[:maybe])
-          end
-
-          it 'should attach the subcomponents to the right pins' do
-            expect(subject.two.pin).to eq(10)
-            expect(subject.maybe.pin).to eq(11)          end
-        end
-
-        describe '#proxy_states' do
-          it 'should return a hash with the state of each subcomponent' do
-            subject.two.high
-            expect(subject.proxy_states).to eq({two: board.high, maybe: nil})
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/setup/output_spec.rb b/spec/lib/components/setup/output_spec.rb
deleted file mode 100644
index 8de06ff6..00000000
--- a/spec/lib/components/setup/output_spec.rb
+++ /dev/null
@@ -1,25 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Setup
-      describe Input do
-        include BoardMock
-        let(:options) { { pin: 'A0', board: board, pullup: true} }
-
-        class OutputComponent
-          include SinglePin
-          include Output
-        end
-        subject { OutputComponent.new(options) }
-
-        describe '#initialize_pins' do
-         it 'should set the pin mode to out' do
-            expect(board).to receive(:set_pin_mode).with(board.convert_pin(options[:pin]), :out)
-            subject
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/setup/single_pin_spec.rb b/spec/lib/components/setup/single_pin_spec.rb
deleted file mode 100644
index d34c5584..00000000
--- a/spec/lib/components/setup/single_pin_spec.rb
+++ /dev/null
@@ -1,39 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    module Setup
-      describe SinglePin do
-        include BoardMock
-        let(:options) { { pin: 'A0', board: board } }
-
-        class SinglePinComponent
-          include SinglePin
-        end
-        subject { SinglePinComponent.new(options) }
-
-        describe '#initialize' do
-          it 'should require a pin' do
-            expect {
-              SinglePinComponent.new(board: board)
-            }.to raise_exception
-          end
-
-          it 'should convert the pin to an integer' do
-            expect(board).to receive(:convert_pin).with(options[:pin])
-            component = SinglePinComponent.new(options)
-          end
-        end
-
-        describe '#mode=' do
-          it 'should tell the board to set the pin mode' do
-            expect(board).to receive(:set_pin_mode).with(subject.pin, :out)
-
-            subject.send(:mode=, :out)
-            expect(subject.mode).to eq(:out)
-          end
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/softwareserial_spec.rb b/spec/lib/components/softwareserial_spec.rb
deleted file mode 100644
index 440a2627..00000000
--- a/spec/lib/components/softwareserial_spec.rb
+++ /dev/null
@@ -1,23 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe SoftwareSerial do
-      include BoardMock
-
-      subject { SoftwareSerial.new board: board, pins: { rx: 10, tx: 11 }, baud: 4800 }
-
-      before do
-        expect(board).to receive(:write).with("12..0.10,11\n")
-        expect(board).to receive(:write).with("12..1.4800\n")
-      end
-
-      describe '#puts' do
-        it 'prints a string to the serial interface' do
-          expect(board).to receive(:write).with "12..3.Testing\n"
-          subject.puts("Testing")
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/ssd_spec.rb b/spec/lib/components/ssd_spec.rb
deleted file mode 100644
index b5ead4f5..00000000
--- a/spec/lib/components/ssd_spec.rb
+++ /dev/null
@@ -1,78 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe SSD do
-      include BoardMock
-      let(:pins)  { {anode: 11, a: 12, b: 13, c: 3, d: 4, e: 5, f: 10, g: 9} }
-      subject   { SSD.new(board: board, pins: pins) }
-
-      describe '#initialize' do
-        it 'should create a digital output for pins a-g' do
-          subject
-
-          segments = [:a, :b, :c, :d, :e, :f, :g]
-          segments.each do |segment|
-            expect(subject.proxies[segment].class).to equal(Basic::DigitalOutput)
-          end
-        end
-
-        it "should clear the display" do
-          expect(subject).to receive(:clear).once
-          subject.send(:initialize, {board: board, pins: pins})
-        end
-
-        it "should turn on the display" do
-          expect(subject).to receive(:on).once
-          subject.send(:initialize, {board: board, pins: pins})
-        end
-      end
-
-      describe '#clear' do
-        it 'should toggle all the seven leds to off' do
-          segments = [:a, :b, :c, :d, :e, :f, :g]
-          segments.each do |segment|
-            expect(subject.proxies[segment]).to receive(:high)
-          end
-
-          subject.clear
-        end
-      end
-
-      describe '#on' do
-        it 'should turn the ssd on' do
-          expect(subject.anode).to receive(:digital_write).with(board.high)
-          subject.on
-        end
-      end
-
-      describe '#off' do
-        it 'should turn the ssd off' do
-          expect(subject.anode).to receive(:digital_write).with(board.low)
-          subject.off
-        end
-      end
-
-      describe '#display' do
-        it "should scroll on multiple characters" do
-          expect(subject).to receive(:scroll).with('foo')
-          subject.display('foo')
-        end
-
-        it "should make sure the ssd is turned on" do
-          expect(subject).to receive(:on)
-          subject.display(1)
-        end
-
-        it "should clear the display on unknown character" do
-          expect(subject).to receive(:clear)
-          subject.display('+')
-        end
-      end
-
-      describe 'with a cathode' do
-        it 'should invert the logic'
-      end
-    end
-  end
-end
diff --git a/spec/lib/components/stepper_spec.rb b/spec/lib/components/stepper_spec.rb
deleted file mode 100644
index b4407123..00000000
--- a/spec/lib/components/stepper_spec.rb
+++ /dev/null
@@ -1,39 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  module Components
-    describe Stepper do
-      include BoardMock
-      let(:options) { { pins: {step: 9, direction: 10}, board: board } }
-
-      subject { Stepper.new(options) }
-
-      describe '#initialize' do
-        it 'should create a BaseOutput instance for each pin' do
-          expect(subject.step.class).to equal(Basic::DigitalOutput)
-          expect(subject.direction.class).to equal(Basic::DigitalOutput)
-        end
-      end
-
-      describe '#step_cc' do
-        it 'should send high to the step pin with the direction pin high' do
-          expect(subject.direction).to receive(:digital_write).with(board.high)
-          expect(subject.step).to receive(:digital_write).with(board.high)
-          expect(subject.step).to receive(:digital_write).with(board.low)
-
-          subject.step_cc
-        end
-      end
-
-      describe '#step_cw' do
-        it 'should send high to the board with the direction pin low' do
-          expect(subject.direction).to receive(:digital_write).with(board.low)
-          expect(subject.step).to receive(:digital_write).with(board.high)
-          expect(subject.step).to receive(:digital_write).with(board.low)
-
-          subject.step_cw
-        end
-      end
-    end
-  end
-end
diff --git a/spec/lib/message_spec.rb b/spec/lib/message_spec.rb
deleted file mode 100644
index c8c5767e..00000000
--- a/spec/lib/message_spec.rb
+++ /dev/null
@@ -1,47 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  describe Dino::Message do
-    describe '.encode' do
-
-      it 'should require a command' do
-        expect { Dino::Message.encode }.to raise_exception(/command/)
-        expect { Dino::Message.encode(command:90) }.to_not raise_exception
-      end
-
-      it 'should not allow commands longer than 4 digits' do
-        expect { Dino::Message.encode(command:90000) }.to raise_exception(/four/)
-      end
-
-      it 'should not allow pins longer than 4 digits' do
-        expect { Dino::Message.encode(command:90, pin:90000) }.to raise_exception(/four/)
-      end
-
-      it 'should not allow values longer than 4 digits' do
-        expect { Dino::Message.encode(command:90, value:90000) }.to raise_exception(/four/)
-      end
-
-      it 'should not allow aux messages longer than 512' do
-        expect { Dino::Message.encode(command:90, aux_message: "0" * 513) }.to raise_exception(/512/)
-      end
-
-      it 'should build messages correctly' do
-        expect(Dino::Message.encode command: 1, pin: 1, value: 1  ).to eq("1.1.1\n")
-        expect(Dino::Message.encode command: 1, pin: 1            ).to eq("1.1\n")
-        expect(Dino::Message.encode command: 1, value: 1          ).to eq("1..1\n")
-        expect(Dino::Message.encode command: 1                    ).to eq("1\n")
-        expect(Dino::Message.encode command: 1, pin: 1, value: 1, aux_message: "Some Text" ).to eq("1.1.1.Some Text\n")
-        expect(Dino::Message.encode command: 1, aux_message: "Some Text"                   ).to eq("1...Some Text\n")
-        expect(Dino::Message.encode command: 1, value: 1, aux_message: "Some Text"         ).to eq("1..1.Some Text\n")
-      end
-
-      it 'should escape newlines inside aux message' do
-        expect(Dino::Message.encode command: 1, aux_message: "line1\nline2").to eq("1...line1\\\nline2\n")
-      end
-
-      it 'should escape backslashes inside aux message' do
-        expect(Dino::Message.encode command: 1, aux_message: "line1\\line2").to eq("1...line1\\\\line2\n")
-      end
-    end
-  end
-end
diff --git a/spec/lib/tx_rx/serial_spec.rb b/spec/lib/tx_rx/serial_spec.rb
deleted file mode 100644
index 421a167f..00000000
--- a/spec/lib/tx_rx/serial_spec.rb
+++ /dev/null
@@ -1,149 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  describe TxRx::Serial do
-    def mock_tty
-      @mock_tty ||= "/dev/mock_serial"
-    end
-
-    def mock_serial
-      @mock_serial ||= double("serial", read: "", write: nil)
-    end
-
-    subject {
-      Dino::TxRx::Serial.new
-    }
-
-    def io_instance
-      subject.send(:io)
-    end
-
-    describe '#connect' do
-      it 'should use the specified device and baud rate from options hash' do
-        expect(::Serial).to receive(:new).with("/dev/ttyACM0", 9600).and_return(mock_serial)
-        txrx = Dino::TxRx::Serial.new(device: "/dev/ttyACM0", baud: 9600)
-        expect(txrx.send(:io)).to equal mock_serial
-      end
-
-      context "on windows" do
-        it 'should create a new ::Serial object for the connected COM port if non specified' do
-          # Simulate being on Windows
-          original_platform = RUBY_PLATFORM
-          Constants.redefine(:RUBY_PLATFORM, "mswin", :on => Object)
-
-          # Simulate 3 COM ports with COM2 connected.
-          expect_any_instance_of(TxRx::Serial).to receive(:tty_devices).and_return(["COM1", "COM2", "COM3"])
-          expect(::Serial).to receive(:new).with("COM1", TxRx::Serial::BAUD).and_raise(RubySerial::Error)
-          expect(::Serial).to receive(:new).with("COM2", TxRx::Serial::BAUD).and_return(mock_serial)
-          expect(::Serial).to_not receive(:new).with("COM3", TxRx::Serial::BAUD)
-
-          txrx = TxRx::Serial.new
-          expect(txrx.send(:io)).to equal(mock_serial)
-
-          # Set platform back to original value
-          Constants.redefine(:RUBY_PLATFORM, original_platform, :on => Object)
-        end
-      end
-
-      context "on *nix" do
-        it 'should create a new ::Serial for the first connected tty device if none specified' do
-          # Simulate /dev/ttyACM0 connected.
-          expect_any_instance_of(TxRx::Serial).to receive(:tty_devices).and_return(['/dev/ttyACM0', '/dev/tty.usbmodem1'])
-          expect(::Serial).to receive(:new).with('/dev/ttyACM0', TxRx::Serial::BAUD).and_return(mock_serial)
-          expect(::Serial).to_not receive(:new).with('/dev/tty.usbmodem1', TxRx::Serial::BAUD)
-
-          txrx = TxRx::Serial.new
-          expect(txrx.send(:io)).to equal(mock_serial)
-        end
-      end
-
-      it 'should raise SerialConnectError if it cannot connect to a board' do
-        allow(::Serial).to receive(:new).and_raise(RubySerial::Error)
-        expect { TxRx::Serial.new.send(:io) }.to raise_exception Dino::TxRx::SerialConnectError
-      end
-    end
-
-    describe '#io_reset' do
-      it 'should call flush read, stop read, and start read' do
-        expect(subject).to receive(:flush_read).and_return true
-        expect(subject).to receive(:stop_read).and_return true
-        expect(subject).to receive(:start_read).and_return true
-        subject.send(:io_reset)
-      end
-    end
-
-    describe '#read_and_parse' do
-      it 'should notify observers on change' do
-        expect(subject).to receive(:read).and_return("02:00")
-        expect(subject).to receive(:changed).and_return(true)
-        expect(subject).to receive(:notify_observers).with('02','00')
-        subject.send(:read_and_parse)
-      end
-
-      it 'should not split messages into more than 2 parts on :' do
-        expect(subject).to receive(:read).and_return("02:00:00")
-        expect(subject).to receive(:changed).and_return(true)
-        expect(subject).to receive(:notify_observers).with('02','00:00')
-        subject.send(:read_and_parse)
-      end
-    end
-
-    describe '#start_read' do
-      it 'should create a new thread and start looping' do
-        expect(Thread).to receive(:new).and_yield.and_return(double("abort_on_exception=" => true))
-        expect(subject).to receive(:loop)
-        subject.send(:start_read)
-      end
-    end
-
-    describe '#stop_read' do
-      it 'should kill the reading thread' do
-        subject.instance_variable_set(:@thread, mock_thread = double)
-        expect(Thread).to receive(:kill).with(mock_thread)
-        subject.send(:start_read)
-        subject.send(:stop_read)
-      end
-    end
-
-    describe '#write' do
-      it 'should write to the device' do
-        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial)
-        expect(mock_serial).to receive(:write).with('a message')
-        subject.write('a message')
-      end
-      it 'should break up messages larger than the board input buffer'
-    end
-
-    describe '#read' do
-      before :each do
-        expect(subject).to receive(:io).at_least(:once).and_return(mock_serial)
-      end
-
-      it 'should read single characters until it hits a newline and strip it' do
-        expect(mock_serial).to receive(:read).exactly(5).times.with(1).and_return("l", "i", "n", "e", "\n")
-        expect(subject.send(:read)).to eq("line")
-      end
-
-      it 'should catch escaped newlines' do
-        expect(mock_serial).to receive(:read).exactly(7).times.with(1).and_return("l", "1", "\\", "\n", "l", "2", "\n")
-        expect(subject.send(:read)).to eq("l1\nl2")
-      end
-
-      it 'should return a blank string if there is just a newline' do
-        expect(mock_serial).to receive(:read).exactly(1).times.with(1).and_return("\n")
-        expect(subject.send(:read)).to eq("")
-      end
-
-      it 'should allow escaped backslashes' do
-        expect(io_instance).to receive(:read).exactly(3).times.with(1).and_return("\\", "\\", "\n")
-        expect(subject.send(:read)).to eq("\\")
-      end
-    end
-
-    describe '#handshake' do
-      it 'should call #io_reset'
-      it 'should write again after timeout'
-      it 'should return the value from the ACK'
-    end
-  end
-end
diff --git a/spec/lib/tx_rx/tcp_spec.rb b/spec/lib/tx_rx/tcp_spec.rb
deleted file mode 100644
index e2424564..00000000
--- a/spec/lib/tx_rx/tcp_spec.rb
+++ /dev/null
@@ -1,37 +0,0 @@
-require 'spec_helper'
-
-module Dino
-  describe TxRx::TCP do
-    before :each do
-      @host = "127.0.0.1"
-      @port = 3467
-      @instance = TxRx::TCP.new(@host, @port)
-    end
-
-    describe "#connect" do
-      it 'should raise a TCPConnectError exception if it cannot connect to the server' do
-        expect { @instance.send :io }.to raise_exception Dino::TxRx::TCPConnectError
-      end
-
-      it 'should return the TCPSocket if connected' do
-        @server = TCPServer.new @port
-        expect(@instance.send :io).to be_a(TCPSocket)
-        @server.close
-      end
-    end
-
-    describe '#io' do
-      it 'should set io to a new TCPSocket with the specified host and port' do
-        expect(TCPSocket).to receive(:open).with(@host, @port)
-        @instance.send :io
-      end
-
-      it 'should use the existing io instance if set' do
-        @server = TCPServer.new @port
-        socket = @instance.send :io
-        expect(@instance.send :io).to equal(socket)
-        @server.close
-      end
-    end
-  end
-end
diff --git a/spec/spec_helper.rb b/spec/spec_helper.rb
deleted file mode 100644
index a31b7943..00000000
--- a/spec/spec_helper.rb
+++ /dev/null
@@ -1,24 +0,0 @@
-require 'rspec'
-
-require File.expand_path(File.join('../..', 'lib/dino'), __FILE__)
-
-# Nice little helper module to redefine constants quietly.
-module Constants
-  def self.redefine(const, value, opts={})
-    opts = {:on => self.class}.merge(opts)
-    opts[:on].send(:remove_const, const) if self.class.const_defined?(const)
-    opts[:on].const_set(const, value)
-  end
-end
-
-module BoardMock
-  def self.included(base)
-    base.class_eval do
-      let(:txrx)  { double :txrx, add_observer: true,
-                                  handshake: "528,14,20",
-                                  write: true,
-                                  read: true }
-      let(:board) { Dino::Board.new(txrx) }
-    end
-  end
-end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 70a0dca5..d1a0e3b3 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -156,6 +156,7 @@ void Dino::process() {
     case 33: i2cSearch           ();  break;
     case 34: i2cWrite            ();  break;
     case 35: i2cRead             ();  break;
+    case 36: i2cTransfer         ();  break;
     #endif
 
     // Implemented in DinoOneWire.cpp
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
new file mode 100644
index 00000000..5511a920
--- /dev/null
+++ b/test/api/core_test.rb
@@ -0,0 +1,136 @@
+require 'dino'
+require 'txrx_mock'
+require 'minitest/autorun'
+
+class APICoreTest < Minitest::Test
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+
+  def test_set_pin_mode
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: board.low)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: board.high)])
+
+    board.stub(:write, mock) do
+      board.set_pin_mode 1, :out
+      board.set_pin_mode 1, :in
+    end
+    mock.verify
+  end
+
+  def test_set_pullup
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 1, pin: 1, value: board.low)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 1, pin: 1, value: board.high)])
+
+    board.stub(:write, mock) do
+      board.set_pullup 1, false
+      board.set_pullup 1, true
+    end
+    mock.verify
+  end
+
+  def test_digital_write
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 1, pin: 1, value: board.low)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 1, pin: 1, value: board.high)])
+
+    board.stub(:write, mock) do
+      board.digital_write 1, board.low
+      board.digital_write 1, board.high
+    end
+    mock.verify
+  end
+
+  def test_digital_read
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 2, pin: 1)])
+
+    board.stub(:write, mock) do
+      board.digital_read 1
+    end
+    mock.verify
+  end
+
+  def test_analog_write
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 3, pin: 1, value: board.low)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 3, pin: 1, value: board.analog_high)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 3, pin: 1, value: 128)])
+
+    board.stub(:write, mock) do
+      board.analog_write 1, board.low
+      board.analog_write 1, board.analog_high
+      board.analog_write 1, 128
+    end
+    mock.verify
+  end
+
+  def test_analog_read
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 4, pin: 1)])
+
+    board.stub(:write, mock) do
+      board.analog_read 1
+    end
+    mock.verify
+  end
+
+  def test_set_listener
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b00000011)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b01000011)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b11000011)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b11000000)])
+
+    board.stub(:write, mock) do
+      board.set_listener(1, :off)
+      board.set_listener(1, :off, mode: :analog)
+      board.set_listener(1, :on, mode: :analog)
+      board.set_listener(1, :on, mode: :analog, divider: 1)
+    end
+    mock.verify
+  end
+
+  def test_digital_listen
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [1, :on, {mode: :digital, divider: 4}])
+
+    board.stub(:set_listener, mock) do
+      board.digital_listen(1)
+    end
+  end
+
+  def test_analog_listen
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [1, :on, {mode: :analog, divider: 16}])
+
+    board.stub(:set_listener, mock) do
+      board.analog_listen(1)
+    end
+  end
+
+  def test_stop_listener
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [1, :off])
+
+    board.stub(:set_listener, mock) do
+      board.stop_listener(1)
+    end
+  end
+
+  def test_analog_resolution
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [Dino::Message.encode(command: 96, value: 10)])
+
+    board.stub(:write, mock) do
+      board.analog_resolution = 10
+    end
+    mock.verify
+  end
+end
diff --git a/test/board_mock.rb b/test/board_mock.rb
new file mode 100644
index 00000000..ce0ecb7b
--- /dev/null
+++ b/test/board_mock.rb
@@ -0,0 +1,8 @@
+require 'dino'
+require 'txrx_mock'
+
+class BoardMock < Dino::Board::Default
+  def initialize
+    super(TxRxMock.new)
+  end
+end
diff --git a/test/board_test.rb b/test/board_test.rb
new file mode 100644
index 00000000..9bdc917b
--- /dev/null
+++ b/test/board_test.rb
@@ -0,0 +1,113 @@
+require 'dino'
+require 'txrx_mock'
+require 'minitest/autorun'
+
+class BoardTest < Minitest::Test
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+
+  def test_require_a_txrx_object
+    assert_raises(Exception) { Dino::Board.new }
+  end
+
+  def test_starts_observing_txrx
+    io = TxRxMock.new
+    mock = MiniTest::Mock.new.expect(:call, nil, [Dino::Board::Default])
+    io.stub(:add_observer, mock) do
+      Dino::Board.new(io)
+    end
+    mock.verify
+  end
+
+  def test_calls_handshake_on_txrx
+    mock = MiniTest::Mock.new.expect(:call, "528,14,20")
+    txrx.stub(:handshake, mock) do
+      Dino::Board.new(txrx)
+    end
+    mock.verify
+  end
+
+  def test_set_aux_limit
+    assert_equal 527, board.aux_limit
+  end
+
+  def test_set_dac_and_analog_zero
+    assert_equal 20, board.dac_zero
+    assert_equal 14, board.analog_zero
+  end
+
+  def test_set_low_high_analog_high
+    assert_equal 0, board.low
+    assert_equal 1, board.high
+    assert_equal 255, board.analog_high
+  end
+
+  def test_add_remove_component
+    mock = MiniTest::Mock.new
+    mock.expect(:pin, 1)
+
+    board.add_component(mock)
+    assert_equal [mock], board.components
+
+    board.remove_component(mock)
+    assert_equal [], board.components
+  end
+
+  def test_write
+    board
+    mock = MiniTest::Mock.new.expect(:call, nil, ["message"])
+    txrx.stub(:write, mock) do
+      board.write("message")
+    end
+    mock.verify
+  end
+
+  def test_update_passes_messages_to_components
+    mock1 = MiniTest::Mock.new.expect(:update, nil, ["data"])
+    3.times { mock1.expect(:pin, 1) }
+    mock2 = MiniTest::Mock.new.expect(:update, nil, ["byte"])
+    3.times { mock2.expect(:pin, 2) }
+    board.add_component(mock1)
+    board.add_component(mock2)
+    board.update(1, "data")
+    board.update(2, "byte")
+    board.update(3, "ignore")
+    mock1.verify
+    mock2.verify
+  end
+
+  def test_convert_pin
+    assert_equal 9,  board.convert_pin(9)
+    assert_equal 13, board.convert_pin('13')
+    assert_equal 15, board.convert_pin('A1')
+    assert_equal 15, board.convert_pin(:A1)
+    assert_equal 21, board.convert_pin('DAC1')
+  end
+
+  def test_convert_pin_esp8266
+    board = Dino::Board::ESP8266.new(txrx)
+    assert_equal 2,  board.convert_pin(2)
+    assert_equal 4,  board.convert_pin('D2')
+    assert_equal 5,  board.convert_pin('GPIO5')
+    assert_equal 0,  board.convert_pin('gpio0')
+    assert_equal 17, board.convert_pin('A0')
+  end
+
+  def test_incorrect_pin_formats
+    assert_raises(ArgumentError) { board.convert_pin('ADC1') }
+    board.instance_variable_set(:@dac_zero, nil)
+    assert_raises(ArgumentError) { board.convert_pin('DAC1') }
+  end
+
+  def test_analog_resolution
+    board.analog_resolution = 10
+    assert_equal 0,    board.low
+    assert_equal 1023, board.analog_high
+    assert_equal 10,   board.analog_resolution
+  end
+end
diff --git a/test/components/basic/analog_input_test.rb b/test/components/basic/analog_input_test.rb
new file mode 100644
index 00000000..e97bd9b6
--- /dev/null
+++ b/test/components/basic/analog_input_test.rb
@@ -0,0 +1,40 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class AnalogInputTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Basic::AnalogInput.new(board: board, pin: 14)
+  end
+
+  def test__read
+    mock = MiniTest::Mock.new.expect :call, nil, [14]
+    board.stub(:analog_read, mock) do
+      part._read
+    end
+    mock.verify
+  end
+
+  def test__listen
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [14, 16]
+    mock.expect :call, nil, [14, 32]
+    board.stub(:analog_listen, mock) do
+      part._listen
+      part._listen(32)
+    end
+    mock.verify
+  end
+
+  def test__stop_listen
+    mock = MiniTest::Mock.new.expect :call, nil, [14]
+    board.stub(:stop_listener, mock) do
+      part._stop_listener
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/basic/analog_output_test.rb b/test/components/basic/analog_output_test.rb
new file mode 100644
index 00000000..e007988d
--- /dev/null
+++ b/test/components/basic/analog_output_test.rb
@@ -0,0 +1,41 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class AnalogOutputTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Basic::AnalogOutput.new(board: board, pin: 14)
+  end
+
+  def test_analog_write
+    mock = MiniTest::Mock.new.expect :call, nil, [14, 128]
+    board.stub(:analog_write, mock) do
+      part.analog_write(128)
+    end
+    mock.verify
+    assert_equal part.state, 128
+  end
+
+  def test_write_uses_digital_write_at_limits
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [board.high]
+    mock.expect :call, nil, [board.low]
+    part.stub(:digital_write, mock) do
+      part.write(board.analog_high)
+      part.write(board.low)
+    end
+    mock.verify
+  end
+
+  def test_write_uses_analog_write_between_limits
+    mock = MiniTest::Mock.new.expect :call, nil, [128]
+    part.stub(:analog_write, mock) do
+      part.write(128)
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/basic/digital_input_test.rb b/test/components/basic/digital_input_test.rb
new file mode 100644
index 00000000..22929dd4
--- /dev/null
+++ b/test/components/basic/digital_input_test.rb
@@ -0,0 +1,61 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class DigitalInputTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Basic::DigitalInput.new(board: board, pin: 14)
+  end
+
+  def test_start_listening_immediately
+    mock = MiniTest::Mock.new.expect :call, nil, [14, 4]
+    board.stub(:digital_listen, mock) do
+      part
+    end
+    mock.verify
+  end
+
+  def test__read
+    mock = MiniTest::Mock.new.expect :call, nil, [14]
+    board.stub(:digital_read, mock) do
+      part._read
+    end
+    mock.verify
+  end
+
+  def test__listen
+    part
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [14, 4]
+    mock.expect :call, nil, [14, 32]
+    board.stub(:digital_listen, mock) do
+      part._listen
+      part._listen(32)
+    end
+    mock.verify
+  end
+
+  def test_on_low
+    low_cb  = MiniTest::Mock.new.expect :call, nil
+    high_cb = MiniTest::Mock.new
+    part.on_low { low_cb.call }
+    part.on_high { high_cb.call }
+    part.update(board.low)
+    low_cb.verify
+    high_cb.verify
+  end
+
+  def test_on_high
+    low_cb  = MiniTest::Mock.new
+    high_cb = MiniTest::Mock.new.expect :call, nil
+    part.on_low { low_cb.call }
+    part.on_high { high_cb.call }
+    part.update(board.high)
+    low_cb.verify
+    high_cb.verify
+  end
+end
diff --git a/test/components/basic/digital_output_test.rb b/test/components/basic/digital_output_test.rb
new file mode 100644
index 00000000..919727aa
--- /dev/null
+++ b/test/components/basic/digital_output_test.rb
@@ -0,0 +1,59 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class DigitalOutputTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Basic::DigitalOutput.new(board: board, pin: 14)
+  end
+
+  def test_low_on_initialize
+    mock = MiniTest::Mock.new.expect :call, nil, [14, board.low]
+    board.stub(:digital_write, mock) do
+      part
+    end
+    mock.verify
+  end
+
+  def test_digital_write
+    part
+    mock = MiniTest::Mock.new.expect :call, nil, [14, board.high]
+    board.stub(:digital_write, mock) do
+      part.digital_write(board.high)
+    end
+    mock.verify
+    assert_equal board.high, part.state
+  end
+
+  def test_high_and_low
+    part
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [board.high]
+    mock.expect :call, nil, [board.low]
+    part.stub(:digital_write, mock) do
+      part.high
+      part.low
+    end
+    mock.verify
+  end
+
+  def test_toggle
+    part.low
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:high, mock) do
+      part.toggle
+    end
+    mock.verify
+
+    part.high
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:low, mock) do
+      part.toggle
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/ir_emitter_test.rb b/test/components/ir_emitter_test.rb
new file mode 100644
index 00000000..35e6e62d
--- /dev/null
+++ b/test/components/ir_emitter_test.rb
@@ -0,0 +1,29 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class IREmitterTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::IREmitter.new(board: board, pin:1)
+  end
+
+  # These are really API tests.
+  # Should move these and test that API methods get called here instead.
+  def test_packs_pulses_correctly
+    part
+    string = "16.1.38.#{[4].pack('C')}#{[100,200,300,400].pack('S<*')}\n"
+    mock = MiniTest::Mock.new.expect(:call, nil, [string])
+    board.stub(:write, mock) { part.send [100,200,300,400] }
+  end
+
+  def test_accepts_modulation_frequency_as_option
+    part
+    string = "16.1.40.#{[4].pack('C')}#{[100,200,300,400].pack('S<*')}\n"
+    mock = MiniTest::Mock.new.expect(:call, nil, [string])
+    board.stub(:write, mock) { part.send [100,200,300,400], frequency: 40 }
+  end
+end
diff --git a/test/components/lcd_test.rb b/test/components/lcd_test.rb
new file mode 100644
index 00000000..902571e2
--- /dev/null
+++ b/test/components/lcd_test.rb
@@ -0,0 +1,49 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class LCDTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::LCD.new cols: 16, rows: 2,
+                                        board: board,
+                                        pins: { rs: 12, enable: 11,
+                                                d4: 5, d5: 4, d6: 3, d7: 2 }
+  end
+
+  def test_initialize
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, ["10..0.12,11,5,4,3,2\n"]
+    mock.expect :call, nil, ["10..1.16,2\n"]
+    board.stub(:write, mock) do
+      part
+    end
+    mock.verify
+  end
+
+  Dino::Components::LCD::LIBRARY_COMMANDS.each_pair do |command, command_id|
+    define_method("test_#{command.to_s}".to_sym) do
+      part
+      mock = MiniTest::Mock.new.expect :call, nil, [Dino::Message.encode(command: 10, value: command_id)]
+      board.stub(:write, mock) { part.send(command) }
+      mock.verify
+    end
+  end
+
+  def test_set_cursor
+    part
+    mock = MiniTest::Mock.new.expect :call, nil, [Dino::Message.encode(command: 10, value: 4, aux_message: "0,1")]
+    board.stub(:write, mock) { part.set_cursor(0,1) }
+    mock.verify
+  end
+
+  def test_puts
+    part
+    mock = MiniTest::Mock.new.expect :call, nil, [Dino::Message.encode(command: 10, value: 5, aux_message: "AB")]
+    board.stub(:write, mock) { part.puts("AB")}
+    mock.verify
+  end
+end
diff --git a/test/components/led_test.rb b/test/components/led_test.rb
new file mode 100644
index 00000000..39bb328b
--- /dev/null
+++ b/test/components/led_test.rb
@@ -0,0 +1,21 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class LedTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Led.new(board: board, pin:1)
+  end
+
+  def test_blink_runs_in_thread
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:threaded_loop, mock) do
+      part.blink(0.5)
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/mixins/callbacks_test.rb b/test/components/mixins/callbacks_test.rb
new file mode 100644
index 00000000..734cbaa9
--- /dev/null
+++ b/test/components/mixins/callbacks_test.rb
@@ -0,0 +1,77 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class CallbackComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::Callbacks
+
+  def pre_callback_filter(data)
+    "dino: #{data}"
+  end
+end
+
+class CallbacksTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= CallbackComponent.new(board: board, pin: 1)
+  end
+
+  def test_add_callback
+    callback = Proc.new{}
+    part.add_callback(&callback)
+    assert_equal part.callbacks, {persistent: [callback]}
+  end
+
+  def test_add_callback_with_key
+    callback = Proc.new{}
+    part.add_callback(:key, &callback)
+    assert_equal({key: [callback]}, part.callbacks)
+  end
+
+  def add_two_callbacks
+    @callback1 = Proc.new{}
+    @callback2 = Proc.new{}
+    part.add_callback(&@callback1)
+    part.add_callback(:read, &@callback2)
+  end
+
+  def test_remove_callback
+    add_two_callbacks
+    part.remove_callbacks
+    assert_equal({}, part.callbacks)
+  end
+
+  def test_remove_callback_with_key
+    add_two_callbacks
+    part.remove_callbacks(:read)
+    assert_nil part.callbacks[:read]
+    assert_equal [@callback1], part.callbacks[:persistent]
+  end
+
+  def test_update_runs_callbacks_and_removes_read_callbacks
+    cb1 = MiniTest::Mock.new.expect :call, nil
+    cb2 = MiniTest::Mock.new.expect :call, nil
+    part.add_callback        { cb1.call }
+    part.add_callback(:read) { cb2.call }
+    part.update("data")
+    assert_nil part.callbacks[:read]
+    cb1.verify
+    cb2.verify
+  end
+
+  def test_pre_callback_filter_modifies_data
+    cb = MiniTest::Mock.new.expect :call, nil, ["dino: value"]
+    part.add_callback { |x| cb.call(x) }
+    part.update("value")
+    cb.verify
+  end
+
+  def test_update_self
+    part.update("test")
+    assert_equal "dino: test", part.state
+  end
+end
diff --git a/test/components/mixins/listener_test.rb b/test/components/mixins/listener_test.rb
new file mode 100644
index 00000000..30b9a9c8
--- /dev/null
+++ b/test/components/mixins/listener_test.rb
@@ -0,0 +1,57 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class ListenerComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::Listener
+
+  def _listen(divider=nil); end
+  def _stop_listener; end
+end
+
+class ListenerTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= ListenerComponent.new(board: board, pin: 1)
+  end
+
+  def test_include_callbacks
+    assert_includes ListenerComponent.ancestors,
+                    Dino::Components::Mixins::Callbacks
+  end
+
+  def test_call_stop_before_listening
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:stop, mock) { part.listen }
+    mock.verify
+  end
+
+  def test_call__listen
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [nil]
+    mock.expect :call, nil, [32]
+    part.stub(:_listen, mock) do
+      part.listen
+      part.listen(32)
+    end
+    mock.verify
+  end
+
+  def test_call__stop_listener
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:_stop_listener, mock) { part.stop }
+    mock.verify
+  end
+
+  def test_add_and_remove_callback
+    callback = Proc.new{}
+    part.listen(&callback)
+    assert_equal [callback], part.callbacks[:listen]
+    part.stop
+    assert_nil part.callbacks[:listen]
+  end
+end
diff --git a/test/components/mixins/poller_test.rb b/test/components/mixins/poller_test.rb
new file mode 100644
index 00000000..0972f390
--- /dev/null
+++ b/test/components/mixins/poller_test.rb
@@ -0,0 +1,66 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class PollerComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::Poller
+  def _read; end
+end
+
+class PollerTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= PollerComponent.new(board: board, pin: 1)
+  end
+
+  def inject(data, wait_for_callbacks = true)
+    Thread.new do
+      if wait_for_callbacks
+        while (!part.callbacks[:read]) do; sleep 0.01; end
+      end
+      loop do
+        sleep 0.01
+        part.update(data)
+        break unless part.callbacks[:read]
+      end
+    end
+  end
+
+  def test_include_callbacks_and_threaded
+    assert_includes PollerComponent.ancestors,
+                    Dino::Components::Mixins::Callbacks
+
+    assert_includes PollerComponent.ancestors,
+                    Dino::Components::Mixins::Threaded
+  end
+
+  def test_call_stop_before_polling
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:stop, mock) { part.poll }
+    mock.verify
+  end
+
+  def test_uses_threaded_loop
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:threaded_loop, mock) { part.poll }
+    mock.verify
+  end
+
+  def test_add_and_remove_callback
+    callback = Proc.new{}
+    part.poll(&callback)
+    assert_equal part.callbacks[:poll], [callback]
+    part.stop
+    assert_nil part.callbacks[:poll]
+  end
+
+  def test_stop_kills_thread
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:stop_thread, mock) { part.stop }
+    mock.verify
+  end
+end
diff --git a/test/components/mixins/reader_test.rb b/test/components/mixins/reader_test.rb
new file mode 100644
index 00000000..1ea84e0a
--- /dev/null
+++ b/test/components/mixins/reader_test.rb
@@ -0,0 +1,56 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class ReaderComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::Reader
+  def _read; end
+end
+
+class ReaderTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= ReaderComponent.new(board: board, pin: 1)
+  end
+
+  def inject(data, wait_for_callbacks = true)
+    Thread.new do
+      if wait_for_callbacks
+        while (!part.callbacks[:read]) do; sleep 0.01; end
+      end
+      loop do
+        sleep 0.01
+        part.update(data)
+        break unless part.callbacks[:read]
+      end
+    end
+  end
+
+  def test_include_callbacks
+    assert_includes ReaderComponent.ancestors,
+                    Dino::Components::Mixins::Callbacks
+  end
+
+  def test_read_once
+    mock = MiniTest::Mock.new.expect :call, nil
+    inject(1)
+    part.stub(:_read, mock) { part.read }
+    mock.verify
+  end
+
+  # test returns read value
+  # test blocks main thread
+  # test read_using -> {}
+
+  def test_add_run_remove_callback
+    cb = MiniTest::Mock.new.expect :call, nil
+    inject(1)
+    part.read { cb.call }
+    assert_nil part.callbacks[:read]
+    cb.verify
+  end
+end
diff --git a/test/components/mixins/threaded_test.rb b/test/components/mixins/threaded_test.rb
new file mode 100644
index 00000000..d12183df
--- /dev/null
+++ b/test/components/mixins/threaded_test.rb
@@ -0,0 +1,100 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class ThreadedComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::Threaded
+  def foo(str="test")
+    @bar = str
+  end
+  attr_reader :bar
+  interrupt_with :foo
+end
+
+class ThreadedTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= ThreadedComponent.new(board: board, pin: 1)
+  end
+
+  def test_add_interrupts_using_interrupt_with
+    assert_equal ThreadedComponent.class_variable_get(:@@interrupts), [:foo]
+  end
+
+  def test_threaded_stops_threads
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:stop_thread, mock) { part.threaded {} }
+    mock.verify
+  end
+
+  def test_threaded_enables_interrupts
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:enable_interrupts, mock) { part.threaded {} }
+    mock.verify
+  end
+
+  def test_threaded_calls_block_given
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.threaded { mock.call }
+    sleep 0.1 # Should find a better way to do this.
+    mock.verify
+  end
+
+  def test_thread_stored_in_instance_variable
+    thread = Thread.current
+    part.threaded {}
+    refute_equal(thread, part.instance_variable_get(:@thread))
+  end
+
+  def test_threaded_loop_calls_block_repeatedly
+    mock = MiniTest::Mock.new.expect(:call, nil).expect(:call, nil)
+    part.stub(:foo, mock) do
+      part.threaded_loop do
+        part.foo
+        sleep 0.05
+      end
+      sleep 0.07 # And this.
+    end
+    mock.verify
+  end
+
+  def test_stop_thread_kills_thread
+    mock = MiniTest::Mock.new.expect(:kill, nil)
+    part.instance_variable_set(:@thread, mock)
+    part.stop_thread
+    mock.verify
+  end
+
+  def test_interrupts_override_singleton_only
+    second_part = ThreadedComponent.new(board: BoardMock.new, pin: 2)
+    before_class = second_part.method(:foo)
+    before_instance = part.method(:foo)
+
+    part.enable_interrupts
+    after_class = second_part.method(:foo)
+    after_instance = part.method(:foo)
+
+    assert_equal before_class, after_class
+    refute_equal before_instance, after_instance
+  end
+
+  def test_original_method_called_when_interrupts_enabled
+    mock = MiniTest::Mock.new.expect(:call, nil, ["dino"])
+    part.stub(:foo, mock) do
+      part.enable_interrupts
+      part.foo("dino")
+    end
+    mock.verify
+  end
+
+  def test_interrupt_stops_thread
+    part.enable_interrupts
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:stop_thread, mock) { part. foo }
+    mock.verify
+  end
+end
diff --git a/test/components/one_wire/ds18b20_test.rb b/test/components/one_wire/ds18b20_test.rb
new file mode 100644
index 00000000..768f7efe
--- /dev/null
+++ b/test/components/one_wire/ds18b20_test.rb
@@ -0,0 +1,80 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class DS18B20Test < MiniTest::Test
+  def bus
+    @bus ||= Dino::Components::OneWire::Bus.new(board: BoardMock.new, pin: 1)
+  end
+
+  def part
+    @part ||= Dino::Components::OneWire::DS18B20.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF)
+  end
+
+  def test_decode_temperatures
+    assert_equal({ celsius: 125, farenheit: 257 },
+                 part.decode_temperature([0b1101_0000,0b0000_0111]))
+    assert_equal({ celsius: 0, farenheit: 32 },
+                 part.decode_temperature([0b0000_0000,0b0000_0000]))
+    assert_equal({ celsius: -10.125, farenheit: 13.775 },
+                 part.decode_temperature([0b0101_1110,0b1111_1111]))
+    assert_equal({ celsius: -55, farenheit: -67 },
+                 part.decode_temperature([0b1001_0000,0b1111_1100]))
+  end
+
+  def test_decode_resolution
+    assert_equal 12, part.decode_resolution([0,0,0,0,0b01100000])
+    assert_equal 11, part.decode_resolution([0,0,0,0,0b01000000])
+    assert_equal 10, part.decode_resolution([0,0,0,0,0b00100000])
+    assert_equal  9, part.decode_resolution([0,0,0,0,0b00000000])
+  end
+
+  def test_set_convert_time
+    part.instance_variable_set(:@resolution, 9)
+    part.set_convert_time
+    assert_equal 0.09375, part.instance_variable_get(:@convert_time)
+    part.instance_variable_set(:@resolution, 12)
+    part.set_convert_time
+    assert_equal 0.75, part.instance_variable_get(:@convert_time)
+  end
+
+  # test resolution=
+
+  def test_convert_is_atomic
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:atomically, mock) { part.convert }
+  end
+
+  def test_convert_matches_first
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:match, mock) { part.convert}
+  end
+
+  def test_convert_sends_the_command
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [0xCC])
+    mock.expect(:call, nil, [0x44])
+    bus.stub(:write, mock) { part.convert }
+  end
+
+  def test_convert_sets_max_convert_time_first
+    part.convert
+    assert_equal 0.75, part.instance_variable_get(:@convert_time)
+  end
+
+  def test_convert_sleeps_for_convert_time
+    mock = MiniTest::Mock.new.expect(:call, nil, [0.75])
+    part.stub(:sleep, mock) do
+      part.convert
+    end
+  end
+
+  def test_convert_sleeps_inside_lock_if_parasite_power
+    bus.instance_variable_set(:@parasite_power, true)
+    Thread.new do
+      sleep 0.5
+      assert_equal true, bus.mutex.locked?
+    end
+    part.convert
+  end
+end
diff --git a/test/components/one_wire/enumerator_test.rb b/test/components/one_wire/enumerator_test.rb
new file mode 100644
index 00000000..c7e17429
--- /dev/null
+++ b/test/components/one_wire/enumerator_test.rb
@@ -0,0 +1,141 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+# State machine simulating a bus during address search. Initialize with n for
+# n devices with random (CRC-invalid) addresses. Call #reset before each search.
+class BusSimulator
+  def initialize(device_count)
+    @devices = []
+    device_count.times do
+      @devices << { rom: rand(2**64), in_search: true }
+    end
+    @devices = @devices.uniq
+    @index = -1
+  end
+
+  def addresses
+    @addresses ||= @devices.map { |d| d[:rom] }
+  end
+
+  def reset
+    @devices.each { |d| d[:in_search] = true }
+    @index = -1
+  end
+
+  def read_address_bit
+    bit = 1
+    @index = @index + 1
+    @devices.each do |d|
+      if d[:in_search]
+        bit = bit & d[:rom][@index]
+      end
+    end
+    bit
+  end
+
+  def read_complement_bit
+    bit = 1
+    @devices.each do |d|
+      if d[:in_search]
+        comp = d[:rom][@index] ^ 1
+        bit = bit & comp
+      end
+    end
+    bit
+  end
+
+  def write_bit(bit)
+    @devices.each do |d|
+      d[:in_search] = false unless d[:rom][@index] == bit
+    end
+  end
+end
+
+# Ruby version of the C++ functions running on the board.
+class BoardSimulator
+  def initialize(simulator)
+    @simulator = simulator
+  end
+
+  def reset
+    @simulator.reset
+  end
+
+  def search(branch_mask)
+    output_string = ""
+    (0..7).each do |i|
+      addr = 0
+      comp = 0
+      (0..7).each do |j|
+        # Read bit and complement from simulator.
+        addr_bit = @simulator.read_address_bit
+        comp_bit = @simulator.read_complement_bit
+
+        # Set them in variable.
+        addr = addr | (addr_bit * (2 ** j))
+        comp = comp | (comp_bit * (2 ** j))
+
+        # Override address bit to a 1 in variable if 1 in mask.
+        # Write whatever addr_bit ends up being back to the bus simulator.
+        if branch_mask[(i*8) + j] == 1
+          @simulator.write_bit(1)
+          addr = addr | (1 * (2 ** j))
+        else
+          @simulator.write_bit(addr_bit)
+        end
+      end
+
+      output_string << addr.to_s << "," << comp.to_s
+      output_string << "," if (i != 7 ) # No \n. TxRx strips it IRL.
+    end
+    output_string
+  end
+end
+
+# Monkeypatch Bus and Helper to stub in simulations.
+module Dino
+  module Components
+    module OneWire
+
+      class Bus
+        def read_power_supply
+          @parasite_power = false
+        end
+
+        def initialize(options={})
+          @board_sim = options[:board_sim]
+          super(options)
+        end
+
+        def _search(branch_mask)
+          @board_sim.reset
+          result = @board_sim.search(branch_mask)
+          # Manually call #update to simulate data recevieved from board.
+          self.update(result)
+        end
+      end
+
+      class Helper
+        def self.crc_check(bytes)
+          true
+        end
+      end
+    end
+  end
+end
+
+class OneWireEnumeratorTest < Minitest::Test
+  def test_find_all_addresses
+    # This gets slow with large number of devices.
+    bus_sim = BusSimulator.new(100)
+    board_sim = BoardSimulator.new(bus_sim)
+    bus = Dino::Components::OneWire::Bus.new board: BoardMock.new,
+                                             pin: 1,
+                                             board_sim: board_sim
+    bus.search
+
+    found_addresses = bus.found_devices.map { |d| d[:address] }
+    assert_equal found_addresses.sort, bus_sim.addresses.sort
+  end
+end
diff --git a/test/components/one_wire/helper_test.rb b/test/components/one_wire/helper_test.rb
new file mode 100644
index 00000000..1acf3f67
--- /dev/null
+++ b/test/components/one_wire/helper_test.rb
@@ -0,0 +1 @@
+# Test crc check.
diff --git a/test/components/one_wire/slave_test.rb b/test/components/one_wire/slave_test.rb
new file mode 100644
index 00000000..3369b746
--- /dev/null
+++ b/test/components/one_wire/slave_test.rb
@@ -0,0 +1,151 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+module Dino
+  module Components
+    module OneWire
+      class Bus
+        def read(num_bytes)
+          data = ""
+          num_bytes.times do
+            data << "," unless data.empty?
+            data << "255"
+          end
+          self.update(data)
+          self.pre_callback_filter(data)
+        end
+      end
+    end
+  end
+end
+
+class OneWireSlaveTest < MiniTest::Test
+  def bus
+    @bus ||= Dino::Components::OneWire::Bus.new(board: BoardMock.new, pin: 1)
+  end
+
+  def part
+    @part ||= Dino::Components::OneWire::Slave.new(bus: bus, address: 0xFFFFFFFFFFFFFFFF)
+  end
+
+  def test_requires_address
+    assert_raises(ArgumentError) { Dino::Components::OneWire::Slave.new(bus: bus) }
+  end
+
+  def test_atomically_locks_the_bus_mutex
+    mock = MiniTest::Mock.new.expect(:synchronize, nil)
+    bus.stub(:mutex, mock) do
+      part.atomically {}
+    end
+    mock.verify
+  end
+
+  def test_atomically_calls_the_block_once
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.atomically { mock.call }
+    mock.verify
+  end
+
+  def test_match_calls_reset
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    bus.stub(:reset, mock) do
+      part.match
+    end
+    mock.verify
+  end
+
+  def test_match_skips_rom_if_alone
+    mock = MiniTest::Mock.new.expect(:call, nil, [0xCC])
+    bus.stub(:write, mock) do
+      part.match
+    end
+    mock.verify
+  end
+
+  def test_match_matches_rom_if_not_alone
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [0x55])
+    mock.expect(:call, nil, [[255,255,255,255,255,255,255,255]])
+    bus.instance_variable_set(:@found_devices, [1,2])
+    bus.stub(:write, mock) do
+      part.match
+    end
+    mock.verify
+  end
+
+  def test_copy_scratch_is_atomic
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:atomically, mock) { part.copy_scratch }
+    mock.verify
+  end
+
+  def test_copy_scratch_matches_first
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:match, mock) { part.copy_scratch }
+    mock.verify
+  end
+
+  def test_copy_scratch_sends_the_command
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [0xCC])
+    mock.expect(:call, nil, [0x48])
+    bus.stub(:write, mock) { part.copy_scratch }
+    mock.verify
+  end
+
+  def test_copy_scratch_resets_after_command_if_parasite_power
+    mock = MiniTest::Mock.new.expect(:call, nil).expect(:call, nil)
+    bus.stub(:parasite_power, true) do
+      bus.stub(:reset, mock) { part.copy_scratch }
+    end
+    mock.verify
+  end
+
+  def test_read_scratch_is_atomic
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:atomically, mock) { part.read_scratch(9) }
+    mock.verify
+  end
+
+  def test_read_scratch_matches_first
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:match, mock) { part.read_scratch(9) }
+    mock.verify
+  end
+
+  def test_read_scratch_sends_the_command
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [0xCC])
+    mock.expect(:call, nil, [0xBE])
+    bus.stub(:write, mock) { part.read_scratch(9) }
+    mock.verify
+  end
+
+  def test_read_scratch_reads_bytes_from_bus
+    mock = MiniTest::Mock.new.expect(:call, nil, [9])
+    bus.stub(:read, mock) { part.read_scratch(9) }
+    mock.verify
+  end
+
+  def test_write_scratch_is_atomic
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:atomically, mock) { part.write_scratch(1) }
+    mock.verify
+  end
+
+  def test_write_scratch_matches_first
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:match, mock) { part.write_scratch(1) }
+    mock.verify
+  end
+
+  def test_write_scratch_sends_the_command_and_data
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [0xCC])
+    mock.expect(:call, nil, [0x4E])
+    mock.expect(:call, nil, [1,2,3])
+    bus.stub(:write, mock) { part.write_scratch(1, 2, 3) }
+    mock.verify
+  end
+end
diff --git a/test/components/register/select_test.rb b/test/components/register/select_test.rb
new file mode 100644
index 00000000..955e9e6d
--- /dev/null
+++ b/test/components/register/select_test.rb
@@ -0,0 +1,26 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class RegisterSelectTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Register::Select.new(board: board, pin: 14)
+  end
+
+  def test_default_to_output
+    mock = MiniTest::Mock.new.expect :call, nil, [14, :out]
+    board.stub(:set_pin_mode, mock) do
+      part
+    end
+    mock.verify
+  end
+
+  def test_callbacks
+    assert_includes Dino::Components::Register::Select.ancestors,
+                    Dino::Components::Mixins::Callbacks
+  end
+end
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
new file mode 100644
index 00000000..551cc0ce
--- /dev/null
+++ b/test/components/register/shift_in_test.rb
@@ -0,0 +1,70 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class RegisterShiftInTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board, pins: { clock: 12, data: 11, latch: 8 } }
+  end
+
+  def part
+    @part ||= Dino::Components::Register::ShiftIn.new(options)
+  end
+
+  def test_proxies
+    assert_equal Dino::Components::Basic::DigitalOutput, part.clock.class
+    assert_equal Dino::Components::Basic::DigitalInput,  part.data.class
+    assert_equal Dino::Components::Register::Select,     part.latch.class
+  end
+
+  def test_byte_length
+    new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
+    assert_equal 2, new_part.bytes
+  end
+
+  def test_rising_clock
+    assert_equal part.rising_clock, false
+    new_part = Dino::Components::Register::ShiftIn.new(options.merge(rising_clock: :yes))
+    assert_equal true, new_part.rising_clock
+  end
+
+  def test_read
+    # mock = MiniTest::Mock.new.expect :call, nil, ["22.8.1.#{[11,12,0].pack('C<*')}\n"]
+    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, 2, {preclock_high: true}]
+    board.stub(:shift_read, mock) do
+      new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2, rising_clock: true))
+      new_part.read
+    end
+    mock.verify
+  end
+
+  def test_callback_bubble
+    mock = MiniTest::Mock.new.expect :call, nil, ["127,255"]
+    part.stub(:update, mock) do
+      part.latch.update "127,255"
+    end
+    mock.verify
+  end
+
+  def test_bit_array_conversion
+    part.update("127")
+    assert_equal [0,1,1,1,1,1,1,1], part.state
+
+    new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
+    new_part.update("127,255")
+    assert_equal [0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1], new_part.state
+  end
+
+  def test_callbacks_get_bit_array
+    mock = MiniTest::Mock.new.expect :call, nil, [[0,1,1,1,1,1,1,1]]
+    part.add_callback do |data|
+      mock.call(data)
+    end
+    part.update("127")
+    mock.verify
+  end
+end
diff --git a/test/components/register/shift_out_test.rb b/test/components/register/shift_out_test.rb
new file mode 100644
index 00000000..711cc7c3
--- /dev/null
+++ b/test/components/register/shift_out_test.rb
@@ -0,0 +1,33 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class RegisterShiftOutTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board, pins: { clock: 12, data: 11, latch: 8 } }
+  end
+
+  def part
+    @part ||= Dino::Components::Register::ShiftOut.new(options)
+  end
+
+  def test_proxies
+    assert_equal Dino::Components::Basic::DigitalOutput, part.clock.class
+    assert_equal Dino::Components::Basic::DigitalOutput, part.data.class
+    assert_equal Dino::Components::Register::Select,     part.latch.class
+  end
+
+  def test_write
+    # mock = MiniTest::Mock.new.expect :call, nil, ["21.8.1.#{[11,12,0,255,127].pack('C*')}\n"]
+    new_part = Dino::Components::Register::ShiftOut.new(options.merge(bytes: 2))
+    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, [255,127]]
+    board.stub(:shift_write, mock) do
+      new_part.write(255,127)
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/rgb_led_test.rb b/test/components/rgb_led_test.rb
new file mode 100644
index 00000000..0b55bf1f
--- /dev/null
+++ b/test/components/rgb_led_test.rb
@@ -0,0 +1,66 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class RGBLedTest < MiniTest::Test
+ def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board, pins: { red: 1, green: 2, blue: 3 } }
+  end
+
+  def part
+    @part ||= Dino::Components::RGBLed.new(options)
+  end
+
+  def test_proxies
+    assert_equal Dino::Components::Basic::AnalogOutput, part.red.class
+    assert_equal Dino::Components::Basic::AnalogOutput, part.green.class
+    assert_equal Dino::Components::Basic::AnalogOutput, part.blue.class
+  end
+
+  def test_write
+    red_mock = MiniTest::Mock.new.expect :write, nil, [0]
+    green_mock = MiniTest::Mock.new.expect :write, nil, [128]
+    blue_mock = MiniTest::Mock.new.expect :write, nil, [0]
+
+    part.stub(:red, red_mock) do
+      part.stub(:green, green_mock) do
+        part.stub(:blue, blue_mock) do
+          part.write [0, 128, 0]
+        end
+      end
+    end
+    red_mock.verify
+    green_mock.verify
+    blue_mock.verify
+  end
+
+  def test_color_array
+    mock = MiniTest::Mock.new.expect :call, nil, [[128,0,0]]
+    part.stub(:write, mock) do
+      part.color = [128,0,0]
+    end
+    mock.verify
+  end
+
+  def test_color_names
+    colors = Dino::Components::RGBLed::COLORS
+
+    mock = MiniTest::Mock.new
+    colors.each_value do |color|
+      mock.expect :call, nil, [color]
+      mock.expect :call, nil, [color]
+    end
+
+    part.stub(:write, mock) do
+      colors.each_key do |key|
+        part.color = key
+        part.color = key.to_s
+      end
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/servo_test.rb b/test/components/servo_test.rb
new file mode 100644
index 00000000..3cf78407
--- /dev/null
+++ b/test/components/servo_test.rb
@@ -0,0 +1,63 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class ServoTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Servo.new(board: board, pin:1, min: 0, max: 360)
+  end
+
+  def test_toggle_on_initialize
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, :on, Hash])
+    board.stub(:servo_toggle, mock) do
+      Dino::Components::Servo.new(board: board, pin:1)
+    end
+  end
+
+  def test_attach
+    part
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, :on, Hash])
+    board.stub(:servo_toggle, mock) { part.attach }
+    mock.verify
+  end
+
+  def test_detach
+    part
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, :off, Hash])
+    board.stub(:servo_toggle, mock) { part.detach }
+    mock.verify
+  end
+
+  def test_position_modulo_180
+    part.position = 190
+    assert_equal 10, part.position
+    part.position = 180
+    assert_equal 180, part.position
+    part.position = 0
+    assert_equal 0, part.position
+    part.position = -1
+    assert_equal 179, part.position
+  end
+
+  def test_position_writes_mapped_microseconds_to_board
+    part
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, 20])
+    board.stub(:servo_write, mock) do
+      part.position = 10
+    end
+    mock.verify
+  end
+
+  def test_speed_writes_mapped_microseconds_to_board
+    part
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, 180])
+    board.stub(:servo_write, mock) do
+      part.speed = 0
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/setup/base_test.rb b/test/components/setup/base_test.rb
new file mode 100644
index 00000000..4a7b3434
--- /dev/null
+++ b/test/components/setup/base_test.rb
@@ -0,0 +1,22 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class BaseComponent
+  include Dino::Components::Setup::Base
+end
+
+class BaseSetupTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def test_requires_board
+    assert_raises(ArgumentError) { BaseComponent.new }
+  end
+
+  def test_registers_with_board
+    part = BaseComponent.new(board: board)
+    assert_equal board.components, [part]
+  end
+end
diff --git a/test/components/setup/input_test.rb b/test/components/setup/input_test.rb
new file mode 100644
index 00000000..b65678ab
--- /dev/null
+++ b/test/components/setup/input_test.rb
@@ -0,0 +1,42 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class InputComponent
+  include Dino::Components::Setup::Input
+end
+
+class InputSetupTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= InputComponent.new(board: board, pin: 1)
+  end
+
+  def test_pin_mode
+    mock = Minitest::Mock.new.expect :call, nil, [1, :in]
+    board.stub(:set_pin_mode, mock) do
+      part
+    end
+    mock.verify
+  end
+
+  def test_pullup
+    mock = Minitest::Mock.new
+    mock.expect :call, nil, [1, nil]
+    mock.expect :call, nil, [1, true]
+    board.stub(:set_pullup, mock) do
+      part.pullup = true
+    end
+    mock.verify
+  end
+
+  def test_pullup_in_options
+    mock = Minitest::Mock.new.expect :call, nil, [2, true]
+    board.stub(:set_pullup, mock) do
+      new_part = InputComponent.new(board: board, pin: 2, pullup: true)
+    end
+  end
+end
diff --git a/test/components/setup/multi_pin_test.rb b/test/components/setup/multi_pin_test.rb
new file mode 100644
index 00000000..40bb6140
--- /dev/null
+++ b/test/components/setup/multi_pin_test.rb
@@ -0,0 +1,61 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class MultiPinComponent
+  include Dino::Components::Setup::MultiPin
+  require_pin :one
+  proxy_pin   two:   Dino::Components::Basic::DigitalOutput
+  proxy_pin   maybe: Dino::Components::Basic::DigitalInput, optional: true
+end
+
+class MultiPinSetupTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= MultiPinComponent.new board: board,
+                                    pins: { one: 9, two: 10, maybe: 11 }
+  end
+
+  def test_require_pins
+    assert_equal MultiPinComponent.class_variable_get(:@@required_pins), [:one, :two]
+  end
+
+  def test_proxy_pins
+    assert_equal MultiPinComponent.class_variable_get(:@@proxied_pins),
+                 {two:   Dino::Components::Basic::DigitalOutput,
+                  maybe: Dino::Components::Basic::DigitalInput}
+  end
+
+  def test_validate_pins
+    assert_raises(ArgumentError) do
+      MultiPinComponent.new board: board, pins: { one: 9, maybe: 11 }
+    end
+    assert_raises(ArgumentError) do
+      MultiPinComponent.new board: board, pins: { one: 10, maybe: 11 }
+    end
+    MultiPinComponent.new board: board, pins: { one: 9, two:10 }
+  end
+
+  def test_build_proxies
+    assert_equal Dino::Components::Basic::DigitalOutput, part.proxies[:two].class
+    assert_equal Dino::Components::Basic::DigitalInput, part.proxies[:maybe].class
+  end
+
+  def test_proxy_reader_methods
+    assert_equal part.proxies[:two], part.two
+    assert_equal part.proxies[:maybe], part.maybe
+  end
+
+  def test_pins_mapped_correctly
+    assert_equal 10, part.two.pin
+    assert_equal 11, part.maybe.pin
+  end
+
+  def test_proxy_states
+    part.two.high
+    assert_equal({two: board.high, maybe: nil}, part.proxy_states)
+  end
+end
diff --git a/test/components/setup/output_test.rb b/test/components/setup/output_test.rb
new file mode 100644
index 00000000..59c44c5d
--- /dev/null
+++ b/test/components/setup/output_test.rb
@@ -0,0 +1,25 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class OutputComponent
+  include Dino::Components::Setup::Output
+end
+
+class OutputSetupTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= OutputComponent.new(board: board, pin: 1)
+  end
+
+  def test_pin_mode
+    mock = Minitest::Mock.new.expect :call, nil, [1, :out]
+    board.stub(:set_pin_mode, mock) do
+      part
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/setup/single_pin_test.rb b/test/components/setup/single_pin_test.rb
new file mode 100644
index 00000000..9308d825
--- /dev/null
+++ b/test/components/setup/single_pin_test.rb
@@ -0,0 +1,21 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class SinglePinComponent
+  include Dino::Components::Setup::Input
+end
+
+class SinglePinSetupTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= SinglePinComponent.new(board: board, pin: 1)
+  end
+
+  def test_requires_pin
+    assert_raises(ArgumentError) { SinglePinComponent.new(board: board) }
+  end
+end
diff --git a/test/components/software_serial_test.rb b/test/components/software_serial_test.rb
new file mode 100644
index 00000000..da07697d
--- /dev/null
+++ b/test/components/software_serial_test.rb
@@ -0,0 +1,33 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class SoftwareSerialTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::SoftwareSerial.new board: board, pins: { rx: 10, tx: 11 }, baud: 4800
+  end
+
+  def test_initialize
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, ["12..0.10,11\n"]
+    mock.expect :call, nil, ["12..1.4800\n"]
+    board.stub(:write, mock) do
+      part
+    end
+    mock.verify
+  end
+
+  def test_puts
+    part
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, ["12..3.Testing\n"]
+    board.stub(:write, mock) do
+      part.puts("Testing")
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/ssd_test.rb b/test/components/ssd_test.rb
new file mode 100644
index 00000000..23b386a2
--- /dev/null
+++ b/test/components/ssd_test.rb
@@ -0,0 +1,82 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class SSDTest < MiniTest::Test
+ def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board,
+      pins: {anode: 11, a: 12, b: 13, c: 3, d: 4, e: 5, f: 10, g: 9} }
+  end
+
+  def part
+    @part ||= Dino::Components::SSD.new(options)
+  end
+
+  def test_proxies
+    segments = [:a, :b, :c, :d, :e, :f, :g]
+    segments.each do |segment|
+      assert_equal Dino::Components::Basic::DigitalOutput, part.proxies[segment].class
+    end
+  end
+
+  def test_initialize_clear
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:clear, mock) do
+      part.send(:initialize, options)
+    end
+    mock.verify
+  end
+
+  def test_initialize_on
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:on, mock) do
+      part.send(:initialize, options)
+    end
+    mock.verify
+  end
+
+  def test_on
+    mock = MiniTest::Mock.new.expect :high, nil
+    part.stub(:anode, mock) do
+      part.on
+    end
+    mock.verify
+  end
+
+  def test_off
+    mock = MiniTest::Mock.new.expect :low, nil
+    part.stub(:anode, mock) do
+      part.off
+    end
+    mock.verify
+  end
+
+  def test_scroll
+    mock = MiniTest::Mock.new.expect :call, nil, ['foo']
+    part.stub(:scroll, mock) do
+      part.display('foo')
+    end
+    mock.verify
+  end
+
+  def test_display_ensures_on
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:on, mock) do
+      part.display(1)
+    end
+    mock.verify
+  end
+
+  def test_display_clears_if_unknown_char
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:clear, mock) do
+      part.display('+')
+    end
+    mock.verify
+  end
+  # Test with cathode
+end
diff --git a/test/components/stepper_test.rb b/test/components/stepper_test.rb
new file mode 100644
index 00000000..7e17c3f7
--- /dev/null
+++ b/test/components/stepper_test.rb
@@ -0,0 +1,49 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class StepperTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Stepper.new board: board,
+                                            pins: {step: 9, direction: 10}
+  end
+
+  def test_initialize
+    assert_equal Dino::Components::Basic::DigitalOutput, part.step.class
+    assert_equal Dino::Components::Basic::DigitalOutput, part.direction.class
+  end
+
+  def test_step_cw
+    dir_mock = MiniTest::Mock.new.expect :low, nil
+    step_mock = MiniTest::Mock.new
+    step_mock.expect :high, nil
+    step_mock.expect :low, nil
+
+    part.stub(:direction, dir_mock) do
+      part.stub(:step, step_mock) do
+        part.step_cw
+      end
+    end
+    dir_mock.verify
+    step_mock.verify
+  end
+
+  def test_step_cc
+    dir_mock = MiniTest::Mock.new.expect :high, nil
+    step_mock = MiniTest::Mock.new
+    step_mock.expect :high, nil
+    step_mock.expect :low, nil
+
+    part.stub(:direction, dir_mock) do
+      part.stub(:step, step_mock) do
+        part.step_cc
+      end
+    end
+    dir_mock.verify
+    step_mock.verify
+  end
+end
diff --git a/test/message_test.rb b/test/message_test.rb
new file mode 100644
index 00000000..d56294da
--- /dev/null
+++ b/test/message_test.rb
@@ -0,0 +1,44 @@
+require 'dino'
+require 'minitest/autorun'
+
+class MessageTest < Minitest::Test
+  def test_require_a_command
+    assert_raises(ArgumentError) { Dino::Message.encode }
+    assert_instance_of String, Dino::Message.encode(command: 90)
+  end
+
+  def test_require_command_in_correct_range
+    assert_raises(ArgumentError) { Dino::Message.encode command: -1 }
+    assert_raises(ArgumentError) { Dino::Message.encode command: 256 }
+  end
+
+  def test_require_pin_in_correct_range
+    assert_raises(ArgumentError) { Dino::Message.encode command: 0, pin: -1 }
+    assert_raises(ArgumentError) { Dino::Message.encode command: 0, pin: 256 }
+  end
+
+  def test_require_value_in_correct_range
+    assert_raises(ArgumentError) { Dino::Message.encode command: 0, value: -1 }
+    assert_raises(ArgumentError) { Dino::Message.encode command: 0, value: 256 }
+  end
+
+  # Test that aux message is limited by board aux_limit
+
+  def test_build_messages_correctly
+    assert_equal "1.1.1\n",    Dino::Message.encode(command: 1, pin: 1, value: 1)
+    assert_equal "1.1\n",      Dino::Message.encode(command: 1, pin: 1)
+    assert_equal "1..1\n",     Dino::Message.encode(command: 1, value: 1)
+    assert_equal "1\n",        Dino::Message.encode(command: 1)
+    assert_equal "1...test\n", Dino::Message.encode(command: 1, aux_message: "test")
+  end
+
+  def test_escape_newline_in_aux
+    assert_equal Dino::Message.encode(command: 1, aux_message: "line1\nline2"),
+                 "1...line1\\\nline2\n"
+  end
+
+  def test_escape_backslash_in_aux
+    assert_equal Dino::Message.encode(command: 1, aux_message: "line1\\line2"),
+                "1...line1\\\\line2\n"
+  end
+end
diff --git a/test/test_helper.rb b/test/test_helper.rb
new file mode 100644
index 00000000..b5b6a24b
--- /dev/null
+++ b/test/test_helper.rb
@@ -0,0 +1,29 @@
+require 'dino'
+
+# Nice little helper module to redefine constants quietly.
+module Constants
+  def self.redefine(const, value, opts={})
+    opts = {:on => self.class}.merge(opts)
+    opts[:on].send(:remove_const, const) if self.class.const_defined?(const)
+    opts[:on].const_set(const, value)
+  end
+end
+
+# Taken from: https://gist.github.com/moertel/11091573
+def suppress_output
+  begin
+    original_stderr = $stderr.clone
+    original_stdout = $stdout.clone
+    $stderr.reopen(File.new('/dev/null', 'w'))
+    $stdout.reopen(File.new('/dev/null', 'w'))
+    retval = yield
+  rescue Exception => e
+    $stdout.reopen(original_stdout)
+    $stderr.reopen(original_stderr)
+    raise e
+  ensure
+    $stdout.reopen(original_stdout)
+    $stderr.reopen(original_stderr)
+  end
+  retval
+end
diff --git a/test/txrx/serial_test.rb b/test/txrx/serial_test.rb
new file mode 100644
index 00000000..29aace3d
--- /dev/null
+++ b/test/txrx/serial_test.rb
@@ -0,0 +1,159 @@
+require 'dino'
+require 'minitest/autorun'
+require 'txrx_mock'
+require 'test_helper'
+
+class DummySerial
+  def read
+    ""
+  end
+
+  def write(message)
+    nil
+  end
+end
+
+class TxRxSerialTest < Minitest::Test
+  def mock_tty_device
+    "/dev/mock_serial"
+  end
+
+  def txrx
+    @txrx ||= Dino::TxRx::Serial.new
+  end
+
+  def io
+    suppress_output do
+      txrx.send(:io)
+    end
+  end
+
+  def test_connect_with_device_specified
+    mock = MiniTest::Mock.new.expect(:call, "serial-obj", ["/dev/ttyACM0", 9600])
+    Serial.stub(:new, mock) do
+      txrx = Dino::TxRx::Serial.new(device: "/dev/ttyACM0", baud: 9600)
+      assert_equal "serial-obj", suppress_output { txrx.send(:io) }
+    end
+    mock.verify
+  end
+
+  def test_connect_with_no_devices
+    txrx.stub(:tty_devices, []) do
+      assert_raises(Dino::TxRx::SerialConnectError) { io }
+    end
+  end
+
+  def test_connect_on_unix
+    txrx.stub(:tty_devices, ['/dev/ttyACM0', '/dev/tty.usbmodem1']) do
+      mock =  MiniTest::Mock.new
+      # Raise error for first device
+      mock.expect(:call, nil) { raise RubySerial::Error }
+      mock.expect :call, "serial-obj", ['/dev/tty.usbmodem1', Dino::TxRx::Serial::BAUD]
+
+      Serial.stub(:new, mock) do
+        assert_equal "serial-obj", io
+      end
+      mock.verify
+    end
+  end
+
+  def test_connect_on_windows
+    # Simulate being on Windows
+    original_platform = RUBY_PLATFORM
+    Constants.redefine(:RUBY_PLATFORM, "mswin", :on => Object)
+
+    mock =  MiniTest::Mock.new
+    # Raise error for COM1
+    mock.expect(:call, nil) { raise RubySerial::Error }
+    mock.expect :call, "serial-obj", ["COM2", Dino::TxRx::Serial::BAUD]
+
+    Serial.stub(:new, mock) do
+      assert_equal "serial-obj", io
+    end
+    mock.verify
+
+    # Set platform back to original value
+    Constants.redefine(:RUBY_PLATFORM, original_platform, :on => Object)
+  end
+
+  def test_io_reset
+    flush_mock = MiniTest::Mock.new.expect :call, true
+    stop_mock = MiniTest::Mock.new.expect :call, true
+    start_mock = MiniTest::Mock.new.expect :call, true
+    txrx.stub(:flush_read, flush_mock) do
+      txrx.stub(:stop_read, stop_mock) do
+        txrx.stub(:start_read, start_mock) do
+          txrx.send(:io_reset)
+        end
+      end
+    end
+    flush_mock.verify
+    stop_mock.verify
+    start_mock.verify
+  end
+
+  def test_read_and_parse
+    # Should not split on any colon after the first.
+    txrx.stub(:read, "02:00:00") do
+      txrx.stub(:changed, true) do
+        mock = MiniTest::Mock.new.expect :call, nil, ['02', '00:00']
+        txrx.stub(:notify_observers, mock) do
+          txrx.send(:read_and_parse)
+        end
+        mock.verify
+      end
+    end
+  end
+
+  # Test start read?
+
+  def test_stop_read
+    thread = Thread.new { sleep }
+    mock = MiniTest::Mock.new.expect :call, nil, [thread]
+    txrx.instance_variable_set(:@thread, thread)
+
+    Thread.stub(:kill, mock) do
+      txrx.send(:stop_read)
+    end
+    mock.verify
+  end
+
+  def test_write
+    mock = MiniTest::Mock.new.expect :write, nil, ['message']
+    txrx.stub(:io, mock) do
+      txrx.write('message')
+    end
+    mock.verify
+  end
+
+  def test_read_single_chars_until_newline_and_strips_it
+    mock = MiniTest::Mock.new
+    "line\n".split("").each do |char|
+      mock.expect :read, char, [1]
+    end
+    txrx.stub(:io, mock) do
+      assert_equal "line", txrx.send(:read)
+    end
+    mock.verify
+  end
+
+  def test_read_handles_escaped_newlines_and_backslashes
+    mock = MiniTest::Mock.new
+    "l1\\\nl2\\\\\n".split("").each do |char|
+      mock.expect :read, char, [1]
+    end
+    txrx.stub(:io, mock) do
+      assert_equal "l1\nl2\\", txrx.send(:read)
+    end
+    mock.verify
+  end
+
+  def test_read_returns_empty_string_if_just_newline
+    mock = MiniTest::Mock.new
+    mock.expect :read, "\n", [1]
+    txrx.stub(:io, mock) do
+      assert_equal "", txrx.send(:read)
+    end
+    mock.verify
+  end
+end
diff --git a/test/txrx/tcp_test.rb b/test/txrx/tcp_test.rb
new file mode 100644
index 00000000..a10f4958
--- /dev/null
+++ b/test/txrx/tcp_test.rb
@@ -0,0 +1,43 @@
+require 'dino'
+require 'minitest/autorun'
+require 'txrx_mock'
+require 'test_helper'
+
+class DummySerial
+  def read
+    ""
+  end
+
+  def write(message)
+    nil
+  end
+end
+
+class TxRxTCPTest < Minitest::Test
+  def txrx
+    @txrx ||= Dino::TxRx::TCP.new("127.0.0.1", 3467)
+  end
+
+  def io
+    suppress_output do
+      txrx.send(:io)
+    end
+  end
+
+  def test_connect_raises_if_server_unavailable
+    assert_raises(Dino::TxRx::TCPConnectError) { io }
+  end
+
+  def test_connect
+    server = TCPServer.new 3467
+    assert_equal TCPSocket, io.class
+    server.close
+  end
+
+  def test_io_doesnt_reconnect
+    server = TCPServer.new 3467
+    socket = io
+    assert_equal socket, io
+    server.close
+  end
+end
diff --git a/test/txrx_mock.rb b/test/txrx_mock.rb
new file mode 100644
index 00000000..80edbd40
--- /dev/null
+++ b/test/txrx_mock.rb
@@ -0,0 +1,10 @@
+require 'dino'
+
+class TxRxMock
+  def add_observer(board); true; end
+  def read; true; end
+  def write(str); true; end
+  def handshake
+    "528,14,20"
+  end
+end

From a6aa8b91a0a48685295faff94cc6af744e655a0d Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 10 Mar 2018 08:35:15 -0400
Subject: [PATCH 191/296] millis instead of micros for receive acknowledgement

---
 src/lib/Dino.cpp | 4 ++--
 src/lib/Dino.h   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index d1a0e3b3..a444c566 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -30,10 +30,10 @@ void Dino::run(){
     // Acknowledge when we've received as many bytes as the serial input buffer
     if (rcvBytes == rcvThreshold) acknowledge();
   }
-  if (gotByte) lastRcv = micros();
+  if (gotByte) lastRcv = millis();
 
   // Also acknowledge when the last byte received goes outside the receive window.
-  if ((rcvBytes > 0) && ((micros() - lastRcv) > rcvWindow)) acknowledge();
+  if ((rcvBytes > 0) && ((millis() - lastRcv) > rcvWindow)) acknowledge();
 
   // Run dino's listeners.
   updateListeners();
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index a31e778b..77944152 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -149,7 +149,7 @@ class Dino {
     // Keep count of bytes as we receive them and send a dino message with how many.
     uint8_t rcvBytes  = 0;
     uint8_t rcvThreshold = 64;
-    unsigned long lastRcv = micros();
-    long long rcvWindow = 1000000;
+    unsigned long lastRcv = millis();
+    long long rcvWindow = 1000;
 };
 #endif

From e633e653447ccf45d4e43b2055194d4aea09b36f Mon Sep 17 00:00:00 2001
From: Vasiliy Gandzha <vasivik@gmail.com>
Date: Thu, 3 May 2018 16:23:50 +0700
Subject: [PATCH 192/296] Update helper.rb

fix error for ruby 2+
---
 lib/dino/components/one_wire/helper.rb | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
index b4fcbd29..1bfff474 100644
--- a/lib/dino/components/one_wire/helper.rb
+++ b/lib/dino/components/one_wire/helper.rb
@@ -2,12 +2,14 @@ module Dino
   module Components
     module OneWire
       class Helper
+        ADDRESS_TO_BYTES_CLASSES = [Integer, Bignum, Fixnum].freeze
+
         def self.address_to_bytes(address)
           [address].pack('Q<').split("").map(&:ord)
         end
 
         def self.crc_check(data)
-          if data.class == Integer
+          if ADDRESS_TO_BYTES_CLASSES.include?(data.class)
             bytes = address_to_bytes(data)
           else
             bytes = data

From 5d2063cfea3a0a0ffb3bb751edf1cf41ad821c2c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 1 Dec 2018 15:20:40 -0400
Subject: [PATCH 193/296] Small fixes to examples and comments

---
 examples/ethernet.rb                          | 15 --------
 examples/one_wire/ds18b20.rb                  |  2 +-
 .../rotary_encoder_mac_volume.rb              | 12 +++----
 examples/ser2net.rb                           | 31 -----------------
 examples/stepper/stepper.rb                   | 16 ++++-----
 examples/tcp.rb                               | 34 +++++++++++++++++++
 lib/dino/components/i2c/bus.rb                | 12 ++++---
 lib/dino/components/one_wire/bus.rb           |  1 +
 src/dino_wifi.ino                             |  2 +-
 9 files changed, 57 insertions(+), 68 deletions(-)
 delete mode 100644 examples/ethernet.rb
 delete mode 100644 examples/ser2net.rb
 create mode 100644 examples/tcp.rb

diff --git a/examples/ethernet.rb b/examples/ethernet.rb
deleted file mode 100644
index 832dcee1..00000000
--- a/examples/ethernet.rb
+++ /dev/null
@@ -1,15 +0,0 @@
-#
-# This example shows how to use an Arduino with an Ethernet shield and the du_ethernet.ino sketch loaded.
-# Replace the IP address in this example with the IP you used when uploading the sketch.
-# The Ethernet shield uses up pin 13, so you'll need an LED on pin 5 to make sure it's working.
-#
-require File.expand_path('../../lib/dino', __FILE__)
-
-connection = Dino::TxRx::TCP.new("192.168.0.77")
-board = Dino::Board.new(connection)
-led = Dino::Components::Led.new(pin: 5, board: board)
-
-[:on, :off].cycle do |switch|
-  led.send(switch)
-  sleep 0.5
-end
diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index 5745aecb..be655c4c 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -14,7 +14,7 @@
 end
 
 # Call #device_present to reset the bus and return presence pulse as a boolean.
-if bus.device_present
+if bus.device_present?
   puts "Devices present on bus..."; puts
 else
   puts "No devices present on bus... Quitting..."
diff --git a/examples/rotary_encoder/rotary_encoder_mac_volume.rb b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
index bc80a479..160e60f2 100644
--- a/examples/rotary_encoder/rotary_encoder_mac_volume.rb
+++ b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
@@ -1,10 +1,5 @@
 #
-# Example of a smiple rotary encoder polling at ~1ms.
-#
-# WARNING: This method is not precise at all. Please do not use it for anything
-# that requires all steps to be read for precise positioning or high speed.
-#
-# Works well enough for making knobs like this example though.
+# Example using a rotary encoder to control audio output volume on a Mac.
 #
 require 'bundler/setup'
 require 'dino'
@@ -50,8 +45,9 @@ def set(value)
   value = 0 if value < 0
   value = 100 if value > 100
   volume.set(value)
-  unused_steps = value - volume.get
-  puts "Current volume: #{volume.get}%"
+  current_volume = volume.get
+  unused_steps = value - current_volume
+  puts "Current volume: #{current_volume}%"
 end
 
 sleep
diff --git a/examples/ser2net.rb b/examples/ser2net.rb
deleted file mode 100644
index 17d2afe5..00000000
--- a/examples/ser2net.rb
+++ /dev/null
@@ -1,31 +0,0 @@
-#
-# This example shows how to use an Arduino on a remote machine via ser2net.
-# Running ser2net serves up the serial connection over the network interface,
-# so you can communicate with the Arduino over your local network or the Internet.
-# 
-# Example ser2net command for an Arduino UNO on Mac:
-# ser2net -u -C "3466:raw:0:/dev/cu.usbmodem621:115200"
-#
-# Note that we're using ser2net in raw TCP mode and not telnet mode which is more common.
-# 
-# Replace /dev/cu.usbmodem621 with your Arduino device.
-# Arduino UNOs are usually /dev/ttyACM0 under Linux.
-#
-# ser2net is preinstalled on many Linuxes. Install ser2net at the Mac Terminal with:
-# brew install ser2net
-#
-# http://sourceforge.net/projects/ser2net/ for more info on installing and configuring ser2net.
-#
-
-require File.expand_path('../../lib/dino', __FILE__)
-
-# The remote ser2net host is the first argument for a new TxRx::TCP.
-# The second argument, port number, is optional. 3466 is default. This must match the port ser2net uses on the remote machine.
-connection = Dino::TxRx::TCP.new("127.0.0.1", 3466)
-board = Dino::Board.new(connection)
-led = Dino::Components::Led.new(pin: 13, board: board)
-
-[:on, :off].cycle do |switch|
-  led.send(switch)
-  sleep 0.5
-end
diff --git a/examples/stepper/stepper.rb b/examples/stepper/stepper.rb
index 6a403d6c..c79c8b2c 100644
--- a/examples/stepper/stepper.rb
+++ b/examples/stepper/stepper.rb
@@ -7,12 +7,12 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 stepper = Dino::Components::Stepper.new(board: board, pins: { step: 10, direction: 8 })
 
-  1600.times do
-    stepper.step_cc
-    sleep 0.001
-  end
+1600.times do
+  stepper.step_cc
+  sleep 0.001
+end
 
-  1600.times do
-    stepper.step_cw
-    sleep 0.001
-  end
+1600.times do
+  stepper.step_cw
+  sleep 0.001
+end
diff --git a/examples/tcp.rb b/examples/tcp.rb
new file mode 100644
index 00000000..114b5063
--- /dev/null
+++ b/examples/tcp.rb
@@ -0,0 +1,34 @@
+require 'bundler/setup'
+require 'dino'
+#
+# This example shows how to use dino when connecting to a board via TCP.
+# This applies to the WiFi and Ethernet sketches, or serial sketch + ser2net.
+# Port number defaults to 3466 (dino), but may be given as a second argument.
+# It must correspond to the listening port set when the board was flashed.
+#
+connection = Dino::TxRx::TCP.new("127.0.0.1", 3466)
+# connection = Dino::TxRx::TCP.new("127.0.0.1")
+# connection = Dino::TxRx::TCP.new("192.168.1.2", 3466)
+#
+board = Dino::Board.new(connection)
+led = Dino::Components::Led.new(pin: 13, board: board)
+
+[:on, :off].cycle do |switch|
+  led.send(switch)
+  sleep 0.5
+end
+#
+# ser2net can be used to simulate a TCP interface from a board running dino serial.
+# It serves the serial interface over a TCP port from the machine running ser2net.
+#
+# Example ser2net command for an Arduino UNO connected to a Mac:
+# ser2net -u -C "3466:raw:0:/dev/cu.usbmodem621:115200"
+#
+# Tell dino to connect to the IP address of the Mac, at port 3466.
+# Note: ser2net should be used in raw TCP mode, not telnet mode (more common).
+#
+# Replace /dev/cu.usbmodem621 with your dino serial device.
+# Arduino UNOs should be something like /dev/ttyACM0 under Linux.
+#
+# http://sourceforge.net/projects/ser2net/ for more info on installing and configuring ser2net.
+#
diff --git a/lib/dino/components/i2c/bus.rb b/lib/dino/components/i2c/bus.rb
index c36db726..bdc6904b 100644
--- a/lib/dino/components/i2c/bus.rb
+++ b/lib/dino/components/i2c/bus.rb
@@ -22,6 +22,10 @@ def write(address, bytes=[], options={})
           board.i2c_write(address, [bytes].flatten, options)
         end
 
+        def transfer(address, options={})
+          board.i2c_transfer(address, options)
+        end
+
         def read(*args)
           read_using -> { _read(*args) }
         end
@@ -36,15 +40,15 @@ def bubble_callbacks
               address, data = str.split("-", 2)
               address = address.to_i
               data = data.split(",").map(&:to_i)
-              update_component({address: address, data: data})
+              update_component(address, data)
             end
           end
         end
 
-        def update_component(hash)
+        def update_component(address, data)
           components.each do |component|
-            if component.address == hash[:address]
-              component.update(hash[:data])
+            if component.address == address
+              component.update(data)
             end
           end
         end
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index 7b3b81b6..35862815 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -40,6 +40,7 @@ def device_present
             (byte == 0) ? true : false
           end
         end
+        alias :device_present? :device_present
 
         def reset(get_presence=0)
           board.one_wire_reset(pin, get_presence)
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 38c95807..6c6e2e04 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -8,7 +8,7 @@
   #define LED_PIN 13
 #endif
 
-// Configure your WiFi options here. IP address are not configurable. Uses DHCP.
+// Configure your WiFi options here. IP address is not configurable. Uses DHCP.
 int port = 3466;
 char* ssid = "yourNetwork";
 char* pass = "yourPassword";

From fa8d65027412ccf113100848075c4b0491bd8086 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 2 Dec 2018 01:47:08 -0400
Subject: [PATCH 194/296] Add basic EEPROM read/write functionality

---
 dino.gemspec                              |  2 +-
 lib/dino/api.rb                           |  1 +
 lib/dino/api/core.rb                      |  4 +-
 lib/dino/api/eeprom.rb                    | 24 ++++++++++++
 lib/dino/board/base.rb                    | 32 ++++++++++++---
 lib/dino/components/basic.rb              |  3 +-
 lib/dino/components/basic/board_eeprom.rb | 47 +++++++++++++++++++++++
 lib/dino/components/mixins/reader.rb      |  6 ++-
 lib/dino/tx_rx/base.rb                    |  5 +--
 lib/dino_cli/packages.rb                  |  1 -
 src/lib/Dino.cpp                          |  9 +++--
 src/lib/Dino.h                            | 10 ++++-
 src/lib/DinoBugWorkaround.cpp             | 24 ------------
 src/lib/DinoCoreIO.cpp                    | 47 ++++++++++++++++++++++-
 src/lib/DinoSPI.cpp                       |  8 ++--
 test/api/core_test.rb                     |  8 ++--
 test/board_test.rb                        | 15 +++++---
 test/txrx/serial_test.rb                  |  3 +-
 test/txrx_mock.rb                         |  2 +-
 19 files changed, 188 insertions(+), 63 deletions(-)
 create mode 100644 lib/dino/api/eeprom.rb
 create mode 100644 lib/dino/components/basic/board_eeprom.rb
 delete mode 100644 src/lib/DinoBugWorkaround.cpp

diff --git a/dino.gemspec b/dino.gemspec
index 7d9d24cb..4b0e967a 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -34,7 +34,7 @@ Gem::Specification.new do |gem|
   gem.version       = Dino::VERSION
   gem.executables   = ["dino"]
 
-  gem.add_dependency 'rubyserial', '~> 0.5.0'
+  gem.add_dependency 'rubyserial', '~> 0.6.0'
   gem.add_dependency 'bcd', '~> 0.3.0'
 
   gem.add_development_dependency 'rake'
diff --git a/lib/dino/api.rb b/lib/dino/api.rb
index 8d10255a..94d61e96 100644
--- a/lib/dino/api.rb
+++ b/lib/dino/api.rb
@@ -2,6 +2,7 @@ module Dino
   module API
     require 'dino/api/helper'
     require 'dino/api/core'
+    require 'dino/api/eeprom'
     require 'dino/api/dht'
     require 'dino/api/i2c'
     require 'dino/api/infrared'
diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index 14eadb3a..609b9834 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -38,7 +38,7 @@ def set_pullup(pin, pullup)
         pullup ? digital_write(pin, @high) : digital_write(pin, @low)
       end
 
-      # CMD = 7
+      # CMD = 5
       def set_listener(pin, state=:off, options={})
         mode    = options[:mode]    || :digital
         divider = options[:divider] || 8
@@ -54,7 +54,7 @@ def set_listener(pin, state=:off, options={})
         mask |= 0b10000000 if (state == :on)
         mask |= 0b01000000 if (mode == :analog)
 
-        write Message.encode(command: 7, pin: convert_pin(pin), value: mask)
+        write Message.encode(command: 5, pin: convert_pin(pin), value: mask)
       end
 
       # Convenience methods by wrapping set_listener with old defaults.
diff --git a/lib/dino/api/eeprom.rb b/lib/dino/api/eeprom.rb
new file mode 100644
index 00000000..2b918220
--- /dev/null
+++ b/lib/dino/api/eeprom.rb
@@ -0,0 +1,24 @@
+module Dino
+  module API
+    module EEPROM
+      include Helper
+
+      # CMD = 6
+      def eeprom_read(address, num_bytes)
+        address = pack :uint16, address
+        write Message.encode command: 6,
+                             value: num_bytes,
+                             aux_message: address
+      end
+
+      # CMD = 7
+      def eeprom_write(address, bytes=[])
+        address = pack :uint16, address
+        bytes  = pack :uint8, bytes, min: 1, max: 128
+        write Message.encode command: 7,
+                             value: bytes.length,
+                             aux_message: address + bytes
+      end
+    end
+  end
+end
diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index df99bc38..17587dc6 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -2,15 +2,18 @@ module Dino
   module Board
     class Base
       include API::Core
+      include API::EEPROM
 
-      attr_reader :high, :low, :analog_high, :components, :analog_zero, :dac_zero
+      attr_reader :high, :low, :analog_high, :components
+      attr_reader :analog_zero, :dac_zero, :aux_limit, :eeprom_length
 
       def initialize(io, options={})
         @io, @components = io, []
 
-        ack = io.handshake.split(",").map { |num| num.to_i }
-        @aux_limit, @analog_zero, @dac_zero = ack
-        # Leave room for null termination.
+        ack = io.handshake.split(",").map(&:to_i)
+        @aux_limit, @eeprom_length, @analog_zero, @dac_zero = ack
+
+        # Leave room for null termination of aux messages.
         @aux_limit = @aux_limit - 1
 
         io.add_observer(self)
@@ -38,9 +41,26 @@ def write(msg)
         @io.write(msg)
       end
 
-      def update(pin, msg)
+      def update(line)
+        case line
+        when /\AEE:/
+          update_eeprom(line)
+        else
+          update_component(line)
+        end
+      end
+
+      def update_eeprom(line)
+        message = line.split(":", 2)[1]
+        @components.each do |part|
+          part.update(message) if part.pin == "EE"
+        end
+      end
+
+      def update_component(line)
+        pin, message = line.split(":", 2)
         @components.each do |part|
-          part.update(msg) if pin.to_i == part.pin
+          part.update(message) if pin.to_i == convert_pin(part.pin)
         end
       end
 
diff --git a/lib/dino/components/basic.rb b/lib/dino/components/basic.rb
index 79463819..61544cd0 100644
--- a/lib/dino/components/basic.rb
+++ b/lib/dino/components/basic.rb
@@ -5,6 +5,7 @@ module Basic
       require 'dino/components/basic/analog_input'
       require 'dino/components/basic/digital_input'
       require 'dino/components/basic/analog_output'
+      require 'dino/components/basic/board_eeprom'
     end
   end
-end
\ No newline at end of file
+end
diff --git a/lib/dino/components/basic/board_eeprom.rb b/lib/dino/components/basic/board_eeprom.rb
new file mode 100644
index 00000000..1842e8cc
--- /dev/null
+++ b/lib/dino/components/basic/board_eeprom.rb
@@ -0,0 +1,47 @@
+module Dino
+  module Components
+    module Basic
+      class BoardEEPROM
+        include Setup::Base
+        include Mixins::Reader
+
+        public :state=
+
+        def after_initialize(options)
+          super(options)
+          self.state = Array.new(board.eeprom_length, nil)
+          load
+        end
+
+        def load
+          state.each_slice(128).with_index do |slice, index|
+            read_using -> { board.eeprom_read(index * 128, slice.length) }
+          end
+        end
+
+        def save
+          @state_mutex.synchronize do
+            @state.each_slice(128).with_index do |slice, index|
+              board.eeprom_write(index * 128, slice)
+            end
+          end
+          load
+        end
+
+        def pre_callback_filter(message)
+          address = message.split("-", 2)[0].to_i
+          bytes = message.split("-", 2)[1].split(",").map(&:to_i)
+          {address: address, data: bytes}
+        end
+
+        def update_self(hash)
+          self.state[hash[:address], hash[:data].length] = hash[:data]
+        end
+
+        def pin
+          "EE"
+        end
+      end
+    end
+  end
+end
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index ef332c9e..d387d17d 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -22,7 +22,11 @@ def read(&block)
         end
 
         def block_until_read
-          loop { break if !@callbacks[:read] }
+          loop do
+            break if !@callbacks[:read]
+            # EEPROM read won't work without sleeping here. Not sure why.
+            sleep 0.001
+          end
         end
 
         def _read
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 972d7de0..273bd90f 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -54,10 +54,7 @@ def stop_read
       end
 
       def parse(line)
-        if line.match(/\A\d+:/)
-          pin, message = line.split(":", 2)
-          pin && message && changed && notify_observers(pin, message)
-        end
+        changed && notify_observers(line)
       end
     end
   end
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index 8dc06c35..65dea32c 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -10,7 +10,6 @@ class DinoCLI::Generator
       "lib/Dino.cpp",
       "lib/DinoCoreIO.cpp",
       "lib/DinoIncludes.cpp",
-      "lib/DinoBugWorkaround.cpp",  # See explanation at top of file.
     ]
   },
   servo: {
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index a444c566..3a37933e 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -97,16 +97,15 @@ void Dino::process() {
 
   // Call the command.
   switch(cmd) {
-    // See explanation at top of DinoBugWorkaround.cpp
-    case 999999: bugWorkaround   ();  break;
-
     // Implemented in DinoCoreIO.cpp
     case 0:  setMode             ();    break;
     case 1:  dWrite              ();    break;
     case 2:  dRead               (pin); break;
     case 3:  aWrite              ();    break;
     case 4:  aRead               (pin); break;
-    case 7:  setListener         ();    break;
+    case 5:  setListener         ();    break;
+    case 6:  eepromRead          ();    break;
+    case 7:  eepromWrite         ();    break;
     case 11: pulseRead           ();    break;
 
     // Implemented in DinoServo.cpp
@@ -226,6 +225,8 @@ void Dino::reset() {
   stream->print("ACK:");
   stream->print(AUX_SIZE);
   stream->print(',');
+  stream->print(EEPROM.length());
+  stream->print(',');
   stream->print(A0);
   #if defined(__SAM3X8E__)
     stream->print(',');
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 77944152..d44f7517 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -4,6 +4,7 @@
 #ifndef Dino_h
 #define Dino_h
 #include <Arduino.h>
+#include <EEPROM.h>
 #include "DinoDefines.h"
 
 // Figure out how many pins our hardware has.
@@ -39,12 +40,16 @@ class Dino {
     void aRead                 (int pin);  //cmd = 4
 
     // Core IO Listeners
-    void setListener           ();         //cmd = 7
+    void setListener           ();         //cmd = 5
     void updateListeners       ();
     void updateCoreListeners   (byte tickCount);
     void digitalListenerUpdate (byte index);
     void clearCoreListeners    ();
 
+    // EEPROM Access
+    void eepromRead            ();         //cmd = 6
+    void eepromWrite           ();         //cmd = 7
+
     //
     // Store listeners as a 2 dimensional array where each gets 2 bytes, such that:
     //
@@ -95,10 +100,11 @@ class Dino {
     void clearSpiListeners     ();
 
     // I2C
-    void i2cBegin              (); //cmd = 31
+    void i2cBegin              ();
     void i2cSearch             (); //cmd = 33
     void i2cWrite              (); //cmd = 34
     void i2cRead               (); //cmd = 35
+    void i2cTransfer           (); //cmd = 36
 
     // One Wire
     void owReset               (); //cmd = 41
diff --git a/src/lib/DinoBugWorkaround.cpp b/src/lib/DinoBugWorkaround.cpp
deleted file mode 100644
index cd7dc5e3..00000000
--- a/src/lib/DinoBugWorkaround.cpp
+++ /dev/null
@@ -1,24 +0,0 @@
-//
-// After refactoring there's a strange gcc bug referencing the first
-// instance of sprintf in Dino.cpp, only when compiling for the 328p/Uno/Nano/Mini.
-//
-// It only occurs when trying to exlude all the new .cpp files by commenting
-// out the #define lines at the top of Dino.h. At least one needed to be left in
-// to avoid the error.
-//
-// Narrowed it down to the following:
-// Must declare a function in a separate .cpp file.
-// That function must mutate some instance variable in Dino.
-// That function must be one of the switch options in the Dino::process case statement.
-//
-// This file is a stub to meet those requirements.
-// Leaving this in until sprintf usage is replaced or bug is fixed.
-//
-// Similar issues:
-// https://github.com/arduino/Arduino/issues/3972
-// https://github.com/CongducPham/LowCostLoRaGw/issues/28
-//
-#include "Dino.h"
-void Dino::bugWorkaround() {
-  rval = 0;
-}
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index a9f4bf01..f8d1a9b5 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -73,7 +73,7 @@ void Dino::coreResponse(int p, int v){
   stream->print('\n');
 }
 
-// CMD = 07
+// CMD = 05
 // Set a listener ON or OFF, or change its type, or divider.
 // Takes settings as mask stored in val and applies to existing listener
 // if pin was already used, or first inactive. See Dino.h for mask structure.
@@ -195,3 +195,48 @@ void Dino::pulseRead(){
   }
   if (pulseCount == 0) stream->print('\n');
 }
+
+
+// CMD = 6
+// Read from the microcontroller's EEPROM.
+//
+// pin         = empty
+// val         = number of bytes to read
+// auxMsg[0-1] = start address
+//
+void Dino::eepromRead(){
+  if (val > 0) {
+    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
+
+    // Stream read bytes as if coming from a pin named 'EE'.
+    stream->print("EE");
+    stream->print(':');
+    stream->print(startAddress);
+    stream->print('-');
+
+    for (byte i = 0;  (i < val);  i++) {
+      stream->print(EEPROM.read(startAddress + i));
+      stream->print((i+1 == val) ? '\n' : ',');
+    }
+  }
+}
+
+// CMD = 7
+// Write to the microcontroller's EEPROM.
+//
+// pin         = empty
+// val         = number of bytes to write
+// auxMsg[0-1] = start address
+// auxMsg[2+]  = bytes to write
+//
+void Dino::eepromWrite(){
+  if (val > 0) {
+    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
+
+    for (byte i = 0;  (i < val);  i++) {
+      if(EEPROM.read(startAddress + i) != auxMsg[2+i]) {
+        EEPROM.write(startAddress + i, auxMsg[2+i]);
+      }
+    }
+  }
+}
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 2a2292a4..992fd9a2 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -42,19 +42,19 @@ void Dino::spiEnd(){
   #endif
 }
 
+// CMD = 26
+// Simultaneous read from and write to an SPI device.
 //
 // Request format for SPI 2-way transfers
 // pin         = slave select pin (int)
 // val         = empty
-// auxMsg[0]   = SPI settings. 2 LSB = SPI mode. Bit 7 = MSB(1) / LSB(0).
+// auxMsg[0]   = SPI settings. 2 LSB = SPI mode. Bit 7 = MSB(1) or LSB(0).
 // auxMsg[1]   = write length (number of bytes)
 // auxMsg[2]   = read length  (number of bytes)
 // auxMsg[3-6] = clock frequency (uint32_t as 4 bytes)
 //
-// auxMsg[7]+  = data (bytes) (write only)
+// auxMsg[7+]  = data (bytes) (write only)
 //
-// CMD = 26
-// Write to an SPI device.
 void Dino::spiTransfer(int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate, byte *data) {
   spiBegin(settings, clockRate);
   digitalWrite(selectPin, LOW);
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
index 5511a920..3399fd5e 100644
--- a/test/api/core_test.rb
+++ b/test/api/core_test.rb
@@ -83,10 +83,10 @@ def test_analog_read
 
   def test_set_listener
     mock = MiniTest::Mock.new
-    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b00000011)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b01000011)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b11000011)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 7, pin: 1, value: 0b11000000)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b00000011)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b01000011)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b11000011)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b11000000)])
 
     board.stub(:write, mock) do
       board.set_listener(1, :off)
diff --git a/test/board_test.rb b/test/board_test.rb
index 9bdc917b..4e964cfb 100644
--- a/test/board_test.rb
+++ b/test/board_test.rb
@@ -25,7 +25,7 @@ def test_starts_observing_txrx
   end
 
   def test_calls_handshake_on_txrx
-    mock = MiniTest::Mock.new.expect(:call, "528,14,20")
+    mock = MiniTest::Mock.new.expect(:call, "actual ack value in txrx_mock.rb")
     txrx.stub(:handshake, mock) do
       Dino::Board.new(txrx)
     end
@@ -36,6 +36,10 @@ def test_set_aux_limit
     assert_equal 527, board.aux_limit
   end
 
+  def test_set_eeprom_length
+    assert_equal 1024, board.eeprom_length
+  end
+
   def test_set_dac_and_analog_zero
     assert_equal 20, board.dac_zero
     assert_equal 14, board.analog_zero
@@ -70,13 +74,14 @@ def test_write
   def test_update_passes_messages_to_components
     mock1 = MiniTest::Mock.new.expect(:update, nil, ["data"])
     3.times { mock1.expect(:pin, 1) }
-    mock2 = MiniTest::Mock.new.expect(:update, nil, ["byte"])
+    # This tests that lines are not split after the first colon delimiter.
+    mock2 = MiniTest::Mock.new.expect(:update, nil, ["with:colon"])
     3.times { mock2.expect(:pin, 2) }
     board.add_component(mock1)
     board.add_component(mock2)
-    board.update(1, "data")
-    board.update(2, "byte")
-    board.update(3, "ignore")
+    board.update("1:data")
+    board.update("2:with:colon")
+    board.update("3:ignore")
     mock1.verify
     mock2.verify
   end
diff --git a/test/txrx/serial_test.rb b/test/txrx/serial_test.rb
index 29aace3d..defadb80 100644
--- a/test/txrx/serial_test.rb
+++ b/test/txrx/serial_test.rb
@@ -93,10 +93,9 @@ def test_io_reset
   end
 
   def test_read_and_parse
-    # Should not split on any colon after the first.
     txrx.stub(:read, "02:00:00") do
       txrx.stub(:changed, true) do
-        mock = MiniTest::Mock.new.expect :call, nil, ['02', '00:00']
+        mock = MiniTest::Mock.new.expect :call, nil, ['02:00:00']
         txrx.stub(:notify_observers, mock) do
           txrx.send(:read_and_parse)
         end
diff --git a/test/txrx_mock.rb b/test/txrx_mock.rb
index 80edbd40..65d99435 100644
--- a/test/txrx_mock.rb
+++ b/test/txrx_mock.rb
@@ -5,6 +5,6 @@ def add_observer(board); true; end
   def read; true; end
   def write(str); true; end
   def handshake
-    "528,14,20"
+    "528,1024,14,20"
   end
 end

From 63b302e0a7041500244df8a8c6cf98745ba577aa Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 9 Dec 2018 14:52:38 -0400
Subject: [PATCH 195/296] Callbacks to run local code (on the board) based on
 listeners

---
 lib/dino/api/core.rb       |  10 +-
 lib/dino_cli/packages.rb   |   2 +
 src/dino_ethernet.ino      |  15 ++-
 src/dino_serial.ino        |  23 +++-
 src/dino_wifi.ino          |  16 ++-
 src/lib/Dino.cpp           |  38 +++---
 src/lib/Dino.h             |  93 +++++++------
 src/lib/DinoCoreIO.cpp     | 264 ++++++++++++++++---------------------
 src/lib/DinoEEPROM.cpp     |  48 +++++++
 src/lib/DinoPulseInput.cpp |  57 ++++++++
 test/api/core_test.rb      |   9 +-
 11 files changed, 350 insertions(+), 225 deletions(-)
 create mode 100644 src/lib/DinoEEPROM.cpp
 create mode 100644 src/lib/DinoPulseInput.cpp

diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index 609b9834..c6116f0c 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -50,11 +50,13 @@ def set_listener(pin, state=:off, options={})
           raise "Listener divider must be in #{DIVIDERS.inspect}"
         end
 
-        mask  = Math.log2(divider).to_i
-        mask |= 0b10000000 if (state == :on)
-        mask |= 0b01000000 if (mode == :analog)
+        exponent = Math.log2(divider).to_i
+        aux = pack :uint8, [mode == :analog ? 1 : 0, exponent]
 
-        write Message.encode(command: 5, pin: convert_pin(pin), value: mask)
+        write Message.encode command: 5,
+                             pin: convert_pin(pin),
+                             value: (state == :on ? 1 : 0),
+                             aux_message: aux
       end
 
       # Convenience methods by wrapping set_listener with old defaults.
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index 65dea32c..53b6eac5 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -9,6 +9,8 @@ class DinoCLI::Generator
       "lib/DinoDefines.h",
       "lib/Dino.cpp",
       "lib/DinoCoreIO.cpp",
+      "lib/DinoPulseInput.cpp",
+      "lib/DinoEEPROM.cpp",
       "lib/DinoIncludes.cpp",
     ]
   },
diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index cc762432..c5bff54b 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -33,6 +33,9 @@ void setup() {
   Ethernet.begin(mac, ip);
   server.begin();
   printEthernetStatus();
+
+  dino.digitalListenCallback = onDigitalListen;
+  dino.analogListenCallback = onAnalogListen;
 }
 
 
@@ -41,7 +44,7 @@ void loop() {
   client = server.available();
 
   // Pass the stream to dino so it can read/write.
-  dino.setOutputStream(&client);
+  dino.stream = &client;
 
   // Handle a connection.
   if (client) {
@@ -51,3 +54,13 @@ void loop() {
   // End the connection.
   client.stop();
 }
+
+// This runs every time a digital pin that dino is listening to changes value.
+// p = pin number, v = current value
+void onDigitalListen(byte p, byte v){
+}
+
+// This runs every time an analog pin that dino is listening to gets read.
+// p = pin number, v = read value
+void onAnalogListen(byte p, int v){
+}
diff --git a/src/dino_serial.ino b/src/dino_serial.ino
index 1c890f07..c977d571 100644
--- a/src/dino_serial.ino
+++ b/src/dino_serial.ino
@@ -6,22 +6,35 @@ Dino dino;
 // Defaults to Native USB port on the Due, whatever class "Serial" is on everything else.
 // Classes need to inherit from Stream to be compatible with the Dino library.
 #if defined(__SAM3X8E__)
-#define serial SerialUSB
-//#define serial Serial
+  #define serial SerialUSB
+  //#define serial Serial
 #else
-#define serial Serial
+  #define serial Serial
 #endif
 
-
 void setup() {
   // Wait for serial ready.
   serial.begin(115200);
   while(!serial);
 
   // Pass serial stream to dino so it can read/write.
-  dino.setOutputStream(&serial);
+  dino.stream = &serial;
+
+  // Add listener callbacks for local logic.
+  dino.digitalListenCallback = onDigitalListen;
+  dino.analogListenCallback = onAnalogListen;
 }
 
 void loop() {
   dino.run();
 }
+
+// This runs every time a digital pin that dino is listening to changes value.
+// p = pin number, v = current value
+void onDigitalListen(byte p, byte v){
+}
+
+// This runs every time an analog pin that dino is listening to gets read.
+// p = pin number, v = read value
+void onAnalogListen(byte p, int v){
+}
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 6c6e2e04..646fab5f 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -64,8 +64,10 @@ void setup() {
 
   connect();
   server.begin();
-}
 
+  dino.digitalListenCallback = onDigitalListen;
+  dino.analogListenCallback = onAnalogListen;
+}
 
 void loop() {
   // Reconnect if we've lost WiFi..
@@ -78,7 +80,7 @@ void loop() {
   client = server.available();
 
   // Pass the stream to dino so it can read/write.
-  dino.setOutputStream(&client);
+  dino.stream = &client;
 
   // Handle a connection.
   if (client) {
@@ -88,3 +90,13 @@ void loop() {
   // End the connection.
   client.stop();
 }
+
+// This runs every time a digital pin that dino is listening to changes value.
+// p = pin number, v = current value
+void onDigitalListen(byte p, byte v){
+}
+
+// This runs every time an analog pin that dino is listening to gets read.
+// p = pin number, v = read value
+void onAnalogListen(byte p, int v){
+}
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 3a37933e..35e15b94 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -90,23 +90,26 @@ void Dino::process() {
   val = atoi((char *)valStr);
 
   #ifdef debug
-   Serial.print("Received - Command: "); Serial.print(cmdStr);
-   Serial.print(" Pin: ");               Serial.print(pinStr);
-   Serial.print(" Value: ");             Serial.print(valStr); Serial.print("\n")
+    if (cmd != 90) {
+      Serial.print("cmd:");   Serial.print(cmd);
+      Serial.print(", pin:"); Serial.print(pin);
+      Serial.print(", val:"); Serial.println(val);
+    }
   #endif
 
   // Call the command.
   switch(cmd) {
     // Implemented in DinoCoreIO.cpp
-    case 0:  setMode             ();    break;
-    case 1:  dWrite              ();    break;
-    case 2:  dRead               (pin); break;
-    case 3:  aWrite              ();    break;
-    case 4:  aRead               (pin); break;
-    case 5:  setListener         ();    break;
+    case 0:  setMode             (pin, val);        break;
+    case 1:  dWrite              (pin, val, false); break;
+    case 2:  dRead               (pin);             break;
+    case 3:  aWrite              (pin, val, false); break;
+    case 4:  aRead               (pin);             break;
+    case 5:  setListener         (pin, val, auxMsg[0], auxMsg[1], false); break;
+
+    // Implemented in DinoEEPROM.cpp
     case 6:  eepromRead          ();    break;
     case 7:  eepromWrite         ();    break;
-    case 11: pulseRead           ();    break;
 
     // Implemented in DinoServo.cpp
     #ifdef DINO_SERVO
@@ -119,6 +122,9 @@ void Dino::process() {
     case 10: handleLCD           ();    break;
     #endif
 
+    // Implemented in DinoPulseInput.cpp
+    case 11: pulseRead           ();    break;
+
     // Implemented in DinoSerial.cpp
     #ifdef DINO_SERIAL
     case 12: handleSerial        ();    break;
@@ -174,17 +180,6 @@ void Dino::process() {
     // Should send a "feature not implemented" message as default.
     default:                          break;
   }
-
-  #ifdef debug
-   Serial.print("Responded with - "); Serial.print(response); Serial.print("\n\n");
-  #endif
-}
-
-
-// Expect the sketch to pass a pointer to something that inherits from Stream.
-// Store it and call ->print, ->write, etc on it to send data.
-void Dino::setOutputStream(Stream* callback){
-  stream = callback;
 }
 
 //
@@ -238,7 +233,6 @@ void Dino::reset() {
 
 void Dino::resetState() {
   clearCoreListeners();
-  lastActiveListener = 0;
   #ifdef DINO_SPI
     clearSpiListeners();
   #endif
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index d44f7517..6fcc4016 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -19,45 +19,54 @@
 class Dino {
   public:
     Dino();
-    void setOutputStream(Stream* callback);
     void run();
 
-  private:
-    // Main loop functions.
-    void acknowledge();
-    void parse(byte c);
-    void process();
+    // Expect main sketch to pass a reference to a Stream-like object for IO.
+    // Store it and call ->print, ->write, ->available, ->read etc. on it.
+    Stream* stream;
 
-    // See explanation at top of DinoBugWorkaround.cpp
-    void bugWorkaround();
+    // Callback hooks for local logic (defined in main sketch) based on listeners.
+    // These should be used if:
+    //   1) a round-trip to the remote client is too slow, or
+    //   2) something needs to happen regardless of remote client connection.
+    // Eg. Instant feedback from a smart light switch.
+    void (*digitalListenCallback)(byte p, byte v);
+    void (*analogListenCallback)(byte p, int v);
 
+    // Core IO API Functions
     // Functions with a cmd value can be called through the remote API.
-    // Core IO Functions
-    void setMode               ();         //cmd = 0
-    void dWrite                ();         //cmd = 1
-    void dRead                 (int pin);  //cmd = 2
-    void aWrite                ();         //cmd = 3
-    void aRead                 (int pin);  //cmd = 4
-
-    // Core IO Listeners
-    void setListener           ();         //cmd = 5
+    //
+    // This subset is made public to allow use by local listener callbacks.
+    // Reading and writing through the dino library can help maintain
+    // consistency and notify the remote client of local actions automatically.
+    //
+    void setMode     (byte p, byte m);                     //cmd = 0
+    void dWrite      (byte p, byte v, boolean echo=true);  //cmd = 1
+    byte dRead       (byte p);                             //cmd = 2
+    void aWrite      (byte p, int v,  boolean echo=true);  //cmd = 3
+    int  aRead       (byte p);                             //cmd = 4
+    void setListener (byte p, boolean enabled, byte analog, byte exponent, boolean local=true); //cmd = 5
+
+  private:
+    //
+    // Main loop listen functions.
+    //
     void updateListeners       ();
     void updateCoreListeners   (byte tickCount);
+    void analogListenerUpdate  (byte index);
     void digitalListenerUpdate (byte index);
     void clearCoreListeners    ();
-
-    // EEPROM Access
-    void eepromRead            ();         //cmd = 6
-    void eepromWrite           ();         //cmd = 7
+    void findLastActiveListener();
 
     //
-    // Store listeners as a 2 dimensional array where each gets 2 bytes, such that:
+    // Store listeners as a 2 dimensional array where each gets 2 bytes:
     //
-    // byte 0, bit 7   : 1 for listener enabled, 0 for listener disabled.
-    // byte 0, bit 6   : 1 for analog listener, 0 for digital listener.
-    // byte 0, bit 5   : storage for digital listener state
-    // byte 0, bits 4-3: unused
-    // byte 0, bits 2-0: timing divider exponent specific to this pin, 2^0 through 2^8
+    // byte 0, bit 7   : 1 = enabled, 0  = disabled
+    // byte 0, bit 6   : 1 = analog, 0 = digital
+    // byte 0, bit 5   : digital listener state storage
+    // byte 0, bit 4   : local flag (remote client cannot modify listener if set)
+    // byte 0, bit 3   : unused
+    // byte 0, bits 2-0: timing divider exponent (2^0 through 2^8)
     //
     // byte 1          : pin number
     //
@@ -68,10 +77,14 @@ class Dino {
     // Map 2's exponents for dividers to save time.
     const byte dividerMap[8] = {1, 2, 4, 8, 16, 32, 64, 128};
 
-    // Storage and response func for features following the pin:rval pattern.
-    int rval;
+    // Response func for features following the pin:value pattern.
     void coreResponse(int p, int v);
 
+    // Functions with a cmd value can be called through the remote API.
+    // EEPROM Access
+    void eepromRead            ();         //cmd = 6
+    void eepromWrite           ();         //cmd = 7
+
     // Included Libraries
     void servoToggle           ();         //cmd = 8
     void servoWrite            ();         //cmd = 9
@@ -114,11 +127,23 @@ class Dino {
     void owWriteBit            (byte b);
     byte owReadBit             ();
 
-    // API access to timings, resolutions and reset.
+    //
+    // Board level timings, resolutions and reset.
+    //
     void reset                 ();  //cmd = 90
     void resetState            ();
     void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
+    unsigned long lastTick;
+    byte tickCount;
+    byte registerDivider;
+
+    //
+    // Main loop input functions.
+    //
+    void acknowledge();
+    void parse(byte c);
+    void process();
 
     // Parser state storage and utility functions.
     byte *messageFragments[4];
@@ -144,14 +169,6 @@ class Dino {
     #endif
     byte auxMsg[AUX_SIZE];
 
-    // Save a pointer to any stream so we can call ->print and ->write on it.
-    Stream* stream;
-
-    // Internal timing variables and utility functions.
-    unsigned long lastTick;
-    byte tickCount;
-    byte registerDivider;
-
     // Keep count of bytes as we receive them and send a dino message with how many.
     uint8_t rcvBytes  = 0;
     uint8_t rcvThreshold = 64;
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index f8d1a9b5..1b302f3b 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -2,70 +2,86 @@
 
 // CMD = 00
 // Set a pin to output (0), or input (1).
-void Dino::setMode() {
-  if (val == 0) {
-    pinMode(pin, OUTPUT);
+void Dino::setMode(byte p, byte m) {
+  #ifdef debug
+    Serial.print("setmode, pin:");
+    Serial.print(p);
+    Serial.print(", mode:");
+    Serial.println(m);
+  #endif
+
+  if (m == 0) {
+    pinMode(p, OUTPUT);
   }
   else {
-    pinMode(pin, INPUT);
+    pinMode(p, INPUT);
   }
-
-  #ifdef debug
-    Serial.print("Called Dino::setMode()\n");
-  #endif
 }
 
 // CMD = 01
 // Write a digital output pin. 0 for LOW, 1 or >0 for HIGH.
-void Dino::dWrite() {
-  if (val == 0) {
-    digitalWrite(pin, LOW);
+void Dino::dWrite(byte p, byte v, boolean echo) {
+  #ifdef debug
+    Serial.print("dwrite, pin:");
+    Serial.print(p);
+    Serial.print(", value:");
+    Serial.print(v);
+    Serial.print(", echo:");
+    Serial.println(echo);
+  #endif
+
+  if (v == 0) {
+    digitalWrite(p, LOW);
   }
   else {
-    digitalWrite(pin, HIGH);
+    digitalWrite(p, HIGH);
   }
-
-  #ifdef debug
-    Serial.print("Called Dino::dWrite()\n");
-  #endif
+  if (echo) coreResponse(p, v);
 }
 
 // CMD = 02
 // Read a digital input pin. 0 for LOW, 1 for HIGH.
-void Dino::dRead(int pin) {
-  rval = digitalRead(pin);
-  coreResponse(pin, rval);
-
+byte Dino::dRead(byte p) {
   #ifdef debug
-    Serial.print("Called Dino::dRead()\n");
+    Serial.print("dread, pin:");
+    Serial.println(p);
   #endif
+
+  byte rval = digitalRead(p);
+  coreResponse(p, rval);
+  return rval;
 }
 
 // CMD = 03
 // Write an analog output pin. 0 for LOW, up to 255 for HIGH @ 8-bit resolution.
-void Dino::aWrite() {
-  analogWrite(pin,val);
-
+void Dino::aWrite(byte p, int v, boolean echo) {
   #ifdef debug
-    Serial.print("Called Dino::aWrite()\n");
+    Serial.print("awrite, pin:");
+    Serial.print(p);
+    Serial.print(", value:");
+    Serial.print(v);
+    Serial.print(", echo:");
+    Serial.println(echo);
   #endif
+
+  analogWrite(p,v);
+  if (echo) coreResponse(p, v);
 }
 
 // CMD = 04
 // Read an analog input pin. 0 for LOW, up to 1023 for HIGH @ 10-bit resolution.
-void Dino::aRead(int pin) {
-  rval = analogRead(pin);
-  coreResponse(pin, rval);
-
+int Dino::aRead(byte p) {
   #ifdef debug
-    Serial.print("Called Dino::aRead()\n");
+    Serial.print("aread, pin:");
+    Serial.println(p);
   #endif
-}
 
+  int rval = analogRead(p);
+  coreResponse(p, rval);
+  return rval;
+}
 
-// Send current value of pin and reading value (rval), following the protocol.
-// This is for core reads and listeners, but can be used for any function
-// following the pin:rval pattern. Set those variables correctly before calling.
+// Simple response for core listeners, or any response with the pin:value pattern.
 void Dino::coreResponse(int p, int v){
   stream->print(p);
   stream->print(':');
@@ -74,39 +90,62 @@ void Dino::coreResponse(int p, int v){
 }
 
 // CMD = 05
-// Set a listener ON or OFF, or change its type, or divider.
-// Takes settings as mask stored in val and applies to existing listener
-// if pin was already used, or first inactive. See Dino.h for mask structure.
-void Dino::setListener(){
+// Enable, disable and change settings for core (digital/analog) listeners.
+// See Dino.h for settings and mask layout.
+void Dino::setListener(byte p, boolean enabled, byte analog, byte exponent, boolean local){
+  // Pre-format the settings into a mask byte.
+  byte settingMask = 0;
+  if (enabled)  settingMask = settingMask | B10000000;
+  if (analog)   settingMask = settingMask | B01000000;
+  if (local)    settingMask = settingMask | B00010000;
+  settingMask = settingMask | dividerMap[exponent];
+
+  #ifdef debug
+    Serial.print("setlistener, pin:");
+    Serial.print(p);
+    Serial.print(", enabled:");
+    Serial.print(enabled);
+    Serial.print(", analog:");
+    Serial.print(analog);
+    Serial.print(", exponent:");
+    Serial.print(exponent);
+    Serial.print(", local:");
+    Serial.print(local);
+    Serial.print(", settingMask:");
+    Serial.println(settingMask);
+  #endif
+
+  // If an existing listener was already using this pin, just update settings.
   boolean found = false;
-  // Check if previously assigned a listener to this pin and re-use.
   for(byte i=0; i<PIN_COUNT; i++){
-    if (listeners[i][1] == pin){
-      listeners[i][0] = val;
+    if (listeners[i][1] == p){
       found = true;
+      if (bitRead(listeners[i][0], 4) == 0) {
+        listeners[i][0] = settingMask;
+      } else if(local) {
+        // Only allow local code to update local listeners.
+        listeners[i][0] = settingMask;
+      }
       break;
     }
   }
 
-  // If this pin wasn't used before, take the fist inactive one.
+  // If this pin wasn't used before, take the lowest index inactive listener.
   if (!found){
     for(byte i=0; i<PIN_COUNT; i++){
       if (bitRead(listeners[i][0], 7) == 0){
-        listeners[i][0] = val;
-        listeners[i][1] = pin;
+        listeners[i][0] = settingMask;
+        listeners[i][1] = p;
         break;
       }
     }
   }
 
-  // Update the last active listener whenever we make a change.
-  for(byte i=0; i<PIN_COUNT; i++){
-    if (bitRead(listeners[i][0], 7) == 1){
-      lastActiveListener = i;
-    }
-  }
+  // Keep track of how far into the listener array to go when updating.
+  findLastActiveListener();
 }
 
+// Runs once on every loop to update necessary listeners.
 void Dino::updateCoreListeners(byte tickCount){
   for (byte i = 0; i <= lastActiveListener; i++){
     // Check if active.
@@ -117,7 +156,7 @@ void Dino::updateCoreListeners(byte tickCount){
       if(tickCount % divider == 0){
         // Check if digital or analog.
         if (bitRead(listeners[i][0], 6) == 1){
-          aRead(listeners[i][1]);
+          analogListenerUpdate(i);
         } else {
           digitalListenerUpdate(i);
         }
@@ -126,117 +165,44 @@ void Dino::updateCoreListeners(byte tickCount){
   }
 }
 
+// Handle a single analog listener when it needs to read.
+void Dino::analogListenerUpdate(byte i){
+  int rval = analogRead(listeners[i][1]);
+  analogListenCallback(listeners[i][1], rval);
+  coreResponse(listeners[i][1], rval);
+}
+
+// Handle a single digital listener when it needs to read.
 void Dino::digitalListenerUpdate(byte i){
-  rval = digitalRead(listeners[i][1]);
-  // Previous state is stored in the 5th bit of the first byte.
-  // If changed, update it and send the message.
+  byte rval = digitalRead(listeners[i][1]);
+
   if (rval != bitRead(listeners[i][0], 5)){
+    // State for digital listeners is stored in byte 5 of the listener itself.
     bitWrite(listeners[i][0], 5, rval);
+    digitalListenCallback(listeners[i][1], rval);
     coreResponse(listeners[i][1], rval);
   }
 }
 
-// Gets called by Dino::reset to clear all core listeners.
+// Gets called by Dino::reset to clear all listeners set by the remote client.
 void Dino::clearCoreListeners(){
   for (int i = 0; i < PIN_COUNT; i++){
-    listeners[i][0] = 0;
-    listeners[i][1] = 0;
-  }
-}
-
-//
-// Rapidly polls a digital input looking for rising or falling edges,
-// recording the time in microseconds between consecutive edges.
-// There is an optional reset at the beginning if the pin must be held opposite
-// to its idle state to trigger a reading.
-//
-// Max 65535 microseconds reset time.
-// Max 255 microseconds per pulse (between 2 consecutive edges).
-// Max 255 pulses counted.
-//
-// val bit 0   : whether to reset the line first or not (0 = no, 1 = yes)
-// val bit 1   : direction to pull the line (0 = low, 1 = high)
-// auxMsg[0-1] : unsigned 16-bit reset duration
-// auxMsg[2-3] : unsigned 16-bit pulse read timeout (in milliseconds)
-// auxMsg[4]   : unsigned 8-bit pulse count limit
-// auxMsg[8] + : reserved as output buffer, will be overwritten
-//
-void Dino::pulseRead(){
-  // Reset
-  if (bitRead(val, 0)) {
-    uint16_t resetTime = (auxMsg[1] << 8) | auxMsg[0];
-    pinMode(pin, OUTPUT);
-    digitalWrite(pin, bitRead(val, 1));
-    delayMicroseconds(resetTime);
-  }
-  pinMode(pin, INPUT);
-  byte state = digitalRead(pin);
-
-  uint16_t timeout = (auxMsg[3] << 8) | auxMsg[2];
-  byte pulseCount = 0;
-
-  uint32_t start = millis();
-  uint32_t lastWrite = micros();
-
-  while ((millis() - start < timeout) && (pulseCount < auxMsg[4])) {
-    if (digitalRead(pin) != state){
-      uint32_t now = micros();
-      pulseCount++;
-      auxMsg[pulseCount+8] = now - lastWrite;
-      lastWrite = now;
-      state = state ^ 1;
+    // Only clear listeners if they were started by the remote client.
+    // Leaves listeners started by local code running.
+    if (bitRead(listeners[i][0], 4) == 0) {
+      listeners[i][0] = 0;
+      listeners[i][1] = 0;
     }
   }
-
-  stream->print(pin); stream->print(':');
-  for (byte i=1; i<=pulseCount; i++){
-    stream->print(auxMsg[i+8]);
-    stream->print((i == pulseCount) ? '\n' : ',');
-  }
-  if (pulseCount == 0) stream->print('\n');
+  findLastActiveListener();
 }
 
-
-// CMD = 6
-// Read from the microcontroller's EEPROM.
-//
-// pin         = empty
-// val         = number of bytes to read
-// auxMsg[0-1] = start address
-//
-void Dino::eepromRead(){
-  if (val > 0) {
-    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
-
-    // Stream read bytes as if coming from a pin named 'EE'.
-    stream->print("EE");
-    stream->print(':');
-    stream->print(startAddress);
-    stream->print('-');
-
-    for (byte i = 0;  (i < val);  i++) {
-      stream->print(EEPROM.read(startAddress + i));
-      stream->print((i+1 == val) ? '\n' : ',');
-    }
-  }
-}
-
-// CMD = 7
-// Write to the microcontroller's EEPROM.
-//
-// pin         = empty
-// val         = number of bytes to write
-// auxMsg[0-1] = start address
-// auxMsg[2+]  = bytes to write
-//
-void Dino::eepromWrite(){
-  if (val > 0) {
-    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
-
-    for (byte i = 0;  (i < val);  i++) {
-      if(EEPROM.read(startAddress + i) != auxMsg[2+i]) {
-        EEPROM.write(startAddress + i, auxMsg[2+i]);
-      }
+// Track the last active listener whenever changes are made.
+// Call this after setting or clearing any listeners.
+void Dino::findLastActiveListener(){
+  for(byte i=0; i<PIN_COUNT; i++){
+    if (bitRead(listeners[i][0], 7) == 1){
+      lastActiveListener = i;
     }
   }
 }
diff --git a/src/lib/DinoEEPROM.cpp b/src/lib/DinoEEPROM.cpp
new file mode 100644
index 00000000..63308c6b
--- /dev/null
+++ b/src/lib/DinoEEPROM.cpp
@@ -0,0 +1,48 @@
+//
+// Basic EEPROM read and write functionality.
+//
+#include "Dino.h"
+
+// CMD = 6
+// Read from the microcontroller's EEPROM.
+//
+// pin         = empty
+// val         = number of bytes to read
+// auxMsg[0-1] = start address
+//
+void Dino::eepromRead(){
+  if (val > 0) {
+    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
+
+    // Stream read bytes as if coming from a pin named 'EE'.
+    stream->print("EE");
+    stream->print(':');
+    stream->print(startAddress);
+    stream->print('-');
+
+    for (byte i = 0;  (i < val);  i++) {
+      stream->print(EEPROM.read(startAddress + i));
+      stream->print((i+1 == val) ? '\n' : ',');
+    }
+  }
+}
+
+// CMD = 7
+// Write to the microcontroller's EEPROM.
+//
+// pin         = empty
+// val         = number of bytes to write
+// auxMsg[0-1] = start address
+// auxMsg[2+]  = bytes to write
+//
+void Dino::eepromWrite(){
+  if (val > 0) {
+    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
+
+    for (byte i = 0;  (i < val);  i++) {
+      if(EEPROM.read(startAddress + i) != auxMsg[2+i]) {
+        EEPROM.write(startAddress + i, auxMsg[2+i]);
+      }
+    }
+  }
+}
diff --git a/src/lib/DinoPulseInput.cpp b/src/lib/DinoPulseInput.cpp
new file mode 100644
index 00000000..79d86c39
--- /dev/null
+++ b/src/lib/DinoPulseInput.cpp
@@ -0,0 +1,57 @@
+//
+// Read chains of input pulses. Only used for DHT sensors right now.
+//
+#include "Dino.h"
+
+// CMD = 11
+//
+// Rapidly polls a digital input looking for rising or falling edges,
+// recording the time in microseconds between consecutive edges.
+// There is an optional reset at the beginning if the pin must be held opposite
+// to its idle state to trigger a reading.
+//
+// Max 65535 microseconds reset time.
+// Max 255 microseconds per pulse (between 2 consecutive edges).
+// Max 255 pulses counted.
+//
+// val bit 0   : whether to reset the line first or not (0 = no, 1 = yes)
+// val bit 1   : direction to pull the line (0 = low, 1 = high)
+// auxMsg[0-1] : unsigned 16-bit reset duration
+// auxMsg[2-3] : unsigned 16-bit pulse read timeout (in milliseconds)
+// auxMsg[4]   : unsigned 8-bit pulse count limit
+// auxMsg[8+]  : reserved as output buffer, will be overwritten
+//
+void Dino::pulseRead(){
+  // Reset
+  if (bitRead(val, 0)) {
+    uint16_t resetTime = (auxMsg[1] << 8) | auxMsg[0];
+    pinMode(pin, OUTPUT);
+    digitalWrite(pin, bitRead(val, 1));
+    delayMicroseconds(resetTime);
+  }
+  pinMode(pin, INPUT);
+  byte state = digitalRead(pin);
+
+  uint16_t timeout = (auxMsg[3] << 8) | auxMsg[2];
+  byte pulseCount = 0;
+
+  uint32_t start = millis();
+  uint32_t lastWrite = micros();
+
+  while ((millis() - start < timeout) && (pulseCount < auxMsg[4])) {
+    if (digitalRead(pin) != state){
+      uint32_t now = micros();
+      pulseCount++;
+      auxMsg[pulseCount+8] = now - lastWrite;
+      lastWrite = now;
+      state = state ^ 1;
+    }
+  }
+
+  stream->print(pin); stream->print(':');
+  for (byte i=1; i<=pulseCount; i++){
+    stream->print(auxMsg[i+8]);
+    stream->print((i == pulseCount) ? '\n' : ',');
+  }
+  if (pulseCount == 0) stream->print('\n');
+}
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
index 3399fd5e..dc24b8ce 100644
--- a/test/api/core_test.rb
+++ b/test/api/core_test.rb
@@ -83,10 +83,11 @@ def test_analog_read
 
   def test_set_listener
     mock = MiniTest::Mock.new
-    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b00000011)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b01000011)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b11000011)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0b11000000)])
+
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0, aux_message: "\x00\x03")])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0, aux_message: "\x01\x03")])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 1, aux_message: "\x01\x03")])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 1, aux_message: "\x01\x00")])
 
     board.stub(:write, mock) do
       board.set_listener(1, :off)

From 429d3a238008d5fa935cd8c9149a2949e6aabc25 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 10 Dec 2018 12:53:15 -0400
Subject: [PATCH 196/296] Add ESP8266 over the air update. Standardize CLI
 option format.

---
 lib/dino_cli/parser.rb   | 16 ++++++-------
 lib/dino_cli/targets.txt | 52 ++++++++++++++++++++++++----------------
 src/dino_wifi.ino        | 42 +++++++++++++++++++-------------
 3 files changed, 65 insertions(+), 45 deletions(-)

diff --git a/lib/dino_cli/parser.rb b/lib/dino_cli/parser.rb
index a2c578f4..31c5bf05 100644
--- a/lib/dino_cli/parser.rb
+++ b/lib/dino_cli/parser.rb
@@ -34,21 +34,21 @@ def parse
           args.shift; set_sketch("ethernet")
         when 'wifi'
           args.shift; set_sketch("wifi")
-        when '-baud'
+        when '--baud'
           args.shift; @options[:baud] = args.shift
-        when '-target'
+        when '--target'
           args.shift; set_target(args.shift)
-        when '-mac'
+        when '--mac'
           args.shift; @options[:mac] = args.shift
-        when '-ip'
+        when '--ip'
           args.shift; @options[:ip] = args.shift
-        when '-ssid'
+        when '--ssid'
           args.shift; @options[:ssid] = args.shift
-        when '-password'
+        when '--password'
           args.shift; @options[:password] = args.shift
-        when '-port'
+        when '--port'
           args.shift; @options[:port] = args.shift
-        when '-debug'
+        when '--debug'
           args.shift; @options[:debug] = true
         when /^-/
           error "Invalid argument '#{args[0]}'"
diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
index 49087ca7..394d12e1 100644
--- a/lib/dino_cli/targets.txt
+++ b/lib/dino_cli/targets.txt
@@ -3,8 +3,8 @@
 
     mega (default)
 
-      Covers the popular Atmel chips on Arduino boards listed below, and many more.
-      This is the primary target and all features will be included. Default setting.
+      Covers popular Atmel chips and associated Arduino boards. This is the
+      primary target and default setting. All component features are included.
 
       Chips:  ATmega328p, ATmega32u4, ATmega1280, ATmega2560
       Boards: UNO, Nano, Mini, Ethernet
@@ -12,22 +12,35 @@
               Mega 1280, Mega 2560, Mega ADK
               Most Lilypads (excluding ones with an ATmega168)
 
+    esp8266
+
+      Based on the ESP8266 chip by Espressif with integrated 2.4Ghz WiFi.
+      This option includes all component features EXCEPT:
+          Serial, LCD
+
+      Chips:  ES8266, ESP8285
+      Boards: WeMos D1, Node MCU, Generic ESP8266 Modules
+
+      Note: Building the (default) serial sketch will only allow connections via
+            serial. Build the WiFi sketch to connect via the integrated WiFi.
+
+      Note: After the initial upload via serial, the WiFi sketch for this target
+            supports over-the-air updates from the Arduino IDE using ArduinoOTA.
+
     core
 
-      This includes only the core feature set of dino:
+      This includes only the core component feature set of dino:
         Set Pin Mode
         Digital Read/Write/Listen
         Analog Read/Write/Listen
 
-      This is useful if you're getting errors when trying to upload, want to
-      include specific features by hand, trying to squeeze onto something with
-      low memory, or testing a new chip. This is the smallest the dino sketch
-      can get for now, and should be universally compatible.
+      This is mostly useful for testing, or if severely limited on memory, as it
+      is the smallest sketch possible and should be universally compatible.
 
     mega168
 
       This specifically targets the older ATmega168 chip used in early Arduinos.
-      They have half the RAM and flash available, so we need to cut the sketch down.
+      With half the RAM and flash available, we need to cut the sketch down.
       This option includes core functionality AND:
           Servo (6 maxmium), DHT, OneWire, IR Out, Tone, SPI, I2C
 
@@ -35,25 +48,22 @@
       Boards: Duemilanove, Diecimila, Pro, Pro Mini
               (Later versions of these may carry an ATmega328)
 
-      Note: While you can generate this sketch using any communication type,
-      it will only fit on the ATmega168 when generated for serial communication.
-      There is not enough memory available for Wi-Fi or Ethernet. You can
-      try the core target to tradeoff features for networking instead.
-
-      You can also try to create a serial over Wi-Fi bridge with:
-      https://github.com/jeelabs/esp-link, if you have an ESP8266 handy.
+      Note: While you can generate this sketch using any connection type,
+            only the serial version actually fits on the ATmega168.
+            There is not enough memory available for Wi-Fi or Ethernet.
+            Try the core target instead to tradeoff features for networking.
 
       Note: Aux message is always limited to 264 bytes or less for the ATmega168.
             Servo count is always limited to 6 (normally 12) for the ATmega168 chip.
-            These limits apply regardless of using this build target, as long as
-            a board with that chip is selected in the IDE.
+            These limits apply as long as an Atmega168 is selected in the
+            Arduino IDE, regardless of the options passed to this sketch generator.
 
     arm
 
       This is the same as mega, but omits libraries specifically known to be
       incompatible with the Atmel SAMD (ARM Cortex M0) chips. Use this when
       you need to load a sketch on the Arduino Due or similar boards.
-      This option includes all features EXCEPT:
+      This option includes all component features EXCEPT:
           Serial, Tone, IR Out, I2C
 
       Chips:  AT91SAM3X8E
@@ -61,6 +71,6 @@
 
   NOTE: While different targets include different libraries, you can manually
   control which libraries are included at compile time by editing DinoDefines.h.
-  All the library files (even the unused ones) are copied to the destination sketch
-  folder to enable this. Uncomment a corresponding #define in DinoDefines.h to
-  include everything needed for that library. Comment it out to exclude the library.
+  To enable this, libraries unused by the sketch are copied to the sketch output
+  folder anyway, provided they are not incompatible with the target architecture.
+  Uncomment or comment #define lines in DinoDefines.h as needed.
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 646fab5f..25d79b05 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -1,6 +1,9 @@
 #include "Dino.h"
 #ifdef ESP8266
   #include <ESP8266WiFi.h>
+  #include <ESP8266mDNS.h>
+  #include <WiFiUdp.h>
+  #include <ArduinoOTA.h>
   #define LED_PIN 2
 #else
   #include <SPI.h>
@@ -17,7 +20,6 @@ Dino dino;
 WiFiServer server(port);
 WiFiClient client;
 
-
 // Use the built in LED to indicate WiFi status.
 void indicate(byte value) {
  #ifdef ESP8266
@@ -27,7 +29,6 @@ void indicate(byte value) {
  #endif
 }
 
-
 void printWifiStatus() {
   Serial.println("Connected");
   Serial.print("SSID: ");
@@ -42,10 +43,13 @@ void printWifiStatus() {
   indicate(true);
 }
 
-
 void connect(){
+  Serial.println();
   Serial.print("Attempting to connect to SSID: ");
-  Serial.print(ssid);
+  Serial.println(ssid);
+  #ifdef ESP8266
+    WiFi.mode(WIFI_STA);
+  #endif
   WiFi.begin(ssid, pass);
   while (WiFi.status() != WL_CONNECTED) {
     delay(500);
@@ -54,7 +58,6 @@ void connect(){
   printWifiStatus();
 }
 
-
 void setup() {
   pinMode(LED_PIN, OUTPUT);
 
@@ -65,30 +68,37 @@ void setup() {
   connect();
   server.begin();
 
+  #ifdef ESP8266
+    ArduinoOTA.begin();
+  #endif
+
   dino.digitalListenCallback = onDigitalListen;
   dino.analogListenCallback = onAnalogListen;
 }
 
 void loop() {
-  // Reconnect if we've lost WiFi..
+  // Reconnect if we've lost WiFi.
   if (WiFi.status() != WL_CONNECTED){
     indicate(false);
     connect();
   }
 
-  // Listen for connections.
-  client = server.available();
+  // Handle one client at a time.
+  if (!client){
+    client = server.available();
+    if (client) dino.stream = &client;
+  }
 
-  // Pass the stream to dino so it can read/write.
-  dino.stream = &client;
+  // Run dino.
+  if (client) dino.run();
 
-  // Handle a connection.
-  if (client) {
-    while (client.connected()) dino.run();
-  }
+  // End the connection when client disconnects.
+  if (client && !client.connected()) client.stop();
 
-  // End the connection.
-  client.stop();
+  // Handle OTA updates.
+  #ifdef ESP8266
+    ArduinoOTA.handle();
+  #endif
 }
 
 // This runs every time a digital pin that dino is listening to changes value.

From 8ad047f7d46a6f58763d8408f0987a89892adacf Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 13 Dec 2018 20:54:07 -0400
Subject: [PATCH 197/296] TCP sketches fallback to serial so listeners work
 when no TCP connection. Enable EEPROM on ESP8266.

---
 src/dino_ethernet.ino | 43 ++++++++++++++---------
 src/dino_wifi.ino     | 81 ++++++++++++++++++++++++++++---------------
 2 files changed, 81 insertions(+), 43 deletions(-)

diff --git a/src/dino_ethernet.ino b/src/dino_ethernet.ino
index c5bff54b..28e37c9c 100644
--- a/src/dino_ethernet.ino
+++ b/src/dino_ethernet.ino
@@ -2,6 +2,16 @@
 #include <SPI.h>
 #include <Ethernet.h>
 
+// Define 'serial' as the serial interface we want to use.
+// Defaults to Native USB port on the Due, whatever class "Serial" is on everything else.
+// Classes need to inherit from Stream to be compatible with the Dino library.
+#if defined(__SAM3X8E__)
+  #define serial SerialUSB
+  //#define serial Serial
+#else
+  #define serial Serial
+#endif
+
 // Configure your MAC address, IP address, and HTTP port here.
 byte mac[] = { 0xDE, 0xAD, 0xBE, 0x30, 0x31, 0x32 };
 IPAddress ip(192,168,0,77);
@@ -11,7 +21,6 @@ Dino dino;
 EthernetServer server(port);
 EthernetClient client;
 
-
 void printEthernetStatus() {
   Serial.print("IP Address: ");
   Serial.println(Ethernet.localIP());
@@ -19,10 +28,9 @@ void printEthernetStatus() {
   Serial.println(port);
 }
 
-
 void setup() {
-  // Start serial for debugging.
-  Serial.begin(115200);
+  // Wait for serial ready.
+  serial.begin(115200);
   while(!serial);
 
   // Explicitly disable the SD card.
@@ -32,27 +40,30 @@ void setup() {
   // Start up the network connection and server.
   Ethernet.begin(mac, ip);
   server.begin();
-  printEthernetStatus();
+  #ifdef debug
+    printEthernetStatus();
+  #endif
 
+  // Add listener callbacks for local logic.
   dino.digitalListenCallback = onDigitalListen;
   dino.analogListenCallback = onAnalogListen;
 }
 
-
 void loop() {
-  // Listen for connections.
-  client = server.available();
+  // Allow one client at a time to be connected. Set it as the dino IO stream.
+  if (!client){
+    client = server.available();
+    if (client) dino.stream = &client;
+  }
 
-  // Pass the stream to dino so it can read/write.
-  dino.stream = &client;
+  // Main loop of the dino library.
+  dino.run();
 
-  // Handle a connection.
-  if (client) {
-    while (client.connected()) dino.run();
+  // End the connection when client disconnects and revert to serial IO.
+  if (client && !client.connected()){
+    client.stop();
+    dino.stream = &serial;
   }
-
-  // End the connection.
-  client.stop();
 }
 
 // This runs every time a digital pin that dino is listening to changes value.
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 25d79b05..599c3908 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -4,6 +4,7 @@
   #include <ESP8266mDNS.h>
   #include <WiFiUdp.h>
   #include <ArduinoOTA.h>
+  #include <EEPROM.h>
   #define LED_PIN 2
 #else
   #include <SPI.h>
@@ -11,6 +12,16 @@
   #define LED_PIN 13
 #endif
 
+// Define 'serial' as the serial interface we want to use.
+// Defaults to Native USB port on the Due, whatever class "Serial" is on everything else.
+// Classes need to inherit from Stream to be compatible with the Dino library.
+#if defined(__SAM3X8E__)
+  #define serial SerialUSB
+  //#define serial Serial
+#else
+  #define serial Serial
+#endif
+
 // Configure your WiFi options here. IP address is not configurable. Uses DHCP.
 int port = 3466;
 char* ssid = "yourNetwork";
@@ -22,11 +33,12 @@ WiFiClient client;
 
 // Use the built in LED to indicate WiFi status.
 void indicate(byte value) {
- #ifdef ESP8266
-   digitalWrite(LED_PIN, !value);
- #else
-  digitalWrite(LED_PIN, value);
- #endif
+  pinMode(LED_PIN, OUTPUT);
+  #ifdef ESP8266
+    digitalWrite(LED_PIN, !value);
+  #else
+    digitalWrite(LED_PIN, value);
+  #endif
 }
 
 void printWifiStatus() {
@@ -44,56 +56,71 @@ void printWifiStatus() {
 }
 
 void connect(){
-  Serial.println();
-  Serial.print("Attempting to connect to SSID: ");
-  Serial.println(ssid);
+  #ifdef debug
+    indicate(false);
+    Serial.println();
+    Serial.print("Attempting to connect to SSID: ");
+    Serial.println(ssid);
+  #endif
+
   #ifdef ESP8266
     WiFi.mode(WIFI_STA);
   #endif
+
   WiFi.begin(ssid, pass);
   while (WiFi.status() != WL_CONNECTED) {
     delay(500);
-    Serial.print(".");
+    #ifdef ESP8266
+      Serial.print(".");
+    #endif
   }
-  printWifiStatus();
+
+  #ifdef debug
+    printWifiStatus();
+  #endif
 }
 
 void setup() {
-  pinMode(LED_PIN, OUTPUT);
-
-  // Start serial for debugging.
-  Serial.begin(115200);
-  while(!Serial);
-
-  connect();
-  server.begin();
+  // Wait for serial ready.
+  serial.begin(115200);
+  while(!serial);
 
+  // Enable over the air updates and "EEPROM" on the ESP8266.
   #ifdef ESP8266
+    EEPROM.begin(512);
     ArduinoOTA.begin();
   #endif
 
+  // Connect to WiFi and start TCP server.
+  connect();
+  server.begin();
+
+  // Add listener callbacks for local logic.
   dino.digitalListenCallback = onDigitalListen;
   dino.analogListenCallback = onAnalogListen;
+
+  // Use serial as the dino IO stream until we get a TCP connection.
+  dino.stream = &serial;
 }
 
 void loop() {
   // Reconnect if we've lost WiFi.
-  if (WiFi.status() != WL_CONNECTED){
-    indicate(false);
-    connect();
-  }
+  if (WiFi.status() != WL_CONNECTED) connect();
 
-  // Handle one client at a time.
+  // Allow one client at a time to be connected. Set it as the dino IO stream.
   if (!client){
     client = server.available();
     if (client) dino.stream = &client;
   }
 
-  // Run dino.
-  if (client) dino.run();
+  // Main loop of the dino library.
+  dino.run();
 
-  // End the connection when client disconnects.
-  if (client && !client.connected()) client.stop();
+  // End the connection when client disconnects and revert to serial IO.
+  if (client && !client.connected()){
+    client.stop();
+    dino.stream = &serial;
+  }
 
   // Handle OTA updates.
   #ifdef ESP8266

From 835f60f843d2d0145d869ff367a2e1acedc9eb40 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 16 Dec 2018 15:24:12 -0400
Subject: [PATCH 198/296] Let basic outputs receive state updates from the
 board

---
 lib/dino/components/basic/digital_output.rb | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/lib/dino/components/basic/digital_output.rb b/lib/dino/components/basic/digital_output.rb
index 3b3be84d..280694c4 100644
--- a/lib/dino/components/basic/digital_output.rb
+++ b/lib/dino/components/basic/digital_output.rb
@@ -4,14 +4,21 @@ module Basic
       class DigitalOutput
         include Setup::SinglePin
         include Setup::Output
+        include Mixins::Callbacks
         include Mixins::Threaded
         interrupt_with :digital_write
 
         def after_initialize(options={})
-          low
+          super(options)
+          board.digital_read(pin)
+        end
+
+        def pre_callback_filter(board_state)
+          board_state.to_i
         end
 
         def digital_write(value)
+          value = board.high unless (value == board.low)
           board.digital_write(pin, @state = value)
         end
 

From 1afce17fcfe89c034f1c2df0420ccffea9065fd4 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 16 Dec 2018 15:36:04 -0400
Subject: [PATCH 199/296] Fix parser bug that would re-run commands if sent
 only newline API access for reset without acknowledgement when disconnecting

---
 lib/dino/tx_rx/base.rb                       |  2 +-
 src/lib/Dino.cpp                             | 12 +++++++-----
 src/lib/Dino.h                               |  4 ++--
 test/components/basic/digital_output_test.rb |  6 +++---
 4 files changed, 13 insertions(+), 11 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 273bd90f..267feff7 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -37,7 +37,7 @@ def flush_read
       def start_read
         @thread ||= Thread.new  do
           trap("INT") do
-            io.write("\n90\n")
+            io.write("\n91\n")
             raise Interrupt
           end
 
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 35e15b94..22a69bab 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -51,7 +51,7 @@ void Dino::parse(byte c) {
     // If EOL, process and reset.
     else if (c == '\n'){
       append('\0');
-      process();
+      if ((fragmentIndex > 0) || (charIndex > 1)) process();
       fragmentIndex = 0;
       charIndex = 0;
     }
@@ -81,7 +81,8 @@ void Dino::parse(byte c) {
 }
 
 void Dino::append(byte c) {
-  messageFragments[fragmentIndex][charIndex++] = c;
+  messageFragments[fragmentIndex][charIndex] = c;
+  charIndex++;
 }
 
 void Dino::process() {
@@ -173,7 +174,8 @@ void Dino::process() {
     #endif
 
     // Implemented in this file.
-    case 90: reset               ();  break;
+    case 90: handshake           ();  break;
+    case 91: resetState          ();  break;
     case 95: setRegisterDivider  ();  break;
     case 96: setAnalogResolution ();  break;
 
@@ -211,7 +213,7 @@ void Dino::updateListeners() {
 
 
 // CMD = 90
-void Dino::reset() {
+void Dino::handshake() {
   resetState();
 
   // Reset this so we never send RCV: along with ACK:
@@ -230,7 +232,7 @@ void Dino::reset() {
   stream->print('\n');
 }
 
-
+// CMD = 91
 void Dino::resetState() {
   clearCoreListeners();
   #ifdef DINO_SPI
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 6fcc4016..4039592d 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -130,8 +130,8 @@ class Dino {
     //
     // Board level timings, resolutions and reset.
     //
-    void reset                 ();  //cmd = 90
-    void resetState            ();
+    void handshake             ();  //cmd = 90
+    void resetState            ();  //cmd = 91
     void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
     unsigned long lastTick;
diff --git a/test/components/basic/digital_output_test.rb b/test/components/basic/digital_output_test.rb
index 919727aa..64c69527 100644
--- a/test/components/basic/digital_output_test.rb
+++ b/test/components/basic/digital_output_test.rb
@@ -11,9 +11,9 @@ def part
     @part ||= Dino::Components::Basic::DigitalOutput.new(board: board, pin: 14)
   end
 
-  def test_low_on_initialize
-    mock = MiniTest::Mock.new.expect :call, nil, [14, board.low]
-    board.stub(:digital_write, mock) do
+  def read_state_on_initialize
+    mock = MiniTest::Mock.new.expect :call, nil, [14]
+    board.stub(:digital_read, mock) do
       part
     end
     mock.verify

From 1b71fe53906160e606781aaf97bb0698739f209b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 1 Jan 2019 13:49:48 -0400
Subject: [PATCH 200/296] Let WiFi connect fail without blocking main loop

---
 src/dino_wifi.ino | 86 +++++++++++++++++++++++++++--------------------
 1 file changed, 49 insertions(+), 37 deletions(-)

diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 599c3908..8fd53a08 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -4,12 +4,11 @@
   #include <ESP8266mDNS.h>
   #include <WiFiUdp.h>
   #include <ArduinoOTA.h>
-  #include <EEPROM.h>
-  #define LED_PIN 2
+  #define WIFI_STATUS_LED 2
 #else
   #include <SPI.h>
   #include <WiFi.h>
-  #define LED_PIN 13
+  #define WIFI_STATUS_LED 13
 #endif
 
 // Define 'serial' as the serial interface we want to use.
@@ -26,58 +25,62 @@
 int port = 3466;
 char* ssid = "yourNetwork";
 char* pass = "yourPassword";
+boolean connected = false;
+long lastConnectAttempt;
+int WiFiConnectTimeout = 10000;
 
 Dino dino;
 WiFiServer server(port);
 WiFiClient client;
 
 // Use the built in LED to indicate WiFi status.
-void indicate(byte value) {
-  pinMode(LED_PIN, OUTPUT);
+void indicateWiFi(byte value) {
+  pinMode(WIFI_STATUS_LED, OUTPUT);
   #ifdef ESP8266
-    digitalWrite(LED_PIN, !value);
+    digitalWrite(WIFI_STATUS_LED, !value);
   #else
-    digitalWrite(LED_PIN, value);
+    digitalWrite(WIFI_STATUS_LED, value);
   #endif
 }
 
 void printWifiStatus() {
-  Serial.println("Connected");
-  Serial.print("SSID: ");
-  Serial.println(WiFi.SSID());
-  Serial.print("Signal Strength (RSSI):");
-  Serial.print(WiFi.RSSI());
-  Serial.println(" dBm");
-  Serial.print("IP Address: ");
-  Serial.println(WiFi.localIP());
-  Serial.print("Dino TCP Port: ");
-  Serial.println(port);
-  indicate(true);
+  serial.println("WiFi Connected");
+  serial.print("SSID: ");
+  serial.println(WiFi.SSID());
+  serial.print("Signal Strength (RSSI):");
+  serial.print(WiFi.RSSI());
+  serial.println(" dBm");
+  serial.print("IP Address: ");
+  serial.println(WiFi.localIP());
+  serial.print("Dino TCP Port: ");
+  serial.println(port);
+  indicateWiFi(true);
 }
 
 void connect(){
-  #ifdef debug
-    indicate(false);
-    Serial.println();
-    Serial.print("Attempting to connect to SSID: ");
-    Serial.println(ssid);
-  #endif
-
   #ifdef ESP8266
     WiFi.mode(WIFI_STA);
   #endif
-
-  WiFi.begin(ssid, pass);
-  while (WiFi.status() != WL_CONNECTED) {
-    delay(500);
-    #ifdef ESP8266
-      Serial.print(".");
-    #endif
+  if (millis() - lastConnectAttempt > WiFiConnectTimeout){
+    WiFi.begin(ssid, pass);
+    lastConnectAttempt = millis();
   }
+}
 
-  #ifdef debug
+void maintainWiFi(){
+  if (connected == true){
+    if (WiFi.status() == WL_CONNECTED) return;
+    connected = false;
+    connect();
+  }
+  if (connected == false){
+    if (WiFi.status() != WL_CONNECTED) {
+      connect();
+      return;
+    }
+    connected = true;
     printWifiStatus();
-  #endif
+  }
 }
 
 void setup() {
@@ -90,10 +93,19 @@ void setup() {
     EEPROM.begin(512);
     ArduinoOTA.begin();
   #endif
+  // Start the dino TCP server.
+  server.begin();
+
+  delay(2000);
 
-  // Connect to WiFi and start TCP server.
+  // Attempt initial WiFi connection.
+  #ifdef debug
+    indicateWiFi(false);
+    serial.println();
+    serial.print("Attempting to connect to SSID: ");
+    serial.println(ssid);
+  #endif
   connect();
-  server.begin();
 
   // Add listener callbacks for local logic.
   dino.digitalListenCallback = onDigitalListen;
@@ -105,7 +117,7 @@ void setup() {
 
 void loop() {
   // Reconnect if we've lost WiFi.
-  if (WiFi.status() != WL_CONNECTED) connect();
+  maintainWiFi();
 
   // Allow one client at a time to be connected. Set it as the dino IO stream.
   if (!client){

From a696e015199598fea7149d03133d2cf1b73b025d Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 3 Feb 2023 23:45:56 -0400
Subject: [PATCH 201/296] Fix a race condition in receiving handshake
 acknowledgement

---
 lib/dino/tx_rx/handshake.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino/tx_rx/handshake.rb b/lib/dino/tx_rx/handshake.rb
index 9b2361a4..e0a77764 100644
--- a/lib/dino/tx_rx/handshake.rb
+++ b/lib/dino/tx_rx/handshake.rb
@@ -8,9 +8,9 @@ def initialize
       end
 
       def update(sender, result)
-        @acknowledged = true
         sender.delete_observer(self)
         @result = result
+        @acknowledged = true
       end
     end
 

From e3a4282bb1b565498838125e3a02981328e70dac Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 4 Feb 2023 01:52:49 -0400
Subject: [PATCH 202/296] Pass tests

---
 lib/dino/api/core.rb                      |  2 +-
 lib/dino/components/one_wire/helper.rb    |  4 +---
 lib/dino/components/servo.rb              |  2 +-
 test/api/core_test.rb                     | 11 ++++++-----
 test/components/register/shift_in_test.rb | 23 ++++++++++++++++++++---
 test/components/servo_test.rb             |  6 +++---
 6 files changed, 32 insertions(+), 16 deletions(-)

diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index c6116f0c..3980008a 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -41,7 +41,7 @@ def set_pullup(pin, pullup)
       # CMD = 5
       def set_listener(pin, state=:off, options={})
         mode    = options[:mode]    || :digital
-        divider = options[:divider] || 8
+        divider = options[:divider] || 16
 
         unless [:digital, :analog].include? mode
           raise "Mode must be either digital or analog"
diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
index 1bfff474..b4fcbd29 100644
--- a/lib/dino/components/one_wire/helper.rb
+++ b/lib/dino/components/one_wire/helper.rb
@@ -2,14 +2,12 @@ module Dino
   module Components
     module OneWire
       class Helper
-        ADDRESS_TO_BYTES_CLASSES = [Integer, Bignum, Fixnum].freeze
-
         def self.address_to_bytes(address)
           [address].pack('Q<').split("").map(&:ord)
         end
 
         def self.crc_check(data)
-          if ADDRESS_TO_BYTES_CLASSES.include?(data.class)
+          if data.class == Integer
             bytes = address_to_bytes(data)
           else
             bytes = data
diff --git a/lib/dino/components/servo.rb b/lib/dino/components/servo.rb
index 4768347a..cdc96eb5 100644
--- a/lib/dino/components/servo.rb
+++ b/lib/dino/components/servo.rb
@@ -16,7 +16,7 @@ def attach
       end
 
       def detach
-        board.servo_toggle(pin, :off, min: @min, max: @max)
+        board.servo_toggle(pin, :off)
       end
 
       def position=(value)
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
index dc24b8ce..b7213b2a 100644
--- a/test/api/core_test.rb
+++ b/test/api/core_test.rb
@@ -84,9 +84,10 @@ def test_analog_read
   def test_set_listener
     mock = MiniTest::Mock.new
 
-    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0, aux_message: "\x00\x03")])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0, aux_message: "\x01\x03")])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 1, aux_message: "\x01\x03")])
+    # \x00\x04 corresponds to the default divider of 16 (2^4)
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0, aux_message: "\x00\x04")])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 0, aux_message: "\x01\x04")])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 1, aux_message: "\x01\x04")])
     mock.expect(:call, nil, [Dino::Message.encode(command: 5, pin: 1, value: 1, aux_message: "\x01\x00")])
 
     board.stub(:write, mock) do
@@ -100,7 +101,7 @@ def test_set_listener
 
   def test_digital_listen
     mock = MiniTest::Mock.new
-    mock.expect(:call, nil, [1, :on, {mode: :digital, divider: 4}])
+    mock.expect(:call, nil, [1, :on], mode: :digital, divider: 4)
 
     board.stub(:set_listener, mock) do
       board.digital_listen(1)
@@ -109,7 +110,7 @@ def test_digital_listen
 
   def test_analog_listen
     mock = MiniTest::Mock.new
-    mock.expect(:call, nil, [1, :on, {mode: :analog, divider: 16}])
+    mock.expect(:call, nil, [1, :on], mode: :analog, divider: 16)
 
     board.stub(:set_listener, mock) do
       board.analog_listen(1)
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
index 551cc0ce..1f60b16f 100644
--- a/test/components/register/shift_in_test.rb
+++ b/test/components/register/shift_in_test.rb
@@ -33,15 +33,32 @@ def test_rising_clock
   end
 
   def test_read
-    # mock = MiniTest::Mock.new.expect :call, nil, ["22.8.1.#{[11,12,0].pack('C<*')}\n"]
-    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, 2, {preclock_high: true}]
+    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, 2], preclock_high: true
     board.stub(:shift_read, mock) do
       new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2, rising_clock: true))
       new_part.read
     end
     mock.verify
   end
-
+  
+  def test_listen
+    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, 2], preclock_high: true
+    board.stub(:shift_listen, mock) do
+      new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2, rising_clock: true))
+      new_part.listen
+    end
+    mock.verify
+  end
+  
+  def test_stop
+    mock = MiniTest::Mock.new.expect :call, nil, [8]
+    board.stub(:shift_stop, mock) do
+      new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2, rising_clock: true))
+      new_part.stop
+    end
+    mock.verify
+  end
+  
   def test_callback_bubble
     mock = MiniTest::Mock.new.expect :call, nil, ["127,255"]
     part.stub(:update, mock) do
diff --git a/test/components/servo_test.rb b/test/components/servo_test.rb
index 3cf78407..24158b68 100644
--- a/test/components/servo_test.rb
+++ b/test/components/servo_test.rb
@@ -12,7 +12,7 @@ def part
   end
 
   def test_toggle_on_initialize
-    mock = MiniTest::Mock.new.expect(:call, nil, [1, :on, Hash])
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, :on], min: 544, max: 2400)
     board.stub(:servo_toggle, mock) do
       Dino::Components::Servo.new(board: board, pin:1)
     end
@@ -20,14 +20,14 @@ def test_toggle_on_initialize
 
   def test_attach
     part
-    mock = MiniTest::Mock.new.expect(:call, nil, [1, :on, Hash])
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, :on], min: 0, max: 360)
     board.stub(:servo_toggle, mock) { part.attach }
     mock.verify
   end
 
   def test_detach
     part
-    mock = MiniTest::Mock.new.expect(:call, nil, [1, :off, Hash])
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, :off])
     board.stub(:servo_toggle, mock) { part.detach }
     mock.verify
   end

From 207584890f3db09d3a44d1d8928e217eaca054b4 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 4 Feb 2023 22:57:34 -0400
Subject: [PATCH 203/296] Add EEPROM convenience methods and an example

---
 examples/eeprom/eeprom.rb                 | 34 +++++++++++++++++++++++
 lib/dino/components/basic/board_eeprom.rb | 24 +++++++++++++++-
 2 files changed, 57 insertions(+), 1 deletion(-)
 create mode 100644 examples/eeprom/eeprom.rb

diff --git a/examples/eeprom/eeprom.rb b/examples/eeprom/eeprom.rb
new file mode 100644
index 00000000..959d11bc
--- /dev/null
+++ b/examples/eeprom/eeprom.rb
@@ -0,0 +1,34 @@
+#
+# This is a simple example to blink an led
+# every half a second
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+
+# Initialization automatically gets all EEPROM data from thee board.
+eeprom = Dino::Components::Basic::BoardEEPROM.new(board: board)
+
+# EEPROM size reported by the board.
+puts "EEPROM Size: #{eeprom.length} bytes"
+
+# Write values like an array.
+eeprom[0] = 128
+eeprom[1] = 127
+
+# Changes do not save to the board automatically.
+# Call #save to write to the board, and automatically reload from it.
+eeprom.save
+
+# Read values like an array.
+puts "Address 0 contains: #{eeprom[0]}"
+
+# Enumerate like an array.
+eeprom.each_with_index do |byte, address|
+  if address == 1
+    puts "Address #{address} contains #{byte}"
+  end
+end
+
+
diff --git a/lib/dino/components/basic/board_eeprom.rb b/lib/dino/components/basic/board_eeprom.rb
index 1842e8cc..c6c3dbc4 100644
--- a/lib/dino/components/basic/board_eeprom.rb
+++ b/lib/dino/components/basic/board_eeprom.rb
@@ -27,7 +27,29 @@ def save
           end
           load
         end
-
+        
+        #
+        # Specific Array-like methods for convenience.
+        # 
+        def length; board.eeprom_length; end
+        alias :count :length
+        
+        def [](index)
+          @state_mutex.synchronize { @state.send :[], index }
+        end
+        
+        def []=(index, value)
+          @state_mutex.synchronize { @state.send :[]=, index, value }
+        end
+        
+        def each(&block)
+          @state_mutex.synchronize { @state.send :each, &block }
+        end
+        
+        def each_with_index(&block)
+          @state_mutex.synchronize { @state.send :each_with_index, &block }
+        end
+        
         def pre_callback_filter(message)
           address = message.split("-", 2)[0].to_i
           bytes = message.split("-", 2)[1].split(",").map(&:to_i)

From 8d682f3ff5ae45fcda3038a18810dfa431bc695a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 4 Feb 2023 23:39:28 -0400
Subject: [PATCH 204/296] Clean up the I2C interface

---
 examples/i2c/ds3231.rb            | 30 ++++++++++++++-------
 lib/dino/api/i2c.rb               | 26 +++++++++++-------
 lib/dino/components/i2c/bus.rb    | 10 ++++---
 lib/dino/components/i2c/ds3231.rb | 25 ++++++++++-------
 lib/dino/components/i2c/slave.rb  | 11 +++++---
 src/lib/Dino.cpp                  |  1 -
 src/lib/DinoI2C.cpp               | 45 +++++++++++++++++++------------
 7 files changed, 94 insertions(+), 54 deletions(-)

diff --git a/examples/i2c/ds3231.rb b/examples/i2c/ds3231.rb
index f19f4481..676486a1 100644
--- a/examples/i2c/ds3231.rb
+++ b/examples/i2c/ds3231.rb
@@ -1,14 +1,14 @@
 #
-# Somewhat pointless example to ensure I2C is working. Sets the time on a
-# connected DS3231 real-time-clock and reads it back every 5 seconds.
+# Small example to show how I2C works. Sets  time on a DS3231
+# real-time-clock, and reads it back every 5 seconds.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 
-# Only pass in the SDA pin of the I2C bus. SCL (clock) pin MUST be properly
-# connected for things to work, but we don't need to control it.
+# Only pass the SDA pin of the I2C bus. SCL (clock) pin must be 
+# connected for it to work, but we don't need to control it.
 #
 # Most Arduinos: SDA = 'A4'   SCL = 'A5'
 # Leonardo:      SDA =   2    SCL =   3
@@ -19,11 +19,23 @@
 # This is for convenience when working with common development boards.
 #
 bus = Dino::Components::I2C::Bus.new(board: board, pin: 4)
-rtc = Dino::Components::I2C::DS3231.new(bus: bus, address: 104)
 
-rtc.time = Time.now
+# The bus auto searches for devices on intiailization.
+puts "No I2C devices connected!" if bus.found_devices.empty?
+bus.found_devices.each do |address|
+  puts "I2C device connected with address: 0x#{address.to_s(16)}"
+end
+
+# 0x68 or 140 is the I2C address for most real time clocks.
+unless (bus.found_devices.include? 0x68)
+  puts "No real time clock found!" unless bus.found_devices.empty?
+else
+  puts; puts "Using real time clock at address 0x68"; puts
+  rtc = Dino::Components::I2C::DS3231.new(bus: bus, address: 0x68)
+  rtc.time = Time.now
 
-loop do
-  puts rtc.time
-  sleep 5
+  5.times do
+    puts rtc.time
+    sleep 5
+  end
 end
diff --git a/lib/dino/api/i2c.rb b/lib/dino/api/i2c.rb
index 17d833ea..783e14e0 100644
--- a/lib/dino/api/i2c.rb
+++ b/lib/dino/api/i2c.rb
@@ -10,23 +10,29 @@ def i2c_search
 
       # CMD = 34
       def i2c_write(address, bytes=[], options={})
-        aux = pack :uint8, [address, bytes.length, bytes].flatten
+        
+        # Bit 1 of settings controls repeated start.
+        settings  = 0b00
+        settings |= 0b01 if options[:repeated_start]
+        
+        aux = pack :uint8, [address, 0, bytes.length, bytes].flatten
         write Message.encode command: 34,
-                             value: options[:repeated_start] ? 1 : 0,
+                             value: settings,
                              aux_message: aux
       end
 
       # CMD = 35
       def i2c_read(address, register, num_bytes, options={})
-        settings = options[:repeated_start] ? 1 : 0
-
-        # Won't write anything if no start register was given.
-        unless register
-          settings = settings | 0b10
-          register = 0
-        end
+        raise ArgumentError, 'maximum read length from I2C devices is 32 bytes' if num_bytes > 32
+        
+        # Bit 1 of settings controls repeated start.
+        settings  = 0b00
+        settings |= 0b01 if options[:repeated_start]
+        
+        # Bit 2 of settings controls whether to write a start register before reading.
+        settings |= 0b10 if register
 
-        aux = pack :uint8, [address, register, num_bytes]
+        aux = pack :uint8, [address, 0, register, num_bytes]
         write Message.encode command: 35,
                              value: settings,
                              aux_message: aux
diff --git a/lib/dino/components/i2c/bus.rb b/lib/dino/components/i2c/bus.rb
index bdc6904b..7c5330b2 100644
--- a/lib/dino/components/i2c/bus.rb
+++ b/lib/dino/components/i2c/bus.rb
@@ -10,12 +10,16 @@ class Bus
 
         def after_initialize(options={})
           super(options)
+          @found_devices = []
+          search
           bubble_callbacks
         end
 
         def search
           addresses = read_using -> { board.i2c_search }
-          @found_devices = addresses.split(":").map(&:to_i)
+          if addresses
+            @found_devices = addresses.split(":").map(&:to_i)
+          end
         end
 
         def write(address, bytes=[], options={})
@@ -30,13 +34,13 @@ def read(*args)
           read_using -> { _read(*args) }
         end
 
-        def _read(address, register, num_bytes=1, options={})
+        def _read(address, register=nil, num_bytes=1, options={})
           board.i2c_read(address, register, num_bytes, options)
         end
 
         def bubble_callbacks
           add_callback(:bus_master) do |str|
-            if str.match(/d*-/)
+            if str && str.match(/d*-/)
               address, data = str.split("-", 2)
               address = address.to_i
               data = data.split(",").map(&:to_i)
diff --git a/lib/dino/components/i2c/ds3231.rb b/lib/dino/components/i2c/ds3231.rb
index 4185cee4..ad6b7ed8 100644
--- a/lib/dino/components/i2c/ds3231.rb
+++ b/lib/dino/components/i2c/ds3231.rb
@@ -3,18 +3,12 @@ module Components
     module I2C
       class DS3231 < Slave
         require 'bcd'
-
-        def pre_callback_filter(bytes)
-          t = bytes.map { |b| BCD.encode(b) }
-          Time.new t[6] + 1970, t[5], t[4], t[2], t[1], t[0]
-        end
-
+        
         def time
-          # Return of read_bytes is still unfiltered string from the bus...
-          read_using -> { read_bytes(nil, 7) }
-          @state
+          read_using -> { _read }
+          state
         end
-
+        
         def time=(time)
           bytes = [ 0,
                     BCD.decode(time.sec),
@@ -27,6 +21,17 @@ def time=(time)
           write(bytes)
           time
         end
+        
+        # Time data starts at register 0 and is 7 bytes long.
+        def _read
+          read_bytes(0, 7)
+        end
+        
+        # Convert raw bytes from the I2C bus into a Ruby Time object.
+        def pre_callback_filter(bytes)
+          t = bytes.map { |b| BCD.encode(b) }
+          Time.new t[6] + 1970, t[5], t[4], t[2], t[1], t[0]
+        end
       end
     end
   end
diff --git a/lib/dino/components/i2c/slave.rb b/lib/dino/components/i2c/slave.rb
index 14cf1e14..e0b50419 100644
--- a/lib/dino/components/i2c/slave.rb
+++ b/lib/dino/components/i2c/slave.rb
@@ -3,12 +3,15 @@ module Components
     module I2C
       class Slave
         include Mixins::BusSlave
-        include Mixins::Poller
+        include Mixins::Reader
 
-        def repeated_start
-          false
+        def initialize(options)
+          super(options)
+          @repeated_start = options[:repeated_start] || false
         end
-
+        
+        attr_accessor :repeated_start
+        
         def write(bytes=[])
           bus.write(address, bytes, repeated_start: repeated_start)
         end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 22a69bab..72db040c 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -162,7 +162,6 @@ void Dino::process() {
     case 33: i2cSearch           ();  break;
     case 34: i2cWrite            ();  break;
     case 35: i2cRead             ();  break;
-    case 36: i2cTransfer         ();  break;
     #endif
 
     // Implemented in DinoOneWire.cpp
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
index 316f1fc8..1492221d 100644
--- a/src/lib/DinoI2C.cpp
+++ b/src/lib/DinoI2C.cpp
@@ -23,8 +23,9 @@ void Dino::i2cSearch() {
   stream->print(SDA);
 
   i2cBegin();
-  for (byte i = 0x08; i < 0x78;  i++) {
-    Wire.requestFrom(i, 1);
+  for (uint8_t i = 0x08; i < 0x78;  i++) {
+    uint8_t length = 1;
+    Wire.requestFrom(i, length);
     if (Wire.available()){
       stream->print(':'); stream->print(i);
       while(Wire.available()) Wire.read();
@@ -37,43 +38,53 @@ void Dino::i2cSearch() {
 // CMD = 34
 // Write to an I2C device. All params as binary in auxMsg.
 //
-// val        = repeated starts?
-// auxMsg[0]  = device address
-// auxMsg[1]  = number of bytes
-// auxMsg[2]+ = data
+// val        = Settings
+// val bit 0  = repeated start
+// val bit 1  = write register address before reading
+// val bit 2+ = unused
 //
-// Max 256 bytes. Validate remotely.
+// auxMsg[0]  = 7-bit device address
+// auxMsg[1]  = reserved
+// auxMsg[2]  = data length
+// auxMsg[3]+ = data
+//
+// Max limited by aux message size.
 //
 void Dino::i2cWrite() {
+  byte repeatedStart = bitRead(val, 0);
   i2cBegin();
   Wire.beginTransmission(auxMsg[0]);
   Wire.write(&auxMsg[2], auxMsg[1]);
-  Wire.endTransmission(val);
+  Wire.endTransmission(repeatedStart);
 }
 
 // CMD = 35
 // Read from an I2C device. All params as binary in auxMsg.
 //
-// val        = repeated starts?
-// auxMsg[0]  = device address
-// auxMsg[1]  = start register address
-// auxMsg[2]  = number of bytes
+// val        = Settings
+// val bit 0  = repeated start
+// val bit 1  = write register address before reading
+// val bit 2+ = unused
+// 
+// auxMsg[0]  = 7-bit device address
+// auxMsg[1]  = reserved
+// auxMsg[2]  = register address
+// auxMsg[3]  = number of bytes
 //
 // Max 32 bytes, limited by Wire library buffer. Validate remotely.
 //
 void Dino::i2cRead() {
-  if (auxMsg[2] > 32) auxMsg[2] = 32;
+  if (auxMsg[3] > 32) auxMsg[3] = 32;
   byte repeatedStart = bitRead(val, 0);
   i2cBegin();
 
-  // Bit 1 of val is flag for whether to write register address first or not.
+  // Optionally write a register address before reading.
   if (bitRead(val, 1)) {
     Wire.beginTransmission(auxMsg[0]);
     Wire.write(auxMsg[1]);
     Wire.endTransmission(repeatedStart);
   }
-
-  Wire.requestFrom(auxMsg[0], auxMsg[2], repeatedStart);
+  Wire.requestFrom(auxMsg[0], auxMsg[3], repeatedStart);
 
   // Send data as if coming from SDA pin. Prefix with device adddress.
   // Fail silently if no bytes read / invalid device address.
@@ -85,7 +96,7 @@ void Dino::i2cRead() {
   while(Wire.available()){
     currentByte++;
     stream->print(Wire.read());
-    stream->print((currentByte == auxMsg[2]) ? '\n' : ',');
+    stream->print((currentByte == auxMsg[3]) ? '\n' : ',');
   }
 }
 #endif

From c51d4be4279e5cca69474d20bf0ed11e8dfbde1e Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 5 Feb 2023 00:46:49 -0400
Subject: [PATCH 205/296] Readers and pollers handle arguments better

---
 examples/one_wire/ds18b20.rb         | 12 +++++-----
 lib/dino/components/i2c/bus.rb       |  8 -------
 lib/dino/components/i2c/ds3231.rb    |  9 ++++----
 lib/dino/components/mixins/poller.rb | 10 ++++-----
 lib/dino/components/mixins/reader.rb | 33 +++++++++++++++++++---------
 lib/dino/components/one_wire/bus.rb  |  4 ++--
 6 files changed, 41 insertions(+), 35 deletions(-)

diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index be655c4c..afe24c07 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -37,7 +37,7 @@
 end
 
 #  Format a reading for printing on a line.
-def print_reading(reading, sensor, i)
+def print_reading(reading, sensor)
   print "#{Time.now.strftime '%Y-%m-%d %H:%M:%S'} - "
   print "Serial(HEX): #{sensor.serial_number} | Res: #{sensor.resolution} bits | "
 
@@ -49,8 +49,10 @@ def print_reading(reading, sensor, i)
   end
 end
 
-# Read the temp from each sensor in a simple loop.
-loop do
-  ds18b20s.each_with_index { |s,i| print_reading(s.read, s, i) }
-  sleep 5
+ds18b20s.each do |sensor|
+  sensor.poll(5) do |reading|
+    print_reading(reading, sensor)
+  end
 end
+
+sleep
diff --git a/lib/dino/components/i2c/bus.rb b/lib/dino/components/i2c/bus.rb
index 7c5330b2..e687896a 100644
--- a/lib/dino/components/i2c/bus.rb
+++ b/lib/dino/components/i2c/bus.rb
@@ -26,14 +26,6 @@ def write(address, bytes=[], options={})
           board.i2c_write(address, [bytes].flatten, options)
         end
 
-        def transfer(address, options={})
-          board.i2c_transfer(address, options)
-        end
-
-        def read(*args)
-          read_using -> { _read(*args) }
-        end
-
         def _read(address, register=nil, num_bytes=1, options={})
           board.i2c_read(address, register, num_bytes, options)
         end
diff --git a/lib/dino/components/i2c/ds3231.rb b/lib/dino/components/i2c/ds3231.rb
index ad6b7ed8..ef2a36e3 100644
--- a/lib/dino/components/i2c/ds3231.rb
+++ b/lib/dino/components/i2c/ds3231.rb
@@ -4,11 +4,7 @@ module I2C
       class DS3231 < Slave
         require 'bcd'
         
-        def time
-          read_using -> { _read }
-          state
-        end
-        
+        # Set the time.
         def time=(time)
           bytes = [ 0,
                     BCD.decode(time.sec),
@@ -22,6 +18,9 @@ def time=(time)
           time
         end
         
+        # Read the time.
+        alias :time :read
+        
         # Time data starts at register 0 and is 7 bytes long.
         def _read
           read_bytes(0, 7)
diff --git a/lib/dino/components/mixins/poller.rb b/lib/dino/components/mixins/poller.rb
index 8f9fb4b9..aa8e3c04 100644
--- a/lib/dino/components/mixins/poller.rb
+++ b/lib/dino/components/mixins/poller.rb
@@ -4,19 +4,19 @@ module Mixins
       module Poller
         include Reader
         include Threaded
-
-        def poll_using(method, interval=1, &block)
+        
+        def poll_using(method, interval=3, *args, &block)
           stop
           add_callback(:poll, &block) if block_given?
 
           threaded_loop do
-            method.call
+            method.call(*args)
             sleep interval
           end
         end
 
-        def poll(interval=1, &block)
-          poll_using(method(:_read), interval, &block)
+        def poll(interval=3, *args, &block)
+          poll_using(self.method(:_read), interval, *args, &block)
         end
 
         def stop
diff --git a/lib/dino/components/mixins/reader.rb b/lib/dino/components/mixins/reader.rb
index d387d17d..43643f9b 100644
--- a/lib/dino/components/mixins/reader.rb
+++ b/lib/dino/components/mixins/reader.rb
@@ -4,23 +4,36 @@ module Mixins
       module Reader
         include Callbacks
 
-        def read_using(method, &block)
+        #
+        # Defalt behavior for #read is to delegate to #_read.
+        # Define #_read in including classes.
+        #
+        def read(*args, &block)
+          read_using(self.method(:_read), *args, &block)
+        end
+
+        #
+        # Delegate reading to another method that sends a command to the board. 
+        # Accepts blocks as one-time callbacks stored in the :read key.
+        # Blocks until a value is recieved from the board.
+        # Returns the value after #pre_callback_filter runs on it.
+        #
+        # Give procs as methods to build more complex functionality for buses.
+        #
+        def read_using(method, *args, &block)
           add_callback(:read, &block) if block_given?
 
-          # Block and catches read value for return, AFTER the pre-filter.
           value = nil
-          add_callback(:read) { |data| value = data }
-
-          method.call
+          add_callback(:read) do |filtered_data|
+            value = filtered_data
+          end
+          
+          method.call(*args)
           block_until_read
 
           value
         end
-
-        def read(&block)
-          read_using(self.method(:_read), &block)
-        end
-
+        
         def block_until_read
           loop do
             break if !@callbacks[:read]
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index 35862815..881e37a5 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -46,8 +46,8 @@ def reset(get_presence=0)
           board.one_wire_reset(pin, get_presence)
         end
 
-        def read(num_bytes)
-          read_using -> { board.one_wire_read(pin, num_bytes) }
+        def _read(num_bytes)
+          board.one_wire_read(pin, num_bytes)
         end
 
         def write(*bytes)

From 728568de9894efd9dd86e3566774e6a944cdf4a0 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 5 Feb 2023 21:00:10 -0400
Subject: [PATCH 206/296] Fix I2C

---
 lib/dino/api/i2c.rb | 2 +-
 src/lib/DinoI2C.cpp | 6 ++++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/lib/dino/api/i2c.rb b/lib/dino/api/i2c.rb
index 783e14e0..fe7a4b41 100644
--- a/lib/dino/api/i2c.rb
+++ b/lib/dino/api/i2c.rb
@@ -10,7 +10,6 @@ def i2c_search
 
       # CMD = 34
       def i2c_write(address, bytes=[], options={})
-        
         # Bit 1 of settings controls repeated start.
         settings  = 0b00
         settings |= 0b01 if options[:repeated_start]
@@ -31,6 +30,7 @@ def i2c_read(address, register, num_bytes, options={})
         
         # Bit 2 of settings controls whether to write a start register before reading.
         settings |= 0b10 if register
+        register = 0 unless register
 
         aux = pack :uint8, [address, 0, register, num_bytes]
         write Message.encode command: 35,
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
index 1492221d..32778b3c 100644
--- a/src/lib/DinoI2C.cpp
+++ b/src/lib/DinoI2C.cpp
@@ -54,7 +54,7 @@ void Dino::i2cWrite() {
   byte repeatedStart = bitRead(val, 0);
   i2cBegin();
   Wire.beginTransmission(auxMsg[0]);
-  Wire.write(&auxMsg[2], auxMsg[1]);
+  Wire.write(&auxMsg[3], auxMsg[2]);
   Wire.endTransmission(repeatedStart);
 }
 
@@ -81,9 +81,10 @@ void Dino::i2cRead() {
   // Optionally write a register address before reading.
   if (bitRead(val, 1)) {
     Wire.beginTransmission(auxMsg[0]);
-    Wire.write(auxMsg[1]);
+    Wire.write(auxMsg[2]);
     Wire.endTransmission(repeatedStart);
   }
+  Wire.beginTransmission(auxMsg[0]);
   Wire.requestFrom(auxMsg[0], auxMsg[3], repeatedStart);
 
   // Send data as if coming from SDA pin. Prefix with device adddress.
@@ -98,5 +99,6 @@ void Dino::i2cRead() {
     stream->print(Wire.read());
     stream->print((currentByte == auxMsg[3]) ? '\n' : ',');
   }
+  Wire.endTransmission(repeatedStart);
 }
 #endif

From 88ef099f7f087bca928fad09948b5af663e94061 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 5 Feb 2023 23:50:55 -0400
Subject: [PATCH 207/296] Add tests and remove unused methods for DHT sensors

---
 examples/dht/dht.rb         |  4 +--
 lib/dino/api.rb             |  1 -
 lib/dino/api/dht.rb         | 12 -------
 test/components/dht_test.rb | 66 +++++++++++++++++++++++++++++++++++++
 4 files changed, 68 insertions(+), 15 deletions(-)
 delete mode 100644 lib/dino/api/dht.rb
 create mode 100644 test/components/dht_test.rb

diff --git a/examples/dht/dht.rb b/examples/dht/dht.rb
index 113e71c9..63d127b7 100644
--- a/examples/dht/dht.rb
+++ b/examples/dht/dht.rb
@@ -4,8 +4,8 @@
 require 'bundler/setup'
 require 'dino'
 
-board = Dino::Board.new(Dino::TxRx::Serial.new(device: "/dev/cu.usbmodem1431"))
-dht = Dino::Components::DHT.new(pin: 7, board: board)
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+dht = Dino::Components::DHT.new(pin: 4, board: board)
 
 # The DHT class pre-processes raw data from the board. When it reaches callbacks
 # it's already hash of :temperature and :humidity keys, both with Float values.
diff --git a/lib/dino/api.rb b/lib/dino/api.rb
index 94d61e96..bdb0143f 100644
--- a/lib/dino/api.rb
+++ b/lib/dino/api.rb
@@ -3,7 +3,6 @@ module API
     require 'dino/api/helper'
     require 'dino/api/core'
     require 'dino/api/eeprom'
-    require 'dino/api/dht'
     require 'dino/api/i2c'
     require 'dino/api/infrared'
     require 'dino/api/one_wire'
diff --git a/lib/dino/api/dht.rb b/lib/dino/api/dht.rb
deleted file mode 100644
index 413db961..00000000
--- a/lib/dino/api/dht.rb
+++ /dev/null
@@ -1,12 +0,0 @@
-module Dino
-  module API
-    module DHT
-      include Helper
-
-      # CMD = 13
-      def dht_read(pin)
-        write Message.encode command: 13, pin: convert_pin(pin)
-      end
-    end
-  end
-end
diff --git a/test/components/dht_test.rb b/test/components/dht_test.rb
new file mode 100644
index 00000000..21c1182e
--- /dev/null
+++ b/test/components/dht_test.rb
@@ -0,0 +1,66 @@
+require 'dino'
+require 'board_mock'
+require 'minitest/autorun'
+
+class DHTTest < MiniTest::Test
+  PIN = 1
+  
+  # Actual raw data from a sensor
+  GOOD_STRING  = "14,82,77,57,26,52,26,57,26,51,32,51,26,57,26,52,72,57,26,67,72,57,26,51,27,56,72,52,77,52,77,51,26,57,72,67,26,52,26,57,26,52,26,57,26,51,31,52,26,57,72,67,26,52,26,56,72,57,26,52,26,57,72,52,77,51,72,67,72,57,72,51,32,51,26,57,26,52,72,57,72,56,72,47"
+  GOOD_ARRAY   = [14, 82, 77, 57, 26, 52, 26, 57, 26, 51, 32, 51, 26, 57, 26, 52, 72, 57, 26, 67, 72, 57, 26, 51, 27, 56, 72, 52, 77, 52, 77, 51, 26, 57, 72, 67, 26, 52, 26, 57, 26, 52, 26, 57, 26, 51, 31, 52, 26, 57, 72, 67, 26, 52, 26, 56, 72, 57, 26, 52, 26, 57, 72, 52, 77, 51, 72, 67, 72, 57, 72, 51, 32, 51, 26, 57, 26, 52, 72, 57, 72, 56, 72, 47]
+  SHORT_ARRAY  = [1,2,3,4,5,6]
+  
+  # Make test data with a bad CRC byte (all 1s = 255).
+  def bad_crc
+    bad_crc = GOOD_ARRAY.dup
+    (67..82).each { |i| bad_crc[i] = 56 }
+    bad_crc
+  end
+  
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::DHT.new(board: board, pin:PIN)
+  end
+  
+  # It should tell the board to do a #pulse_read
+  def test__read
+    part
+    mock = MiniTest::Mock.new.expect(:call, nil, [PIN], reset: board.low, reset_time: 1000, pulse_limit: 84)
+    board.stub(:pulse_read, mock) do
+      part._read
+    end
+    mock.verify
+  end
+  
+  # Callback pre filter should convert string of bytes to array and call #decode with it.
+  def test_pre_callback_filter
+    part
+    mock = MiniTest::Mock.new.expect(:call, nil, [GOOD_ARRAY])
+    part.stub(:decode, mock) do
+      part.update(GOOD_STRING)
+    end
+  end
+  
+  def test_decode
+    # Error message in output if data is missing.
+    result = part.decode(SHORT_ARRAY)
+    assert result.keys.include? :error
+    assert result[:error]. match /missing/i
+    
+    # Error message in output if bad CRC.
+    result = part.decode(bad_crc)
+    assert result.keys.include? :error
+    assert result[:error]. match /crc/i
+    
+    # It should calculate output correctly.
+    result = part.decode(GOOD_ARRAY)
+    assert_equal result, {celsius: 29.5, farenheit: 85.1, humidity: 66.9}
+  end
+  
+  def test_crc
+    refute part.crc(bad_crc)
+  end
+end

From f606fadf3cbe586bad835377c2d1d34368bf6de4 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 6 Feb 2023 00:44:43 -0400
Subject: [PATCH 208/296] Cleanup some tests

---
 lib/dino/board/base.rb              | 2 +-
 lib/dino/tx_rx/base.rb              | 2 +-
 lib/dino/tx_rx/serial.rb            | 2 +-
 test/components/dht_test.rb         | 4 ++--
 test/components/rgb_led_test.rb     | 2 +-
 test/components/setup/input_test.rb | 2 +-
 test/components/ssd_test.rb         | 2 +-
 7 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index 17587dc6..82bde344 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -5,7 +5,7 @@ class Base
       include API::EEPROM
 
       attr_reader :high, :low, :analog_high, :components
-      attr_reader :analog_zero, :dac_zero, :aux_limit, :eeprom_length
+      attr_reader :analog_zero, :dac_zero, :eeprom_length
 
       def initialize(io, options={})
         @io, @components = io, []
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 267feff7..1b861ba7 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -30,7 +30,7 @@ def io_reset
 
       def flush_read
         Timeout.timeout(5) { read until read == nil }
-        rescue Timeout::Error
+      rescue Timeout::Error
         raise RxFlushTimeout "Cannot read from device, or device not running dino"
       end
 
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index 44554744..5a99be8b 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -71,7 +71,7 @@ def tty_devices
       end
 
       def on_windows?
-        RUBY_PLATFORM.match /mswin|mingw/i
+        RUBY_PLATFORM.match(/mswin|mingw/i)
       end
     end
   end
diff --git a/test/components/dht_test.rb b/test/components/dht_test.rb
index 21c1182e..2da6b874 100644
--- a/test/components/dht_test.rb
+++ b/test/components/dht_test.rb
@@ -48,12 +48,12 @@ def test_decode
     # Error message in output if data is missing.
     result = part.decode(SHORT_ARRAY)
     assert result.keys.include? :error
-    assert result[:error]. match /missing/i
+    assert result[:error].match(/missing/i)
     
     # Error message in output if bad CRC.
     result = part.decode(bad_crc)
     assert result.keys.include? :error
-    assert result[:error]. match /crc/i
+    assert result[:error].match(/crc/i)
     
     # It should calculate output correctly.
     result = part.decode(GOOD_ARRAY)
diff --git a/test/components/rgb_led_test.rb b/test/components/rgb_led_test.rb
index 0b55bf1f..a3d8c176 100644
--- a/test/components/rgb_led_test.rb
+++ b/test/components/rgb_led_test.rb
@@ -3,7 +3,7 @@
 require 'minitest/autorun'
 
 class RGBLedTest < MiniTest::Test
- def board
+  def board
     @board ||= BoardMock.new
   end
 
diff --git a/test/components/setup/input_test.rb b/test/components/setup/input_test.rb
index b65678ab..49a767c5 100644
--- a/test/components/setup/input_test.rb
+++ b/test/components/setup/input_test.rb
@@ -36,7 +36,7 @@ def test_pullup
   def test_pullup_in_options
     mock = Minitest::Mock.new.expect :call, nil, [2, true]
     board.stub(:set_pullup, mock) do
-      new_part = InputComponent.new(board: board, pin: 2, pullup: true)
+      InputComponent.new(board: board, pin: 2, pullup: true)
     end
   end
 end
diff --git a/test/components/ssd_test.rb b/test/components/ssd_test.rb
index 23b386a2..9f553fd5 100644
--- a/test/components/ssd_test.rb
+++ b/test/components/ssd_test.rb
@@ -3,7 +3,7 @@
 require 'minitest/autorun'
 
 class SSDTest < MiniTest::Test
- def board
+  def board
     @board ||= BoardMock.new
   end
 

From faa361a3ba474047e07fdd999864019ea2cb03b3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 6 Feb 2023 01:54:42 -0400
Subject: [PATCH 209/296] Start using simplecov and cleanup test helper

---
 .gitignore                                   |  2 ++
 dino.gemspec                                 |  5 +++--
 test/api/core_test.rb                        |  4 +---
 test/board_mock.rb                           |  8 -------
 test/board_test.rb                           |  4 +---
 test/components/basic/analog_input_test.rb   |  4 +---
 test/components/basic/analog_output_test.rb  |  4 +---
 test/components/basic/digital_input_test.rb  |  4 +---
 test/components/basic/digital_output_test.rb |  4 +---
 test/components/dht_test.rb                  |  4 +---
 test/components/ir_emitter_test.rb           |  4 +---
 test/components/lcd_test.rb                  |  4 +---
 test/components/led_test.rb                  |  4 +---
 test/components/mixins/callbacks_test.rb     |  4 +---
 test/components/mixins/listener_test.rb      |  4 +---
 test/components/mixins/poller_test.rb        |  4 +---
 test/components/mixins/reader_test.rb        |  4 +---
 test/components/mixins/threaded_test.rb      |  4 +---
 test/components/one_wire/ds18b20_test.rb     |  4 +---
 test/components/one_wire/enumerator_test.rb  |  4 +---
 test/components/one_wire/helper_test.rb      |  1 +
 test/components/one_wire/slave_test.rb       |  4 +---
 test/components/register/select_test.rb      |  4 +---
 test/components/register/shift_in_test.rb    |  4 +---
 test/components/register/shift_out_test.rb   |  4 +---
 test/components/rgb_led_test.rb              |  4 +---
 test/components/servo_test.rb                |  4 +---
 test/components/setup/base_test.rb           |  4 +---
 test/components/setup/input_test.rb          |  4 +---
 test/components/setup/multi_pin_test.rb      |  4 +---
 test/components/setup/output_test.rb         |  4 +---
 test/components/setup/single_pin_test.rb     |  4 +---
 test/components/software_serial_test.rb      |  4 +---
 test/components/ssd_test.rb                  |  4 +---
 test/components/stepper_test.rb              |  4 +---
 test/message_test.rb                         |  3 +--
 test/test_helper.rb                          | 22 ++++++++++++++++++++
 test/txrx/serial_test.rb                     |  3 ---
 test/txrx/tcp_test.rb                        |  3 ---
 test/txrx_mock.rb                            | 10 ---------
 40 files changed, 60 insertions(+), 121 deletions(-)
 delete mode 100644 test/board_mock.rb
 delete mode 100644 test/txrx_mock.rb

diff --git a/.gitignore b/.gitignore
index 973343b7..6519d022 100644
--- a/.gitignore
+++ b/.gitignore
@@ -20,3 +20,5 @@ test/tmp
 test/version_tmp
 tmp
 *DS_Store*
+.ruby-version
+.rvmrc
\ No newline at end of file
diff --git a/dino.gemspec b/dino.gemspec
index 4b0e967a..0a0b2d10 100644
--- a/dino.gemspec
+++ b/dino.gemspec
@@ -34,9 +34,10 @@ Gem::Specification.new do |gem|
   gem.version       = Dino::VERSION
   gem.executables   = ["dino"]
 
-  gem.add_dependency 'rubyserial', '~> 0.6.0'
-  gem.add_dependency 'bcd', '~> 0.3.0'
+  gem.add_dependency 'rubyserial'
+  gem.add_dependency 'bcd'
 
   gem.add_development_dependency 'rake'
   gem.add_development_dependency 'minitest'
+  gem.add_development_dependency 'simplecov'
 end
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
index b7213b2a..fa7a04a7 100644
--- a/test/api/core_test.rb
+++ b/test/api/core_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'txrx_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class APICoreTest < Minitest::Test
   def txrx
diff --git a/test/board_mock.rb b/test/board_mock.rb
deleted file mode 100644
index ce0ecb7b..00000000
--- a/test/board_mock.rb
+++ /dev/null
@@ -1,8 +0,0 @@
-require 'dino'
-require 'txrx_mock'
-
-class BoardMock < Dino::Board::Default
-  def initialize
-    super(TxRxMock.new)
-  end
-end
diff --git a/test/board_test.rb b/test/board_test.rb
index 4e964cfb..c83912c7 100644
--- a/test/board_test.rb
+++ b/test/board_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'txrx_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class BoardTest < Minitest::Test
   def txrx
diff --git a/test/components/basic/analog_input_test.rb b/test/components/basic/analog_input_test.rb
index e97bd9b6..48e469d0 100644
--- a/test/components/basic/analog_input_test.rb
+++ b/test/components/basic/analog_input_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class AnalogInputTest < Minitest::Test
   def board
diff --git a/test/components/basic/analog_output_test.rb b/test/components/basic/analog_output_test.rb
index e007988d..16eb63d3 100644
--- a/test/components/basic/analog_output_test.rb
+++ b/test/components/basic/analog_output_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class AnalogOutputTest < Minitest::Test
   def board
diff --git a/test/components/basic/digital_input_test.rb b/test/components/basic/digital_input_test.rb
index 22929dd4..e630e4cb 100644
--- a/test/components/basic/digital_input_test.rb
+++ b/test/components/basic/digital_input_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class DigitalInputTest < Minitest::Test
   def board
diff --git a/test/components/basic/digital_output_test.rb b/test/components/basic/digital_output_test.rb
index 64c69527..3b5d30b9 100644
--- a/test/components/basic/digital_output_test.rb
+++ b/test/components/basic/digital_output_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class DigitalOutputTest < Minitest::Test
   def board
diff --git a/test/components/dht_test.rb b/test/components/dht_test.rb
index 2da6b874..911638d3 100644
--- a/test/components/dht_test.rb
+++ b/test/components/dht_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class DHTTest < MiniTest::Test
   PIN = 1
diff --git a/test/components/ir_emitter_test.rb b/test/components/ir_emitter_test.rb
index 35e6e62d..70013155 100644
--- a/test/components/ir_emitter_test.rb
+++ b/test/components/ir_emitter_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class IREmitterTest < MiniTest::Test
   def board
diff --git a/test/components/lcd_test.rb b/test/components/lcd_test.rb
index 902571e2..892d2d81 100644
--- a/test/components/lcd_test.rb
+++ b/test/components/lcd_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class LCDTest < MiniTest::Test
   def board
diff --git a/test/components/led_test.rb b/test/components/led_test.rb
index 39bb328b..ba8c2ebf 100644
--- a/test/components/led_test.rb
+++ b/test/components/led_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class LedTest < MiniTest::Test
   def board
diff --git a/test/components/mixins/callbacks_test.rb b/test/components/mixins/callbacks_test.rb
index 734cbaa9..0d304eca 100644
--- a/test/components/mixins/callbacks_test.rb
+++ b/test/components/mixins/callbacks_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class CallbackComponent
   include Dino::Components::Setup::Base
diff --git a/test/components/mixins/listener_test.rb b/test/components/mixins/listener_test.rb
index 30b9a9c8..801bda2f 100644
--- a/test/components/mixins/listener_test.rb
+++ b/test/components/mixins/listener_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class ListenerComponent
   include Dino::Components::Setup::Base
diff --git a/test/components/mixins/poller_test.rb b/test/components/mixins/poller_test.rb
index 0972f390..b7ec82e6 100644
--- a/test/components/mixins/poller_test.rb
+++ b/test/components/mixins/poller_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class PollerComponent
   include Dino::Components::Setup::Base
diff --git a/test/components/mixins/reader_test.rb b/test/components/mixins/reader_test.rb
index 1ea84e0a..19dac6e5 100644
--- a/test/components/mixins/reader_test.rb
+++ b/test/components/mixins/reader_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class ReaderComponent
   include Dino::Components::Setup::Base
diff --git a/test/components/mixins/threaded_test.rb b/test/components/mixins/threaded_test.rb
index d12183df..a44b82ae 100644
--- a/test/components/mixins/threaded_test.rb
+++ b/test/components/mixins/threaded_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class ThreadedComponent
   include Dino::Components::Setup::Base
diff --git a/test/components/one_wire/ds18b20_test.rb b/test/components/one_wire/ds18b20_test.rb
index 768f7efe..8a6c1499 100644
--- a/test/components/one_wire/ds18b20_test.rb
+++ b/test/components/one_wire/ds18b20_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class DS18B20Test < MiniTest::Test
   def bus
diff --git a/test/components/one_wire/enumerator_test.rb b/test/components/one_wire/enumerator_test.rb
index c7e17429..04d69a86 100644
--- a/test/components/one_wire/enumerator_test.rb
+++ b/test/components/one_wire/enumerator_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 # State machine simulating a bus during address search. Initialize with n for
 # n devices with random (CRC-invalid) addresses. Call #reset before each search.
diff --git a/test/components/one_wire/helper_test.rb b/test/components/one_wire/helper_test.rb
index 1acf3f67..152fe234 100644
--- a/test/components/one_wire/helper_test.rb
+++ b/test/components/one_wire/helper_test.rb
@@ -1 +1,2 @@
+require 'test_helper'
 # Test crc check.
diff --git a/test/components/one_wire/slave_test.rb b/test/components/one_wire/slave_test.rb
index 3369b746..e8d49d96 100644
--- a/test/components/one_wire/slave_test.rb
+++ b/test/components/one_wire/slave_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 module Dino
   module Components
diff --git a/test/components/register/select_test.rb b/test/components/register/select_test.rb
index 955e9e6d..2ea99ea6 100644
--- a/test/components/register/select_test.rb
+++ b/test/components/register/select_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class RegisterSelectTest < Minitest::Test
   def board
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
index 1f60b16f..68618214 100644
--- a/test/components/register/shift_in_test.rb
+++ b/test/components/register/shift_in_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class RegisterShiftInTest < Minitest::Test
   def board
diff --git a/test/components/register/shift_out_test.rb b/test/components/register/shift_out_test.rb
index 711cc7c3..5ad79f5c 100644
--- a/test/components/register/shift_out_test.rb
+++ b/test/components/register/shift_out_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class RegisterShiftOutTest < Minitest::Test
   def board
diff --git a/test/components/rgb_led_test.rb b/test/components/rgb_led_test.rb
index a3d8c176..75443540 100644
--- a/test/components/rgb_led_test.rb
+++ b/test/components/rgb_led_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class RGBLedTest < MiniTest::Test
   def board
diff --git a/test/components/servo_test.rb b/test/components/servo_test.rb
index 24158b68..dd44098d 100644
--- a/test/components/servo_test.rb
+++ b/test/components/servo_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class ServoTest < MiniTest::Test
   def board
diff --git a/test/components/setup/base_test.rb b/test/components/setup/base_test.rb
index 4a7b3434..d16848c2 100644
--- a/test/components/setup/base_test.rb
+++ b/test/components/setup/base_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class BaseComponent
   include Dino::Components::Setup::Base
diff --git a/test/components/setup/input_test.rb b/test/components/setup/input_test.rb
index 49a767c5..d960c2b6 100644
--- a/test/components/setup/input_test.rb
+++ b/test/components/setup/input_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class InputComponent
   include Dino::Components::Setup::Input
diff --git a/test/components/setup/multi_pin_test.rb b/test/components/setup/multi_pin_test.rb
index 40bb6140..3c7b4bda 100644
--- a/test/components/setup/multi_pin_test.rb
+++ b/test/components/setup/multi_pin_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class MultiPinComponent
   include Dino::Components::Setup::MultiPin
diff --git a/test/components/setup/output_test.rb b/test/components/setup/output_test.rb
index 59c44c5d..8ac78e92 100644
--- a/test/components/setup/output_test.rb
+++ b/test/components/setup/output_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class OutputComponent
   include Dino::Components::Setup::Output
diff --git a/test/components/setup/single_pin_test.rb b/test/components/setup/single_pin_test.rb
index 9308d825..a46ecaa1 100644
--- a/test/components/setup/single_pin_test.rb
+++ b/test/components/setup/single_pin_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class SinglePinComponent
   include Dino::Components::Setup::Input
diff --git a/test/components/software_serial_test.rb b/test/components/software_serial_test.rb
index da07697d..9a66d086 100644
--- a/test/components/software_serial_test.rb
+++ b/test/components/software_serial_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class SoftwareSerialTest < MiniTest::Test
   def board
diff --git a/test/components/ssd_test.rb b/test/components/ssd_test.rb
index 9f553fd5..f8542316 100644
--- a/test/components/ssd_test.rb
+++ b/test/components/ssd_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class SSDTest < MiniTest::Test
   def board
diff --git a/test/components/stepper_test.rb b/test/components/stepper_test.rb
index 7e17c3f7..c12e6c9b 100644
--- a/test/components/stepper_test.rb
+++ b/test/components/stepper_test.rb
@@ -1,6 +1,4 @@
-require 'dino'
-require 'board_mock'
-require 'minitest/autorun'
+require 'test_helper'
 
 class StepperTest < MiniTest::Test
   def board
diff --git a/test/message_test.rb b/test/message_test.rb
index d56294da..c6559bb5 100644
--- a/test/message_test.rb
+++ b/test/message_test.rb
@@ -1,5 +1,4 @@
-require 'dino'
-require 'minitest/autorun'
+require 'test_helper'
 
 class MessageTest < Minitest::Test
   def test_require_a_command
diff --git a/test/test_helper.rb b/test/test_helper.rb
index b5b6a24b..58cc8b41 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -1,3 +1,9 @@
+require "minitest/autorun"
+require 'simplecov'
+SimpleCov.start do
+  add_filter "test"
+  track_files "lib/**/*.rb"
+end
 require 'dino'
 
 # Nice little helper module to redefine constants quietly.
@@ -27,3 +33,19 @@ def suppress_output
   end
   retval
 end
+
+class TxRxMock
+  def add_observer(board); true; end
+  def read; true; end
+  def write(str); true; end
+  def handshake
+    "528,1024,14,20"
+  end
+end
+
+class BoardMock < Dino::Board::Default
+  def initialize
+    super(TxRxMock.new)
+  end
+end
+
diff --git a/test/txrx/serial_test.rb b/test/txrx/serial_test.rb
index defadb80..16034a2d 100644
--- a/test/txrx/serial_test.rb
+++ b/test/txrx/serial_test.rb
@@ -1,6 +1,3 @@
-require 'dino'
-require 'minitest/autorun'
-require 'txrx_mock'
 require 'test_helper'
 
 class DummySerial
diff --git a/test/txrx/tcp_test.rb b/test/txrx/tcp_test.rb
index a10f4958..4d8c97a4 100644
--- a/test/txrx/tcp_test.rb
+++ b/test/txrx/tcp_test.rb
@@ -1,6 +1,3 @@
-require 'dino'
-require 'minitest/autorun'
-require 'txrx_mock'
 require 'test_helper'
 
 class DummySerial
diff --git a/test/txrx_mock.rb b/test/txrx_mock.rb
deleted file mode 100644
index 65d99435..00000000
--- a/test/txrx_mock.rb
+++ /dev/null
@@ -1,10 +0,0 @@
-require 'dino'
-
-class TxRxMock
-  def add_observer(board); true; end
-  def read; true; end
-  def write(str); true; end
-  def handshake
-    "528,1024,14,20"
-  end
-end

From b7fb1f59d092c287d94eb62caf71a0478e0cf1b7 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 6 Feb 2023 10:57:25 -0400
Subject: [PATCH 210/296] Tests for core and one wire api

---
 lib/dino/api/core.rb      | 19 ++++++++---
 test/api/core_test.rb     | 37 +++++++++++++++++++++
 test/api/one_wire_test.rb | 69 +++++++++++++++++++++++++++++++++++++++
 test/test_helper.rb       |  5 ++-
 4 files changed, 125 insertions(+), 5 deletions(-)
 create mode 100644 test/api/one_wire_test.rb

diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index 3980008a..f2c334ec 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -73,13 +73,24 @@ def stop_listener(pin)
       end
 
       def pulse_read(pin, options={})
-        reset       = options[:reset] || false
-        reset_time  = options[:reset_time] || 0
+        # Hold the input pin high or low (give as values) before reading
+        reset = options[:reset] || false
+        
+        # How long to reset the pin for in ms
+        reset_time = options[:reset_time] || 0
+        
+        # Maximum number of pulses to capture
         pulse_limit = options[:pulse_limit] || 100
-        timeout     = options[:timeout] || 200
+        
+        # A pulse of this length will end the read
+        timeout = options[:timeout] || 200
+        
+        raise ArgumentError("reset time must be betwen 0 and 65535 ms")if reset_time > 0xFFFF
+        raise ArgumentError("timeout must be betwen 0 and 65535 ms")if timeout > 0xFFFF
+        raise ArgumentError("pulse limit must be betwen 0 and 255")if pulse_limit > 0xFF
 
         settings = reset ? 1 : 0
-        settings = settings | 0b10 if reset == high
+        settings = settings | 0b10 if (reset && reset != low)
 
         aux = pack :uint16, [reset_time, timeout]
         aux << pack(:uint8, pulse_limit)
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
index fa7a04a7..1627bf1e 100644
--- a/test/api/core_test.rb
+++ b/test/api/core_test.rb
@@ -1,6 +1,8 @@
 require 'test_helper'
 
 class APICoreTest < Minitest::Test
+  include Dino::API::Helper
+  
   def txrx
     @txrx ||= TxRxMock.new
   end
@@ -133,4 +135,39 @@ def test_analog_resolution
     end
     mock.verify
   end
+  
+  def test_pulse_read
+    # Default settings
+    mock = MiniTest::Mock.new
+    aux = pack(:uint16, [0, 200]) << pack(:uint8, 100)
+    message = Dino::Message.encode command: 11, pin: 4, value: 0b00, aux_message: aux
+    
+    mock.expect :call, nil, [message]
+    board.stub(:write, mock) do
+      board.pulse_read(4)
+    end
+    mock.verify
+    
+    # Good options
+    mock = MiniTest::Mock.new
+    aux = pack(:uint16, [1000, 200]) << pack(:uint8, 160)
+    message1 = Dino::Message.encode command: 11, pin: 4, value: 0b01, aux_message: aux
+    message2 = Dino::Message.encode command: 11, pin: 4, value: 0b11, aux_message: aux
+    
+    mock.expect :call, nil, [message1]
+    mock.expect :call, nil, [message2]
+    board.stub(:write, mock) do
+      board.pulse_read(4, reset: board.low, reset_time: 1000, timeout: 200, pulse_limit: 160)
+      board.pulse_read(4, reset: board.high, reset_time: 1000, timeout: 200, pulse_limit: 160)
+    end
+    mock.verify
+    
+    # Bad options
+    assert_raises(ArgumentError) { board.one_wire_write(4, reset_time: 65536) }
+    assert_raises(ArgumentError) { board.one_wire_write(4, reset_time: -1) }
+    assert_raises(ArgumentError) { board.one_wire_write(4, timeout: 65536) }
+    assert_raises(ArgumentError) { board.one_wire_write(4, timeout: -1) }
+    assert_raises(ArgumentError) { board.one_wire_write(4, pulse_limit: 256) }
+    assert_raises(ArgumentError) { board.one_wire_write(4, pulse_limit: -1) }    
+  end
 end
diff --git a/test/api/one_wire_test.rb b/test/api/one_wire_test.rb
new file mode 100644
index 00000000..4fcb88ca
--- /dev/null
+++ b/test/api/one_wire_test.rb
@@ -0,0 +1,69 @@
+require 'test_helper'
+
+class APIOneWireTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+  
+  def test_one_wire_reset
+    board
+    message = Dino::Message.encode command: 41, pin: 1, value: 255
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [message]
+    txrx.stub(:write, mock) do
+      board.one_wire_reset(1, 255)
+    end
+    mock.verify
+  end
+  
+  def test_one_wire_search
+    board
+    message = Dino::Message.encode command: 42, pin: 1, aux_message: pack(:uint64, 128, max:8)
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [message]
+    txrx.stub(:write, mock) do
+      board.one_wire_search(1, 128)
+    end
+    mock.verify
+  end
+  
+  def test_one_wire_write
+    board
+    
+    # Calculate length and parasite power properly.
+    message1 = Dino::Message.encode command: 43, pin: 1, value: 0b10000000 | 3, aux_message: pack(:uint8, [1,2,3])
+    message2 = Dino::Message.encode command: 43, pin: 1, value: 4, aux_message: pack(:uint8, [1,2,3,4])
+    
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [message1]
+    mock.expect :call, nil, [message2]
+    txrx.stub(:write, mock) do
+      board.one_wire_write(1, true, [1,2,3])
+      board.one_wire_write(1, nil, [1,2,3,4])
+    end
+    mock.verify
+    
+    # Don't allow more than 127 bytes of data.
+    assert_raises(ArgumentError) do 
+      too_big = Array.new(128).map { 42 }
+      board.one_wire_write(1, true, too_big)
+    end
+  end
+  
+  def test_one_wire_read
+    board
+    message = Dino::Message.encode command: 44, pin: 1, value: 9
+        
+    mock = MiniTest::Mock.new.expect :call, nil, [message]
+    txrx.stub(:write, mock) do
+      board.one_wire_read(1, 9)
+    end
+    mock.verify
+  end
+end
diff --git a/test/test_helper.rb b/test/test_helper.rb
index 58cc8b41..d02cb904 100644
--- a/test/test_helper.rb
+++ b/test/test_helper.rb
@@ -1,9 +1,12 @@
 require "minitest/autorun"
+
 require 'simplecov'
 SimpleCov.start do
-  add_filter "test"
   track_files "lib/**/*.rb"
+  add_filter "test"
+  add_filter "lib/dino_cli"
 end
+
 require 'dino'
 
 # Nice little helper module to redefine constants quietly.

From 652c72671a0849146693a1088dfe0acad08ea92a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 7 Feb 2023 12:13:48 -0400
Subject: [PATCH 211/296] EEPROM API and binary packing tests

---
 lib/dino/api/core.rb    | 13 ++++++++++---
 lib/dino/api/eeprom.rb  |  2 +-
 lib/dino/api/helper.rb  |  2 +-
 test/api/core_test.rb   | 12 ++++++------
 test/api/eeprom_test.rb | 34 ++++++++++++++++++++++++++++++++++
 test/api/helper_test.rb | 38 ++++++++++++++++++++++++++++++++++++++
 6 files changed, 90 insertions(+), 11 deletions(-)
 create mode 100644 test/api/eeprom_test.rb
 create mode 100644 test/api/helper_test.rb

diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index f2c334ec..f79b359b 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -85,9 +85,16 @@ def pulse_read(pin, options={})
         # A pulse of this length will end the read
         timeout = options[:timeout] || 200
         
-        raise ArgumentError("reset time must be betwen 0 and 65535 ms")if reset_time > 0xFFFF
-        raise ArgumentError("timeout must be betwen 0 and 65535 ms")if timeout > 0xFFFF
-        raise ArgumentError("pulse limit must be betwen 0 and 255")if pulse_limit > 0xFF
+        # Validate
+        if reset_time < 0 || reset_time > 0xFFFF
+          raise ArgumentError, "reset time must be betwen 0 and 65535 ms"
+        end
+        if timeout < 0 || timeout > 0xFFFF
+          raise ArgumentError, "timeout must be betwen 0 and 65535 ms"
+        end
+        if pulse_limit < 0 || pulse_limit > 0xFF
+          raise ArgumentError, "pulse limit must be betwen 0 and 255"
+        end
 
         settings = reset ? 1 : 0
         settings = settings | 0b10 if (reset && reset != low)
diff --git a/lib/dino/api/eeprom.rb b/lib/dino/api/eeprom.rb
index 2b918220..0eb02f97 100644
--- a/lib/dino/api/eeprom.rb
+++ b/lib/dino/api/eeprom.rb
@@ -12,7 +12,7 @@ def eeprom_read(address, num_bytes)
       end
 
       # CMD = 7
-      def eeprom_write(address, bytes=[])
+      def eeprom_write(address, bytes)
         address = pack :uint16, address
         bytes  = pack :uint8, bytes, min: 1, max: 128
         write Message.encode command: 7,
diff --git a/lib/dino/api/helper.rb b/lib/dino/api/helper.rb
index 3692a8c9..6dc91178 100644
--- a/lib/dino/api/helper.rb
+++ b/lib/dino/api/helper.rb
@@ -8,7 +8,7 @@ def pack(type, data, options={})
                     when :uint32  then 'L<*'
                     when :uint16  then 'S<*'
                     when :uint8   then 'C*'
-                    else raise ArgumentError "unsupported pack format '#{type}'"
+                    else raise ArgumentError, "unsupported pack format '#{type}'"
                     end
 
         # Can pass a single integer to get packed if we always [] then flatten.
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
index 1627bf1e..5cdd33d4 100644
--- a/test/api/core_test.rb
+++ b/test/api/core_test.rb
@@ -163,11 +163,11 @@ def test_pulse_read
     mock.verify
     
     # Bad options
-    assert_raises(ArgumentError) { board.one_wire_write(4, reset_time: 65536) }
-    assert_raises(ArgumentError) { board.one_wire_write(4, reset_time: -1) }
-    assert_raises(ArgumentError) { board.one_wire_write(4, timeout: 65536) }
-    assert_raises(ArgumentError) { board.one_wire_write(4, timeout: -1) }
-    assert_raises(ArgumentError) { board.one_wire_write(4, pulse_limit: 256) }
-    assert_raises(ArgumentError) { board.one_wire_write(4, pulse_limit: -1) }    
+    assert_raises(ArgumentError) { board.pulse_read(4, reset_time: 65536) }
+    assert_raises(ArgumentError) { board.pulse_read(4, reset_time: -1) }
+    assert_raises(ArgumentError) { board.pulse_read(4, timeout: 65536) }
+    assert_raises(ArgumentError) { board.pulse_read(4, timeout: -1) }
+    assert_raises(ArgumentError) { board.pulse_read(4, pulse_limit: 256) }
+    assert_raises(ArgumentError) { board.pulse_read(4, pulse_limit: -1) }    
   end
 end
diff --git a/test/api/eeprom_test.rb b/test/api/eeprom_test.rb
new file mode 100644
index 00000000..0b63a9f8
--- /dev/null
+++ b/test/api/eeprom_test.rb
@@ -0,0 +1,34 @@
+require 'test_helper'
+
+class APIEEPROMTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+
+  def test_eeprom_read
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [(Dino::Message.encode command: 6, value: 16, aux_message: pack(:uint16, 15))]
+
+    board.stub(:write, mock) do
+      board.eeprom_read(15, 16)
+    end
+    mock.verify
+  end
+
+  def test_eeprom_write
+    data = (1..16).to_a
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [(Dino::Message.encode command: 7, value: data.length, aux_message: pack(:uint16, 15) + pack(:uint8, data))]
+
+    board.stub(:write, mock) do
+      board.eeprom_write(15, data)
+    end
+    mock.verify
+  end
+end
diff --git a/test/api/helper_test.rb b/test/api/helper_test.rb
new file mode 100644
index 00000000..eee9f35a
--- /dev/null
+++ b/test/api/helper_test.rb
@@ -0,0 +1,38 @@
+# encoding: ascii-8bit
+# For convenience when validating longer data types.
+
+require 'test_helper'
+
+class APIHelperTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def test_single_integers
+    assert_equal pack(:uint8, 25), "\x19"
+  end
+  
+  def test_other_formats
+    assert_equal pack(:uint16, 5*10**4),  "P\xC3"
+    assert_equal pack(:uint32, 4*10**9),  "\x00(k\xEE"
+    assert_equal pack(:uint64, 9*10**18), "\x00\x00\x84\xE2Pl\xE6|"
+  end
+  
+  def test_array
+    assert_equal pack(:uint8, [25,26]), "\x19\x1A"
+  end
+  
+  def test_padding
+    assert_equal pack(:uint8, 25, pad: 2), "\x19\x00"
+  end
+  
+  def test_min
+    assert_raises(ArgumentError) { pack(:uint8, 25, min: 2) }
+  end
+  
+  def test_max
+    assert_raises(ArgumentError) { pack(:uint8, [25,26,27], max: 2) }
+  end
+  
+  def test_invalid_formats
+    assert_raises(ArgumentError) { pack(:uint128, 25) }
+  end
+end

From 35a605f3a26edda6afac0be83a8c5c655f4b074b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 7 Feb 2023 14:38:41 -0400
Subject: [PATCH 212/296] API tests for I2C, IR emit, servo and tone

---
 examples/ir_emitter/ir_emitter.rb  |  2 +-
 lib/dino/api/infrared.rb           |  2 +-
 lib/dino/api/servo.rb              |  2 +-
 lib/dino/api/tone.rb               |  3 ++
 lib/dino/components/ir_emitter.rb  |  6 +--
 test/api/i2c_test.rb               | 76 ++++++++++++++++++++++++++++++
 test/api/infrared_test.rb          | 37 +++++++++++++++
 test/api/servo_test.rb             | 49 +++++++++++++++++++
 test/api/tone_test.rb              | 33 +++++++++++++
 test/components/ir_emitter_test.rb | 37 ++++++++++-----
 10 files changed, 228 insertions(+), 19 deletions(-)
 create mode 100644 test/api/i2c_test.rb
 create mode 100644 test/api/infrared_test.rb
 create mode 100644 test/api/servo_test.rb
 create mode 100644 test/api/tone_test.rb

diff --git a/examples/ir_emitter/ir_emitter.rb b/examples/ir_emitter/ir_emitter.rb
index 8a82f564..ed51e779 100644
--- a/examples/ir_emitter/ir_emitter.rb
+++ b/examples/ir_emitter/ir_emitter.rb
@@ -52,4 +52,4 @@
         560, 1690, 560, 560, 560, 560, 560, 560,
         560]
 
-ir.send(code)
+ir.emit(code)
diff --git a/lib/dino/api/infrared.rb b/lib/dino/api/infrared.rb
index bdaa0ff5..68fa112e 100644
--- a/lib/dino/api/infrared.rb
+++ b/lib/dino/api/infrared.rb
@@ -3,7 +3,7 @@ module API
     module Infrared
       include Helper
 
-      def infrared_send(pin, frequency, pulses)
+      def infrared_emit(pin, frequency, pulses)
         # Need to start using length - 1, but doesn't work on board yet.
         # 0 = 1 pulse, 255 = 256 pulses.
         length = pack :uint8,  pulses.length,  max: 1
diff --git a/lib/dino/api/servo.rb b/lib/dino/api/servo.rb
index 487c4185..d3726384 100644
--- a/lib/dino/api/servo.rb
+++ b/lib/dino/api/servo.rb
@@ -11,7 +11,7 @@ def servo_toggle(pin, value=:off, options={})
         write Message.encode command: 8,
                              pin: convert_pin(pin),
                              value: (value == :off) ? 0 : 1,
-                             aux: aux
+                             aux_message: aux
       end
 
       def servo_write(pin, value=0)
diff --git a/lib/dino/api/tone.rb b/lib/dino/api/tone.rb
index 4b59bd42..9f4a7170 100644
--- a/lib/dino/api/tone.rb
+++ b/lib/dino/api/tone.rb
@@ -3,6 +3,9 @@ module API
     module Tone
       include Helper
 
+      # value = tone frequency in Hz (should be sent as binary to allow higher than 9999, and limit to above 30Hz)
+      # duration = tone duration in ms
+      # duration currently sent as string. Should be binary and max limited to uint32
       def tone(pin, value, duration)
         write Dino::Message.encode command: 17,
                                    pin: convert_pin(pin),
diff --git a/lib/dino/components/ir_emitter.rb b/lib/dino/components/ir_emitter.rb
index 687c3d17..15428f99 100644
--- a/lib/dino/components/ir_emitter.rb
+++ b/lib/dino/components/ir_emitter.rb
@@ -1,7 +1,7 @@
 module Dino
   module Components
     class IREmitter < Basic::DigitalOutput
-      def send(pulses=[], options={})
+      def emit(pulses=[], options={})
         if pulses.length > 256 || pulses.length < 1
           raise ArgumentError, 'wrong number of IR pulses (expected 1 to 256)'
         end
@@ -9,11 +9,11 @@ def send(pulses=[], options={})
         pulses.each_with_index do |pulse, index|
           raise ArgumentError, 'non Numeric data in IR signal' unless pulse.is_a? Numeric
           pulses[index] = pulse.round unless pulse.is_a? Integer
-          raise ArgumentError 'pulse too long (max 65536 microsec)' if pulse > 65536
+          raise ArgumentError, 'pulse too long (max 65535 ms)' if pulse > 65535
         end
 
         frequency = options[:frequency] || 38
-        board.infrared_send(pin, frequency, pulses)
+        board.infrared_emit(pin, frequency, pulses)
       end
     end
   end
diff --git a/test/api/i2c_test.rb b/test/api/i2c_test.rb
new file mode 100644
index 00000000..1aa84eb4
--- /dev/null
+++ b/test/api/i2c_test.rb
@@ -0,0 +1,76 @@
+require 'test_helper'
+
+class APII2CTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+  
+  def test_search
+    board
+    message = Dino::Message.encode command: 33
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [message]
+    txrx.stub(:write, mock) do
+      board.i2c_search
+    end
+    mock.verify
+  end
+
+  def test_write
+    board
+    aux = pack :uint8, [0x30, 0, 4, [1,2,3,4]]
+    # Normal
+    message1 = Dino::Message.encode command: 34, value: 0b00, aux_message: aux
+    # Repeated start
+    message2 = Dino::Message.encode command: 34, value: 0b01, aux_message: aux
+
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [message1]
+    mock.expect :call, nil, [message2]
+    
+    txrx.stub(:write, mock) do
+      board.i2c_write(0x30, [1,2,3,4])
+      board.i2c_write(0x30, [1,2,3,4], repeated_start: true)
+    end
+    mock.verify
+  end
+  
+  def test_read
+    board
+    aux = pack :uint8, [0x30, 0, 0x03, 4]
+    # Normal
+    message1 = Dino::Message.encode command: 35, value: 0b10, aux_message: aux
+    # Repeated start
+    message2 = Dino::Message.encode command: 35, value: 0b11, aux_message: aux
+
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [message1]
+    mock.expect :call, nil, [message2]
+    
+    txrx.stub(:write, mock) do
+      board.i2c_read(0x30, 0x03, 4)
+      board.i2c_read(0x30, 0x03, 4, repeated_start: true)
+    end
+    mock.verify
+  end
+  
+  def test_read_without_register
+    board
+    aux = pack :uint8, [0x30, 0, 0, 4]
+    message = Dino::Message.encode command: 35, value: 0b00, aux_message: aux
+
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [message]
+    
+    txrx.stub(:write, mock) do
+      board.i2c_read(0x30, nil, 4)
+    end
+    mock.verify
+  end
+end
diff --git a/test/api/infrared_test.rb b/test/api/infrared_test.rb
new file mode 100644
index 00000000..2493cdfa
--- /dev/null
+++ b/test/api/infrared_test.rb
@@ -0,0 +1,37 @@
+require 'test_helper'
+
+class APIInfraredTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+  
+  def test_infrared_emit
+    board
+    aux = pack(:uint8, 4) + pack(:uint16, [255,0,255,0])
+    message = Dino::Message.encode command: 16, pin: 8, value: 38, aux_message: aux
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [message]
+    txrx.stub(:write, mock) do
+      board.infrared_emit 8, 38, [255,0,255,0]
+    end
+    mock.verify
+  end
+  
+  def test_minimum_pulses
+    assert_raises(ArgumentError) do
+      board.infrared_emit 8, 38, []
+    end
+  end
+  
+  def test_maximum_pulses
+    assert_raises(ArgumentError) do 
+      board.infrared_emit 8, 38, Array.new(513) { 128 }
+    end
+  end
+end
diff --git a/test/api/servo_test.rb b/test/api/servo_test.rb
new file mode 100644
index 00000000..76f1b6e7
--- /dev/null
+++ b/test/api/servo_test.rb
@@ -0,0 +1,49 @@
+# For convenience when validating longer data types.
+
+require 'test_helper'
+
+class APIServoTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+
+  def test_on_off
+    mock = MiniTest::Mock.new
+    aux = pack :uint16, [544, 2400]
+    mock.expect :call, nil, [Dino::Message.encode(command: 8, pin: 9, value: 1, aux_message: aux)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 8, pin: 9, value: 0, aux_message: aux)]
+
+    board.stub(:write, mock) do
+      board.servo_toggle(9, :on)
+      board.servo_toggle(9)
+    end
+    mock.verify
+  end
+
+  def test_min_max
+    mock = MiniTest::Mock.new
+    aux = pack :uint16, [360, 2100]
+    mock.expect :call, nil, [Dino::Message.encode(command: 8, pin: 9, value: 1, aux_message: aux)]
+
+    board.stub(:write, mock) do
+      board.servo_toggle(9, :on, min: 360, max: 2100)
+    end
+    mock.verify
+  end
+  
+  def test_write
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 9, pin: 9, aux_message: pack(:uint16, 180))]
+
+    board.stub(:write, mock) do
+      board.servo_write(9, 180)
+    end
+    mock.verify
+  end
+end
diff --git a/test/api/tone_test.rb b/test/api/tone_test.rb
new file mode 100644
index 00000000..e5d160fb
--- /dev/null
+++ b/test/api/tone_test.rb
@@ -0,0 +1,33 @@
+require 'test_helper'
+
+class APIToneTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+
+  def test_tone
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 17, pin: 10, value: 150, aux_message: 2000)]
+
+    board.stub(:write, mock) do
+      board.tone(10, 150, 2000)
+    end
+    mock.verify
+  end
+
+  def test_no_tone
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 18, pin: 10)]
+
+    board.stub(:write, mock) do
+      board.no_tone(10)
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/ir_emitter_test.rb b/test/components/ir_emitter_test.rb
index 70013155..ee91a4bc 100644
--- a/test/components/ir_emitter_test.rb
+++ b/test/components/ir_emitter_test.rb
@@ -8,20 +8,31 @@ def board
   def part
     @part ||= Dino::Components::IREmitter.new(board: board, pin:1)
   end
-
-  # These are really API tests.
-  # Should move these and test that API methods get called here instead.
-  def test_packs_pulses_correctly
-    part
-    string = "16.1.38.#{[4].pack('C')}#{[100,200,300,400].pack('S<*')}\n"
-    mock = MiniTest::Mock.new.expect(:call, nil, [string])
-    board.stub(:write, mock) { part.send [100,200,300,400] }
+  
+  def test_pulse_count_validation
+    assert_raises(ArgumentError) do
+      part.emit Array.new(257) { 0 }
+    end
   end
-
-  def test_accepts_modulation_frequency_as_option
+  
+  def test_numeric_validation
+    assert_raises(ArgumentError) do
+      part.emit ["a", "b", "c"]
+    end
+  end
+  
+  def test_pulse_length_validation
+    assert_raises(ArgumentError) do
+      part.emit [65536]
+    end
+  end
+  
+  def test_emits
     part
-    string = "16.1.40.#{[4].pack('C')}#{[100,200,300,400].pack('S<*')}\n"
-    mock = MiniTest::Mock.new.expect(:call, nil, [string])
-    board.stub(:write, mock) { part.send [100,200,300,400], frequency: 40 }
+    mock = MiniTest::Mock.new.expect(:call, nil, [1, 38, [127,0]])
+    board.stub(:infrared_emit, mock) do
+      part.emit([127,0])
+    end
+    mock.verify
   end
 end

From 60b4fb0e360441f4c7498431fd06c7a4e764b29b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 7 Feb 2023 18:35:35 -0400
Subject: [PATCH 213/296] SPI testing and cleanup

---
 lib/dino/api/spi.rb  | 57 +++++++++++++++++++++----------
 src/lib/DinoSPI.cpp  | 26 +++++++-------
 test/api/spi_test.rb | 80 ++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 134 insertions(+), 29 deletions(-)
 create mode 100644 test/api/spi_test.rb

diff --git a/lib/dino/api/spi.rb b/lib/dino/api/spi.rb
index b023c0d8..40449a04 100644
--- a/lib/dino/api/spi.rb
+++ b/lib/dino/api/spi.rb
@@ -4,28 +4,50 @@ module SPI
       include Helper
 
       def spi_header(options)
+        options[:read]       ||= 0
+        options[:write]        = [options[:write]].flatten.compact || []
         options[:mode]       ||= 0
         options[:frequency]  ||= 3000000
-        options[:bit_order]  ||= :lsbfirst
-        raise ArgumentError,
-              'invalid SPI mode' unless (0..3).include? options[:mode]
-
-        # Flag unused high bit of mode if we need to transfer MSBFIRST.
-        settings = options[:mode]
-        settings = settings | 0b10000000 if options[:bit_order] == :msbfirst
-
+        options[:bit_order]  ||= :msbfrst
+                  
+        # Bit 0..3 of settings control the SPI mode
+        #
+        # 0000 = SPI_MODE0
+        # 0100 = SPI_MODE1
+        # 1000 = SPI_MODE2
+        # 1100 = SPI_MODE3
+        #
+        settings = case options[:mode]
+        when 0
+          0b0000
+        when 1
+          0b0100
+        when 2
+          0b1000
+        when 3
+          0b1100
+        else
+          raise ArgumentError, "invalid SPI mode. Must be 0, 1, 2, or 3"
+        end
+        
+        # Bit 7 of settings toggles MSBFIRST (1) or LSBFIRST (0) transmission order.
+        settings = settings | 0b10000000 unless options[:bit_order] == :lsbfirst
+        
+        raise ArgumentError, "can't read more than 255 SPI bytes at a time" if options[:read] > 255
+        raise ArgumentError, "can't write more than 255 SPI bytes at a time" if options[:write].length > 255
+        
         uint8 = pack(:uint8, [settings, options[:read], options[:write].length])
-        uint8 + pack(:uint32, options[:frequency])
+        [uint8 + pack(:uint32, options[:frequency]), options]
       end
 
       # CMD = 26
       def spi_transfer(pin, options={})
-        options[:read] ||= 0
-        options[:write] = [options[:write]].flatten.compact || []
-
-        return if (options[:read] == 0) && (options[:write].empty?)
-
-        header = spi_header(options)
+        header, options = spi_header(options)
+        
+        if (options[:read] == 0) && (options[:write].empty?)
+          raise ArgumentError, "no SPI bytes to read or write given"
+        end
+        
         write Message.encode command: 26,
                              pin: pin,
                              aux_message: header + pack(:uint8, options[:write])
@@ -33,9 +55,10 @@ def spi_transfer(pin, options={})
 
       # CMD = 27
       def spi_listen(pin, options={})
+        header, options = spi_header(options)
+        
         raise ArgumentError, 'no SPI bytes to read' unless (options[:read] > 0)
-
-        header = spi_header(options)
+        
         write Message.encode command: 27,
                              pin: pin,
                              aux_message: header
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 992fd9a2..5dafe09e 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -21,15 +21,13 @@ SpiListener spiListeners[SPI_LISTENER_COUNT];
 void Dino::spiBegin(byte settings, uint32_t clockRate){
   SPI.begin();
 
-  bool msbfirst = bitRead(settings, 7);
+  // SPI mode is the lowest 4 bits of settings.
   byte mode = settings;
-  bitClear(mode, 7);
+  mode << 4;
+  mode >> 4;
 
-  if (msbfirst) {
-    SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, mode));
-  } else {
-    SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, mode));
-  }
+  // Bit 7 of settings toggles MSBFIRST.
+  SPI.beginTransaction(SPISettings(clockRate, bitRead(settings, 7), mode));
 }
 
 // Convenience wrapper for SPI.end
@@ -48,16 +46,20 @@ void Dino::spiEnd(){
 // Request format for SPI 2-way transfers
 // pin         = slave select pin (int)
 // val         = empty
-// auxMsg[0]   = SPI settings. 2 LSB = SPI mode. Bit 7 = MSB(1) or LSB(0).
-// auxMsg[1]   = write length (number of bytes)
-// auxMsg[2]   = read length  (number of bytes)
+// auxMsg[0]   = SPI settings
+//   Bit 0..3  = SPI mode
+//   Bit 7     = MSBFIRST(1) or LSBFIRST(0)
+// auxMsg[1]   = read length  (number of bytes)
+// auxMsg[2]   = write length (number of bytes)
 // auxMsg[3-6] = clock frequency (uint32_t as 4 bytes)
-//
 // auxMsg[7+]  = data (bytes) (write only)
 //
 void Dino::spiTransfer(int selectPin, byte settings, byte rLength, byte wLength, uint32_t clockRate, byte *data) {
-  spiBegin(settings, clockRate);
+  // Pull select pin low.
+  pinMode(selectPin, OUTPUT);
   digitalWrite(selectPin, LOW);
+  
+  spiBegin(settings, clockRate);
 
   if (rLength > 0) {
     // Stream read bytes as if coming from select pin for easy identification.
diff --git a/test/api/spi_test.rb b/test/api/spi_test.rb
new file mode 100644
index 00000000..af824f7e
--- /dev/null
+++ b/test/api/spi_test.rb
@@ -0,0 +1,80 @@
+# For convenience when validating longer data types.
+
+require 'test_helper'
+
+class APISPITest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+  
+  def test_spi_modes
+    assert_equal (board.spi_header(mode: nil)[0][0]), (pack :uint8, 0b10000000)
+    assert_equal (board.spi_header(mode: 1  )[0][0]), (pack :uint8, 0b10000100)
+    assert_equal (board.spi_header(mode: 2  )[0][0]), (pack :uint8, 0b10001000)
+    assert_equal (board.spi_header(mode: 3  )[0][0]), (pack :uint8, 0b10001100)
+    assert_raises(ArgumentError) { board.spi_header(mode: 4) }
+  end
+  
+  def test_spi_lsbfirst
+    assert_equal (board.spi_header(bit_order: :lsbfirst)[0][0]), (pack :uint8, 0b00000000)
+  end
+
+  def test_spi_frequency
+    assert_equal (board.spi_header(frequency: nil    )[0][3..6]), (pack :uint32, 3000000)
+    assert_equal (board.spi_header(frequency: 8000000)[0][3..6]), (pack :uint32, 8000000)
+  end
+  
+  def test_spi_too_many_bytes
+    assert_raises(ArgumentError) { board.spi_header(read: 256) }
+    assert_raises(ArgumentError) { board.spi_header(write: Array.new(256){0})}
+  end
+  
+  def test_spi_no_bytes
+    assert_raises(ArgumentError) { board.spi_transfer(3, read: 0) }
+    assert_raises(ArgumentError) { board.spi_listen(3, read: 0) }
+  end
+  
+  def test_spi_transfer
+    board
+    options = { write: [1,2,3,4], read: 4, bit_order: :lsbfirst, frequency: 8000000, mode: 2 }
+    header = board.spi_header(options)[0]
+    aux = header + pack(:uint8, options[:write])
+    
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 26, pin: 3, aux_message: aux)]
+    
+    board.stub(:write, mock) do
+      board.spi_transfer(3, options)
+    end
+    mock.verify
+  end
+  
+  def test_spi_listen
+    board
+    options = { read: 8, bit_order: :lsbfirst }
+    header = board.spi_header(options)[0]
+    
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 27, pin: 3, aux_message: header)]
+    
+    board.stub(:write, mock) do
+      board.spi_listen(3, options)
+    end
+    mock.verify
+  end
+  
+  def test_spi_stop
+    board
+    mock = MiniTest::Mock.new.expect :call, nil, [Dino::Message.encode(command: 28, pin: 3)]
+    board.stub(:write, mock) do
+      board.spi_stop(3)
+    end
+    mock.verify
+  end
+end

From 8560b463552958cd0727c1e9c2de3649075cfdf5 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 7 Feb 2023 19:53:44 -0400
Subject: [PATCH 214/296] Simplify EEPROM updating from board and board tests

---
 lib/dino/board/base.rb    | 17 +++-----------
 lib/dino/board/default.rb |  1 +
 lib/dino/board/esp8266.rb |  1 +
 test/board_test.rb        | 47 ++++++++++++++++++++++++++-------------
 4 files changed, 37 insertions(+), 29 deletions(-)

diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index 82bde344..9c4531cc 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -42,25 +42,14 @@ def write(msg)
       end
 
       def update(line)
-        case line
-        when /\AEE:/
-          update_eeprom(line)
-        else
-          update_component(line)
-        end
-      end
-
-      def update_eeprom(line)
-        message = line.split(":", 2)[1]
-        @components.each do |part|
-          part.update(message) if part.pin == "EE"
-        end
+        update_component(line)
       end
 
       def update_component(line)
         pin, message = line.split(":", 2)
+        pin = pin.to_i unless pin == "EE"
         @components.each do |part|
-          part.update(message) if pin.to_i == convert_pin(part.pin)
+          part.update(message) if pin == convert_pin(part.pin)
         end
       end
 
diff --git a/lib/dino/board/default.rb b/lib/dino/board/default.rb
index 57d19b91..c7358539 100644
--- a/lib/dino/board/default.rb
+++ b/lib/dino/board/default.rb
@@ -18,6 +18,7 @@ def convert_pin(pin)
         return pin.to_i             if pin.match(DIGITAL_REGEX)
         return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
         return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
+        return "EE"                 if pin == "EE"
         raise ArgumentError, "incorrect pin format"
       end
 
diff --git a/lib/dino/board/esp8266.rb b/lib/dino/board/esp8266.rb
index 7ebca523..cbd28e5c 100644
--- a/lib/dino/board/esp8266.rb
+++ b/lib/dino/board/esp8266.rb
@@ -34,6 +34,7 @@ def convert_pin(pin)
         return gpio_pin_to_i(pin)    if pin.match(GPIO_REGEX)
         return analog_pin_to_i(pin)  if pin.match(ANALOG_REGEX)
         return digital_pin_to_i(pin) if pin.match(DIGITAL_REGEX)
+        return "EE"                  if pin == "EE"
         raise ArgumentError, "incorrect pin format"
       end
 
diff --git a/test/board_test.rb b/test/board_test.rb
index c83912c7..49470bb9 100644
--- a/test/board_test.rb
+++ b/test/board_test.rb
@@ -23,7 +23,7 @@ def test_starts_observing_txrx
   end
 
   def test_calls_handshake_on_txrx
-    mock = MiniTest::Mock.new.expect(:call, "actual ack value in txrx_mock.rb")
+    mock = MiniTest::Mock.new.expect(:call, "528,1024,14,20")
     txrx.stub(:handshake, mock) do
       Dino::Board.new(txrx)
     end
@@ -42,11 +42,25 @@ def test_set_dac_and_analog_zero
     assert_equal 20, board.dac_zero
     assert_equal 14, board.analog_zero
   end
-
-  def test_set_low_high_analog_high
+  
+  def test_set_low_high
     assert_equal 0, board.low
     assert_equal 1, board.high
+  end
+  
+  def test_analog_resolution
     assert_equal 255, board.analog_high
+    assert_equal 8,   board.analog_resolution
+    
+    mock = MiniTest::Mock.new.expect(:call, nil, [Dino::Message.encode(command:96, value:10)])
+    board.stub(:write, mock) do
+      board.analog_resolution = 10
+    end
+    mock.verify
+    
+    assert_equal 10,   board.analog_resolution
+    assert_equal 0,    board.low
+    assert_equal 1023, board.analog_high
   end
 
   def test_add_remove_component
@@ -69,19 +83,29 @@ def test_write
     mock.verify
   end
 
-  def test_update_passes_messages_to_components
+  def test_update_passes_messages_to_correct_components
     mock1 = MiniTest::Mock.new.expect(:update, nil, ["data"])
-    3.times { mock1.expect(:pin, 1) }
-    # This tests that lines are not split after the first colon delimiter.
+    4.times { mock1.expect(:pin, 1) }
+    
+    # Make sure lines are split only on the first colon.
+    # Tests for string based pine names too.
     mock2 = MiniTest::Mock.new.expect(:update, nil, ["with:colon"])
-    3.times { mock2.expect(:pin, 2) }
+    4.times { mock2.expect(:pin, 'A0') }
+    
+    # Special EEPROM mock.
+    mock3 = MiniTest::Mock.new.expect(:update, nil, ["bytes"])
+    4.times { mock3.expect(:pin, 'EE') }
+     
     board.add_component(mock1)
     board.add_component(mock2)
+    board.add_component(mock3)
     board.update("1:data")
-    board.update("2:with:colon")
+    board.update("14:with:colon")
     board.update("3:ignore")
+    board.update("EE:bytes")
     mock1.verify
     mock2.verify
+    mock3.verify
   end
 
   def test_convert_pin
@@ -106,11 +130,4 @@ def test_incorrect_pin_formats
     board.instance_variable_set(:@dac_zero, nil)
     assert_raises(ArgumentError) { board.convert_pin('DAC1') }
   end
-
-  def test_analog_resolution
-    board.analog_resolution = 10
-    assert_equal 0,    board.low
-    assert_equal 1023, board.analog_high
-    assert_equal 10,   board.analog_resolution
-  end
 end

From 9fffa9bab666b9c72d1c0acc28700870b5c3cc62 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 8 Feb 2023 02:54:15 -0400
Subject: [PATCH 215/296] Fixes to multipin proxy building and register state
 management. Base component initializes with nil state.

---
 lib/dino/components/lcd.rb                 |  2 +-
 lib/dino/components/register/output.rb     | 22 ++++++++-----
 lib/dino/components/register/shift_in.rb   |  4 +++
 lib/dino/components/register/shift_out.rb  |  4 +++
 lib/dino/components/setup/base.rb          |  1 +
 lib/dino/components/setup/multi_pin.rb     | 38 ++++++++++++++--------
 lib/dino/components/softserial.rb          |  2 +-
 lib/dino/components/ssd.rb                 |  2 +-
 lib/dino/tx_rx/base.rb                     |  2 +-
 test/components/register/shift_in_test.rb  |  4 +++
 test/components/register/shift_out_test.rb |  4 +++
 test/components/setup/base_test.rb         |  4 +++
 test/components/setup/multi_pin_test.rb    |  7 +++-
 13 files changed, 69 insertions(+), 27 deletions(-)

diff --git a/lib/dino/components/lcd.rb b/lib/dino/components/lcd.rb
index 81778671..128c937a 100644
--- a/lib/dino/components/lcd.rb
+++ b/lib/dino/components/lcd.rb
@@ -22,7 +22,7 @@ class LCD
       #       rows: 2
       # )
       #
-      def after_initialize(options)
+      def after_initialize(options={})
         board.write Dino::Message.encode command: 10, value: 0, aux_message: encoded_pins
         @cols, @rows = options[:cols], options[:rows]
         board.write Dino::Message.encode command: 10, value: 1, aux_message: "#{@cols},#{@rows}"
diff --git a/lib/dino/components/register/output.rb b/lib/dino/components/register/output.rb
index 16f9bc96..64ca7adf 100644
--- a/lib/dino/components/register/output.rb
+++ b/lib/dino/components/register/output.rb
@@ -17,7 +17,7 @@ def after_initialize(options={})
           # When used as a board proxy, store the state of each register
           # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
           #
-          @state = Array.new(@bytes*8) {|i| 0}
+          @state = Array.new(@bytes*8) { 0 }
           write_state
 
           #
@@ -39,9 +39,12 @@ def write
         #
         include Mixins::BoardProxy
         def digital_write(pin, value)
-          # puts @state.inspect
-          @state[pin] = value
-          delayed_write(@state)
+          state[pin] = value
+          delayed_write(state)
+        end
+        
+        def digital_read(pin)
+          state[pin]
         end
 
         #
@@ -49,10 +52,11 @@ def digital_write(pin, value)
         # Lets us catch multiple changed bits, like when hosting an SSD.
         #
         include Mixins::Threaded
-        def delayed_write(state)
+        def delayed_write(old_state)
           threaded do
             sleep @write_delay
-            write_state if (state == @state)
+            # Keep delaying if state has changed.
+            write_state if (old_state == state)
           end
         end
 
@@ -61,8 +65,10 @@ def delayed_write(state)
         #
         def write_state
           bytes = []
-          @state.each_slice(8) do |slice|
-            bytes << slice.join("").to_i(2)
+          state.each_slice(8) do |slice|
+            # Convert nil to 0 to ensure bit order is consistent.
+            zeroed = slice.map { |bit| bit.to_i }.join.to_i(2)
+            bytes << zeroed
           end
           write(bytes)
         end
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index deec557d..84420bb7 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -20,6 +20,10 @@ def after_initialize(options={})
           self.rising_clock = options[:rising_clock]
           bubble_callbacks
         end
+        
+        def pin
+          latch.pin
+        end
 
         #
         # Some registers use rising edges for clock signals. Unless we pull clock
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index b3de0fc4..fd545c89 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -18,6 +18,10 @@ class ShiftOut
         def write(*bytes)
           board.shift_write(latch.pin, data.pin, clock.pin, bytes)
         end
+        
+        def pin
+          latch.pin
+        end
       end
     end
   end
diff --git a/lib/dino/components/setup/base.rb b/lib/dino/components/setup/base.rb
index 802ef181..09f51df0 100644
--- a/lib/dino/components/setup/base.rb
+++ b/lib/dino/components/setup/base.rb
@@ -9,6 +9,7 @@ def state
         end
 
         def initialize(options={})
+          @state = nil
           @state_mutex = Mutex.new
           initialize_board(options)
           initialize_pins(options)
diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
index 9cf1c440..301c65b5 100644
--- a/lib/dino/components/setup/multi_pin.rb
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -57,13 +57,9 @@ def require_pins(*args)
           # '::proxy_pins' in the class definition. See RgbLed class for examples.
           #
           def proxy_pins(options={})
-            if options[:optional]
-              options.reject! { |k| k == :optional }
-            else
-              options.reject! { |k| k == :optional } if (options[:optional] == false)
-              require_pins(*options.keys)
-            end
-
+            require_pins(*options.keys) unless options[:optional]
+            options.reject! { |k| k == :optional }
+            
             proxied_pins = self.class_eval('@@proxied_pins') rescue {}
             proxied_pins.merge!(options)
             self.class_variable_set(:@@proxied_pins, proxied_pins)
@@ -82,17 +78,31 @@ def initialize_pins(options={})
         def validate_pins
           required_pins = self.class.class_eval('@@required_pins') rescue []
           required_pins.each do |key|
-            raise ArgumentError, 'missing pins[:#{key}] pin' unless pins[key]
+            raise ArgumentError, "missing pins[:#{key}] pin" unless pins[key]
           end
         end
 
         def build_proxies
-          proxied_pins = self.class.class_eval('@@proxied_pins') rescue {}
-          proxied_pins.each_pair do |key, klass|
-            component = klass.new(board: board, pin: pins[key], pullup: pullups[key]) rescue nil
-            self.proxies[key] = component
-            instance_variable_set("@#{key}", component)
-            singleton_class.class_eval { attr_reader key }
+          proxy_classes = self.class.class_eval('@@proxied_pins') rescue {}
+
+          # Build proxies for named pins once a pin number was given.
+          pins.each_pair do |pin_name, pin_number|
+            if proxy_classes[pin_name]
+              component = proxy_classes[pin_name].new(board: board, pin: pin_number, pullup: pullups[pin_name])
+              self.proxies[pin_name] = component
+              instance_variable_set("@#{pin_name}", component)
+              singleton_class.class_eval { attr_reader pin_name }
+            else
+              # Fail silently when given pins that don't map to a proxy class
+              # Components can use pins without setting up a subcomponent
+            end
+          end
+
+          # attr_reader nil for optional pins when not given.
+          proxy_classes.each_key do |pin_name|
+            unless self.proxies[pin_name]
+              singleton_class.class_eval { attr_reader pin_name }
+            end
           end
         end
       end
diff --git a/lib/dino/components/softserial.rb b/lib/dino/components/softserial.rb
index 1dd2db38..71aed3af 100644
--- a/lib/dino/components/softserial.rb
+++ b/lib/dino/components/softserial.rb
@@ -13,7 +13,7 @@ class SoftwareSerial
       #       baud: 9600
       # )
       #
-      def after_initialize(options)
+      def after_initialize(options={})
         self.baud = options[:baud]
         board.write Dino::Message.encode command: COMMAND, value: 0, aux_message: encoded_pins
         board.write Dino::Message.encode command: COMMAND, value: 1, aux_message: self.baud
diff --git a/lib/dino/components/ssd.rb b/lib/dino/components/ssd.rb
index c363cd21..df24d7ab 100644
--- a/lib/dino/components/ssd.rb
+++ b/lib/dino/components/ssd.rb
@@ -17,7 +17,7 @@ class SSD
 
       # ssd = SevenSegmentDisplay.new(
       #   board: board,
-      #   pins:  {anode: 11, a: 12, b: 13, c: 3,d: 4,e: 5,f: 10,g: 9}
+      #   pins:  {anode: 11, a: 12, b: 13, c: 3,d: 4, e: 5, f: 10, g: 9}
       # )
       def after_initialize(options={})
         @segments = [a,b,c,d,e,f,g]
diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 1b861ba7..58252930 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -31,7 +31,7 @@ def io_reset
       def flush_read
         Timeout.timeout(5) { read until read == nil }
       rescue Timeout::Error
-        raise RxFlushTimeout "Cannot read from device, or device not running dino"
+        raise RxFlushTimeout, "Cannot read from device, or device not running dino"
       end
 
       def start_read
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
index 68618214..8a83fa3e 100644
--- a/test/components/register/shift_in_test.rb
+++ b/test/components/register/shift_in_test.rb
@@ -18,6 +18,10 @@ def test_proxies
     assert_equal Dino::Components::Basic::DigitalInput,  part.data.class
     assert_equal Dino::Components::Register::Select,     part.latch.class
   end
+  
+  def test_identifies_with_latch_pin
+    assert_equal 8, part.pin
+  end
 
   def test_byte_length
     new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
diff --git a/test/components/register/shift_out_test.rb b/test/components/register/shift_out_test.rb
index 5ad79f5c..35969007 100644
--- a/test/components/register/shift_out_test.rb
+++ b/test/components/register/shift_out_test.rb
@@ -18,6 +18,10 @@ def test_proxies
     assert_equal Dino::Components::Basic::DigitalOutput, part.data.class
     assert_equal Dino::Components::Register::Select,     part.latch.class
   end
+  
+  def test_identifies_with_latch_pin
+    assert_equal 8, part.pin
+  end
 
   def test_write
     # mock = MiniTest::Mock.new.expect :call, nil, ["21.8.1.#{[11,12,0,255,127].pack('C*')}\n"]
diff --git a/test/components/setup/base_test.rb b/test/components/setup/base_test.rb
index d16848c2..ff18b02e 100644
--- a/test/components/setup/base_test.rb
+++ b/test/components/setup/base_test.rb
@@ -17,4 +17,8 @@ def test_registers_with_board
     part = BaseComponent.new(board: board)
     assert_equal board.components, [part]
   end
+  
+  def test_start_with_nil_state
+    assert_nil BaseComponent.new(board: board).state
+  end
 end
diff --git a/test/components/setup/multi_pin_test.rb b/test/components/setup/multi_pin_test.rb
index 3c7b4bda..7c1a0734 100644
--- a/test/components/setup/multi_pin_test.rb
+++ b/test/components/setup/multi_pin_test.rb
@@ -32,7 +32,7 @@ def test_validate_pins
       MultiPinComponent.new board: board, pins: { one: 9, maybe: 11 }
     end
     assert_raises(ArgumentError) do
-      MultiPinComponent.new board: board, pins: { one: 10, maybe: 11 }
+      MultiPinComponent.new board: board, pins: { two: 10, maybe: 11 }
     end
     MultiPinComponent.new board: board, pins: { one: 9, two:10 }
   end
@@ -41,6 +41,11 @@ def test_build_proxies
     assert_equal Dino::Components::Basic::DigitalOutput, part.proxies[:two].class
     assert_equal Dino::Components::Basic::DigitalInput, part.proxies[:maybe].class
   end
+  
+  def attr_reader_exists_for_optional_pins
+    part = MultiPinComponent.new board: board, pins: { one: 9, two:10 }
+    assert_nil part.maybe
+  end
 
   def test_proxy_reader_methods
     assert_equal part.proxies[:two], part.two

From 4c175fd00cb40ced02b77a62281f3ae75fe094b6 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 8 Feb 2023 12:58:11 -0400
Subject: [PATCH 216/296] Let SPI registers control MSBFIRST/LSBFIRST. Improved
 examples.

---
 examples/register/shift_in.rb           | 12 ++++----
 examples/register/shift_out.rb          |  8 ++++--
 examples/register/shift_ssd.rb          | 16 ++++++-----
 examples/register/spi_combined.rb       | 27 ++++++++----------
 examples/register/spi_in.rb             | 37 +++++++++++++------------
 examples/register/spi_ssd.rb            | 27 ++++++++++++------
 lib/dino/components/register/spi_in.rb  |  9 +++---
 lib/dino/components/register/spi_out.rb | 15 +++++-----
 8 files changed, 85 insertions(+), 66 deletions(-)

diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index 03576c03..9d0520f8 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -1,11 +1,13 @@
 #
-# Example showing how to read an input shift register using Arduino's "shiftIn".
+# Example using the Arduino shiftIn function to read data from a shift register.
+# SPI is more efficient and may work with the same hardware, so use that if possible.
+# See examples/spi_in.rb
 #
-# The register implements #digital_read and other methods expected by Components,
-# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+# The register is a BoardProxy, and implements enough Board methods that
+# DigitalInput components can use its pins directly.
 #
-# The Button object is created by passing the register instead of the board, and
-# the register's parallel output pin that the button is connected to.
+# The Button object is created by using the register in place of board, and
+# the register output pin that it's connected to.
 #
 # Note: rising_clock must be set to true if using TI CD4021B register or similar.
 # This should apply to any register which outputs on a rising clock edge.
diff --git a/examples/register/shift_out.rb b/examples/register/shift_out.rb
index 6729d0df..6f92daca 100644
--- a/examples/register/shift_out.rb
+++ b/examples/register/shift_out.rb
@@ -1,13 +1,17 @@
 #
-# Example showing how to set up an output shift register.
+# Example using the Arduino shiftOut function to write data to a shift register.
+# SPI is more efficient and may work with the same hardware, so use that if possible.
+#
 # Multiple bytes may be written in one operation.
+# Register instance stores state, and its size can be set by including :bytes when intiailizing.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                     pins: {latch: 9, data: 11, clock: 13}
+                                                     pins:  {latch: 9, data: 11, clock: 13}
+                                                     # bytes: 1
 
 # Write a single byte
 register.write(255)
diff --git a/examples/register/shift_ssd.rb b/examples/register/shift_ssd.rb
index 6bfd0e82..a6b80a6e 100644
--- a/examples/register/shift_ssd.rb
+++ b/examples/register/shift_ssd.rb
@@ -1,19 +1,21 @@
 #
-# Example showing how to use an output shift register to drive a seven segment display.
+# Example using the Arduino shiftOut function to drive a seven segment display.
+# SPI is more efficient and may work with the same hardware, so use that if possible.
+# See examples/spi_ssd.rb
 #
-# The register implements #digital_write and other methods expected by Components,
-# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
-#
-# The SSD object is created by passing the register instead of the board, and
-# the registers's parallel pin number that each SSD pin is connected to.
+# The register is a BoardProxy, and implements enough Board methods that
+# DigitalOutput components can use its pins directly.
 #
+# The SSD object is created by using the register in place of board, and
+# the register output pins that the SSD is connected to.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 shift_register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                           pins: {data: 11, clock: 13, latch: 9}
+                                                           pins: {data: 11, clock: 13, latch: 9},
+                                                           # bytes: 1
 
 ssd = Dino::Components::SSD.new   board: shift_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
diff --git a/examples/register/spi_combined.rb b/examples/register/spi_combined.rb
index 32bfa994..e981e52b 100644
--- a/examples/register/spi_combined.rb
+++ b/examples/register/spi_combined.rb
@@ -1,30 +1,27 @@
 #
-# Example showing how to use an output shift register to drive a seven segment display.
-#
-# The register implements #digital_write and other methods expected by Components,
-# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
-#
-# The SSD object is created by passing the register instead of the board, and
-# the registers's parallel pin number that each SSD pin is connected to.
-#
+# Example showing 2 SPI devices on the same bus with different select pins.
+# Combination of examples/spi_ssd.rb and examples/spi_in.rb
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-output_register = Dino::Components::Register::SPIOut.new  board: board,
-                                                          pin: 9,
-                                                          frequency: 3000000,
-                                                          spi_mode: 3
+output_register = Dino::Components::Register::SPIOut.new board: board,
+                                                         pin: 9
+                                                         # frequency: 3000000,
+                                                         # spi_mode: 0,
+                                                         # bytes: 1
+                                                         # bit_order: :lsbfirst
 
 ssd = Dino::Components::SSD.new   board: output_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
 
 input_register = Dino::Components::Register::SPIIn.new  board: board,
-                                                        pin: 10,
-                                                        bytes: 1,
-                                                        spi_mode: 3,
+                                                        pin: 8,
+                                                        spi_mode: 0,
                                                         frequency: 3000000
+                                                        # bytes: 1
+                                                        # bit_order: :lsbfirst
 
 button = Dino::Components::Button.new(pin: 0, board: input_register)
 
diff --git a/examples/register/spi_in.rb b/examples/register/spi_in.rb
index 6bacdd9c..bdf177d4 100644
--- a/examples/register/spi_in.rb
+++ b/examples/register/spi_in.rb
@@ -1,33 +1,34 @@
 #
-# Example showing how to read an input shift register using SPI.
+# Example of input components connected to an input SPI shift register.
 #
-# The register implements #digital_read and other methods expected by Components,
-# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+# The register is a BoardProxy, and implements enough Board methods that
+# DigitalInput components can be attached to its pins. 
 #
-# The Button object is created by passing the register instead of the board, and
-# the register's parallel output pin that the button is connected to.
+# The Button object is created by using the register in place of board, and
+# the register output pin that it's connected to.
+#
+# The board pin connected to the register's select/latch pin is required to initialize.
+# Each device connected to the SPI bus needs a unique select pin on the board.
+#
+# Clock and data pins do not need to be specified when using SPI, since they are
+# predetermined on the board and shared by all SPI devices, but they must be connected.
+# Pin mapping varies depending on the board.
+# A reference can be found here: https://www.arduino.cc/en/Reference/SPI
+#
+# SPI output (MISO) and SPI clock (SCLK) map to pins 12 and 13 respectively on the Arduino UNO.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 
-#
-# Pin 10 is default slave select on Arduino UNO. Connect to register "latch" input.
-# Register data and clock pins go to 12 (MISO) and 13 respectively on the Arduino UNO.
-#
-# Clock and data pins do not need to be given when using SPI, since they are
-# predetermined based on the board you are using, and dealt with by the library.
-# But they still must be connected. The exact pins vary depending on the board,
-# and a reference can be found here: https://www.arduino.cc/en/Reference/SPI
-#
 # SPI mode and frequency are specific to a TI CD4021B register. Change as needed.
-#
 shift_register = Dino::Components::Register::SPIIn.new  board: board,
-                                                        pin: 10,
-                                                        bytes: 1,
-                                                        spi_mode: 3,
+                                                        pin: 8,
+                                                        spi_mode: 0,
                                                         frequency: 3000000
+                                                        # bytes: 1
+                                                        # bit_order: :lsbfirst
 
 button = Dino::Components::Button.new(pin: 0, board: shift_register)
 
diff --git a/examples/register/spi_ssd.rb b/examples/register/spi_ssd.rb
index 079e0915..1d01a076 100644
--- a/examples/register/spi_ssd.rb
+++ b/examples/register/spi_ssd.rb
@@ -1,21 +1,32 @@
 #
-# Example showing how to use an output shift register to drive a seven segment display.
+# Example of an output SPI shift register driving a seven segment display.
 #
-# The register implements #digital_write and other methods expected by Components,
-# and makes its parallel pins addressable (zero index), so it can proxy the Board class.
+# The register is a BoardProxy, and implements enough Board methods that
+# DigitalOutput components can use its pins directly.
 #
-# The SSD object is created by passing the register instead of the board, and
-# the registers's parallel pin number that each SSD pin is connected to.
+# The SSD object is created by using the register in place of board, and
+# the register output pins that the SSD is connected to.
 #
+# The board pin connected to the register's select/latch pin is required to initialize.
+# Each device connected to the SPI bus needs a unique select pin on the board.
+#
+# Clock and data pins do not need to be specified when using SPI, since they are
+# predetermined on the board and shared by all SPI devices, but they must be connected.
+# Pin mapping varies depending on the board.
+# A reference can be found here: https://www.arduino.cc/en/Reference/SPI
+#
+# SPI output (MISO) and SPI clock (SCLK) map to pins 12 and 13 respectively on the Arduino UNO.
 #
 require 'bundler/setup'
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 shift_register = Dino::Components::Register::SPIOut.new  board: board,
-                                                         pin: 9,
-                                                         frequency: 3000000,
-                                                         spi_mode: 3
+                                                         pin: 9
+                                                         # frequency: 3000000,
+                                                         # spi_mode: 0,
+                                                         # bytes: 1
+                                                         # bit_order: :lsbfirst
 
 ssd = Dino::Components::SSD.new   board: shift_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 36298543..d3c1d966 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -2,21 +2,22 @@ module Dino
   module Components
     module Register
       #
-      # Model SPI registers as single pin. Data comes back on the select pin,
-      # so just inherit from Select.
+      # Model SPI registers as single pin. MOSI and MISO are shared
+      # and predetermined, so we only need to care about the select pin.
       #
-      # options = {board: my_board, pin: slave_select_pin}
+      # options = {board: my_board, pin: register_select_pin}
       #
       class SPIIn < Select
         include Input
 
-        attr_reader :spi_mode, :frequency
+        attr_reader :spi_mode, :frequency, :bit_order
 
         def after_initialize(options={})
           super(options) if defined?(super)
           
           @spi_mode  = options[:spi_mode]  || 0
           @frequency = options[:frequency] || 3000000
+          @bit_order = options[:bit_order] || :lsbfirst
         end
 
         def read
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index 14cf87af..8d5922a2 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -2,25 +2,26 @@ module Dino
   module Components
     module Register
       #
-      # Model SPI registers as single pin. Data comes back on the select pin,
-      # so just inherit from Select.
+      # Model SPI registers as single pin. MOSI and MISO are shared
+      # and predetermined, so we only need to care about the select pin.
       #
-      # options = {board: my_board, pin: slave_select_pin}
+      # options = {board: my_board, pin: register_select_pin}
       #
       class SPIOut < Select
         include Output
 
-        attr_reader :spi_mode, :frequency
+        attr_reader :spi_mode, :frequency, :bit_order
 
         def after_initialize(options={})
+          super(options) if defined?(super)
+          
           @spi_mode  = options[:spi_mode]  || 0
           @frequency = options[:frequency] || 3000000
-
-          super(options) if defined?(super)
+          @bit_order = options[:bit_order] || :lsbfirst
         end
 
         def write(*bytes)
-          board.spi_transfer(pin, mode: spi_mode, frequency: frequency, write: bytes.flatten)
+          board.spi_transfer(pin, mode: spi_mode, frequency: frequency, write: bytes.flatten, bit_order: bit_order)
         end
       end
     end

From 278f8a521ffeee323bbcb9f62e9cfb77fe3bc62c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 9 Feb 2023 13:38:38 -0400
Subject: [PATCH 217/296] Don't fix external OneWire library since it's no
 longer used

---
 lib/dino_cli/generator.rb | 3 ---
 lib/dino_cli/packages.rb  | 2 +-
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index af02ecb9..a386aa34 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -40,9 +40,6 @@ def read
         if f.match /\Avendor/
           directive = @packages[k][:directive]
           contents = "#include \"DinoDefines.h\"\n#ifdef #{directive}\n" << contents << "\n#endif\n"
-
-          # Hack to workaround /util folder includes in latest OneWire library.
-          contents.gsub!("util/OneWire_direct_gpio.h", "OneWire_direct_gpio.h") if f.match /OneWire/
         end
         { path: f, contents: contents }
       end
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index 53b6eac5..bb4238e6 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -84,7 +84,7 @@ class DinoCLI::Generator
     ]
   },
   one_wire: {
-    description: "OneWire bus support (Just DS18B20 for now)",
+    description: "OneWire bus support",
     directive: "DINO_ONE_WIRE",
     files: [
       "lib/DinoOneWire.cpp",

From 59674ae7feb342110387c76a96bdf9a33711beb7 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 9 Feb 2023 17:43:17 -0400
Subject: [PATCH 218/296] Add Board#eeprom convenience method

---
 examples/eeprom/eeprom.rb | 5 +++--
 lib/dino/board/base.rb    | 4 ++++
 test/board_test.rb        | 8 ++++++++
 3 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/examples/eeprom/eeprom.rb b/examples/eeprom/eeprom.rb
index 959d11bc..09821f3a 100644
--- a/examples/eeprom/eeprom.rb
+++ b/examples/eeprom/eeprom.rb
@@ -7,8 +7,9 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 
-# Initialization automatically gets all EEPROM data from thee board.
-eeprom = Dino::Components::Basic::BoardEEPROM.new(board: board)
+# Initialization automatically gets all EEPROM data from the board.
+# eeprom = Dino::Components::Basic::BoardEEPROM.new(board: board)
+eeprom = board.eeprom
 
 # EEPROM size reported by the board.
 puts "EEPROM Size: #{eeprom.length} bytes"
diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index 9c4531cc..84656af3 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -36,6 +36,10 @@ def analog_resolution=(value)
       def aux_limit
         @aux_limit ||= 39
       end
+      
+      def eeprom
+        @eeprom ||= Components::Basic::BoardEEPROM.new(board: self)
+      end
 
       def write(msg)
         @io.write(msg)
diff --git a/test/board_test.rb b/test/board_test.rb
index 49470bb9..d5c72110 100644
--- a/test/board_test.rb
+++ b/test/board_test.rb
@@ -62,6 +62,14 @@ def test_analog_resolution
     assert_equal 0,    board.low
     assert_equal 1023, board.analog_high
   end
+  
+  def test_eeprom
+    mock = MiniTest::Mock.new.expect(:call, "test eeprom", [], board: board)
+    Dino::Components::Basic::BoardEEPROM.stub(:new, mock) do
+      board.eeprom
+    end
+    mock.verify
+  end
 
   def test_add_remove_component
     mock = MiniTest::Mock.new

From 1b833e7098dc7f7ea07cb5e63d7de5862fc33e66 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 10 Feb 2023 10:33:02 -0400
Subject: [PATCH 219/296] Store listener dividers correctly on board. Store
 DigitalInput state as int, not string

---
 lib/dino/components/basic/analog_input.rb   | 2 +-
 lib/dino/components/basic/digital_input.rb  | 2 +-
 src/lib/DinoCoreIO.cpp                      | 4 ++--
 test/components/basic/digital_input_test.rb | 6 ++++++
 4 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/lib/dino/components/basic/analog_input.rb b/lib/dino/components/basic/analog_input.rb
index 86b3c54b..78e32127 100644
--- a/lib/dino/components/basic/analog_input.rb
+++ b/lib/dino/components/basic/analog_input.rb
@@ -13,7 +13,7 @@ def _read
         end
 
         def _listen(divider=16)
-          @divider = divider || 16
+          @divider = divider
           board.analog_listen(pin, @divider)
         end
       end
diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index 3ef4558a..77cf3b44 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -18,7 +18,7 @@ def _read
         end
 
         def _listen(divider=4)
-          @divider = divider || 4
+          @divider = divider
           board.digital_listen(pin, @divider)
         end
 
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index 1b302f3b..2b89950a 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -98,7 +98,7 @@ void Dino::setListener(byte p, boolean enabled, byte analog, byte exponent, bool
   if (enabled)  settingMask = settingMask | B10000000;
   if (analog)   settingMask = settingMask | B01000000;
   if (local)    settingMask = settingMask | B00010000;
-  settingMask = settingMask | dividerMap[exponent];
+  settingMask = settingMask | exponent;
 
   #ifdef debug
     Serial.print("setlistener, pin:");
@@ -151,7 +151,7 @@ void Dino::updateCoreListeners(byte tickCount){
     // Check if active.
     if (bitRead(listeners[i][0], 7) == 1){
       // Check if to update it on this tick.
-      byte exponent = 0b111 & listeners[i][0];
+      byte exponent = (listeners[i][0] << 5) >> 5;
       byte divider = dividerMap[exponent];
       if(tickCount % divider == 0){
         // Check if digital or analog.
diff --git a/test/components/basic/digital_input_test.rb b/test/components/basic/digital_input_test.rb
index e630e4cb..c25b6761 100644
--- a/test/components/basic/digital_input_test.rb
+++ b/test/components/basic/digital_input_test.rb
@@ -16,6 +16,12 @@ def test_start_listening_immediately
     end
     mock.verify
   end
+  
+  def test_converts_to_integer
+    part
+    part.update("1")
+    assert_equal part.state, 1
+  end
 
   def test__read
     mock = MiniTest::Mock.new.expect :call, nil, [14]

From 4e841081adbcd108400ed5782d19ea9be99bc29f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 10 Feb 2023 13:10:33 -0400
Subject: [PATCH 220/296] Listeners still wrong with bitshift and (). Bitmasks
 work instead.

---
 lib/dino/components/basic/digital_input.rb | 4 ++++
 lib/dino/components/setup/base.rb          | 8 ++++----
 src/lib/DinoCoreIO.cpp                     | 3 ++-
 src/lib/DinoSPI.cpp                        | 4 +---
 4 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index 77cf3b44..2e3c4343 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -33,6 +33,10 @@ def on_low(&block)
             block.call(data) if data.to_i == board.low
           end
         end
+        
+        def pre_callback_filter(data)
+          data.to_i
+        end
 
         def high?; state == board.high end
         def low?;  state == board.low  end
diff --git a/lib/dino/components/setup/base.rb b/lib/dino/components/setup/base.rb
index 09f51df0..06d7b161 100644
--- a/lib/dino/components/setup/base.rb
+++ b/lib/dino/components/setup/base.rb
@@ -4,10 +4,6 @@ module Setup
       module Base
         attr_reader :board
 
-        def state
-          @state_mutex.synchronize { @state }
-        end
-
         def initialize(options={})
           @state = nil
           @state_mutex = Mutex.new
@@ -16,6 +12,10 @@ def initialize(options={})
           register
           after_initialize(options)
         end
+        
+        def state
+          @state_mutex.synchronize { @state }
+        end
 
         protected
 
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index 2b89950a..2c6c75ce 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -151,7 +151,8 @@ void Dino::updateCoreListeners(byte tickCount){
     // Check if active.
     if (bitRead(listeners[i][0], 7) == 1){
       // Check if to update it on this tick.
-      byte exponent = (listeners[i][0] << 5) >> 5;
+	  // Divider exponent is last 3 bits of settings.
+      byte exponent = listeners[i][0] & 0B00000111;
       byte divider = dividerMap[exponent];
       if(tickCount % divider == 0){
         // Check if digital or analog.
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 5dafe09e..092983de 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -22,9 +22,7 @@ void Dino::spiBegin(byte settings, uint32_t clockRate){
   SPI.begin();
 
   // SPI mode is the lowest 4 bits of settings.
-  byte mode = settings;
-  mode << 4;
-  mode >> 4;
+  byte mode = settings & 0B00001111;
 
   // Bit 7 of settings toggles MSBFIRST.
   SPI.beginTransaction(SPISettings(clockRate, bitRead(settings, 7), mode));

From a3736087c55f7429bdb0982dc29bac416512da6b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 10 Feb 2023 13:13:52 -0400
Subject: [PATCH 221/296] Improve RotaryEncoder so #steps and #angle give
 state. Updated examples.

---
 examples/rotary_encoder/rotary_encoder.rb     |  4 +-
 .../rotary_encoder_mac_volume.rb              |  9 +-
 lib/dino/components/rotary_encoder.rb         | 90 +++++++++++--------
 3 files changed, 61 insertions(+), 42 deletions(-)

diff --git a/examples/rotary_encoder/rotary_encoder.rb b/examples/rotary_encoder/rotary_encoder.rb
index e5a26af3..2f97afb1 100644
--- a/examples/rotary_encoder/rotary_encoder.rb
+++ b/examples/rotary_encoder/rotary_encoder.rb
@@ -10,8 +10,8 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 encoder = Dino::Components::RotaryEncoder.new board: board,
                                               pins:{ clock: 4, data: 5 },
-                                              divider: 1, # (default) read approx every divider ms
-                                              steps: 30   # (default) steps / revolution
+                                              divider: 1,            # (default) read approx every divider ms
+                                              degrees_per_step: 12   # (default) angular degrees the encoder moves between steps
 
 encoder.add_callback do |data|
   puts "Encoder position: #{data[:position]}°"
diff --git a/examples/rotary_encoder/rotary_encoder_mac_volume.rb b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
index 160e60f2..b0df871a 100644
--- a/examples/rotary_encoder/rotary_encoder_mac_volume.rb
+++ b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
@@ -7,8 +7,8 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 encoder = Dino::Components::RotaryEncoder.new board: board,
                                               pins:{ clock: 4, data: 5 },
-                                              divider: 1, # (default) read approx every divider ms
-                                              steps: 30   # (default) steps / revolution
+                                              divider: 1,            # (default) read approx every divider ms
+                                              degrees_per_step: 12   # (default) angular degrees the encoder moves between steps
 
 # Set up a pseudo terminal with osascript (AppleScript) in interactive mode.
 # Calling a separate script each update is too slow.
@@ -38,15 +38,14 @@ def set(value)
 # Some values from 0-100 aren't applied so the encoder gets stuck in a
 # small range if we write every step. Track when a step has no effect
 # and apply it later with this.
-unused_steps = 0
 
 encoder.add_callback do |update|
-  value = volume.get + update[:change] + unused_steps
+  # Increase by 2% for every step so it responds faster.
+  value = (volume.get + (update[:change] * 2))
   value = 0 if value < 0
   value = 100 if value > 100
   volume.set(value)
   current_volume = volume.get
-  unused_steps = value - current_volume
   puts "Current volume: #{current_volume}%"
 end
 
diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index 14d03aff..9ea7764e 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -4,57 +4,77 @@ class RotaryEncoder
       include Setup::MultiPin
       include Mixins::Callbacks
 
-      proxy_pins data: Basic::DigitalInput,
-                 clock: Basic::DigitalInput
-
-      attr_reader :position, :steps, :degrees_per_step
-      alias :position :state
-
+      proxy_pins clock: Basic::DigitalInput,
+                 data: Basic::DigitalInput
+                 
+      attr_accessor :degrees_per_step
+      
       def after_initialize(options={})
         super(options)
-
+                
+        self.degrees_per_step = options[:degrees_per_step] || 12
+        reset
+        
+        # DigitalInputs listen with default divider automatically. Override here.
         divider = options[:divider] || 1
         clock.listen(divider)
         data.listen(divider)
 
-        @steps = options[:steps] || 30
-        @degrees_per_step = (360 / steps).to_f
-        @state = 0.0
+        observe_pins
+      end
+      
+      def angle
+        state[:angle]
+      end
 
-        start
+      def steps
+        state[:steps]
+      end
+      
+      def reset
+        self.state = {steps: 0, angle: 0}
       end
+      
+      private
 
-      def start
-        clock.add_callback do |clock_state|
-          (data.state == clock_state) ? self.update(-1) : self.update(1)
+      def observe_pins
+        #
+        # This is a quirk of how listeners work.
+        # When observing the pins, attach a callback to the higher numbered pin,
+        # then read state from the lower. If not, direction will be reversed.
+        #
+        if board.convert_pin(clock.pin) > board.convert_pin(data.pin)
+          trailing = clock
+          leading = data
+        else
+          trailing = data
+          leading = clock
+        end
+        
+        trailing.add_callback do |trailing_state|
+          (leading.state == trailing_state) ? self.update(1) : self.update(-1)
         end
       end
-
-      #
-      # Callbacks#update calls these before and after callbacks respectively.
+      
       #
-      # Take data (+/- 1 step change) and calculate new position (state) in degrees.
-      # Leave old position in @state for now, so callbacks can compare to it.
+      # Take data (+/- 1 step change) and calculate new state.
+      # Return a hash with the new :steps and :angle. Pass through raw
+      # value in :change, so callbacks can use any of these.
       #
-      # Return a hash with the new :position and pass through :change, overriding
-      # the data param we took, which would have passed directly to callbacks.
-      # Callbacks can use either :position (in degrees) or :change (in steps).
-      #
-      def pre_callback_filter(data)
-        { change: data, position: (state + (data * degrees_per_step)) % 360 }
+      def pre_callback_filter(step)
+        # Copy old state through the mutex wrapped reader.
+        temp_state = state.dup
+        temp_state[:change] = step
+        temp_state[:steps]  = temp_state[:steps]  + step
+        temp_state[:angle]  = (temp_state[:angle] + (step * degrees_per_step))
+        temp_state
       end
+
       #
-      # Callbacks run now, receiving only the value of #pre_callback_filter
-      #
-      # After callbacks, set @state to the position calculated earlier.
-      # This method also receives the result of #pre_callback_filter.
+      # After callbacks, set state to the hash from before, except change.
       #
-      def update_self(data)
-        @state = data[:position]
-      end
-
-      def reset_position
-        @callbacks_mutex.synchronize { @state = 0 }
+      def update_self(new_state)
+        self.state = new_state.except(:change)
       end
     end
   end

From 15be763782efdf3c3c002dfd8f4f88b9c888fa16 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 10 Feb 2023 13:14:35 -0400
Subject: [PATCH 222/296] #convert_pin can return nil for parts not directly
 using pins

---
 lib/dino/board/default.rb | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/dino/board/default.rb b/lib/dino/board/default.rb
index c7358539..271e4fac 100644
--- a/lib/dino/board/default.rb
+++ b/lib/dino/board/default.rb
@@ -14,12 +14,13 @@ class Default < Base
       DAC_REGEX = /\A(dac)\d+\z/i
 
       def convert_pin(pin)
+        return nil                  if pin == nil
         pin = pin.to_s
         return pin.to_i             if pin.match(DIGITAL_REGEX)
         return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
         return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
         return "EE"                 if pin == "EE"
-        raise ArgumentError, "incorrect pin format"
+        raise ArgumentError, "incorrect pin format: #{pin.inspect}"
       end
 
       def analog_pin_to_i(pin)

From 0bb2c78a1bb5789ba0a64037827dfc367a20382c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 10 Feb 2023 13:38:11 -0400
Subject: [PATCH 223/296] Use steps per rev instead of degrees per step to set
 up RotaryEncoder

---
 examples/rotary_encoder/rotary_encoder.rb            | 9 ++++-----
 examples/rotary_encoder/rotary_encoder_mac_volume.rb | 8 ++------
 lib/dino/components/rotary_encoder.rb                | 4 ++--
 3 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/examples/rotary_encoder/rotary_encoder.rb b/examples/rotary_encoder/rotary_encoder.rb
index 2f97afb1..0fef0e93 100644
--- a/examples/rotary_encoder/rotary_encoder.rb
+++ b/examples/rotary_encoder/rotary_encoder.rb
@@ -10,12 +10,11 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 encoder = Dino::Components::RotaryEncoder.new board: board,
                                               pins:{ clock: 4, data: 5 },
-                                              divider: 1,            # (default) read approx every divider ms
-                                              degrees_per_step: 12   # (default) angular degrees the encoder moves between steps
+                                              divider: 1,                # (default) read approx every divider ms
+                                              steps_per_revolution: 30   # (default)
 
-encoder.add_callback do |data|
-  puts "Encoder position: #{data[:position]}°"
-  puts "Encoder change: #{data[:change]}"
+encoder.add_callback do |state|
+  puts "Encoder moved #{state[:change]} steps | CW step count: #{state[:steps]} | Current angle: #{state[:angle]}\xC2\xB0"
 end
 
 sleep
diff --git a/examples/rotary_encoder/rotary_encoder_mac_volume.rb b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
index b0df871a..5612ab2c 100644
--- a/examples/rotary_encoder/rotary_encoder_mac_volume.rb
+++ b/examples/rotary_encoder/rotary_encoder_mac_volume.rb
@@ -7,8 +7,8 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 encoder = Dino::Components::RotaryEncoder.new board: board,
                                               pins:{ clock: 4, data: 5 },
-                                              divider: 1,            # (default) read approx every divider ms
-                                              degrees_per_step: 12   # (default) angular degrees the encoder moves between steps
+                                              divider: 1,                # (default) read approx every divider ms
+                                              steps_per_revolution: 30   # (default)
 
 # Set up a pseudo terminal with osascript (AppleScript) in interactive mode.
 # Calling a separate script each update is too slow.
@@ -35,10 +35,6 @@ def set(value)
 volume = AppleVolumeWrapper.new
 puts "Current volume: #{volume.get}%"
 
-# Some values from 0-100 aren't applied so the encoder gets stuck in a
-# small range if we write every step. Track when a step has no effect
-# and apply it later with this.
-
 encoder.add_callback do |update|
   # Increase by 2% for every step so it responds faster.
   value = (volume.get + (update[:change] * 2))
diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index 9ea7764e..4b93ac45 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -12,7 +12,7 @@ class RotaryEncoder
       def after_initialize(options={})
         super(options)
                 
-        self.degrees_per_step = options[:degrees_per_step] || 12
+        self.degrees_per_step = (360 / options[:steps_per_revolution]) || 30
         reset
         
         # DigitalInputs listen with default divider automatically. Override here.
@@ -66,7 +66,7 @@ def pre_callback_filter(step)
         temp_state = state.dup
         temp_state[:change] = step
         temp_state[:steps]  = temp_state[:steps]  + step
-        temp_state[:angle]  = (temp_state[:angle] + (step * degrees_per_step))
+        temp_state[:angle]  = (temp_state[:angle] + (step * degrees_per_step)) % 360
         temp_state
       end
 

From 43638fec8b9296e39a0fed72e884493f1f643c6f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 11:17:21 -0400
Subject: [PATCH 224/296] Correctly set default steps per rev for rotary
 encoders

---
 lib/dino/components/rotary_encoder.rb | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index 4b93ac45..477d369d 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -12,7 +12,11 @@ class RotaryEncoder
       def after_initialize(options={})
         super(options)
                 
-        self.degrees_per_step = (360 / options[:steps_per_revolution]) || 30
+        if options[:steps_per_revolution] 
+          self.degrees_per_step = (360 / options[:steps_per_revolution])
+        else
+          self.degrees_per_step = 30
+        end
         reset
         
         # DigitalInputs listen with default divider automatically. Override here.

From b690d210bf53a955b4266d4435dac3ed3a3529a5 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 12:26:07 -0400
Subject: [PATCH 225/296] Add BoardEEPROM support for the ESP8266

---
 .../{eeprom/eeprom.rb => board_eeprom.rb}     |  0
 src/lib/Dino.cpp                              |  8 +++++-
 src/lib/Dino.h                                |  5 ++++
 src/lib/DinoEEPROM.cpp                        | 25 +++++++++++++++----
 4 files changed, 32 insertions(+), 6 deletions(-)
 rename examples/{eeprom/eeprom.rb => board_eeprom.rb} (100%)

diff --git a/examples/eeprom/eeprom.rb b/examples/board_eeprom.rb
similarity index 100%
rename from examples/eeprom/eeprom.rb
rename to examples/board_eeprom.rb
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 72db040c..512697fb 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -221,7 +221,13 @@ void Dino::handshake() {
   stream->print("ACK:");
   stream->print(AUX_SIZE);
   stream->print(',');
-  stream->print(EEPROM.length());
+  // Send the defined length for ESP8266 EEPROM and initialize later.
+  // Read the value and send that for other boards.
+  #ifdef ESP8266
+  	stream->print(ESP8266_EEPROM_LENGTH);
+  #else
+  	stream->print(EEPROM.length());
+  #endif
   stream->print(',');
   stream->print(A0);
   #if defined(__SAM3X8E__)
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 4039592d..ab4d18d0 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -16,6 +16,11 @@
 #  define PIN_COUNT 22
 #endif
 
+// Use the maximum length for the ESP8266 EEPROM.
+#ifdef ESP8266
+#  define ESP8266_EEPROM_LENGTH 4096
+#endif
+
 class Dino {
   public:
     Dino();
diff --git a/src/lib/DinoEEPROM.cpp b/src/lib/DinoEEPROM.cpp
index 63308c6b..0693b345 100644
--- a/src/lib/DinoEEPROM.cpp
+++ b/src/lib/DinoEEPROM.cpp
@@ -12,7 +12,11 @@
 //
 void Dino::eepromRead(){
   if (val > 0) {
-    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
+	#ifdef ESP8266
+	  EEPROM.begin(ESP8266_EEPROM_LENGTH);
+    #endif
+	  
+    uint16_t startAddress = ((uint16_t)auxMsg[1] << 8) | auxMsg[0];
 
     // Stream read bytes as if coming from a pin named 'EE'.
     stream->print("EE");
@@ -24,6 +28,10 @@ void Dino::eepromRead(){
       stream->print(EEPROM.read(startAddress + i));
       stream->print((i+1 == val) ? '\n' : ',');
     }
+	
+	#ifdef ESP8266
+	  EEPROM.end();
+	#endif
   }
 }
 
@@ -37,12 +45,19 @@ void Dino::eepromRead(){
 //
 void Dino::eepromWrite(){
   if (val > 0) {
-    uint16_t startAddress = (uint16_t)auxMsg[1] << 8 | auxMsg[0];
+	#ifdef ESP8266
+	  EEPROM.begin(ESP8266_EEPROM_LENGTH);
+	#endif
+	  
+    uint16_t startAddress = ((uint16_t)auxMsg[1] << 8) | auxMsg[0];
 
     for (byte i = 0;  (i < val);  i++) {
-      if(EEPROM.read(startAddress + i) != auxMsg[2+i]) {
-        EEPROM.write(startAddress + i, auxMsg[2+i]);
-      }
+	  EEPROM.write(startAddress + i, auxMsg[2+i]);
     }
+	
+	#ifdef ESP8266
+	  EEPROM.end();
+	  EEPROM.commit();
+	#endif
   }
 }

From 11c8e568be0d3ea69b7a9cd08bed9fbff93417fd Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 13:13:15 -0400
Subject: [PATCH 226/296] Change the default config for the mega168 sketch

---
 lib/dino_cli/targets.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 1e9d4ea8..5d6cc1bd 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -11,7 +11,7 @@ class DinoCLI::Generator
     core: [:core],
 
     # Specific features for the old mega168 chips.
-    mega168: [:core, :servo, :one_wire, :ir_out, :tone, :spi, :i2c],
+    mega168: [:core, :servo, :shift,:tone, :spi, :i2c],
 
     # ARM includes everytyhing except specific incompatibilities.
     arm: STANDARD_PACKAGES - [:serial, :tone, :ir_out],

From 63f0b414d6363c2e68894c4f4177b7c2e3f496fd Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 16:46:14 -0400
Subject: [PATCH 227/296] Remove #callbacks= and test callback modification
 happening in mutex

---
 lib/dino/components/mixins/callbacks.rb  |  9 ++++++---
 test/components/mixins/callbacks_test.rb | 13 +++++++++++++
 2 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 13b84f27..24098080 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -3,13 +3,16 @@ module Components
     module Mixins
       module Callbacks
         attr_reader :callback_mutex, :callbacks
-        attr_writer :callbacks
 
         def after_initialize(options={})
           super(options)
           @callbacks = {}
           @callback_mutex = Mutex.new
         end
+        
+        def callbacks
+          callback_mutex.synchronize { @callbacks }
+        end
 
         def add_callback(key=:persistent, &block)
           callback_mutex.synchronize do
@@ -31,13 +34,13 @@ def update(data)
           data = pre_callback_filter(data)
 
           callback_mutex.synchronize do
-            callbacks.each_value do |array|
+            @callbacks.each_value do |array|
               array.each do |callback|
                 callback.call(data)
               end
             end
             # Remove special :read callback before unlocking.
-            callbacks.delete(:read)
+            @callbacks.delete(:read)
           end
 
           update_self(data)
diff --git a/test/components/mixins/callbacks_test.rb b/test/components/mixins/callbacks_test.rb
index 0d304eca..61dca871 100644
--- a/test/components/mixins/callbacks_test.rb
+++ b/test/components/mixins/callbacks_test.rb
@@ -18,6 +18,19 @@ def part
     @part ||= CallbackComponent.new(board: board, pin: 1)
   end
 
+  def test_callback_mutex
+    callback = Proc.new{}
+    mock = MiniTest::Mock.new
+    3.times {mock.expect(:call, nil)}
+    
+    part.callback_mutex.stub(:synchronize, mock) do
+      part.callbacks
+      part.add_callback(:key, &callback)
+      part.remove_callbacks(:key)
+    end
+    mock.verify
+  end
+
   def test_add_callback
     callback = Proc.new{}
     part.add_callback(&callback)

From 7a86b227580a2dd05a5c9c8b78a2842ae09cd3e2 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 17:57:24 -0400
Subject: [PATCH 228/296] Exlude EEPROM and use MSBFIRST/LSBFIRST on the Due so
 it compiles

---
 src/lib/Dino.cpp       | 10 ++++++++--
 src/lib/Dino.h         |  1 -
 src/lib/DinoDefines.h  |  6 ++++++
 src/lib/DinoEEPROM.cpp |  2 ++
 src/lib/DinoSPI.cpp    |  8 +++++++-
 5 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 512697fb..3ebb3251 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -108,9 +108,11 @@ void Dino::process() {
     case 4:  aRead               (pin);             break;
     case 5:  setListener         (pin, val, auxMsg[0], auxMsg[1], false); break;
 
+	#ifdef EEPROM_PRESENT
     // Implemented in DinoEEPROM.cpp
     case 6:  eepromRead          ();    break;
     case 7:  eepromWrite         ();    break;
+	#endif
 
     // Implemented in DinoServo.cpp
     #ifdef DINO_SERVO
@@ -221,13 +223,17 @@ void Dino::handshake() {
   stream->print("ACK:");
   stream->print(AUX_SIZE);
   stream->print(',');
+  
   // Send the defined length for ESP8266 EEPROM and initialize later.
-  // Read the value and send that for other boards.
+  // Read the value and send that for other boards, except the Due.
   #ifdef ESP8266
   	stream->print(ESP8266_EEPROM_LENGTH);
+  #elif defined(EEPROM_PRESENT)
+	stream->print(EEPROM.length());
   #else
-  	stream->print(EEPROM.length());
+     stream->print('0');
   #endif
+	
   stream->print(',');
   stream->print(A0);
   #if defined(__SAM3X8E__)
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index ab4d18d0..badfe5b6 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -4,7 +4,6 @@
 #ifndef Dino_h
 #define Dino_h
 #include <Arduino.h>
-#include <EEPROM.h>
 #include "DinoDefines.h"
 
 // Figure out how many pins our hardware has.
diff --git a/src/lib/DinoDefines.h b/src/lib/DinoDefines.h
index daca06b6..8d66ac8c 100644
--- a/src/lib/DinoDefines.h
+++ b/src/lib/DinoDefines.h
@@ -14,3 +14,9 @@
 // #define DINO_SHIFT
 // #define DINO_SPI
 // #define DINO_I2C
+
+// No EEPROM on the Due.
+#ifndef __SAM3X8E__
+  #define EEPROM_PRESENT
+  #include <EEPROM.h>
+#endif
\ No newline at end of file
diff --git a/src/lib/DinoEEPROM.cpp b/src/lib/DinoEEPROM.cpp
index 0693b345..dd898c9f 100644
--- a/src/lib/DinoEEPROM.cpp
+++ b/src/lib/DinoEEPROM.cpp
@@ -3,6 +3,7 @@
 //
 #include "Dino.h"
 
+#ifdef EEPROM_PRESENT
 // CMD = 6
 // Read from the microcontroller's EEPROM.
 //
@@ -61,3 +62,4 @@ void Dino::eepromWrite(){
 	#endif
   }
 }
+#endif
\ No newline at end of file
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 092983de..280c0b90 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -25,7 +25,13 @@ void Dino::spiBegin(byte settings, uint32_t clockRate){
   byte mode = settings & 0B00001111;
 
   // Bit 7 of settings toggles MSBFIRST.
-  SPI.beginTransaction(SPISettings(clockRate, bitRead(settings, 7), mode));
+  // Don't try to refactor t his and just pass bit 7.
+  // On the Due, MSBFIRST and LSBFIRST are ByteOrder class objects.
+  if (bitRead(settings, 7)) {
+  	SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, mode));
+  } else {
+  	SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, mode));
+  }
 }
 
 // Convenience wrapper for SPI.end

From 589590e84225386c9147ef4891a311a3330d181f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 18:03:23 -0400
Subject: [PATCH 229/296] Update change log with PR message

---
 CHANGELOG.md | 119 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 119 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index dd324ac0..383cab14 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,124 @@
 # Changelog
 
+## 0.12.0
+
+### New Boards
+- The `dino sketch` shell command now accepts a `--target` argument. It includes/excludes features to tailor the sketch for different boards/chips. Run `dino targets` for more info.
+
+- ATmega Based Boards (default) (`--target mega`):
+  - This is the default sketch if `--target` isn't specified, and works for many of the common Arduino products, like the Uno, Nano, Leonardo and Mega.
+
+- ESP8266 (`--target esp8266`):
+  - Works with `Dino::Board.new`, but calling `Dino::Board::ESP8266.new` instead allows pins to be referred to as any of `'GPIO4'`, `4`, or `'D2'`, as printed on dev boards like the NodeMCU or WeMos, with the printed names mapping to the correct GPIO.
+  - Works with either built in WiFi or Serial.
+  - WiFi version supports OTA (over-the-air) update in the Arduino IDE. Initial flash must still be done via serial.
+  - **Note**: SoftwareSerial is incompatible with the ESP8266. LiquidCrystal (LCD) compiles for the ESP8266, but does not work. Both of these are excluded.
+  
+- Arduino Due (`--target due`) :
+  - Up to 12-bit analog in/out. Pass a `bits:` option to `Board#new` to set resolution for both.
+  - DAC support. Refer to DAC pins as `'DAC0'`, `'DAC1'`, just as labeled on the board. Call `#analog_write` or just `#write` on an `AnalogOutput` component that uses the pin.
+  - Uses the native ARM serial port by default. Configurable in sketch to use programming port.
+  - **Note**: SoftwareSerial, Infrared, and Tone are currently incompatible with the Arduino Due, and excluded from the sketch.
+
+- ATmega168 (`--target mega168`):
+  - By excluding a lot of features, we can still fit the memory constraints of the ATmega168 chips found in older Arduinos.
+  -  SoftwareSerial, LCD, OneWire and IROut are compatible, but left out to keep memory usage down.
+  - Included libraries can be toggled in `DinoDefines.h` to suit your needs.
+  - **Note:** Aux message is limited to 264 bytes on the mega168, or less depending on included libraries. The only feature currently affected by this is sending long infrared signals, like for an air conditioner.
+
+#### New Components
+
+- Hitachi HD44780 LCD support. _Uses Arduino `LiquidCrystal` library._
+
+- Seven Segment Display support. _Ruby implementation as multiple LEDs._
+
+- Infrared Emitter support. _Uses [Arduino-IRremote](https://github.com/z3t0/Arduino-IRremote), and the [ESP8266 fork](https://github.com/markszabo/IRremoteESP8266) where applicable._
+
+- Tone (piezo) support. _Uses Arduino `tone`,`noTone` functions._ 
+
+- SoftwareSerial. _Uses Arduino `SoftSerial` library._ (**write only / experimental**)
+
+- Rotary encoder support. _Uses polling method @ 1ms interval._ **WARNING**: Not suitable for high speeds or precise position needs. It will definitely miss steps. Sufficient for using rotary knobs for user input.
+
+- DHT11 / DHT 21 (AM2301) / DHT22 temperature and relative humidity sensor support. _Custom implementation where input pulses are measured on the board, then decoded in Ruby._
+
+- DS3231 RTC (real time clock) over I2C _(Ruby implementation)_
+
+- DS18B20 temperature sensor. _Uses custom implementation of Dallas/Maxim 1-Wire bus below._
+
+- Dallas/Maxim 1-Wire bus support. _Low level timing functions run on the board. High level logic in Ruby._
+  - Most bus features are implemented: reset/presence detect, parasite power handling, bus search and slave device identification, CRC. No overdrive support.
+  - Based on [Kevin Darrah's video](https://www.youtube.com/watch?v=ZKNQhzPwH0s) explaining the DS18B20 datasheet.
+
+- I2C bus support. _Uses Arduino`Wire` library._
+
+- Shift Register support. _Uses Arduino `ShiftOut` and `ShiftIn` functions._
+
+- SPI bus support (_uses Arduino `SPI` library_) :
+  - Read/Write Transfers
+  - Read-Only Listeners (like digital/analog listeners, but reads n bytes from MISO)
+
+- Generic input and output register classes for the above 2: `Register::ShiftIn`, `Register::ShiftOut`, `Register::SPIIn`, `Register::SPIOut`.
+
+- Board EEPROM support. _Uses Arduino `EEPROM` library._
+
+- WiFi shield support (**untested**)
+
+### Changed Components
+- Servos can now be connected to arbitrary pins as long as they are supported by the board.
+
+- Digital and analog listeners now have dividers on a per-pin basis.
+  - Timing is based on a 1000 microsecond tick being counted by the board.
+  - Call `#listen` with a value as the first argument. Eg. `sensor.listen(64)` will tell the board to send us that specific sensor's state every 64 ticks (~64ms)  or around 16 times per second, without affecting other components' rates.
+  - Valid dividers are: `1, 2, 4, 8, 16, 32, 64, 128`.
+  - Defaults are same as before: `4` for digital, `16` for analog.
+
+### Hardware Abstraction
+
+- `MultiPin` abstraction for components using more than one pin:
+  - Components connecting to more than 1 pin, like an RGB LED or rotary encoder, are now modeled as `MultiPin` and contain multiple `SinglePin` proxy components. An `RGBLed` is built from 3 `AnalogOutput`s, for example, one for each color, connected to a separate pin.
+  - `MultiPin` implements a shortcut class method `proxy_pins`. Proxying a pin allows subcomponent pin numbers to be given as a hash when initializing an instance of a `MultiPin` component. Eg: `{red: 9, green: 10, blue: 11}` given as the `pins:` option for `RGBLed#new`.
+  -  When initialized, subcomponents corresponding to the proxied pins are automatically created. They're stored in `#proxies` and `attr_reader` methods are created for each, corresponding to their key in the `pins:` hash. Eg: `RGBLed#green` and `RGBLed#proxies[:green]` both give the `AnalogOutput` component that represents the green LED inside the RGB LED, connected to pin 10.
+
+- `BoardProxy` abstraction for shift/SPI registers:
+  - The `Register` classes implement enough of the `Board` interface to satisfy components based on `DigitalInput` and `DigitalOutput`, such as `Led` or `Button`.
+  - This lets you call methods on components directly, rather than manipulating the register data to control components indirectly. 
+  - Initialize the appropriate `Register` object for the type of register. To initialize a component connected to the register, use the register as the "board", and for the pin, give the parallel I/O pin of the register that the component is connected to. Pin 0 maps to the lowest bit.
+  - This also works for `MultiPin` components built out of only `DigitalInput` and `DigitalOutput`, eg. `SSD` - seven segment display or `RGBLed`. See `examples/register` for more.
+
+### Input Components, Callbacks and State
+- `@value` has been renamed to `@state`.
+  - By default, all components define `#state` and `#state=`, which access `@state` through `@state_mutex`. This way we don't try to read with `#state` while a callback is updating it with `#state=`.
+  - `@state` can be any Ruby object representing the state of the component.
+
+- Callback functionality for components has been extracted into a mixin module, `Mixins::Callbacks`.
+  - Like before, callbacks for all components on a board run sequentially, in a single "update" thread, separate from the main thread. This is the same thread reading from TxRx.
+  - `#add_callback` and `#remove_callback` methods are available, and take an optional `key` as argument.
+  - Blocks given to `#add_callback` are stored in `@callbacks[key]`, to be called later, when the "update" thread receives data for the component. The default key is `:persistent`. 
+  - Each key represents an array of callbacks, so multiple callbacks can share the same key.
+  - Calling `#remove_callbacks` with a key empties that array. Calling with no key removes **all** callbacks for the component.
+  - `#pre_callback_filter` is defined in the `Callbacks` module. The return value of this method is what is given to the component's callbacks and to update its `@state`. By default, it returns whatever was given from the board.
+  - Override `#pre_callback_filter` to process data before giving it to callbacks and `@state`. Eg: given raw bytes from a DHT sensor, process them into a hash containing `:celsius`, `: fahrenheit` and `:humidity` values. That hash is given to to callbacks and `#update_state` instead of the original string of values.
+  - `#update_state` is defined in the `Callbacks` module.  It is called after all callbacks are run and given the return value of `#pre_callback_filter`. By default, it sets `#state=` to that value.
+  - Override it if updating `@state` is more complex than this, but be sure to either use `#state=` only once, or wrap the operation in `@state_mutex.synchronize`.
+
+- Input components no longer automatically start listening when created, since there are more options for reading inputs.
+  - `DigitalInput` and its subclasses are the exception to this. They automatically listen, since there is little advantage to other modes.
+
+- Input components can have any combination of `#read`, `#poll` and `#listen` methods now, coming from `Reader`, `Poller`, and `Listener` respectively, inside `Mixins`.
+  - `#read` sends a single read command by calling `#_read`, and blocks the main thread, until `data` is received from `#pre_callback_filter`. When received, any block given to `#read` will run in the "update" thread once and be removed immediately. `#read` then stops blocking the main thread and returns `data`.
+  - `#poll` requires an interval (in seconds) as its first argument. It starts a new thread, and keeps calling `#_read` in it, at the given interval. `#poll` does not block the main thread, and does not return a value. A block given will be added as a callback inside the `:poll` key.
+  - `#listen` adds its block as a callback inside the `:listen` key, calls `#_listen` and returns immediately.
+  - `#stop` stops polling **and** listening. It also **removes all callbacks** in the **`:poll` and `:listen` keys** (callbacks added as blocks when polling or listening).
+
+### Minor Changes
+- Serial communication now uses the [`rubyserial`](https://github.com/hybridgroup/rubyserial) gem instead of [`serialport`](https://github.com/hparra/ruby-serialport).
+- Added more useful information and errors during the connect & handshake process.
+- Extended message syntax so the Arduino can receive arbitrary length messages, including binary.
+- Created `Dino::Message` class to handle message construction.
+- Moved CLI into it's own class, `Dino::CLI`.
+- Added simple flow control to avoid overrunning the 64 byte input buffer in the Arduino `Serial` library. No flow control for Ruby receiving data.
+
 ## 0.11.3
 * Backport bug fixes from 0.12:
   * Listeners weren't working properly on the Arduino MEGA.

From ee96dae96d7b6f221c4ec86dbd5711c1d7e5971d Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 18:16:56 -0400
Subject: [PATCH 230/296] Change #update_self to #update_state for more clarity

---
 CHANGELOG.md                              | 3 ++-
 lib/dino/components/basic/board_eeprom.rb | 6 ++++--
 lib/dino/components/mixins/callbacks.rb   | 8 ++++----
 lib/dino/components/rotary_encoder.rb     | 2 +-
 test/components/mixins/callbacks_test.rb  | 2 +-
 5 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 383cab14..5a239b45 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -26,7 +26,7 @@
   - Included libraries can be toggled in `DinoDefines.h` to suit your needs.
   - **Note:** Aux message is limited to 264 bytes on the mega168, or less depending on included libraries. The only feature currently affected by this is sending long infrared signals, like for an air conditioner.
 
-#### New Components
+### New Components
 
 - Hitachi HD44780 LCD support. _Uses Arduino `LiquidCrystal` library._
 
@@ -113,6 +113,7 @@
 
 ### Minor Changes
 - Serial communication now uses the [`rubyserial`](https://github.com/hybridgroup/rubyserial) gem instead of [`serialport`](https://github.com/hparra/ruby-serialport).
+- Switched from `respec` to `minitest` for testing.
 - Added more useful information and errors during the connect & handshake process.
 - Extended message syntax so the Arduino can receive arbitrary length messages, including binary.
 - Created `Dino::Message` class to handle message construction.
diff --git a/lib/dino/components/basic/board_eeprom.rb b/lib/dino/components/basic/board_eeprom.rb
index c6c3dbc4..c3e49a42 100644
--- a/lib/dino/components/basic/board_eeprom.rb
+++ b/lib/dino/components/basic/board_eeprom.rb
@@ -56,8 +56,10 @@ def pre_callback_filter(message)
           {address: address, data: bytes}
         end
 
-        def update_self(hash)
-          self.state[hash[:address], hash[:data].length] = hash[:data]
+        def update_state(hash)
+          @state_mutex.synchronize do
+            @state[hash[:address], hash[:data].length] = hash[:data]
+          end
         end
 
         def pin
diff --git a/lib/dino/components/mixins/callbacks.rb b/lib/dino/components/mixins/callbacks.rb
index 24098080..c63e2607 100644
--- a/lib/dino/components/mixins/callbacks.rb
+++ b/lib/dino/components/mixins/callbacks.rb
@@ -31,19 +31,19 @@ def remove_callback(key=nil)
         alias :remove_callbacks :remove_callback
 
         def update(data)
-          data = pre_callback_filter(data)
+          filtered_data = pre_callback_filter(data)
 
           callback_mutex.synchronize do
             @callbacks.each_value do |array|
               array.each do |callback|
-                callback.call(data)
+                callback.call(filtered_data)
               end
             end
             # Remove special :read callback before unlocking.
             @callbacks.delete(:read)
           end
 
-          update_self(data)
+          update_state(filtered_data)
         end
 
         # Override this to process data before passing to callbacks.
@@ -52,7 +52,7 @@ def pre_callback_filter(data)
         end
 
         # Override if behavior other than @state = filtered data is needed.
-        def update_self(filtered_data)
+        def update_state(filtered_data)
           self.state = filtered_data
         end
       end
diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index 477d369d..e9d04f7d 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -77,7 +77,7 @@ def pre_callback_filter(step)
       #
       # After callbacks, set state to the hash from before, except change.
       #
-      def update_self(new_state)
+      def update_state(new_state)
         self.state = new_state.except(:change)
       end
     end
diff --git a/test/components/mixins/callbacks_test.rb b/test/components/mixins/callbacks_test.rb
index 61dca871..00eb28aa 100644
--- a/test/components/mixins/callbacks_test.rb
+++ b/test/components/mixins/callbacks_test.rb
@@ -81,7 +81,7 @@ def test_pre_callback_filter_modifies_data
     cb.verify
   end
 
-  def test_update_self
+  def test_update_state
     part.update("test")
     assert_equal "dino: test", part.state
   end

From b0c98a66e3e32f5b103f39819371c99717285d52 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 20:03:00 -0400
Subject: [PATCH 231/296] Tests

---
 lib/dino/board/base.rb                        |  2 +-
 lib/dino/components.rb                        |  2 +-
 lib/dino/components/mixins/listener.rb        |  3 +++
 lib/dino/components/register/select.rb        | 15 +++++------
 lib/dino/components/register/shift_in.rb      | 18 +++++--------
 lib/dino/components/register/shift_out.rb     |  4 ---
 lib/dino/components/setup/input.rb            |  2 +-
 lib/dino/components/setup/single_pin.rb       |  2 +-
 .../{softserial.rb => software_serial.rb}     |  0
 test/board_test.rb                            |  3 ++-
 test/components/mixins/listener_test.rb       |  5 ++++
 test/components/mixins/reader_test.rb         | 16 +++++++++---
 test/components/register/select_test.rb       | 22 ++++------------
 test/components/register/shift_in_test.rb     |  4 ---
 test/components/register/shift_out_test.rb    |  4 ---
 test/components/setup/base_test.rb            | 26 ++++++++++++++++++-
 test/components/setup/input_test.rb           |  9 +++++++
 test/components/setup/output_test.rb          |  6 +----
 test/components/setup/single_pin_test.rb      | 10 ++++++-
 19 files changed, 88 insertions(+), 65 deletions(-)
 rename lib/dino/components/{softserial.rb => software_serial.rb} (100%)

diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index 84656af3..02b2c0a5 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -62,7 +62,7 @@ def add_component(component)
       end
 
       def remove_component(component)
-        stop_listener(component.pin)
+        component.stop if component.methods.include? :stop
         @components.delete(component)
       end
     end
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index a29c5a45..30931282 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -15,7 +15,7 @@ module Components
     autoload :Stepper,          'dino/components/stepper'
     autoload :LCD,              'dino/components/lcd'
     autoload :Relay,            'dino/components/relay'
-    autoload :SoftwareSerial,   'dino/components/softserial'
+    autoload :SoftwareSerial,   'dino/components/software_serial'
     autoload :DHT,              'dino/components/dht'
     autoload :IREmitter,        'dino/components/ir_emitter'
     autoload :Piezo,            'dino/components/piezo'
diff --git a/lib/dino/components/mixins/listener.rb b/lib/dino/components/mixins/listener.rb
index da450e03..fd89b8e9 100644
--- a/lib/dino/components/mixins/listener.rb
+++ b/lib/dino/components/mixins/listener.rb
@@ -3,8 +3,11 @@ module Components
     module Mixins
       module Listener
       	include Callbacks
+        
+        attr_reader :divider
 
         def listen(divider=nil, &block)
+          @divider = divider
           stop
           add_callback(:listen, &block) if block_given?
           _listen(divider)
diff --git a/lib/dino/components/register/select.rb b/lib/dino/components/register/select.rb
index 6abe23ee..012c0642 100644
--- a/lib/dino/components/register/select.rb
+++ b/lib/dino/components/register/select.rb
@@ -3,21 +3,18 @@ module Components
     module Register
       class Select
         #
-        # Register select is an active-low output pin, used to choose which
-        # register on a bus we're accessing. For input registers, the board
-        # sends readings prefixed with the register select pin number, since
-        # each register uses a unique select pin, while clock and data are shared.
+        # Register select is an active-low output pin, used to select a device
+        # on a bus for access. For input registers, the board sends bytes
+        # as if they were coming from this pin. Each register uses a unique
+        # select pin, so we can identify which Register object the incoming bytes
+        # belong to. Devices on the same bus share the clock and data pins.
         #
         # There is no need to write this pin directly, but it must be in output
-        # mode, and must follow the callback pattern to receive updates.
+        # mode, and must include Callbacks to receieve updates.
         #
         include Setup::SinglePin
         include Setup::Output
         include Mixins::Callbacks
-
-        def initialize_pins(options={})
-          super(options) if defined?(super)
-        end
       end
     end
   end
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 84420bb7..a7745dfe 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -20,10 +20,6 @@ def after_initialize(options={})
           self.rising_clock = options[:rising_clock]
           bubble_callbacks
         end
-        
-        def pin
-          latch.pin
-        end
 
         #
         # Some registers use rising edges for clock signals. Unless we pull clock
@@ -36,13 +32,6 @@ def rising_clock=(value)
           @rising_clock = [0, nil, false].include?(value) ? false : true
         end
 
-        # Reads come through the latch pin. Bubble them up to ourselves.
-        def bubble_callbacks
-          proxies[:latch].add_callback do |byte|
-            self.update(byte)
-          end
-        end
-
         def read(num_bytes=@bytes)
           board.shift_read latch.pin, data.pin, clock.pin, num_bytes,
                            preclock_high: rising_clock
@@ -56,6 +45,13 @@ def listen(num_bytes=@bytes)
         def stop
           board.shift_stop(latch.pin)
         end
+        
+        # Reads come through the latch pin. Bubble them up to ourselves.
+        def bubble_callbacks
+          proxies[:latch].add_callback do |byte|
+            self.update(byte)
+          end
+        end
       end
     end
   end
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index fd545c89..b3de0fc4 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -18,10 +18,6 @@ class ShiftOut
         def write(*bytes)
           board.shift_write(latch.pin, data.pin, clock.pin, bytes)
         end
-        
-        def pin
-          latch.pin
-        end
       end
     end
   end
diff --git a/lib/dino/components/setup/input.rb b/lib/dino/components/setup/input.rb
index 8362b12a..52df4f8d 100644
--- a/lib/dino/components/setup/input.rb
+++ b/lib/dino/components/setup/input.rb
@@ -3,7 +3,7 @@ module Components
     module Setup
       module Input
         include SinglePin
-        attr_reader :pullup, :divider
+        attr_reader :pullup
 
         def pullup=(pullup)
           @pullup = pullup
diff --git a/lib/dino/components/setup/single_pin.rb b/lib/dino/components/setup/single_pin.rb
index 4ae5286f..3dac83c5 100644
--- a/lib/dino/components/setup/single_pin.rb
+++ b/lib/dino/components/setup/single_pin.rb
@@ -18,8 +18,8 @@ def initialize_pins(options={})
         end
 
         def mode=(mode)
-          @mode = mode
           board.set_pin_mode(pin, mode)
+          @mode = mode
         end
       end
     end
diff --git a/lib/dino/components/softserial.rb b/lib/dino/components/software_serial.rb
similarity index 100%
rename from lib/dino/components/softserial.rb
rename to lib/dino/components/software_serial.rb
diff --git a/test/board_test.rb b/test/board_test.rb
index d5c72110..275e3ebf 100644
--- a/test/board_test.rb
+++ b/test/board_test.rb
@@ -73,7 +73,8 @@ def test_eeprom
 
   def test_add_remove_component
     mock = MiniTest::Mock.new
-    mock.expect(:pin, 1)
+    mock.expect(:methods, [:stop])
+    mock.expect(:stop, true)
 
     board.add_component(mock)
     assert_equal [mock], board.components
diff --git a/test/components/mixins/listener_test.rb b/test/components/mixins/listener_test.rb
index 801bda2f..e57fb3bb 100644
--- a/test/components/mixins/listener_test.rb
+++ b/test/components/mixins/listener_test.rb
@@ -21,6 +21,11 @@ def test_include_callbacks
     assert_includes ListenerComponent.ancestors,
                     Dino::Components::Mixins::Callbacks
   end
+  
+  def test_divider_save_and_read
+    part.listen(4)
+    assert_equal part.divider, 4
+  end
 
   def test_call_stop_before_listening
     mock = MiniTest::Mock.new.expect :call, nil
diff --git a/test/components/mixins/reader_test.rb b/test/components/mixins/reader_test.rb
index 19dac6e5..32d3acf4 100644
--- a/test/components/mixins/reader_test.rb
+++ b/test/components/mixins/reader_test.rb
@@ -39,10 +39,18 @@ def test_read_once
     part.stub(:_read, mock) { part.read }
     mock.verify
   end
-
-  # test returns read value
-  # test blocks main thread
-  # test read_using -> {}
+  
+  def test_return_value
+    inject(42)
+    assert_equal part.read, 42
+  end
+  
+  def test_read_using
+    inject(1)
+    reader = MiniTest::Mock.new.expect :call, nil
+    part.read_using -> { reader.call }
+    reader.verify
+  end
 
   def test_add_run_remove_callback
     cb = MiniTest::Mock.new.expect :call, nil
diff --git a/test/components/register/select_test.rb b/test/components/register/select_test.rb
index 2ea99ea6..6351d8d4 100644
--- a/test/components/register/select_test.rb
+++ b/test/components/register/select_test.rb
@@ -1,23 +1,11 @@
 require 'test_helper'
 
 class RegisterSelectTest < Minitest::Test
-  def board
-    @board ||= BoardMock.new
-  end
-
-  def part
-    @part ||= Dino::Components::Register::Select.new(board: board, pin: 14)
-  end
-
-  def test_default_to_output
-    mock = MiniTest::Mock.new.expect :call, nil, [14, :out]
-    board.stub(:set_pin_mode, mock) do
-      part
-    end
-    mock.verify
-  end
-
-  def test_callbacks
+  def test_includes
+    assert_includes Dino::Components::Register::Select.ancestors,
+                    Dino::Components::Setup::SinglePin
+    assert_includes Dino::Components::Register::Select.ancestors,
+                    Dino::Components::Setup::Output
     assert_includes Dino::Components::Register::Select.ancestors,
                     Dino::Components::Mixins::Callbacks
   end
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
index 8a83fa3e..68618214 100644
--- a/test/components/register/shift_in_test.rb
+++ b/test/components/register/shift_in_test.rb
@@ -18,10 +18,6 @@ def test_proxies
     assert_equal Dino::Components::Basic::DigitalInput,  part.data.class
     assert_equal Dino::Components::Register::Select,     part.latch.class
   end
-  
-  def test_identifies_with_latch_pin
-    assert_equal 8, part.pin
-  end
 
   def test_byte_length
     new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
diff --git a/test/components/register/shift_out_test.rb b/test/components/register/shift_out_test.rb
index 35969007..5ad79f5c 100644
--- a/test/components/register/shift_out_test.rb
+++ b/test/components/register/shift_out_test.rb
@@ -18,10 +18,6 @@ def test_proxies
     assert_equal Dino::Components::Basic::DigitalOutput, part.data.class
     assert_equal Dino::Components::Register::Select,     part.latch.class
   end
-  
-  def test_identifies_with_latch_pin
-    assert_equal 8, part.pin
-  end
 
   def test_write
     # mock = MiniTest::Mock.new.expect :call, nil, ["21.8.1.#{[11,12,0,255,127].pack('C*')}\n"]
diff --git a/test/components/setup/base_test.rb b/test/components/setup/base_test.rb
index ff18b02e..934e0f2b 100644
--- a/test/components/setup/base_test.rb
+++ b/test/components/setup/base_test.rb
@@ -8,17 +8,41 @@ class BaseSetupTest < Minitest::Test
   def board
     @board ||= BoardMock.new
   end
+  
+  def part
+    @part ||= BaseComponent.new(board: board)
+  end
 
   def test_requires_board
     assert_raises(ArgumentError) { BaseComponent.new }
   end
 
   def test_registers_with_board
-    part = BaseComponent.new(board: board)
     assert_equal board.components, [part]
   end
   
+  def test_unregisters_with_board
+    part.send(:unregister)
+    assert_equal board.components, []
+  end
+  
   def test_start_with_nil_state
     assert_nil BaseComponent.new(board: board).state
   end
+  
+  def test_sets_and_gets_state
+    part.send(:state=, 10)
+    assert_equal part.state, 10
+  end
+  
+  def test_state_through_mutex
+    mock = MiniTest::Mock.new
+    2.times {mock.expect(:call, nil)}
+    
+    part.instance_variable_get(:@state_mutex).stub(:synchronize, mock) do
+      part.state
+      part.send(:state=, nil)
+    end
+    mock.verify
+  end
 end
diff --git a/test/components/setup/input_test.rb b/test/components/setup/input_test.rb
index d960c2b6..164fb286 100644
--- a/test/components/setup/input_test.rb
+++ b/test/components/setup/input_test.rb
@@ -30,6 +30,15 @@ def test_pullup
     end
     mock.verify
   end
+  
+  def test_stop_listener
+    mock = Minitest::Mock.new
+    mock.expect :call, nil, [1]
+    board.stub(:stop_listener, mock) do
+      part._stop_listener
+    end
+    mock.verify
+  end
 
   def test_pullup_in_options
     mock = Minitest::Mock.new.expect :call, nil, [2, true]
diff --git a/test/components/setup/output_test.rb b/test/components/setup/output_test.rb
index 8ac78e92..be44580a 100644
--- a/test/components/setup/output_test.rb
+++ b/test/components/setup/output_test.rb
@@ -14,10 +14,6 @@ def part
   end
 
   def test_pin_mode
-    mock = Minitest::Mock.new.expect :call, nil, [1, :out]
-    board.stub(:set_pin_mode, mock) do
-      part
-    end
-    mock.verify
+    assert_equal part.mode, :out
   end
 end
diff --git a/test/components/setup/single_pin_test.rb b/test/components/setup/single_pin_test.rb
index a46ecaa1..7d67cc7b 100644
--- a/test/components/setup/single_pin_test.rb
+++ b/test/components/setup/single_pin_test.rb
@@ -1,7 +1,7 @@
 require 'test_helper'
 
 class SinglePinComponent
-  include Dino::Components::Setup::Input
+  include Dino::Components::Setup::SinglePin
 end
 
 class SinglePinSetupTest < Minitest::Test
@@ -16,4 +16,12 @@ def part
   def test_requires_pin
     assert_raises(ArgumentError) { SinglePinComponent.new(board: board) }
   end
+  
+  def test_mode=
+    mock = Minitest::Mock.new
+    mock.expect :call, nil, [1, :out] 
+    board.stub(:set_pin_mode, mock) do
+      part.send(:mode=, :out)
+    end
+  end
 end

From 4f7ee25def14ec9a465718973c347709da2d07f8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 11 Feb 2023 20:09:38 -0400
Subject: [PATCH 232/296] Fix spelling of Fahrenheit in variable names

---
 examples/dht/dht.rb                      | 2 +-
 examples/one_wire/ds18b20.rb             | 2 +-
 lib/dino/components/dht.rb               | 4 ++--
 lib/dino/components/one_wire/ds18b20.rb  | 4 ++--
 test/components/dht_test.rb              | 2 +-
 test/components/one_wire/ds18b20_test.rb | 8 ++++----
 6 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/examples/dht/dht.rb b/examples/dht/dht.rb
index 63d127b7..f2f07ed5 100644
--- a/examples/dht/dht.rb
+++ b/examples/dht/dht.rb
@@ -14,7 +14,7 @@
   if reading[:error]
     puts "Error: #{reading[:error]}"
   else
-    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:farenheit]} \xC2\xB0F | "
+    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:fahrenheit]} \xC2\xB0F | "
     puts "#{reading[:humidity]}% relative humidity"
   end
 end
diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index afe24c07..49ce8f43 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -44,7 +44,7 @@ def print_reading(reading, sensor)
   if reading[:crc_error]
     puts "CRC check failed for this reading!"
   else
-    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:farenheit]} \xC2\xB0F | "
+    print "#{reading[:celsius]} \xC2\xB0C | #{reading[:fahrenheit]} \xC2\xB0F | "
     puts "Raw: #{reading[:raw].inspect}"
   end
 end
diff --git a/lib/dino/components/dht.rb b/lib/dino/components/dht.rb
index 46438eae..0c91635c 100644
--- a/lib/dino/components/dht.rb
+++ b/lib/dino/components/dht.rb
@@ -31,9 +31,9 @@ def decode(data)
 
         celsius   = ((bytes[2] << 8) | bytes[3]).to_f / 10
         humidity  = ((bytes[0] << 8) | bytes[1]).to_f / 10
-        farenheit = (celsius * 1.8 + 32).round(1)
+        fahrenheit = (celsius * 1.8 + 32).round(1)
 
-        { celsius: celsius, farenheit: farenheit, humidity: humidity }
+        { celsius: celsius, fahrenheit: fahrenheit, humidity: humidity }
       end
 
       def crc(bytes)
diff --git a/lib/dino/components/one_wire/ds18b20.rb b/lib/dino/components/one_wire/ds18b20.rb
index 8aaf0245..853b441c 100644
--- a/lib/dino/components/one_wire/ds18b20.rb
+++ b/lib/dino/components/one_wire/ds18b20.rb
@@ -60,9 +60,9 @@ def pre_callback_filter(bytes)
         #
         def decode_temperature(bytes)
           celsius = bytes[0..1].pack('C*').unpack('s<')[0] * (2.0 ** -4)
-          farenheit = (celsius * 1.8 + 32).round(4)
+          fahrenheit = (celsius * 1.8 + 32).round(4)
 
-          {celsius: celsius, farenheit: farenheit}
+          {celsius: celsius, fahrenheit: fahrenheit}
         end
 
         def decode_resolution(bytes)
diff --git a/test/components/dht_test.rb b/test/components/dht_test.rb
index 911638d3..bf67c339 100644
--- a/test/components/dht_test.rb
+++ b/test/components/dht_test.rb
@@ -55,7 +55,7 @@ def test_decode
     
     # It should calculate output correctly.
     result = part.decode(GOOD_ARRAY)
-    assert_equal result, {celsius: 29.5, farenheit: 85.1, humidity: 66.9}
+    assert_equal result, {celsius: 29.5, fahrenheit: 85.1, humidity: 66.9}
   end
   
   def test_crc
diff --git a/test/components/one_wire/ds18b20_test.rb b/test/components/one_wire/ds18b20_test.rb
index 8a6c1499..301a7a78 100644
--- a/test/components/one_wire/ds18b20_test.rb
+++ b/test/components/one_wire/ds18b20_test.rb
@@ -10,13 +10,13 @@ def part
   end
 
   def test_decode_temperatures
-    assert_equal({ celsius: 125, farenheit: 257 },
+    assert_equal({ celsius: 125, fahrenheit: 257 },
                  part.decode_temperature([0b1101_0000,0b0000_0111]))
-    assert_equal({ celsius: 0, farenheit: 32 },
+    assert_equal({ celsius: 0, fahrenheit: 32 },
                  part.decode_temperature([0b0000_0000,0b0000_0000]))
-    assert_equal({ celsius: -10.125, farenheit: 13.775 },
+    assert_equal({ celsius: -10.125, fahrenheit: 13.775 },
                  part.decode_temperature([0b0101_1110,0b1111_1111]))
-    assert_equal({ celsius: -55, farenheit: -67 },
+    assert_equal({ celsius: -55, fahrenheit: -67 },
                  part.decode_temperature([0b1001_0000,0b1111_1100]))
   end
 

From fde8ee77a820952e328d09392b994ac1c86a917d Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 12 Feb 2023 13:08:12 -0400
Subject: [PATCH 233/296] Tests for ShiftIO register interface

---
 lib/dino/api/shift_io.rb  | 10 +++---
 test/api/servo_test.rb    |  2 --
 test/api/shift_io_test.rb | 71 +++++++++++++++++++++++++++++++++++++++
 test/api/spi_test.rb      |  1 +
 4 files changed, 77 insertions(+), 7 deletions(-)
 create mode 100644 test/api/shift_io_test.rb

diff --git a/lib/dino/api/shift_io.rb b/lib/dino/api/shift_io.rb
index f1f2b3de..f6a4ddb8 100644
--- a/lib/dino/api/shift_io.rb
+++ b/lib/dino/api/shift_io.rb
@@ -12,12 +12,12 @@ def shift_write(latch, data, clock, byte_array, options={})
         settings = shift_settings(data, clock)
         limit = aux_limit - settings.length
         bytes = pack :uint8,
-                     byte_array,
-                     max: (limit < 256) ? limit : 256
+                     [byte_array].flatten,
+                     max: limit
 
         write Message.encode command: 21,
                              pin: convert_pin(latch),
-                             value: bytes.length, # Should be length-1 so 0 = 1 byte, 255 = 256 bytes
+                             value: bytes.length,
                              aux_message: settings + bytes
       end
 
@@ -25,7 +25,7 @@ def shift_read(latch, data, clock, num_bytes, options={})
         settings = shift_settings(data, clock, options[:preclock_high])
         write Message.encode command: 22,
                              pin: convert_pin(latch),
-                             value: num_bytes, # Should be num-1 so 0 = 1 byte, 255 = 256 bytes
+                             value: num_bytes,
                              aux_message: settings
       end
 
@@ -33,7 +33,7 @@ def shift_listen(latch, data, clock, num_bytes, options={})
         settings = shift_settings(data, clock, options[:preclock_high])
         write Message.encode command: 23,
                              pin: convert_pin(latch),
-                             value: num_bytes, # Should be num-1 so 0 = 1 byte, 255 = 256 bytes
+                             value: num_bytes,
                              aux_message: settings
       end
 
diff --git a/test/api/servo_test.rb b/test/api/servo_test.rb
index 76f1b6e7..9eecd34f 100644
--- a/test/api/servo_test.rb
+++ b/test/api/servo_test.rb
@@ -1,5 +1,3 @@
-# For convenience when validating longer data types.
-
 require 'test_helper'
 
 class APIServoTest < Minitest::Test
diff --git a/test/api/shift_io_test.rb b/test/api/shift_io_test.rb
new file mode 100644
index 00000000..45c71174
--- /dev/null
+++ b/test/api/shift_io_test.rb
@@ -0,0 +1,71 @@
+# encoding: ascii-8bit
+# For convenience when validating longer data types.
+
+require 'test_helper'
+
+class APIShiftIOTest < Minitest::Test
+  include Dino::API::Helper
+  
+  def txrx
+    @txrx ||= TxRxMock.new
+  end
+
+  def board
+    @board ||= Dino::Board.new(txrx)
+  end
+  
+  def test_shift_settings
+    settings1 = pack :uint8, [4, 5, 1]
+    settings2 = pack :uint8, [6, 7, 0]
+    assert_equal board.shift_settings(4, 5, true), settings1
+    assert_equal board.shift_settings(6, 7), settings2
+  end
+  
+  def test_shift_write
+    settings = board.shift_settings(4, 5)
+    bytes1 = pack :uint8, [1,2,3]
+    bytes2 = pack :uint8, [25]
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 21, pin: 3, value: 3, aux_message: settings + bytes1)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 21, pin: 3, value: 1, aux_message: settings + bytes2)]
+    
+    board.stub(:write, mock) do
+      board.shift_write(3, 4, 5, [1,2,3])
+      board.shift_write(3, 4, 5, 25)
+    end
+  end
+
+  def test_shift_read
+    settings1 = board.shift_settings(4, 5)
+    settings2 = board.shift_settings(4, 5, true)
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 22, pin: 3, value: 8, aux_message: settings1)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 22, pin: 3, value: 4, aux_message: settings2)]
+    
+    board.stub(:write, mock) do
+      board.shift_read(3, 4, 5, 8)
+      board.shift_read(3, 4, 5, 4, preclock_high: true)
+    end
+  end
+  
+  def test_shift_listen
+    settings1 = board.shift_settings(4, 5)
+    settings2 = board.shift_settings(4, 5, true)
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 23, pin: 3, value: 8, aux_message: settings1)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 23, pin: 3, value: 4, aux_message: settings2)]
+  
+    board.stub(:write, mock) do
+      board.shift_listen(3, 4, 5, 8)
+      board.shift_listen(3, 4, 5, 4, preclock_high: true)
+    end
+  end
+
+  def test_shift_stop
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [Dino::Message.encode(command: 24, pin: 3)]
+    board.stub(:write, mock) do
+      board.shift_stop(3)
+    end
+  end
+end
diff --git a/test/api/spi_test.rb b/test/api/spi_test.rb
index af824f7e..136d33db 100644
--- a/test/api/spi_test.rb
+++ b/test/api/spi_test.rb
@@ -1,3 +1,4 @@
+# encoding: ascii-8bit
 # For convenience when validating longer data types.
 
 require 'test_helper'

From 1e442d5e4163aabe9ca02b15704c1af4bf2226f8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 12 Feb 2023 18:29:32 -0400
Subject: [PATCH 234/296] Make tone work with freq/duration above 4 digits, or
 no duration at all

---
 lib/dino/api/shift_io.rb      |  4 ++--
 lib/dino/api/tone.rb          | 17 +++++++++++------
 lib/dino/components/piezo.rb  |  2 +-
 src/lib/DinoTone.cpp          | 11 +++++++++--
 test/api/tone_test.rb         | 11 ++++++++++-
 test/components/piezo_test.rb | 33 +++++++++++++++++++++++++++++++++
 6 files changed, 66 insertions(+), 12 deletions(-)
 create mode 100644 test/components/piezo_test.rb

diff --git a/lib/dino/api/shift_io.rb b/lib/dino/api/shift_io.rb
index f6a4ddb8..dcc79baf 100644
--- a/lib/dino/api/shift_io.rb
+++ b/lib/dino/api/shift_io.rb
@@ -8,11 +8,11 @@ def shift_settings(data, clock, preclock_high=false)
         pack :uint8, [convert_pin(data), convert_pin(clock), preclock_high]
       end
 
-      def shift_write(latch, data, clock, byte_array, options={})
+      def shift_write(latch, data, clock, bytes, options={})
         settings = shift_settings(data, clock)
         limit = aux_limit - settings.length
         bytes = pack :uint8,
-                     [byte_array].flatten,
+                     bytes,
                      max: limit
 
         write Message.encode command: 21,
diff --git a/lib/dino/api/tone.rb b/lib/dino/api/tone.rb
index 9f4a7170..8faf8fd4 100644
--- a/lib/dino/api/tone.rb
+++ b/lib/dino/api/tone.rb
@@ -2,15 +2,20 @@ module Dino
   module API
     module Tone
       include Helper
+      
+      def tone(pin, frequency, duration=nil)
+        if frequency < 31
+          raise ArgumentError, "Tone cannot generate frequencies lower than 31Hz"
+        end
+        
+        # Pack the frequency and optiona duration as binary.
+        aux = pack(:uint16, frequency)
+        aux << pack(:uint32, duration) if duration
 
-      # value = tone frequency in Hz (should be sent as binary to allow higher than 9999, and limit to above 30Hz)
-      # duration = tone duration in ms
-      # duration currently sent as string. Should be binary and max limited to uint32
-      def tone(pin, value, duration)
         write Dino::Message.encode command: 17,
                                    pin: convert_pin(pin),
-                                   value: value,
-                                   aux_message: duration
+                                   value: duration ? 1 : 0,
+                                   aux_message: aux
       end
 
       def no_tone(pin)
diff --git a/lib/dino/components/piezo.rb b/lib/dino/components/piezo.rb
index c1f558e2..2e840fc8 100644
--- a/lib/dino/components/piezo.rb
+++ b/lib/dino/components/piezo.rb
@@ -11,7 +11,7 @@ def after_initialize(options={})
       end
 
       # Duration is in mills
-      def tone(value, duration = 500)
+      def tone(value, duration=nil)
         board.tone(pin, value, duration)
       end
 
diff --git a/src/lib/DinoTone.cpp b/src/lib/DinoTone.cpp
index e15caf3f..db4bb233 100644
--- a/src/lib/DinoTone.cpp
+++ b/src/lib/DinoTone.cpp
@@ -6,8 +6,15 @@
 
 // CMD = 20
 void Dino::tone() {
-  unsigned int duration = atoi((char*)auxMsg);
-  ::tone(pin, val, duration);
+  uint16_t frequency = auxMsg[0];
+  uint32_t duration = auxMsg[2];
+  
+  // val is 1 if a duration was given, 0 if not.
+  if (val !=0) {
+    ::tone(pin, frequency, duration);
+  } else {
+	::tone(pin, frequency);
+  }
 }
 
 // CMD = 21
diff --git a/test/api/tone_test.rb b/test/api/tone_test.rb
index e5d160fb..c4457fcd 100644
--- a/test/api/tone_test.rb
+++ b/test/api/tone_test.rb
@@ -13,13 +13,22 @@ def board
 
   def test_tone
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [Dino::Message.encode(command: 17, pin: 10, value: 150, aux_message: 2000)]
+    aux1 = pack(:uint16, 150) + pack(:uint32, 2000)
+    aux2 = pack(:uint16, 300)
+    
+    mock.expect :call, nil, [Dino::Message.encode(command: 17, pin: 10, value: 1, aux_message: aux1)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 17, pin: 10, value: 0, aux_message: aux2)]
 
     board.stub(:write, mock) do
       board.tone(10, 150, 2000)
+      board.tone(10, 300)
     end
     mock.verify
   end
+  
+  def test_tone_prevents_low_frequencies
+    assert_raises(ArgumentError, /freq/i) { board.tone(4, 30, 3000) }
+  end
 
   def test_no_tone
     mock = MiniTest::Mock.new
diff --git a/test/components/piezo_test.rb b/test/components/piezo_test.rb
new file mode 100644
index 00000000..6d9e81b6
--- /dev/null
+++ b/test/components/piezo_test.rb
@@ -0,0 +1,33 @@
+require 'test_helper'
+
+class PiezoTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Piezo.new(board: board, pin:8)
+  end
+
+  def test_low_on_initialize
+    assert_equal part.state, board.low
+  end
+  
+  def test_tone
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [part.pin, 60, nil]
+    mock.expect :call, nil, [part.pin, 120, 2000]
+    board.stub(:tone, mock) do
+      part.tone(60)
+      part.tone(120, 2000)
+    end
+  end
+  
+  def test_no_tone
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [part.pin]
+    board.stub(:tone, mock) do
+      part.no_tone
+    end
+  end
+end

From 809454714f622c7aac27a99da74cbf1674ed0eb5 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 12 Feb 2023 23:46:22 -0400
Subject: [PATCH 235/296] Let DigitalOutput take strings and nil. Let
 components on ESP8266 have nil pin

---
 lib/dino/board/esp8266.rb                    | 3 ++-
 lib/dino/components/basic/digital_output.rb  | 1 +
 test/components/basic/digital_output_test.rb | 9 ++++++++-
 3 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/lib/dino/board/esp8266.rb b/lib/dino/board/esp8266.rb
index cbd28e5c..eba38e4b 100644
--- a/lib/dino/board/esp8266.rb
+++ b/lib/dino/board/esp8266.rb
@@ -29,13 +29,14 @@ class ESP8266 < Base
       }
 
       def convert_pin(pin)
+        return nil                   if pin == nil
         pin = pin.to_s
         return pin.to_i              if pin.match(RAW_REGEX)
         return gpio_pin_to_i(pin)    if pin.match(GPIO_REGEX)
         return analog_pin_to_i(pin)  if pin.match(ANALOG_REGEX)
         return digital_pin_to_i(pin) if pin.match(DIGITAL_REGEX)
         return "EE"                  if pin == "EE"
-        raise ArgumentError, "incorrect pin format"
+        raise ArgumentError, "incorrect pin format: #{pin.inspect}"
       end
 
       # Only one analog in on the ESP8266, GPIO 17.
diff --git a/lib/dino/components/basic/digital_output.rb b/lib/dino/components/basic/digital_output.rb
index 280694c4..48415fe8 100644
--- a/lib/dino/components/basic/digital_output.rb
+++ b/lib/dino/components/basic/digital_output.rb
@@ -18,6 +18,7 @@ def pre_callback_filter(board_state)
         end
 
         def digital_write(value)
+          value = value.to_i
           value = board.high unless (value == board.low)
           board.digital_write(pin, @state = value)
         end
diff --git a/test/components/basic/digital_output_test.rb b/test/components/basic/digital_output_test.rb
index 3b5d30b9..6ea4de46 100644
--- a/test/components/basic/digital_output_test.rb
+++ b/test/components/basic/digital_output_test.rb
@@ -19,9 +19,16 @@ def read_state_on_initialize
 
   def test_digital_write
     part
-    mock = MiniTest::Mock.new.expect :call, nil, [14, board.high]
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [14, board.high]
+    mock.expect :call, nil, [14, board.low]
+    mock.expect :call, nil, [14, board.low]
+    mock.expect :call, nil, [14, board.high]
     board.stub(:digital_write, mock) do
       part.digital_write(board.high)
+      part.digital_write(nil)
+      part.digital_write("0")
+      part.digital_write("1")
     end
     mock.verify
     assert_equal board.high, part.state

From 8693e6abaa9f0966bd6d5896a9f3b8bd57452cdc Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 13 Feb 2023 16:00:56 -0400
Subject: [PATCH 236/296] Tests for BoardEEPROM and RotaryEncoder

---
 lib/dino/components/rotary_encoder.rb      |  2 +-
 test/components/basic/board_eeprom_test.rb | 61 ++++++++++++++++
 test/components/rotary_encoder_test.rb     | 83 ++++++++++++++++++++++
 3 files changed, 145 insertions(+), 1 deletion(-)
 create mode 100644 test/components/basic/board_eeprom_test.rb
 create mode 100644 test/components/rotary_encoder_test.rb

diff --git a/lib/dino/components/rotary_encoder.rb b/lib/dino/components/rotary_encoder.rb
index e9d04f7d..1edd4b86 100644
--- a/lib/dino/components/rotary_encoder.rb
+++ b/lib/dino/components/rotary_encoder.rb
@@ -15,7 +15,7 @@ def after_initialize(options={})
         if options[:steps_per_revolution] 
           self.degrees_per_step = (360 / options[:steps_per_revolution])
         else
-          self.degrees_per_step = 30
+          self.degrees_per_step = 12
         end
         reset
         
diff --git a/test/components/basic/board_eeprom_test.rb b/test/components/basic/board_eeprom_test.rb
new file mode 100644
index 00000000..ae17768e
--- /dev/null
+++ b/test/components/basic/board_eeprom_test.rb
@@ -0,0 +1,61 @@
+require 'test_helper'
+
+class BoardMock < Dino::Board::Default
+  attr_reader :eeprom_stub
+  
+  def eeprom_read(start_address, length)
+    # Initialize a fake EEPROM
+    @eeprom_stub ||= Array.new(eeprom_length){255}
+    
+    # Pack it up like a string coming from the board.
+    string = @eeprom_stub[start_address, length].map{ |x| x.to_s }.join(",")
+    
+    # Update ourselves with it.
+    self.update("EE:#{start_address}-#{string}\n")
+  end
+
+  def eeprom_write(start_address, bytes)
+    @eeprom_stub[start_address, bytes.length] = bytes
+  end
+end
+
+class BoardEEPROMTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= board.eeprom
+  end
+  
+  def test_pin_ee
+    assert_equal part.pin, "EE"
+  end
+
+  def test_loads_on_initialize_and_updates_correctly
+    assert_equal part.state, Array.new(board.eeprom_length){255}
+  end
+  
+  def test_delegates_to_state_array
+    mock = MiniTest::Mock.new
+    mock.expect(:[], 255, [0])
+    mock.expect(:[]=, 128, [1, 128])
+    mock.expect(:each, nil)
+    mock.expect(:each_with_index, nil)
+    
+    part.stub(:state, mock) do
+      part[0]
+      part[1] = 128
+      part.each { |el| el }
+      part.each_with_index { |el| el }
+    end
+  end
+  
+  def test_saves_to_the_board
+    part[0] = 128
+    part[part.length] = 127
+    part.save
+    assert_equal board.eeprom_stub[0], 128
+    assert_equal board.eeprom_stub[board.eeprom_length], 127
+  end
+end
diff --git a/test/components/rotary_encoder_test.rb b/test/components/rotary_encoder_test.rb
new file mode 100644
index 00000000..f1a1fc10
--- /dev/null
+++ b/test/components/rotary_encoder_test.rb
@@ -0,0 +1,83 @@
+require 'test_helper'
+
+class RotaryEncoderTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::RotaryEncoder.new board: board, pins: {data:3, clock: 4}
+  end
+
+  def test_sets_steps_per_revolution
+    assert_equal part.degrees_per_step, 12
+    part2 = Dino::Components::RotaryEncoder.new board: board, pins: {data:3, clock: 4}, steps_per_revolution: 40
+    assert_equal part2.degrees_per_step, 9
+  end
+  
+  def test_resets_on_initialize
+    assert_equal part.state, {steps: 0, angle: 0}
+  end
+  
+  def test_calls_listen_on_both_pins_with_given_divider
+    clock_mock = MiniTest::Mock.new.expect(:call, nil, [1])
+    clock_mock.expect(:call, nil, [2])
+    data_mock = MiniTest::Mock.new.expect(:call, nil, [1])
+    data_mock.expect(:call, nil, [2])
+    
+    part.clock.stub(:listen, clock_mock) do
+      part.data.stub(:listen, data_mock) do
+        part.send(:after_initialize)
+        part.send(:after_initialize, divider: 2)
+      end
+    end
+  end
+  
+  def test_observes_on_initialize
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    part.stub(:observe_pins, mock) do
+      part.send(:after_initialize)
+    end
+  end
+  
+  def test_observes_the_right_pin
+    refute_empty part.clock.callbacks
+    assert_empty part.data.callbacks
+        
+    part2 = Dino::Components::RotaryEncoder.new board: board, pins: {data:4, clock: 3}
+    
+    refute_empty part2.data.callbacks
+    assert_empty part2.clock.callbacks
+  end
+  
+  def test_goes_the_right_direction
+    part.data.send(:update, 1)
+    part.clock.send(:update, 1)
+    assert_equal part.state, { steps: 1, angle: 12.0}
+    
+    part.reset
+    
+    part.data.send(:update, 1)
+    part.clock.send(:update, 0)
+    assert_equal part.state, { steps: -1, angle: 348.0}
+  end
+  
+  def test_callback_prefilter
+    part.data.send(:update, 1)
+    part.clock.send(:update, 1)
+    callback_value = nil
+    part.add_callback do |value|
+      callback_value = value
+    end
+    part.data.send(:update, 1)
+    part.clock.send(:update, 1)
+    
+    assert_equal callback_value, {change: 1, steps: 2, angle: 24.0}
+  end
+  
+  def test_update_state_removes_change
+    part.data.send(:update, 1)
+    part.clock.send(:update, 1)
+    assert_nil part.state[:change]
+  end
+end

From 53b9a7d3e02cdc3934a41debaff45618b899cd0b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 13 Feb 2023 17:20:46 -0400
Subject: [PATCH 237/296] Let Shift registers set bit order. Default to
 MSBFIRST for in, LSBFIRST for out

---
 lib/dino/api/shift_io.rb                  | 14 +++++----
 lib/dino/components/register/shift_in.rb  | 14 ++++++---
 lib/dino/components/register/shift_out.rb |  7 +++++
 lib/dino/components/register/spi_in.rb    |  4 +--
 lib/dino/components/register/spi_out.rb   |  2 +-
 src/lib/Dino.cpp                          |  4 +--
 src/lib/Dino.h                            |  8 ++---
 src/lib/DinoShift.cpp                     | 28 ++++++++++++-----
 test/api/shift_io_test.rb                 | 38 +++++++++++++----------
 test/components/register/shift_in_test.rb | 18 ++++++++---
 10 files changed, 89 insertions(+), 48 deletions(-)

diff --git a/lib/dino/api/shift_io.rb b/lib/dino/api/shift_io.rb
index dcc79baf..55f8a672 100644
--- a/lib/dino/api/shift_io.rb
+++ b/lib/dino/api/shift_io.rb
@@ -3,13 +3,15 @@ module API
     module ShiftIO
       include Helper
 
-      def shift_settings(data, clock, preclock_high=false)
-        preclock_high = preclock_high ? 1 : 0
-        pack :uint8, [convert_pin(data), convert_pin(clock), preclock_high]
+      def shift_settings(data, clock, bit_order=:lsbfirst, preclock_high=false)
+        settings = 0b00
+        settings |= 0b01 if bit_order == :msbfirst
+        settings |= 0b10 if preclock_high
+        pack :uint8, [convert_pin(data), convert_pin(clock), settings]
       end
 
       def shift_write(latch, data, clock, bytes, options={})
-        settings = shift_settings(data, clock)
+        settings = shift_settings(data, clock, options[:bit_order])
         limit = aux_limit - settings.length
         bytes = pack :uint8,
                      bytes,
@@ -22,7 +24,7 @@ def shift_write(latch, data, clock, bytes, options={})
       end
 
       def shift_read(latch, data, clock, num_bytes, options={})
-        settings = shift_settings(data, clock, options[:preclock_high])
+        settings = shift_settings(data, clock, options[:bit_order], options[:preclock_high])
         write Message.encode command: 22,
                              pin: convert_pin(latch),
                              value: num_bytes,
@@ -30,7 +32,7 @@ def shift_read(latch, data, clock, num_bytes, options={})
       end
 
       def shift_listen(latch, data, clock, num_bytes, options={})
-        settings = shift_settings(data, clock, options[:preclock_high])
+        settings = shift_settings(data, clock, options[:bit_order], options[:preclock_high])
         write Message.encode command: 23,
                              pin: convert_pin(latch),
                              value: num_bytes,
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index a7745dfe..17074d65 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -15,9 +15,10 @@ class ShiftIn
                     data:  Basic::DigitalInput,
                     latch: Register::Select
 
-        def after_initialize(options={})
+        def after_initialize(options)
           super(options)
-          self.rising_clock = options[:rising_clock]
+          self.rising_clock = options[:rising_clock] || false
+          self.bit_order = options[:bit_order] || :msbfirst
           bubble_callbacks
         end
 
@@ -27,19 +28,22 @@ def after_initialize(options={})
         # Set this once and future calls to #read and #listen will do it.
         #
         attr_reader :rising_clock
+        attr_accessor :bit_order
 
         def rising_clock=(value)
           @rising_clock = [0, nil, false].include?(value) ? false : true
         end
 
         def read(num_bytes=@bytes)
-          board.shift_read latch.pin, data.pin, clock.pin, num_bytes,
-                           preclock_high: rising_clock
+          board.shift_read latch.pin, data.pin, clock.pin, num_bytes, 
+                           preclock_high: rising_clock,
+                           bit_order: bit_order
         end
 
         def listen(num_bytes=@bytes)
           board.shift_listen latch.pin, data.pin, clock.pin, num_bytes,
-                             preclock_high: rising_clock
+                             preclock_high: rising_clock,
+                             bit_order: bit_order
         end
 
         def stop
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index b3de0fc4..67a3ad3f 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -14,6 +14,13 @@ class ShiftOut
         proxy_pins  clock: Basic::DigitalOutput,
                     data:  Basic::DigitalOutput,
                     latch: Register::Select
+                    
+        def after_initialize(options)
+          super(options)
+          self.bit_order = options[:bit_order] || :lsbfirst
+        end
+        
+        attr_accessor :bit_order
 
         def write(*bytes)
           board.shift_write(latch.pin, data.pin, clock.pin, bytes)
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index d3c1d966..109349f8 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -12,12 +12,12 @@ class SPIIn < Select
 
         attr_reader :spi_mode, :frequency, :bit_order
 
-        def after_initialize(options={})
+        def after_initialize(options)
           super(options) if defined?(super)
           
           @spi_mode  = options[:spi_mode]  || 0
           @frequency = options[:frequency] || 3000000
-          @bit_order = options[:bit_order] || :lsbfirst
+          @bit_order = options[:bit_order] || :msbfirst
         end
 
         def read
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index 8d5922a2..e47fb8eb 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -12,7 +12,7 @@ class SPIOut < Select
 
         attr_reader :spi_mode, :frequency, :bit_order
 
-        def after_initialize(options={})
+        def after_initialize(options)
           super(options) if defined?(super)
           
           @spi_mode  = options[:spi_mode]  || 0
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 3ebb3251..1515f690 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -146,8 +146,8 @@ void Dino::process() {
 
     // Implemented in DinoShift.cpp
     #ifdef DINO_SHIFT
-    case 21: shiftWrite          (pin, val, auxMsg[0], auxMsg[1], &auxMsg[3]); break;
-    case 22: shiftRead           (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);  break;
+    case 21: shiftWrite          (pin, val, auxMsg[0], auxMsg[1], auxMsg[2], &auxMsg[3]); break;
+    case 22: shiftRead           (pin, val, auxMsg[0], auxMsg[1], auxMsg[2]);             break;
     case 23: addShiftListener    ();  break;
     case 24: removeShiftListener ();  break;
     #endif
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index badfe5b6..f4e5a761 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -100,10 +100,10 @@ class Dino {
     void noTone                ();         //cmd = 18
 
     // Shift Registers
-    void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte *data);          //cmd = 21
-    void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte clockHighFirst); //cmd = 22
-    void addShiftListener      ();                                                                         //cmd = 23
-    void removeShiftListener   ();                                                                         //cmd = 24
+    void shiftWrite            (int latchPin,  int len, byte dataPin, byte clockPin, byte settings, byte *data); //cmd = 21
+    void shiftRead             (int latchPin,  int len, byte dataPin, byte clockPin, byte settings);             //cmd = 22
+    void addShiftListener      ();                                                                               //cmd = 23
+    void removeShiftListener   ();                                                                               //cmd = 24
     void updateShiftListeners  ();
     void clearShiftListeners   ();
 
diff --git a/src/lib/DinoShift.cpp b/src/lib/DinoShift.cpp
index 1f7d33da..bbe630e7 100644
--- a/src/lib/DinoShift.cpp
+++ b/src/lib/DinoShift.cpp
@@ -23,18 +23,24 @@ shiftListener shiftListeners[SHIFT_LISTENER_COUNT];
 // val        = length (int)
 // auxMsg[0]  = data pin (byte)
 // auxMsg[1]  = clock pin (byte)
-// auxMsg[2]  = send clock high before reading (byte) (0/1) (read func only)
+// auxMsg[2]  = settings
+//     bit 0  = transmission bit order (1 = MSBFIRST, 0 = LSBFIRST)
+//     bit 1  = send clock high before reading (byte) (0/1) (only matters for reading)
 // auxMsg[3]+ = data (bytes) (write func only)
 //
 // CMD = 21
 // Write to a shift register.
-void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte *data) {
+void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte settings, byte *data) {
   // Set latch pin low to begin serial write.
   digitalWrite(latchPin, LOW);
 
   // Write one byte at a time.
   for (uint8_t i = 0;  i < len;  i++) {
-    shiftOut(dataPin, clockPin, LSBFIRST, data[i]);
+    if (bitRead(settings, 0)) {
+      shiftOut(dataPin, clockPin, MSBFIRST, data[i]);
+    } else {
+      shiftOut(dataPin, clockPin, LSBFIRST, data[i]);	
+    }
   }
 
   // Set latch pin high so register writes to parallel output.
@@ -44,11 +50,11 @@ void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte *
 
 // CMD = 22
 // Read from a shift register.
-void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte clockHighFirst) {
+void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte settings) {
   // Send clock pin high if using a register that clocks on rising edges.
   // If not, the MSB will not be read on those registers (always 1),
   // and all other bits will be shifted by 1 towards the LSB.
-  if (clockHighFirst > 0) digitalWrite(clockPin, HIGH);
+  if (bitRead(settings, 1)) digitalWrite(clockPin, HIGH);
 
   // Latch high to read parallel state, then low again to stop.
   digitalWrite(latchPin, HIGH);
@@ -58,11 +64,17 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte cl
   // Start with just pin number and : for now.
   stream->print(latchPin);
   stream->print(':');
+  byte reading = 0;
 
   for (int i = 1;  i <= len;  i++) {
-    // Read a single byte from the register.
-    byte reading = shiftIn(dataPin, clockPin, LSBFIRST);
-
+	
+	// Read a single byte from the register.
+	if (bitRead(settings, 0)) {
+	  reading = shiftIn(dataPin, clockPin, MSBFIRST);
+	} else {
+      reading = shiftIn(dataPin, clockPin, LSBFIRST);
+	}
+	
     // Print it, then a comma or \n if it's the last byte.
     stream->print(reading);
     stream->print((i==len) ? '\n' : ',');
diff --git a/test/api/shift_io_test.rb b/test/api/shift_io_test.rb
index 45c71174..da3e3e0c 100644
--- a/test/api/shift_io_test.rb
+++ b/test/api/shift_io_test.rb
@@ -15,49 +15,55 @@ def board
   end
   
   def test_shift_settings
-    settings1 = pack :uint8, [4, 5, 1]
-    settings2 = pack :uint8, [6, 7, 0]
-    assert_equal board.shift_settings(4, 5, true), settings1
-    assert_equal board.shift_settings(6, 7), settings2
+    settings1 = pack :uint8, [6, 7, 0b00]
+    settings2 = pack :uint8, [4, 5, 0b01]
+    settings3 = pack :uint8, [4, 5, 0b10]
+    settings4 = pack :uint8, [4, 5, 0b11]
+
+    assert_equal board.shift_settings(6, 7), settings1
+    assert_equal board.shift_settings(4, 5, :msbfirst), settings2
+    assert_equal board.shift_settings(4, 5, nil, true), settings3
+    assert_equal board.shift_settings(4, 5, :msbfirst, true), settings4
   end
   
   def test_shift_write
-    settings = board.shift_settings(4, 5)
+    settings1 = board.shift_settings(4, 5)
+    settings2 = board.shift_settings(4, 5, :msbfirst)
     bytes1 = pack :uint8, [1,2,3]
     bytes2 = pack :uint8, [25]
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [Dino::Message.encode(command: 21, pin: 3, value: 3, aux_message: settings + bytes1)]
-    mock.expect :call, nil, [Dino::Message.encode(command: 21, pin: 3, value: 1, aux_message: settings + bytes2)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 21, pin: 3, value: 3, aux_message: settings1 + bytes1)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 21, pin: 3, value: 1, aux_message: settings2 + bytes2)]
     
     board.stub(:write, mock) do
       board.shift_write(3, 4, 5, [1,2,3])
-      board.shift_write(3, 4, 5, 25)
+      board.shift_write(3, 4, 5, 25, bit_order: :msbfirst)
     end
   end
 
   def test_shift_read
     settings1 = board.shift_settings(4, 5)
-    settings2 = board.shift_settings(4, 5, true)
+    settings2 = board.shift_settings(4, 5, nil, true)
+    settings3 = board.shift_settings(4, 5, :msbfirst, true)
     mock = MiniTest::Mock.new
     mock.expect :call, nil, [Dino::Message.encode(command: 22, pin: 3, value: 8, aux_message: settings1)]
     mock.expect :call, nil, [Dino::Message.encode(command: 22, pin: 3, value: 4, aux_message: settings2)]
+    mock.expect :call, nil, [Dino::Message.encode(command: 22, pin: 3, value: 4, aux_message: settings3)]
     
     board.stub(:write, mock) do
       board.shift_read(3, 4, 5, 8)
       board.shift_read(3, 4, 5, 4, preclock_high: true)
+      board.shift_read(3, 4, 5, 4, bit_order: :msbfirst, preclock_high: true)
     end
   end
   
   def test_shift_listen
-    settings1 = board.shift_settings(4, 5)
-    settings2 = board.shift_settings(4, 5, true)
+    settings = board.shift_settings(4, 5, :msbfirst, true)
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [Dino::Message.encode(command: 23, pin: 3, value: 8, aux_message: settings1)]
-    mock.expect :call, nil, [Dino::Message.encode(command: 23, pin: 3, value: 4, aux_message: settings2)]
-  
+    mock.expect :call, nil, [Dino::Message.encode(command: 23, pin: 3, value: 4, aux_message: settings)]
+
     board.stub(:write, mock) do
-      board.shift_listen(3, 4, 5, 8)
-      board.shift_listen(3, 4, 5, 4, preclock_high: true)
+      board.shift_listen(3, 4, 5, 4, preclock_high: true, bit_order: :msbfirst)
     end
   end
 
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
index 68618214..8bf9176c 100644
--- a/test/components/register/shift_in_test.rb
+++ b/test/components/register/shift_in_test.rb
@@ -31,18 +31,28 @@ def test_rising_clock
   end
 
   def test_read
-    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, 2], preclock_high: true
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :msbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :lsbfirst
     board.stub(:shift_read, mock) do
-      new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2, rising_clock: true))
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2)
+      new_part.read
+      
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :lsbfirst)
       new_part.read
     end
     mock.verify
   end
   
   def test_listen
-    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, 2], preclock_high: true
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :msbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :lsbfirst
     board.stub(:shift_listen, mock) do
-      new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2, rising_clock: true))
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2)
+      new_part.listen
+      
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :lsbfirst)
       new_part.listen
     end
     mock.verify

From 5ede312eb930f2d4d508fb26bc93b927773b7716 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 13 Feb 2023 17:49:10 -0400
Subject: [PATCH 238/296] Change target for Due to 'sam3x' and update changelog

---
 CHANGELOG.md             | 24 ++++++++++++------------
 lib/dino_cli/targets.rb  |  2 +-
 lib/dino_cli/targets.txt |  2 +-
 3 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5a239b45..37ceb733 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,15 +6,15 @@
 - The `dino sketch` shell command now accepts a `--target` argument. It includes/excludes features to tailor the sketch for different boards/chips. Run `dino targets` for more info.
 
 - ATmega Based Boards (default) (`--target mega`):
-  - This is the default sketch if `--target` isn't specified, and works for many of the common Arduino products, like the Uno, Nano, Leonardo and Mega.
+  - This is the default sketch if `--target` isn't specified, and works for Arduino (and other) products based on the ATmega AVR chips, like the Uno, Nano, Leonardo and Mega.
 
 - ESP8266 (`--target esp8266`):
-  - Works with `Dino::Board.new`, but calling `Dino::Board::ESP8266.new` instead allows pins to be referred to as any of `'GPIO4'`, `4`, or `'D2'`, as printed on dev boards like the NodeMCU or WeMos, with the printed names mapping to the correct GPIO.
+  - Works with `Dino::Board.new`, but calling `Dino::Board::ESP8266.new` instead allows pins to be referred to as any of `'GPIO4'`, `4`, or `'D2'`, as printed on the NodeMCU dev board. When in doubt, look up your board's GPIO mapping and use those numbers instead.
   - Works with either built in WiFi or Serial.
   - WiFi version supports OTA (over-the-air) update in the Arduino IDE. Initial flash must still be done via serial.
   - **Note**: SoftwareSerial is incompatible with the ESP8266. LiquidCrystal (LCD) compiles for the ESP8266, but does not work. Both of these are excluded.
   
-- Arduino Due (`--target due`) :
+- Arduino Due (`--target sam3x`) :
   - Up to 12-bit analog in/out. Pass a `bits:` option to `Board#new` to set resolution for both.
   - DAC support. Refer to DAC pins as `'DAC0'`, `'DAC1'`, just as labeled on the board. Call `#analog_write` or just `#write` on an `AnalogOutput` component that uses the pin.
   - Uses the native ARM serial port by default. Configurable in sketch to use programming port.
@@ -28,6 +28,8 @@
 
 ### New Components
 
+- `TxRx::TCP` allows communication with the board over an IP network, instead of serial connection. Tested on Arduino Uno Ethernet Shield (Wiznet W5100), and ESP8266 native WiFi. Should work on Uno WiFi shield, but is **untested**. WiFi must be configured before flashing. Instad of `dino sketch serial`, use `dino sketch wifi`.
+
 - Hitachi HD44780 LCD support. _Uses Arduino `LiquidCrystal` library._
 
 - Seven Segment Display support. _Ruby implementation as multiple LEDs._
@@ -38,7 +40,7 @@
 
 - SoftwareSerial. _Uses Arduino `SoftSerial` library._ (**write only / experimental**)
 
-- Rotary encoder support. _Uses polling method @ 1ms interval._ **WARNING**: Not suitable for high speeds or precise position needs. It will definitely miss steps. Sufficient for using rotary knobs for user input.
+- Rotary encoder support. _Uses polling method @ 1ms interval._ **WARNING**: Not suitable for high speed or precise position needs. It will definitely miss steps. Sufficient for rotary knobs as user input.
 
 - DHT11 / DHT 21 (AM2301) / DHT22 temperature and relative humidity sensor support. _Custom implementation where input pulses are measured on the board, then decoded in Ruby._
 
@@ -62,21 +64,19 @@
 
 - Board EEPROM support. _Uses Arduino `EEPROM` library._
 
-- WiFi shield support (**untested**)
-
 ### Changed Components
 - Servos can now be connected to arbitrary pins as long as they are supported by the board.
 
 - Digital and analog listeners now have dividers on a per-pin basis.
   - Timing is based on a 1000 microsecond tick being counted by the board.
-  - Call `#listen` with a value as the first argument. Eg. `sensor.listen(64)` will tell the board to send us that specific sensor's state every 64 ticks (~64ms)  or around 16 times per second, without affecting other components' rates.
+  - Call `#listen` with a value as the first argument. Eg. `analog_sensor.listen(64)` will tell the board to send us that specific sensor's state every 64 ticks (~64ms)  or around 16 times per second, without affecting other components' rates.
   - Valid dividers are: `1, 2, 4, 8, 16, 32, 64, 128`.
   - Defaults are same as before: `4` for digital, `16` for analog.
 
 ### Hardware Abstraction
 
 - `MultiPin` abstraction for components using more than one pin:
-  - Components connecting to more than 1 pin, like an RGB LED or rotary encoder, are now modeled as `MultiPin` and contain multiple `SinglePin` proxy components. An `RGBLed` is built from 3 `AnalogOutput`s, for example, one for each color, connected to a separate pin.
+  - Components connecting to more than 1 pin, like an RGB LED or rotary encoder, are now modeled as `MultiPin` and contain multiple `SinglePin` `proxies`. An `RGBLed` is built from 3 `AnalogOutput`s, for example, one for each color, connected to a separate pin.
   - `MultiPin` implements a shortcut class method `proxy_pins`. Proxying a pin allows subcomponent pin numbers to be given as a hash when initializing an instance of a `MultiPin` component. Eg: `{red: 9, green: 10, blue: 11}` given as the `pins:` option for `RGBLed#new`.
   -  When initialized, subcomponents corresponding to the proxied pins are automatically created. They're stored in `#proxies` and `attr_reader` methods are created for each, corresponding to their key in the `pins:` hash. Eg: `RGBLed#green` and `RGBLed#proxies[:green]` both give the `AnalogOutput` component that represents the green LED inside the RGB LED, connected to pin 10.
 
@@ -98,22 +98,22 @@
   - Each key represents an array of callbacks, so multiple callbacks can share the same key.
   - Calling `#remove_callbacks` with a key empties that array. Calling with no key removes **all** callbacks for the component.
   - `#pre_callback_filter` is defined in the `Callbacks` module. The return value of this method is what is given to the component's callbacks and to update its `@state`. By default, it returns whatever was given from the board.
-  - Override `#pre_callback_filter` to process data before giving it to callbacks and `@state`. Eg: given raw bytes from a DHT sensor, process them into a hash containing `:celsius`, `: fahrenheit` and `:humidity` values. That hash is given to to callbacks and `#update_state` instead of the original string of values.
-  - `#update_state` is defined in the `Callbacks` module.  It is called after all callbacks are run and given the return value of `#pre_callback_filter`. By default, it sets `#state=` to that value.
+  - Override `#pre_callback_filter` to process data before giving it to callbacks and `@state`. Eg: given raw bytes from a DHT sensor, process them into a hash containing `:celsius`, `: fahrenheit` and `:humidity` values. That hash is given to to callbacks and `#update_state` instead of the original string of raw bytes.
+  - `#update_state` is defined in the `Callbacks` module. It is called after all callbacks are run and given the return value of `#pre_callback_filter`. By default, it sets `@state=` to the value given.
   - Override it if updating `@state` is more complex than this, but be sure to either use `#state=` only once, or wrap the operation in `@state_mutex.synchronize`.
 
 - Input components no longer automatically start listening when created, since there are more options for reading inputs.
   - `DigitalInput` and its subclasses are the exception to this. They automatically listen, since there is little advantage to other modes.
 
 - Input components can have any combination of `#read`, `#poll` and `#listen` methods now, coming from `Reader`, `Poller`, and `Listener` respectively, inside `Mixins`.
-  - `#read` sends a single read command by calling `#_read`, and blocks the main thread, until `data` is received from `#pre_callback_filter`. When received, any block given to `#read` will run in the "update" thread once and be removed immediately. `#read` then stops blocking the main thread and returns `data`.
+  - `#read` sends a single read command by calling `#_read`, and blocks the main thread, until `data` is received from `#pre_callback_filter`. When received, any block that was given to `#read` will run once as a callback and be removed immediately. `#read` then stops blocking the main thread and returns `data`.
   - `#poll` requires an interval (in seconds) as its first argument. It starts a new thread, and keeps calling `#_read` in it, at the given interval. `#poll` does not block the main thread, and does not return a value. A block given will be added as a callback inside the `:poll` key.
   - `#listen` adds its block as a callback inside the `:listen` key, calls `#_listen` and returns immediately.
   - `#stop` stops polling **and** listening. It also **removes all callbacks** in the **`:poll` and `:listen` keys** (callbacks added as blocks when polling or listening).
 
 ### Minor Changes
 - Serial communication now uses the [`rubyserial`](https://github.com/hybridgroup/rubyserial) gem instead of [`serialport`](https://github.com/hparra/ruby-serialport).
-- Switched from `respec` to `minitest` for testing.
+- Switched from `rspec` to `minitest` for testing.
 - Added more useful information and errors during the connect & handshake process.
 - Extended message syntax so the Arduino can receive arbitrary length messages, including binary.
 - Created `Dino::Message` class to handle message construction.
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 5d6cc1bd..2d18ddfe 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -14,7 +14,7 @@ class DinoCLI::Generator
     mega168: [:core, :servo, :shift,:tone, :spi, :i2c],
 
     # ARM includes everytyhing except specific incompatibilities.
-    arm: STANDARD_PACKAGES - [:serial, :tone, :ir_out],
+    sam3x: STANDARD_PACKAGES - [:serial, :tone, :ir_out],
 
     # A surprising amount "just works" on the ESP, notably not LCD.
     esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp8266],
diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
index 394d12e1..1fcf52e3 100644
--- a/lib/dino_cli/targets.txt
+++ b/lib/dino_cli/targets.txt
@@ -58,7 +58,7 @@
             These limits apply as long as an Atmega168 is selected in the
             Arduino IDE, regardless of the options passed to this sketch generator.
 
-    arm
+    sam3x
 
       This is the same as mega, but omits libraries specifically known to be
       incompatible with the Atmel SAMD (ARM Cortex M0) chips. Use this when

From ceb33996d2c5879317a0dd0c18a3dbdd834b6ef2 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 13 Feb 2023 22:50:36 -0400
Subject: [PATCH 239/296] Tests for SPI input and output registers

---
 lib/dino/components/i2c/slave.rb           |  2 +-
 lib/dino/components/register/input.rb      |  9 ++--
 lib/dino/components/register/output.rb     | 17 ++++---
 lib/dino/components/register/shift_in.rb   |  6 ++-
 lib/dino/components/register/shift_out.rb  |  2 +-
 lib/dino/components/register/spi_in.rb     | 11 ++---
 lib/dino/components/register/spi_out.rb    |  7 ++-
 lib/dino/components/setup/base.rb          |  2 +
 test/components/register/shift_out_test.rb |  1 -
 test/components/register/spi_in_test.rb    | 54 ++++++++++++++++++++++
 test/components/register/spi_out_test.rb   | 38 +++++++++++++++
 11 files changed, 126 insertions(+), 23 deletions(-)
 create mode 100644 test/components/register/spi_in_test.rb
 create mode 100644 test/components/register/spi_out_test.rb

diff --git a/lib/dino/components/i2c/slave.rb b/lib/dino/components/i2c/slave.rb
index e0b50419..790f06a5 100644
--- a/lib/dino/components/i2c/slave.rb
+++ b/lib/dino/components/i2c/slave.rb
@@ -5,7 +5,7 @@ class Slave
         include Mixins::BusSlave
         include Mixins::Reader
 
-        def initialize(options)
+        def before_initialize(options)
           super(options)
           @repeated_start = options[:repeated_start] || false
         end
diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index 3a7f670d..76d85ec1 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -6,9 +6,9 @@ module Input
         include Mixins::Callbacks
 
         attr_reader :bytes
-
-        def after_initialize(options={})
-          super(options) if defined?(super)
+        
+        def before_initialize(options={})
+          super(options)
           #
           # To use the register as a board proxy, we need to know how many
           # bytes there are and map each bit to a virtual pin.
@@ -28,7 +28,10 @@ def after_initialize(options={})
           #
           @reading_pins   = Array.new(@bytes*8) {|i| false}
           @listening_pins = Array.new(@bytes*8) {|i| false}
+        end
 
+        def after_initialize(options={})
+          super(options)
           enable_proxy
         end
 
diff --git a/lib/dino/components/register/output.rb b/lib/dino/components/register/output.rb
index 64ca7adf..695a514b 100644
--- a/lib/dino/components/register/output.rb
+++ b/lib/dino/components/register/output.rb
@@ -3,9 +3,11 @@ module Components
     module Register
       module Output
         include Setup::Base
-
-        def after_initialize(options={})
-          super(options) if defined?(super)
+        
+        attr_reader :bytes
+        
+        def before_initialize(options={})
+          super(options)
           #
           # To use the register as a board proxy, we need to know how many
           # bytes there are and map each bit to a virtual pin.
@@ -17,9 +19,8 @@ def after_initialize(options={})
           # When used as a board proxy, store the state of each register
           # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
           #
-          @state = Array.new(@bytes*8) { 0 }
-          write_state
-
+          self.state = Array.new(@bytes*8) { 0 }
+          
           #
           # When used as a board proxy, only write sate if @write_delay seconds
           # have passed since this object last got input. Better for things like SSDs
@@ -27,6 +28,10 @@ def after_initialize(options={})
           #
           @write_delay = options[:write_delay] || 0.005
         end
+        
+        def after_initialize(options={})
+          write_state
+        end
 
         def write
           raise 'define #write in child class based on communication method'
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 17074d65..2a217875 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -15,10 +15,14 @@ class ShiftIn
                     data:  Basic::DigitalInput,
                     latch: Register::Select
 
-        def after_initialize(options)
+        def before_initialize(options={})
           super(options)
           self.rising_clock = options[:rising_clock] || false
           self.bit_order = options[:bit_order] || :msbfirst
+        end
+        
+        def after_initialize(options={})
+          super(options)
           bubble_callbacks
         end
 
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index 67a3ad3f..ef1ab19d 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -15,7 +15,7 @@ class ShiftOut
                     data:  Basic::DigitalOutput,
                     latch: Register::Select
                     
-        def after_initialize(options)
+        def before_initialize(options={})
           super(options)
           self.bit_order = options[:bit_order] || :lsbfirst
         end
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 109349f8..586b7ec0 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -12,20 +12,19 @@ class SPIIn < Select
 
         attr_reader :spi_mode, :frequency, :bit_order
 
-        def after_initialize(options)
-          super(options) if defined?(super)
-          
+        def initialize(options)
+          super(options)
           @spi_mode  = options[:spi_mode]  || 0
-          @frequency = options[:frequency] || 3000000
+          @frequency = options[:frequency] || 1000000
           @bit_order = options[:bit_order] || :msbfirst
         end
 
         def read
-          board.spi_transfer(pin, mode: spi_mode, frequency: frequency, read: @bytes)
+          board.spi_transfer(pin, mode: @spi_mode, frequency: frequency, read: @bytes, bit_order: @bit_order)
         end
 
         def listen
-          board.spi_listen(pin, mode: spi_mode, frequency: frequency, read: @bytes)
+          board.spi_listen(pin, mode: @spi_mode, frequency: frequency, read: @bytes, bit_order: @bit_order)
         end
 
         def stop
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index e47fb8eb..3740429c 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -12,11 +12,10 @@ class SPIOut < Select
 
         attr_reader :spi_mode, :frequency, :bit_order
 
-        def after_initialize(options)
-          super(options) if defined?(super)
-          
+        def before_initialize(options)
+          super(options)
           @spi_mode  = options[:spi_mode]  || 0
-          @frequency = options[:frequency] || 3000000
+          @frequency = options[:frequency] || 1000000
           @bit_order = options[:bit_order] || :lsbfirst
         end
 
diff --git a/lib/dino/components/setup/base.rb b/lib/dino/components/setup/base.rb
index 06d7b161..3fad5fd4 100644
--- a/lib/dino/components/setup/base.rb
+++ b/lib/dino/components/setup/base.rb
@@ -7,6 +7,7 @@ module Base
         def initialize(options={})
           @state = nil
           @state_mutex = Mutex.new
+          before_initialize(options)
           initialize_board(options)
           initialize_pins(options)
           register
@@ -42,6 +43,7 @@ def unregister
         # Setup::Base only requires a board.
         # Include modules from Setup or override this to use pins.
         #
+        def before_initialize(options={}) ; end
         def initialize_pins(options={}) ; end
         alias :initialize_pin :initialize_pins
 
diff --git a/test/components/register/shift_out_test.rb b/test/components/register/shift_out_test.rb
index 5ad79f5c..ff6b5ffd 100644
--- a/test/components/register/shift_out_test.rb
+++ b/test/components/register/shift_out_test.rb
@@ -20,7 +20,6 @@ def test_proxies
   end
 
   def test_write
-    # mock = MiniTest::Mock.new.expect :call, nil, ["21.8.1.#{[11,12,0,255,127].pack('C*')}\n"]
     new_part = Dino::Components::Register::ShiftOut.new(options.merge(bytes: 2))
     mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, [255,127]]
     board.stub(:shift_write, mock) do
diff --git a/test/components/register/spi_in_test.rb b/test/components/register/spi_in_test.rb
new file mode 100644
index 00000000..199b95f2
--- /dev/null
+++ b/test/components/register/spi_in_test.rb
@@ -0,0 +1,54 @@
+require 'test_helper'
+
+class RegisterSPIInTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :lsbfirst, bytes: 2 }
+  end
+
+  def part
+    @part ||= Dino::Components::Register::SPIIn.new(options)
+  end
+
+  def test_defaults
+    part = Dino::Components::Register::SPIIn.new board: board, pin: 9
+    assert_equal part.frequency, 1000000
+    assert_equal part.spi_mode,  0
+    assert_equal part.bit_order, :msbfirst
+    assert_equal part.bytes, 1
+  end
+  
+  def test_options
+    assert_equal part.frequency, 800000
+    assert_equal part.spi_mode, 2
+    assert_equal part.bit_order, :lsbfirst
+    assert_equal part.bytes, 2
+  end
+
+  def test_read
+    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :lsbfirst
+    board.stub(:spi_transfer, mock) do
+      part.read
+    end
+    mock.verify
+  end
+  
+  def test_listen
+    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :lsbfirst
+    board.stub(:spi_listen, mock) do
+      part.listen
+    end
+    mock.verify
+  end
+  
+  def test_stop
+    mock = MiniTest::Mock.new.expect :call, nil, [9]
+    board.stub(:spi_stop, mock) do
+      part.stop
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/register/spi_out_test.rb b/test/components/register/spi_out_test.rb
new file mode 100644
index 00000000..6a2655f1
--- /dev/null
+++ b/test/components/register/spi_out_test.rb
@@ -0,0 +1,38 @@
+require 'test_helper'
+
+class RegisterSPIOutTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :msbfirst }
+  end
+
+  def part
+    @part ||= Dino::Components::Register::SPIOut.new(options)
+  end
+
+  def test_defaults
+    part = Dino::Components::Register::SPIOut.new board: board, pin: 9
+    assert_equal part.frequency, 1000000
+    assert_equal part.spi_mode,  0
+    assert_equal part.bit_order, :lsbfirst
+  end
+  
+  def test_options
+    assert_equal part.frequency, 800000
+    assert_equal part.spi_mode, 2
+    assert_equal part.bit_order, :msbfirst
+  end
+
+  def test_write
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [9], mode: 2, frequency: 800000, write: [0], bit_order: :msbfirst
+    mock.expect :call, nil, [9], mode: 2, frequency: 800000, write: [255,127], bit_order: :msbfirst
+    board.stub(:spi_transfer, mock) do
+      part.write(255,127)
+    end
+    mock.verify
+  end
+end

From cccb96c4b5a05ac6431b2a730069c93ad408f322 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 13 Feb 2023 22:59:20 -0400
Subject: [PATCH 240/296] Handshake checks ACK, so it doesn't raise from old
 data in serial buffer

---
 lib/dino/tx_rx/base.rb         |  3 +--
 lib/dino/tx_rx/flow_control.rb |  7 +------
 lib/dino/tx_rx/handshake.rb    | 17 +++++++++++++----
 3 files changed, 15 insertions(+), 12 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 58252930..5faf665c 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -48,8 +48,7 @@ def start_read
       end
 
       def stop_read
-        return nil if @thread.nil?
-        Thread.kill(@thread)
+        Thread.kill(@thread) if @thread
         @thread = nil
       end
 
diff --git a/lib/dino/tx_rx/flow_control.rb b/lib/dino/tx_rx/flow_control.rb
index 1010dcb1..f21cf1d0 100644
--- a/lib/dino/tx_rx/flow_control.rb
+++ b/lib/dino/tx_rx/flow_control.rb
@@ -64,12 +64,7 @@ def reset_flow_control
       def read_and_parse
         line = read
 
-        if line && line.match(/\AACK:/)
-          # A HandshakeAttempt is observing. Also pass self so it can stop.
-          changed && notify_observers(self, line.split(":", 2)[1])
-          # ACK: means the board reset its counter. Reset ours.
-          @transit_mutex.synchronize { @transit_bytes = 0 }
-        elsif line && line.match(/\ARCV:/)
+        if line && line.match(/\ARCV:/)
           remove_transit_bytes(line.split(/:/)[1].to_i)
         elsif line
           parse(line)
diff --git a/lib/dino/tx_rx/handshake.rb b/lib/dino/tx_rx/handshake.rb
index e0a77764..7b060407 100644
--- a/lib/dino/tx_rx/handshake.rb
+++ b/lib/dino/tx_rx/handshake.rb
@@ -7,10 +7,11 @@ def initialize
         @result = nil
       end
 
-      def update(sender, result)
-        sender.delete_observer(self)
-        @result = result
-        @acknowledged = true
+      def update(line)
+        if line.match(/\AACK:/)
+          @result = line.split(":", 2)[1]
+          @acknowledged = true
+        end
       end
     end
 
@@ -30,6 +31,14 @@ def handshake
               loop do
                 if attempt.acknowledged
                   puts "Acknowledged. Hardware ready...\n\n"
+                  
+                  # Stop the handshake attempt from observing.
+                  self.delete_observer(attempt)
+                  
+                  # We reset the board, so reset the transit mutex.
+                  @transit_mutex.synchronize { @transit_bytes = 0 }
+                  
+                  # Return the data part of the ACK line.
                   return attempt.result
                 end
               end

From 2cb62434f369e550a6a9e3b849789531664a729b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 13 Feb 2023 23:51:57 -0400
Subject: [PATCH 241/296] Add CLI instructions for vendor libraries

---
 lib/dino_cli/generator.rb      | 14 ++++++++++++++
 lib/dino_cli/helper.rb         |  6 ++++++
 lib/dino_cli/missing_files.txt | 20 ++++++++++++++++++++
 3 files changed, 40 insertions(+)
 create mode 100644 lib/dino_cli/missing_files.txt

diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index a386aa34..119bfdb6 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -3,6 +3,10 @@ class DinoCLI::Generator
   require "dino_cli/packages"
   require "dino_cli/targets"
   require "dino/version"
+  
+  require "dino_cli/helper"
+  include DinoCLI::Helper
+  
   attr_accessor :options
 
   def initialize(options={})
@@ -29,6 +33,7 @@ def self.run!(options={})
 
   def read
     @packages = PACKAGES
+    files_missing = false
 
     # Replace each filepath with a hash containing the filepath and contents.
     @packages.each_key do |k|
@@ -42,8 +47,16 @@ def read
           contents = "#include \"DinoDefines.h\"\n#ifdef #{directive}\n" << contents << "\n#endif\n"
         end
         { path: f, contents: contents }
+      rescue
+        files_missing = true
+        puts "File missing: #{f}"
       end
     end
+    
+    # Show the text file when vendor files are missing
+    if files_missing
+      missing_files
+    end
 
     # Read in the sketch itself.
     @sketch = File.read File.join(options[:src_dir], "#{options[:src_sketch_name]}.ino")
@@ -117,6 +130,7 @@ def write
       # Then write the file contents to the destination path.
       if (targeted && !excluded)
         package[:files].each do |file|
+          next unless file
           dest_path = File.join(output_dir, file[:path].split('/')[-1])
           File.open(dest_path, 'w') { |f| f.write file[:contents] }
         end
diff --git a/lib/dino_cli/helper.rb b/lib/dino_cli/helper.rb
index 3ea1b46f..683b4a88 100644
--- a/lib/dino_cli/helper.rb
+++ b/lib/dino_cli/helper.rb
@@ -20,4 +20,10 @@ def targets
     $stderr.puts
     exit(2)
   end
+  
+  def missing_files
+    text = File.read(File.join(@options[:cli_dir], "missing_files.txt"))
+    $stderr.print text
+    $stderr.puts
+  end
 end
diff --git a/lib/dino_cli/missing_files.txt b/lib/dino_cli/missing_files.txt
new file mode 100644
index 00000000..ab6e61c8
--- /dev/null
+++ b/lib/dino_cli/missing_files.txt
@@ -0,0 +1,20 @@
+  
+  If all the missing files are from the vendor directory, you have 2 options:
+
+  1) If you cloned the dino repo with git, please run:
+
+     git submodule update --init --recursive
+
+     Then try generating the sketch again.
+     This command clones the needed repos into dino's src/vendor folder.
+
+  2) If you installed the gem via gem install, you can ignore missing vendor
+    files and install the libraries in your Arduino app instead.
+
+     The libraries used are:
+     
+       IRremote v2.3.2
+       IRremoteESP8266 v2.3.2
+
+     In the Arduino app's library manager, search for them by name. Please
+     install the versions listed here. Newer or older versions may be incompatible.

From 1f5fbeda418dbeb3f626847cd6e862b9a65a9cb7 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 14 Feb 2023 11:53:54 -0400
Subject: [PATCH 242/296] Test base classes for I2C bus devices

---
 lib/dino/components/i2c/ds3231.rb       |  2 +-
 lib/dino/components/i2c/slave.rb        |  2 +-
 lib/dino/components/mixins/bus_slave.rb | 11 ++--
 test/components/i2c/bus_test.rb         | 77 +++++++++++++++++++++++++
 test/components/i2c/slave_test.rb       | 53 +++++++++++++++++
 5 files changed, 136 insertions(+), 9 deletions(-)
 create mode 100644 test/components/i2c/bus_test.rb
 create mode 100644 test/components/i2c/slave_test.rb

diff --git a/lib/dino/components/i2c/ds3231.rb b/lib/dino/components/i2c/ds3231.rb
index ef2a36e3..bc8a77ed 100644
--- a/lib/dino/components/i2c/ds3231.rb
+++ b/lib/dino/components/i2c/ds3231.rb
@@ -23,7 +23,7 @@ def time=(time)
         
         # Time data starts at register 0 and is 7 bytes long.
         def _read
-          read_bytes(0, 7)
+          super(0, 7)
         end
         
         # Convert raw bytes from the I2C bus into a Ruby Time object.
diff --git a/lib/dino/components/i2c/slave.rb b/lib/dino/components/i2c/slave.rb
index 790f06a5..60b86487 100644
--- a/lib/dino/components/i2c/slave.rb
+++ b/lib/dino/components/i2c/slave.rb
@@ -16,7 +16,7 @@ def write(bytes=[])
           bus.write(address, bytes, repeated_start: repeated_start)
         end
 
-        def read_bytes(register, num_bytes=1)
+        def _read(register, num_bytes=1)
           bus.read(address, register, num_bytes, repeated_start: repeated_start)
         end
       end
diff --git a/lib/dino/components/mixins/bus_slave.rb b/lib/dino/components/mixins/bus_slave.rb
index 2cc5fc7c..ae285edb 100644
--- a/lib/dino/components/mixins/bus_slave.rb
+++ b/lib/dino/components/mixins/bus_slave.rb
@@ -7,19 +7,16 @@ module BusSlave
         attr_reader :address
         alias  :bus :board
 
-        def initialize(options={})
+        def before_initialize(options={})
           options[:board] ||= options[:bus]
-          super(options)
-        end
-
-        def after_initialize(options={})
-          super(options)
-
+          
           unless options[:address]
             raise ArgumentError,
                   'missing Slave device address; try Bus#search first'
           end
           @address = options[:address]
+          
+          super(options)
         end
 
         def atomically(&block)
diff --git a/test/components/i2c/bus_test.rb b/test/components/i2c/bus_test.rb
new file mode 100644
index 00000000..4ad2e07f
--- /dev/null
+++ b/test/components/i2c/bus_test.rb
@@ -0,0 +1,77 @@
+require 'test_helper'
+
+class I2CBusTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part  ||= Dino::Components::I2C::Bus.new(board: board, pin:5)
+  end
+  
+  def slave
+    @slave ||= Dino::Components::I2C::Slave.new(bus: part, address: 0x30)
+  end
+  
+  def inject_read(lines, wait_for_callbacks = true)
+    Thread.new do
+      if wait_for_callbacks
+        sleep while board.components.empty?
+        sleep while board.components.first.callbacks.empty?
+      end
+
+      [lines].flatten.each do |line|
+        board.update(line)
+      end
+    end
+  end
+
+  def test_initialize
+    inject_read("5:")
+    assert_equal part.found_devices, []
+    refute_nil part.callbacks[:bus_master]
+  end
+  
+  def test_search
+    inject_read("5:48:50")
+    
+    mock = MiniTest::Mock.new.expect :call, nil
+    board.stub(:i2c_search, mock) do
+      part
+    end
+    
+    mock.verify
+    assert_equal part.found_devices, [0x30, 0x32]
+  end
+  
+  def test_write
+    inject_read("5:48:50")
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [0x30, [0x01, 0x02], some_option: true]
+    board.stub(:i2c_write, mock) do
+      part.write 0x30, [0x01, 0x02], some_option: true
+    end
+    mock.verify
+  end
+  
+  def test__read
+    inject_read("5:48:50")
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [0x32, 0x03, 6, some_option: true]
+    board.stub(:i2c_read, mock) do
+      part._read 0x32, 0x03, 6, some_option: true
+    end
+    mock.verify
+  end
+  
+  def test_updates_slaves
+    inject_read("5:48,50")
+    mock = MiniTest::Mock.new.expect :call, nil, [[255, 127]]
+    
+    slave.stub(:update, mock) do
+      part.send(:update, "48-255,127")
+      part.send(:update, "50-128,0")
+    end
+    mock.verify
+  end
+end
diff --git a/test/components/i2c/slave_test.rb b/test/components/i2c/slave_test.rb
new file mode 100644
index 00000000..194fea06
--- /dev/null
+++ b/test/components/i2c/slave_test.rb
@@ -0,0 +1,53 @@
+require 'test_helper'
+
+class I2SlaveTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def bus
+    unless @bus      
+      inject_read("5:48")
+      @bus  ||= Dino::Components::I2C::Bus.new(board: board, pin:5)
+    else
+      @bus
+    end
+  end
+  
+  def part
+    @part ||= Dino::Components::I2C::Slave.new(bus: bus, address: 0x30)
+  end
+  
+  def inject_read(lines, wait_for_callbacks = true)
+    Thread.new do
+      if wait_for_callbacks
+        sleep while board.components.empty?
+        sleep while board.components.first.callbacks.empty?
+      end
+
+      [lines].flatten.each do |line|
+        board.update(line)
+      end
+    end
+  end
+  
+  def test_write_and_repeated_start
+    part.repeated_start = true
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [0x30, [1,2]], repeated_start: true
+    bus.stub(:write, mock) do
+      part.write [1,2]
+    end
+  end
+  
+  def test__read_and_repeated_start
+    part.repeated_start = true
+    
+    inject_read("5:48-127,127,127,127,127,127")
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [0x30, 0x03, 6], repeated_start: true
+    bus.stub(:write, mock) do
+      part._read(0, 6)
+    end
+  end
+end

From 212f6a56122f79696b6274934411f3ff0b37219e Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 14 Feb 2023 14:40:24 -0400
Subject: [PATCH 243/296] Tests for DS3231 real time clock over ITC

---
 lib/dino/components/i2c/ds3231.rb  | 31 ++++++++------
 test/components/i2c/ds3231_test.rb | 68 ++++++++++++++++++++++++++++++
 2 files changed, 87 insertions(+), 12 deletions(-)
 create mode 100644 test/components/i2c/ds3231_test.rb

diff --git a/lib/dino/components/i2c/ds3231.rb b/lib/dino/components/i2c/ds3231.rb
index bc8a77ed..8bdcd233 100644
--- a/lib/dino/components/i2c/ds3231.rb
+++ b/lib/dino/components/i2c/ds3231.rb
@@ -4,21 +4,13 @@ module I2C
       class DS3231 < Slave
         require 'bcd'
         
-        # Set the time.
+        # Write start register 0x00, then bytes to set time.
         def time=(time)
-          bytes = [ 0,
-                    BCD.decode(time.sec),
-                    BCD.decode(time.min),
-                    BCD.decode(time.hour),
-                    BCD.decode(time.strftime('%u').to_i),
-                    BCD.decode(time.day),
-                    BCD.decode(time.month),
-                    BCD.decode(time.year - 1970) ]
-          write(bytes)
+          write [0, time_to_bcd(time)]
           time
         end
         
-        # Read the time.
+        # Do a blocking read when #time is called.
         alias :time :read
         
         # Time data starts at register 0 and is 7 bytes long.
@@ -26,8 +18,23 @@ def _read
           super(0, 7)
         end
         
-        # Convert raw bytes from the I2C bus into a Ruby Time object.
         def pre_callback_filter(bytes)
+          bcd_to_time(bytes)
+        end
+        
+        # Convert Time object to 7 byte BCD sequence.
+        def time_to_bcd(time)
+          [ BCD.decode(time.sec),
+            BCD.decode(time.min),
+            BCD.decode(time.hour),
+            BCD.decode(time.strftime('%u').to_i),
+            BCD.decode(time.day),
+            BCD.decode(time.month),
+            BCD.decode(time.year - 1970) ]
+        end
+        
+        # Convert 7 byte BCD sequence to Time object.
+        def bcd_to_time(bytes)
           t = bytes.map { |b| BCD.encode(b) }
           Time.new t[6] + 1970, t[5], t[4], t[2], t[1], t[0]
         end
diff --git a/test/components/i2c/ds3231_test.rb b/test/components/i2c/ds3231_test.rb
new file mode 100644
index 00000000..88285333
--- /dev/null
+++ b/test/components/i2c/ds3231_test.rb
@@ -0,0 +1,68 @@
+require 'test_helper'
+
+class DS3231Test < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def bus
+    unless @bus      
+      inject_read("5:104")
+      @bus  ||= Dino::Components::I2C::Bus.new(board: board, pin:5)
+    else
+      @bus
+    end
+  end
+  
+  def part
+    @part ||= Dino::Components::I2C::DS3231.new(bus: bus, address: 0x68)
+  end
+  
+  def inject_read(lines, wait_for_callbacks = true)
+    Thread.new do
+      if wait_for_callbacks
+        sleep while board.components.empty?
+        sleep while board.components.first.callbacks.empty?
+      end
+
+      [lines].flatten.each do |line|
+        board.update(line)
+      end
+    end
+  end
+
+  def test_time_to_bcd
+    time = Time.new(2000, 1, 1, 0, 0, 0.0)
+    bytes = part.time_to_bcd(time)
+    assert_equal bytes, [0, 0, 0, 6, 1, 1, 48]
+  end
+  
+  def test_bcd_to_time
+    bytes = [0, 0, 0, 6, 1, 1, 48]
+    time = part.bcd_to_time(bytes)
+    assert_equal time, Time.new(2000, 1, 1, 0, 0, 0.0)
+  end
+  
+  def test_time=
+    mock = MiniTest::Mock.new.expect :call, nil, [[0, [0, 0, 0, 6, 1, 1, 48]]]
+    part.stub(:write, mock) do
+      part.time = Time.new(2000, 1, 1, 0, 0, 0.0)
+    end
+  end
+  
+  def test_read
+    bus; inject_read("5:104-0,0,0,6,1,1,48")
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [part.address, 0x00, 7, repeated_start: false]
+    bus.stub(:_read, mock) do
+      part.time
+    end
+  end
+  
+  def test_pre_callback_filter
+    mock = MiniTest::Mock.new.expect :call, nil, [Time.new(2000, 1, 1, 0, 0, 0.0)]
+    part.stub(:update_state, mock) do
+      bus.send(:update, "104-0,0,0,6,1,1,48")
+    end
+  end
+end

From 277baa6d4c80c397dba9ea9662c81fd581822956 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 14 Feb 2023 16:09:18 -0400
Subject: [PATCH 244/296] Update led example and start numbering examples

---
 examples/{led => 01-led}/led.png | Bin
 examples/01-led/led.rb           |  57 +++++++++++++++++++++++++++++++
 examples/led/led.rb              |  23 -------------
 3 files changed, 57 insertions(+), 23 deletions(-)
 rename examples/{led => 01-led}/led.png (100%)
 create mode 100644 examples/01-led/led.rb
 delete mode 100644 examples/led/led.rb

diff --git a/examples/led/led.png b/examples/01-led/led.png
similarity index 100%
rename from examples/led/led.png
rename to examples/01-led/led.png
diff --git a/examples/01-led/led.rb b/examples/01-led/led.rb
new file mode 100644
index 00000000..66f66825
--- /dev/null
+++ b/examples/01-led/led.rb
@@ -0,0 +1,57 @@
+#
+# Simple example that controls an LED.
+#
+require 'bundler/setup'
+require 'dino'
+
+# If the board is connected with a USB cable, it's most likely serial over USB.
+connection = Dino::TxRx::Serial.new
+
+# Initialize an object to represent the board, giving the connection.
+board = Dino::Board.new(connection)
+
+# Initialize an object representing the LED, giving the board and pin.
+# The on-board LED (marked "L") is connectd to pin 13 on most Arduinos.
+led = Dino::Components::Led.new(pin: 13, board: board)
+
+#
+# Now we can control the LED.
+# Led is a DigitalOutput, so it can only have one of two states:
+# 1 / high / on
+# 0 / low / off
+#
+# We can write the state directly, or use named convenience methods.
+# The 3 lines below all do the same thing: turn it on, wait half a second, turn it off.
+#
+led.write(1); sleep 0.5; led.write(0)
+led.high;     sleep 0.5; led.low
+led.on;       sleep 0.5; led.off
+
+#
+# Calling #toggle will set it to the opposite of its current state.
+# Keep it blinking for 3 more seconds using #toggle.
+#
+6.times do
+  led.toggle
+  sleep 0.5
+end
+
+#
+# What if we want to blink in the background?
+#
+# led.blink runs in a separate thread, managed by the led object,
+# and doesn't block the main thread. Give it the blink interval in seconds.
+#
+led.blink 0.5
+
+# Wait while it blinks for 5 seconds.
+sleep 5
+
+# Call a method that sets the state (#write, #high, #low, #on, #off) to
+# automatically stop the blink thread.
+led.off
+sleep 2
+
+# Blink faster indefinitely.
+led.blink 0.25
+sleep
diff --git a/examples/led/led.rb b/examples/led/led.rb
deleted file mode 100644
index f7b8b7a7..00000000
--- a/examples/led/led.rb
+++ /dev/null
@@ -1,23 +0,0 @@
-#
-# This is a simple example to blink an led
-# every half a second
-#
-require 'bundler/setup'
-require 'dino'
-
-board = Dino::Board.new(Dino::TxRx::Serial.new)
-led = Dino::Components::Led.new(pin: 13, board: board)
-
-# Start blinking every half second.
-led.blink 0.5
-
-# Wait for 5 seconds. #blink does not block.
-sleep 5
-
-# Calling #on implicitly stops #blink.
-led.on
-sleep 5
-
-# Blink faster.
-led.blink 0.25
-sleep

From 56532b5212d4ee4263a42b91d36f269731060fb2 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 14 Feb 2023 16:18:04 -0400
Subject: [PATCH 245/296] Arrange the first 5 examples into a mini tutorial

---
 examples/{button => 02-button}/button.png           | Bin
 examples/{button => 02-button}/button.rb            |   0
 .../potentiometer.rb                                |   0
 examples/04-pwm_led/pwm_led.rb                      |   0
 examples/{rgb_led => 05-rgb_led}/rgb_led.rb         |   0
 5 files changed, 0 insertions(+), 0 deletions(-)
 rename examples/{button => 02-button}/button.png (100%)
 rename examples/{button => 02-button}/button.rb (100%)
 rename examples/{potentiometer => 03-potentiometer}/potentiometer.rb (100%)
 create mode 100644 examples/04-pwm_led/pwm_led.rb
 rename examples/{rgb_led => 05-rgb_led}/rgb_led.rb (100%)

diff --git a/examples/button/button.png b/examples/02-button/button.png
similarity index 100%
rename from examples/button/button.png
rename to examples/02-button/button.png
diff --git a/examples/button/button.rb b/examples/02-button/button.rb
similarity index 100%
rename from examples/button/button.rb
rename to examples/02-button/button.rb
diff --git a/examples/potentiometer/potentiometer.rb b/examples/03-potentiometer/potentiometer.rb
similarity index 100%
rename from examples/potentiometer/potentiometer.rb
rename to examples/03-potentiometer/potentiometer.rb
diff --git a/examples/04-pwm_led/pwm_led.rb b/examples/04-pwm_led/pwm_led.rb
new file mode 100644
index 00000000..e69de29b
diff --git a/examples/rgb_led/rgb_led.rb b/examples/05-rgb_led/rgb_led.rb
similarity index 100%
rename from examples/rgb_led/rgb_led.rb
rename to examples/05-rgb_led/rgb_led.rb

From 62d4e4a65e4e76bfef6203ea4d13ac5d70cc765b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 15 Feb 2023 01:36:57 -0400
Subject: [PATCH 246/296] Improve flow control: no timing functions. Notify
 every half buffer size.

---
 lib/dino/tx_rx/base.rb         |  2 +-
 lib/dino/tx_rx/flow_control.rb |  4 ++--
 src/lib/Dino.cpp               | 25 +++++++++----------------
 src/lib/Dino.h                 | 10 ++++------
 4 files changed, 16 insertions(+), 25 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 5faf665c..6493aca5 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -35,7 +35,7 @@ def flush_read
       end
 
       def start_read
-        @thread ||= Thread.new  do
+        @thread ||= Thread.new do
           trap("INT") do
             io.write("\n91\n")
             raise Interrupt
diff --git a/lib/dino/tx_rx/flow_control.rb b/lib/dino/tx_rx/flow_control.rb
index f21cf1d0..d72a1c38 100644
--- a/lib/dino/tx_rx/flow_control.rb
+++ b/lib/dino/tx_rx/flow_control.rb
@@ -64,8 +64,8 @@ def reset_flow_control
       def read_and_parse
         line = read
 
-        if line && line.match(/\ARCV:/)
-          remove_transit_bytes(line.split(/:/)[1].to_i)
+        if line && line.match(/\ARx/)
+          remove_transit_bytes(line.split(/x/)[1].to_i)
         elsif line
           parse(line)
         else
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 1515f690..fc667dc9 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -12,28 +12,21 @@ Dino::Dino(){
 }
 
 
-void Dino::acknowledge() {
-  stream->print("RCV:");
-  stream->print(rcvBytes);
+void Dino::rxNotify() {
+  stream->print("Rx");
+  stream->print(rxBytes);
   stream->print("\n");
-  rcvBytes = 0;
+  rxBytes = 0;
 }
 
 void Dino::run(){
-  boolean gotByte = false;
-
   while(stream->available() > 0) {
-    gotByte = true;
-    rcvBytes ++;
+    rxBytes ++;
     parse(stream->read());
 
-    // Acknowledge when we've received as many bytes as the serial input buffer
-    if (rcvBytes == rcvThreshold) acknowledge();
+    // Acknowledge when we've received half as many bytes as the serial buffer.
+    if (rxBytes >= rxNotifyLimit) rxNotify();
   }
-  if (gotByte) lastRcv = millis();
-
-  // Also acknowledge when the last byte received goes outside the receive window.
-  if ((rcvBytes > 0) && ((millis() - lastRcv) > rcvWindow)) acknowledge();
 
   // Run dino's listeners.
   updateListeners();
@@ -217,8 +210,8 @@ void Dino::updateListeners() {
 void Dino::handshake() {
   resetState();
 
-  // Reset this so we never send RCV: along with ACK:
-  rcvBytes = 0;
+  // Reset this so we never send Rx along with ACK:
+  rxBytes = 0;
 
   stream->print("ACK:");
   stream->print(AUX_SIZE);
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index f4e5a761..c63f2bdf 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -145,7 +145,6 @@ class Dino {
     //
     // Main loop input functions.
     //
-    void acknowledge();
     void parse(byte c);
     void process();
 
@@ -173,10 +172,9 @@ class Dino {
     #endif
     byte auxMsg[AUX_SIZE];
 
-    // Keep count of bytes as we receive them and send a dino message with how many.
-    uint8_t rcvBytes  = 0;
-    uint8_t rcvThreshold = 64;
-    unsigned long lastRcv = millis();
-    long long rcvWindow = 1000;
+    // Flow control stuff. Notify when we've received half a serial buffer worth of bytes.
+    void rxNotify();
+    uint8_t rxBytes  = 0;
+    uint8_t rxNotifyLimit = 32;
 };
 #endif

From be19bb3a3734c27c4bd047eaa77393f030fd23f7 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 15 Feb 2023 01:54:08 -0400
Subject: [PATCH 247/296] Update button example

---
 examples/01-led/led.rb       | 39 +++++++++++++----------
 examples/02-button/button.rb | 62 +++++++++++++++++++++++++++++-------
 2 files changed, 72 insertions(+), 29 deletions(-)

diff --git a/examples/01-led/led.rb b/examples/01-led/led.rb
index 66f66825..f372a4ee 100644
--- a/examples/01-led/led.rb
+++ b/examples/01-led/led.rb
@@ -1,34 +1,39 @@
 #
-# Simple example that controls an LED.
+# Example 1: Controlling an LED
 #
 require 'bundler/setup'
 require 'dino'
 
-# If the board is connected with a USB cable, it's most likely serial over USB.
-connection = Dino::TxRx::Serial.new
+# If the board is plugged into a USB port, we can talk to it with serial over USB.
+io = Dino::TxRx::Serial.new
 
-# Initialize an object to represent the board, giving the connection.
-board = Dino::Board.new(connection)
+# Create an object to represent the board, giving the I/O object.
+board = Dino::Board.new(io)
 
-# Initialize an object representing the LED, giving the board and pin.
-# The on-board LED (marked "L") is connectd to pin 13 on most Arduinos.
-led = Dino::Components::Led.new(pin: 13, board: board)
+#
+# Create an object for the LED, giving the board, and the pin that the positive
+# leg of your LED is connected to. The longer leg is usually positive.
+# See led.png in this folder for a hook-up diagram. 
+#
+# The on-board LED (marked "L") is internally connected to pin 13 on most Arduinos,
+# and can be used without connecting anything.
+#
+led = Dino::Components::Led.new(board: board, pin: 13)
 
 #
-# Now we can control the LED.
-# Led is a DigitalOutput, so it can only have one of two states:
+# Now we can use it. A digital output can only have one of two states:
 # 1 / high / on
 # 0 / low / off
 #
-# We can write the state directly, or use named convenience methods.
-# The 3 lines below all do the same thing: turn it on, wait half a second, turn it off.
+# We can write state directly, or use named convenience methods that led has.
+# The 3 lines below all do the same thing: turn on, wait half a second, turn off.
 #
 led.write(1); sleep 0.5; led.write(0)
 led.high;     sleep 0.5; led.low
 led.on;       sleep 0.5; led.off
 
 #
-# Calling #toggle will set it to the opposite of its current state.
+# led.toggle will set it to the opposite of its current state.
 # Keep it blinking for 3 more seconds using #toggle.
 #
 6.times do
@@ -40,18 +45,18 @@
 # What if we want to blink in the background?
 #
 # led.blink runs in a separate thread, managed by the led object,
-# and doesn't block the main thread. Give it the blink interval in seconds.
+# and doesn't block the main thread. Give the blink interval in seconds.
 #
 led.blink 0.5
 
 # Wait while it blinks for 5 seconds.
 sleep 5
 
-# Call a method that sets the state (#write, #high, #low, #on, #off) to
-# automatically stop the blink thread.
+# Calling a method that sets the state (#write, #high, #low, #on, #off)
+# automatically stops the blink thread.
 led.off
 sleep 2
 
 # Blink faster indefinitely.
-led.blink 0.25
+led.blink 0.05
 sleep
diff --git a/examples/02-button/button.rb b/examples/02-button/button.rb
index eadecf7f..6716786c 100644
--- a/examples/02-button/button.rb
+++ b/examples/02-button/button.rb
@@ -1,24 +1,62 @@
 #
-# This is an example of how to use the button class
-# You must register helpers and have the main thread
-# sleep or in someway keep running or your program
-# will exit before any callbacks can be called
+# Example 2: Using a Button
 #
 require 'bundler/setup'
 require 'dino'
 
+# Set up the board, connecting with serial over USB
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-button = Dino::Components::Button.new(pin: 13, board: board)
 
-button.down do
-  puts "button down"
-end
+#
+# Create an object for a momentary button, giving the board, and the pin that
+# the ungrounded side of the button is connected to.
+#
+# `pullup: true` tells the board to keep the input pin high (logical 1) when the
+# button is not pressed. Without this (or an external pullup resistor), the pin
+# might float between 0 and 1, giving incorrect readings.
+#
+# See button.png in this folder for a hook-up diagram.
+#
+button = Dino::Components::Button.new(board: board, pin: 7, pullup: true)
 
-button.up do
-  puts "button up"
+#
+# As soon as a Button (or any DigitalInput) is created, the board starts
+# listening for changes to the physical button. When that happens, our button
+# object is notified. To catch these notifications, we have to use a callback.
+#
+# button.add_callback saves a block of code, and runs it when the button state changes.
+# 
+# The callback below checks if the state is 0 (the button went from up to down),
+# then counts and prints the number of times pressed.
+#
+presses = 0
+button.add_callback(:count_presses) do |state|
+  if state == 0
+    presses = presses + 1
+    puts "Button press ##{presses}"
+  end
 end
 
-# Force callbacks to run at least once for the initial state.
-button.read
+# Wait for the button to be pressed 3 times.
+sleep 0.005 while presses < 3
+
+# Callbacks are stored in a Hash. We can be specific and use keys when adding and removing.
+button.remove_callbacks(:count_presses)
+
+# Or remove them all. Either way, the block above won't run anymore.
+button.remove_callbacks
+
+#
+# button.down and button.up add callbacks that automatically check state for you.
+#
+# #down runs only when state goes from high (1) to low (0).
+# #up runs only when state goes from low (0) to high (1).
+#
+# We can use them to control the internal LED from example 1.
+#
+led = Dino::Components::Led.new(board: board, pin: 13)
+
+button.up   { led.off } 
+button.down { led.on }
 
 sleep

From 5c5b4e65adcbe90a83ee83e56a8efa0aff471198 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 15 Feb 2023 14:31:58 -0400
Subject: [PATCH 248/296] Use a separate thread and buffer to write to the
 board.

The board buffer updates in the same thread that callbacks run. If we try to write in that thread, and there wasn't enough buffer, the write blocks indefinitely, and the buffer space never updates.
---
 lib/dino/tx_rx/base.rb         | 42 +++++++++++------
 lib/dino/tx_rx/flow_control.rb | 80 ++++++++++++++++++++------------
 lib/dino/tx_rx/handshake.rb    |  1 +
 lib/dino/tx_rx/serial.rb       |  4 +-
 lib/dino/tx_rx/tcp.rb          |  4 +-
 test/txrx/serial_test.rb       | 84 ++++++++++++++++++++++------------
 6 files changed, 136 insertions(+), 79 deletions(-)

diff --git a/lib/dino/tx_rx/base.rb b/lib/dino/tx_rx/base.rb
index 6493aca5..817aff9f 100644
--- a/lib/dino/tx_rx/base.rb
+++ b/lib/dino/tx_rx/base.rb
@@ -17,6 +17,10 @@ def self.inherited(subclass)
       end
 
     private
+    
+      def parse(line)
+        changed && notify_observers(line) if line
+      end
 
       def io
         @io ||= connect
@@ -26,34 +30,42 @@ def io_reset
         flush_read
         stop_read
         start_read
+        stop_write
+        start_write
       end
 
       def flush_read
-        Timeout.timeout(5) { read until read == nil }
+        Timeout.timeout(5) { _read until _read == nil }
       rescue Timeout::Error
         raise RxFlushTimeout, "Cannot read from device, or device not running dino"
       end
 
       def start_read
-        @thread ||= Thread.new do
-          trap("INT") do
-            io.write("\n91\n")
-            raise Interrupt
-          end
-
-          loop do
-            read_and_parse
-          end
+        @read_thread ||= Thread.new do
+          loop { parse(read) }
         end
       end
 
       def stop_read
-        Thread.kill(@thread) if @thread
-        @thread = nil
+        Thread.kill(@read_thread) if @read_thread
+        @read_thread = nil
       end
-
-      def parse(line)
-        changed && notify_observers(line)
+      
+      def start_write
+        @write_thread ||= Thread.new do
+          # Tell the board to reset if our script is interrupted.
+          trap("INT") do
+            _write "\n91\n"
+            raise Interrupt
+          end
+          
+          loop { write_from_buffer }
+        end
+      end
+      
+      def stop_write
+        Thread.kill(@write_thread) if @write_thread
+        @write_thread = nil
       end
     end
   end
diff --git a/lib/dino/tx_rx/flow_control.rb b/lib/dino/tx_rx/flow_control.rb
index d72a1c38..5c4fd95e 100644
--- a/lib/dino/tx_rx/flow_control.rb
+++ b/lib/dino/tx_rx/flow_control.rb
@@ -13,34 +13,15 @@ def initialize(*args)
 
       def write(message)
         add_write_call
-        @write_mutex.synchronize do
-          while message && !message.empty?
-            bytes = reserve_bytes(message.length)
-            if bytes > 0
-              fragment = message[0..(bytes-1)]
-              message = message[bytes..-1]
-              super(fragment)
-            else
-              tx_wait
-            end
-          end
-        end
-      end
-
-      # Keep the transit mutex lock for as little time as possible this way.
-      def reserve_bytes(length)
-        @transit_mutex.synchronize do
-          available = BOARD_BUFFER - @transit_bytes
-          reserved = (length > available) ? available : length
-          @transit_bytes += reserved
-          reserved
+        @write_buffer_mutex.synchronize do
+          @write_buffer << message
         end
       end
 
     private
 
       def reset_flow_control
-        @write_mutex    ||= Mutex.new
+        @io_mutex       ||= Mutex.new
         @transit_mutex  ||= Mutex.new
         @tx_sleep_mutex ||= Mutex.new
         @rx_sleep_mutex ||= Mutex.new
@@ -57,23 +38,62 @@ def reset_flow_control
           @read_lines      = 0
           @rx_sleep_calls  = 0
         end
+        
+        @write_buffer_mutex ||= Mutex.new
+        @write_buffer_mutex.synchronize do
+          @write_buffer = ""
+        end
 
         @last_interval_update = Time.now
       end
+      
+      def write_from_buffer
+        fragment = nil
+        
+        # Check space on the remote read buffer. If available, take a fragment
+        # of that many bytes off the local write buffer.
+        @write_buffer_mutex.synchronize do
+          break if @write_buffer.empty?
+          bytes = reserve_bytes(@write_buffer.length)
+          if bytes > 0
+            fragment = @write_buffer[0..(bytes-1)]
+            @write_buffer = @write_buffer[bytes..-1]
+          end
+        end
+        
+        # Write if we can. Wait otherwise.
+        if fragment
+          @io_mutex.synchronize { _write fragment }
+        else
+          tx_wait
+        end
+      end
 
-      def read_and_parse
-        line = read
+      # Use transit mutex for as short as possible by reserving bytes and writing later.
+      def reserve_bytes(length)
+        @transit_mutex.synchronize do
+          available = BOARD_BUFFER - @transit_bytes
+          reserved = (length > available) ? available : length
+          @transit_bytes += reserved
+          reserved
+        end
+      end
 
-        if line && line.match(/\ARx/)
-          remove_transit_bytes(line.split(/x/)[1].to_i)
-        elsif line
-          parse(line)
+      def read
+        line = @io_mutex.synchronize { _read }
+        
+        if line
+          add_read_line
+          if line.match(/\ARx/)
+            remove_transit_bytes(line.split(/x/)[1].to_i)
+            line = nil
+          end
         else
           rx_wait
         end
-
-        add_read_line if line
         update_sleep_intervals
+        
+        return line
       end
 
       def update_sleep_intervals
diff --git a/lib/dino/tx_rx/handshake.rb b/lib/dino/tx_rx/handshake.rb
index 7b060407..60d525a1 100644
--- a/lib/dino/tx_rx/handshake.rb
+++ b/lib/dino/tx_rx/handshake.rb
@@ -29,6 +29,7 @@ def handshake
 
             Timeout.timeout(HANDSHAKE_TIMEOUT) do
               loop do
+                sleep 0.001
                 if attempt.acknowledged
                   puts "Acknowledged. Hardware ready...\n\n"
                   
diff --git a/lib/dino/tx_rx/serial.rb b/lib/dino/tx_rx/serial.rb
index 5a99be8b..d9001de8 100644
--- a/lib/dino/tx_rx/serial.rb
+++ b/lib/dino/tx_rx/serial.rb
@@ -14,11 +14,11 @@ def to_s
         "#{@device} @ #{@baud} baud"
       end
 
-      def write(message)
+      def _write(message)
         io.write(message)
       end
 
-      def read
+      def _read
         buff, escaped = "", false
         loop do
           char = io.read(1)
diff --git a/lib/dino/tx_rx/tcp.rb b/lib/dino/tx_rx/tcp.rb
index df8eb31f..d0fbca35 100644
--- a/lib/dino/tx_rx/tcp.rb
+++ b/lib/dino/tx_rx/tcp.rb
@@ -25,7 +25,7 @@ def connect
         raise TCPConnectError, error.message
       end
 
-      def write(message)
+      def _write(message)
         loop do
           if IO.select(nil, [io], nil, 0)
             io.syswrite(message)
@@ -34,7 +34,7 @@ def write(message)
         end
       end
 
-      def read
+      def _read
         IO.select([io], nil, nil, 0) && io.gets.gsub(/\n\z/, "")
       end
     end
diff --git a/test/txrx/serial_test.rb b/test/txrx/serial_test.rb
index 16034a2d..93217f10 100644
--- a/test/txrx/serial_test.rb
+++ b/test/txrx/serial_test.rb
@@ -75,54 +75,78 @@ def test_connect_on_windows
 
   def test_io_reset
     flush_mock = MiniTest::Mock.new.expect :call, true
-    stop_mock = MiniTest::Mock.new.expect :call, true
-    start_mock = MiniTest::Mock.new.expect :call, true
+    r_stop_mock = MiniTest::Mock.new.expect :call, true
+    r_start_mock = MiniTest::Mock.new.expect :call, true
+    w_stop_mock = MiniTest::Mock.new.expect :call, true
+    w_start_mock = MiniTest::Mock.new.expect :call, true
+
     txrx.stub(:flush_read, flush_mock) do
-      txrx.stub(:stop_read, stop_mock) do
-        txrx.stub(:start_read, start_mock) do
-          txrx.send(:io_reset)
+      txrx.stub(:stop_read, r_stop_mock) do
+        txrx.stub(:start_read, r_start_mock) do
+          txrx.stub(:stop_write, w_stop_mock) do
+            txrx.stub(:start_write, w_start_mock) do
+              txrx.send(:io_reset)
+            end
+          end
         end
       end
     end
+    
     flush_mock.verify
-    stop_mock.verify
-    start_mock.verify
+    r_stop_mock.verify
+    r_start_mock.verify
+    w_start_mock.verify
+    w_start_mock.verify
   end
 
-  def test_read_and_parse
-    txrx.stub(:read, "02:00:00") do
-      txrx.stub(:changed, true) do
-        mock = MiniTest::Mock.new.expect :call, nil, ['02:00:00']
-        txrx.stub(:notify_observers, mock) do
-          txrx.send(:read_and_parse)
-        end
-        mock.verify
+  def test_read
+    txrx.stub(:_read, "02:00:00") do
+      line = txrx.send(:read)
+      assert_equal line, "02:00:00"
+    end
+  end
+  
+  def test_parse
+    mock = MiniTest::Mock.new.expect :call, nil, ['02:00:00']
+    txrx.stub(:changed, true) do
+      txrx.stub(:notify_observers, mock) do
+        txrx.send(:parse, '02:00:00')
       end
+      mock.verify
     end
   end
 
-  # Test start read?
-
   def test_stop_read
     thread = Thread.new { sleep }
-    mock = MiniTest::Mock.new.expect :call, nil, [thread]
-    txrx.instance_variable_set(:@thread, thread)
-
-    Thread.stub(:kill, mock) do
-      txrx.send(:stop_read)
-    end
-    mock.verify
+    txrx.instance_variable_set(:@read_thread, thread)
+    txrx.send(:stop_write)
+    assert_nil txrx.instance_variable_get(:@write_thread)
+  end
+  
+  def test_stop_write
+    thread = Thread.new { sleep }
+    txrx.instance_variable_set(:@write_thread, thread)
+    txrx.send(:stop_write)
+    assert_nil txrx.instance_variable_get(:@write_thread)
   end
 
   def test_write
-    mock = MiniTest::Mock.new.expect :write, nil, ['message']
-    txrx.stub(:io, mock) do
-      txrx.write('message')
+    # Message is appended to the buffer.
+    txrx.send(:stop_write)
+    txrx.write('message')
+    assert_equal txrx.instance_variable_get("@write_buffer"), "message"
+    
+    # Message is written from buffer when we start the write thread.
+    mock = MiniTest::Mock.new.expect :call, nil, ['message']
+    txrx.stub(:_write, mock) do
+      txrx.send(:start_write)
+      sleep 0.005
     end
     mock.verify
+    assert_equal txrx.instance_variable_get("@write_buffer"), ""
   end
 
-  def test_read_single_chars_until_newline_and_strips_it
+  def test_io_read_single_chars_until_newline_and_strips_it
     mock = MiniTest::Mock.new
     "line\n".split("").each do |char|
       mock.expect :read, char, [1]
@@ -133,7 +157,7 @@ def test_read_single_chars_until_newline_and_strips_it
     mock.verify
   end
 
-  def test_read_handles_escaped_newlines_and_backslashes
+  def test_io_read_handles_escaped_newlines_and_backslashes
     mock = MiniTest::Mock.new
     "l1\\\nl2\\\\\n".split("").each do |char|
       mock.expect :read, char, [1]
@@ -144,7 +168,7 @@ def test_read_handles_escaped_newlines_and_backslashes
     mock.verify
   end
 
-  def test_read_returns_empty_string_if_just_newline
+  def test_io_read_returns_empty_string_if_just_newline
     mock = MiniTest::Mock.new
     mock.expect :read, "\n", [1]
     txrx.stub(:io, mock) do

From b928561ffe8f8c505e3539a2c10ecd5c2560ad4b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 17 Feb 2023 17:15:47 -0400
Subject: [PATCH 249/296] Count ticks (and update listeners) more precisely

---
 src/lib/Dino.cpp       | 17 +++++++++++------
 src/lib/Dino.h         | 12 +++++++++---
 src/lib/DinoCoreIO.cpp |  4 ++--
 3 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index fc667dc9..f48063ee 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -188,12 +188,17 @@ void Dino::process() {
 // Digital listeners only send values on change.
 //
 void Dino::updateListeners() {
-  unsigned long now = micros();
-  if ((now - lastTick) > 1000) {
-    lastTick = now;
-    tickCount++;
+  currentTime = micros();
+  timeDiff = currentTime - lastTime;
+  
+  if (timeDiff > 999) {
+    // Add a tick for every 1000us passed
+    tickCount = tickCount + (timeDiff / 1000);
+      
+    // lastTime for next run is currentTime offset by remainder.
+    lastTime = currentTime - (timeDiff % 1000);
 
-    updateCoreListeners(tickCount);
+    updateCoreListeners();
 
     // Register Listeners
     #ifdef DINO_SHIFT
@@ -249,7 +254,7 @@ void Dino::resetState() {
   fragmentIndex = 0;
   charIndex = 0;
   tickCount = 0;
-  lastTick = micros();
+  lastTime = micros();
 }
 
 
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index c63f2bdf..f1170389 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -50,13 +50,19 @@ class Dino {
     void aWrite      (byte p, int v,  boolean echo=true);  //cmd = 3
     int  aRead       (byte p);                             //cmd = 4
     void setListener (byte p, boolean enabled, byte analog, byte exponent, boolean local=true); //cmd = 5
+    
+    // Read value of micros() every loop.
+    unsigned long currentTime;
+    
+    // Counts 1ms ticks based on currentTime. Rolls over every 256ms.
+    byte tickCount;
 
   private:
     //
     // Main loop listen functions.
     //
     void updateListeners       ();
-    void updateCoreListeners   (byte tickCount);
+    void updateCoreListeners   ();
     void analogListenerUpdate  (byte index);
     void digitalListenerUpdate (byte index);
     void clearCoreListeners    ();
@@ -138,8 +144,8 @@ class Dino {
     void resetState            ();  //cmd = 91
     void setRegisterDivider    ();  //cmd = 97
     void setAnalogResolution   ();  //cmd = 96
-    unsigned long lastTick;
-    byte tickCount;
+    unsigned long lastTime;
+    unsigned long timeDiff;
     byte registerDivider;
 
     //
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index 2c6c75ce..eee8d3e5 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -146,12 +146,12 @@ void Dino::setListener(byte p, boolean enabled, byte analog, byte exponent, bool
 }
 
 // Runs once on every loop to update necessary listeners.
-void Dino::updateCoreListeners(byte tickCount){
+void Dino::updateCoreListeners() {
   for (byte i = 0; i <= lastActiveListener; i++){
     // Check if active.
     if (bitRead(listeners[i][0], 7) == 1){
       // Check if to update it on this tick.
-	  // Divider exponent is last 3 bits of settings.
+	    // Divider exponent is last 3 bits of settings.
       byte exponent = listeners[i][0] & 0B00000111;
       byte divider = dividerMap[exponent];
       if(tickCount % divider == 0){

From cce3a135463c1b0aca417fad191beecb239a372b Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Fri, 17 Feb 2023 22:15:52 -0400
Subject: [PATCH 250/296] Set listener defaults after_initialize instead of in
 args

---
 lib/dino/components/basic/analog_input.rb  | 13 +++++++++++--
 lib/dino/components/basic/digital_input.rb |  9 +++++----
 lib/dino/components/mixins/listener.rb     |  4 ++--
 3 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/lib/dino/components/basic/analog_input.rb b/lib/dino/components/basic/analog_input.rb
index 78e32127..6ee735d6 100644
--- a/lib/dino/components/basic/analog_input.rb
+++ b/lib/dino/components/basic/analog_input.rb
@@ -7,15 +7,24 @@ class AnalogInput
         include Mixins::Reader
         include Mixins::Poller
         include Mixins::Listener
+        
+        def after_initialize(options={})
+          super(options)
+          @divider = 16
+        end
 
         def _read
           board.analog_read(pin)
         end
 
-        def _listen(divider=16)
-          @divider = divider
+        def _listen(divider=nil)
+          @divider = divider || @divider
           board.analog_listen(pin, @divider)
         end
+        
+        def pre_callback_filter(value)
+          value.to_i
+        end
       end
     end
   end
diff --git a/lib/dino/components/basic/digital_input.rb b/lib/dino/components/basic/digital_input.rb
index 2e3c4343..40d6e4dd 100644
--- a/lib/dino/components/basic/digital_input.rb
+++ b/lib/dino/components/basic/digital_input.rb
@@ -10,6 +10,7 @@ class DigitalInput
 
         def after_initialize(options={})
           super(options)
+          @divider = 4
           _listen
         end
 
@@ -17,8 +18,8 @@ def _read
           board.digital_read(pin)
         end
 
-        def _listen(divider=4)
-          @divider = divider
+        def _listen(divider=nil)
+          @divider = divider || @divider
           board.digital_listen(pin, @divider)
         end
 
@@ -34,8 +35,8 @@ def on_low(&block)
           end
         end
         
-        def pre_callback_filter(data)
-          data.to_i
+        def pre_callback_filter(value)
+          value.to_i
         end
 
         def high?; state == board.high end
diff --git a/lib/dino/components/mixins/listener.rb b/lib/dino/components/mixins/listener.rb
index fd89b8e9..b0fae556 100644
--- a/lib/dino/components/mixins/listener.rb
+++ b/lib/dino/components/mixins/listener.rb
@@ -7,10 +7,10 @@ module Listener
         attr_reader :divider
 
         def listen(divider=nil, &block)
-          @divider = divider
+          @divider = divider || @listener
           stop
           add_callback(:listen, &block) if block_given?
-          _listen(divider)
+          _listen(@divider)
         end
 
         def stop

From 3f9a2f2711ae5706ef760408277613d730bb09af Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 18 Feb 2023 00:16:52 -0400
Subject: [PATCH 251/296] Add Potentiometer, with moving average smoothing, and
 example

---
 examples/01-led/led.rb                     | 25 ++++----
 examples/02-button/button.rb               |  9 +--
 examples/03-potentiometer/potentiometer.rb | 66 +++++++++++++++++-----
 lib/dino/components.rb                     |  1 +
 lib/dino/components/potentiometer.rb       | 51 +++++++++++++++++
 5 files changed, 123 insertions(+), 29 deletions(-)
 create mode 100644 lib/dino/components/potentiometer.rb

diff --git a/examples/01-led/led.rb b/examples/01-led/led.rb
index f372a4ee..d78b0a77 100644
--- a/examples/01-led/led.rb
+++ b/examples/01-led/led.rb
@@ -20,20 +20,22 @@
 #
 led = Dino::Components::Led.new(board: board, pin: 13)
 
+# Now we can make it blink.
+puts "Blinking every half second..."
+
 #
-# Now we can use it. A digital output can only have one of two states:
+# A digital output can only have one of two states:
 # 1 / high / on
 # 0 / low / off
-#
-# We can write state directly, or use named convenience methods that led has.
-# The 3 lines below all do the same thing: turn on, wait half a second, turn off.
+# We can use led.write to set it directly, or named convenience methods.
+# These 3 lines all do the same thing: turn on, wait half a second, turn off.
 #
 led.write(1); sleep 0.5; led.write(0)
 led.high;     sleep 0.5; led.low
 led.on;       sleep 0.5; led.off
 
 #
-# led.toggle will set it to the opposite of its current state.
+# led.toggle will set it to the opposite state each time it's called.
 # Keep it blinking for 3 more seconds using #toggle.
 #
 6.times do
@@ -44,19 +46,20 @@
 #
 # What if we want to blink in the background?
 #
-# led.blink runs in a separate thread, managed by the led object,
-# and doesn't block the main thread. Give the blink interval in seconds.
+# led.blink runs in a separate thread, managed by the led, and doesn't block the
+# main thread. Give it the blink interval in seconds.
 #
 led.blink 0.5
-
-# Wait while it blinks for 5 seconds.
-sleep 5
+puts "Blinking in the background... Hello from the main thread!"
+sleep 3
 
 # Calling a method that sets the state (#write, #high, #low, #on, #off)
 # automatically stops the blink thread.
+puts "Turning off for 2 seconds..."
 led.off
 sleep 2
 
 # Blink faster indefinitely.
-led.blink 0.05
+puts "Blinking faster forever... (Press Ctrl+C to exit)"
+led.blink 0.1
 sleep
diff --git a/examples/02-button/button.rb b/examples/02-button/button.rb
index 6716786c..06b3816f 100644
--- a/examples/02-button/button.rb
+++ b/examples/02-button/button.rb
@@ -23,8 +23,7 @@
 # As soon as a Button (or any DigitalInput) is created, the board starts
 # listening for changes to the physical button. When that happens, our button
 # object is notified. To catch these notifications, we have to use a callback.
-#
-# button.add_callback saves a block of code, and runs it when the button state changes.
+# button.add_callback saves a block of code to run each time the button state changes.
 # 
 # The callback below checks if the state is 0 (the button went from up to down),
 # then counts and prints the number of times pressed.
@@ -40,8 +39,8 @@
 # Wait for the button to be pressed 3 times.
 sleep 0.005 while presses < 3
 
-# Callbacks are stored in a Hash. We can be specific and use keys when adding and removing.
-button.remove_callbacks(:count_presses)
+# Button keeps its callbacks in a Hash. We can be specific and use keys to add and remove.
+button.remove_callback(:count_presses)
 
 # Or remove them all. Either way, the block above won't run anymore.
 button.remove_callbacks
@@ -59,4 +58,6 @@
 button.up   { led.off } 
 button.down { led.on }
 
+puts "Press the button to turn on the LED... (Ctrl+C to exit)"
+
 sleep
diff --git a/examples/03-potentiometer/potentiometer.rb b/examples/03-potentiometer/potentiometer.rb
index 03940b62..3db77b09 100644
--- a/examples/03-potentiometer/potentiometer.rb
+++ b/examples/03-potentiometer/potentiometer.rb
@@ -1,24 +1,62 @@
 #
-# This is an example of how to use the sensor class
-# with a potentiometer to control the flash speed of an
-# LED. The set_delay callback reads from the potentiometer
-# and changes the sleep delay for the LED on/off cycle.  
-#  
+# Example 3: Potentiometer and Analog Inputs
+#
 require 'bundler/setup'
 require 'dino'
 
+# Set up the board, connecting with serial over USB
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-led = Dino::Components::Led.new(pin: 13, board: board)
-potentiometer = Dino::Components::Sensor.new(pin: 'A0', board: board)
 
-delay = 500.0
+#
+# Connect the potentiometer's outer 2 pins to Ground and Vcc respectively.
+# The center is the wiper, and should be connected to one of the board's analog
+# pins. On most boards these pins start with 'A' and can be given as strings.
+#
+# See potentiometer.png in this folder for a hook-up diagram.
+# 
+potentiometer = Dino::Components::Potentiometer.new(pin: 'A0', board: board)
+
+#
+# Like with Button, the Board starts reading the Potentiometer value immediately,
+# but we need to add a callback to do something with it.
+#
+potentiometer.on_change do |value|
+  print "Potentiometer value: #{value} \r"
+end
+puts "Turn the potentiometer to change value. Press Enter to continue..."
+
+# Stop the callback.
+gets; puts
+potentiometer.remove_callbacks
+
+#
+# The default resolution for Analog Input is 10-bits, so you should have seen
+# values from 0 - 1023. We can use the value to control the blinking
+# speed of the LED from the earlier example.
+# 
+led = Dino::Components::Led.new(board: board, pin: 13)
+
+# Helper method to calculate the blink time.
+def map_pot_value(value)
+  # Map 10 bit value into 0 to 1 range.
+  fraction = value / 1023.to_f
 
-potentiometer.when_data_received do |data|
-  puts "DATA: #{delay = data.to_i}"
+  # Linearization hack for audio taper potentiometers.
+  # Adjust k for different tapers. This was an A500K.
+  k = 5
+  linearized = (fraction * (k + 1)) / ((k * fraction) + 1)
+  # Use this for linear potentiometers instead.
+  # linearized = fraction 
+  
+  # Map to the 0.1 to 0.5 seconds range in reverse. Clockwise = faster.
+  0.5 - (linearized * 0.4)
 end
 
-[:on, :off].cycle do |switch|
-  puts "DELAY: #{seconds = (delay / 1000.0)}"
-  led.send(switch)
-  sleep seconds
+# Callback that calculates the blink interval and tells the LED.
+potentiometer.on_change do |value|
+  interval = map_pot_value(value)
+  print "LED blink interval: #{interval.round(4)} seconds    \r"
+  led.blink(interval)
 end
+puts "Turn potentiometer to control the LED blink. Press Ctrl+C to exit..."
+sleep
diff --git a/lib/dino/components.rb b/lib/dino/components.rb
index 30931282..9d44ac2f 100644
--- a/lib/dino/components.rb
+++ b/lib/dino/components.rb
@@ -21,5 +21,6 @@ module Components
     autoload :Piezo,            'dino/components/piezo'
     autoload :RotaryEncoder,    'dino/components/rotary_encoder'
     autoload :OneWire,          'dino/components/one_wire'
+    autoload :Potentiometer,    'dino/components/potentiometer'
   end
 end
diff --git a/lib/dino/components/potentiometer.rb b/lib/dino/components/potentiometer.rb
new file mode 100644
index 00000000..272a85b8
--- /dev/null
+++ b/lib/dino/components/potentiometer.rb
@@ -0,0 +1,51 @@
+module Dino
+  module Components
+    class Potentiometer < Basic::AnalogInput
+      
+      attr_accessor :smoothing
+      
+      def after_initialize(options={})
+        super(options)
+        
+        # Read 2x as often than regular AnalogInput.
+        @divider = 8
+        
+        # Keep values to smooth with moving average by default.
+        self.smoothing = true
+        @moving_set = []
+        
+        # Start listening immediately.
+        listen
+      end
+      
+      def smoothing_on
+        self.smoothing = true
+      end
+      
+      def smoothing_off
+        self.smoothing = false
+      end
+      
+      def on_change(&block)
+        add_callback(:on_change) do |new_state|
+          block.call(new_state) if new_state != self.state
+        end
+      end
+      
+      def pre_callback_filter(value)
+        smoothing ? smooth_input(value) : value
+      end
+      
+      def smooth_input(value)
+        # Add new value, but limit to the 8 latest values.
+        @moving_set << value.to_i
+        @moving_set.shift if @moving_set.length > 8
+        
+        average = @moving_set.reduce(:+) / @moving_set.length.to_f
+        
+        # Round up or down based on previous state to smooth even more.
+        state && (state > average) ? average.ceil : average.floor
+      end
+    end
+  end
+end

From fd95ec7715be76e79a80a5f64b0678071886d31e Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 18 Feb 2023 21:10:44 -0400
Subject: [PATCH 252/296] Output sketch folder instead for use with Arduino CLI

---
 lib/dino_cli.rb           | 2 +-
 lib/dino_cli/generator.rb | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/dino_cli.rb b/lib/dino_cli.rb
index 03e4621a..246221ca 100644
--- a/lib/dino_cli.rb
+++ b/lib/dino_cli.rb
@@ -13,6 +13,6 @@ def self.start(options={})
 
   def self.sketch(options)
     result = DinoCLI::Generator.run!(options)
-    $stdout.puts result[:sketch_file]
+    $stdout.puts result[:sketch_folder]
   end
 end
diff --git a/lib/dino_cli/generator.rb b/lib/dino_cli/generator.rb
index 119bfdb6..9389772b 100644
--- a/lib/dino_cli/generator.rb
+++ b/lib/dino_cli/generator.rb
@@ -139,6 +139,7 @@ def write
 
     # Return the location of the sketch file.
     options[:sketch_file] = sketch
+    options[:sketch_folder] = output_dir
     options
   end
 

From cd09ce0d81be4fb89998248b919b3ab0b3e3f86a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 19 Feb 2023 02:24:21 -0400
Subject: [PATCH 253/296] Update readme and changelog

---
 CHANGELOG.md |   2 +
 README.md    | 149 +++++++++++++++++++++++++++++++++++++++------------
 2 files changed, 117 insertions(+), 34 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 37ceb733..c1d3e0b7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -40,6 +40,8 @@
 
 - SoftwareSerial. _Uses Arduino `SoftSerial` library._ (**write only / experimental**)
 
+- Potentiometer class, based on AnalogInput, but enables moving average smoothing by default and adds #on_change callback method.
+
 - Rotary encoder support. _Uses polling method @ 1ms interval._ **WARNING**: Not suitable for high speed or precise position needs. It will definitely miss steps. Sufficient for rotary knobs as user input.
 
 - DHT11 / DHT 21 (AM2301) / DHT22 temperature and relative humidity sensor support. _Custom implementation where input pulses are measured on the board, then decoded in Ruby._
diff --git a/README.md b/README.md
index 60b988a0..13d65ba5 100644
--- a/README.md
+++ b/README.md
@@ -1,65 +1,146 @@
-# Dino 0.12.0
-[![Build Status](https://secure.travis-ci.org/austinbv/dino.png)](http://travis-ci.org/austinbv/dino)
+# Dino 0.12.0 [![Build Status](https://secure.travis-ci.org/austinbv/dino.png)](http://travis-ci.org/austinbv/dino)
+#### Ruby Meets Microcontrollers
+Dino gives you a high-level Ruby interface to low-level hardware, without writing microcontroller code. Use LEDs, buttons, sensors and more, just as easily as any Ruby object:
 
-## Get Started In No Time
+````ruby
+led.blink 0.5
 
-Dino lets you start programming your Arduino with Ruby in minutes.
+lcd.puts "Hello World!"
 
-#### Install the Gem
+reading = sensor.read
 
+button.down do
+  puts "Button pressed!"
+end
+````
+
+Dino doesn't run Ruby on the microcontroller board either, like [mruby](https://github.com/mruby/mruby). The board always runs a C++ firmware that exposes as much low-level I/O as possible, so we can use it in Ruby. It becomes an I/O peripheral for your computer.
+
+High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They also get thread-safe state, callbacks for inputs, and effectively mulitask a single threaded microcontroller (no "task" priority though).
+
+Physical components connected to your boards map to Ruby objects you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between.
+
+## Getting Started
+#### 1) Install the Gem
 ```shell
 gem install dino
 ```
 
-#### Download the Arduino IDE
+Before we can use the microcontroller in Ruby, we need to flash it with the dino firmware (or "sketch" in Arduino slang). This is needed **only once** for each board, but future versions of dino may need reflashing to add firmware-level functions.
 
-Dino is all about writing Ruby, but we'll need to upload some C code to the Arduino so we can talk to it. You'll need the [Arduino IDE](http://arduino.cc/en/Main/Software) for that. Even though it's still in beta, version 1.5 is recommended since it lets you upload from the command line.
+#### 2) Install the Arduino IDE OR CLI
 
-#### Connect your Arduino
+Download the Arduino IDE from [here](http://arduino.cc/en/Main/Software) for a graphical interface, or install the command line interface from [here](https://github.com/arduino/arduino-cli/releases), or Homebrew.
 
-Connect your board with a USB cable. Open the Arduino IDE and pull down the `Tools` menu. Make sure you have the right type of board, and the correct serial port selected.
+**CLI Installation with Homebrew on Mac, Linux, or WSL on Windows:**
+````shell
+brew update
+brew install arduino-cli
+````
 
-#### Prepare the Bootstrapper
+#### 3) Install Arduino Dependencies
+Dino uses Arduino "cores" which add microcontroller support, and a few C++ libraries for now. We need to install them.
 
-Use the included command line tool to create a folder with the Arduino sketch you want to use and optionally configure it.
+**IDE:**
+* Open the IDE and select Tools > Board > Board Manager from the menus.
+* Search for `ESP8266 Boards` and install the latest version.
+* Now go to: Tools > Manage Libraries.
+* Find and install the following libraries, at the version numbers given:
+  * `Liquid Crystal by Arduino, Adafruit` at latest version
+  * `IRremote by shirriff, z3to, ArminJo` at `version 2.2.3`
+  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.3.2`
 
+**CLI:**
+````shell
+arduino-cli core install esp8266:esp8266
+arduino-cli lib install LiquidCrystal
+arduino-cli lib install IRremote@2.2.3
+arduino-cli lib install IRremoteESP8266@2.3.2 
+````
+
+#### 4) Generate the Arduino Sketch
+The `dino` command is included with the gem. It will make the Arduino sketch folder for you, and configure it.
+
+**For ATmega boards, Serial over USB:** (Arduino Uno, Nano, Mega, Leonardo, Micro)
 ```shell
-# If connecting via serial, USB or ser2net, this is all you should need:
 dino sketch serial
+````
 
-# If usng the ethernet shield, you'll want to specify unique MAC and IP addresses:
-dino sketch ethernet -mac XX:XX:XX:XX:XX:XX -ip XXX.XXX.XXX.XXX
+**For ESP8266, Serial over USB:**
+```shell
+dino sketch serial -target esp8266
+````
 
-# For more options:
-dino help
-```
+**For ESP8266 over WiFi (2.4Ghz and DHCP Only):**
+```shell
+dino sketch wifi -target esp8266 -ssid YOUR_SSID -password YOUR_PASSWORD
+````
+**Note:** [This example](https://github.com/austinbv/dino/tree/master/examples/tcp.rb) shows how to instantiate a board over the network. After flashing, you'll need to figure out what IP address your board has, and modify the TxRx line in any other example you wish to run. They are written for serial.
+
+#### 5a) IDE Flashing
+
+* Connect the board to your computer with a USB cable.
+* Open the .ino file inside your sketch folder with the IDE.
+* Open the dropdown menu at the top of the IDE window, and select your board.
+* Press the Upload ➡️ button. This will compile the sketch, and flash it to the board.
+
+**Troubleshooting:**
+* If your serial port is in the list, but the board is wrong, select the serial port anyway, then go to Tools > Board in the menus and choose your board from the list.
+* If your board doesn't show up at all, make sure it is connected properly. Try disconnecting and reconnecting, use a different USB port or cable, or press the reset button after plugging it in.
 
-__Note:__ Current Ethernet shields come with a sticker indicating the MAC address you should use with them. For older shields without a dedicated MAC address, inventing a random one should work, but don't use the same one for multiple boards. Valid IP addresses depend on the configuration of your network.
+#### 5b) CLI Flashing
 
-#### Upload The Bootstrapper
+* The path output by `dino sketch` earlier is your sketch folder. Keep it handy.
+* Connect the board to your computer with a USB cable.
+* Check if the CLI recognizes it:
 
-* Connect the Arduino to a USB port on your machine, (even if using the ethernet sketch).
-* Open [the normal Arduino IDE](http://arduino.cc/en/Main/Software)
-* Open the `.ino` file in the sketch folder you just generated.
-* Click the upload button (an arrow).
+````shell
+arduino-cli board list
+````
+  
+* Using the Port and FQBN (Fully Qualified Board Name) shown, compile and upload the sketch:
+````shell
+arduino-cli compile -b YOUR_FQBN YOUR_SKETCH_FOLDER
+arduino-cli upload -v -p YOUR_PORT -b YOUR_FQBN YOUR_SKETCH_FOLDER
+````
 
-#### Verify Install
+**Troubleshooting:**
+* Follow the same steps as the IDE method above. List all FQBNs using:
+````shell
+arduino-cli board listall
+````
 
-* Build the sample circuit [examples/led/led.png](https://raw.github.com/austinbv/dino/master/examples/led/led.png)
-* From your terminal, execute `ruby example/led/led.rb`
-* Observe your LED blinking continuously
+#### 6)  Test It!
+
+Most boards have an on-board LED. It's internally connected to pin 13 on Arduinos, but might be another pin on your board. Run the LED example from [here](https://github.com/austinbv/dino/tree/master/examples/01-led/led.rb), changing the pin number if needed. If the LED starts blinking, you're ready for Ruby!
 
 ## Examples and Tutorials
 
-### Circuits and Programs
+#### Included Examples
+
+* The first 5 [examples](https://github.com/austinbv/dino/tree/master/examples) are sort of a mini-tutorial, to familiarize you with the basics. Read the comments and try modifying the code. You will need the following:
+  * 1 microcontroller (Arduino Uno, Leonardo and Mega are most compatible)
+  * 1 button or momentary switch
+  * 1 potentiometer (any value)
+  * 1 external RGB LED (4 legs common cathode, not a Neopixel, or individually addressable)
+  * 1 external LED (any color, or use one color of the RGB LED)
+  * Current limiting resistors for the LEDs
+  * Breadboard
+  * Jumper wires
+  
+  **Tip:** Arduino kits are a cost-effective way to get started. They will almost certainly include these parts, plus more, getting you well beyond the starter examples.
+  
+* The remaining examples will usually demonstrate the interface for a specific component class, or how to use multiple components together.
+* Each example folder should incldue a wiring diagram alongside its code.
+
+####  More Examples
 
-* Take a look in [the example directory](https://github.com/austinbv/dino/tree/master/examples) for small component examples
-* Try [Getting Started with Arduino and Dino](http://tutorials.jumpstartlab.com/projects/arduino/introducing_arduino.html) from [Jumpstart Lab](http://jumpstartlab.com), building a number-guessing game and a simple nightlight
-* An example [rails app using Dino and Pusher](https://github.com/austinbv/dino_rails_example)
-* For a Sinatra example look at the [site used to shoot the cannon at RubyConf2012](https://github.com/austinbv/dino_cannon)
+* Try [Getting Started with Arduino and Dino](http://tutorials.jumpstartlab.com/projects/arduino/introducing_arduino.html) from [Jumpstart Lab](http://jumpstartlab.com) (_ignore old install instructions_).
+* An example [rails app](https://github.com/austinbv/dino_rails_example)  using Dino and Pusher.
+* For a Sinatra example, look at the [site](https://github.com/austinbv/dino_cannon) used to shoot the cannon at RubyConf2012.
 
-### Explanatory Talks
+## Explanatory Talks
 
 * "Arduino the Ruby Way" at RubyConf 2012
-  * [Video by ConFreaks](http://confreaks.com/videos/1294-rubyconf2012-arduino-the-ruby-way)
+  * [Video by ConFreaks](https://www.youtube.com/watch?v=oUIor6GK-qA)
   * [Slides on SpeakerDeck](https://speakerdeck.com/austinbv/arduino-the-ruby-way)

From c1fdefa1a612b3265d215ff3ac78a21237efe37c Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 19 Feb 2023 02:38:32 -0400
Subject: [PATCH 254/296] Fix readme formatting

---
 README.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 13d65ba5..a112419b 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 # Dino 0.12.0 [![Build Status](https://secure.travis-ci.org/austinbv/dino.png)](http://travis-ci.org/austinbv/dino)
-#### Ruby Meets Microcontrollers
+### Ruby Meets Microcontrollers
 Dino gives you a high-level Ruby interface to low-level hardware, without writing microcontroller code. Use LEDs, buttons, sensors and more, just as easily as any Ruby object:
 
 ````ruby
@@ -14,9 +14,9 @@ button.down do
 end
 ````
 
-Dino doesn't run Ruby on the microcontroller board either, like [mruby](https://github.com/mruby/mruby). The board always runs a C++ firmware that exposes as much low-level I/O as possible, so we can use it in Ruby. It becomes an I/O peripheral for your computer.
+Dino doesn't run Ruby on the microcontroller board either, like [mruby](https://github.com/mruby/mruby). The board always runs a C++ firmware that exposes as much low-level I/O as possible, for us to use in Ruby. It becomes a peripheral for your computer.
 
-High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They also get thread-safe state, callbacks for inputs, and effectively mulitask a single threaded microcontroller (no "task" priority though).
+High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They get thread-safe state, callbacks for inputs, and mulitask a single core microcontroller, but no "task" priority.
 
 Physical components connected to your boards map to Ruby objects you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between.
 
@@ -26,11 +26,11 @@ Physical components connected to your boards map to Ruby objects you can use dir
 gem install dino
 ```
 
-Before we can use the microcontroller in Ruby, we need to flash it with the dino firmware (or "sketch" in Arduino slang). This is needed **only once** for each board, but future versions of dino may need reflashing to add firmware-level functions.
+Before using the microcontroller in Ruby, we need to flash it with the dino firmware (or "sketch" in Arduino slang). This is needed **only once** for each board, but future dino versions may need reflashing for firmware functions.
 
 #### 2) Install the Arduino IDE OR CLI
 
-Download the Arduino IDE from [here](http://arduino.cc/en/Main/Software) for a graphical interface, or install the command line interface from [here](https://github.com/arduino/arduino-cli/releases), or Homebrew.
+Get the Arduino IDE [here](http://arduino.cc/en/Main/Software) for a graphical interface, or use the command line interface from [here](https://github.com/arduino/arduino-cli/releases), or Homebrew.
 
 **CLI Installation with Homebrew on Mac, Linux, or WSL on Windows:**
 ````shell
@@ -39,7 +39,7 @@ brew install arduino-cli
 ````
 
 #### 3) Install Arduino Dependencies
-Dino uses Arduino "cores" which add microcontroller support, and a few C++ libraries for now. We need to install them.
+Dino uses Arduino "cores" which add microcontroller support, and a few C++ libraries for now. Let's install them.
 
 **IDE:**
 * Open the IDE and select Tools > Board > Board Manager from the menus.
@@ -75,7 +75,7 @@ dino sketch serial -target esp8266
 ```shell
 dino sketch wifi -target esp8266 -ssid YOUR_SSID -password YOUR_PASSWORD
 ````
-**Note:** [This example](https://github.com/austinbv/dino/tree/master/examples/tcp.rb) shows how to instantiate a board over the network. After flashing, you'll need to figure out what IP address your board has, and modify the TxRx line in any other example you wish to run. They are written for serial.
+**Note:** [This example](https://github.com/austinbv/dino/tree/master/examples/tcp.rb) shows how to instantiate a board over the network. You'll need to figure out what IP address your board got, and modify the TxRx line in other examples you wish to run. They are written for serial.
 
 #### 5a) IDE Flashing
 
@@ -112,7 +112,7 @@ arduino-cli board listall
 
 #### 6)  Test It!
 
-Most boards have an on-board LED. It's internally connected to pin 13 on Arduinos, but might be another pin on your board. Run the LED example from [here](https://github.com/austinbv/dino/tree/master/examples/01-led/led.rb), changing the pin number if needed. If the LED starts blinking, you're ready for Ruby!
+Most boards have an on-board LED. It's internally connected to pin 13 on Arduinos, but might be different for you. Run the LED example from [here](https://github.com/austinbv/dino/tree/master/examples/01-led/led.rb), changing the pin number if needed. If the LED starts blinking, you're ready for Ruby!
 
 ## Examples and Tutorials
 

From 169830b8385196771fded85093abcdbae9816b4f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 19 Feb 2023 14:02:18 -0400
Subject: [PATCH 255/296] Add board#finish_write for scripts that don't loop

---
 CHANGELOG.md                   | 14 +++++++-------
 README.md                      | 10 +++++-----
 examples/soft_serial.rb        | 15 +++++++++++++++
 examples/stepper/stepper.rb    |  5 ++++-
 lib/dino/board/base.rb         |  6 ++++++
 lib/dino/tx_rx/flow_control.rb |  4 ++++
 6 files changed, 41 insertions(+), 13 deletions(-)
 create mode 100644 examples/soft_serial.rb

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c1d3e0b7..7024f047 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -38,11 +38,11 @@
 
 - Tone (piezo) support. _Uses Arduino `tone`,`noTone` functions._ 
 
-- SoftwareSerial. _Uses Arduino `SoftSerial` library._ (**write only / experimental**)
+- SoftwareSerial **(write only)**. _Uses Arduino `SoftSerial` library. Only tested on ATmega chips._
 
-- Potentiometer class, based on AnalogInput, but enables moving average smoothing by default and adds #on_change callback method.
+- Potentiometer class, based on AnalogInput, but enables moving average smoothing by default, and adds #on_change callback method.
 
-- Rotary encoder support. _Uses polling method @ 1ms interval._ **WARNING**: Not suitable for high speed or precise position needs. It will definitely miss steps. Sufficient for rotary knobs as user input.
+- Rotary encoder support. _Polls @ 1ms interval._ **WARNING**: Not suitable for high speed or precise position needs. It will definitely miss steps. Sufficient for rotary knobs as user input.
 
 - DHT11 / DHT 21 (AM2301) / DHT22 temperature and relative humidity sensor support. _Custom implementation where input pulses are measured on the board, then decoded in Ruby._
 
@@ -54,7 +54,7 @@
   - Most bus features are implemented: reset/presence detect, parasite power handling, bus search and slave device identification, CRC. No overdrive support.
   - Based on [Kevin Darrah's video](https://www.youtube.com/watch?v=ZKNQhzPwH0s) explaining the DS18B20 datasheet.
 
-- I2C bus support. _Uses Arduino`Wire` library._
+- I2C bus support. _Uses Arduino `Wire` library._
 
 - Shift Register support. _Uses Arduino `ShiftOut` and `ShiftIn` functions._
 
@@ -71,7 +71,7 @@
 
 - Digital and analog listeners now have dividers on a per-pin basis.
   - Timing is based on a 1000 microsecond tick being counted by the board.
-  - Call `#listen` with a value as the first argument. Eg. `analog_sensor.listen(64)` will tell the board to send us that specific sensor's state every 64 ticks (~64ms)  or around 16 times per second, without affecting other components' rates.
+  - Call `#listen` with a value as the first argument. Eg. `analog_sensor.listen(64)` will tell the board to send us that specific sensor's state every 64 ticks (~64ms) or around 16 times per second, without affecting other components' rates.
   - Valid dividers are: `1, 2, 4, 8, 16, 32, 64, 128`.
   - Defaults are same as before: `4` for digital, `16` for analog.
 
@@ -85,8 +85,8 @@
 - `BoardProxy` abstraction for shift/SPI registers:
   - The `Register` classes implement enough of the `Board` interface to satisfy components based on `DigitalInput` and `DigitalOutput`, such as `Led` or `Button`.
   - This lets you call methods on components directly, rather than manipulating the register data to control components indirectly. 
-  - Initialize the appropriate `Register` object for the type of register. To initialize a component connected to the register, use the register as the "board", and for the pin, give the parallel I/O pin of the register that the component is connected to. Pin 0 maps to the lowest bit.
-  - This also works for `MultiPin` components built out of only `DigitalInput` and `DigitalOutput`, eg. `SSD` - seven segment display or `RGBLed`. See `examples/register` for more.
+  - Initialize the appropriate `Register` object for the type of register. To initialize a component connected to the register, use the register as the `board:`, and give the parallel I/O pin on the register that the component is connected to. Pin 0 maps to the lowest bit.
+  - This also works for `MultiPin` components built out of only `DigitalInput` or `DigitalOutput`, eg. `SSD` - seven segment display or `RGBLed`. See `examples/register` for more.
 
 ### Input Components, Callbacks and State
 - `@value` has been renamed to `@state`.
diff --git a/README.md b/README.md
index a112419b..a881a5be 100644
--- a/README.md
+++ b/README.md
@@ -14,11 +14,11 @@ button.down do
 end
 ````
 
-Dino doesn't run Ruby on the microcontroller board either, like [mruby](https://github.com/mruby/mruby). The board always runs a C++ firmware that exposes as much low-level I/O as possible, for us to use in Ruby. It becomes a peripheral for your computer.
+Dino doesn't run Ruby on the microcontroller board either, like [mruby](https://github.com/mruby/mruby). The board runs a C++ firmware that exposes as much low-level I/O as possible, so we can use it in Ruby. It becomes a peripheral for your computer.
 
-High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They get thread-safe state, callbacks for inputs, and mulitask a single core microcontroller, but no "task" priority.
+High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They "multitask" a single core microcontroller, with thread-safe state and callbacks for inputs, but no "task" priority. If you need more, integration is seamless. Simply connect another board and instantiate.
 
-Physical components connected to your boards map to Ruby objects you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between.
+Each physical component you connect to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between.
 
 ## Getting Started
 #### 1) Install the Gem
@@ -112,7 +112,7 @@ arduino-cli board listall
 
 #### 6)  Test It!
 
-Most boards have an on-board LED. It's internally connected to pin 13 on Arduinos, but might be different for you. Run the LED example from [here](https://github.com/austinbv/dino/tree/master/examples/01-led/led.rb), changing the pin number if needed. If the LED starts blinking, you're ready for Ruby!
+Most boards have an on-board LED. It's internally connected to pin 13 on Arduinos, but might be different for you. Run the LED example [here](https://github.com/austinbv/dino/tree/master/examples/01-led/led.rb). Change the pin number if needed. If the LED starts blinking, you're ready for Ruby!
 
 ## Examples and Tutorials
 
@@ -122,7 +122,7 @@ Most boards have an on-board LED. It's internally connected to pin 13 on Arduino
   * 1 microcontroller (Arduino Uno, Leonardo and Mega are most compatible)
   * 1 button or momentary switch
   * 1 potentiometer (any value)
-  * 1 external RGB LED (4 legs common cathode, not a Neopixel, or individually addressable)
+  * 1 external RGB LED (4 legs common cathode, not a Neopixel or individually addressable)
   * 1 external LED (any color, or use one color of the RGB LED)
   * Current limiting resistors for the LEDs
   * Breadboard
diff --git a/examples/soft_serial.rb b/examples/soft_serial.rb
new file mode 100644
index 00000000..fa04c8a7
--- /dev/null
+++ b/examples/soft_serial.rb
@@ -0,0 +1,15 @@
+#
+# Example of writing to software serial.
+#
+require 'bundler/setup'
+require 'dino'
+
+board = Dino::Board.new(Dino::TxRx::Serial.new(device: "/dev/cu.usbmodem14B01"))
+
+# Even though an Rx pin is given here (it's needed by the lbirary), only transmission works for now.
+soft_serial = Dino::Components::SoftwareSerial.new board: board, pins: { rx:10, tx:11 }, baud: 9600
+
+soft_serial.puts "Hello World!"
+
+# The board writes asynchronously. Make sure it has written everything before we exit.
+board.finish_write
diff --git a/examples/stepper/stepper.rb b/examples/stepper/stepper.rb
index c79c8b2c..a71daaa6 100644
--- a/examples/stepper/stepper.rb
+++ b/examples/stepper/stepper.rb
@@ -1,5 +1,5 @@
 #
-# This is a simple example to move a stepper motor using the sparkfun easydriver shield: https://www.sparkfun.com/products/10267?
+# Example driving a stepper motor with the EasyDriver board: https://www.sparkfun.com/products/10267?
 #
 require 'bundler/setup'
 require 'dino'
@@ -16,3 +16,6 @@
   stepper.step_cw
   sleep 0.001
 end
+
+# The board writes asynchronously. Make sure it has written everything before we exit.
+board.finish_write
diff --git a/lib/dino/board/base.rb b/lib/dino/board/base.rb
index 02b2c0a5..6b9bf34a 100644
--- a/lib/dino/board/base.rb
+++ b/lib/dino/board/base.rb
@@ -19,6 +19,12 @@ def initialize(io, options={})
         io.add_observer(self)
         self.analog_resolution = options[:bits] || 8
       end
+      
+      def finish_write
+        sleep 0.001 while @io.writing?
+        write "\n91\n"
+        sleep 0.001 while @io.writing?
+      end
 
       def analog_resolution
         @bits ||= 8
diff --git a/lib/dino/tx_rx/flow_control.rb b/lib/dino/tx_rx/flow_control.rb
index 5c4fd95e..4848b675 100644
--- a/lib/dino/tx_rx/flow_control.rb
+++ b/lib/dino/tx_rx/flow_control.rb
@@ -17,6 +17,10 @@ def write(message)
           @write_buffer << message
         end
       end
+      
+      def writing?
+        @write_buffer_mutex.synchronize { !@write_buffer.empty? }
+      end
 
     private
 

From 3880ca55ebf60c11c2d59079f15adcd7d61446b4 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 20 Feb 2023 11:36:08 -0400
Subject: [PATCH 256/296] Improve the stepper example

---
 README.md                      |  2 +-
 examples/stepper/stepper.rb    | 31 ++++++++++++++++++-----
 lib/dino/components/stepper.rb | 45 +++++++++++++++++-----------------
 lib/dino_cli/targets.txt       |  2 +-
 4 files changed, 49 insertions(+), 31 deletions(-)

diff --git a/README.md b/README.md
index a881a5be..860ec708 100644
--- a/README.md
+++ b/README.md
@@ -82,7 +82,7 @@ dino sketch wifi -target esp8266 -ssid YOUR_SSID -password YOUR_PASSWORD
 * Connect the board to your computer with a USB cable.
 * Open the .ino file inside your sketch folder with the IDE.
 * Open the dropdown menu at the top of the IDE window, and select your board.
-* Press the Upload ➡️ button. This will compile the sketch, and flash it to the board.
+* Press the Upload :arrow_right: button. This will compile the sketch, and flash it to the board.
 
 **Troubleshooting:**
 * If your serial port is in the list, but the board is wrong, select the serial port anyway, then go to Tools > Board in the menus and choose your board from the list.
diff --git a/examples/stepper/stepper.rb b/examples/stepper/stepper.rb
index a71daaa6..77655348 100644
--- a/examples/stepper/stepper.rb
+++ b/examples/stepper/stepper.rb
@@ -5,17 +5,36 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-stepper = Dino::Components::Stepper.new(board: board, pins: { step: 10, direction: 8 })
+stepper = Dino::Components::Stepper.new board: board,
+                                        pins: { slp: 6, enable: 7, direction: 8, step: 9, ms1: 10, ms2: 11 }
+                                        
+# Default is 8 microsteps. Set to 2 so we can move faster.
+stepper.microsteps = 2
 
-1600.times do
+# 400 steps is now 1 revolution for a 200 step motor.
+400.times do
   stepper.step_cc
-  sleep 0.001
+  sleep 0.002
 end
 
-1600.times do
+# Sleep the driver chip and wait a while.
+stepper.sleep
+sleep 1
+
+# Wake it up and set to full steps. 
+stepper.wake
+stepper.microsteps = 1
+
+#
+# Now 200 steps the other way will move us back to the start.
+# Note the longer sleep here since the steps are bigger.
+# Adjust both sleep vales to suit your motor.
+#
+200.times do
   stepper.step_cw
-  sleep 0.001
+  sleep 0.006
 end
 
-# The board writes asynchronously. Make sure it has written everything before we exit.
+# We write to the board asynchronously.
+# Make sure we send all step commands before exit.
 board.finish_write
diff --git a/lib/dino/components/stepper.rb b/lib/dino/components/stepper.rb
index 9716e75a..b6b12af4 100644
--- a/lib/dino/components/stepper.rb
+++ b/lib/dino/components/stepper.rb
@@ -9,46 +9,45 @@ class Stepper
       proxy_pins  ms1:       Basic::DigitalOutput,
                   ms2:       Basic::DigitalOutput,
                   enable:    Basic::DigitalOutput,
-                  sleep:     Basic::DigitalOutput,
-                  optional: true
-
+                  slp:       Basic::DigitalOutput,
+                  optional:  true
+                  
+      attr_reader :microsteps
+                  
       def after_initialize(options={})
-        wake; on; divider = 8
+        wake; on;
+        self.microsteps = 8
       end
 
-      def sleep_mode
-        sleep.low if pins[:sleep]
+      def sleep
+        slp.low if slp
       end
 
       def wake
-        sleep.high if pins[:sleep]
+        slp.high if slp
       end
 
       def off
-        enable.high if pins[:enable]
+        enable.high if enable
       end
 
       def on
-        enable.low if pins[:enable]
+        enable.low if enable
       end
 
-      def divider=(steps)
-        return unless (ms1 && ms2)
-        case steps.to_i
-        when 1
-          ms1.low; ms2.low
-        when 2
-          ms1.high; ms2.low
-        when 4
-          ms1.low; ms2.high
-        when 8
-          ms1.high; ms2.high
+      def microsteps=(steps)
+        if (ms1 && ms2)
+          case steps.to_i
+          when 1; ms2.low;  ms1.low
+          when 2; ms2.low;  ms1.high
+          when 4; ms2.high; ms1.low
+          when 8; ms2.high; ms1.high
+          end
         else
-          return
+          raise ArgumentError, "ms1 and ms2 pins must be connected to GPIO pins to control microstepping."
         end
-        @divider = steps
+        @microsteps = steps
       end
-      attr_reader :divider
 
       def step_cc
         direction.high unless direction.high?
diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
index 1fcf52e3..9d3afa61 100644
--- a/lib/dino_cli/targets.txt
+++ b/lib/dino_cli/targets.txt
@@ -42,7 +42,7 @@
       This specifically targets the older ATmega168 chip used in early Arduinos.
       With half the RAM and flash available, we need to cut the sketch down.
       This option includes core functionality AND:
-          Servo (6 maxmium), DHT, OneWire, IR Out, Tone, SPI, I2C
+          Servo (6 maxmium), DHT, Shift In/Out, Tone, SPI, I2C
 
       Chips:  ATmega168
       Boards: Duemilanove, Diecimila, Pro, Pro Mini

From 4d61f87d6148d1c69ab6a537f524d8a7dd749160 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 20 Feb 2023 13:31:47 -0400
Subject: [PATCH 257/296] Add wifi library to readme

---
 README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 860ec708..76942747 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,7 @@ Dino uses Arduino "cores" which add microcontroller support, and a few C++ libra
 * Now go to: Tools > Manage Libraries.
 * Find and install the following libraries, at the version numbers given:
   * `Liquid Crystal by Arduino, Adafruit` at latest version
+  * `WiFi by Arduino` at latest version
   * `IRremote by shirriff, z3to, ArminJo` at `version 2.2.3`
   * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.3.2`
 
@@ -54,8 +55,9 @@ Dino uses Arduino "cores" which add microcontroller support, and a few C++ libra
 ````shell
 arduino-cli core install esp8266:esp8266
 arduino-cli lib install LiquidCrystal
+arduino-cli lib install WiFi
 arduino-cli lib install IRremote@2.2.3
-arduino-cli lib install IRremoteESP8266@2.3.2 
+arduino-cli lib install IRremoteESP8266@2.3.2
 ````
 
 #### 4) Generate the Arduino Sketch

From c54edfa97bd514ba16768623f2d27251c93e7913 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 20 Feb 2023 13:32:11 -0400
Subject: [PATCH 258/296] Sleep stepper driver after example

---
 examples/stepper/stepper.rb | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/examples/stepper/stepper.rb b/examples/stepper/stepper.rb
index 77655348..6e03e21b 100644
--- a/examples/stepper/stepper.rb
+++ b/examples/stepper/stepper.rb
@@ -35,6 +35,9 @@
   sleep 0.006
 end
 
+# Sleep the driver once we're done.
+stepper.sleep
+
 # We write to the board asynchronously.
 # Make sure we send all step commands before exit.
 board.finish_write

From 737de0bf5a70aed8bf384e9f484d65b1374032bf Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 20 Feb 2023 15:18:36 -0400
Subject: [PATCH 259/296] Track supported hardware in HARDWARE.md

---
 HARDWARE.md | 171 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md   |   8 +--
 2 files changed, 175 insertions(+), 4 deletions(-)
 create mode 100644 HARDWARE.md

diff --git a/HARDWARE.md b/HARDWARE.md
new file mode 100644
index 00000000..122c61b6
--- /dev/null
+++ b/HARDWARE.md
@@ -0,0 +1,171 @@
+# Supported Microcontrollers
+
+:green_heart: Full support :yellow_heart: Partial support :heart: Planned. No support yet
+
+### Microchip/Atmel Chips in Arduino Products (and Compatibles) 
+
+|    Chip        | Status          | Version| Boards           | Notes |
+| :--------      | :------:        | :----- | :--------------- |------ |
+| ATmega168      | :yellow_heart:  | 0.12.0 | Duemilanove, Diecimila, Pro | Features removed for memory. Configurable. Run `dino targets` for more
+| ATmega328      | :green_heart:   | 0.11.0 | Uno, Nano, Fio, Pro  | 
+| ATmega32u4     | :green_heart:   | 0.11.0 | Leonardo, Micro, Leonardo ETH, Esplora, LilyPad USB | **v0.11.1** for Leonardo ETH
+| ATmega1280     | :green_heart:   | 0.11.1 | Mega | 
+| ATmega2560     | :green_heart:   | 0.11.1 | Mega2560, Arduino Mega ADK | 
+| ATSAM3X8E      | :yellow_heart:  | 0.12.0 | Due | Uses native USB. SoftSerial, Tone, IR Out, and I2C don't work yet
+| ATSAMD21       | :heart:         | -      | Zero, M0, M0 Pro | 
+
+**Note:** Only USB boards listed. Any supported chip should work, once you can flash it and connect to serial.
+
+### Arduino Accessories
+
+|    Chip               | Status          | Version| Product          | Notes |
+| :--------             | :------:        | :----- | :--------------- |------ |
+| Wiznet W5100/5500     | :green_heart:   | 0.11.1 | Ethernet Shield  | Wired Ethernet for Uno/Mega pin-compatible boards
+| HDG204 + AT32UC3      | :question:      | 0.12.0 | WiFi Shield      | WiFi for Uno. No hardware to test, but compiles
+| ATWINC1500            | :question:      | 0.12.0 | WiFi Shield 101  | As above, but heavy on RAM. Compiles for Mega only
+
+### Espressif Chips with Built-In WiFi
+
+|    Chip        | Status          | Version| Boards           | Notes |
+| :--------      | :------:        | :----- | :--------------- |------ |
+| ESP8266        | :yellow_heart:  | 0.12.0 | NodeMCU | SoftwareSerial and LCD don't work yet
+| ESP32          | :heart:         | -      | DOIT ESP32 DevKit V1 | Original ESP-WROOM-32
+| ESP32-S2       | :heart:         | -      | LOLIN S2 Pico | Single core Xtensa, native USB
+| ESP32-S3       | :heart:         | -      | LOLIN S3 V1.0.0 | Dual core RISC-V, native USB
+
+**Note:** There are too many boards using these chips to be comprehensive. Most should work. These are the exact ones used for testing, chosen based on popularity.
+
+# Supported Components
+
+:green_heart: Full support :yellow_heart: Partial support :heart: Planned. No support yet
+
+### Basic GPIO Interface
+
+| Name                  | Status          | Version  | Component Class | Notes |
+| :---------------      | :------:        | :-----   | :------         | :---- |
+| Digital Out           | :green_heart:   | 0.11.0   | `DigitalOutput` | -     |
+| Digital In            | :green_heart:   | 0.11.0   | `DigitalInput`  | 1ms - 128ms (4ms default) listen, poll, or read
+| Analog (PWM) Out      | :green_heart:   | 0.11.0   | `AnalogOutput`  |
+| Analog (ADC) In       | :green_heart:   | 0.11.0   | `AnalogInput`   | 1ms - 128ms (16ms default) listen, poll, or read
+| Analog (DAC) Out      | :green_heart:   | 0.12.0   | `AnalogOutput`  | Only present on Arduino Due and ESP32
+| Tone Out (Square Wave)| :green_heart:   | 0.12.0   | -               | Not working on Due yet
+
+**Note:** When listening, the board checks the pin's value every **_2^n_** ms (**_n_** from **_0_** to **_7_**), without further prompting. Polling and reading follow a call and response pattern.
+
+### Advanced Interfaces
+
+| Name             | Status         | SW/HW     | Version  | Component Class | Notes |
+| :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
+| I2C              | :green_heart:  | Hardware  | 0.12.0   | `I2C::Bus`
+| SPI              | :green_heart:  | Hardware  | 0.12.0   | `Register::Select` | Hardware register I/O
+| Shift In/Out     | :green_heart:  | Software  | 0.12.0   | `Register::Select` | Bit bang register I/O
+| Software Serial  | :yellow_heart: | Software  | 0.12.0   | `SoftwareSerial` | No read, only write
+| Hardware Serial  | :heart:        | Hardware  | -        | - | For boards with native USB and UARTs
+| Maxim OneWire    | :green_heart:  | Software  | 0.12.0   | `OneWire::Bus` | No overdrivee support
+| Infrared Emitter | :green_heart:  | Software  | 0.12.0   | `IREmitter` |
+
+### Generic Components
+
+| Name             | Status         | Interface   | Version  | Component Class   | Notes |
+| :--------------- | :------:       | :--------   | :-----   | :---------------  |------ |
+| Board EEPROM     | :green_heart:  | Built-In    | 0.12.0   | `BoardEEPROM` | Not all boards have EEPROM
+| Led              | :green_heart:  | Digi/Ana Out| 0.11.0   | `Led` |
+| RGBLed           | :green_heart:  | Digi/Ana Out| 0.11.0   | `RGBLed` |
+| Relay            | :green_heart:  | Digital Out | 0.11.0   | `Relay` |
+| 7 Segment Display| :yellow_heart: | Digital Out | 0.12.0   | `SSD` | No decimal point
+| Button           | :green_heart:  | Digital In  | 0.11.0   | `Button` | 
+| Rotary Encoder   | :green_heart:  | Digital In  | 0.12.0   | `RotaryEncoder` | Listens every 1ms
+| PIR Sensor       | :yellow_heart: | Digital In  | 0.11.0   | `DigitalInput` | Needs class. HC-SR501 
+| Analog Sensor    | :green_heart:  | Analog In   | 0.11.0   | `Sensor` |
+| Potentiometer    | :green_heart:  | Analog In   | 0.12.0   | `Potentiometer` | Smoothing on by default
+| Piezo Buzzer     | :green_heart:  | Tone Out    | 0.12.0   | `Piezo` | Frequency > 30Hz
+| Input Register   | :green_heart:  | ShiftIn     | 0.12.0   | `Register::ShiftIn` | Tested on CD4021B
+| Input Register   | :green_heart:  | SPI         | 0.12.0   | `Register::SPIIn` | Tested on CD4021B
+| Output Register  | :green_heart:  | ShiftOut    | 0.12.0   | `Register::ShiftOut` | Tested on 74HC595
+| Output Register  | :green_heart:  | SPI         | 0.12.0   | `Register::SPIOut` | Tested on 74HC595
+
+**Note:** Most Digital In and Out components can be used seamlessley through Input and Output Registers respectively.
+
+### Motors / Motor Drivers
+
+| Name                 | Status         | Interface | Version  | Component Class   | Notes |
+| :---------------     | :------:       | :-------- | :-----   | :---------------  |------ |
+| Servo                | :green_heart:  | Direct    | 0.11.2   | `Servo`  | Max 6 servos on the ATmega168, 12 otherwise
+| L298N                | :heart:        | Direct    |          | -        | 2ch DC motor driver
+| A3967                | :green_heart:  | Direct    | 0.12.0   | `Stepper`| 1ch microstepper. Tested with EasyDriver board
+| PCA9685              | :heart:        | I2C       | -        | -        | 16ch 12-bit PWM for servo, DC motor, or LED
+
+### Displays
+
+| Name                     | Status         | Interface        | Version  | Component Class   | Notes |
+| :---------------         | :------:       | :--------        | :-----   | :---------------  |------ |
+| HD44780 LCD              | :green_heart:  | Direct, C++ Lib  | 0.12.0   | `LCD` | Could make it work through registers
+| SSD1306 OLED             | :heart:        | I2C              | -        | -     |
+
+### Addressable LEDs
+
+| Name               | Status             | Interface             | Version  | Component Class   | Notes |
+| :---------------   | :------:           | :--------             | :-----   | :---------------  |------ |
+| Neopixel / WS2812B | :heart:            | -                     | -        | - |
+| Dotstar / APA102   | :grey_exclamation: | SPI                   | -        | - |
+
+### I/O Expansion
+
+| Name             | Status         | Interface     | Version  | Component Class      | Notes |
+| :--------------- | :------:       | :--------     | :-----   | :---------------     |------ 
+| PCF8574 Expander | :heart:        | I2C           | -        | -  | 8ch bi-directional digital I/O
+| ADS1115 ADC      | :heart:        | I2C           | -        | -  | 16-bit, 4ch analog to digital converter
+| ADS1118 ADC      | :heart:        | SPI           | -        | -  | 16-bit, 4ch analog to digital converter
+| PCF8591 ADC/DAC  | :heart:        | I2C           | -        | -  | 4ch ADC + 1ch DAC, 8-bit resolution
+
+### Environmental Sensors
+
+| Name             | Status         | Interface | Version  | Component Class   | Notes |
+| :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
+| DHT 11/21/22     | :green_heart:  | Direct    | 0.12.0   | `DHT` | Temperature, Humidity
+| DS18B20          | :green_heart:  | OneWire   | 0.12.0   | `OneWire::DS18B20`| Temperature
+| MAX31850         | :grey_exclamation: | OneWire   | -        | - | Thermocouple
+| BME280           | :heart:        | I2C       | -        | - | Pressure, Temperature, Humidity
+| BMP280           | :heart:        | I2C       | -        | - | Pressure, Temperature
+| HTU21D           | :heart:        | I2C       | -        | - | Temperature, Humidity
+| HTU31D           | :heart:        | I2C       | -        | - | Temperature, Humidity
+| AHT10            | :heart:        | I2C       | -        | - | Temperature, Humidity
+| AHT21            | :heart:        | I2C       | -        | - | Temperature, Humidity
+| ENS160           | :heart:        | I2C       | -        | - | CO2e, TVOC, AQI
+| AGS02MA          | :heart:        | I2C       | -        | - | TVOC
+
+
+### Light Sensors
+
+| Name             | Status         | Interface | Version  | Component Class   | Notes |
+| :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
+| APDS9960         | :heart:        | I2C       | -        | - | Proximity, RGB, Gesture
+
+
+### Distance Sensors
+
+| Name             | Status         | Interface | Version  | Component Class   | Notes |
+| :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
+| HC-SR04          | :heart:        | Direct    | -        | - | Ultrasonic, 20-4000mm
+| VL53L0X          | :heart:        | I2C       | -        | - | Laser, 30 - 1000mm
+| GP2Y0E03         | :heart:        | I2C       | -        | - | Infrared, 40 - 500mm
+
+### Motion Sensors
+
+| Name             | Status         | Interface | Version  | Component Class   | Notes |
+| :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
+| ADXL345          | :heart:        | I2C       | -        | - | 3-axis Accelerometer
+| IT3205           | :heart:        | I2C       | -        | - | 3-axis Gyroscope
+| HMC5883L         | :heart:        | I2C       | -        | - | 3-axis Compass
+
+### Real Time Clock
+
+| Name             | Status         | Interface | Version  | Component Class   | Notes |
+| :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
+| DS3221           | :yellow_heart: | I2C       | 0.12.0   | `I2C::DS3231`     | Only set and get time implemented
+
+### Miscellaneous
+
+| Name             | Status         | Interface   | Version  | Component Class   | Notes |
+| :--------------- | :------:       | :--------   | :-----   | :---------------  |------ |
+| MFRC522          | :heart:        | SPI / I2C   | -        | -                 | RFID tag reader / writer
diff --git a/README.md b/README.md
index 76942747..e56cf782 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@ Dino doesn't run Ruby on the microcontroller board either, like [mruby](https://
 
 High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They "multitask" a single core microcontroller, with thread-safe state and callbacks for inputs, but no "task" priority. If you need more, integration is seamless. Simply connect another board and instantiate.
 
-Each physical component you connect to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between.
+Each physical component you connect to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between. See supported hardware [here](HARDWARE.md).
 
 ## Getting Started
 #### 1) Install the Gem
@@ -77,7 +77,7 @@ dino sketch serial -target esp8266
 ```shell
 dino sketch wifi -target esp8266 -ssid YOUR_SSID -password YOUR_PASSWORD
 ````
-**Note:** [This example](https://github.com/austinbv/dino/tree/master/examples/tcp.rb) shows how to instantiate a board over the network. You'll need to figure out what IP address your board got, and modify the TxRx line in other examples you wish to run. They are written for serial.
+**Note:** [This example](examples/tcp.rb) shows how to instantiate a board over the network. You'll need to figure out what IP address your board got, and modify the TxRx line in other examples you wish to run. They are written for serial.
 
 #### 5a) IDE Flashing
 
@@ -114,13 +114,13 @@ arduino-cli board listall
 
 #### 6)  Test It!
 
-Most boards have an on-board LED. It's internally connected to pin 13 on Arduinos, but might be different for you. Run the LED example [here](https://github.com/austinbv/dino/tree/master/examples/01-led/led.rb). Change the pin number if needed. If the LED starts blinking, you're ready for Ruby!
+Most boards have an on-board LED. It's internally connected to pin 13 on Arduinos, but might be different for you. Run the LED example [here](examples/01-led/led.rb). Change the pin number if needed. If the LED starts blinking, you're ready for Ruby!
 
 ## Examples and Tutorials
 
 #### Included Examples
 
-* The first 5 [examples](https://github.com/austinbv/dino/tree/master/examples) are sort of a mini-tutorial, to familiarize you with the basics. Read the comments and try modifying the code. You will need the following:
+* The first 5 [examples](examples) are sort of a mini-tutorial, to familiarize you with the basics. Read the comments and try modifying the code. You will need the following:
   * 1 microcontroller (Arduino Uno, Leonardo and Mega are most compatible)
   * 1 button or momentary switch
   * 1 potentiometer (any value)

From 2e1737a876846456ce002305e7693cfb12e9604a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 20 Feb 2023 20:13:10 -0400
Subject: [PATCH 260/296] Add servo dependency to readme

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index e56cf782..1a0f5a6c 100644
--- a/README.md
+++ b/README.md
@@ -46,6 +46,7 @@ Dino uses Arduino "cores" which add microcontroller support, and a few C++ libra
 * Search for `ESP8266 Boards` and install the latest version.
 * Now go to: Tools > Manage Libraries.
 * Find and install the following libraries, at the version numbers given:
+  * `Servo by Michael Margolis, Arduino` at latest version
   * `Liquid Crystal by Arduino, Adafruit` at latest version
   * `WiFi by Arduino` at latest version
   * `IRremote by shirriff, z3to, ArminJo` at `version 2.2.3`
@@ -54,6 +55,7 @@ Dino uses Arduino "cores" which add microcontroller support, and a few C++ libra
 **CLI:**
 ````shell
 arduino-cli core install esp8266:esp8266
+arduino-cli lib install Servo
 arduino-cli lib install LiquidCrystal
 arduino-cli lib install WiFi
 arduino-cli lib install IRremote@2.2.3

From 3b29dec241ba5e9df1f41818d6ca392685a1170a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Mon, 20 Feb 2023 23:02:13 -0400
Subject: [PATCH 261/296] Add basic ESP32 support

---
 HARDWARE.md              | 10 ++++----
 lib/dino_cli/targets.rb  |  5 +++-
 lib/dino_cli/targets.txt | 37 +++++++++++++++++++---------
 src/lib/Dino.cpp         |  5 +++-
 src/lib/Dino.h           | 15 ++++++++++++
 src/lib/DinoCoreIO.cpp   | 53 +++++++++++++++++++++++++++++++++++++++-
 6 files changed, 106 insertions(+), 19 deletions(-)

diff --git a/HARDWARE.md b/HARDWARE.md
index 122c61b6..53380d27 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -21,17 +21,17 @@
 |    Chip               | Status          | Version| Product          | Notes |
 | :--------             | :------:        | :----- | :--------------- |------ |
 | Wiznet W5100/5500     | :green_heart:   | 0.11.1 | Ethernet Shield  | Wired Ethernet for Uno/Mega pin-compatible boards
-| HDG204 + AT32UC3      | :question:      | 0.12.0 | WiFi Shield      | WiFi for Uno. No hardware to test, but compiles
-| ATWINC1500            | :question:      | 0.12.0 | WiFi Shield 101  | As above, but heavy on RAM. Compiles for Mega only
+| HDG204 + AT32UC3      | :man_shrugging: | 0.12.0 | WiFi Shield      | WiFi for Uno. No hardware to test, but compiles
+| ATWINC1500            | :man_shrugging: | 0.12.0 | WiFi Shield 101  | As above, but heavy on RAM. Compiles for Mega only
 
 ### Espressif Chips with Built-In WiFi
 
 |    Chip        | Status          | Version| Boards           | Notes |
 | :--------      | :------:        | :----- | :--------------- |------ |
 | ESP8266        | :yellow_heart:  | 0.12.0 | NodeMCU | SoftwareSerial and LCD don't work yet
-| ESP32          | :heart:         | -      | DOIT ESP32 DevKit V1 | Original ESP-WROOM-32
-| ESP32-S2       | :heart:         | -      | LOLIN S2 Pico | Single core Xtensa, native USB
-| ESP32-S3       | :heart:         | -      | LOLIN S3 V1.0.0 | Dual core RISC-V, native USB
+| ESP32          | :test_tube:     | -      | DOIT ESP32 DevKit V1 | Original ESP-WROOM-32
+| ESP32-S2       | :test_tube:     | -      | LOLIN S2 Pico | Single core Xtensa, native USB
+| ESP32-S3       | :test_tube:     | -      | LOLIN S3 V1.0.0 | Dual core RISC-V, native USB
 
 **Note:** There are too many boards using these chips to be comprehensive. Most should work. These are the exact ones used for testing, chosen based on popularity.
 
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 2d18ddfe..473de12b 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -16,7 +16,10 @@ class DinoCLI::Generator
     # ARM includes everytyhing except specific incompatibilities.
     sam3x: STANDARD_PACKAGES - [:serial, :tone, :ir_out],
 
-    # A surprising amount "just works" on the ESP, notably not LCD.
+    # ESP8266 mostly working.
     esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp8266],
+    
+    # Just core implementation on the ESP32 for now.
+    esp32: [:core]
   }
 end
diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
index 9d3afa61..4613c0d6 100644
--- a/lib/dino_cli/targets.txt
+++ b/lib/dino_cli/targets.txt
@@ -7,11 +7,12 @@
       primary target and default setting. All component features are included.
 
       Chips:  ATmega328p, ATmega32u4, ATmega1280, ATmega2560
-      Boards: UNO, Nano, Mini, Ethernet
+      Boards: Arduino Uno, Nano, Mini, Ethernet
               Leonardo, Micro, Esplora, Leonardo ETH
               Mega 1280, Mega 2560, Mega ADK
               Most Lilypads (excluding ones with an ATmega168)
 
+
     esp8266
 
       Based on the ESP8266 chip by Espressif with integrated 2.4Ghz WiFi.
@@ -26,6 +27,29 @@
 
       Note: After the initial upload via serial, the WiFi sketch for this target
             supports over-the-air updates from the Arduino IDE using ArduinoOTA.
+            
+            
+    esp32
+
+      Based on the ESP32 chip by Espressif with integrated 2.4Ghz WiFi.
+      This is still EXPERIMENTAL! Only includes the core subset. WiFi not working.
+
+      Chips:  ESP32, ESP32-S2, ESP32-S3
+      Boards: ESP32 DevKit, LOLIN D32 / D32 Pro, LOLIN S2 Pico / Mini,
+              LOLIN S3 Pico / Mini
+              
+              
+    sam3x
+
+      This is the same as mega, but omits libraries specifically known to be
+      incompatible with the Atmel SAMD (ARM Cortex M0) chips. Use this when
+      you need to load a sketch on the Arduino Due or similar boards.
+      This option includes all component features EXCEPT:
+          Serial, Tone, IR Out, I2C
+
+      Chips:  AT91SAM3X8E
+      Boards: Arduino Due
+
 
     core
 
@@ -37,6 +61,7 @@
       This is mostly useful for testing, or if severely limited on memory, as it
       is the smallest sketch possible and should be universally compatible.
 
+
     mega168
 
       This specifically targets the older ATmega168 chip used in early Arduinos.
@@ -58,16 +83,6 @@
             These limits apply as long as an Atmega168 is selected in the
             Arduino IDE, regardless of the options passed to this sketch generator.
 
-    sam3x
-
-      This is the same as mega, but omits libraries specifically known to be
-      incompatible with the Atmel SAMD (ARM Cortex M0) chips. Use this when
-      you need to load a sketch on the Arduino Due or similar boards.
-      This option includes all component features EXCEPT:
-          Serial, Tone, IR Out, I2C
-
-      Chips:  AT91SAM3X8E
-      Boards: Due
 
   NOTE: While different targets include different libraries, you can manually
   control which libraries are included at compile time by editing DinoDefines.h.
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index f48063ee..18cbdf00 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -227,7 +227,7 @@ void Dino::handshake() {
   #ifdef ESP8266
   	stream->print(ESP8266_EEPROM_LENGTH);
   #elif defined(EEPROM_PRESENT)
-	stream->print(EEPROM.length());
+	  stream->print(EEPROM.length());
   #else
      stream->print('0');
   #endif
@@ -244,6 +244,9 @@ void Dino::handshake() {
 // CMD = 91
 void Dino::resetState() {
   clearCoreListeners();
+  #ifdef ESP32
+    clearLedcChannels();
+  #endif
   #ifdef DINO_SPI
     clearSpiListeners();
   #endif
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index f1170389..488e6f01 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -68,6 +68,21 @@ class Dino {
     void clearCoreListeners    ();
     void findLastActiveListener();
 
+    //
+    // Tanslating aWrite to ledcWrite for PWM out on the ESP32.
+    //
+    #ifdef ESP32
+    //
+    // Track which pin is assigned to each LEDC channel.
+    // Byte 0 = enabled or disabled
+    // Byte 1 = pin number attached to that channel
+    #define LEDC_CHANNEL_COUNT 16
+    byte ledcPins[LEDC_CHANNEL_COUNT][2];
+
+    byte ledcChannel(byte p);
+    void clearLedcChannels();
+    #endif
+
     //
     // Store listeners as a 2 dimensional array where each gets 2 bytes:
     //
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index eee8d3e5..e408bc21 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -14,7 +14,11 @@ void Dino::setMode(byte p, byte m) {
     pinMode(p, OUTPUT);
   }
   else {
+    #ifdef ESP32
+    pinMode(p, INPUT_PULLUP);
+    #else
     pinMode(p, INPUT);
+    #endif
   }
 }
 
@@ -64,10 +68,57 @@ void Dino::aWrite(byte p, int v, boolean echo) {
     Serial.println(echo);
   #endif
 
-  analogWrite(p,v);
+  #ifdef ESP32
+    byte channel = ledcChannel(p);
+    ledcWrite(channel, v);
+  #else
+    analogWrite(p,v);
+  #endif
+
   if (echo) coreResponse(p, v);
 }
 
+//
+// Manage ESP32 LEDC channels so we can do PWM write.
+//
+#ifdef ESP32
+byte Dino::ledcChannel(byte p) {
+  // Return a useless channel if none available.
+  byte channel = 255;
+
+  // Search for existing LEDC channel with our pin first.
+  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+    if (ledcPins[i][1] == p) {
+      channel = i;
+      break;
+    }
+  }
+
+  // If channel is still 255 we didn't find one, so make one.
+  if (channel == 255){
+    for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+      // 0th byte being 0 means not in use.
+      if (ledcPins[i][0] == 0) {
+        // Just use similar settings to ATmega for now.
+        ledcSetup(i, 1000, 8);
+        ledcAttachPin(p, i);
+        ledcPins[i][1] = p;
+        channel = i;
+        break;
+      }
+    }
+  }
+  return channel;
+};
+
+// 0th byte = 0 for not in use.
+void Dino::clearLedcChannels(){
+  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+    ledcPins[i][0] = 0;
+  }
+}
+#endif
+
 // CMD = 04
 // Read an analog input pin. 0 for LOW, up to 1023 for HIGH @ 10-bit resolution.
 int Dino::aRead(byte p) {

From abc39e0a5d67fb986a650d53e51c8a8d8bf00882 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 01:07:19 -0400
Subject: [PATCH 262/296] Fix WiFi, EEPROM and ADC/DAC reporting for ESP32

---
 lib/dino_cli/targets.txt |  2 +-
 src/dino_wifi.ino        | 43 +++++++++++++++++++++++++---------------
 src/lib/Dino.cpp         | 29 +++++++++++++++++----------
 src/lib/Dino.h           | 12 ++++++++---
 src/lib/DinoEEPROM.cpp   | 24 +++++++++++-----------
 5 files changed, 67 insertions(+), 43 deletions(-)

diff --git a/lib/dino_cli/targets.txt b/lib/dino_cli/targets.txt
index 4613c0d6..757c6298 100644
--- a/lib/dino_cli/targets.txt
+++ b/lib/dino_cli/targets.txt
@@ -32,7 +32,7 @@
     esp32
 
       Based on the ESP32 chip by Espressif with integrated 2.4Ghz WiFi.
-      This is still EXPERIMENTAL! Only includes the core subset. WiFi not working.
+      This is still EXPERIMENTAL! Only includes the core subset. WiFi works. No OTA yet.
 
       Chips:  ESP32, ESP32-S2, ESP32-S3
       Boards: ESP32 DevKit, LOLIN D32 / D32 Pro, LOLIN S2 Pico / Mini,
diff --git a/src/dino_wifi.ino b/src/dino_wifi.ino
index 8fd53a08..4f29b366 100644
--- a/src/dino_wifi.ino
+++ b/src/dino_wifi.ino
@@ -1,16 +1,23 @@
 #include "Dino.h"
-#ifdef ESP8266
+#if defined(ESP8266)
   #include <ESP8266WiFi.h>
   #include <ESP8266mDNS.h>
   #include <WiFiUdp.h>
   #include <ArduinoOTA.h>
   #define WIFI_STATUS_LED 2
+#elif defined(ESP32)
+  #include <WiFi.h>
+  #include <ESPmDNS.h>
+  // #include <WiFiUdp.h>
+  // #include <ArduinoOTA.h>
+  #define WIFI_STATUS_LED 2
 #else
   #include <SPI.h>
   #include <WiFi.h>
   #define WIFI_STATUS_LED 13
 #endif
 
+
 // Define 'serial' as the serial interface we want to use.
 // Defaults to Native USB port on the Due, whatever class "Serial" is on everything else.
 // Classes need to inherit from Stream to be compatible with the Dino library.
@@ -26,8 +33,6 @@ int port = 3466;
 char* ssid = "yourNetwork";
 char* pass = "yourPassword";
 boolean connected = false;
-long lastConnectAttempt;
-int WiFiConnectTimeout = 10000;
 
 Dino dino;
 WiFiServer server(port);
@@ -36,7 +41,7 @@ WiFiClient client;
 // Use the built in LED to indicate WiFi status.
 void indicateWiFi(byte value) {
   pinMode(WIFI_STATUS_LED, OUTPUT);
-  #ifdef ESP8266
+  #if defined(ESP8266)
     digitalWrite(WIFI_STATUS_LED, !value);
   #else
     digitalWrite(WIFI_STATUS_LED, value);
@@ -58,13 +63,21 @@ void printWifiStatus() {
 }
 
 void connect(){
-  #ifdef ESP8266
+  // Make sure we're in STA mode on ESP boards, which can also be AP.
+  #if defined(ESP8266) || defined(ESP32)
     WiFi.mode(WIFI_STA);
   #endif
-  if (millis() - lastConnectAttempt > WiFiConnectTimeout){
-    WiFi.begin(ssid, pass);
-    lastConnectAttempt = millis();
+
+  // Try to connect.
+  serial.print("Connecting to WiFi ");
+  WiFi.begin(ssid, pass);
+
+  // Delay until connected.
+  while (WiFi.status() != WL_CONNECTED) {
+    delay(500);
+    serial.print(".");
   }
+  connected = true;
 }
 
 void maintainWiFi(){
@@ -88,15 +101,10 @@ void setup() {
   serial.begin(115200);
   while(!serial);
 
-  // Enable over the air updates and "EEPROM" on the ESP8266.
-  #ifdef ESP8266
-    EEPROM.begin(512);
+  // Enable over the air updates on the ESP8266.
+  #if defined(ESP8266)
     ArduinoOTA.begin();
   #endif
-  // Start the dino TCP server.
-  server.begin();
-
-  delay(2000);
 
   // Attempt initial WiFi connection.
   #ifdef debug
@@ -106,6 +114,9 @@ void setup() {
     serial.println(ssid);
   #endif
   connect();
+  
+  // Start the dino TCP server.
+  server.begin();
 
   // Add listener callbacks for local logic.
   dino.digitalListenCallback = onDigitalListen;
@@ -135,7 +146,7 @@ void loop() {
   }
 
   // Handle OTA updates.
-  #ifdef ESP8266
+  #if defined(ESP8266)
     ArduinoOTA.handle();
   #endif
 }
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 18cbdf00..211285ad 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -101,11 +101,11 @@ void Dino::process() {
     case 4:  aRead               (pin);             break;
     case 5:  setListener         (pin, val, auxMsg[0], auxMsg[1], false); break;
 
-	#ifdef EEPROM_PRESENT
+  	#ifdef EEPROM_PRESENT
     // Implemented in DinoEEPROM.cpp
     case 6:  eepromRead          ();    break;
     case 7:  eepromWrite         ();    break;
-	#endif
+	  #endif
 
     // Implemented in DinoServo.cpp
     #ifdef DINO_SERVO
@@ -217,27 +217,34 @@ void Dino::handshake() {
 
   // Reset this so we never send Rx along with ACK:
   rxBytes = 0;
-
+  
+  // First value is aux size in bytes.
   stream->print("ACK:");
   stream->print(AUX_SIZE);
-  stream->print(',');
   
-  // Send the defined length for ESP8266 EEPROM and initialize later.
-  // Read the value and send that for other boards, except the Due.
-  #ifdef ESP8266
-  	stream->print(ESP8266_EEPROM_LENGTH);
+  // Second is EEPROM size in bytes. None on Due.
+  stream->print(',');
+  #if defined(ESP8266) || defined(ESP32)
+  	stream->print(ESP_EEPROM_LENGTH);
   #elif defined(EEPROM_PRESENT)
 	  stream->print(EEPROM.length());
   #else
      stream->print('0');
   #endif
-	
-  stream->print(',');
-  stream->print(A0);
+  
+  // Third is A0. Ignore for ESP32. Pins aren't in order.
+  #if !defined(ESP32)
+    stream->print(',');  
+    stream->print(A0);
+  #endif
+
+  // 4th is DAC0 if available. Ignore fore ESP32. Also not in order.
   #if defined(__SAM3X8E__)
     stream->print(',');
     stream->print(DAC0);
   #endif
+  
+  // End
   stream->print('\n');
 }
 
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 488e6f01..de1ee387 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -11,13 +11,17 @@
 #  define PIN_COUNT 70
 #elif defined(__SAM3X8E__)
 #  define PIN_COUNT 66
+#elif defined(ESP8266)
+#  define PIN_COUNT 17
+#elif defined(ESP32)
+#  define PIN_COUNT 40
 #else
 #  define PIN_COUNT 22
 #endif
 
 // Use the maximum length for the ESP8266 EEPROM.
-#ifdef ESP8266
-#  define ESP8266_EEPROM_LENGTH 4096
+#if defined(ESP8266) || defined(ESP32)
+#  define ESP_EEPROM_LENGTH 512
 #endif
 
 class Dino {
@@ -182,7 +186,9 @@ class Dino {
     byte valStr[4]; byte val;
 
     // Scale aux message allocation based on enabled features and chip.
-    #if defined(DINO_IR_OUT) && !defined (__AVR_ATmega168__)
+    # if defined(ESP8266) || defined(ESP32)
+    #  define AUX_SIZE 528
+    #elif defined(DINO_IR_OUT) && !defined(__AVR_ATmega168__)
     #  define AUX_SIZE 528
     #elif defined(DINO_SHIFT) || defined(DINO_SPI) || defined (DINO_I2C)
     #  define AUX_SIZE 264
diff --git a/src/lib/DinoEEPROM.cpp b/src/lib/DinoEEPROM.cpp
index dd898c9f..1ea4bc7e 100644
--- a/src/lib/DinoEEPROM.cpp
+++ b/src/lib/DinoEEPROM.cpp
@@ -13,8 +13,8 @@
 //
 void Dino::eepromRead(){
   if (val > 0) {
-	#ifdef ESP8266
-	  EEPROM.begin(ESP8266_EEPROM_LENGTH);
+	  #if defined(ESP8266) || defined(ESP32)
+	    EEPROM.begin(ESP_EEPROM_LENGTH);
     #endif
 	  
     uint16_t startAddress = ((uint16_t)auxMsg[1] << 8) | auxMsg[0];
@@ -30,9 +30,9 @@ void Dino::eepromRead(){
       stream->print((i+1 == val) ? '\n' : ',');
     }
 	
-	#ifdef ESP8266
-	  EEPROM.end();
-	#endif
+  	#if defined(ESP8266) || defined(ESP32)
+  	  EEPROM.end();
+  	#endif
   }
 }
 
@@ -46,9 +46,9 @@ void Dino::eepromRead(){
 //
 void Dino::eepromWrite(){
   if (val > 0) {
-	#ifdef ESP8266
-	  EEPROM.begin(ESP8266_EEPROM_LENGTH);
-	#endif
+  	#if defined(ESP8266) || defined(ESP32)
+  	  EEPROM.begin(ESP_EEPROM_LENGTH);
+  	#endif
 	  
     uint16_t startAddress = ((uint16_t)auxMsg[1] << 8) | auxMsg[0];
 
@@ -56,10 +56,10 @@ void Dino::eepromWrite(){
 	  EEPROM.write(startAddress + i, auxMsg[2+i]);
     }
 	
-	#ifdef ESP8266
-	  EEPROM.end();
-	  EEPROM.commit();
-	#endif
+  	#if defined(ESP8266) || defined(ESP32)
+  	  EEPROM.end();
+  	  EEPROM.commit();
+  	#endif
   }
 }
 #endif
\ No newline at end of file

From 4bfa84f07b47f848060b4db5370eb1ccfc3d0c74 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 11:34:25 -0400
Subject: [PATCH 263/296] Make the SPI header API method clearer

---
 lib/dino/api/spi.rb | 27 ++++++++++++---------------
 1 file changed, 12 insertions(+), 15 deletions(-)

diff --git a/lib/dino/api/spi.rb b/lib/dino/api/spi.rb
index 40449a04..8885fd67 100644
--- a/lib/dino/api/spi.rb
+++ b/lib/dino/api/spi.rb
@@ -7,7 +7,7 @@ def spi_header(options)
         options[:read]       ||= 0
         options[:write]        = [options[:write]].flatten.compact || []
         options[:mode]       ||= 0
-        options[:frequency]  ||= 3000000
+        options[:frequency]  ||= 1000000
         options[:bit_order]  ||= :msbfrst
                   
         # Bit 0..3 of settings control the SPI mode
@@ -17,18 +17,14 @@ def spi_header(options)
         # 1000 = SPI_MODE2
         # 1100 = SPI_MODE3
         #
-        settings = case options[:mode]
-        when 0
-          0b0000
-        when 1
-          0b0100
-        when 2
-          0b1000
-        when 3
-          0b1100
-        else
-          raise ArgumentError, "invalid SPI mode. Must be 0, 1, 2, or 3"
-        end
+        settings =  case options[:mode]
+                    when 0; 0b0000
+                    when 1; 0b0100
+                    when 2; 0b1000
+                    when 3; 0b1100
+                    else
+                      raise ArgumentError, "invalid SPI mode. Must be 0, 1, 2, or 3"
+                    end
         
         # Bit 7 of settings toggles MSBFIRST (1) or LSBFIRST (0) transmission order.
         settings = settings | 0b10000000 unless options[:bit_order] == :lsbfirst
@@ -36,8 +32,9 @@ def spi_header(options)
         raise ArgumentError, "can't read more than 255 SPI bytes at a time" if options[:read] > 255
         raise ArgumentError, "can't write more than 255 SPI bytes at a time" if options[:write].length > 255
         
-        uint8 = pack(:uint8, [settings, options[:read], options[:write].length])
-        [uint8 + pack(:uint32, options[:frequency]), options]
+        header = pack :uint8, [settings, options[:read], options[:write].length]
+        header = header + pack(:uint32, options[:frequency])
+        [header, options]
       end
 
       # CMD = 26

From 694d061b991626cba24252a5f601e3da227f0dbf Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 12:40:56 -0400
Subject: [PATCH 264/296] Cast SPI clock speed to uint32_t properly

---
 src/lib/Dino.cpp    | 2 +-
 src/lib/DinoSPI.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index f48063ee..9a36c8f4 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -147,7 +147,7 @@ void Dino::process() {
 
     // Implemented in DinoSPI.cpp
     #ifdef DINO_SPI
-    case 26: spiTransfer      (pin, auxMsg[0], auxMsg[1], auxMsg[2], (uint32_t)auxMsg[3], &auxMsg[7]); break;
+    case 26: spiTransfer      (pin, auxMsg[0], auxMsg[1], auxMsg[2], *((uint32_t*)(auxMsg + 3)), &auxMsg[7]); break;
     case 27: addSpiListener   ();  break;
     case 28: removeSpiListener();  break;
     #endif
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 280c0b90..45db44ab 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -102,7 +102,7 @@ void Dino::addSpiListener() {
         pin,
         auxMsg[0],
         auxMsg[1],
-        (uint32_t)auxMsg[3],
+        *((uint32_t*)(auxMsg + 3)),
         true
       };
       return;

From 9bc06284c422a07bdda30784dd3bebc6774f0e62 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 15:30:45 -0400
Subject: [PATCH 265/296] I2C support for ESP32 and fixed stop bit being
 flipped

---
 HARDWARE.md         |  2 +-
 lib/dino/api/i2c.rb | 10 ++++----
 src/lib/Dino.cpp    |  2 +-
 src/lib/DinoI2C.cpp | 57 +++++++++++++++++++++++++++++++--------------
 4 files changed, 46 insertions(+), 25 deletions(-)

diff --git a/HARDWARE.md b/HARDWARE.md
index 53380d27..d547d449 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -56,7 +56,7 @@
 
 | Name             | Status         | SW/HW     | Version  | Component Class | Notes |
 | :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
-| I2C              | :green_heart:  | Hardware  | 0.12.0   | `I2C::Bus`
+| I2C              | :green_heart:  | Hardware  | 0.12.0   | `I2C::Bus` | Only default clocks
 | SPI              | :green_heart:  | Hardware  | 0.12.0   | `Register::Select` | Hardware register I/O
 | Shift In/Out     | :green_heart:  | Software  | 0.12.0   | `Register::Select` | Bit bang register I/O
 | Software Serial  | :yellow_heart: | Software  | 0.12.0   | `SoftwareSerial` | No read, only write
diff --git a/lib/dino/api/i2c.rb b/lib/dino/api/i2c.rb
index fe7a4b41..5c3d2ddd 100644
--- a/lib/dino/api/i2c.rb
+++ b/lib/dino/api/i2c.rb
@@ -10,9 +10,9 @@ def i2c_search
 
       # CMD = 34
       def i2c_write(address, bytes=[], options={})
-        # Bit 1 of settings controls repeated start.
+        # Bit 0 of settings controls stop (1), or repated start (0)
         settings  = 0b00
-        settings |= 0b01 if options[:repeated_start]
+        settings |= 0b01 unless options[:repeated_start]
         
         aux = pack :uint8, [address, 0, bytes.length, bytes].flatten
         write Message.encode command: 34,
@@ -24,11 +24,11 @@ def i2c_write(address, bytes=[], options={})
       def i2c_read(address, register, num_bytes, options={})
         raise ArgumentError, 'maximum read length from I2C devices is 32 bytes' if num_bytes > 32
         
-        # Bit 1 of settings controls repeated start.
+        # Bit 0 of settings controls stop (1), or repated start (0)
         settings  = 0b00
-        settings |= 0b01 if options[:repeated_start]
+        settings |= 0b01 unless options[:repeated_start]
         
-        # Bit 2 of settings controls whether to write a start register before reading.
+        # Bit 1 of settings controls whether to write a start register before reading.
         settings |= 0b10 if register
         register = 0 unless register
 
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 434517f6..28814c52 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -229,7 +229,7 @@ void Dino::handshake() {
   #elif defined(EEPROM_PRESENT)
 	  stream->print(EEPROM.length());
   #else
-     stream->print('0');
+    stream->print('0');
   #endif
   
   // Third is A0. Ignore for ESP32. Pins aren't in order.
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
index 32778b3c..f0250c3f 100644
--- a/src/lib/DinoI2C.cpp
+++ b/src/lib/DinoI2C.cpp
@@ -20,18 +20,19 @@ void Dino::i2cBegin() {
 // CMD = 33
 // Ask each address for a single byte to see if it exists on the bus.
 void Dino::i2cSearch() {
+  byte error;
+  uint8_t addr;
+  i2cBegin();
   stream->print(SDA);
 
-  i2cBegin();
-  for (uint8_t i = 0x08; i < 0x78;  i++) {
-    uint8_t length = 1;
-    Wire.requestFrom(i, length);
-    if (Wire.available()){
-      stream->print(':'); stream->print(i);
-      while(Wire.available()) Wire.read();
+  // Only addresses from 0x08 to 0x77 are usable (8 to 127).
+  for (addr = 0x08; addr < 0x78;  addr++) {
+    Wire.beginTransmission(addr);
+    error = Wire.endTransmission();
+    if (error == 0){
+      stream->print(':'); stream->print(addr);
     }
   }
-
   stream->print('\n');
 }
 
@@ -43,7 +44,7 @@ void Dino::i2cSearch() {
 // val bit 1  = write register address before reading
 // val bit 2+ = unused
 //
-// auxMsg[0]  = 7-bit device address
+// auxMsg[0]  = 7-bit device addresses
 // auxMsg[1]  = reserved
 // auxMsg[2]  = data length
 // auxMsg[3]+ = data
@@ -51,11 +52,17 @@ void Dino::i2cSearch() {
 // Max limited by aux message size.
 //
 void Dino::i2cWrite() {
-  byte repeatedStart = bitRead(val, 0);
+  // No repeated start on ESP32.
+  #if defined(ESP32)
+    bool sendStop = true;
+  #else
+    bool sendStop = bitRead(val, 0);
+  #endif
+  
   i2cBegin();
   Wire.beginTransmission(auxMsg[0]);
   Wire.write(&auxMsg[3], auxMsg[2]);
-  Wire.endTransmission(repeatedStart);
+  Wire.endTransmission(sendStop);
 }
 
 // CMD = 35
@@ -74,19 +81,33 @@ void Dino::i2cWrite() {
 // Max 32 bytes, limited by Wire library buffer. Validate remotely.
 //
 void Dino::i2cRead() {
+  // Limit to 32 bytes.
   if (auxMsg[3] > 32) auxMsg[3] = 32;
-  byte repeatedStart = bitRead(val, 0);
-  i2cBegin();
 
+  // No repeated start on ESP32.
+  #if defined(ESP32)
+    bool sendStop = true;
+  #else
+    bool sendStop = bitRead(val, 0);
+  #endif
+
+  i2cBegin();
+  
   // Optionally write a register address before reading.
   if (bitRead(val, 1)) {
     Wire.beginTransmission(auxMsg[0]);
     Wire.write(auxMsg[2]);
-    Wire.endTransmission(repeatedStart);
+    Wire.endTransmission(sendStop);
   }
-  Wire.beginTransmission(auxMsg[0]);
-  Wire.requestFrom(auxMsg[0], auxMsg[3], repeatedStart);
-
+  
+  // ESP32 crashes if requestFrom gets the 3rd arg.
+  #if defined(ESP32)  
+    Wire.requestFrom(auxMsg[0], auxMsg[3]);
+  #else
+    // Wire.beginTransmission(auxMsg[0]);
+    Wire.requestFrom(auxMsg[0], auxMsg[3], sendStop);
+  #endif
+  
   // Send data as if coming from SDA pin. Prefix with device adddress.
   // Fail silently if no bytes read / invalid device address.
   if(Wire.available()){
@@ -99,6 +120,6 @@ void Dino::i2cRead() {
     stream->print(Wire.read());
     stream->print((currentByte == auxMsg[3]) ? '\n' : ',');
   }
-  Wire.endTransmission(repeatedStart);
+  Wire.endTransmission(sendStop);
 }
 #endif

From 03bc57f12d116ecf732e727d7d12f056ea8285b3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 15:32:56 -0400
Subject: [PATCH 266/296] Fix I2C stop bit being flipped

---
 HARDWARE.md         |  2 +-
 lib/dino/api/i2c.rb | 10 ++++----
 src/lib/Dino.cpp    |  2 +-
 src/lib/DinoI2C.cpp | 57 +++++++++++++++++++++++++++++++--------------
 4 files changed, 46 insertions(+), 25 deletions(-)

diff --git a/HARDWARE.md b/HARDWARE.md
index 122c61b6..d03b390f 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -56,7 +56,7 @@
 
 | Name             | Status         | SW/HW     | Version  | Component Class | Notes |
 | :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
-| I2C              | :green_heart:  | Hardware  | 0.12.0   | `I2C::Bus`
+| I2C              | :green_heart:  | Hardware  | 0.12.0   | `I2C::Bus` | Only default clocks
 | SPI              | :green_heart:  | Hardware  | 0.12.0   | `Register::Select` | Hardware register I/O
 | Shift In/Out     | :green_heart:  | Software  | 0.12.0   | `Register::Select` | Bit bang register I/O
 | Software Serial  | :yellow_heart: | Software  | 0.12.0   | `SoftwareSerial` | No read, only write
diff --git a/lib/dino/api/i2c.rb b/lib/dino/api/i2c.rb
index fe7a4b41..5c3d2ddd 100644
--- a/lib/dino/api/i2c.rb
+++ b/lib/dino/api/i2c.rb
@@ -10,9 +10,9 @@ def i2c_search
 
       # CMD = 34
       def i2c_write(address, bytes=[], options={})
-        # Bit 1 of settings controls repeated start.
+        # Bit 0 of settings controls stop (1), or repated start (0)
         settings  = 0b00
-        settings |= 0b01 if options[:repeated_start]
+        settings |= 0b01 unless options[:repeated_start]
         
         aux = pack :uint8, [address, 0, bytes.length, bytes].flatten
         write Message.encode command: 34,
@@ -24,11 +24,11 @@ def i2c_write(address, bytes=[], options={})
       def i2c_read(address, register, num_bytes, options={})
         raise ArgumentError, 'maximum read length from I2C devices is 32 bytes' if num_bytes > 32
         
-        # Bit 1 of settings controls repeated start.
+        # Bit 0 of settings controls stop (1), or repated start (0)
         settings  = 0b00
-        settings |= 0b01 if options[:repeated_start]
+        settings |= 0b01 unless options[:repeated_start]
         
-        # Bit 2 of settings controls whether to write a start register before reading.
+        # Bit 1 of settings controls whether to write a start register before reading.
         settings |= 0b10 if register
         register = 0 unless register
 
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 9a36c8f4..4e4fbbc4 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -229,7 +229,7 @@ void Dino::handshake() {
   #elif defined(EEPROM_PRESENT)
 	stream->print(EEPROM.length());
   #else
-     stream->print('0');
+    stream->print('0');
   #endif
 	
   stream->print(',');
diff --git a/src/lib/DinoI2C.cpp b/src/lib/DinoI2C.cpp
index 32778b3c..f0250c3f 100644
--- a/src/lib/DinoI2C.cpp
+++ b/src/lib/DinoI2C.cpp
@@ -20,18 +20,19 @@ void Dino::i2cBegin() {
 // CMD = 33
 // Ask each address for a single byte to see if it exists on the bus.
 void Dino::i2cSearch() {
+  byte error;
+  uint8_t addr;
+  i2cBegin();
   stream->print(SDA);
 
-  i2cBegin();
-  for (uint8_t i = 0x08; i < 0x78;  i++) {
-    uint8_t length = 1;
-    Wire.requestFrom(i, length);
-    if (Wire.available()){
-      stream->print(':'); stream->print(i);
-      while(Wire.available()) Wire.read();
+  // Only addresses from 0x08 to 0x77 are usable (8 to 127).
+  for (addr = 0x08; addr < 0x78;  addr++) {
+    Wire.beginTransmission(addr);
+    error = Wire.endTransmission();
+    if (error == 0){
+      stream->print(':'); stream->print(addr);
     }
   }
-
   stream->print('\n');
 }
 
@@ -43,7 +44,7 @@ void Dino::i2cSearch() {
 // val bit 1  = write register address before reading
 // val bit 2+ = unused
 //
-// auxMsg[0]  = 7-bit device address
+// auxMsg[0]  = 7-bit device addresses
 // auxMsg[1]  = reserved
 // auxMsg[2]  = data length
 // auxMsg[3]+ = data
@@ -51,11 +52,17 @@ void Dino::i2cSearch() {
 // Max limited by aux message size.
 //
 void Dino::i2cWrite() {
-  byte repeatedStart = bitRead(val, 0);
+  // No repeated start on ESP32.
+  #if defined(ESP32)
+    bool sendStop = true;
+  #else
+    bool sendStop = bitRead(val, 0);
+  #endif
+  
   i2cBegin();
   Wire.beginTransmission(auxMsg[0]);
   Wire.write(&auxMsg[3], auxMsg[2]);
-  Wire.endTransmission(repeatedStart);
+  Wire.endTransmission(sendStop);
 }
 
 // CMD = 35
@@ -74,19 +81,33 @@ void Dino::i2cWrite() {
 // Max 32 bytes, limited by Wire library buffer. Validate remotely.
 //
 void Dino::i2cRead() {
+  // Limit to 32 bytes.
   if (auxMsg[3] > 32) auxMsg[3] = 32;
-  byte repeatedStart = bitRead(val, 0);
-  i2cBegin();
 
+  // No repeated start on ESP32.
+  #if defined(ESP32)
+    bool sendStop = true;
+  #else
+    bool sendStop = bitRead(val, 0);
+  #endif
+
+  i2cBegin();
+  
   // Optionally write a register address before reading.
   if (bitRead(val, 1)) {
     Wire.beginTransmission(auxMsg[0]);
     Wire.write(auxMsg[2]);
-    Wire.endTransmission(repeatedStart);
+    Wire.endTransmission(sendStop);
   }
-  Wire.beginTransmission(auxMsg[0]);
-  Wire.requestFrom(auxMsg[0], auxMsg[3], repeatedStart);
-
+  
+  // ESP32 crashes if requestFrom gets the 3rd arg.
+  #if defined(ESP32)  
+    Wire.requestFrom(auxMsg[0], auxMsg[3]);
+  #else
+    // Wire.beginTransmission(auxMsg[0]);
+    Wire.requestFrom(auxMsg[0], auxMsg[3], sendStop);
+  #endif
+  
   // Send data as if coming from SDA pin. Prefix with device adddress.
   // Fail silently if no bytes read / invalid device address.
   if(Wire.available()){
@@ -99,6 +120,6 @@ void Dino::i2cRead() {
     stream->print(Wire.read());
     stream->print((currentByte == auxMsg[3]) ? '\n' : ',');
   }
-  Wire.endTransmission(repeatedStart);
+  Wire.endTransmission(sendStop);
 }
 #endif

From 2f731d86c0009ef596f346d0259fc4d53ffc7293 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 17:01:23 -0400
Subject: [PATCH 267/296] Add I2C package to ESP32 target

---
 lib/dino_cli/targets.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index fc58deba..54a0378f 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -20,6 +20,6 @@ class DinoCLI::Generator
     esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp8266],
     
     # Just core implementation on the ESP32 for now.
-    esp32: [:core, :shift, :spi]
+    esp32: [:core, :shift, :spi, :i2c]
   }
 end

From a0f437b3843d2204734d64dd77fa5a5524ae0cdc Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 23:06:39 -0400
Subject: [PATCH 268/296] Manage LEDC channels better on the ESP32

---
 src/lib/Dino.h         |  2 +
 src/lib/DinoCoreIO.cpp | 84 +++++++++++++++++++++++++++++-------------
 2 files changed, 61 insertions(+), 25 deletions(-)

diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index de1ee387..964233b3 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -84,6 +84,8 @@ class Dino {
     byte ledcPins[LEDC_CHANNEL_COUNT][2];
 
     byte ledcChannel(byte p);
+    byte attachLEDC(byte channel, byte pin);
+    void detachLEDC(byte p);
     void clearLedcChannels();
     #endif
 
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index e408bc21..51ca3522 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -15,9 +15,10 @@ void Dino::setMode(byte p, byte m) {
   }
   else {
     #ifdef ESP32
-    pinMode(p, INPUT_PULLUP);
+      detachLEDC(p);
+      pinMode(p, INPUT_PULLUP);
     #else
-    pinMode(p, INPUT);
+      pinMode(p, INPUT);
     #endif
   }
 }
@@ -34,6 +35,11 @@ void Dino::dWrite(byte p, byte v, boolean echo) {
     Serial.println(echo);
   #endif
 
+  // Stop using a LEDC channel if the pin was using one.
+  #ifdef ESP32
+    detachLEDC(p);
+  #endif
+    
   if (v == 0) {
     digitalWrite(p, LOW);
   }
@@ -50,6 +56,11 @@ byte Dino::dRead(byte p) {
     Serial.print("dread, pin:");
     Serial.println(p);
   #endif
+  
+  // Stop using a LEDC channel if the pin was using one.
+  #ifdef ESP32
+    detachLEDC(p);
+  #endif
 
   byte rval = digitalRead(p);
   coreResponse(p, rval);
@@ -69,8 +80,9 @@ void Dino::aWrite(byte p, int v, boolean echo) {
   #endif
 
   #ifdef ESP32
-    byte channel = ledcChannel(p);
-    ledcWrite(channel, v);
+    // analogWrite is implemented but we can use manual control to do more.
+    // analogWrite(p,v);
+    ledcWrite(ledcChannel(p), v);
   #else
     analogWrite(p,v);
   #endif
@@ -83,37 +95,59 @@ void Dino::aWrite(byte p, int v, boolean echo) {
 //
 #ifdef ESP32
 byte Dino::ledcChannel(byte p) {
-  // Return a useless channel if none available.
-  byte channel = 255;
-
-  // Search for existing LEDC channel with our pin first.
+  // Search for enabled LEDC channel with given pin and use that if found.
   for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
-    if (ledcPins[i][1] == p) {
-      channel = i;
-      break;
+    if ((ledcPins[i][0] == 1) && (ledcPins[i][1] == p)){
+      return i;
     }
   }
 
-  // If channel is still 255 we didn't find one, so make one.
-  if (channel == 255){
-    for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
-      // 0th byte being 0 means not in use.
-      if (ledcPins[i][0] == 0) {
-        // Just use similar settings to ATmega for now.
-        ledcSetup(i, 1000, 8);
-        ledcAttachPin(p, i);
-        ledcPins[i][1] = p;
-        channel = i;
-        break;
-      }
+  // We didn't find a channel to reuse.
+  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+    // If the channel isn't initialized and it isn't marked as used, use it.
+    // should find some way to check if the channel itslef is being used
+    if ((ledcPins[i][0] == 0)) {
+      attachLEDC(i, p);
+      return i;
     }
   }
-  return channel;
+  
+  // Return a useless channel if none available.
+  return 255;
 };
 
-// 0th byte = 0 for not in use.
+// Attach a pin to a channel and save it.
+byte Dino::attachLEDC(byte channel, byte p){
+  // First 8 channels: up to 40Mhz @ 16-bits
+  // Last 8 channels: up to 500kHz @ 13-bits
+  // Just use similar settings to ATmega for now.
+  ledcSetup(channel, 1000, 8);
+  ledcAttachPin(p, channel);
+  
+  // Save the pin and mark it as in use.
+  ledcPins[channel][0] = 1;
+  ledcPins[channel][1] = p;
+  return channel;
+}
+
+// Stop using a LEDC channel when we're done.
+void Dino::detachLEDC(byte p){
+  // Detach the pin from the channel.
+  ledcDetachPin(p);
+  
+  // Mark any channel associated with our pin as unused.
+  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+    if (ledcPins[i][1] == p) ledcPins[i][0] = 0;
+  }
+}
+
+// Clear all the LEDC channels on reset.
 void Dino::clearLedcChannels(){
   for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+    // Stop the channel if it was still enabled.
+    if (ledcPins[i][0] != 0) ledcDetachPin(ledcPins[i][1]);
+    
+    // Mark the channel as unused.
     ledcPins[i][0] = 0;
   }
 }

From feebfa855dbb5781965b143effd568f32c8cc2ae Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Tue, 21 Feb 2023 23:40:38 -0400
Subject: [PATCH 269/296] Servo works on ESP32 by swapping library

---
 README.md               | 47 +++++++++++++++++++++++++++++++----------
 lib/dino_cli/targets.rb |  4 ++--
 src/lib/DinoServo.cpp   |  6 +++++-
 3 files changed, 43 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 1a0f5a6c..ed463923 100644
--- a/README.md
+++ b/README.md
@@ -39,29 +39,54 @@ brew install arduino-cli
 ````
 
 #### 3) Install Arduino Dependencies
-Dino uses Arduino "cores" which add microcontroller support, and a few C++ libraries for now. Let's install them.
+Dino uses Arduino "cores" which add microcontroller support, and a few libraries. Let's install them now.
 
-**IDE:**
-* Open the IDE and select Tools > Board > Board Manager from the menus.
-* Search for `ESP8266 Boards` and install the latest version.
-* Now go to: Tools > Manage Libraries.
+**IDE method for Arduino & Clones:**
+* Go to: Tools > Manage Libraries.
 * Find and install the following libraries, at the version numbers given:
   * `Servo by Michael Margolis, Arduino` at latest version
   * `Liquid Crystal by Arduino, Adafruit` at latest version
   * `WiFi by Arduino` at latest version
   * `IRremote by shirriff, z3to, ArminJo` at `version 2.2.3`
-  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.3.2`
 
-**CLI:**
+**CLI method for Arduino & Clones:**
 ````shell
-arduino-cli core install esp8266:esp8266
 arduino-cli lib install Servo
 arduino-cli lib install LiquidCrystal
 arduino-cli lib install WiFi
 arduino-cli lib install IRremote@2.2.3
+````
+
+**IDE method for ESP8266:**
+* Go to Tools > Board > Board Manager.
+* Search for `ESP8266 Boards` and install the latest version.
+* Go to: Tools > Manage Libraries.
+* Find and install the following libraries, at the version numbers given:
+  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.3.2`
+
+**CLI method for ESP8266:**
+````shell
+arduino-cli config add board_manager.additional_urls https://arduino.esp8266.com/stable/package_esp8266com_index.json
+arduino-cli core update-index
+arduino-cli core install esp8266:esp8266
 arduino-cli lib install IRremoteESP8266@2.3.2
 ````
 
+**IDE method for ESP32:**
+* Go to Tools > Board > Board Manager.
+* Search for `esp32` and install the latest version.
+* Go to: Tools > Manage Libraries.
+* Find and install the following libraries, at the version numbers given:
+  * `ESP32Servo by Kevin Harrington, John K. Bennett` at latest version
+
+**CLI method for ESP32:**
+````shell
+arduino-cli config add board_manager.additional_urls https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
+arduino-cli core update-index
+arduino-cli core install esp32
+arduino-cli lib install ESP32Servo
+````
+
 #### 4) Generate the Arduino Sketch
 The `dino` command is included with the gem. It will make the Arduino sketch folder for you, and configure it.
 
@@ -75,11 +100,11 @@ dino sketch serial
 dino sketch serial -target esp8266
 ````
 
-**For ESP8266 over WiFi (2.4Ghz and DHCP Only):**
+**For ESP32 over WiFi (2.4Ghz and DHCP Only):**
 ```shell
-dino sketch wifi -target esp8266 -ssid YOUR_SSID -password YOUR_PASSWORD
+dino sketch wifi -target esp32 -ssid YOUR_SSID -password YOUR_PASSWORD
 ````
-**Note:** [This example](examples/tcp.rb) shows how to instantiate a board over the network. You'll need to figure out what IP address your board got, and modify the TxRx line in other examples you wish to run. They are written for serial.
+**Note:** [This example](examples/tcp.rb) shows how to use a board over a TCP connection, but the WiFi sketches fall back to the serial interface if no TCP client is connected. You should be able to run the examples over serial while still connected.
 
 #### 5a) IDE Flashing
 
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 54a0378f..192ececf 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -11,7 +11,7 @@ class DinoCLI::Generator
     core: [:core],
 
     # Specific features for the old mega168 chips.
-    mega168: [:core, :servo, :shift,:tone, :spi, :i2c],
+    mega168: [:core, :servo, :shift, :tone, :spi, :i2c],
 
     # ARM includes everytyhing except specific incompatibilities.
     sam3x: STANDARD_PACKAGES - [:serial, :tone, :ir_out],
@@ -20,6 +20,6 @@ class DinoCLI::Generator
     esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp8266],
     
     # Just core implementation on the ESP32 for now.
-    esp32: [:core, :shift, :spi, :i2c]
+    esp32: [:core, :servo, :shift, :spi, :i2c]
   }
 end
diff --git a/src/lib/DinoServo.cpp b/src/lib/DinoServo.cpp
index 631d0225..6f8913a6 100644
--- a/src/lib/DinoServo.cpp
+++ b/src/lib/DinoServo.cpp
@@ -4,7 +4,11 @@
 #include "Dino.h"
 #ifdef DINO_SERVO
 
-#include <Servo.h>
+#ifdef ESP32
+  #include <ESP32Servo.h>
+#else if
+  #include <Servo.h>
+#endif
 
 // 12 servos on most boards. 6 on the ATmega168.
 // Could be up to 48 on Arduino Mega.

From 0ffe095474da99165683689b0122557e0adc4300 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 22 Feb 2023 10:55:22 -0400
Subject: [PATCH 270/296] OneWire (bit bang, not RMT) support on ESP32

---
 lib/dino_cli/targets.rb |  4 ++--
 src/lib/Dino.cpp        | 10 ++++++++++
 src/lib/Dino.h          |  3 +++
 src/lib/DinoOneWire.cpp | 24 ++++++++++++++----------
 4 files changed, 29 insertions(+), 12 deletions(-)

diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 192ececf..9a7bd70c 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -19,7 +19,7 @@ class DinoCLI::Generator
     # ESP8266 mostly working.
     esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp8266],
     
-    # Just core implementation on the ESP32 for now.
-    esp32: [:core, :servo, :shift, :spi, :i2c]
+    # ESP is missing LCD, IR, and Software Serial
+    esp32: [:core, :tone, :one_wire, :servo, :shift, :spi, :i2c]
   }
 end
diff --git a/src/lib/Dino.cpp b/src/lib/Dino.cpp
index 28814c52..6612cd02 100644
--- a/src/lib/Dino.cpp
+++ b/src/lib/Dino.cpp
@@ -289,3 +289,13 @@ void Dino::setAnalogResolution() {
     Serial.print("Called Dino::setAnalogResolution()\n");
   #endif
 }
+
+// Use a different blocking microsecond delay on different platforms.
+void Dino::microDelay(uint32_t microseconds){
+  #if defined(ESP32)
+    ets_delay_us(microseconds);
+  #else
+    delayMicroseconds(microseconds);
+  #endif
+}
+
diff --git a/src/lib/Dino.h b/src/lib/Dino.h
index 964233b3..aeb688d8 100644
--- a/src/lib/Dino.h
+++ b/src/lib/Dino.h
@@ -168,6 +168,9 @@ class Dino {
     unsigned long lastTime;
     unsigned long timeDiff;
     byte registerDivider;
+    
+    // Wrapper for different delay implementations by platform.
+    void microDelay(uint32_t microseconds);
 
     //
     // Main loop input functions.
diff --git a/src/lib/DinoOneWire.cpp b/src/lib/DinoOneWire.cpp
index d762b0c6..9ced43fa 100644
--- a/src/lib/DinoOneWire.cpp
+++ b/src/lib/DinoOneWire.cpp
@@ -14,11 +14,12 @@ void Dino::owReset(){
   byte present;
   pinMode(pin, OUTPUT);
   digitalWrite(pin, LOW);
-  delayMicroseconds(500);
+  microDelay(500);
   pinMode(pin, INPUT);
-  delayMicroseconds(80);
+  digitalWrite(pin, HIGH); // Essential on ESP32. Enables pullup on others.
+  microDelay(80);
   present = digitalRead(pin);
-  delayMicroseconds(420);
+  microDelay(420);
   if(val>0) coreResponse(pin, present);
 }
 
@@ -96,19 +97,21 @@ void Dino::owWriteBit(byte b){
   // Write slot always starts with pulling the bus low for at least 1us.
   pinMode(pin, OUTPUT);
   digitalWrite(pin, LOW);
-  delayMicroseconds(1);
+  microDelay(1);
 
   // If 1, release so the bus idles high, and wait out the 60us write slot.
   if(b == 1){
     pinMode(pin, INPUT);
-    delayMicroseconds(59);
+    digitalWrite(pin, HIGH); // Essential on ESP32. Enables pullup on others.
+    microDelay(59);
   // If 0, keep it low for the rest of the 60us write slot, then release.
   } else {
-    delayMicroseconds(59);
+    microDelay(59);
     pinMode(pin, INPUT);
+    digitalWrite(pin, HIGH); // Essential on ESP32. Enables pullup on others.
   }
   // Minimum 1us recovery time after each slot.
-  delayMicroseconds(1);
+  microDelay(1);
 }
 
 // CMD = 44
@@ -137,17 +140,18 @@ byte Dino::owReadBit(){
   // Pull low for at least 1us to start a read slot, then release.
   pinMode(pin, OUTPUT);
   digitalWrite(pin, LOW);
-  delayMicroseconds(1);
+  microDelay(1);
   pinMode(pin, INPUT);
+  digitalWrite(pin, HIGH); // Essential on ESP32. Enables pullup on others.
 
   // Wait for the slave to write to the bus. It should hold for up to 15us.
-  delayMicroseconds(5);
+  microDelay(5);
 
   // If slave pulled the bus high, the bit is a 1, else 0.
   b = digitalRead(pin);
 
   // Wait out the 60us read slot + recovery time.
-  delayMicroseconds(55);
+  microDelay(55);
   return b;
 }
 #endif

From 867567f4ca156499f0e0ac0ae5fbdc36345f6553 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 22 Feb 2023 11:30:55 -0400
Subject: [PATCH 271/296] Fix some hardware list errors.

---
 HARDWARE.md | 36 +++++++++++++++++++-----------------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/HARDWARE.md b/HARDWARE.md
index d547d449..f67f0a98 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -31,10 +31,12 @@
 | ESP8266        | :yellow_heart:  | 0.12.0 | NodeMCU | SoftwareSerial and LCD don't work yet
 | ESP32          | :test_tube:     | -      | DOIT ESP32 DevKit V1 | Original ESP-WROOM-32
 | ESP32-S2       | :test_tube:     | -      | LOLIN S2 Pico | Single core Xtensa, native USB
-| ESP32-S3       | :test_tube:     | -      | LOLIN S3 V1.0.0 | Dual core RISC-V, native USB
+| ESP32-S3       | :test_tube:     | -      | LOLIN S3 V1.0.0 | Dual core Xtensa, native USB
 
 **Note:** There are too many boards using these chips to be comprehensive. Most should work. These are the exact ones used for testing, chosen based on popularity.
 
+**Note:** For these boards, "pin" numbers are always based on GPIO numbers defined by the CHIP, not the pin numbers labeled on the BOARD. They might coincide, but not always. Keep a mapping reference handy for your particular board.
+
 # Supported Components
 
 :green_heart: Full support :yellow_heart: Partial support :heart: Planned. No support yet
@@ -59,10 +61,10 @@
 | I2C              | :green_heart:  | Hardware  | 0.12.0   | `I2C::Bus` | Only default clocks
 | SPI              | :green_heart:  | Hardware  | 0.12.0   | `Register::Select` | Hardware register I/O
 | Shift In/Out     | :green_heart:  | Software  | 0.12.0   | `Register::Select` | Bit bang register I/O
-| Software Serial  | :yellow_heart: | Software  | 0.12.0   | `SoftwareSerial` | No read, only write
+| Software Serial  | :yellow_heart: | Software  | 0.12.0   | `SoftwareSerial` | Library on Board. Write only
 | Hardware Serial  | :heart:        | Hardware  | -        | - | For boards with native USB and UARTs
-| Maxim OneWire    | :green_heart:  | Software  | 0.12.0   | `OneWire::Bus` | No overdrivee support
-| Infrared Emitter | :green_heart:  | Software  | 0.12.0   | `IREmitter` |
+| Maxim OneWire    | :green_heart:  | Software  | 0.12.0   | `OneWire::Bus` | No overdrive support
+| Infrared Emitter | :green_heart:  | Software  | 0.12.0   | `IREmitter` | Library on Board
 
 ### Generic Components
 
@@ -79,28 +81,28 @@
 | Analog Sensor    | :green_heart:  | Analog In   | 0.11.0   | `Sensor` |
 | Potentiometer    | :green_heart:  | Analog In   | 0.12.0   | `Potentiometer` | Smoothing on by default
 | Piezo Buzzer     | :green_heart:  | Tone Out    | 0.12.0   | `Piezo` | Frequency > 30Hz
-| Input Register   | :green_heart:  | ShiftIn     | 0.12.0   | `Register::ShiftIn` | Tested on CD4021B
+| Input Register   | :green_heart:  | Shift In    | 0.12.0   | `Register::ShiftIn` | Tested on CD4021B
 | Input Register   | :green_heart:  | SPI         | 0.12.0   | `Register::SPIIn` | Tested on CD4021B
-| Output Register  | :green_heart:  | ShiftOut    | 0.12.0   | `Register::ShiftOut` | Tested on 74HC595
+| Output Register  | :green_heart:  | Shift Out   | 0.12.0   | `Register::ShiftOut` | Tested on 74HC595
 | Output Register  | :green_heart:  | SPI         | 0.12.0   | `Register::SPIOut` | Tested on 74HC595
 
 **Note:** Most Digital In and Out components can be used seamlessley through Input and Output Registers respectively.
 
 ### Motors / Motor Drivers
 
-| Name                 | Status         | Interface | Version  | Component Class   | Notes |
-| :---------------     | :------:       | :-------- | :-----   | :---------------  |------ |
-| Servo                | :green_heart:  | Direct    | 0.11.2   | `Servo`  | Max 6 servos on the ATmega168, 12 otherwise
-| L298N                | :heart:        | Direct    |          | -        | 2ch DC motor driver
-| A3967                | :green_heart:  | Direct    | 0.12.0   | `Stepper`| 1ch microstepper. Tested with EasyDriver board
-| PCA9685              | :heart:        | I2C       | -        | -        | 16ch 12-bit PWM for servo, DC motor, or LED
+| Name                 | Status         | Interface           | Version  | Component Class   | Notes |
+| :---------------     | :------:       | :--------           | :-----   | :---------------  |------ |
+| Servo                | :green_heart:  | PWM + Library       | 0.11.2   | `Servo`  | Max 6 servos on ATmega168, 12 otherwise
+| L298N                | :heart:        | PWM Out             | -        | | 2ch DC motor driver
+| A3967                | :green_heart:  | Digital Out         | 0.12.0   | `Stepper`| 1ch microstepper (EasyDriver)
+| PCA9685              | :heart:        | I2C                 | -        | -        | 16ch 12-bit PWM for servo, DC motor, or LED
 
 ### Displays
 
-| Name                     | Status         | Interface        | Version  | Component Class   | Notes |
-| :---------------         | :------:       | :--------        | :-----   | :---------------  |------ |
-| HD44780 LCD              | :green_heart:  | Direct, C++ Lib  | 0.12.0   | `LCD` | Could make it work through registers
-| SSD1306 OLED             | :heart:        | I2C              | -        | -     |
+| Name                     | Status         | Interface               | Version  | Component Class   | Notes |
+| :---------------         | :------:       | :--------               | :-----   | :---------------  |------ |
+| HD44780 LCD              | :green_heart:  | Digital Out + Library | 0.12.0   | `LCD` | No register passthrough
+| SSD1306 OLED             | :heart:        | I2C                     | -        | -     |
 
 ### Addressable LEDs
 
@@ -122,7 +124,7 @@
 
 | Name             | Status         | Interface | Version  | Component Class   | Notes |
 | :--------------- | :------:       | :-------- | :-----   | :---------------  |------ |
-| DHT 11/21/22     | :green_heart:  | Direct    | 0.12.0   | `DHT` | Temperature, Humidity
+| DHT 11/21/22     | :green_heart:  | Digi In/Out| 0.12.0   | `DHT` | Temperature, Humidity
 | DS18B20          | :green_heart:  | OneWire   | 0.12.0   | `OneWire::DS18B20`| Temperature
 | MAX31850         | :grey_exclamation: | OneWire   | -        | - | Thermocouple
 | BME280           | :heart:        | I2C       | -        | - | Pressure, Temperature, Humidity

From 665a48a7e1a2539c384bc7eaf0df91993cbdf359 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 22 Feb 2023 16:30:29 -0400
Subject: [PATCH 272/296] IR out for ESP32. Newest IR library for all platforms

---
 .gitmodules                       |  6 ----
 README.md                         | 10 +++---
 examples/ir_emitter/ir_emitter.rb | 56 +++++++++++++++----------------
 lib/dino/api/infrared.rb          |  9 +++--
 lib/dino_cli/packages.rb          | 19 +++--------
 lib/dino_cli/targets.rb           |  6 ++--
 src/lib/DinoIROut.cpp             | 40 ++++++++++------------
 src/lib/DinoIROutESP.cpp          | 26 ++++++++++++++
 src/vendor/Arduino-IRremote       |  1 -
 src/vendor/IRremoteESP8266        |  1 -
 10 files changed, 92 insertions(+), 82 deletions(-)
 create mode 100644 src/lib/DinoIROutESP.cpp
 delete mode 160000 src/vendor/Arduino-IRremote
 delete mode 160000 src/vendor/IRremoteESP8266

diff --git a/.gitmodules b/.gitmodules
index d1468cc8..e69de29b 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,6 +0,0 @@
-[submodule "src/vendor/Arduino-IRremote"]
-	path = src/vendor/Arduino-IRremote
-	url = https://github.com/z3t0/Arduino-IRremote.git
-[submodule "src/vendor/IRremoteESP8266"]
-	path = src/vendor/IRremoteESP8266
-	url = https://github.com/markszabo/IRremoteESP8266.git
diff --git a/README.md b/README.md
index ed463923..064c991b 100644
--- a/README.md
+++ b/README.md
@@ -47,14 +47,14 @@ Dino uses Arduino "cores" which add microcontroller support, and a few libraries
   * `Servo by Michael Margolis, Arduino` at latest version
   * `Liquid Crystal by Arduino, Adafruit` at latest version
   * `WiFi by Arduino` at latest version
-  * `IRremote by shirriff, z3to, ArminJo` at `version 2.2.3`
+  * `IRremote by shirriff, z3to, ArminJo` at `version 4.0.0`
 
 **CLI method for Arduino & Clones:**
 ````shell
 arduino-cli lib install Servo
 arduino-cli lib install LiquidCrystal
 arduino-cli lib install WiFi
-arduino-cli lib install IRremote@2.2.3
+arduino-cli lib install IRremote@4.0.0
 ````
 
 **IDE method for ESP8266:**
@@ -62,14 +62,14 @@ arduino-cli lib install IRremote@2.2.3
 * Search for `ESP8266 Boards` and install the latest version.
 * Go to: Tools > Manage Libraries.
 * Find and install the following libraries, at the version numbers given:
-  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.3.2`
+  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.8.4`
 
 **CLI method for ESP8266:**
 ````shell
 arduino-cli config add board_manager.additional_urls https://arduino.esp8266.com/stable/package_esp8266com_index.json
 arduino-cli core update-index
 arduino-cli core install esp8266:esp8266
-arduino-cli lib install IRremoteESP8266@2.3.2
+arduino-cli lib install IRremoteESP8266@2.8.4
 ````
 
 **IDE method for ESP32:**
@@ -78,6 +78,7 @@ arduino-cli lib install IRremoteESP8266@2.3.2
 * Go to: Tools > Manage Libraries.
 * Find and install the following libraries, at the version numbers given:
   * `ESP32Servo by Kevin Harrington, John K. Bennett` at latest version
+  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.8.4`
 
 **CLI method for ESP32:**
 ````shell
@@ -85,6 +86,7 @@ arduino-cli config add board_manager.additional_urls https://raw.githubuserconte
 arduino-cli core update-index
 arduino-cli core install esp32
 arduino-cli lib install ESP32Servo
+arduino-cli lib install IRremoteESP8266@2.8.4
 ````
 
 #### 4) Generate the Arduino Sketch
diff --git a/examples/ir_emitter/ir_emitter.rb b/examples/ir_emitter/ir_emitter.rb
index ed51e779..92344e27 100644
--- a/examples/ir_emitter/ir_emitter.rb
+++ b/examples/ir_emitter/ir_emitter.rb
@@ -1,21 +1,18 @@
 #
 # This is a simple test of the IREmitter (infrared blaster) class.
-# It is based on part of "IRtest2" from the included Arduino library:
-#   https://github.com/z3t0/Arduino-IRremote/tree/master/examples
+# It is based on this example from the Arduino library:
+# https://github.com/Arduino-IRremote/Arduino-IRremote/tree/master/examples/SendDemo
 #
-# To verify your emitter is working, you could flash "IRrecvDump2" from that
-# examples directory to a second board. With an IR receiver on the correct pin
-# of the board (see https://github.com/z3t0/Arduino-IRremote#hardware-specifications),
-# open a serial monitor at 9600 and check that it receives the signal sent by this script.
+# To verify your emitter is working, you can flash this sketch on a second board:
+# https://github.com/Arduino-IRremote/Arduino-IRremote/tree/master/examples/ReceiveDemo
 #
-# If you don't have 2 boards, use "IRrecvDump2" to capture a code from a button
+# Attach an IR receiver to the receive pin (2 for Atmel AVR) and observe for serial output.
+#
+# If you don't have 2 boards, use the receive sketch to capture a code from a button
 # of a remote you have. Copy the raw code (long list of numbers in curly braces),
-# from the serial output, replace the curly braces with square brackets, and
-# those raw values are now compatible with Ruby and this script.
+# and modify it into a Ruby array. 
 #
-# Flash the dino sketch onto your board and connect the IR emitter.
-# Substitute a code you captured for the NEC example below.
-# The corresponding action should happen on your device, eg. "Power" on your TV.
+# Reflash the dino sketch onto your board and test the IR code operates your device.
 #
 # Both of these methods require you to have an IR receiver handy.
 # If you do not have one, there are IR codes in Raw format for many devices
@@ -30,26 +27,29 @@
 # explicit about which serial device this script must use. The relevant
 # TxRx call is below, but commented out. Enable it and substitute the approriate
 # device  for the board that has the IR emitter connected and dino sketch loaded.
+# Open the receiver board in the Arduino IDE's or another serial monitor.
+#
 txrx = Dino::TxRx::Serial.new
 # txrx = Dino::TxRx::Serial.new(device: "/dev/ttyACM0")
 board = Dino::Board.new(txrx)
 
-# Setting the IR emitter pin is currently unsupported.
-# Although the value gets passed to the board, it always uses the default pin
-# for your specfic board/chip, as defined by the library (in bold) at:
-# https://github.com/z3t0/Arduino-IRremote#hardware-specifications
-ir = Dino::Components::IREmitter.new(board: board, pin: 3)
+#
+# The IR emitter can be set up on most pins for most boards, but there might be conflicts
+# with other hardware or libraries. Try different pins if one doesn't work.
+#
+ir = Dino::Components::IREmitter.new(board: board, pin: 4)
 
-# This is the raw data corresponding to NEC 0x12345678
-code = [9000, 4500,
-        560, 560, 560, 560, 560, 560, 560, 1690,
-        560, 560, 560, 560, 560, 1690, 560, 560,
-        560, 560, 560, 560, 560, 1690, 560, 1690,
-        560, 560, 560, 1690, 560, 560, 560, 560,
-        560, 560, 560, 1690, 560, 560, 560, 1690,
-        560, 560, 560, 1690, 560, 1690, 560, 560,
-        560, 560, 560, 1690, 560, 1690, 560, 1690,
-        560, 1690, 560, 560, 560, 560, 560, 560,
-        560]
+# NEC Raw-Data=0xF708FB04. LSBFIRST, so the binary for each hex digit below is backward.
+code =  [ 9000, 4500,                                 # Start bit
+          560, 560, 560, 560, 560, 1690, 560, 560,    # 0010 0x4 command
+          560, 560, 560, 560, 560, 560, 560, 560,     # 0000 0x0 command
+          560, 1690, 560, 1690, 560,560, 560, 1690,   # 1101 0xB command inverted
+          560, 1690, 560, 1690, 560, 1690, 560, 1690, # 1111 0xF command inverted
+          560, 560, 560, 560, 560, 560, 560, 1690,    # 0001 0x8 address
+          560, 560, 560, 560, 560, 560, 560, 560,     # 0000 0x0 address
+          560, 1690, 560, 1690, 560, 1690, 560, 560,  # 1110 0x7 address inverted
+          560, 1690, 560, 1690, 560, 1690, 560, 1690, # 1111 0xF address inverted
+          560]                                        # Stop bit
 
 ir.emit(code)
+board.finish_write
diff --git a/lib/dino/api/infrared.rb b/lib/dino/api/infrared.rb
index 68fa112e..abb668f7 100644
--- a/lib/dino/api/infrared.rb
+++ b/lib/dino/api/infrared.rb
@@ -4,10 +4,13 @@ module Infrared
       include Helper
 
       def infrared_emit(pin, frequency, pulses)
-        # Need to start using length - 1, but doesn't work on board yet.
-        # 0 = 1 pulse, 255 = 256 pulses.
+        #
+        # Limit to 255 marks/spaces (not pairs) for now.
+        #
+        # Length must be 1-byte long, not literally 1
+        # Pulses max is 2x255 bytes long since each is 2 bytes.
         length = pack :uint8,  pulses.length,  max: 1
-        bytes  = pack :uint16, pulses, min: 1, max: 512
+        bytes  = pack :uint16, pulses, min: 1, max: 510
 
         write Message.encode command: 16,
                              pin: convert_pin(pin),
diff --git a/lib/dino_cli/packages.rb b/lib/dino_cli/packages.rb
index bb4238e6..613b8d46 100644
--- a/lib/dino_cli/packages.rb
+++ b/lib/dino_cli/packages.rb
@@ -61,26 +61,17 @@ class DinoCLI::Generator
   ir_out: {
     description: "Transmit infrared signals",
     directive: "DINO_IR_OUT",
-    exclude: [:esp8266],
+    exclude: [:esp8266, :esp32],
     files: [
       "lib/DinoIROut.cpp",
-      "vendor/Arduino-IRremote/boarddefs.h",
-      "vendor/Arduino-IRremote/IRremote.h",
-      "vendor/Arduino-IRremote/IRremoteInt.h",
-      "vendor/Arduino-IRremote/irSend.cpp",
     ]
   },
-  ir_out_esp8266: {
-    description: "Transmit infrared signals with the ESP8266",
+  ir_out_esp: {
+    description: "Transmit infrared signals with the ESP8266 and ESP32",
     directive: "DINO_IR_OUT",
-    only: [:esp8266],
+    only: [:esp8266, :esp32],
     files: [
-      "lib/DinoIROut.cpp",
-      "vendor/IRremoteESP8266/src/IRremoteESP8266.h",
-      "vendor/IRremoteESP8266/src/IRsend.h",
-      "vendor/IRremoteESP8266/src/IRsend.cpp",
-      "vendor/IRremoteESP8266/src/IRtimer.h",
-      "vendor/IRremoteESP8266/src/IRtimer.cpp",
+      "lib/DinoIROutESP.cpp",
     ]
   },
   one_wire: {
diff --git a/lib/dino_cli/targets.rb b/lib/dino_cli/targets.rb
index 9a7bd70c..e4416f99 100644
--- a/lib/dino_cli/targets.rb
+++ b/lib/dino_cli/targets.rb
@@ -17,9 +17,9 @@ class DinoCLI::Generator
     sam3x: STANDARD_PACKAGES - [:serial, :tone, :ir_out],
 
     # ESP8266 mostly working.
-    esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp8266],
+    esp8266: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp],
     
-    # ESP is missing LCD, IR, and Software Serial
-    esp32: [:core, :tone, :one_wire, :servo, :shift, :spi, :i2c]
+    # ESP32 mostly working.
+    esp32: STANDARD_PACKAGES - [:lcd, :serial, :ir_out] + [:ir_out_esp],
   }
 end
diff --git a/src/lib/DinoIROut.cpp b/src/lib/DinoIROut.cpp
index 4847de35..12889ee9 100644
--- a/src/lib/DinoIROut.cpp
+++ b/src/lib/DinoIROut.cpp
@@ -2,33 +2,29 @@
 // This file adds to the Dino class only if DINO_IR_OUT is defined in Dino.h.
 //
 #include "Dino.h"
-#ifdef DINO_IR_OUT
+#if defined(DINO_IR_OUT) && !defined(ESP8266) && !defined(ESP32)
 
-#ifdef ESP8266
-  #include "IRremoteESP8266.h"
-  #include "Irsend.h"
-#else
-  #include "IRremote.h"
-  IRsend infraredOut;
-#endif
+#include <IRremote.hpp>
+
+// Save memory?
+#define RAW_BUFFER_LENGTH 2
+#define DISABLE_CODE_FOR_RECEIVER
+#define IR_REMOTE_DISABLE_RECEIVE_COMPLETE_CALLBACK
+#define EXCLUDE_UNIVERSAL_PROTOCOLS
+#define EXCLUDE_EXOTIC_PROTOCOLS
+#define NO_LED_FEEDBACK_CODE
 
 // CMD = 16
 // Send an infrared signal.
 void Dino::irSend(){
-  #ifdef ESP8266
-    IRsend infraredOut(pin);
-  #endif
-
-  infraredOut.enableIROut(val);
+  // Byte 1+ of auxMsg is already little-endian uint16 pulses.
+  uint16_t *pulseArray = reinterpret_cast<uint16_t *>(auxMsg + 1);
+  
+  // Dynamically set the sending pin. Needs to be PWM capable.
+  IrSender.setSendPin(pin);
 
-  for (int i=0; i<(uint8_t)auxMsg[0]; i++){
-    uint16_t pulse = ((uint16_t)auxMsg[(i*2)+2] << 8) | auxMsg[(i*2)+1];
-    if ((i % 2) == 0) {
-      infraredOut.mark(pulse);
-    } else {
-      infraredOut.space(pulse);
-    }
-  }
-  infraredOut.space(0);
+  // auxMsg[0] contains number of uint16_t
+  // Val contains frequency
+  IrSender.sendRaw(pulseArray, auxMsg[0], val);
 }
 #endif
diff --git a/src/lib/DinoIROutESP.cpp b/src/lib/DinoIROutESP.cpp
new file mode 100644
index 00000000..f3c74dc7
--- /dev/null
+++ b/src/lib/DinoIROutESP.cpp
@@ -0,0 +1,26 @@
+//
+// Dino IR output for the ESP8266 and ESP32.
+// Depends on: https://github.com/crankyoldgit/IRremoteESP8266
+// DINO_IR_OUT must be defeind in DinoDefines.h
+//
+#include "Dino.h"
+#if defined(DINO_IR_OUT) && (defined(ESP8266) || defined(ESP32))
+
+#include <IRremoteESP8266.h>
+#include <Irsend.h>
+
+// CMD = 16
+// Send an infrared signal.
+void Dino::irSend(){
+  // Byte 1+ of auxMsg is already little-endian uint16 pulses.
+  uint16_t *pulseArray = reinterpret_cast<uint16_t *>(auxMsg + 1);
+  
+  // Can work on any pin.
+  IRsend infraredOut(pin);
+  infraredOut.begin();
+  
+  // auxMsg[0] is how many pulses were packed.
+  // val is frequency
+  infraredOut.sendRaw(pulseArray, auxMsg[0], val);
+}
+#endif
diff --git a/src/vendor/Arduino-IRremote b/src/vendor/Arduino-IRremote
deleted file mode 160000
index 96186317..00000000
--- a/src/vendor/Arduino-IRremote
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit 96186317b251c04da595159402f80538c0be5eed
diff --git a/src/vendor/IRremoteESP8266 b/src/vendor/IRremoteESP8266
deleted file mode 160000
index fce4ccf0..00000000
--- a/src/vendor/IRremoteESP8266
+++ /dev/null
@@ -1 +0,0 @@
-Subproject commit fce4ccf0bd58eb7e0d905ee279eeccdca6ba1e69

From 5ad86190fde12e386f5c64d307193cfa6c5b6c89 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 22 Feb 2023 18:09:37 -0400
Subject: [PATCH 273/296] Update I2C and SPI tests with new defaults

---
 src/lib/DinoSPI.cpp  |  6 +++---
 test/api/i2c_test.rb | 10 +++++-----
 test/api/spi_test.rb |  2 +-
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 45db44ab..56857d16 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -37,9 +37,9 @@ void Dino::spiBegin(byte settings, uint32_t clockRate){
 // Convenience wrapper for SPI.end
 void Dino::spiEnd(){
   SPI.endTransaction();
-  // If the sketch is using SPI for TxRx (Wi-Fi/Ethernet) we don't want to end.
-  // CLI generator will define TXRX_SPI in Dino.h for those cases.
-  #ifndef TXRX_SPI
+  // CLI generator will define TXRX_SPI in Dino.h for all WiFi sketches.
+  // Only matters if using the SPI-based WiFi Arduino shield. We don't want to end.
+  #if !defined(TXRX_SPI) || defined(ESP8266) || defined(ESP32)
     SPI.end();
   #endif
 }
diff --git a/test/api/i2c_test.rb b/test/api/i2c_test.rb
index 1aa84eb4..0fb7ec9e 100644
--- a/test/api/i2c_test.rb
+++ b/test/api/i2c_test.rb
@@ -26,9 +26,9 @@ def test_write
     board
     aux = pack :uint8, [0x30, 0, 4, [1,2,3,4]]
     # Normal
-    message1 = Dino::Message.encode command: 34, value: 0b00, aux_message: aux
+    message1 = Dino::Message.encode command: 34, value: 0b01, aux_message: aux
     # Repeated start
-    message2 = Dino::Message.encode command: 34, value: 0b01, aux_message: aux
+    message2 = Dino::Message.encode command: 34, value: 0b00, aux_message: aux
 
     mock = MiniTest::Mock.new
     mock.expect :call, nil, [message1]
@@ -45,9 +45,9 @@ def test_read
     board
     aux = pack :uint8, [0x30, 0, 0x03, 4]
     # Normal
-    message1 = Dino::Message.encode command: 35, value: 0b10, aux_message: aux
+    message1 = Dino::Message.encode command: 35, value: 0b11, aux_message: aux
     # Repeated start
-    message2 = Dino::Message.encode command: 35, value: 0b11, aux_message: aux
+    message2 = Dino::Message.encode command: 35, value: 0b10, aux_message: aux
 
     mock = MiniTest::Mock.new
     mock.expect :call, nil, [message1]
@@ -63,7 +63,7 @@ def test_read
   def test_read_without_register
     board
     aux = pack :uint8, [0x30, 0, 0, 4]
-    message = Dino::Message.encode command: 35, value: 0b00, aux_message: aux
+    message = Dino::Message.encode command: 35, value: 0b01, aux_message: aux
 
     mock = MiniTest::Mock.new
     mock.expect :call, nil, [message]
diff --git a/test/api/spi_test.rb b/test/api/spi_test.rb
index 136d33db..c888f59d 100644
--- a/test/api/spi_test.rb
+++ b/test/api/spi_test.rb
@@ -27,7 +27,7 @@ def test_spi_lsbfirst
   end
 
   def test_spi_frequency
-    assert_equal (board.spi_header(frequency: nil    )[0][3..6]), (pack :uint32, 3000000)
+    assert_equal (board.spi_header(frequency: nil    )[0][3..6]), (pack :uint32, 1000000)
     assert_equal (board.spi_header(frequency: 8000000)[0][3..6]), (pack :uint32, 8000000)
   end
   

From 8b965c7239c231d052d374f395748df097d6e6f8 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 22 Feb 2023 18:14:41 -0400
Subject: [PATCH 274/296] Update stepper tests

---
 lib/dino/components/stepper.rb  | 5 ++++-
 test/components/stepper_test.rb | 8 ++++++--
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/lib/dino/components/stepper.rb b/lib/dino/components/stepper.rb
index b6b12af4..d859c9c7 100644
--- a/lib/dino/components/stepper.rb
+++ b/lib/dino/components/stepper.rb
@@ -16,7 +16,10 @@ class Stepper
                   
       def after_initialize(options={})
         wake; on;
-        self.microsteps = 8
+        
+        if (ms1 && ms2)
+          self.microsteps = 8
+        end
       end
 
       def sleep
diff --git a/test/components/stepper_test.rb b/test/components/stepper_test.rb
index c12e6c9b..3696695a 100644
--- a/test/components/stepper_test.rb
+++ b/test/components/stepper_test.rb
@@ -16,7 +16,9 @@ def test_initialize
   end
 
   def test_step_cw
-    dir_mock = MiniTest::Mock.new.expect :low, nil
+    dir_mock = MiniTest::Mock.new
+    dir_mock.expect :low?, false
+    dir_mock.expect :low, nil
     step_mock = MiniTest::Mock.new
     step_mock.expect :high, nil
     step_mock.expect :low, nil
@@ -31,7 +33,9 @@ def test_step_cw
   end
 
   def test_step_cc
-    dir_mock = MiniTest::Mock.new.expect :high, nil
+    dir_mock = MiniTest::Mock.new
+    dir_mock.expect :high?, false
+    dir_mock.expect :high, nil
     step_mock = MiniTest::Mock.new
     step_mock.expect :high, nil
     step_mock.expect :low, nil

From 4113d67cf589c5191f2c576e7758caddc8455456 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 22 Feb 2023 18:19:59 -0400
Subject: [PATCH 275/296] Use #digital_write in LED example so it doesn't PWM
 if on a capable pin

---
 examples/01-led/led.rb | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/examples/01-led/led.rb b/examples/01-led/led.rb
index d78b0a77..18bf732a 100644
--- a/examples/01-led/led.rb
+++ b/examples/01-led/led.rb
@@ -30,9 +30,9 @@
 # We can use led.write to set it directly, or named convenience methods.
 # These 3 lines all do the same thing: turn on, wait half a second, turn off.
 #
-led.write(1); sleep 0.5; led.write(0)
-led.high;     sleep 0.5; led.low
-led.on;       sleep 0.5; led.off
+led.digital_write(1); sleep 0.5; led.digital_write(0)
+led.high;             sleep 0.5; led.low
+led.on;               sleep 0.5; led.off
 
 #
 # led.toggle will set it to the opposite state each time it's called.

From c94b093cca98da65450dd6ce3e6a2d0db1a7d330 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Wed, 22 Feb 2023 20:02:52 -0400
Subject: [PATCH 276/296] Add Led/Potentiometer PWM example

---
 examples/04-pwm_led/pwm_led.rb | 67 ++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/examples/04-pwm_led/pwm_led.rb b/examples/04-pwm_led/pwm_led.rb
index e69de29b..70792863 100644
--- a/examples/04-pwm_led/pwm_led.rb
+++ b/examples/04-pwm_led/pwm_led.rb
@@ -0,0 +1,67 @@
+#
+# Example 4: LED Brightness and PWM
+#
+require 'bundler/setup'
+require 'dino'
+
+# Set up the board, connecting with serial over USB
+board = Dino::Board.new(Dino::TxRx::Serial.new)
+
+#
+# LEDs don't change brightness much with voltage, but we can vary it with a
+# technique called PWM. PWM sets up a fast (500Hz+) wave on the LED pin. Then we
+# set a duty cycle, telling the LED what fraction of those cycles to be on for.
+#
+# Eg. 1 cycle on, 4 cycles off = 20% duty cycle.
+# This happens so fast that it looks like 20% brightness to the naked eye. 
+# 
+# Depending on your board, some pins may not be PWM capable. Pin 13 on Arduinos
+# isn't, so the earlier example was limited to on/off. There might be a wave
+# symbol printed next to the pin number, but check your documentation. 
+#
+# Note: If you have pins labeled "DAC", do not use them here. DACs generate steady
+# analog voltages, not waves, but we access both DACs and PWM with #analog_write.
+#
+# Set up LED on a PWM pin. See pwm_led.png in this folder for hook-up diagram.
+#
+led = Dino::Components::Led.new(board: board, pin: 11)
+
+# led.analog_write sets duty cycle from 0 to 255, where 255 maps to 100%.
+[0, 63, 127, 191, 255].each do |duty|
+  led.analog_write duty
+  percentage = (((duty+1)/256.to_f) * 100).floor
+  print "LED at #{percentage}% duty cycle. Press Enter..."; gets
+end
+puts
+
+# Now let's add the potentiometer from the previous examp to control it.
+potentiometer = Dino::Components::Potentiometer.new(pin: 'A0', board: board)
+
+# Helper method to calculate brightness.
+def map_pot_value(value)
+  # Map 10 bit value into 0 to 1 range.
+  fraction = value / 1023.to_f
+
+  # Linearization hack for audio taper potentiometers.
+  # Adjust k for different tapers. This was an A500K.
+  k = 5
+  linearized = (fraction * (k + 1)) / ((k * fraction) + 1)
+  # Use this for linear potentiometers instead.
+  # linearized = fraction 
+  
+  # Map to the linearized 0-1 range to a 0-255 range for 8-bit PWM.
+  (linearized * 255).floor
+end
+
+# Callback to change brightness.
+potentiometer.on_change do |value|
+  duty = map_pot_value(value)
+  
+  # led.write uses digital_write OR analog_write, based on argument given.
+  led.write(duty)
+  percentage = (((duty+1)/256.to_f) * 100).floor
+  print "LED brightness: #{percentage}%  \r"
+end
+
+puts "Turn potentiometer to control the LED brightness. Press Ctrl+C to exit..."
+sleep

From bb0910dfe27f9a7169ba5b6c38475a762c722072 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 23 Feb 2023 01:04:05 -0400
Subject: [PATCH 277/296] Fix register Shift In for ESP32

---
 examples/register/shift_in.rb |  4 ----
 src/lib/DinoShift.cpp         | 39 ++++++++++++++++++++++-------------
 2 files changed, 25 insertions(+), 18 deletions(-)

diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index 9d0520f8..ca68aa07 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -9,10 +9,6 @@
 # The Button object is created by using the register in place of board, and
 # the register output pin that it's connected to.
 #
-# Note: rising_clock must be set to true if using TI CD4021B register or similar.
-# This should apply to any register which outputs on a rising clock edge.
-# Change as needed.
-#
 require 'bundler/setup'
 require 'dino'
 
diff --git a/src/lib/DinoShift.cpp b/src/lib/DinoShift.cpp
index bbe630e7..4f77da27 100644
--- a/src/lib/DinoShift.cpp
+++ b/src/lib/DinoShift.cpp
@@ -11,7 +11,7 @@ struct shiftListener{
   byte     len;
   byte     dataPin;
   byte     clockPin;
-  byte     clockHighFirst;
+  byte     settings;
   boolean  enabled;
 };
 shiftListener shiftListeners[SHIFT_LISTENER_COUNT];
@@ -24,8 +24,9 @@ shiftListener shiftListeners[SHIFT_LISTENER_COUNT];
 // auxMsg[0]  = data pin (byte)
 // auxMsg[1]  = clock pin (byte)
 // auxMsg[2]  = settings
-//     bit 0  = transmission bit order (1 = MSBFIRST, 0 = LSBFIRST)
-//     bit 1  = send clock high before reading (byte) (0/1) (only matters for reading)
+//     bit 0  = transmission bit order, 1 = MSBFIRST, 0 = LSBFIRST (default)
+//     bit 1  = clock state before reading (only), 1 = HIGH, 0 = LOW (default)
+//     but 2+ = unused
 // auxMsg[3]+ = data (bytes) (write func only)
 //
 // CMD = 21
@@ -51,10 +52,19 @@ void Dino::shiftWrite(int latchPin, int len, byte dataPin, byte clockPin, byte s
 // CMD = 22
 // Read from a shift register.
 void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte settings) {
-  // Send clock pin high if using a register that clocks on rising edges.
-  // If not, the MSB will not be read on those registers (always 1),
-  // and all other bits will be shifted by 1 towards the LSB.
-  if (bitRead(settings, 1)) digitalWrite(clockPin, HIGH);
+  // This matters on the ESP32 for some reason.
+  pinMode(dataPin, INPUT);
+  pinMode(clockPin, OUTPUT);
+  pinMode(latchPin, OUTPUT);
+  
+  // Some registers want the clock pin high at the start. If not, first bit won't be read,
+  // and other bits will shift by 1 toward the new "first" bit.
+  // Default is to start with clock low.
+  if (bitRead(settings, 1)) {
+    digitalWrite(clockPin, HIGH);
+  } else {
+    digitalWrite(clockPin, LOW);
+  }
 
   // Latch high to read parallel state, then low again to stop.
   digitalWrite(latchPin, HIGH);
@@ -66,14 +76,15 @@ void Dino::shiftRead(int latchPin, int len, byte dataPin, byte clockPin, byte se
   stream->print(':');
   byte reading = 0;
 
+  // Read a number of bytes from the register.
   for (int i = 1;  i <= len;  i++) {
-	
-	// Read a single byte from the register.
-	if (bitRead(settings, 0)) {
-	  reading = shiftIn(dataPin, clockPin, MSBFIRST);
-	} else {
+    	
+  	// Read a single byte from the register.
+  	if (bitRead(settings, 0)) {
+  	  reading = shiftIn(dataPin, clockPin, MSBFIRST);
+  	} else {
       reading = shiftIn(dataPin, clockPin, LSBFIRST);
-	}
+  	}
 	
     // Print it, then a comma or \n if it's the last byte.
     stream->print(reading);
@@ -126,7 +137,7 @@ void Dino::updateShiftListeners() {
                 shiftListeners[i].len,
                 shiftListeners[i].dataPin,
                 shiftListeners[i].clockPin,
-                shiftListeners[i].clockHighFirst);
+                shiftListeners[i].settings);
     }
   }
 }

From e55cdbab4d9cd7f58ec31944ec6ebddf2cf1473e Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Thu, 23 Feb 2023 02:38:35 -0400
Subject: [PATCH 278/296] SPI works on ESP32, but needs different mode than AVR
 ?

---
 examples/register/spi_in.rb |  8 ++++----
 lib/dino/api/spi.rb         | 20 +++++--------------
 src/lib/DinoSPI.cpp         | 38 ++++++++++++++++++++++++-------------
 test/api/spi_test.rb        |  6 +++---
 4 files changed, 37 insertions(+), 35 deletions(-)

diff --git a/examples/register/spi_in.rb b/examples/register/spi_in.rb
index bdf177d4..b0ade717 100644
--- a/examples/register/spi_in.rb
+++ b/examples/register/spi_in.rb
@@ -22,13 +22,13 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 
-# SPI mode and frequency are specific to a TI CD4021B register. Change as needed.
+# Tested with CD4021B register, which is LSBFIRST, but needs SPI mode 0 on some boards and 2 on others.
 shift_register = Dino::Components::Register::SPIIn.new  board: board,
                                                         pin: 8,
-                                                        spi_mode: 0,
-                                                        frequency: 3000000
+                                                        spi_mode: 2,
+                                                        bit_order: :lsbfirst
+                                                        # frequency: 1000000
                                                         # bytes: 1
-                                                        # bit_order: :lsbfirst
 
 button = Dino::Components::Button.new(pin: 0, board: shift_register)
 
diff --git a/lib/dino/api/spi.rb b/lib/dino/api/spi.rb
index 8885fd67..27cd6e83 100644
--- a/lib/dino/api/spi.rb
+++ b/lib/dino/api/spi.rb
@@ -10,21 +10,11 @@ def spi_header(options)
         options[:frequency]  ||= 1000000
         options[:bit_order]  ||= :msbfrst
                   
-        # Bit 0..3 of settings control the SPI mode
-        #
-        # 0000 = SPI_MODE0
-        # 0100 = SPI_MODE1
-        # 1000 = SPI_MODE2
-        # 1100 = SPI_MODE3
-        #
-        settings =  case options[:mode]
-                    when 0; 0b0000
-                    when 1; 0b0100
-                    when 2; 0b1000
-                    when 3; 0b1100
-                    else
-                      raise ArgumentError, "invalid SPI mode. Must be 0, 1, 2, or 3"
-                    end
+        # Lowest 2 bits of settings control the SPI mode
+        settings =  options[:mode] 
+        unless (0..3).include? settings
+          raise ArgumentError, "invalid SPI mode. Must be 0, 1, 2, or 3"
+        end
         
         # Bit 7 of settings toggles MSBFIRST (1) or LSBFIRST (0) transmission order.
         settings = settings | 0b10000000 unless options[:bit_order] == :lsbfirst
diff --git a/src/lib/DinoSPI.cpp b/src/lib/DinoSPI.cpp
index 45db44ab..cfbccbb0 100644
--- a/src/lib/DinoSPI.cpp
+++ b/src/lib/DinoSPI.cpp
@@ -21,25 +21,36 @@ SpiListener spiListeners[SPI_LISTENER_COUNT];
 void Dino::spiBegin(byte settings, uint32_t clockRate){
   SPI.begin();
 
-  // SPI mode is the lowest 4 bits of settings.
-  byte mode = settings & 0B00001111;
-
-  // Bit 7 of settings toggles MSBFIRST.
-  // Don't try to refactor t his and just pass bit 7.
-  // On the Due, MSBFIRST and LSBFIRST are ByteOrder class objects.
-  if (bitRead(settings, 7)) {
-  	SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, mode));
+  // SPI mode is the lowest 2 bits of settings.
+  byte mode = settings & 0B00000011;
+  // Bit 7 of settings controls bit order. 0 = LSBFIRST, 1 = MSBFIRST.
+  byte bitOrder = bitRead(settings, 7);
+  
+  // Do this nonsense so I don't have to care about varying macro definitions.
+  if (bitOrder == 0) {
+    switch(mode){
+      case 0: SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE0)); break;
+      case 1: SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE1)); break;
+      case 2: SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE2)); break;
+      case 3: SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, SPI_MODE3)); break;
+    }
   } else {
-  	SPI.beginTransaction(SPISettings(clockRate, LSBFIRST, mode));
+    switch(mode){
+      case 0: SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, SPI_MODE0)); break;
+      case 1: SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, SPI_MODE1)); break;
+      case 2: SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, SPI_MODE2)); break;
+      case 3: SPI.beginTransaction(SPISettings(clockRate, MSBFIRST, SPI_MODE3)); break;
+    }
   }
 }
 
 // Convenience wrapper for SPI.end
 void Dino::spiEnd(){
   SPI.endTransaction();
-  // If the sketch is using SPI for TxRx (Wi-Fi/Ethernet) we don't want to end.
-  // CLI generator will define TXRX_SPI in Dino.h for those cases.
-  #ifndef TXRX_SPI
+  // CLI generator will define TXRX_SPI in Dino.h for all WiFi sketches.
+  // Only matters if using the SPI-based WiFi Arduino shield. We don't want to end.
+  // ESP32 doesn't like when SPI.end is called either. Might be safe to never do it.
+  #if !defined(TXRX_SPI) && defined(__AVR__)
     SPI.end();
   #endif
 }
@@ -51,7 +62,8 @@ void Dino::spiEnd(){
 // pin         = slave select pin (int)
 // val         = empty
 // auxMsg[0]   = SPI settings
-//   Bit 0..3  = SPI mode
+//   Bit 0..1  = SPI mode
+//   Bit 2..6  = unused
 //   Bit 7     = MSBFIRST(1) or LSBFIRST(0)
 // auxMsg[1]   = read length  (number of bytes)
 // auxMsg[2]   = write length (number of bytes)
diff --git a/test/api/spi_test.rb b/test/api/spi_test.rb
index 136d33db..d62412a0 100644
--- a/test/api/spi_test.rb
+++ b/test/api/spi_test.rb
@@ -16,9 +16,9 @@ def board
   
   def test_spi_modes
     assert_equal (board.spi_header(mode: nil)[0][0]), (pack :uint8, 0b10000000)
-    assert_equal (board.spi_header(mode: 1  )[0][0]), (pack :uint8, 0b10000100)
-    assert_equal (board.spi_header(mode: 2  )[0][0]), (pack :uint8, 0b10001000)
-    assert_equal (board.spi_header(mode: 3  )[0][0]), (pack :uint8, 0b10001100)
+    assert_equal (board.spi_header(mode: 1  )[0][0]), (pack :uint8, 0b10000001)
+    assert_equal (board.spi_header(mode: 2  )[0][0]), (pack :uint8, 0b10000010)
+    assert_equal (board.spi_header(mode: 3  )[0][0]), (pack :uint8, 0b10000011)
     assert_raises(ArgumentError) { board.spi_header(mode: 4) }
   end
   

From b2a2a2601a10abbc6eccbdfdd5a2429d21804ee3 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 11:52:25 -0400
Subject: [PATCH 279/296] Change pinMode interface so ESP32 can pull pins up or
 down

---
 lib/dino/api/core.rb                      | 21 +++++++++++-------
 lib/dino/components/mixins/board_proxy.rb |  4 +---
 lib/dino/components/setup/input.rb        | 17 +++++++-------
 lib/dino/components/setup/multi_pin.rb    |  8 ++++---
 lib/dino/components/setup/single_pin.rb   | 26 ++++++++++++++++------
 src/lib/DinoCoreIO.cpp                    | 27 +++++++++++++++--------
 test/api/core_test.rb                     | 24 +++++++-------------
 test/components/setup/input_test.rb       | 27 +++++++----------------
 test/components/setup/output_test.rb      |  2 +-
 test/components/setup/single_pin_test.rb  | 10 +++++++--
 10 files changed, 89 insertions(+), 77 deletions(-)

diff --git a/lib/dino/api/core.rb b/lib/dino/api/core.rb
index f79b359b..a1219e25 100644
--- a/lib/dino/api/core.rb
+++ b/lib/dino/api/core.rb
@@ -6,11 +6,21 @@ module Core
       DIVIDERS = [1, 2, 4, 8, 16, 32, 64, 128]
 
       # CMD = 0
-      def set_pin_mode(pin, mode)
-        pin, value = convert_pin(pin), mode == :out ? 0 : 1
+      def set_pin_mode(pin, direction, pull=nil)
+        pin = convert_pin(pin)
+        
+        # bit 0: 1 = input, 0 = output
+        # bit 1: 1 = pulldown
+        # but 2: 1 = pullup
+        #
+        settings = 0b001
+        settings = 0b000 if direction == :output
+        settings |= 0b010 if pull == :pulldown
+        settings |= 0b100 if pull == :pullup
+        
         write Message.encode command: 0,
                              pin: convert_pin(pin),
-                             value: value
+                             value: settings
       end
 
       # CMD = 1
@@ -33,11 +43,6 @@ def analog_read(pin)
         write Message.encode command: 4, pin: convert_pin(pin)
       end
 
-      def set_pullup(pin, pullup)
-        pin = convert_pin(pin)
-        pullup ? digital_write(pin, @high) : digital_write(pin, @low)
-      end
-
       # CMD = 5
       def set_listener(pin, state=:off, options={})
         mode    = options[:mode]    || :digital
diff --git a/lib/dino/components/mixins/board_proxy.rb b/lib/dino/components/mixins/board_proxy.rb
index cf9395ec..6e242fdd 100644
--- a/lib/dino/components/mixins/board_proxy.rb
+++ b/lib/dino/components/mixins/board_proxy.rb
@@ -16,9 +16,7 @@ def convert_pin(pin)
           pin.to_i
         end
 
-        def set_pin_mode(pin, mode); end
-
-        def set_pullup(pin, pullup); end
+        def set_pin_mode(pin, mode, pull=nil); end
 
         def start_read; end
       end
diff --git a/lib/dino/components/setup/input.rb b/lib/dino/components/setup/input.rb
index 52df4f8d..8bb22154 100644
--- a/lib/dino/components/setup/input.rb
+++ b/lib/dino/components/setup/input.rb
@@ -3,13 +3,7 @@ module Components
     module Setup
       module Input
         include SinglePin
-        attr_reader :pullup
-
-        def pullup=(pullup)
-          @pullup = pullup
-          board.set_pullup(self.pin, pullup)
-        end
-
+        
         def _stop_listener
           board.stop_listener(pin)
         end
@@ -18,8 +12,13 @@ def _stop_listener
       
         def initialize_pins(options={})
           super(options)
-          self.mode = :in
-          self.pullup = options[:pullup]
+          if options[:pullup]
+            self.mode = :input_pullup
+          elsif options[:pulldown]
+            self.mode = :input_pulldown
+          else
+            self.mode = :input
+          end
         end
       end
     end
diff --git a/lib/dino/components/setup/multi_pin.rb b/lib/dino/components/setup/multi_pin.rb
index 301c65b5..1111989d 100644
--- a/lib/dino/components/setup/multi_pin.rb
+++ b/lib/dino/components/setup/multi_pin.rb
@@ -9,7 +9,7 @@ module MultiPin
         # class and stores it in @proxies.
         #
         include Base
-        attr_reader :pin, :pins, :pullups, :proxies
+        attr_reader :pin, :pins, :pulldowns, :pullups, :proxies
 
         # Return a hash with the state of each proxy component.
         def proxy_states
@@ -22,7 +22,7 @@ def proxy_states
 
       protected
 
-        attr_writer :pins, :pullups, :proxies
+        attr_writer :pins, :pulldowns, :pullups, :proxies
 
         def self.included(base)
           base.extend ClassMethods
@@ -69,6 +69,7 @@ def proxy_pins(options={})
 
         def initialize_pins(options={})
           self.pins = options[:pins]
+          self.pulldowns = options[:pulldowns] || {}
           self.pullups = options[:pullups] || {}
           self.proxies = {}
           validate_pins
@@ -88,7 +89,8 @@ def build_proxies
           # Build proxies for named pins once a pin number was given.
           pins.each_pair do |pin_name, pin_number|
             if proxy_classes[pin_name]
-              component = proxy_classes[pin_name].new(board: board, pin: pin_number, pullup: pullups[pin_name])
+              params = { board: board, pin: pin_number, pullup: pullups[pin_name], pulldown: pulldowns[pin_name] }
+              component = proxy_classes[pin_name].new(params)
               self.proxies[pin_name] = component
               instance_variable_set("@#{pin_name}", component)
               singleton_class.class_eval { attr_reader pin_name }
diff --git a/lib/dino/components/setup/single_pin.rb b/lib/dino/components/setup/single_pin.rb
index 3dac83c5..03111482 100644
--- a/lib/dino/components/setup/single_pin.rb
+++ b/lib/dino/components/setup/single_pin.rb
@@ -3,9 +3,26 @@ module Components
     module Setup
       module SinglePin
         include Base
-        attr_reader :pin, :mode
+        attr_reader :pin, :directon, :pull, :mode
+        
+        def mode=(mode)
+          @direction = :input
+          @direction = :output if [:out, :output].include? mode
 
-        protected
+          @pull = nil
+          if @direction == :input
+            @pull = :pullup if mode == :input_pullup
+            @pull = :pulldown if mode == :input_pulldown
+          end
+          
+          @mode = "#{@direction}"
+          @mode << "_#{@pull}" if @pull
+          @mode = @mode.to_sym
+          
+          board.set_pin_mode(pin, @direction, @pull)
+        end
+        
+      protected
 
         attr_writer :pin
 
@@ -16,11 +33,6 @@ def initialize_pins(options={})
             raise ArgumentError, 'a pin is required for this component'
           end
         end
-
-        def mode=(mode)
-          board.set_pin_mode(pin, mode)
-          @mode = mode
-        end
       end
     end
   end
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index 51ca3522..e6fb4379 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -10,17 +10,26 @@ void Dino::setMode(byte p, byte m) {
     Serial.println(m);
   #endif
 
-  if (m == 0) {
+  // bit 0: 1=input, 0=output
+  // bit 1: 1=pulldown
+  // bit 2: 1=pullup
+    
+  if (bitRead(m, 0) == 0) {
     pinMode(p, OUTPUT);
+  } else {
+    pinMode(p, INPUT);
   }
-  else {
-    #ifdef ESP32
-      detachLEDC(p);
-      pinMode(p, INPUT_PULLUP);
-    #else
-      pinMode(p, INPUT);
-    #endif
-  }
+  
+  // Set pullup or pulldown for ESP32
+  #ifdef ESP32
+    detachLEDC(p);
+    if(bitRead(m, 1)) pinMode(p, INPUT_PULLDOWN);
+    if(bitRead(m, 2)) pinMode(p, INPUT_PULLUP);
+    
+  // Write high on other platforms if pullup.
+  #else
+    if (bitRead(m, 2)) digitalWrite(p, HIGH);
+  #endif
 }
 
 // CMD = 01
diff --git a/test/api/core_test.rb b/test/api/core_test.rb
index 5cdd33d4..25b20093 100644
--- a/test/api/core_test.rb
+++ b/test/api/core_test.rb
@@ -13,24 +13,16 @@ def board
 
   def test_set_pin_mode
     mock = MiniTest::Mock.new
-    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: board.low)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: board.high)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: 0)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: 1)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: 0b011)])
+    mock.expect(:call, nil, [Dino::Message.encode(command: 0, pin: 1, value: 0b101)])
 
     board.stub(:write, mock) do
-      board.set_pin_mode 1, :out
-      board.set_pin_mode 1, :in
-    end
-    mock.verify
-  end
-
-  def test_set_pullup
-    mock = MiniTest::Mock.new
-    mock.expect(:call, nil, [Dino::Message.encode(command: 1, pin: 1, value: board.low)])
-    mock.expect(:call, nil, [Dino::Message.encode(command: 1, pin: 1, value: board.high)])
-
-    board.stub(:write, mock) do
-      board.set_pullup 1, false
-      board.set_pullup 1, true
+      board.set_pin_mode 1, :output
+      board.set_pin_mode 1, :input
+      board.set_pin_mode 1, :input, :pulldown
+      board.set_pin_mode 1, :input, :pullup
     end
     mock.verify
   end
diff --git a/test/components/setup/input_test.rb b/test/components/setup/input_test.rb
index 164fb286..51e8bb42 100644
--- a/test/components/setup/input_test.rb
+++ b/test/components/setup/input_test.rb
@@ -13,24 +13,20 @@ def part
     @part ||= InputComponent.new(board: board, pin: 1)
   end
 
-  def test_pin_mode
-    mock = Minitest::Mock.new.expect :call, nil, [1, :in]
+  def test_pin_mode_and_pullup
+    mock = Minitest::Mock.new
+    mock.expect :call, nil, [1, :input, nil]
+    mock.expect :call, nil, [1, :input, :pulldown]
+    mock.expect :call, nil, [1, :input, :pullup]
+    
     board.stub(:set_pin_mode, mock) do
       part
+      InputComponent.new(board: board, pin: 1, pulldown: true)
+      InputComponent.new(board: board, pin: 1, pullup: true)
     end
     mock.verify
   end
 
-  def test_pullup
-    mock = Minitest::Mock.new
-    mock.expect :call, nil, [1, nil]
-    mock.expect :call, nil, [1, true]
-    board.stub(:set_pullup, mock) do
-      part.pullup = true
-    end
-    mock.verify
-  end
-  
   def test_stop_listener
     mock = Minitest::Mock.new
     mock.expect :call, nil, [1]
@@ -39,11 +35,4 @@ def test_stop_listener
     end
     mock.verify
   end
-
-  def test_pullup_in_options
-    mock = Minitest::Mock.new.expect :call, nil, [2, true]
-    board.stub(:set_pullup, mock) do
-      InputComponent.new(board: board, pin: 2, pullup: true)
-    end
-  end
 end
diff --git a/test/components/setup/output_test.rb b/test/components/setup/output_test.rb
index be44580a..cca9a4ea 100644
--- a/test/components/setup/output_test.rb
+++ b/test/components/setup/output_test.rb
@@ -14,6 +14,6 @@ def part
   end
 
   def test_pin_mode
-    assert_equal part.mode, :out
+    assert_equal part.mode, :output
   end
 end
diff --git a/test/components/setup/single_pin_test.rb b/test/components/setup/single_pin_test.rb
index 7d67cc7b..801f02c9 100644
--- a/test/components/setup/single_pin_test.rb
+++ b/test/components/setup/single_pin_test.rb
@@ -19,9 +19,15 @@ def test_requires_pin
   
   def test_mode=
     mock = Minitest::Mock.new
-    mock.expect :call, nil, [1, :out] 
+    mock.expect :call, nil, [1, :output, nil] 
+    mock.expect :call, nil, [1, :input, :pullup] 
+    mock.expect :call, nil, [1, :input, :pulldown] 
+    
     board.stub(:set_pin_mode, mock) do
-      part.send(:mode=, :out)
+      part.mode = :output
+      part.mode = :input_pullup
+      part.mode = :input_pulldown
     end
+    mock.verify
   end
 end

From d6afbbce0b0f36b6edb74905cbcb02dc554c5986 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 12:39:32 -0400
Subject: [PATCH 280/296] Use LEDC channels in reverse order to minimize servo
 conflict

---
 CHANGELOG.md           | 10 ++++++++--
 HARDWARE.md            |  4 ++--
 src/lib/DinoCoreIO.cpp |  8 ++++----
 src/lib/DinoServo.cpp  |  3 ++-
 4 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7024f047..25afe8df 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,10 +9,16 @@
   - This is the default sketch if `--target` isn't specified, and works for Arduino (and other) products based on the ATmega AVR chips, like the Uno, Nano, Leonardo and Mega.
 
 - ESP8266 (`--target esp8266`):
-  - Works with `Dino::Board.new`, but calling `Dino::Board::ESP8266.new` instead allows pins to be referred to as any of `'GPIO4'`, `4`, or `'D2'`, as printed on the NodeMCU dev board. When in doubt, look up your board's GPIO mapping and use those numbers instead.
+  - Works with `Dino::Board.new`, but calling `Dino::Board::ESP8266.new` instead allows pins to be referred to as any of `'GPIO4'`, `4`, or `'D2'`, specifically for the NodeMCU dev board. When in doubt, look up your board's GPIO mapping and use those numbers instead.
   - Works with either built in WiFi or Serial.
   - WiFi version supports OTA (over-the-air) update in the Arduino IDE. Initial flash must still be done via serial.
-  - **Note**: SoftwareSerial is incompatible with the ESP8266. LiquidCrystal (LCD) compiles for the ESP8266, but does not work. Both of these are excluded.
+  - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP8266, and are excluded from th sketch.
+  
+- ESP32 (`--target esp32`):
+  - Works with either built in WiFi or Serial.
+  - WiFi version does NOT support OTA (over-the-air) updates yet.
+  - **Note:** Servos and analog outputs share the `LEDC` channels on the board. Maximum of 16 combined.
+  - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP32, and are excluded from th sketch.
   
 - Arduino Due (`--target sam3x`) :
   - Up to 12-bit analog in/out. Pass a `bits:` option to `Board#new` to set resolution for both.
diff --git a/HARDWARE.md b/HARDWARE.md
index f67f0a98..e6a3c496 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -92,9 +92,9 @@
 
 | Name                 | Status         | Interface           | Version  | Component Class   | Notes |
 | :---------------     | :------:       | :--------           | :-----   | :---------------  |------ |
-| Servo                | :green_heart:  | PWM + Library       | 0.11.2   | `Servo`  | Max 6 servos on ATmega168, 12 otherwise
+| Servo                | :green_heart:  | PWM + Library       | 0.11.2   | `Servo`  | Maximum of 6 on ATmega168, 16 on ESP32 and 12 otherwise
 | L298N                | :heart:        | PWM Out             | -        | | 2ch DC motor driver
-| A3967                | :green_heart:  | Digital Out         | 0.12.0   | `Stepper`| 1ch microstepper (EasyDriver)
+| A3967                | :green_heart:  | Digital Out         | 0.12.0   | `Stepper`| 1ch microstepper (EasyDriver)å
 | PCA9685              | :heart:        | I2C                 | -        | -        | 16ch 12-bit PWM for servo, DC motor, or LED
 
 ### Displays
diff --git a/src/lib/DinoCoreIO.cpp b/src/lib/DinoCoreIO.cpp
index e6fb4379..6d731d0b 100644
--- a/src/lib/DinoCoreIO.cpp
+++ b/src/lib/DinoCoreIO.cpp
@@ -105,14 +105,14 @@ void Dino::aWrite(byte p, int v, boolean echo) {
 #ifdef ESP32
 byte Dino::ledcChannel(byte p) {
   // Search for enabled LEDC channel with given pin and use that if found.
-  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+  for (int i = LEDC_CHANNEL_COUNT -1; i > 0; i--){
     if ((ledcPins[i][0] == 1) && (ledcPins[i][1] == p)){
       return i;
     }
   }
 
   // We didn't find a channel to reuse.
-  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+  for (int i = LEDC_CHANNEL_COUNT -1; i > 0; i--){
     // If the channel isn't initialized and it isn't marked as used, use it.
     // should find some way to check if the channel itslef is being used
     if ((ledcPins[i][0] == 0)) {
@@ -145,14 +145,14 @@ void Dino::detachLEDC(byte p){
   ledcDetachPin(p);
   
   // Mark any channel associated with our pin as unused.
-  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+  for (int i = LEDC_CHANNEL_COUNT -1; i > 0; i--){
     if (ledcPins[i][1] == p) ledcPins[i][0] = 0;
   }
 }
 
 // Clear all the LEDC channels on reset.
 void Dino::clearLedcChannels(){
-  for (byte i = 0; i < LEDC_CHANNEL_COUNT; i++){
+  for (int i = LEDC_CHANNEL_COUNT -1; i > 0; i--){
     // Stop the channel if it was still enabled.
     if (ledcPins[i][0] != 0) ledcDetachPin(ledcPins[i][1]);
     
diff --git a/src/lib/DinoServo.cpp b/src/lib/DinoServo.cpp
index 6f8913a6..c87436bf 100644
--- a/src/lib/DinoServo.cpp
+++ b/src/lib/DinoServo.cpp
@@ -14,11 +14,12 @@
 // Could be up to 48 on Arduino Mega.
 #if defined (__AVR_ATmega168__)
   #define SERVO_COUNT 6
+#elif defined(ESP32)
+  #define SERVO_COUNT 16
 #else
   #define SERVO_COUNT 12
 #endif
 
-
 // Create an array of wrapper structs that link pins to servo objects.
 struct ServoWrapper{
   byte     pin;

From 6242fce3eecdb489954cf960049878d80084ca38 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 12:50:33 -0400
Subject: [PATCH 281/296] Correct error if calling A or DAC pin on boards
 without

---
 lib/dino/board/default.rb | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/dino/board/default.rb b/lib/dino/board/default.rb
index 271e4fac..6b32ff9c 100644
--- a/lib/dino/board/default.rb
+++ b/lib/dino/board/default.rb
@@ -17,8 +17,8 @@ def convert_pin(pin)
         return nil                  if pin == nil
         pin = pin.to_s
         return pin.to_i             if pin.match(DIGITAL_REGEX)
-        return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX)
-        return dac_pin_to_i(pin)    if pin.match(DAC_REGEX)
+        return analog_pin_to_i(pin) if pin.match(ANALOG_REGEX) && analog_zero
+        return dac_pin_to_i(pin)    if pin.match(DAC_REGEX) && dac_zero
         return "EE"                 if pin == "EE"
         raise ArgumentError, "incorrect pin format: #{pin.inspect}"
       end

From 2c49f195db8222eca2e1227687b242c49dbf285f Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 13:00:50 -0400
Subject: [PATCH 282/296] Add ESP32 to changelog and hardware list

---
 CHANGELOG.md | 11 +++++++----
 HARDWARE.md  |  8 ++++----
 2 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 25afe8df..2b7b230f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,22 +9,25 @@
   - This is the default sketch if `--target` isn't specified, and works for Arduino (and other) products based on the ATmega AVR chips, like the Uno, Nano, Leonardo and Mega.
 
 - ESP8266 (`--target esp8266`):
-  - Works with `Dino::Board.new`, but calling `Dino::Board::ESP8266.new` instead allows pins to be referred to as any of `'GPIO4'`, `4`, or `'D2'`, specifically for the NodeMCU dev board. When in doubt, look up your board's GPIO mapping and use those numbers instead.
   - Works with either built in WiFi or Serial.
   - WiFi version supports OTA (over-the-air) update in the Arduino IDE. Initial flash must still be done via serial.
-  - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP8266, and are excluded from th sketch.
+  - Dev boards can map GPIOs to physical pins differently. Always look up the GPIO numbers and use those for pin numbers.
+  - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP8266, and are excluded from the sketch.
   
 - ESP32 (`--target esp32`):
   - Works with either built in WiFi or Serial.
   - WiFi version does NOT support OTA (over-the-air) updates yet.
+  - Only tested with the original ESP32 module so far, not the later revisions with slightly different hardware.
+  - Dev boards can map GPIOs to physical pins differently. Always look up the GPIO numbers and use those for pin numbers.
   - **Note:** Servos and analog outputs share the `LEDC` channels on the board. Maximum of 16 combined.
-  - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP32, and are excluded from th sketch.
+  - **Note:** SoftwareSerial and LiquidCrystal (LCD) both do not work on the ESP32, and are excluded from the sketch.
+  - **Note:** SPI bug exists where input modes don't match other platforms. Eg. For a register using mode 0 on AVR, mode 2 needs to be set on ESP32 for it to work. Using mode 0 misses a bit.
   
 - Arduino Due (`--target sam3x`) :
   - Up to 12-bit analog in/out. Pass a `bits:` option to `Board#new` to set resolution for both.
   - DAC support. Refer to DAC pins as `'DAC0'`, `'DAC1'`, just as labeled on the board. Call `#analog_write` or just `#write` on an `AnalogOutput` component that uses the pin.
   - Uses the native ARM serial port by default. Configurable in sketch to use programming port.
-  - **Note**: SoftwareSerial, Infrared, and Tone are currently incompatible with the Arduino Due, and excluded from the sketch.
+  - **Note**: SoftwareSerial, Infrared, and Tone are incompatible with the Arduino Due, and excluded from the sketch.
 
 - ATmega168 (`--target mega168`):
   - By excluding a lot of features, we can still fit the memory constraints of the ATmega168 chips found in older Arduinos.
diff --git a/HARDWARE.md b/HARDWARE.md
index e6a3c496..8d64fef9 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -22,16 +22,16 @@
 | :--------             | :------:        | :----- | :--------------- |------ |
 | Wiznet W5100/5500     | :green_heart:   | 0.11.1 | Ethernet Shield  | Wired Ethernet for Uno/Mega pin-compatible boards
 | HDG204 + AT32UC3      | :man_shrugging: | 0.12.0 | WiFi Shield      | WiFi for Uno. No hardware to test, but compiles
-| ATWINC1500            | :man_shrugging: | 0.12.0 | WiFi Shield 101  | As above, but heavy on RAM. Compiles for Mega only
+| ATWINC1500            | :man_shrugging: | 0.12.0 | WiFi Shield 101  | As above, high memory use, Mega only
 
 ### Espressif Chips with Built-In WiFi
 
 |    Chip        | Status          | Version| Boards           | Notes |
 | :--------      | :------:        | :----- | :--------------- |------ |
 | ESP8266        | :yellow_heart:  | 0.12.0 | NodeMCU | SoftwareSerial and LCD don't work yet
-| ESP32          | :test_tube:     | -      | DOIT ESP32 DevKit V1 | Original ESP-WROOM-32
-| ESP32-S2       | :test_tube:     | -      | LOLIN S2 Pico | Single core Xtensa, native USB
-| ESP32-S3       | :test_tube:     | -      | LOLIN S3 V1.0.0 | Dual core Xtensa, native USB
+| ESP32          | :yellow_heart:  | 0.12.0 | DOIT ESP32 DevKit V1 | No LCD or SoftSerial. SPI input bug. See changelog
+| ESP32-S2       | :test_tube:     | 0.12.0 | LOLIN S2 Pico | Might work, not tested yet
+| ESP32-S3       | :test_tube:     | 0.12.0 | LOLIN S3 V1.0.0 | Might work, not tested yet
 
 **Note:** There are too many boards using these chips to be comprehensive. Most should work. These are the exact ones used for testing, chosen based on popularity.
 

From 204f6e60592dd5675c3739b8b2177fa211912b41 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 13:15:32 -0400
Subject: [PATCH 283/296] Fix -- instead of - in CLI arguments

---
 README.md              |  4 ++--
 lib/dino_cli/usage.txt | 24 ++++++++++++------------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 064c991b..d79fa7fd 100644
--- a/README.md
+++ b/README.md
@@ -99,12 +99,12 @@ dino sketch serial
 
 **For ESP8266, Serial over USB:**
 ```shell
-dino sketch serial -target esp8266
+dino sketch serial --target esp8266
 ````
 
 **For ESP32 over WiFi (2.4Ghz and DHCP Only):**
 ```shell
-dino sketch wifi -target esp32 -ssid YOUR_SSID -password YOUR_PASSWORD
+dino sketch wifi --target esp32 --ssid YOUR_SSID --password YOUR_PASSWORD
 ````
 **Note:** [This example](examples/tcp.rb) shows how to use a board over a TCP connection, but the WiFi sketches fall back to the serial interface if no TCP client is connected. You should be able to run the examples over serial while still connected.
 
diff --git a/lib/dino_cli/usage.txt b/lib/dino_cli/usage.txt
index 5e4202a7..0c60fd42 100644
--- a/lib/dino_cli/usage.txt
+++ b/lib/dino_cli/usage.txt
@@ -9,26 +9,26 @@
 
   Global options:
 
-    -target TARGET    (default: mega. Run 'dino targets' for more info)
-    -debug            (default: off)
+    --target TARGET    (default: mega. Run 'dino targets' for more info)
+    --debug            (default: off)
 
   Available sketches and sketch for each sketch:
 
     serial
-      -baud BAUD    (default: 115200)
+      --baud BAUD    (default: 115200)
 
     ethernet
-      -mac XX:XX:XX:XX:XX:XX    (required)
-      -ip XXX.XXX.XXX.XXX       (required, no DHCP)
-      -port PORT                (default: 3466)
+      --mac XX:XX:XX:XX:XX:XX    (required)
+      --ip XXX.XXX.XXX.XXX       (required, no DHCP)
+      --port PORT                (default: 3466)
 
     wifi
-      -ssid SSID            (required)
-      -password PASSWORD    (required)
-      -port PORT            (default: 3466)
+      --ssid SSID            (required)
+      --password PASSWORD    (required)
+      --port PORT            (default: 3466)
 
   Examples:
 
-    dino sketch ethernet -mac 12:34:56:78:90:12 - ip 192.168.1.2
-    dino sketch serial -baud 57600
-    dino sketch serial -baud 9600 -target core
+    dino sketch ethernet --mac 12:34:56:78:90:12 --ip 192.168.1.2
+    dino sketch serial --baud 57600
+    dino sketch serial --baud 9600 -target core

From 64c537cfdfe07368ff5b5f5dd3dec919231e2908 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 14:18:11 -0400
Subject: [PATCH 284/296] The Nano Every ATmega4809 should just work

---
 HARDWARE.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/HARDWARE.md b/HARDWARE.md
index 8d64fef9..1c239448 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -11,6 +11,7 @@
 | ATmega32u4     | :green_heart:   | 0.11.0 | Leonardo, Micro, Leonardo ETH, Esplora, LilyPad USB | **v0.11.1** for Leonardo ETH
 | ATmega1280     | :green_heart:   | 0.11.1 | Mega | 
 | ATmega2560     | :green_heart:   | 0.11.1 | Mega2560, Arduino Mega ADK | 
+| ATmega4809     | :man_shrugging: | 0.12.0 | Nano Every | No hardware to test, but should work
 | ATSAM3X8E      | :yellow_heart:  | 0.12.0 | Due | Uses native USB. SoftSerial, Tone, IR Out, and I2C don't work yet
 | ATSAMD21       | :heart:         | -      | Zero, M0, M0 Pro | 
 

From 2721bedeb1629b9fa8484e13aeb068562722c302 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 15:02:27 -0400
Subject: [PATCH 285/296] Tests for remaining mixins

---
 test/components/mixins/board_proxy_test.rb | 24 ++++++++++++
 test/components/mixins/bus_master_test.rb  | 28 ++++++++++++++
 test/components/mixins/bus_slave_test.rb   | 44 ++++++++++++++++++++++
 3 files changed, 96 insertions(+)
 create mode 100644 test/components/mixins/board_proxy_test.rb
 create mode 100644 test/components/mixins/bus_master_test.rb
 create mode 100644 test/components/mixins/bus_slave_test.rb

diff --git a/test/components/mixins/board_proxy_test.rb b/test/components/mixins/board_proxy_test.rb
new file mode 100644
index 00000000..4642d7bb
--- /dev/null
+++ b/test/components/mixins/board_proxy_test.rb
@@ -0,0 +1,24 @@
+require 'test_helper'
+
+class ProxiedComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::BoardProxy
+end
+
+class BoardProxyTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= ProxiedComponent.new(board: board)
+  end
+  
+  def test_methods
+    assert_equal part.high, 1
+    assert_equal part.low, 0
+    assert_equal part.convert_pin("7"), 7
+    part.set_pin_mode(1, :output, :pullup)
+    part.start_read
+  end
+end
diff --git a/test/components/mixins/bus_master_test.rb b/test/components/mixins/bus_master_test.rb
new file mode 100644
index 00000000..cb46d0e5
--- /dev/null
+++ b/test/components/mixins/bus_master_test.rb
@@ -0,0 +1,28 @@
+require 'test_helper'
+
+class BusMasterComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::BusMaster
+end
+
+class BusMasterTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= BusMasterComponent.new(board: board)
+  end
+  
+  def test_has_mutex
+    assert_equal part.mutex.class, Mutex
+  end
+  
+  def test_components
+    part.add_component "1"
+    assert_equal part.components, ["1"]
+    
+    part.remove_component "1"
+    assert_equal part.components, []
+  end
+end
diff --git a/test/components/mixins/bus_slave_test.rb b/test/components/mixins/bus_slave_test.rb
new file mode 100644
index 00000000..f6959411
--- /dev/null
+++ b/test/components/mixins/bus_slave_test.rb
@@ -0,0 +1,44 @@
+require 'test_helper'
+
+class BusMasterComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::BusMaster
+end
+
+class BusSlaveComponent
+  include Dino::Components::Setup::Base
+  include Dino::Components::Mixins::BusSlave
+end
+
+class BusSlaveTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def bus
+    @bus ||= BusMasterComponent.new(board: board)
+  end
+  
+  def part
+    @part ||= BusSlaveComponent.new(bus: bus, address: 0x22)
+  end
+  
+  def test_initialize
+    assert_equal part.board, bus
+    assert_equal part.address, 0x22
+  end
+  
+  def test_requires_address
+    assert_raises(ArgumentError) { BusSlaveComponent.new(bus: bus) }
+  end
+  
+  def test_can_use_bus_atomically   
+    mock = MiniTest::Mock.new
+    1.times {mock.expect(:call, nil)}
+    
+    bus.mutex.stub(:synchronize, mock) do
+      part.atomically { true; false; }
+    end
+    mock.verify
+  end
+end

From d3a1630e97d6de9ca95fdb3114304528aa6cac9a Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 16:06:32 -0400
Subject: [PATCH 286/296] Input register tests. Fix bug where bit order was
 reversed, but not byte order.

Switched default order back to LSBFIRST to match output registers, since. Using MSBFIRST just hid the bug.
---
 examples/register/spi_in.rb               |   2 +-
 lib/dino/components/register/input.rb     |   8 +-
 lib/dino/components/register/shift_in.rb  |  10 +-
 lib/dino/components/register/spi_in.rb    |   2 +-
 test/components/i2c/slave_test.rb         |   2 +-
 test/components/register/input_test.rb    | 108 ++++++++++++++++++++++
 test/components/register/shift_in_test.rb |  37 ++------
 test/components/register/spi_in_test.rb   |  10 +-
 8 files changed, 132 insertions(+), 47 deletions(-)
 create mode 100644 test/components/register/input_test.rb

diff --git a/examples/register/spi_in.rb b/examples/register/spi_in.rb
index b0ade717..bc56d747 100644
--- a/examples/register/spi_in.rb
+++ b/examples/register/spi_in.rb
@@ -26,7 +26,7 @@
 shift_register = Dino::Components::Register::SPIIn.new  board: board,
                                                         pin: 8,
                                                         spi_mode: 2,
-                                                        bit_order: :lsbfirst
+                                                        # bit_order: :lsbfirst
                                                         # frequency: 1000000
                                                         # bytes: 1
 
diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index 76d85ec1..b4ecd657 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -20,14 +20,14 @@ def before_initialize(options={})
           # When used as a board proxy, store the state of each register
           # pin as a 0 or 1 in an array that is (@bytes * 8) long. Zero out to start.
           #
-          @state = Array.new(@bytes*8) {|i| 0}
+          @state = Array.new(@bytes*8) { 0 }
 
           #
           # Keep track of whether anything is listening or reading a specific pin.
           # This might be separate from whether a component is attached or not.
           #
-          @reading_pins   = Array.new(@bytes*8) {|i| false}
-          @listening_pins = Array.new(@bytes*8) {|i| false}
+          @reading_pins   = Array.new(@bytes*8) { false}
+          @listening_pins = Array.new(@bytes*8) { false}
         end
 
         def after_initialize(options={})
@@ -66,7 +66,7 @@ def update(message)
         #
         def byte_array_to_bit_array(byte_array)
           byte_array.map do |byte|
-            byte.to_i.to_s(2).rjust(8, "0").split("")
+            byte.to_i.to_s(2).rjust(8, "0").split("").reverse
           end.flatten.map { |bit| bit.to_i }
         end
 
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 2a217875..6fd6bd1d 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -18,7 +18,7 @@ class ShiftIn
         def before_initialize(options={})
           super(options)
           self.rising_clock = options[:rising_clock] || false
-          self.bit_order = options[:bit_order] || :msbfirst
+          self.bit_order = options[:bit_order] || :lsbfirst
         end
         
         def after_initialize(options={})
@@ -38,14 +38,14 @@ def rising_clock=(value)
           @rising_clock = [0, nil, false].include?(value) ? false : true
         end
 
-        def read(num_bytes=@bytes)
-          board.shift_read latch.pin, data.pin, clock.pin, num_bytes, 
+        def read
+          board.shift_read latch.pin, data.pin, clock.pin, @bytes, 
                            preclock_high: rising_clock,
                            bit_order: bit_order
         end
 
-        def listen(num_bytes=@bytes)
-          board.shift_listen latch.pin, data.pin, clock.pin, num_bytes,
+        def listen
+          board.shift_listen latch.pin, data.pin, clock.pin, @bytes,
                              preclock_high: rising_clock,
                              bit_order: bit_order
         end
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 586b7ec0..5c28fc28 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -16,7 +16,7 @@ def initialize(options)
           super(options)
           @spi_mode  = options[:spi_mode]  || 0
           @frequency = options[:frequency] || 1000000
-          @bit_order = options[:bit_order] || :msbfirst
+          @bit_order = options[:bit_order] || :lsbfirst
         end
 
         def read
diff --git a/test/components/i2c/slave_test.rb b/test/components/i2c/slave_test.rb
index 194fea06..317a7971 100644
--- a/test/components/i2c/slave_test.rb
+++ b/test/components/i2c/slave_test.rb
@@ -1,6 +1,6 @@
 require 'test_helper'
 
-class I2SlaveTest < MiniTest::Test
+class I2CSlaveTest < MiniTest::Test
   def board
     @board ||= BoardMock.new
   end
diff --git a/test/components/register/input_test.rb b/test/components/register/input_test.rb
new file mode 100644
index 00000000..fbe56228
--- /dev/null
+++ b/test/components/register/input_test.rb
@@ -0,0 +1,108 @@
+require 'test_helper'
+
+class InputRegisterTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board, pins: { clock: 12, data: 11, latch: 8 } }
+  end
+
+  # Shift in is probably the simplest form of an input register.
+  def part
+    @part ||= Dino::Components::Register::ShiftIn.new(options)
+  end
+  
+  def button
+    @button ||= Dino::Components::Button.new(board: part, pin: 0)
+  end
+  
+  def test_sets_byte_length
+    new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
+    assert_equal 2, new_part.bytes 
+  end
+  
+  def test_state_setup
+    new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 3))
+    assert_equal new_part.state, Array.new(24) {|i| 0}
+    assert_equal new_part.instance_variable_get(:@reading_pins), Array.new(24) { false }
+    assert_equal new_part.instance_variable_get(:@listening_pins), Array.new(24) { false }
+    refute_nil   new_part.callbacks[:board_proxy]
+  end
+  
+  def test_updates_child_components
+    button
+    part.update("1")
+    assert button.high?
+    part.update("0")
+    assert button.low?
+  end
+  
+  def test_bit_array_conversion_and_state_update
+    part.update("127")
+    assert_equal [1,1,1,1,1,1,1,0], part.state
+
+    new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
+    new_part.update("127,128")
+    assert_equal [1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,1], new_part.state
+  end
+  
+  def test_callbacks_get_bit_array
+    mock = MiniTest::Mock.new.expect :call, nil, [[1,1,1,1,1,1,1,0]]
+    part.add_callback do |data|
+      mock.call(data)
+    end
+    part.update("127")
+    mock.verify
+  end
+  
+  def test_read_proxy
+    # Stop automatic listening first.
+    button.stop
+    
+    # Give #read some value so it stops blocking.
+    Thread.new do
+      sleep while !part.callbacks[:force_update]
+      part.update("255")
+    end
+
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil
+    part.stub(:read, mock) do
+      button.read
+    end
+    mock.verify
+  end
+
+  def test_listener_proxy
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil
+    part.stub(:listen, mock) do
+      # Tells the register to start listening when it initializees.
+      button
+      
+      # Should not make a second listen call to the board.
+      button1 = Dino::Components::Button.new(board: part, pin: 1)
+    end
+    mock.verify
+    
+    # Should be listening to the lowest 2 bits now.
+    assert_equal part.instance_variable_get(:@listening_pins), [true, true, false, false, false, false, false, false]
+  end
+  
+  def test_stop_listener_proxy
+    button
+    
+    # Calling stop on a child part, when only it is listening, should call stop on the register too.
+    mock = MiniTest::Mock.new.expect :call, nil
+    part.stub(:stop, mock) do
+      button.stop
+    end
+    mock.verify
+    
+    # Check listener tracking is correct.
+    assert_equal part.instance_variable_get(:@listening_pins), Array.new(8) { false }
+    refute part.any_listening
+  end
+end
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
index 8bf9176c..e8045ed6 100644
--- a/test/components/register/shift_in_test.rb
+++ b/test/components/register/shift_in_test.rb
@@ -19,11 +19,6 @@ def test_proxies
     assert_equal Dino::Components::Register::Select,     part.latch.class
   end
 
-  def test_byte_length
-    new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
-    assert_equal 2, new_part.bytes
-  end
-
   def test_rising_clock
     assert_equal part.rising_clock, false
     new_part = Dino::Components::Register::ShiftIn.new(options.merge(rising_clock: :yes))
@@ -32,13 +27,13 @@ def test_rising_clock
 
   def test_read
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :msbfirst
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :lsbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :lsbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :msbfirst
     board.stub(:shift_read, mock) do
       new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2)
       new_part.read
       
-      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :lsbfirst)
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :msbfirst)
       new_part.read
     end
     mock.verify
@@ -46,13 +41,13 @@ def test_read
   
   def test_listen
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :msbfirst
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :lsbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :lsbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :msbfirst
     board.stub(:shift_listen, mock) do
       new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2)
       new_part.listen
       
-      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :lsbfirst)
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :msbfirst)
       new_part.listen
     end
     mock.verify
@@ -67,29 +62,11 @@ def test_stop
     mock.verify
   end
   
-  def test_callback_bubble
+  def test_gets_reads_through_latch_pin
     mock = MiniTest::Mock.new.expect :call, nil, ["127,255"]
     part.stub(:update, mock) do
       part.latch.update "127,255"
     end
     mock.verify
   end
-
-  def test_bit_array_conversion
-    part.update("127")
-    assert_equal [0,1,1,1,1,1,1,1], part.state
-
-    new_part = Dino::Components::Register::ShiftIn.new(options.merge(bytes: 2))
-    new_part.update("127,255")
-    assert_equal [0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1], new_part.state
-  end
-
-  def test_callbacks_get_bit_array
-    mock = MiniTest::Mock.new.expect :call, nil, [[0,1,1,1,1,1,1,1]]
-    part.add_callback do |data|
-      mock.call(data)
-    end
-    part.update("127")
-    mock.verify
-  end
 end
diff --git a/test/components/register/spi_in_test.rb b/test/components/register/spi_in_test.rb
index 199b95f2..e07b96be 100644
--- a/test/components/register/spi_in_test.rb
+++ b/test/components/register/spi_in_test.rb
@@ -6,7 +6,7 @@ def board
   end
 
   def options
-    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :lsbfirst, bytes: 2 }
+    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :msbfirst, bytes: 2 }
   end
 
   def part
@@ -17,19 +17,19 @@ def test_defaults
     part = Dino::Components::Register::SPIIn.new board: board, pin: 9
     assert_equal part.frequency, 1000000
     assert_equal part.spi_mode,  0
-    assert_equal part.bit_order, :msbfirst
+    assert_equal part.bit_order, :lsbfirst
     assert_equal part.bytes, 1
   end
   
   def test_options
     assert_equal part.frequency, 800000
     assert_equal part.spi_mode, 2
-    assert_equal part.bit_order, :lsbfirst
+    assert_equal part.bit_order, :msbfirst
     assert_equal part.bytes, 2
   end
 
   def test_read
-    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :lsbfirst
+    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :msbfirst
     board.stub(:spi_transfer, mock) do
       part.read
     end
@@ -37,7 +37,7 @@ def test_read
   end
   
   def test_listen
-    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :lsbfirst
+    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :msbfirst
     board.stub(:spi_listen, mock) do
       part.listen
     end

From ae56c6cbcc2d497be4cdfbdabd222098d808c2e1 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 18:36:37 -0400
Subject: [PATCH 287/296] Make input register bytes to bits conversion clearer

---
 lib/dino/components/register/input.rb | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/lib/dino/components/register/input.rb b/lib/dino/components/register/input.rb
index b4ecd657..6f9a211a 100644
--- a/lib/dino/components/register/input.rb
+++ b/lib/dino/components/register/input.rb
@@ -61,13 +61,22 @@ def update(message)
         end
 
         #
-        # Convert an array of cached bytes into an array of integer 1s and 0s
-        # Convenient for bubbling to proxy components, but is used for all callbacks.
+        # Convert array of bytes coming from the register into an array of bits
+        # to update self state and give to component callbacks.
         #
         def byte_array_to_bit_array(byte_array)
-          byte_array.map do |byte|
-            byte.to_i.to_s(2).rjust(8, "0").split("").reverse
-          end.flatten.map { |bit| bit.to_i }
+          #
+          # For each array element (1 byte):
+          # decimal number as string -> integer -> padded string of binary digits 
+          # -> reverse digits from reading order to array indexing order
+          # -> join digits of all bytes into one string
+          #
+          binary_string = byte_array.map do |byte|
+            byte.to_i.to_s(2).rjust(8, "0").reverse
+          end.join
+          
+          # Split the digits out of the string into individual integers.
+          bits = binary_string.split("").map { |bit| bit.to_i }
         end
 
         def read

From 2bf7443ceabbca3156e6ac94507b8da18d50e8f4 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 19:41:19 -0400
Subject: [PATCH 288/296] Tests and fixes for output registers. Default to
 MSBFIRST

Bit order was reversed for these, like input registers, but byte order was also wrong. MS byte always first now.
---
 examples/register/shift_in.rb              |  5 +-
 examples/register/shift_out.rb             |  4 +-
 examples/register/shift_ssd.rb             |  4 +-
 examples/register/spi_combined.rb          | 17 ++---
 examples/register/spi_in.rb                |  6 +-
 examples/register/spi_ssd.rb               |  3 +-
 lib/dino/api/shift_io.rb                   |  8 ++-
 lib/dino/components/register/output.rb     | 22 ++++--
 lib/dino/components/register/shift_out.rb  |  4 +-
 lib/dino/components/register/spi_out.rb    |  2 +-
 test/components/register/output_test.rb    | 83 ++++++++++++++++++++++
 test/components/register/shift_out_test.rb |  2 +-
 test/components/register/spi_out_test.rb   | 10 +--
 13 files changed, 135 insertions(+), 35 deletions(-)
 create mode 100644 test/components/register/output_test.rb

diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index ca68aa07..fc40d3cc 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -16,8 +16,9 @@
 
 shift_register = Dino::Components::Register::ShiftIn.new  board: board,
                                                           pins: {latch: 10, data: 12, clock: 13},
-                                                          rising_clock: true,
-                                                          bytes: 1
+                                                          rising_clock: true
+                                                          # bit_order: :lsbfirst
+                                                          # bytes: 1
 
 button = Dino::Components::Button.new(pin: 0, board: shift_register)
 
diff --git a/examples/register/shift_out.rb b/examples/register/shift_out.rb
index 6f92daca..87e6ee73 100644
--- a/examples/register/shift_out.rb
+++ b/examples/register/shift_out.rb
@@ -11,8 +11,10 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 register = Dino::Components::Register::ShiftOut.new  board: board,
                                                      pins:  {latch: 9, data: 11, clock: 13}
+                                                     # bit_order: :msbfirst
                                                      # bytes: 1
-
+                                                     # buffer_writes: true
+                                 
 # Write a single byte
 register.write(255)
 
diff --git a/examples/register/shift_ssd.rb b/examples/register/shift_ssd.rb
index a6b80a6e..31a77fa6 100644
--- a/examples/register/shift_ssd.rb
+++ b/examples/register/shift_ssd.rb
@@ -14,8 +14,10 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 shift_register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                           pins: {data: 11, clock: 13, latch: 9},
+                                                           pins: {data: 11, clock: 13, latch: 9}
+                                                           # bit_order: :msbfirst
                                                            # bytes: 1
+                                                           # buffer_writes: true
 
 ssd = Dino::Components::SSD.new   board: shift_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
diff --git a/examples/register/spi_combined.rb b/examples/register/spi_combined.rb
index e981e52b..1cca9cc8 100644
--- a/examples/register/spi_combined.rb
+++ b/examples/register/spi_combined.rb
@@ -8,21 +8,22 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 output_register = Dino::Components::Register::SPIOut.new board: board,
                                                          pin: 9
-                                                         # frequency: 3000000,
-                                                         # spi_mode: 0,
+                                                         # frequency: 1000000
+                                                         # spi_mode: 0
+                                                         # bit_order: :msbfirst
                                                          # bytes: 1
-                                                         # bit_order: :lsbfirst
+                                                         # buffer_writes: true
 
 ssd = Dino::Components::SSD.new   board: output_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
 
 input_register = Dino::Components::Register::SPIIn.new  board: board,
-                                                        pin: 8,
-                                                        spi_mode: 0,
-                                                        frequency: 3000000
-                                                        # bytes: 1
+                                                        pin: 8
+                                                        # frequency: 1000000
+                                                        # spi_mode: 0
                                                         # bit_order: :lsbfirst
-
+                                                        # bytes: 1
+                                                        
 button = Dino::Components::Button.new(pin: 0, board: input_register)
 
 button.down { puts "down"}
diff --git a/examples/register/spi_in.rb b/examples/register/spi_in.rb
index bc56d747..e70b88e0 100644
--- a/examples/register/spi_in.rb
+++ b/examples/register/spi_in.rb
@@ -24,10 +24,10 @@
 
 # Tested with CD4021B register, which is LSBFIRST, but needs SPI mode 0 on some boards and 2 on others.
 shift_register = Dino::Components::Register::SPIIn.new  board: board,
-                                                        pin: 8,
-                                                        spi_mode: 2,
-                                                        # bit_order: :lsbfirst
+                                                        pin: 8
                                                         # frequency: 1000000
+                                                        # spi_mode: 0
+                                                        # bit_order: :lsbfirst
                                                         # bytes: 1
 
 button = Dino::Components::Button.new(pin: 0, board: shift_register)
diff --git a/examples/register/spi_ssd.rb b/examples/register/spi_ssd.rb
index 1d01a076..16050190 100644
--- a/examples/register/spi_ssd.rb
+++ b/examples/register/spi_ssd.rb
@@ -26,7 +26,8 @@
                                                          # frequency: 3000000,
                                                          # spi_mode: 0,
                                                          # bytes: 1
-                                                         # bit_order: :lsbfirst
+                                                         # bit_order: :msbfirst
+                                                         # buffer_writes: true
 
 ssd = Dino::Components::SSD.new   board: shift_register,
                                   pins:  { cathode: 0, a: 1, b: 2, c: 3, d: 4, e: 5, f: 6, g: 7 }
diff --git a/lib/dino/api/shift_io.rb b/lib/dino/api/shift_io.rb
index 55f8a672..a7130796 100644
--- a/lib/dino/api/shift_io.rb
+++ b/lib/dino/api/shift_io.rb
@@ -10,12 +10,11 @@ def shift_settings(data, clock, bit_order=:lsbfirst, preclock_high=false)
         pack :uint8, [convert_pin(data), convert_pin(clock), settings]
       end
 
+      # CMD = 21
       def shift_write(latch, data, clock, bytes, options={})
         settings = shift_settings(data, clock, options[:bit_order])
         limit = aux_limit - settings.length
-        bytes = pack :uint8,
-                     bytes,
-                     max: limit
+        bytes = pack :uint8, bytes, max: limit
 
         write Message.encode command: 21,
                              pin: convert_pin(latch),
@@ -23,6 +22,7 @@ def shift_write(latch, data, clock, bytes, options={})
                              aux_message: settings + bytes
       end
 
+      # CMD = 22
       def shift_read(latch, data, clock, num_bytes, options={})
         settings = shift_settings(data, clock, options[:bit_order], options[:preclock_high])
         write Message.encode command: 22,
@@ -31,6 +31,7 @@ def shift_read(latch, data, clock, num_bytes, options={})
                              aux_message: settings
       end
 
+      # CMD = 23
       def shift_listen(latch, data, clock, num_bytes, options={})
         settings = shift_settings(data, clock, options[:bit_order], options[:preclock_high])
         write Message.encode command: 23,
@@ -39,6 +40,7 @@ def shift_listen(latch, data, clock, num_bytes, options={})
                              aux_message: settings
       end
 
+      # CMD = 24
       def shift_stop(latch)
         write Message.encode command: 24, pin: convert_pin(latch)
       end
diff --git a/lib/dino/components/register/output.rb b/lib/dino/components/register/output.rb
index 695a514b..03e1f06a 100644
--- a/lib/dino/components/register/output.rb
+++ b/lib/dino/components/register/output.rb
@@ -26,7 +26,9 @@ def before_initialize(options={})
           # have passed since this object last got input. Better for things like SSDs
           # where many bits change in sequence, but not at exactly the same time.
           #
-          @write_delay = options[:write_delay] || 0.005
+          @buffer_writes = true
+          @buffer_writes = false if options[:buffer_writes] == false
+          @write_delay = options[:write_delay] || 0.001
         end
         
         def after_initialize(options={})
@@ -44,8 +46,8 @@ def write
         #
         include Mixins::BoardProxy
         def digital_write(pin, value)
-          state[pin] = value
-          delayed_write(state)
+          state[pin] = value  # Might not be atomic?
+          @buffer_writes ? write_buffered(state) : write_state
         end
         
         def digital_read(pin)
@@ -57,7 +59,7 @@ def digital_read(pin)
         # Lets us catch multiple changed bits, like when hosting an SSD.
         #
         include Mixins::Threaded
-        def delayed_write(old_state)
+        def write_buffered(old_state)
           threaded do
             sleep @write_delay
             # Keep delaying if state has changed.
@@ -71,9 +73,15 @@ def delayed_write(old_state)
         def write_state
           bytes = []
           state.each_slice(8) do |slice|
-            # Convert nil to 0 to ensure bit order is consistent.
-            zeroed = slice.map { |bit| bit.to_i }.join.to_i(2)
-            bytes << zeroed
+            # Convert nils in the slice to zero.
+            zeroed = slice.map { |bit| bit.to_i }
+            
+            # Each slice is 8 bits of a byte, with the lowest on the left.
+            # Reverse to reading order (lowest right) then join into string, and convert to integer.
+            byte = zeroed.reverse.join.to_i(2)
+            
+            # Pack bytes in reverse order.
+            bytes.unshift byte
           end
           write(bytes)
         end
diff --git a/lib/dino/components/register/shift_out.rb b/lib/dino/components/register/shift_out.rb
index ef1ab19d..2d271b2f 100644
--- a/lib/dino/components/register/shift_out.rb
+++ b/lib/dino/components/register/shift_out.rb
@@ -17,13 +17,13 @@ class ShiftOut
                     
         def before_initialize(options={})
           super(options)
-          self.bit_order = options[:bit_order] || :lsbfirst
+          self.bit_order = options[:bit_order] || :msbfirst
         end
         
         attr_accessor :bit_order
 
         def write(*bytes)
-          board.shift_write(latch.pin, data.pin, clock.pin, bytes)
+          board.shift_write(latch.pin, data.pin, clock.pin, bytes, bit_order: bit_order)
         end
       end
     end
diff --git a/lib/dino/components/register/spi_out.rb b/lib/dino/components/register/spi_out.rb
index 3740429c..dbba7cf7 100644
--- a/lib/dino/components/register/spi_out.rb
+++ b/lib/dino/components/register/spi_out.rb
@@ -16,7 +16,7 @@ def before_initialize(options)
           super(options)
           @spi_mode  = options[:spi_mode]  || 0
           @frequency = options[:frequency] || 1000000
-          @bit_order = options[:bit_order] || :lsbfirst
+          @bit_order = options[:bit_order] || :msbfirst
         end
 
         def write(*bytes)
diff --git a/test/components/register/output_test.rb b/test/components/register/output_test.rb
new file mode 100644
index 00000000..039cf3ab
--- /dev/null
+++ b/test/components/register/output_test.rb
@@ -0,0 +1,83 @@
+require 'test_helper'
+
+class OutputRegisterTest < Minitest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def options
+    { board: board, pins: { clock: 12, data: 11, latch: 8 } }
+  end
+
+  def part
+    @part ||= Dino::Components::Register::ShiftOut.new(options)
+  end
+  
+  def led
+    @led ||= Dino::Components::Led.new(board: part, pin: 0)
+  end
+  
+  def test_sets_byte_length
+    new_part = Dino::Components::Register::ShiftOut.new(options.merge(bytes: 2))
+    assert_equal 2, new_part.bytes 
+  end
+  
+  def test_state_setup
+    new_part = Dino::Components::Register::ShiftOut.new(options.merge(bytes: 3))
+    assert_equal new_part.state, Array.new(24) {|i| 0}
+    assert_equal new_part.instance_variable_get(:@write_delay), 0.001
+    assert_equal new_part.instance_variable_get(:@buffer_writes), true
+  end
+  
+  def test_write_buffering_control
+    new_part = Dino::Components::Register::ShiftOut.new(options.merge(bytes: 3, buffer_writes: false, write_delay: 0.5))
+    assert_equal new_part.instance_variable_get(:@write_delay), 0.5
+    assert_equal new_part.instance_variable_get(:@buffer_writes), false
+  end
+  
+  def test_updates_and_writes_state_for_children
+    led
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [[1]]
+    part.stub(:write, mock) do
+      led.on
+      sleep 0.002
+    end
+    mock.verify
+    
+    assert_equal part.state, [1,0,0,0,0,0,0,0]
+  end
+  
+  def test_implements_digital_read_for_children
+    led
+    
+    mock = MiniTest::Mock.new.expect :call, nil, [0]
+    part.stub(:digital_read, mock) do
+      led.board.digital_read(led.pin)
+    end
+    mock.verify
+  end
+  
+  def test_bit_and_byte_orders_correct
+    part.instance_variable_set(:@bytes, 2)
+    bit_array = "0101010100001111".split("")
+    
+    mock = MiniTest::Mock.new
+    mock.expect :call, nil, [[0b11110000, 0b10101010]]
+    part.stub(:write, mock) do
+      part.instance_variable_set(:@state, bit_array)
+      part.write_state
+      sleep 0.002
+    end
+    mock.verify
+    
+    assert_equal part.state, bit_array
+  end
+  
+  def test_disable_buffering
+    part.instance_variable_set(:@buffer_writes, false)
+    part.instance_variable_set(:@write_delay, 1)
+    led.on
+    assert_nil part.thread
+  end
+end
diff --git a/test/components/register/shift_out_test.rb b/test/components/register/shift_out_test.rb
index ff6b5ffd..ae1b8860 100644
--- a/test/components/register/shift_out_test.rb
+++ b/test/components/register/shift_out_test.rb
@@ -21,7 +21,7 @@ def test_proxies
 
   def test_write
     new_part = Dino::Components::Register::ShiftOut.new(options.merge(bytes: 2))
-    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, [255,127]]
+    mock = MiniTest::Mock.new.expect :call, nil, [8, 11, 12, [255,127]], bit_order: :msbfirst
     board.stub(:shift_write, mock) do
       new_part.write(255,127)
     end
diff --git a/test/components/register/spi_out_test.rb b/test/components/register/spi_out_test.rb
index 6a2655f1..3208d0cc 100644
--- a/test/components/register/spi_out_test.rb
+++ b/test/components/register/spi_out_test.rb
@@ -6,7 +6,7 @@ def board
   end
 
   def options
-    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :msbfirst }
+    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :lsbfirst }
   end
 
   def part
@@ -17,19 +17,19 @@ def test_defaults
     part = Dino::Components::Register::SPIOut.new board: board, pin: 9
     assert_equal part.frequency, 1000000
     assert_equal part.spi_mode,  0
-    assert_equal part.bit_order, :lsbfirst
+    assert_equal part.bit_order, :msbfirst
   end
   
   def test_options
     assert_equal part.frequency, 800000
     assert_equal part.spi_mode, 2
-    assert_equal part.bit_order, :msbfirst
+    assert_equal part.bit_order, :lsbfirst
   end
 
   def test_write
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [9], mode: 2, frequency: 800000, write: [0], bit_order: :msbfirst
-    mock.expect :call, nil, [9], mode: 2, frequency: 800000, write: [255,127], bit_order: :msbfirst
+    mock.expect :call, nil, [9], mode: 2, frequency: 800000, write: [0], bit_order: :lsbfirst
+    mock.expect :call, nil, [9], mode: 2, frequency: 800000, write: [255,127], bit_order: :lsbfirst
     board.stub(:spi_transfer, mock) do
       part.write(255,127)
     end

From 1d5730f0329fda65bdbcdfc3c10a214e8fedb004 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sat, 25 Feb 2023 20:50:09 -0400
Subject: [PATCH 289/296] Switch input register default back to MSBFIRST

This should finally be correct. MSBFIRST per byte, but LSBYTE FIRST
---
 examples/register/shift_in.rb             |  2 +-
 examples/register/shift_out.rb            |  2 +-
 examples/register/spi_combined.rb         |  2 +-
 examples/register/spi_in.rb               |  2 +-
 lib/dino/components/register/shift_in.rb  |  2 +-
 lib/dino/components/register/spi_in.rb    |  2 +-
 test/components/register/shift_in_test.rb | 12 ++++++------
 test/components/register/spi_in_test.rb   | 10 +++++-----
 8 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index fc40d3cc..b179e9d0 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -17,7 +17,7 @@
 shift_register = Dino::Components::Register::ShiftIn.new  board: board,
                                                           pins: {latch: 10, data: 12, clock: 13},
                                                           rising_clock: true
-                                                          # bit_order: :lsbfirst
+                                                          # bit_order: :msbfirst
                                                           # bytes: 1
 
 button = Dino::Components::Button.new(pin: 0, board: shift_register)
diff --git a/examples/register/shift_out.rb b/examples/register/shift_out.rb
index 87e6ee73..9439232b 100644
--- a/examples/register/shift_out.rb
+++ b/examples/register/shift_out.rb
@@ -14,7 +14,7 @@
                                                      # bit_order: :msbfirst
                                                      # bytes: 1
                                                      # buffer_writes: true
-                                 
+
 # Write a single byte
 register.write(255)
 
diff --git a/examples/register/spi_combined.rb b/examples/register/spi_combined.rb
index 1cca9cc8..262ddeec 100644
--- a/examples/register/spi_combined.rb
+++ b/examples/register/spi_combined.rb
@@ -21,7 +21,7 @@
                                                         pin: 8
                                                         # frequency: 1000000
                                                         # spi_mode: 0
-                                                        # bit_order: :lsbfirst
+                                                        # bit_order: :msbfirst
                                                         # bytes: 1
                                                         
 button = Dino::Components::Button.new(pin: 0, board: input_register)
diff --git a/examples/register/spi_in.rb b/examples/register/spi_in.rb
index e70b88e0..15fcf4bd 100644
--- a/examples/register/spi_in.rb
+++ b/examples/register/spi_in.rb
@@ -27,7 +27,7 @@
                                                         pin: 8
                                                         # frequency: 1000000
                                                         # spi_mode: 0
-                                                        # bit_order: :lsbfirst
+                                                        # bit_order: :msbfirst
                                                         # bytes: 1
 
 button = Dino::Components::Button.new(pin: 0, board: shift_register)
diff --git a/lib/dino/components/register/shift_in.rb b/lib/dino/components/register/shift_in.rb
index 6fd6bd1d..0b5d208b 100644
--- a/lib/dino/components/register/shift_in.rb
+++ b/lib/dino/components/register/shift_in.rb
@@ -18,7 +18,7 @@ class ShiftIn
         def before_initialize(options={})
           super(options)
           self.rising_clock = options[:rising_clock] || false
-          self.bit_order = options[:bit_order] || :lsbfirst
+          self.bit_order = options[:bit_order] || :msbfirst
         end
         
         def after_initialize(options={})
diff --git a/lib/dino/components/register/spi_in.rb b/lib/dino/components/register/spi_in.rb
index 5c28fc28..586b7ec0 100644
--- a/lib/dino/components/register/spi_in.rb
+++ b/lib/dino/components/register/spi_in.rb
@@ -16,7 +16,7 @@ def initialize(options)
           super(options)
           @spi_mode  = options[:spi_mode]  || 0
           @frequency = options[:frequency] || 1000000
-          @bit_order = options[:bit_order] || :lsbfirst
+          @bit_order = options[:bit_order] || :msbfirst
         end
 
         def read
diff --git a/test/components/register/shift_in_test.rb b/test/components/register/shift_in_test.rb
index e8045ed6..646d8397 100644
--- a/test/components/register/shift_in_test.rb
+++ b/test/components/register/shift_in_test.rb
@@ -27,13 +27,13 @@ def test_rising_clock
 
   def test_read
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :lsbfirst
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :msbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :msbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :lsbfirst
     board.stub(:shift_read, mock) do
       new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2)
       new_part.read
       
-      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :msbfirst)
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :lsbfirst)
       new_part.read
     end
     mock.verify
@@ -41,13 +41,13 @@ def test_read
   
   def test_listen
     mock = MiniTest::Mock.new
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :lsbfirst
-    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :msbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: false, bit_order: :msbfirst
+    mock.expect :call, nil, [8, 11, 12, 2], preclock_high: true, bit_order: :lsbfirst
     board.stub(:shift_listen, mock) do
       new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2)
       new_part.listen
       
-      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :msbfirst)
+      new_part = Dino::Components::Register::ShiftIn.new options.merge(bytes: 2, rising_clock: true, bit_order: :lsbfirst)
       new_part.listen
     end
     mock.verify
diff --git a/test/components/register/spi_in_test.rb b/test/components/register/spi_in_test.rb
index e07b96be..199b95f2 100644
--- a/test/components/register/spi_in_test.rb
+++ b/test/components/register/spi_in_test.rb
@@ -6,7 +6,7 @@ def board
   end
 
   def options
-    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :msbfirst, bytes: 2 }
+    { board: board, pin: 9, frequency: 800000, spi_mode: 2, bit_order: :lsbfirst, bytes: 2 }
   end
 
   def part
@@ -17,19 +17,19 @@ def test_defaults
     part = Dino::Components::Register::SPIIn.new board: board, pin: 9
     assert_equal part.frequency, 1000000
     assert_equal part.spi_mode,  0
-    assert_equal part.bit_order, :lsbfirst
+    assert_equal part.bit_order, :msbfirst
     assert_equal part.bytes, 1
   end
   
   def test_options
     assert_equal part.frequency, 800000
     assert_equal part.spi_mode, 2
-    assert_equal part.bit_order, :msbfirst
+    assert_equal part.bit_order, :lsbfirst
     assert_equal part.bytes, 2
   end
 
   def test_read
-    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :msbfirst
+    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :lsbfirst
     board.stub(:spi_transfer, mock) do
       part.read
     end
@@ -37,7 +37,7 @@ def test_read
   end
   
   def test_listen
-    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :msbfirst
+    mock = MiniTest::Mock.new.expect :call, nil, [9], mode: 2, frequency: 800000, read: 2, bit_order: :lsbfirst
     board.stub(:spi_listen, mock) do
       part.listen
     end

From f9282be94950a0199c3dd67025a0d0f5b7cc2a05 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 26 Feb 2023 00:34:34 -0400
Subject: [PATCH 290/296] Finish OneWire tests

---
 HARDWARE.md                                 |   1 +
 lib/dino/components/one_wire/bus.rb         |   2 +-
 lib/dino/components/one_wire/helper.rb      |   7 +-
 test/components/one_wire/bus_test.rb        | 131 ++++++++++++++++++++
 test/components/one_wire/enumerator_test.rb |  26 ++--
 test/components/one_wire/helper_test.rb     |  18 ++-
 test/components/one_wire/slave_test.rb      |   2 -
 7 files changed, 168 insertions(+), 19 deletions(-)
 create mode 100644 test/components/one_wire/bus_test.rb

diff --git a/HARDWARE.md b/HARDWARE.md
index 1c239448..7da24340 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -66,6 +66,7 @@
 | Hardware Serial  | :heart:        | Hardware  | -        | - | For boards with native USB and UARTs
 | Maxim OneWire    | :green_heart:  | Software  | 0.12.0   | `OneWire::Bus` | No overdrive support
 | Infrared Emitter | :green_heart:  | Software  | 0.12.0   | `IREmitter` | Library on Board
+| Infrared Receiver| :red_heart:    | Software  | -        | -           | Doable with existing library
 
 ### Generic Components
 
diff --git a/lib/dino/components/one_wire/bus.rb b/lib/dino/components/one_wire/bus.rb
index 881e37a5..1c9bd2ec 100644
--- a/lib/dino/components/one_wire/bus.rb
+++ b/lib/dino/components/one_wire/bus.rb
@@ -16,7 +16,7 @@ def after_initialize(options = {})
         def read_power_supply
           mutex.synchronize do
             # Without driving low first, results are inconsistent.
-            board.set_pin_mode(self.pin, :out)
+            board.set_pin_mode(self.pin, :output)
             board.digital_write(self.pin, board.low)
             sleep 0.1
 
diff --git a/lib/dino/components/one_wire/helper.rb b/lib/dino/components/one_wire/helper.rb
index b4fcbd29..38df0112 100644
--- a/lib/dino/components/one_wire/helper.rb
+++ b/lib/dino/components/one_wire/helper.rb
@@ -7,6 +7,11 @@ def self.address_to_bytes(address)
         end
 
         def self.crc_check(data)
+          calculated, received = self.calculate_crc(data)
+          calculated == received
+        end
+        
+        def self.calculate_crc(data)
           if data.class == Integer
             bytes = address_to_bytes(data)
           else
@@ -22,7 +27,7 @@ def self.crc_check(data)
               crc = crc | (xor * (2 ** 7))
             end
           end
-          crc == bytes.last
+          [crc, bytes.last]
         end
       end
     end
diff --git a/test/components/one_wire/bus_test.rb b/test/components/one_wire/bus_test.rb
new file mode 100644
index 00000000..0e1c1b54
--- /dev/null
+++ b/test/components/one_wire/bus_test.rb
@@ -0,0 +1,131 @@
+require 'test_helper'
+
+class OneWireBusTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+  
+  def part
+    @part ||= Dino::Components::OneWire::Bus.new(board: board, pin: 1)
+  end
+  
+  def test_read_power_supply_locks_mutex
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    
+    part.mutex.stub(:synchronize, mock) do
+      part.read_power_supply
+    end
+    mock.verify
+  end
+  
+  def test_read_power_supply_sends_board_commands
+    board_mock = MiniTest::Mock.new
+    board_mock.expect(:set_pin_mode, nil, [part.pin, :output])
+    board_mock.expect(:low, 0)
+    board_mock.expect(:digital_write, nil, [part.pin, 0])
+    board_mock.expect(:one_wire_reset, nil, [part.pin, 0])
+    board_mock.expect(:one_wire_write, nil, [part.pin, false, [0xCC, 0xB4]])
+     
+    part.stub(:board, board_mock) do
+      part.read_power_supply
+    end
+    board_mock.verify
+  end
+  
+  def test_sets_parasite_power
+    mock = MiniTest::Mock.new
+    mock.expect(:call, 0, [1])
+    mock.expect(:call, 255, [1])
+    
+    part.stub(:read, mock) do
+      part.read_power_supply
+      assert part.parasite_power
+      
+      part.read_power_supply
+      refute part.parasite_power
+    end
+    mock.verify
+  end
+  
+  def test_device_present_in_mutex
+    mock = MiniTest::Mock.new.expect(:call, nil)
+    
+    part.mutex.stub(:synchronize, mock) do
+      part.device_present
+    end
+    mock.verify
+  end
+  
+  def inject_reading(reading)
+    Thread.new do
+      sleep while !part.callbacks[:read]
+      part.update(reading.to_s)
+    end
+  end
+  
+  def test_set_device_present
+    part
+    mock = MiniTest::Mock.new
+    mock.expect(:call, nil, [1])
+    mock.expect(:call, nil, [1])
+    
+    part.stub(:reset, mock) do
+      # Give 0 for first reading, device present
+      inject_reading(0)
+      assert part.device_present
+      
+      # Give 1 for second reading, no device
+      inject_reading(1)
+      refute part.device_present
+    end
+    mock.verify
+  end
+  
+  def test_pre_callback_filter
+    assert_equal part.pre_callback_filter("255,180,120"), [255, 180, 120]
+    assert_equal part.pre_callback_filter("127"), 127
+  end
+  
+  def reset_test
+    mock = MiniTest::Mock.new
+    mock.expect(:call, [1, true])
+    mock.expect(:call, [1])
+    board.stub(:one_wire_reset, mock) do
+      part.reset(true)
+      part.reset
+    end
+    mock.verify
+  end
+  
+  def _read_test
+    mock = MiniTest::Mock.new.expect(:call, [1, 4])
+    board.stub(:one_wire_read, mock) do
+      part._read(4)
+    end
+    mock.verify
+  end
+  
+  def write
+    mock = MiniTest::Mock.new
+    expect(:call, [1, true, [255, 177, 0x44]])
+    mock = MiniTest::Mock.new.expect(:call, [1, true, [255, 177, 0x44]])
+    mock = MiniTest::Mock.new.expect(:call, [1, true, [255, 177, 0x48]])
+    mock = MiniTest::Mock.new.expect(:call, [1, false, [255, 177, 0x55]])
+    mock = MiniTest::Mock.new.expect(:call, [1, false, [255, 177, 0x44]])
+    
+    board.stub(:one_wire_write, mock) do
+      # Parasite power on and parasite power functions.
+      part.instance_variable_set(:@parasite_power, true)
+      part.write [255, 177, 0x44]
+      part.write [255, 177, 0x48]
+      
+      # Parasite power on and not parasite power functions.
+      part.write [255, 177, 0x55]
+      
+      # Parasite power off and would-be parasite power function.
+      part.instance_variable_set(:@parasite_power, false)
+      part.write [255, 177, 0x44]
+    end
+    mock.verify
+  end
+end
\ No newline at end of file
diff --git a/test/components/one_wire/enumerator_test.rb b/test/components/one_wire/enumerator_test.rb
index 04d69a86..a2d05d6b 100644
--- a/test/components/one_wire/enumerator_test.rb
+++ b/test/components/one_wire/enumerator_test.rb
@@ -1,12 +1,16 @@
 require 'test_helper'
 
-# State machine simulating a bus during address search. Initialize with n for
-# n devices with random (CRC-invalid) addresses. Call #reset before each search.
+# State machine simulating a bus during address search. Initialize with
+# n devices with random addresses. Call #reset before each search.
 class BusSimulator
   def initialize(device_count)
     @devices = []
     device_count.times do
-      @devices << { rom: rand(2**64), in_search: true }
+      rando = rand(2**56)
+      crc = Dino::Components::OneWire::Helper.calculate_crc(rando)[0]
+      crc = crc << 56
+      rando = rando & crc
+      @devices << { rom: rando, in_search: true }
     end
     @devices = @devices.uniq
     @index = -1
@@ -96,7 +100,7 @@ module Dino
   module Components
     module OneWire
 
-      class Bus
+      class BusStub < Bus
         def read_power_supply
           @parasite_power = false
         end
@@ -113,12 +117,6 @@ def _search(branch_mask)
           self.update(result)
         end
       end
-
-      class Helper
-        def self.crc_check(bytes)
-          true
-        end
-      end
     end
   end
 end
@@ -126,11 +124,11 @@ def self.crc_check(bytes)
 class OneWireEnumeratorTest < Minitest::Test
   def test_find_all_addresses
     # This gets slow with large number of devices.
-    bus_sim = BusSimulator.new(100)
+    bus_sim = BusSimulator.new(20)
     board_sim = BoardSimulator.new(bus_sim)
-    bus = Dino::Components::OneWire::Bus.new board: BoardMock.new,
-                                             pin: 1,
-                                             board_sim: board_sim
+    bus = Dino::Components::OneWire::BusStub.new board: BoardMock.new,
+                                                 pin: 1,
+                                                 board_sim: board_sim
     bus.search
 
     found_addresses = bus.found_devices.map { |d| d[:address] }
diff --git a/test/components/one_wire/helper_test.rb b/test/components/one_wire/helper_test.rb
index 152fe234..95e5e3c1 100644
--- a/test/components/one_wire/helper_test.rb
+++ b/test/components/one_wire/helper_test.rb
@@ -1,2 +1,18 @@
 require 'test_helper'
-# Test crc check.
+
+class OneWireHelper < Minitest::Test
+  
+  def test_with_valid_crc
+    assert Dino::Components::OneWire::Helper.crc_check(18086456125349333800)
+    assert Dino::Components::OneWire::Helper.crc_check([121, 117, 144, 185, 6, 165, 43, 26])
+  end
+  
+  def test_with_invalid_crc
+    refute Dino::Components::OneWire::Helper.crc_check(18086456125349333801)
+  end
+  
+  def test_arbitrary_length_read
+    assert Dino::Components::OneWire::Helper.crc_check([181, 1, 75, 70, 127, 255, 11, 16, 163])
+    refute Dino::Components::OneWire::Helper.crc_check([181, 1, 75, 70, 127, 255, 11, 16, 164])
+  end
+end
diff --git a/test/components/one_wire/slave_test.rb b/test/components/one_wire/slave_test.rb
index e8d49d96..e3c4e39d 100644
--- a/test/components/one_wire/slave_test.rb
+++ b/test/components/one_wire/slave_test.rb
@@ -10,8 +10,6 @@ def read(num_bytes)
             data << "," unless data.empty?
             data << "255"
           end
-          self.update(data)
-          self.pre_callback_filter(data)
         end
       end
     end

From 3bc8be4e2973a781db93172cb9b124062c70e7a9 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 26 Feb 2023 12:36:34 -0400
Subject: [PATCH 291/296] Update hook-up diagrams for first 4 examples

---
 examples/01-led/led.fzz                     | Bin 0 -> 2395 bytes
 examples/01-led/led.pdf                     | Bin 0 -> 367270 bytes
 examples/01-led/led.png                     | Bin 69321 -> 0 bytes
 examples/01-led/led.rb                      |   6 ++++--
 examples/02-button/button.fzz               | Bin 0 -> 4005 bytes
 examples/02-button/button.pdf               | Bin 0 -> 446386 bytes
 examples/02-button/button.png               | Bin 55959 -> 0 bytes
 examples/02-button/button.rb                |   5 +++--
 examples/03-potentiometer/potentiometer.fzz | Bin 0 -> 4457 bytes
 examples/03-potentiometer/potentiometer.pdf | Bin 0 -> 457715 bytes
 examples/03-potentiometer/potentiometer.rb  |   2 +-
 examples/04-pwm_led/pwm_led.fzz             | Bin 0 -> 4458 bytes
 examples/04-pwm_led/pwm_led.pdf             | Bin 0 -> 457670 bytes
 examples/04-pwm_led/pwm_led.rb              |   2 +-
 14 files changed, 9 insertions(+), 6 deletions(-)
 create mode 100644 examples/01-led/led.fzz
 create mode 100644 examples/01-led/led.pdf
 delete mode 100644 examples/01-led/led.png
 create mode 100644 examples/02-button/button.fzz
 create mode 100644 examples/02-button/button.pdf
 delete mode 100644 examples/02-button/button.png
 create mode 100644 examples/03-potentiometer/potentiometer.fzz
 create mode 100644 examples/03-potentiometer/potentiometer.pdf
 create mode 100644 examples/04-pwm_led/pwm_led.fzz
 create mode 100644 examples/04-pwm_led/pwm_led.pdf

diff --git a/examples/01-led/led.fzz b/examples/01-led/led.fzz
new file mode 100644
index 0000000000000000000000000000000000000000..d38a69be2c6b9ed449117cd47a2e0d9edce9f29d
GIT binary patch
literal 2395
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
NGynhq5eWbQ001x2iRS<S

literal 0
HcmV?d00001

diff --git a/examples/01-led/led.pdf b/examples/01-led/led.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..7a27201a0378e5f6ef63722751202097cf629fb7
GIT binary patch
literal 367270
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

literal 0
HcmV?d00001

diff --git a/examples/01-led/led.png b/examples/01-led/led.png
deleted file mode 100644
index fa78286253b9635522302bacd44177e7a22685be..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 69321
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
a&%tC5)KeDjYH#2VAaxb(dxdu_pZyQMTloC|

diff --git a/examples/01-led/led.rb b/examples/01-led/led.rb
index 18bf732a..4326141b 100644
--- a/examples/01-led/led.rb
+++ b/examples/01-led/led.rb
@@ -12,8 +12,10 @@
 
 #
 # Create an object for the LED, giving the board, and the pin that the positive
-# leg of your LED is connected to. The longer leg is usually positive.
-# See led.png in this folder for a hook-up diagram. 
+# leg of the LED is connected to. The longer leg is usually positive.
+#
+# See led.pdf in this folder for a hook-up diagram.
+# Use a current limiting resistor with external LEDs to protect them.
 #
 # The on-board LED (marked "L") is internally connected to pin 13 on most Arduinos,
 # and can be used without connecting anything.
diff --git a/examples/02-button/button.fzz b/examples/02-button/button.fzz
new file mode 100644
index 0000000000000000000000000000000000000000..1e630fb9757d8cd7b6421b3543b581f9a910d94d
GIT binary patch
literal 4005
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
L003AI00000@;aay

literal 0
HcmV?d00001

diff --git a/examples/02-button/button.pdf b/examples/02-button/button.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..ef2231f0c475f964d343bc2592a8e47ed535fc1a
GIT binary patch
literal 446386
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
MA$E3){1zks08eujH~;_u

literal 0
HcmV?d00001

diff --git a/examples/02-button/button.png b/examples/02-button/button.png
deleted file mode 100644
index 636bf134cdbc3140d165ed8c3546801ba2a06953..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 55959
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
S_yG+dayON3WLz`)<9`8l8#6xu

diff --git a/examples/02-button/button.rb b/examples/02-button/button.rb
index 06b3816f..e5e75ddd 100644
--- a/examples/02-button/button.rb
+++ b/examples/02-button/button.rb
@@ -13,9 +13,10 @@
 #
 # `pullup: true` tells the board to keep the input pin high (logical 1) when the
 # button is not pressed. Without this (or an external pullup resistor), the pin
-# might float between 0 and 1, giving incorrect readings.
+# might float between 0 and 1, giving incorrect readings. When the button is
+# pressed, it pulls the input pin down to ground (0).
 #
-# See button.png in this folder for a hook-up diagram.
+# See button.pdf in this folder for a hook-up diagram.
 #
 button = Dino::Components::Button.new(board: board, pin: 7, pullup: true)
 
diff --git a/examples/03-potentiometer/potentiometer.fzz b/examples/03-potentiometer/potentiometer.fzz
new file mode 100644
index 0000000000000000000000000000000000000000..14d52e451a776bf4a80e21faaef83295f9b0d12b
GIT binary patch
literal 4457
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

literal 0
HcmV?d00001

diff --git a/examples/03-potentiometer/potentiometer.pdf b/examples/03-potentiometer/potentiometer.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..91c8396543ce7da241ea860071aa822f6643ec28
GIT binary patch
literal 457715
zcmeFY1yo#JvnbdE3+@ntySqCChu|J8I0R_YIKc_hcz^%_f)gM}2=4A0+_iCUAUHIy
z^Zoz#-#c^X&ANAH)_ZHsx`*D)Icrz#l3lxY)jrh>nsN#pJe>UK4BdI%`RF{<+|(|X
z@6g4?(YbUT+?{NwnOV@eWL<46++AG%y4Q4dvG%aCfj_{W09pWd05w1WzzN{_>zns)
zU<VhVoP|3aTTYaho0pH9msgO7myefEkb|3_iJO~=1zl1S-3Dm=hZgU@r|I+FhMG&(
z!rj8j#SWcI)56ZijhYV*p#AR<`2Pcfytliejys$nI+u<NwY#gwpBpu5Zcc7qbS^6k
zY93B*xD+z~_%EZZLv3r}<n|Ygg_|Qam%0nk=HK`c_~-D(aPsc%Hm*QwE;$=d2P+$G
z#aE_(GcEKVcretkd}m|j4kzqk>He1(%Fb~1(YXv9tljOYMTAArxs+@i?CjmC`MBZt
zuN>UnG;LgEU7X*;$phV~h2bo^IJvm$ytlA|E8!nB6<sZS(79gQ0PWyo2>+!BE(HfC
zI9t?Q3Qll|<!r26tZn{i$ITr+P0r}vUyn1r-V(~+_n+e9f8u=3ERT!uoi^k-R}?cd
zEtrrjiYqUKXsecnx%XMI6ozH*OFSpALV=N{rl!m{mR33%W~B<6!N*CUTeX;n*A=7J
zZ2)Y<I%{{K@pkoiY)o8(8u0($ix4fO5RrN4?R)9h_)eGW{libA=r%_;x8+L*U*ZbE
zS|t}rd~=kTVR24b_kO47h4~25VNJiBaOA7DR?iD%Sw&5Rw>7ustw)X$-ip!#=)a3G
zuvyzZS=p#X=<)B}R9iW{It2Dmh=P$-VuW|Twuuy&+K5)sO3!E%TM@jOA9uF~JpV3#
zYs321QhBN~t#DI)cAmVk*WC&5+<p)a&R%RSDqg*uHAwn(7vzW?#qW&szR-oa20}Q6
zkiHdgG9S7c-Xw!pct#0(z~Yb`bO-P3alObGcPper3R3RH%DW}I8+VWCyZHs$SpO|V
zK?h)$BvxP3EN<W=*PCah%;+}cLzVwbiNA<_EH>l*#nxNR_I*H)l@N0xz4Pa^_S|~Y
zFW4!srzwH%4m-<pvib4*!ZKR4m2xkpE&_9=e`DEXeYdTHfg8nmWph_B`uH!HPKu#v
z%j;#m>eCSQSKW>ZEfT(Gi@zUxXw?+%Dw0lkuI7nN=!61g33SW!pM;x#?vC(1ps%`&
zjo8McBGjD`IhL$QMBMZG+#U}qK$-?92NHyurppYU`qHl2PdOM|YG$OY=dNJAr)--?
zAE9%_b$YCsd|Np8Yj$7a2*2bX7cqsd!7{jb@D|wWnA=K>#>at4<=--DMi-l%O>y|o
znY`O8ITWqqIc`EQRs%wv28-<lHQ&bAx`hsnF%0+IGiHRYaru2Ht4ehGpto3f;Tm{F
z=f39fcFME8tI#uIu&#7e9t|_`f#1c&l|F5v-M?I20qUzQXT0)JZpqasgG7__ScS^+
zI@5U2(VMaAn6b*a<@<|Z<pYj{&z{(hd2Q|i$fVL@c_5?-PufU}Zfs|r5raF~>uj_h
zh9mmxbx!)1yJ?ZQFSaLJ&lj=7J}8K_bcWvBSX&XDbGVp_B-zAibF!C4!RGz#h(TzZ
z1AS!RzV;Eh=dUM)WaXD~aq=kEUUWTH*UhehXFYW>u$_buk$WJL@!xug-08_mabua_
zz?iN@N70kdCi5t$eRh3{%9CG9yQX~|WcqGE9F6ns5X@F=<;Y+_PiRIM(y(qO;IOO7
zIfU0H=S^kr_z1Q?X1C)_{$Sx&8*w6a7|B*_<G7+&L%b<l*_$MmTuV_xvW=Tf+ahJ*
zXewP}#%$+Gdf6ptkFye}k8AMOmz70>-*)3j=?wC+Q3n-CEuWk&&2|g5s**j8?~Gj}
z$zd8}sY1$g?KZq2#KPK2D3535b!Z1}xqWFL?Mpe4fvnJLC+&7G+*qT;_~fnQcV7%m
zK<P>*oucRN&u@R@Wi-17sj@1QUwGjkJIB~1p4chWWqwt!DNo_|VV3KSSbyB1JV!@S
ztTTOGr^Zi2$K6>3ta;R!?ymVJL18qno!G*bEIC0T1p&&KbykA0LOlk#+BBu=h;Y43
z4i%Pif8|l`-q$_vi*RXk9I3B0;d0;!=*ff%`JhGIhZ`?05ffKw@R2fsIc)|?jH?FF
zm8e#ZX`Coc*zDd21@7b=pDJ3fP4>n&WGbiZn43!CGS4`a_}_QM7t$eXS%><+QL0q-
zyswi?oXoT!pO<0b_?=bOD~x~b^Z9VTHpvycxM3%rJ>|2`q826Np*CW!BrWN3V-?D#
z(sD4>cAqWNRS^;0bbaCWCy4>M;_c%!qCGzvXYQ;X|Hx&gYpE$v2y>N*_OFBjGL;^W
z`q%IKx6M2HlNu1GY*6gV(=d%Xp2u!6P}puF+F&AQ{L~~jwGVA+ZNT>`e}q&H#?26d
zI<P_(L4t8*8WgibZ)@zpDq&%-E{Lj>dXgIu=OU$~?&JJ$=Y+K*h<RP+FEif=mYF_I
z>!24q9gsACQk7pI6Ee{INo)@Bw3V*qqfj1>CXm^A<FnXXXq7)1k-g2)+7?wQOyC9O
zXsg@Z_-R*}N8?EQ@XfG}?wyI6Po;CEvhvay<B9b9XOAK0X?lz9e$*wuEnbIqPe_il
zXc%9`HJuVpW%p(@AO<%t*!X1&nPQ>KrB%kHz0cn75Y~l(DK91>^r%=iHI{>kV+=Bu
zD!3^~!GcqJIu?o(0Tdrt7{XMpbT3gOg$ccKde+-B4czTbYLYAwF4#TPLru)MDN?~~
zwx2K@@6B9}x>UrY#Bhc8)s11dYVlc?qKt0=eU?5rQ=rK2t{1*+7fC!+H@9Iw7)%$y
z8lc^AC~Ug?w!hOeK%z<@v5-hrJ@41a_<kW`65YmhxY}XnQCr}0lvrwF?MtEWRsnX;
zxaFPijwH2Tw;gW2S<d<5#_8`_AwXg9IjBMAVKP{<Ia;+28%);2Wx7{=uQ~;iNBi?2
z0e`Ui`@vw!?wauL2TYKL;6JgSfn=Ad)q@*ofVf4{%eX>d9cmyPnFUv<2Ma<7CWD}W
zqNE_|Wedd{-zz`a6F>^Je@scl$CB~nn7%fkR4JP%Fv`r!bnBsF6#}j>##{VekSJ0^
zD$gjk#=xF_S<B27KR02naE=qF|IW{BUVb<{c`GK>WxOOdGv$)-mq1F1FHmNV?)R`)
z!vJZh+dDQ2QjH%oH8yNq{8F+WmMEnH&dxaZ57myzn*0Rzsp(qW*bz)Zn~zq#*oX?^
zkL;ZdcwU$GI~nk}=AD4}y@@0EjbQm;iGtB%LiYK&y)7qMX$mi29hw<*`dQ>8A$<gi
z#F{c^tJygp9_bx#mK9pwS-1JZK>)?W?XBwV#m_-#1<azS-m1^PcAK-kPhzTWF?vxY
zvGwwz)5F^D>t)ApXHI{)#M}N*PgfG6=ky+FP_oSoRyU8KOZ2sXL4wFJE5nGuj5yP=
zroPSSzPc1IX8Fe9aE)7=W<ERrox*7gXYy;XvK1}wmTlV`ld+oA7O(2z@5Cx(j66!)
z0n}m~1>a6o+P1x#qJQIU8-;(Id+fvEx{qdrKo>_xTzzkm&DvV!w(|QmR!wjpSd+!u
zAe&__t<SFFlhtzdEmO)5ji&<-o1}4Xvg;4n&P;5^#epnQrUXy24^PT&gI5g6wPD(y
z9jaxZY42}Ug)1|A_r4MdeH3!BX`Ww52G+;PCH&l!Me0n>INCnw_Ujvc&^{)kkfilC
zVo%I^=CE63R8@BNLQz9S;#9p|1*t8!{;MJ$hvW#ZnDGP`<cCXCtA`nT*^~EnRX#oy
zdIW(12DxU5-a_-&YVaX#Db*<OW2W|5>=ueaFsMCeh*iC=b4u{w46jotkC&!iRpJ@B
zJqve|B8A=JMc|Q;6GvNejGqD)X{uj(0L#8p>!qn{WA&NmX)vLO`Wlmn=Ic0qi0Jbl
zo}NZ(;x!C0xc*pnngNz7T1VO&J3BDl%Xdb8y_7+>O@4Av5vg50W39`YXLWj8>4SFS
z-!|Vuq}2TlV1u^tbK)7>jL>LBypfW$HHXS-7PU3LS6bVMx51V?5r;u<o?5MXq;wzE
zk1TViPBa&wg07N1>gNV5AwJ!MC2J6@fZ*qyZ{%q3_e+vs-+miYp5dU$P7_;YU+Qje
zy&6L#50miG+ccg`|8a(|z^*B~Vf+d0y6E2HO?+h7@o0f0yJF-zlIJ6}nEyiO;Od$(
zlwdewthVMA_S{y?ZP=u39C)fnyFF9ZqwK2sGuL};w@6*3F8i68Uq=%nD_MoLeh|^9
z7aN>2IN^QovrrEZcNt3?GncJ8Uo<ZWo^Mp1ei{B5ZU5bkbwyDCi>t#vW;f;*<J=bI
zT(Vi5vgoS0F-Kqnfy7a8__Lt0oTmKMgk)kp{<G=iWQnt^v1@;lkK1oW`(<oCq(bj>
z6#D|W#oUfPPm^#?h21WdVI=AyX6{rg9(UlkTz19-T<5luyMCUxBRN+YpVo?D)tUX-
zCncFRi#tP0Ta&*Tz#o2ufGKW<rxVL|gx~J%c0J6Vv`jW9IMpustI@R8m8}D{xM@Q{
zPp<9iR0;1_Wlj?6tCB7jwyWb7T|9wFrP;^g#Esw4SLe!w`c5B{IW55qH7(y3MnN5h
z>IX@4-uYX3z%jbQl@r~t8)g@qiv+XJNx`6OarL5jrEs2pajo8%_wlC|@9LL{1X87z
zd|J3%52=Ii){nx(lC8iTut^>zR1s{Hsb<U}=VsFY&{pWm4=X#&2(7YpN<D7cEsv)7
zUAVAY6gyv1b$O<~UTkb9%AM8;e0twrM1eouib1Xtc+yLjtVkpa7MMMJQ4lDM{X!~E
z)-9b<`#op?cx@FnMqt<}k@Hq=AljX(%yKtN*(T0M(?;H?ru!#*t8r6m_OZ#8KAte+
z_lIgBFMjgU8c-h&ga)@dWOLo(Lu!OW#!C^WpG*E)xqSX??%4i%uW&mX)F|_&6zRX(
zjJPB7<)LbXH}HuAoiM}9h=m!88;458&^5lx;eLEgh!gxJUKraDf~~IUy76TYkw~=Y
zXNY4i;m4p8cdE=kf+1ez{35!p!*zaP1zr;CClbud`Volg!VK$GTevA7qaa7c1W6_4
z?LY#WSNQ%yS1oXEa~(wM^ZbN9866%a-cR{kk#OV%ftP(*hZ~K6--PFKbaUA`50I(f
zn~Q@KqQ5+mWi)JIxM2!J=W8;U?pp8kLn>@%y27@*S2hic0J=fcQ&+;@fWAo~^fWgh
z=C{V<c?I&yE=LszW0`M!_d>Aq4sgXx@~0eD^fl#lf{r<=Ckk1qFL%|pJj3_M{(?nt
z4dJXEIm9jB&bpnWJ>g#*DtU<YM;B}H^$1NJo^qmc**ll{nc+owOL&`kjnc~jddHC3
z|8P!q4Z)s<Hefe?=bUT72Avkz9;>J)A7^((YD{I65XMa>3Q%gWY+;@J6jDyAwbEQ}
zsb>%STCwRwkbFbpm9u<Esler%_%<R51yrP8l%d|B;o3<ZM)KCh>pmIn>ik-iL9$E9
zW(T=nL?rPYmC7Oy^NCZMxCWZ4|Ajeb55;qSZ-;tsdix{aqzp7Zk_w3A6_1;pH?^ii
z!!+YpLSQHZs`v8S_Pbp4JS}18m<RtV@-?st%9xMhLG!Pi2H7XPo3U^0fhW;n4Q>I(
zi<mxkCsAs~=kxMZQFLN-O2+l?&&Q+bU5y&>uP0<hj?|1{y<dQNNHJKbZM?qw;SU}4
z+~?unz#(Nmn{Iq5PRm(1o8TRFru`+@&CU!0R)K=>yd`w$V)kgh)|ePZRx?73FPS8U
znaS^B(^=FM)~2|O1G1~gx>_9eX*nCzXt}0+?4A2WeR=6`>9YFeSV!#0^mUKgdkKH$
zFZV4C#nJbvWTlO<U$xX}<OiQ`;+D9UxVZe@kzxbQo*Mee)fbp98@YTXU67hTx7oQS
zbejsKNkwb1c{;a_@6$hz=$Wb@Z<iI-1~1WyLRQ_9A_g`Umsf5awgbEpHl<V`W=AbW
zdmW<l_ff*{V5+V8o0-Fn48Y`Mp&n;EA`sUO2|XUJ5Tq?8aLm6wgC9`~?>bnfW)7un
zln{ch7rC6j|NZxZ_6bAdkq~aZJb#bG%qS`B6-0iS<ji2M+LQq|HoQS9|CFR+V4jU%
z=Y_j*Ts7T@+g-3~K|l))Fq#>BZxbI0*_2y$#yO9O%#O+odxEU?35#_vhYY`FbvUD5
zTGC%lx717Xo5Zb$_g(pUOG@^vX#YG5NEE9Mh!(pDt9nh>y>F_I_R-dE)oe&f$w<0N
z&Qlt^)a3%QTip>kZ@|4?2+4oPXTmsjZM58ecGYy9bFEB(GP>MZrK_t>bMuwk8V+p-
zqG}!T-8!Q_Q3#<mH*e<nbX?kivpOsR@xX3PrQ^%`*oqmrblbk<!wn=s4{qRiAi7?~
z5Rjuph5TSLL{H!SFgT$BDmqu8-_i`5(5UIt4&VNnpJPSog+@F|1H>@z&178eXO%sQ
zZjO6fbgyx=`vwmddC#?R;Qy(Tp{ORu+%#PAY-dUQ?#%0%%rbF6l&_jIM?!x~gFK63
z0Kti+-DYY-wb^Ikr_SO5)}hkns0|%KkAur)wHCN$;vr^RKLBAL4N0!QJKk>An0&GR
z`cVU7Mk}0^f<u>zzS)wE+^TNGOz(}(Tp*;e0!ImiWO0a6(5l8n-+z{Zqo{C@{lqfw
z@!ykdG*ONbA9yeU1WOBjs5jM?yl6<z2f}qE1k#w)XBMgJH3gvsex1$U8Em0~WN|hd
zf6*E*s?0Iw`cN;QXy(?K&{~25GQMFrvAZNPj&T5`5|Fd49lgf?9vT2D;&DtA`=VUm
z;VYDdv5A;Tb1c-sW{m*{r#m@9<yW8_hHzfc1?JR611;qDh`nZ2(QWFACY-@l0^E}0
z8ru}R9m}K7;NY|;1ZL{qqF@V9Dn22;QtB{Tr%ZK2YOOv<G7Kp9`AIjrA<0mc6fP+h
zL~>f*ajTN;WNTp=gns-EvJhqlI@KqOuiw}If$Kg+d(xp7BNNuZ;fH&Da&f6ZSq<T&
zVYX;gWGqbtv_gpIE*anI2JSKJ6)G;H#h3=d#|!|uI2VhY8xnct<=E~Ad^3KFqR>0)
zebOp3t`^^bn6z(84a7Kxz+`jrzmoH?o~-*G$qa3eBa61YAQH+iU=v$;C7IqM5duVk
z)QxkTP{~JJO-E{hFjUGZli8c;I*J<<C(D=N6qT1_c!%HwZ9zp%5={d%g1sEf0s#-M
z62O?Kdzz-?d!!X=;EJ65vdd74w=NB1?<2oeD7tX&##diTg<gp-K%0gfvYzq`d+@!)
zD9<iIG=%tb<8X_9DqTK=QmOv@U%eK8dOt#loz4d*>j(Rb8=h3_&tv}Jl7TbArQm3|
zW0X0+lC?nQs`b1w<5-YctRA&)6408=wGEF_K36{EM7_SNLKYKrhzcp(h-h#jroa85
zS;PnLcwJ9BGzsrOfp>gtxPKm{-NYu@(N)~Qm1le__s_9p+Z%k(N`Hs<9eCL3F7Hm2
zzb0}2*x-Q(ni}UkVT+rh2=kGtmdb|!)$7k||7Hvb^0FlC$G9l54Ycj`CtexC2?65P
z1F3;8(|cE7+$(BdynZuev%(eXI91M0{P%!tCxWPZW?g>km8&es`H&w9^;NI_W}~#>
z7ZKt4*PZUg7A=rLfw2+O9?D;==js4QJ*WIbLB<0~(ORI?JmUq%zq_=Sv7QQ>pI>+=
z`?sOPC!Bg^Na}A+?t1)fU#`f0xy?KGKH+9P>EJ0zMhr3g2b+sMroL<|GB0q##2dd5
z3Hc|`$c|(DrCZt5hEkWDC7jJ~pO{FhA-11y30nxq=}&Uq`Ecuzd&)nSl<x0zd$Vp0
z_Leo&kB>gjlID-R*J~mLFFk|IN^cXnA6n?^%|OD#jX-=+1Q=~Y{E-<vdw+0`Go#w4
zVk3;WSPhR6sv&0TLUavg5)jD@p2feq(_E$a3XKqqt=S+=on;NA46l)Aur9$FT4A^l
zP9(^c%0AVL>N3Euzj(g(Ya*2i268}b3%o-b=z<y~v=7K;*@x|Rjj~Lk+-xTmd$vf(
zO{7%zB~iN<UliTpO9Q+_Hppj~#GbvP*7{-HN`KiL&Of^Qb>Ve-#d^a8=MGqQnHaa8
zNyV@4tF_P3j3!*;a4A$M&{-LH&RKye*T&ge8+;^xM7?^|g?gl%GK?@f6O;Lc=$ify
zJ14_?tyRN=P0l|v`F8%2DR{m4t1_`R%U0U-Ue)29*;Hkgs|aH?B;X@ZK{KbB!>Yl0
zxJbapDP|ZIQU@0T`qCv)ndBU^j<jAlKW8|BN-?vXFvJL?k&}T(xCiWc!8O=8e`kJD
zEW2ES_zn>=wvBv3k3n%tYgO>O_0ah-Wwq=*bg8T%JNFO#kC7KY^Wn*{Cw@UQeD|OR
z&c$qMR1weyZzpnp@{Ddgd$~_N5_J!1N@Kch4f&mvmpguqufZ^fF**EdISd|*sQK>q
zT^+E!Cy~J;x@Lxv54Wgy^`&8uwziAw@uI^`_=1e?;rqkN_LVPDbmXg4S)^?f>XYXt
z;N~r{qXhq@2zNSpo#pGZBEzdd1}FEWUq{)i>YSKKkdvXCxL+2Is%HI0BLQ3(liiY?
zM-B)e<KpOMajRbzk{82{@hwVG_b8oQ1JY<@UQl!#ibEEn2pQ1Y7{(K~%l<u!XS;?v
z<hN=-^d=8xk8>{jNmV<v|BB?8MKLO`feTms7Axf^4KoVs<p@x7+3T!ZYBp`97PV+C
zk?+gOI}G)`EkroEC^1l-{d+sM_EMr8`Q;dfS?!ZoB@9a8H=jadPeMY1bMu`U%HRPr
zm)1?hn8j83Kxt83h1BNk1F_7`-ZQvO>4D;j;!lJ}6CCk`HdpL94Dc8*PRtaP=Zl%V
z^OIy3SuFVqdsaSy*a$ldqefQO+{9qh36t9<of~3sdwiv}d>j^?oU7^S+xlk&t8Pg0
z584k|QUKmHU}VT?gt#Qh5)b_ezAAlJ_Q;W>=J>_0ja>#sSYWTCt@7&@KR5>hASN`|
zu<dFEmn(k`h?%@lmG4fo3(<Msjn?B5_;i|UL!-vOLbXF!!)BA!f<3&)zg_nx({N>&
zituXG@cOYvnWgb{R;&K+=eTHaJu(72X;r?+yrG+;1ukSXY3|)Di`}rn7-p50&WA)d
z?!rhx1}VM|rel7U3=P+3&)_KZCk5?WeO|s*^C{wQdPar6D#2f_w2<%$m3}!_qMGnX
z!@IUh+~Dgj9t!9_C4x(>ygW87XcQPAVwHTssVB^&H%<%e<FqGcTi~*O)?Sj9Xg%lk
zT}s&Q;aA=vFYQU<m@ZmiU`A7iPsJm}RL|3A6h-8}M!A}Mi>kPNoLF`iDzQ5{Ckp5J
z1R+Yt8iS7vBq6V=?KeepjV<`SnJ&JBSvd(0bX{|uF~KSHu(f*S)V<(g$cS%9<|6UO
z4#3T?P!_zxlJ6?ooLdh<$DWbF1re1U+2Tw2)~v@7IoQJIBo2xxcPL(OiUIrbF0gIx
zyq8UU%vr`QjD2$?r@R`}z@gjYtQue4=4zocGiseNeZs0-18#m@ct9@_ZxNZ`--Gc;
zJF<lR#-FW$lMYhnyb&o*Yh}!mF(~LtbLjL%5k8khpd>r;YGe4hw{-eUV}g8i17aEC
z>(^#>FW!{BQyTcJbWwLd^B9su$k=0=dL;Kc7k?OBCqd39;d4K|4BxY)ND-zYv!(|6
z(&RQVV-pVXuBS?ptTDPj<>*$38f`&LQLFScCptnKDroP%7Ay0cDZkkwqH0vX1*)LH
zH7dVsefDDM`!`9sO_jf}k=@zIU)Uw~-g6Ney>*jrb7}b$XvEl~Hak`;Axxi0=HF-(
z=NpaB)sQP3m7$fpfrU(9Ex7=v&j(hR`AjMPVS+ADaa84f^#QvDxu0;}JH?)ALDX#g
z@{pu#ojpN$<0X};=HpK<hnONIt(?lObDsrJr$!0Qv+0ocjtbjeSA|4M$Y~hk*}66z
z&Aspu`mj~Onr=}LZrMFg`xIY7frm3s-twx(>{ok<*S?^9q#VKCil9pDmYW>a{l30y
zrxq@(aUZA{s|+IaLcP;`K52^giHmFKQ>^u@*y^h&))=yPGXl-%M=dn&qT|N{<Y}6g
zp`!?CdkUY_V-pIrzHns*r~nhDl@iH9j<^mB@yqAXon~O&j~x>%agZMxR8eBR5*&i~
z62=L!1xWSwF<)CY>NQt8U^x(W3*8n7eVS{3gdpmc4^O8H_h#NZFv>?55raYWsaD>v
z<~n^>x@c|^pGMtlI>m3oQDQ6~MG0&2tJ#ThB@~llw`5MkUeak4wBv4D-{mCr6f=(I
z@vgk40%-_%CPnO(BsdO?-jK)#E{f872k*>BXm=23Bl=)WFlCA_YiBISu#a_7l5_Z{
zC%vWEgu>+)dX#q&lu~0ryUj>eUrtS>J6+ImS5TL_Gm&3VC$P0qdTIPZf5=|y;ysx~
z_Cv}D>u7u7)OX@Q+_+xqckMv!&H1dO=~R1ijT)O&i+S*tN+X{weRL^yt`MOrNJ^0`
z(uS4zgytUK5#*BSe0>n}^)Bj8gCsokdoZm}m`zyH>Mx3BT5}X3rc)jL$R7>_qY$gE
zTzjR%6dHr_Qt?}zW;$2007qB5p_eQlFH>0K7p5l>z|EgLYZ5*wKeq<em0x@eQ;VNZ
zuOY4%&n9kMrYMLFIA3C{%BYUf9dC=ZG1@Ry@?ZM?W>!)J<6!i=oHFeq-w;V+x4rLM
zbHA#Y$@#iFj@!c8&pF&lnK7s#S98b2z1qtNDsjOhiz>u*3r!l|Q=YD;j*MCAFtTqy
z8}7%5m;PuV3u7xd1?bExa89&UzcZfm8%BFtv2w)Q34ZsAr{2(#-rh&ZI+Z7@=5opK
zlPklS;5}XRZ_<xHt{Qu-^j6yf!D1l+W5M1UqamBHn*r2%&m-@ph&ZB(-QNlU`F!Ur
z5HsDebz4&|Ylc&kC61GnAa8aG(6+ope_8d@tvM(m!a?0?g#jh+vyNI<_ohX<XcH&p
z>Sdmph6p9z)sS5(2j5QdmL>&hniMmx7ZRG(Lcax$%Pv>gU1E}GbMETEN2x`Lqf(ZW
z-k&pG(LF@$WqksZiuZy7D8Hh)iht1I>^prAZdh&ufOOm1ijORg&?br9iqG<d^WQPM
z`&r)PM>NoVuT3Tow;Dn6WS303e{GY!Qt-WP;R;QaXx#eKZ}W-e*HrXFrn5@tC>?a9
zAy#xgzpEq|$`S^^Ux%f&SNaKgI};TZzkFTas?OCq%aVT<?Vv&2))~=&_71OoWvM{5
z+n7K3!{UfG8xM!92c+KjUY>GvrtPu&vMl*xMW-TJ8DZ{>AZ?8_e!v;~<kb=Q@y#8@
z215e!Z3_3*ktSM{+?V+G0^`b~Fcvn_BzDJJ3=+i?pYR4{e4rt2))ZOzP)kTncX6G1
zmtW*o@VbXoINcimYt`Poq;&TaG5fuN3A`Bc55^?7VNF}JLO4_xpH*QRJJQoqiOsm`
zl&vD{K|ZVwyecNwMzHIy6lK%t6lvq(7TskI9}Eko@37vv6#@6(^WcpS5E$85ec%CZ
z{l}ryH4(q9ryu2~KfH`=FK1o}4z+UV6>9H_xzf3;$6wmhxy5~}Z)v=n!z4Z1TQPmn
zd?2hVTB<BTVxGd=zbSt|B=HP%SQz%6W#68yk_cDn3msv<YN6HECwem-0+OXGl%Dd;
zQe+`(BVPGk8EQ=}cglBh_mB;(oJ9qh8@J2ZOb{HuNXlTv2=R443E$Vg3X}8Jw+4+4
zWAj5;fx%bWW1iGNs=d)hKB<EXH+>VWFau1ePU=ipzM`6M%DGbE{nHE*=)O~AM6VW$
z^;Adtdt_O#IM3@-6f<+?;eoTyZcl=uGRrG$xb<A0Nj3b5(r)uk>n+a|gzj38PkE}C
zeK;gkC#jtCH^?DZk$pN88mmS+8DHX9QAGAT+bO2pOxu|sPWE$;nD3QSHSLE17S7rn
z(#vgHUL)ZHG%MVFD?A*U=Y<t?Nn7N11&$+1VyV1{0pN!$sgy;&H_;Ec_1V+y+r6ai
z<wh4vF(miR%LIt$%yS;U6)~Pn?)$G#C8o{%Fv|u&DixsYr>216#cau!3k#!limB4e
zfF71BBpT$sGHYZ2cc*t#gXy<D1OOpTTS4?v778T**O6O$VZ~0A6A&a+d~591FysCf
z0B{i>!>!M8r3K`G-CnZAbJW{&19FO!Zm?vRXlk8S06}^3Q0J674Z?jLC;%YIpl!IA
z!u}Qsz?}GXq=gA5Op=>|9MB<9{=F9mqhZP29RNuE>~nymxRm>$a1#;GkT>~J%x4n2
zoST9gAe~mQn2McASF#Pwna2iDzd<ryzSvoost4{?T?D-*8p@xn{R{vE=vXa#qRpuA
zuKu0@0MM0QZZe;o1h;aQCLsXab#{DXC$Ym$xcwynLC>^n-}!oC()*(3c)xGecXsJj
z69LF0YjMaiTnPyHi@+h$52vqkJqx)|0l47_KFdU?OBro10YSYPcQucvw}o6N0L|xg
zB9$0*0)qY=fS~7XGvAIGX4K5l0n~{`=`|ANHT!G`0Nj=$`Nai|x2Na;c}xWsDFN&&
zL4Q&JKrGdM{OUlVu;LkDo!TMQ&bghcH)I_Ea8U61d<APOtN;L{zm1@1EM}Qa{YC}=
zUhpp*n=KBDX2ekfIto`SIKN3$h?xZ;Xcj0pfFhf!QsaPcMS*~zFO1!`-;_&44^P*m
z{9EkwrtlB}1uS|+M#K6hW6rC^SA%H0bug;L9|b&rD#ZR-iuKO|w?AcDe+u111i88Y
zt{)TmUsOK^uUY$33iqeX?N7;?_P=V$c)0(M#bk1_y8oe+>}mdK9e}H%psWBuKtKQ}
z!T$hHO8{BGGX#V`pMPG6$cTR~6eJ`>WK<MX)IaSx8V1_)=jhK-QPHu`(J?UL7b+Sy
z4i+Z%pZh<9{6YVN1^-|^M}7VW;=gu1bpY_5BM2a_AR^ELp5Y-N;vqcs0H^=}1Y|h3
ze;EGfh42g!2^j^>5;_JPpcWU-J|f~XIJ3w|NN{L>cs~FM4;i0^M+SvJ%L0`aM93SQ
zko%nORb?lU_5_rk&(bvn4V{?e1?fu$MkZz!R(=6NAz=|wSvh$HMI~hw9bG+r14E-X
zR@OGQcJ>bM+}u4py}W%sd<+c>j{rwTB_@4NPD%ZemY$bi@U5_@_<KoJbxmzueM4hY
zS9ecuU;n`1(B#zg%<SC!!r}&Gb8CBNcW?jT?EK>Q<<<4g?cE=_5CDk(5bIx({h#E*
zgUj^{J_kssf8;`V<^^wvcu2@JJSg}wTBsHv0$SeS=Y+2kaw|L0==ijuM3$}-=*0B=
z8w_WEMEgs!|D0eU|Bod5mtg-U*CGHD5dl7Vh<E@g04#7XFABi?-|fG3@ZUD@-!|~y
zHt=7!fzp@iNgfpkb+dwkb0qb1RRzRXPzCE0pBG`e@}%rNp8$yT>Gw=mc29s1)|*|(
zNie9ydrjXw{HkgZ&3(y%T_HEnjqQbz+<2rF@!6LwOI49%>rlE^h-rj~kOQ{gc}uY8
zq~Ey0Tr4smz?{3Km8I5ii}v7@pT?nIG{`@ZMi0_88-M<!62e26QxL9a-|}ly=mB>Q
zLh`XZYqv8U7P)C}8HQGu99UKHExBNEDC!8Btjl_zWzB^7Y>RUp2fSA*+86J&acp*|
zG0g#Vayhc~_04bur?ZrAE3oeEbr9LSl|iz`mDkUC7RCJkq8&@3!N%Hz9`pTP-Pwis
z2^Ak+b8r6g)@5k@p|{|-@U=_}h}X7q)Eu>LeP(WdqX>IWQD$}%fF^Jn`2m<wB6upg
z+O6Pw=nb=~cdFoLUoau~GKZ8f#w#r)SzIw0PY~FN$X{BnAUM&+_>P!3WO9K%>RL{<
z@#Xg0SRg%ik{pt&I)i(>15e*x%y|{5`F8xG7Yr@)O!Z0^>a@x@=Tzfw&`n&mw6uJX
zu68#{QB$4vimhvd^VtqNsb2-l8$-<oA3P=0U(;Ih0K)%mP2b(0^0eno>yPZB#pN~g
zwbv<Ev$JRX)g~%OM0j{I>?1t@z#u(>G*NNIMErs|?744t<)IXDt<&3rHE7&E@8uIf
z_nwn8;;}Y%67O+V`QBij67Mmz4a=LU8@iujj@d#YP}^u(5%{gQ*o0!l@Faa*ynIl2
zxgQbm7Ql=M&5C+_ghm`~Krc3~!89{9I0)W+vNO)flVmGWa&>hLU{QV`v7B@VFCR<i
zw&BN4f!Qa3?NZ>c7OLxx9GqSKsK=wT`lD!QJ%qohWpS?i7mB%=W1(Gpt1~T9YeS-Q
zpR!t4@n@CZw3d#}Yl_a`opwp7^};6rRP_)i$c#K2Le<?%48y6xQ!L#VBC*+;B3+@0
zvp3V{Vh5f?4XBFp0m(kqe@1}L5Nb&y|6ewP3Rp)Vj`dCUz1@T0<m8${OPqu&mI7o+
zzfQH3t=U)h>U(YqDc)wX8MCQhBVqmt`Wg#A!X3dA0O<#O3H!bALxk$Z$G4aktjM3?
z7=(=o)<Z)Bv6m`so_|l&_o3_bbP{E|HP(#udQ6Z9nb)B9KLIcUM%FO79*iK(+tpJ?
zeFK)}>AtrE3>+I8kc6wR*Z_pIsJv<b_H5L{_gSg+W+_6ZnIG92(E6ZqCrUd<dmzV;
z-E`)2&(eYV=M+I5?07PCGzP*I<M9h*SKr2;0FF<9kAiKS6K@+UE%*!%1o=YVbe-Y7
zRQkA%MuJbrR-xxHpuZf2uqy@C4xG20x@x#l6U@zbm_0rt>4tvHUrtL|UX`PATNv8H
z9qMR|;n7U|<dxUb-2US5j=Q3_{f4!_ivSvbwRC2XWN}3y)C1FRw}E|PxL3?--^YK1
z3})0c-WtE?2e6m~`R&RRY9jn;rVOc_zeo<uF@N|ux@?%^n|KQj?U(%!*!w-0{W@gB
zFLS(gz?{XJ%AtNJW#9s`xoZN8e*$#Uv|Fg*$lPeyoC)<VV%0tYA_W%0#=`5NsV_|n
zfQ6)!EVxMN%D4knA!|+ND!ixf*F48jFS6wWdILLOOIb(|Tt(gp{kVyj9p{*XNXDYU
zU0T@&n_C(CyWrz*c=;0DFRYgE6B?8%i*5AZuf^2>wB!l@Q_UbhV92~0SaEOY2b}aH
zEl|CZsspB9J(jQ9*DP6+CfZ@#(1x>?(<gklSxMLxxU+#94Ec?Qg9G%m4<_Q~BJc>y
zODCi$PaUg?dY<SbIQ;b({x)bi2qD9rzMf24a_BMp2>{<D{<0NzKc)>asw#&%pF|^*
z@P@XpL6i_XfJ?$p-uD0my;pf9ag$Lu_b_ytCjhd7RFy__9@Hz$-CxM`OlOf{d!=`~
z?@*1)H#R|B>u16@`)<L>iDM%gixxou>b!ul;l#1He1WOMU08YTW!P^n7dK}R{xDXL
z`ZrUG7q~-1O4Kp9N&>fQ_u_$_9zd6t*Zfa_C`zI!jxw&3b)`#x<ef-<u;&nigL46&
zM4w5Aj4~Zhnd?ImUrEK@C?G%^K8tVLE%qg`{gm2nzHPL!b-&~a@-ryze79)!S$oty
zQ$^Lw%kUT@X=}uJ_ltj~{&UiiSHc8Gdrttuxs$*LLevg@bG#>j<yxdZ$tj3ju!*Rz
zI2Mt$J;T2J9oRZVFf~jTl=v-(`jg^D*#9<POmuevpWy|#OK>uR4ZoC=<UDg1oO=S`
zRpip>5~Wb#$Q_1<Gm>J7vCt|jzF@#TUOj(^g=3gMX6M{g-m9D3WNTO6n<cH2$@r35
z5y&-#mTAw612F`NfDHQ5g33sC?}f4MHvY|vc|QRj2oY7rFSF;XAtsX4zSck0&>`M2
z*C@zBpm^SKl!0Ng<WN?-UCYvs&8Rb%v6fTai}JI%#iquF^M+m5Btk;?WtvMpQAR5(
zVDyrlMCA@Zl6jUCR6p>BxhP!R3VL_Fp%DV)Un3~2xbmruwOs`Xd@E68ck9P$&Ua4H
z9tc}wz;n&!OF0jc5-I+lgo<o?Qa231YP;NkH7T5;wx+u3u$`8ABc^04{S;#|aGta>
zqT9e;lxQ_KB7LyAr2bmB2Bql(`%V1D6M$e|))C~tF{-kpTNkx$l$)r;V5DclqR*-l
zB>fij6>m03D)-H;EDVDST5oWZeE)LTt)TlV`$p~(EHFHuOtI}~9p!Cpjb3!(15w}z
zGu%vwynP=Kb0d3Zpm?(Z?Uy|R2J>Vn&mH5RV2y+;RY}?x%#Y;By&X7saqMo9#g-4>
zp(NY&+Sengs%Pt=_3OXD59Z}E9!2pKqwf|y3ZO`K)xq>UD~QcvHbU5hycNUv4eV7c
z6?wIR^Z6T0U`d)~?~*6L##-p9N9lkWStQfcq!JKgz{bJsnRv>VM*0!W0hzudkXi0*
z5c)$L+;o<1nl;Xtj#FLi>_k#FyI~YHKif=W+Fp;+U(>isW8Ig6GuRR?tVED-X1R#H
zv-&$=1T!9^+O~C*zg1Z-$reIgm=ch9Y7*O~k>jTIg*7$E(I4<1^8y6lQPtS>o#K1X
z>1Z(Snz!)LlO?weqX&KJZq$?Y0kJzY+jCTdw$cHRztjK6gU9&5tw~AZC%}Ae!4qJg
zP+)InSE};#AziU+?VgZ7`;j)h^<@w`%<a#vuqzpa&Ybt3Yma7dNr?gn3%sLYefRKj
zsw#$F-oxX&)_bk^ut0KP3u37$xJHTsz&=uS9Jiz$L&Zf_pldE7q~KX9p2$%ZhYSd)
znA<#kAlBLNtX%)Kq^Ng>e1v+>)+d-!|G}e+?$%{%sn?m^CMxWLC=XLlxoa3tcqQsF
zq|BVcPY8P2i^a$x)w75a2@!j4OTx4CE``VJRbrS8Hom+KCear=(r&!vanyCH?(7KB
z-QIR`hc+_kYKB|s;fIzk3{@q-3f<d8WnuV|spi8iDS?MrO0Zx*x{cEtIX|Xv`%*5`
zwdP07O68JE#lLn}&3x<$M$=zoo!1HRy|sxHCjFthUVl^zy}0tK*M-`Jx;tZgL>`ZB
zy}zxW>^q^iU)^~%C3=GHS^Y_{_ys!Pv=}k{<`*QBt)m^a#i;ynk@`$9B7bi#buli^
z&Jd;4nGpMY$tRw?B+HVGaVJh%$T}aP<_RE~e76GM3*sM($^wW2#=Iy|tEN4@i~7lE
zxQ$o%4Tzh({ij}U$UH7*V3HXYe^TWXLh`5>eEDC`cK#>J{=a&H^k@RN3BskNila1$
zi2g4P)uJ<xE@jV@1dize_M<38`cA+8STtAgh#qEDGP<?v+B<`>K&W#3t>SKw)Ct`a
zpop#HjyDMXrW%I6fA4wl1gNh2SmaI6d9Bdhv&vNMTe>2TQFdpVVD<6~wqT@<O|oqG
z$_wx(L{ZVlBJ;RFsNovrK^FI8lfa6YX8NkC2KxS$s9AdDVlRd~aGYa_t%}*fc&zE`
z>F4S&8|fuHB5CoDFfvrg!iy(B*tavXCjh$Y8cam>34j%L<^qdK?QwZvaS6QH_8BEa
z$cMlKpH+#u-I>}I9j)0~)$%s~?Z@HeWwqK@ocrV{!g_k7;>d_OWe5NF`4mph6X31O
z(xJ&?^n=rcO8v|B;98%L?-o@WR><CREta3ZuVxK;PS0MFYZ!vJ`Dp(5HPA^TqP<o>
zjtLqF<~XU?j2LU2{2>J@UI5T>wGnTX)D(xyt>9UOc~*2TG9%t`|KQqmIVM_<Ul@k}
zqQZNrC*3pHS<o*uEqdA1BEfht3{jPHiWWFuUc=3VnEoJWz9<HHc_RzMJKOw48VgwT
z|9H>u=p|)!FF2Z|k=$;VTD`pxV-;iBFa)@3hM~i?gv>u3=$K0t-ok^D5BKl@nJT05
z6ZG=cN^Y8uCP=n=v1DYlm>pH8mg>Fn+b{o39XP8M^Vcvnx(%1dsFxbB1X;6KGq-!n
zC%|BVAIB4*Qdap1Fv;vVQ4D~)qV{~aSK0&QMKS+p8{#F?l{DM}XC0mZBp!qO6)|Wz
z-a3X2f@h14FP$^qIMh!P#j(7EFtDdoiDwkr#wa@FDWa$Bzhv_--{5-TKq(1*Y^%t9
zm+o2r&Gh7)%ZXEaXVtk(t8O5))FS!wI#f3<uRRNW5*i;<8yEqjsh{~xVW2%B;Hb7L
ze;hWvWFp(BBDjDXZc@tol~NXOd>r++#B7_}V^!dKp(NttCznestP4m5`My`SRWtPX
zTW9c*wQ`ooW@ENhc}qf#Hk+K@H=Lg@x)Qt3?jfjsTqJ%*_e>8AW-Mn^k?qyjkE!<t
z+UeIvOIN20JABS7wQezX_P=CIwgH}jRFab38CNMc8UB!8#OD6hIxSta)C<U;*)l)9
zN)w|q`HGpSY->3((jW8x(Nh1fxrSzqg}L>V{CkB5AapInz5X2NabJn?E6k;;D`${@
z$>_6CD!$Ua(6c4MIHeqH&gK=8E4`ashy>-F=2RQm%@wTcj<BJwu@3sU{Bv2MgSSbv
zPnHD<SEdum;P~|D^j^~2`0CBgyEbB|XI7I(XdX&?Mtsd7!7GOI-KO`b8MKdi{sl1#
zj2_Zp&pBslN(^|!)(iElSjU<7>U^ot{O#Qv#!`nXxWgTSEgb)#St&MYI*IMD8LIj@
zu*EHb<vRmUeasW7pgI)`)etUtMg!y`JGjFM@^dWTHwb(SHx+)d(hQ%v{i}f`YdO|=
z8yjJ9BD&&=**kc4Z47&H3fX<c{{?;m+^E5~&9kO;k66mn?#0&G?BX}e^K0`XSJ#4b
zc>FrXLos?26G5y)9U;#LsH0$!hf=*}1d}aZ8%wQJCR6T@cFOJO^@0Yo`yiM1M6>cZ
zWFcjUdE5gV$r_r>h_`EbZOL%^{|f8%46HouQ)Prc0TwkrJ{V!9ez4S_ZC+3%3l=DL
z?p?9MAz*7jD$8{}ird{O`D?#egfexz;Q49KY)w7z<v5zrwTBac80u23IJO3HZM3)P
zv|okWkoNI*co7{*^1-Q?KX^kaBi)M4{lup2LS{mm_UG!-KOd<g-&)qED3e=X>QQ4R
zbuhM@2HKi0WOT1pX>=KLA>RNG{Iw^Clo>Mg8Y`p54)v3llf*0g#)!a+CE?2Gw6s3)
z^`PJA0GP++Un;7d341IbjeU&y^(UbrlNV?K_Zm^Wcve>SoH{1tdCBG7Fx($~eN6Y0
z+I#{mEFMDSdsq50AyNqPn1Wpx%-g1BWYNRkYAxr)2C-HbX1W$FC>I37k7tQeLlRVq
z&1cvZjz#-d^+I#kQw*)OwJmDwbNJ23a&nrgd^`XEuky1XHvQDl7K+lFCqR$jox(@B
zv8<MQH4jw%tn<x?to!b{^zzwgn7&nThxP~bN1?}v!1cIA)b3G!cmhv+<o*O8a!jrJ
zRNEH*i)n$Mv}cgT%ljLK2V)N&udqEJ(V|Y<DnW7<n)>l~Jm4l^O?kYgTu6ShT*!x5
zpLo#O1$&2c$x52Yb!6nd2)l-kG*##tv_G3fYA?l4;R(?7?)nK3J1266xPBVlM(~&f
z!>_>bj_)>KB!dk<mKKiMTxDi>9bFK4Ij=VMfg0?JEA|AV0C2xrF=KwiTK_<>+nptH
zqgwW$2+c}z%)hDV)>JJ%;4$nb#68sS9I3~D&71#A-htsl!L+LicdNhpyd(&nO|grT
za9Z34GRh@8={&kxTDH<_We4z(<)3U&nsUR<XYa87gyKWn?h<IDF(2KrR@L4;ilO#%
z!rfG-=YwvN=`h4NlNYgM6eO-p-pjOT6GstQOM_EM*lv($@CorOqszS7yvK#g`@@>S
zcniX&siShs%9h!@y_bRD#j#~<o!qPPaDAPRo!X*N6HkC}v75#xfLt|13Pxbi{s3(M
zP@IF)X?|nX9-aMLRT3UnYzX*10s0O@X8C>Fao%0O3CMMHvkJ80TUuT+k(*F+VdXJU
zQ~;E+J$p_^9m00U^urC3-Nl9J2ZY8fl0>^p2$@e7F8f6f$lj`J<zLXbw2}v#b`6A?
zdXeMWBi^3pwU%C8KPCol#7asGZh!@}O84J{rN3LW9^(N~)Fi6D>=y=brI!<g44(g7
zoPX6z(rXXj((Z6zXtnpW{r4sT<3HyQuI6}eq`IM*vc~qSN};9KmUZ~7pUT<43@pc3
z#aWh-%H-f6O}b~42kO;TR@ODNwzVcx*Vl*e(N_=ju;wuj+R_IBNa^SN;b#p#XKt`a
zJ9zBESP^)$60iwR#AG+(LnQGcUO`hLitJzN3QNit$cWE9|GuNN_CXmv4<%t(%$bz2
zNffZ&Ze#lLqPxB73DE5?rCHlp*<J~)OZ&6<2;htFy90icC^xc^A+8K560Tz_d^cf(
z8vI8G_jr&OB!wKf5eMT8oPg(nPk_*w(<cB~$zA_Z(V1fRqS_2B7rN9xD@e@UIyySq
zA8`T+U!~XnMc1tGtfZJe@jZZk?lhSY;bC{eyhW<U>&OFoeN{4vNy!cW8HCFu72}eA
z{bOIgE#MR9U}|E?WHWfpT|Q1lAb|S8^v0<40q-XB$Bn9K#NdoOMt^no^Mk}=DfY@!
zJuC9)+KH&xfdkM-Y4YtqXNevGNH;i}@lkJd>sMbu?V=tOZIB9ARb#o78d{=60GOIJ
z_R>zgUkSc)UslYV&Wpj&TA}yr5#90VH`zK9Omlu-fklf4sY0Tc5lNiUZtU;JW+&cM
zH}%Y(|LFY^%tvJVI3CC#Sp+vpmm8~!==R?#uz#5({BR^(^rjhZy%qmvz4reLK@Wb^
z-?RB?LdW7giVw`O9(>`xkca<TNJx^ZIf~4Cn%K_EzC#ayuPh8OIL-XWbTq8htUVB{
zZKNK%5Ov>tR98do5t638$$njf6ZkIBz0I+QlD}m!ffc-CaSqh=j&`AnG~<S5<*ri^
zAEXnPyIiRm$hV|)U11%-UQdW96SyW8VHVgZqmtt@BZ~fc8Bqs6j6Lj;B6`rlj@WR<
zFgoL`cO#sVFWT4FUNu!E=MkS0?R{BI6vw=k0DhsXU=@T`;RoN4tO9yHv+HpBjHfE1
z6V^}BWhqt*e<~HvRW;*beRuAhutsC!%b{m~os%!x@E8Tn4t38)xcRW8H2%9)On%bo
z8pD?j!@92iqg!>|z&Nr=Gaos&D#7$P>W0t*&u;IpJBDn$c4&I*6JXOlu$$rmp6lcp
zol!jj&`Q@}LguZyn($;Zy505(0M5qwjdtnm+hN8(!QZT%=Q#X`zq7c?F+${}v`1(I
zMr2Bq{=o^4Z*NOs=xFd*<PN%ftOY&Po2e;hUG0W&gmQUV1Ug`9jg}52AR8N}Fvvwg
z_~pHvdR~3<JXHidSpPF9MpW!F!<l*ThhX?Ky_&40aMWvF*)lRTmKg0>(rtE*MX>EE
z<>^>|_5uC6{l@**@iT?M4Zss%XeR?6aueNAz)6=pX0Qi53m6h*ERe6cJB=%c%vJoz
zM~F{mMX3wok$3)%!NR%}l%gC}sZaE~77!>YMHqm0lf9lD%`pC8ock_-YQ_?|C3*nU
zRu_A4M`6uVX_zjU7C*LTJ$={l+WczwF+24t?=huCdE;4n*vyvfy`w^Hee1pGV98Ra
z=wiyUoFc7{C8PQ?6XlQyY$;6sOvXd=8Rs%5=O0`y6*fv7$LleJ?B_h_#ZkOQk<<Vb
zWqt&+vb{xtU2v_hnv_OOV|#mh8pm;YImE%XA$guv0i2U!YY6~YCju%O+O2=x(55t=
zkttWswJ{!~nh{QM(Gn=;8|A=eZEXB}Mrl9Sz4a?x)K{QMGnDI&pTG$*uPzFavg5*$
zOk2;!+FwMjnZH;i;sSYudzuT{aj-YPj<5F>9G`zdu89gUc;GqhZNFn^|96H#`Ctq;
z4C6n^<i9hF{DA&7;t5r%uy#CYMEY#3)%CzF(TfsT4BJ?n6l_TH*<+!&M4%1i7q&xv
zYHEsQpM)t#zNvO6VyY~1r}lpB;M+!K*UseRG$qvaZ$y`<$4l_J>pv4Zio}|WbYBWP
zBMG8!<(Bo#h&@S(tsWwYBBaI~u`<$3wv}m+vyR0X{{8Qc!#x5~0#LoHuR_nNyuCV`
z7-pMGTe#j^fJ@l5IE9qy<MilEl1;}th;6in0n#EWY?r=Q2JrR8bwjtIRW$>nHi;)c
zoN&rGGJgF=zU<?WpHE=Grej%jno^vcA3yaR{M{4OGhrPEr?X&BR6irnLBF{r<FBO^
z;YQ+InS;*zCzzqnDh!gssFj*8+T@J>zHDUXM}L#y;OoF9Bhj)-(iUfEt*w{vxi=a9
znvzlmCHF5!*(9}-;-~npu;)|_?vO6MPd6&SFyey=L+|YFyR`_eA2cL9#s?|93&ZsC
zX>w8jgS|I_hPwU#hewet*_RMg_OfNK$Y>FgEMY=SNJ2<uXGY4tWe+h*vL}1i$sR(s
zY}pgZGWKB>|7+ZL_ubw7{h#yy{hsrj^E|)j=^TgoG}p}Mb1m=p>-~Da-q%$mDx@V4
z_9!fup}A0ON6MNZLxYmpkMRORoYaHCYK;41j>zR!5YA?r5>!@%8VfZNc5cu+>`Oan
zWq<U?L8EiK5b;I_484|j+XOVCe;!5!v&4j;OVrXTv5|f*;g{<syn>d$(O6rbdG%75
z`ODQ-wumFsmeNjfohQT8%So+JtacZx339X&^`!RL+{<xw?570NR80XXtEqz$sZ6<!
z%dG0kI^vsSmM8TEJlM-LR|kHCO1p|TMqkxDs|`Uic-s)ekjIf-@vC3l%j>wuk}W7T
z<px%o%Uw^3Vd7sb9g|{__CAz1S=8S0QTCfW@i2TEO<<4Nyi!g~+=bk6FXg3HujuvW
znZC}A*O4AnKI2o<cS~aQ6$^`An`6N3iz71<U$qM17B?B=fAWU^mFP}vt_vslzKg)d
z_#V0i2>xD&e(zZ`Xgw^%v!xCioFoz|NB7tv_l}~i3&q%c^i4vyO0$vlhm5E`<_g|e
z?4A8PhhEm+B_?Aga!@oRmARJ1ozcuk@>O?~M{*gN%+&2U_Z@BKiRV8K_x3liw!RtB
zETpUL=|oWAtk>B&fnY#kGXPkbj-{CEGje)TZS~3>->|t;=AZMu@^c)(={0XFv_NQ9
zcxi;6<qz0M>B61?7<f46)cCO0<bbdDIp<gQwJKQi(41k1wS|I>Dtr4NH&K^So_BwR
zfDqSM_;Y}XEW8E5^3K4{0<OqZigfzMa+4HJ6j4{;&&P<qUa<n^=|&XSarXFN6i24V
z1K}1IwFnM}sxo%QV;T)I0WM!e_kRUppwuj(#|a;XS`0@%7^pywBg!1c7t>ds*)xya
z_@2tsJ*i+K@uZmJR;cssRJAX9HnEGN#lG3x)`XhH$r1?sC8?#sZP6ZE!gp@PHD(u*
zQ3y`~sjL>vs_QO<4z=LagIX`+h5!^6BDy~sN1WijHdX#Uk{gG(5I`4h-<Wi0Ga<9-
zY@bn-mh;)_s7v{BAEPd144w1f(o+|Izt4VF2PfP@U<Fx4<DO$HZlN#AYH{H{G_+}X
zZ*iU?H{_&Gey|<VWVw8*PBhSQE8)jaj;5k32zppq2>aXwRc|<jW^lL1UqB6^N?k<n
z*7g=V5>u@t7pn$Nbt=+tuy>;V)tRc)i~hS1;iwfYQqv(|Mm1g+)R_>ef$a%H)m^WK
zt-vQEGC@o`nb_x;Uz-2c&T~CjBI#@y^DxgtA!`+jQMLd>!$CpaH-ZcpG#ka-c;Pa%
z6a$EEo^>=)A^_u=yWLgr88HMU(NSRWQ;d(+&BUe-<ii5It>}$D!`<LzyO6mv84WA}
zF7fO`w9z@s-|{q}iN3}LZy|WekTo>!uGACMx<Ty`a1UA_7uX_}j-_sf9wc1HBMAIs
z$FZ})$hzW1#E?m>BKr1t6#xSg$&QQpVbe-i&u~NL$m@#$rj8%!Ax?W2;v7kQThQrA
z1oWdH3DqII3whT<8XTBC3t``p2L^thf09(_eJab4ht?7i6fmdvUA2r~?bqUKV4G^h
z?2WELFz+P_LLZuX*?+xb(ymvCrY+x$_|V1V&C26=(b|QYKJ;mO#o_&10U_9Ne<)U8
z$`8Z&Fy?{n^eE@0BvFg_sR6TRwhvT$j;om89*&lIdci|{{vcGE{?!H=JBXlx&1HL^
z2Ie*%#MlwK)aiPLB|etDjV5YuUSy7%BCaFOCvXfXtmeJ_a&exEmsgWM?-iMoVKySi
zHxn*S!^M-Xk8%LP;jM{16t@vuK-E-DI#v>KT@cvzz7Mo-j{=&5-&bi~tP?f)ww49e
zt&e*Es91@FUC5Di5)a)Zl*ld>2*c?Qp;p=;>vm+{>Q@YUzfQFpwF|koOjH;i7{`=g
z2<$DBPIZU4SD_4cM&nG%T2A76LIH`gbmw_5BywW~&Knv`1bqyz_CJPn)%g&47+0<f
zmTG9JnH&5a-aI#dOdI8;(iGX53YQXC)CJ-8RW^w1`+dH$cfg2|!YDp;<+Eeq1Xdjq
z?c<4U6(08sljukng-^=oGTFNG$l;~%A%1t|4^t(YHf{NZ7k$D7>nsh**94z&9Q8qv
z`DAP);FBBBgyVNHxEYA2JUd9-|K7!VdvA>S@4m6_&Mu@BUJtUBcAJ$*^oqcH_@Ar>
zCP+dkX$pQbD=75XPc@0z;$D`O9S73!RMxs^tgaLkgpj>me3+rnrTEi%_8h6aJ(8t|
z&d(1w*Ee&%tEhMvXGspyI+qqy4Gk%yuR<u32)x96<QY`MWn}l5#7fb72Zz$CkHZ(c
zx9<y;XuPfaCTg=!=ftV4$)NG7BR6%aQ$S*#V#fo_ZO$6(NA$sJFDF|EWU5T)bw6$W
z$zG10LAg^!7oFt3sl`dPM;<>Z7&#lGWQp&=FrjYhj3_K`O5#4ccu2f)fgQ3x87g5{
ze>~A_>I;`mxErPIlv3I9L~dK6j;tps$6FlClpt?zT;b%YQd1`=&h3&oyLHiklx45v
z;w#ZNdeOJdM%)~vxZGRm*+&lep3V7ld87Zaylc8QLUovJIVuCtE)G5xKD0MXZ;Z4R
zH8`_o-FoOEC{y(G95p4=oqZi3l7#xAOA?-dv<-yRt)lX&BpFp?Ya$i2!9ypi+#J&y
zAeP7?_ocDe!hpU|a5`Gs*>G;WjFXUpX_CV8Y&a1mlB&P$rQTpK(19e1BHXnJ3D)}I
zhY8ngN!+~?J^8mPtZh?81+G7>&`m2e<T|F>d5`+?K(-TVdKIzNwUz}~^L@lf%tVU$
zKH}57p4GN-5(|{QY#_$0?`C-Bqv~{?{Gw?hpTejJB!T~Y-qOD5@jHJizh+gAdRt&4
z>rq9h`fGc3dl642kg_k>{6QdbxjB6KgFt%ofV?h6{<$ts_*~Pf__U!EDmLP=uq-}v
zN5s$l<NZ4R=)AB@D!>&`KUF)Y%3d1I*V}kTjZAuukd4P4=_yV&9)R?G1dNB@!J~fX
z3L4NO>6`GFO&IY-DU?>-`GHq@2fb%Rq?_|h@EZrg4?OiOih{x77oR4Fnbw~u3L$nC
zJcdows8IRnOzc8@m9ID%U%U9(QLfH*CR#}GDb1DS;?+g`!NbFD9*?8SDfh3@?kU~?
zi=_fsEVro|**z93`%e~2=Zx(QLEDNTz4)6l8vB)_RQba3$B-XXM2Us9!ms_)S~j)M
z^xmzkEfBZPU(eD!CDH30Ug~%0pyat3L$iTRt<5{cSZ`LmFz$@DK;1B6NP9MZ$A7(t
z%W>m4vqE587vbO&-NJ0Q6S);d%R@Sw_j`6B*04uOQhw_dEDM8T?H=9^>3(LHzFm?K
z>|}b-$G;@re#H63?ZHEy5`V}djHDuJ1>M~yT_gF@ryNjf*d?@F{g9-K(p>&AkITge
z8$P_}I1%Rjd{T449`+t2OPN=$8Kkz<lVq?3!BP%46|b3o_bjdXT6mFH7pMygX)3zi
zn8PX~Ug=UB0*%i;cB;oWZ_)4nqTj6sVc+fo)`9RHn@pO9;w=#Ae_cq}yPyhvzW#qf
zHizs6rd((jG6Sup0M0Lx^!!ck-0*fgiAHJ{B1*(E5*tzLGcJfrpC}NaD6CQBwgwb%
zNlPGdeLZ4Ad_~qViK!D_F}CbNwiw9RGavG|SjjwmFSj&8Am^4a<lNGreW!gl#%g?9
z3FVL3RQwLxF+Bu9Zv0dW!5dLnT_>EFeCGRngaKBuVQ|p}#c_^qWb6n1<l;lIutzgF
zH-l%-VeSbEI=wylG+4mgjYNAE^w7<o5;UFEV-f={f>+0|Z#w?0RU?Pk3CRc!V}6Cr
z9+|9Y8yd_aGiSI}v@B0a*cE7E35Ct|&yobS+)+Dj|Nf2*;(C|!g9pxHTJnu=no>pw
zqd$Js6nq}7DR1%<T!G&}{)amXCG?~5k9Q%98vr}bwGfyXNp@Ytx?RZTjxX#I8M^-g
zF@6OUNC2Qvux~M_FIKydyY_3Te<k^0p5*?Jiv;~4Y75&@JLD<v(X~K!Xi?a50K-H8
z40};<DQzESKgOPM`;1dCYE#}0y#tp(;sz$%7A<xmBHAlbq~`o<yO7H>X$<@Rlb-Zv
z#BK)DDg8ZS=jZn`P7H!jL~HDe(d=<7B^nJkHxEy3?ra+Pjg1}r7~LhnloOOL^eh@g
z^)ZMyAfQ6wggY`9ieH_Z0-3%GPChH#Bo=m=qK3)2=N2!511?-`(}>n<rU_>lT^0os
z>kmPX39|jnl|KYM<77P#n@l@n;7gZdpn>6QYe7xX4}YOqU>3zDFu3De1or(TcFbmA
zgHu3dFrN@r{zlFH&sR`ZoA&l@(ABk}uh4l9J^Ytvs;8xJV&eohhIwuMwMh{_c~ivO
zgJI^!YfGZSIwUuZddqK88PdMi_YdV<4K|BTC%ON!YS{7p|4xEpjWEBD3_uNJH{*x-
z-EGwHYyz(zQ;y5ng;*i;K|D|lfBuOq*rQ&z2SW*s-i6enQq=Uv0A&4&Sw_$50XZN0
z1g4Cdz^48lQAG9FWc*7c6E1s8(1amb*}-}L_W6tUFLid59cq<j_kGo@V6HENoNY1w
ze3zi~%8Wc?Oa1-Bq{uV&MAM;a4LaGXLJC7wGH+Y(80FA~6K~4&TXrHyV51yd%#3<G
z@|Km=oVj%@4l^$@T9<xEc@m}()e?t)!*T2BN!-9@6S2zM9)HU{=~~{6vXn_v`+>@y
zl7n1VI3QVSl9Ps+v62r2BIu*<Uhi*XWJ^1Q4ni?)U_$xi`@Ges&R+fj|GZ)A{Uf(3
zp#8%jgaKsYDGUv$40Y2WkUTrlG{zd##1kl6sh3kI@+4L#`P&`E%5wwCnKn+vUmE02
zI)*t8R`qzF9;v8)=0R}}b@j(e0qNi_WU2$+fG$t)&s$&A(S2Jouqd@4e@bGBPjrLF
zr6hjRBGKTHpr!lKSb<yA0Se7u^<mavfrg_dD!8@B((y-aSxrZ7=o|_Raj>a$pB69c
zPPTv7P_chTf0h61grf_uMnO^TESNRt0{~J%;&4xCsILl)kc1UVC~y^IttCPoRVPdk
z_BO<OxQo`tR_3S1OGzzxx1V!nf8DP6<XY`HnljfwtLF|+n+*a+5T^!)5!mzTk;CJS
zh)vNOK<wiX2NX7Bz-4OuSwi{exP|*a*&8>0^0;LHOXHi9LnHVcLQ~LIFj7vU9hyRg
zkR&TV)gHD#lMtZHWrIgA(%l%b<8IH*^{Br><1pO@3Gz3KOa6!_-9TMK)!8e%xlKX`
z3rp~K7E_^YKgv9<hvKf6IE%(Fu+>2n6YUSTQaXrBM;{~v?!gVlOqk_3?)Y*z5E1iw
zUFnt2C0=MUrwC=z&bXl=l-eed74o?V^D)&VZG^^xnW~vN`6J>phzd|#1nA0mgZ__H
z>J?%1R6dR5w_;Pg#<yUz>AOdo&Zx_I@Z1nDOlN!OkOrhoJvE3;Rbl}_2Y<x-s<zvC
zRGDqLmu3HY@GUW?oO+t~BGk7+<BuPud?6BW>ETVr(Il~09PdiPMdAw;*11$!?2l2E
z$b$1d?<FmywYlJTzJ?FH{u;$gqi+x=WSl^`@el%^g%LQ{GV2lKFy0>-_RrT4<b&@2
zLk;Rr@AJ!V3cNb7S|AFFMdGMQQ?Q-;l?CbcV73Ti2<cnzVS7AFT)z*GDisnqw>lHp
z%uyr^cu+S|vV;9*G=^grGLa8meF_8o^cSUFh;~^C#ahZw>9nUJ*}#i90R!Jm1O{Hq
zqTqDFC9+g(kpx-}j+3QgcjYMX{a_waIanDNW0#^_vg|mG_VP7N9UYCiYziy<@osLG
ze`afhF|wG6EEM)y!^#0|ok?_qk1DEOIczg&slr~=BJXA#Fqr!1%I3LMQ9fJnEn``q
z?|2KK9`n{G>pqNtZ$6%jHTugd{Ut-&i;aN^?=S{W2P2KcXU~#-8DO!$<$*^7kLQ%N
zf87%J9L7%6KWP=<8adZUwu;1N*k&{4^j}hv{ad-4z-Py3;7oxWH2}~juXG2};m=8c
zKCy)Y_Cy!3Cn4PHb|AH-wD}gi^ED0(g_Th@Fs%0nmcx<M$j{K#hvO`}kOjMb*!mk2
z$i%-HGt5;m2G5|_D~vceY-pSXDfoSSMUPN^hA;3wdiCH^xgsrUX7+_f*G?)I#_Q2R
zYC|yOuZX^RBx>)|<tts`-trRVjVV_>1Pk%j&1>nli!28}nJ(~Y_ZB|;@NubLAsFKS
z<cG-6L$W3wUWdQ}|BE{g<fLNgMaF>fL#0q$7Rlb>!HqK1Hl?e*y({oneaerCIwvqS
ztxrG)`k_&Ey0FO`s5=A&oPE|Vq)C0v)ZTNZco*^kT5M_xo;)G-1=+(H5|^&Pp2hwq
zzDI7538!CrjKE&-yTAv4XR;TXC?FF%B2IwVX(obR*Sfto;of4vggcHJ9M464zuP}6
zN9L$0h}?gBDT8v%%C;1KcDv620$(f0wHq)Y<v#H7dEo5j<0aPR?5rH1X%iKE+s!H(
zprz>hngw$&G0%7Y62R@ql4zuNA;<S)smVxk#060jhbssD{OlBX{ztg|<hA8cSulJV
zA~p-diNOfzYb}35$+&zUE(Bmd>cGsKfu{bkx}N9X*}vjQMmV(qx0CgcBe+mf6CI$J
ziV8yQ7o~8=;2@+6!Yt@kfH^&K0zxz=b8u5#ILQJ+l1?CO!LbbdhuARTWkLV=zc2n(
zio@6gpq^9623;4e_mxjy-$`VAAMo_qsODii_$@_}1wI<ya(|@$<kbV6kk+m_HRJ<S
z9mN^K&s72>+rJ_8|GCf|lt2JLl%x*gXf}B#B7YKw${s9nG9uC-BO=QHfQVjQgHPoD
zOIFUl17-*1{#{5CnDqBhK>hV68~2OF(WRbiBEzodpk4*hwf$;*3($2V+=N*&82^>W
z-2+^EplccaZvb6z`rlIAJ_!8Z2)baLo4`QKgMIy83nHVz{v6cz8zmI)fAJ1rnIMzF
z#FQi(7!1}IWka}(i+T<8DPX2nd@3=G-Gw}byHuty5~?4H1`^?80w3Q8?bE@5&m*u>
zlh{A?)(UxR_F|^ew;dmzWto9}Wgc~OWZQ+bcb$(yZz#(mxAsA6?vRzh1ySHjG5~dG
zuQOz?kzCKmoH~Y|l3zbs6=!ULUB6mkY)ySE)B0!&Gv&=d=W@%-5HwaFjXN%suu%2#
zhC8hOT7%aLkFGB(e_S+B&rkCkp99pfM+E;VdO=izrPj7I5UknNo?S7@eDk9+^+mqD
zXaAS-oq!jpds~X|EtU$8+wpLruTi6kiG$IN(VD_(pIwr>n1P5R;DyTr6bdE#<;IsU
zmwP&##R_fQTm_3|Su{liqqYA-UE9C#G?I4U-y@aAc!|7VvGD%@sRz=Lg9tLk&W2fV
z>c^~?*{vn**&0&#Uo1?H={Sy%KwKltpMZz~x_PetSA(>L#tAEiuVVto%iS8Ph-L+!
zd!{xW6l852V_G*ut8DWf>WrdK3aq`3^jZ>P^*W)^Cg3#UNnrooH_PMuRjItUK;&rv
zBBp{t&MA5Y*8$E4f<_ODE^tM~pIXlU8ueknk{)|vq-u`l`vbL43QiFV*%TKdS2UOa
zxP78-q`V6mcn-j(#2(nRMb*&)b4*YJ3&y{T6h8!SD&0&VFy)f2{u@xP*bq43ByEuf
z^roUI>O1=)QV%}AMc_0*H4Eb0fF2wy!y2Fm|I-lX&F!2W4|4I^i~edcwZG<T|Bn6u
zF-XoxQ~p@7Aps%>?}JE}Ujv*g&*q70VkGj=7@EoF8Lp-2fx26E9*b;#tX?+La6G-<
zu*_=l83^5F15N`t>@r{q_Eu^qng+E5R(Ba#<G)>DquA~uKl6X{hk6l8U_p@d@Dosc
z5CBST^R?jx&oL7q$XbmY2afd%0B={}hU*RxcCxdfx&v_BBit^8G&#QGPzs#Q9*tds
zYEvbk{v@$KQFlK4Ga_VPcOtN&Hg#88nwKNZSy#-10UB$Pnq*`#Hk<d%|LDi#UY*D>
z`SJ>(=Yt_IL}k6=)@@<|1){{~$b$${H=xeF<tI`Uboi$c)l99<Pn?QW(^{2Bj6cB=
zXvrc=JP=tHjG~_arBF%1V<>$IlxFT;(8B^oV|8mM{JZX%gYRr_t@azV3pl#nO!ulP
zoC$|KlmmBnAI0ZQ<F=wc;S{bco7w7c2uK~)#TF%pwF0dDg;GbS&d;1XcHv|z<hc!G
zy`UZy4%<gC#w+1Q38$yea?GCp%)(Z|)b^cUi#0M{<LmiW{;x7Khke`H?zO!~sm6gJ
z$LdK9@i7iBZ+cht<|o($6O?cD%N-Z+<A}HYEPUWob@F93SX+LeF7GkdFZ{HsFlKT-
z<yYh-wr)i_NWBY@|2c!6Z~SiI(-^x$K#c<oc=ibldQB6vH%a8TyAbKnf7<uIUGeXz
z=6^3+e!o22K)RYdg&>BTWRl|A5w-GIou)3_u^qxST)`BIwV-i)VP=Id-z|p@fm2sr
zE~feB;a#%}u>)+hmFofL=M1qF+o5Uz<2LxV5ZTcLz|P~}RKP+&@0{1+!Z~T-fuPgs
zrTgpaX-UQoP7VmIq)UbePE9IhT(UXM6*X<BbpM{FF5{EA{DL41LuuEO)Kh)cic{JO
zvl^e*gTpvoV;)s1yg%wE!)2^tZ7pPMY^+Ji8cK$c{TQsK)6l+#%|zU!TfY7G%rTtR
z`&8|YZ^;k1V(?dOpS&ECsi2$5z1WE_;<0>j32vFjR|gg>m`Hv|J7@P~O<dD7kCK<q
znX%)7*rhlht3$0AnZ}jS?<}`&20dzj|DHy<DdN^G8XnCZ^}X20lAzWj-+`**j!OvG
z$aP});img6U;gw0)y`nyQ7%fMPfApspE^nudfFz~ZZbYYO@NiK=ZS29CsJWf9sa`;
zF_DR%l>5b(Gym{J)09f#RV;|sLsr+x`c87-0w?P`&yoX|e6qfi0|YKW-$_P{!Wgv;
zfV5_2fqlxqpo?p9_CfjVITd&343IOi>|9!O|M}irRKp`iB0KPjPXJ7G`9wXd#=Zln
zN(M^Ux{*4G6-pdXC!Av1g>)N3aaT}VW)Sbwco?aRBtm?R6uFMmsdt6l?R&E(Sae#<
z$?D)y<+W4Px9p>0{4`JGa19xd(g<{*Go=Z_IG>5CWF0P(8wAzQ%R(U+va}yOc-?X<
zd-nFJW95me#*|UZG9~$yl%iJj^JDFJe!x$25F={2)L*zGg)93c8}I+%uAZan%)OTz
z-U7WZB=p32-+8ek@va`w{;d6-$(yP;jZRIRF?L#THj;h_z@3-5%_?9`)bZ9b5loX-
zx717eybtBxNKR~+TibuTw|!0EY{{c2%kXVxRSQsTazY_)rwA~Oyu@tGEd&>`g{1gc
zZN(wKSYlnpCnEjUvPAffuVT<>+|{qQY1`WJWHNcoxT>2m-n$Un$e|w>h*>I!?D?1m
zj+R;1`X@CnUB8l_G5W;fP!FWdO+euums|EN5&O3=e<*A9eiv-+6g<dV%I9oG|5m_;
zQp$-bd!yTa#z*5`-VQ6uWfRimiMx9619b?b0l03+zk(2iU+I5f*zWA_&LVTA?8M)~
z5c&UIUMBr-*B-w`f&nxIp5{!*zpAI+L{4(ncUVokH7+vNo6sNdF-25qX;7$xZ2ope
zjAik`Y2D5Rw#AFL=S25|%HZU206v3BillyX*6L4r-W`f{!!_}xxnpgYO@|uje~9W2
zo{rX$h-13nBJu=oO)PyQw&_De6J+r+1gW=JwEtcI*XY}d?P8N}q-Kv&ze~g_ei-CZ
zhV0AnH#FqUhp@L2Jg`EuP0&ZRve-_vP>CW*;8Q_Km8~RKJX^e%TQFT5{rLckXo^#v
z6mQ65N=ZyZ*(|e?K4Msxt3{^Tp+$BI=<1N`t@d6xnq!hj?;pU8P*X$vxUP%kicaNj
zDQylC!yjTs;FCP=_l?&bpp8bWd6mKyS!%LPuiDHMmrn*Hv_^5-`)i(5co(4_PK7)S
zyfgw#HWqJ(40rhE$J7R0#i`}SG2W`)hjmVl(anw=8j{JKx1+8&Z*%lc#@!Mkln$~d
zUEJPRwLIiBeGy&Uwa7Th$R(H{UH4*Muhm^*GQu{a<ZjCYZt-XOUHjY81#iAR7VG<d
z|5jT_emclx^7lx%98#Gd-ua`FpghhxU`j;y!`wVDf=B%r4j%1Kf=t3}(Z2DplCAe$
zOzxa|eUc@~4xXX|i)G#7MW&iZvgMo#gBV^+o3&SHNltLl(8Cy!%E&HIZ<Oeb96P*H
z8!;?dB5}0#y8lN-y>|NUKy^(Ew{V=$bupG`!KktUbweWYjmUJ@!pbD$u-1F-$UuVe
z%kMi+;GZMysn$&DhXZ0NHD1XKU!Ci662@7!3oGWt-dm|khamTLBVLmiryq^Gm+og~
zg8T}nagW>z6C*<=sObOLb8F^FR5e6WA-sx)lJ(u}e%K}OUP|M-++md$E0@2`*9l*$
z2pDf@r|fAw>|_x2=7<3M2YNkUL6-b5CdN*nWO2V>v@#ncv7W-H)#s98wD8uivw3Jq
zQg}Ec`R*N1ysCNX2t>z@Xahd>E~-w!0cM@T59M^Pq_bZR8u;`ygm#ZfZ@9opACMRu
zC73Qi`I5J43~`+p53`62L>E!zH{h;mS0r4o30&CnY))51`#5txyP^J+9Z1b6F9z|n
zhn0QPwIBSW)TdyN$<cX&*^9JjiHCo?0P-8;b^hP{*}oaHM+*F!UV=A|V=rRDrQMe|
zjjOO>;djePlzq2?Eklm8cVzUQZPeHJcv)7i`TM<R^^J+TSHIzfL8&L;G5r1k;szFl
zkesA(42L*L0XaCPvcixm5&onyaxg!mywVh$4pAB|Ve~LcmA)wG;$tqzDXzPYNBLlX
zqEPA~81_Oqcb5V2t&8oFgTou)-f9UKXIsI-Kzn2Djy$zbsfJ<qH4+ainFXG=-$=y(
z5%EOOm_#q(G~U|Gc<hUZ;+b7YpyYx$tCb>Jrk$$pitl;S{FqVuP48!&8q^#0zA7r<
zj%!JSD#FAhB-b1_<CCx4u9?%3r7e>AN8VNRrad`-<UC~iR!kQ}>v`IxVa2$Igleov
zixU??1{W+6`cR7XhlyLTq_FIldFIj6NgGLqag8&<tYRN>I*T0P0^bf`3{ew#&_YxY
z%3dnKoVOb54ISna!Df7|HGDkUbT`3ufP&+$oUhcgd^T}KjnKDRThG!8I-F>b^(ZcH
zdmv+#>6(lTKUPsOTDZJk@euD^s>R!Tl|^v!s^ZDk_gsSeDDceq!vyb2VkYV~iq3tE
z)I6fyCm-}$E7!||uCb^=`Khe%lHv8{8^;B+ZYnA$LUlph9Yvx9$}Kr$Cm$<T>jqs_
z3dbkn8*87rEtwC!I)!D&q=RqWOVl0NH!C6xYGGmfVRk9pT@C0`>c()8t|}{h`*!7O
zrjvt%(_tWqj$SgnsCEM+7a(Bo461vEbLi6b%`HSJx{1p{N{)Exvks?S$DvXGFYx$s
z4JRQn!D|;gjugJFgI^-=xZ-!nWAq;^#D8KS@DE4_9aeInRHRQTN3mwzB@t3Q-+##G
zmgtwPnhkA7i(hVYJ#kp5(pB=b^ig`6;R$F?EP&_82f(8KBgt302nKwSaJ_g%q*><x
zPG!)v9p?Y=`?BM=kngwde67B-vcLI&m374M>C>mJ-(B-PX*zl0FFZ}G290eA=VPYe
z3-Z{d9j|b1(_D$OC5aYqD>O~I9fYHY1ylAHUy!}Prq32*&mJd8D-b2S6o&&}O4&rL
zeL;Mx?BMef7bPizg@p(QzsU%H6}4{L$If}2NeC1W2+`JBi95#$HVdEz4?)2_azxo@
z*=`vPeCGU=(Nx+|ohz=$d?r9$UH^g@sP(#cj#8H@>Cft9m@;gl8g+m_MgyzfsO7#G
zedjfbVO&W|B;`y|P19S08HE>GH60DN4WK8XQr|X^Pf>O5B-zF!xStB2Y5UzZExA;F
zOjwgh3T;kJO(7hge4}Oz9{*7Tse5U;V+R5hucU(psA(2u5Di=TbdjQr;WLNGpF)SZ
zW5&|bfE2`8d7Z6^FL%i*t9VT#e5_Rd4$JA6Y9ry@5|t{79M(}my8KqE(3fn#r1{8y
zgPa>sVGW1s5@Rs8l}5cT@+hn2nyaOMzg9vgXB6|HK;X*!N9uMq{kRVn-#onH5?s9c
zJ*XGk@#0N*1gYyx!jm2^Qwht{>3wouRWTwl_HKNtl1yK7n^zk(8A~qT5Rd`2FU=B&
z&8N8FDaOOLD*Tw0<!~wQb7{l!0g2gP?A>I{Z9jkPRXRtXH!~ep+PI*np>OkaT5^a8
z2g7|GIl_%ubi-B|m#k<e{b(9veW$Z{NWInXu>8R{<~IKEr{Xvi&ha!G96fyTZuCda
zH3^IbA}o8VI2{_GB9FgWh39-Gm#v+dh`GI7GTpkm)|HHDA6au8=|H{&lT#XF*^U{+
zPjpNUG?f#CRm75%YP4@grQCg~#?PZ)7ov2@+{i|i!Zz{#JUBb)`(^Uh3VtK*0++Fw
zi-}a5&nx{#amfvzlj2`HO0rxZp1hUXf8|7Bb_9%nm_AqT$-Ag>D(j2H`von_IPtB>
zk!D!g1}W*Y-w28MEPwlD7LVlGKHfvKiD8E@D_g}!h#zO4Ll|Sp@uS#(N(oHlBgav7
ziYj8m-e$xQ0+riciI>TjdSlL4mWO<|vG)*v@9XgllCH_Eu23(-Vf{5s8nSglG;jH^
zd$|sl@rjF>o6$SGaNJAd4wM%xzQ^O_#Q;sHonME){=KxA2nsn0oHjWHGD0AyKrrMK
z$WU&l{R>>x3itFhV^bt6u5!Lbr)R19TCUmrn(=iSwT$#HS5`~(JPHI;O%hI2jgCO9
zpM6dB{6jUAe%wYY+vIxZ*QfE<!fx@YDO7urXo%AzQh=i<v}rKKv%QPpF{2&Va(O0-
zQs_Xo9(yn7AVtSMD|9)ULXgn{WcZ)&kRBtYys!1B93-3^@HTzZ@%6h2Rq|+8pqhtk
zWW4BBQFipD;h>CwSr=Yyl#0QgrW`&1#j5G-8^Tp>_GzF0rWKo9zr+45^G>0Rf3%VG
zFthMEA@8be1`6tX*PicV{IIdnLSWWuaYZr{O9pf*BWAv>T=n<J7?!)7VHI};e(QrK
zrBs6b(GQeMC#3x}AVl{)2C@KFI#z*~_vYzdN6_8)Vw-w&rLp(D{NblgMJ4{%x}<9-
ztWuKhfNdp)U!SKvbqRU{-hswmLl4$2Z@$Ng*%BY|X0Igp+jw=zc11lkzxX|Pkz!2X
z($hR~-oD8fhF?OK-tS-a(jaCb1?Dgu@D^wH=_XnC_v%iRNj0C-CHnh6o)p)lXO+vS
zo-;h^PpR*y9mT&m3@I4w8l>Kg2b$k(;xjoY^XLu19b%e;)D2pH*RlEov#_d*9}7#a
zS)SDMUQBFz3KLZ3#Zwb*uM7mG^(@qKxp&efKb?W<_6qjq2Q=C!Wxiu>45Yos74YrY
zC1YRMn_bA;mW4vjg-7_awzX_tq4uMe#;^KZLaR`+trb-<ca-)=yS}nLqUu}q<XoGW
zEG=Y{mO##Hgt!CILcwCyipW(wVx+b=PbK%8hq?K9S<aY;duwMG?Dhg-<iVroj9)wn
zis1dh-shpL7za!+_p?$C%W=4a_|b$8#!Wd>nCvMi>ce=LchyRKvj%l&H%QNHWfEAx
z9yRVNJcnSD1&!gVjE4wiJACE$0Q+_DEXVL<B%#VxlW`}N9pmzt@%yX^*ji#Sa*&fm
zJCaSH>#2rKNb#9o$Z;2L*0c;YHcT>uYXyH63J_R}jsMIN`Q&<IPH`FU=Tk2r&|Een
zsfL1}VQ3SE(zaF*JC@;)JC{_=@1^yQW`zH%-@#L$PBvEz($?1Yo=J81PrBwrZDH=P
zyO%~~pVU(R!d-C-uh8V=V9LEMQojC`t`z)46(ZJ(vO$lC)Wb@p8ljxuQ)w#CbOui<
znaNzs%e!XU;wAs(fl}ksjwAP_o?5OBJ%e;Y9rg4z&)Na#Hw$_VNO-mWl<;<k{B{K-
zBR&6gRexnN{|m3rnr@ya7I=fyHQ}lmO4YjRZ516u{;Q8O4jUThI(x$wqV8YTpb*uZ
zj7#BJcA`PmxsiCsaGqn@UUek7UKgX$*^xmy`;k93RTKYvQ#F+M91ugm?8b2tsV`PI
z>(7)2B6;RKBmJi_Lo7eG+%C&g`erU0owB03`LytaAWH=;jqV$R7OdIdWGS^eHgqbr
z0INRb>OVC~>jVyhkYZV-ugcLXA#`gN#)UanMfIKh647u<9$$>5-t@&{7D3e6-jvFM
z!QW1Hd-gR#m1U~=CWX6*>eW`bfPf&AVQi61Az^=k4u}@)3%E#tN<f=n<NAw*)>YIt
zQ#>QdRDvrPvoW9&#Pjm<WEzyr`h8*UcM8I5=}~nKNDlX<;ZxP7w)yTHg!8K(d+LY7
zgDiym!-XDQ$@}<3!GuyTfG2{j+-n!YXhTF}<^bv1#+L!Ioa+?p*4_<(p@k7k)<N}f
z!bCv&3)`g3xM@(eYa(BpKuJI56UN}G>HaYypP_$@-}`GDCv97_!z$x29f>aE#oXs!
zV{aL3e`hf=M)PoAY2V4~i<+!=qZ)X&i}HfM-BeO-jTKZp0XtpGPf+_zl5ii_Ul9qG
z7fV5y_J5Nd9ql}4%LDe-egCIm#n2GEI3V#eP5<-vLl`Ym9G5WR6bWvU4R^t`Px<WB
zA#u!5L0*RRhfqNWw!+koBT-7tD{qhUYs}Tf1u1U;GW`K|nnc$%sYFzk3azG|k`SJ!
z(=w2;<-9j9J@(~b;RE4T@5hw4bxlrfT{cA6E3u7X3BU>Yt-9au)ufp~QQCX@6Fz->
z?cjPRZ?Yue&Z=p<e}=5&l$Inef(<gR0AG^{fehn9S2#^^rPDrIjj4itZ(Mww;Lp0;
z+)nenx(fmO>>8?q4OUL%_ye?T+5Ptxd+du)3e?04C@0EBLQ1EHaCVw*yZY>F89E<M
z{icm4%rrA8Y5sz(<q?`TiO)?-tcQ&(-7Eq_yH%kmcUBVJ$dm+3BT88t`$MgN`D0Uh
zvR2<r?~ChYZ`fM+uWC7dadU$B9q9JEIzWIe04@&b>f6z~kP5N2)DQ?+P!LE&?+A`>
z1H8N?<cwfPO;o0;tcWH-58_N4YB|bNKQ(+CZ57V+ploqlPDhPiJV|T8C&HzFb;30=
zP&DmOS1^jDbUe&lxnEgl%HgsP!t8UVBBz_aFMXIh<b-clNZN^)zF9drX`&Dd@X+iw
z>OknHlsi1n?bA;#Wp8zMc;F-ks%f+8qPqM1^71GskN8orn}k5{krQYFr(z2q-6!*|
z<}vPGZ|8fDw-i5pIV3z8Y;$|<{KXX*6}ziC-@XU$qU`}S97tj$KgmPXmJkq}s6qjU
z4R98yCw&Gg6!btUA{GVaH#L#P3J7S_cOmzIegaGlkQZSjK-V=RN$gN!t2zOOMRg0q
za0dUikHMqy?8w0+k;N43^B+6jMmy#O)=H-Hl_#t4SB9;eoJ5P+&bJHNaa|X^v8<~Z
zUbrAnAbNA*rl-1wel)jENgep%X2S92X-!3v5Zu`Eu49D87a5HT+7UAi`kaP1N@SEb
z;3fSganPnR1qBpSiH}yjXR)=URNhO)N<=%8@QveZ)8j{7n1g19X>VVMKS8m@%f5yt
zoJDUUcOfr!K_*7jGhr7ZFhBtWU3B)?s`v4coR1gfBYEu((Q2`_(Aj=I7UpkqS}^hA
zi?~b6@f_DGE={;OKz3L+-w-oOoQ4!9UT079n#0O?%-#-u|9<9zWXAnj8Ws+MaS*+c
zoGa~!E4m(a*u7YHWjWMEn+*3rDS^2bxs-scBCd`sRn?2Pyq89i3VE}<nL>O+aKW47
zUbb9Yd6Vh%P%bE=tk*$8g1@xvZGdK~Wk?o9R1w~LNUKf%R8&g59No8ve*ml+Bp5@G
zND6^jqM6KvGB5-|KK6cDp{2mHtpTzMU&L25ORKX_={6o`cuY@oeMp%DOmo9-%tRG}
zZnj4Pp^Gh#bZ{DDvw!BWxF`~E{Brnww0u3M?hr-Dae<WFo?1&{1!f{QX?77lc~-qH
zi7(K8a-7P%gXfAP<FGvMIm^UXkzPI@4C4Gh-r;(z9w{Fef{vQ|J3Zn_3<NTqWj18f
z8RD>sX(W?7+(1}sl))>8-T~YlwiVo+yP;J{pz8j8MhZGbC1{)!^wDkXg)azqk*2aS
zL8i7=E6TF9!NhY;#}BnWyqCAn(dlU1mqGZjBGL@ZYJKD=25TVUwfO;C8#6hocnMu+
z&h2+hIR9p4=E&9JheEFEZcI&OY&v3h1r?W>Ux^QeTW$lD#vVoVCUBCo(LVC=I6Fal
z>W3*W%%BommT#ZiV1pD=D0gy_xm>6<qkP}vuCCbKhj&>6uKAsw7u~<ryJ<^ITZavM
zO^k(45oxFTdq`}YWrbI)9V8d{6Z3Bg8J1t_2#YhDH|%3~5veYyLktyf=C5EDQl`F_
zIvud9?^=8*h$&7LO6}DPKXOV_4>O@vL;E3TiG9Gi>pNo|8YfX+kKrA8g%mITOrY`R
z_pr9LaJbxlFUGDp`hBgv?6E`fkJu~%uCl$Q9+D&PleCE%!jnKx6JE?C2$AM`D{CaW
z;0e^h5rnZftlI^~X?Hn8VtMJ)plw=-U|yQy@>iPUs@<`n_u!48tA&uw0-R{Vq8sOe
zKOXjFULn7#N#&S~Z4#TUIKPICbfKcPU?*;3`}*WzPWPy?U`58pkoj5}Z^sq*BGt5q
zxB4{i?b#cjg@TW+Wf+88g;Tc$b5mV3*R0Q?N_@83nEJPLO9|nJC_zMk8d@gJY@A4A
zW&EQDD$48rk4Hu=%-|jV4Qi6z0*hn$C1r5xq#ev8oWN<?Qp>}9VQQJy-K|LhYn;b#
zdRnkoa`yRMzK4<c!3b6Fmlq#D*r(t>jN}2CyGyXiT?l$Z6SF!8q~MpyuO5?vfk~@R
z|7qm$_!b1#e4N>iTiJFJ9cUsMl|}PddH8j<WICN%Y0=A5J^Kz9>hpL&j`LhShll}H
zl9&<3Dd?hJPGYsi6i;&1;h8mul6NrY%weV;_T#jKjM&R_f<8U$M>$UwNP~L-yugHS
z3KA5V>`Bma*KcFU2}R$>=up@eHPDC56Ay!cYA?x{q5_0sd%A0}b<3ZZSpQIBi|z+L
z38;zwNB@Y;VTRI4G)^ms&E!vx@?J`GjI?*!@01(CYXxi<S&hEj6pf#Y(i8}YaFVya
zb={c%DGlA?CCGM92wsbH#1QPn6+kWmg8~5ep#;?sQY*0w`P4)%!Q8)$+UD?8k$6c~
zV+FE%14{Nq=wug(8c4`iC7{@;f>6}DG`WWDJ${^|mc|%r*BtX|)P5(wG(5btX>nsA
zo2sUoIZ-I}(lJBkOIp%`V542(+9e!-h?E>Fj<3qm*f>y6S}A)>rzreHo5L0Dl##9N
zfbrWWpEVOll9gP;$4yBeFj#Fe%dOT?R$xul5~OUwCamyzV}JaU>N`br?&__y(fN<p
zE_1*Ek;U&T1~>(bh1c?6<RmiNcIvd;5W#**EH>E)PxYy?y!d)-o>Axtr3=zw)s5|(
zA3BcH_V5dauUnG^!O0jb!ojZ7$7a&;d4kb0%AO(ff&AO2T$Ul1O0JJ4WEtJbfTYrd
z7k(P}&W@Bp)tRWsHm!ti_6<yzMi1LF9=rezbeI7)-{y{1^^`WzSkgL0QIyt@lMDZm
zV$JX;-25N<o38+Wh``zl);f9^Q-@^gM?1!4n=21wmqrdBD-X~LKGs%Lv>nPE>G@U+
zbFcL<tV$ji2d2UMmD?#`cfyv*(Qn!JB_v)~y?d)JUA2_@t;gP-m6m2ZBVNAqq~fio
z6at%I1IT|wc_RC2nTY_UO%(0G8!B#Lx9SlKC^ozMYHs$Zd^0uKA={7o*Y)yUi#&P-
z;t~ag0CVbgSnNzyj;|XAs|Uj!Z-f@H*-v&+wPw!4SYFX6*p!E?4m8Z&YZYJ7$Ujo_
zwoXIPNdKS*+Y5t))qQzCxSN2=#vWv`D=Ww<n<Ys{M<K8)LeyY!RTYbIVz6Kgxt`>=
zoBTiA@9`fG_W$rUcy%%Y^c%wACy|eAUg63w_Ex*uWDfhJid9IyD(?GsufeKAMNspk
zZ#MChtCI2avZ*F=St9n@6g5E-`k2JAf*67oV<v@r97=VHwrkyns^{Xhld)BWRb0ce
z5q^~@f$?>~8!AVldLsY$^HzEr{H&|way}ACa0XvKHs-CcG8;;e$RsG10cnsbrlu#q
zU`f8&-TeA3_h=jcoB9St0iuG`Ts$pf;G?!hHlKoK(F8a#t6D4z=hnzwi?*3`xVkjF
zX$IBqo$_NAJlOWQ^Vk~`nUA;bjNJ}@b+G9Ho2fGQA2?_K?$Eyv%-K7ehJ0d<jDn1`
z+|MI(q@{m3Gsnu}=t)VLlYjm@N-K5Y+&?d<sQlGV=J$4rC#AtzJc_5}ezyDN!Y}P)
ze{U!Md%IsQ{L)VDU+v^h|Iza2_sRc#;g@#uzqdOnD=n)i1K#|z-7gn@X{YdeJL%u=
z^Op<1v?Ct~MDAr}Wm>7d{*?W_-7gn@Y4`Iyqrck8{XP!AT==EkuV)_pF@EwVPoFv|
zds^n_^U3^u;qP`b<dcei-lu`bJ?o=V*L5uItgRk`lZ{*~AMRbzbg;0orj>%*-g<cF
zsI>GcS}6@{Tbnx%kIG9c(n_7TefU7v`u+tchkH(r){YO4g8#qZbl2(rwR;v;;PWn8
zyV_b=tKYZq`0IQm8S-oc$0c2|z5CGm{!yt*cP$=T|LcS#_veeFs4KB9N2sw<Fu_O6
zQzt{>)79ep#XmE0U2QimX6fL1O?-bN%+9fsw(T>E2}f{AMqd8y{Gyr28{H<l9S^f-
z8uKq@#2Q_Dm3EJT{)sT3chzi#Qbg74_SjadmkPAe3$u&ya&YTfs)fOz$1Z8<XTnVM
zt{Ixg^0cVOd-qEbZSy;<q+8x7AG=UQyzN;sp~#h5H_T@Fu%gA!vsW&P&CJ2Zb4^|H
zn8|C^jJvJ;7o4C5IrrW8nUhGF+;OY6{H4MyC%lR^KjonWa_*lE-toR=u=$EP%{fp$
z$2&;1=6qnA1m!$S{_y2ABYQ)S7x?+xHD`u=Ht1?hCTfRYz_rrO`_r<YFv!w1v>nK0
ztSsQ`&vmOP;QN%jy_7pX*Pp$VyCLurd0_7?FMhuFUw?FGec!^6W@;~4SFX>W+sNhF
z`ds5~U)}T(S*){LruW*~c(D6hU{$NOfHs^_9bq9|^F4|0B6|9K#zHEKstr9hd-Yxs
zqxPNK7c=tKv+0cWhT`mU&}%tGgQ_udHX~+T!WUBN!`g0NsEILMl<V_)*MBYG43vD^
zf8R=kNokPjqP)>&>Q^J{*Kjjwe!JsUNlS*DZ*ytPHx4-VSt&P6zw0-D;1K>`u}7mS
zdsSS6daWkgM6CML?cD4$@APKu+OD{;7kj2;n|FmW;O37ut*A8el3aEbj9fAi#8^X#
zt=y(OyEJ~?`%iYxzR5HVV#ZmzF=Q{x<TPD4F&*&OX0Yrl?Cw0{IfJ{_*8<1ir8fGf
zG7LF6TIj?0B0@5h=O%=X<(ztf3Z@(43kk6??$fle>)|?3qV~jw@v(`m9+v_Q^)(5*
z8;li|U4FDH92I8<F4ZJ(pLHPm)~xZ)pBoua$YRoN%-Nt(C`!GaVw)@ZTJ5YWA~z<<
zMQ=vk)F3G4)w~jI+@`v-|9PLs1}Pc3wgXiL>?daRUi##muYAQigl5nB@XEj~%b@4`
znsD5SGc^4s8Qg`Z>|?Wya$>Dk685IU{OKHh2JIiQCuX*1oc`|Mz0uFUT;aK$q#vG9
zapoVrpXy{M-jVc=H*a`f(_zk;gd-jYXBf-wy_?r~<M4}}B7I`Au8(21euR)h)+e^}
z2FO?X4~`qoyt5U~@Vt@{ubY!9=x?H(-ImLi^Z0<I-mTj68HA{(_v6l<No6}ERwf%e
zRFX4w?9D5~nWnON2Fub947|NsdBbDZ(U-#7_Pfs8*%_MKr6bkf#G7=tf6yDcX^2jP
z<7LI?k)HiK%!mfxHsa*`83x0#!yyr~$L%U54DxTCo4KjMT-4~wC%=B>jH$!-X{&&2
z^u6r+SDCb@?Nv6+b<G+B+B%;c+wf5_WGD>@{c+PE@LOTtXbt!N`TJM<W4^)5opV+h
zFvD#*Mz~MnMh2hp2H##gIH+uJnHyd`*&qHfryzCA{Pu?QwTv6qMOxvH%-@H#F&>f+
zG?gFlb(}In$@dw5nRmV*@zu!dy1Lz?#v3g$*Y%;3M)+{PD*Bl9x3^TmQUzlpqqrMi
zB&E_!`o1?>cH%j&;+7UIJNs?!<$gPFsZd@ya>G=qKF=s|-sHA?mx0vm9agrFe7m&D
zF1ayJ={a!yeHX&!hu?RGd?1D%%BNd;7W@VA>{EH*@{^E0mm`q|BbLnZ&*d9al)4s9
z@bW}(SKJvM^?$(0E>#%*`09CU|M`!dT4e$*&i7&+=ZC7L{xJ{!lZlvj<i2##<=#M~
z>e(##+9;g2Zy_lim9Wc0t!^CxUVd4Vd_*=vj{S9sP53YH9~&p?Pz(lH>1Hk``D&Yd
zHul%#<WwD2%UQR}!O!nESr5WzJ<BpwWXYNmNvV8#USc54%*I9BI3X<c!#p>wK@cbZ
zOA%SyzSwbr?8x4<^Iz3ZrHnJ_WLy&M`lK8|Z#e!)C00Ag6ZPV*Sn*<#Y6z`!eyQ?p
zlp4SEiHql3yO|!`T#NhqI;zpb^vwR-*VGt7ZH1Ame%4}W6VK#Q@7KKqYH{~r*M9?_
zJ*Pu<b<*;u6@TIvnP2hC|DFEtm$L%*eD2?e1<H`2&@ayL|D}fo?xTXZ{{M#s(vc5A
z{2z2!pxB($Aas*z0Oi2QU0o#K968~`uUq-%4U?nmd#9q2*?`1HlreGP*Jbxz7EC>h
z4V~<0X@-W74r9YJHqjZQ?wLlVJ;$msYsmIHTdaaw;<fskBJmjw3XQJsl?)>&hzqz2
z*a8jQF>q!BHvTb9pynqDmYzdxp@LQF9pcIC1|JqHM*YG&7o0mF9)b0s#(%aB@#M_8
zvQjKxXuh`i$tGvFH}&$GnRogkWmz3H5<^+)+0{g#lI*H;)fezA1ilrR|AqwL>?F!}
zs-)ji<92lK#q#1xHBGD7!*7nMC2@>$`*oiwKK4*By|O$Dlyt>H%Mk<?DScu}^>Mdp
z#(j3&ks-=bH<dficYYH(6OnLGZS?dlirYaa@6YJb+ZjA<E8r)XA-cUpT~54b7og+|
zz<}Kw9btYZsD(v59M@aVt+mus0ybQ4J=w5;y>WrJ@!m{gVs&Y(dd;)=p?A}#Abg;V
z>tBT@)c@MKi#QMXWUy8G)p4*@diahGDZT-0F!@I|V1|*vX&8$9Ogchc{zSqTP+KFz
zMDv0+Mx10OA*Ce{v!GW7v?T4r5M1SdpcNVaRp$$8i4cAma3(~`uUlnh?UCmNZBU$K
zTFau-BseWX0#rP0V&J)}k4bc(7FNW0av9I&fLSlv^i`4k4{FT)zi+jH+<;FM{HyeM
z?2iqo#s2-V82FEWU;O{dcVR35aTJQds?{8TQGACTRyk>VMm;!lMc&Wc-KoLNxy8%E
z-bUFXdi6WQ+)R?jm%~%1ug5(;Da&+}Xe<~L(<+Z0$~>am0DpMr!mz2Em)Q25<sVx&
zcCJ7f40E-w=2bZL44}>$Mt((xklu+FD3SP~#0$HSue%Upc0UOmc+xvgNFdP=ipXWr
zuD|Rm2j*tpLHdJ7nLI;67fzzO4r7)dX}bqh0vdkRiPWd#k021i_M)f>^a(wLAu)h)
zdzzDo6~)s-*P5m96W2h|P#|=B1ypCEHeZl(VcU2ds!qk=KTKefUu^?5VI`D=V;6MJ
z)AH9%|3pu#(<tA|xYs!Co$)TDYrFy6<WoJw0M&_XSI9oi35q_z1qXpViS90B8wM(C
zU>k5!DtIysR_Ci{2&odtx^qPvI>7Nrd|@kb(0uP@yeF#elnO6t9Kj&9zRdJJ-UJb<
z>~AL4<XYyOqIJc6>scS>kbLcT=tKIt>q<=es?j2946xVpq606ds>U|Ajk)?JgGEnY
z%XaHF8Q300e<ZRGczfc63XmPU5Uy&i2_4oEV)6}aDIuOyN&jMmPv+MoDQUeVF5SGS
z3cXszOZzGH5NYR~pBqdprDkn=s5QN-=_X!t_iETdJyAYum0@dSlyo~TW2D8_#@3#t
zf$EiXmO+G^E<3XUgbhdrXjc%yVCyg5iGJZ?>}(8swYcus8ERXNr8F$(JcCbepUTO3
zeOs{GX2qms5uK5$x?U9>`olo0JdOhq7_QZqoxS5KoEx6b%P>IVhBhPCxts_GKo17x
zaw8TcrWREeZ^e_uKGc0Xo<B`H9^#8KnaC<IoXmz5)lNqacU7sB;*3{RdZ!|M9n%o}
z-}bS5`%-r0iYJp-_AK?_4qOLu3fX278;@qWRc@qWIGP@4-k41Zo!w5_QK?07sp;oT
z^G06wS3hOu&!%_dbsgD6nxX4!Bt=4|7Gvdd#!PH*2V^vMzP)Q3#72ff8x*BtW$Gjq
zvrZk2n5um1a*Vd^+F*0FwWvI6&uf24{#!0^^~2TzM?+T8OxIs0=HIA;ehE3xIq3SP
z7VPSg^3s&mfxb)n2sMR)kH;InZ<9+)e8xNvJ~Tbsi7`t|<&V1<%RAKdB;(X*`-Sa3
zz{xG3+6+}dW&IZsu#p0XfgTWy41$ur9B(j}-|3K&#Ip*9R}tHsp8#8oT8~9~Jww$P
zl8ZzYkVJ2nT}ZTAJ}9-M0!fR{wR#1)wLquc%Kv#6^1}~oH)xL#9hmk&V8^q!a9!b^
z;CMUp#1EcQ3l+N%A#<sn&4g{*9rM~d#01#a+@@WKIhfqX5LyFW-%!ole5tGxfN`!~
zd-ZD(9Eg%36IIaFIGqsG7I09#YH@6+I#<}t2{b72U19}$CxxC6+o2ZPg+%!<V%2vc
zn(8y#fxru_Xsy|N7g^j79`Hd$anTAakkQuyX7w(<y^Az>v^+s_bi_MVw*0l%Ko<hL
z`W@W8cIYmIJX6BqQMg{ies8nMDj%mC$%|(Og4VrwT}ddRW2{|n_UwJpl&V=TlJp04
z*=&3dP<b>V^?Vz0>~y_eqwalErfP^2wJ4Ok_u24xGlGrOgIV)HgI;cE&jk4#1t|hI
zlq9cCP_9Jnuv!9n!wazOq2cNb`}o3?2V$N9SS?ks)aAgBz#`NSg*CK~q{huisXv;0
zCr0<WA(wsrtaprg3(!0iRDwdM2TmYi*Z?+!7h4OhI~4A7wma~<S-yK>xagV6H-TgK
z#siK>BM#2O>D*jv&!i&8R6v?Ba9|YGeH!H8>wuY?W<xdnSi;Ob9|0W=^cE{2IP;K+
z&65j0)P(a$(8p;ygj8_r!am*q`cBc`KZ_k(!{&9^l@a%Z0H&BKdi$&n=?Xrb1Vw;h
zy!dS#s5e0WhJo(*{q83{MZtIeFZRAX9?G`ue~MBe3MpdBlA_3#-Bd!7Bv~S+5|S;+
z+HjSM2opjSQ%ORaWM3zHp@bM)_I;hPjF~ZW`JL1K-1pOcKll4=@ALV6KEL1l{*hrc
zuIoC_WBDG(d3=upN!~~`g>R$g{c((hWqpQr`4k-bnE>+uBf0%={)|QCqRI5d4%8qY
zDUG=n8eT%t6sw^AOr(Gqb#BGMIZ)MbeakDdQEXC8O+t|%ryJ=*{xcaD)1bKVp2#<T
zwR`cJO#EOZvWv&cGScE>wp3@tqje$7r9_$Koza>_0RlHyvKa&;?7|S%>EeWksCw`=
zT+UtTFPqd$_8Qc^E$*77f1m6fYk}4=&dF7Sk}F)rGEv39{khkx?xuk!4N1C<2{+BT
z*-saFAK)@q*=Dj=!+Qfo`tC8QxEu0CXAYk24;w=D<9a3I7HWm&?ufl}PG{&lc*&d-
zyI-1Zm{#SXk*@J!i?Bnn)TTyT)x%vXLW{-%9RYW&AKP*6TM#5q(MQYK4p#2pbMZ{L
zS&E#WKWg3wElwY+YMfOga9o&_@*9}b3pA&q=B+Wa4$Zm(QHy%<cQ4N~bld_Akco-2
znN3Q5@aK$fwek1+P$!AciP*>Z0F?NmEKfQ{bD+y&1?cCl7hy6@+J(RBq_nm0MZcR|
zMq)?btC~lB*>=!)zwrh2#IVAqF7Y}NMxCmbS#PBXWmVI49~tGwFPwfeFR*{(*}H{3
zMP2h%QNeG+_XzohH9zMbp7woekbL^n`(j$MWS7#5zRdCbn<bJdeRjh*BsC4@!;4J$
z_jR_nu3Um|&h56ocIR^x?t<!$+G$6&RDmenz?ltub@epF8EJScuZ$B}`hEuaOxriT
zREr@R%*QY$^@X{<xxqX&R%Mm?Hd7#p{;|Elojr4Jn2B)8<Bn%s0&VY3?JyQ!mK%f^
zeAxcE2Qas<dz~%c6LfjASNF}ED~7?vm-)KRS4##PVTFo^1qN=3dv91zSeHo`1ZLFE
zH^z(#^p4$w#ND3fNttRe5}K`-nvd4Xrw9_aQ9x4?%tPyA3ALl$agw1@1BLA&QrR_W
z4ypA^<FgbRimIheyyJW4V1-_}AcxiI@D^98%RSzNUJQU6Tx)<Ht`rmD^$<k~szP8;
z@NC{H;x>*Mannm+VP{j(BCxj(o~wu>iU2Vu4C+w8v<;r`?F16|IUD~v7fF>wRvOvq
zyf5h-G+unY)lGQ|;{?yL)>Ih&Z6L1=vtS@Fi1uZFit);@D;zuG5FNkYrpb8!kPH1m
zbm{}(0Zx+KsW;*)jc0x1flU+#-ZKRjktD^eBm+ZR0gA8(WhUxnYADgO{(V!d20mY1
zjTswp^1#l$1g%d!s|i$jBtsWTnvlDT>j53rxb#6MPxL7h{oMF#s|Ymcj(6uO)PItO
z{llMSnG^$z1UwcBkuIUAVf5=^S}#jN=&X(>!ltW;wT_L@AO0w|k7OOdS%u<6x#&|p
z2G(Thzod#A6$nO6ZjN40D2{Nu9K8qq_<6xiWsO_A2Qge1pU_3{Bg^n6wxL&GMBjCW
zZF_KGvUq+8Irw$HRk%+jUHHkd;%E)`J@yV3_bwc7R|q$4ILkSI8}0hxQS8YZ8Ac3w
z?<H3mCUK?d;gGH3m+Z$p>6gf+PxrJ94tIIC*?6@#wTbHJ@>@(f4&O$Xph)f<k$GrQ
zuy9IC5mIN13?CplePc|U7YnPm)Vj{t_V$t=zJIO2r}e$c?fT~s&ZLYC!ritNU@6xV
zp?YmiVB+n7w}hYEn51o1xoaP{U|^HJr!+ZZYPf6BW!cw@ki|$C2c&k4$>K${IcANg
zR3$erjy5_pA60`%Lz@LQ_08)qqL(E={UF}f!HJ<f>D3RbjC-Fo(e>5;jn^T-z!H}#
z&>xwBu>)g_YN#8x;xVsjwu+D?%*=fS7J#{z#*5E~`jh*RrA{Oq#rd0yrt+XG`q=wo
zGWT$+j+0u1gr~DZ$$b$L=-e}Sm7YlfCEU?$o~ww94Fu+%TzvfC5~i$=7PVr0%hF0U
zQa0^WDSyf*Q@t28kAuG;L#Y5u7<VJ0ND{!=a32_&qYLLXF*Yh!HKRo?L;BF=3#hSb
z6bV#4M)g2dhQ2Fs@C^9lYe5Tb5IeeH!~7lZPWKm(=Rz+AAFMEO-@c9(iciigCdD%z
z<o5yJ`dnyXVLRR-cQU|u<8Z<a@^#ayiWU5{e(}8416UY6NM!OO`JsM0;GwwjWM?>x
zCk#cB&ukdS3&&|;zoOcvGvV9mz*7Q|7ypJD$b%0+%}2=k@Oot=sSC`=A&ftxrhr-w
zq0;g&HM@@g<_9`7rB)mm=H=v530&pcWThx0pRMXoYOD5L+rY@24<sC8@PYeCjshC>
z4gi=M{Fizr$L+1Qy?x(7*$#FX|B`~fSNW|WPUz`HFLOq^3~;<RSr&bfk9JyS65lZd
zALnjjhRCiW786^_&F~onJ1lLN3W~C`1ccqrCuou2S5cr=Wh?3$T?_hTXAGBp1HUl@
zl7sPJ9u)ZQYY6Lhy8{&SHR4*{&p-Lmuq0yo5@t8Nj3N;}3$bKvZ2b9OQU>dBLC~;g
z3u=mjWNy!+b)sJc0(2MEbbJ*M5un9O#4-E8+aCz?K<s}!%FtY@G5LDaiN2(RtlMX!
z?UJD^!`ua}S#!XJCLeNo7Hlr6LO>L+-vv2L^yX3Tp$j3Bs}Cb(s1`Jn)I@{c76qs9
z(L-q3HWXQZL92JCs~w+BLJw$IY6T*%JOXotANuWEflFc3I}?5*J$PoUGZ>`>0Pga%
zMH?~)4!yjJ*r0UAWyWBi)E;0AlkqcXIbs_+XPFVj6l8uvEjkku5+QE?BwzLDG5<w%
z?6eG$wvfAuAjrV{&_zpdv7|I64Nb~CYjM}#wmqQJVr5eujF~~r)q}cLWQRFwVa#b2
z5op1XZsX_3!+D#*mD!+3Ov89(o-m+K5x_ENT~J>vpt|Piu9<QC9t*vDqt7S;;@6i7
z-h@v$)BEwmfdoU+0(=QI)5I*KZI+1%te>M14zm_7W~h<?jBtO~98JG20`&dzB>-UU
zmV^$8T`>SgX9i;q20Mene%KvW&dHKrm8{bl&H)nF`mXYJ8;F4sz)nNgEG``XC@x;8
zJb&JG6(Lp!?}Z)9s-mvfN(uz*nC7=o1~E3S0!Y;%U$A`ZuR-LqP~{j2Vsa-70Xz5<
z$uPrcH81wo2PCxoVex8_q#_1#6`|u8OdvUOfZ}zuF@^(73`L&9>}ei+QfIq4_^g47
z_>_5l!wPYd6RfuKG%=lcC&lD*mz-N&cJp})h7zs{Pe+yt0C3!ZhGnr-CsYV}5#<XM
zfFq8;u<^CfPo0*AWL6^E!v+ZhFJTerE3+TZ5CyV8z5!JkFw}vuSOJ5VH1mM78!zU$
zXi7u(c;{MxKglgcnu0^-)<OOAM9_CT1r{<MAToJ+H-RS`!Gk8Ax?gW@!qvk=d8}Q?
z=zy;Dg~anocu*HAqK^+tXH0olXKNvZ>BRX|bSl+%718@+lc=-%@1{%_#g@zcVr!`+
z{CmO$0!@VzpaGs<XyQN;#u;rNSOLwu0SH1t0#0L#wK{bcRD?x=VljS5aYmIB)@ud`
zf*^h(Y%jivr+IA|vH~?P(-k1Ria4q~CNK`O)XcVZypO&Gub~JFEv+IHztuxwOw`${
z03r?|5A*+p=63~*QPle`2bT}BD%1k4EhdfcqJ~`oCY+j;V{%!H<OMz-ApFHo(DXyQ
z2M9AD;gZX86o(nFWv1~Ra<EY)(BP_N9No|nEkqpmVQej+Sds~K=uRE0HciD;UC7>U
z(7D_1rSr#&(t}?<Wrtia=28<NGp^%f2|!P^t8Ql;-SNg=#lGPHbMv9FB_66B_C9Kn
z6{oR1V{Hu}EU8lOfN0|iL{jI0WeHlt@pg;IEECvkIi+E$nPnoy%F>z%i{j>BhLiR#
z@H9e5#%A!52lz`=plR$&RQwyNSmkJ6RsI}TMvdj9d6lZS2v>63n8UUB94jxa{h2$C
znE51j7tdn%y(nvdMQX@C@Vyduh7e0$>QMtdXhCS)8l);KQh@;M#Ph^bwC3;wgt6hk
zMPFBeSu|-@4opir&<*vs0GWw20c|!0S+kOkelLKz4}hthJMr%VAnsKJN_;t`>I(ik
zz(F1u8z6*k-9UkW%wES*eFSUz=-XxpBqyL$b$dqw?o3hLX*6V+sMY`vP51_ZzVZMl
zjsVRSoezrul<I@AYGoX;^N<TU(7snzJgSM3l>UJWNI+b2EHw)K+Se_S4v+;1&kK-o
z)EL_&{SeCaQ#~shpxWF7bOZ6D-LjZPGK9f>?4^<kOe~N)x@&7DX`bMT>hH-CTB*X3
zPN4*P`_9>PSxwr?esgz8P23hCx64|1@5yZW?Kieo?YEB?$DArVdwc%;Ro3(}{M<1B
zS)e>dLJznEnWOn$fY}NP`h;wTdSX@)dS#eQv>9WK4iaD(ByDtTA?mYVLK<)-#5>f!
z=N&*s2So4x+Ca==9tDzRkoXeaA_TXv1thScnYxc;3q~<`q+hIE%J5ObbC7>m30^Y3
z(?`-rBD$sy^<6A0X?{C*$yiz9yE_!%;o-XHbkstHC*P1py!ZC?>^x)ORsrNzMu*vI
zHft(Aw_=u@CyOwIY?E9^U!t!RChLYt^bU*7dYi=U;u?OahM%w=YL9)15vOVl7_apW
z>~NxM$GWeJjd&J2vZ9>y#*p7+_WGBOHS0$uBO9Yn8DXS^+fOMSEF1X@x_oB_sxWv`
z2fAEOq`KAjL7=qz8*s1LGxq{KNdB$U5N9rbt)e5);65FnC4AI}PalR8S9Ge1eJJ`N
z(+A|S@4M?ZqrRU;rTU$FQ`V7Eus+WPG+nj0?*md$hu2B#wG^72Y4k@Z7)joMcm~aH
z#_tled4@dfi5szMPMg{D;^at!@YAV%dSHUVB+peCxG3kjH4|t~lrt(!d;8a{z^dm|
z&zi3M_%v%jyj<r@e`(y_n48g`^91xPqdlSx@RLJz`GZ<VcdWfVx@Y4O(6FT%NE;$~
zsC;Mu>Iu5>8{!2%y3HyP?sw@Xr?@Mg%RPNWIoHtsz<a~!_r+PI3i*d(1x<p=c9f6Z
zo|0CjKX!okGH0L<F0^v-w3&m=8O5k3m>YZNH83rf)R;vnnEM+u%0*iPZlmL|OOJAj
zTVTHK3LjU;y%vgBEo`q^)te02@7r4CvFpOe2?c9~F>WldTi9M1Z5b-=^+DIKmIWPy
zBDYQkGrBz(&i8<-Y@iAnQq6!d$ZgitaahKC3}!N|(ckV>zb3yVpEtP7e#GQN-Eim8
z<Cn(#9?q@_%6byoJLwY#8k>io3!OAj+d~lhEPuUb)GJNWp5tSDO3upnz7*}LHAhS;
zDrNj`HjNeZD}?QR!ySPQDYk4c^-1YE*b~!x>@BLZSCQ^eUJcBhV*@Imfo^^je%DU|
zfZQJJw@vg{rJC*NQj>YDokGjjtn^sU8&)VTlS&O(mW9)q&WUg12bOzE=xIxDpCZX7
zvF^9yHJvU}%65I^_`K#j^#*FJi=d9`FDGQDF_fC7?NJYIeAJ=h22^lwk1WhA<PJVy
zJ{SBftydVSI;$e!gStHb)xi|klKEQqb8b}fu`r7Tfl<+2BxXn$=#C|0mYwr$@$-p|
z2juq84uCni&%O4NkB4t6R)}WJzc?Z=5pdO4(?-+gKr66cXyxZ0$7{<ro=$F}Gepzo
z&2(>|w`=b}Gx(`_gShpR@4L=lP2SozyJ-E%RU~=ip8SLXZ&nMO{da@TZk2ziZh|hU
zJz;VtvXRkZ;?#+2iLb<QOak<U>QC<FB=r_KQ@DMqdO2DaBlNmI8w56a2s}M#D7q*q
z>>Rw~%#qq7;)x_Wy<~`h+K@+}4-)7?#Cm0_8(PKW)XM_boW<~yXZ<b}v(WHYHSAI5
zW3dJ81J+2|n7a%#R0!uSwqaUV4uI^Y`2)Dj9zI$ghi6lSRX#4h!-2CafiaOIKT^AL
zRdYo?OU6^@+inne%18RzP+2$n0lg(W6T>w=^<}oUJ6%5oH)b1Z>v!|F=G9&f!p9o8
zzrk(*h2`3^x0H)O6{q0+6LjUYj_FysnLGpW1zRJcO5CAkpRM+vP?`(%)GvbG{Ob^F
z0UY^5K2%^O*mw_#U$`$CML&U3t$UfRycKq&;qbV8*>o?S4_INBqNGFJ2I0r`v^~&I
zaHQy~sD)JoxErXO;k@Kdc~0FT6&kq7H)Bis%RQ8y@W-4kJyS4InS^B=1Ymzr0R&FB
zq*(5<uF&m7(#DJ=kjx8^)!?*Fa-y;l0vq>$kO#F)SY{Gxu~Y+PByAN@1_192tPGr0
zl_~JJpLk#djs?Unrh`D`GVtCAV}O*<x=Ud;U*s|@W~j-oq|6%ir`iYfj7~6x>jQPG
z?l7iW2?NUQ(D(uHA=Y6_gje4h@Ey)VRFcf_PN_Lqd2;Kap|rSh4tIqz0xaU{1>9dM
z0p8TKiV(qzi-bMPI9Hw&8D`0481W4ffE^prq{J!I;x_PDq<tW3S{}iSDAj=i`n62b
z%1aaO(GaDL)jS7OhucFK>RkZk8A1#J9IRpcgrq}Je=@)k@^%`H4rBE6_^q@z))kDH
z)vDl5kQJrBO`g8?YU%4_%B|{J3lD|`EfQ`8ZWR~0ikKTnSvfTZ2Z9wO1ebvMFIbSc
z;Rin;nXyPxDiRI?cM^zNk)}0WG|lc_vics0?H3kq+H9L!U0*qdAT%ECD$iTgpJrZU
zk4t<te#u2M;I!yxTMp8kzWbU9&u&3M+Z*K${fF#s$wvmrw8PvCeIYKvaTi9b`0iDN
zb-0~R9_EWp%usv4Qi9I1|CARaziYYgW0k<YHxo)x(}d2rzJ)ms=8C{PzSgq6yHdTO
z_JxXR)!qsKpy$w}B7G(smdRqEO*?;J+}uZYh<$wyv1`S2r?!tPtzx3q-vVEw<{+Dg
z**~r~sZg3{Xjs=|lhAa#(&9W39ZCi8m1F&h*1%3%K}QE~?M-=~?4qI8x$!qmR5_5O
z^FmSgO19r#+cf4YQ$-Qd{q}yZS+W6pe8t1Hr@qEV;Z-$a3u`yZ(5(U2E7|O*qSZXU
z&Wws=4KDUgTtIo31F-VT2}Br>EY=CcHyr;`iQIO^`tom!54w#^PkwtNUYb*qo8S;M
z%h55h-|b~)%5JXhTQ}?qqq!0G)VHPQuHc^8Axnb*W<EKrB}}mfS&J+|rhfzDUcdqL
z4ys-Ca{1=={%=aOaFv5Q(`%1#1Z|kzfVce$k`7#lGt;khKHPjc|H&Fc|9(}_oj$^E
zJ45nB%vexScW~B*x;Xs;6I&yW8NcT_feS`$r~O|?5GWUIctQwQaGQLCb+IdlJ5PMy
zHmkTDe74AhMoij&;L7CSmpm&T2OoaZiwUw~77?+{wPufo4=$}wIzM{*OqXqgoh<e8
zmF`zZrc6wX4&@zg_IKafXS_qNC?M_5EspsNC6iO8kIJPy_NHbtrT{Me!;uNdv;FZX
z$YPEr$9OOf1+mP?!A4YX1~6mjC#b`O{!qYJL$AkNW+pG9f(X3IPqg@IlZA4yIxT%?
zl7*e2t(}6rRuyiCbyrSaAs-oj`f1nMsFU|nx2&X9&)qGKud=Z^7PoItYbQ3!JM)p(
zG<Z%<|2x#n77Ho1A^rHSxxu<BcaCnVPZf?2-aRgg%-Q_TDbfA@+yR&V&C|2n_6~1&
zp41u1AsMO}gVqQiU?*?I-@{4AlsvG);EWAL-y*fHMyFY+<bMuKo8=auVjyQ+7&!d>
zWK0Ey=AOtHfaEU$5GkVKR}s1zgGiX)2gkUcvx+d2fz%m>a8DZJ4YTqE0p#fHjk`hy
z9q&U|k--#zcDHDHfk`=oNeaEAT|>6Tal-d|XC*J+aN1yRFTty~LBe7NiX(hS*Jo%-
zna-R=UrY8AeaJX<CTx<C2T#Ih{hXO?j0{5CK8SU;yMa((F&~H`aS}Mn6>S+RZI^<b
zF5~oLvz6G#>N%*bUn2|WXj_)J^QwKk$qjsOqE0+-273+;|7iLR=vn*-`bi(jlF*eh
z2vy*_><+hJkYr?CGJnfUQeIirxp8<`Np^vg(f6)+`5LkGOBpGuU-&mymQFjaJ&`$@
zW+pWO;LYUo>g?d?I|b=0Aoh}jNF*c{wP+m((mVqfUxQ#~5;f3|5{1U|836QGR)Iie
zsI6)h!3&lG*m%2T#T4e1R0fuWdVONvxC?}#{Z#iAF5gYuHwQ&an2E|rEu}K;-fe}1
zwvjMJab0#pVChZ8AB758-ud|C8*a=R7G)!k!4KSP`WX9_k+7Dn4Ss4F-cQ7X(F&Bg
zGvAhELS^xCvag)diWBwr&mW&Q)X3RtxYa-+#zxhhr%#J45YRW96}Vi`)0pXTbcFd$
zc|je8g@nE4y7Y%op%|aRo7i0E<b8x_c+4eQ^O_q<Lf$WY_FeUDy9iE^sM@g2h!;gd
zGK-Io9t^u{7Tt^#->0S`RRXZpYnDg<7wcCz7=otosiCSq%HD2h!hR+YPaOH<dkBop
zU$S0netP|%d7+xWmj3*4nOI8)%7MUg_EmxTEkBkMfwBH+$$nkF|G?6L3!Sy26p-c!
zcYjm@v3PfX+lGx*^wWy%>K<^?<e?g}=I(|4GItN84Ljl~#m$fl&z)^nZAonz)Zp5^
z&&cbahS@oDz9-0UIERhdZGNTObM3PrpOlPSH@R7%SfD<z#BLayG-?c`J}>8e;lf)C
zYM{Z8bFrgg_+(4dH9iSMUvXjR`y!;a;={vCGb)yhJVw>+cQvj~7XRkDn8bJdZj+an
z;zbjG1c$kUgmgwwV`Ij%=rs%^^96ip5}E4`(w$p<yG@PvjG;>vC3cvv?BB$Gt*Xe3
zjpiZYM7VMw$747VF$f~5-<o5w0*W6&MLsi`a0SH|*ofv|1mMiqe8zQ&Q~bT9Bv*Ua
zUG^Z#!n0ka#<w4CxN!9S`{K;CfS3(Vu!C*{_7&jrDY(Jy%1Ey6E9xQlT&E)%Da0%#
zm3gDl;L8yYw?En*y2(~2xOON!xr8#sd<PALmGey`11EIX2j1#FBVwf`H%)L~5sWY2
zk=jRSh*6#Qh)9`p)V%QMG{<n$jM0iGMu&-i+ixr|X->XE@#K79gEYQhanW5aj`ve;
zoR5p!?w39?qsRF(vaQJU-*ZrT{)|lYqjvR2P3=Kd)kD7()&31h=PwkUzmkG}dgCWD
z%HNQ54*iw0@(T&+r#F83+|MMPf3Ar4(81qGEJ`YeHp%^<xENjZbl!F2x)<QO{6a?A
zWetcbHh-n9ut+^WRqFniw3W^yoA2)8T6a2>GhXy|im#GtqW-`JS)1(|FNB@sV;pi5
z5*V`R4g5+d2_^1L_UGK<4t?Dlyv3+T{l&c}QetW%p&P3lLOb;^TjC?UIvngceLCA)
z=wTxi-#a0?&DX!zN8B|uycbpf%4ak=yR%Cu>A>i=v-yeL&lD6?@Htmp%f9G2Pu+-n
zlhxLF*%jJ$i}HNC_My9CKYq7C_wL}QaxH!jnPZ4v=M9J1`#<sCDiqLmw{>jp;tktS
z6SJFt%dO=^;<?;I?7P;IE^qjN=KPSzEv>Wnx@qvBYrEN(!;T}%u5wunpYLGC=w#wO
z7t@+EPC7M|Dx~35P4><wcG%vVcLq~!^9$sj7A{>1)qMWgZR#|a&hz9fLC!6K@_$mA
z{VQ8aK~?QHA^MpK_3v%!KgUe^QJMW?>lIjX^iyFri&OQ}cK<(Gn7yV4@$7#Kv;Ti9
z%>LEe{6}Bk4h`U^mj;c)4k2CM2luvrnBC~*v-|jn{Vv{TYwOa-gs;C*j0zi9Mt2Zv
zx&rRT=*VIN#O!#FT&vXo#1=H3S!Zi`P0RNgkJO8|zIUpY%LTy5Mds07L&I+U&i$v<
zOd0pZ*|&gUun(^${jTHXuV*E{z6$iRsw8<{P(#TlS~#PGJDtYe--=_9Y9^1^E7*B$
z9v)P!pB+<uySXfdBJoX=fShbE*Ddkuf}V^iI9O7S-?>^~?@ALd(p`MU^NO`X^MtN~
zfg838B>pbI?FR**<Dp}Iw-EE);R(Fahbx25J4%i0;>yN9nwo9ec_o?}U*TW-giSAI
za+|5OUdz@k=Z5Ur`}x9?KM*T_X~6Pp=KPPZ7Ow(73H20P)IL!ax9n8b@XJcwzft-*
zSCOs%Y^c6kKkoH{`m{D;ia?5F*prs(V#oaAFA?2l3Kwoa@V@5n{zYSGr`Izc*69xd
zjGN;fkES}K%Ud0<^af}T8afFnoKO@Okhshi9@%fv8%svl*=$AgFfNk$`IKDdZOcCH
zH4wJfz8ZOWSmsv10x=75{l;I8p?+Q3pI-%@4`}(oTOa|aL|iP0?i_7uyhdibM_sOU
zd)^5j+EMX_zL#xrZCDd2xdf!A^zYsHY+OH&%5@bho?mvGUw-CV^x=zQc)$5Qgupy{
z#{Gq1D#ocaSuY~Sv><qN*URV(UftlKx8sk=$s6cASu&%9Zl7auJVIBxqOLRwdK<Zf
zZR{1=$0@IAw>{RQ$*wj0mhW%#sQ!zN1IR0wHAHAYjH)~^g_Zd<KeO)b_wJnGm~GSj
zUY$?9zo<>w-1CE`@4W@dcZN_<Up+Ybem^^!_q{~h?RdPmd>y^V4p)*)6@7kqoiBQ(
z>V={9?Pphyr0`muH*}da=(RF4KciYJ&*zvtga=Kq=0OjTWASEGO~;6ov#oNMiXO@D
zdjGKbqVH6(ndZ=~z`JZC>i>WRul<mDU%4;W*W!Gu=9_@%8QId$eb8s45|2pv;W4!_
z9~aMAfdy##$Xh0^#%eTS#Bs(u)N9mjCE0YQJKPheq1GgPa}4`(FXF8n<$kjynWMs;
z_XwvRUZk){@)MiOsrT>tMNd3u>l0BYI-Ltt1^+`XXer{*`Ut6S`(Ncpyp#~jsjUaI
z&30(reg;MW`~{@`S7u|0r<2nL{zz?DM~EGTu38y6mw0QwStC1bhg-6&L*CSS7x)hU
z0R9I8jL-eiXNT?Y3$U5`l(sq$aA=6<{<DM>$LOWmBS(*S?^`%~on!ZTwz=do=a|3S
z28EkvBT%FV)XbCL7<kl*`m79I&bv?1F1Y*YPRH$ExB~{zxTWQgyGwo46Phxwt_E5}
zF;kobi18&p@nvkTU%+Su$F;YVSZhI(qZBktwv;RN8jI_FO7E`n<UM0xwn41QgLvbl
zZxed}M*=ZFu)A2|oo}n&w+DI`O5QtPK7ESReEeMK(Dv%g$eW^19jnI?e-i!t_8va>
zhvG+Jgjk9{O!E!`ir+bJ02E(+`iq9+&L#YVsi_|uK%^>z4HyA=l<%Lx4q$qszz$%S
z3hPilS|o(lQ9$D0;ba!xFmU{;#C=@p5~pFPYm$LR!-<S~{q414E(<+gV@Ne(8!lfo
zR5p|3+a#=){>rw-bMK`i_PbwHl8HAm{OS-)p89`a&03Jz>q{uuO;d@EvDo)Esl<em
zIa+#wn|!V2(=pB2naDtQ{56(*=TI|Q^38nP%#v@<`T!u`o@0(`L+%*Tnnl(D+D`P$
zmKTPDJVCv?g0@B2YIs~Xj9%Z7WPkC4X6#Xpa&<3!_<!5@z7G6oHAm5}wLHMUE3TYr
zaklBs9=Wj5$8P5;BBNGyrE})a$Wm9}7kZB^lG-{z8$Gu}q7Y2JV4sZ@lGKd);K;t>
zh(Cc?0Y^+=nioe~Zu+8@`DpzlN_z5(MbPCQVY_tcD)C+YcUr?%2Fs<WovFqtjPvB3
zD)O}J+Rv5x-8lA%@8Bg*zDfJ$n0$pT{_jacmNDCuhp%&OqIRnKN0QU>yPl8Pw`^i1
z%y(VB{dDuNxee$(u}0UFL@5vqy}>DRVqMg(ZwH2oA}%A;GhbiWym3dxw9$ERm-@^%
zH_}0z8PWBqRsX%l__JiTLXmMX%TGgTjp1rz*rPI2VKf}2yCp58j&3xi|G+u|^)X_Z
zC!s~(Vf)mFD6Jxj(wf1=zvCuYE+ZhFBxC)c8p%<rp(!Kw(%ZmA=ho)&kVkbvzWeWD
zU2aU+*!$t8qq1r;7~67!l%vom3lqD}d_XjwZ-^ax)p^!4@(3Mw^4Z!_BxSfI?a2w!
z%w*jYYd^;z{T^+LYvCy(ep?6yqJw3Fr8r7`OWHT>Ej3E=bCGqY!~DMVAKGmZF6z(t
zk`n2+xc-*5#ot?2@H@5%<BkW`VbHoM^(*JtDe;-trw@0STUNf_Ii?nxQ|Cc^dea^=
zw!-7=aRfg_cRI(l>`gwOf;hA;G{I8T^J#tIQ1(P^VED7Og;1CN37jQW9AD*%Ob|O3
z6IIA1as4H@3p2Y(k2>WZb5ymKbb#jvp^?}(fv#<%I1l!Hg|f?6I?rD2=ZaP*A4YOE
z|NV)NYbJ5oqXpYy$#;*4eQZkaG<4l^dV~2o`v%Wemy@bZ5&`;cv1HuzTvp8h*kWyD
zvVByv;T@N?h*J|LFHAq}Tz}0t-+vLG^A~#?V0{9o)8^*#Hf8?pn-SkVMiu$$(QgzK
zHgC{U%~<+|acN0whGl&tg&#ADkf#%`sjxkY3cv5WWNtdC*reR>+qkk{Q$#<%u1~wY
zR9LD!WQ07EblF#FrNiyA<p<gNXc=CG!(TYA%goj@K-F29rdC$Xpv~I4Gq*1vSLXDc
zwL6E{oH4nbElBU$O}@i|Ka4GslHHQl3aeZ-H4^<e_aex5bHC5CP&=teoWjAeWUUQ&
z75o)u{$lz78IJL99&8^no)-_O8od$K8LUo{Fm?-w@GblM0Fna6HM`02Vnj*Pq&Hzv
zos!v`5gIQ<O+`2Mzu&5r-I|KAKwGh(niamnSylX;z+yuvfNBV?nnnQCTx0cBhmq-s
z#d_e}HUGZImiyo{P%c^00XhRaO?5=6(_S0Wp3bse67a1U!#7T<j^PeFkNE#hmgr{(
zEb|Wq7DKe1_y+=eSUa30`ytGiH`14|LF$Y{&9rC<12y4WmHN`h$8fsl+G#sI(Za;<
zNZ!Ttr6z=PoOw2_z#=iAn)g+I$@dg{lbBly$ERvAa$xe$ALcs#{Ih@Bv|m<DD&`{Z
z@%M_8-e<axon0$%``q=O#csaMil2}sBVPY86Dv-waXJuRgWdYF*?==Y&109vnU|Tz
z8?%}&z2v<a#EtO0@ptT&KsIT??2Zl@4!P+i73=Ky+PX<`=0Nr~T?f@2QV7wf?X0$!
zYjiDIyeySJOLtM)jSscYOC$?+S@<91O5<R^yoH#U4MwVkte9CDx{@0#{KTS_3Xe;K
zCLG@?7yY0pKyTz?)c4~vXj_X$DF5@zbh6aRr!~8RjO6VMHYJ5O>`#3pdiPfS@tH#Z
zFa){yAK}Cfs#HeB8;m$<xV^<M>J^TQeMX!|=zfpqczxB^p-7q6cok+$o~1HRkh;sk
zPvwR?9D_V^BO>jc5M%iIN#7ydY3CL&>4uG2lqGo+&Gkj>VTEu{?fg0ofyc+p48}KZ
zs@}X}{2Y(Li!*Z%NET6zuaavdLfzAAB;I5kkH8dJc=~fUrbv~n>Aj_G{SQqnwj;(Y
z$Q^OD-Efav))J5Qv97?gzRhRH()Oq<5A|5&T6_Vms(Ulp)$#YI6HnTl*JUTaYF!W$
zG*_Fbh|;1_lovr4)C#!OJGz&_O^n|DGNDcEVaC2o0uB)gh12|7jW29`JO2)rvND87
z-PH$=@W(W1CwT7ks7+1QlRvl#F&ypt;Tccx_&>t4*bbuE9b;<Ieno@#hBMlhyMzsT
z2cnOvPRyr>`VM^yqrWIuVLr*TRDvS9*og{$9;JAMhC#z8zS=ujb9>P{nq>6lAM9L?
z4?f<}9X1W@WCM1RTIBKJGk9UPpqHXYIKqV@i;ct0qdPH{WN9P*hb32iwyyJ%K9L(<
z-$Ri;!cn-3sPcDJN*KwbY^j7oj{6jx@iWi&zgN1T-O|0~vbo*u=xb{xJ_j_jaBOW%
zM#Wnvb7KB`zx;wI2~v4WN%JjxRaNm_k)@z@H4rat9cD(BWIlByvoy*;=)A<%V~sC2
z3Vzb<DNnin?&IuBZ@dQnGBe**(l}K8^5{PHtxgYwj-Q=&IA_2A*`mbyGy1Mo-z*~j
zt`k^;zKYq@J_w?axy?<RKBkLATl4m_74IIA?@#93E#57nZc*bkfy<ejVei}UGP#z%
zQFhU~KvAJGb4*9}tBUM#t_^1Fe6?%XF9aj#Eny>z_=w~!?fb=xLaP1M_4izpDzcQ=
zE^$3lXLC}WcyjPNco*DSzKx`n&TFfm)vN9n$+=_OvGI=YyJ%<auU#|b{xBnUOS6wM
z&_0Mme^vVWe&fu6ks|M1E;2IGe|7i1HdlP{)kIqbvgB;0|H>>r)d|fWdw$XElZ13Q
zLh%E_`^{hH!~SfT|8IW(r|I=yyE-X@o?5>qMiu{!mQ4yjWxK)m|5UbH@t<wd)FHpQ
zik0o=WfRx`XmVXi)he=bi-N*gFXuDi*1MIhP3UD>yQh)+*xt*(_LFwm6gNx1zt=14
zSkZ&~Va0lrFK&h%OO|w9Yq&>tzf<vh$}8#~J*1_VX%(uivhcQ*(yEQq%WGz?yo)k^
z8-kv#ngl;n8{V}c=<OSkpwWl-o+;LcH2T$KxW3Ml=FU5t@O&~uZ(HfoL<c3S4r`P6
z2Fy~*-5(}hFRvX6B9DdpE%rC~zBrubYh%l}T6_I(Q_(-3`p1ce+QHve{NHF2@`n}w
zS5whHHW}oePujaVf~H%F|9|udS<`{I_P?p<|5>T%@(^Ye)E`R_LAhqi*cg9+IZCy6
z6c&c@4T_vO+qzhzA3Nw5ZE)QAQRs`9#%&EUuNnn<>a%JdJ6N7vCwRZMEkafH{Z*Nk
zIlTS1*GJEIhm~miz95*vd{9LOj#nAXHK(2`m+{r8N=C<1kkcaSV^%AAKD1=Vr>>e=
zg+?Wq&p%qS_7H24ROQwo)ZIC+gi_%lxi!93C$b9^EhWFj3z?^-7guku+%5l!-L1v#
zn4IT3#+%RECFE*a$)@+D&V9A)`0jJYWP<Y4&wqKYGf9rkMrIzDkZWN_Zlz#Ad*=r7
z+M&u`6sbICK+C_|Ga&wSfjo`;1}m7v$^7(OZs%?L@Lc!Y*h^|})ywDa`Fo{j<X%n{
z%y9ayJlsAeW2C|2;+Xsub6d1PBm-PW8Z2B#=_b|PnR~uaD)Y+GmW*mDP<JhPMJ<d|
zLqXzI?!|lLkX@P|Ht3w+@ycFDuA;5(QquENvc}Ca6W`0CCl{r8J)^^Y96NBNV@RqP
zXk#fijScVHk&C6Klp8j2`Cgirqiy$Bu>JlVjCI!zR>d+f*BUj$IkDY|GNx6c0=ODM
z*=z;<ot6q3&<3e@v%cCrUIH+NJSKWc@#)EhlP#D>L!?@GTCBIB#NTF4YUFZx!N$91
zThfed2-OWQ%4GWn%467fTX7_WSom4WGwvf(&DymEJ8h1Rel5$bxE5xadwFF{D)}k0
zib(FVl^Eg6obGyR;T>Cc!xiRuJwKU_)~O0q2lMncFkh7;dwi|yV8Q0nbI*Ea-QQ1c
z8#ETvix^yZ4iUI2Bp&Y1j*U{;`i4iD0n%m_=TQBR{Rs>{<003iu&b!<WOlMomn=p;
z{lvIzmuh&RYhI&sxDn42UIpp<BNpa1FH21zBa8eq6GUV7@#cmdRr_XacL2^iKQr<M
z;D8lSj*;D~8Xo0f&B_W^Z13E>#?P%`8Y1T^_t-8fMbD*1Mz5q%@npu4t8f^ps#>~p
zvv%Sm+Pgd}Q;TAQ8CA;FWp8R+QX*NtP}f|}*bg#C#dhs|K`1ef2L&^~G+$-91D1_R
z>6({UQM}s9zOS5(=#+@G33an1V&c%J{F3NN>-!Y8cXKy2?4mh&<Pf(Sd4}%=RznqO
z$OSYsYYTc2qy{<;agA)|tyR^)a1Ku%L6u!$MD~<Hx%y)?MT%IN#sHke#0@xOUe)0g
zRn)%6RDeo3Z{lNO7S$cl&v@t*Pz`uQ0JigeZtL-(<z@b(Jem~MnJPYe{UiQLUz9f}
z?5pOvG7z}GLw_AJt1{d`{e3y2qB|UkSEa8xAK{G?B#erzB3x0F6N6K9o!c2F{6siZ
zeCFh$A4RW3XD<|fi}kane}&IN{V$O74|yWNOk+@M%2YdV5lPI3DvqH>b|FEoZu%Lh
zwWD7z#EamUbO7Bl${Wc5rBf{?q*!g0Nsy27zxzX7{`mMB#A$tokOvs{y9|%aG3zZx
zwG{v*A{_K&fau;FZZ<F(i5qU}2wOs~J+DQ)`zBGRDCiN#_5sV+OaxvQe~Rh{SS|rL
z1`jBJ1vCpqjByy;m?q;qBM8Tc&nol{5{%~$y?znK*iZQ)H@M8GBFv=0pU&I-;mK8Q
zf!-pzI&d$z=V1&*gE~(O)L$?L^3+9|#SK7I>A9K)SB2W9Q~7a2r%HUYE?Sz5;tX>V
zosOSg<0lzyAX1!D0!Gm~5Bslx*%mXah<#V7*+0h7D_Rokyx?b~^G^$JBEYP>csPo0
zARAR1pUJ2M+w)5Phd?p!17SLa8Z8G>0ZNFAPB47%9ayT;5bQk1Z0K8ggm1(E23|A@
z$oMr-n>@X_r-V6(LVdzz3rzI!poWb>Ro`t;2<mEUXPX2FaK~0avu!xI4R-X!fhEd-
zmdMbAqV~`MSZ0xFk_TuK1N!+M(9ipyO9fXxIJe>iPGBqq(aohC;Dgdgz&DH+AIt8m
zi*J}mJwZ|B3K*%GgLO<Gi;JJ_&>}=&uF&o@LyH>h${j#AOsp-}z%Q`@o@3Gnh!}>Z
zyGd0ILJ=qn+C6>~^r;K1?4-a7IMZAI6#5(ho)uJNUyr5Eq478pxb*$p6?a~YXUpaC
zAG-T>c4j)!UQm#?k~pzHUDQWG+;~&YntO_R8`s675`62nQBm9DnV=T7^_>PF4=vvZ
zIjuc`^%iLuO(2Happ7`-66N_t`1@2f(fGh5k$#9SY(aYh=<i|aprc34D&l41N_YVk
z-@2sN25#`4XlD%rDCc7zW-jP$AoJjD-{4G1US9aKz?mJ*k^WoPAn6+!nfLMI<!ht;
zMEH|?`snAe$#sw@TJ9t40xnSAHy?+8fMm6hZ&i-K_@FOA6#;~i1L$q2Ss<scoQ0^f
zgm1DN!FKwr0o_3MK@){Io={kci5>-u6QFjBbx3J3p~4XA1A>GghcIKN`j~1?v9uiY
z%RZ7b#CXY8i=-Iip~aC`7L~qFRuK~U8VsHVeREDKc?sp8*;+0NeZ)Bet{A96?<%bY
zmSl_(N`XiyCU+*Igp7i9&jLOhV7Rq71oT=nEGFnFSAjHEVqHeHWk8Ge5*{W74+pi4
zwT+_$fNt1?z~vUe)?8hfgm06^;A72zc!%XU2rK^cBBA)RNK{_>qe#$=fJhX8u|9`2
zFRmgk)0e>jb}Rcp7vi5R1SuKJgZXqI5<DQIxh)9R3^4A^Sey&N%}aHH)&ML5CSLw;
ztb;5AXmpericTdgCg6PH0LPLZ___-?b5csT8Wz-1&&yT;PBB=3XL){0{ya4hO%U7*
zJ{GK^RVkhDjMarcN(rhFuV_StH;p#^iK<hi7=qpKnKrT=4EPXqhirW06!T<1jwW>t
zxilCLKM5s0#tj*_!54uJwm$yFEXF_;S>WmqdA38H+CU3i;}XzMl>dB1FjAp}c|$t_
zcuFO&3j{3EbUEX9``hUJ`|T$*5ct3rni<38a?CxB-$w{Ffw+txR&g)oi`^iB@!%cM
zgnD2-4%i0R-XWu5-41AK1X|pN*T#<{H$%flNb+%#C(n=~4Vamr6{y~-d_TmRnsBmR
znfyH<6c|bh=%$m00UWAA6rAwJc?dAkOjV^|gB}j1Zz_=bLChX0YU>j87?4O7M}Oq0
z|3sKaKL`HVT5KG2XGC|*kx-vSEaiskzJdN#zc>90LVwu(`MGM)OGdyH?A`;=94BGf
z4~#BIn~cZ+UVM{Q&SO?dwAeIiX`Vpmw7^+BV*u#}UW-mcGuLG{WzspSa5O%B#u?3>
zRn*3RL9M_1UadF&uUh}d)%qCK`q~23J~q;PM<=h{vk&g0M$ltX$rjIgJ4uQIZa|Wb
z^NK4mqlriYa~_mD(1`i{-hK`Iy@g}44Ky)AQ{a7~n=djPphM8#y0d0HRc*PdIFKdi
z++Sr~-nh)jdSTftzxOq8$q4s0%E=9Etv}pQ7`8oyt5ZWv_Y40TS_66#8A6Rk2fyPx
z(Vn^vaEWU47qtZih0UWESi0Y_bAVOj``=Q6BUBTX822sB_t7^ISz-)oOQXEq=`?rd
zI%h^5Sr9%32!MbhJ*zM`goy-mO7LStz5j--1C(%e9r(-|VAEEl+R^mu-=-EE2nK}y
z2_D*U4&e8vap$0k22=d!L}0fy6@YWIW`oz!as~kFIsP?J`ejGJt^IHMwXcEv(8m%L
zCZ+%m%47MaO{ig;Cvdqna7|XL2ziDs%RUookieyvQ2WHwfNiHymm~i*BS*4;H$MdC
z?3OPI{<IViKh0BTbmCjw|7-<Xv0Q}VIADu!2f9!(?&J{`+70Ne|ABJ;+<*g@1|SpY
z5@l#n39W=f6N&V4jq3d>1p`lS$T^<@-u#1UY`J%K^Ih*O!BOmlLK(+^KI1_SL~MY@
zWmp!PlmhE^5~fB7ivsxh<!UsI&yZolXew?XM9iy$p@jq-)_1gAy1K>JO(COk>%h7D
zJGu_N`@}eojPM)r_o+tF_(1yzBwz+UCe8&4nR(WqhvKfI@1iGt&xPfoqo_bZIF3WW
z69W@}ncl$i#7Vz+Vv*e}NCG+<#7xOC)vkI0NHVb;jGi~V0DT}F!W>ee&MyH(TRuJV
z1J?pHya6~LfQEtV^}sR}(H3=Hz(w*(0T)Ta!9z$u0>wWba;Hgo0Q&489)1#4E=>Kp
zgic`Y`GYt&W&Upa;d4}A*~OfoFch%vKIC$JW1v+F<hktx5PA$7mjaE0#+_Msn9Kw4
za1)gS4$d1@Ucm<==cUtupGU$mY}Ji~uric+;3g1*wy;7RfZ95>-?LnB+FxAopREKv
zbRZshBqT}hGj3x9tXXyxXjX|D_zF(=f#(Tg2SCQE96WlD9q^LGwqLv?JMa#`OG*JR
zSqCTJGe=dsfro^czL~&74!Z}#N?I19kU{M41$$v~5qS?eFZ&tX^8tWOvY@y?F#ysM
z(Sz90fL<GhdsHjnhcg&AYvq2ow`mw1pby#$Fo2oQv-~0grv^e8VHpsy4xru-WJS3_
zym1>Yh(Nj#0w84tV6_;(AuNuh6Mu2Tf3hC%3txK{+T>txE;v@&L0GxdK*eUifUn>v
zD;w1hnwZ7m?*bqW$WE=wOTVDswGcqR;L&I0S@3s~7I}z;eSvJ*N`ru*NO*t{!DB|l
zwb=XfRAOm@4!~&xaQ4-_l>R%>M~~p{6Xy5CQ&VU-pLj@k_{O4%E`$;#Klt4SPxSqM
z|Ix)%0OG_la7$!xwS$@`8>pGBOOBxJ#h(Z>z}J7f7|`qF9nhx(w?WGtMkncU-%!Ih
zaMG}n^N4lcATw=D-DM17q5%}M7Pa^};Fpl-_xf!YK^RT~t4<6f(B1T??n63lfsTs_
zzgJ~#{O|2K&2dnU5t_<sGV*<-ua+jF1sqyaUFjvp@3-|28a-RS9r~D&#>7DMlRSJ1
zu=FDH+`p#LlTv@x=so|d(f<jJ?q-M=dgqtl$9+!`e_eO<2rx58kg*;DU6|b<*2FRa
zuI`*-ln-^JMYX%S0*jkky%NsJq|;!1Cze@DSlsjP=yn7|^5zJ+!3wFl+ETKAgw(_X
zvU27EtdP2$hu?UQ3J9qcrDN_X9zVS93F@I2D>UZ-M(guh5SxbptL+71^NIL7(e8Ih
zt^^uw6_MtE(Y^?i<>H5ffYoa~1-Rt@3FY_3ZGc9_0kss^A^*XtTq=-qdE|=YDk6tS
zgX(beVgR$d0TuSp9%5tof<Rw9m*w9-()k1jk&Mt~9Epd??aT^)z?y!<`2h+Zup;fH
zwFECx6|8H9ni>KD?*-q4c(O&>WK$hP)j+~m1euMf6~OWK|B-{qUPX-FhI*=ig)Rm;
zn8msZ0!^F*Edxt_s*#GRV-BL_K7pVOowoDH5BLUx`#+dB>g=C-fQ6l|z;e!_;8HVS
z8n3HVK|-RL3#ga%GupsjHR{74a-CkPAv%#lK>H#}6DaS+&x7U-s9{|+s~J?wU_dPg
zmHewfME!dL0YYYyH;VC9ZsjqwEQpR=`t$9^-ht-z0oI$9f|C+RH0(-sIXW76biyfB
zu;<U#mOX$s{zy(xcYvBlj>F)IV#|DIZVEE^2mmFL6yf^Kz+9%u_|Gp8Xo8ne6)2`;
z;u$J2ooQk5(-XdxEdkwiSRG9Ap%pDC_9@sjG2j#^b8tN0ED2SIZJO6O0j~QL`+T2o
z3`lx{n3@s;lt+0ub}CSUg?2%wowAo;qmBF|1KS4NSF#|o+(+^PDokpKz!1TLFqsn`
zMKWuMLuIV|W5+6D;V@zLB5=(%ff_`*Uw<DXii%nR*d7S>9=pE^cH}RD%_4jGu<{bx
z>!HpgUr~!A?zS4XHGot)#{!8ME|4#~^9-7(?=3Bz1EDjPWDFushezeglaN{4?-cyO
z+tvXd&^l-a2RETd96^#MjKD1Uq3oqR<e>#dWD5(Si;thM{o|wg_k{wiO8~CX3AM;)
zYk<!4wT7qA48wU%Ow(W}72M0;Xl*v~_j?T|`>FsL4CH|ap@~l1#>cCOQo|7%cubka
zq5D6aSqGs%=|?8wHjZ-o1`kusni$!9zHnNl{b1X{<pNDBf^+8i*YzzY;c6K?Ro^@P
z=FK(S<;TvgnYkx{WNrw|TL2<}r_{CrRqgBKt3>n8B!AH|r}RxHF2xp|R+>4rQ?k+4
zGFmTUNA`Y0arc9tIS;PO{C;DKrc^?GE2bK~jY~~cyG{hFGwsZ%9)v~lXM&~nzAd`C
zXONL92o+DwYIk$m=$T~XYXygW_zH`4T+M!+(Ei0+!sQ{O)HA80ZY&bAE(ko>GM%z{
zxqW(L-E4OwDtef>po|HTPqFSe`&`zoC#$c8XxwIl)E8Rp8a-paW61T$jXo}$9M?T(
z<@X*4j~l|CUwcX`vq8qLrdKw;df8GqB{v+NMS<ameYC*KL&Vu0zK7o$4(=?(4jL^e
zcN+;d;GazT`gTpeVSbOI62V?v@O@xhMCSPLd5^}FnzFS_!1dX|PY$LY?p&WQM4cdy
zT~Ep7lg{35$8~F~SvHLWeIBZCL%D!V{8wf<Lnrf!yQ9Ydj-xy6p3=?k>u;6!x~9es
z7cFcx5RZ~5OdNO-wJA8{lcbJY)5j(Fv9If+wgz9vjd$N>Neb>sp7?Ugo91areQK|(
z-onz_^8V2uXq;7YQV68^GyuC6r9evAd#H)+%bb3LJon&Tg%-p`_G`9MAJ7HoW_O<%
zIlEW-xIxrWwKLg<f{Tu%n?pRo+9-xXbE$p*cZa5G(H-P<g~jg(d6&*y{>09E__Ei9
zkK_I7>hIr~pW&F_XPdPm9oXF`fVza@z1oGV1f6VceXYi93Jh(IZ0qGLxtXiib8jF?
z;(qbgZnWFd*5hl|^dM_XkCUQ9c#Ws18>KCi3kdsH5jD=aL<5Q0TxW-}ouXPT%Z^|)
z6TSEafxmnkc#3x0gDsjUrNBc}Fvy<wYSy*S0=1!8O)1?kHO{hMc@;U4P{koxeT%pL
z(Av}|sUW+YO_;n5jQ}9nONRq9`|AWN-Q+9NCEL!XIWB)jm5F9FUIVU=3Qk`L(y0Cd
z&|`BIK{X`+#`pR_u1P=?w`5QPrN~-O3G;GZ7VmRCRuOVZ$D*;+<&m>A8o;%<zI+wN
zwxOZ9ndbw`Uzgl@JE^EDm2IQF%lf33XC^50hxQ2)E5{-vVm?Oe%j@4uowpR@6CEgI
zV9{CE1aJ49sn$p0PAGb`nOfB{cRtCRVWeA8O0G_jF6C(3e=;;?ojuYI&aY)z;eYer
zpE5&#R4lOSC{z{Y|6028Gcoj^<Mb&g|5mypub}wPmaedfq@a4@AI=wR)%sDo(!YyG
zL~X79r{?}EYMb=OJDz7)$D9b{F_HYP&_81u1l`ZsujsH-Px@H16v|xEv27Dq2L0L4
ziH&YZyPzw<VV_EiEEM@aj+S(9SXcG6_m&bNusDx{n-XakpL5F2-GWS5Skx{??dY0A
zadC5g3+M|#e#qQGN#VBq9#zXcWZ83cW`_GK&qF^#)?r=F)Eu@&diV~hA#QJJB%p`7
zUG}_j-TtEMZ`CNjvSj5CDgXA~zs`XD<HG*S6)LQ~{Ha3a58T-QN6C_in}~q_tx)-&
zRiW~?6n++T`S~B{6Q)JFSq&Ob!F$Ggxk+vjz{T<T2K8HYSX#Z7Q|ym6kdPL8?dWrT
z%a(JGGt$N4s|bjz;5-Q4b;Wku*8|#pcwbNy0_MP=mBm(!8t3<$=$F;MV70y5t#|$S
zPU0c}x9rbZu9RvAZ!98xdMhi`RE^}<JmQv)pBlgW(%@m=#he~C$@lNhSl(Jt54raI
zQkYy5<|vtsvr1LlPu72dAfd5}@V9wUPFb|EnyS1gX=Q8ZIpE%@2y?r&F^;@)N(5b{
zM4=0QwCJg-WT8-5*`bK6Z!gLg6T;M@9d@_vPFBdqyiXd4nZn*9kldi@GSW)b!nv!x
zLS(r}H~T^-kV3I0b2qB+J~vw{u+7MI+lRC7_TQVIi4(tqF1~^ve$!neySMIhy>HPG
z?MHoLwomh+o32ZaWyWkrIgj@dO&3&#co;$xB)gh8tHxe#ay%A;%;-D6<IUDd!vKqu
zty@yLF7iGeN<L<}EGAggt8MP^Fi3bokphCOASH$?^EN|5(`YbBQIE*jjf{@BS`KmR
zoouN*XVWZ}ByoHU8*4JUy)>)!SkTegt%O%rGF=0GLaGlAye`i%o#LOx@0fGTPi#{e
zYs6<2lzY9ORJ5JUnMXy^WfoUpP7r&rLoF!#nN@_4_V!L@NQL^BXK`K2Av0i7#K2TS
z0e{i07mvce=&#{&GrJUbJX-T*`cBkiW#-MQorZUsu2UUU1!o)dlF8A%a-Rd5yi&9S
z^LCuUNr2!6|4iXmu*7;r858=6_)gq$&@<bJ+B#^PDwp6#sxvOgZ^`m5?Dl+})oA2d
zcAoA123fKB?;_SS*5&3A2Fw=xXB<_T0GohDGCV7LRS2Meq|9O>;V#3rF=I$IlW#`!
z(aeUo_4{0>r1tseOe#?KevK%e^nwwjW9qRP=<mT^y_nb3j((50rLh7LjXO4_Ci~?x
z#4^MX85svbdz+Nji;>-@3L*s;c1J3ob-7b?c)Qw8QR%BN|KQHKEeV&#%-`S+^zHYT
zY(2&7GY^Oq4R@-LaGVm|_KvuPv2tSp30uAH-s5r0vrjZc{I;#@pw?P6_oS=)K8x)=
zk*J7M*F3tP4|S9A=icfJ4sU8VKa;?(uCe#j^agfZ6&p+!SlYP;H|S(HaQo@g^e>ZN
zW<T#~D{*yf&FmPh`}*M3Xx!`hx%<h87Ht^@iikOY?+PFsA<N=CQm>kqJJ(R2I1OD%
z#rg|)^@LYR>u?S8`r(IjhEyuQ>-4+V@(56+%oD#1nUMl>{9f2LT$!fKe|FWV64yIt
z7Pjr^5&JWG3Tp-lZ;N3kaNJ&EE7Ho40|zrU)FRhcmYoyrEj>;|cY!xDn>1S|ygiNf
zZ9>RNyf+XpF!yngh&F;Crl_KNRHMf^pUy}8jF|98kSG|fp<nCp^?VdA2^%&3A`E_~
z`6Kpw@t3*06mgjQER_kyc~}p)&Srtm$mP<_i%svDuI^(CK~RUXx5mo<Ved`Aq3-*>
zVWpB1ku_UISw<xLI;rd-S;i8|k`O|6W-3L5i9*??EXg|ALY7JPb+TvQ$v$HpX6gOu
zy|3#!>psuxxX<H#-s67m=gDChW0wDK`>vnw=bQ4KDo2XQXw}rP=uf-?gh_tilFS%3
z)Q{iFp#qouy5zjs@@1lDAw<=~xw2D*H)&sV-ON6b<Xh9*FOE}C7+dTBwwm`tN%dKY
zhN`{Y->HfuoiB;&(7irA66gNrN^FVv!+^5q?o+ne5J;+`OXO%nvK%fZfX8JmUcd7A
zX1TUT8$@!6)FgCfD_|J;rUjB|u<7c#&8tRIz)Si?MzN$7qznyGmJFXASEWAjU{Q8b
z>AYW`rlkaPE?wBS*2qWa3ldrQN^^&y6S|o<dFp-gE>JN@orm#^Jw$Nz;awRCo@O6T
z`6PbS>hyN=Gp$_QEO}o1k=G!kl_@MjHzchuk)(#_GMmZZGF~jW<als|X2d3ZY>SJb
z?_HfyZ-wW(g{W=UQ#Fk2wvSkj^kp^)1a--7=J>4>pbzHldMM@L(H@$s=>=60B|U>W
zk{ffeV#l-8qdE5@grT^ru7K^n8~S0ij)7Y>8{y(GF#E&>Q{Y<Fvgr!d2_-${9e$y9
z-K=geX`XATW%}tcB1jGF2br&jaVkVcc)Nj*LCx_P6zMF(6V_Ez(@We_??=8FGpUQX
z&xcvp@MSZIGFd7%YolMDozkLsL5SE-^z6A8BLbEy?qr=l=v$}Iv{mSEdNgL`&8lgx
z?ZDfQE+D^yP*0ZqV>vmj5>X96Cu47tfs_649?2P5r_B1CcuB2WT4jQP0V}Sp<JGTu
z(&Ro^Mi2J4R7H1M5BiK~j8@;yQ>+oIv3cM1*?KHP*Rf40o>Hvin4Ep>jSPp7>O4XX
zRbWqI+uHOer%Se-?=#1<ksu5#mbc`JuuL<Y8dKVyv1&RO7z%wAN>U`TbdepPc=Fme
z&LswV!c#pwB4p9i`OFU1u(Md(XL%9re8zNXc|7V;gNVD3@VDkm2d=5?JL+cDFw8=b
zc3t;taWa~1$-kC@(o{9H67W&*D}zdOXC&xAbOBlG0(v5@-j#-Q1V@rDiKu{$qiN<~
zY=<3KmP<0LGX`5EAhMyhuVS=g)Nj0=dSnw$ZIx_=yJ|&{qxodD?+&^`38y1MIYnq6
z8Mh8Jo~MP5a~0BxJUvH`<|@&9QeQ)Rw4l8}1pB^z^pPaYQe}+QASfsMmQ=ds=&hkB
zc-E?G*DHbU__AD0h>FP^{2VBwhk}@T=tpdLg<Z~wPf+d1iBcKZ*4CB7t%Ti{N>8#_
z7?19|Y-DsOi)!Xw3dSp4i}`hCmzH=~f%fI-{?i?Nt<EK0U@33^@w8L@$Ep9jzyGv*
zx5U4gQvP85|9z?yx%2;YtE50_!GEzL;1@!azvRCeRB?H9j_&ceiinB(Bd$7i3H3=q
zt~V{BSs#yLg{5PkJi9v>H=V(Fl4BJ;w(<EB0g);qid>!ke!bR{)s&m(@>ES_Md`6C
z<p>4km1Ujl^j0}t<LyWA;|ZSlz;`ZeuPF`zbi<-PhlX8hho-$I+bc*+8Mf^L#P2U!
znml4!H`x2vR$nZL7tfM~`sluj+O2u(_KH|`$1Up4pXIYzc~kQ046M-vW#7VbzIQfl
z#9e;2x$&#2dc8F^7Gj%&)vTPp*B%p<|1>hZF8S>4GoSml%q2qjY}mLto+_E=J<C@X
z*of_tgQ?Yv%AaTT|8V`JO(1yh43E5U@DlLmUn{|D|JEZeR)-P2OHNAx*{=0M>pecS
zf#S+2!W8tweEaNy$xsH$Xf~%~iK&dWM@4B%=YEk$Bn8IUP&-o8uy15~i-iDf_(YhT
zq)A@Sx%?+S<39>XB>u(HB>DI2NPgWlf7@r=-KhWa86|(IF!>+qGwwB{`t;jp{OvRT
z>@)t;f6V^q8oa@6O?@`$@lv<epmq(ld{A}$g@s1ad=5@2XNCD4zJ-(J-p$}^vL}MR
zbZ6F88E&Yp)fhiw(X4(~nV^g9*x*oQHe&w)?fYXP?ti*(-0(nAkRpLs%?%4-RB%b^
zqnOsq*(7rD)bMfe^`_)%bOj}DnkAWtaNn^!#cp<JEkR$qt^5?|Hl!CE$D`csElrU8
z#(AurhJWL0a_$b5yFc|Jg@fRq=A$J`X|Q8U;)ULRM)NYMTyw~mgFBc;Aks-&t21|9
zM;@ZB5q;Q)&GFPa^-l6svZh@2034;9?ay6V;Vjab^zJFJKQ}6guvxieHyDe6eGC2Q
z48jhl9>Pu+`G{*QYl0`w*%DhMR$#%i;@u(W2w6BNrC|JU2J~nRaEUae&kc%t<}<(F
z>lul;XFAk0JwN>YzEq8VE1SoB&`YLpK0;uYkF`MT1dG4z$txYw)3bx`I41e&;VBg+
zy%FTT%pK=|f{$;>xiZaLA3v6$;xZ?Bq{yhVGY`!p7)NMh+|SxNH=P79@Wjk9@`MV1
zV27oSB7>7cov@;NeVqmS%@>gePpnIAob?S^+COF&+wJs)PLuU(p5gvIak4P%HI<Y8
zIM{15BG+?;ck?33Cr5}fl|<z&Xrkg(Tm!8ht>UOaM&o$SSQQ&jf%fgyTr)Fs^E1V(
zjv$l{Fus3u5C7Bs4OD-jTE9)^JY7ETdDW7L{I$G}vJl-pLrL3%i;$-5A<CXP)D40^
zSNRtCgYTL8p*z*9_?0aQLf_+BPv3Jo-VSign;mqJ3CoiS6GKNzJ5$`-#F8}v#xlgo
zvIbXP)AYv2m_yk>3U{oW;i9sBBK3U*zgYB%V7Ag2n+Ve>cNQZx?PFi|ELf?)X4sod
z1yRG-B~-N1=Br}0XF(GW!ei;%*Cx(Hs=^|wjg2|z7_O?P%ZIID^A!ymk~sl0p?PiL
z;JaD|;#WBebs~KlPK9gLEqMd$IN<1X+^8)ry%+K>o=y1fr*kJJmA3OnC$Be&J+(Hn
zyA|1E^hr+GTfBN*_5|fr*`dwbI;-^-daV-IrNo@CJw~&6x(a;Rwge9LSL~Y4KTq2)
zk(=GeA>UR)Sj8PE)SY~fz4*-3g*XIeJVzQ(#@2}A+non_=I@2^`<{+^m?GFBu1G~S
z?=)|=Eh?OO+aP1OWD8M)`eM0f>_xt8tNDodBV$zSpdTm*$y&%uia_l7TJ>h~thA&s
zhrOxp@=Lu$imZX<prsDZu}+j^%Wqwsd&Ad&n^smg@O{HN+7#WM?_RNpxP=>5xS2@A
ztb)ZZ(|e<6J|VU0$Rpitd!gD`g>kq~@D0Owj8wBv!H$K*=YgcwBLz<WnsyQI>3a?N
zxp?Hmdb?dw2HgT>&jh0<)M6g4?~l|~D$A3Yd^E>UqrKs+>R@*Ig6?6IxGqiRCxLHA
z0(lM~l^pM(jN>NY0(GWOYo@<exR0F6Je^ytS&UW>MD7DAfQ{!Q;(ywE|0qoXzh&SY
z4(KexcPfpr^I<LSh1?C)v}>q_LvAZps(m4F?2e<A4@qmf#&l5g{0*GuXOE>2Xe4CF
zX^fDZAuW7v5d%^gW4t|-17nr3>ae3*nfl}oeQkW%XuzSOh~*8T<{6Vt*`5L)V-XEf
z4?=j|aZ35nMZAxev7Mc%=&NT@_iG%(k^0Zn$DGjU$F&OG_8Trbde3S0k6KkeHo&tC
z#q#iClF#&uNUv%{+`n6`NrUn$yFObN8ZEZh5^_FU!^UvmSpG-`b@$jY!tpRiz=vDc
zy?IYSxrw5VgeAf|<)c-{hn2sCtl5`I2sJeC6{1o8P9;l<@Kf^HTH?!8tUA@TbWl(D
zu+90zfZFn-9!skXt$kmoB)9SJSIbGzR*D1OhI0eXUOVW!S{E>d27siYwJ?xq)_^{}
z_;2zm40`1F9P4NztPJuhB~mbIcLq#sGETFtf=CI&rq_dUoXFz0`GOIJlYD#XYdLsQ
zPaxk(jlgDJ4eJIts}Jgx@eW$Djm2^XpUYq1pIR^8P8-Fl#q6XZ9S9!QJBWw(z71vG
z3U8KPugP~Kj6ZhnmiG*Eh!0@xh!r2K&lhq@6a0k5ut)_wN}B2?pA5-ZoKr*D#tl6z
zMMT1yctY*&T=I=>x1)J~D2=yamN(a%Wd^~8PS$a0{`z=z;(jxOyXg~XNF&s&?+9nN
zIx5+4sv6tgf|vEfxkkoy4wE!0BGrasI~tfTQ8{0GfL~dY;0bgZahgGKw8vSV>q!so
z)JUs%71cd$!p478UEj+0bN9-V7eui(fLeq;SM;hcwPQZlveaEg=3`6$nB4?D6O{n)
zD?_N3ACT`qVYS_ToaW0YZBZZS2jHNuq5mpH;z$M`eO<$3FvnJ2dCiBYQNqK|w6Fk!
z>*}0&8qKj(kxJQOnq3C!ow>QEL_5rC-@mbmJ$ZpzcBRe}LwlCL6yH{uGJQjn|Jl@$
z?4mq`G;b1IH9Qw9*RwoG#I8ewS68yfaixa?7#}GtMsF|rkwL@OJ;Z~sX94Er(UT1_
zf=e+E_#(ycOXq$0O8QFiT-X?+oGJ&<iCVU`+QEtV2~EcLYKHkI)|M=Mq*kN@Mwz;c
z57v~E;z-BDjJuz!cjmcF(}U~kk_GW%6#<Twx&VyTr2x}zlor7=tA$<d){~3gbm0p7
zppop8BUQfW4uWw~reWrA`j!|$0Pl@78My;zqa{6ifx*dv1mv#9sd`5``d2~|a_O^|
zxFcMs>uiPvZpfmJ`DwHaM0TI8$CutfPXJn5v@0h>+4DP<olT84)x9u~e#m}w#*WLc
zPx?H%@Qr-Za}v@i7zedzd;eA2LO1PL=Z+j?*i+L2!#CnoO5n6!b@DDbfsSL|drBd?
z^&m<4(hiKl@)b_Hj;}+^MaA{JY3*gNJ%)?~((F3A(M`0wpAu$!ZyWy%oHY6gAn*mr
z2SfC$bR_hWXD-w$_zV~y?taW6yERd9pfY1ZYHf}}3uI|}yg1`<7kxFuWU$mk&$k<W
zAN%n`I@dOC>J?x>UDg<v*wW#^vl;h0Wd|Lv52sxVr!Ko#I5{|Dr055G(w9N$Ea}h;
zOfx^w+MzCzSE>kMIpon59kC6237c0`(tf_5ZMcLmxDE{>-Dn833C&hf$Z}*f8(qwV
zYRgIX`R{^OD+|~D(&tC3lM{;i;%dzve-)ZmxpVS{UaR(dKAzE&q&nX^e}={3w`rE#
z-J;b9Y5%Chd*N3ZRoJ(-u~U!+Y?k|tj9EJ%iKBL89udTH@X9>IOYwTsY_6pEhSWYZ
ziN7dv^iyy9)8M43=u6Sw(i3H*7jUB~mK7fEqUf5M&7)f7r-Mgihu!Jf1@{5@9cy!X
zISt`|w@0DxKMtPgZetGK+wNA!MW;$|ekszd{*NM6?t6=J<Zr(tWj8~r2n*hv!*lNs
zwC1NppC7~J7*cO%!;L=mWj>C`OdXS$Pb4&n_F6p#H5)aU+eb9TD&W=^#&ecZAFs;t
zPZKt4kPT9`#w)eMnj2QU^Q(=FrY>fTMK^9Ls}RQ30v8TpuD8q)6{Tdov{#{69<h3|
zt76>*YkS(#w*+mR2H3WX%6I>A^NvtxK0PBzzPG(>9FuN;;zrpTyX{UQmGXVqLs%Ej
zvHZ9zxDT(K<rm{eItA0N2NlOq@$p5bRM~_%nmsx>JPMjj=?#$%R+r6`hQl-rrU!G<
zlF8gDWY0w>hhDMF`J?7)hMI1tYSTaNZJ<^j>chaE2FT^>T&f?q=VBt<XvgU{&0I=4
zpHlf2BV7;m<s(`JI}E&-_x2*jk&XgQ8@^-HRCRvz^k{gvBfC@%?XlT60%8px*x|*^
z#u%g+>MA}qo$oPSVbLYmD*}yBF2Ov738i&2#QhE5GtN(Xqc79bZYOyOPWHTHsIP22
zD<E^oDK~Beu7|RjRIwI+K5*z-pU$a-p7jowfH}n#PlXmpMRa3b(%0#i$(sBdlFh(g
zVuH4ZYL<AHf@tHxznaGUv^jK+<A>fTW>c4RldJikAJ*<k^qQ%9jZTIibI8mhsdlD3
z`<T^yi&K|gUmIB?EU{#D308|Y((cL7D{x&w;27ps_T0T*N@py#J<ARb93zG@0;I?O
zlbQkMKqX6h<uqzE8I-B1zp3WKOU)O5A{{D<Ix8jAJR!sbOaVDNIt|h*g#1eOn49PZ
z2ifyk*K~E=RypZn7zEP5<_2&O*L=+#6THK@j;);=NX7FTGs3)-%nGjtC49^CdC{d*
zo68@L<%@1@bvH>)Lzzub6dg5faPt!a^k%Cj<5%eS9KoROoFutf#Q36?gfbP)jAL%^
z^)+Z-6X%=RPesi$DhK*jxaeu4ICYi1iN$1wSy#q<jL~?Goh1(7G(HW4P=-Lo9>DJL
z*4+FHP4q(>`4SZ_JolORx~FzKXZTrEbci1v^3p@~FY%krYYhEa^(Kp+{?Vnurl&$V
z`C_lu0gfwfg#7vrY2k^Z$E0nXwixJVPmUQsK>KAp?0oD7*K~1Jmv-;m8PqMLDM8A5
zGx-RU__Y#)ip<E@bOOrT20JjADGznN4z&8?o!cha7YdSw-M>@Gk<Ql_FHFoguic>}
zd@`7-xyYjdc}b`Yh)t%Am!>nDzZ@$5<>=t{=4VvrN53(Oyp^IK9Cc^!wtM61^C1>0
zhMHMuy3u~WCk@h>O+oKSxm$BP$*z_XM0MSz$-}Zw%R)tZVraJw<L+wkWKgg2#4Pr#
z&DIgW6*Gh$PkZ)Z-IVpzUG>%{?`lwL*Pw@pksKLqPu&+$-;mP?&ipJSLp{<g=2XeI
z=P^q?7N^(LrGT0rMK%3fHD5-e?ozJCZOVDC5bvz&M3nXiO;3(4+vD?k-&b)sWTyL2
z1ABEb_YSaE1;o}+H6m_H7I6>H@>k%4<D*1p*l163P){3_A;<Qhn+uOu5W-><`^g*C
zuMqE>a3+^?dSnIqjAKAQQmk_@b4jR8gc08b;1BJ6@MX`OZc5m8(3b7P3e4oA_K`Ei
z;f3tI-RG|3XuX;mGCz?X`#tt)s4XvDQS^AHs8e<+$94?)$`HcvDagV^)prOd8<`=>
zqF!z_a}(AoznnoX&K<G5vs%@s&{pWRl<+dqzDmMMgYf)XAaBjb$3rT|&CMOoT&NM&
z%H)$>stahcdUH1&I$^kO1<-Yu2(t~Xw@MXHA+TpKIObxoH6H>k`5v0I_b)9^h|_po
z_{R|By(i-q%O!5jY8STkOY&zs3{js8v-J&jkC5lsx#&9U%<-EQQz<#<a&4FL#Xz=w
zv`%|fnfTq*-sm&mG^D4Zy2sKR!2O<RAHk$Ugtr`S3AguBYxNH#QCI+97EZK|zgy~X
zw0Uco<P-W@aefN)1lb9{c)7A3yY4NJmi{zjUy<Hw-@4K%aKR_YCm^3T{J&EzS(wc)
z*vD<YO13C#AFfTb$Cz!M_1a!<V_Ka#_g347$LPqHm}_c*rRe>6i^qpi0<{~UEj?@-
zQ7wlI@2V`R(a}%!jtHwy%d9@p_!{|UU(lk{?EI$Qz{MRw(pj53=Et<XXHv#iv%=YD
zGxqnbp*hiAK8`5SV+rN1t5$DFQj;!H#uF@>h?b9Tky||_XFn=v2ITBK21orO{GW{-
zcS~~qcmvpLup3A5hvd8$iOfto5oM!M)02ZMv$#CbN{LOUu4@)Bqw>?FuctH&?Wa#R
z2>=h{1gXuptWNg|i>9ynO4o++U`--#uTLC}ZeP(h2DfjP;694A>4S7v(e`gEvn3m_
z*2j;HH;*;GF{Jmu?+uqjpGDgf92`!g9u%#|c;%}-qYGLsWHlf>gscXb7l|NVE6V95
zFi-bGJ2;E<RedvtUh*=Z@lm9OH@1df6cWCB*FuH&A}w!(PmiB>17~Sh&E_-K+Jfu8
zVWo;$*?SSvR_&nJSL9TYXn+`_;Y{7?rZ#{{8#F>4l=Rwq*ISfc5*3d~lSlpiZP+&f
zxY){Z&2h0x(NQlD&pIJ+khNV9h*=E?1{F|762I;Y&wpVsRo#V*p^y;<Boh7@$3`-L
zy<z2&3@>T#7m}RwEKo@-bG+<-oYp_yXIX+4=7#i>I6M?C<u8j4GBH<2vFuL8ASJ}R
z(x*6(2KTVu0y<t5$JLTQApHW&MtNc8WRD4NeU*1;misuffALP?CUoC9c;A!Lrny30
z&nrKcun&+WU6<kZ+LqgCCI~wR=?~>3Y~jTymwFjzDtqpau;6dTLYWI*UY)FrL%LDo
zmaiqK+*aEBLCHn9KOZq9SP1lrfInRW1w!Cr@1jh6(G38LAz}Q!xF30jHO|X#MYdk)
z1HAZipB~<Cdzs`cd58IIjsufT=6>(Bl~`!HyZ2UyL#)L0_Q8`S5$RFyb$j%q@5+6H
ze66WlRpnc|K2ZTLHclIkc3GOUEh32oOim_%Qv&6fFAS~vg7iMqB(p;I;K_Afo!2&l
zEHSDq#3QnTDk}Gkq3t5K&X|N>#vdDTZXykT4in6l1ES&2k$zQ4Uy87c7EJ9}M8c*9
z6F1RoW#F|vcVXBzrpC|FiRaY&q8A_QJUzHX4ae`_q5{zx^xK6=LS6=LZU@smnn~sy
z<6*dR>nwUI3_&>NhZqyMge$-<!Q~2CEge;>)S8!RAIsXz1rG)-gl)>N@jmE{hCUIU
zJ^V7YWVOFQ_LkiVxYlTlpC{b+sdo}`(ULo(<<ZPCz{fsNW#OJ4@?wp~LhghypI5k%
zD99mzbevJ@?S$Ef5I(FeQ3ShBGi^6-G30N#?Dsxes{FEEDH}=1$OPqPB&DA8{u$T%
zH4$GMUS9Sk$=Hvwe1S0%FF5Mij8QY~gZO%IiA6P1i#1eTg>#@YS{ytk9BSHlgYbDu
z<Ez(Qgg4>sUJKbeVs)uC??B^3L(0K_7buZOKm5S!LWs(k;gy&5Zr;|ZJ{M7pe9P&=
zkf#7_#Ry8<=J}?HgoS5i!4N&6LB3%7Yk>Up;Ao8hX*i;`SS~-YGTI6~kFf9&2-;Ls
zSTduW*3@?CjZEtMNby#JjM;_6rHu}|Vw29-m2gYb%_<YWQ)w+{#}hOixG@iMlh}?Z
zH1UV<FFV(HYzvaI)6q}zR`gNb{YJ`HPD@QAFjn0V&WR%c5%2nNgG1VNnD!}0!{|u~
zf(v%sT&gMHc6sz@_572srprun2lfn=-fEahT}{`tbU1#CMebbB=_#xr8bVHY1r>3O
zj)e%UsqGUe@r?<ZytxPT!W*f)R-wN6xGHR=A(P9wY$=yXNbTT2-7EacYC*D+(~_(g
zN?Ka1z!g_Aj}Z5%3*Y3DFlM9hzu^Xr?%FZ}`AVD;&jKNv!rSm~)jk^D2Kb0m9K93P
zHbZ;46X45r?H(&L@Z^m-qsD;4`C(n-m5EV#ePz*_c5(t9G(srX7(=%?i=_0lxGgso
zrj=NG#*`_#d|7IgAE`zr8ylV}Ff!_edP8m-AEB8al6#oSQo&qQzKhTxm#++78YG>z
z-()yEhi9*d)xI~9;Pq@!<qq=ttnx;xD$A<#@DL>=WB<W-q7N+n@x5ylmG>f;wNCYL
z889<Q;y3DzE%ZgSAfdyXyCIx~vEYk&nmZk1aX}lhDP-1s+-ROh7hw=bb9y+PFuE=$
zygfLPoI%dTA2yD&k1Oz?m$6qiVVuPeqVDu{NUctj*FPq$_ep%%&f|Bmy|bt6<y0cQ
zd_0lDlHpe@?4=n93Njj2d67PST&%}vNo&C6-xr4-B&~c211h!{`s%N30%7yR9G(i_
zoL^h4UDwE0E2H)h|HPr_DVd;Y5pz(>{p!PVKmLy>b)VxkM2YHn!vnm9AI;ROloAe=
zT{Y+HbCcU@^BiT!ffiLbWT<0q^*<`BhmVON8(g5r>+?#+D$~4q&e?mmsJN`ExvTXy
z=ONBOli<+Mtm!uW4a@{0RgUM7WD=c-7gBgzZ8Sw`H?n(_YzV1SJ^|2K4nAG_&u_IA
zvgap~KOKWc4uPJCo@?akp|~w~EW|a|9*70Hd^rK6-(q#Hxw1{@yjh~qmNR)2HzN}X
zc59&`M^^h8qC$FF0{`gy?3j~x1HBoM0kF216)3k@N)f@;mn))p*)~!zn0BbTW^!=a
zSaAmy1e?1qru)@b??)_#kkD|)UfJyuUGlSxz)kn(9h;p(Br=#!^jj#yU&@40g6Ug?
zQ^3Ve>(S}OM4hBEY%JYNlGo&*)B}sY#SI&lQKY3No5!G;Vm?<?@l#>@(dk=UJAJG+
z2L0oXI$rjjI2T&$wV^XS=JHXP6o=xBdr3$a^hE*-C}cV*Gyt5d;~FsXL^A_<Rb$5=
zmfV*^I-c*ZcOaBK(>!y;u;J=~W2k^kGGz6NL9qn+NTbl2&9TJ<GSna&IHN7fgm%31
z>{msxcUq@cP0x<nEDv0A29x6v?%x*-%OhD<Y3uE4<2-QI^VH>+-wryHh&T1-ELANd
zkND@JSZa&Ko`friwIw?dHRs{Rp>ItWu>%4QCCkKeHueV0s~!KoXMHK~PPR@U@;I&g
zfyk3$qYk#e(V*me5EJ7&49|=L7Qv<V6+EcEBJkB+cdErJpI%3bz?y{t--6V@#x_WM
zS(a^o{Ub8wkN06&@HS)KRkn|}5wkD!n+?EBa8d~Ti1H;%nB^o9I)}Cy+XHz4q&$C9
zP$M-hw(2T{9nJ70YxPE2c@f6y3t79mm7!NQK1SO?S0Zk_WxFY0(Q9J~0d{g>02|oJ
z@NbvP>Xo;}kTqV=LwK#7y`7y3hc#Y@dZ`{d*x|0rOt%MH47UjP<41Vm>J++@beqI5
z6!z#a!940kUA9SJpvR?sHCx0cNobcVNz>Wz>`Lr4v!yE8;YP}dqWd4LBS%|}K8?S6
zd2CylVpQ9g9SnjfYpu%}%ID$6Ru9IY$I+BwJm1yYk$ZO+L(dT(-ehw}UXflzUf;?y
z&I3Mzjtz(-4XN}(vR?rofsR_7Pj;p48oCenqB7~A!D2L^a>;liK6<?s&t9~gA=ffB
zHLz`d11$gRzsCJnJ=xv2Kzo9H3$&+BQfb4>D=$ehHlr+Sm4WIvZCGE~94R_n!0FQ~
z*vG$Q#7-@c{IJR(EXyoLK5!7>O_C$7+<$pm#6^sa^eh~KlOE0ZO3Ll-!Ns5kN%|SJ
z)@w1#$NZd!4lVC5P!dlh!al;H0#4@pV>mCJiaG4W*}OfkVv*=S9kO6qZk0I6TM<Qm
zQ)9Rk@`8xjt(UtV(vd8O*IfhVMP+T3qiTUvjSKB#4*j{{;i!f9sf}ShBHQJPivAgL
zG)=;-rSi>8S?ryOV$Z>;?v3)6mo*2M1$+%<u5yHOY|WH0Jl*P?1G%gX&6CcN9XXfB
zcw>h3LzJ^>;Zp1D!ipP0oy(n2&WY=F<G7bOeu#bcN>cqY>FY!+3PexHpuj^BSXO^-
zRDs8jSW%lG90*vg`!$=7{7bhQ3Vm$p4%_-U(<t|&(-uC%sprtZULG+NWNjBZ6OgO{
zDMSX8k|ZpbtPa<)xc)d`s2<DxH!73$%$a%%GhJU;V~qP6m#Yq#_{JBLdr7|Ma?IWO
zeA_*i3OCSNc>-geX%6GWvd<HyqKY5xBpVrN@FvL2S`-JIIX#jJ&2iTXcq!{UOgU+^
z>ufFNo&nC*tIgY%7G?EIuM_P{wDL`?n3kssani5x(!GND&+o&HZ{$Fa>e%h~<@cU&
z^q0Su*)OxjR}aA=ZqIcD@Y*xpW2&4ecmtK7iln9fVhgwFtvpnL+<eg;Z2{9N+5=o3
z-<MIV&!+Yu5zi>rRW+wFun{3KqeI9U3^V>ILk;`et>|zVxso3>lt)p21&Ysi^hwwL
zX!-wo-%oF`|E=%Gkqlo9ul<9Y{Us}|cV?AGtQM9mF_zv$nXh%ckI{J-CmdWz8DIwV
zwZiX>mBT&1#cY4@H$ZVhA!0Qo?2_K0_u5Bl*zJ0+cOv8z5K|xYx@P>vJ`*e%_L@Ml
z`Hn79({Zs`Gkkf-FloL4yO<v+ak=orv&`s`eW79Nrwyr*F2X$l_l7~{1oAkeN$qGL
zlhu6~8~(Gc72QC+>E(!f?4rIW_-rS^lvtN*tsx@gn$En*7^E7p)vrj~Jo$tgzs)db
zcC%-mFGL>1R8UEA6L&qw5xi2+64J%!vkA&|`|i$qc~AMi+9VQ4kYUIy?~|?0c^;*n
zsaGW*hntSdQctUWO+~6+1p$>Rwv2!)Z+FDn&;)^1WaP^}z0>I-$ia8$IrgT(6^FTg
z68`pXmHGB=0QDz$`yc<_p&4ssaK?3Mn=(#X7o4Lzr*U4K=9|hs|KkhmPZ@w`-rI)&
zo_X}yufQ{>o5Ywk<3{3lpdok8o)+vJ7*szTBX`Z{f-Kerk_8-7?%BwD>oMMfUeD;F
z)`VjX2uC5S*PSharIMG60eJe0vNmG(&dFY(D+w2>vEq--C<JT2ma(+QQWGBrT%2S{
zpG{|?h!CqsQa|U~(iWZo%k6vOGqJ3VWp~trxZJ#p54x{xq+kfAI<!!Y4lJDYiB5ly
ze>e}y5^b>ZW}jA@=eYDU?Y(4;sG~KN_6HPOsgiWMpKIX`phX_^oAtlpRMWMZ;te*j
zAE>&A?(hM5lkVNT2}t|a^C(R+=lfg{GpWA@LMriAMEf6nS~m%xaW(Uw-i&e&U!e^2
zE-r3uTRA1294+x`YdzpL%8^yvNjj1L^eQ1Lz2W?dYE(Kke?VjSywAEF4K7DqN-2q>
zdoh6+HE;X!ba?Asf;uPy6F9g)o;%%TS;_DklrHlgE(y&`J5(=KENsrT*W#|k{9Od!
zbqhcBPvvY#y>3xWD^XLX6ABMsKPLoCZlD|R^dM;xK2@}vH0i@BG=q-ksq5l}S7Py!
z(dW}{AC?gRbX7h&5HdTkIm%;o1~oRUrA}w``gZV08R8k7<EG_l3xZUteFI)eyE}uv
z2?G?`1QZ1F7XzrQFFbY?wRyZMM`cIYYG$aB8t++v7Uizzf1P8k&ZjHThUC$Ryt$aT
zF{S|boa)&Lp*NVW78owsfrsEw;iXvT+8&_=V(Dk7-)vXQ2yq#lZ2yeuzl@(+J|@b3
z0`bMBi*lhN{igWUOwmVs19cgu0wGwZKIpAVsfo^F^8$nBWW&d5@Ecc|JeJmwjeSwc
z-BZ<i?JX<z-z-^gjPQlxGM(9kphT~;6w#I$KRdsb&z#IfxGU#{toyDhqLc3j_cwfC
zh8Is6El~~@MPjRW950s}4yHY_MZF51frg&JK<c4xe8kD%%uz<6O{)a8Tws^DZ8iwu
zW4D(SkK0^LcgfH|DP7=zE3Kw(pwFPyK#t^;nZx@7wbv9uj>Ns0nR;6S?l~(pH*S=P
zqON6;%a8EVgkv%%5Jgw!WFlW1-n$jn#_~x{(7S9G^FThBNB>dmseH5}hSAg1hCZv{
ziSBsNi>o2H=0ty(f>rKx(e}Bb2_he9ee$|>o&DEle1CVerGtXNn$|doow}|4r4MDf
zgyYrG<_$4kedFF2-6S!EJLsI~f0Jf19v8o(00M&`+prD-gHL*+n$<M7lf3h1dtRdI
ztDM4w&5y8qBckn>lJ}31-+G!KUAk@H)V}({(~7^Zb?DD9BcVR@bsG#E4*74cw#YYo
z-}@Xei~k(IIY8=T-_W28jfZ(<Tnikq@+JZ7GfQot%Cyz-8IT}g%7#dKW##Pw34%z5
zH`O$FmPX^zTBoUQMdx>o4<6<`<SWn9zsOr7?DPU}xBk)oak0WnPTSti=oZc!+&S+w
zWEDMGmTt~{NZsGtFkRLwDmialt9^S-NkNQYGeb7N7HDHsR{r8tiznpDxEeDnKTvy8
zmSK=h_PW!yh{PC2t+Zjy@(;_S3Bay@^;Z)~J@#NZLnB2!+LT@RRCwXBPgL}8tJ2X)
z%Kru{QRij^j?`|31awk{z75z{T{?#M$%}qr1HwmdfnN@&2IeV8OwvcgABCGp<uC}_
zyb++qeqg7>EJ)2l_vZ5XS8BPJ#Y#p>-AQJ7$^@0NYOXw9Ma{f&l~Osr6HqEi{P3Mh
z?~7ncCLwHDn}J~zd+bgur!T+SC)pcmLD<S0F~dk}cm1c&zxlYN2J9riQEGi~IgUv(
zhwZh9yW3Kmo7G?YLsph<M2&e(HoyRJk+&^*sx^aG@L(Djku<p~wc)EO8ek`zxAh}a
zf;x)Fz{Xphjkkg#F{4{>5FF5xXm|(Ar3)0czx0&=&_n^z|D8%ldxbajda09w!<j2Q
zKj1U7_&WaxUzx=o8|Juy%BJgW%x;$>o`24_uHlvw#Kicu!F_8z<??fXoG5bWSTDm@
zT$_A6eAOUsXj^J+3%<aE##wf1BWMagj@y^|^2yP-kHetxsOFCYwSSJ3=&LjGPO#rN
zV5Rr`h_12*B%V;>4MHq=`h!Ol8n|rsEjw4|ZwrACOCIlJ%&K~dsrk_n+rn2Wi+eL^
z@Y@Xwx?z=<)tn5T)9P=VuY6gP$Aiww*L(w1GX{<(8?x5h$!>>wotPb*;(dj_i9SG>
z3p_ho`?PV&xyhN!?ee(;J%YSEAc!bF+gmjlJhx^e)-SUI&sZIeFu~f?xFlmL68W|)
z{kHuvfsq%13;IQG>O{)_TVC>KNoVRojD0qTv*LkOjq+<VOVdxLxSLrFlt<6MpY1Hq
znguC6bb5e1Na>|YTm~sUHSVX#20Doq3-1tTJ`8^UBc?pU+tNsx>rpWxd${~z)31^&
z1B^7c3yED1&xtWajlCyA?GKNpI!IUPBu{6UynU5X?aX1rUE#zOJAW~pj)*tVR}IJ~
z4roG7pd|>?0jo}4#<gN`%m=ReN4KhwlvQ^6-olUpCa<RP!xM!PBGytDbT3AP-BmiE
z2@TClJXLwAW<ofzRQm^<tsT}%5vh7=fY;6Npmq(OST?n}!&qk8L_?DtT=lG{n7?B^
zJE81Sk#W9cJG0%BtD5!xcq_5KZ`XzN%wm+-0BntlqJUrHxP1ecHBi>H)fFT5yqx$D
z%wj$?aqqt|<r&^dCP_&K3J-LiT4Kr3KEx_#%}gZ`NrIW<qC2&bT!ZqW#`~f*=`ReF
zYt63R-0qXIu&U0UD#AaD2x9&CVB*TXeK&vP*Dze@Gm~ewpq(NqF|yV|29Z%Zr&s%V
z3W3}XhbOZ96+FapJR8J9>>OlZ=87Ofy}Hyc<GgQD=_BkxpBKGC;k0b>+ZP}h+d`pj
zC;c@##DScGreMcfZnHWg-Mq@emFb>j)#8T^^sg%fX4hq}w{xVoJaPw-SKgWtnaRoz
zh~u<#x{0v15&?qL7Vy2SF2kjNwa5SXH;BSNuNC(R`Q&wkePGk=sV3}sanyx{2R&ZN
z@-Cnb=xyh+_Tkcu&=1;&LmA)GvvUEd6tIBnYQT;i@y80Tndw$p)M|a@w?BEm{V;w1
zqQ;~g&sM5aEc|4?c>?5R-c8pDwf3(2ch#@nRi}xHC(X*Y*oEXw#g&~kATunE(v@}w
zyTuy3kvsh)?S(Dqc3~&A;OtzunBy<-7%nom)2-j&vtZ+mOh7P-&+^OMY{1*($>oMt
z*r%x+Q*iX+KOu6lJ;!IAY6^AJl3O*P`+bzl9O^^ogcd$TBqd?l3(5rNZ<ug$v$N$l
zHwx_3=r<7GH@1g7LRw3_D~{z>b>}?>7d9ox*H84)R<v29*1EmMJ~QD`U^+ONH<G~@
z&eaD$Mk60>csm=jU>p#~=*GiKqvjiFr>_RVcWKmlx~2>#vNeF>(YGZNPjYSwb~rdT
zx68FgJghmf&aVIE=p`79Ub6Scr0JLuO<U{sMfX-c{%F5=J9tJ=jXHyxq)i8+h9ZEo
zXPh<i2x$IbW3H}0G929rnP!e_1eX4s;tz7IzmgTX3=BTm`ncSV1ikXu{=t>~a<H)n
zWqLFmvW=5cDAg<D9Ch`Mb6YYs)=oF)>p$?g9E;3++hrNyh}7%AILLK5&L6kEc1tf_
z+xL*Ot~|tE0F9@^cjY=bS`|emF;n%=Z56hZ@4saidSN#4;n4ad$USYaOzEBY)O>v?
zcDrz01o|{UU+Zc5#v`H(`v<^I4Uld=36sm{Ty=h92i8}I@h_Wv?+-qdNtREXqEhGD
z!5?eiGN>phZxRVN9gZ{&or=~oxRO#yC(RVGzeP<5VSz=q`-Gft%ksZoUzDXB=O=bK
zC$0&|N=O<W9QnU=+y9*$`2YI9KV?k#Q4R5<^Tc_nbCUn4?3euey(iAe{j;`5Qu@DI
z+avi)hl#(e?E&3Bg3f_%AE|WVau*|`Q>!~<52-gcUhT<E9dNsPx#85t_a)jo=>>s{
z@K>dBS4iuqmwj(rD`dpi#*_2?*+;CqL<+?9Z8@Je2H(=xKby4A`DRbeS*SLWmU_-%
z%{!M*_25I$-s7L&6b+d3xKRuHfzCYl;~EOO#~VL(q#Llt=#~qIN*mo%N6;H3?pUn0
zEPUyFG1R!DHx+&Oq)hW+8VyPH|6B+2W0XJUSms|d{P#&Iex2dJTL<%FQU6c}^9x<Y
z|Ij*^J)Km}zw2QB@2Z0-7duR%?<HM)D$?;bVb2ZP(#B`u&op$)*uM>WL<Nn!ueHv+
zij*?tN5X^}@!RRHH{&{DG(8IjdlusoZcpAuTXsQjwXm0v3k}Lk+ogTQa}@k$<%W|-
zP!TFwl(ySgh{=3jc8R#UqC%uwM<Qdj(r28)@in%iH?EiYQoImTffb~a6Hhvf;CTrY
zBUuZ?R4*~XZ>emW*|;H$M4RPv-o2zZFN$^GxmX)>l3Or$J8gA!gJT2QGRedcsmR?I
zwY@B{|H)@#p8!LyGbPt_pk)B%VeAfm{71(wm>w?VbLhk<rwViR@sS>#)^|hO4>b1N
zRoTZ1dFFpBzt%Y7xO=uzblEpMIp;eyoZ8fvCNfX6tSx*iv3JEG0O#2zEGFBr1Cfr~
z++2os`zbK2>@bW2e`tBfh^2!-{fS{x&MsQhY@~DO-7VVZCzXu!u1sdma&U3=O@Ac?
zEVT9J0Pq~Z5n>+88XS(fc{6tU{YIeePBS19h<$n~F{QGq>(h=>(#P6(=T}DUbWyaN
zdA_%rph*UORqS)}J>`!+M7FypT+@KvzLXeLbW;z*(co6ESR5X)sl0k!%0g{kv#KE+
zyVv3ZUMrOUnh;El!<gpbK_yim`?{6jpicwg-mD3Ox)s((k7_;$Q8?_)JKWU1XT52M
z+Pq^HN6D5-`lK&OL*vjW$Fa}<s0zu6t<I9?DY%t)%_v-(QF>FR!0w)VU+wNEF8f4S
z<%^kXpL?%iK5kiBP}HZYPTaK+*%C{lVb1=%d}KMDgl;x2ta|Ei!8hY4wDxJUu;N;3
zgUB7Dj$jUrv4;$ouAsXNpdr(&Ny#9@arKA8gVra<pHM@YzDVKFziH&IY)9jJg7?yc
zZ3eB?`3=2(6vYOySpzzL!;mQG<{^|=8*d6hkC}izh}r_Y?n78ZfS_>(R8Dq2qIDYK
zicPcmDqAH<HOd(d`UF@wtc;*eQPq*4RDv?8FZ<!ZJfBzJ0u4vxyW;G2;w1s7W_Ezb
z1K-;zS>9!TIMh~??^e^aVJ7w3Ez-gRkfsBPt#fFi^KK7>WRTgR9EU2lcbfDMwydhR
zCCdX8@2Dx@U<28QbsJ+NN5TR{J<y(l$@osy5n*aXq~|5*uUkb?-0gW+Hoj9eh>?ZB
z)->n2y&Hi9sjpT*KF0~j?s$pUD)K4~HthlV<0$$4cdCJy$yq?R$D(Yta}BD7i=${&
z2#`U*waY{4S|#=~bXC{^wK2y=xeuv<43YQ%OWxa8fIl?~@og_gxc&}uC7FXF0+NJk
zKhjuwN<WX|O@I&hAQ%}$8u~#PuBQfZgg1E>wbHc>*Vry>uv%4EfNqeXlyJx9Tq|xw
z;|kcqed~Z~Pdr-~a}%t_A?2s5(00X1G6h4J27Gn9EL1jaKjH#EtyxUp&tnV#3Hi?%
zfX-4&{o4o=;OvJz0?dl29T)qoUslS;&L8y%F=f~VUFZ}eQ^BT9+M>v7HPAX##{6v%
zWd0NwI*Z|f&ai-XC74aEwSjdpB=6cGFqfmm)4of7rLN<tYeQ?~9fVjDue8t4>ykZ*
z-savw?NCtPsnn$GV2iSdarF+k`gTJi0t49ExG?K)fk$-5_suRW)H0JO0T>xwDPIvw
zTB{#_8Xyw9L#g35Vorn1`Pph)7>C-WhSX`@(At6?1fihJw}`$ps~svd9ohqjB!$J>
zll@cyXYV0WHb()p%Ez8ixK7qNE|^lvkgvEk*+BY?St_A4S^8T(#!pgiT5S#j2n<>Y
z4Ld@Tg!?BWFnZJ5d^6Zz)}%PV6Xaj33IT$v3()r0=VXyX7)XLUVvV2(W(~Qu16W7m
zC@(&T3Fabyw9AI{KyM+oBS0Y(1342UTK_mg{2HL^1qY2R#GC4)4LB|=kL~gUmL+Fe
z&W`hLvq)lh)&ZTu1(xxcWjG@^0R~sV3DCf-@3D%pkyhWr(gDCF9F>_0oZ&s20?DMG
z_S%;!MMNuvGKg4=nJu0l#{?s>9@wop5{5sZ|L0XPMn__%yn7J~I|wp+PmI-jAaoz|
zs&4bn^0-mJNJ#(_+xZei9rI^?h<ni26bl$aF~pnSsfr=Z3qK7}89^C0*xjjo>#nqj
zsqD{)Aw9B;M9;5>r{et2r)xFmRwHG595sRM+K{}R5;mq>yEgjMMq_J0Za+p0x{{+S
zHY=~o;5xRKeJNyU+!QiF@z+)9!S|6Ocd%rH-gm0h;|1B9Tu@x<Hw+(XvK>0Q@SQ5s
zYR3Q^q7RB+Qg$g+4awk4&j9v_JJ8K^UyGjy*Z>AQBpiTQPlHE{i;-e{^mZvL-_H1@
z|9o(Qe>qriqws#-QAG)o=??sD1jxkFd`<TMX|Mg6&{M)fM>AGQQET=;Es9yyuObj$
z6GCAQWSc@H`Zf^B2>k9@zo`n;dHimOfn^?52qo2n%uooW8x8q+gg)DVO#ZPR*r>>k
ziqoJ13r!2?W}!c1{LhC6*Zj-rYR*sKBhCgRo<jAyJAf>@PdtW&|6!wjv-+c`*tk1d
zqdr?UOI)W|MJwO=Wl>;1$v^a0kRSexOd%oHkh0&Y5NL`VV(tp?!@sUw-1R<x7TVLE
zKMjx<3fl8z0$^q5Zm|bu)o2_F7*rEp&Hs9GEIEETTieDGwuk^67H>cILrdM|wf0^4
z<4!yLM_G}_Nw`hg0%Rj_)Zf!fZnMAj(ys3Pt(Si5r9X&^-+Jk{Uiz2j{jHb&W%K>k
zOTYc4-~Q5Xf9W5=hW``&r4I!9Z7GHWa|I`EWbdu@_G}ISn4NeMn!U0c;g4&v9B^vc
zkouMaNKy)acG(}`2W%bgHP#44UCx0i-uJpO`DKivRzdlvTS)w0;TGm$#t=`ezbN`2
zYE{-Iw7qtLtKGU*LFEy9RUvS3Hf%~TM_iK6>_w*btsK8sqE0Z8hK_~~Sd5&I>BfhJ
znIaN03sOXYO?H2omS*cL7|>FWUWA))CI)@WSf!cQ@!9%}c#=68$YNa@L!W&Ig8?m=
zs}pIcOXm{rDc$E&at8k6XRX9(wX7Zl3|dv{@#OZzw`;99rV3j$#m#H}gHx*dm#eLD
zj3QA56)w~ep~f42M+1eEF%#NQx_-$m4`Di{(5R~GHjlZnd~?ZnAvKGhoDt^@P8Y42
zH>!1Z$X!%_tM0O2T@vdC(d3h8oGO&yiWSHd=&k4p>Vv)6ES&HfU+yZZyhn=QW%Wr$
zur3_&KA%N*CxR{QHth-fvZ=L|uWlytGleuEMNbn3V+W5E*$qBBZ1bAqgl!^~LbUL(
z&uBe5Oy377ubW6*oOmYLmCdDFlM;USDv!J0vx8%M1BVL5V$T$0uq@}2qPF$8@PS;<
z#WEw%{PWH8v@1e>UglMy4&~~55P_l@fl{qYRZgMDO*yGtZpjHyN4`w~5E&Kzm?)Bv
zT(i4JLb>0E-MYgo&vqSpaNC2^-7HMYR{%j#4sKlzjj5yRmn@%;iw&G{l4aty?q6=a
zb=HH{D8Q5Y*52pI=MPSPP*=8Bb+^Vzii=O@a#EaT0vQ<a#tzX&p6>H`Y{RZ>3v8Zi
z!xsJ7$!nmUb&a=IHh*07pn|=43w5le|I$8xoPW1GssYPja%VNIymB;g`y68-`vS(*
z>drcvE~VmejjXQIh-IABw8uIJVZ2r}uJCGFa`Ki4dLd`Xb0H%=vZWq#d_#}5`fSlj
zNum(Usexl?l{!2);NI9e^+T05w<3MZ5#A$OkK_dFTXu-p*23^L-uOPB#LwB8$}1_0
z(H&y^yG;j56kq?x9PG}+-@W}QnWE%BnAD}^WMu!DaQ)j<>arl0D5hcOV1N7G3Gs8X
z|3xxI$zKT5|1#nFGN1ADIXcxE{WRNsYWUmd%+zk~(>g?-u64(6{qx+2`B)M*`VQHF
zi4lB7A;y`?D%AUhOj+?%$j!jgSeK{Ov0_j6SA4)vwBKJU8@%<Yw}l_W&!=3zbm*&}
zzI3-2-yQGw!@<FqoG*K9ZQgRO6`ZSiRLmFznMhw!zk{U0@4MagHn%Dw={ifss`!WI
z@6pZQo0|QpD)gm3e`p%hc{#k=zb{C~{_9kzPS05FGo4HQX>mIFs+Ymn)D7cp{8{5a
z$;1AG#!_5P=ARS)w^=Oz)5QPnJnZgT{~-_i3%}+6&^#>F9cstldD#EE^00pm=m(+3
zzXbdL@AJR^|MJM@0B7so0i9hi`c8$(2OU>frdpo7*X-BCJXhX91_kKI3TY);6Xifq
z`ElQbPcf)5$F-XYkjRdhtxYK96p~<n_80|TY(*sUey3v8CfinfBizs=mB`Z+6U5kU
zydz`)F`ihYx4qMYSXo4nRC#}X{l@eC!{qAkR7Y(>5wX04<BDcso2Z}PRGlOd3xe-Z
zGc=iu1YKoPe|*SYL@oP-)pQ8u0FpJOGK0d=avAi4$%RoU4S+gI|2q}kbP597n+>AM
z06aVaTD6*<vlt!X#UGH3+XhLD2dQ=M&<?*2pBYgjcN?{~k@cNw^ebpa69(<Q!sfk2
z^Ls$QR|xTY%l$q>zlFjNvHx3a|JFml73=>NmO?af)3r0L_@;B<J5}-ezBt=3xmn@8
z&+GleW&uK?f6(y##Z5NporhUL?~!NJ<f^HdU{oH_H5i_9ee7K$?y{wYjLH0&TguFM
zX(mxuhW2PoX*Vk4>~_NXm9+t3^99=VmbVXQIGks$0Iq4lmZ+#_zTZ?;Ek8PBr>-@9
zzWV%8PkcuPsHh6F{XYR0sQI1hVB~WEz-d$XPPOMb3DUeX<<AQ*y_H)WPtv1Hsl-wk
zxdkW>;=L)<0t8@Y{`71?@MH$EX*OvAuXsLe3re_r54Cf^VU$3J0$t@#$?K7+C09rX
z^l+&QQH#9uZC0~Zq2n)LWdH=hmj)no61t$4))pYZpyQ04h;JMjh_UmC$Gq2(H@;ID
zJAS8<|F2yF%}ya~8<^{MEXxSolR4-*T^9z&0sV~p>3aJ3zCwHAG3}URHG*glKt`<&
z2LJjNpk%n;L}5n!az)BzJk^w(9*QR+nM2hd_0wQ}nv#viO@@tI=rwdLt{F1)o$9BN
z{B$*W>hBTRQivqDK(M|g0Ob8VmA_t4pu1Ag@2UMgwZC`mZ-MYbLj4v9`oCrExcYyC
z8gsKcTE%KU=XWP==XR7aZ@dYu=w96U3^cc{=A-~0y9}M7?c%yzzUh8H$zhFRh>I^n
zB%I4(M4=dZTTd9zCv>Da@Y{A{<F^_mWM(~W8^Fh9&B2bJNj;lBq_@BJNO8x<AhP;h
z^?h7@-7M3*MfQ)G*ou0s59UG+J2YIJ-IscAYU~_;@`DTL{PCgstJxb4<#kI_0Pjt)
zUvmvl<hWS1f7ZuDuqOjQsC&B{Qnf7aL@LqUG+vzt%;sYh^B+j^-S!0=y!|Qr95!BQ
zos3~+f$_~;^^V@NF3bCD9W9E!OinCD75Kz%HpQRTZlsQAplc7gU$M4Y7!B>;l$y4W
za{tt=ze+k@wl%^A%g_!x7oA-^RptIDnq;OFT^TnX5oSU-(<t;f{;Hi9@>y;EJfh+N
z^Nw?aBR*?`A&BRs_VAJQnSnx6rbc--HU8N=O*&nl28dORb=Tc56vFsGRHRU*OP4lo
zw;_E+*Yd;vreegs|4Tj>qEM&I_w@5ek&@^L;<-%r8+74*dr+;!y>4}q30{{CGuc(!
zU7C2#=6!wpDtE+O&7{Fq0dQzP%eesB57d$F0JyGACcu-6k&nmp>PQS}b!xP(%89f#
zoDQAW+{ojc+$@UsesH{d(ZQ4Un$&*WCn0(h`Y~tf!Mh}QD&$dmSXyk=Dv7(FAi!-c
zbgfamE1}?C*69VoqPVsqBt3xiZb%S*K-YI;-om{hIoR<f%Yn`Q4{gpTJg4q|ou@x2
z%XcDjEIwQHN=jOyU7=*E*}W{aTmc8wxAEV4Gf`K3>}z}BqMdw|1<wQYs%e5F%CqTf
z5f3=_9q$abFNv{@c*TE_!&LWB)R&+ID;WZ3gG@4YPhDI7=&^D82a&9Hlt&&xgF{RV
zAAGDP-iA&T=^q&|Z*OH*xqI22Nt25HZtWyNb6z66Z}!z&ZP*b3VTWdJB4{=8iv09b
z@|hbRS&ZpV6CJFLBhU70x3i6Wr)v4QW|oX{z^9s&lo)yzCIx%&M?Gu92BtA|0z>=p
zXf^^{1uR|o=y$5HJozvHj=rgvzq8Zk=3qV`0RrJaKO>dG2G0eJD0jTcL<B{+bY5_i
znaDsi=Kx`84iFOhywZc29R<ca#uYSC2VTKpj4_Bt2P#m=7*MNx-ILk>P+-vS=l`Cc
z-}~YBdHF3Le#^t(`r@~K{O_^{U{bk0!CSR5d(8)53EbRLku@5lXTB>>9~7Tq`tdte
z_&v<wH!@qjo2|?;vF7KG>h3vszSjPWmvT(Hh|;v9TluQ22i^GRr<oDCE&I!#Yl;~!
zMhI^cC$Nz;5u~e~7nXZjv!~4;9$MzDB?vs!`!Xh~rs_aaC-itu<Zi~h#bR}QHZ|Dy
zh-}xpt9eC!rHM+MmE}4cIHLNzg`QlA2wg1q+eS6Rg$c+@(qYX7^}~YY&E`VI1;{Pq
zE&p<JRWDGLxZW`FEAQC;TnUS+4sUYg>T*{bz$=`&g@j9lkFABH+JWiz*%SQuVh>;r
zpUR;11@Cgw)e@7YnMdCYs-Lgxe3+q?lgiSenZ9)fL|K1+E|Q>IjM<@^#}L>A2)#zk
zRcP&P*iZ!GgE%NJrXUE+nARQ;t6Tt3ir4J`Zt%bz5y6W~azd<g^dNAedib0y!JSI6
zX)AYzrEmlZY<tRnu{9~gxO^|DCY1n4gR$$VNp+Hd*(mvdrxoe&bCQ#AnDUQL2_o76
zSOpZsMjvRC+N}O~B^}?XXnRY(Q>i4uK+`GU{T**kL1uSSjJ8ftz5)mY7MQeSfSOSP
zMmd)2N(qujQ}#DeBoRLkuHaqj{5mEkuo3!uIKNlt_h$Qjc7BV3--3GRx8C`!M*o|v
zg2OAUj{gsPZvqeH+W(J_qe2Tw<;XIm=%ff?FidIDW@$kZ5>m-B_I*@JsfJQ%!Bi?)
zGNF*QQVo%*Bs(z}`!*Pi8UO2^F}8Ga&i8q~-{<-L&w24Wxs7YCx$e*U{=7e*J3S(9
zvvW+V;Nol*?e)3oDZJY^BU<O$eBO3~d;8kYhN?34wnkwZCthkKRAQhR72BuBg8wi6
z%r#m*L#qHp%4dzmlUEpT7EszSb`^=7FL%Jx(OO*Ypx)7w)|M{w<@UQCbzxrFX=h<$
zJzvh~gq6#2ad~-#@h%M|1Q?OW{H>0Kv#q#`lPh@HR%=TKD{FBRdGQUV^X2wf+uMM@
zQUX6g9Rk}=oN}>t5|{gFmqz*S`DZsQ_P02@AWZCal*dNr=OXVU(_AEU?;gLllYhaZ
zZ3{-*HQykU7JrUeTd(<9ZLVaT=8{C?th`&RS0?WgxN#7*dgm3RwZ&eKun|UUE4+2~
zZjlJC+HidDNAqQYF?>t4ZEFg|VzxaJ(Q0;9;+6>b<hyZYK=z{*5&?_T_X%h<t0-{O
zV^XpX`Iv;C<aUxy${6PCc#^JF7d?1rjeUQLUd+SpypMagn_CEfUETj6>{i4{!5~@V
z?SefQ4fC5N>(6+=I&U<){doM$1AvZSVS_xoQ$y*m&m^3F_<yxigL%IvIyIE0O)LB_
z?bP^92j=)sr^Y{>8te{@48F6Yuz5;ymk-5vmlrtL+FC!WKD^7h@%$=Stm?5>N4Yo~
z8_#dwgcz1-yCO57+r1rUA)<I9Rq%_HGm`3b5xy!?O93y6*!!x#DRIP=CNk)K@Yx-m
zMF|`4HeOo1y?A3v;rGz6>X$<zR?1*v+v_=;jl*ln7mz6LI@4n$y|3#Vo@YJxz4n%L
z1C@7X!)B4in}z1ZeEPxDm>=;g)Lae#0rT(Q!m{~RlJ-{n$`LaPYcOurJA^K1zapd+
z*^-87XX{i(uH}GfPGxJsOsuVsU@p)IAD>#9-QY3sBs{50v2X6mzF6}phy<I9kvaAa
zA+$d5^{U8a+Ti&-_<Jb(;Gr8i9bKca<3_~3A0D@0RDt{LMOx<OZtvXWH%V)?t!}<W
zz&bB@?(vX5lec4lpnIdo)b})PJ*XM;e9Gw{fiXg>@9}K{t%IBZYp9H3SUb?X!JM>Z
z6uK`5%>`2kz!L`yO)DGo<3!l(SM;0UfoB2D<^w%o1k{pJLjM3)J3uB@No$S5QiJJh
zZu)CLWmG=gC~We!`}?>$0E(fIO3wl#i{=k8{KpH^P;nairg07cSmm0)eM}{RaecQr
zytE9SR67z9v4By7>U(eq)(5>z6GKl&HGzU#Y7YIrIjZy%JXL$-L+t={6!u((Jp4n0
zk4!sXxdUT|?m6(G;KO^@`(VILE5P(>xyaExz&N3c$2lQBBMcxY1I?huXu<#m#es96
zOmDu)uNqE~!Bo~VKH+iAKlE9G$BJ6#3`wX7(laqFTVM3he{#qGpRscoTJ43Qp99S)
zpB0S?`un*$z#*@~>y5&m#bbu0P7e9~-Sa?V1^~2l%_tfOmm!KSpadR>uJ2b-+q(-)
znWN1IZ~ovIKJ1^}|Nr~!zv2>ot5Q)so!53+U0vU=YI)K4B0oM%z|MU0%Uj>wk9vRN
zN&tftIe>9UNgcVCg<`x(1c2r3xW?h(vp)#f*g#PBU{LUX-_5k8z`n?QMYYRFGcKOb
zHpf3f9mN5u52T+19M{hqK5;$!=M83cL;&7RF}$I9zZ?6<{a_zAwSfIa?i`8pGmlV8
zn_NYliT9Lxvw*4DhsozD#dH8p!>*P1;29Kr+6^d$%uf4$$n5AtW(PMcwE{K(nN%b&
zcz`EyO&|fdgB-^7ZA{bqLK>J}cSbds$N6CG;0*Q}2*w|f<#~cBGt{FCEMgj-cc|W7
z{d~0f`M~a2+~Yd}c^M*@IjRQ?WfwhT6xOoUfN3fJ+5Ugo>GwsqZ+rR<b*4XJ<GM56
zyGvfWiJy{L2cCTG9R9YPl-5=R(@26GKZ+iMY6xh{836IhBYq<&K<EHm^HtKOz-MFV
zYl5;-GsG4Cbl{+yPJox_(eX^T{w!zYBWj=pOrUJ$Z2q5!Dd&J7@axfxYScg$%dNiw
z#hi^m)}tAv_xSEX-X9F=tOx~B0uWGpFr0PoGG>_Y71yifT1#^WVZwzt(hRXhGhdlG
z;~0+S0{*<889prl<4udfA~>3vzo!4+m;QSw3(U|ROb1xYwv-5>r*=6|-qE9{V>-NG
z!^{Zl$AgY0m@bi9>?78*RA6J!)pCuzHJj8Qh@Hf4{+<N$O)h@wV>E;1=Acd5b2bKq
zn-lN+iR%*-s5*l&q?m>qgLfIPjm(Evx7C4&ww?$gS^-Si+BOi-X8EB0Pgg!j5Akt{
z6dVkex{Fr1VVkg3Lf`G2Voaf@<r#&AL9o`MD6TUw%_q?9zzrrtCh%?Tz<f~t{48hA
zSNaY2LhtR4Orh?g`q!(kX=s~nPw`)8aXMIryj<E}S-JLb8bM1t-{ptE8}esuIKG@y
zqTX*(9#k5h(eRt2lbCtUQ)PkwJ?mEz=Q(H}4&KbSFL@cus0!PEa7T)nXliOYqI?zg
z{PEJO;ZL?oUk1(4<VY{0v!6Guh?MJj97C$MezC}`cXwsVX0ZVdttZW~vA;cOb%Zs9
zehoEtndEWD$8!I*Yw($XB_@UdAsb*c%7$@h<1ar9Kvh+K99NQ;2mhWOt~71r|Icxy
zj74WRz_#suu=Ee1(|Z-}2wmBW)cUY=Z}<lsujFm&lE#|3*u{)D8=>hRVEzaGc`aqt
z@HY#0s^+m;?F!L%?|F}^8w@{qe3vWdLx-AUAn%KWR*&#TH{ZHTHD;#!*D0M{-`t^{
z((fYLyxk<{`NKYi3ePibVM_Q2K|%VplPN|yc4fQvRXl6lcIworcFL&&%>n$tF(lsi
zbO!=QRtzn6t0H`8tUbY{VXB!{b!Ff|Dn+y`@%HsD-t*gDl$}5K)Td2;Ptw75@zm0z
za!whah6QUFCfrB8spNu-#hRVvbkP*TXZpun_}vT8f6YcTSfLYDbp{}cJ*)*h9b^1%
z{pDFLKisXq3`9W!G6{&9HpS(?6o`U3aMu0<MEwIqv4N<6{tv}R|9#(C0^g-y?evp3
zts-g^-dtgN_Cfy2x5k~nhu`{yyS_N{nscg?&%+fkO1eykj=*=Lvm>aJpI+Bh%Wk!i
z)hS%rNbyIUP}v~j!X@gfa~Lqhb?VHAm;0bbVP~2#gLhzqenGUejAbh4FwMr@qcFyT
z`(W(I@qb?Tzj7|NDAPgC@3s7%=Eu7SaPZKG9P9nI;Uv}Gpw5=}&RF!<Ph9W%jLP8M
z1%7h?PfL)YTZQTQfU3JW!UKAJ<whdXz!3lI96j`916(5twWm?db4OvJsqhh};6dx0
z-!Pv*KrC&K8f=95V7B?52GeCyzv~TiU>Z6AnkEv(5OR2h>-!Dl@|D31)lG2tXY(VN
z-1UP341e<>bu@T31(-i`-lSWa4$J9v1BeP%pNsI%e*QV1f35uFX3#H<NISc)yXcx=
z@(^o$6kD%w^^9M0wa_Wv@N2$1@A2Ji1|VErkdF)?4)QI=)DB_>OW@t_G?xLT2)uym
z8bOVm^w%_hkbMux>mS{C`W)nDFhQvfXvYCe?$SXc#u+hj(B=XRTu&@)$S-L4EaUg+
zH#vQad${PMu)tB+mAybY_5;(%?Qs@7NFsL>_WlW|q{y`L4IahK2OP{TZ{bu1oS~#W
zBCiK*r9?d+Z4|}__>1@W!v5LaKWF!UBX^IKa>_1ki!9lGH@@{|XyDw)M$0s<G~`_U
z01;C70Mhwt7!YfKx9rzr?8ngTU;s7R=F2hV8oV2TNc{jrYE%Jm?I$i`pV6nO*Fd%F
z7i-uI-W^!=^*Q~IrY|qze0Q}d_z~CVl&AXhyh&*izW56E-ML_)K3CvpBjn~fTJ8Kc
zl@)&X9acZ;h-$wnEfT}n%72FY`x)*$CEXcnNBh4UUK9*u@Oij#AKJci-L-}=@rW<M
zN`Wv(p**p&wr|-o_&AicT#&p+!7Ke1K>-3i?tye@<2B9#`wfzgFwXhhTQ1|SFL8R~
zud(l6(iQoC^LR-JDErknp8!2sQ}kVohgt30karT9#S!ZhM0Wh<8*%B#4UHXFuP@3R
zA*;gpDW<;0H1oj+>jmp%%HZqC-()4vEzMh2vNs^U&g<FSWqNx&&qn%>ME?kc9R>#U
zf}D>`d}Zqj-?ulzQi8Mp(C>{NTD*NT*BKrz@e;K)oRvs9+NsuISA1C9iRE5*V^=<W
z_Q5XV0+%yt;loJ24@-GH8Z7rSgrgXb97bX=1F=JlAlNYHqzkCJbW|%Si+%vIdlHl@
z0kApcQq-i^{`1G+1gD(Nf6sxveBf85=0iQDwEnl=FR*~P%EM1{Z{~fEn**~%lAn>n
zgTukC2X6mGCUE<k0KAB)y?`0)fOl8aKz<(s{Qg_ih+DQfD5XPw{~Pf8oFl;R`$+)5
z{~VKR>tVz=&4B#=V&L~HfZK-wzb|Y8{5~J>`-8ykV}Wg3^c1*#uEDd6ku4zNwQU?;
z!wI~;ode|cQNZih!x`$@Bg(13>%)Q9?*UF<6x5;r+1o$o_P;A{G3!xwd^}av?}RJb
zZnj9CJ7JZ2`QZ^<rdyr~Cmx2|Wb4dW5egDIQK&c@%uq3hf8GQK3Ee&q0mj*!q17Ov
zdk=^q=O2QEjtkSf3nX+`N(p`XTp+>x8VMzsU5uTFF+J(1x)>x#FgMqZT!Ru!*B<&(
z4v=6fNrMDa9V(Q<N9=<KPwIgL6I7H|C7=eYL4FB?63j(AL4wH(h&4Arh6#-PKO6dg
z?}XY=Z);x=12+2p(e&(PT1n?i9*1R_SFOH>7(dkitpT<pUx@ZNTknCtnqE+jfSlht
zk8~Zw9!dW>i!0xRUsyRO<mLN=jTcw-ulmm6ubTersODEu&p*Ha?>xg9ADFJh9wM*2
zQDvee^p~f|%d1WzhO5r@dFe{iX2t)sfLFQMK48Pbb9I~79drs1d8e(YO<E&zzd$xN
zeKB#Z^34k&j+J4J(fkrZz4-6_Z(a>zqSna<_co3me(Sp2SX69lLvB`Pn!uh6jJjr5
zr_Nzs^Z4SrqD4J*cU^mYpV$lDW1R3=SS{-@zuNw7RihiJD05^<v{jKbZS;CUzVnU3
z{@=?fz1Q31Uy$j4lrAijwWhf1ep_euHLP8?b-koz*ZtJnQbu_PaW)0Z6uyxk);Ot=
zKjf8d(|&)HcvHqIp13os(WU6d)x=BK%kLuBL$3_=DrgCpk+c*P6}qHhk`R)pDcygw
zSk-9zds#Jw<=!cWB`kfx+R@Glm%*Qa#mln5-~Od5_T~#P-#TnNeBvD5|It_C!Q(5h
zi5qM{rL-22=aDY*F>2$4Po^5H9Cgl2EBG>Z9X6O@#7}rz^PDiJrjfdA5Jh-3NFs4X
z_Qh|Vp^(UKC{RQwvkQsJf4!Yxy43vTLLwxn6NN<OX^jT|rG>=b4!~ahQ%L-$kod1C
zo+Wr-a;e#CzuEQCHEVWfRHl|M-JxnZ;?KD%^c5`Bf6Z?Z%i3<@5;2!#?T%jUe6H?(
zm2>01!#m6rw5!!EWv&*V(Y~)#FtT-!v)<vnTT*pxIYBvML9B4Wi8)uT1BFD?E|0vl
z=0u3T--JkKv$22m|6$6&(LrCq(~RZiMOz)bpFXJ7Tlsw?{^b=#f5#`AUl$4CxaMVR
zKYxCc(YZ!EXeT-1Et;_6rswbBb74+9kw=Vbufq<wyInP}D45fujTE?#-O-?*zw+vt
zhhp54msea1f(_=7@VU4_LpXnz%V4S9<=Pg*!(^(gu3(oyZ%F=4RdvOhwBdeYrB<g5
z?$YuYk;J@#VXM6#Vqe{=EWDADdcWd>qxS}lw!9yikq>@+Xbxxm;Iaq1>-jEgik?}1
z#Z3L{%hmaur?fv>yh7g4;>uQY#lMhgM3qstUNRVbBYpLuQSrJ*FE9K7Q(Tg0k=Bx8
zh_npR3~c?ttdkBB2QGZ8@8NonTdX%fFGloLio`1}mmP`n-y;`DNLGrf83`I8w>&MV
zH}#|Ki?H0;zu=;*)xp=?@$CmsU(;3a4m~itE!UtdvexpvFz2s%?wOt%#4YJdXw;T1
zlrIil;oZ||+Z@!3D$D+2;t)X9TeWX{*oyF^t%VPH1Pd;@%RQ-zS5S`;jVoOPi^p8>
ziXVpiD-~24Bje&UH0wRgkK17rlmB>~hY)wIPmw7CfKpuA)9iVzEvpjWQ~BngWj4&)
zPPv+bkEw`vRR2Tc31@@auf%2S_nL+Dh`yaZsBV+o?meHA^X=_7Ywf6%c^<3E8Ir(3
zC7QjcFhKDgzv^MTDY5v-39&_*HR{JJv=$^iI5+1zM>y{*gAXv7w}4PzZNCO77<J;2
zm11?xiw_$(j~t9z`-&3YWIzxN)>Z7dK{4;hcv^tEve9m1{LuxwrCx4_b**1_?w}a@
z^42uc%eMD0r0y)R!QWCe#ZKtkMxs8oCqz-~9F!J#Na?(DkJ=HND>=tXp!f~}zk?q7
zJf@%TO2w&9glzTSqa&Tu7F{@c{52V0*oq+IHXY||3xYoV5PTr9#OAA}%1Ql?QiJVB
z&v4KCq%3jKN)nr+m`INFh2axq>Y$skf*jlr-Hb|;k6PenoG@+vqWH(_*Ftk#oBZXQ
zXHkrosYD%Jzr=XtM11S!sKtkj*C)qFd!Ddb_z->hs1#9yV1}-Dh1i@Aws8SA=Z=l%
zy)#NuTvwf1u+-u@Rx$iTIr&*j(IzIFbH1O%xBBjHr+s5|laMQXGs6_t9TBwNwr*2C
zFc*3FGi~j}3Q3bNQ23dfxfv-VjJ#Q27C7fhQu<rM8P)j>!9K1n=0ZRA%|OqBpZ;xr
z*e}20zzWQ3QRU;7<*WOWiK<n))Fsc4P>LJ3iJ%EFO1&DspSvl$a9g_P1zNkpZ@Ah-
zSH4!TUzGSw$xuj$YmQjB{=9d97bm7ivp$&&n4{eF=Y^ED!Kmyxq~q$JWb(K)G_Cd%
zkX{1jGNqY*Rd?bAPG*ZH87sOvET!b#)%$?mdw?7*r9vfD8J(Tgrsop*j$a!LGY7JI
z{EM$vJtV7IGU{{Zd>6PJ`Kq+$Mh~vN>%q2qzAKvWGsmv(Q$Oo8e=%?K)kk~tkjppm
zrFgmGlh;6vC7g|@N<I_FxE#4+1&qssl<Uucarx5d*^*))LJIMV{?Hab*anOSFi|Tb
zt$~RuP2u1GChEifeB_Nydf8qs2{Y6IW>8BF=K;CrLFD>(#raE}G_r56yQ;WGN}00K
zw4m87c_Fq?+iUn*CVW8nOLX9_9?>@KOC}eOoKdOLwAs|2E9$XCI#u(1Rz0XVB$$(q
z#mx)u4u0!=IKT1zu+JyX=i!+_mYWH23c;HrJ?`-Zb#^x9WZd*@yyi)EUUhB9yU6X*
zt1lw2>8UD-&L9BO1p@rcRf0=wx+r_2+e1%sdwxt!f%D>hI}JFF=Auho_IMEI_;SS>
zNq5U^y#xf1D^q>WddXEccRKA3(QVPblk1OI*uZznwawHTwyX*BB0F{YjqXFeJj=KH
z>edS%5AxS~hL$ynynEE*y{BZWhC-&?K;5^-vztC`{FHc0wsSS$H+L;s68l7i^!tru
zf<<w-zYlqaE&d?K+m?Ox5%?1QO;gsxN%;6kzJUIDCl!u>D*;%~J_E~EG+`shz@tYG
z4VNcwp0oG$9BxT0;_KS&_l~UL^oNmtdkFMfrU_MftkY;P^zkO^kk?|jl2%z`-yOTD
zU&ys-hrt|bg~nW8RdZp+7q$2mg!dhOwkMEzUk><3JhUKPltdGwWcapV5%+k-W@Fy6
zwhU-}%6Y+1c#Uov!j!v(n%Y(3RK&NXs*>pT&ctehPp}-`g&z2PM|5dFeaCY^{PuWy
zb+hpN4~2z#LPbXpJ6H9SVDRmL3JWuO%~)58saw-y7#%ZYraf?_D%H%aqsEN7J{2MK
z9vwcP=1f>omA#_dEHP$NV&<^#^-}qG|Lezgl=~yZNs@`nx+7o^+xS=C%Rn20$wPW@
z-HndoO3!^}C;3t=#lA%<ZRK1vvP-y-^O<@^6X-ulLLKW^>kI#mJ-w*V?{Kg{(Y)_Y
z*LL+vkV=g8o)D3rxX_S*anW?D3#_|U%si~G30egy<h|Qzct^>al(=uR=<Ai)>iEYf
zyDUR)AC8CR8*injeMJrypBTC->1r7nE+kNkvou$nm7(A;_wdjI9dZHYZ_<z5ZUW6_
z<=?Iz8oKK?ba%0AyA=shq+nZ*;%vU^5%&I$=3Vt2Atwc&Rqps4B5KfJu*!-*T<m*k
z^>v7W%t66)<Rs9e-W?LV-Duf<GuXAsp2o24sJx60mR2RIXISF+@O$V_`(L`6Ur`C!
zkr;d8W_RV*1B;D!@i<lWSIh9qzk=^?nvu;so#D*U3{M&er9bV-(5|){xMi1F-cacM
zZGED0sm6Jc$9%_RYL^Yn^&!%hoY?=7L_gGT`SEEsu3-l)@I%*1h0CrD+Zk2fLBmIZ
zv4|Z`iJKSr=x|N-&c;LKZz+Ye-KVzAz4aYDNYcxB6I@`#s3a#<Q)=)`^I>|Dsw>Y(
zOhDw(Op837r$q<W=*z!{5tb1@|5`L4(eag_Ek15;)1B}#X6Pl&wBpc^w;%cX-BcSS
zx#+$8`<fwAmCVOcm{rHxMX2xCyBp=(uMHcM!#kzDFCN<9+0y#}iy(cy(+AWrc#sY{
zV&15C+rCv1Gm2<BBy5_ILMmFhzWjAd4x;Na`dh~QUQDHo0ZwmFd+CP!B=ruhHPXVH
zYfhVOQf;BEj8r9kx&s?Bn~fp{t$iQ*NH5`J$~VKrp;V)54;MfFo>6_lKnTIP3Y)3V
zRSBQJ5!a47Zw7y%Tx)r4y(XWs0Q_dY#3pm6p7ZMthEuLNe*{gXo92RAHO=W{ZLe(E
zYT^hr(gZC{yCj?ho^bVw2VO()8vZTYh@SM~pc3Dut6LV{ZAdJxKZAaL1#8^E8JQy!
zL&ExQzQ-p$LxlW8`(r}xcV5u5!6W$IoX=z^TQAH_Hr1{gw@S#3B$-fXlj2O=MQZzo
zvNT=0XiI%VvX0o$I+r0E|4vEEn>+GJ_z&%>B%D4d8Zm<-5bO_t-V124#Z{hWU@<$l
zPOunvstspCAt?n-JOmn2xk_Fb_kT2O8fev1ZtXRSw5bsEPFzRegjt0a2f^^OvCg2W
zGuKOR<g$C0-6#wx9#j`K3iExq&4D(sgNydE19YDJ%H_bgVj(poLL&Q&A>;vxEOy89
zAxLCRR-NP4dHVkMM1A?99R#Iry6*{^NgMiv`CPpCRV$mXof0V*p3ITqTGIHkB}Gca
z=9*?yL;9@9l`<WC{%V3Fk~#A-H5{6TYOL?2SEt$|>#Zv<N8as;93+a$)DP20JHOof
z)E8$fb8sZi1aXafKiclXy|tIaL;bnTj{nAtjo>tgwj7`xfsZ|nX{MFco_Di>cDRv5
z$VElYkajc;4+K{_7(_b2Ta<OA?Cko$DBO(|nns?Y2g&%A8wW^LrI%)9^SCy5N9|-(
z4c@Jz?YA4qYy2usv5+4M>Is}nl~dKff06h*7t*L|S+9Bf)d#y{M@}S1Dqq>ZC-qK~
z{@XJj^xvH$CA1u%U^#~2Pgx-nD7;hz8Zy2OR>#}Dr0r3zIly19)3&@U%!xOb*IY7r
zdDk7v@YkOAse%`MPQ;(oUw3ideQ%{gTXBvOv+YNCd4yiK>sZfj=V^X#R|r-h4H8cJ
z*=yz>znN`To70rtQBM557k$||BSm#sE7N>n)t7sLuU5QhC0vTTvL){-6@GikM(f{O
zUSFjT4J_+e3Nyr9QmP%?HX;+#>Su(bN1Rw+8kXU3J8^+s5wGH9n|aS=0_hK3jr%ZX
z)JDF2@pMA&<WS%IVdvWIB%Hx9u_z=kjKZIRV+G>&t8b10>Gu2+>%(4E&y@<=VS3H@
zxAYsU51kM)iF~(1oH}PkmyF!2;Z>0D4Srno8S=f#Up86+-&?X%2u6}jTNblvu19T0
zvilMr<zjJ#_tK&Jjh86odar%A<``!TEa{B5z1V}SYuV29G}pA~(!NE^9xzXP(+eOJ
z_z=sbT6FYOPn9bfCMGx=Ej%P9@F@q16mCEE%!VQb!|Y?#AW~S6AtdzP`En33fiz(M
z<=!_<mE()62u<6sWq!Ap<P*_bDW)NGU|7WY9nAMC^gia&jMDV3ft>fo9V2)-n(P;0
z)5_$g1|fG#5zN!~s<f9~r~A+O==CHU;0_MHtXEC2qO8)<I?hosZ;7(}J<?|b?HB@x
z1mtG3XR~~oz@c5EuqCdlZ}<H!S-e6e<d3rWFK-QYHuKDX%S+R{j~B*Ap)5L<9Nf4F
zvv0l7na+9{D}CMW&oYVv@8vHVi415U^0?9=;~`pIWw<<vh)e|WpVhUUzk~SCDpA@W
zMwZIv#J|u~YeRcrzEdwm-?p;4mfzvOiKlu^@AY17j&OmF$Sj%qS(=PCy>iK|mv#-V
zw?W!TYDS}#3h!T#IH-DQ0YNA64>B^e55Bsz5<aKz$wo|opUC+Nl&nf|UHFx^jSYJx
zBYll;4KM6@2Xlpds;7BJ;M0OfK4KfTCnlYAPc+$eaEZaD6Hb}^)l0C>uTgt@BYgRR
z+eyxS<l&ZY_3r80Wa3IYxZ=HS`y(@X;FUNFbM;wi-kh5^uhmw+o5Q~oNl62acpp(x
z!2cfaPU*|@X}#GpzXWN<lBt|uqC#!Y=?|2^(1f1ow*t`61jqFk9673&teY5`@NQNc
z=8E+r+*x%9|DGRtWo7nl>-B}3cW~UgacL1jCn=F6a=H&?XaoS1XEitGRNyak9YR){
zfKQiA>WvCJ_IpeI6^%ivQXdr990XL2e&aqA%r-0~$<xTt%lB<}_NPiw%VYb`hB$6&
zdk6E;t{1g8U(!acxZbux@5$kv&MV(@Z?if2cHuR2Xw{wQUt0-g{MfJEZu>|tdPMT(
ziKueXf&1&aMPGGoiV;G(3|$RG_B3zvdWXg&XJ3>HWGwLT<GG{kx&C9`nw`SdZa1{W
zotC}Q9BTWPu?q&pP`09mPz?2G;g?g_h7XGS+kqI$Pz%x08ztsJ`Wn<1)Pt&YHwogK
z+gx$Ncp=sOsncax+440Xo*~JqH_!yj;>-R%rL)n!ZOalt;(zvV4+Bd4@7j7kF#(Cc
zOxB8RhC;tfibsZj;;M`k`@9k$6_$@*eSwe)x6jW508%lZ=M_LI{Nt`ep;0N#zRih9
z(h=5?`Tfk7{Di&!>IJ(c47tKB`DGEEUOmB&WExNvv7IJ3?4fi(np>T|S!7q?jw?Rb
z?c$nM6h(O3^}ImGzzj(>)So)#yDzw0eHTuDu=?@Gh2EsZAWyQof7yAd%VJ(5MNuFV
zoR?XXwSNHlt^P~)h6}5Vh5FV1uzRqUWB#l7m-b$E7XyVFf}g;Kp@!PuvIPeNV_zqL
zVHJn7UW9&pk@;0t`rN>cnk$kD;UfGY+Ge&L!OLxPx-ShH?f*K0N72;2nBe8yY88(z
zuM8Kl`Mqe75Bx_`+D!d}2fqMsq+wVw@J(-RYtey7!3tr^n1#_?;@?k~2H`<yZQPwP
z@br_9we8$&{6;USxMw^_5{OuHm+aGWj9L(`D)J1L*p#s#=dzhV(u<omJ+kNX=L=eh
zwmYf9Y|ia74t_Q#vZP0JDMvf}xkHCA*W0^uKD!)9(~)0Ik(FIlXy<ky<lY)o>#$0p
zf^LnVgC=TrBK<4p_`mggj+uHZnbj<)w^A7a9*AyjZ^iug4<ozune(~yEu5_FUBt&m
zI&E>VcL6^-iz`D@ra*ygpS81ttCOWQxH8szx7ps_0eZn$52cQ^)d>qN2M=)*sEVhc
zsw}&K`JcF=isINmP3LQBj&Eafi{}=HQw~o19W5-a#i2=J`djupijOS|{SyoYb30*a
zy-!<fz8v`3hJ8WX$-)y_Qf`}vi}rpO3m4X(Ywx!ZAKN4As=PdyJI4ALV;2;}<;OnP
z*aby#`LRzvc44Eq{M0p+#O24fH1-N*arv<amycag5tkq9Lmaz+5SJe-FOFSM6_+0?
zShFrDY!nAy%<~<)pd_xqdKc(p>07vfacB0>nLs~o2ls^i@3Ap!%;VZ=rz$?S>`prc
z1#$4jToU|%5C>mlKPW1QgD>_E%HoP+yWeTIaf3Mc8vD)0jpE>o{R2XL<M;w#;23k}
z7?6gYc1p_P;A`w<pm58q-R^_-3BK5(27MGr=1jy*$FD(KfUZF|dThL#^0YZ(Kda)u
zt=`>b?R%}d-!m&n#H6>F>?b75^BR`l%E9>-w(R$S9a~5o4mjuhs<vb|?aG@J>E@dm
zxI>~Z)~+lHiWn`#JL52e_|YEBa8C{+5I)-Nz~~tr?xC8G(rQOYwY(Tn`@k*?-D8xR
zV~EIRyz3ca;Nj%T7Cf00#h{aG87%}9y`z@VQJc*mca72+RK`eUqg&djt44KaX=x7V
zX$UJNkh)8IywpX_hb>0sYTu252|hGTKdBb8aJ0oCrxNMMprJ<SwWA&IY|c!E1A$^r
z?!x%0HJOWb1?F^?wl%s87oyWliBt+{pmWe1u7}a!O|9&A8|`7BL}iJ&Lykk}?8Bq!
zHL|6-9fU?FpDW&(a6F39HQMMf+Nn{7X~9&uhm8(8FfwvPF(W9HE{aiE3O*rbgm08o
zM+hDrLe&i)>Z`*O+9W+j(#*QZIkLgz{$5<;5Pbb$wB2b!7p9(!YNo@{UUyM&Viy6U
znK@cVM~yNl1k{KM3WxF=F&ZUfoR*C?>WmgdQgcZ!YK+|MQM{wZhB=Cq)&?&R>;4fW
z{n99Mb!*=+EbbzSLZC0Zn@e#-h-Js9hIe*-^{E&ttre;6iY5&aT0FfPhdk3W869|2
z#(e!l={dYDu8V>T+Hej;^U(*4A)<+wl1q9fw*N+MZg6o2o+MKmT^i`)b$HavtSFE`
zt3_*!WOt5^dLwJF7!6sx6b>&2$3&PN3nOFV2@Y;X4y_}lG`Jpt`q(VkpCa>SwALN%
zgW1ug9Ep>)4<=Ja;2rhe@8aBhyq9&EW(xGAjf{SJCzDqGt_5F7_fVxvC(+6ndiVr*
zaPd&TL-tpcTxZXXQYuOehu5jbVMIHlOG#aXVso{$_yWAZu;6HUr&(}JX>Om3x2B&6
zjzDfhk$qHi{9Fw%$SzD4;|j4Yn9$K5j*O5?EyZ8QnH!*<q9SqT;bPH&t+k^AK04Hj
z{5I49x~HG%5beHcQEUsT3qPb#9%}P`gs7{m&NxNytr%??Mlzn2lKY2BN$8B)lSxl7
zqj$aURhZfrQO<iO72`RIM(a_fRs`yc@FM(+eydh;X>nt>4}DH=MUgq)T!j~JjxcMD
z8%`Q6e2^{W-Pq>mS0fu1o1L?N6j`mS7WTpFQI4OrZ%r3IK8#Ygj9Sp)*QKf4e?v5*
zrtglUb0oEgTB_$c+G)OC9ZRFw`jm?j=!`4fSy+-E?LGYf=k^ZL1$zYPaO*chEXgrR
zt*BV#O|%-8FeFT6G(Q+X>vwQkJ4dQywjxd{^bvZ5>$F7)q`@n+MCr<}n!K?Wy~7P6
z;`<2FZ=x;1$~{+TQOU_Mz9OG(dp~;C5b8;3)j97|tI<^nwcMyygngJp6;bKPS50j5
zdBvhf_P+6IywY(|sy>oF2_z4VE1GD`fOabQ`vczd?ou-A3<!HeV^Ao5KYE!(p*_)|
zigtSWi{P^->&3|XZpZgkGWS~9Axy1tgw|B5YeIHe_Mi{r%}KOQgc+*BcjZVtDJ?P^
zo%7XyFAecPxCjxJ-k;ct2nU;1c~h!}ZKDWKwMV=8p=I4uREff7t|Cgehv~v~-~;tD
zuFyIa*`IW`b<!8PT5en$A|Xt#iYi<)<vokcNrX;>EWte>I1v14WA_!>i+PtT2>jKK
z?_Yj>8f-wQvwBpU&7WO@KHOQGM&*Np4LxzQ8ULK-IsBU7cL}v=U7E={9i)4A(g-gP
zNXgLqu5>@blKLx$^{Qw_&z?Z1`-XM82p`PO^hh@XI?YegCx(O=8QvU&IWg@`TM0xy
zU=gbCm6E7jkF>SdoP=|gw66mKXe6qw^O(^Vh%*r-)Rpq>${?QF5B4P0iI%;QziYHV
zml%a5b<;Pue8x0@1CsR8NmC`#4tk3ayYM?oDV;`G^3dJyCiD+IBaCntwXYBMwjn<8
zNCQ={{EYr;)f((@Cb(aQKq)2eOdVdNdQvoy^}d3l+Ir_1Z8kV>`uUL|x@wEd6L_3{
z8zNq}3T^1B&~J{SA=~ugB6Iw7(@XIpPh3Tsb$=&&!fk^|pewV*OJe|y^rN>s<IPpY
zYH^{u(JL0ez;Z@7*2mw`Tn>FEKic*|O5aXASfCYm0qiRNm<<|8aWle8p^v$`N<(lL
zac8t;ga)*$i|R$Ox{n$3a<Wf+Z3xPb9{x2)IqDnwp1MUi**9JTOQQx~z^7Kj8*3tK
zxpOf5d)C;SJEGM}{h_@D2-qALKIj68O`~w#ZZwuAco-SkPj&>qG)yi)0GV<T(GVII
z+>Ye62_`Y-3Pw9mdEayVWQGQTzCc!tI2?8Os~WG1^kqtB@CyQ(&fxFq&!$CHwE=--
z6vws+9uAl7U#j(#v`IP~5%)NF8_*EX@MwnsykIbCV6Gr>3w`V5Lj(&YzUyP}Yur}}
z-Wc2Ojjd$<aUA;-KLPs{+#XJJ4<-$RKWtjhJZCX*&I_<4&ru(jK!UHf$>+MVVD~k;
z!3F!9e32q3fk>=QUT`2q9ZhYEio@evBIVTL5+oXuNyKj|SUbE$jjoi0JKty9FpDnI
z`OyZ1S(YCo=l5zjE&r1W*4KxAr0+v{4}BE3wlG8LY)B4fL4Q!Ut#B)mtlk-1*{|Pj
z3M7w@@Xgb*ri3dXGyU-$9u=^oOTkgc<Gc{c_qi!<n|NNHPFAbC>>RV3d#JsPz>hTz
z%#`m^^XB%{Sf!jLwg!4<AliD%HAE_Jo%1ZUTI?h#Qk|Atvlo~u$5Y|CnKJ5&oibAH
z<j->H;b!rM{*bahwX@Ht=-fDLl=PNbM2h?ZN&<1AmVH2!uzOj?+Rz(f*r$~DnQ?sF
zo~}Ad0>Hv+E{AJ>HtcsirN!UW;lIR*)5i6U5P4tN;@<MaU`de-uj*UwI`bs(8mGKE
z*0uXqb;pvLp<}Wue3NOb!2OaRYhPv26}!jK3z1SJOi9obZzxeJ*~3&qACYY)CAo<_
z+is<D?#f#fUczG&zS~qQ&xW9hb!=~SwX9JR3dkII*772G`lj>68@40T(SccU3dSvU
zWoizE8N>b|Mx_T7$L!})I|Dv~)KZHY-Zc^`j)v0VXjxYt37jYm@g}iDsjxDCRYRvl
zy879yV8~hm$$p=B#rT%H?=kj48vx_%cq&4r$<%jKUYu?0ZO9WP4j}HNJjhKHn14%!
zbGd}Hqe0d=0h<z~03Ww_lD}o8?XA?%oq5$;T-@h*!y#RD3*82`acqNwbZCfxg-gAx
zx3;T-D?+)*qGmusBGoodaZEcOKW%nw5BRO=qyM%%p2G$Xb#IMb7lHk@A-<OltZ3@6
zTH-`qTpjVchOkIZ4O?yXIXCg55c6Yf{XHVB0LaB2QS24xTdBS~@;WM7_poeD)CpS`
zRW~gT%CT1~8|Ea$raIPNPQMUB#JY+&p7J{9sc6jaG~nMU3yGVcD8W9dxvuQ(Lgu@z
zysTSg-StHGF)!i0YGI}3ss=YZS1FcGe}2A96dR%cDpTkgx9aJ**7ZP-AqBD&<r1mf
z!b=%wU)`X&>H%%jY3O)eL^AS~MX@@CM<B(Le$)KcbU^Hd)c!zAf>4v4+o}c^(~{dr
zNYq3KGPk>kogOc{z`hX!J>5Is(TKz&H3WC((t?g>k`075b;nc{Qt~i^mu#Ehh6SG`
z7>hFDlZZCrR)tRfEHc9MO-=No(a&fRJZ^&s6?fZ<d#I-uTV8jCN4!CIp2X<L&>Q+l
zT6p^KU_Py`s^|$zG{^2o?Cr(m6OgK&kbzXy-&64jzte9(=3^9FS7>Rf4WKvWX*4W$
zB8q95@$q=5@hvT*JqJGibLh6f5CKK*m!X^Ut~@Kbm{ByQs1`NHw6%0g4HZ?3iXmMp
zHUv_|z9B`e0sC#f0_kySC;5kX=Sej9xh(GW+VQGbm6N^heb%}-p@1rGlZdpo%OG3|
zv}_Y;vV$*i$^f<n9XXIV2#IB&<+xY^c~^@9cO=RZ&J|E)wk0oOp_ZAqe{{0qv}MP)
z``3@5Ln)vNsNoAP4>h1hdMq{a;#QSE8>0UAHydsy(Xa<HzrB6!dj>S^JW9}gR?QL(
zZx?EH+RT$sd1ENusTRdj`asXhz<{cRm}6Su(U6A|wY$Pg&|PCyBlL{N^Eaas6GVY(
z>q>CfzM*&IwJg&rf|N*Hk62{YRXir{i+kVhVP0Q(xWuHYKs7crCN~j%-m_Sn-zhys
zO`sLoVcCIhKMusvO-q7O<gb$_kQQ6>#<*y&Ab;=YMC=wVUHoDvsnC!NE>ABvDQ}!I
zOX~weq>n9ut_#$~*3_E;ae(wwvGA^DP)PBMlH2+~%xr@#wM|q^fhOf;DjpH&Wh&@R
z%HxEU;Kqpt1|YL`<uNr>AE}XX9Xeu2l^$%#6Hw%Vr2V3!fdg8O%+gVzCLQ>;ycVGP
zPbklU-%X5q3j7|=xk7bLWeL6Sv0e*oRJBdF=4lhuczIL<7fO(sO4`ukc`pwr4AZFG
zm6gydTm_xK^c#b$cUj>oEHyQ5(s2t4iEfK6YEaXo9Yl*nQ^iw>xf#c0)I?}5UV-(4
zp7$MZQCq63`bT^^xrbU9JXJ&AN{D)h+8nV~5m$Z*xF{w?46B3R;2<TVRU{UFEDWJ1
z%!nc(vT~do9m{f1*?o@f#T^34`$t84yR7i-U0{_FY&RX<*-BCGq!zr0*t@!+6<GQy
zH+`KZ_Q6wd6&OyPfS?coM4W(b#NN`y;LZedVml-PJ-r8(IKh`3plo{WS;6#8z<LA2
zc~>7;Z>B71uh&Wtn{;RPV8QXdBkX-{pdoS>n7E7j(+t3?M2&_G4n#Ap&Mjw77Qx6T
zSl*On=CzCi!dYs%R>BCx0ArRD_|keHNj>N>x3s}w<$-|kSH=;Jt(Vi!0~_WG?6LPE
zikkw@OYeJkBI=N1g3mO^I%_Tg=Mg91{x{BGJe)a@tQa1>2(N~XTnIkct=E}6*8EN@
zPr247D8>dH)(|lvZ*ZW6gj53OeBqZT(6X%Qqt&*&^0Ou7w~LCIk;-{+dx3=yNa9xI
zPf<gc3K>A>`gF`A-8m`s*0X|8K{{R$#M04=`fP!B{<;lVz<5%KWwA`*-Ta`CWUjbm
z#fUMP1VViAcA@(HQ(BSSM*YjFPS`^MA~UEGu-IxM>i0uDrL}(0(Mf_=ROAxLR#8jo
zV+vgXNj#oo%72pI$pyIP4GzO=Ad_vQ6~QzskDq>SWGWK>Nv+6N2K~#6oNB%rjBPpE
z=(f9*tyZMQ0av#e%JaHygv7h+z((XlJ*BUMjf`pkrI4r@?8-*FZGo23OBK4dKACQ?
z@)A|8ZmHOq2ZRR(lz8521_JRJ-7ZxL-1$){itd`bA>%5_qYB=yNTI9ma{$uR$W^Ko
z9CQ!~fkVNoPf#PiwK}#_8U=#3Wa-g8vN0=N{MxyPhK6{n`u(1^7W9Y~RrVh&dUA<-
zsCh6Mgn8_s;D}NNxMAIJQNoaK4ZgO$eU$g57h+(jC#bxm<d}Syd1!w|X>F(}ieIz8
zRsxliqg~f;@_n~@)UG@b(z)_dQuugYn(qG?fB*)A9q7$1yvw}|L`??-bi)n)OiPL2
z2&c%X^VgM-_9JpLTcWsCO-(*F{FQZ`=K*U2!aVxz`@l&m-cq^0PD?l7scx0)_8TE_
zGkDXWlvtKG<zK6%`~8U&E53oesYs<+Zf3+DtxmBg$87%7SG{XyQM1P|AY9{ML_`bA
zq}co|J!J(df1;)~%RxYRD?d}<gH!|CEp5vKx;uWyB6wUupfVmm-*#X5H2?`EL0^TK
z{-F)gP}Vn}ax7_OL;LI2_C3I^Ucy>ZZ$ldLH`Ej|ts<_=fa8G{ZZT+z$iEX}!)Fj-
z+R9QT&14X8zunUmp%2_+K%CblZ&lz5upru<?n%d@-MmbJ`%(=&AWMm6>B~Wa1feO!
zq9)vz-$`tVA^G$Jmj2TUm4Q#6dKfx((9+oCLUrGb5_+Wu5&6(*)FWiOHYX4(8I|e4
z#NZsFQHOayX5zXy^c;8%14f32nrLl_wfTM;Ik}#`qv@9wnb8d66fof9clM(!328qV
zj3s%E1k`1YdXEA%DWy`YG4RX{UA3Va?g1n8KnE(N!>zrQCfynBSCBr%-n+&|Y$zf@
zp{cVKE6CAhdeT@31hEBXp^U&m7zoMD)bQqc$;T7xdGD<!E6bbaNfA-YA(zKKzB?zS
zgDGjilYSNvf|3R3_&^SVJ^AKh@>nQ6)su=Bu~Ob?0!lER;z-m=0E~i$B6L*+w!H@#
zlSm0bFrYjPiloQ$Fir@o`43-pvd;@A%;cc4$ur%sZ(;<jq;{C4!~Hc)S=%80!OBut
z@orw?Bo{3N&VZHOO_lhJq9;>y6tdRA5H_Zc6*0wToqKSLy8K6xe{6J1C3KmD4WFTn
z4Pq?4gHmF}+wNNB0Z9IY*7YDlUoN2?Xh~W~c^tg5!G#(AbV7kNqW7^Np+;+Oq4y=o
z|3h|#{3H%Y8Kg|Qc!jP#-vW@{Pg>iTkkOF-s~7{Bob2#SZGb0e1_+2nP2b*taAxpN
zU<Uu%SlMYS+l&Vm&UqUgin6&?`FP@>NU*B=0jW$UrNwEA0RTDMUC2$7)=_lfI(Z;U
z2eDvU@G=5A3!|By%P?(dc50`l7Q=B=FWhj?jV`J`p$!{St7-0oc{!k7?obNiT@?B|
zlwmWoQo{IA9mv=XC0-~sY$Yud7ffSx(Sh5k)y3V4=z5ol(Hkh^?{&{K<Jas{FUNP`
z_aY9X9Bu?=LCzGI(D9J>4Rm{aM06lTi-+w@L9WNlzFFRBJp10)!8w<mKY^EntezD{
z#$L>5*8q`@E5eO^hEI?6{-uS5UV(&RdL+3=2_5!#Hq3UX`#Oq_fV2z(y(U|L$9Eub
z1BCue(5qvMmOa3DEW!!CAoOQrCgY+1L{Kpv_Qtr`Jfr>?qVLy%z>Ou~6vm;L*xO@v
zu-Fi?gB%noEnrxHxu0YQCvIr6V)<C&KRKj`k?KrxKfv=+O+<JioQCWbGu4YKNK9qg
zLEuIph-U`RclzYy9CE_*fjHfadD}qzH-6iS*y>ub0#aA4rU-5&R;oA2LrvfE^Z*s)
z71X0$dqIF&kjU0o0Q3MO52E$5&);<9rZ2tMh?V(bBh0L8ZpZU@4uD{BB0ZgC3P2tp
z2cRBq)pQV`PK4Fq?y<6UNMR)?x&e1Wm`EDHLf9e3gu()cGbukM=oVVl@K_7<ZY^tl
zn^i`8tSkZ9z)8_B0c<>ol$OQyQd5@Zeii6*Ep>SQyTqDkzf4>$r&#UIHCle7K0WlI
z@-C~K+S<CzOw5i_7EUn5v*s0-uWt8chQRb;o?P@Ol>s8#t}c8=PIXR|k7Z4cbOy*$
zY31G+`llMO7952hb)q1C5&;9H1yJWCr5y)oCP8N3Tafx}EdUYKl!QtZC@l!k$M60z
zCxCjewBXkXaJNeljBO2A7~e0GN}ydoTX$T$x?SAnL6Ao)RFrT$b#xv@>iV|4i%b9v
zXcyRSL~iDo(n?GPz}VUaM3o(7q?9so(u}Ey5<*%2tf#<-l?~7>H?;xU1wqL_!|Rwq
z#uQv_BCBKrG_&0;<YH5{|2#t*cd<wf_0Vy6W|I6vuCP%A$Um?LHn&uKmr6tf#P>cp
zh=2Fe_CVvN=E8T=gMe3Z6>)0sTT3aj(#cB>tZylQ1W7pL3}+p`yFFK8$6Y_>*&iix
zGgWCT8<4A};Yt&Fn--gz7Dj>e7T~|eO%a-RCId^sRPj=p<*2MvU#$p@?pIF@D~7|3
zYN8oZW~EgBK(cYa(svT&9hFSEABV#^W*0wXp$8-70Itn?lX*Lyd#FpJD*cXWJ<<+}
zihDG>$n<npSR7m_eazfGTONeP)ovgxKATVXc}cBBU@~*I*EtUTTz8pe3RT`)D$H~+
zUKioI-E<2;(lmJyDS;!GJW<2#DldX_Pl~N!WrP|aYMCOnWDsZp<1r2_-pOa7w#+=!
zS!4z{C`WbR5tg&5qkMOsDsP-B=ik9@NdBHPsKZ#10<2mt^jEN(deWMTSTXEJ^vJOq
zdZ;HTolgPV#%ux^s#A`gf)KbTv(a5<S&T5@a3`6BG4BOdWdS#{S6v8c2Qt*a+^(?G
zS2gTp*w&I%25N>Xl<d-A15h(GVCBaU!g2|~Q*0l@lvN0Nm=th6Eee1zP;V#-!#KCc
z5fbIQhBdfOifRLozK+a9QVtRl(e2UDZ`8b@H~xE|lM2=pb3H@8D}x`@N}qrtOJimX
zD^v!n4@Xs9@nmnFozwoM&F6^F28V_`)v>jOv_mMLd*9FpAZUwKQ*jj$CM2MqR@`z&
z^D;jH=QdVCu2TNEU}~%ncBKPl`skaU(ZNy;E$Oj}FM)+K6d_PXhMKWNQ3&M9!F<Vp
zcj*B|X2gA_68*`=;H5;OU@gvGufMpC{${XX$f<-?@|qbb_Q)pEJiR+dYjOY#MWMJ-
zQ`=tNqITscsB1CA$jj<TPvdIMqZ|>n@Q%x~!CtqiOq2w_mx(#uO0|)bph|33;#<nn
zHAdmI1XpcVP_ZDBE3q0>1ffjSJI|sfGAp1ea85}$2TR*9$7bn(ry$#DOty(ERAl>C
zf>10rNdTw_&Wu3M4lWuq4LWO%)NFkMDuS1obettxn(71SSCcc*F|c@cM*w0(R)o(E
zY?-_a5G=Gq$>Mli3(`<ER%rx64gU`C8mNmv8v=uFLr~*Y9rGfp-p|z3iva=(oTKkC
zAl|bCp_%noc1#P=Dxi=S6o*4BXF!T+kcdr5oPQQA0BgnuXP{siT6nDL9AY^UD}&_r
zGkeQ-WvAJ(pZHuyk?36SkhYF=T8e#t<^p;j!}OEPQZmSJTe?TeYTN8uF{70&gG2SS
z;`=rEernm~zhhK2WE<I8E?^O4o%d9~9Z;olkcCC*VM!%z(hF%02jzT8Wzi&ZTPHr)
z%fSoK1W;KRZCX$jwd;QLFyo?kPEHme2Z0wg0`fyEr<R#%bOjFy*$E0I8@0y*uZ2+k
zeiC2|I0w9*-VR<78V<&IpjJrzdZazGN(ka>sDuyRhFK*<M5!6K2ty^9j3iD_YLAUT
zPQ|&3AUcD#606b<2h4z8**>)fU{$rbB%qbUH?#2=u*3K33Nti8eHW^25R3uAqZZ+&
z%4QwJxQ%7zAFo20IaG54e1^%G6gMHk3{VL`xz(2MKyosKn@nOIjBgoYGYAu8$yYp$
z;EQ`(r-NO2-o>JyQsadYlfXGZ9m%q15>ZMaNE$5$5#2yEe#KHac|+G7h};2yZnPmF
zegTKVreOSt`u%Vk6Fdn3$1VhL%nziIpRdaTr-&J!c;<HL*u3&8P@97EdI+XxHD$Hv
zHko{@K3f995H>zF!9IY>v98+zk!orRL1ISElG^{ir5)6|w4|42szh+Kt#6wGP`%Fh
z)N+IRSkXAkIsz*9T%@G2$~~+w2dF?eRG|V@x`;i~>S<|EL6(&FnIh|=_1e2w=vhsY
z?srxk$*RcKoa>YzXSGCTIT%wVEL=e#IfkrFCQg8otSK2#p1}KoY&uyI$|i1$0CYhH
zOBxhw@baypK37T?p-~$9Qfa_B+Fnbg_W;&JH1M-<xzvPgzc)jk!It67(shqbTirO|
ze)^<456I(2v<YZ09F^jg(ILHskD%$B-N_hkY!Zg*l0!X1*zOkNhLK0vB)?&XM&Gj;
zfet2h0!k1js1q~cy(>#Jrzg5hZpZ-v_i}Hj*5lX?DhD620O9))o#FuHP^i*70rx<a
zUfSoKdA>UyRw(+9lM$HVC+#+<ly4{jq!TQN3jioNL7f;gHLNP!28Vf|Dg@mXrZZqg
z_iWSlumVtTrhs0c2BaJCQ@rQTk71mERMNR{YE};Md{)j1O8fB;#;fbV3?xm(yikBJ
z!2eSyZ88`$&Ts&Pm+4S4fYX_jj7ecKs4gKPlQ;{Q=ijh$bzgm%$z;BVEB1#hmn-gv
zBo`!!o>1j`Hi#MrD6~Q>ui0W#69<wFg~g3!casb6wl8JXe9&T4Q1j6x61CkKHc%c-
z8yRvMuIxEbNb~WlM9C6GB~X~`K}L6)TR-hwPZ){X7G6ICeWIbIeF=~oD8Kcg2h=^o
zU^1cFEC`CjOnj3)bfhFua8Q_qrw`MW=Hr!c6*Cs&>!D&isM>?5ZQ;Qm*a&=px{w?e
zLJRSarT`unh_Hae8p~^$rVb(_0c-=HF;lG3pR=b}B_EU;R7&ztvw=+oj|LPWmfW8Z
z9oU!@lO@Nh#LWUc8sF|u5(7|%hq!_h24GTp&o%(Bipzx{tb|E#oZ#Ng29o-LLN+NR
zW+O*XFu-ynOmp>90BtgEw6F{mP$BYNBTGakS5P-cMn>ebX+5my6=GJ5aR#PVX8_v!
zmC4NjXfH%U1mQMY>XXBxWLadSiHc)hF$?>i1SA8JQt#G3O_tRw(m}Ol>e4DdmS^7;
zC+~)E^}o3G3RZz}f<rYyDVYe4J-x)%KxPrDDvc$vP#tTm_Umv`0FXc2!mVqpqPacO
z6I%Bq02U0W{dn>@Wr2WoC4j5UHO+NL83wzXd|zgFbalyf10;C}Ajx%K0s4zX)%jqe
zPP2GnQ=IGTlOR-J7Jmvr@h6OeMuA&B&<M1ZY~#x})RnJkx-+j9Q$-mrsq<=UrAT+y
z%Ebo#4OY%1Ueez~q9Fd@Oc0j{6NmEMq5o0n`+qnyiS1fJA>}+cbcmTbxj-{(&c_sx
zZ+cERVFV_4WHZA4Oq7U~5loPW*a(Z$1lh*b?eV{qJ2Z|=v-nvv6@UMP?f_!QUxUZ7
zMY67cok=xjU)Xi32}+`>a^ONrQ~RY5O2{+7s%5jkW}C&LMM^2;DD}?TZGdKx?Ux<S
zXar8xYjmMUdI$GVKm8q*N`4BM6y7--7)}UO0gH1oGt!g>kfwg&6b%|+Gk~Q!89trV
z$D?=JJ!<%Sskn1B#IE3nu}rM#Fpb_3J9C+X#hD+&G$&_*Q!pW<z9TrpR>ZI(fE^*4
z_&9%X!n3l-Xl(xQ?AHCCVNH|MOAf+#RVJ2=7tap9`GK1`DQW$8tvVePnl<I?-^xpx
zEcBC;zJDp!1W~@VO}8=my{c|rH#}{Uq#DY%7}$jU57Duyw33-viJ;XhY@$@nBvO0s
zpF*W@HL!7l$dm|dCBT|!?i-j46FLZf3&^(K7B$3FdWTyze=n^^AZ<%dD4pSFF*4+d
zx&EhwCqF=V>LyBoL^T@&wA7`Gsinm?0!9|iHxpI^g`J!%$&uj>gPa`Gzs@0=gxpSo
zm?jY^K$sd1%I1K_!7iKYya<J=&mgYGUS^YA0eN^b#54tIwpq+ZRi=`MN%2zv?1+=n
zmw(Bmn&kJE|EI4y$vZ*N&veQM6JeX_h5-@<;VP3vv6NEt=k!4culm=~ho*6~SPeK+
zAz^^}OyT%KjTs=@8$h^;cotup#?o@0kv=?*Crv}K6BMTslMg6L03eeEvHhI?HAPXs
z1BevL+NaZp0h~0Yc2jXuYK%WoTMMtI#TC1=0VT2t;1Bm9{N^DKgVJdaqn=i3Q`u#O
zIgF|s$-Iu3fkC|KMMeNf8v)7RBa=uQ^83;bsj8n3P*r-R#%-#5QX3^rvcVx}V0b6P
z4B$$B^?unKy|n=&7gS0o2*l7aGW%NqR6Z#_odnVZvg6Z-6<qV#N!sM%%~Vv0%^?0u
z3r|Otn1qB|C!vO}zrJC1Qu!mQ#3bd<3jbjesi$(k{ykKxKY^8)(aKM$RIFSTlF&({
z{Mo@u6AT{+3<R{hNi^aywSolGdjWvj*?~1^{1|J=nV|cRAz?pQ0?<VCt_I42!=N5C
zcH_(iU}c$&Gk49VFC8`3lOv*@^&wNySfIBZWOaW`bo)%Wzggl+><D-gQ)_}t4BAz$
zviT&Fxx@e#@J^&cTw=hS0;y_C6c001WziISJp44%DU2)CAl@L83tEVQP!Y$IvCu;m
z@RTSZ2FAbbS1-qP3BJd{abZhHe~v5-0p>(c57WQ;K~b=W=TZtoseA|k$_}|k0l{?L
z0kZlVB7qKi=w^<A*}ZNvP<<u{#Z!Cern2)vs|V;znV`-9uzL!;Gy}U~!fhiXX4Ki)
zAT~3s%Wm!DL`F<Uf`8RW1Nh@VZ6#v6ZH~yI8R?I}7tY*CGYPz7mRwmx`bB{6P6HjI
zY$81y2AWRR{At_I<i0VsVoh)YCNkEkU361v#Xrp~CtA|}9ZN&0BEW(t`ijOI=_Zu+
zzK7S$TFdJGo9buB8-T|93MbZ{CBQVni2eyn0<^piIr?B+2$h|c>3|_b3?zmX<7E3a
z`zdw9DLF`8ojhV7P1=#5ZIlBFuh|&0U6-Aqj#0Ofa?rBO79Tdmq>42HU9aJca;s)x
zf}d%(`msQQX%pQ$sWOUZXvon|dl0SR(my0XCB;PS1r5$uEW;+Xd$U^9c9`r2HC@o9
zuB^ps_XZ}LRmu;rER_Hy&mv~;E8u0au^?9AHTC}W5Md^GJ6?EYbqy<pl9;`3vt4+C
z?8K_OR_gB>>!}4zs^CKxOlquW(Wo9iedHigsUP4eEWv852h3V_vv*u6sOVZP?yUgT
zi-qiFJyz?xGI;u@BvTbY=X*A~-Kpl5dq0N+eypQ(ohI)ITTqTw23_RacWBv<73_ZK
zPv4}Zo;%iDIM(>S=+UHRT?dhj@QE&RR(tW5ibLRoECP-1{MSN+SzU|lmiqAqqsf#f
zW;NGg%O8^(U?<gy$Ghv846Sh*#uzp{y^Z|HB(#ZzIWvP97Jhp`djCY*;y5z=?^_pi
z1476<vmJ7*wT?xY@E_-G22O^WCS^*jZopQnNnN4i<Sf=;0XEwf)NcTi{bPrEe9<IY
z)1<!8@!r>oc9scNQx9M@4b+}^%1h9MaHhd0)EHbapfp93upw|1=mp65re02rCP{|_
zA4~W%pa}thCRZ#i|7&hyFb<!Ai8u-M)roehYx!knOZs4t8N;G=WV+X>pOIc!^CZSt
zen0K3VPnB`sF!L=_uJ3>>+IHL_r9VOXG#726YOf-y^bsCf9|T2vq6AU0^iCg{4_~=
zm>udfwLwltgIVprP_qc2<<0;G|805@ga!RrxEX5#1bN_J>3y3F1~U!SkD>7W*yP<~
zfbGAg4^Tv*@NTl4R?(I>tw{Z`eqG#OARe|1Gn&mt>%5^hCJ1CAwNw?-=pTj(hK8&7
zdnx2gU9}i1%l;uiJEU|_th3SEnT_$dr-9=}2b7Ji0sRNekq8e4b0mtu>=)pj0r?-Z
z$ZdTS-8QMfPCHMJsu!RaoB-UaC(ViS@o#jhO@ynHiA?{XOaLjE42S<6MC>1w=|3K2
zLgdWzJRBKJ7tVm%U*)1vRjt0Q<O13aN?0)^QL-Tn5SPq}Aki%77bqfz4ZWYin?7+1
zgBrXrE+S!6Pn6jxKT}iXqV)>1nN2!U-iJX8?1+!{pj(@J5)Ow;!@Tq?QwJ@T6Z3LF
z{4|EJvIpC+r#{S*yTqJ&z~t9JO|Z<tHY`x#q|{gw?Cchf<Y2>BlN|~KU;T{@vy%gf
zA6P~coq(bMXPp@E1Nt=IvjA+?l!h@nFUT#K(}-BPC3_lC$Vo8d=*QllSuw5H(=Y1d
z$ERPg2M>T~n%PS;!HD<;)CM5de<v0MBom?-ji-KKV8?Wi&E7I|I?E(N?=N^!Z1&Q`
z(la!y8~#9uV2+jeRo5PX%+^nyD*+fSETZA0I_teVTtV#ipDDetph$ixi%E!39cUVB
zhJ`9PP~RQ`8wQ-KE=|P^bk^Y^ofYAImx(6>N<R%7Vh+W>FR4%ytKj<_hC|@Qh^7g`
zcCU*Yn{4Qdqmt;MRra8Hti6o}@r316YHv~TOiBcvpclYLS1H1Gaij3&_F_Mag4v^*
zW<YHw+$%C-W@s1+)_%h4|1;cXoNDn~WYLW6us=muKtufhJ|4u@S(u*9jP0<@!BSI-
zPU916#>r7^ot-qXhOM(~G-!rO&dlf)v$J$^S#-*HqKUd_NVE-;%J>6-%goSzNn>Jz
ztdnU5tR^v4@4ve=RO+0pSp}Z^f9QvuI<IMxMfm#-ffMB%qz2zoHb?4IapSbcgqp8X
zpj)XOQIJ`zEzk>1RyzzZQ$P^D@v&5!n$}TU24-YsXXS)5x{;-{uf$ZU4Eg_K@6F?(
zY~TOkN|9nj5gKGIk;)QdO=6U!4WXzo$ZqUg3sGq7%h**?F-f+vC;KwCkbR%AFIlrb
z=QSwzeRtoV<@<ZRe$VrIzJK(pX1UJmI?wYsj`#6Cj`KYyN|ykbHIF%w2hIdVjb_g8
z?W+l`QF?0mQ(x_u@dAGYj>iC4+&&Iq@fskSdcI}OH+Sev`07I0YX=^j$B~{}8gl$Z
zBAUM7{tMBf{}pZ``=vwqzrsx<#jyYG4Bh_+g_}M?!cBM9O3Z));>yavjAv;sIJ=(L
zB}2xV445J4==zc!QcVUEW8tcO0lt1_e#`k+aB}JA>DN{1iPDv<7;qe6X?3A!)cPot
zxqdN1mUZRRb*h9Sp;imb<h0eNjDM@$@NYXA{)cDg{`R^C57vA5Vm6v%|K&08e_*aQ
z;qb4{!2kDNbxZF0KRYt_f3n?ZtG?PgW&M|W>jq^FbWdacEZmYC`8VO(5K^yL*9Y2^
zSNf~M#O218cyN3YG%}7ut#beN3EeHdmw#m2U`&MSmV@j>(qWs;4ypejoLaivw@#j$
zg9B-cr8&ytsm^tRNrF<jECvKp87UA*YoI_%1c9_~^ROJv)<9Yb&iFvx5fBUPw`Kxi
zU?MmxXWnc81=3qE5J*=~P0{yU16Dc(taSNf&~KH1{#Ux`|B@ioRw8)wsNf&975`Vd
zX^U3j{|)J;shoV7tTvgYOW<7Y+*0KbP4X-KPV*;=%_E3uNm2HEI3(UAE|tBwNJ%8d
z7e$by$-wU(fXX8&X960RWbW<jlEUSdIga48%`#|-=n|V-qIjWR^{&RVYH40?o`?Z5
z;50TeQRYxr1d!uz__WE`Y^kqq$Z4-1<)tN<x^wlD1E~`5D+251x{+eGEZ<9VMo7Y}
zXUkk-H+7cyf#L~}>OKu=tDJO?1d2!-G}ERqvq+%%x>WbSdu^#-`of@c3KYf<K>{m`
zXGxmR>#|6H5$j%;o%&U?gnox${p5Jhx5kkYAomT#OLw!|{mL*m%d9_ddqc?SS2>g<
zs=e9W<#p1Wlj|>P-RlKhNdEfl_^%#`JWCT@27)O`8Fe?}m-N);k=&m`;2Rp7ze>2^
zhaxu1*`%ryBxSbGYF&2e*U4FPIY`M>t_-MUZE$2;s?Lz+`Y%PN4UJexZ}{gi^7TW}
zkh=CZ_AM#wW}yryr`(}**m3}ELnTMepir!aq`<Z=>9iqh3n>n-Gm#Qa;6ObI$v`rx
zyAfM-XEthkkWQ*n*%nQwjpL3$%(w*noW(Cqr>)l}_1TiHO+p?(9EO4tu|?DAKe#rD
zdHPk*T|cDRl7iWk<CQOSP&`w%Rn%#t^BvNT3-N;*vqaM=L0EM{Z^$r%vp5@y{#H<j
zQ=hJi7T}(ICm_B!8gxojPAxM{I)lPaA1LhjW|BH3*0L6qB-Z7QK~=}EfzLe>Qhb+<
z#sjVM29LEtG0eoY>&=Pg6-ZpVv<4)wHS-+(`8*Opk4C5Se%_?lWKV4)V4hS+%o7ja
zpHB2b8o_^0<ovTpIN}eT5?eGfH&splUMtGIT@J=RKgtfY{2wHs$$v?ku^$1-^=G&C
z2mD4WdGq+(Pr<aGTFGb4lG!13^kk_&9CQQwpUFLPYyZW6roH6XW=xVqH>UZ6Qq(@H
zyX5Rgwsv3qMJf27`kM~-&+K70fV|Bni9<S?PV=wlV5>;@Puex)XEV>1eX{lV9DDy$
zth*#hGj?4kbX~&#m!R3YPVhgq3H?v6+yTk>Z^}xL+8H)a&jF<+)w9u%YVx1-oX$pv
zoiF=iXUDHr^`D&`zs~&ql`Q)gGU24Yw~cOpWALK}(BZkwj>L__bK-e2StB;{CF9DT
ze)&z7i_VCZv8tu7I>%!=lOyl1r8_n@KY&iB=ewE=4?}3V6jXUOPrNFa18wzu?0hbd
z_hR&DGb{d9wSZ+b>5zKX{X&cO)cdnQGaMl16C_b50GTI1ek`8P=?wM$%S8R79Gkor
z0w#8Pi|7#Umk!yS-~Ce)$e5K^bCx&O^<p6rdT@&Jr-&kSL=_6bzxqQ+oztzL_y1^X
z1#r<@#G(v0Pm^MR9MM%UBJ}GBaL=E5Fn^Fc{D*$OjSG|HdT6~`OYhj6P2BuZf{mEK
z1zi_NXZ}_1@E-`?1EvF@V-Q|yPH;)wEkD-xUOcXm3H<iNMzv>gM8#l<q6GY8&pP$@
zZ?_Uc8tTD)3)LyfHt_r~&?J)#ek>^I($DDt)4##Rf=3}~XaC!W^`O%_1hLZ?mpL(4
zA#>NKd2H85!~lhCx~XuFSqn`^E4Au2*3G#1_OgBU+8H3}V}P7#oLe^6qM(zy(5Kqi
zll0_P&n)u@S^Q2%{|DGo=^?lZe(53~MQuO)jm=;{fI9PP8A6+LFWh1Dq!1zJ%Tct4
z<VCUcXhJj>MYv#pfq$uoUVl!VZxA~&xkX$-v7FDvc?6DVW5%DF{$|8yN62aLI09X4
zR=AZ5QR^$%uk^GW5iMz}#8+D7kPu8}XodMIZhgL-kNSQ;JlTI2M$$Hn3Eg=o2qDMH
z6RD|!RtX?eX0qxo)0Gpn>KsH?_`PU0Vc~q)A1s|`gNZbyCWbkTrfG?wJB?H*po=*&
zn+8bMC9e;JV$H5Ypzso=13Q%Q{+gZwybkd_zL9+*AHbc%gmm!|K7s~iU)-;a7>%E|
zishAq!5vH#74U~v6q&4M!g0FpK{@rMnRx$HTo0VncZH*01)rVJO}cAnAow7X>3e)p
zKU~N+YWI)8X@RH8+o6F}Zt-kBk#gi;r%pxKpzI;1FG~P+8spke<uD_jj`6?t{Q{eg
z7}9ugXl}_xSJWbM#%xZ^MaEd1zVp(dZrgmkpQzJ<HhGBVM6pi;>oj%w8JP;d6Wps6
z_Wdb!>XCa&%j%h|1|Q<$loYj%7Lp@hym9i*&qXRoe*ab-o!up6E{*P#{?Oo9Oyw|g
zuW+F12tFcw@>XjUH<`XiB)A4I!m4wWLa2XKL{rz@4?K1$-v0xxh|`z)#Ton|o*=>g
zlVWKemS+X)%%RC`LHL!v;w*h*ktJ2*hYmPneDNsw(xf`xKVJi^)|V>3X^$(fs1O&!
za9`Sa5w$_=M_B(bx2LQWwTJq2iHa?1y<i(%IZUM9e}T!05w7_~j2$~D3Qg=NTx>`g
ziHQ{Lh-R|7L}y4X`k+79Bi{<MT>SvadI;qaDe5DrUv{U^goSXa{0x>f#s%>CrO#9d
zr)N!!>|Dt+Qz__|CVW%io{m}^gYyL8{l0Y9GM7-6pUW=?6Nn<7VU2Kk7AcA>p+d|)
zXsTu6N)}!YM)#YOgQ+_y)Sq)F2yBe~sF9O)7sxB95a3GJton0WXi#M>#%U$H*&X72
zeWN(_wVr}oQh0c+=VY9<2b|oq>EtCvo<(I3XWmm16yLv%8b|ISmf3qmI-W5eq=GD~
z0`Xmx3`|NGlU3)*iXe7R%2b;$iGQ&keJ@3Qb|e(uIXgs!pn~D<MEYHviJ<y%^{y=p
z+6VnPr#^ryv3?V`R)DtP0Q^V9c3;WURa6LbM*RxEFYYbkRZ#&C1?4V*rwf83%;(&g
ztmc?;r_Mslp+zifQR@~PVo~^ft>@0!A5;#Ea4k>EtAd-RYhQoJrTC474}a8_L4f6&
zGl+fvb_Z4E;CY2W<q&3ZPpVq#JWN<0+UL~eWezXcc;ztKsWv`-0qTnjO$e(Dda+B6
zo>wNX+lO72mSZI^ZMqW~L^bmQdK4>I^o)Xz<uN#?l0jJ<MFuSD%J&Oj*bt>75&yY^
zh&+<}<*5BJ$%{v0*lFB!M^0Y40GmnN90rs3{kpvmKX^;(WmBBe1z<XyM0=Oi|JXki
zSk_DUJW441;{KiK`$@43Sl>&%ST_B#P`W_$<V#UFQ$k_S99T0R$_xzU;|<5!Wzt)v
z>xn%@WKqBh_1`H3ZgQT>;W+~GL!*9Gk#;kj24ydr-`My>Leo}&c$dA_FrqrXdM!dJ
zW5K4^vzt>jbEWLTno;O-$MM%~OHGf(XYS8wYDzs>C9buf&7AMVWWQ=MSW5_YnUFf~
zTI;s5aEN$AX*qbZ<C;xq{lmIuo<YTtVBrsE^!0pM1$w{gD{31rm`C=F3qI=0xtI)R
znsj+NEG#CoO1pnl|Jv8lmD%bY!TyaaF)kzWA(9ya^^5H)E8~7tL7Yk-+umQLP&DJj
zsi%%zysj79Y*_8@*&i=0ZHpPcr~{XlK(f5a3XgoTxEk1GulwL3Fg#;13a&4DFW7Vt
z6v&Xsl4~~2*vJ>p(mF>Pl!Yab-R0D;`qLqE7Z&WzOR!Gshd0j0j20uDQ=dX#4wK;8
zUtC5v?sOsk2=O&1uGvb4Cp?M_hbZ*R`C3Zk^Q@4nSha#BRLk$3>Vdo6)oDTOsK!5R
zvVbXGnqF@3olwItGEK=wG$MN7mr~5L15PP07}{bA-c<VKG)>y^Q7DkN8%;OP_k-`Y
z$@!l8a3&QUD^kT0&`?3ksf6$OT=T;UMiVqAAyIlx2TzL|B4>Aa<7*!ELJW%-#zuY7
zK-akzA|mgIp0bDSGqi$bz=*N^CpBjJIEjj!oa1R4DjfK{dkRg}9e9Uo|Lu>_kwxo6
zBk}%7a_3q?-%E6mY|4bNE}1g^bJLyiATZ6G(uUJEbqKF(qf3ep`9Nqjc}9Eo`&BkJ
zF=UIEYj(qqokhu%F;%f9)k)9C^l0zy5HB3#$D)JAguUC|wJ)lTm^4RoldZU;lekwe
z*q<bu6S=VyseqT2dT%r618vJgM8CXnk*{5O8r`3%Dr{dzu{0|)_$!d(uVmaZy&>$c
zC7L?_!Jz!1l^z)8L4cb)SKD^t?c^3_PEQb&rEOs)(D)A&X!#$JaS>xbr`Rwa*%%N-
z+>P>sJA8ODGgN@6=K?E12E{5qVi_lyG<JJ6|BZ8tsBXCMoeUT{K`)k3qwt83V!#n^
z#g%PD#asnrpM8)OI1fBo2wwO?h3|*cc$cMKj%`7F6ZZ)WK-Ap-jA)`uMeh{4t>Y$d
zq1O-pN~YzBKMG?0gc=OPKY5#6IQ2FyoC!gpOo~caKBNynqEwH(9KqwQh~JL)k0itO
zkVC-_#Qa|MZW^I)w&JB_!yPS%2RuYYT!JM}`TmtBVD5N`VO6&i&=(o}3F@)sh^r&D
z+}t2+_@i?a7{IKCF_C6<`~FL~gilAH$trSVx@`4+_ncd#TP|vZk)0a^rpM@@S25!s
zYt)x7NQTJ{-8)d9P{dJTM3yFHWQDOx{A@(<#TlRKOFDj@XOWtC<HB;V#YwUmdj1`p
zN|9uaw?}H3pfT0)SH9-b{K%gd-3zaZy@^8M&+&M7mz5zZ;&|G}1GEw;W2&)=iZEeI
zSnp@5!%X~-GUV_NwNphDU=Umzh4Z>{vsP_W*v{~9I}d)lo18J@5w86!9%z0L8@CC?
za#DDACvXzGx2{(g)y6~SgUMVE@k~b%6jQg!gW&v+Rt|#=QOC^b4s8e>#J>C;6haTK
zJdnTr;3>LbJ@y(!ueomwa7O1d$H@;xh}ca>--UxOqaM036;u_F-nhLU-ftob5QFf~
zRNxQCAiN)L4NLPlbOxZNE^#DAhwO;Z?iYu>pKM3rY1e}Zd{8}7m-iHc;sfpAh#u`w
z0|}b_#DKt&Q3&l8;`A;kqa*I#TqrOB@TzSApE+uMix9QO85r8D>$q%eZm3nll^ce#
z2)_~(uHkNdX~)+US4)iA*Y1kOYa>lx#q`aT1D?8mL4?rV=LXks*+shY11J=emn%`P
z1*6mMmb{;xF9YKmMucm~;EOoK1g$WRSjx=fnQHr`jo-C$go{Cw=tspM+r~~jlUx_h
zNmH%_EfPYI0*2bBAj?2Yb}^D{6J0>Nq6)tqbp{Dz_^g7&e?GqhY+&GqdXghKegCpZ
z?ASjo(hCtJV?ZcmQ@8b4#jvuByEM*GowS6lqcBAEbc_WCf?>DG2l;O7R0t8Hm?>zA
z6H?T^w~!s|2J(WcZ76bvhyL97?IeJtc!`ffj3SCNY<m>vjh#_ovv2W>ee_rr$y07d
z2cF7T{brf4vNOT_910-_<RE)G>=tlpP{=pd13SST>o0#>?<v}yGNGxVotMe57hXWx
z$~#sRBgxi119*x;MA2-2!;r39@&dhB*k_!A<;-<?Ra=}eU$afFSZQZf_q}&Tt=UXO
zwE(^6UC@*1P*Mo}+J9-T)**=*A<V0M#BYtczIpkHB@f(~MjNY4l#Ynj1B;qdR{qHP
zi7v4NHICCey&v2LFzYjdH+GtOg4;kD`@kUw^$lUQya!%&*k=d-4$@*l*apC~L->@S
zuqd*s2N=m4=PF~&p0^-snenoxQ%SHHNiG?-y^4zeQI}678IMoXNxKhBvHj2hKmEop
z4|sc-nY3Crc9MsQQBYxU05ktuEgB)ias(@bzw*)AQMe&B@j-vQN4^$9>;ssz+o;>L
zj2gZ0lXucQJ_S}=3~VFD0*?v)c*mms(6!)}%(ktkamfH-JY~B0)2c!>Rr+4`pULlq
zLrL6??es4C>DPVuo7En(eq+vZ2ZP91VVa@s{mZNXYMw7b?NE*+6ARnU<t87?_7ola
zGlR3he5vT2v2eubJf#p4OX_~t?0mMb_N5BKceNMpNk2VAneerB&su+kLHU{d9x!Y^
z9Srp#?-6M;oS`vc5q|;lfwc+*j4v%P#@?6T;-uS`3k%E37vAs2_(b--|6cHcm{fKr
z-d#UCwg1e1;$h(EfN>j2^uq^5v~>G7@|<3E;2Ccp05fwN%*+OOBW)09>s$BVrd_t~
zhevX)&kcmC9rOy;9n?Z~8Dhghohe5=p%97%pB|+^Q2b0kepEb!w&V6cY=@vKht>TX
z`{56+f`r;Ltt_Bz|KB@6XsIp+99g6X{^25C7PZfX+xv;XKAzT55hoW4lG;fmeu`P6
z`!@L<lpbk6Y=BQhZ4m<Od1y~B`ioIGRyUnGdjTW{dx>H=ethC6Q$8IH%0lyVhim_S
zW}*>U``kgISbCUw{(L0;r=&?0HqH3on$`w}2Q!yI-&(%BunIZ&NVP&DQT-7qR3`*e
z408v)Ne`wo!=F2A75fyuj|R1^{5EYGixmu{;y=^HDL&vJPwsiY`<I^r*&^iWB`CtS
zvmoBaFAUw#DkeF?&5V=@g#MF4?{~WjS;4|iYI%OTCV1HjiiSrKH+C+`;y-J@5K-6-
z?fN{c!>+qvsBJH{c^7QkPkit>PQ+(_K!fBOCCSr1+;en>zVRxf##`K@pE*{h)no+p
z9U-!HkH4PAq5r|M5U$jbz&||V=O7P5AlFkYt5_XN;F0>_dgOKLAD%F35a4m1TeuOB
zVTH+tF=;?v82K~7vV?&(1mWVLD;E^gH}b1OgaDuS^s%J_STYKs_m8q&Bm}+R_onEY
zpTJuhpXz#-Ih~r`+1HqnO$_8X_j|)~1Lh12%ZxA0xNRw7JB83koO?3skLzLpELv(f
zbgQA&`mgSn9_Nd>MDf2t>wgrq%+}WmLP=n)G7^rx&C-~<k$;Z>w=qUp4B&C;ljhmu
z)>paWKr~JVF^dLOkVg(69v$%kYXKrw=mQow!4kwU>ai`IO+FF;P`4}%N}Z1SH<QAG
z7BHiXHO{lXz&_1|=EGGI$dn`97W5#X#?b;3qj0KjVnnRdB>j+|l4X>CzZ>Qk=|)0P
z?1=S2M*;8(;8bDomu5jw9C_Lew<dcJMg_T<q+oX-Q*G5F`IqM8c-j5r#0Ma(Y~v;#
zmd45kNNSuLrVv98Z*odRK8n8Pf^w?DqrmDP^uvWAUrSZ)5WV&YfNCf|`0JCcM=m$g
z7!arzzGDFklW3t*hgrbH{|3BIdFdR94*M*;=_YR8lX|v4;Gt^~NDu<i513+;p(qF}
zjKT^w7+`|hWChoKE<k0#O(2kAPIrYK0z?P`GdG3zZJ9E}w@pL{(yfkB)8MQXhWs5g
zsLP{`A&&9K-o9-PDc?3S;)2nfkq=uLH867tx6F`IBHu*s7O)xmNHR`NVk~Rf<+BEQ
zLVOS`Jm7?rkBN4E#&2PPxjRuXI33&%2T2O@4XRM98rSIVJMs+#FT@9TfTH!@?{0-5
zAiun2(Et`_+_eP?@G@;WL@^2$gcyYkix@JTtKf1s`E4-bM)X31=z`c9y-q;`{3d#R
zUJwCk#~%m4PA?x>ce!E|i+k`7{r%CGY4nc9k+$Ln)Ii(@x!gL`AmwxK;HN(H{~o`W
z^0`L+M4xEP$&Y}>HGpVbu~LW)vce4VAwa5T2^(ZT6;#XJQbl5eAZUmN&=CC#8U})S
z672o0M+^@xHf@$TbOvNvsgJU)Uiv7Qs!2ADH|MHyT&5m3MDRUF4!7BcKxXzEX!t9B
zRqq+gSZyQaS{jrwF*=kCpTX0o$tf@7SgE}<;_a~<7g75EZ?g3#6c4he4dM=DFDM04
zszCdb*#A3J*iq4&Qz0!+0C*LELX#nPg$|s3QhHF0-*#I*!t}_g7dDxN`7aUzIVeea
z>gol6uNL>LCn6A&K@|`Rq4>e!&Xv5bE-K*Fn(6X}H?hW&KF>`nHNDKMg?$$i8lLjt
zWr2kQa9V3y26DbMLYW*ys7N3&RZ#A6#ZSKI7Zg~}@KS*fsr7f0pKS0)TLAL=qb!sX
zk%$a{FhNT6*<4{WCE~e2y8fmI88NJ;^?+zG9Rwqm;?kdUI>1bASk`Zz$ZVh+g4YkQ
z4@n5P03vfCI%+#!7P!tc#N7<C#KQp3pEJ$^H#7|BTzh%KewC`*%<^|>(GRd__jNjk
z;%|T<;LUyy3<2{Ef;?~oisasBWayyG6iV;orSmK>@ANH;?Fd()l&4_Nct(hdAzV#T
zt){OSpmM@U{6Lf1LUZ!pm{pnwz6_-XEmf^jLlI*u32BI>xhHGeiPJ|b0H|@pp}X$d
zs$7XNLA(Cer*nS`;rrAfFuN7PyKex|KSKEDA|2ZxfB%>Km=SkpTu<n4F+Ai21>Jt(
zPQZ$vwF)Q7Kv_u(qJXMa{rzr|huV(&gBScimvEI)Jx|u7J@ugqahAq}`c^=7(gxqO
z6&FI__6R96-I^f(BAf=(E4~k9EMjyXf`lu*dpxHGWXLLftcmgYVx>mK&aU}lnp!<E
zI$bos&A2vQJV1ss^=Ulp>(EflPAE0x(&Gf+2P4&3zfDBaBXB|Q=bgn_{wYHSHuuMr
zh-yoQ3|OQXOr%@jPR2d$zh5sBgZKBO6JtL4Rv1rWA<@4hodknwnV^6ISSL7?5J7nY
zw2&Kl0tsaxPm+lv-|rR&X&vB~HyJ_*WNg}RRU{{sKzeiumP=)Z56bHz-Kq{RUSOc*
ztc>KG@ngKO6=i&;Dy%9aQCo$ZrN^h}ZR^o}hSL&Cch)P92k~*u$L6iZCa%!{9^huR
z&-4CkJ)u%(t}cT7I8=H!=P8GGMfJuxt%T-zIl)?U5H5R@-Q70eO)tE5lmE=Og5?S;
z`^4pt7>%2YR6Z9eH?aH|st`wPx>s20N^BVV-xT@3Pm#%phK|J=Ck!0)$>;#~ZA<GO
zmz)TytJT8lKhSdO&}#IepDtev)jY_zZ0sb?8&InvR;me>i{g)T^<hBX<pW+ZsdoHh
zC&aV5sU^AB)FcC{8IbUGr}=2wl`3(#pjvNZIl;>q{+>XHAbO%F(G3TsTXa8EgYb=V
zn=%IEdF+*)-rd{E5r!6q)P2AolJbWwP#%JXfYaCqMN3ePEPJ4WIwQ1~!9R~lY@H$p
zgrP#nWI0tpe>ulhnF7Ss<X?;-VBrDqWZujcNcBz-y$(j|9zP`kEM{wEffSEP(Tj#O
z0tA_AH=`F+OgV*>wZfEh1fU<Fxrk4itlgjz&N>OdHQR@3kyf#6mLLu4-%3jQf!aRA
zdal>@x1e~a5DChif8^guJQ|5F^a?I!S#d5+2F}t<$SXvU8F#PVAiHL)81a^Vx^b)u
zhnrNnp%t*s-7WC-Y~ewnN-^X&0Gw{zGxl`{)Fn|BtN9BOUgx7Rk<ypf%R!Cn*O>4C
zVg;~6zX$M8*0mMDL-p@pjK+<fGNh!-P+4?agvLg_WGl>20Hv@Ns=sA4POh^Je_$gc
z2|vL0gQ~_`Dhi-5?E}R|QndsGd#H*5alRMVW8*&%@DPBvzf0b5w2b2}31-AMHHd+#
z{|0~;bQ|Q;IOoHU#sH5b7YgM)>+K#}L17iBa6PTw`6ryQ*;Ud5ZzO@j;$%R)3G;oN
z&OYHLKbWpBSTF`ycvP{ozKoSI-*RF)>R$z}aQfESzLjdgatZVGOi%NDCb96SfroSw
z0IOWM;ZzA)P9ojF-UeVNcFYgrE1&txfieID38BFGtCm43JUt|l{(ppo+vFY|dH_Xe
z&`99F9WYsd9O@S3BtF=v@q_%Bl~g@@&(;sw?Rv|_dV2g9DiZ%28vcw2oj5178-B~f
zUm*Mi6UK_PZ(FauYfp_7K`HpwwF>Ni>RJp+7lCL$rgJ*w9C!5qSY)M>qx>73v032%
zJO0TQ;xwE}l0n!SRkN@Qx-Q>1)B3?Bd#-s2Zkl;lI$sA4Y%3Yg{VO@%vJrokwo<g>
zZgsgXL2TiuT45&J&~<xeCPb+jSS<zuv|8f<+<)euewHFJ2Ozfc7niqDiu}jQ7AM(O
z%UW;x_#=Sd?D?oshZRAN<4?Tt?-mQHnLw=t|M^;3Z4muXS>~^a@fN$1yT_6Rx}ttV
z!Eclx|E{v-sh!wf>6)h^1^Cw5*}9O_`SrEBCEW{%jHWSJ#(W(~O}06EADu3?zbkM-
ztTkXV2IGxz6HD3mpoA;Gsw%_!nB+5`$QNz<g$Bwr{5z}L+d}^R)gm#kf0J%)|J9?j
zrDy_q5Ktp0+3p2U5OeiIzi&2#>f;yKVv^xcbRbUsC@3lx6d`VtLSnyg&HX~K?IGh`
z=Y+O^Cg28LQ=tX^Su)w+F#!980c8QqZCY!X6-=B$^9%K1&;(>2#aWvCFmNMd6e8~4
z>^AugApF&f_Mg=uOO5m`we@SD(CgN)XM8SP<*|;Mq%Ax-+o~<T*jd^2bS6V%xt9x}
zVd!_nt|4`lEU2r2m=#Ljn!bqd2B`BR30?r8018|J0A0+H;JZcJ_aW<ln}vt6A<!7M
z8BxSRrQ2293U-OEE_@5RSkGK1BmB_??sd!rSoyjCpkm_pcOmN+wphPD#0G6#-{{}x
z;30-EFo0~u3sj|fh=+xq<ORqVl?f7eOT8DdrUdod-v_K9Do|GcTM9mLo<ul(Hr-`6
zR+dm`&c`Z|G1m*vWSCAjuF>#c67J*w@p3n5-u{H!nJ%n{VnDFA?HSX%<4CG)wQZ?w
zHGMCr?2?r?7U^-F_+c&nPw?XJ`9Y{)vH>qBPagQV{Tl!@ItV1|e^M|3@B);9f3^>h
zI;;qr1(WSt%5|H`<6ldW|H`iV=<_daEto)yC3HS|v%tTVbNUlM_@~k_;0N~;w}HeE
z6qW{&y-*RbbT?=U^`(i_?MmXm#83&(=W!Nva{&}#M*Ov&B~-DlOEMNc8o@9<)M4;x
z7FWWXCI(^_C<j4ZRJX}TjY*|Ox1a48qWBbZHAD6B^#+=tF)!?oAHn4u^<@Q!IaAU7
z@0`qVJnhLNWdURZWgt(0m}SKbGEjp0)sW$%vmd<ijN`^m3Prr^x))g=vI<XIbr|s-
z>SlO|ez~>A1sa9~$-*_>Kbfg6Kp1W`L;^}z1?9&DX!}Lb+~T;|5c#8mmQ+O(_5$57
zhY=LiQ2m$}aJs+6?xe1u-(mNtfKOIMWdZ1mD8ESE4^R5x-SF})<zwDI7SbR@2%(HW
zQt-gt{xNcGKqcUdZm+k)AueNlzy|*5&o{e&0aw1^3KwpZ*MGXZ%gzQ#AIvD9(wnk!
z?416Cfzxh$>i2NX_Kiz9^IYqIdP=?UGgWP~r~FsY@n)kZN8@DnvxMwL-x@r(&g<Uz
z1>z4JrwN)$YtM@K)GYNcSzY|!w$RWp)O}BgFtmkbkXlwC8(T&FXBA}7@iY!P(c}j&
z?I&jhSAu$Re-TiusP{*R_BV=xp%ymKX-4Xp{O=lR?uW@L^LeH|;rT2|v0E5Hv7U2n
z6ek0jUcMi`L(AM(Qby{C`dLg~gdo}<`!xR6*iJ;gXl*#AFVW?Xm@HGc?vxgP^NrWN
zX5&h|2eY%%rJXafVT5^aq;YPEl22;<Jc4esegZ*6>|P)Kf%RsgjZjw2YTSaK7bSzC
zYDbyEaKLPhK$&P(aDV4L$ku8&qb?o!uS=Aes$DWH)9bbWUwQJ@NJipdp9Vnn>NDk^
zIlj?Y!REv@(e6+p4ltqu;UVXt?Jv#{Kre{HUm9!56k?OhZr;}8t=ayQxBl-~UW3yd
zK98{8jJNTBW_drGoSO*-?`VK`SfNfet`j2booZW|!;MV&PcV_x-~7fm9bI68DK)E)
zc{8Y`t2^{wP@j5CFP%<jIe4ls<^^0iBz<i)W<-4L6W(?A6~~@ZnP#3f)u%e@YsA63
z=S$CIJ}16Br}X@7_5ryi7uIaNW^?1}8?7#3hAYd%g^lqxKZqeQ?c|Oo1Cl#~{iBfx
zPbv)+Z*s}di~TF#lAEZzlC@{weVPt9Q9Cz|n_s!Ua<kBW_?G-}%y8<n%yO|+-sUEx
zjJv&Y$z`2Kp}Q`t?Lj`ieOlgb;8ELHeshJTb!dvWbVi@WN|aNbQ?ROne@tT$=IB+z
z;}P5P+^-#6Z6Y)sJO_(USjwi$eO76FIj8BE*;QRT!uD)6v$FQqE15ucH&Z%WHeLRN
zW#gq{rRy29FIvh(pYBvvnwN=ZT^f4*YIrpJ33Da~i!f6HtYFr1geYT^w?B#@mtDnm
zs&myyFmKo}-*)ItT(hgrEMr$jnP<a<4cnpx>fp^$g*NXwv*70*#})4Lx<;-EpHgdx
zVXPB)IJ{btkh?lhW4o+lvu_Hv(zdei*=WAjkD@!(lm}H!L*krP_DuHEQ>rI_o1tXw
zCeSaf*gqDV=JgoTX1`#On0+E8Y^5%8aDWv@a|-t*_bmMOd~}y!vQDT|F?--+r=HyM
zC$H4YMBkXLHM6JwKy|(C5M<5lP+G-y?n>6S?DUn7sn2d=OBQ=qs->6aNLPJ)akzTP
zQq8ifE%$l(K4*R+kL!J^<b@8cRpXCIb1pM_4P=i_Cq9``W=QH8_<r6jx2>4a*~h$?
zJ;RE*H^@8wysczdtF)tH)DE27>Bt_R9v_!?O2jQ547{JvfN@Y7X(ni2zl41>*Rwss
zcKPH@V*KzlazBnWBCeTN@-4ID6D>a8gXV9tt4@cO?=uL-7MT!NiLZNaW!GH%-l*!a
zP|4%^Dz)uRZ<YX;m)9+NEkSrFn>cyrqASe_I`2Uo)lFfuPL7Nhp?${o+}i4nh$8~m
z8ea9pbURIaZz1o@8tgrNlYy%-vr<NW;Q5q*QgBkJpboY3L6Hlb#o0;Lv!6$7EA+<4
z^sS_aC$%j-S3XuHo><WyAG@2R>YT&u8hy8LFFbXdg}sF3sULDRYE8{avXQIHC2VVJ
z`=br8&C99g&u_(NCI7hBeLuSNfQ%WoYySS{HDR_q3k|c!-wp}nC#oL(a+S;dGD5Ix
zm_;^zrA;zP=er52`cWkp8g3@5dVJi_O!ln5o+%qcS|l;uC3tqysxsibz6{%syThsj
z2ZA}h=Nn?Wn*8fln~G6s2hZNg=hL<;-|@OHc#aPHrn$w7hmeuYMqgK*!F24{YeME*
zGOX!vs#-;)D)`~3j12LSBF@CrWY_2QZKy+0)cV_Px(?>Pep?!T{Mglu6CXQ^uAA%h
z_}=YDHk%Bs<vN{Xe<(X;*v&uiok<7vCHtFjvVFE0^>+F(M?3!--3Z}v&p1Iei#l6M
z&;#j_H%CVF47%1jNB1vY<V$&RF%Tn4=`b8-lvuT9)4g&mT&M2Juw*Msu9*b!-E=3<
ztHG3Ke%ma4Pf47=&gGxl_hFw6%Mvc;OQ}Hb%f7ZJUHxk!F)iHtlJl+(W$`HWg-sO)
zj8f$)cziJN`KEL><6VGFv56}6ms*a>0wY1;;Zfp~?TOOaxct|~DIWuquL~k0mGxiR
z+s3Xrl;)GIO|bRdO}QT>z%90NaQQxMauSgid&hM(x#$O*{36}S3KfQwLio^Lfm>bu
zS_5H($2E#<VjL?E%@#xS&n<e`S_TGix|9}ETzfh3dijk|z1{UimjT7D$y-g86^dPT
zukP&Na6yVbyL$DdxqaY|q*L{FX^onULlVbEv?~4cdJOo~y=Ha=|4_*3(R*qBnjbw-
z23{3Bt`p^-7b|F5_A;8oMNYpYUkAMEI52}()Tz}X5^zHGqSpzveR$}zf$1fRIy=r$
z&ML9h^@YVz=bq~h;dJ>duR<qh>hPF$xoO+H*!Mj=`MhdeG4qSm_eW>*@4xSpf4LSB
zOu^c;Tr#1R)RU=0xjaVyko0UW$P?IPaEJG@`FZQ@a=LJW;GV~3Z@)Ajv{|wh=5Q%p
zx<#X~h-ng3E2SOE9=I@Z0W-tW<(mi|K5ej4>dDNl<jh4EubH0Xy!E0t+5BCaV!-D-
z=W^8*7CX%~E~+Rjj%%&J%;yxla+RDa6}xJccFei?=Q((PTeBr9c3BJ!rk|=8oe|IA
zlV2npXQrNk4;>P~*th%4RO?uu9rT%@rmtb{vQ$_k>oO>k0*eu|^0XcK(p+18=D8pE
zY~DnvM7`*8Eh9g2F`PQ|n@Lx+y$M(>JM7^Yd#iJcoq3UYYzM%Av+-UPv{^lOzcl9-
z=rSB;?Togdu1hqF&P7pom&fQV%&f`u7=<|0$OtZJt7B#!t~s#Eom)Gx5JULl;|p$d
zrNbbP#Xqk)^SkQObaBYE1sH@ap~*Nwv5Q}xe@zViGKTo$$xO!wJuhrzEm#z8>w^Za
zlU>dJ2Zo%MoJQZAdpW^sQAJ<P=^|&t*9Ue$^wDbyPV$Q$N=a&9nmjJ}rN)4#p4X?I
zYZ2#g`NB>3D5|iShiX>41pdlXitMlg`$}SB39Qa*drc#s86>}rPwrEuq3ne6i&Ir;
zoM0Y8WLOdPb~o>O;1#>BXjGk6Sd`WZMdw?+ocOrxstfJg{$j8QS0_?hs};K}pI)^E
zt9xNv2jkEoO;KzK^tp4Q2RU7k#p;zcP6M_xGWoa}%o^+Vb44dP7l9ii+UraCI@1n?
z+LjR!<Hi=@xr!H$30*IYxR{%%c8%GQ-lpW1bh&_DIX;vvi_8RJ^CM}Ixi?-XuPlK5
z&I2>HVWFe)q1;kvD~6?`h5oZ=6pXVwylvDd6~cKuiWO^Cf@W*<h3~w~GR;-;=CDm7
zuFO6}vhT>w==^&8U4vfa+91WaM}<Z4-J2fFT6HeIa(3@UH7MiLea=uR*=5t%sA3P!
zwtI#7`dsk7OQy;+Y_<3f5XBe0GV~Jrm7DDnH3OryLuAE-jnZ@&PVCMz<|woEJKb?S
z7sqy*-7MSJBJfF-4oZ^ywefr{l3qkDlwJ3YplrmPd-1&zjc-Y1`?ZE%4c*Gr79Po<
z$KJNS*EC_Jp0e#3B4}y&4s#pZ+bo0Fx2I+T^y}@mTU$0AJoHqX;q<pWxkA%q19Q(z
z2EjN9D#4VBo9}hVf{)6UJ`YC}zkTIncBovCdytELJ2sOc^C|=XqPX7oPYN;_ZF3xE
zl)GLwXxT7*r_a8Wm!-~isckf5H_NAUH;&28z782ML>w2jG|swc8JfbY9L(0tQl@-2
zYuX~}bVMqBF8A~7<9lCUM}|1bdiy0?X~B=!H|&gZcPv;NS#TNg3XXprT&_OLB20N<
zCFCBqH+!r`aqZnL>#R>EZNY6W!iD?HLgV60Tb%RN@>0iR!$ist#7SJ%bUeD(!A6IQ
zFHpySK;F4c%edmxx6mtcllyOd=#R?SE8zX+Vz{XUD^vKrd49b1yQQr5tNI_z^N8GJ
zCaV=Hv7zI`r}=V}KURslB<s&;exXlSoTBYH9&H&ct=^$<RYFxJYxsrlh+la#irt9Y
zICMk~MN!FFrk<1bzR~8GQ0{m`RMy44b-0@O`X3gezMq0GYsmzi;eDLRq(n$GV?FjF
z*9Cb)__!C-;-pkwwab+BOi-(D^?~QRaHF&{eyZPQ;-nkf!e+_u37-2>n3B=1$)G&t
z8qqbQWi4U(Ei!flAF`UOjS?hi#B1^NUEO=4!>aSc>%Cpc9oEN$>@q)54#r1tFh9lm
z6a+^P62=T&hPjdlk0+`#1!y%GT^KvlRBknc^l*Mmu;q+V)1{TuKajCk%f?0wQ%BR`
zU`kl}{$}nJ^4QR|LxRg8mt%c(B$LIH=KTsR*aQWhoo{dAj+MwjvPIa3)=)-VPBBhm
zicib+aei#(A$IJJ8)|!zVB*djV~$NMQ_m|`)C$wJ+hgpg(Qn6xy?rZg9+zBsT*)u6
zeag~lsq<y9NA>+8c|J`{uILy2;(ejtoL{zS2zMX)c#bCPyO*|m+K651>_Vq7<7Hk!
z1NGFqvic&I+nO}&0})?MwJn}L7%pq+yxX^O1UEzHJ|6yHNuzYv8k5A4xlFoRpU7Jn
zX4aePQ`PzD6(77Et8`Q}a&3K?&zXu>Mv4<O-`4DVq%`RA$-vBMN<%^IA|FarhW5mq
zmwBC0qobe}_ked<(2TRx9X&$n2Wdm*iAnS0=-7~GFJVeAQ7t2z;;-qYY9oEMQ6oq0
z`C;C&fpBiP%y{L?JNBgKXRqpUI3TIXT%LO<xqbYq$(tKLbMeEzYu-j*CA`Q5TYX(;
zUAm%Q_ZVgszsn7Ykv0iAm1T{cv(EkWcn|Nfd=6SwI~Vv0^GdC%lJu9_PF@-5Ua~l~
z>K7h7@FI0hELjBW;o1qS^EqY`Jb4*PCY`3In|isOb~!bSX~df{i<AY#zCCY<Vcv1@
zRwbP?2#RRCnw+xbwu<pVwRb)2y;xk0>&;C1H$&lku4v3_*&U0zRr`pqDqkbTdqt$>
zZr*z};D05t+BWM|IkHRPt3{>rwW>@}EG7O(NNvJt6C6Wz`MK$Htn#UGr{&6+9f!s;
z8J?c60+xGtwEz9$5mWY#qaK|fW+rBzN?NC@-Q?g@-hPW!<Xn*d)DuBL0d!eovZ@nS
z^Yn!BK{<G8IZjK;VCo4HRpDx;iwk;VHtpPXysmic^~vC2P5<IEJ0=Y1JA;sIRlHvn
zZZ+xBN8zQkoR6MhOsTNN!m@FT#MN^L+L}a|Yg^1Z&Ga=6q<X$hC)Y12r(?Rw8eEn?
zJkR-JKKF;ok=2fOM?M(cW6p?X$*9KG!h?6Z4k{Q(A+K{(2B=;eyvHqjb}B_N$aVpK
zWV|jWW%m)<<M!7%Iuj+Hy~<7O3|R{7)c8JKI&&h=Dce^STToL+^9&tceYsWUsnS~{
zcOirI_&jcJ$4I)yx$CjC3vVK_#CI)3qIn;lV3kO-9V`K#$!3jJzdn<rHOu@w;3?*H
z|JUxrnIU;zhgvml?}^mKWeSS6P3A<WT>o(vO+P;Su_Wol@v0JQm*gxKeSd9JAqD$d
zyX)V(nS%`-@1}(e4o<#4x3H4u%NRFvhvLH-ZT<UtkwhbhTR#MP&6b{+2vDAh47@(Y
z;-sn|s!?>%*~}lIcZfDY;lN7mTZI*?+*a>shAX?<K2<v|;U3mLIjT2)lr>nfYuKkg
zd=-P_&cfg7)LcvydR{$PcuC<p2j+FxWoM;VHQDpXk~?p7yw&<6%voIwmk7F&V<}ji
zxWM#dx;yh|rd9_jd#Mu<2TxabXBKd`8cTza@7z4{)U3!Y<8!25d>(~Bs=*YKoM?o|
zz6BP8AmJ%EHTTW4Mb)-yI#=i?52)(jJS#H&RHhHH=a4<7aP>eG?>KFc=Ck+TbtA55
zsUHDi1p>#fEzcWX`f)2gJnEKcxBjftWS_v7RlT!Tl}#V3y%@&S<twB((wamNx{0Vv
zsTA4)%E}JOiiXJd6LshGc<u+#m!Zm4;R#ow=ig`gXV%bmx{ZVk;D*ln%IUwIw#hX%
zoIPiMmk+;R0B8O!dbf%y(dUd<f|&th)<i-HOD2*sYq7Pn9@iH7N|xPf=|`E^=)JSk
zxytbG&cg5F9vRzCX!`$fMlhY9I$>u_`8n;ub8nA6=3{L6eJwl4SJw^^6V1yx_Os63
zn2VVlWe-17f1y*R_kJ&Dejn~xV~(PjeMsqaC67N&{Z6@NuCjBv+slIqhRv4PW-dwF
zn}o(n2QR^uSILi`F%64G&!&Yw8D<m;7wenrPT)7kH(mOnX{+-LN0D_y^I5oiN9hfk
zms*(<)I+19&$acVwb~@J#L{mM_M~NMJ+jZ|e`=#BU?=KCr)=myGF9fcD-H3bezC-J
zySduU+s0n}C-5g#qbE`Z73ShhDGvG5yUyo+&~o$c#ia`n->gW8w&iaRS1&AhtRG4^
z5r&<^cf8p9qo}x<yF=*Yn)oxFo5VrSRBB&FVazx37ygH5XKqnZB81;8w<a?Vela|q
zc|Rkg;`Xg#lY#oThkP%?D48X*_K~MX%|5l_(mrkbN~&W#(eYy11S|51GG86jk|=Wq
zT$%yvP|;3SU+G4!RF~BB?G#-b^HM{2v=NPZ{XlV8WxU-s(;Dp{y!5+<+_dWX#<cD@
zNmXf8#?Mi8^R7*9BT2ShrfFuyZ}n{^6gdb62}!SWv5jT(P411U$vh$XKj2)fwa6sL
zxlXC9*P6P5cXhFiK}K)Mt@j#M)V|>KETv^mjOHAdHpx_WT@pXn%=yT)*zTG@I#MQg
zAmv{3)l<5{A1tIK3~|GGPfsyZ9$IcYJzLWmRae$4%u#y3g@XEKleah_DlKO5NTijS
zzHXnLsc}8QMfWQ6w8P8PL>2LgR=YNl%MSH9G#Fd@=A?IDve-{CbqoZjs1dbBwQtLE
z*URMKRlO;PZ$D1B(TeJlEqt&Nopkw?H(?|=%y@RiL0`WZMXS*~@B;LNWyl(j#5S#%
z(@4-~@@m)E^Et6fbZ4LB>WXXl+PiYLYiXM19i@EY*yODlHR}_XB=4v%-g4%*NzJ|7
zfuK)qul#aJ-&V{Md4bWat_*joTEte$CUah_BZEdG=Y&>`neqkm27!pi;}u@)!zYN}
zhTervOdW_Sjc|HKkV$$sdHr2lXiEN@0r~h=feKv9v+AT92G8$l9O*a|I9O?RrQ}l8
zIf@r`l66s9F(KK5(M+u(rdHxF{26Z;?@wp*R1=e~%e41Xm<<0iEI*><GT?XOtEqc7
zYXYOhwPv&F^r07BE>(T<DzUG*2QR*9_NVXa7|w3Y;)@7St^OD=?#`0ysBPLz|6Dpn
z<&z0a?G-O|>$h1aj?`D9x2TO-N>_+&RdK|#`j~H4gv*n!w62vtk&!~bPI(;S-&P?d
z<f(RrJth^7K;M`x$>or~r!!IxSIe%fzOh@-^U?52E`q<1r=~SWpsq+F7Aq%fgPzIw
zhDO1tJ7(-v@NlpD-v}z_!Ry?&54MK#(->C32~8@5S}x;#(vk&2o*tbz-;O~nB5k!?
zbeI=y$k{$;COT1F6*nSh%xp!dO()h})`KZGI8rR&tKwV^YDnl#R10~E2aj;+pD4oL
zjBO+v)VX!yI^Xf^i3y(edr0T5(Q>$^vIpwHRl?=z$nY{tmve;6tIeakUPgf12=>cF
zdKkbGJBN-&HZh&kgW=}->#MJ#VCly|3U%QQ;qqnWTtjZ>3b><76>x*#1Nif=SSsmj
z=#@vh*6Mc72diJ~=0%6aOJe2LipQxeQ83(n_3TV_LaoA!LoTH>f}W?XG<L_76$*L2
zN@&6e8cdc}1SM6RlQgLj@|@Ebc={=W4O|sQ{1$WJ0eJA_M4^uN*K2k;Do2`q$*WZg
zWTwR_-%R+hauM9F-L2O|?K`vTyG3liElSVxOQ8)@F9-6zS~-j!R6Y3oWeS>zm7CtK
zfyM_2c@j?1RmUuW8<5sD?ah)YgYS8Zq_N>UtPiU`I3aD@7hM$>S86%Vi{34)54$!3
z#@4ycaFQTe1K;Cl^!5XO<)xsW;qc^Z{n1Ab0=3r1_)W5PUh@PjGVZnP*p?I1Ayxxt
zek-CU2j;IDhF=jQvPOY_nF+fx<G_8L=1G)eae5q$5bipNa;<T-C)7@kWaOODgH<~Y
z#F+A;2Qxb7Y2|CG;+m6LRtwvz;Fv{ZeuSZ*=JfHEI&k~iD@QT51`1}<Z?CLQl{{-5
zDR)mpPa53J<S{Xp9usL%v^kPRsEQksfArY2XcriVx3S4Z50;xZE?vU9R0VHsJ`mo1
zl~6m<9Nu&)x$luYVRHWUo!%@jt>cP%unryH%I{=CXv63?Uk%6k90;|}mwoYYFiYVv
zWobm$?|LxP;Om`;Pgw@AUCm$P4CD+5wM|{`kjk!p2*3!PFGv#oUKNL1Aa+*WM-gf-
zV^8Po;gzSxysEl$4_JwS#^cq)Xu}o1PE&3J7_NDdXE}@rriD}TF_Xr*RXx}(wv3an
zs^W|%j+TP$ZIo3}INx8xk2dTY_&U}ciAZa?LE{ivMXUMs^33g`y~<a}ENEIKggjYA
z%08N*V4kMF{Dyikse6M<9azK+Q}0olYv6XO_l1syf~!{VvTHtu1XG=<U)%w{m7!KS
z?3xd@qFhjJMj%$so2=iwq8O~d=6l2^EO^4?tRGjkbACMItWaDCL@ej#8o<Wv2Ka))
zg*=<=;tKSO*rE|Li#;RvfK6)BvZ`uh<suM|58vcGHdPg;9^?HenuV$o-fFk6&vEV;
z*jP2TxFG-8>8dy+w`TF2TUA`Lfa47g1K3JZ#ithSrm9_wj;Mt1g5l5Uy1)08+Iteq
z;jMd);q`8spkSt${q*kAl3;5`Hcev`ftfG_`-rM@q6g7B^Gilx`swpDPl*b8vUW_|
zvo3>c`dADp=;Ptcox^vkOo6KjuC-Uf%Ebb!)CAkBrm9)v8lkq7LqX~VT@8FODZk6*
z{+w$f?ncI~ga~RT7kTde&97g6MSAGNq>lNsK3mbPfjeHmiaBlU4{pNt#lv>PF|1t7
zEv|mXl}RwS$3M`qqWQsmyw+oLss+vqTXFlo5ZKQGU9PCBQs}`e<r!K#rNLSS2kEk<
zcmboxoXI!P>%+?Vs=d>F?}J4M-%Jz#eiVGi)zt`&74*bka3@!37xKig;mi@}!78JM
zYY5&xqR&8kO<n;l_pa#YaXwC(L-VhXO~O^V+l3ykc_kbj{e11fT*4rjv5tFsmwX*h
z>|Lvt7A|O6lL~hNmn_k2;~B@w1vV7%BQdo?o~wx*0}HZ*T6N_m6JUMDCdXaM!u+ue
zPlAyp=9cYz=mjTt(J7_M)Z{CN2;f%v=i3NVSOlCXxoAVIikqOAX(|y2Fn~qTE+kU>
zBZRNV_(o(K0K22EpivkArq9xqzIa+6HYPfe2!8aHr`8h3f1|s62kY{hC|;d7ENHrh
zYPnw+=qbrmDANalx}Fd)5eAD=1~94cluEy=gvnwzU`mrH152=AC=TpE31-d9Aik<6
ztnStF5wzj-b2ayv8ga`OahJC8fU%x{V)bi#W#)8IE0XBJQ*rt#{s?RD`odM<P&*bK
z@7s3=BCO}`(Z4H$JMvrI#Mi`teRxLADMrvUPy2kC%ktraVtBem<?H7fF6_Q(IM;*^
zLZl7$hWu#ek^wftap@TjO{i6~ku@EQ!pilL&)#D&9a!0eyhb>g=_=^y;dR_TV+?HE
ziQrVYP{mYL&$o`FF8$BJrm1_(FXdA766}$bQPa`=RaJ5FERN`}PbR>7r;s3l`Rc7f
zs15VB9+w0`P1hgCqAOF0e%R;kuPVwjlO7{t8P%lFG*J#;ywu_v%-$m8nU`!kKN5_X
zK^P{NmOXML)HXlS5-kPKtCj4k4tzW-5}sX}4K`zr(sN(&=ayij-*asoDFYjq>_P`}
zc>*hEAgurX(Gm2ZkHYhSmHVv}yE;c3a<TXr%Q6SBT@2?4BI5pt8O4MajD{ZUS>4U>
zGr9ze(bPpIS>Ua-&NkDaU@koM&$gjpV-kv^xz#I%z)mjSAhs}p!LmA&U4VydmQ4u*
zJ|pkLAtwca+UD6W#~#rwwt`<UT6pu?M3+!2c}FJG0J5E^2A8I0X{_9Qnbkz!=tY(c
zT#un?hzy9y06t0W1J}qf6Up^mqQJ_v<sQw#P68h?W<AJozXrU(M4LI`RtF*q`b4%7
z?^ux}fDx~nfH?)IbkLn4)GpRxEPIa$dNvv7qQv!K030o#e#jCm2KyK_@`1a=TE%2*
zft{;dxoGjMg0BYN3eU`(w%3P68I9vGj3x>w<(4IMMt7#zxOY`tXJ}le`WR6q>(23>
zj|b(?8IC;?_-uZ20`4^4dFW%TqkrKkvk<2F-Fxmez8d(nglgwJ`tjDwljDZaYj2yq
zUw`glm1XgAEnczljpZp7e){3Z35?TD5v~QK$r7U|`J&V#dA8#r=h5wQLKCzHZiXT{
zJW9Z8G3CcIRZB{x9z7a&{9xSv;`9Wq@N&+48=pFOS3oYZVj}L){BGt}T;%BvPQ#D<
zE=wN`$|h)MI?LUMM9IJi)Q!&bufN|Prxm_Q6i=pw&+l$66QwN84Y6zIG&H<+Xze`s
z`nym8`<1zm$XaX78QTyx=pC8lX>h0a+pdl`uUzePHExccNT!q5>Nh67wvbUPv|Pit
zVrJX(`IjAS9+MmQ#tUMu8FRVv3hY-*)!I)M`lRI;UHaXR!y)IJ4>bs5GE9feUi0X#
zeC;=V7&~57PWO)Z=B<m0)@u3zm*k4^@F=&Ov72Ah+i+cu4<GT=sCw{_nNx@9m#E?G
zj*euRXXjrW(Ft!>Y<+|(FGZP(&`r25Rx9WTNL;HQWgoX~NeyM@Y2nUwl*rPKs1t0R
zx%a5S%7`+v;X$V9W%vG-dgYu}w9KeNZ{H+>I#<oZW+dsy7h2ouq3fzUX6wcZW0ovx
zD93Ch7EL7{)~4O?5f4$oF9>v;UO7R0wczDhAAXN$FjZ_b_d2hEY-#s({m6_qryNZ-
z@s*6WD_9|~8no(hMLwB$HsTwD&X|_h!}^y!DuvAwy%zP-O*1>34fES$+z$-~p%%r8
z@3S#EX0=^<z9`qxvFy^Uyj{ZFAe$+>sbY`gkJ;mMx5Akp`O4>@8qCVozq+P%pwwKr
zZt{O>IoQnqw3_<N9X85?Q5mjb24Veo=f_8ODMnn{-|7465d2<(CVih}{9IPo*!%1d
zkw!c1(`)6s6B$O{P$>4J8U<g`xZKd5plll9Gpm`7n6o{us5T*<_O>!Dq5O!15qtFO
zM{PY_@{})}Qg6(QJxtWO63RYLRIVJK$sRn|oTeX5t2SMFUt35i^B7yl+<UBi{-fEG
z79Dr%sQlE}Dc>GEX*_D>o0t(ESO2+TB*Ls?2<N!-hIDY#b%tln=81#jnl6pU4QyLQ
zYpLs=BMW8{EA1Gaf-|EorDZQIzLIJ@ext)Dgt2Bk^(zohaSHIr7nBj5M%Psj(9>p)
zS5Bw}ryJiXd6nKusMA7N%YPH$@35}BWcUHz9X{AaGp*1y)g1l<rS1%uRySm6dnMAU
z+&sGEiekVqtChss^2{WK?`oS1XL$ZPYG^3XmD(jT{o^bpugRA{6Hc6ws&QbM>Roav
zgS+7jU(!T5io{QJ6i-iB4fQ9#)?RdgF%_q&n`-A-v)48)7N0nttag1dIn=*adIyV8
zrOgd)E-kij*E+gBt{>m3AC23|%wU$Pha*~yqjo8e8M%x5s^u3-4ZX0-PM#}k9a$Qs
z5XPN$(qz$I6}ao^Soam1|6DWS#^q`qxZwwy?)R_!E>?QG>PbA)Zg{KfKJ%a!ITu>X
zn#(7wtl~2fuyQ(&BUds{%)q^Ic}kCHI?!R0U`C6T5#yM2?-S@dz_eY(-?>C2V1Cf9
zmovbeGl0#G&528ARBdmkizLU7xpu2j=!Fy3PGytXzES}b>hlY(oi3yPIn8@ZJ4#v0
zb!<=EZwLQhZi#O5i2)x`lOBFD3EomU;EK`0tc>gW_T#=D?{LY%Os<W5+zAI7rn-T7
zLyh?|AD6yemXhh#1w$S>MsBwx)i6D-J2C(9u`?LplxupRx#fHca-lk!u@{WgHxf+x
zith4CdwoZ#N5!)9vx*<YaovWD8=W8JY}#E+Uc1g(&!@zN-ntz*F3tLpykuy+@8SIC
z1B8xJlti{Ot;}Q53F*_zg9fv$6Atq!J%Z1(*Is7(DzCQ86gXxreRJx<ui(MWXlH(p
z%yJl)&iIIYC6V27z>ZDgUE_NhaJ7S%2y|kMdn`LOF20fjW&cCc%WEq3D1{Sv;R$J1
z%Or=;p_q@MJ#;bAV>**EmLEl3O`PnY#|i08aB!HPiuv@ywY)E9d2}Xc=^N_1aXZ2-
z+jp%>Io+j&LK>u2KSG&ZvX<<tT@0Kg&_&t4E-d$a*`8(lQa6sMF89|%Gp6CN2xf48
zwc%K2-?(lJZ`Q=oD)2$IA#s;@@OMm)J^r{4_=o!QHfkX-fpLu&#2PwEPao=x$6!ss
zQYBi=M(}|t@i0^WG@=3?yJ;??%|Qg*q>zOSY`y@@%)I{eN(A`Z_o}(w!sm|CytD1$
zwHNK!d_S2SN?ihX(ag$p6MR$st&)-%xOm>XjsZnGwg}b6YHb`CytK0!p<NsXzA!t>
zIx_Nc$v&yLbS$9Mv?N*TBbWx`8naH9<%C?x&mt}<x%1!YR`b8<YSeIg=Z3zL2s0he
z9koj?;?8Kwdi>Toet1P9JId()VePHMqI{$GK|oMx5b07;Q5q5HK^jSwZUpHPDS;Uf
zkuDMG?i{*@89-7xhh`Kc2N-G?U<CH{^ZCYa_uAj?cdu*z0G{`K>YV#N_c_lb?YnAk
z;Fr%^jOhZ~uESpGZ^p429VEkdKKMhwy+C+Yb?#wb>)$O}+}(Nr|LVFYx_NHvPpQfE
z6l!=3XG|q_Mfs1zHYyAaa5Fwqb0x1l=^Mc^#u!*8&NYB)@s_<gSMiYI?4ftE)eo~A
zU(ADdaL?(a;JZeGs*{EWZoSptO0m`k$`8lOsouzD!IMoupN`a-H(b#0n3qwJ&ba3f
z%LAm(XS3ngW$r^{qHFAj9Hr>|0zdW$lx;1zveLHOv&?3$!q|{f5LwMnEj8DiEXGf~
z_-g6i!(!l!@N33nRw3vUmm1uYaXZYKw3qE$C!5`wO8-<IqjmhV6LU}h?pJ5M8_4X_
zn*L(RikVw{Y>=Vo!^ibA+h@fa6VZC63{jp7qb0k3C+3bG%uBfB-sLF16UhzZ#Y&aC
z;86uoM$HXgHm8}ho%D=}Zk+k&I46g^T$3hNW={*H3Qsp?2nH_QY`(WG25WvR%GV&B
z+5x@PHh5KNH@s6%8pUiq2RH9Bub)7RLeoy3vGVkyBS)mdcDYJH-u&_P@Bu_}*j;vS
z!V-+LK76(n@7%KFje*EuVRI2gcmZR)?PV$LTFWpz*;bHwGeB*8)xjE5=#*-c_P0j(
zV+yw!r}xM07-XPRP3g^;`5*GXp`vo0)VAC#CwAhyWE%%PQv<s?yaL&{`U?{?ov6$`
z<jkmN&0McBa_DvX-VHJtOx#+(WR8W#aajXxTK=S44lb7?xWR3S30J8SpW*Ja1eI;O
zuG;>)lD!7Q%L$i(dACZvI|XH!7aYl>l8%1r-|#)ZT$H%=>RDa5TNC7XwbsOJil-Hc
z1SNSixx6!b^SoFj&5G{_?g3W+J?=jLmx-uJX9I)TMMD&y>>Im5(e#`uYcp2~&6G*o
z<wt~Hrt!v$g<>{m;Cw8b$BdRby=%7namUe5WZD6nKiqFdJrJ`^bu4SW_Sl>Hp~*t$
zZG7aCRtTP|z$QeOG!i+eB^L)NKu-*|<7f|3MVF?v4o}%8upE;$*$<w*X`NJEX^q>R
zqno@B-&Tk+rYh%}l4v{IdtVj6fjD=C@qJ{;_8RsTv$Jcw^})}iJr7K;E$=^K=u_#*
zY4OzKTQtJwg40ySZXvs2Z(@?v*4Iq?USct)adV}2*+I(;%&)3^S5j1}&}B}PH5cwV
z^%Up2;SvgR#=Y|K>LF0xv729T!wICml!4i%Ar022=(OM1X)9Kj+p(6}X@$nj4S&Am
z$*{exOf`XM9v;m2OR|-LkKoGW!s7IF)Oo~0K+Ya+2SKe{<%r1bktyZ~sF%sFOdKAq
zblvjW5!xbr+*G%4@=@#vroO@&XY>{XI=)9VSYz7PET=bP5B=Ca%<?(xDe4+hN6I^)
zeB?+n-E+npYsO<nKVq%Rh+ZzIDDkh{__DPx30Bb;Y@c=Jtjq|YV;pZQXKmii%VeOp
z-yK<R%n74USApx7*E&(m2*f<?gXYhpml%8+>hxQeOt)W!E5SA0K2G?_&#3Tv_ZmX0
z92!PfW7Js6c73-Kr|j5atpUO5vjr4hQk6C3<=7PKOMb7NrrG5`zA;P7n(bG!(=xlR
z`9;M{zoU}d%B9Bb3~=?SaZqfU+gXp3nm}>g$8tQP0c$<AG;6-P1uI=fx1RAme)h&6
z1(Hw5bz@x!xhV)?x~hR4mdK>q9LGl_i9!?Wl9w#g+oOJ_n<0`BR!yqvCPz`%Aee1X
zv+<-uQz*rczGr-HvND2uJ@huSTVC}i)oQ;cy}Grm5Pe<NRl~MUM;~EvJJ?+q<+|X8
zsjsd-Y&dJ(Y?`n0Db&DKHmezTV0JQSwfVd0ggy%KT2Zh`Fd%ku_#Xz{L<TE;-q}wt
zg&S46x`~tQN&UEBIlE_;z(-w%A3^ZC;s^Vl)g}(el^0P!WX~NDVF3#sd<Y-NlzB#=
zQ(~Nwduu4#pJaFL1`X#J6Wr<XVZfB+iIO@TVk^;;IC{X|&^S7i1>a1K*eDm1GR?Di
zt!^MAWpK=|8?)yb7O1;SH=IQGVO*yh=3D<_nLlsB+HJROq?psYz0UC6IOVS=J}y!4
zKgeU<?f$j10Q44!EBByA7M2}WQ&og5V`v;^-vqV2;*6^<S$GO}<Kp5H35R;0nEA2K
zu|n=VJS1G2%dM<Wt2y;Woc^*;#GDP>AU@BoIb1wppfy2n#pbcj$NdH!>MwbVWd}^*
zjeO_(C;h4xws=RkUiCA*VLhws%Hs9iT1E2M!=h5=Cyz!>oYf}kv#RE_)7>U~T3q5#
zZ-4R{UlcB-d>5oT&eR6Kt1E)Vfmgg1vOXDQ^$O;5>T!;~lWH(&>mBd_KAI{ido!7h
zH;$o-v+G)Gl6gAF(?6Fouq6w^DfPz|585*`C$v86#!DA-gJ^?3>l*~(p_S5Ma8p&m
zrbN5C77CH?j+dv+WE4J2SAM_T?Lgi+%cnXd*V*(eMVC|L=?&LdbxMfJ4|;ExbvU*O
zhwxMnh!v^n22FpkE>om8jQQt64<W3VM^@3xs`KFAQEab(Y5%tWyMqUn!t;tme>JA`
z)<28?y*TUDjo_(fannfrXOq7d|JU`a>CDf1Z+p-4qBuIW0@fBD_TSb;WPUyPkp9M{
zuPReDLJPZ23a1y+3nEmx_>vQbIB1grkCnwxB=#W7XY-%E;Ide{b0o1_YJKat)+&Sh
zR%02roJ?xX29FTb>I`^pYFfE2OKohUjl8UixPgD)Wlzx$n)I{yRpf|YRqNxPaut}l
zJ@DT$7P87aj=dR|_IGx<Uo7uJ(#qEZHa&f1_2bN)m}f<8$C+{;lDqONYoAviuge^g
zj%5|SxPQosp3dKL4NLsv)Z;UL8&O@uWe`*vITak^@+%5`oC~v%{Q-KIR@U(vZA4;Q
zGQ`YaJ<2154&zYHkcu}av2Et4VZy%v8rF|lzWPhA>RA@WO~#59^9Xffg@cmHJ2WPj
zv^y2)Q<lw(UhKku^9Y?q&Qp)djkXHlS6b^9&FyDZdK-2o%jxatQ;e2d79dxzNNl~!
z=top4iRjwqx+U`Ds)$6WHyh3`=XFRPmOM;f(7_z&2BrG6+yZD$<@Qc}H9%d~G2|wg
zs&37F2;vA#GTH@u--D9z4c{z3Tb0G67Mk=lJ`(?nKYdDWEdvX0nx17S(l7cv#E7IQ
z^}Y<JwSQk7+0e_}QEaJSEsqd>`<`n$o&@m9+|PNq<x+>lws8!8DGTf}ijBxmEAJRm
zt`~5`%b6wTEPWafQyaWnX)x+j<pC+{_zhc1tFE#}eJ}5*Z&pWjp!p4gQZpkmc=dok
zTQ62lf_a1#dK54KS;Q!;csiz2TF=rp;Z{tF%rMYX4l4Lo-r;P{5GDE7D+-x1OlQY`
z5+M8S{-|TVfvl~|>uqd>wHjB3p0*%lh^4duZls;~RHnSj9A$%aEUXeow@xr}tKsi(
zAc=oeOCNL1J@%t4@4fkpa7^Wp(VlvlM6-+T!0an(h4=g5L60z3#d@3){VXQ_tecA{
zaCKBF8KZjHiHeurFD9c9|0|iOzk%-~{8t`k8h_QrNT+9+h_OogD+>YJzZ&`X0?b(V
zS9U(a>i>-Td$9&fLEn_s3(`YG8U0luEae~N{c~|>HuR6!diefX`tQa6d{tl>9@IZG
z&jcR+)Bbliz@~rA@cYM@|NQ;0#d&_^z@}nU>qOE_YTpmCY^)?Z5@g#C`mU}%bK4%T
zYmCBD++wk99ysp35XUOu-Gbe}%$p7V(|Ta8tVf>_kQx4C%ReGwng3-pn9*YxqVtc-
z|Lx<y4*!RxtN*LRXa6g5|H24>{NKp^3*&#__AgZb19bkw&wr5qho1k!23YSe%!Pxv
zfs3}NGxM!%AK|O|<gkC-+>lAaO4rW&JEXad=vj6EGAsc(e=X~XE^lyYV`Ks(gO)O0
zyP;><du>hDzl^93o@~Z1ZV<%W*Vbyl2Lx|a_X9_vnG`)s4y6S>rBbq?l{LRJA{lgR
zG=Ee}_5!)4zhKAO;FiJ<*%G2ULj#TG(SV)a{)*3b3mc@;RYZ06?`Ohs!1|5;If69x
zDxCO5r%hb`WHH&0_rnU+gTFmd<InuhgvvUcx!;y+H;h*h9YGS{bEF^t>iFfEBGyl-
zgHBV=vJ_iE<ng1CFb+@@mI%{Ax1(o?bUJ`aT0H{xp&ck*;?#Hd<y$eypBYl|rB87f
z#U;NadA8yWixMsC*nt6$L9_usHQo*%7(<II2XW@dz~h_qdH>Yr-X{T1to4IZ*M1aN
zvy1~d(R==QqS=(hHu{x?UppAn1E?3H#98Hk{6^0bVIZMhF~TFX;2+;HhI7l}5jtvl
z|Dj$INFcIUq8~B_L1zJxe+JKkd8(iO)gbD`ygs^X>PuP2$9%FO{QD2nU4V-L=wRU%
zvY`zcnILiG)QT9^o_Ti5>3aoH9kZgK&*FRflr23gEWch5CDMGLg!33kU{=NZc?R?;
z5EObIql;O?zq7-hKgkgsOl@8h--!aa$~F@44;C!z0Nc*>!S4ZFp9lmx<_C-cmWees
zW^3zZ=mpIU-E-=cK;M9q4M`7C$-&k>(5Lw3FW*F5<N(&Bqd&Yq(56or6~BD=MmOlp
zyb85|o1gZ2suxs<1hQ$st8WHbBE9+~w)Qgq*<Rd0HiaWqEL<#hO92YJVXN#wt)Nbo
z%)Y1q7(VHa8{7qOoip!($EE$f<1Jh{?6#=@IH4pgCX#D3V`I@49TgXW@V?-#OsKR_
zl_>|Tmxv-!1vaxw!b=oO12^KzX4B;WcQ~pSF8KlX3~-WGGbo_L0Jn^u#Q@kGb+1;M
zlo5&Ox`E~Z==^=LY`-gr)c+nc40pE&?)jRw{FC#*oF%3+{XPElDH!Iti!~se-$k%U
zEBpa!4$AD()l)Z!xoiRV0Lbp5x(hGm=u@hm<ela2N_v-i8i|ic`gj4bIV)DRt6|L>
zskz;E0^noy<>ZUr<IehkL>f6ipq0G-3Sp_s+TRK&M7G|@MxfQa@~VpA3HuW7JP<8)
zAej@8(-UB&6X^%4wOB78@HEvv?4IQnlkKDij`sJM0Q<%~bIK(f8gl`=?`?zZ%ZSvW
zcJ#AcXH0f-ZDh_TtNnVG+Ev*ikIhL=qW2}vHuWrln!!^I)C`g&pk{OcHA6q>KWoPM
z{B$O82G>)bjx`9P97IDw7yFN<caCF?IjV?Q^&v^zp>;gfzX(MQf@Ch=kNmys--c#k
zmZ~C3&k{cofs^g5HPw;v`JVj;rl%0wai`rvw|_y^h^>5)AFw}1-*mCIflM_bd3KU7
z*zUFhgv7zkYkt6+EqR0{!_6b=fWyz|_BNfSwZ#-5NY;##07wLnkcq!H%<Lf$naQ`a
z;DtOws9(tuHi5Z6-hYgmG=P)Afpf;(TUk5ye1H`aMo2OsuvA9-l%~-Oq{nHrYd}(N
zT-RK3lFYQxk1K#jvF(HTBOt9<H<a7xZ(z^gx;aYNUE}~M4S`;*0>}}mpP#P6faCK^
z$@m(w^elDWml363%)Y0e-N71KjM9cg(<X812EmVo%R9cF*wPzL99IzeLy`ex5i1pF
zHH(Z*-fZy$S9c@49Q|yyH0}uSc;`6U<iXxA58LUH2LMs4ga&0q{(o$C@Bk@&FlU^l
zevqa%*fml70x|jf|BPh;*-kY(8;p}{N&I=n1~Cltyy1}5RnL;Yff0b|<VFLmgSesL
z>chyVSfJH3Xg!+l6GZB$XW6hXAS7o~(kHV=pW+kr;@BEvagzCO*V<1r%TL=ynw(Ws
zqp*&rpC)*!{f>aq4P+HdVi+PiT@OY4hhoSwiS4N`X7{(5rNC;fNQ66MN-pF`r>U77
zkOfa=f=`ey#@k;{c#lZL6SX@;iXjp)4V@4JW^v67uK56e?RE4vU>y{)>F@~_pP*E&
zD2^MeW|pDeW@?9KmX|J3?H!><NZ`emlXcb+k3rMYT(zw#IxOji?^GeXNoD?mKhufr
zn(GX!<Lgs{UaXmw;2ioyD~W@4%vcZGxa9njOB1p`yr*)2xA)RTY*=EOVMU_Q=lKg#
zM!QVKM8`^e7p}l~c(0?K^+<W^G;rUK&unz*M|QpZtCtXN_3WG`*0^)CUGh08qm%bJ
zSuwO0)oH$+Uh>mXpLR#`yH2)_wKPfnb~LKK=Dpq_nsmkS%|qRT$|(G~2S>6BkbVpu
zu63_}_~qxFj4c1Cg@MX!{K}3dTzwGpTh3bz97~flrD#S*yM5a27jkBXFnEHVn=F45
zy76f3$<v6yr&SHeCSNbs-__-EyC;&ofps3UpXTWiJ=%j?J!uRLsiLZ<Hn@KKduxrn
z3e;5|bqOTXBeA@z56X<b3Y356TJ3~ZYgwBsXs0XtphU($jEyOvwrU2f*2=tV`}YNE
zRN0HsRM1eNdOa!1()gIjW%lVezLYhY25qLHh=jtpqS;bm$l40?S!Epc?BnT$Y&!9s
zOuqD(DU25-+r`-MwF^)0TiT#OBeUY+to(5imsW<-BG?k@JR_GrU>eM4W}sRa+YLN5
z9$n}v_!tH+effv62|C}l>Qt4fS$&AI^RD)(^*izifw9y75!TiD9iW`&a<~99NdRf>
zH0?SYv;Rae=@)fg<~B9^Il<%Ya0?%gDf5S4-DNzX->uJeouFc7`4h`p^VZ(LL!EwU
z>oF&}AQdF&Nv;{`iBZ_ab=R~S-mzUqL5QY?OVzWjEm3Lf*;(5FPxCm?F*3KyHg|$*
z_zNqK$W?RU*4Gvtau&VfR_K~t;OA@jbgvUL&uf_Dfs3OlRz~6mwdj?N$j`x|CdmK<
zkc^?dFOpUMn_aG7t64vGGd9GUckQ}j-pX*_Jb6D)Qnj>~S!s=AE%`C#QyYn;hVEuo
zwBn(9X7Z(V_&<&8-eDoJg*yup>qaJGVzNf>7-4fpbz;U&Rp_Ek-BBY)+B>f_S>||Q
z4}(u3enG{#VMfE1-aLb-FMLj4_4k}MOZ;!H#pfok;Yo=iI-oR-K;S|$?u_Y#K#mp8
zm)PK*)a|lQe*4eEgU%IA>KqpU%jV$Oz22Tplds_V){D>*(~}R!H4#27)TU{_*_}d{
z=TXBJPw`f?kxMAoDj&xpeTtmj(bjw^s=X%3ueES}Luk_!_tkQ<tB=#c=T&cQ1e7)K
zJKnaTblBje%k3^l0FM(CWi$!+S$>)d)pQG&1<UA1z5?4$Cue)B^pWRElB<6<T3iPP
zSZ63Y4)Zils8vb(EF@C!uYNKLw&4vYk!<hlp&mI+7I#~*GL_G8_w0pUFE3<;E3?U9
zkca8b(y;=5-Jqpz(Uncfy<B!NcV9Ms)1sq?0&)3XPGYF;HTUCyXdm@HO;Zk)1$;_#
z#Ng^?T`bdw<?glkvSp=?^k!uW)4q#0tAA&hu!`-Dq&FiEuz~D8ENQMQPqxmVulJ-k
zQ_%CWRah=|+iW_-Q5UB-x1ml>Zn>@;-ZVkjtpZD17)S+m1IBz$3W4tfD^=sHWqs+A
zbNwiPq`Iv<afw=+&J=TJ=COcuF9AC#2ts~625dWZIO20#Vfj$ykBAs_wrk>gv-MD*
ztAXRH9~iv+=i%+;Zkt1G$noE?a5v+HWWXZR;@GclD-*>=Pm7I4z;wy0Yfsz1YnlpX
zwB3Doc>U+rb^al5(lFVpP-@@<nwKjNQfr3No6RZgmMe}_)+ceaL09CL+}E+aJ)k`<
zVA-U5yz@zJE9W8}M=X2|w#(fQlB`4xPo9Xm0{29YSt`8O)0<5%^`hUbJggKw%GkZ2
zd=KDY&h1_KN&{$=Xox`pv=ySV!`3uS_b!SN!y)O-;G$~YOn18EQJ#xx*ma;$_ovI%
zIvnWG?$CDV)ie!7+TxN99}1*XVqW)YJOljFm9F4uix?c+<=Gt(bD#5DB5pm>GzDGr
zk<$DD04})TF}VP+r?Tav0+5N2k2dN3yTSDZ8Cx9CsFEpOO1UNGex|lol?xbTF|)Uk
z)B|)FC9X5OE_aK1XT>fbYMNR@;C<(kt}84~H5{4WmyD~}tD7TuF)2Norh)S>q}q_%
zO_@(uuA<muvC>a`K#hYK6$l0_-Mpvx4H~EFWFY7<lB+(qF2z~cFsXe$;0(M_mkP%k
zjkpIGFOGOm?Lf65d;?ndaON>Cb0*mVQ3^Fpj+hh0oG05WVpQy{A|^8C^xpMn&^ww-
zcu(6L?h)9o_>M87r>qpGUy}XeAy?jD-BAsiA!P|`Iyz|;U4JAzX1AeG@3DqFL2lSy
zRI9GoTW{pk!vvA8ff$2yDb74!SgHo5WNC*Kz1NdpR_GX_n#8nsf-Hv1p>{4}?f6cR
zcCu#vO^Ch4j7jwz9ms~lrUrJ22!fup)zq9s2TNYm$p0GhT9kXJ)9Ipt+RGIJaeeKf
zhiE?-YdfNCM)3tME*lrEE=j~M*H=?|((QT2o&J%;?}Qx+%gRFWhkdg_5+R<^u$Pe^
zT-<f<9dz2htrXwY4gK}R^+KREoktlFlNkp)U7|8G2=@cw??T-WbvY`cvAc6Jk0CSS
z`WtxIe1czNdVQk%Mk>>Jqo~RtRGWQn_^^pz%^LSs3e)8Sdi&Yuh@OA<8_k9msXGMi
zA#1Q31<GFWq1qzf!gks`Tj+(`^p*P1N}w<S*FxBRCWqCU+Ff`9VCkQ~G@-DQy8thG
zJ$s)P;6gu6Od>N;jKhwXok)Iv^wHv<^_xpA;!So2ir>2$W9s(PU4Jkco6KE=<^^oK
z{+J!FzNfrkG(KjxH{!W)uQ8Jza?7zEl(y@;H8NnkkxiH8qfazr(6+bACdCVrA<Ail
zHeB!B+W|ftbGqx`$AM>#+H1ho)V;29eF1fKgUn|tXlBpWC3|RI&Dg-ght*Qh!hfd9
zG@qf2;=dTUk<@3>ySJ@~J+Swi&<6qLv4~A?-k->rnKj8yi_|eS{T?~&VrPTulM#7h
zWZLLhn3)(9n@K<XajB&Nh{Kq;1y<{mn;)8*K%-7WtF<MW7jrK*r}Ynt8o&XHlP8ak
zB?M4L5+^OA2RWF`#Ezc*XOm&TymXYpecB*b;Az${Wb)a_K<<KPT=db@W2CqK$slfN
z7dpDSZ(?!ZwPazoZk*i=H91MS*O?4B3EDeFLgb=Uf#&X^iACC;CAF^f?y*!xw?d_)
zPg)wPAfF`bynYn;dV@i?_h0N){UCt3M(AT!$A<3@>YJpWQ1Oa1nM`;_O-sbXvA)q}
zTGQLRv`{#<WeGu-FUXLM4<1~pIpg!%t`#}B>YGo#Z&JzCH*&?ZNA`9z9XnNDf3+0`
zyYZ3WXg%SrK1=^Z-suNl)u%x>-Siz33Y0=m-byn6krXG<3mg|nJM-w30~bcPTr%Sl
zv*-eOCAGm90=|g>JPHDrx}nRb1*+$=Jt(!Wz|RDVM`KY*mn1DE`~6GZwNgiTXwtYO
zS6E=BYA0GmLx=V|5v@-f<ury=Y`ni{#*W;W`j=$sIoW%^Q^mU14G+V-Ae-1970_x~
z?R@U+RK5D5)km`J8}3*0%*!Rmi>F*&3+^=E9%jBZR3DUHxV^q=+_!}#^*5J(6H?;1
z#LOX?JwYHZZ=C1#UH{3HCch0-5XotBW%E+Au8UP1<6n^w>p=U!OKvx&3j2wE@-vTD
zJ*`HSHV@q3*uR5*{vf5WFfNldY*Ka=bF=#NszIOh34tXXRd*=ceL*2%x7XftrLS`#
zlBJ{TV+Ze;8&RuiY~q7=VowIm<N}~;6KIiCq?Lwe;#HIWLL!ke)Q-Kj&@SXWU%#zt
zbh<YDBfg3KMr+;vIoaA$o&WJe(F!b9rQsr{ch|g5zx~O`fW@qkwbso}C6lu^9TgHt
zeSxn#BOisFdbP*Nb~v1JpV9L+i|+7TriB&VPs$HB*=b5LDhO_|t&p~5;>@SV;w1;J
z%nYg&8cWw{g$>$YwbLz&vmLx&(w3<{5`h^igzHZvnrAntLCc=5*R<WJoSXOV=lYas
zum5^tD#9o%rHra-l!C8S`>EV2$|A-*kbS+o&YKb&H^!JR`S4?y(^vzdj_v1Rl$U*p
zbipD+Yvt=SvopGO20UVlq}$CXN<$n{A^IAxUv8$Z+B775D<;Tw<YPvz4I}~YDF-4Y
zUfe70QGPHaKlm$e*|L}`LJzZ0u}!(W*~Hzn%DyUACn8@p>J3&pUtB^M*6nhjLC~Q|
z*3Wm!B_nuYk4{V^BM?l*?>=%Sv33=|9B>vFI7#U26+M|6EYvb>Y=hNU8<JKMVdBQw
z@_lWv83p}?re2x$MOsgJDZ@`lo^+>s<rx(}hM0VSY|lsdjVl-bQ4qxS&TLi8wH{@7
zUNYctL7eI~*Pp(+;2(Bm4dR*C<4)^bC&&+Bn3Nu`V83}mc2bf5v}%qw_CXdMyV@z(
z<WWyd(UC>2Dx<+YXHjn+Q_S)=$;U^YS|JJd1NYQF>KR*rZ1v5@pwzmQQ;+M3zG+Ph
zJzbawWv+wrc6ZRnrj)?Ry|t`@(R9mbd6Ut)diBe>g9LM$Wz6`!2GqA%@?Rp?YHTY_
z9_7_TB+ZVXl#>D1<qyIv?l?GGSNa4H#_nEEBITw2QZ(;DLEpf{SC?M1{Z_BvTkk>W
z*C0LmFIc8muj)TTRn&n9KYcK(7&r7vdb8LmatyM~4^L!@nvbwu@-4tQ`axWwTi^Nx
zHzJCHXG<doC0matS<RT^Bo2m28^d<lp!<KW4QYjLNaFguCUORB3$V^L{vUhk>q-|s
z5zp%_mHkc})N#lhPJhqo%(^|GkdzmliC3J?6xkqf@C1n{^yCGnpZIg&ID2t$<6GK`
z!q45jj#yErAV!~4Q1RjVJ|u1+y$dIiC>DnC;Bliu;Y!*hz}Y&!9{+dUl~<?#Pu>4-
zvj-1L+FArgx(a;E^1@0nPf#kPKVzhd4ysm9gE3tCAHJU+^x$ZXOntZ^tN3vFSRw-p
zaP~Jh<5}^j7z`JO-^15f0faU<&g%=OEEUSGg8NKJ63oe*XkBE5z3~g*?U(nkr3)92
znsTZxo9@KD7>-P<q(X5cb?&SkRzd~Nf8v+R#Sq#)TDM7?PeC<ReoJSAy|{zYnP*Z^
zbMD`X;`z7q+fG67IGzVyVHi3=+f4nmJ{;{EjvxBor=WmjtTQWJ(*dN&jZyb8DjZI)
z6ydsafmal6C_7iy&M*-L_4eQ*jG92Nu%{ra-WhUqu{=LG``{t;A>sg{7`Bm-IO+_}
zp1tc5d%1$|zM&}9v5N1O<#<O3a8c7_U9tsCw@y{(=Rm16T9qqcS2OD(*kvX*-Ly7W
zs1X?WUt<N+>^pjJ2WQA?{^D&OFlQj8`Wyg8p9SK5pR?$jU-;83WKClh&oPJ1qdr~4
zKollnL`QA<&<*H;AKD`~q)tH&s)-Vu_p?v0$+ZN<)pn+KMPVlWM8;?V&ST-<nng{)
zoPCci!Pp+01O2B@<8fWM2rTOh^S_w!sYL=DMI^{^(}ZDGBSrQ1;se+a+S`_%If46-
zj3@%P0?sgubv-dz*<xK$6zCMOu^o(|^Wd*%L=~gt-y;E{?cRoVPcF*s9AwsdT}8+X
z=Ncohy)*IeoTDu#OYU|EzJ-PDLsmkg5l#fG0DGywUQ#3CtetnMhWGfu+08A58%J#4
zaqbzFzwa5#D4c?zq+E>UZ^==`HK1}E#v7=<)0^|{z?37K-E#+nTBEx7-u10N8EG^d
z{ADi!cd8#rHVC1`v`i8#rLd(j7c#LcCK3FIY29I+*Ycd;Y(u{w&m#blfdR?3E&u`Z
z;<U3B{HbUiv2<1@hdS9+m&MU1i+xDodJp&BAxis?eFfxjlkV#GxBx)2z}`MY%X;`1
zo+CySkQ9p(6>8%tk_~|wH~cH98bERXn{K>JdjKHE-ZVgt|1}q9UjfK*^1tT(Pr7CP
zZu-weRQ})n{+aW?yIDDN4A{TAxA=1f_*pe)9j@{Q?QI;1AvUg1E0~tw9#(TKPAIw&
zq{cb=$HocO<=x9Bx+!h}@P95okJ5I%@n8F$;1Ygy;{J2Di-1G$|Ia@Ce+1)SD9apB
znRviY@ALeclP0zKo`Va8KY^9+{vcuj`vUbrT5O5ovlYFMz}X{gZ=7xO_aQ_5-0>XL
z2yKmhEz-g$3|(IvK?MNj>#u6wweV9Ak_0IXHAe7&v!5Q$G}-@^VB|GNuiYM8spH-F
zJV17lP3{j-17Uf9a$A7Z<7t<4%8nTIyfBFnM8s)Rsyd##pMpvUp`!yjs9xNQnZQPO
z9?tK$7jv>-TKo?nuakqRgZpqV!nk3T!N9)B>icG%;WB!l*N;$}I%n_PeXrk+!&r|j
zDQI=A;`wB=tuoBP*$(6GzuEzXI}xifnt`()BjY^F#J}T84~56|Jprr9uHRmhM#L2-
ziF)HaoWY!E8if@EBdV`%^wCf)U>7}A|JQEd`ZULSesbx&H(M<t$_<Rlo*_qZi<Tz2
znVy0kPn1?b0Q(Zu_);u@1SD%{y#{0?7iek*#Sd<9_A!y|61&nbe1R~@`#(__k;H2c
zseu)bmRO`%(~~s|Xc7|_qk{n0%PJ};ujCH5G(ZveA$i(1Jw4;C)aU%HsJ@!a(y|pG
zo!o#l<L-hv4O*tq^^S@AkP5+yt9yqWtf=A!Om!<j&h}=^y<8x(kgbh@0P&b|v;HIo
zyf_%EA7BS_Iz52I9Q{$TQ5py0(-Z>ixL+X9*4>NSYSNwJ=LB=2RPH$cxO;M{HA6h_
z6-#%at8WUnLAaoTPeGOUT-agIyu09R9^MA52lX$!uF($<3m~8K@H%;jA%O^q_GbGE
z6ev%Ind&(`+7)1c(Zba!K&qbp`v$e&KmqEEKM$os6|23SesS^>&lK`g+wTA}(XKws
zQ}{Pc`IQ6HbyukrHh$s@f|6g(`|d*`tEhcm$^q$((l89S*lx$x%_VLh*lSj}(VHDP
z!b;u2b@7_H^`Pm=ad*fJzVB4$#r#3>*W)I#$xfVuc3B;}Zt6bd#r9<`>a>c!GzO#7
zwjqenPAq%&DR<*DX3~(d)I|0LU}BlFTk&gpey1+9(`}i6Cv^j!O&5Q%`T&puZ9j0w
zPSzOi0w%VT^5$Hw?nA)xn`)U9+NU5ykFW=j=!=3yrZ$#NLAx{(A*U;NaU9ZHm@3)e
z6x4fH&HJ5q&(lA`bvny-!!a{D^qdqJi<Qxvvj<mB&?h%|J1!(@uNZtperL5@F<hBw
zV&lXQAOr4_-j~3B@Ic#wAAn$V24zkW_hoZqqND*TOq~*Wfe>pkJ_yFt(etyYAOFPb
zx)&AIcHv4Tmu%;-`yap&1n(s_-~GaWqhlCQ1%y!c+s_vWj5Nv5%;sRu)lJ-Nzyomh
zds?F>rr_*eyhIcSI9rlXdPA~1>!cARf62A&EzhX^w4<?@0TDOXqn6#@FMbNz>qmoY
zM6I78;_zbggBN|j@KZWkA#=!d=12c=nur^Z4xR-n<O?IAqIb1yzwi|bbUlP~fJ`9X
z)?Prl4<H{g7X)-4zWOFqF;{qOIF}qKE5g>nW%wJYV$*_emNF7|PwEdFXpXqgw|-=b
zlhyG(1sss*jdt__Y{|EMV7=uSNP{XCwZG{DL<n0k`goGRiXNeD&A!b7kb9&=5*Y=2
z(#E*23y89*K}`wvhd>ZWj!)HNbpg&Jir$X{87qrVpXbd*e&FU>tN7bbAdRBHXc!(a
zQ0wWpbwE3k<DT9Z!10QkrDIVVG3wWo5Af_~GG=rHux`}vt{sP2_30Pc(>d(LIaoM~
zipF6k5umue*nP<S4Ph}LlD$vl*D9iBC+8$IGL6iRgN4Nph(-2<Wf0nF%kd?pfQhEt
zU9<NAR+x<(9K8=9Y3Q$>K(f;3Kx#h*3a<l(V<ZI-xr5<2dIis97C3oIa0A6Xyd!GB
z0p=`!<iuqS-GX-iMLw$>sP8^n?$6NlK;4g2pJnO{#w4)dRAH>VKuUVE1BA;Q-d-vg
zIO#gvi`7}W1!y3}HL*7aaKcF2ZC)I}K4Cpacq1Y8R~%E+NwV~wY!D_mi<a_mMY|J4
zK*_4*DPaDpGwAbU?{l`AXWTRsvhLtiV@)S3{iHA&%u51pF$NpQ*}x{wDUw$y*+s=S
z<Pswv=^cN(&hb)#eEvY6%}B90RG~MXrpSjk(lo3s0eGEUS?0YG;dI`U$&U|ghbsgv
znfsUt!^eYaFP>+AP`YuOv6FlEk+Sa8?%iAWmV)TnKXTo5`Xy5q(RDBD&d2ZNHF~y|
zpQVWH>C`xQBd-zv)D(#He}2F1s}H*Bq0sefv_7%@P4Db@QHshl(UcV`mEtI7LyF8(
za%W0j<IVtr0X@p1MDcsA@1ddB$mf>OIqJXnBki83N}=f1htIk5orH8qXq?zXoMx^}
z>OLNR{cwfWy=^pZ+xC)x1?2=K9#gP>I&Ky$Nh5TX<yId=3cQOJH+yhqQ6JXmUlAzp
z7BWA4tu+qZDoPTRlJ%``N@K$9cV{U9VZs}lDqIbcOouHsF(Dmudm?I#RW89M_I&_3
z{SvZSYf9j4V#YxO{VTW6T;!s+Df}w3GDv=IjpbV_9k{(Ou4$FO>$t!CZjmpd-S*uL
zhm>nyM%~`2J(}Vq;m{n{=;Qp8)R6bP1gA@|88oHbS!TjA&=FnP`C^!?LYIb1?>1@O
zZQeuUfv@YdHVKnoD!YlbNZShuICvY>GL+~f?`q%v(c=gALRt4k1O@5S=ih2sYjz-^
zBm}8w63kldJYY(m$6E?Au96<9UMB>r^U@Mcz=9!6y=<dWN^1|k(Dz|_1a4wqBR?4)
zrD;72AeG~jp|$NZ(i)-d*a%<Ibs6oH7ot672O~Hn@bMf_%Ev-19|<0(jaI)?1r3N2
zid_G?g_%z5ix}D*;EPYGvfrTf*_V)y5}koRqn#W*Jx}WoZT@=qYEsbDiRM-uz0$At
zBMhP3qFSU~jPu9n6&a`pbpV6G6xQM}`I=G3GJydK>lb9qJrEgneJ|*Q=A!lh{&Vcs
zJM0~n`26c@ld=3>O0U*G(Ol~#eE3N35_$O%@iw=WMjV%4)7yPIpjJ9@n0&evczKZw
zAvNQ@oM5;spkqn&b&LH9HSd75)d&fr+nBt@afeb}oInX|?Ff5ac(Z6IM|#s~f;UCO
zuS`TEWmK-3IF#(ehP^nHKcp^NpqovP0Q$^B(#XA<SDr@23a<Io&){|$=-N=TM%Wu6
zo|!5N>6Z^mU+;+s2Fg%*uMiW&#%4aGbtk(eq4#*kHN<@-f8^jYqN}UmdB^~Yxo8M2
zWP#eaQ(x9ll!yg+J+Qq=FMLHVT&K^_v$Tz%e#V4ME6rR-$grv0ksE#Gwfs~gmHa^Z
z5|-0BVc59gBVkc9-b^fRbk#GC*StpKD+_Y{Ch~bH-FUftYk=Yfg`&X;?HT#j03W0c
z>*AjTqw&Ff+gKNd#w2?LRSx|or#nKN$e2VqhdsD*tcOsSB&v0NeJEwG<`Adq>r6?$
z&*>~yLX+I#6U6=@%U|pxM}xSnQ+6+5Lb=dw9oF{Kd6_q=e-tlH_uc1HpN>#0Gjn`<
zOG=phZC3)Rbz5A^AZ><EB%fF0b9n!)Puy<PdygUlhX~jbaeFeB9gkzj)KXpSfNrl~
zg0~i7)He5Cj)qKf+TL@`NJo&r8%-PLT65%;FiR~Twqui}Gmve5B33rvO8=_~yK0f0
zNRrx1ENsF{jv&h3?@c{;_90T3jKY1um~n=V+TDQ8n8$Cy)24Fv=!>T4I}K5CWK(F-
z{kYVcBi6CRmLW^&BP_kM%W(I!vhYo=cnMyzHv1PVMpZp8L?SAOrUD*{xkH5Dk6WMk
z>`aBIwa1(>2>*CjLxd4t6Y>biAMJNP2zOOob=JK>oof4#xX1xoLM%n{Ui6jq951;y
zp(FoCp&EUgSj*-oeW?u`l`fBkt_pZX+J5w;^UT@a(%Ze&QozftRw{B;5GmQ<Z}~;o
zC~Vw^`N1Qy$8D~-aIn8-q{8gYuimQfK1$}Jd3j;YtE<W`Hq0*N44LIy8z%h`9zI3*
zs@rPW8+X(~B=asyw|FTC>o*uDLOy&uhHxJ9Q9W*Ri@WR%nJ?bcv>tjEjt3*i;Ry{#
z%~c=jJg<7pj+r?H_LL{#b)3F9iDh@c?D@EDJoyDhGiEhY5Vw0a=Y^`zj=;g%j!puU
zWCt;fINtAW=ssl%j}0@aJA21{FH8<_iWj}{X3>YX%5HyTQriy*#&={_rm~DgXbz&a
z&=NnyO2l7w3Un41w|=N#(EiS4)OKe>U-}kf|B^3d)+3U^#h;_$J_T+zj<$3=glna=
zVeDDVGwdA~^%V@^w3*UxE(?5b7W~{9P@SP8-01{MXpZd5L5^?tjZ{i~d@M=WL`=?{
z^=Bshvp#JW-El&$Gr<j|>1!_|pe!$(JS&_@xSXLBl>AAh30KAr`|z!OT`6suz2AX(
z_}{X3EDuaIkDfU0-Q%@T2=>1XQ7U=gMZpfm!wuAyBe9Xnfg&Sh1bNsgv^a^lwB4AW
zm*qayw|xIb>G10`ztO8Q&@1vrsVW1yD4R3U{eq7z&)*QXU3m$}8I9VCgYCX*1##Wp
z8#&(HGExhqujo8eZs)#Yx1$Qyx_h-ExpVX<O42oZ4me8bCvXRTp!rs9(Dt0sJ%dL-
zDIy^GNu;8vf-Y)C_N<|VOY6Z;i4V5aCm_kY`;wVHXM7j<t2wcf4}l(E=;*wxN-Khn
zd({ZX%Aq@Iof;jo?i?ErNnT%QwHhAzJ%1^hJ$BQj|K>}hO&gx00s)eW;g?4Cywj21
zWTB&mHa3KZuODOnkP8+cFpJnKziJHap>iV!r)Gq%eZ8v_M{@C55mdAG)d@~S%_2k8
z;Tl%kn`kemck2v){-WpokKP_mi(&$rY#)J^J+VUT7OKJ!)UCoDHjUt0(Oagd&8FJw
z)jJ+N(mUG?nTHyYUV`5h!bd5tD25$=f~}<VzOvNX-seGfI`R;(Gw3snwTojsDVg*b
z2)0TOesB0%&2+S+=h3kw|11;B8V>@kc@Q9l37NYj0)JZS;iPv-y503ij5i{(Vi*I0
zv>HzO$ui6NGD`Fqsx_uZr!BwN$cIUBKe=pChY~MuQ}%!1mvysudX4s!@ly7(nN>?|
zSRZ36-hQfd!=MuKlQ+Zx%`o;f*w42E+EG>N(9>&FSy%f}**0n*z4eJrMFM&y^CB<I
zu!5{*+2Gf-AzbeHbdwo5r9r%06-&lrWSYqOjvVIO!9+a+Vd0W!J5%z+<J8*cl6wP0
zkuq#EXx$*>ulB1JdG}Rc_Cfixy7vc7r~cX46LEv9TY)_6Zs0<@nmAcrF0o5}<>k|1
zLEs7G#M^<~NZz2ca|})}`&4$yF~#@ow#5bir7xYBIU!0*28`MiL$nWxnakI<VpuJT
z2TKJBASui^RZ@|cNB%M441WAlmn!^d)9ebQ5zDmi71XiYI3jJ0vqXJ=u@gb$v=P*v
zKOg;EO5I<iz&~#q{V`ZEo%-ko#Xi$FIjbL|rlq%HQJQBX=K*>mG~X?uiykU(8|XB1
zZ*miioHguF4!fSpT$hT;(Jo<G9nkKcU-P^7gQJ2C0v)e0v{i6>s;@lm%YtGlQEHhd
zELVky270+D8g6f6X->I)cCewvS=V-gA+~p_!VOm4Zg^RhL@2c9kCfrU8&xXTO6}Lo
z&(bpPHM24p-agokiLa=PZgVsSH7?(CEzY$1S-9#XH@$dHptRxX^?Xe6_jVi|IUi@e
z7&Ja%o%LextyE<zX}O}($=LQ6Il2ZD_yg_!AJ!^neau_gPnPMXJ-J6Ux6OY>cXu;z
zu?8$~Jt8YfS=S+)m(1KD=zldB9NC-lboZqaL014Ys?%E`W2B%rrf#lsWb8}p^{uin
zrWO>zBO@IHgZrJT1v}2PLd0(+-?3C(S-aUl$qF~mg^Ho9mXj|-Q;jGs8NK?hHkWqL
zI>Co@PZ~6;z6bJ3IjcTCRbRa?6zTsg(k#`Dw@RaSwk}vVJ@w6ZWMd{@12IqLy;Z`R
zJ|0sMVvkm}c-0o}bK6$2SdJyt&Q?d>;%JX5$(MF-Z_}y5*d(9or&k>_7iG&Uq8^oQ
zBs*-EO4}>t*Ph5f3bs-CxSHYYd*P6g<?g4-RbU1mDlHpq{wh0NUW$#+*Wx9e8&5?$
zg~&ICCoD=vs+1!;8y<-m|FZhBoG=!#H)OkH9Z-3l%E#Cf`1)Qqzs!D1jod7!&YH<5
z>4X{aGAPp*#7>7YG#iB$&Ce=9d?>;~GY`mZBJ<{eTfe(2KA&X0Om75pYh+4{3$4w_
za~INAGKMTkn>4*k8e9;xVy7)SC$A9Y-YWHRnD9WUqDi*9>tdPRL(PKE8+=C4uQVpG
zy*aCwq!Xo?kFGmjznV?=anDe)jmg$n!5lQ*Bg|p{Lkc|Nw!pp%7?ldx+I`FPacy$p
z@w?An?yBn*k7A9&8xwW)(Yw0y@H~d-wGrj3x6>`9%F#qB9A)CYFQYu0uHC)~D@$q^
z$CB1(cy*)T6fbw1P2@*u3rx|w6)2&p1tUBgj=e3h;ks)>v2Lrk`k!;-65aGyr4^3?
zppPU(jkL7T8I%TF+~+6Wu58?b1aAX(Mk-kAnihY)e>)l<rK^57+KQJfTT*PgY6g=b
zEp^Cv2+5JEnaG|$!K=cOgW_bomHgQA>m)fpCcC?>rQ41&JlsL&P3*#67BOWeHHcH0
zP@dAyiQSvY@J61mI2l$JD<f$W%91LZJn~>olXAM?N@WAf{ZjW0W`)LOEhpV;CgX-(
zAd8%Qu409K@?V1H4U)=VpOlE-XnBO*{aDK7Q=3R$1a6&hir|@Od3!bBCuR63bebez
zD_A`4+Wwt}Ulg>%nKI8QOyHRfeO85Up6YJ%ttz%DZ-L@4n@vr1t9J~7y|LClR7Fpb
zMD(&L4i$28>@Pg`twwJ&Se`?_%o%Zt8Y?$mO03D>+}M2Ub&u_&K&O3TyP3E8{$U!D
zwL52ulSuIk6@=iE7XvreO#fDnuR4W;I6O0v*c0o7tTisuKgUw*GG0XPFPtCj?sn9(
zbL`9UlHX2C30!J!{Y3vd8q5&B_CV$hW}EwNcFH({N!j;#CzHFSRx@KRIZNrBT8feG
zNr;-h?TH-0hn*xC(dbw~K6^ZSl5@+vBw;$pE)$(@%n)AZwayq!?MhYrwJ!GP#igs$
zdraleoa%dcu=uUOJQVQV;Ln+dD=#@)$DnF3&gTVfXbrB!U9FUfVW}Bb5lUw^nPwiE
znod9U2OE4v2ws21YMSXOtL+=By1$KQucAT&6u7uIkQyz1yL~^DM{e4vdA-jpQ<gE4
z%SrvJpV93ZY5|63>Yyp#6UP21c5)sMoExFr8r!N;mNmAZO&vA9-$Fe`l2qwN)Sy-q
z3E|23o_5?a)3I)!wg?LjxT`ADb8f?HvE|3PU*PlxxA^Y*Ge(u4pjPj!iak+}9ipAb
zurn{!OirdbK8VL2vD3Bt_XtwW*L1kwXav{Wchb5Z#00z|k%~=KU`ks`Wu~xPL^pXW
z(C2vaLk+}<5^H@pEFVSsS@Nc`E&A@0^EzG}iz#*5wo_v_ss)h_c6<mKnsgzU-yN5M
zWzW&HT+4TR(K(9x$G4UY!eWHMN~$*YNp_MYvy2<9I|iRo$T*AE-l?~g#ZGNsn|`kj
zVaK$;M!Fk!C3svb9#|e4rxX4D)o13zFe};;3ifo&&^$>AA!Ab0pL;;^$n;hJ<r)IF
ziIoZUw4>{OFLC}(Ij4^gd8Qw-WWDy;OlXHJlR_8GvPwb~8-M*8jV;M<6Xnvi+T#5P
zgxM;qU2>%eZ;I!P!~2+2VS_x92$zj5uKc8>&|e;gKl1Gq_bR}3R^fd2)smU?60kc;
z7_J+>d-}iMy<v-{enur>sQ+$ELRnHtX(}+2{Y5iEy)*I+S}^3wdq#Y6m`{W*Y98`(
zEfmb7mvGRtD)Qdd)4)yA02JtDA|=8D+8B|x5LI<A6&%?JhasXgjF*gMM74$PP}k))
z1iq=yx|Q-}3lA#k&oOWE_rK2<JGLyQneXn42BAV$bY6RTTO4?Q_`~Qk?l$wGPdH7I
z4~ffkYK%9KbTS3U8b`)Vj#I1+7B3H6kj}=vl`zdd82VW1?}==H4JQY9bF|4IvqfQF
z9WA8mJ_p$5y+oV}WJ(;1xSi3TRbKFIFuE042I&8#MpmCe|K`|5eTL1&X)4$>b6bsC
zzb%t=43Ra~y0>G|WNG%?v$IpUHUQVZJ+3hA;EnBlMQmjos%2=$pmN1<^K8%W`+(nT
z5&o+QT~?l-g(=CxKiiiO)|JQcgitYgyj!5xRD0;RhMBDZMB?o`H+zje7FZ!FBQYvF
ze1#YmdbNja3G}^z5ZN1M;ZGjPNU#Ka)gE4A`u@JFT3+{~mBoXEx`k%~Fwrc;9hZ0$
z)*Eisy}!p;hz=gwE`cW{W}}q}b9OMVo4-GJWYh09j>yvry8|PnJ*aE{FilG5HAcPs
zQ`tw8=yoG+yOT$?-KR1%Do9*Wax{K@*|+vr$MIA}<~TeS9)J&-+n3;1hhO+|(p9`T
zDf_cvt(g^@e5t8@SN|LbBY?4oCmmV50z+>t3-0Avv`xf%JSC0Sni6#)WAptTv?+mf
zj(Mi_%c#vK>%|#!*@rNulaadE%DF$pFV|}_Z^VxIBci7S%pJy*bnAFU!nn*GQaD9z
zS4M8WBThs4MrDTWcH1SbMm7Ct7=qqxhjL!MLEiLy{yb`E)h4DO{MM^s89053_8(nD
z$>*o3qp}sWrL5!l*&5{n>@!MSjS<)ExaIRZ6uUMt&(+y(415=BFybotOf)fYe)%Q_
zsD@9xdY5GBoj%V?#Isbzipui~e!IUr^ay!#sI=PI5R0o;X0kYvlj^gLAy6l%H45Y@
z5@@aA(sLBp+wNldl{v$CYt_0=nTf>bZWf&$jabrS*B8`Iimh+QW{@lb$eV#UwI!S*
zTo~%7{dxWOAj`OvrmuBxH_I=)MZ(y~QJCm=OyaESAft$~S;>ULaQ34R>dDUR3~`5R
zL*vv=pViC>ewxIXR?yyN?4YV^JFQmMXRD8=;XvNh>(NKhI^WRUc%$U*NoIlUXYnF+
zuyGS~A{HnVdbX)AMeFpL#ruox+oA?$swo9^7jtK*A=jVu_<-YB(eE3q`9fV16||QO
zCGPAQ)rMTBRWmCSVt(=!@$@};vXSmDx>?2-oO;S8!$j|SVVLWt^SiGJ>(x$ea7S8A
z4u$!?U$M{Yi_u_kQe3@GgXQdF`8C^xtKFEbpdHSSm%vjyy;UOAiWm^aNRik;ik7t!
zLn>(R%*EFdcio8;t<B3Z=pHV<<@9;H;mwTB<Si#+jYn+VPY0d>cV32=NV4lNHc*8d
za$%;^MZa%KE=J}z8gYSR6Lov*o<)d${}7j&I{7AMpYd6L-i0`_KT=**->(F43r8$f
zw1n<|ZF1d(c(&uORd|c^%xQA~NmMzJEN&G*pfQ3(dB$Nw{CRHINC~WK)SXP)9!yIZ
z7?*vqfeM^U24#kLQU25x{|ST=qYwDn<A7Jg6E$>9W(iiY@T#am%QOpP1!|0(q>ZKG
zAMvEm^&@A5{3^7?@@W>DJD<DSzpTtW|GGBI@;mi=&Wa~P_wJp^+pVV4M+zEfHq7ss
zTf_ya=iP)u+(jKIX3H`r6~F9jTcbOnY988@;;8D1%}e>`bav|_=;a$Ex_109L>-F5
z#nG|uk4L-1N2;5XehBhA?V_%r$&1LC*XtEo&4RIw9Ro-XWO&rx2$2!j=rj;h_M}0)
zXK!M{HBpD+nItvJOe#{H+g(;MDJRPO-nC0o6$RFA5W@=EEziV1waOaIyFUrLS?+2>
zhEY*2G)|v2u&Rvyeb;_5T0B0qCCMsb<<yqGgNx`rrgKtUJi4`NTlGcsyL)SZg`>aS
z-&-D=M-D!>oj!{YNGmSDdst|X*c|Wq(`ywelg_L1tiFkP_Yf&9-b>}A$U#zlDxFDE
ztNe5@XztX#BHm8v)aBxI#>YmkOn9H}uNP9toB902`Vv$?ED%RDLCENwK1&i;7sklO
z0-;DmMlX&GFJ+8*w;gB|qndp0?ercHHP(b*f)4?9i#`zkGM5SgVnp~;DCE>#nx@R*
z=a<u%^Z3=(oI?GB6<{pihj$`Ss>jHi^v_?qjo@!TM23T(k<H`|vcxa5uoB0LS~-K?
zGU9J5Bg5-=^7TUinWt1(zmsN1hJU!Ec_>pXq+eKQ%{-_q8wnt-URK(A;GTB_?o}^@
zn+|jPKS+DausGUiL6C$b1c%_-I0Ojp(nx~DaCi6M?j!_nB)AjYo!}DOoyOg1+?^@-
z?tXV?=iZ%Xc7Kpc*LmOL)?HPn4(F~)vA{z%H7G;!poO**Wc1G~Ct$Rk6&E*uucL<T
zHt3~$Y}=l5Q+nU%Jl=(@5ZL`Tl*Y-J`*_YyV0B!uifCdVua018p^II6Zq}}%uhEnn
zYu?Faqv$5cGNzt+|EV@<t5ABSRKB}U$`!JC{pXLg(P_I7?FlUtw41w0l`>?rYMvKY
zaxa@QMUD#_rVH71-eERxU&#YCzAh8DFV2;nj~yV4z-3wj14?aWrwpY9L0?O!kRZ`N
zeh#TDhScBk0B0(_6NZvCgE`Z&ta0w|O2zHf{M;_X^dT&SpIJ1&w-M@gq9CSU0(uWI
zf@xeuK7{T^3jO1P>Fl1k4_l?;jPF6}Fx?7qg%TCF5^~lKLS1`9DACAcW^`f?yKz^g
zbd|2{_vh48Z7N*`Joh5(cy5jzNO;N5>oN9n_J>Mpe${h;M}~SH+T+`>3xoqWTPt8{
z0kHil?yH|)KT)VDZkCEW=f`1F^u}_wMmlI;RG59@_6mHf>(M6!SlgzBzPFE1msl<K
z#1K*{H!Oh$f(C5Zm=V?2s8ZIE)(-<fL*1gvdOtGgYX;;Zl>v_maTQgSX}M(nhhAAv
zDmWDyT|{*A7YQ3GvRaQzU{TXjOo00=l1B|dipU>NnQMLRW9cAVo>bl3vJGd_gXCT#
z!2W=`;75>#ZG%&{a>}h&ewH4b1DYa^^&vCuB8(6{?_XB>*i9%)@~#6?4g_8F&uI4S
zJE<PR<v`vR>y@=lfzYkFuOGVr6$xaNP=)091CGe+HH<pBk*7kbgtH|oX#stmFlaJ+
zLbb+#%x@MA1UhivllcdyP>AseU>xjnzHcQSdXU3B<u~d@<$!!%<T`2sU%x%F%%IMC
zdko}I!74`ILtRK|d1-m1rN@|MJR7t}t+2~Wg);vI=MISmG@$7lW7{bmP_hy#fa`XE
zk@Sw@&^ELSF@tmLr||V4)*2ZPw&#t_igX&p=6#o0k3Ztrfy#vMNiU*9rHMOW*Pjj7
z+J&McfV*gdn>#eA*K4uh%%=A4Z%$&JZb4?8u`iD=E^lZwh$}ZadO=pFSVGzxSa{}Z
zLp3UtGdS0!YWqM2`S}*7@!p?v#Y`35yuDb6V8{qU_u%a`2Y91(NC~zv;RE0_`vWr0
zY)nuii1mGov+bh`E9Z~XvtI(5L-G9%^XE(_G>Kdo(uJ_pHR*755SEG8yeV8=H>uA7
z%%~iSW>pW=3|Yg<OjXY&P8r}Ans3l<yE9$L*5DXED3LSWfn%Q#$g3t_)zD2O*@4|O
zze&mn&_o7>lHa%0MFIX>&Fw0u=~4keaNY+JLjxMH(b|?v#iJ0SBLKfUPR_3@5A$>^
z$I20h&8bNl0FIK<qG}6po@=f<BtiWN_+K-FG5R0>V9wTv#$!L7W|>0F!5^Y8?gr7i
z3Cjd>jS4t`?6wPcvIa=ero!8{F>VQceG(y=GYoi2zot_D#Ks_Q1ej$^mFSB=w|DcI
z5>U#|$fJ(R#iJ&|*?}n5IM~pI(8;&?01<H*+lk2yuUd%NRFpLC1at&OaW0k`g8+QB
zr<DVg^xZw_`?8G2X^*`ov3K$aAVU$~+u4um0G~#`*IgFL0h%+<4gq%|?qHY!z^=(I
z1@b_ultRZSuC|CT#N3<y>Hv77Y#5C{1bey=vsj(voB71sc0%1sE<<c9bcK=R>2S_t
ztwtbkwMs9zmgzxE&N~IbKne)2s{{dMpt%%%f)Z$|80?rF^Z5Z*$NthZ>O*p8RomQw
zg06-t@%zVcch^tGgzFYvNOz<EuLU5B$yV4p!wm0=oIF)19R-n60R*%`p`Ut%&Ne)V
z{V{oM8l!!iJ5qz%jr?yp@0+)mZ&RFZp|d?%g;dMBkeV7G%hlnAoR*5KAdCNmT4w{D
z$R*>4KR^nA^+(o0fnvlR8|B0dG=C~>oxi_3j1Ca$W|iPEYKC&A(`y!1GgAU9Z4gm0
zhtMMugY93ZZjH^_*yPH=*X^lL7G@0~y-L@I#0h<-lfe8^h^bV7L~r((eD^=3-xLGF
z#ma7a<^VJYy9f(+-xEV$*HiI^<JqZF?pFF%P9p-Y+=K#}C=>Ti@?~kcRG5;ozi{j(
zbSVb(Ht!NJ4G105`DRS^EMOxQ_2(*Y9=e?h<tVGAXaIo9O>GK_?)eqaq~KWzv3dK>
z_rRRLZG;j2FOP&`1OqrJyh5NEZ&?Bm(ia9%cs<io7X}02=?K0jXLS&=LM%;F0msfm
zqJ>$+!jQtR;-hITpaH}w&_7j+2&$AjKS^IU0@=sPm?UZfGy^ml2-ULOiT;I{wJhrp
zAHaTR=HI9O_;Vf?KDP5-r;czpGz>tIdQ|zAYJ$utAloLX+Z`ZD5xLBVv2INB4?FFG
zhGW)m%s(_eBPXC)DHXrel6Zr*Q7T@@fRS+o0g@Bmk6xggrkGrkbsP{Ez&N{d<*S8-
zdWr*_8&TQM0YPgh@_V(bOuVu@ibHDQEl}KR-Y=q9mx-@2hJO}{79>}p5B*RCvhY)(
zOwz?R9DgM1NvC+h1F*q8K3Wz*2@Oz6;_)X361^-lud*&hN^x2G!?jl^=dp$d;D^Dm
z^^PJJ{B>%LZ5{=5DNR7&rpmYN%SI4MWDi41s2HBP?}7fi<a%wOncc0e{(WSlLb+>L
z_*IfP6sX2dqI5g*n$Q6Ie)ZtLC+{;=&=f9duSIZ@cyKjSgqZ;M@0;-mHU{K~SLZ$|
z6(5HWj#LHIX8j8L+@Hj}{j_&h3@3myz4(Z+=Q>Xh(p^N#yM51;zZJpt=8GLriaGl7
zeypod4n6&Vq&`_Q9KG|8(sPHfvjhMMc0NYqhC$O*C~f<<^bCPsY|hLtDjVq963!cE
z`2de1MrD|vSNj13Xl!29^sE&0W!s<9dxyGCpa_I;e7`3~_w{I+awPy<ozw9M6~np^
z^PEW8_RYIRpuWxb;5rst14xWvCU}l$cmsRi6|q=#fD)a7&X(lgMh(zoa$Uc7RiQlY
zR4H)30=mP-`}5%Wf#dFug>J<@z)~H$+H+12C*a3~Iwi0ZkeGM*xyLH8%-00`6|K0;
z4TR3XkU-9IFWpkCWEINP3qZj`v;2h-n_ofD?oD9mTlWc$rhk`*4d~7uB2AoO`T>Rz
z$f-wJvQe3u5mVl^-7w`<CT^i{QDetbE^hHEGnTV_^Rv+7$@5)8zt?Zf*ZSKln?Ea~
z?QQPqLIf&qOT|;3uDT9I|8(e4)&8e{Jzz(iawx=vX&(%Z=t5MQ-6S6zE5t9|2+z2W
z4I$kpc?bQwrQ*JXeGV5N0N3T-lIPO~e3!dMri9)f5Z^pdP@oW#{Pi%$&4<*8)fG&M
zYn^K%K*?XAp3c(1@kI&bPjYcC;HfXoSu7fSfd8<UlMew6(AC74?mbWtj5FZMfKIkv
zGsu5HzOt42x&YJ^0px^?1SL;mptFv0yGrttvY({-Cuc<1ZTfTCrcmxC(^?V7rOccw
zmx&KDhX4ub*aZZHY6B3_E(@o+5cj4&KyK}$L*W$W{R~jUXrS_j;S~^87Hg&{K>CM_
zc`8~0g;lnw0w_?s1T3V`?i6N9U|~3SqY+*K0zk%SMX7dgheqJ!9MGOB;8*{+BuE#6
zqGX*rc|!+`M=D?#RrMjvmf2Y;bSDq=I+Np5rL_KjtVO9=81aj=B%(ORvKv$qvCyGI
zA2umTYwnAbIB1?3%qbd;cfdK?L)haX@VFLJo_PLgPaOE^uot1DMVVX}F}|`&I;zO}
z?rQaMF=9rOaxmwc4d4U7db3lbcpdPK7y=-S<or&)`Sj7oy+OQ=r6^mo^66t9fDgc9
zaPZ&?u`d%Bb$x{DE7;d-QG$0I;@oeaPPg3JJuUk*PYZD65R#6xe@3{i2gy8jhS)oj
zc5Avdi1YCi!MyIabREjXp>BYH0M=er>qc=t0<<=4k&;PCAZ;{nJfX|Qa0Je)Qo>O-
zKd!^17v(L9(DKE74X9v~LXvCoNr0ZSBf{-9pO)tXZjj5|N!gPl80RP=e5O>u$rJ4>
z0IU!lld$>3$}q#GE2PHh8ephQyi|#&B!a0$+XO&p9PwNNI{B!AQJ6CzoeE{G&_1~)
z$=IcHko8wGb6=_V_h#kda{s_KTx_3M`{}9%><Q+S>wV(ouZmZLc#Sxh*&KgKgcMYg
zU>hK=2k||9Iy|YNO#E1hJZ4f-Ij7MVAgk;z6cg5DKuZC)bkp1k63o}WpmxM9HNx{2
z>7h$5?K7Dwb0=oUxyMmkE@KHS2%3*%U?7&wdKH%kX1$PVBc!;hneu^-r0sl8LwfrS
zB`GRAW9f5CZDt&oI4FN!SDVl~OU}u-H{Mf>HIaNoRN^O}{3f?iU{?2RCOjl}x=HD9
zhDQ8DIuk!^Ke_0gnFTF0=hLU_H&aImVaMhx!FD*##hvUU@8E$eG14pBOGLbH8VUQ)
z6euG}BNVj0cyoL=JZvM@nWux{Jr76nwUa=u>m;vA`mU5_MBx7NZ$Y%t$P9KF8hTCb
zrtmk9Q#RVm8sT5JcpO9P_GM`OVmT}!ew=UpPHpuP1W3@2^l}+>JhrdJ6Q@+{fIF8y
z0%LrHav#1p3Yw?IyYZ#RaqHn`oM(;*)^LBxpYi@R6ObZ~oqzFzcqK#~Pt1n`%RkOl
z?EOVRd#6EOXJI4VzP8p{`E!&lLNfW0DlH#oZN$%U6DdD%XGWr&p~l-E53m*RuByF{
z21vp@!_?mwe2MYB(q#J`Io9=1beUul)a3N`REPOGm^?gwKKiqKVjAWS6W2#tXCJlg
z?oV_$r)_kl1*4MPbg!@>+1^ya2d0MNV~z#<z1GfFD{2&V+3-rnEuFF*C_xmgpKrAY
za4Sp~^#}BJ5vJ_ulcG4~CS`HyL33{>18W*(m-22FiZqC=veS68nt5c3yQV(7y!0DD
zA<`fBm-5)XVD;wNq{p^{O)MbbH{1H)N9~UDzjTwE0hy;3xa=O_&`vm5zfea;a*Z_a
zdMKHGA70$8_R(&g8AXPwMDL-*Kkgj->R60ktks>AMY4GPkZcj@`Ac4`{V%CACIu;C
z4_RM8YlHV%1IaHs^mY;p*`wK93yYm)?qgI$s~vEwbat9szi@TtO~}|!wL2jtQzr$u
zV}D&@>!9{pRq0o+EFh9VwdNL4q5hz&%$iB&ov<{`Ir%Gw!%~S9sSqV23r`*c&Od*~
zPC-pZ?r+|&2g?h%gAao&3}?&nQ8%nX(rQ>VD%e5K4e2+7YW`dRSH)DksLjwqqJ<r1
z*=15llbE-%H}Xx=jcL=(e+R?_%Ba>j4yfP$%Dwv1ywh@p{*Hht!-{yX-~;=O7tBEB
zZP)Q6k43#XN-Nwc&7@pn4y!JI1rOP0c{L{U5hJc=LML#%M8$>CnP}qc$i0fdn<b9}
zg&Uw|pQy|&BA1t)T*r&7-EXf1nR${>_sOE!SHkRyR}NgxA=>_-7aH!X2ep@wlBl<9
zLMtlzYr0#>;5r-j>#pthHuOb8QXt%%lwzmrtu>3`m%Y3m_O@Jn9yG;c612uY4mNDA
zmjvPz*zBZ0nn|eql$JT@8<JSTL$K44p6R8*y(BOnFHsq^Yda$tc(?;NL{^AQNNt|}
z?ROjX`s?C!X;<xZy;SSges%rb{txMDK-idsu_DXGUPpEE<5q|z`Q+nX%&yhbk&bD)
zv!_G%p3NgWr?{Y;Fs8v*69J855_raxLjeAY9Vx5lo2Sbei*^^G+BsoTgW@@#ZXB++
zRxHTc+>^l0#X+Z{4pN}xBnZ#g6Eg4nUf|d>jZX=HPf>GSu6aD{ZMfv_c{~nprOMi#
z=*x~i@m{7h{v-<K%F|XI>c9LR_UR(ILaR@L%Jnuq>B04<>my_0`+zinmQvyew|{J2
zeE)L>sHJ0i$+-qt#fY-|c5u5*qIvV0r1^0d1p7%E@c>W`I+U)L_)*3c3z=^Zd>)6%
zF}l}RPmG8>JnFV%`t{WlIIi>VNj6`P@3D_M_+fT4S>Kil`$r*NLlf<J`ZPRG%p?Km
z0d1I^04969OGM-8Ea5*YG>-tVV_|<~*4li;9<cW$Uz+kEfc-@SyvhdP5<En|0S#d@
z>v{tJme}xnTjZb{HI(Tx3P^z-6hJjcu&pB~>OHR4LB#^;=8pD?bn^0}gH<!xtXgTV
zKo)OTtZcNq4xNsrK=;gUIbqF;pW<9}V(tVVZ~fRO;kzZe>%54)>YUUF*o(d7(~Y{c
zxo(m4vERAm@wip{I5UZ*bI<2tU-V%ks0!dG|2hs(?4w7aw*O<5jn&h?D9y+1`$>=7
zl6yQI3OTi&Bn^EsMuzOrB49Hcu0q$EWN_T{xWLWo{E-q_$)lwxFAlZd4T{GBEAfmo
z+Mf=T{ZE$1+`_Sb@<>}tfc@ko)Vt0nJFvw5**pE4tS5ta^yHJnlifgwl(9HA=}UpY
z*YiD&w*bpFT(-`D@4ZTxP8xWMoQx5dRX&eW%lYX(+b48NUZhW4T09YjrzL!{154~N
zKn0QZ=WRL=fGZZ6w>%!FZHFGo;QPFa5gU%HCs)-2Joa{mcX~3%kNyErK?BdI`p{FL
zl6kK^F^#zS>mLp60CvrL#s>qqaX%ffw|ZpGmg~91%##;QF*zlJFVRlUH)o|l0+>#G
z$2>Xc_o8`aKoS5%PLWO?L#Qy+srtv0%$A>=L^yhw*W=Kl;yC}%*{Ok~`$;Wydv=_>
zM7Z<+1lmp4_7CH|(cP;*Pw~)54hYvX9q#1+BoqrntrV!&Y3q0?2|U%MLv#-CvSwlZ
z4p7V-vQgUml_%a*E?|5fw^erU249u;Jqe>bNHV#-T9RyocM(e3^y{$tQayr<o6<w@
zqt&g~gvgcP0Z($Y!yELg*umb=RSQrRvmVM?OeQliWN}DKDZ9z76YazEl=W813UzcH
zL|0TXN+T5LH2Y8`*Q?U=&(wsq$6vT2rx7wpP16}y6uO$zrHC{6LNR+SKXjQz=iH(Q
zV}tCRl!hl*@q8R$HT(=RL=nmk>8-6f6?!A{s;XlYjmke5FpY)<g^_!psy%$Dqm95r
zOneM7V-a3=gh4)6Ncpo%h~29O$#~BTW`B6RcX7(85}dM2E0?b0x`XMr7ymuN81H~r
z6?;i6ZY+)*VRp!XHL4nT7ly`zE+_@nNZ6%XiW;aQO~x_lgm7OwDp?Y5+3ptC5spc4
zD%0^I1Q)*-{i^gZ%g<EL9w`;MRpdXK=-|x9iJg1MC|7T5_Ur9hpA-RVJ%Xf8MDz$+
zc&dX^b^|iQAk`ejgjEk2P8vPZb{wvw6U~kQ+Pefq$qI)8Q5NZF&fyVfBYTfpdg<t@
zv~~eUCnG~oTz^}YKkUH=?UyycpR=gMPArdE*RV!b&fi|Y!WBLny<&T2op<)fg#j8_
z$5cvho1>i_#f6Lq$u8pLUgK0siO~`0Lw*^JqyEwGQfgFPiZ)WLtWXop`BCL^T3XKp
zdzq!DR{u;vnBU2l5y2NpuYaFf>byOIxk#cg=O$y_JDErZes8DhP?o%T)#`%-v(@R|
z+??|>igX9qT$BU90|A?FSDk0y%**^aRp@N|-Fe0Pvca#T&jPKis9Xuxe0asBm=}bo
z4mi4=yC!f+2TGyuI27-eu)j}@xaXGB6W2|~j}3IkH=<UdEepWkFh=R!%5N?o4PbNH
z%r+P+(_Re~7_PR{mz~{)yZU%Aky{n2l9eO~6-l4Ej%Q%kDO`OA|6MmZ$jtKd(tUs7
z4zm*bwIS}ZkR!-YqB%K{NE<$^?mk4R*!HF1mQv6<e2Zb+x!rrB!zB{FGU~0l!b)K`
zk>5=IuGqSUS$|zcVY6swC_Xt0RneSK26n2oX?EGF@0xgT_@-+`{O8htb-c?LgV^(_
zZhS(wmwUG(SG)zhv0EX9-N3EL?uVSQF81!LzG2yERpxiSKVMoi6)Y<|W2oZcSUK#x
z2<s2D2fN0$kml}QUcZ-5p%G-ysdA>H8)YT6i&=Ojt^Q5wDxr|m1y!eGQaNz6z0321
z)FsGf@gv_+wf<@Q<bhhn&Cp<EuuyUiH(HDa@Zi&IUODi0t&R{}A5iy&FL}a|PhAnl
zng8qA=N=))2IxZgCQIz|0F`zUt0*6a?>XiM8B&#lj!?sp4_vGXBWVh>7QZkp2%L6h
zZVhQsDwA$c42*CJ5H;032UhQ^*ag;rpP^B#x+XnlET*q57?P#06B!VP`9e{c%NKnr
z1W!BAf=usL=);~hc%{tyRI18T#u46h&mVFx4Q>q-zxRBLkTvaht7`4Hel)VcBl!?{
z^jgbdTD!PZ^Jjg@s+y!t*JKLYneyb|yxcYWeJEV;gSOjmGIRuMv3ufauizVk@6pBW
zLi=8;Ua;wVf}x0dmyX`&aAgCx-S9}~o<U*BmnDsQ<8}SBuj(zobrf&9;*8tvmx}Q-
zjDs4tJUnnae}4bcLao+N0SSOHB;5_}kD$C|hbk$56UyBoUV(Aws7ouey*OEa%VJ+1
z?L~r>y@Ai4<!EdYObcmh+3VOZlgi)HEwBCo+z?;Vv5@phCS4g1Y&T~nuEY{BWNIK2
z<1P6E<+8e1OGF_mv;Jl71MQAeD-psV$K>5O?10)3PcY*2FFQ+2Xb(wkr5@jD;dPD)
z0sJe&Qmn7Y_SY|s-o4k^Pb5&WPc<P6y{}EsvpjY2HqfAN%}GlXzIcZbO~tFPDrJBy
z^BUudgr)l3x7Ss_j+#cpmV3AOeHYnIUL(-T`x<8vX)zXBk=cdV*C41FNZ$RJCJC(X
zo@xmPeOq;ab|@ZTYk25}$;cA44L|#)q#I^=8hkZvBdNCxnVP^X@#EdzwaW<16bg`q
z*JUlRf^*}5yQh>h{e%-%L++AXT8BjMvz{5fkckiTW=lrlDlVff#P={MU!R8zYDF8M
zxPEnD+p`x}^`fM;yVWUH3#`g9u}hy+Fy^KnMb~fPWZ#}O3Ng?MZt~zLZWYq)uyjuz
zOeo?X`nYLj<CPjX7I&xV{Z(D5hyr5~Y@bd5(Nz2JS$6`CHlYgMM>d4cePX6Fz2nVL
zVCWiBLy?0@JCCk?mfM!6E_JJteokxjT0GX2nqj9vPHSLx=y}%Jh2QeMUV`Ib;IGW#
zx0P>%5C$)FB>JUt=$x_lb{Q6P{ggB^>gZwbY~*ZuB%1L%Nu<{fsNXZRezfXUWqZkY
zxE%kta>Vq-VcXpKHa0v%LiO60esOP=u!(Tp+7o1J3+~?OwBzC5&WnRJUs}CK2&#4r
zUg8RG<+l(2%FTcNCU-!ZTRE328X`s%fhLmoe!x%dN+XaWq8720-}SQ<b!U3LBi{Da
zdPz14-5QDWrtfHl6i4##7bOkoNET>Uk@oOMN;uZ8^(-%0+@N+%r}U6gyy#22nH!UO
zFbWirtkrfybydwxq{YQeh1%%r^OP=GMDt@=SX9qDgtzb{scDfLm7a}#{W4`+<K>r}
zVK?X}K3d<@@w~A0Egep<gcK)~5jT&08iM=R;a%|J`w(0;4VXaP_1zlaaHoh`_q0i|
zjsFIG@w0Z~@(Bz)c=pehVHkzomGHv9TN;_zV$s+B#rQ9n%^e_!<$$CveOvQiQ<|Ls
z7_pq(RphI8Cp-8LthUNpk1QVli*?HZVDVq@vCqHY<yB3ClwA34x0SB{nwd+doqyT-
zUj)^Tn}v8ig0~u7PyW%(e<#U*=;nV0V|M|17@;h&-4aW@72J>R^qh|cyOY`eG)6#M
zZx*t#c&@t|)`38QOrXA0EEhLOi72AGTFwm$aNmm0x28x$r)u<9I<@2mbt_2gELRLU
zuffa8n(lg-p7><CQlPK)A*44UD!8=ms|BJ{Rin5FYk|WRq(zgYCws*%2ue(F4wbFI
z;rn0usJjq;T_agX-Y}AbF;eT~-VC#HW)g7DY{&<oXI{t-xLh6kWCll&!?rGk4dNv7
zqBX%7&3&$a27XVwlbsA9?zn&R8wyHa13Q8}(|M#6_nf7Z^0?2h`w)JWOG!A5ANh0>
zAe0^2C$%H6%~Qc_zJW2Om*eT417!JLSbx8<AP0v7ul89uaVOgjLly2O21)LGV;!%w
zb3O9OEQ@-EYVS^#k5k1rjy_||l9vI2i18Wo;(1*PA82xc0=yzH_CZ|;D<>1+zU}k?
z^mgqw=y=#F{84PlH$L?+33sxloT~H5F~yk-ly$`#y9XX{xI2|xzGDh5C}7e2TUv}J
zF*sa+o{k2F4<1E--FxPNJ@8w%J~~Xkfoi{55{%KM^@)0RY+bN3_x9WCi8h2$`l$AH
zL3gq|Pcc3XO+cx*y$jT6Ajt$27VxEwJ6W*`gRCy~=Aq9T`1#O+$15yQfE^~omumnd
zKEjCH<hYjZ2%Oxiy*~8G)WDkQLm0I}%%=Ce5*`nU)6gJk^FOd3s9+P4rK5q`hL<ye
z6Z6^q(c7(pX^Q9HyOWu|2gW<N0_L9}SS=y}*qfRmNtjm!0CqU?!+@uU%EMU|f!~6|
zp}rBp4%zJpqbjKr;p+ejp22ab&>K*|i6Ql^sZ+Mfk7)nN?X?s_=FPp{{>&aX^X{Y!
z27We;tl$iMk{`>OQbjihHrQi<BA#`W2|46vSa={wdO>nLm=oX`(N)Bnua0~wkv5Yj
zhyjl<lFH}5e4O&&pyf4y?70ko=Q3DzX_s=>9(K{Yso}noYIg)6*dkg4@<rP^5Qpfo
zKqe8?03ztj`Y}S6ZGp7#FXWh%2}le78?dHoie2>yusdyYrw!q0%c*M(kd`j~#aQCs
z2V|{BTK_W`1$3}{{6T1QA4}-}ozj1@`2Xa)+wK1%^$(=sUs6wd{tK|-r89ag?KSUY
z>gCb@mc##0$^T7&V#cA`1s8zmu-n<jKSKR?l>S5J{}TK^Y5pqb+B+Cj5+gmoWOcL&
zUbz605ex<3PwQ%&TIyCl)_H}g`BHsuf;EMo7d>{9nIAnC_@RKQdGp}t;%iOKiI&U4
z7OiJfKP?k@IMwFpU%Pr1Q3?KsssHzi`Cr*}GQ3hC3wzY4pfczmgZ>|CdAdjH*7^U`
zLjTDK@Qt1vJPdpEO27mq$&vo(|E+Hw9+5IhKVH)R|3pwZMjGMxk<<S_W-UpEwf!4T
zSLViZUCGLQ@*gkNZ}TKA7KXG}9}>}e4_vwcDU6NR+fBFTc2StY;bsZC7FnD}J}O6v
zh9w66=u}zLDcP*u?Fhg8iju2=v?hhqL%$h|-rm$U<5n=y){dYT_B^OQ+noZ8!B6OY
zUOBId36j)|_?<t#4Bzu}j$>|NFetsgLKHk~ceV__Js4eg4(#6S_VrLV7IP;9pQ%av
zM$WpE)lR~d9j;yq1H&eSh;k|bbc+k0CfW`kA(HTiK+QQxCHeI6@nhQQQoPVkVOr~T
zAUGKZFK0Y~<!d5(dx91^FX|9N`E}}EO)R>B7Wd&CkYi1qR+~@V$&@}bsNvm^uE6J2
zh^pFkA?Pvd$rwTbIdL?B!5dv0@MS}+uNXy1Kmk<~oOn9`Sw|T%H&Q1jad)y#3G+mP
zOM5+y+wJz6%MBotHC_ta7MNUhb|Cy(9pJN43j<cwDpD0y09kbr9jBn2A7=#~803K$
z5pqQdl(PWi`PUzgeAaYXcNA^0fD#?0Kc6dg?4u&2rEhHK(vBdv`RYZS2l|oEcx@o7
zP(NtmmNwp4`gD7)h9|9QrG^y9>y9xoH|y{=q=h9;i~g6w8tWgbt=-AanaPY>-7J9Y
z-ju=S0<h&|MXtUHu;U<%_|gujK9TSC)Ml6ASwma-lye6FxnJcGN}o$_iUVJT+Ywxg
zfgZylTn?`ZXj)Fy&EA3ly(4H47TQtzp)Z<p+&6@I@^LeT&MY)ZOwc3n+|Cdc>QjKj
z`M9ezld&J!RVA3*F9}D_9Q<lAuP_C;LuK3NWqZwhHY%za^Qqlp<Vbi2ODL<+El_Cr
zxNFsNPJl{?A@)Gkg&>zx@#pB!2cM)--4S5@c=F=_U)f__lHmj*T*Fjumh)i%;a8WG
zsMO7&4>tN$Ia)iy3gPf4u8#1wRapTg{$~v~lOOAja`aC-;V+S!?Ncmo_XGrOj@<59
z@9py)Z?_fhihej;3eQABi3At{etE!1gPjj^M>FnZ9i~wihd$$o=9KuefW9CT;dRT3
zfF)=xP96Dl0Y|}tQoxA7>={{YO<f?DxyL~9b6WB4`eX=*aLFCH%>>lB)KWC!JH|Gk
zs9Rya&i6+*;JX<m;ddw7!zd-6xxfHwJ-Xp&#ydJN#;W%gu~z7%aKbd=S)~6WWfUAX
ztyiEBr4DfUq;dGmwFz2t$Zm7TJj!%KYID~EwBn9Z3LI{m1m4ko9)#ZB2-@;N2W^cp
z00!&SpA*P$Ls;p3*?4_??4!Yay$nAc<TnU(BXSbzDUew7%>9c5)%r!t<oE6=oFeFi
zD(+<KzASn-KtMPwlbhZGfwnXKp3ZR*=pZ^NFO!8r(K9uuLM$~%k9;^5^cU-=HsBFW
z!;g*71D7)ziwdCk;`6}ltiV>S^YImU*7~ijsCynThLeHGcoKW*rSM$y?;xlb(5l5%
zDa3tijQ2^u`SAXq{KcAJgYih07f+1GStSMt2Xf(bo>ib@p)IpyJRAVp9Rg~gecQ0Z
zM~_T$C;Kf{H{1evK}gXbTp@sMimVrHw*ku;(Ir3QghtReHrsDpLG}Yci@%=vUa}id
zL+;;*OEb(!^h{2ZfE>Wu#5vxY>RJro@J_yQ&kI4I<8c>(opk}$uiuFZT3?1oWO!w~
z<S~j3lB7*Y_|sHzDa<#bpxA*13ZO+k6+3?L#j&&Lj`4~@zh~XwuebuB)+eryi|o^b
zn1D@$!+HXs?oyKsfNfWG$P6ct(YTT8hqkYTZ_!HiEFbgC(`1h!gi&C!2U-o_fe60?
zYNd04^Ty1(Od5V+gM+#|{X6L(l-0nJ_hQBmN5?*E1W47+LkKI6!##i$n@LdXhu(F*
z0dHDd{U(H&7L37wPEvKn&J?NJVlr6INdpAiSAEoA3ml9ipQj-oZ9u-39^};mV*oQg
z{^~u=_^2~?lC`u1?xjaqNgjb?VNAFb&ad$uc*_T5ERWF25iKB5;fX(QCI)pcNX!!4
zZov20nI`ST0L$9#w|@eer}^{l?8MrkkNqg|&g4x$idVaW6Yyrodo1^~Dpy^86dj4*
zdyPsHFOtTC#*l+8*=d{7ODiK6Ura5ygqtCy^s7~7Y9L6m45>4qrD$dTB3|+c{B8}~
zeG&Fmet;NuCvOB_YaDAV`O2>XZ$1N5gp;)68ub<a{yI$*iO`9`oJ=rgCuuxSB(h{V
zv(POqYWy#L$24B6CE1@55h`QT@uJ^SA|oN}ioR~d*gL(SuF~g!=oHI(+%5){yiLlI
zAco4XavCJP`C5y;sk(L-@O&jH|5oJFuHl3D_({**K_>m*HS@;V_Ir!Wrm<bvLR#ow
zX+*gJaF81c%kkF4YDvm4WttK}DWb=^Mh&~LAmsXUdvn+qM}j3SMvk~*GZs;P$5MhX
z@+|9QpHZN6w2D|2Z-(>SSTg))gcuM|dk@S%cdES;+zMsFoRikQ`dnpvV$mDE(JF|f
z)QJCG!IX$h<<5WP8N1$2Ly__aOnH!@3q|Su?kW}`T6p&41dIHj9MR7R9VPqZs+Jhq
z-fC$+y2C3zF4X*UG3RZryBLRH*1SPw!j?gy+xd+Cw~8fvC=>lonsk1<EBM^`2-5YR
z88t=KWgN4ya2=li5G$jWA$p})t}xU{bo|^T53`L#@^T1{d?X*WxgmX6CY4Uj#Jq;%
zW`lb{rHUep_(j$W7j8a>p23)rq;6+YjZ;x%w>cD6=J=nVrtoD06lf37+80sZSa6^o
zMg=r4yM2Q2jl@Y*wGO{oGP1`jw--2S`$&>XHzmuB$jcUm!Fj%f_sN??`6d4GGIQu)
z^cPCom7j(K8PT!hD;W(4EYB2*+={cSsVmLBsZ=77-yp=-IXdj{Zp_>VV5```1?1X(
zEPY0D#nbnUf$iNfr_hzuO`44%_t!=yakf>P<cv3qrr~bf%Hf}a=}jx-H6uoHbtTnE
zoyY4Cq%iCYRGPUApriOjqXzIIcJF$VhPaVbwt-T&@3!mwQ_F)YMUlaJ#~IZNl6uo{
zBtlQ^K8vr3j<ZJi3P-mWdxVmdgyWWU{35@TKL4eMjOk&B&>k@)^y9dtfm6~*m7?4x
zK7KQ?UlVFLfz21wh7wAr<hjXVXuLe(fec<)$ja92FW}a#R-?u0zX#Oc4yvp6wwOnq
zu$vF}!E@S^AGx9rQhY0`SK@9p8h<U6a+$pq3>9G*!g(3<JKk+>rtEq+$!CuvUtysO
zE!rcKS$5`T*nW*McYJEV6_h7KnQ-BqkEzYyIeq;$Dv^DBJ<5@Tg&W%$Zk<I|e(b89
z6%93*?hZQhy!l=H>D*?SR!Ifbg$Z7V2y%+i4Jm)<4@t5;(vd1zoAow3?BLd-U%~V3
zwP4AEz-G*voqh+l>@(tz2k_2Vc{L?>-{hP#<lftxWc`#d5FElBv5&EWzeS<%I{0)s
zsj9zD9$hb=9q<*Gni{ou1@2bXI}B1RRpe?PQWu4UuMH0ZAr`p#{bnr|pGL2Ixs~fk
z$7vv@pP`MxPcvS#CK&#{(qd;YbK-#|;S^_iEf5L*V6Iy*rjK;cfD6H!p-2IE@%4+8
zqp!-!-}Zk{ZIS1N5qUJl27^+0#6><q4m4gcbI^>T{-m)~SZI6CNutFv^BYOm3f&lW
z-4QdpNyLf|Z|5dm?faWRs5$nrx!G|bgE{3luHKFC0%F@{Hcs}mcYKNC^ZfbL--a^2
zjC@`fL=B)H>^K`f>k081ij_6jEWqWraHcd(W`R=tVY;?5bW%~z4r8xROztH#c{}+j
z&>?m{OZ;nu%=zFSKTIWX{+D7Wl`8)4=Bb$>suh{#GI+T!?eGj5m3kL+`SbRYXI^3Q
zkH{>H(ye@i^l)<9R=PtFIO?4C)RKmx%A?5MRyf%ewF+477Me-0pZ5=*Tw!&QHZ*;8
zv1M8Ek1WKPw+ojWZ8y4*h8*`8WGy_1Vw1C~jGcg|E{Q8tvt1WRd#OqnvdM;A##*L-
zH=P;Ho7@&-8>@8MH0iayO(cxF59Ur{d{qQLcUdFLzdU8RSz^gE*<VbT5P16&a_^%u
zD_g9J*i%#gF`dgP>mkZOB$qr|pQS2?jRRT6*6@`$34ux5ZhWOuJkwWNI-DN+pq5~*
zufY{Enegn~n?{Q-O?m|`c3w!JnEHwxlK)crsRtkY^9w1u`*;{S2>tLyx&r3`N>Jgr
z6jY7dBKpIS_gFNnMQd3{m=PEsu6nZ6sg0ji|AIp}^AwomnT{3siD=YobheL<Wq5?S
z1hc)`U!I>ZC@!$3OsZrmCx5_5W`AsoR_D-yGgTJ%^T=^x&~bkS#qA$YcV*mND3+pb
z5u<&bsdSR+TWokvZfJEzJL~a`Xg7B{?AgumthfX(+fe)d0)^NV3o?C2K(2p<WtSD4
zB&oaeSLTvQ>p`BpBaPrY79&zamsZp9@xPOBB+OHY#w%f;_46QX=c=!8L?98*Vs^n*
zrSq@uXyDFl{~6c9NiPwRiM_9p`yz#Q(5}~-#;uf*rsap*9`~Pe?BaSkE5zK9nLu9u
z>~^31Nr$PM+;O+ed*qlOjcVLHk$1z%sGW$4o8cTaL?x`Xqf(^MD^0#`HH8=-)X;g#
z<Gq)~eegsgqo&W`DcNR}TxS;}>@xn8r`@VA6fCQQpO0xd8L!oi*1D&{JEVySQ9g`o
zykrk^*~il((S)z}T9n8-S7JPveNPZGsx*|?85f<fccba8HDLeaSo_Ebavxm3#SYe(
zgJioI3mxy<HLRY3t3VSMc-I8hi(UNM`?Dt%uqIO>tOF;P&Aq!I&zME#{ig?S2cm8b
zIAn-Y&J^Gna24=2r*k5tf=%|`npWozXR(C^O^KG?m6hE*D>5_CFh`!J{e#aS{VBJr
z@I$hb-=I0+@vI4~fAW~L12%bF8K$OI@Mh_!l|2`8SgD*!@;6yGw2hlG+hqgVKT;m?
zzv<^ceAbx+X2)(Uzx)=NpX-aJx~=Zj&bF{f|Ks7lbF%%f$nD}{&@wQG(?fKE7x&vB
zI1k!;NhmvV+r{6X?x~`Sa(qEyZujMm!o*+dL_(|2BhXM8e>SuE*=2m>owgA(3A{oI
z7p#D7)r&p^w+d+$rO@xH;3LtRrzFh>2Dip95jeUl!dS1%l-_>l@O9zf48c|(LM92|
z=R8T+b@z$gl1-sDmopMXux-T%QpBIk{{mAT-=UC9x<2NKau73)Jt0{V5&n8Wj4igF
z$%pi_$(obk;xuk~fA}rZcDmKiqjp){FUgx0b1t8(lA9zU-;WCUM=kxdmf)0=Kha7h
ziiEDPt1~rpI<^uQ6oxzYmBX{6^QJiza$R_!z`<ik{B$>&6TtZhx&ZzpO5neR36*Fg
zsMLFj{1)0nqRGwZ(fBkY<AF|yP?4bCO-SG2c;}E-n6FcuY~WYpbjK*DqQD~mnlF;W
zHYtNXPW7b)-kk!A6|rIsp*@$Jzha92Qo3Ct4KlyIBFp5|-bqLw=lS8Y!1y+%-zeGA
zd}Q9eAr2fS7SeWi-|@bM%T?y@n0s0vw9<WE>ygq^c!$x*4ShZ$-$kX*;g_Vh82^6o
z)cfUgF!sd8E2%Dxav2W`pX`rK-(Aw{zw^eggO&9!=){z{U!zMG!HFP^sPKv+pKGeH
zM<!C(8~%kKsWmz`(4v9=dYn$jGwk}AJpAYz&X-)nUPR25-72%6tz>BVd$a_vbBjM3
z>nnwmrKG#%P8M4s7e8a5Df|;kA#nr8n{oT$Ay;SrQa$g~rvIGF=~hX=V@_FM@iJlf
zs2XN<TNJ*3SuJX2qaX>p4%Ou6YfxL;3JhXqM=s2l9ZcR03OpOURMU*?yy!h3l<<gz
zlO2=dKpMyl7b(Q-4pOI@vR0NX6Ftk;WKAD55^Uo9n*q5FCCo36<oo@l3-ei>)D+IB
z#*jwK-vOx-g$pH!7qvMXS`*GF*1WOWQrTj`<VV~~B*<TfjqoVXmtl+s4(P+;xvMG5
zy$TK<MXz>#rcuPX6n+>W@niXVWzvNxSK)!SUCPo_o{?+wCA~5^ogA8N(|-iQ`8jzs
zeEr<8{15w(4>Yi0u++)kFy*W3-ISHLPPf&mI{CcKT9~5=98Z<)Y|E#LKOV&zJY#5k
z+}NM7jHH`o_YK>H5;+{Qq|gQF`5nwvs^Eu!v1Ax-Sm&$-%H9Q)O_g<eSd|WYSh;eW
zk`IKZZrw9C)hYb)=kPaOuDcPiPz0zU21x(ItQB0=hx7s%ynk*7d`QfC&JUav>Dqg!
z@8yTA7zIoA{rs13qRugArSnoBhL_Zl3-_vFlSkf)TMR$2y|Ejs<WxI!TQX+qEH_Fr
z)nFkaI4Y8#57b~=;eR`btf>1N%<~(E7m*m=_2)T4^!HeK?9!g|n{6oxYHl*swWE0>
zQW~cOdoq;rquFGkEb=Kz)2V-&q`s0ojQ=Zwy5styMtFDec@|-<=<mE9cwBnx2rYsw
zA0I!Nv+UnG@2YENaz#xYGNNm(_c8w{JFPcKpPd}_Nhl#at3ku>A|F$q^mU~#jVPtr
z_=&+^SxahE3O*C`xwX}jO>Vzq9v=N6^g@~~*RyJ`)!62K;MW`FjMr&uBc>Q`_qnzd
zsL^$=p|pXG=!Q^}l0%iRUT{~&A_e7rlD?Wg1gH1k(^{0GpK~eQwSK4cnHbHljn_;5
zQ4#|IBSqLMi%nd+vl>9>`PhLgG)^G<mZf{%Uxmw7r~I~##7NI8?1?Bb&X|cKy$Q<u
zKNFBz&Z}t4l@>;NybjVC8TlrdoB~fGR%hak)P#GcI}$C2YS_%PM_}|j4Y@VxMGYlm
zq05lwmBRD0(VJ4KzFw}`r4X$vFU}A|O$6`P`H4MPr<#OmJQ@t8E7lrg`meb>R8%R_
z0+zjYu28rf3SK+^NSPz%#rf$_6!Kf2x$+VuNF7{K%~8dczWI$G%;&%><wBV;!D8{^
z`-OoO@+(F+V_AwXyu&f_i$iE;d3*+C)VdN|(toLN=Q+|$JBd7;Vu<_~oOknwsM1`2
zx%0oJ&=nM}Ojt)CTDo^h(H}@CMsf9H^P5nbtR!sH;HPBn9&h&n)8B~DCHXe;55zHc
zsW6x`D5(?ZuofVzNA5{25w`z6Sx6|IaQzf*yk=7DY{INM!PTLM=8A|Bc4S0K+q?U7
z)1iQ3uE1w;2}zo8PljnE?PIy1%kqq_UGmw@R1r6k4ozMX@}c0}F%p}NlII^ZMO7<P
z56fNOn1P}&1>XV{Q+)TIz5%_3uYFjM6Kl>-48mG8hV*itA*Gi>QI-vp-oc7fKDd@s
zq>h$#hzSv#LLRhP;lgu&G@o%-+^gRv{(irEJJjs9YW2!vg$Gag+dw#Ki(VdjBipm}
z_IB}h`ip5EUX=a7jJL{uuM9coURK^&5Vvs#AGqVA#B1B3UJE!@y|mXetR(AVqg^E^
zH=eK=u3Fj&V<wU-wNs_RGjWPZ5Jxi0jxKUb*(;?+(tJt$)mi#Gty$HbYU2E=7NpKl
z9}+<SQ}OH&PU@<3jLJID#;NCUp@M~}>{asdh>!mz<%wVMJCaS{)nylcugMWWzREm>
zNRgbhBN-s~I&xwhJK2<tZ5!W_`7y0c8jiKk(W#p=1cm{uvasKM&j#;>i3Yf@JNQ(I
z9bR(G?Cz*c@x4rdb5L&ME7I1(K_1t!V1k2jY^lI~!PmhSYbIuN+!L*$g=wW#U^AX*
z_AFbhrn2gS(JZViyp(JoUyPut%_EvTP0vMkbEh7ie%6$j!bWLjs`O2bsKIvS_3IkN
z!KGg@1M^%PwsqBkF$l*n@tyo@D4)YCa@6ZWf%Ez;&{PA7f9blKPEl|}`LmOBZ35h{
zVnHvMzvm+(CXCrBH?|ND^DU~cw6`)#czt019jld2zLNPjw4d|2rTd{BC-RR--}>O|
z7}zd{V&9+&9RAC92`oItl^Ey4f=ejKqbv*s9fN4X`so-9bJR>jR)%LEE;OVWUBSxo
z%YFp3%4i8&y3`4L(2Eb_Ct922Y|z9*OzZ7v94ZXf(;t8LD@Wz;Maj4*(HnC;^QX;l
z_NBT7S29ZMbM95kJXfoa_f`Yr{v4|l11}BK#4k^F9{A#hV3YpdM0Ks2+}z<OSc)y=
zU}hl5aoORQgQh({3466vhMM#<FHdU$Vg4BBPr1^)VW^Dh(dILRV|=>Tt(D*1T5;+)
zDa|lHKVJ|VZwix&86=EzeM@RFMds{NPZM9Zn}x#PQ-jrQwHd8lN>%$yt*VSFo;H98
zkB{}pt(Y#t-;Y|A;Mu$akpoP8ijs?Ch55~)h>ZET8jcB$C|;P(251W^cNyiG#Y?i=
z4riC&BdE_Y&c$&<V>F4*7rb?55mgf4v5Q1w#QFzGA-RKHYW%WMx~g&5g(^SPD}y;^
zt<$G3q%eMa(58FD^bbU&)6V+2jI~baC|8WZhR(hM%xMr}rIq)Bq-WSLF7MAB_%f|U
z$~)9v$zE8^w^D_{B+pMCmE@Exjg9R^aA9+KxuSq(#_W7)-SZ|r@w;T6aHQWgpqmv&
zd0}*V8i$W0F>4>VV+;g4ol9OJ{r;NX0?)fOoo@q&4m;@hgsN6h-%(YK2X=UwP))xW
z$`>6GC$Ac(AFB|$oqK;8#|WRU-OAYd3xio-<=5G>E!cZLzL7}*c0alG{A#(0WD&gA
zugBPvYHG8Q)X6u>dNObmwR@~igQ=&F;6xd?IaU_4uScwZr<b!yR|-hnc5~A@-n_eo
zxke1{CRSGdWv+CEqyC)W1D^{EEJNE>d>Q01$qh{k7Bwq6$y%1BalwjL`Q=cp${j-m
zxAHM{S@e9i^B2{5p*MOUyIJ&$l^|4w=ErYRw`JuV*TsHm(bR|T(;gZ*aaHlAMR1um
zG=k)reQV7XMsjn`3a6#7X};uUI1~(U?Q|+$9iWi5IP`uc&ZBDWOxYpjg^VsbmoSX1
z_;%Z?nQfT=u^sEhqW6gLHE6L!*B{VKq_ai+4!rDjc|4zdI1abi<U?z%$5YuF5^~_m
znG3v~TcXBht2h=V&tbG$jkd^&Kktq&Q#}A@6xWzz{rG^AHV%z{N5ExccxYeNx~QLE
zMrmA>eaSAP5PgWhc#5QSWppNvO6d{X(<*R((F5NH4(5s}BBIvrPkKG2aEKqE$zV@+
znKsU7W=yDK-s#54j%NfnoT(N}b@5E?7Nd{ZcCqr72&L2y?~As4Qb8me!&;}>`@`+v
zWjj4Xu~NA$Q_JFKGRplXbXU(41^R9%aP|3c;IoWK#-b?_Ky)?V=N(BE_H5a6ilc9`
zj|>WO2mM6iAYq=eA^f3D7Ca%imp_l=(A-~n6{ci}6*0nQEfrel%5~c3sPfaMnZInj
z(n|aF=O$lNek7tm3ifMh&tc<Fpd30xm15!4H7tU?%wNS(9FA;U$G%8{|6o~}*jrI2
zrbM0PVeLPsBFUJYmLnr%#US=I+N8L_)DVAJzw4oo$<^Y524}jss}Ptc_q1WK%fJou
zBpM9HfnXdgn7(&Ned$~HaCG+gG%y2Ut53TxS&_$-WFqp8eP8(gQo$Z4@~!(@Je=3A
zPwV$Ooxe-+hmC6myZM?ieak{M0eA#2%W?I?%QIWxDI(;^Yq7-lkv{@V6$nWE5IR5d
z=T=FD+Ui#O@QLL0iLm|FQP}n9?}eam9#+O<IJ>bN-2YBpO_R%zF^k&ExzVSk?Hm4K
z#)3f-Svd15N=>c@hrkXPiR3L#lLEhH>wa_@l0-C5S5@^La$&Z%B8ynF-=FX-|C_4%
zyHv{k6lzx#QUC3{>B(o}jzKLM+BMVIV_MfI;L<_-KZA{eudBQ5=9^9FLh*mDUomZU
z27<PmSN7(v9>?!Q&4lW6IJ^nj9sFVy=(JRxy{Que3|-I6Hjw_h#w_7bP``>vG!&ok
z?0NUGhcN#8ldRNa1S{t824lQ2y2fptl*72d9HfL`;2tkvB9fcw0WcA1$WKi0X~rpt
z;qz}M$pe040{j>-lYxfr^U!Mep7w0o7riC;TE%;oG%}W$_G-(psL<u=$+@^m8j67e
zhj?{ET!}@ubMuERKCm;<EIjZWa2K}<tZle=bhB{2iP9Nm#tkZt%hbebE|>`?!XQeN
z+ADw&oRMp^m447&dn9?~Y@=Xp{B;#^gfctEHI%HB`RaJvzTT!+zYo+bJ7sV$`un|)
z%@)+K<)-_&?^u}?vHL2Y*R%z3DaWb{yvH*V23Fj{ADsuSmh{89yq%6m5V4&1Y0KU%
zx6|4U^a<Wfu164Vv)55)QeEyP**{vhE(Ry8Yd9lNErxVSPDC^dRfps&?81sa1^O{}
zG57l+_)&UXHK8kfZd0&(Xc7#fuK2aF$Z>tlTd{WPj<?ilB7Wg6MyG({GdTxLsbU7Z
zcJU?{ak_KZf6ayn950^{r%}xE?EOwkHpV^I43B)Ah$K&EmrdaPCv!ofNKh=1nX)Q4
z%+lhcsiWbBb-To*($JSVg1<8m*ZaZQzi5lQfK>*^YGP`i9z7N6Pl+`XSi)m=Tj(Hh
zOOdt5<z?n_OX(emHa6^==}3unODg)}FE~WkYcW^K<)$?=Ub$G_=)i!L&N#JF+ONIq
zvaRL+tLTREyn&<K{7(f;cc?FmGI!T*>O{fiC3EVDo$`ykO%13vX?=MvQhKn^uFFoZ
zC~IPTtI<&33De=Q+w{rkINGQzU98|xHIl4{RLVd~4&ly=@8?~LI+{@#rWKp11?T`r
zd9aBBtFq~nYd8Ngx2cosx)YYXj+9M#BFXFW&8x;&pWz)TFx<4%X3LP#>wsl!&#sX|
z1)1k{<7!hQ5vNbwCtH#PEEw}CxXH&;w|s2|I<oe8T8f^1?*LYP^CSl|+kLK^^svy_
zF&dIzC4{!lS8T4As21>1*GGyJ&2qk$cjc#Mx-Z>yz<X_CKJdnEL7_^TR$|u$tPT0L
z=vJ|rCxU9Q(H6PM>`!Irnql&`Ou&d?Cy;xzr_i7Jyutlj85=$Qxj=O2q}&49xqX}z
zBAS?8w#PlS+k%T}Okc{RM!zZXZr;>Mf<%_7(9Et&Xrh9`G2gDs;60klnH?#an^uA7
z=+#!~<~sZI^~T%$)vfe~E~BAlWvlaseF6VVmPEm!+@0pfbLN#fbOsNAhHL$mnAXcT
zzxudN+5<{F;P~*z3ovz3$fpViv0WG5-^A43Z7G}8sL(O~Mzbp-b<RGqkzeACCX1`>
z4D-n=v*Zu{mrX;op?-q=DgdG@-|h&~a{;d*9qozX7kWeWN1Ib8+4fo)<l=y@_+9iX
z{pH<tX*!7LkOnM$g;hf3z^>e#5*y=uz;%G;ma>Q^RB+34-Z1MyEV^1jOLBe-Ovo7e
zJeHKA0AOE#Ax1E%8A<I1)|}k5oj$pJCnH>~p|$HWAl^-QaFQ~0LTGGm%IaA+bz-ab
zmhq?N`R!`H29ukXB|=tDorhg?r50`04*1j9qGpAYjW=gB1?XHr6LnaSyFGX6M5ANU
z?!e9BTwwB}_ZW%?<+;Gb{iIT%n?)v;@=VplUgWU2T+cd6NK>pJv-Ee)KbI*$AQbRO
z!jxb*Zd#<TR}~Dn0UNlP<u6(SXc71v28i8KnyKag2T|u84#yYv{Unk|2qFj)B}fR1
z=)FX=h!)X%^cF-}tQx)d-d2>TtM@L5&g#7cVfD6H-Ftq|b3NDl4|be6bC=Kkz0d6K
z%n*8JgX@$N17*VgMA`PX(0+k3_3)nxIp1Sjnk{(}DvadUnoQ6GpCH3It9W?^;rX|E
zA}zY{lx{c4p@G8hTG@lxx2aNvOGgy&xVzz~!WZ7O6RFSL;N%mp);ko!43V4!V(gt|
zsfNh@Zu3dYI<9imnk$#KKr>!Bie=wIK;P!{D)sJd%sa24v#5!CaTW22!uu-`&McCr
zv|UmCd(VnX@sLoyh1^~dsMG9~?Pd>YLi;;y9lctvsETyGd3%cr-tsB}0^N`upMG6%
zR?zlJ*?vYOfzf0$cZwG~dx{0K$AGii7_I2!yn;6zl(Iw-_III<T>O&%JG1z&4ddj~
z@gF4kg2fB^k6tYfd=Q_<h_&q?Os3K?b6A7r6Q-z@>s+x6q_Y0DC+TNut18`D4@oYP
zl!l(Y&}`kuqmxKZ5d}wQA?sQPb&#;^_fxY}Ku^Z;wW$&<qW&3oted4y)`EhoQd0dW
zv;$MtO{=v9CFM9S>p6qY)lod?FhMFyv&Ei%D~biW^Gv5-++`YlwQ}bvN^v|ql7Z@u
zm6^dw8R{3Fh94YMRD|+4#hji6AeQHA!AzloA=2R?qLXjdhW4~6?yeha1WbuvK`ev!
z^??D>fnH6<U+1(*s4%)XBZ6TDowDX@|0q%T_J40cfnc64p>aN~K<UnxqsaXO_pj`B
zU{cDn?x`K{JcWO=rqkIXJFo)j$v7VEG+=rn)o(`qO`T9Y!ZIS03vgiO@wn8(sZKbr
z<fz_|rW7zPnr3BgtwVX2_)n4Tcq9ci!|QJjhn?`ePX<U%O)rTZ7*myLLU6IbYal9<
zp<k&1Lc&+`j-P;JD9bWe!ndBzppQ5rv`9d`8C87Z*sehR>L8m;6r7*|CC2&e7c&s&
zu#$1Eap!+&8+)=U^_dMt1p62DXafr``0DqDj69L6eH1BG%^Avr!sZ-(icfG28w;$y
zIcE)Ay>XXJ<Zb|$?|ZtRol(l~4cYvwN4azrxLNWRF1&N(Y-^4*YpJV6nI^i8+0Zxa
z9}Q?@NEVo#_2>WR27Ik$sN|8?mfwYUV5H6<QdX6w3#LfU$`6V^cTW^|&To;6joVsL
zuVoA`-2X%~a?#SRGAd`k_oo%}e*5fx5K}Pj0cL8DnRb+JzgJLq`k9%T*=K7HCR<aX
ztKIdKO{Wt+VIC;bDp$L8W#^F!rfJ>0U0X9xV*$;XFu8ZJZzbO%K1M$>A*>k6f%&sk
z)`;T1F39IJc1BvQSbxG*#Wc}+Fb*kSv2dKB2q@O_B2zl_4_EoO;G~|J6nh)+#9B?+
zbiyvSyyYy97J~ASl08@nqTaLU#siAv#Gh_xKWKE*BYKruh(<oj9ws+X!CW0~F9?^`
zt(u2sC@-L|+;Z=lAqV&1i6_h{?Tv2my!)neBf_QVr)IBD_uyuJ^x@Ba_u*4RiB*=i
z6T+qSrB1fg3+Rw+mFK&Q)h<UG;*IbPLW3r|XO1<0UURQI(kc*IH^NJMI^LVJkiwRn
zF+##0p3v2~V}zPN5z{<h5>`ZxQxF}d&M%-l32D5>)kF{JXg3cggm2N9EqJ1|(8css
z#uhw-^LlnGRvpu1x}Cg}%v0BZI=@b?OwF5YT|d4r!Dgg!PI1x!@k!PyW^k2aqZ}fP
zfvVBvyTRSaV>GOtL70_e>z(1UP~@1c^|_WDm~ra$0R)oU(tzS7DeZ1@Ft!v|id&C?
z)`N&QmN+k@0Ou^~jMyD__F$i?IYOA^)i6Rz4*tnW$Akm^C6Csl;<vq;8&JVMQkV_6
zx;ykoo|6>Ygz&rMj%eNUJvfTgC&tO%zramz@%k-Y$)nr`RDG@zaR;!)@RHWCp%G<v
zzhL0W%^qC+er2eUJ*FArW0As?w!!IBe@OQQ_P1{Ld}j@|BHf8@o2Wg8cuIWay$On9
zr63$lLx=eny1^kof^4tr_F#WdR$A3_MQ(7EU|xYH2oYEGjLG?G1FBjS<`4$}Ffqx>
zQUPhtYYB-pa7J!R{B*LH{P>@LQQ0M1B2Xlx%PX4x3{38LUbO=k^=xiLofx0`qrg6#
zj7n1Wm)~InmE=l_LUcZf>;7NZ3-xTlG&LAc2YX=0wjWLuISn9ly~Xfr&}S%8wx#o$
zrN~V$)|)}`UrB6qORsPu_C-*XjeC@etD0E8n;yFeH{-$rI;LntS#N1{9ibo8KChZw
z*?=PV-g#sGOC2KwRo=}MYCw_j@AjNhETF?&Q|uO~7SQ9=uR_AjFhX|YS@Xh0J8<=`
zfq%UbZG~=nV+^G_ruWsrkPkmGMG(v1GBwe==;c}WbU;xH-fPt+kl1COfri-$VbMyP
z6sawckO21ZKf;BeL|i15SGz$VJazl3FB3s%9(^+!X<Hxwztvg%q^Sv~!?XXrDb;fW
zr7LAYLNEZ*mSAxlJyi?58PgnlD~)Ng|N5&K{v8mu!u%#;!L4WyHf!;nAyJ*%R3zhm
z)9MC1@0atM<B~EI+0V+w?&fi{AnfJ(O8+We8Y7f}-}P^M2kz|B0z%JPU14kj0^E$Q
zBHQ1Ct>E3Ym5e*Bn!(+bWm?l)K<kJ$^1`HljSDMMrfnKE?wvEDF4k?nevnRpm^~~W
zBjw(WPA2~nyKsG=>~(r0LCs*cYMw!0AhkImjO4WV<U4Ba{9lfSc>?_!P_V^Jlo_k|
z0=mjmu;GhHi5r}kF<zAylmTpiXPymH)rhhXbHeB71K{T1AHA3b(Lr8P8&p~70|PYK
zdvkz^pAvc=cHF*3W$(cTO9#ueBKKe|vSQMEGs64!pFn7i#1c(={sA@7Pbp-|05ho-
zp}1CQ?bPhs4j!^hxjI9U%I!ZY7(I0;DWQ_GhW1ArnVJ+sJad1T^7ml9iKE*<f?#9x
z)j(=u1aqTJ;|m&4sIW`EbyAS}=X9`>Jf|<1D+JzW%KtL+oCh-5+K4jAta(ubwm0oq
zYsY1}#5bT!P_xaJ8D=(WZ;OE&UN^2#<aTe3TrBj<0@__r*~>^<3D6?Rq2d7CKKCb+
z$N&M+vkPi+DRaU!H9ez{)AZW{^H1);$<Jpd={{lFL+*kKn~hBTq_gko^63ZP%E^00
z+}UNX+J|?}FQ3j5^k3k4X>4o-+&&Ox-gs$t>8|1F4Wiy4md<DP=s$SI-I5o`L1>O9
zSgqkC&w<nt{ni!$)tj1xSCz#A>|r1?iQV0U!Ksx$cuazd)AQ8SA`e>-en;sZ%xUk8
zENTd;{FzbB{K4#-{sJ0R3d(21X4GYJ989lgRMamHwienwUTFmyTk(><assG3?~n8G
zxyD=rfo!&l1}BV=BJY>uRDMMwF}sFLY4!i+DSTW|I6QrQaC9wRwCpWnnf^SY?n9Ba
zRK~b)sin^|&=eFI!^j3Az5<EkHc;(c1!|#|{|Ml4PEyX;IJxO2KkeNe&2ZUA-V5tk
za8Scsg-llg7z#=5J&pv>sJ=<^r}V%yS*{pT0AN&y2YI3vWIN-zRjJXzB35V~{8=_N
z?xh8E6U@}$*GeNwwKm2m7_#+i50>7R^#OD(WaR?eYdJy09!#r*p1pLi5y0{%6ARY^
z%s%69;TLaZhG|+^oJ#R2Z$y!3Hvba@Vm_g}F4RX?(J&01n)zP@(C=364Soy;EoCT)
zUuf-W3y$KANS*`H8dZRrMyp|(vNEQ)n>!YS6`Q7%cuI>xHK^-C-38sDNUz^B!lkXa
z0S%RIdZQCI0|+E|O2sd$FXEk`r=}2AV1}4~A4OPb>ley_!VMvjepavu3K$YLix0`m
z+JnJ3#<FL@2D?}blP%Dq(Q$3a7mYk&3upmhZ>~4an5$)PceHxTL`>B2I?#u@Z8(FL
zl?+e}2P7#y7lH_=%u3CUwG=m~%BEAYqiT>#D;fKSg!|eH=z(O+<^mwc^tra_WiPM@
z@s-(`@?&xf-z-Y-akje(<t{pX^z414*0aED)>sA<Xz+VOS5p;B;?RL_83ZtOX3$n<
z%G1^d%E0`VL7mGJptY&*N|0O01Iob1dgCh3jiJa&rd6D8jiBT-XAFvj8>>KtZ@uSW
zJlNZVIY!Zhj#HC2hnHwQb3#(L0{30*BcT(_Wo~fu`>UNHjesAbcV^uCd*BSSUm&>{
z^jRzO9oy4|ZXhQm@GTP^%+-K+%<>r+Am?x@CihNt0iBX4vN`1}+GHui#(fFsl;Md8
zC@<Su85b5ctEu7kmRdkN^cjOY)9NufuoiDla3uGr3EkO6J2U|L)psZ0Iu*cLS)T)`
zc=fE@M}x75W@a@kCnValeSHp*3yRz$h`hN-Enxv2C~-zF>iH?5FUVZ55k<Mz02Eqv
zAq(KXKNwvDG3*Bl^;9k^$u8k1lW`T2_izokJs903S{nPG16GP#GoaU1;?R^l76)iW
zR9hYLgAseBj9GTay+tMY7PN8F|B3Y39q40_Etv#XJrt<!-uBn0LSSV#^=*<|9l)5v
z<*`;XeScb5vDYwHX0AFIOoq40Mv+bdxZz3BWfYkQ%MaMt_LhMTkV!tf<C)-Gz<Y_V
zKc$aZe9G|VSialM*$G&i=vV#G{-*ce)H+11jr!_9{kCb_y@5-WcB}uyv;dI=bHS<^
zpd)Lpsy7aG12A?wdnywFqE-n`Jr(i)xmaDSO8#$-X%I(RkKkD8Po14kdYypQIIw(l
zoE|igH=123>Xo2w9q4$9fWq;<;)Pi^x_J(j7CVz<H=tC1@z|%FXahIo5p@39Zt(ow
z)s&|C1{AbEHiZGOPea(!8)>U*nRGRe+=B%+0%xivB$)wSmS63|-MT`-;!Ui%_c;ho
zle6wMKlq0!MJ>-7AO&Udk)?$E9Z=7NawB1N!NJ0p`Tnze5idck!p1%0vlZds5n|!q
z*sdxC{AsFU>RO8jLbyScAyY2S$jTQu^?zCl$H#@idDphd>~~;d*pW(T(jCC2B6SzF
zH7hO%#05;b7_5n>5XV|u#=FXxtC-f^Jp*G*lOx?PHPFbpQ$6<TO224t6n-)K-(_|y
zyh(s#T)1^9yCf*R0X3zaNPYtLyJ%-~@ZW-aAwZl()xg?{8UmJJ)RzF!NL|Nd!P-?S
z50wIIioAmEcodjQ2*#P!2pS+ir87Yl_+4OQH}hT9liv2dKqG3(!=h1Kasj>VbTYB_
zWg?Z=b|u7zqw1`#w$bgTZVmj1dbISfTd~(?*e(sN3;J4zE?9tY@_k%@B9X53T2uhm
zmJ+MIY2Y;`343AvQvq0P`iT6lHv)?~)vZLs4<MOt!vQX`U^Neow8&|2csdmq__0$0
zpZzo%rovp)#Ggv)nnn>wXJ76{1ER>OIlJ!l8N{xPaiQUS0%(c$FqZ}fq$#~16T;C7
z8e*%~?30f`ZEDLyclP$+8M6xHRY0*U$BF0Gb-}KO?z;suTW|);7zWX%%<v%`V(9;>
z$z`uJ=E^g2@V#qsgG2Mlc<B~=NuRIL8k|9BM1mz2V)4JAx;i68Pr;&!y0PwZIg%2y
zkuBo7>hCnOb+Tj98}$^51h@(1?ZR1e_s(I3YqEQL=TNMR5#iQ7*(HyZEx3NI)c_L%
z6uF;Tmm6B{c4KD?cChRJKS;f@+*;_2XO#Y4u=_6#J1afSvuG}}={n~80(njTAspo`
z?lr?p=inlQqNTx{c^6rPRzJtPG=`TlF7rL}NeTwnnEKuOdME<#IFgC`A#`|h<CQXC
zogedHj=1&bk0hFQMJ}2jKhr27*ZvVs+*c+7#ZI0$-^1J<k`jELgQ3&?vLv|3`grb*
zPY@0&eQTA^@eWES<h?cte3qa7>^@Bp?OzX%7psha)v!Xk`UjdEef94Kqz3zHiO!Zv
z3e^n9M0uNkq)~GkduFXkLe(bU`H#zP9IbN6ZFtXV_soBT|HDdNIYk=#yR0&$ml<|9
zTE9NH+WSj?B!<Q2V>YI-Gqa06-M3v(+Umr-j~6z@J;dEbvEcY8YF1MvS@ZhMvKVl`
zQX}x;;aW~7$$ig$C1tD5*3#XQcIorF{mrrA<^}cq+?{~yw-hHy;cnU^Je(t41bpCX
zBH46U^{Nn!9>-t)+jIM&o3!f9^xgoUjzM&AMS#%0df!eE>iSFD2~vMQoig<|w_C@8
zhkIk*MWZ<ZDZXX4)gqm?F_~sl>$+!^ztMu_b5Gq}$lm^C*Mf(r9oa^Z(Ot7hlU27b
zPSV9#FGb5wV+bgX{?X&dB+S#>+<v(5Svu-mtrg-wFfUop&s_8(Ws>C!r8#vo?1{Em
z_5M^#M!obvD0}bbyqN$7U9D|$UCDj^Hohf;I*qkS37298`f-oQD>jZH;-R<DVbN(!
z?rVj|nViKGuNBTEKVV7Ug+6IrwvD;z+}$@keq(nT=vwMW>6;bnf0^ht!qzR&v}~KQ
z)kdc%kzA*lV0S=IV=&96=fm6U<i$*3>Z;+=CX}0T=0Qj4IsYxPgN~ekw>9)gZ5dB4
z?NV5JwHNQ_M34JWYQUAJXAVF1%3nrDnJR(Lh&O|e7hmtn8DqC_F&tRs)Y<L6whPPB
z<9pGUV=<T$;y&gVof))#*B_ly`I*mswCVxun2DGh4zu*Pp&uNb^d)56!Z{c_E)XRD
z;BR_2@Q1>Sja;rxJlFh`d-+7XztmoETibeUtHdcnv(kz*^7g`-!wW3r?R|er%n})J
zTh8im?3ip0`OrT#pT(g{VS_SMK{5{Iv2JDN7Yk}wg?_5V)Cp7O;CpP^xrIh9{`+ud
zDDnX1zmL~2Rgi2ou44SR#`WzQ!=l6ATHltKtc(U8l_Un8);@OC(G|K=lijbc{NU+?
zm;rw`HaW}Ag3{>U38t*3mioH+Gh7#^A-a~N$QQ>hlIbrMAMIJCxC&(_tDy?2e=VSg
zb2j&1xTUvJ6eOR!9aCNxpmm2Mex&w%$cTogTxBlfTFPC#s~fwref}HcR&6s+V(q`$
zp>}e1n5fuP*`(w(BlLYHE^$5-d@*mjzI{C6@#%P%wb59+uQAynm-XkBsfuVc89Gcg
zN?sZ~-NqkYqY*eIIi5CB;WVirvW;g>=PPWnOPeiT6-}poCz$^8{lkCDP7~+<qKIdH
z^AFOk3s_5zjlz1Q@F{k((bL04VQwSr-B9>w5%Hw{9Rd>-%lXde`&G8MAKfjJF*Bzl
za$NHgj?~9c2gr`b!u<Rk2?lR4?WQe{*y&m}Kq8L#@ZD^tJghJEM;YA`fxY0P>h1Pf
ze0My19FM+CjbWLNcgUc1x%zH<bp%n;V26aZxy&<sE~?C9MsH5Ole$R~_j|Ie9pmes
zZ#Y?3BnFYjgYTS4Pn2a`n^6+=Pu%=<hb18TGN^z*Q5EDnuX3n)kB{rWEfgx?dlE#X
z!Xo51#yBE3@RMJx)iJzvz(=opHi~-P5bfAMDA8nDE}Oc!AP8&uFsA%2Z&KuY-dZGz
zZ+oRJJ>I7Z;>vT;As}!#*C()quGwp86*X2^|E3YcLCL}3kW2iauUuVI*_CD>-Aj%*
z{-rDiTmH#re$NX#*QS2ahbQ+w9nX!gA4LYINc04HrSaQkDHhmYcE2(*v+iutK8oaI
zi27PH(S6>XjJ7XPLUAT|$qCUvfkSWX)|ppvizSCdhf=CYw>m^UZ(Q-S{>7G35Zr3)
zD_wA}bsj~YOs-$Z2fw-1&<D?%Yxr`*KGi|o6=T#dI=K~2n8&+dhE1>L>ZqyQFS_3H
z>ifk(WOb;u7JI)aeF$sgh26~|OvL8)j89QP-9yw2j5)7DeXbC=O~O2~w7h8S7ri-I
zoU!~w+WNQqKZUz$BwZCA5{2(4j~(9wX3i)09X>@-iyp4FyqjObV6|Qwb<lX`O*ve4
z(_??Huu3{IIPdNpWM0`%_qys#7qY91WuS7tIlO8deLEzow@*%WQ+~_3Pffja8K?fT
zb!~!3|K<>b7C#T*ZC42n^m1RZjXCn}_NM*QA)5R8;qq);XTPXt{BWB?@SE#^R+$TI
zs^xum{9Bh6vtP}BuU6IZR;QNnyv9@*s9>~PsDsE|dNDh*g&%XG^own84*0KD8TM@c
zg=g^2E!TPp-P***dt7#-g-ufVZqMY!Jw-*89kQ~DYtQ(vj6O-l<{Mo$9)Wks6Fs$W
z$`9t<bnC8+dKcI|D%Yrq!eOrV{h|pHX0HDZBGGBlweGg(-4aGp#ii)TUz*eJ?asQ#
z#hpHN9Otf4E1R8sNl=IfY{+?zt?J&ebL)TdfVCe*76?|#APNY;h_T5p{l}__URSzU
zw~X`dM`s6-C&!M}RmUzyy7Y_xLckZIBTp7hbkMaRvFcfr8>?4F#UC@^n4`#g&zaZS
z7Zf+_>T@ct>A=J+UzXk>(RC3+!?|Or1TTaxbv=@-8f<rpnH%3bibU~46mQQOyIPPY
zl-pne)OktRBZ1p9bv)aCweA0}HntQ@??=bfpl9ca1n%eESN+A?`24p?+x+c+8uzYN
zgCR`YS4J!J!xyJ{ARyA*M{$F|np&)gC4h28v=P38S)$hfT50Bd=gJ6P?j0RUjiT<C
zQqaYmpGLwIcJ(RHX?>#W$u**5dB5HQ<gy&vu9m5Z2q=g)uZ$L1I6YUwe0xRL<*UFm
z?TZ(urv?YVit6#I+?2!Z8Mgpx*MD*-I!_}{Jk@2DO<6z%#F9`i+?2Nn=|cNd&bxIO
zPN)E1YTT!6bkRqV)mZG|Z%Q|*9a^6~wg&~&_|i3l{NZ`Gz~f)PEFScTg0;KU9Z(DE
z8CJu7f>*1sh+hurUha#rbD}q%UN?_#$wpiiTKyMDM<OH0t-aD+-tU{V9EI&I@u?98
z-Z2*|$SGD6r)KPzebHBFjki3*#l?~g`IG-J#ZKvw!(Cn(g`@HW&G*6Zui}JmOkrU^
zIclHWBp?t*QeHoKh#rQ#z@J2i9x6U9R3|om8DbRp%;1kTgfsR%){8LH`;0|{%p6Ny
z{ApoKsqb*fJIF+?bfwhg1fk8{A8wP%5A5T+OF8MbPDW#Cyq}u+nk6K;J<w`bCDs-5
z!zI%7CkR`w(D!9b_~q-qjq?F2jxG4?c*y+6<iJ9}7p=?s8`{}=rS!YwH{4tb7AFFA
z(JzvucOwpZf0`i;acuuGavR-oo#J}<(23?=xSoR`+UaMVwl7YeHxtuy;*WN=><O~_
z-ZrH_EMElP%1|6J`=c2*{Bg`1|LWfl&Hk)B8mDxc*t^iF!6~V3x_)2Z!S0Km?{M&I
z;?<BRpFfe!_VoOz?UG?z{%uZ{k~q-TTsS%V{Mn&ckipe%j_%G+#Y?Wbzw6K9gLCs`
z9Pz%rBukN@h{oy?5bV#(ObJeTA|8L|1)b7UP2mu;S6`@0h`Oin8&Nd4#jn0yel@xH
zs?NAXmxyri<zW}B*w$tfMYi}``yMD9ujN0gsl_UilEpAp_ic(>AN1P=)#dsRA}M#s
zH{|8eth2X_)Qiq@S|y@5A*Lu&PNlEBIJ0P}N#TszEV=x*v?p&fuuI59I+nHZug_^S
zh#jOG?N-8f2nFw<Zc2#=zA?TCDR!ffD?w=8sUIA`MOFtT*FHIUn*R3f@o=<nDo$(g
z)lhjfAI`CRQ|wO>n+s3nFc%K3!t51c>->BT<a<>oO4*AUi{iSegTG&<(&cu{Uc`{m
z%QCJ#<Q&jtUl^cCjeGs|WaF!}VM}M6J^3v6G-G^B(d?4VpKOSmT0!M}sTlK9_Gr&$
zY@Fxh1d2OEtF>R@F)L?Dv4n3RGdzNC#eRq3n|-mGoo3n_QK*R@ndIbY!5ktJuP26L
zD{$ldQA623X6|F}^&Y;Cq{G!Ua1piR`sDp1vwR0(wrG?#=XdYZPyW;2+Ws~w0tOAf
zSa!c)r@M|HN}{Rnx=L-E_#`Xx%mj%X!MtdL7Y?7;U&+t(V0daHF|6H8GB{p@JojEp
zl&y`~%D8v;3G@)nRsEbZwJ*x##pb14jX2)E6KZ#dg)PDN^~HzVucosS1ZbR_DMZRI
zyg`OBH!I_t9t*k0gn>zKXgK93*H1iENyPuwmzH_1lRB}X*fJhEc^423SVqFswvzg?
zBts{#6pb<^q?Ox8`8EQBW6+;XWG)Tc!7aysb~ZB<b63dM1$Fm|U9uM5qt3SwlzWnb
zJcA9X{fmvKe?fR%mPX;Jp+JSoH%xmxyiz5yl);>_?t>+{_cokS>D{3p*Ov-?nn9xb
zU9V;|>5=4gYkF}JT7~UY;j)um@8MSKaZlIG-UxGxnRN>==RHgakk!I!?n|`nH<a3b
z$St?F^HNiRl!~4Ei`hQ;cKg8Ga!Pi1Rw~w6hy61FmOR5n2YxTSPokVB*~1~vrTTt{
z(54h@(!P+$WyUiX*4|Gf`o-JbVfdM{b!{vEfqz`f)7X@R*d19-g;U<PVafi-W|bpS
z?SBZSw1f{BvHYR*jPin_ffoD*Q3mM=MC-PFQXgd0Qezf*eoRjNDbKRD#8oNN9kai%
zP`W<HQlwkwv$M5mUPd`Qa~<@bi=J(bOolTqJ)>@~{dShU9ohrA-@o$#+iC=3<Wy;c
z^Y$ZC&x1Oxzx>`dl0%ssExshSWCd+=0eB^2FG@8|ERw5nxfEt)iQ4i*euVY7Qy|4<
z$~<0~>_j0crB2Y(37W)&FYG=>)AT=~xaUp~)A<U^Rl^iFJz?fgiS4b`bg!v=U(4jb
zNU`9E<*|!|Fg42|-nNVO6NNE*E-x&MZ-;%ro~txvF8>Pk;>EopXvs6#JmciwX%v!H
zDbv@(GC$ear2L(Q-{cg&Qe<`f#+;g^QgJGtVi2OFZ&sY`G&5DG)S<iKBh0i+l`zwl
z{@}E8@Y-np%%Yd&%A$ASj8S^&yV*IVqR*mu`l)_oYtuo7t)tg(U9ppp{dhjR67BBZ
zwOP`$-&#gtkzun8vCaKUVwL-|s&&P7v*r)d$%L@Jf9i|lak_csF%mE(8!F48yV7c9
zT-LA-d*~(7gL=_B#ObgX=l_rI_X4+cYPrg%tzj6)KlKNnUla27-r=7!AWBfnRsTX%
z6hb8u_IU<3C^gRUMj*OgR6+C+VOsl3tCcuHg2h$W2Qv7_$B-=f-l1$f+*c$ym}CFt
zh7iZ*UTg~MMdI(5C~yZze3f;9H-6t}Jlg1f>1U51MpirPHi$2eS)?s00(!sdSZO6V
z8OUYPNTrE&ycOJwdH&uHfo(}=j-t@Yct+tXO7cJqiu2`;VzB#4tue-h*2|bl|2svs
z2}zDn5z8}akBFv4j!_K5Asa;KKr%@*HrOX{`ID??XIa(P2l8semM0Nit5WO6|KQaX
zrbr1GkFbfU;f8GcdGc(Xk%&8qO$D2@D-V6kc9LCK=nRqhG43xq@yiIQWe(w&&z{T4
z+lt~>j=n?$o4{jy>IL#l%7-^+jG_1H^gAlcy<#Gm$Yu<)NS@=bmonwvDVZ(2kcdiu
z^Tl!lK{8y$6Y*7!t-hX$bj!xVBKcPEgyLR|QvCkU=#Fo2fqmB;UIHtYoK5|&VMOMf
zKUOsQ;17Q*{u9FOX}F8dkxS-`s>}4?8}QYtcu}5<-N39UY_xhCV0*3G!kRJXNMg!;
zbx_ZHb5L(96a%B{Ypn52%DNJFREmpq-!AvCdFp}MbnrzavlDjm4D)w#nlrg*a|X5X
z{23U=qjV&)Ov`(jWA><LknFjH*jjJZM5%$LybvGS*ib@R2hK-#Pav6I8p3kt)1xZL
z7>b96FCl&WXy;wM$DaR|@vLZ8`OxhPAu6Y*msQ|vCX!G$;xcSW4_s54F3rjWr*HQ%
zZ#x?}p5VTHB@~Zbh#EZI7(*@AVd9qD53wSH1mbTxq`f*6Gj34l=g$YdRfF*RQ7<2N
zzl{DH2+eC<#*p&4mv#mlEy(o^I~%GfDyiY`x6%CWBOps0D|$x}!EO~~WhhVm#`<CZ
zz2?jaw(X|t%=m3-E~$K`onf*@lRsD7%!_feVdFgG0evqyj2fM<g%7-|NTe04w*vjX
zVHJAO#FrLM(<{POD2<Wd&C!mMqrzJ?x^F8}8sug07N>E1^op^2C@#a&%QYi;Cv6;U
zl@qH%SJ~@w|GM{uNalSi7&z0$A{q~7?aeg%c4g-y)PlL*K0haC(K0(GXR$ZKaEGY0
z1!`ZQZCtK`SYZ@z^z!*E#W{W2!(?@8_C93Bb%YuITo4@E`10FtI9ZH+H}pdBXk0&Y
zpjmcZkNBK6In8SnqU7!)M3Ww@n2s}Q&aN<Qw2y9@DYp%BG0K>!M<|=$s?;iWF0PRq
zv<1n!j{IFuUi_Q?(N`#2_Jf(@<M{7~SKLj=aVc#@Q{o>K%XVF^ZKe#Yy#ePx%rDYw
z&EhzS^CCx{AQ+QziINK$2N8Fo;KfHppVP2&b1cSm@ksQ;a}IK}!e;4+XYNWyC`B)H
z^?F!nr5VM=nT0)l?vP-HOB+_dN^Z<Ta2&>JeZ{xDl&!FYJQP@_(Rsz<YHkv^-+G0@
zl0NozrdT84SJ3peoA4D8YC2Krj`K5x43bf5IO8}VLfjH^5VE%F?;!mS-igm4i*1^m
z(ARZ@TUFP)LU|;mHQ9axcrmrvzXXse*H{kh<}tPwD8HV%NTR!fyR(Gkmv^RJDJ&!c
zzGodUT|~w*5+mQ=RqrAc^u!Y!<na<FHwZ#r?f*_H!n|UCV?%E2)KpToV;Lp5Y!%Hv
zWU;^zx5eqqVZQ<CTI}p<pM!s#&iW{KPghWV%I~7$Labq2G={aHYE!Tc)7Q^iWfD17
z%L{pSIK}?Bbu>=$A4YKGP5p6Lxai6T)lvn9hTS&V9c~<XiM|N1-Tv#<ghRpYOi!=*
zXTz`>d(W_%p`~J8qF;42dX0xz3KgHQCQ>=yIT#xETu0MJ9D4?DJz1Uj*?KX{M7$Zo
z%%mPK@@G@bepSVMK*hHr#5{fFeB}jGzjQ<8JfiiE+1gP+(wbVheWXX%gSc8#76~0>
zUFCeCI*tWw|8goBYB%Pro-p@0r$*e}xL)b%F_X0xi(tR?+eh89DN9+*wV59adVRiY
z+6dNohYfSmW-;@Q*q!irsDtA^ApO9o9D!iwt!UzeQtUJHDm4bq&c$cYTN+v*&SnPe
zUwYcnsvMtXv=4G=+tpnYJ6QG(|IawK7G&69pZ%(3mN$o-?U&L|j$y8Y`OUzEEIYvy
za#>wXn+};jF?pp$%(aCd4RIirNaorCmoWDy5X)9D$|%2+54bn<M7_cEpDN5M>G7@4
zwbQ?r^Cw~L=5%ST5lOooMpuyja3%h~>xG<(WndpOKa$a_=fLdZkLg{o+4wb{xDL8g
zra|V~<&>wKt5$vXb7-s*_Y}1N5Pj?rhpIqG|Dfxad2bRAgM>Ntj73eG$P0}vZ^6jR
zM)#C>hqv-w2SMVs)OF}OMR$|>V7<b<mdg1ilMPF<3LCYA)Vkl+T^Vs}lj(9}8Je0l
zi%VRFDdl<KuoQ2^_!T$vn0Za!H&=-Y_Ok>NUM5jt`s|fk{;@Te#jmMN7!C9rsw}3&
z6s@~JBlliRH(eE;SoKJ_Wm`34qe?OhSt8V^G;Kbc`WiGVZUZW^dRY&T?c>%?^D%V<
z^P4sMmx9iV2`wwJ$n@@B-o_eX_iZd^&z|5?W?r00vFK9O|Mp4Z6?FDAsfS`qHx~=r
z8{7@wa&N4h4~RK<BU&-vw6xBO;Qo&c6{QG1VI7ltMw)}VO~LNuwOpZcQV4`}keRnG
z*#O>qqYtxk@;Mf1UKZ?^e{7m(BIFhBsHEiI0UUam(!Hc!<6&CQ$hpfEaqbB{y^g|j
z(<*`V7Z++g=}Er94A@sb93B@>IiUf=?Md;~Bb*ab-%bMd*U8HnYU%nt($dn`L`LQa
z&OL{mya+BO+xgy1>N9w1Dd6jC+MEc*jYa|_8))6YehJD0J8aFB^AchXpA+(?X9)c@
z??1|Sk6`9yVYr&(oGbe8kFzn(+5fQ8k=8kJ28M*7mDJz-teCGz<5L}2E6zw5>$C5-
zZ|8~wC$BkT0u}RdzVwvN!Yc#z$_Xj9N~Urkb~1}89Ru`C{ql?+!82WE^}p^~5^%<V
z=vwD=mUFW9%R7!!t+Qxr+GvSa`@e~dU&|dNLJt@sm}{AHoOB_$!j<z&EQO+8e<7*Y
zRaJ`zXnqgG{6L>Q8k1`<7WVLMzdW(8V=hB3u$NP=)Wx_y*a&AEA*upg)ZBHT26WZ-
zJt^bh)BuR4ew&=E7>HX-2)kp|)eZ7wvNP&u;a$vJn=|?ux;SL7?1LBEIDZ~rE5cF<
zXp?yn>mGDD6)kpAjt~Ty84(|t66%2T%Uc_qRZPdN<+fN<+J7~xA6d&>sX|7t<(jC)
zFvU3~r1B)e?CknL;ahkoJ8CIi#jho({yElbs+@0G-5Ii{zW%1z|804Z!|g9b@Ve?B
z&rR7s3eTPq-g#}$8yV+>%d388r}c>%M~}~?b^Z2kS3~wzyV1_WFF+1FLipunK>5#4
z5E|;0+nUzH9`0D4!n}YrgAsNln-0eHu!vFa=KlX8sZ@DX3s9TOGWger>aib-D2sfg
z%mnFYDfRQ6)m^;U>;Q2Vf@^tQ31lYOuC)L=b-&WOPx=C-+UE_hmS0i_iMhjgBIKd}
zAJ(G-5%tWq$6OlDq9Ajd%3q^BbpV6+XvR)K-F_+?;5R-T0&lAgZUPu$!t3K0qtz3%
zMfM(TMz4vyIr0|ly=h~YIlBl*HP-TSHmzT)jhs%X?q#lZBr!Yt10vo$Sz2Zo#Mv*;
zqG6=M&;~#^GhCS+*aG}qTUI2R&6(5}guCU-#xVA?AajfM?9A#5MwH6fFdpC^w}UMf
zoDLwH7Y|ccVg+qIw4OUBXv6VHCJ(o}7*FjM2|z-YkNF@Bd(6De&$LsxpotapRp|pd
zebNAz=Ru;QAV{29s-+{7x{)bvVYJ>nT@fwLTl~b5k(!cjX7!BQQi!!4`+kvcNfv)A
z<{4bg>Itrv4vJg*r*<8riTB+P>q&2p>v=&}8f#2&n%CUh)UI7~0JI-+vHVB}h5Bt-
zYci~2UdX$q0>ar;G2baK7(wo#o{-8grecydV**5mqj#O$18gAby{&mIv0ur_KH!Q>
zuNCpw6YL+1orxk8_6k?|AY&x;AAv|~CyC@*SCe{};aG?~NE@=q0v=zinlP6w>b~bs
zErLmXw|6MmVSlk<d)AS6Yv<V_>7bTyc`gN^E%|8s=WnsT9p(Y=Ud23BYvue^k;$3`
z$XG>Iv_pqkz1i(<6#~3m{48IT_z|{k#${?!Z`NJ4HGfsQ>=n-A1!CQlsnZ^}1Hk0t
zxaeDVW9w%rpfFqO1_gQ(#|oJ@sb6~&AD4&u$y{smja9btzq~PqLydsPE}>&xfSNy9
zSVcp7%$VRs%{?qH_^ZIB%bVS+tFY$_ntPmD|AzM5h#w2}*L~YRBiFS*>$4|fVMOR;
zRm>lemLv~?Hd3`YkZn_x5U6S6O6l>I6=>R#<d>QF5&#kIFhycR;X=|{uBdO^Q6C#e
ze>mrZhs))bET#!=7ZL{P;wJUvx(%Q8M6DUui!(-kftsl{-;bGFojMTd=)(upy?l0c
zmougwG(}%HL&?y81ZmG6B`}u9uffwZ8JRQ8P5;}H9t2_S2bv~3;K-t70a~1?z{ZGK
zeY~!DfqXH@%7~QYKfudH5G%`-(6avjtm=f8{|H^Wzz13tK$QOLi|1FwW|F8rdqrE}
zoSB8nig}%6jj^q7$_d&<bq$(o3EINVcE_6NYEb+%V_DXF72pr~;Y0-$O`AP;>iXie
z;Q@Py0QpKt&)fdukEX$}^{n_>Pxt_6lW}q4nMi#jIm3o^PC(5P@!SOHii-@fXC8AC
zX+eICX3xKBsFDxZqjTH$lXyTw+O7%I0qw#>yiZuJNMCc0QMbJ?4J<a!11eiQ&FX`*
zUT0qXU(&ipC|gYS#SI0L-P4Q%sZl3*x2THwe3QyKq@1m!KTiI!ra0<QtOou21+Smy
zD=4I)zGR41SdP{tY3{Qrma0Pp{`+y>zvN*&6$IHT4d2sS_l%{;sgXZ)m$kTw9I4r{
zXImd^F*``|4U>@2Q>?`$!HUcHu=$QO{bz8`KQd9sRw|x6xrBJ{o&;p~3phf#vPIHu
zu~UB;X}l|}wSFLGyYgA}PV%qt-oH0f=|<N{&c$0xR`Shs>EmDB31W>4GXe>H^jdOi
zZ9Zz1d*Yy--KI!W9{ZjApdx!)a}Q_zCtTg+`9({xv%-*=BqLNelezs9-IluQ1H)Sm
z8>-U>mF`=Gm@@4_+xsSBk{Z7CsSq|>Z^}ToWU37TYS*rCBg;FV<~*qFB&T)K-4DjK
z14g;yxNyaUA3xF^8;&HY_UHQZqYFZN_SIZc)k!_?-p6x7_7d)Fhr)tLvSt<%MvuUv
zeZvz<^+}NrF=hKJpW^T^mELOKRln-<U5JlG^_Jk~HE&(Bu^t#AaeZQRR8LN4vF}Ju
zrrU<wB9dr%1Py+EIV4@CWsoz)4p9*A+4;oTD0MQ;RjFH7yFqJS@gq3(hu`bc4YU2v
zx9{0UNXnn?JaIWW!rJ{l-tF4eH4;k2c9OXCMO9rd9$gyj@%B{Q$?<O(chVvCNv82Y
zqKrVnPff}#K1NN3qZX{F?j(nfOP^Po^QhVYv1?^Ue>+`GZ@Y=R+lBT#FcVc$OFuT$
z*lV8l+4=#u&c2(z9kDxkSo~yd)E3X;1?~x|V+#s!AhD~DrBop)>{{Cbo-FscRAp9r
z3u5}IRUd^{Jl?mXp*trWqu0RK8qrRT>)Q(Gde7cVANHbGT&RsyNBO4a`*{CK&Yf~j
zgkB$x94}3&f3xBQXW2_KaXI|3MT=xLl{&WIJS~p{|HMqUl7}+KAL9LH*4|?gQS3@w
zdx#v!H6(WGXDihZr|VUYjhKXKd37$O+PwcH+1$1v_^9y3pWO;)g{?0?B>ZawUurRF
z%pdsEue_7!E0jTVtdomBXuRfxJ{Fj<a}`;U?E3t=1o|e_Ws<@-C}1M%r6q5I>NshK
zW*nw2^cDX~CDBYpy=S<VuTHt%m`SeGC8|;H%IM_K5D~purjwyHwwmPp<sGz~be?8W
zc>J~6@yBe%Q=iN%T`bw1(Ui5AVl2&w0AmYz$GauX(uKt#jWZ$&4aCv&4Vo$212`*J
zKcmI3is{FDy`NkgB}NeumaT+O%*FHMuMdB=ifD7yN|OsyRVX5Tl<{kh3a7C`v6#`(
zQeMtTw!2iU(CCxB-1T&&aI|W3wmRQ82_qfuwz^oT<sw&dn}$Vj_VWbY_j}Lkrbv`A
zRaErq6AU;@W=XS6uSW)4`?iXyKhmlcbDgc`SOlD7t)<j5#?5GJM)er!{H)L~)-MdK
z($+sp(yEM7U4E}v3|l2Xw3`g{5#f@lEsuo6cwl|g2$?=4jzrkNEKlSfzDqlQ{yu(S
zmPnZ~bD)t|^Sya8O=er88HO%iliM=ECJtYG#oj!tUA&+5s=!1z!o_7k)b1cEf@j}d
zOu4G+$p75jXmJnsuISd%NDhSQ-)FdR4B6eGOK;jw0mxsyF_g?(Lm?LrJ}2G#!$-H+
z6e6ZTMkghVi<OV$z7H854XEyI$kM^Gpvq>>Pd8VF=;uS}a0-(csXwU6KRS3sSEW#_
zBgpbZ#p-_8*90{w*%ho4t(j%xAn%zD+xmM}flQot=;`aI$_=$bhS(ZDb&dBq`EWQ>
z!HEmCIu~Ntnm_OoK(Tzy`UW!IHv1UX5!a}a<C5$CjCU|GBi{YaCG)8@`Kz%iw}5(~
zWx<E1&ZFafZv*6%Z)YE7#@^See;~PUKo=j{oT3ML=V)ni>DcvRPk&V|$^5JPeMS7Y
zjbAaiAE$j5JDBsR^3=L4d*}l_x@^6t2#Fv>nep<tIcz80U;o^#s?hwnh3YCB`>__w
zT;bJG^3)A2Cw(N9B|y9^xy3tIOP}2F<%1plduPMH2ge~yTABq)boYMBH?*<76DSwD
z81Cc6pTqIR{jnZ5gXtK1nQ1?BIsehL>*Z66bQuVplA_Gx%YZ=<mu*N<3o$S8(DxP6
zS<znQ!kwqZ7tiTm^(<n~+o*hL<ravg+jj5{%~a6YsIjWB-GxgF@}=GRV>b}ZZt|BN
z7oF6~>l=~mskNPdoaQ2d<I;D>AvVj2g;!F5=C0J}w>PotVnVoe+fE`m-E15~D#2W^
z4|h3Tlkw%l$H=5F+^4pOFUqjLI%BpA4u$czABuhd$#$B5IAM`$jQ#flC2Om}mTBEW
z6GELJQAGATw{#%?^+XFEJ{@Vld!ek4UQ)$n(Sn4Q+-b&L-dZk1I;UV>e7(c!y-mbH
zh7&p5mv)PAa{ndet80<A?`fz<%9OEteir3xW(FV3vlfC@o;HWlhbF>4WPcDiie^>m
zKnqDna8J#YLKib$3fuN|8SFm)PKVxcR)wigVq@6r72n&XI2z%8Fw*JxF<M-Mpy!vG
zmJKqHBq-tMOuYJ@Dc>L9MyrN9uvn(t*BJa8s{V^xM!|FU>b)4&rL(-x?+86Tq<JN8
za}3(s)69rLEXRu|>e3uhj87)6P2U)RvGwaa+M-Wz74^hJG8QI2GY<<76D323kBr6S
zl*_wOSx9T=^1NX*6%V3pb0=P(g+P9=yCpOkCQIIl$r0{(W@2zpl}jBN_HovNKBJ__
z-=f*uKWl7%;FQ5dIoZ!*iu?Mzn`hK+Xwuzz3)jiNevzZ;=C92eE)KkGDHiP^XmaoD
zm4XiWO?=qdSLWqKA8XdQI>bY5tkc}TY8_M2;RcsP9Z7k$zLm+7{eS#?az;qDZk~sI
zX>!DVe?fj`75nh>e9Rq0KUM?1!TXDug+6GP(8GXfov}$sb*L9!yhp{R+zo!zo0xdK
zS@%VxLf+rny5Mfyi>=a|4i5K@ebjJBjchqw|03=6gC%E$k?dmZEF;OFZ-m`(KOUX+
z)=2sHkR&ucVOM}Oq|yc{H>B{(<2OFc$n37Sa;lrI+)%O&cB9Zj44JEQ%exGo<;wKr
zw=gzx>!M;L2`gn|oNZT_YviY-Px}4Q8s>T4gMrPl=KQPY;sZ?)9^ED5*u_2Nt4}Gj
zv5tDi#6u`j1_T5iWm&{0m1ZX4Z2Y8gF8U_ixcRlrZ$Cb-dmuCYW0tTmcV-l6bgW;A
z`_&7{>Y%bx2D6f9#}VgU23^c$qoL^qAF>9{Oi^E56rOyDGt-ifFSl|jQEzh08~Hhw
z``}SRKK_zz-w(Fj(kEy-ImO~11;H1@6P$KkyuVXPb2DrsUpaff7XPdAy0ie>btcd8
zwqWWum@&2RCC@o5t*MpjECf+hm>b7gG1Sy>9b$!|-QE)Ttgse=;GENYcVsjl4HXsa
zke=*yNi8kAdMG)m>h`VT^rEgu0KHY8OY%!A8oJ&$Lct@#T2b<;aCC(bqQ3uS`#Pu=
ziJ<ejzk9}Aq2<JWOscM8H#wmj=2+h&uziqnfxXuw;7~J?mXa*^*;qGSBAlqr-B`C-
z;#ADxgjmyTU4|}C*Vw}pz7<ke+|yt$_ln`VuBV|;8_P<5zvm)&kzv16-FN}Rx)2S`
zx+{Z55^AC@X~Kk!?uQ_VxP|{*)@LvE73&T#UG!Wa^4{F~C+@UNZAKu9CLPv!<}1at
zM3b;F(a@FV*xus^gjLFK*KHC_2As#qBGSgXsx>73o~#uLDl|f*nhcg&Z1URnl9R!_
z3X0C)Xk-r)6N=j|+OV2gLa~;jp&tEzv}yz^hN`W`1RSHGlP&9V>%RpnN|>e~OkL2W
zyDAdIr-_$60?5+GQt)O<O%!E*&R?f!=tQyUERIOU(AGV_jFd<OI^gtm!Wt!H%A*Et
zmk#Dh{mDiLZ#DhF!kVfEUY_RgWw?VZjD&w}uMi^FB!%$Jz0)yH=NP4EVrM~;XqrhH
zma3;5%1TaZ!pvRcYdV0p`!y9JW73nTc{~nz5UELh-!GdWa~Iwhm+pTd6$(|s1X~dZ
z^u9sZX%)V@aXQ~t5qRRt<oP7j(i>Pxnu0w;9Sv0-<W|FVC5YY*T%W(O10l#%mpoN7
z)}7E#S=pf59=AxUWd9XQyPcP-9euLzdKkGNc;5#y5OtZ!P1!=b?V8bv9}WUCLs;Hf
zz^!hq3wfHd_b&utr4YML1_C%im$E{cL07>FKcgTf2RIEr+}N3ErQ6<8;+lKo8PRjG
z({6DcgebjO{l!fJ@v<Bw(Nt&9u*#-tWpyNvQ=X27LSZTjx+l@lPj?0RMw=iNC0qC@
zQGmxnmvXMNo`xKS)R_<vAxi9(31us$3K7A3y{L6?00=XpxB+-zz1|s^EURREEkUj2
zunP9Sz^!U_*D=<e9pQ0a%QiFiusqQ)(~*gWwm=)Zs`nPRgaS;|F6k;1gmTE!Tj^F5
zS=?6h5`+(iu+T)j-i7&Rl$wb*%{`vZ(vuU3BYmeeWSUbdX(<-k^*s$-){IkEo|2Ql
z%#_TpK{zeOXG=GiN_rZq42Gc0^=dQaz1~*ErS6zttoC7n`6hpc)Ier(<H93D5xA5g
zm3x4HDy{P_XJg$-u?<Mf&mMs(thM*c4ib|E@w-U~mr_u{qy*OI5+R7~ohNH&zz<z|
z@zd1^gfb+RQf~}o7)HH&;rCq%?4TrScMcA1zjq!KpP_XgfslphX9l3BzUQVikbpzP
z&l$zJ|2Ht&D1@36Tu|8d=sXDV?s~+m#Z3}ymL;ed2RXgIlUd>tMY}z2+l&9<j3OGk
zr65<Fc2h^YEx{h=3_^MRK0^xzLaV@qeR>75exhAKG$B3tXP2-(7aZmqr$86I&Qvk<
zPNKgn>}P3@z@ectyH`YyfStoq$@wLTW*)xPxg{E0JKC_Gk3fMLZagKN+Aew;gnHs$
z=K&mbi|fNRqqBP&TxYb^uX`yq8SoiA7cC_x73G_0x0g;Xs1YOIz*Bpt%Ei5e4?wwx
zJi3nC2to9_4VlPfgVzyr9B)!+w=eo$_kRaP<DT;LQcFy7(yKgm+EN$Q2QuVTRfg%8
zo@|{namR0nwn}c*2WE)qh*jeOW&{nUoGj@;Y@ccO!1^{wG&6+9vx}!+(``41rl%b_
z|3??E$ug*fN`1{@FF=NE_}L*U2!Vd7JjMuQcJJ4MZ`sZ>sY#RO6XyPPpi7qOg;1^A
z5Jahk$keebv1Z<VPC)_rQZva(#{B^ea-dZe<%y0GlNmRIAqd&MEXctbw=tK{0su3Z
z%2R5R@piDiDWa!g8o$AE(#hDvKKVQAk4S_vLGrj|<*X9O5`t{zv5WMi1@}J$b5tlI
zG$W^=#Y}qg*J0^rGv-gxCs-aAtuKL>S?abR?YMXb=}jb>iED&2b56j4^jXg8e-Vg&
z*I;&eYGcXC6Bc^B$esq;r>3ccI5a>rhsd==Dp<Ffkmlzh2xNq+{qbTnl>PU=QL}%5
z9<T7!Z&wjNGZL0x?qv|kFwP`Q@zQNqy{}l`2g9;neN2C*8x56=eTG7x0U(A95?L#T
zVogs`P>D&!<Fd~G)TJ<LZ#CsK2_Sz?HX09VK4O8*hzW33dXGDSlLrCXO~3N%?g*f;
z5i>IyBdz3tZQ-5s<Ekc|Jp!vC<wF8L1S=H0n2Hzx`$#Gs*nptg&G9(k$#bDFtIjLD
zhw)_us31zGSM3*o>p=smG(HD_2SRMt!r3?-ZuMeL99XIKh-`*mm|JpkqCOtm1E^<W
zS7gXK=yq?M#KlHpo`|7|({uIy)5q(KAcVs`l`+O@<%r*L-t{hZJ5Ic--mwL3B2V>n
z>)FB+(%g4yxx+2>zu2E8_Q}OZmd6I)DPE2i_LC3WD9ALy(yh*Kmk@qrsq<T|b7}P6
z2Bg-}+W^;#aEzC${~<pz=6Lc!SkA}6vi|$LudxQxinvVSWk2pd^eTTJ+rEB;IDSw$
zCylr2ZJ29>6WZ&wnxtmZ9!NAzsg8!|{gzPcaPUkOBZDq*wGIy4I}LiSGR4JZTtW4h
zRyQrve0>A9HfdywsQojAqDqbx+x~=8H}U|<S;Sq$lovG{wjDC9ky1}XM$A_<@BcLE
z_g#5)lP5uf2^#TOxJ6$O7G9+YxF3#)^trzfp0Nv-dhz3&;XXV27C5JxZ`+S2HLrvS
z%<ZZ?;AxY1yZ<^?zm65t#I#bsO)|%ZxsH6ET(6}wAvArCmqVsLzWJL<+H|D-(LV%Z
z{^;_spy^0kNxLeyTUS%RfI1Gpj>IS~lctR453ML%tcL+ZFM52lwmuIMY$To%V$%;5
z5?Apaz5~n7&ZjuY;xM9ob}oh#ev<VR<TPLB?*|NOJCVP04nDU2{XWcRb>dAbar>-@
zIXdO>4*xqu_xr-Y9f+1oNpQhUL&Lj=E;BKcFIQjwA+&6{hx%JbdD+m~c!9BF{f3g$
zzT&oG#mQ@0{C`}1cRXBMxONf=i5f(75~4>ZdQH@5(M1cQ_g;n(1kr=hYxFKblqjS3
z(R&*VM(>R7+j7pi_x`?rhCO?gcRla(mbKT~Yxq~9cDQXnr1DoTG>^g1w+1W|`7=Tk
z!(zm;10>b+r~Bp2TJc31I2<4ha30xl@4~H^$#9VBMaeA5iX8(;)Sk#kbO8OyOSzH7
zR838)FU5HbJEE)=>G@YJvl|cnhBaf~?VeLY#0n0)GV`ydYh$^U=i>chwK5K^mXv`P
z5>Qo9@O|ATfvfNKR9y<~EZ<1s3Q4kxDkSuN3*DG?`AqO;kT(odK;iys^6aKRr{>)4
zC)>c%ptO6#@P1wQgAXQfwnX})iO!(#uWkbV88L^j{uM{X^LTPz0^`RCUavgC{n)r_
zO-b<P3xf3OAe+al<l5SOj$F`m1RZ?$7X9W)#jtPm#%%lNEX^7I%{c!wSgsN1!H48E
z_V%f;1&45fp2`<b3HZ-5KTkak7+q#0CN*uZLA?-lX;=1&dB)eH?=Kjv5<8Bu#r={N
zE%d2?+Wi5h-*Qi0y`fCT4^=9vGa&)qeU*K<q`|4#ou^Fi%ZK`6{=<KN@7-jNK>n*M
zTb%cn_}yRJ(y#dD;F+MJewHTtWkMO_M(lC@uCL2_^NvFt@=Dm;53J+f)hZ<R7WvKU
zPL)dObF<x$b%JRb_}wJiaJ3_Fslr~Lla@~xwuU}%)o@4%_DDA6w%Uu92t?&S;i8rQ
z^O9b>ZS#h+G2eW@swE<OCz$EDE94p+3ANl0tvh%hFx&cd#nEcNY}08D@kOAsB;ZLR
zTHVU_xJFxReNuO05O1NBNZ9>4$jctPJxYFVEN2<B(ubNS%pZtqwow*3Bf(>hAI39q
zTtpQ?Chiv_;eK|lf6#Ymja9wS!|2vYC9IQUsIL?EzEpk@oj(;<#%XdaFNE`4`i+8d
zmx4Qe+ZyS<uv7l-G~92Kbf{%+{xMHV9P&A&+3TdejyUIcALk%1-!z}CZ_a0v(8;O>
zuHFiZm+usxyD%&Rn>IWv5~oJgF^6;$@jk?K^<<h*Esc!l(l`#>SVH!ct*3=oeqOx6
zy!e7>Na4RKimhy8hvBl~>7v9@@`YY@2)x-oL;+!`p_>IFiqHXpatVj;U$*mmXEZQS
zNua5@D6zkuy3*{w{=m!T&+tP@C%tl__{&I9EHBAc-1I;@8TU$Z(QbTCN0HoDeA0-G
zjNhV2l4k=yAYGqO&mT%A&EV)48Oc9XJ9G|m?h+4qF;>DfjZk>@4J+>SbKBBre;CKf
zwJ5&f;GmdVv~;h^gqs&s=k-I@sJ20)cZ94(JBTZ@PGvUEL=UJADeEga(E)qSQ>>FE
zY9wE=KV3HK?S2ZWfaEcUcPhN(+giu8R}H-1Vuq-j26=5Jeahus7j*<2X*9pXm$7bJ
zLsdIkmVUiK<nFc_!VcB>O%dlhR|7Ax@GTK61nPCy>GbxMLEysHx}ArnD}2QtIU+=N
zdRO^a4!I@u>cyc+(awo+lU?VqP@dHdx_K}+ty<pavW<>z`{!66jaU<f1Plk0oJ4Yn
zjG&3Al#VcGI-Pr1#MCb2o(p8>u+KLwXLC0KS7uFh)4YNjefDPIug50xC*t7!B-5tV
zpmPdvB{L&oHWCm;VK8o**Yy(CtM-L`+4&4+{Jp4Dv6KZmUCBESJ_=d*h-ywNQExP)
zt!!r5ty=c8hwAV~)NO1f!22=rbSpR}KLbK0#_PrBWCP<Wxb8Zh`elC!nmkQK8lS_s
zvs-%;$n&pAqsI+^&T4)!<ZNiXhU#1iFPh%)Lz528U&~cqnQ>|cH#LN=@~Pd7X^uh`
z4pTHzWSA+Cd@RX^eWAHP`M8Mc?E^qTgO9x~VGI}F#jsFLYkus$D5ml^H{Z2z;a5MP
zOG-_^c0f2q)0Nqc#;m1Rz^uJy>BpC#Kd6*AWaKuY@!Cw|NtN~*WdgjUz{M1vfJ*VS
zrj05-N@0TcYsAf0Uzy2=P%Mp5fVo$7+iIHuebT|(x0aRGCY>8rXK(E7pgMyRnDdCM
z6f+nr4hvK#JTe(?>)H%FNM{D0wNEEtnIz@@4lhaW{xDO;3-l6hZR_bpf0$Be0>O0v
zAb+mTuybu@n#sNvU=N+<W?Hxd7<}Y+tB<pFg*aM)E_LC|2>&jxJxWpbK8F<%W6r{3
z;ID6HO59z*+@v<qe<%Ppvb>)NrRnGc21kmKdnat-PRuD7D8AD;RqlNWi;dMx|9+IB
zA>}gu9UyW1j(OiDe-eD)fDZ?N#&Un;Sc_N*$If2WJX{ydJ?Jy^`N<yNmR-;=9#luC
ztcCez*8X{{<qNc*s1ywtDYt3+X-Z+sj(i8{C@{9U1i_?6c*#s|!|yym9oU|C>KIzY
zLM2})R#KnsP-l?c;)uPz@6Cj~ZCcI`bU*-FxL&LJRSj3by3g}#R8kvU`G;LTp-Kl_
z>6GvD8p|l{n>`YV?D=zTCW?WW!Snsr|9P10Y;626<veIjX=Rl~0jg8y5^K5v=-;%3
z6AyUHVhzm|fKAMnJs6-s-CJ_s)O*49O)$8FyRqHeIg9}q=k<7Wf(A2GhYD?N(Hj?<
zRLhj^at1r3RUP$Wg(mTFx=cuTK$9+d^^DG2`|Q^!W$=2#-Mj7c6yZ9OUS}`}wVRk}
zG%Hl6f}U}~JL6k95}C1|;`3}m4>ShVKj9P-ZX2O?UaJT@Y+Ak)2+jG7T}B37Tvw~l
zndg5y`t=3PO!-+HKW6~v8|<={lHm)i-3+t}fuodixC1I3K54Fqb}*fe+_ar59U+uq
zqZPdkZObV3LAYxo`K}fygD>?x7TwxsPE7guZl)BYP^p5i=iv^}OLA2Gz8f>HFb)0C
za@6QyP)2@tNyk=K;r^LpsBk3N@|KmDQg+w1rLZG5$@%FextQ`^XB5g?U>sw2Vu^pp
z{>&3gybM$9oCtM!){JTrvm0&Ar~!UKh^lc3wIh`AOaS!Na}&YNesv9w{muCMp66vK
zHH+giZ>#BLT^70Tc4C*}bLRoLeJy+`;#U9M{RcfOBhB^qZ2Ma1{nOVKzZ;jMQdSNw
z>j%i|4!R;x9$!8j=^-(8>DoJQ%We*kE8o5CYZEfv<By4M>n|!@xSq#RCokck$kqme
znwD>az?Wd?P4sm3fbWUmQS*EX==O}r-CoIhXxHcx$DKjOdyRGF0BcuC^xU@618(Se
zOQBhq$8pGB>pNJ!Rf&wM<DZTi*R3_o#b|mRh_tf5`Za?KKlllEs1f1=Z?}f9%iYew
z$i>``nn77n$K>Gco7O0Oun-Xylo#pwalzr1;<<=pCvfshDoqqTzSWZqZ!WD9!wv*#
zx&|YnM(g*Fo_mY^50;4MpZ4EhJrc9)3fc4Voy#K^vmXUsn?DYM*X((Z*gB^Ap2tJ>
zP~`Ke$&>q`87z*A?+Hb<To6%|Li;L1ZYUP;_I~Sa*_CsAhgxLQ(yqX_YDceCmK(?@
zt~=ayt{Z6Y$}hlpr^{LC>ibhH0I{x&*tds`OTiE44_39V_BNHxby5NR#CZB6X`%n&
z_av-smh1kJJ3$4oug{@DK>LG|?lzG*?{OlwZw>2t=pGbHmp@vU)Rn57KZcYtcuRR=
zA(Dl=?J%?+>3zFk&l!fanmfB5SEiW0G`~*o$|!b6xR)&PT^ZO0UuyU)G8PpWx|t)Q
z<`2$7C9Z-l=jUqSziaeG_q%;j7r!n6jxjr_*aD+V#f%Ejw`;m}{3E=poY2L|{~Jl-
z+jb3iJv&H;D{q9rw;a-o3890)^iTQni0X@$#dyUfA3+%(GhNK!4d0w^OXuybk7=<z
z(d`Oi0od&7JfxgF&2kz_z2~`%a!+Hh1M-NSgH@B;piA<f2T&Gv&N6;OV>?m1Q*wZE
zJ0R$?uhv3#IIX|%x~C-EfnCBLeo1*dxQap@T`6C#7%-%sU9T;;d34P8f@YCK?uNb7
z@r$y69q+Dij|$O{;u$#Jrk2AmVO=-B$jIFdubUIhKxGS^)WyjC9rD|t`tha%6Afi=
z%WCBA+*zFvhN#aPeBXqR7`#0*%LclNUq|jjm!j0}CpTYUfzvUA;mJF|QGB~flYS->
zB$y@OmMGxZa3lyUmiyN}weY+%+W6)&PLU$oWQXU{??;}p7fxOXfxTN=0VG_L_dWLj
z|3UF{`^&{Lr5GGA5qC<4-OfQmpT$vzD;zPqW`Iu(F3I~1)AnaCUsji&h2H9W?(r;n
zmM!eR^|v!T_;2`8{R9Cx8gh7Cn9}XoRlHZOi;VR0IEvqv$#8paq%T6u_oV{|#h*C+
z3?t)>dwhgd{DT4q|Bpw!8dp*n+#r*~+7qQ*<F7Z=eQr2J@Zl(<|42G_w)^wuyZiAZ
zsV!bMjQtrDJsR(*EU>9M4BLMysm?kH2FPBa_fm3*$yvZ&Igv9)h}$lENuwF!IaK`Y
zD86J;L}L|+wh_m`Tt3v(y{4#4k&aj)Q1C+Uq+DjtimT;4@z1_zmdWM)N%Zj3!PmTZ
zkdY6rqGSwGS#H5;S@YY@nZ#s95<P{5f%iKQXs&8WtgayWhquOUDr(=ueuDa_S~Mi(
z^!K){C4EJJ<*a14s@YGF{_Ta$Mx%*|d$zxP;(cgKZ=^T*Gf&wl^*{5~)V<}UTmB>Y
z3$g8svzgcb$2wDs0mNv&z~d~A32$SANp(hddSzfqrF(2WB@0a(B2|^Y$HLk4^s`9i
zTQVx_bek>w2T|jx1V-;k{1_(6O-{74HL+A26zNBNvSvAE%N9u~%%gv$g<Yo4t)ZFZ
zSuv*a{L1G{Vt$xHPqvL)mDy=uP&tjrikIYD5vjNQJ|>p^Y6xc6s-t{gQ7yy7jd1rp
zD_RR0U%h2!^UxTA1Ppv*{*zK`&r)J<L%jR}cwW4zE>A-5w8i^05Di0~xP*DY61ryC
zFxB_f>-d?96Yo&#kW5PBug?QjrAsi|!U`E;E#TcT41~2Tf#FzR(EYb((kc&fUmBnv
z<C@m56Kj1Aw@A;+<9euTrkn2{Bs<`PEGY=%PC;kNDi<~f|G0Gcg5&TrTp&PjMlp=+
zbphVX2*O9!#G&{|?l-u-p}kC=C>yCcr%UI>7mk%gj-pQmNvxG7QcJ%bJ(C!Ec5Tyf
zf78w(UP??CpMhYdVl(oOIg2E{USbjVm5o%YmCbv5a5c@V4h^!%UQS)d%y{f)pN0oD
zDPG;Q^RNwy?5fO}kNFwhYd^4dP@IMbth}<_Z1&(+2zfw+=YmETPq{x{k0Dm&-sBn#
zrb;Dvw9uz|9(c-5s~)xcCo3=ezCn>e>+e5meQ}(W_lwP=`kgE8(`!q#eR)#+Rg_^v
z{B$`@;?RtJY<9b>(nN|i@HwX%NA4L@Xzd_V!pLRFa}}-M0;Ro67CDqJLTUI!3e3=y
z(;GE=HV=!nSieWxB)(@X9pzRaLKj8j;>z-i5&^qWN@kchns95E`xUJyM7R-6d>Igk
zP81^XFqB8j56RQ`om$A+BF?Wmx*{`MEWR@*pssSA{i%eEqF->T#Kf>{yfQYxcwd6k
zblLoH`>h6MgxS6Ia9*zD4|sED85rPMa^I$@m%etV=-=oGIz&q#<fw^mKLn`!5K-=N
z_0x)~mWg%$-gUdoLk!v*Hfgz|t%9BpqSK6~iUZ9HS&aeSOHwS4DRr_f!C#+*6sxt)
zXx9AHra<3h$o^a+V5oDHOORMOt2d~f{hFkH>7_h(W|{ZkESFCNjnhX7&TKZKbq-b;
zfp3NFwEBvb72Eq!uUQ!V%XhfVO^NKdN;AVhnu!sG9dfGJQ?465n&&UcR2bp=Xc8E>
zhqg1dHj*G9faV<13khJ_)6t>->S_EU%Q%Sq5sSsA@VEI2Ed}L2xUIMtRG5u~@i!hF
zV0+Ut*y5=-Wl1Pe*5{>ieSmyGqT@dN={-e%DzTNFWWutAmiht)X48Gd`T|%e_E*p_
zQj`e5Qmana9Foo_dbW%fO!S!m!^XzLiN)r~UtzBxPuV+4b;h-HK~oo};OCEBf`PNQ
zz9kz6Q<jgCY`X4IcAnZo>)bNsWoQqp{MnwGX~-LNe|y35SOz<vm@?eVP~UivBZXs0
zM7-QAURG}uB#55&%&HD+j(1+UBa4VfVK9NvM_YninTNkOInMP5lq!GH=5j04S@U`D
z4@AkVp^~HG&no42+;qEPrG&`u4w}y&=UPrq#h4E~Crk9E{DIFt<w=}qhb$?<WO`2#
zzRiu|axhu^c#lDCz9P~_qJ=&vKSlc<-*ravS4Y23F}2eSDvw)-^#i!$IET2}trfkj
zJVBC_&&EEaiUrEYfQP=7TG_4LGxy1i8y^;k$%`{J_}Zh@vl?!+eC67zKGr+_fW>ms
zlOqlriBAB}Stsf1l}viGK>jvcAyrB-a$uP;b8UlUf~UUDIdulBQ%8I5ExO@Pk`wkw
z&j&~swvRfpyhuWklGnij6g18EMqUrZ=f{~+`ya5bi2E<^3HuUpYtEX(mfPQv$P;sm
zcT>{ap@;trjxwFttEf;gGfdb9Lx#f2{VVxx*<U%^h+VGOldiu>Xf&>uWcRD&SIj7{
z=jr?mSts#(Diizl0jO8Il3y+9Ie`cN;b?F2dQ}AhsnB(~BE^?dEFq=%$!^_IiDK}}
z7x#H^^=2$hjpk%Vbcv4{ET88W?udKh4`bn5^0h!@tBjfDB7#V2pN4S|;_hKcN@DMf
zj8O>jI(&FRYW4DEecs0y>Zh9VPjW@8H6(bu^(hvgz6Wp8mzHo?q=1f%Ol?!=F=V}-
z^6osefBt~o>N)A_AI2#fo=O<&IDOTp94B9Eb*^nc>TpUA@gJ7JtBGY>mpp$&3w?Lh
zgd0bph0xMLJW~_a7-pfI1<0PlkJj;lUk`c$EhHzWl5=ocs~E+)SA6@OXAq0t6bojt
zeFB4pi>bf+Nxo57iXie&PLPBcN0}=VmT^G3_*)a>b*B4O)iQ2F(x=qZDWemCtDhGX
z;3<%OZ6!ezgT#k1_4eJho5N1u%C{|<*zjvgF|F36M@F<l>4QWkweTbiJ3Gk;F|a+u
z(CY#kYQf_NWim^Q?*cHe;TOiAA?6ETwb&}=T0*#Wq_XNl(-?;AHjZVM>=TIzOmEvL
zlc{j|6H;g_s`u$ONvk^_8;-#5?Oi5ES~Jr~zRCVD5+0g)Y262_31Tpb@nm!&>c92x
zxChN2qp!wYq>o&hmB3H>yf>_TKUT(7j*I{JJ2tM&yT0A>R{@2DU+*nVCwYe8XIBw$
z{`sXMnY5mMR5ca;$~OE5*`unm700%Iyb_Evs{Vo?>@^C4$}2%zI&5)Oo9>k&Pw)%P
zyvU*2*E5i6GMx#lKj_Ftx9-8OY&@A}rMR%buf!ssl2kVlJ5NyoY!=_e-^qm$XC#|s
zS-;W74SzfbU9<VgHFG=zyLrd+y|P6XBG%rBlQknk9&W&M<$Pq)6HYRu8ycc9M6pO(
zHj<;&JSANgys?ur_40L=G=YZ&Zav;ey~Q%m=!fLCY8*M1kHx1n-={2u(PKT+e-YQ)
z8EyJH3`}n4e`(QNCpNQ7Tc-tAIzHWxciJE&))r!$e!V8!Le=$ZNcA%g=VRX!-mnJ0
zZnN~02Z8wogn7)^QUwoadX2SSe{rqhXlqcw%1@LUH%%B{z;}LLua{N&1-<W6vXo<v
zx@;s)l1lGAjrpoGo3!OB50hQ~@kLk<v4Y!F%qk|yr)Hfjw~;QXzREoH&r4SXDDJmJ
zzX?4;3ss+?_Yknra^E}}oKQHqNEF#z4)wJ<T^H99bQB6*6hC(!pyIuyRp=vqt>}Ep
z*s0yU%-cm)sU-k<)_)QTN|s`(R)kTpz9lF!xllh=lP3MpC|m2Bi8pA1Fgu^Ffb>vX
z2q}BsN4azL_~CUlD0S=%@fFqMg2xorUUaTw($uWrwKsT4&n>0Xj<z&@hSu6q(I1R=
zP<Ka5)|wEpv6@`1Z<ZdNW)&vuttX0DePlRX!%01RwJXahgJiqqT(k^SkRqOfVGSD_
zaJsaRW@HqYMa{&|Oi)0jSHwO`Elbo9FiABZYF>;VQ>_b(*F7|n%pB&{CU6O4rcw}U
zPwaX)cwAw~x5^?Z?iG~2q0xN7vC5Bbtf}+s^sB5u<f4*URi9`v!&5?T`v({-at5fm
z?OgMRk077)4;yDECzkWWxirHDt~@dauV9_gI~!BFW(nWPEkZ*Ul`(T&pReMN7h)yu
z^pK<%mk^f33Yb>4hOTZ%iLx+De>P9kp`-wf8IGT`y2%|7egx-fZ}w*z{ZT{u{Cexd
z3p3`mH{?P}dRM}FHZnsQe{T&WZU0hhHlz*F;j*{j#(HC&Ypt001S`s&Y}WTG8Rc9{
z`Q2cqt>W^LJHAkN2d-PU))hR27+iyP8~u@HZA8b*q5Xx(E<DwS`~HV@_S&AO7h6JV
z@?&qxA7wBRAw_g4A{7cr4*Q7MfXgUF^zn#3h?4Y8@o#Q5W&>Y(CA~Zz>lr0M?%a1Q
z9-u)5rh~l4H)%{Tl#56LlZcA@s4&=EKE$}db3aM7R27}LH=2nq3Zs*OGD+1DO`~7X
zF-cYNTJ9LjC(lLky2Y@8J9lMkoxZ1H5EA+!!kHmTq3~>ypS06dUgJ8t3)0Sw+A!0g
zNKzd~VdQ`!4c&3SE6e0T($2GUNNMMiR8J35G&qU|Ay%8pk`BYB@*Sy0@km-VdC?4c
z0^bCt@psQ&iTUI~uDHz1gt>E*O;r)$_yY=sDP>5mT#QYg6Tdy+q64_Fdk&9ga;-em
z%Nv6&J142~9j$gltU?DDDfgepCU*8)M2f00zd<kUPGcgvCCMkCPEuWF(jOg62SiK5
zdCZZ(MD+fNle&4Hi_)o4M@t%$2Az`mtE~Y@jQxWX*`0ofmF7Jnzdpzs=pv&JLRC;%
zh39Q9e<Z>(X?pjG>IUv;mfhX|_jC7794CE1oL*NzoVyZ#bn4jDHqBQ5%;l%hIewPM
zvB$>O>ng{BoP3&F9Dq1&QkzMKbE_3Gnb3|eap$I9Xh~E6e^=C)Qfok;<#|uo{mExd
z<&oP$AI;tK)NP{BaL1#W#%-E_ldatI#uTBhNh4^k=@$SfOvCasoWPjKm~6fC)MMo^
z(OK#h3bpmgI(2Im3NQMTjaAvy<b@r9)ndpdR+#WF02X$I&#&gp<#`|d`XIfKqza_r
z#>YvjzfKd48v)3R7>rueqUoYQSjc+HLnLgn%Q%?3>}1l9dg5D`e$dfRE8*SJWQKGI
z-GyHpjgonudb04NsYyW2Q>Cn1S95vOohsGCBqln$+n4&HYVv(8pEvlqa*K#c!|N{<
z3STEaH352?ekC%vebEmw8xX}d@k#`EEo`t@?vym*t<3ELj83F9GXkEZs$=3NkPR@d
zFWh-8Qh}-TMP;Ic@$TI}^-BH9+X@@0!s<(omkLZeIosrpEV~MYiDWyUqyd8{H|Z!r
z(5f*%?^eJ9wA+g*DU~<qL#6q>4>E!&PonF5lT7=m03V<geO;asd>o);Q-V5aHFxe9
zO-Mr%n;Nrz-!FB5!kSOF>zBE6tMHxByBdMY=^Tchy(4K%aiv@&=8fFBcF8{go~(~z
zemon1luZXWunVdEF{4&uu>c^xwKb!0%X1kJRrq}Y2<!7$sh?J@NX|1!!xx~blI*DX
zc|SxoHrx0$z|RBKj<}3@;IHJG^;f`%w^&$}EzIOiLHZRB0C=m3gJ&s|Mg(#rlM02@
zm}kS(%JlOf$d(3~UaSPBxD(TA4FK42_Sm=qQ+Wnot<)0>pqTDsvBNu5b^k%NgdCnU
zQZn63@@t1H_rk8S1klv#<}{O0#Pk4!?Tx6kvK!zws-0*zxpJMWoea_wxN?C@YEd;o
za~2lq?Z4mJwwTK!ZA=Rc6M&O+b%0J-SoW{#3`cwAMd&h^;^K(3bpSdW8}U#^12(Ox
z89C+w$lu`gl-3-$e4Z!zJcB7$y%g<p9su)Ncfa2EK}c`W7s4$7&5sp-(d@lLvv-X&
zG;&*^P~{!rphBU|%Z6&8-1E&v8^G>eckm{>E))uzOjQ^F%yeYe%w7R~2fCbu04%7*
zmn7*im+yG2AZiO><Bpd%!>x8Pe{pdXvKPMI#tdpxw#I4uyd`w=b6L2FI~A{Z5V5d%
zR9k~ua4@H%QU-{KV6X3<W_M%kWD8)~C-N<6kEq8+{>q|42_3Zua{*`9369C+sps=^
zmN}ctyRL0C0rqAGdkhGA6~UADCNW9XlcA`jmOJ;*9<#W@Cr{m(3@aPuo(EYM7l)b4
z2jZ?#0AFHP1*#$k0B_=zeK&3<QaixgoCFdRd<URm;jFxvF_&kmE0eSZz9y2`Dv_w?
z&V@io4)_2|HJj*44ge6zQwTZq0gC+^MpGS7U|JPYr2r)R^TNcbuFpr5rwgE^PSmQP
zFH9$@epd%z&{p)p>kOu}N-AgTJH3j;F92#v=24tq=gO`4rZTg`4V?6=VLAbj{5M%H
zQa?}qAjP0B8i*b0GC=GYGQTogx{E}1eHMU$SLs=riMr*f@8L`LimDYAs10Zx01A;K
z7JBKO=Q6_;ZUXp!A5YSwH+M>`4I>f<Dm6&EodI9Zh~ybKp8`JUMH!BH-tlCu;p$gE
zz-qDTBuuH3M)n+~L^0f6$?8P`#zUunmI`>USoaTsO9PMroe?@wu3YY$BKsM@?NZK|
z%Hthxc)kX3T75q?U?{5ATeD?(>|iE;9>FNw4Ri_b9gukfd@WKhpFaFMjcN7TBDb>1
z)?9uAG0nDr3V0QBIa<PLAW~k-#JapZQz)d_)e4(Oic%k(14vLIau{!|xm;1&v4aq1
zJNJ#UJ4f5BNXnDJr17;ZZUVrtV&Z0J3TR-pR_AOon#mOVUfZ4fVn*^L8lsX^r3v~2
ze-Hs0JWt03%#Z3i8ma@(oVi|ILTi^RHxveJ?o3iO1rc!90rql08G{3Ku^_N+Pzyxw
z@QnljU2VCoN)t;nc_N=b6Y~J?OJlEz+W=}DZN{((srAN{^&VX+Y?OOK$>F5KGB^7;
zsJq-Ev|x|?X0II!I_r1K!Ttf+4jgq}2vwpuXHa_^#`-)-8N1lKtx!LaLGX-b!I5WH
zGRPOVDa?INq|4E(X}JsZ2idR;qP+3e$zT_j1`bC>?3N2V#9GMG+@9<0M2Kl#;)uDm
z%sqaXZ*bro*R(g|N2{EsR+nCX+C1qFEKSVAYiCz6BKdticm2Dl^E;MOGB)_;(%6D8
zUH5A*%Mg2Ba~Yj{SB~-wHAgJqT|{4@=)q-bYX1BZ%Kh5Ees;;h9ZNWJgW}1D%`P}F
zE$U)uI=#jbvxg%LCR+Rkd`0#S+TnXO2!v-B@L0cqA`Jh~*_`TZg%R9EE!41&lymfu
zg1B7?JMw{hf%ih^zknzWfXCL*rT6qI--Usv)?nFhFs<XrTm5V2lG&H|cyj{+ul?b`
zlUuecrVwBSqds;WS8U*%9Bh$zSJn3|)CX#K%P~0mgBx$IQ9wWh%YqW_2tB+JD6bU~
zh!k6)L=Dynh!`FmiR=N;*{wp$2Z;>|GKy;)Znc!W-(PfD!O!Yu?9b}3d|p`HhKgx!
zT$XvxSq_*?rk`DvX<gM_Vxj82muFQyQsaTeq_8ex__%$om_8r4B%tlu{TvEf+~sLn
z>N?^B5WAV`N>KAz+)bs(pGREQgIlh5Y8`!rD0W#N-MZt=?I7^HcQ47o3r$^(bI-dF
zRQ7V`UQl~*w)@pyFJ3-rWSZylG5}SEknjPu({5)Cy>}{qFtyV$4vOznc^k`(`)W<)
z>&TSrpbP@z1F=Sguhwnq)*9V1u=`so8oHGKFzpOau3_I9ZXdGi=sN)4S8LmL_2{_8
zxjwxHU$=2a1}Qj{XLoRS4wvn-Kie*1^Wo@78|rjiPT|X;8*BVAL45|}J8GttgssmC
zWH`^ZmY-dxBZ0-2oBD1oqZKQ!24n~vzM665<I~j64=!0~z19-m4~3rn)W*A8X~M8>
z4-_1vuBDWJ^WL9_S^*REQOUC4We3~w0_XgGg8mWzrc{f?@f?irYHAhhikGO~`AT15
zzf#xy5a~TgkYph{xF@3A7m)!la~5@j<DS3O8Kvg3y#5n<F*xdhKw1j#pXe)lm%eS!
zksBZtoy5_Zq8JuN0W@`d_3GoT=L~!w;a1}8bfxcJ7Kw5}?w^$%y|KM=Ou?O-&j$F`
z)D_#GD}%mLjx<a^ySzp>V2_r6r*ccADEgVYtPwqV<9l0V+h<fej&v=2g5Y<EKmsz<
zYi_R}O=eg|S<F!g^2v$+)()RgECT^Q(zu~KYs5wN__WRAO#KQ6mZN(29*#6Q#vvm-
z+oF)Qt{fC<q2(9ae6pD&L#p7i$|cgax3kJ2u8911E@zE<%HC<Qh`m3~t_{fIn+8WH
z?oBG7!=UNArr^W&@V!Yf3IxAPUe|Ssa}e;}b(q+`hOh5B#bnJvJMCuHTj2QI>OezB
zDA$bup7*UjyV^BKbpKkv%ekp+FoC3Na6IL#P9CF)cgf^8CAg%zOMru@v|DU{fn)V%
zXr)M;rfc=bxuH7@F;Kzpc7!A5e%@Mud`9I<TpurBedevajIW`KbWa0R(PepXcGw6k
zTy4ypd4}S8Teo&ux|}(ZDSLw_mG!n3dFu@M%FhjzPeSbbmK^~d9J%%Xe>xDjs#RnF
z!~fMmb;rS3pRQ^XeD9lG{!CY4kH+A{FdN7MytJY$^g7T)N@Ul4EyR%2=DnEXkpjr`
zN`LH6rl6q6!jb-s=aoV5(Mr?O4SI=o=U<bUOuZ2S`V>G3dMNHr!mPp2fdy3$*%ERw
zx~wi#(`~z}QY3V1VEiC`@4^|;C0Ofx69g<6hMG1k-$wqk;7WqgtIL9AV%;u&5c%K~
z@W=Wkj^PLQd!M>;Kf7jQWT8zqdCM*zQJ}0OB|QHcYRYTVaS`=x%{H_8B2Jm=mWw6U
zJDTx%jbV~PSqM>_BbPdE+jQH?zF0_<AM3JOnS3iba0W~0&Pa;OSe{=m{yI@Wp-_|I
zo6FLz>j&*Ry#a=5+x&im6s2)0xWrK5gdp4uG#Gtc`B;~CXXgiQfg$f6D8Cn(hfuBM
zY0b&XH(u7DtXr1cpH28M^Rv#!)n8Q6Jj5^rjBJINpZ`#Y^tnD8D=I2MA5vXQ?g;in
zOF^^~evA&dCR;UO?BuHYAzu;wi!xV@c&5s4=64Wbh<WBK4&rUQ=F^0Z%jxZ$qsfBV
zoxEsZx1HNM^+JN<*%AWchuNm?lw4h7NqoF5;-G@_)r}I0Oi6ibB!ph|1Nq58k)}8Q
zAjq%LW!tvd3nNvt;XMyAP4VKr?ZqA{TgE2=m@!584I{+Kfy|fAGUPMx@c7G6Zh{KS
zFOQd5Qzty6(o@Bmhy5MsbS2BX%`@Sc6b!&}=w+p)FYOw^Ce=1Mdas8Hg>MtQOH5M%
zXBo###bZG;c-EHk^u}+H%xy$<@m#v0$|dWQL3LE8?N8dQ0nVFMmdsC-?p+fcF!Ri(
zwHwu%m$+p{rp~b<xHTiqsgv9f_`Z4g5h@JK9l62JJnQj<HI&pY{0y^OE77TTmLuLA
zgi`G`*C?E#Rh%QfJrjao(eQidph8!A^hcT@FRZ_Keq`oPsQpOVprn?imr4Ger<q1<
zD41u8KTkgsoDRix8$URSuBy#ML(Kl@pjRbRcV4d>ZGJEHi$^(3$7lWPeX<`on7J+Y
zKq)yAmiRk!;)+3wX$RQ*-*DzZE{sHqd_Vg{yD$AgV)Bd|%W0u6E+OIK<Ja-%_uuKq
z)rQyz?Zu!6MnL(`6P<@H)W{T$gLx9q@P)2$+(%3h!4QwdB}s-^Wy{Kg;3`Lc%<aN-
zipaQMFdjW$qBVD9G6SJd!{yWUw+)z6rayoE7We)(gg4Up?u-}H^r=T!l4`@$TpV{U
z&i0mGe%1X^XDi@*Fm4sG$XOFB%*GGeaag71f09TN37AnN5vHsILKdBJyD@Lva_|!c
zUOm*-vXbcO*7AH{`F7rx>(g<DTT3V5>s9gk%uJCo&1)D0i>$!Uz&59Vk7q~yZL;CC
zSGTt_q2SL$g2|j&(&Y;xd}`@l)6usDoSpI~n82^&&>n8a%Q6}K(ZtlE{X*hbjDuPI
z;`&pyavs&=bsY*tJ{*P&MVlG9_MaZDJvBcnO~klH*N*rF2(J;IBlI_AdwMqez~QSY
z(53s&FS2ho{IZkU-*9?RxC_5LUI@vm6O!*Ui`~$_3~1f>n5WKZ{g|Th`(xP`xTS0#
z#k>qvO?B9RRS1xQ>@Oil6|O^$6hd^GJ&7ukPm+fC;yl4B5e9iM*JvVY0s`B6*#jvP
z{i~RQeQvAbiciKeTg|`7FtMjtXXD8=I_~=?niHQ{J40WtTj2YzW<C9lpu5DT#MffC
zoCXKltPQcBDnANL_<5Zv!?sC-?ey)v$rOXMrGiDsVa8MqR@AoL7kUBS4RWwB1~svQ
z7tiw3_3cmh4Rjw`KH5P_JXlsL3gcw+iQaiCTle`Fo~86z(wg2elcmCTCL&<ri>+=+
z##_lR7C(bIMB%GF)VH$z$NozXA}imjQl6cD`u6<ru@GKRLC^YkCA^^8>5<<c;A)zH
zf3^k#%_-1#8l!b)pDLX49>>HpSqUh2JH}(y1`HErzd(|6`q_Y&n1W}HUL5T^rn)Co
z;Y0VO!N?Yhg8C;IO(G;&FXV9+0)}Vxs|p%1vhAN(+;gYG{^0nVAForzA$SoZ7~`!l
zUBLrn3rR0H$kBs?<kAm(laCS57qq*ZtFzMb-5u>&Y_P_X_hwsw<FDwq%Ys+m=Z;q;
z6!m=<*Nu7h`Vd}6k4txiNx(w2dDK+clS1oN3sl%QctIaqE`a{uwxGV!H?#%Zrz;ic
z7-^jiShDPhDn@;B39>z(*=Sh@e~)eR<mkegrRoPZ1$9LZ8{+7_+gGEmIq9syXfwx&
z$rb>hD1F-04dS@yTRV{2YgwP4l?}$o77}ija`E73MWc}oMjq78<BHj#LIR#N`m`v<
z7%Uxs`bNBO;fW`$Y;Q5;MAhG5+t@xDFl_nDw;Y5g?fxbR?7@L?0YS%tQ-$9wuQPez
z0SCcbv*rUBwHSB;UFyRj4H#{)_BX=I3=08EjeP8`6aaFsbq=Yp_aKdj?`kmKT7EI)
z*=vy{OUxy1*gN=+J{#aE8?aMYtJe<fGor#0%WV&_k6L+YYj*{CLnYJvu;CaN**lfL
zwjx3z_wnaN232@fKM|8wHPF)N4nqrwBgnuFLC$K6Y*Cr{?7#$wQNw`nxRV!l)9B&F
z@dv)fj<?rBL0}BxxT8_OoVYu26AG{X(-HtIIj&o}AYRbA#&$tE6*hE4FK*+JGG37N
zh{V;B2uZK0ny8kT2uWFSlG#uafUT}^Xu8|c=_eO*^lnl-JZT28EcQ`P4neH@AcQxt
zzjm6cACY5=x26G~uM6V4QnbGbvR7VpBov9%GqVgfZxgaJuOr%PanNt}69ibhrQO_y
z6d_p%o+FKJ5=mq#ADO${X_4KGD5eKgwyO???X*1QHNk!U9rfv3idYNDAi(=%TB2ms
zC){JELSld`KXR-b0Eh`M3)88>7x0F$_gcD7Q@lQdIMld@?2f4V%TIUO8}pa%%up1=
z{b&A`pa{uw+$dHW#@lDl{!D{7MvcoGGpMi~Ifx(q4@@DbPc*A9Zr}`4x3#xZ9$$*C
zecNu&w!|Lz?nAE!Z?}Bg2XAlXGHyF=P`B4td$%%Y-Z$m9USqx@n^39~!>EgLnQJ^T
zt6+%e@Qpiq#LevOIsC?6t@w8E7DY`mf5kpb6A&?k{aWSzwd?XDT#R*}GR!xJk8z0~
zz7(f0Qd-u)5}~LpqPPeaLC}!bohNjaFZr4A|LTgR`~ycDbl~rnSK|?J5hlG4dAjW!
ziJD?eUs{;Cp7HqsI;=U#MBa#9>lTNI|0I1Zrg_xa_aceqMiUKb)pPbn<ri`IZ&5Ah
zA9{+~yp)y0*X7YwJBc74;prbps|9}SkO#Xdh@QuJdI?FmNGrBygAVpP;GL!+k@H!v
zPrN%!-&9}HUurW2r|9SkdPLb^V4WGl-b=;|R5w+Fo0g>ORKJaV={Py#y%y(Q8DJ1P
z28t3V3ND5Vr(?ISe;ual0@*;2yI^aSH7ano2R_lJt9jdLijK1k<#7B1R;9ti+f2I^
zJZNDt&wE3mQmc2$z^SDCnuB`mQ?o6}e75fu#*|M#T{vqhbb$0_1=S#fkPEcSH-Bd*
z&ZQ>lccY%nugFhC5?@}B3OUE6dH?A1dylJEmfIYy3|~hNX|ltXPUek)>x1kYQR3G;
zf1YFx`*M&qTN^q_voY><B$!v0_sC>Q)7Exc3~(^AuL8?6bJ`VJ<)!9puM`*E4V~U#
zfriVpu@LmshUs+5Bi<hp)|S||i?U~>n!MgK{=inxdD3tZBcyOD;mO`4JWC{%d!EGx
zYvGl44wCR>!izP_cG4}LaZ-+<G4SajA{=y`#R}0%*$1B;mee@$s~~=UL@Rb19~rjo
znNJWIV}$sH=6r!StyD0*Vnmj*4=VD$QOU;FbLKI7+{@zGALe-j_dTO{U*yK6(-g6t
z=pS`d<wNAQc9Q0v+PH@M^U_qwOEm$qEi6*=I-756US~#8nUSzVi4HiYJ@Akp6o{8P
z*2*hw5(Jz^*QG^V!&~#40it&O0@mE+IirLxbX1Yv$PD8zoK4*k7KzlAwnyzgVaivb
zFB-x2PR*C}O#OQ|&^o*mTf&nL5A~9MD@LnS(k$lLzGM1Fv?aGSTe*SHOHUbGQ=&X2
zVYbZKFtOy4NBJt~@^bjp$U+q=^YVSa*pC3*{ZAoUhi5j9w{7MYU}9@whd0K$aHg63
z!-VB)J>C=;7ZtFjabHIM8oP;nX_V4(gYn(14Uf%6T6`RAcs#za(TW}tf-6df0~A;6
zlu=o@AWg+xqE$iA)~@~A_-2+;eofXJ>Z#YT=F7U7GSwcdj!jb^x)hHKuF_Z@!?9dT
zcB7A#8j)qy3OjN7KNQq+Nj=20W?SC(>WT%xs-Ign6&(Bz_=!BRjlNUhk+OHpOpAbs
z=mX0ySKYqlmS(h6&vY+|>jOVs)2y5=vTnp?`vV&iL$feA-bTmEm=8wZ(*e|YyNf<a
z5kcyIC{K0kVtl)63}w5mjWumR!3)N};tHdPbY^QDG=Le$t}^S)CTqn0DzMjUkbmgS
zbe~=O1c8>!?9Ta5KD$7t%$DHc$KG2kBTZwOHZ=mejnzgEsl_8Y7e7jOVas{aMX|G=
z_U*<i>LM{L@7ndOW=B-$7K@Ngt{{qQ?DFNEGuadkV{X2(NHZ8VY1T>f`YDZ2oK0xu
zP|ix!>7NQm&z2=Z*8We6c!t{vP_ETMs-m0+@Qcu@K(Fc2-yd}}8!tCqH(QJ{*_aGt
zW_i3&Wml$Jy?#KUK_97^80_ANw}y@8&m$gf!sq*bhewje0Aq)GPOizhQp{uX=f~Ew
z($zdu5~z!+C!dmXD-%Ci>9k1g$W(CI|G|Lz@MqY&x5pM=OgF<y;$aa3pUgkBbywPz
zOZLl{w`f{fv7?4&bXdl$g>Cjk4D*LcBo)YW?~g>RF*DS-U%}kMv;YmJ&;5(~QBP^i
z1A~i*v-sHAEdOBW9xDZ|y0TqlWMv}6PgS*j(2hq7kfoS>$_nv+`qNU{^}TrI?o2i9
ze7HIG)VsDp^$_WcdTm$f)=$}{cF+8y{O+M(c~17c$b=|wF7~s5hb_T<VURWvY0-5B
z+DQ@^Df()za8pCGyE~Om9un{?ZL8yF6{&>oyn!HvT+)Fm$lR*NQEql6O5Rz9gb|I%
z@&Pp)yDBa!QJy>1a)m5gpe?fj63o88GC&JjQ=^jtWGH#iGxB>cV3%|0>EHUM<)_^i
z&QbHH5ByZnnPVP^>KWuv>~ap101YH(bG}tE=t1x)TMLF+F{o~?2p9YG=oCGkQ!zJ8
zKOK6Uis4sugq^*Fi)NY?fajV%Zr-Ee2z+`Lanq@|raS)QeZ0Fo-^g+AoA;zG3kzkW
z9KDe{k{b668g>Zw<N6S1wg@y?@2gTa2=mOyInUY@M*L%jiD~A5!3@R-b$DuC9#-Y>
z0&Wjz)1|gemXwiBs)1d=9Up!5NGE+$7*{>b{9k23L4!95sD1C*%caw&ozFn8sDSsf
z4wsU@xrG=T)@WT*n}&KC-lXsRw*ETzhkC+TU^_<v@=InJKZ$<zn{g~&XG4!`_!@S=
zp(>SOq$fPSvBCEI0`PORTt2$C?Utk&;l^P+_(#>3<s$dfU8))v+;rkzG7)N6qEkg%
zszx$a%Mx<hJ5l}%eOH4$OHy^$keS^5sP1Fi^Gev_AG%OQT+*YaZ4El#d}ZlbUHO|b
z4kkjPyAnK1GS5=HIo1@*OnA&mAPI+Oc?=?2Q70dvikvAAsij>j4PJ-ZL|Tw6o?7J7
zWf|lrZ)sv!49-#{M7}{2o-US=BxUR;Y6<?J*lYA97B6}0KMr(F66*8|mx{2x9(gDl
zzS)@|6&)L#5q!UF1lze0Hj%!<s(;EkgT3!$tHbn{M$)`Y|J+T}`&X2GshuZ?^qI04
z8qsho5KWJj%3vCLt;1ty5$bV;9p@Bj5YOyF7*Vgdlxp)o0)%ybDvPy_{Oj_g#<Onz
z1i)lxA`m5;pDKmTjx1C1+4VGd-EUDZBUv+-KOxo~lA@h57vECYbdCGWOiE+u3KiQ1
z&Y)Q?q80E@eRk<jy>t9Q0k-jLVUuG%GrNftWkt#Lw?b*mFu%}%i0n2~>0ZA9z#{?G
zPx1nG3g&OqiUFs!{3&*r(^=J^$HeKUVhrZhrc7b3Utn?X^Qd!ZnwJB~UF*jVNl#V*
z(fv>qS5E3rBE}mpq2n#s>J&CyUi~VJ<tqpE3y0M&8e(^1frEtolSJF!8#=>m<Z6hf
z^qb(2CQ%rk=X`vU8tVsU6}*_^CNU|QS+zFM0^Sd7p0oXZiN&V1k{6*6XTuC#0?`My
zJk3C$UjqU?;B(hzF$V|I>lj9`8;*GswrgU<^3C&&H?}IbflzZiNcF7Z<9SXtULS9<
z2#$>kdeO+kg~>U`n-{BdljdxHqmjT}79tE}AxmNB)rZN(>`#<p9xP0z2EMo7>R<G`
zr;Jv4bgGVvabb=(Yo}X-$$2q%5et`0Dv)K~ADK*jWFua8d{Q@G^vf?f$N!%g%@k#y
zI?%v9^6TZ91L)ul85`Ha%XJlmVnQ}T6TA1_k_zC@8f69aKCcAe@;XHfry8jk^df}Z
z*8vxcS3_){y+osC8T2-SPd_qJmy_|%K1AmL&%(wPXU0F){coBRb&d<TR^UcML{OLl
z|JVO5510eB9pK7{lPs|RPX~JxR=3AY7o)#+Frqd@-wNB+-*6oMPIEFD=-4$%87JNp
z`7@6R{y4K!n(bassw?vV2&gF1Wyje^rgPyf!E@Oyy#Gdn1mbEj(T_Wi;Bv{$h-zzP
zR&#4c8a|U~`rTo=OIuWlpx`;I_Id7Io(A-i8J_Y>mJns(02@wx39w-atNskF^K=aL
zifPet_P0znyAW#COaa$3imk)G-jyuv+RQscp0q#~(__v}f|Sq1D*S&dAEbd?-l%c!
z{8plW>Oj&x9X{oTC)AO+Fn|0LY;WbYXZHdW_duqeQ{OhkpG$?)?_01Rb}vU>OK{@C
zBH+`H0H5BKpt!f4XQuT-miw-Sh^dBRPS%mH8;$jTHj^x*JDpXOVL909xle?#KdS`&
zy@gZ8naqvX``)v5BW-?6co!7^Y@g%%(Hj1eUV9>aFi)d9-*=zcWee`SQu{O&dgd5R
z3Un^Uw#2+n3$K9xNa5?K${hr9^M}0{N<1A;$l!e<;c~Y5{$ym`Jd<p+)8bvB1gXXT
z56+#+%U{)Rjc1UR>dFzUxauY|6cI@QKop0ESSpWDc=+z@&f$ev8V;&9G612rvx<}K
zgOv)pAP^>+uB@UHPp1>Cl8m>|#uMMjn5^9;ofM;*a`%1X4dd?aZ5Gn8_*p5WWYfwk
z_KGtxEovEpCkmcG%A3?<J173u`X{5=OC1|mfK}-qO+TPOTDsCsaDQ_+o$2V1{}8p2
zQ)c!;H~$5tZRfE;Z!QEajxyFGH9s@FlGwXj4yR0jj2mM$PPoZiRg0T<u(BVC=a8DO
z>1(Yxsw@DKO6D&tChgX`v~#H<9Sue<0G^9kanUi|pKHJ%nqJB3jwk|mL}B=?Pr-`k
zTm3Yo%kv}b+kCl6Y-Iw)VNO}cz^IpEHZ0NZ^3Namx6qsiU7nb|{GdY4^s&X{Y?GiI
zV9<Ps5#hMqblZhfY?0hOgOnu!GslJb#z@47Q;+xw1W0=7|0X^8$Me?Q)in9X<6Hc1
zVD~W9l`a2uyL+i4u{>ydzez#SY8Sh%6sxH~i1m^;;Th2Xo1HgInrW-?q~A71(kf51
z0&V`A11Bn5#y#6NNcn&(kXvrh<)}2Vba!)|-(Bu+@SQaC0PCwXfhc8EtzW8$<N|0t
z1keKWg%c6IcOT@fiTt73;)?1GpPfI;e!jV@LE#?rkvdbgg)Uo0F<u3i=j=OXS-qB7
zj;eNxtC$9bhE>KF`9}%==6djg#pGOpeS@SWy2uY$clYg<B$CnMFxf~&tSY`bWybPg
zEC8pG))GQMM8P6;FGeT|)E#=(6JIiwuW)KO0A9X9%S?Mua7=Q(F%;3OD)301x%TsM
zK@Y*-G;=SGG`Q|uqE5?kn{8*2R;6$;W|;FW5Frpy1={O;=k8S5)#}OQ4qc|ReN$q0
z<+R`5;Ptg?Ml6@=6smJ4ai#Wo;cxhK<WrsnKgMMLvDlWN*t>+Hr#_B}wf--85FMWn
zQSVEwXZWWH9X^wbMvdepI`-WQLB5l8V)xkJvv>8Gfr#uqokIb(k2CY=>G^L0C<auA
z)CjOE?=SVS?WS8{<Ul}=gZE<+t`A!yg(KeZO?zq{K(X#Jwts35lQgXSPq_D8Q8)2S
zTg*O-39^4?HKJ#v!w_K=9&{hK_uYpH`ZLC+XT8Ah<eZ7?<U2(C<IxT%oqb}={;N^M
zlU))k%`4q@55qKz8P+UwkgGx!n9K}g+<I2V`H!y6ob~A*c|S88*^iJ^TzYDn##1C9
zi0z>Icgoh0AnEzc3X}T(ly9;xGZcZ&%{&XM1D{x7E8k+bp*G{lQEX;_lbbX>=4k#q
zMM>P!D({p{XCQ)P^hT&*?)!z-vHfQb{U<ufXnW%%r~VY!@U6nR+Atuz8<+L18-2lA
z6=$%-ZO}4F1xw)cHafK#NI$d0RquBtrR07EFq0k_p8BFPuXLkDnPH<-wjr>_E8d}(
zFx+;J_#aM;lLVX2d~qtD+aCx7I01;{(*OM~<)C!F=KGV#^-4ncf#x;_SqrP1<7dY3
zMri@Ti<lUvOzcOGMIUJ9P_(cfwy2QQ0R}{IS4)X_R4y4U>I>1OpR~jKT+$yLr(~<^
z>+j|7W=+`M4@+bP{B@aOj{~ED6saGW6-U*D70P3tJ=Xq3ZSk<?>)WrbQ`V5|Y<4Cf
zBa?eXb)Q8waxvZl`v->;>|e5y|M=;{67T8?n-=$%fey2R)_zy(aER{ctSr2{2P58{
zrG6t?!DGmg|5iw<cr4^eFOA3YFwK3)aLO}pSq8N`A7$jirQeI_OH-(6lN6g+HH)F&
zU+4QXZGyHc8hT7mWSMo|>I2fOd1ETOR#F0UsLwfn@FALh-y-^6@46!M$h-g3N}EuU
z-Sknmb2{B4;fn~nQ<WY&eAZKXy5Q~4GYXX%vzm6K^JW{Qi#oG{Pw%o_aCT<+Le3b8
zP?G<DNuuv`4}?^EWXa#-wZxiRhm)z<Q)0fOP7Xn*e(@y6Kn03xWq&SE?nCMkok#!W
zrDsag$?}B%Rv@x8cI39l&Zh0chJ=Lj_+{V9shE{NlP65mxXZZi9<4+P&?*8F#=mf?
z|EbsWQmFWaefYoSbH2#j60ZG`Dt~4bo~Dr~L;Oz`-{nrAr2>29PZ!Be<f{7XosMbS
zBN*B1@JKIK6?*v=f+$mrUhS;Kx6gU*^023F%|Mtd+*P%F(3KP_Sg4&vqxjll;**if
zm^Cop0l?FC%M7Pu9%=VSznkN=;%fJpl<lg@-S0{wb5+&OTKSGe#;Z+1dGaw+LH!jV
zDdkqDafqsk-cX5L*uRMubhqq~I&f%;<9nR2f0Q75HBERj$D8jak4R@JjCnrN_;Y<w
zA9^gh*&r)m)!L20(%t=E-s4Wjct^i6&tF7FV_yq-vi-wtaXHCY@&B0ve?Ut0ejv;n
z3CH9DX!bYP;p9_M2eL6&0~;w4UZd8R%-vIK-?OvnXqeD)bG`wct41bs43jYbZy$V>
z^QUhl>hlNYIUYuVK!V!}BIDoSYNw#S^f7{;ZyxV7EbQsa*n<i8eBJ^XPSZmPVY^8n
z#o|Bv4ifsGr!a?&jT@7@g|nRR2|ea!SwF}0x%MTMkF;aG>ah#f8mT?AV_lj}NMVS&
zry?KgF;@npS&l&ZwgW`Zzth&Xy`7DpvFtEM#}>pwdMNx$4KvEksT=hF==$oYsJ<^=
z6%<hc6%`mtrKJRhE&~|pl9EzJx}>`ddO*5!NGa(ULIq}|yJ0|vl<pYf-2wIYeQ&Mz
zhil2bcb{|ax##Tt*`Lq8bKORd9h0(qS~_>z^b0N;rfyDL3?1WT#xN?tHqgYlxQ~lu
zC-PbgYHZ&z^%>sBoZsm_)KWV~3)xQeetDq%E#2~sot3Lthh?<x4RVk8Aa<?c&`2L{
zevS38rwXlMmI`9A2@1G|aB$0gq|q}D@5`Vdf0Fat&;0ck0T%HIg}uS!+kD2dvKt*Y
z;EHy|QOWGokv?C*KA|^kRYEN6qKsy;aH&%}E)QLOQ|a9kWhVqAk+c*u^5Vca%&cnO
z`Hye!VjU;N!2ER`z0tq3su$k_DB@28J><51ExeF(6g26<w7eNVXUll^(T1iic9ww>
zJ;)b5@9C0W7e`YPyVu5ATz88N;x@1wm8U`+8F9;<O;9CdR$8no7HH!ff5j*+wq0jc
zsW$==U0JJ!+E=3`<i#Rt@x^E6ZqkHOZj1g6u|Nify9)+L>-ovQ_I@e7F+*T|;9*|d
zKOcfolYz@MKh1XR?CgE*Bq^ZtVnYCK)8BPI>zoDDXuvo`b?&@Rbc@P1(x3Jqww+I*
z7~Mk;R{A#TdpYBof<jiP3?Re$jM&DWK%!7rk=hSNOWBpGW!uidzy=Jl&DP=5u;xXN
z&O~WHkjxYWPTJXzhe%T_(4U?73B|`0e9i|T#CYZ(mmj;@8<BCz3w<gu%k_Rk-GBUz
zPpj@LsnD@vC1PMp9=V)0=6xWT1<r`jUVORQ%PnN|0-#xs+TKw_2xiO@ZJ78sfx}Fa
zo9OW>UKw1wCIzXv#)4<qMmgPclQ6PJgwXv(9>d>UVk2oL8pxU;&*`%QB(~_o7+<k-
zUA_#b)BS{75qP1#FH(c&q#w$cy}I<52eh*dlDXy#mUtF_HJ&N#dBv+|*RDa%`oK9>
z-xqQT0dvy*<l5|93<Q5U9Qn1xi3ep}->JXD2~`|5RC_ff+n@J3*Hp6XPFP(=<4fz`
zZJA>=F#wL^8zulF#Ro?E7#OMB|3*67oTzBcWIwMJ|Lv@iKF<JFxy*oFnR|8|#zp3#
zJ&Zpb6(^c^7@0GrMdI)KaDx~Fz&(0|e|hMAgU-2|B^3>&fTtzR(5Y4KVehf{^?4;~
z)2eb}*ZQ}Klgo-9-xJ11lho@b@9|qrVkKb3b+`Yy1hOElMAC1+YJQY>CtQ!Xl}#Q^
z1wn1n&pv4ud@7=&G0ym-Lo%(G1<8ID&Si&Vu7rcMGARUfG&JwMvkL(Ky3-imXu_rl
z5M90WG=;2Iq`&5FoBsIU^-#TbfO7g(GhK3(pG+`AHCUDy4s{9VRytU{<hOJ!^4DBC
za^Vi%zh!wGQEP2!y5@WFsGupjYCC5%`YPkU<z=$|z-duAfL(Dj<cnqXr%O?YvcK@Q
zO12B2DYOH0U1B`*D!R1)-$fZUyh*>NTCTe)dv@l}TIQO_WRkvoqHbV}&V&q9{J)E`
zpsBM~HWcWp5AT0notCH-(=Xyd2npg((#P=%US$g46MYgCiYNKNtt8#cM8iO3@t$gy
z#)6`4`X--dNKc~6St4H$2%sq{1}c-oAX}0!#=z&@O0jVG!DD8;qznq@$ah}}Z6n?M
z!OB!WuC)EhE87bK)l|O0KYoz+f{%ZoDiQcd^oi@NBjvD{Q_R0E7)H7&LD`5e4w2*7
zY=B?uP{5+5CA^YKMv_$@-QRd|NA&nX61to_Tt+^;`RIb`wcm@@W_)yt5G*#~px5b1
z0QcR`&h)@H-os_S`(>oQH)qT@@O@#W+k#ojOg<4ZtSbZ-CY|#3wi9P1i>yvYz@7fS
z$^Le&$=x#MXA!B!L%=-)@%P1@%ZBt(f#9(B*9zml22wn%c3=qgG@Fbz>1jWdR%rrS
zs1=FZ3a2c4_w%fUW%&ZG(aFj2ko+^51(MFpOqUx8f?j*{Z)Hy0>GwJmk==M7AQ<w3
zYUPIPu1YZdBEyNyt6~s3SJ_|}RCv-W8QiJ2=8$-(K&WJ@388}dec*mY`<}!!^6I}}
z;ZjUi<oo+z|6#|sp3ZL95A)DHO3gB{JErMpZ9rY!=-uju>f}4Z@zhK&K`_5kg9rT{
z%7bO_0pAcu0Pw}`xE6%wfM56O>HO-P6jk@2dC+g>GwgQI(7S^mBl09`PC}ctOYsai
zR2kyvi))~toRR?mVdq5qsrZ0HDXZ@k-1ypu7d`r)3cVbmZ@dHHbg`1HPkLa_)_Zs)
znL|$={UE3*zIy&F0l-7(ArHWcZMio$Sq}4Zz;MdzcrU4_zq6?Tgca`ityXwLpbXD{
zOzak9f&Af*#Z|ur<c|w?A&|#GXLB5y%<{}-TjQ2kH%#)M=+pY_6!!3@W9}XI?Z<|K
zlH0<Dw?z=}l9zaJ<-v=s5<S!^>phK;k?={DgV#<k|KgX8q=%mY{~Ah@#g^^wnf<6^
zA*5A>C|F91;GC9njSaWm7FIKr`kx6GnNLoJ_g{-24{Cr;KEUDmAI|uG2#Kmnh-Y>>
zmpz2xuSY(WoE;WVl1A|J4Hva!JPdg<w8~D}%Z_wGix%yQRkD1H7QtfK!mHvVj01<B
z*W{8$DP7sPYVX7S-eBtaGZP$UIp=j0_b0Y;+?K9{8BN`=cky)`WV)ahe>IJv>tvUa
zh&)L|^{D>K83{<^!=WUlB$p9z6NFoZXY?P_(W*<ogCfqorkXp!orUQ?=m@;MYPq+(
zw$$6x!qaRQ?xcv1d+txjnCY0MU|b)s6bk+cUPdCd$KFmCXGxjRNw=NZs&}h3tDEEA
zj#M<bX}o~Bxh05d+hU8COuW>D5A4`esZ7>?5iMMzl?{mmTqFsHkuAUio;i=U4pJvC
zyPEZY6poH>(3ZQ}5+m1G3|!`<;}-(sk205=1ga|qw#BmdawBnz*eiOxuX8Q!h@%S{
z&RCNU5Rh|cu&2%?T`<YE6-&=D4Q(lxE!rd7AxKT0bz$+t<0U@MTy|H4cN944xv1hO
zXCG8J-K=JEIv1PKzw`*fkd)2jK;>dfatk7jT3mb>&57C!?UNnd1*>_MueHev6@Gz>
zTF%xeW>V$QuaJg@6Dvs_5bS?8xb>I5*_bs5>yst#J9>1_Cel7JnZtnNYP1*N_t<P*
zAGK!AAL!M+u<P1<L<r#e4dz9_#hsnJ^p`!V)tuSR2r>7pR9I(T6sQy6wzj=@-H+{_
zVBI?RtZ7+x0aZCO4uM_{Iq#bndDizi7vaR(5cug+g`MZ`PXf_8yWXl^ibB!GyN{pN
zGj+L?wzW4T_1~B*C8)2EHE;C}R0=?a;~BCku0IH(z~x3XIQd}HfP>~<tDQ2N4V&PW
zW~FRteSSf2lR+m<`)HO>@v=|R$)F%J0YE9!$Pz~ui%7<6w*RFV{W#~A-=tY`INudH
z>%6*&jDyOS%b3Kd9HRgki*rkwRXLk^Xp0YbG!rkf`NqGc<miU+-;fcwB=BC%pN8)1
zr`VK_-*3jvEdT<GZR+ii`!wGlN%hfvZ62m;d>!16Iw!9;l42`mc;4aX-4vC2Et?VW
znEYWM6}7U33Nenye6JRq1vx)VxAQmRa9M}l*|@6C<x1tlZu|2wIb9z)&H&J{u2Fq|
zq$Kq^2m~d+p=0+akuR*)ow#V<E?R&eD#kRRD|=k<aUnoOw4!qF;|+TyL6J*!cTF>^
zXji9eNLF%XB9qwsAt|IvQi^xhA5g#ihRdMN82gm&0cbT=XZODIwqWk+t1qgGcfuHj
za;R1-YIwgJii^COaBIOg1k%2#o_YMp9#YAS0OCiu9e$?90oK${_H<(D&#g-wmzM*c
z5sy60bj7b}5GI9_IN1#7s=Nhu=|y0aslmz2K#H8>{WnEE6$ty38++sVRk8Ok<u-%8
z@2PH)pBP+Xfj~-Fm`Oij_1AA@gl7!h>JGp2^kV~k8sDF+cP%69jCRP4ouRnM9%b~g
zA@)gYPngBERtYu0Io^+=uM6>xmf`uKAFf3CC+|&+{{qlU?_Y+`2wr;i;{kB$N#MB&
zpz%OH2S(DRGJu}%2mMRMC(Is~;fLQAo>um5F?z0?-=faTw(^z^P7ce0q{>AyI5xpA
zkVY!!6N+V&k>Wt%nZ~6ML?6Yt&iw6dX&Un&5b4SyV8I69c$)KUnfV*O;T`ipu<|G&
zZdcs^QmS_L@RtD6xIo(BtCTNItTh@SC3W5fE?>U(c*LD0kT;hr+OedV^iRz~!-`h@
zfp-5v<H}6|tEL2A+8TsDr&U+N#K7)K;xld2EwVCBm};e4{zS4OOqDcBm}H~s)(38@
zuBqp%qqt{x1}EE`Rytnc>yG(R(!U$`=l7be$<f!&3_$G8aheQa2YUwbbFGHXy;>+G
z7c*v;t+z>+5_hA-KzgvR>$X*y(?udiGi^hM{zBkMjGw14`x$7Hl5&TfPzq~4cC00a
zQ(>=B@f#>1SK>ezob{j8OTyh_>!A2<bgrLp>IIqLID5J26INOpgm956nX{P4k7eo<
z!BKcmCR#>NN&4!2n#G5y!Tq<_9|SP}-O{KbRe4c$w@&Ige>&ZnceHjwZ(F{A!~AWX
zKUSOU18u?T!P$v90GpB#<jt)jD-r)f0zhjWXSm{MTTDb<doI!TJ7Bxc{H{wrwEwp4
zPYK{dd+qalFh_l-R<$#xD#ZSll9U-CFH+(T;6~3~nXqBX&!}i&;*F|{bk`{>4QD!A
zCqNWvD(aD`j2n?oRMR$ibLLPR?YS|zTJ0?cp7T19(6yNm#oiktR^NX9Kw4^L1R!|1
zYXyZ$zDrZ!^!locTjj-7>_K3g$~jr1Gf*i*W4Brbq(<Z32Q}*B(Jc?w2HmT#!|5m!
z&rk)5h&<9pI}7Pt`LCp6($w~9gsRMnKjZ-;Y=n6<gQe-VBB+&|8c;y-40EYBn45t0
zXZfClWdjGX&dM+*xxT9b8PLrLq{SUeU}a8AKc|2<<}ezj0()NBpRkpA6j;VhXDj@y
z{Du)XraJ~dVkLVR1>XiR-7pLxhR2_SNuXOS&@EDPx+Mtj&uU#0Y6}++ix9W}cBOOK
z!pnW0MTqLk_MBptg-ea%d`C+4TGoB3F}f#<a%MmA?w0yFlQ*Z{zyrDaSD&do5UB$h
z8hx>(2=TDe4pY&lxFpNawa9d3vna;)6~MYE!lwR!?um977OV{HyvKo0DXx^gAf4mG
z@mEw7v%peaOg#F&f0!03YV+0@ixIB7%74Se_Jy6>mhtKuH*6Q;y_rcdD*?paM&>Jq
z<lX(`9hUFTm}H<7N}ty-$Mcz`Mq;GpZ!Z>_dEm>t6LpGeiQfmXY$>G>5jAm*lwEhO
z(XJ_#{(JX@_JO)8jLv1l#P3tj6)gT`#j~UcSN#=Inkfh%(CHL-?lQPGwb6HwIheYF
z2q%e)d(eX8ZXYAg5WRrLQwrm+FG!jA{sQuKQp6#lno1JD^mPvWrbck?_+R%EDb7pD
z+liOLQY7}%ap1(c#JtpCo>&kj;7sp1<9#wAiHc({WN6>fyHEE}(fdv3l1ei)e-NRf
z4&D1~n;PB=5xFgP;IBmQx7l(xD}2-EVemP9yC$*&@4Z1qnBoj3Xi0l0pAkO&lqML7
z5lsa|MCrdqK-wYGN)Y(?TwR*W_5?f`-LHtyISE^4!MBfCXlK4JIM@0``m{Qc3EUQY
zO3{+mPp&Er=$7YP&gt)-2Cpy5CE4a}9%f8|4fqh<Xz@Td^$Gkyal@LOo0nMYkG@YV
zSBp}u__~bJS4S~_x-am%<UO}})q9fM{Y!thbG^>Stm4ohH|oAWoTH7lxg%R_8{Qi%
zpSu46F`t$2WCP_Q+avD{ID>u7FBw#AuQDkTE>!>3neXbK*ju9K<e#kPv~5CcR43(-
zCHIJn2_q+9mWt^Z6Q1_2Qkkrp)Q7p>lw&Tp=KM-WYHnOUR}L~oJSzoe)`d-ybf3Ma
zd)jYZSr^O^E*&%}T@pWQ2?5@;vg%Eqb=&ZBsnn&pdM}d2yNT}Uoyah`Yhv^}cW|-B
zKVuLl%%#(M60BIO2Z4RgTFG{NpkexOr))nQ!CRa;p|u>`>1QuWh7)jaO91nj0X&jq
z9J;&_)?X9um$KmJRlB!5e3yza-4nsS>KXV}#r9`^-*o7Ts|_av%Z|{qy>$~8P|mG^
zr=a+^JTG)@E&^l8dW&O2)771qHJW8oXF7c@NQa!d$SI6l=~|34o2U|!`!a1w&OgD~
z34I7q!l9WcjZ%ZSKyY!+!9y}B)RHbB(*h%mreTJj9sPIx(O?YVG}uII<3Ab75Lf4H
zJS2mhUykF1Y4mRe8Op$Hl(#-{|8bV5HCzT|Bqj7!yOgM~vZQcPv=ucHJBGA|rY|i|
z{B&{|BhM*QonA2cEYbSp1Bq#Nf76^;E9SLuruh<4w}Pnz{>xF8KN{Kw%u%KkOyId6
z*pBLOlo=YKOr1agT1&4&0381GHVeQ42(H&Tk?$#ddFryn>6R%E5EZ7`^nZk!eg#uN
zY;jwAtj9XWqE(aaK*!mOybAOl-UELce$JsSP$TQc9F+>|C=VX!qJ3n98U83Wo|UzB
zd$vfC299S`0cq%%rom72VXpiEDDF3{xqBik*^XM$Xj;Rf!<wtg(#Lc(0cokh^eXEQ
zShD}cxfrriClWz7`==Qc0=J*nakgyKx(J28kc@vJxRcDJ(Ge5UN%I{IaGf}0dHeZO
z3TfQpNc@+2)W_Djy~uT_(Y_9}4vgTLaxMFHKRH2py^ka8Qo+0LJKV={>i(m5^u7Qa
z@gkQi3o!nZKTm>D6!TGUJ*JggzhAYD^mu&o^WiP2Y%ZaPBLD_!Ic$PQ;zcU&UKGoC
zf&ULVDU53aLy-|Ae;QJP<69)ilaLGkZ$F#~2F$ZSV&MT~9rTxQBK{c!vatsAS?1X%
z_!Ne;GoK|N`YYJkOOya4KH$|NZ6Bx87}EBW2T70@g#M8Xw2OjX7TLy6h`dLYAV`W*
zT5TITD;s=XI{b1iPGLvnlaS1eQPQkvr~!hy=5+D$6AIZo?mq#I;!n`i=lr$JUlcNO
zm)@BTF?LC2#oD$(-PGXeB)Z9D=u<MM*FYZs2t<?uN5-=WD<N+KTFlcAe_^ZMkHr=5
zU3h!=C7QO?-J!BWyeq{LEf2`HS2!K0O+l7E1zUrD1o%;F#OKDD$g0$TTfwREb;HI5
zAA0heq1&Vto1ri7^1U}UxSm4j-{Y)uAu@pbySH;j3V>MDzWLEtoIzzAZ$9bb{REiQ
zUd7>7aTPTH%vk*5xyS`lyyks2t1rYa8fJX)2Zs%xrE6!iN^%p(`yq#fuMX(cK2dQO
zU+%(x4Nksu0YLLCQ(>MzvWXt5eF8y&zU9CDDHcVt=&{9&9`-75KDrGl8!0X8QoSx1
zG(TwN7j1JgVp7E^oShDzSgTv}1D4x#Koi~QjaGlT4<rFl+~k}If1Idd(U=+<SJbiW
zJBb8Q*|AQg06Cz_47Gb>oyXK|dU|9!Q)AfYti<4!<rPDTEXjEPf952iP&W<-g{_3_
z_h<d9u33<UncDso*i{$dJc^YvUXye+|Coqdtr7`ODZ)(6f^BeN_8gf}UU!|Wwd~$W
z>tcL2^Vt&pc|nCguFlYCL~y7qwQptKM64`gbj5hJu)secko1FdRn-%U1EZ<uC4IPr
zXf7<N0w_jl)JsTtf%4N!{1*3o&XUNr(q<+>IsRSpglEX=@0YTbDb;mj&H`QDfHdG2
zbUiZ6nz2{H@tn3O>5JZ6|2j0s)SJA;2F&sEiUTeF8cMMPqnXbmrU@zVx?i>eT~^jb
z?~EPVZsDj4DsCmIdJ10TGWg$3Ouo%NmXc*~srlqAvixCA!WsW6yWvdBeXtnd?!xg~
zB@XPbZ#WP8MPhE<-~7(>;pg8Hze&?vFi>;iJWS9LuzvOP3sS`^X&bj7kO=y->Ie~<
z-3PPI_%AX7{$pb&%K&V>KPEQ?XCj`OxHt9m&=UfRV}>`XQ7nTh^g<Yk7=^^YDn8ES
z8#NrEixsDi+eFP)KfG=g9q-pEvIZ5>u%q{A%V`JZ!d}D-l+$#u(TzHy+P)NZ<<SU@
zJ}MvUEtGLdooY0}M^BE+pKNxex^Kf>_tICs6DYyCs-n-!+AvGHiUlFnmUn=<-FoL0
zlr`3S)LQG)wwjJuy+H>lBcN=^_R;mY0Spj)aOLOCR=gyjxWe-&`9yCE*WhTO_rne!
z5bQfpY8w{;6zO>GRg{sl^0Sm?Tv|gF?R>ESm31{tOnXrs=hP?S3g%>6>3YV%zyO_C
z)9>Nb^DBDT4fBGQr`5Y~S0__H<fWap)mcC=p}2;V(i%~x`}formA7r>tv^I1+u7=F
z@@Xy}u*B52+|8*c^6hb6xsI#J-nRVOYo|~v$;K>xz;Y<1m3qiW{<nA+eI)@Pp1TA`
z7~(QpvQs*+02Cak{QekJ<Z)g_DmtH`ciwFLqf0L*ul%hdoxGw76b{)c@VQXtZy!Z&
zsSp!<vHoCVU%Ly?nJg^RqVr7=)laJDv*|q~*_AvfgZ~I7!f7SbxiPskuKW)}T9>D#
zlg3y&B5iG$8r8B;1o>~;yF~X^JIPn9O6iyY`lug$JG9k8N$M{D{^xjW9EinL|7;lc
z)mEu4#!nhPIBx?H{V4~myrnySSG^43!m-MS_)`Dy3N8vgDt$_!HvUk)-~F#!AmQ%_
z5{_zJzJ41x8HC7NW$Plm>X(1Ov3gB-2|OAh+vo8J$T$Fm6-U&XGo6Lh+yYSSA2M%M
zTYvo~&k6JX)t3QlF8Jk5b^$kI_shA2+<}Daj*a+tNGg!N=SYf?U!wc#;U_m@^8oGc
zNz{HagdRw1E9)1AkPATB{Tar-mGf}+s#z|0W034G$c`1A1LP7qCCN!U{BodR;oHK{
z+@I_3tl!GHt$%dYEC6})5~;ZOpTx#%ec#)e)2GoqgzscM9)3{MZ;uJM5RA0D1b}2S
z^8i2Vgf7rW+C=%OMc(-cLh^G;yMAlm8(@a&f8Mn`I&dY+42ZW9x#ivCtZ?B>GyP+v
zlR;P{m?8)GWgHjEB`%f<1RFiOiVcz?LBWinL`D226A`8ht!G(FB~k182UX~HJTTjT
zXzyuW1;*=F(Oo^}5kmqtbDL@s$=&Weq;QOfyvmip`*l+`AwYGP&iVtUGoAnJt&gN3
z0U#4hu>-f5Cx$tu_XgA7b@^)o6!y@}Gcz|BTO|QCSBD^`KTOO4uL8hY2|zXq89H@r
zf0BZ%jcn~}i=@vgXE9W>!YN&G!gZH~l{{b(f7YV7ePpqMmZRd7h&KEZX#VkU_1S(Y
z2VMw-fsYw4Y9c})8U0*RAbIimF`J^LdICVGQSF{pA&jY;Ug<35eUxfL45Z0s@S1oy
z{5Iv;tYH>KUw*{IiOG;=^W}8_sG8XAHBf_MrOj}e%9!<0Du#;DPo!K+7uKU3Ky)@~
z7z-dtYwRai{7<T9Z*YJzp2YMxw_IkViJNv05i4muh!wQ!KIr!dR<QEdSP6c_Z08dI
z-=<@x%cF9CK`ew@J!g|=hyu~TGyqI2XCnro)tY@MKa;wZizQDwVh=-KzBBviiDdjY
z<-=Q%VQL(`68|&&6;dt=7y|s5oQ()1G~d?tCzZX3LugM6(Z=}J8eHcx4g|do{J>q(
zn#(npirY}Q*G@vcu$wQMoa(l|Tpo3VIb|1cKFzxy^3z7fqZ&<#@p!_3W`{%YwVCm#
z-CxuSTY3;O2H-9lqTjGey}cIwr%npyyoY-&<aT@9#wuen&F~kX1o!3i1h=ci*H7F^
zxN>&FSG6ROmGwGpyg;EluF<n{1Zbd>B2bkZGxcD@YK_a{!LqI(RZbJaaNGa&bzmE_
z0CqG18>^9rwiBgh7XRtcDF{m|CdnEpq#{_+@_}PtK)Viqse*4$#INpM)<o0pVx}VJ
z+M~Vb+2B2uuXVcG8I1Bu%dg&tmPSPa&yZH6{BKQJXc316XJn1amp*J1aC$)YYY4P2
zMocZ<#>~xS$U)(*q24uh)#@gin|DfYx+fN7Q1M$u8I5=SwI_+lB9kd^(@0*X{Eiy=
z&7cW<ZkJ#5)APj9XbTf-WTLH^8_V#-vK7n2TalC08#Wc;wuz1DT#2JIf8InuHE0gA
z`9wO?y_0||>jeDdm6@jRg#C~Y33;f914pnXI#7o}pTABiIMl}KUWvguZ|0s&54>O_
zklw>wC^7RYBS3)v8b23EGWk5OPVZskgZ(UjLHZwyc7`;-G2Mb0*%(R`wmiU$vyC?`
zFmKYIQ|%^TW;$DW7+2>%cj-Pqd+V)UQj${XB{1pA@3z%P;Q@|246dfDFH_?Ke0zSf
z;~4^P&lsgAiSpP-RLCSRzm<JC`sm_-9QY4}TYH->kE=Y7NvebgCKfJfrSIValpHu%
z%8KG#G}U*EUcK6Cte<X}0QiIW0OWa$;4)6n&F~g)Qy6`8khdGHomFk?W5x)AK&&Wm
z1vcLL9wR$fUVhjdh%pg*3B|*8`R9cgihJ<57Ts{?#5C}0Ol{`K_r5qJmsI2DD~74#
zN%*wJIpo`z+Phl>*`+%74E_iLAtUU7TQX)Q8Wyky9=uSW0CA$Py%J-q*42~5w3yfl
z8}t`2#y-03*&h|Abc7wK`0rHWdY!Vhi;JB`{AXRHAFX<$C}dh~(1FNzLO|IgZi}&m
zt~s}zvZUI%LQn8ED$xPq&f6@ab+cY9;ciB-eYTvGER7eVmGd4loR;t1YkWK=vQ@6M
zDnvHH6<L_!*)02?iGj+`KTfahS8*TZRyH;nh>nMm$>`0~stliE8B%H`MgDlsoy@g?
z6q<zzHK5c9$T+rHE*oxxfqFH(f12$2`tai1yxJ0gDtofGx1&#wXDb&>Wr#;E?rhKF
zt0YTd`|u#_KpN-n^zBdoyvYCbuWhr=h|N3xT|BvxGS=guzw&x~Oq_P-3oIMzUUllH
z|6t5zOf0MMz4K1X>!K5SIN~zNsnXc*m3_|Xj+%>}$wXbz?&g=HSZnu5{fsS_bQh?`
z_H~;JG+q^G3+FP4@J9#1x}pW_%T}f=at4$|76$XNqUAw1mE7Wsf6dl}U>X-V)4fjK
zxV+hO&^CrlHJk{@-P5+bcX^|c2oYZ})lt1Wa&>fWSghi$@Bru(G&)NU-gQk9A49Ef
z-mBGBR+;Cl^4;Zvq<VR7794HHxOQ9|C+;2P$w6tn-5=bBDvnk(Z<$#lJo#EybH!P8
zXv<8iJP<3_mKRu~ES!kVZ@Y?Cc|AQC&nur0u285xO@~**Gbw1Wc?X1w90e2;?>B>z
z*T}Hl%wu7l*{k0fmc|Em3#f@4w#wj^92yBuD+_v))fRhQGx}MWTsupZQKy)23OlEH
ztMJ9osE_)`WX41pcVQY4>BXC9GDg^4^Zlcz&}R2zTJYS$GbnWmuaTnX$@s4HsQhK^
z7iK@iP1<`%K#e*Q(2f^~<f4lp^UCe%G_(v%u%_V^2~04#^TA4Cv6M?1*F0vN7Q{pI
ziolh<r#p6UNe&`kO-ojUq?+Wg#&@<{JQyfTKz2^phUPcB3~7$8tWJc)mcomWy{jPe
zSDx=uGAWAXZ?1GdZbeWaEX&|4&YPH0U!;-9WunwE$hN<hkX2#97S|?Cp*%FfPNPTz
zDi*`YB>a+SLLY=Mwb;6zjPWRwHl3{52F;%Aba0E(7If|31?TuM5Sg*<G*F3PPF&Xu
zFhkv%h=Ai-j-^|k!``ErmNthKBhiPcoPN<;VPgxu8(U%0rTTloH$tktVnX7}h}h+!
z&zAzT=i8L+u`lq9-(#|hD{j|5Z+lLMK(cMD6+VaZk@XFudpuqs>|s#^UPj3lFfArO
zsRLbTsoYW<>SF^a0sK|U54nq8du^TQj}-D8-WpnQ{7e(KY}DPq@)%}`8MB&vBW#8z
zA6k}BKJ;?JWS+oDZ+C1te#z`KT~&d^5L>Y)=D6_9L~bALb!%bD6_5)?bw<g`SB6U0
z1e}H%lV;7Dbqb9+7NfrOn4HcgZg6BS)u?2<qkVkkioT=hmr6h$;_ms|)AO+dk;D3Y
z1DdD;K+KIkju>%bjU$20c8G?1uz{n;m=<dUbGWQgX57;Kv8mm|1hpxy5(Go$+nHg)
zw9lcP6Fcwt!E<(kDb-J)9&<b#y_BE?Lsud(MlG)lE^x)5taYW^zJ7(N#vKu`5wgs5
z`6i43p$0CK1Ib2Tz^k=ez;+rHMXNwVUWrFaLwV4=Qebd}gg(f4o(?=Wt~=P^4Jxg!
z6;XxqZEeN5n6zi~tLxQEKqKV*kVaZD0}BwSY~8jFpJIIVZ$Z=c4a`qTuo0PN-!LO+
zY^~EN862I^Vta9oYObHRA_z$}(UFo0O4ummN>3|hIP4WT<n%=XKhyY&16(0KshSKn
z;;9r2WYm?(f{ffXjw6P3lyKzrgd(F|ZD3lZEv{Jz1(2PHK5r1R9W~50jR-`_*uqx!
zGKx#Eg_=%1nu|=$o&iWI%Le|n!2jI}<g~dv*2YP6{1eih<B2|Oq<vD*7r9BzLjsfM
zrUs@<R~=3ZW8djrgXW$Zrhpyo+n__b8w=5>Ld0|rd#DHcE=i@xXfi!W_)ywrq0pJi
z!=oKB9V}j{ka~6-CU!09#f|KtVnSd?k;%SVR+@>;VFwM7npxm#ffjoci)aTem?yZR
zzYWfXSk(^D7K<>+|JC_MtmB23b8(&#A2E9Y*4QN@DbEGP=JdU1Z_p)H^2Slr(y^VB
zwBT&amG0x?dpe_mMUV#9m-g<0M3vPuzSi@0Og5{#A@Q;Y{?+y{2YZwDbn0&@`f?9K
z*-hlQi3&K^Nfsy~jq9qAX1fiV*M)jwF$q|3TCo|g^F$x;UKiZd!l^67q#d28@QoI<
zBJpAcF)j)9U7awd2cFT+0;&<5*0^^`1Xu?SVyRpSZ38a%fXS1MAqCH=n1NW+i?y;o
zAg`TzCqH!=Y^y~U*6KkA=T<QwbM51<O?QT3B=7@6TqyB;F8GlROt*&hk)BvLa~`kb
zVxhp`aCyqT#8t$!CNz51wn-<McWyy5yBK-HYyP%*JImVE;X5(k7{J%%7qb=(4o8V=
zL({qPxlC@D-vBj&NMUbaPobL7Zt_7N6ANTp>eFr9!CNGMj{mzf!SK+`0tt-3#3DDw
z1vY_lg-y(x!6t@&Q`y<Oj};>?&C5J)r5zg99WrMFrpu4lk#>pKF{Xl53=V}&2o6H>
zi=Q~aC{Ao(6tkh`%VLA(?HeT7dhhC_=6M-`k$gaYMWzA+>meT`2mA6~fxV&jM@H`x
z{C~$&1B`lD1<$-pT;cV}jz^_H0>khP#jhB~6kmQsxp}^BlhaoDt3y;$k+Fu{u4v+%
zzDM_vn`;^DA#bhN{&TpzfG&FbC$kewaI}7ZOxMi8WEoHI3Q_t*CF=s0(a44$$@Ony
z?#mxY+-~kTo0L`StPE8Wc!>7$ZS~HZ?DLSt^wNb|cE=hX;_TjE>9&)GW)@o%xZeY{
zsfR=fCv|ITdtC<>(+f9~e9Zi3^O#6gj#6R}tt`yJT~tW^6$%JDE@Nb%Htkm?`SA2&
z2#sl4v4YE><~$~o3sZ^|5;B*Y+w>YyrPt*_l_76b7A;2e8fkgLLPY7`^A0+GbVMuz
zNuvypa{)O2Cul3U*{-tYMLri~Y%Qq|Sa!F;-eTboufZtl#oe1gcB>#->A~2p%L}ZQ
zDK5`Bw4fYy5Sn77QCz*b1yZ*Af-8q<J~+#q4UFWy2f~1^!xn*mHn2~~D&(`#8l=(L
zn1}wH!yUIjKL^zTVgUh+FohS%ThSk6ZXtfedCxA2S4w0smSJ#~CT&M;tLaLYK`!%{
zJn#dpL#E1t%@It5dX;KFglCyRgpo@hoUwr^<X==fLk?w}4Ke{1fu_eoCk3714^%g3
zy2!f7h4)$~IJ=KM$UQ0V48Qa!JiG_G`i#OvPbP5E@WmG|AD}h~_@ETnsEU)G*FzP(
zoRRE?1{bAa{N|^U2K}lamt-+tJ>murdzSEBgNw&wTrTU|H|Z2eN@^=(kEcZSTr=84
zQU<$_%;H=c&x`6p3w}i%co#tkX30KX9^T+1lNDj7oBK@!rdjp%D(Ra2)!EIzYtG{}
zA3Ir_!jaj=^ERoZ%RPG0zq+$zm1~HifECoODR!tIA`K0hAL}!J4(*7nbp9Ml44W-A
zUycV4?pE_*$0BT=Lw7~A5fO2^S7CzjSWRGm4Z)utJk8}oDS9R1fp}I|{X#|3XZXn6
zmg+?oC>bi_Qo7oS)@ry|>UgXpyZn4x?M*zQ9lGz2?o<IYpU;J^4|mIpKvH#4lfYJ*
zhhj%Ar6qWH<+Qyrqgovp()8pV$*fE89OI-(+DyJ;7G9G~m8P*oda}uth9%hcKdKF(
zMa9v;M8RLo+vmB}Bf6T)PRxwjGdqslXTm1s*ki&MH$1_+-AZx91zjZyf8$B!Om9WL
z1K<-66r{n??OOH|rlhb;1yRcgB-`X1K6)NHF*^zp&NE>X4X<H>$?pTeVU<?NtbKzI
zr3*G1pO7cj0vp*?dxumnN8j*D%*MsW!C{v`B;#4&`qR+{>11!pGH0b(KBlgc6<lFi
zkL1vWYR`|kehEM>Yo%2n^I=S2BWgGKP#|)eXcG+anOgkN7h|+P^#-D{cmw&_j4pM@
zc4V50MoHu1a2TpPRyMbw_@Q||JTx-3n50Aj3hv=%_UdlyLpGk;wo^ofXm7CdMi=H4
z6(@kq8DHu{`wC-M3vhqQs^<+34l^JOAWqf@Nm$2zBPtlUFJQL=aT0)xtDgJhpsi|h
zCpF$V9_t#x5|j2!dk2<J|MzXVd=Z;qtnJI-LRo5%!OBm8&*KJ}EW78VL?AochK7|T
zq1oEdy<{Mq#Fs5)6cc(K#C9L!0T2}pb_@bS{?acxVDd~sh)UcYRamXkgX~yDH?RJQ
z$VulBc^Z^AlBv5V4K3HEvBLTy%@#qVdEJj{lh(|8HCLh`^6ABgKP4QSLsmW5c=>*D
z(vsGAJ;^N|We?SMl*HZ1RoH-MD>`EK7Z1PwFAh-NG5(~3M&er`FkhQcfs{B%`*$<1
z<2GrhrH<M1LNuf^oonmf;A+b!WJsq|X9P0D%4J3ui0Rzb5>QAbXtS18;qNlQT|S`O
zQ-wenQ-XwRW|il4dyG8AfIB#tC~^Cm#uYO`M`8v9{=l9mZK+33IVVB~6|3yfckL=g
zN>&5s+=ObZZ-H1z{I&{B6p2&5(b8tOWK^bl|3NQ*mUkq`t`_?$t#~>b0^l+ALoMe{
zM0!W<;#|Kj7XtQ6OwGh1e6f3&ZK(`&>^h|G8dp*$0sXoA9{G9Y6D7E$ZsrQig45*o
zh+frGI#pS#Zrb&o1wjHiqW}xe@zk)D%P9mUbxrd=z+d^ezff#_k`-k3TNeRe&=xE+
zp!xQt3N%bv8YU@~X~xF=D7W}$P6qNJr3x<}W~s+6`M(F@D!lh7qWaHFBIL+`{|*Na
z-h~+smYA`XL<5$uvXBqWwRrDowE-8gt3tzU^3Py~V9b9Hmgj?l@(s^Tq_c4UwUAm0
zM3!(r0emy~Uev{Y&6ihlkm=msprF<Zz;%aeP@Z}k(V^@AIrs?gB~+Qhdy5FTe3-sZ
z((nQ=AKXC_s^tL(1^uQpWBX#AQ=C(;43pd;;=RYq-A}H3=ElTTvXJSAzJIR)8u54z
zQ+7=&21WvyosZ;){BfZ2FDXv7msLGZw0Et3BSNq7AFjfG!0NF%3aXRG!9|cR2kZYG
z?upKM*JmR8vg(b7#3xEPJ1{$Ut+wxXn&|d;BRdhNhMTO8BKk3hcNHr|cI^X@g;p+9
zroF=h?4h!b&BwpF1>eFPz<b5Od=^1IY<^IIYE+7Z(1Q>Fyu8~3Tt>2^tJMGlj1VTv
z%S`*lL4UR?F-T%5@CsNROX#GCFhGs5DfR%H232^g<8WPcC2(ckz76wPw+9<lYXW4H
zQZ6ZA+*3_GO6?yWVGn)&pB+SFCsFFy2A$F!El-)kpu2hb&OvSW{Z|^`1;iTDIG0)&
z0DTwV?!ZJ#W|Lp%V&yAU8~R>K##^y&Tsa9|<*r6ws~oz%+RMSuS~4-oezuK(sG*g+
zvftxn^Kw$aX|EBLQ@>FiYi-;2n=<8q@MuHd3HZ^oFVy;zb*<Y2hXh*L0}D)~hPg4T
zh%Sy5k1sL5_usHT$>oxDsW53{03m4Vvt?H7)%2lwUQ*)RE$LhkQFS2OSdR%MoH(1e
zkd$Mx=TM|>!k)4OkR!swfHJ3c#i`IqQ7lN9xCdA%X~kN=N74^_hE+K0S*^MbW5I(P
zjicVh73f2M?HjKil_xBcgXuxl)w9aPW)_N`Dw_FsKz99u5M{uT?jmp8odBY*p=BM$
z7zM8o+tKZz5rJ49&+&g0BO4qX1Nu^YS+o|IsRDoxRHx9H4=UdQ5-4(e@n2;$$3+Cz
zWY#ObudM~kb!{Se2ib0A*LO_Z+^sXWAcd`r@K&hx46mv`hvXI$PNJ)7)3K>X>HV=7
z652E_OeZ)CxDv9|2il5D`IfQ|2pfu8KtH%V4VbvIJgq&^N^&k&1%bgP&r+G^ICPDc
z_8+fSPf~B%hpbd<?`d@wi_+>sZ9@cIUFL$!&f^emq<$o*ZK9^A(xknrv^`N99F1Vm
zUIYBLUE9{r^y2Y?89P$IZ^POXrT<QzD0U@mx0W^9^FzIZ2HWwKBwTXFzkrPgd>E1I
zly!whjP#p{qSR#pZjAMyR_cc(-oxInMpNm<z1H28tAUx5_XrNn^0z6s+2ijlN}|G~
zv%-$~S`O)80C?s+HZ8J>aGnsvc?3s$&VfQvgAf!l$*CFcmU{&)C{k0P$=@^FBPzEy
zPG^KnX_q)p)4o2AHd$WK`=Sk8I3|f5r<+@-NT23lX!Go&;rhQ4TDd*00nKq#PH|PJ
zGSr4v71rz#3<|=M^WJk}85j=k;^#E82x$F#?7tTSdwY)ya1@gXYtJ~*mIH3DvJOi}
zy+%3ew7Lf78xDp27LB3IBOSM>uO%FuHlECT9VwnJ(IU47Pq#3qmZ!U?NARP4{n69Y
z2CpOQQ|vAVb$S57M%xKr8TIlUMm#GgIhI{N;-NJzPmVizj9xh%?nc&;n2@c<BZtY3
zw@A!IhwDGWuUd5+u98FsT%q+kN!wQjKB?J?s9Ro!13%Q|b@H^3>y?ohAPl`3-KXt+
zQx+5}DiPuEtlq4A_h-lYsY@2CVS}i4Lw{|;DdYOvP>|+q6VIp~nJAlAZb8k~Zxgzh
z{MqDr&I$2Kx(4S`^)4ppZ?@di>D|(P1&W+FJ|~3(R0JOHdPhwd?@`Pw?~1(DiAeMO
zzO3;Nj0REp!T66f(PqP~>g)q@tF3Co-J$Z!um`z$9(aZgcRXx!L$F`TtAoXKuanOD
z^2u^}Okwi5Vy0@+K7__TP->0ZSC9Wv`P(+VR{VRx!Tw6ivahxJ&Ck8%-&8Tm>odAj
zOHamj-wp4T8fLGUSkA1DH>CKIfM642qcME;*21ZKqIIi{Z8tVQMjQE(Pb%O!6N^2m
zKE`l$e}`!6x^!O{VljE`yBL<=O7}}R#Nl35ON-chjl!pfl`3gI^$jNSY<<r^9Pzq$
z`;RQ65QhSG>5-~aC072>awMm%A%Ry7Ns~pDc~iTgpVl&DqKkmA;*-sc(W0EN+SGWi
zJB5}r#PN~7#0vhSJ_W=5!NQ>IW$D4|4h=$v>FVm9G<#*LTAUyH5}L3wIhdf>4g18-
zy>G`@mffp~X(PV}D+-Dz5jOK7>Q4FM`dQ^RWv|8?W#F=+Sf?Y;Ex+=Q?AVQqbp(^&
z@*I4qjxJhHSBG}$pNz2GIBoXTTjQ)yb4=;f=eZ$6bF?xz-e(Ne+j8Ptc`hzA>pQop
zgx2AIKdN9zq+aP#mZsh9%&dJcf2C%q$<LB6wym)|ZMH|QU8!4xh6F}NyNTVoIC;2d
zY~pIv2i|fQu7K6?@Qc!f5?jzAXzS&dIAIly<CV?g>z{^8Je=S@CoD{f?#4~1Js}Kc
z2^ruY<xQ$QNTeW<&z<P6876QGZ-7);DwH%V5+m_aY+8bT$OdWSD^ctj5Om~^wQsW<
zMR!>Q3U(cm4a|kp2x?L5w|4FMRma%57sxBD@RXQnVuxrIBslSQtm(JK-kqM9jUo5q
z0u3Kl@_s(#<il>D9bgA;*PtX{)!DVhvU+CcZAMwcGTM)Wk8DoqygV%;-LeeyYU<XS
z9^4XU=`9sk^{i~D*_e7hD$@3h=e>c)&3U1lB91PJxdOM|U1~e<*#cz~bvh=?1=;0K
zCZ43U&~$|!?`XtKdswNxgY<beI6~`oE!VPjiih3^jn+?Ks6Zvj8^`We3Gg~5vjsYB
zI;WYp);_nBRyKSZS5Mj%Qr4{sJjy1;8=DKg2FK?2->x+{x3?;}-IigPQd~oyY$yI~
zdnYS7p}#oiX>1~{-=-%?YOvO@fI!S9uA18OcpkHJ{O;)P(1XPte5KCmm;!!4%F0xM
z2mi~i=TzC!<*v}W9rGI63o+R5#{2fx&J8h&@9Oy79lP$M6=pXOWtB|h;|~IyD`Qrz
zSmUMNSrtuqX%3h`_9~8(FsrX^SN1|3HEA^}9nf1R6=KVl(B$sL6Rvd&&$w;0ddOP`
zd83xe`KY3pP)kMXj+H}wzbNC&^v8TkW2^2*&PMy=7NdTymOGeZC<#_?m6qCTm39cq
z^g#yu(tO9sa6bqw{(E`zzE{PE-BG&Eth9sU=2*d=#gmOG+ErT4kck$r;$>+k?s?96
zJM^AApJ&J$>b<z^QaRz@2B%4Dw4Om5oLfa4-^~bjnvVJHg!E6P$AZ^N;VX8vMV)(Z
zMm}QPg;z)&+)MpTv$O||);e?$=_Nc{_x5FWhy2EVQS(>X4xU`*Qy;th+w)*61}YaZ
z|Hk)(?)xs!-j-nnjCD=-{hDQ9<;#O!p~HFFt(e^8_bA3+D>crl@6#KqM(~g7Xl9Fk
zReRv68N(}&oaQ79GcSq9>+J23ZJBb}Oycck{ha4;z_vw(BpdT2qoZ7Btd`1>=qv4}
z-9;`Ni-v|2id>%W#oXQJtb?Brg;4X<TGwn{s~5=)P)ttmdY8!jE9vk?Ohi07e<O-=
zw6kAV<73k2*{>^-L!n6}+9P@mZ-pv6pXqrvx0Y}-b?LY?bmfT)ML1GVbniACe0H#i
z_R-SZYloC_28TYc&WhnOy82SVY&s$nPh{rHy}sUvZ0Chj>v!&Cd!sxOYgWq&L>;-w
zz;s`i9zWR}E?cv#UsLNzI1O6iPR^osC_XI|c^>0-wcm(1k+0NC!AT$fh6kJNlwp}-
zVbnOb=$_+Xapfh4Ix=@*hQifm<ATQ=*TWN6JR`;4kJ{W#>}b3({Sbuiq)@zQ(sw83
z>(v(2b(L6|M%0L73mnV3+>&=VEZdcA5*k@iV2SmfzDH5z8ty$gc#>7CH|Z)gl<n|c
z-qg!!zU^S^=Hyh@D>5|tR$J|pF}2lI=`SsMW)5XoRU^gQwQQB572)B*tNgR<;$Yj~
zZhn-oiDx`wW@5WT*X_&h>gg3?d5YI}_itEU3RFnW_(d5nBK^%z{0op@uWW3TE3Q1E
zwnQbi!551y9UvZ}((^shx~RP|8r#L>jOFs%)B5k37A1`pZ`YSLY(1{4|J=1cvISl*
zc74a+DAPD0H^{JR<Z(9z#o)w~zu&TDPt;{F-tl(3D&dXSw+Xoee*{H!i1uCM7cWH=
zee&iB_Xj5(mYAUB{Ao3u8Onl1os%BUywxrW71-hz7OQT>tbuO&@#PUTU8+1kLs1%A
zo~FNDelI|}R8h2DeQLY5EO+<X2e+PDbH;A)j<gF42f-S4=eGhj*hEwsg!GPF-UXiy
z?D<&4zyfM4wPsZm7!?O%yJm7hTN~G<TIUO1F26P#>)^O;AKDcylAE;2hp0i1G_-XS
zTZ^ViKV?!J2<l4y;)BX1b$XDjWJA`w#kTrPlfUYEi*&Vsh6a<><j6M19f7rHt9%8a
zDOTg3Zdm@vN7<8=Xz4NNj?IJ$j}E%8&41i%y3E1Ey3tPzLbN*;>1iuhFD>UsCr;T_
zht_Z18DrkXx?A@e7t4Y6bmmrio{hP1c<J{vgd5KtW`6SBX%lf#;aki|e>uuOSva-0
zF?-mU+80=&-oZObtKM(Pm3Cw!S%>ks%TE&_O0D?Yv%r-9eo|K%DI1g|G1RTf&G1I9
zv*)`#j*s}3{1tb3+s4EI86(onkLI*HBQ+TISnOMb|Nj1$cYEK+{1JZcMOALwMF=Xb
zRT@pgKIuF6o{ozO2mycaSGh6M+U(sQ3Z8Ge5wJ;rNi1dNTMQRHPz!yzwphuopy^m!
zb}X)9UL!B_Fl*jGmlj)I=4Gz=I&(XzVB~pAn*qa*p>CtyhT>YacGYR0ufXSgehoSn
zl#adEE|uF28HCR;4G!CTh!!Jv!?H2u+<t~7<t$WtXvOBdd-{gP*C=(_2HyC@>1vN(
zOoKZCO5L`K*ccz$$*=TKdd9sBzPV$(Jc8ABEG#-ME~417ux%&3CL1NdK0s&<chjj{
zS>V<0qJHQiZ6KZy>ZuY>voy8#HRfBTQ)qn!O=iUhr=kS+2dX!YOJm&<Bi93th(aib
z>OzQag{m^GR*9rdhX^MbV?u(CFFNT6vXIR`nhZY?iO3sys!r!JE6-C+H7Qfg05_<7
z+iX;>S2WaX$Gv;Ph8gVnIrXk~g^d%vCF)92T5-rX=X>>9gYWb&eG}C(e%+$lQ)(Jd
zg6|u7Mr4d@d{V?Kp2KscU0WmJUB*Kr*4o|v!I2fVvLknP;`1v`Doe-v7W&HXM^aCW
zjWdaX^q?GJ5U3L(CiG|Z#Ydj{Q|pxh05n|Wv~YxKyI6|9pj~%#vJkn3?yhJ|!CQ&b
zLGZ$OM?<6-V=y0(2`vNNMh=W?qGWM8fxceq8&vMzn+ezqcZsY>+obnbjP~bV=Zf5}
z$7mY2&zSAg*b+Tz-ZZ>&cw)eE5;WGX&+?ScNHxT1$7W7~CHtGh#06AMfc{Jk;fehO
z00XTI=1LmbcHw&RS31L5W?#ASimdDFZgq$))K`;Po2;p>?_WP0DbwC8mCQ4nOwgYU
zbpl(A+20GwPTM8#-3nTbWX68XD!zU_r0;`pZ?=HK-R8+)yw%rXHs7d&DG0{DKg4(o
zlk*T85Ja?7F2Ck>U4Gqe=ua)jLu)_)O_o@eZqL2nItF?t7!?5V^s{8^viN+x7l)vv
z=dR9)ZOZ8=M5nR~vZa%~t?);OjZ9CzD(z{NXs&NVw%BQpp^JD0hjO=u7&cdf*A|59
zS2PLv?A&r(pJ5!~ON>P3>W+t9?|?6+pQi2abkC1iZviwv`{jm4(fW&{cWp3mqG!@?
znC`kjnPwM;rKJTORc7fNRo=mp2zclZTQOaVySe&`Ss|;|VY!&wRYk|Q$9o)~JFmP?
z-uR`$W?U#uH&~~!H0QBQSHF_u(MAdV^}cg=@SCZIhmjx4iP22^?uc>Kuw~cb5mm}^
zH5n=&<f<9*D9U@NNoS0}h1Y$}!<6pFq*G(5QAgb^H{v*<iVsw?Ke6D^8k;#*bKe2W
z>xlZ|A3wogsq<XPIOZ6}C&E8dToW3z<K(c>o^G#AJ0`0d^-B2_p}X(NnKETY=4k}E
z9U4qko{e9r=2)|4Gi8-qE@>yOypo)Y5!OY7WTJk%^ElL44$qu4VcfDp;3#a6byi4v
zgoofdzy54mqUZ^~tu~EVt+@!#8=AsC$D=3ccAiF*t%se35!RLjE5F>vuZnVNUK-JQ
znyD$YKetQl*@Grx-Sg}`8VQN+#14*t!3_=MJWN6(F(fD7>)mbgp{LEi*TmmY3wxo8
zJC=rx>;_-iQ)An=7z72Ej`xZ=n>T?mB`R1x3v<74+EF{Xc3cJ7r>;|#0j9UprMj|?
zyS_kuoANr@OGl$u2VuE9+NVyM3z<$!LF3V#la6!q2zQ=0$s^8?_MZtZM)h@*omEeN
z#_SsXZr9I3<I`$?s$|+)b2g?rF;H#sh(3-#DAoK{H(A*!Wo@(89?&Xt`NZhANMwYY
zEF`P5(T@_<-tSVSu+xIS94F-AJ6N$mU~4g#u+a+t9!ymndvXO8LV><J0jM0w{o&u?
z$=+S>1eMXGM?5;*VhaWS!6ZSK_^R6i*GWqP4r2#HQ%VNO?fQaA5CQ!N^^Sd|E?J66
zW8tAav}x4RFy;X^Vdtn2x|P9q-8^N;rj!#zJD<4}tCyjPdSXaTn!-jsm8Mu88=VYl
zetzop0fVR-;`ef0Gf*e8%v*c(=pt*2C1vyOo5?ZvNklIH<kNOL{c`|hbz+^>>AtnL
zZ?|PF9B<r7G;XaqyHNe;9+eQkFld=Cx^NU4>o*`fWaDNY{cCsMF_aZ6qj)TaMIVjn
zy<)PjIcTUFUl-rHdNcIKwVgZezKS#-_X@ETVs7`YoJjeb%0fQIR)Fc6$};Jm$!W*m
zGT31YZof9%%k4Vc+g^K3`xV{58(E%0YW2s^DG8>oA3${e<O2~w?^gDaTtco|=2<Zg
zMpWMn^9<VRFRLro?Yh2z=(b7hVlSV+*`EB#a{Tc?=~q}nmCL==S5BF|_1L`Ks*K}w
zR7;Ihe%4k%f)($;u_!~E@+wL(Jak%rUk^EA%EK9>Z7R`Rdb7&;rr4Ii%}J@+7oxX-
z-QhP~XXozQl^o=wA3C&FEt$Q&@7d|ruxU46xVIyb(x;bPFYEZc%h+?NFkbI>=saJ8
zt`=`va!@yug?$Jy<pc|DG+K&M_uwiewN4`lbt6C_If#r*@ym2^SK;ogz6Xjp;iY@|
zc99Zk)5-yCwd+06Sa-j|Ogdk_Ax(eHz=&@-Rmv_()lzeZ?I|gM3R>*5!LSO|{8}xd
z6}rbmvep;hrlA8!gdc3FTg}Fwe2smeY<8*2v*o>?uf60q0uEM%^}WGE{;K?LvKZ1&
zRXdd;=(=VaVh<yStd3($^u>r(e*U~;bCeyn{3uscT;Hloba~zu(PB98an(JIe}ctk
zdPIl~@wRuLMrY61P?94=?IM##fzj&tNpvB^AZ#9wgwOW9|No)tJ;UMpzCX|;h>##k
zh@KG9`67CY=mgQbiQaqfM534IL?>EwqxTq$K164fF&Mp@QD(;VyZ`&<zS_^T&vW)(
zXYYMh`K-0q;uns?x+uiPDE=04vQ&r#3C%0HFAl|1L^+QuHRN}hSAKV<6LE$QzbkV7
zEM-TFzd%#qXIo(xPC|9<)cy!CB!{d2T=n#Tj&<I)&A^J6=ODbTJ>btub4G(HdRsJS
zE?<&<wrA@X3O!u9h4k)T$E4R@?$%I_k?bMPvyp0oMHw!;YQ7sAu167OCu6-m8SFo+
z1NFVfKJw$eSg)3CA2?ec?B=fSwyTDUx3#WZ(isXv86u`cy1FSB)aQ*Yk#hcZWOS$;
zE1n{q@feh7Vjzh-dcWr`DAuEmwLl{qVX0pNr=|z4w-%D7G%mtJIBvT%eW5I+_LqA`
zSq~o6k_ikB<NT++JXN<mhf`7kTn-OBb!nV!3;_=|cD854hClG>R=n|O*9K9uNqx9f
z_LIuIGldmRE5g@OcJZIXt$gO@?*MXTVTGq81o;spUl<y^VK~WtFflx$akqhMd4^$%
zKC#r#;WmX)CJ`#m$XmfF6qVx{0BVb+k+K_b+CQt6n#^U}rf93B-MId<Np*wwH1xK6
z$m!Y}{C{9gcO3gWr2}&DSNu=vwcox^%u`|7U95cRiV$XO@RxBPC3XFz3ic#4N8C^#
zx=l~7=N2o6%@1|N3KlCx?iMTADi<rWNc-|s6q52{(=5xiq%6vr78+1)k#g+%8%XFv
zphi)b^q~8`r}gA@XCgk2<C;_Kmdk&~FBQ)}%4Pfh0nLM)?Y}_-iB-{oZ1|%q;T!s=
zq-o4PYErNF-Y=K~JR?bE%OzgBBg8BtaeO(x{8j$}7*J<Ho0s=H)w7yEXdtZr1ERqC
z58YJHuv>wHPN&|MJ5Y1VyXloqSrnfY?qZME0=6-Dpzej*-A(?zhC<kpN~ud=K9eQ(
z2f#ODxUr-q5jX&ip7fdPvzHFGab=fcx=*D?Qu82}FpKg9o2jeF&8+l6+XKz_1dBzU
znYS`#K5|E3f8}@6zMx-$*pGJKe2nGD?p(5FOv|SA7+cc+1gJhV1>o_hBde(1Y=v5F
zK-A2O@IR}RZHu-8q%bP+B$1;o$ms|+@PDX8^Su<1Du(%-*JtLttKyll=L6AFna3eJ
ziVw8LPRL0Vh^!4iJI%XNTEIk5KaR{mQ9V2<Or;k+C8at^YsKuzoDNLokyII87m@lR
zmIGR`UxRueZlQOM5)J5)L?}p|T-@VfPzG;FByojK)v4IJ)bkTwy()b1+Q6N<fGYzv
zv7CVG?8bxf7<Hemh|qdw03D$Helx_;Mg!qmAmEU{wAH;YhRk-|o=<OI4z(56;(rpa
zE_qU&EO$2nT@11`l}xd-yNhb|eNbGf5!=<73S@&u41B`Hjs5l$%*<aK&rj+H#`bu5
zm?GD1#!$1g@azdQL8*1yke&zm%08Sa#Q&s>SKBoRVc4j}KHmufEWmhwwYIvTgf8^E
zKtpNk|E<oiWs|3;69!q~dW|A5R(O)sk0&2WC+dVfwB9{PR`~A7vt0oR;+SoS@J2e~
z6VrW{<AXN;fG)88AG(0IKzna1qMmlj9~3!8Sgz01b8dCziIA*`erRlO>qC~=JGVQn
zVz_9Hk~#n#{Bt0F{wIef>p9&a`*s&&dA`eD^d}?S)%+K*l}S^f?O$uf59q8Rcz{(E
z-)~r#yR1}E;cV)DedC(v_=>2&tRrjA+*?g?8d|ocA(T!+O<~j95`3cmN4PV4{iga)
z%pA6}1C|v3XmLCm4YEmm#_wzsV+FENfac7r4h-Yvxm@$|2;V?lu(7DSb;YDU+crN!
z2HI=wAmp1D5;m`d1Xx}Q0Y^EVY~--!0@~#JGHpZ7yiPXMl1?`J+)g&z%uY5Q^z%Ib
zv$>yz$CZCPgJ~2<5QkTRVFD%+q$j9zc6E&b+x+L7!xW@RL*ILaF8T&-q{aipS{C$z
zopwM%-3N=dIX8A0OWn??-a%Qf5EGWslMD&rNg{&IJJI$tHa57qLY@O-_5zAd!RK~P
zFus>bL&MdD6E8UGv(Mt{vwui0j%N{7TaM@MZcY20EtT+{UXOxoc4D997%pfmj+=nZ
z1;!FP7DM&LFIM2;LIRsc_1UE6-zT_86&_aQzu0vfxz~8xgyjGN>Sy1Qt|cC(-F}#M
zt3b%p>dll**}7^^6X{5P&*v*iDIo!jx48hE%3R=iXni&x?Jbez|B$KvP<x?|!J%i(
z+1w<342HTnH%i#BO}>@!sFg>kTA_>RiOHVDQj)x6ljWh%2um<7k2vpXV6fKn$<z%2
zlZVsd8~SisSQ!BR5A>3n3mn`M<cRX)*$H@B?<-3(P1a|NiaFWT!t1lslj^fa1mTo?
zvc)FgK3i4W4Lpz1L7jQNM-S>&!KTIERY!opS(fhNc-qIs@tGds|J$b}O{%*Ss=&vG
z^MVITU_SY4qV<2xj_(3mkC_*`yUl(wQ~_JJ9l2Nd<dH92#X`?miQ5Wx2I??WisL`o
zPL#jFdm4=s7j|56f)n8kvUI)6Q>y?b3S!msn^}J;y_~FqX}-Hgyo8@=+r(wX71P5L
zAG%sv8?FA&+u$@>4aS%9NNC4hAfgW%co80J5`KYI_YeIRcV8rfoSGriFxKiS8a%wB
z3T8qFip%0V%Uu&Oeo*)x+Uloz|MY>IQD7PVdY(QWWq!{S^yV9nNqJ#7b>d>zFb-)*
zwLr}2$-;53VcKZA^HuNeU7Y?IfJ-3sVE_xE1sK3_I-9&S_sN1c4jn)j&D7hsq0zgL
zMbvwo)qeP29A>!Yb4Ymnsin2*T58Rh&{@a=qq}Ie>gAJq-R%8{Vydv3lskIKfX82t
z3aP>hE1tbk=af5bwJ{BGpRIl#T49*EBsU>u%g|sj8bfM2noerEa-jMUPh-Y`Oz}GJ
z&hK6P;Dk=k?nTPK4wbi!aD6Gj8awW>ISwY5XbJ;-AL=XEr2_t42+M|#83u<k_Ks7a
z7&nXk?KTBWY&wdi|BP7=zR7R`wk37gfA&Dx?u-Tgli*VpuT(W&@%;QRbjeI9{aJhw
zizEUQJ^wOK<23x@H}=p<KWHGnocvzEge%;ZB{)%ovOmsJk4Q36(q3ntEBrv^?!lDn
z%FeS+eVtYVHaTYSCsv#K^pR_c`@0vtH%;(zf=8#0E79uso7|h>`HQ(+!G7;!+nEot
zg${3Vc`_ck4@3?Yzfq6d6bNekuy(RdZo-`a;UeFRrXC}Zgc&cn_%rrHuwG_&<i7qE
zBR1?!V=_tN%o$GeLvveLFWvx)k^fh~a2ZaGSWsU_SNM!x1z31$TsB|8q?sC)C%u<W
z7~>CbUtD13bEP#mMl6;<OfTcC2U0N59){;k6(&d}-H?OGb%0Z+`<icPrpk3^b*tAh
zaI)-Z*T(i$p6K+5h5soD<yah?vlY-(=Geg$-|N%BeR12cly=wgKT{6!TlDQ1rnTU?
z!&tmQ<8<YGoe>iwGRJ@HB;g=NhC09yXN|pV6JatDHB>mjLpx3LKPe;3lp(Q{>bn?J
z`aW0`26GK`>`<(pKkYVc5NuqrHCuDFUHpAsnqY8#X}!N%oN@Gp<0wZOd7yF|=llb@
zGnsQE&}&+wZ57l()g{2n!TIVsn#Ff?+wWXC-@pS=vQW;S0d415NUb^_NV$8_*(+o*
zGGprKt(cL;cf1}NWeJYI>p1TE#;f7*_sZplI+2{^7+3&n?DxM<sOu`y=k_)tT?!2A
z!MIysnzVgZ4h}~AEK(lKL1&i^{wp47i;<8EVUV6;&Xs95)Axfm!>2apc>;_RJ^xAh
zZ2t<0`TxtA?Nz}4CuhRe$4(M~4t8tEBRzt}vEhmSUzR5>IjzAOo{yl$-p>AO|6?xu
zJfi<2*Te6TY584E1IazlvOa3<znQ&eY2;vYdXHqV*Luhuri!~&@nu&BdKcAgu6DJ5
z?zKaZ-f6WFkco@cWAE+tlX6coD@C7X1_YbvuuB8kOY&>=*-_a5l&5%5@z;m(2mY0H
zZbg^2&o4v&Xf;R;pmvL~*y6kh{qFN|fOx2b0EJ5)Q8mtkH1Ns{I=kT!J)Qb=Kd7T?
zIl10&1Plol+UpkV0YpI1|1xpr*Vp&Q;yZtL>${c72A?8-7#ptTRGM^IhPzt;HfG|G
zM^R9WKq*+aTF<%H*?7zT#M?QFTIAdLb6g(4o3mD-bIhRTt9|b@l2H55E^61gZGjwq
zu_ph79f6BAcBuz?Gbw52dC7epJBbRS^llzN)|T>Cob|i7BZ_+7)2y2@?7o7sSdK`-
zgTE8~Bz%lYNup^g^z6v!-eLSkyhY+*!FHzP{F)|cC+R(WY&wtUvhx-j(hb-Ny#Lir
z$IAm4uw5hB99Dh#Q1$Y9i`!q)x&X!mgLH8YOuK)4cSbGcZ!a~BSm>8-LYlk};PDM0
zlLlEoRV69ege_^uWXz3IkOZE&y4i`irT^UEt4j~+F(~@QeFdXyCv3*(2rk)-U5*~-
zzCdTf^jf`oc_qEOib9&D*M2SgT!@Qzpw=vV@|TsZcwY#11#sU)xH>CrN0qdrKxaYm
z@S+#9<j;?9|M{I+z<?$U*f3)&EC)$Cit6a|I0+59d9~_Y39QLdD5UlwAb4j7;;k;H
zj^q4c)Mk~eWx8SZ3=p}Z+8nh>)XZ~&6CBcTodYK!I<>tn<g?L6r;jo$BxXOq9UZa9
zJ(h&kouA@MNW-_Oj;w#%^iys_0%r;W_aDY4s$<WNNDycxM(q{RdC=@K_f8NW+BeND
zN<xW7mjcK?TzKp--`$BocK>>}=!=+14ZXk%-ZuYmxLsU=dRCMhopj<c1m|?wb>X(S
zjBCYfa^<Bt0GaHe&T2<|1q~lA%XyX7F4P%+YNwB|3<?mrQFYHw-iAszZV3cU-CPl1
zV7dj@`?q&(bzbOI{pH?wZFK_y3&PCj726#2t7~SWl*jED$&4Ok60ob?7-0jucPfBj
z4nIZF^WBLSHP+$Q-VwU3xFj`*(}PzouK%okFTBuCEDxD7>uz5UE^WzK0gfiEYJa;O
zPlC4#|3(DP2D9i^KR@K$+lJ^ZTvf*xT5vYxOWsd~@)g(uT9KC%d}jzpY3IGPrPsgK
z0dxXXUd#GsL2LR?kIgqHW4QHEz&m3<eIfYNjbp(bFdyagehFAN8*r6K8RA*bewn=x
z61#j6L=w8FZ#HYcC@#9)Q#L)H%!YDZXA8{8JYp<m2<c^F?9qp6F#OwCp7Oct^p5=I
z0Wdrg?!{*LmOm5(IF>Dd&0xJG4^9Mv)>@x3R1H)JW2{UyeYPEL{RLivZ-I`+GZ0$7
z+9=aNV6T}`>mSa*W@(AL479cH<o$l9MF*2ALNuM5-gA9Mc6BYeT|8=g@2j(+3}XI5
zkf^tAwKpj6ye9OpQQX-1z%YqmoA_~12G{9!%$v55$9=B(;{~v53m4Ib)(K)Y*^B%Z
zTkE6Fas!%x*2j<-JO8-5P7amSv8CQi6A8`*$cE2q@cfGB=4V!9;O4bhwVL!p776+?
zB#I6)7{L*_b`<Fmx=|v+DBnhTU^)KfOEp(RVts^$-i)^ddWknN#3o@{z#CiJ*~<g<
z=~pP;^2K-P?86?Sj6)l{AVHz1HFN(Fb$U*KFLDZQz8ZDDJ42yoTjHJs_>2_rNlClC
zgy4kwFqmc-@Bp)`*EzWk!Y%Nr4sykD&kR_waW`xo#kswh)wdRy8>idjgQ_{x!Qh>}
z0N2Hn@j<Oc5R>sCN$>4sa>!b{Z<lTytD9*<fx)MN_Jx0+ZeJ8|mEUFmeLy{Q3Ji^6
zeFN`H@Q~ERan5fG0MCsZLZ62QUvJk(?lZJDLfo_e#z9gZF|7Ymp$Oc=jxcoAp$rD)
zK_Ha^C!_!48h#+D!|iGbvs_x?L(sPyl%~ML|9c|cdJuG{CV97Oev;|DkW&x@m^;yF
z8DoUwfiL`AzakaD;>)0b5CG7{PLg6}x3zl!6!)#C@jn{uw+D|nkCl%4iO3&6S%~?M
zrPk}I7Q7BghGwExxX=%{)VlB5GSY^iEArU4+{yJ$N{DNk6Zv@428b8hcNE;=0)tT<
zS+QT`Ueo%@l+y$G0L#rR2woehp7+VAxw1d24EhJOJ3n>~Zqlggqrl6w9+*hy+u;3u
zF5Yo2`jR7n>?#rwq=I2^0;n$+a1_9dH+&UH@Oo7P*odEVrz5)O3N7mXG#MV>#?3RL
zp=<lm8xS+fV8#2;G>md>X=jRH^wm0B5N>jHTno(-r3Y?5o>rbG9>G2O@lxZr5Adax
z3zjFOZ4HwMC|A7RbS&^!;y$`5l%-mt(B)p@c#n4@Di*_Q7K^&LK!NIZ*53De_+Ch@
z0_Jr<fZVRLHfjG*vh~yYe;ROsUgU=X^QPOe@D^nHGa`4K0g`3FslX&8^DN2v{&2YA
zh%wQ}DR9T`gH6+;k07GI+#F!>UR2no=PFXHNm)pzQ?07G)ICPP-Qx>fYHeA7p>)5U
z-tD8L;@!YrNC-^dGM;V<W;Med6D%Tf5wBSaf3LtxPLh)_QWc|?X18Xq4mWF_ukj9;
z;p*pY*!q=@^KU2qwlEyWOv2-1l<;BeX~$jM_p-kuJRu>_JI@3gx+%RGO@~bKGW2Lt
zZm{Ua_IWan8RITMq$F=epRVzT@sfc2rAwW1!n0xy%!^>lPgA`4ed(4$OkQ)fRMjtF
zS<0PRfVvS7U((4oEDMZ!(lc$Z$DP>UJ*$<6pvv(W?>NW<qz?<9@)~I9k<unv_S3#y
zkE;nPy(uICe?V_%;Y+v5g*2!{j<;({^fucDA2aI7g6K(lp?ZexT^~DhFfr2Tovg_g
zu*e6MfoxUCeA&(?(i3%4WI7kHR#HaX*L0r#U10g2N$nW*^6GQ6g*nw)oES0etglE?
zJ;kx1Q$0kpv2S<$<;EB95HC$GUSaFX5SA)s)$SYb#wd9`DUEdpQ~%#hf&Iz+dARJm
zPzeP(yk@)f%u!y888=yl3^TBVG{2pi?Yo1S4#OGD01l7KQnI1JjoqCLV;*AT3MfI)
zhM;>49@zSU+!#-75y6E0BVd&`&UhA=_*LwkGDnoDZ1LCzhBu=7hg(z5J2?>qKhN%z
zxA#UI<K*4N2Ca;fyl6FM^CJ<WvEZi2(G7CrW?)S8E`ov=$tf+g${B-;;hwHF@kN|c
zNhtM26d3nY@Bz0GdkIf4URu9b0`H@j?L_Cd`&>BLv@KdO6N$h2lkFI9KuPY2CF_zM
z88FyT$jo1fV>X^$oAuK|V6&xpFbIbPTLza$=gyYg1%o1LuN^}}r0goeEukSdcEWwq
z_Oc`ldZ)_2q_3NKHxtby^0Pp#tt36L<L@Zj&bOPsrUgiZ-BOuvml1MW(WlFlvH2u=
z-I%KR+|_StzSVt<*KcaG*B-^-TEIP1cWudnUM|o;DhoV^WorsNe|+6=)(bbs0}qAz
zY;GX+u8u3fm=THVqG{J_?703qy~nlbLOJG!7o%+X4fO6{))TG#8)8{VcFMT%yJUhq
zuu|_RY^Ah7^D@CddfMFEVlwXX^-q-%x8Pm|CbGDmvI<tV!sFEe_}cn^^8?a?M@z8h
z1SCkKKP^KBw22Y56}OGyWbG;wF^(mf;ZzdK<dP`M<di*7Rb8)}9PBEZJeL1ctV^Ik
zuK%ehTY%To4WXg`3aE<Qe0dYS>9cc~)9|_VYo)KVqiApBc&`1YY9t$HApuR|L#A&v
z*9^y2lOoQsGK!>QI~&s9$|aU!+e==2KVbEL{0ZBePxR@oDtE#zK=?o8W<4>Gg{1Xy
zFl|jRND{#KDIk(Iug@=gbxL<BLin2R)3gV(L)b|i^QbNSz~2>zX6$rD_oHNRAbRa-
zyvZ!5n=7%?Sy!mMg896c%iJYXcRFx&X_XcoLy}9_4gn-3?ZC*Q&a+jwsC#WgK6*Ca
z3eki<rl>=9lwDxsXwA&WpVih4T8@j~T{O~7^|A0Uw8;!49bw$k;}mN*-FBP!!H!iC
zp|jO_c^hmlQ=wq>`_!M{_a;BaeHylKr42#ezG9_}pr|>sKeVHmB)6hz(Us&<Wd)Z7
zi0|>`MpUY_$ry~QTD9*6n^aq8_ThHpr?*?2(W2i2?0<=JHgN=z@S0RjnF+%*=B}R@
zhNi4hO+`7120=iqD0M9ij-fq4&Iux%BEM-HZw5k>;?+2X<fI!{Uv{mXb7mk}*neM&
zj}ibtgLf03eAs?35PrCWCUC3yC9+C$Q6+b*J#=isSxS?L3u6S8@-x7r*6bvWh$=l%
zox!I`PzZdIn84(W7V9=vgF@3XwC@TZFS{{-iHpW^5)M-MB`@W<AmOZDr-C{rjSR|{
zGlpNps($AIROSurce1R6j1;rP-pu2(Mpa?I$P|@I?t;8Yh>!b4tv+7-n+zC;vCB8!
znKs_k_uMfK=7M)zHt52cdGyPbUdp}M877rJ(?vQ<hKlxZFP+(7(6dh%oW$z9&H5cp
z`DHsSC|zf4@+P*(jV|mIp7aB~B@tX_OudQ$Q}x=!h$pDe2oYMQdv3d9fxVblE*&6N
zfhpbnVOEg_T*Z?=9FFWYhF~r-CebnVtD*KeC;cl^ouTF`MzYEB(~IXM6n59DBgDNA
z1xKHiYedo_P9JBUXEB~SnRJF_Bsf}<d>`}F1cJ7ucSR9_$xK?fH9~NOcVdlts$%?6
z(dNpEEmh5UiSxvB^2Ce93~?P^b;k=uTBns{V&7jqF-;|B4tu}c%S^iblX%6XE%Xh|
zf4hZ)US0U!WPf45uM(a4D-!zaGI7$MUHAO(-;n=4OPKmh$npDkCm}BkVYmA6yDelu
zb!x@RLBlRrCFu{6{20dr5mClpi}y2~ZvJvgW<2+Qu_EiO4TphBq;sEs&e_rv=<aaI
z{VXjLiwkgPRNJ{WVw^y%#ku-q0AW2asWsLO)-`-KGu2jirbJY@LiBL0O^_-)xKOw3
zA2&z?9vqga_iv0e!Y1G_D=Fxzw<%q}W*1Hkd=<?K$vZ>Z8CvV7G7;6L{-YN>QZA3y
zw2%<`vKc@L_ww=+duHLV;x>29Y77(rx1ENGnbEs}pW}o$tD@pg#q~obkQWh29s4U?
z03!Obp0vC4h_Fkk_Fyr#p$!XMfz9umqS!)Pt1NY~$O5p7Z@jqUC&=;YtAN?=g`XbL
z6}E}K7k69kj5x1PQ<)q1#o7)@FWAE-eU6VCUQvBmC;}vj4|Q46x#CTA8_V6tc<r5R
z{z(WG*vYD1o>ui75N6WKyrx2kOZP)w`wCWg{kzKBtA&>EJe`8)v*Mz^G~5rWo`r;9
zL$2qbD_i;@u4~}Cv1Ll?OH?3=VZ*(S`{m>Oi<?M%!rKqnm@vN`@9Kl7Iurl+6<x4_
zOy+>vyQ98a%0J#jAJXj&--0`KIyGoo_nItBAuJS>@D?1J>sSyDz}@c~WkSJOugIHW
z5mFE&$wl=1Humh5F_GVs%I6mv1~+Y-s32>x;HN=9(oknXrtOAb8j@4pbDCL%IL0IV
z@a!9k@1Ta{9Y<Ejgp&K$qlzIH7tf`!>ro^R;w#i)l&S~DyDoM;@^@oed2lT>sORZ5
zC7C3b(0HSGU+d}pZcgLQw=h|l0=O$V%5{5;>dCs8*(<17wdar~hts-~xBn59rg7zn
zqkLAuyv4q|;CH>d!A_4Psi3jbOjmj|l<a130Wf$`1qx^@xC2*FAM7x>`$SZm9Nq;2
zrO)xVjbXfCl>w1w#st%o=p4EHt6dE`K76n88B3&{ah9l|ImklzLps<KQ3A$m@*mmy
z9aY}PraQllc6KT1BX>=_NjCf-Sa&X0e&I0d7*v9=-rjy#Yqlf1ZW3!VDdHQ|k}fT3
z%KLhC7i3(;XX)GB6ZEt4oH5->s6(;OS58z#`Nt@54*h8oO$?Y(o!qUQIs}9R_Mow>
zvj`_u@lnv5?77JLQ`!6$ZM7lkq0~d(cK*qb2iBw=uUA-_P-L<c<e_OPAtgE-&i9US
zFf`APVMf8_z4;e*`|gW3{@-^KX>5<KjygXj1xy~hgWo<0af!Jf3@kyT(U^;>_W4A>
zP4`k#nOk*U5*h~nz<`d^ph<$s0B_0&{GtA25s{Zfp&uTy)32Yp;q=%Wk@hwUIDCE3
zKN>L01qCD>n-AX_a<itavx9YGWrWsjY`U{P2`SZtYO<F0$B0TW*4**7iNoT+^n`8j
zBSs{mx2ay3#zT)dl#mj6Oh6^PX&s^auemuNT6~A2*6wx1K&NU>-sx;_s88L@8MgDA
znUVHgp?W@E*K!VSiK8*pE%UWUq3z_AQK!M!tROLh`?PI6^q+Zjx-xgKYnzBTg~mIl
zrr1$o=-6f$qcQQWQVGW&pLO*Lm9(l+s3pr2fN8JPIhl3EmoiqP260QRG5(q3wH*%x
ztf!XEv2!h%#TT_8p@eO3UaW?#b~=h$ip-9fB;D;k7t`656~y3?AmC@I1@)X9J;YT{
zO50y_7C+lOq>=aMXB_?&R^Ibx;p4?SANf+;J)RAp(P`O5eMS8>@p|{00|p4&K(()#
zCm3*85msJN0ALhR{d?jdmdTXy8S!vnJJ>Xml8Suy5r1JvX~y!sN*qml1PCf{x3*QO
z;l$I8ZoB(eO|t*y-bA&%>VEs{;xUEBOUfwMWITgA2h&^bH|U?hxG*0$|L>{Krk1^y
zI=u?Tm11`z!e8_7?P|*L!_OE#IoF+i^tgGNU#G4?0GG5QkyG&;=f4?Ngg9a^7T~Ur
zO2dL9<Dc)8*RY@*Ac4_wP0dd-0x=e5i?O<r|5_U-j(ide^w;N}(6m*9G%FfBM=Z14
z{i?{Ct{S`<?1}G$&N{zM!l_UgQi){y-z8T6>QmeST2N|M2gffAfLgSNV+q>TZ{z8D
zTPHX#pP~&bETM!ma1_68G7OWUkwXvsmektb)chktCwj_6iv1?e?sdlYgD!;26Yb!<
zbUrW}8`Y#NI=8TcFSTPby4S??RP}9hK%Fow`O}TZ{gaN$n;V*UX*2c7OQ=U)HIfVB
zBq?vYJy}$w58}&#&H1kaE|Wh+;@e-SiTQU0XM6&jDgG+j?_WRFAEifI%{*dhJaT|I
z2oe1@VJN9O3T(80v%TA&$0jjS7M{keTP2C0EQLz8vTY~w5}+GcM^xQQ-dNk$txfU@
zrF&d%=M~t@eB^&I5!SKv;itxsxr>n6M@DwrYtC(ADNQJ;;j0`+<(RH8mYm<+EblDR
z_nUrtJeR-o3Td(~j)_Qcw<XR9Hg>_W;84<F;J8yToH%yO9vm8;zpvY%23AVQ4(w?i
z|N4E%fs7#z;0Warq-Sp}Eu_B|t>iYb>IR;e8xGP{ej#eIUl+&yT&P!{aHe{TK`Zv2
zbT6Zn^f9EBN@3j%;TL+zv8jptHe|tRfrpBLSP!(_XUX94EZ4C0YHjOh><lFyXLjmT
z?B$Ml)TpH`A=r*0ZSH`z0AQIE=PI^!0Q;XaGPeexIZ~Wgc%Td<)U@&?ntNmSSJ|`S
z%Xw$c<R^!u@t>{5Ig|fT|DI*by_>#@UuZ(hc0_Z?6p?Jt3NHL?i8k)`$j*`AzPFmJ
zwd0&I!#A$E`SSkkUCY!)`O;wr$uf;xu*!wZQRMFH0+w=+2IZ?6cULum0>QXgb|6s|
z+^4a^?Wwlo#wr&_t{A(cU{9_z-Ok$KaB}X}HbY|7gG~68IuPLltmvbT(&ITd)TyUb
zA~9;A87Y3^D=F4DQcPHZkRT2f?Euw%PfUSrYM$dlKScCy$Y=#O$(9_I<!csJD)Fpe
z6@NN!5z3TT%7VQ5mlIun;QuEogIg77lt)DUA*>T%XFJ`b2&lJ?K}{Nn;?dx@9R(ng
z+pyE{kq{>b<08fGryHmDok+=R3~Ry}Z`;g^JJEaB>w_q_2Sco+Z2xewkU(4_@a~lM
z_&5}aESl+KmMRQ<o%p=cB<k}wC(6He+*R=<0!Tmp=ik0x9^$jkDR4jgz%H^bJj<wO
zCUHJ&QIIA1F-W}h@Afz|4O$gnn$Hg%2dsTvhu>NK^QPiNjkSYB<mj%(e6S(RB6HX>
zA=8R+Yb|u4D$z>Hw-?ApKW6)9pmQp%(L3q>k>ZZh#1i~nhmet~Q^NC<8S5s43`=Pv
z2G~ocE1jd-TS1Go-%nN>I+%?Tn?ldLz#`1HS1d#Rzu~I!K=pmq7o2o=<Det34Bykt
zKchANXx2@(px>ylA?o?+t-p8KV}Gex;Ci=&8mlq`q^Ux=*X$Jg=FROJd0}=5%(K-}
z?@L-(yVv>X0tDoki0|m65=A^TgLx)Pa=8*k4h|PQ^s-JQpdnU@%pv#Z4Y*ACUTfcx
zvV*%Zb6e0m`xiLs-8p&UO$a@rI<-mqfE%d_O^Twx>ge;=aSyTQL_d0dJ^jjD;(ANg
z%`tB27F)N6C*<hMy!xPupzJ-gGfmfnzeU8(o55XVy&3VFQ_U3vn%C-4bci-fsCK3z
zLXY`}-|S2(nD^=?nYZ-T->(A+>}l<*J6(I-%Xo3R)fS3f3*HQ+oVmcxc~An5?f&Wd
zDQ@miP}xf1cq;^l6np<yw|sY*TRPY{|JRQ@#rv=7cPl2H-7oDWcJ!n~&}kU8k;qa9
zzejr5)7_WUdK?g*Qp@LyW2KV;Kmd76I9|hWV}EYTd8cP9j&D~dLpyx+s@H9zto4YN
zLH&d_GvS(^)dLVEYiEx<?vh~4a7$IOBA<H_K-M%qNk%)QdIB}g@ZXxMCH}925}F<V
zE7!uamXthU7ZgmASp4SQ%JzX~>Kt8pfy+fUzEOG6+viCzn~9nkpBr-hEMm+xMu`=0
zw%w>Fzf)&&lM4~1OECRTEDj}H)(=cQX7PH~NlEZMbQWmi^~`uG;8mZRNdm7d`#&W`
zxLUq31nzC?qV{jK<4tZ|%)qckYsK)AHkHfj?q%eJ><4}rUa(#|pEr|JtmYT2A#8k4
zMzR$<Fv!S5fn4zfhK-3zloNpEX#H14m^<UzIruheF6+yzeEAYP$`y1ED=b1xkEmqA
zWBk(<8IMEU#%^Yl52k28;ZM+wLvT<woV^#oA#Pb8eG^!Ba&jkto67?gSa;ul1-S|O
z8!=CNHg+OCg0Do9d=#Ml&Ftv(dhGH2XKIEdandbp-@zm^XEJXxOYB#-H}e!}15bO!
zWLQR1w*Ruu1#pf6r(UpNQkKeY0zZ6-1Sywpg{+G4Q>AQ=3mf=BBnZE)AdBJ!9C^|N
z()cF{FBIDgdWSJ+>)u}YF<lBGx_Nqz)NFd}=Wabwk5=4iy5!`68^igZAwShkckBD9
zuZCfl5Z!Tr=@pM+H_&WS0!Dpsa})4JyEQi%!Pc)SY^LhWK-N4gLfx--AL=1wI#ne4
zg&A^FC?kDRfD%-RhWKbC`jDJOov-LUDxaVE?y14T>%Lmb$1hk1Rok>Ko|e^B$~3QR
z*JU*){Ov8Z%j{1=ygvjlPvmNO<MK(>f~ei!ZPY>32a<iY;a{;O$(hS|lz%gLe1=*+
zLHR=SK!YXkz1{yId7?afY2E7f%69QzTkUcs3H&;D*mr)<BtVo}{kPiE_>$|Oq)AiH
z@Rig7a`CiY;XCmIqk4p2r`UKgtlD)&M2a*1*N?&I>PhWZF`5{t(E4V2V0%zgpAE4S
zL=z%?YfIpDdV(CZy*XVU)SruI^VJe8c=3LSylabrmBL?C%ky|ZpY&I9gh|2Y7eks3
z99zyW30>DetfzbAg_+&!_vO_kZ9TU)KM)|!r##OmkXQPt6FsmZ3a)<{TmH+r`B!xS
zD?D0p(W9=k4!`J~AsMP3ZaksM$lC$wqCe&cl!rP@@e{Ha*0HRFBzvu_Hm*I2GdIsQ
zh?Vo(>ZHN_H8KoVRkecw3D}a7Arj~X4~qlp?54$H%WMC>v`)tcLy$;Gs=wauw6P`s
zhVA_W<~vFrW@Abu9m?J@IU3mgD?lMOYVuC*^MAik8wQMuZ)MG73LH)ZFO0V%?&Y9^
zHwtJi;rEW6!LCm>eGi?`-7?Bw#eW2j1+-g2X$fR(Z9U-u&lG!1l_f(GSeZ>rX|pjy
z7ndyJ7h%^BRu8ZZk#6`-1N?!@oz#IqSbr!}|Leh+AG>^Jad{nag3leLlkK}Se!nn6
zh|WDhx3?LzxgGORCfYkpI-flfB21Q!htDJtyIa5#%^zpt_gUmsN&-sGym)S?Z_a`L
zNrUhE(b43sL+mpl6dwk;F<Y4Z#KXxu;dRVP1j==2RUxv?!`YXg;R*$U!5I9Y?l<o3
zU8&E8w>S@4(Yxa~X7)43uhsd3e_B$mBe8RvD}Gd{EWwR<8?9p3?#Ma0QNgNYw+o-G
z?-}!W&0LHM&aN5?U*sOtDZe(B_1^_xS1yCJSQ7P&sTX|KT(3qvCU@Tc;-)Hsbhpp3
zPO1GG<gYYn_ITu5`j%U<XL5*9*;>tW0#MOON|mHF4I55XL>Okorp~@k7blQ($DQ!H
zYHmE^vJFWH)T>Y=!vyPaBy!~!k|!Wl208iO(>~)XQ**)OQsNu6SG+G_si_9$EO$p)
zQ{-9c5(&Da^53-k{n%Y2pH}2x5Jf4;M=>tNZc5o#^!!VH^oDKkzb-}*MRjehN|C*L
zP1B0R`3#l8QTB8hy@&d;b;8n0@*1|G$r*}dp??AF0jGh1^&&<dF~UTe0>(~jZoJ}5
zm-}2kamgC2T3)~D_p7?JE)8(G<j2f7Lx^nJKP)58@vW%SE`7Mklo#GvfF?TBdMd?h
zr%GgE%_LMbql^c#hmVrAqt)RzM`q(F`v#{jWU(o}`WEd8c}@NI_%Z!h2Gxt?VsJ4o
zQ8DhN0HI^{+%0ig#&zTyy8!zW+9sY~7RjM$wbI{GAEoiwAu&k~U}FrGi<h6Ex@oUK
z>KpHqfa2NigSR6ebIT=5oOFI}6n_Z8*KDv?_1&yrr)`J`-0>5$<EbMX&HJs$Sm}7p
z=}mI{oA~_8Rn3qx+g8!2>c=$OVc7{`N0Vcs-^XU$TSXxmRX;mU09+x7;J5R(tBRNM
zDJTwA#m>~I(cR@$el*09?0{R_am{$%WR{x?#8WJ@naG<m2cwjIPZPVdnD?6B?D;C&
zMT_AJ>bhVDmPK;e_bnHr;&P<jX+9bvT0561DQx!5B82EHZv&(%B4gl8!8uJm_hKR8
z8*Rh*y6|X^twd2zM)&u{-Kn1!Aq(W9e-*_!s_~aQkY1i8UUI!xCUD~Z^tQ~othPI%
zsNeHxzUA<0D&G`_E8)=<F|2|=TI<!f=H1k&Ck@$F(Y2Xo;!J~y8SMT!@ri3H!z)27
z({s<nnC5i^+yPYcp98vt(P_1k6Cep1NXejK;L7F0_F>mV(CJ&m_jV-s63Z*Z1#Ep^
zWWBk|nse0$s0_c>aNv=d|I!y~4*pO-f0>YKAaE3POWyTLD|;19#)uJKYlR8U?OqH+
zITKx#v?g#Fw2nE!yM>@xw!>o6T?6c^n!-nODS`7bibEe#gS;;bE6s>r5b&zrWwq7W
zw;M9|k+HIKZxjD6F#66Ty!eGtw^DvnQn=Mm53_vds`Z!C>SK4={%K*Qf&}RpV4s^-
ztLMkv$y+f)D^FvasLOyI#ilQJIt<-km_A$i7>O%9@4@!DVr5y`fvvW^Fm;|SULO~v
z&vCMt)qAVGei)06jhZ()#rDVcQu|;(<3{+ZzmzaG)da%}zxbnrX(l8GFBl7nXES4Q
zy8iAq{^579&rJ9hY#&uE@F}@2tNa+$P+`Y@pQ?Kxai{PBpVq!~Mlb?S`{WmIf<LrC
zIawtL<Ju-&6~<T~mn;^lTtj%JOhLR@9m!CDdurt=Ar<otH^%$R3cGu?LK=7@c1iDK
ztS2LO2}5njVS@r({M@(4WH*~kTvkt&BxVLm92S6+@GI)m4b||qTuJ9sybHQqN9r&E
z#q}CqI3B|iM2O8`02bPP^1Ml5RJl5U#Y^;<m!?@S-`fw4R<vWdXnE~;ce{pb2ZLsE
z7pvPoL%j!3YYITg$kZ-~eBF;pTb-;vU9{H-bG+QG_g|N=y`<U@c;0aEU2k?;=uXx5
zkIE|$cFUN2?N|c3V1nrEWxkNrzL!jbEqK^SVvHtV6L-5G7u?Lolmub}g8WISfXfE`
zgN<od?HSK2N~ix(u*?yj{3zsVB;_7`?Ozr}wkJk87pb5qps4^^-BNe|U9WHnvxtmZ
zK_+ziLvIY8EZjv(L#K|9gwfk6_|ih}zKH1pAKt(f#x1Fr^0kqD!YjIv`gUCCor|;~
zCK#L=ZE}8X7OV5(ge8Rg6-XQSV2x}2wrIQgdLr@A=<+ujs@9xfA67G5^}(B|9K{%y
zcf-%l!3s&P2^@D7t~uBXdTbC_*$kBc+nA8OGQs-sf<P=ub(^phu>N0@b0a+=LWiR!
zC(*P&%J9T3BW`gP$2pfC?TLNDLisP&gzKndPeQyGkm#p8{_YT>UUx`Xd6nkV+FPQ~
zHfP|UDZpvw^HxswS=3kw#7MS>&(r+h@{u+8JSh8l$!)-}u#H!0TRiKT8!V_DAbx-X
zc&?sPpC@Fm%%@DG?(DpkLSx2%adsnpe-H<^)x*p<gHA!V(&yHRfD8V=2YE7j-&3FQ
z%Q2I2>R+jGZUvw9a0Qlk-sr`r5?VK(vz)}CkV=p@EUU_Nqt<)v9^8<HAM4bg)~K{`
zSDU*-CYVd|I|mO64Dpvj^s;(~L2-&I#BJh5Zp^t-j4md9YW??kB*L?&eWa3!4%lWv
z7`G#D+*F=tgHX($8e`X~{)mb$^?H-Cvkx7509FH@*4dJU16WWdTuy!O9m8>vk6>>}
z;ZHP=HfC_&@!REF_^by>QeEZg^YJEO?JGflXY}o_C;Ots3#;8*SJw?JaXNCxG~&No
ztde7gwOLO7-;NgJiWVz#4LP&2BWSw#NTA>=1A(R(%neO;+C(+wm7vVO)_Hx5VA7DJ
zp?+?2YxDn5UzR!$U}6x)c+?rDNW{5e<Nko7(JVDgp@UCFjOv(|vbfh30<Bh$v@9@>
z8ni0CuUJz;MsAiqqdd$1NZn>HMGSbfS2Du#<z~Icw)Mkt#HG$O3$Wvv_nmEgjqHT8
z9WVZ_D=i(=Z`>1!B-0WQO0Z)kL~=22OcjK+T*5tmzpDI1tve4sMmqt2KGR%s&C^WH
zTYN07Slu52Oso^{c;-=vQ&c0I5^m_&2ZWy#N({*jUh3r6C0Dlpt?eH+={604KuQXU
z3nb3l3`;r%P&$O1mla1*iA8=gOQX6`hve~<-zOz`dww!T*`CEQ57SKlbn1A+ZmE|d
z_FI6J^23{cm5xt}JNO}~r`_T}VG6FAXN#;9`LrL5-caCe3b@BdySz(rGjZsn)tWv-
zlPb8p^y4fQNg7f^EZtMvtoG^H^jEJElF0wSi0n!Ob|Fr3SkAQ(F#f&{n#!AjPF<7#
z^t%{7U+r7O=TK_d3ZQjRpN?j;I-a&I`&3bOWB>#I)61VsP2&?`wix-mZyeslT?>)`
zPwfITC#&zc{NBaYf2aIENW`;Q7b$DC8kUQGCpOo1GKLjRMo7(8`u*;A)j4qIXA~Z-
z>YAl<iw;t!YZI9n+y!zZ2va1y<Zys?rB!C*dLKoRsak^?``3ZK<Q;jJK;w#R;=dIS
zF#>|L>a(ABLh4lR=za{%LX(vk5z{Z_!ZH$7CWIV|1;x6c_upTUsdxZUfLX3xR|iTo
zf{H#A#Cru!K6Js*YHV%<kkwH52;O!^b0PA*Yc6Gdq$&!RtpR#NmSyMZd>t_RWDC?O
zE)TPigB)C0B*=X&(&H!Jwc!(6XggFnOOf8>ZTX7wVs(3#?oj|)%O@~1bHS@iVE`qX
z^%UI;gDKEa!$cFnq;Cp6ULFMrORr7m(c{Ikt_OC|=x&q5CRfqPC7<hF?aUZ)Sji|1
zW0fwF&BJG&janA=l5yA!*4>mw7clx+=~!DPD()cdgh=>9tzIy78!9#$vX+sx_^gO=
z$`!Rm2dI0xYmBU4-`U<`c^zZ)UUvhhd!0?BK9pEY_V%^!2xw-5s7t#GZoP|%R6Z)(
zF3U-NXM%_cR<_~h9@-b@L~gzaj32P{Y5@TY+0vj4X%!uBK#|~QekmR^ud{I<Yd+>^
z^7Iv!SLLZ9T=q~Ed&)yX!%m)f`R&t_s|Q%d_vfw=pSoNQVa+wKpX@HU)&x_la?~Vw
z|BXr{AvO{2eu=wz%lVNCLHd$#(?T}f*}9f-jBW3S*2Pm1J~L_@+kDPYB9+1uyd$ev
zK9%DCuIRroL>!V*07HAqSYG-bK!(4pD=FU#l60A+3|)->GEh6<k2Eflb(Z#vkJBgK
zq4kimp3x02KNn}11jC_3v_te$6D`GPhaDBhSKj`<tO_6jT*xb<N+(1O%Ylp(%TNUx
z*H{tCuE81tkTj*9ynHV-4P4JfHajHsMlVLD`-URG$|c>XHX2+3B$FjHJ#ZGO4F0bR
zCQpYtNBo^ucKKU`LlNBe`UmhA=qo39Pd}gWUC`)W{AxyZ*%{F3AK#aKWmhF*x<0}W
zHKxEq+DUq996qt1dEb47TvHC8sj<7Zud;nEw_6*Iw(v@=nBn_5R^%JPMCQG3hWg{!
z-i6;mWC+)unw~UEMXM?0+w=&DGr3W#d2eM3glv?U2qsv)i6!~15Gv#UJ8?kX&A^wF
zWD*KngGEH$<^OaQf)SrXAInGW<?kkRbiI?&-1%gmfAUgg)YG0sh4OsX$oDa;ONXO!
zvMNi*?T@jxNPn+q7L|stZ4!*0=l<N*S7NJd;vag5RIqr_!SSxj_(Ej8Y?Qs(OM4+h
zh_>JR1ofO-FCc%^8*)t&V&my9?OE7VNV-6frZ@8sxE}ZJMu|D89{4=rltwy3(r#y-
z)4g|ZlXRq-tn|q$$K)~qBEf-%ZKo5)t+*ypmOl9+*D6=(HXWK~Hf`Mxm-gViusW9a
z&7kn-Z;E%EofLM188(0>uez+<L76&Z5zE=~iA_^wfrui@+~gbjJbgIgvG7-6u^Tst
zI;s#6f+Q-)-4lI9tQsYt@}h)FW?G{#I)qP)M*c=-v^^_7^-K0gx8Eby({|At<$I!5
zw`KUjmvm9(Ymo^J>2X9nFYRe&E6Nas?-itO=d13~6%X$006_|G1<#Ljq5rtNYO>c;
z1^*pXQFY&H?MH`V6Y>4gYQ3?3#(tXE8sCR#87aNtkGHf8mwZW{=(*3mmtskQ-N%2G
zAD@H{GD=RJ>XS%_G%DH%JY=8JPjD>~ih^Fp$3}h2_{RFW`;7dERKEQ62d{bBf>Q<%
zoBKG{n1n*-s_*kdPH_NyLL6nzjH(TI^GmV}aPbw+e`PyAT;}kQtKDn21fPcCvfK5x
z2pmK1RJ;ucfD5CiSw~znLO}q@i;W0J#H;CtFm}GtKPrffns+s)|A3K)A2;=c|Je3J
zx~+Wo3L1jmN&<_<?IdC<Y}Y*F0?Ic2*ru=nm=pUMa_5eDnc9e<O*I3z<d8a5SBLo%
zhZccikYb^|d>GTd!s2LPz;vOlnZ$lJF`{s1&5FVfsD1U>9SyX4!)L4mv0BkX2)9%5
z!+)bbV}5zTt7%v!sAa;r6n`1i1OcXn^ucc!vQsvKtt1rnN6!CCXxwNpL{+{$*0>fh
z3slpW&x_#}p((OiI%pr$O3-4<)$CXddh$|{p0D;#751NWD7IvsB;yl0*hZts;Ki#~
z-woHMZmqp8KfmOJsy32%Xk7lg&Xl95BqJ5&dnYS7S&}4Zpx!^k_?20VoQ#_vG)V-<
zHc%7yJnvIR)%osNeg;t?%Kzhe+ZI0~W>_BCvKF=YI#sqz*I032J>??1GpEIDBWKY;
z@Gw1cSre!EDQ=A%Yb;NfI6+=@;#e_7_@72KH>RN?A427kv>)?77b`kG%NE(o$dDp-
z3JHA4#d!P>!H1>st*f_2nm)3JNOlI1BryJ3f?~QRKf}#dZE;&$EoqDohv~AMKfNTa
z1Um(6_P4?t?g|yjaie?ODrt|`GWR!-v1D9Z<=Fkm1lKg$Ql>Fk_0J&<m3U?%ifRbk
zTh@S3w^boiA~Q@@XW~-k64DcRh0uif(_uZlqFP;Ow9;NsC8dC23kPRZP-PAT3js|S
zXyrbB!Z}&Aw$!G@k1&g=+(_rxMsF}M3|D<7P*X8fw$xI>*(F4$l<9Qz>|OCwHwby1
z7|R68v57X*xS!cm-q()KkGr~eCwYk{A5xvCKUOnUB!km-eQ!!admSwEz+>|}Tp!#P
z(*&=Q<<`$C%*E*NUJXm2ODhAQ>m~S%CJnp1*CnE~SceUU6Sj>iKVc0Og+>4+!IO)x
z6^I`>y*g38u+WGb|8Bn?k<ZM7$-L#)#m&N3AmXc>Q_fj*g4h@s)}*(YtKIYdMqo}`
z_Tg4BUQ5i%ABs;k91V<T9u4UQ%+#f>+hzoZOe&2U9w({gPjw@t{T*<HA&+gv#Z3e~
z8tBcVD0#Y=ZUgD}E8prC19-<?2j#TUwHU-q@+&D_7?w!x!Yf5ZoQ=01X}T)D`^~GK
zlea`l&@lyjw2-L8#hrB^CjM;-DzBQ5Pa_i==zx2F^8-La49j+O8$pp<*Utg98~xr3
zsW=sVzF3!#!Uj@&9D~z`7EJ_B?wv3&CGl2N+_WOtHV|muV@QD_q_fTq`;k*x3w#lU
zh;9iUOns_C=U$B;ETM?62z;kr?v5Z~Bvme^J5uuV6~aFnys)i<Y`vrP#eO8`?5jg4
zO|9oM{|!AfD>anfAew7_#i)8@ciqFfPhMXhqYl74iU+a++$RTh=x)BoIy!sI59}6K
zfgN;t`uD3z{L1tkZG!1O_?6KmN<dteO%Pl{NSTBIf-G}}Q=D{3H34q)L)dSgizJ)S
zA3yEd*kHqfwzRrJ<nrHxuOXDzQ>;B#mUKki&!XJ&+Nb+A0YIalt~D2|f_IrokRV5C
zq$I=FtGjFnF}zZcApb`GpJV0Wgr%>H9OL@>UvZ}Lqu|H;GilmP6TKD90XyO3HCKnH
zw(IZefZlfu83o6$13K7DLA=ut^^o&m1rziiUfXBa)8!1()%)6U>zST0w-m?r^z6O2
z6sLlu0c4oJ&oF;FC3Zp7bUjL0<I-XtIm&I%dHS0C`|K>zE(^8Pga;UGU?yKpjOY2=
zb~>-Ywl#3ri%5kLH}~zfrdIage%m!9hNsN+bOvtL`wqv1N;Ej-1>#PTfA{*Q#D@?=
zNYHWMpeupT85;q8$kpEUvH7jnrXJ@ZtIw_1r?)O??*5m1xPg?Uj%S!3+Hwm4Q;Gs^
z*K2fX`;&~zc=Q2PFm$`OfvjbrAGYsInFImJwdQGw!GyfNz1|_g=6J3O*J}hF^d2P=
zVtC$u&b<<E<c#uSA3bC=?}V<{bg?Z~gf1Gl4Z1QJ|1<#A?G`R3??WC?Q@@|2%7RsP
z8vk^^-+*ch^@&Gp=eXn2!|bY;|Hb_ycpofCEb`<Uh}op3K6Z3@LAfJyDLBn58`zm=
zNWO3g+%=jcY$s2@40ONKEFw#qF$Ez>>SnEDxd-TpZ$_43P(J2V)9G1{akUN!78=WQ
z42Q|~q8P#3`!cmbdp-f>(1gjiPo#|A6izC<5c$)sPh0Zs<hcs}?}J0+H=LxSswNGR
zT3nDI=UO(U6}PS=nV0dfi}F92?^d^8X#acbD32s)^*=ZEP}_yEwPb<!q`{4o|GCg1
zMFnFBPkRYZtW-^Xr)(BQB4aE6)<jJ;2Z#k)RJod@aMZO${FggCPD>&-tuC_wKO6k<
zY_!15A|a+K-meF0)|O;(=P(;~zqLOf?lGBw4$>%vycUD{Ug0ul5|$%f2OQrY*M(qA
zf8NesuO2`v3V7l5W&_0iT`Sk*>s!-&_DsE-FhwXWd#mNlNR9+HbzoG7XHJL;`xD{6
zZTkNJu0T=0c(okD1O1&nJUZNZaQV&!IRon6!W|wgmw>}mA2y2qB5MU5&VN5YXb^Os
zI={Ob)=p^4#vi|O_jYXiRG+tFx358e0-?2*Su=K{uv42~O#CmxfTzuA@BA+9`_){k
z^(*(N?bAc!-VzP?Jq35$+=<=!#q+(Z@ziiv?kVRJ{r&S&=9%HY&(8Xj_b2fI|FzOj
z<DXY@etsZbE6JUloW!ECGga23*x%U-M;<CZ`o)vO8;`>{3X-U-t$T}nLcB^%D$Q2Y
zQDAi-+>g;li`s&cDwoeaN=;wu&<m2A6ySh})0za%+@CL^LDo7PQ7l|&Lq;C_#)B3+
zWAASBsO%Z3js2ZRUXxYAdJ&p%b}oIxM^75k6sbA}0+MAv+MX(bN#W|#?%XdKeD-g%
zpNqerRqqj>kG;v3ky1H0iYY735mP_EWVyo;C$Iij!;1tim8P=1OPb%7D5#__z8SS4
z&s|E{WISo#(j7F@cIK|K906P7K_6LuaE|F(dZ)=`T18OUmt7@Mn*0h=P!I=2T9hv=
zlI%rrGLxjobV7ivNO;7&bDAg%tCCssEgX}P^zK54ZGKS`d^OvrK{mrMyo_uzKKIU?
z0S#L!vJW2F|LO#_%iGj9Jn9PHbO`xf#fe|${?4=UJNuXymvu3|T0OY#1LJfmri+l$
zxD`i2mGZ$wwyM6Y<t2QOTVTkm69=#C+U-n7!atPv(>_Lz6aZa>R<|DX(M1l9W^Yr@
z^imw+Y!D+I>63lGyBv98)C~Qiu<z1SJ~&+GIE6<S5%iyPuX^?Py@!!cs%8;JLX#EI
zT{u;|kK}Pi_d*>+dCBFJ37$D!d48qhe^yeqT}fryt}ISDiW(ZnG_Llb&(0ovaFrPy
zBd3}4&AVsS%V}w&3`I$!p3`;~N1|FN9vGBLQkq4hV$hXS`|q{hC1#3f2RGPm+(&H~
z-;cDWeP4=56jI<wqE4m!&2v$F?wu7ULN-nraCd_)9&cj6Q%3>G=XViEytnl|lzHk)
zk0b^?TK=&X?0ek@{+`a-Zd^(`DL&}7RP94p@Qll7o$No5^XNn0KsTOH?MyRSoKx_I
z$I(au;H}a)HJ}eCJ~+SAu?%(;hc`W%(nFsGkKM3M^h}MK@m|=L-8iFsScpkzD@rCo
z|7v}rL`pV^MW%=DA0+6O7cNNQ2KHe1+M=-lug&4jEacSMJetX9iC@qvXNZ|DU+T^(
z<6D=$(~$fdZc0W;JDEo_>0MsKkgFwefUG2Lc@spdiro3edGzrD931%$YpEBY)1<4Q
zy)W*-%kxN_UqKoYUJ06c0q~&T1aI7FL{~VLYFVTlZq-b{j1+~zwts0R-diI3-IIO4
zT6gC&l~b0S+tFBlS$V&4;fFtF{n5|0Pu8E|!TS4V6=GYfa4!V)r&fdl3RhZXdPI|u
ziNKD(S&{s`M0X<B4xL@@_}QYHNCqfJ`fPQ6Ue{T1MWZbF3+XjgbpFB?*&b)6MYTiR
zvtG_j+c<VGx=7A5)7|ZtX?&q#w532148=*{6x}(g8}l0vJ8Jm5GKbgIvj5$<u21&&
zd1-y@@AJX|E0hdAUcr57#eb4w%vv&x+S=v5p-1GX=G|P@B^r8sZAE>dWKOV`$yovk
zt-QHFPe6nHeelQrb~qw$xy*?EVp97%5ewcnKUC@xzkbc>+&EhMP@8&mu|9a^93kRf
z;2!(?yudy7_jze!E0j#xXA~r5apS1)i;ze&%iD;bA0$NK7y!STtEu^wd-SotO|N_H
z?}Oh{kYD5*>`n~x8+-gZUtZ1ZGg1Su9O`4BoKN)k+x|9B^}n)%MA$4(uD_f0Kqx(e
zk^p7t-ENc-95YA`G`)$gA#2PD_1{|AQ6eLwVk2`iqMiaT9x2e{QVU1*h}n~!nY^Ux
z{E(!_9+tuzuRGY0Y^PZTWwB)~E6?#Q>!CD3|M|~Lnde1}{YVo@IAIjLM36$W<1Z%g
zw=6fo&o6P8LAy^_%?y&%uiT@a0-byf6zFj|1@)lOXX`mJo?nt!34gx4nx0pr23~pE
zB~p&}&$yS8kMwtV=4d&6@(d{+DdL;Q$m1@WA)MSdJb0K;LyqO;NBq|v|K^d3_=y^M
zJXPQD;Mw}MKfk2Sd5!z`*Ds&fJK&`1rT+^&tN{2YADqL_>*lkg7mp|Aa6D;pJon#l
zcftpMb|~O?U7z;nzwMPZIwEQLEje>dsZqJ6Il5~M){!TdpdkzIk9OT?tjG|Kq#s1@
zGD=q;x)e~-)TBPWG%uZk5<MpEYOy)-djkhA!D}~30o2CJYYIv>z9eD8YlN^`hhhxE
zH`?+(Un8*}h3MkQNN{Ykyz@W-6g1<AvtDd&tY?K_WF%I%-w&<1-sk4br?Y=QzwphG
zdyJNW@<oIqQhX$>36K7@j1u4Jt7}z#l#xKgRL0lD<zTdMD0y2Yap5MdtXmOi?@_J8
zi~2?T`I<|YEFF1It|W$9zMcEcF$#TBYx%;8lt>1`GyP#pmG{vX>p_{_DPsxRy1X}F
z-Lq7wSxhVmksr7-;ESX4%Yt+`Nt5qP#0xs*&FRPa(H>tJ$yMQ3QT3^!L_?S%cQ)!W
zL%$x>!Qz5OVf82%oio3mxSc{3MgsG@uc+RQ3R=(C(vz*l6B{VZg}PwR`3^)Uv(Lg)
zL%fkjIiK#SbR|F$$j0&h#Hv7aL`b;7Buonl<mK_7|AZR_c}t{ps__3Bhilyx*q9p?
z*&~l|_`QRu9hJr7zFwT&?`+ZGtP6Ch2cO)^T=GmJj(6o<t+<M02J`*om>@1xL8kkx
zf|4~;rDj)!TN<uro(suwuC0j@8=`AE?tyX~gPR;jUW4Kt9mP|guc0C!R4tCYwT19A
z50qlr2#pQ1hT*x_%yEStwf)dB6u&gb`$SxC=Xm$|90pRgL8GLGpmXpqJn*asSIPrQ
zw81*wrP6{tve7uI$kTK|)>%j4JAVU!(l{J#bZ<*Rv`OC_Kj-gO;i$#D_wzOC+DOco
zADK(jv7Q*`fn*uDFypKPC7%_3pl`lg1swo(-Q}hHff6m~j}@gO>Zd03ObD_AXx;q!
z=Hv|5S}j{B(@7=N#-rJe5@Z-xgC$0lA`OCPN&Z2kSadfWxjkQ_N6qGFKR+_cBXTj@
zXCA1SSCOV3X3hT)sWM@OxBvs?2BLH<c<AMTh=<Z5Zs$NUc9kadch3w3pGXO>?+GI)
zwzK!Z(*qu&v%DNT+JUyv`xq~!fftU<(#n60%7Q!9ARmB|dQ$QuP0HLHfS7{p0a}QJ
zqnrYoa%U^gOUHsT=w+r?3X-mXP9n&XdvK!er5b~ij=<~W_<#Sa=(oIAZgGa_w%o@4
zwVuAXL(Ph-CzMW^Bk|l$b#9%qUag~aE@Dx~^EH|&96iEL4BeJnE%QBJbllAn`{<}4
z-bkaIPxn-A@F1E>{Eir;W8wbkdpy!E+$b*{KaL~PadR)-5_aa_fJdq3@yqiOK-^m`
zQ9ck#x=~$^G$Cb?G#I#Uz3d^24;?#7(3Kh8{A?3>L`?<eX<pCQXa&vDC1GSd9-vy%
zI}h|NTsh9VA~B({H_fdupiZhee4!}Qmh8z&TTc9E@V-Wz1Hm|=`{0Z&lq?6z&9b<z
zEz;1N_`)EVxSkq*vuq7KLyHdN&!A#7XOZ<S+8h5kip2%=($<SBC5Dj?)rNUE8V|ER
zH^Q&*-X6an;jVq6KdDiSgxiYHfHq-xpo1vaDE2rG79lc>qInJI0p<Y`ZGbX6XKQG&
zTW874x#|tJjZPEFRAoOA<4ZUkP8p9L7==rY_O5zP+r*iGq8CRtyNqN|mP*guf1RV#
zCYKE_sL)-(QzlA_272wwvZ5n(gXa}=^ax*%i~#L2<H*Ei>7d$r=P^LiWu`dm0YXBV
z$*@Aw&wKB4`Tf8c+@hQ9z`K9gr-?H_y*J)%v|7X1_<53xLr$ikS;K?cIsWsXh%eNw
zL{D}%GD!$jfSo+@na4_n-GoBLciy-O6MjXW-(4kBJ!e_@9RYPGME!*Q1G-C=ejaYO
zLER*mxW4y28Bg8!90PT`Qx9Js3JD`0dW!S7)aPe?Db=s=()HaBjB)S5-M^pz_*;YB
zo+a^a`x}O4Ta!=b(|u$q#kt=F{d1WbkVvIBbtC1QJtfG0Sct=7v~nF{LOaZAxv38I
zRO0c8*nn34#F1%+8%34kJT}6kq>?Y6LS>tAadEpO(vr@Ae!dLl(Xa==NuU)FsinxF
z-3cF5Z)$FE;K#3FjSsQ^5r@S^L1_y76kG*G0T<!tq>p#f;FF&>Q}ILw+32!LI3{?M
z$whK?N01m$9@Ouj$M0_Yk?+a)dDuA`H{#NFc-%+6g7kF+KIr-}ms*G)$$CR_f~%U*
zzP9jC$LS3HN6vs4c&*RZlZ!>>XXJB^cOL(Ip+Au!NEykJ<AngzfuN>;1J0akNCZ;E
zk;$4DI4m5}lRZnMEuzpR-#{?L&GA6cwI&xP#B4Sf%QX9!bWx$UmJpr1vwG%m>1phi
zV3F*!1E+6DnVi|I^CK4;s^je$ag5Eq2;`QyQP7KkyV84YsDWJ|FZ9udfRl!}YtV*(
z(mso)@@PW=b=pwC(FmbJR}UjY2jOCyVIFW@Xdj?3YqUM$n)P9YhfczNII0T!XE>h$
zTE(a~c}Gc{oR#z!H(pl+#p91sJ=}IeZCpJ+FQySlC{(-q5j-g+qolZ$J*}v!kLXOH
z&9$VjfJcq~c<h5;di{BD?t+YR&y_nVW%f#P3xve-b|dASb#dl0(>hR~zfv7b`P$&;
zL`GN7QGX>A<y98H#d&Vm5YwHraj>J+HpHD4v|I6`w9K8x#GX692$ba6Y|s1}I(TFR
z?fBIIom||)uRNf(PdbL-3GH##o-)5f4-ejOuxu+IoKf_%8-l{+-Gm<6W*<6iD56)<
zC2@l{cgAEKkx4n+Ye?M6DOM59(8>C+F%C}Vdqse;9~p9iSb9!j9ze^MT7Q1lEE6a9
zK5{E`T9&^b2Yv4E!G8iC=rZ7N;lmy5Z#LT}T!EKwaHh+rR(~r}zYM{v#3(r0^ja5u
zl3C)Oo#y1}FX&m0UcC>I@8s@1+WmE-PF+s+i(^f`3Gk4}8wBQuPDea8v3xuc6<G}l
zEAAKKB?}T`H{YgD@`iP!Hn}Lw40hPR4}Pq+#;uW5e>fH%&^5$g;q5`<Pq;4P3pv&!
zNhL0j9yAt0kwzo=7vW|vB>K-CZv0QcBPYG%Jox!l&tdNjJx{;ui4x$h-ph--Q(m@s
z)Jr0dU%BN+zB10w!%IXz>nlI~3a_m7`{5)uu`5&&ob8d=J+V)@1WC>)QBU6C7kh%Y
zy4st;nO{%r+cu3tR|Ax&y``}7fVzDO_}SGk@;QMp4|iT+*5`D?3J)cO{qPbSVi2Ve
zUwXQDpi4K-gP&h@RPSc!Zirh?xKD2N?)JHzayK=g&cE{D>R$;XAOA|2hx4z5Ss(w3
zU*Y9xem^{C^!MF!M$a7_fAyT?{9@ocZhnDFoz*;?PFMbs|1oFm1%c42fjG|S@OX3J
zjpCG)2j`M&Tq7*J&pAAJG6R0^3BtiAN+*On)i^aez3+3K1Jh@Y?{l478NIOpotsdJ
zFC}mYq!<vj*XL_Q(TbMoN8Z|;_?ZWSTl>q`I!A1yw^mr8M?ELFc%YPyb_2af%HnfC
z^8Re^`<%nWtI31gjVObwKgO4?j?!C2-U`EwD5wfKO7u7a%}5c6H-f7s)cL;8(RIe6
zpO}JPNONrRmf}Z-79ue*aUO~GWY%}qfs)S(KhXC-);kj~<DFCt<tlq1-2Gqaw2aD;
zdUoJJUEaAF-|BzwT$A<SbtS`RNfz;v$y!m0p;go@5ii61<S1X0R+5MpR8}{?{H&Z)
z!}#pA>y4{0#3kYdH3Sq*^y}kS#EYO7@zPdp&)4XsUF?q6%H1Fl*-|*oN9HlcIuS2R
zqA7XSX;^Fv9z@g+yUJMF{-B!|q9I4BNYuioNSL4h==a%h+V9mY5@zv6*!k>>FSW>^
z?ryG*_zU+DH4Y~MRGLK8&=GEZGh8ScA`vyKF%JUO!M&i-I$T`icoQr4xkE%v&7~?Q
zr#<fNS454V8c{Q(3Viq)r&Cxr2f4Oc6|M7lK#6;cm4zr7(zUz3vC${ok9?y)o7DC}
zdmJ)=HO_`EY%%ZUs599ZdE{CQPfPa+crtHn>bBnt$#rOO#@u~zsfeGyMCLd=b4YP5
zZ^X_w{EhIT^|3cF{4U5fmsQ?*GA?zr!@2}d%kP6l3T-((-Zh~BylVGVhV5|WRv&l)
zCjwNI=D(9g1T~d>e0pG<5)p(%#(2^(BIwe^K)TSjH|F#8L{v>lk>cPd96PO-J`v?Z
z=3t4`3=UUDv#157{D>aC>BYGU!p|2z$v!@gL#k`Pmeqr=CQX$HZAo8o5vqVt97gx<
zN##wdi)&i*`ibWc)xgkt3T?yCjT=lZ$O^x+2jwx)II^rLvv6i~zwC~Wjc^`Dk(Z()
zgX(2h(A+NfuCpe6xGFu+YVEz8jvd}gpcBE^y6%;=r~O}I(k5=aeNP<5C_m@Q)whtm
z!!<7rCtINj-jLS$;Rani-q3)T&DAY`;kBc5?(@4FX)ddecb=bO_RjZX6~7OPlOmM5
z?b_xjOZ4XLT)TvKxUruED0=zWdC;jZ<DvyGM0R=$JtsL@v2oT{h<Lo5IMBuB$dHIL
zO836@NO9=nnWx2cT>9Kdt?TQdW;_7Q$}#hf@*{e0++Siq(a&1%Pp(o$m!<H|HCqJ0
zmdqx_b2oh&v5OZ^$s{h)-3=%HR8?akJ~_0l5}l^S^Nd!ywr|^I*jsBEy{JZjQq6U$
z4ubZIS#*%qS(-WB`O!=S<uOpHE?YF+`5JFEoMS5^OA9ze%b<Io&Z94j$=rBJsy1tG
z?Z{fz<TONC;m#bX3G<c=YO~LYUNo-wd(1NF4SS#c*7E^>E5kGj^j#>%DSyRU{`}&H
zhX0PiM5T%GAqG?MpTEUsq9|6A8_m@RhEfLIIMkz)mlE2Y@%LEHg-mPCWR&lxu3&QU
zPmYt}@f+uve~bP6ye?fa9%j-~UvA^l!~dR{vTY>wJgS>%<Jgo1o2j;gH_6YH@4IRf
zoC;EMw(*T8$?{px!lMHhYW}^W7mq7&IL>&?U*mjQm&ExXYlK90xc&bIJVv`lT=eyy
zUs1CT4^guLM@gkm_(Xj}!3(03ENXUX<YPimQTY{R`z!jkk~X!!<G-SE4=yzcx<us;
zIO^s861`blPnuZQTTSYgL`4)%q#Y;HmOH0$RPMCb&|~2|QMtz+;;7tR=X}2AawW$r
zh~!F%s7-tHYV$zAgGJQ#WLy!sj@s@sC*`16;pq86Lsag;WAtsrMIZe66~%k;7{wd#
z3UToX&zxfpyyCsUqIgRx{4&iUlKJA_qJbw7%=(W1iV}9XXbUpBMQbfs$ty{e@Lb9C
z?KUM(k8#A4*(*d%+*KQnMFh$R4f=@^KKeGIgz;$5pRc*u_lYSk3mP5n+#c=PgSi!p
z5=Kk(VYBA$@y|`CyUMK)Ki&U-EIyvZaD8)V9(?h82&0QzQHjPe2RCNK+g(y!0S?D5
zdMohVt7$~A_c)Fj9f4YknvdTpuP0$&q57uhYZRVa7Lzt|=I+es6W1gsiRV#LwG-Q1
zm{n&DgDb{{Lr>ak{6deO<nZ5=Hdq$~j-u7WC>&+<^aU&RcJYt#?hZfed~Vz~Jl@<B
ztN#s;9MR(lS}jFe2@_W=8WWA1+J!%%Pny1zz#x-oSHjb-mZz{$(o))n60w#QG^>Xr
z9zBe+8pyaU&)3K~;woY?G7Kzf_{rrUbRIoV<IGtqi_5J0vPQRAVgsjy<-Vxrh!_7Y
zQ7Zep78jCQTy2UaSsuma-B~63EfK%vm&iJQOV)3=8|U25Z}_9<A<mc-aj_ztuMznG
zz3QntU!&md_#n;KD7bpVov#u2?A79F)z^qj0aWQVomqU1K&RUU^ED!Wpyp<Jhx!^h
zf1sf2dXSbef8fg2i3%aRKe81zbma~P&esTZwYqKB&DU61{BF|-)Yn+p6p*;7>uW4X
zJQ%%~$Jh8VuK@eR-xtG=uMv3#tv2ziIbS2=*OEQH#uxYb2@Y3}3sB<!_V%RSnZoVT
zo4qj|Uryn6Z{p**o*&Lnm^FHj-u#3s<DfMo>EQVqr&G)ER<W-UxdlWn-MGB@8VhG(
z7R&WhUt>X-PGeis`5J-FQk(iij;~Sh(!1g6lM_6jcu@1<A)ldEi9PT>zpr@?4);Dq
zpa1X;k9iR=ZOg3h?+%i=Q{|<fC*!rGcU_E^n*2T}j*4){Ln{<8P%ve;Z9B}qM&wrv
z)cW`neT~3VUAh19zQ)p}LG(ixF~8!{MMt!TSSkMNjzT=GM2hQ(T2imFr_YXpIJLG&
z&4{7pwmE_FBYGwJgPX7MBcD7RbV}ZC)RiKx9v7hWk6Q}f8LSAUm`qnPUk-L9x03~`
zo*&LdS^4oE`kf8B67pP%)co*Yqc)_{$?-MfB&A3|^fdxU%(Bi}eT|@!v^B!(_!^mZ
z)-+$k@iqP}!-x3Letmej5wua}3p_qQ;FFb%=p%e?(8c2o4LBaV*9RQ&OX>YxaGkX0
ze&_iq1L}OgEC=uS8iA8mX?BJB8ViRLN`~O|HG(gaC1JUT$JYp)F1($!`WnGoYtALd
zlXjdq&;{}B*~^&E*QkFz`-&6?f89K950^giLN+v?`%*Kq-X!YLQ+`D6jr*EW*SH3!
z-k;-ZWGOsbvlndhH40v4e|(LC=V}tye2u_i1k~VbEbI{<*)k`@*9eV($lE-S$JYq0
z0;Q*N@HKL-VrFUPwbrPaTpf3CV}>`McPuVRQiHD%C`s#X8i@HCp*g|TID@Z|vozCQ
zBlsFw_saX^Ae*o8ZyBJ7q%LQ_^?W)ubDBnRe2pJ7*M7e6$)67yZO7O6WV9V$<JU|#
zPHE{&J!Z$(h#hXIzVrARzh=fw)bq)lQ{#P&bnK7;`S>!`*Z3uq?(@3NihGt<G4E^C
znKI>gU!%;lb6m9dHOfpAzx;b&Bi#ZJbZvj4uMs%$n4)p1$4B_==*8m-0#4_>e~t5L
zT_>lIwBZyi+<yc9E2r?_*C&U}uzjN5%qO=|O@5U0_~ejNNLTsf35rjSa|%;_Vica7
z!ecierx4Wy%kwotm&dX=B=N~1cMzu0dVF%g_dZoQ)F+25K?HwUbcXok0{Y|>DjstO
zzvUW6T;i;Me&rxKe8QuWo=9*Mj7+6zbSd%uq$u%ac^3mms7)enkw2KZL;Mn_OJ9;d
zI0kdn#qN@p>w`Wyhz?g@oQzyk^u>jFIA5Hf_4UR16<!VV$w9pOXv{&pKFUbP-*A_+
z=tnwo_TT3uoDYX{C5c-`DPFl0XSdfr^=)CLq}!PcKfW#Cq#xAdkz?Oh$mBe}tp^P!
zad2c0p^T=E+%1lq^v3ee1CG$4`2~K~h@~G(PvWf5WwyHgF!Y~?k`4a}nY!Qca3fr1
zuj4cUKfbQYEywnn!PkX*zb!Mz`MQ83u)GIf7w04Av7;XFaGIkB0MDhD`FxEULfyRo
z=IcV}{}?9kudj=6RBIX0*M&^%(M;1ZUzbO{uj}H`SNJ(A_cMKKwl4QH9U;r}-v<}H
zq)IMftxIwhuth{glC2AZVOfkoN2%$oIM){!T<Vc4-o`e(H_2*5#porY!yuS5IecHd
zD^&pBNnUk<SHn@3vUK$j()D24?S(5m>b{dn(>ON`)Y67k$w;MZeqiU9J@q>ECO4cj
z*|avyl{7IM_{t^Z-*F0I_<BH3RbMAYM)?@dW<@q%edjUI6f>_DXALb!>H_-};sv>A
z%)jl&KmSpD?e^{;<NM;a-_W|3WbuXbVVol(>^#%OyJZ{G`DZz2F5rR2RFd0GTA5}W
zlYY7^4}50M)A#6;ZG3P95bs|9_>qx!BViDJ9?0F92%V8J&b$RzkE>g!;3%^i_XV7C
zr>dD^cOM0Z8hdcf!RXvX``~&?;MygNjJqcazE9?Ti|5bPGUlqHmt1P$*NB!ZS5qm=
z%gLC{eB`8~+VJ(Ea2~k|FT3|4&g0%5KkIwb{0i^Ay!-J_xW{q-?!AxuefdN@pRZZb
z_<o-AZ)qsM5zb$QTIdK9=OQ}}2PLI)&4f?<@E@yd&{`L2e(D+=92pRWGhxwQJWHJz
zWQOHa*I+HFE|Q>=&N_`#lKIFv<c#lqc3>^_Xd?W%^i%JEq;1z79`Jb>{wt6Cd@uBZ
z@5|8fxzpX+sy{5wd1Z7j@#?S+0ts5Br{S_lt1+a5FVhj(-R(pb!mY$Kw@OYy;>2uh
z=jQ-DBd_++rv^O#rv?ug<CL2M&e7g^4Ae)gC(cY~JtTlW#}y7l2-MO2e*E*dx&-(>
zkNoa8ULk6iw<Ui*pXwf*@2lak9h-f>n%LbavNDU+WdI>rwjVcfjOfED58e=d0)Ma@
z89cb8C3P9jJf@`2Nj~HEx)Eoc^1aj-_4@(|vKzYB{Dggsbvo|8^Y^`qN8Ftf<QY;+
z(;t7LtP|CeYB+z+naF(&<CID*V%b%e6qmBR#ug>^)$cCVhOZBW>&PXA`w-`GZ;zk#
zy=i`h_g>!p_~-9+PW0Z#{l0u6p3kQ`D(8Ey7^vr8w{gmCdGrOUF6T^o4%c9=_x|TI
zKRk6MP<c#gZlQFz)s-MN&z?A>Krj3YMn@Ij6)GL<UDty?btMiy{|DDm>q?xFxwvxE
zx)Ns|DC|(zHaYaG-o%g1yA7@9KuVR#Cw^pTT8D!E*YwQEMW+wm=lwp{eDFO^-3mIR
zr8R^aQlg}0!dM!|d#(Cdw?a_mlxfsA8yr=&mildREN!TkFvspTkBPJjz9}E-S^WIR
zzL&fK{(i~42NDc9A6)ijv~2k2`WFM9fTj7*vy5_Zx-U(uf6&iy{S^2vk#Z*|T59F`
zM;?9ZVjLW<J_Ks$$XjR;lr_0363?4s(wGh>91H(E^S*T_?0dc~{Qc;6U&x~58%^u1
zX*gW#3vIk*jd}4RIWu@N7`+<aa-KR4x(j7FB{~AJ6S)Z5E)Rz?^dF(2S+?a{p0Cjy
z`url9hElIa9-XVr4=pMFIrQB7!2_L3c2QU--;3IQ?aRmd9iQ*NTALsfevQIkI@f>s
zSNJXoPsw&dsBRsqpM0ns@^ik=*}m^38NP;CmUtxQwi;3yrfTiZljr*Eu%LRw@}4O_
zUrY7iWFw={INu~VHFbxP$v2PX_o?y<zVE%3cb!bX$5N7gxj0*eNB~O7<Syeo8=fVm
zMXJUuKEaL7U`SkIbPkC(1cxmk<%m8v?BHNnV_Ef@A#tV9a@)4bGo;UoUVu(S+s5FV
zF7gPb%2tYDT<a8|%HLKC5)}mVG|y>9R*b{jJh<r#jMrxPvh&{%ibefO3vIgP?26^4
zTwj*wu-=yiYDuNc=WA#N#p(u-m6=q_rTyN<Nf$~R{S)Z+sa(W#JFLbB@hp|cY)&tg
zNF*6oy?E!F%KJ6yxVS|AFrMYT3^?89sW#2z<_(M@gG4zj&aOP@BViBTQCPIAJU$~=
z6c#Qz@|lN}!dN!OYTSog@K)BH_jCVG#UF^$P^seIfd8uab8rMPCYBnD8`|(J7uH|d
zYqgLEnTke-lNBlPB_AsR{RlprM6~huOTCt~rD<-9O`c=T?(jYj-m}AJKe+A!Ux}ls
zq73Dbsv(GykI_$0MWN$cdMXN?_-s_`n38GhN6F(>061?UjZOAtRfEr42=Fzly^-i!
zNXzgaPkYnVw~&B_ib4)YVIVY_(2>PPnUM8hk#Qb)g{Q-kG2E=dbC9+dS9m1gQ&H&1
z%cr7{;6GAzWlGO(KMHEGRIL%gO`N*c8EWRq<)Wr?%LV7|853zINpG#-MYL|<RrM>b
z<fHmXLMTmB`uSFw=v4mU?|UDoI!a9(MFHBU^O+-56~f&j(r@`epNd7N2GLWo=-`>#
zLoTUJl(oAH8dGqi97bnL617Wmo?8<BBlE5~59Q9S4EAuM^?Gi`n@=61P_gLfxlhHS
z^9F{BMI=R1)Rvp{*4Wd25oQTjEb6m}HIMnhp!!Fu4UrKe);v~I_>>U~U6yF)Sb5&*
zL7$36hKI^T-zphJoGy=5U<wtE9NrN7!=9OgGi8x}CU3@wK!lMY6|YvZ{GGM5dLUOP
zYLW|pPZ01ae8#L0_#lW(=7T;Jjt<VARvTk9&Ua)DzjC}5&tr<_v{5*E&1v^!=VDch
z8kgwR6>>BU&@|BT@vU$q=s&+I90~pt`OIH%R}typPemk$S1zVel{1ap)NeLBnoTeV
zLMWX^6Cw6M)|t_CHCtpB0`Ip_P)TjYH_fLa()HEGib&_}Qmd53JPodhG|dl)2lmNc
z1vugN7#hVv|B*y1T^xj1)oVx;v$Xcnk-S(y;<vR=^7tQ<)U)&%Zp6P2PEw61rHMo)
zu~O921`k=6noX#DsqdME+nVs|(IKK+H3t&vY{!E8aI@p!9rT>T`4R)?aBsFahosde
zT#Xc{kG(d_(A@}GXK8}aE%kuX@%3dAX`1ES`86We$>WvRX|?ta8aT(Ts`sT<*WYld
z4;DGcgE!W_m&X|`#5eWpT~UIYZ|2NWlLY}9skLD@Hjg15c0|C|tvq7WW|>cWFRljV
z(T8&!yl^oft%3%7I0=e3fNk@r(_&#dTp9oTM`x|E`wamDQ|r7DkIPo)4ecKPyqr|f
ze|~XZ!FgZN(k$2dcieICi$~7k@Qm)adC0A&FNXS3h(~ZGFk}Q-P6#ne62_{{B~(kD
z_8#7v)S^QaV#-f_Fi+p!Zt?fQzqM~<LoJEWzV-~dyo|gpCZ$OoTGlM4)juT)RNp%4
z7<R1;ht=Rwm(j8{0~sqH?9cM3qkD%(P2S^pd`UgYD57|Zem_&!S)&`JYDy%3)uX|<
zWb88D)f2P1Ze%ZpgQ5K>Z7zK|M!@t?9`UJmq<ue!;qd<_`+n5Ynt26AQ!SEsUVEyh
zMNRbh8y?M7aMk3IX;|YZ2=hSNilB*uhJ`P!F5YD+9Gi{T)GqcT{K%w*N6rM4E?8*~
z`qTzJ_=&xck;l;79F4sQ^Kh{jVb&-1BCOEWISrQ0@y$P$(8;r5U1V;nKX0Sp8KqB)
z0$D6<*djX?1;V!LRJrrH_N#o~Qaj%p%}SP)Mjz6T>w6mGbsxOy`;Oq_;u43+(h<&v
zKkT1R!aJNK1?|({$9hn&$$yf^KUTYN%+}uw!GLpeT+$kQh^kfDR(rNuf4EsEjtqgs
z|45C!!Yw<SM4i!@YK=We^QfK2+J#rgkF^W0j{mi$;Y9tK@y5|PJl3H5Rs%8O*Cvd$
z5gmS3<!!~g17e-R5$g9#Y}vYWzp%SKY0X4DythC8B*aRFq8-tvHsZlgyrnxg7jGHn
z;o>dBtWUgUSmE^=#M+3*_wdw4JiZ66a5ra*@h+&6m-)HN`yPOjaa_vdd*J$eRU^lb
z?*S;uFssO*zK4K5wGj_~d=D~m?{)&>dkFJzzK1aD<9i4zJe2U%M!dd<SR3)u(_d;P
z4pzUv;*svZ)L4A*bFZG-iw-}la<|s)fQu`2`xW9!-MP8AQg;$At~8)e?L~)cT&X)Z
z7grkQ;o?gDtZ!VYU*WZ$p4yAY2778R9vjSaH)qK?PIz;_1K)JH-;NKs-0z1|Ywq_)
z{;gGMQR8Lo5Sjb$FI;oKo7CU9S=5~Sjd`ba`VF1jZ{RR#b>^D;jkOnC;AlO0&hBim
zKxxhf>(Y{QhwmAs%V$v`8aIoRM9tnaKaHCOzVoSGsd2NRLg$H_eb7K@2S0JMGV+Pz
z(zw|$4;MEZW_{vj!wOx+Qnw#YXAd{k>FiA&G2{0y9&Y@>AI=f*t6N46bnu6hIsB~Z
zsT8X_;B-;9UqKgj=jL?LP_g#tq5*w4`@xSc>dwvSqG29R7Y(yMx@cITtKb_X-PJ{-
zWW2iQy(OXY@VQYgKG@yA5FaeJby}9O#s|Bb?c#$28Z-rmV^_IDhT{Wr0_)d2<oPf^
zd_YdOkNGFA&{c#En$xvyqNa7}k8n61``_`Pu_^wm%JsqhJ@Fc($34FaxZ`fF61U@o
zjbE8xz6pL%=6=pixJPZ}PvpqpG;_abtg4IVXT8U2U;hR?R?m(2)x}~JUWbP&ya6XO
zpnb&GTyMP}uD7ecL|^acZ`FK};Q7}3armz)zXw0ME>Jw2#d<%e@=G@Odh7iFN3><s
zb-BtfDG~97?5Xm5b=}5QztViZ-l&^$`gy2M%RT1Pdh7jgh2Gpxl_J$?JE}rzRQuIw
zJsPU~9z0g_jrh@3o~pnXk5z#KPXB0p`o16q^-rw#!}Wg$_tp&ce*RWnc%taxcl=k?
zVTYS8h|!bgp<Z3EkS^GIIl7kVf(03N`}BNLU9ccHvh?VWf2s~2U688|lkU-<uMzj$
zPK{#G`EciU*;aS;=zM$^w`TVqo$tBns`Guk|EJzIvEcDq^AD~%AJBycmO<ykyzAKG
zt@i_b=aV0zIv>{F*-#DIn%k+M^P!q^IsK$vjc4MC=FvCZuHc2RnBI7GyMh~=SFHCF
zYE56=E}~bryZCQP)9eUe@27Lb_b6|@pRe_^9UgRBcjLa{@#db|-{0`a5j}o&AH-mh
z_8RN`fIp3*dY{*Q5ZgflKGyr;O6Ij&o#<1uJaELL`+$F<@=AHWMrK%DQO5xX9;=&`
ze{>w+S?X{)9j8kaYmPcjKs`si_-~1_r7xVX_XA0m%dmN$dOu(5(ntL0c#mZLhP!dj
z{rrZ9T<bso=YRg6^gsW<|NL+NkN@NU`{$qk^(XWH{I7rhKmYmP{`ddm|Mlnp{lESL
zEt;hxZE=D=M1pM+FUX^!Iqrgyof4PLVShK{W#b)_apK{-{UMa=o?`1$;^wo4)>>r@
zBCfQ!Dh}b`5vWg#@I#vVpr2=SCj26dC=_@3fXX~{jDt_KJCa{?BTFD>_VZwr80ge7
zY}SM$6a?;fw?alMDPoGselVJ6(lO5dmA#OIg|V?uu<%=tIHTxItLWka7KGx#RmVX4
z(#9EEd7xvjje%%sI`BV?ifYZMoLEFVk~VdI9v^s@;~iNj+_FijKqM9sv+NUxYF7D{
zyL;Fg5p9a7H^g`TPtkqCT4s|m7Pk;qv?Tq#<>oPD?1KIC^mK5d5!+YYKN*MciO}<M
zaQRinNfRDAbD1Hb_=kwAcI#nu4!5tedcsj>WAfK$rx@KsR_Rcb)jE6P@qEtroEV`9
zcNjUGFQdDcB=b1bz;~~2l&y1=<8I{VdkSez8&G+4-odKW{jbOICZ@L!JJ<$~A8ypo
zmvMgh7aWa`#Zhlnc*MPf2mgt9<2Q{DI1;Q70LQm*=zK^Z<_z~FB2#!ajN-`y78Bpu
zL5x_wu8Z4q^4Dk<-S{R~be6&|(n>SaQ1vLrXpPS<;Jh;v@2`CG{V1DPZ@-A3bwZI>
z(K_!g<~Igg3V4tvrYO6P)sV6T`s~6zimrS?qDR#BNyjjpg!0{2g#IPLX?}~>&iG)C
z)dlYZwNMycC^ZsS<IXbdiQ`xP>&veQoqP&`U!5~}_!Z&MC2HhMb)PXD+K|=e#yB_{
zoa$Oo8*K7gTDkMMvqNIunTOxM>FCelqbN=NJoFv#yC(+^zdDMZPS_K=NO{`6x;;S>
z(w48?Dp5qE{YJYx8;`T)Z(pC0kzzk<e&#`ZlgN2RUc+~_v_9IOxWaYU^5MP<uYo3~
zclGSZzYz~NKH_9T@r@_67Njf?3fJ0Rn0Z6uFanAAj!dMH%55D89ZpSfD4m!&EOnLA
ztsaVSH~XMG#^nSD=lP|h8Msl1O#7<Fr|cI&(*1C+J3m|j8{@8~F6INz$|HJjyu$+p
ze%f#0$&MyqMsaA%!;=pldGA6g`O?O39Fzz@8S`YF&qDabKB&$HXhv;)nSC`5xe$wO
zW5B(}+STG>`7<x!>q~a)qC7^w^Kf4eJI^pO{AM~vn8&<hxLL2e7Pmr&+I~DI0bROn
z-KSpo{*=Gqq>spNzBnq#p`br=prRZ+jkC&Lk8Xs}gj{q_x==IYjdPLs>wd>*Tr`c*
z!Fv)=9%CGy=f9qKl;9iaM<z-}!2Yj!5ap-AH_*>|`?Z`EI@I=q$GCXdKNxN8!@gcT
z(yPbsY0k4#{^X@DlA)JQt{nALHSs#gGR9Nj<%N-6FXs$jA1)h4K0G<j<8p96>wB~P
z3O(xS^%Ea>wYG)H&M{uC?cxt7=+L+%3NYYk#Xa!y8aPBl7}-IMLlEoQ3u8PS0?gmW
zxEuni7iU5R4sp<jL-?;Rhwvj`4iV>ZIfS3}<pq9)7d`tCImALTGk+a<^;aB8JH__f
z<4AIr^<cV<Z|3TaGemK#*ms;E8-W(BgTT6J?tC*>M}uHQ12MX`jtu{lj12G5WX<%V
zd^0o8qdZ?1*0W0-`D(Xu9{9w@xU;_cmS3SqZ9k&c7WdE7alr2lJb1W)NI_@n4mS{K
z>}T!n267<~`P$tzZguk;?T#)ZzV8@kWQ0?~Eg0v)%c`$-2AqDi_djuk>#pU)y|!+0
z{MWoVxHaMZiGJ+(a~9dTOZ+ySF4*zsAkb?YUh2Ad+r{wAv0#knF5?r9@WmwezE^IQ
z4o?sKE=73+(L)my4uNdG8@jh+i2rBiF1k@ZmL2>*8;>(D8vH*8pYYVr^+!jpdx)oJ
zRuXbL53ZHUXwG=URR0exC3o@Zv_)4$xDxu06+sbiuiDI7$csfe7i<~#Zv5;Q`Z@bO
zmVQ4IR|C}Z!Mh=QfJhI&cqs@L6#Q7_(ZA$yIATzt*5OQF^g}~OADmy!=tL)b@h_46
zP|~5?Eb<;DKiA0W2buPZc$y<Q{-BS4>ENiUh{gbn_JWXh_9PLxtSx9-$oyn<q5q)y
zmj*}tu+ND8W9VH;T&{r8g?BHx6YzlWx>0hzrEWK<a5|OY`|i^Q4JzKbf;s!0Hlp#x
zA4T_}9{i)9YNn&7e8wOD)i=M^`CY<=E=rsy`?YFX#o<_&;yW$FWgi63k{7DG)@A(3
z_gw8~r26aVn*$&8JX)#ZAEO&|{bQ(MqyDkHvT?Mj9w_+7P`xaouYc^|Ss#QQ#jz(0
zVe!?|C;PTgL#-KI2sJalM#|=4WXcx~XO!>!W6kjizE^#2kDq(^@X1GS;$Icd<G-@w
zP#TlR8J%48gi%!Z(0fQ08<L~3&RN?`wjyGVbqJ0M*ZuJtqDWIquP^c0S%)XYk*SAd
ztgdI)X0e-31fP<e@a{+e*LmdK))2fExt~}IvJeCXNtqPNTx5i42X*exjr-!ErCpla
zzF+rd(J2ew5r=<o;_*8o69&z-e&gW=9lz$|Nj|tFM~wKpf+Jff&QrJ!akP8mUJtf?
z&-<X?&z=lNhPLvlnrc;@KkwDl!@f}o%Fd&+Y(b;=g*R|Lk3I01&s>yL;##7I2lZY%
zA|xaFaANmbK>WYyJcQyHt+n;->61DC<RW5vrb5k(XRc1<C|_PJ`ieKsp?`f5L7YG0
zALM&J5|)$=&&PeK6rRc9Ro*BVFKt~MuZD_C<sX)~jq~amAKaONWjx6{=Kn|=t*fdh
zqjPd2YXo>C%%%}!t~bG2MZ!}@uyy#Yi9Svb8Z?uDFI15Hqa%-^Z(c3WRcs!J^I()L
z;CVEYJy7eEHK$gfJ;(~7p9_kFS@o!pGFny3+Er?k{N)9Y_glC--v`zB<b0ZPvQg4H
z_^+3T-?-g>eUT7b|M!c8`2fO;#J87<QMnL66`YpK)j!xHSdbedJKRxB^RF)(@}ex?
zPv!vqj;~U&p#A6UaX#TC<ny}Did*GkPWVgTc!mB~eV24G@|kHBp3zVap{;B)MVQ8q
zeLqV%GwscO8F^LwJ?xit@uRJfzQ?8VUi{h7qm?`>bNJ-IsGl$E`t&9wZxO%Wgzg)K
z)7Srkhc_g{-#4U#Bd|-nPI%#6q7}AG`&O9CRlMJC)`rnQEt7p`Z%8GhOg+C-B#x$M
zyPmk`)Yl(-hl+1V`MguaHzdK;s?P~Y<8c&pbwlYA{>7YT);FX&=F&Hi)W&`PfzM&-
zYRCZRHzbK;vp1xS4C07}H>8V)H>7WGOYlLa#CrvA2Wjld-kf?D9B)fIRfi*{L-5s2
zs&+g;Rr`J&{TA`ItLfWSnO$DK(K&0^XV2ps)!lO^nf=$$5(`@~c)6OXH`6IIOBL*R
z-Fo({fnpJiFI3ft)(sk5%`$65-#4m*)A^*F^`)5p4@;T`_N}rLaWaGLk_N82@;<t4
zmlsRMckV}j=T04hLlcwpK`-9U9@~zF?ouD{FK=D${J-GgrQzG#n8&jl$KU^e-!nRR
zI3tX{z>LEgp`Ay^<$KO(uq0~F84bF8_jU20&zsr72VJwA>@`23lnuX*6?Ajcc~rTF
z19mB_BRiw9c30k%3;V!$g@di>!^uAL!+$<-%KK)<T2*JMba2tYioDtmSZe3}lN3w7
zJt&_9;Mfz3%o|xH`cxYw+N&Om%JyiJ?@k@ODV6KUC|$s3un{L?dLyF#7)9gVboEBL
z^;~{dt&hcC*!QJ0ytdlw;!A;nGpTR!Z+M_s!{66mhtDS63XJnHZ^pAoFYD<0C`6`j
zgU~~61j_sBe7<k%d|%428;#{^L_mjYBA!O$wDP?k^x-(?WqqGlWOqiDtH8DAj3Clj
zaevN;_$29@`#B^3!XG&BeMjXkI=#GKBbK%`jWk#zi&fvb64g8$SasX4Q4Af$NiN5R
zqI)?X<0$V7hv%>J%&04_63gT1Gra_j!s87U59<{FH_0gW(;=X_Zjr%=%dNuW5yK0w
zuKM9=0#hR&22zjzur^00HCNoNs5yLmqdqumJQ6ow<0ut9yKB+irK9iqc7k#SN$1yx
zo;~b|grGcL4IIZKS}>SYDy=?fc%#1fw`iZg;Gd%{F0Ro9_LBZa7n~RNC%VAlxi^k!
z;K!lOK44O_dl3(Hg8|)lmbLEEws<iR+28Z(s#TT5o)APApj?EYNjaB~E->_sE->7p
z3-;_Sj)DtJ|74wCY>MVp#<uwp{o893u?9Y8UQN#$M-WzyX5TLwq6>cQt5Vj-r~{AZ
z&(R!T@h5uW!|(o%BXJRBVMdOY=B1_YxLd*e5`h-*R7SE`0Aia<_BhYh^!*PtgQwn(
z1xF<BCNegPXy<sf?R=Lw2y9K23LhfS4*FOR2UokWqQ%xT3hWiQitHC9iiUVG^aGn8
ztl)oSZ{cGawwlD=bi6Bew{oO9z38PFhrcK4@OuuQ&ht~8io_rMj#Cl*vG4wZhqxBS
zf5o*N9J{0OBq(x*;$r;bjub)l!r&hcd9|nQo!LAn5aSvrP)M+K@xqYZGk6T#0*R>b
zaV>`0tF^_(xUbP@3dg7;cX>sFgCEYNcOIO!vhp+QbF0G&9s0zz*j)^97T@AsJdT&N
znSaN@e8Zpkn67at-|#nX=HNt;3Dq_jB_e0Jme{2-HGUF7D!2hi(cGw;V7Bi{635cG
z@h6Yb&kGJ(H!%ghaWjJQ80`LQ_4yi)v*N?#kwwmvL53uNVe@EvTg(eO<7S;Tio^e5
z)Vy81!e-Gl2YupZ43GQwC7#CP{(O9#%{M&6-&_yU7yOCKarmW1jJ{FjDp2mk11g_e
zr1Qz*dZu{aP<UZhcvSoi@^Lx-zFqq>e0}Usf8VbC8Rv2BPe1ExQTi2n^oh$c`!n#X
zh+qEpiBBF5YPx@j^z+d}{v<r!G>XgH3Ru&gVkur*0Vo(|e{2Qp%*w5fU@L^^rVt?|
zsM-o0KDXy<<Yl3ZwT@g%7L+(&+P~((*LS67)-Kx1t<a(VBrg6d!p!0KgyN03c)W2A
zU!L=Q!`%&CUm^wrj!KC|cnj$k!f^&3PsbEA&6&4woCV9kxK`(C#*7y(2*f;&Hfp`m
zeu47|%4787A@W~0mRQS1&aCyIe{Sb<<9QGR=w{2enc2_6vqrtq82yNd<;0e7L>=d=
zUpQR-at`J5IYbHP@T&{{1$Pp0eu<!+K7!V$5w1uyWQdfD4)+7uiVvN`BP|lk-#5}7
zPQ0y)ehm?{_rBp>XW%jHjlyjWWxB(Ct4KZ?BmJ5OGsjw<Sr;EcdsbM!M9^M4@k<2q
z-|)NNkt2S?184okCqG3(HjW1T9SJG;qdWcu50R6Gzmb!MBd$;*>zoeC>5^lusDn0?
zO<(GRbUG+MEhNc`yE-V6(D@ewWgPU;LH*ZP2ZhPJQE@%!pm82o2lcbQ+NNLOMc>Ft
z!$TzBw}{G!OZ;H8HvWc(2+WVa>+m-+^WYtY6ZyRxqc1rLVTR1p8rFpR`5Y&?7ph^h
z1+`F=9uZI+Rauw411+xh2JWtLsWCFMxM<a$*>kv`uM1vS;NOsuhvXww1R<|t^Qh|i
z;VxW@>56Ba#|p1Tyu!6O-oT?FGV|hL|Gq_RM*N;njO29q)!7anbhe4KPKlLqI@{#O
z^YOkJAd<7RT_5cXVqN2X|NoSINs=r%j_kfp5hqCDJe()Cp7-B=C;*ZG%{)5)qFW-h
z?9n-b7?glTFD9qKX}+hA8Gy-&dOSX60LEsSHSD*N8Z%%SQFJUjW^g3RyIi_s2FwTL
zne{P)gWH$^P;jlfix~jL3;n}El9&O;Q$`(*gT!MWEnf_j$4qU!=m~c^W@pau*jy9Q
zF+1qPsonl)tYkqAZLecm{;rviv^lSSrzIni4IlX{e(l)JU$&CK;+2zE>RHR2>YLBh
zoMIn9{|I91;NeEb6#t4|LW`4B5)8U=SQm=$((t{^W^8##f`zJonJ$t!{nrq=nYOyN
zjN%|7k$Ok^Kj{aj7FUUsB1aav*PO`JdURxjv{V;rC4s?jNxE@6-&P`9+)8$bA6@Dz
z?rw<w<;_C3Zx$A>+vsGNB>H%Ios6d_#Bl3m7)Bbx*s1n~!+tB^-Yf`u>16)h!_vvP
zWkfWbPUib@bTZrPWZx|85vDJ177qUH&Bs@~|MSkpKlp#iG=RkJVDlh(aR<wj&6j^K
z9E|80ktHr6Z+0DwqEuNI6kC*p6HqXqVw8+YNnXGzPO?tE21x+*h;t8<GmbI}2_wI^
zQM3W=WOB;#gMS<jDj{jPQsK<BbK(0}4{m!1G^UXKcv=GwvuHhtGx~-iI!W8uGu067
zojKkp(wB|C+t@gy6jL%?%Xr%``rQxOoMUC8vb|2o%iR6E0;LJ+eqIlXHVP>iaU#9a
z!9Nc7^9^}fn0@sPZ?HG!YRBSuG+ubFpe1!Y>?ahNC}mewRt>l>@c8fyqK~*o5bzN^
z=}xJLrXj?K9OozpBq)mR>F+I++aP^<)^L9f5_U*;%Y)-f&wdQ_Bi+5`7wG98p+VPt
za2p#x=j?OgNKqH7_C$XX=+qTH{p-j;w)evs4O#d9WZgYy<Uo7UHugLn^w*u6gZp!1
zTd^nm{GycuwtrS?oY7bbb4LCqkJdXH{$EpzuhMGcxS=Lz-Ar6{5(#r4tr9L>=_T1o
zC5coj6V;ORRG|pmkR9GDN<{JaLqQmq(Y)lKlU8}}HZQFN|NJe*LP>w&UW$E_dLGBq
zfH!Gq@I9)7+Zo{2Bi)^Dz90?pW~yyTR*(gqr6FlKoDc7;1f=1_W0woPq~XRnzFPgd
zLGGap!MOSXff44tZY;^j#PI6|G%Pvmq@kcsX(+f#!`}M;g*)k~xL?n2Qq|*Uzj$f;
z4L4Gl)UTQT!Y}D;a5!AyQIgg>idnLpqZQyv2QYH!JVlX;y+%DRB%OPTc&pL4`gh^;
z0&}*5w9oRkh4><!1y$+XTWR;#xLo`CMWm!FBK-iMKwrN~hsG}bC_SbvStFj5X|E&a
z)2v8FHqstp>GMJ_>8$ueI&U2BQR0^T@{5pjaTKm{b@~T%rXlrW&1fJiTbHcDXXG9J
z%w8VSd7-y-UbsKUwiP4E_!mKe@p7+n4CX$^Jetni(MeSLGon(&yZn`m#gOr}ze?tf
z7d&j@Or;4K9YOeJv`>_DV{|mU2;`m=d%{ulZ_0Sc)Lth%l67?7LGB(ClvlysdxC#d
zKS;IQcPD&JY2@{bg+~wK+6b{~|8nbT=?7#kl&+(ppAU~aob>j2-|S}wy^i5ds=*7&
zDXdoX7qRCNx*4v2K$Eg-?PwZT<%?5yppM+>K<1<_l-s}q;?|$KSWH~{Tv|pk6P669
zh?rMDs#fl)Tyz$PS$fUGVx5piutyk2xlngfH~!E=7rt$cOJX|QNZuO{J^qQ`5?t|b
zdh}no=<fGT?eM+Jovy!61nxr6rK3APK>Io2IBkh_V7g@ywhce_Wa3T^$Uy%<-A%o5
zl*+8#pJV6%HP_s(ehd((>V1xZ581$OgvJJQnv0-b!#cQXK%L#Wf8tJKQv9KLE!?fY
z(cm0z<&DFQbTYQDkz`16!w>bG+zap$hkM<izmoZ1{klQd#Uruw^DcjX|68^}lm{)y
zi7ec|Ng|qG2B8!Vdh75HaFQIcdmN9X5OwUz%MPsxN}5Jc6lJ4<{{9a&Nj6?NW1O~)
zY$szdkBdanYMVZZTxpX~xM`kfFl`&WMAT=T+P1+ttLxNOFiL(iF>wP3ig$%w(7~np
zwC#a>rwiY0taPx#o{chgRI$}DZj{F!cR%dcAVw&9S_W}TXVvwC(^=`)r`K>3=vd4M
zExP7I+gSLXzt4q7JU@ef4Cth-&J12Wo0BzYWzPr1`yL}|8>~GNP1|@|LT6BU=BpL>
zmwR1r4x0Ac?!SfpUi)?7Xq(F!7mr6S8(24*b+)B+TG#$H?gzI$PaARX;yKS~0#|?w
z9t9z2&#S@VU)*E2IDGt>=hgfo%m-v@_5H&YGdt@VZZu3+MEVgo@>2G?n|azO+Tgml
zGOru|c--v=i^siY17b5U7rWwhSH!zyDRWf$6&J2#BpH_9L?{LKB%k1zITF-S+o)*E
z=Ufl?e!EAxje7cFzGf-8(A{!5YvcNn?O1lN^PX)xLW5fQV(@Hbmzi&mbIyd&-FZhb
zy~H-YIoT2A@gR4yoZ!9ZQK}C8W<2R$Beb&2P>yqFXSYZD>9@uAe*JhHXHs?#P*Mrx
zRZdw_fcsbE1vSa@xXula236)%`g7Vx8TmSU=cahOZ#cq+l7U_4BxMfBC%%b{<lgut
z(b-}^V2x+I@a@8^3;e>uk3{zPk>3ZmvK}bh>c!m*Km#nVb?d0q9LRl=QGD3;aG-$S
z)Rqlekx#Lt>*fNdWB0?fEY!Vp^&=zryxK6mPNxks!o(Hs(vP2yh5DUx@N1_a&v01l
zz;1F~hkn+<uBXQ{pH7GK9*0e(sI0Qv`4P&2>Emu=YF}Ir<2-E~G=<l3PNaN4ZLF3P
zXM;gZ&h{hWrTlFBWUgK()V9o|$hi^j9s9n&@12jBPwjZu^sk&N+`7TyjAEbY*QpIs
zDI*u~mD9!%=T>4`_tBK|#xZAphGB0bM4WTtmK}-{Rr7tPAqI#_X1A{J9bfI-`1#eN
z&Db6u-N%pTXi8@EMyoP2Wq0^SfBlI!Uz@XIS~e%m^~0P?(`$2v%?K@O=hfhN?w#~K
zo5S(ixQ8OGw1r||`io<u7{HjTfAiq|%v0F2S4o0rtQgOAS!mUDR6Q>0y5l(&iav`T
zhpJet$8j#VhG#jVvFT1LT}MgxW!(F6qy8RsUxPYXYxgZ9U5DJ;ryqR!!qOnP-)sK3
zB(0t&*by>+Tzpov5X?vnoYM#=7zLq+%->#L$bnKq)Y(p{H7`qeWu(^*UF&#BQhN>@
zzITa{JZ483$>a8)kvvWc<kN<c7%%dLC67JXbfbqQc^qzcrp38{M2~vYqYkFbN+Scj
zh+e9i9MG^&-(W{0uRQagmed$r^d)q`13%73QjWcU;B>BiT)S$c+;&*Hu>Begpozp=
zuI1jhWZeB=2_rgXwf$!4RhFG%M`>i5nGuVc9pUh1+J0My&&nX@bf)=FVr}uZ(HE|E
zR&7<@{w^FfDDbo)sg?%s*bp1NLF*HpuC^?h*j{b-&;Rs$R6AYY_p-FBg@X!x;rwbt
z@Y)Q{d}+b+_5s8^<gF-IWi2fG#41o9KqZAbU#Rl|9NhZ=3?8<92l1FXzbeZhlt*4c
zI3{LG`u4T5MyDDU4SFm+zg6iUUZC})TE1%Nmk;3Bh%K%i=DtoyLlNR?x$yeH@y9Wh
zs~^}&cp2+^jm@UNXhvw!%LlOiFqaQt;}HcAa}#Sn(xJ<0J)uIBpv!Z?G|27eC`kIT
zZLl`vZMWd1EgP{1$^3%5hO|4z<<uSg-Iq|8mVaz@-TP$N@mssb97X7Foij`I(7YeO
z`xwst@jeD)!}o1%T5kegAoZgDi%?@9V#Ak8xby=#Fv8NM0+*9zZ^9UZZBXlZK&}tY
z5ogic$FME_%g3;BI-8~O-el=4ng0rVb!T4vL&+A&k<Dc*fB&bW$?MfCX-QGXm`cd|
zMfSs%+vwBBP`2;zo9|(Urw8N0-Tt(AM0NL(#rrTTGqBl56*{l{z??LGd#n%0=kiIk
zDzA9qPY6Zs6;vC}{Hl%b4>_6MCvp66@JZy@`t@~XzG+x3x6;HXQ8;~@_G8Yl^q>yI
zM0*`0TWly|w0;pIEWD>Idif+4?tBj(-!}i{!#KG2VHljV{;iAz+y4+bnxXIA%RpKm
z)<8h5)_e)b5EYg#lxT7Ey?ah1@bPuqeh`#@>mkewbv}%PdmqNZ#jlu~=u@fbnJ*+c
zIm06NkCde#_ZOM<@<xJ3(*tMw#2fe-s-DXj<<+^lN#E{c)u)_yLp(VDisueolV)+T
z<d`$VIYekrh@P4dKo-eSxsFp^8Xuw)MaF}F9lX5?>C;;Ex}=jF7Ppea;fTq$*hTk5
zRW0>9;o(7${^4fS98QBP3+W7EuLrr2LgbuuJn|}8QH^KY?zCaOlV)cQ>z(}Kbu%8l
zZ@BknIu9VVAFG^AGCKIK2f@E0Ni3tNU8y%1oP~Lv`m(ZLAgGzxA3X2~mS1DACsN1h
zC5IU&UM>W#tYE($T)M2UmYJ;$6nSvd>PM0N0LiBBQ>53JdhyH}Zzl3rUZ|5C2fw|+
z8_#xLjReo{-cOH%VmtXg@Wy#hq%8R#@vCEU&#_ZN;T%I;{wtJyW7al@<^mv1BC4-q
zu3u~#R`qDNH~PV?<gj>yw2JG-q@PKuL!kWRSp5rq<x%3AOX`(RIkMLq7Ql$Sr+DOj
z=?ZV&&$PXtw<cnuZBlx7`c@Ew%WdWMfhz;|A56^Eb~Kt8<D&I4Ubse?;*#%*@g%Rg
zI+s70YbOVbKcYSBdyP`@_eP5(qq*qKmO00<i(OT)h~vCbyFU%?G<l1M6OW=Pij^fk
z3Wik9@C`JRb)lL(@+Os~h4;!_eXf}^bF1n}I<dbUMKhYbl~>qID6Q$gX5L0<eYK1q
zk?3X~Dc$`5M~F#SuGc0qX+~&KtH~SO$vcbV;^PcM>@&(_%KmVi73n&cZ)lSJ_rp<H
z>QQZfMr--|%2{yadyamyg*Z8>GvBbm<9e4eUM$|i#=GK3XJ1)E!|gaauMekgpDTyW
zTeNU|i589>Exe-*coF~)`W<ap_+>kO#a(pb;4V7haqx8VTB%UW!ei}<<9TPF?7Kl6
z!s4${4vRxK*<O0%?YB5vt}{7Yt=!(bwjQ{W5&B3HFf>6^i}H>|ENDD+;phjM_2Tv1
zBSrLs{<G%`b<q!lv-F?I+2%k)WF5}f=KNNcMq4l2oFf+`nWwYOfeL5hj(+6Tk1P5i
zxYsfN!cDZ~=%hAUa^ZMWQWlP)!&7mj8(Ps76sN}NKwJb_-u{ZZTzEYFanTrqi)Q6;
z*8D1|K2uw#%T8m9`d$gqm`FBEU2`@@WOe{*;KGOHwRlvAof_vksE@`N9JkS2zernw
zWdMrxCb0jcAIuY%cgP5vFAcetz@8kO#iV1w2s__%`{cf#|F<}#%<R81Q?*Ja|Bdr+
z#>u`<pb=#VRCDf<Niczpp!rA8^IQwBa)P#ww4^@fM0a9Icv0-oD{f_CUvh%9<-{^Q
zPA+ILRzD(ZG7&|<N!MC4MSpUBr6>=-!jF!ytiA9Ox7z6MW2YU-2j^laN%syUSzI;-
z{Vr?SaNI}m*8Yeq+Hrotzr`p2!r$Y;$;X5BPIocXeWyd_&|i4_YVLHd7sNHi{GATD
zmAhCJHkMmg)bc`IJb2?!_(YTEmMgzqgj1%bR#rbs(fBj6J<cT&C-P^A#HKqxD`TnV
z%rBvFr@X|2$JuY!O|$0}_{^LGi*F8Sk?STSD@OKQWr?-%*Lc0rQNH2d;{Jc&uW@LD
zKjW^0<6atf9h~~t;9}p>xK=a~gg%M8(sftY``@7zRoJ878fVVw%Xwx!bR78^nfHZ7
zuej^RZG81xJl5lFzQtX?<1T(XR^0R(e#Lb+en!O}YCHpSGr<1rI3M%H-tWx$W_WgG
zr?UCQen+zsS6p}Oc%{*0%-2SjIqPP18P^Y^%a~pp?Zk}GqAsp`a39w-cw}p?N>9l6
zC_y5Pc=4%{rO<6sG%guI?_6UnXpp0r5>Me7=@qVSj(F0lwJ389S*s{bZ*FU@AMxIg
z;E-2!f8WZ|#3k{Fymw8*;-Fk9j-34qha6jYQ=JtRKKh87-+~SY$E5Kpex|H>Hdaj9
z$BpBT&cR<Adra5Y?1@cR%Y(iC&Gkclzw|9@gwk)xR?m1wy2*tPl^}4`3tmxwDCCX5
z$Dae9en*{0Nh`0Ch}N9vi>dapD(j1Gv#c?BlCkhSiti02lz9DNkB@cx<0*NT-4f==
z(P>q@vqJ3oLS0<?;65&G@V(284rWe-(ZSsLF*=wz$3_Qp67@y?zA<7F$8o(5c5thM
z0Sy7+6{~}BJ_xdM%cX;H_6SZ1;-l{kEr)iY=7d|^o^XdFMn)?kt;8Bx0zq_D&RHP6
zmJAd~G?fE0zj=%_$&#HwsGaI{4eTE0U6PP?RBoRZ<s~|D1&~Hj7BixSndidsn(wpl
zT*tzZ>GUK1NZM1Z5ums->XR(|!Mxbtw^7#jv+4;#(e^pk%YCx;HJZ`NKH)Dh{EaSO
zSnKQM{*K|(RE)W*8?KgnWfiE}e*DQ?!T0R>&~ZwY2WA`f5cI@?c5?7G``CCY24C`)
z@T@+vh|&%saZwgqSiTj7L?-9UgHqFTSQ;hLn8^Ci7S0VcTZ?)hkiN3+E5kDg2%uc3
z<r!FZlD(-dzIVCRDbI<pI;A~7R;T3CmU8ks<vE$xO`Y}{vzKkI>?`|gc;tkqan7;$
z?|N-_KiJ#HnOSYGEt~9&(4zLHw)my#7~F6`oW}IZ-?;J3zWa_l4Q}Ih-7IdT6C8ty
zcc+zPfi<lBkb9u>GylV^8*>bM4E>U*FY<RYhL%oxGln*PF@`oyx+hzG>@z1lfF%Mg
zI<n+zl)2~Hlre<dc5%g|>CE)7@L1D|F3=r0*7uyiL#0rl+e?`}-~ep=oq5Dhpt@#c
zBIR%79d+U&x{T-2TUSO>l>G=ck+KIZBdJ)n6P<v<z7hL1GVqY>&8y|YTs|zzk}BwT
zl3J9nOr;ea=rKOV*(zV&^_~~t{K)Z|N5=E0cHY&q58FHYRWjPXSy78#jHiva_mlJ$
zuPXho6ZRFq7*&sb`g!5J<z@9<J$jV|f8cHeudGgs<5gha^TwqxWbRvME5G6X3QgIE
zowUjPH#ZIHdKl|_l8bX`+@#g6lOSr(#%JscM|kAmlGTXu+}2K;W30SJWbR5-5gE4i
zB;+^7=SKM?$n(>5eVtLzk~KqaIhH8;JnFIS^N}To8}Q67Q^iNydPh$CB%E=Aq#wkJ
za`W=WO;mi+K(n29-A$>CQvE6!sccr%qV^<MyuIHAZhyV))Bl#)hx1U?-uN**UJte;
zJOqn_e2_H;(-3){{KEGuzT3HRuvy^lV>B?=hEUFxg868JefX$<NyZPUc5_wGXtW8S
zXcCTXJv!%ht0?PIqo6HIPAsrz^a1`xxs6Qg4t>*qo#653!~wQt8bF1WaQ7p?6OjAW
zYt%~x6UdLypld#~jfDqrACm0LhSJ8Ppc33yT-3c)nZ)3DKGP+$9a3AAs_6&j%#tfP
zqEK%@zp+<)(psUNOU_lyH{!ZA1<uzNkX#@2#ESSHI>v)1IP9`EDB3{L9jSflzUHJJ
zA^Dc^6ler~p6dF6k~U<pT)oC~<A`vA8=*zld}tdBck>55w#=FSz}<ee_*qSMpm6m*
zyYiK@jJ3ypMZs+9%(Y)h+|*Y4wO={gt|SF=`xSw3e&XxDj^LoTYri7%99{2^{mPl=
zPzAyD+Mf6`!Z$e}dK|psIZLvFHRJz2a3l+clty$4*{w8nK#8c*0F=Z<R5Zk1#J`l_
z7oqb?c#d!fsK3a3AJ}&#{uSFgK0z&qAJ-E&Jvd>;jnc7|ERPNc$p>#Hxn<lJUC;m*
z15p0)&fg|f_U+mRT<2YOTSVgX1W#PRt8kFpjBJc}I6kBz??KT9O>@p5b-J&)v~CnR
z5OKu@M#<7|fu+~(9nW9Il_$^Xp@MeR(~t?4BxbbVGtPdll6~u$vrBoIPD_L%iV8Sa
zze{AFRlL4N21U*>VrQh}f2yX%aPx=aDeRDRvkgL7Me<6wG8VP#=<!C!V#?Q*X)e4&
zXlj^SR=D83tjyX^Jbx4PX_kO)|C#UiepP(6j?^rr!fRuD!Y<m<p6HfT4&QRk&d8C0
zcK)oyw6lHWt6iBRi|smE$!%BNd~J3}ljt&|XFu)UUHdO{E-0znYxnE^p7FE0P3z_)
zn4Xw(<N9q*nf>~lNHZhm{JQxwr`^o9m1t*W-sIoPHO6u?j?R6*^{0h9J;~w_esfh}
zG5VIpt-f{Pq;zu1tFQQ_pDp~>&o)k*ii!C0t2AvxZjKoP-|B-Yy+Q9g+OlKoXAO_M
z<yInti}TAvKbxWO4Th>UgR3Z8{cNGCpQRc^=Q3X>BnFY*Ri2<I`WacFt*?HBcxs>1
zROu~Ew(MLrmoscu86m18U+ATuE!^n~-}E+*layPP=A1tF4L5oojh~AXf5*N4XK>n5
zxpECLw4Ms<7<e5J3)e_u-c;cEf(=uK&KKbkC5#0hBd~rz`d<vH|G}XKUxC;E7P|C5
zk}>o88mY?1EUV?j)j&W}4qT1g_XE0H52O2Dqo84mrTY<D)aic*ck}m6FZB3XAFnTd
z!<`;EGSb_B$8Y^|<LA8bwLzQSpEtT<K=ON>Hx3D<be%Uid`fQDd9(VZJ#Wx2gX|ys
zHHuBwcAdA1GS+Q8&Kt=r6!^T(o0W*?yuHau$(Ic+wKcx^ZV9?^aI}Wh%nc|m({!c^
zO6my;CqR}S#tBEpuVi5-ImGr5a!N8SgU3#rHQf5S)5Hb+l?>|icW>9%6}tbDg)@$(
z)j9~{`<nZaSFUTEhah-Hej(2IYpn{5u;p^0Rx%m<-f0^La}nvI?;UG#yYnx6Sz%xC
z>jZ79%}OSVb0U2nD_n6|Er7{x=Ol6hsmS$yE_lMQq)Hqys-&Q;&h;+2sA}dFvR0+D
zOa<jOX#bRL#~SOl^P@m*IZJh%$nNic_XCNnTPe-=+FIFXgch}u$>6tTzi~U?_J**y
zy=g9dM$y5(;@6F}aIXm%{G7MJ<>$+F-UgDQl=wJr19YmCuk$vz0Q|W9H_lUY&Kq7$
zK)t@cZg^TfuJcCdtda`Ooj1Ii=xto*&3c{Ad9$d~1P=cH>jB#q(5=~h$DM|_<lZ;j
zteaZswdCe}ME^eUR0=adm=_Sb+AuXV_C+$QG_h|6ypWQmc8K73GA?+IQoEXQB!pC)
zt^x6{COnSleDkA(N<pCS^M|GHzb8XO{jR3{(Ak*i8`u5-FDN;-ap^zs4Bg@*b3mt7
zR*}oDid}GKhRKE;eZNrWG1xegO^3Mbf<B7cwsg0(CiB?oG;~3!jWL$Tpw5(3FQ+D?
z4I~l>-D&;aW3W*57?cvlnm%8{i37g6?k|L}#bZ#X`25hjfr|6L|5LoN{9_zt;6EFm
z>-!m|;K<h8MKXdD*Ms`Yzj+=K=!%U;#NS6{CzAz<Tc@t}!7tr-VhJn#8R_8L^CJCM
ze2~-~ezaUdxqB<gdob)gqVRj^>|3*6qre5~V#v9hTo(iAsI!%|o;hysLu0;!^p9>^
ztUii%mdqM8c1lzahC!VN!{M}$&;`-*%w6sUx*mHi>K}kE*zNw-epFI8#(f@u)0LL*
z^OH$`3V~&@J8$1SA^!Vwo=yAi{G0wbd13m$<%{AIQ4*0xEfmg`U}grYaY5MmMvX_s
z;M-D=70RqB9;?Exr?o-s>K}{6?v!KQIFE|4h3qagUz;5ZJ%k<LZhwQzN5@e1ra2F7
zz2>>j4{+uWU*|0&41`1^*ZFjw8FQZbdnj4g`RCsaxfopZCGO8O_>L(^|JB2@q>&k|
zkz8hGtcS<WqmhdC>mxzMT8+WWTV7AvE8EN4b>*;yCwrRgjfkC+WBPf&Kh^h*q$^nx
zT)Ugq;7~s$!$*L_JEyU<MYf*M@2n?<dQyYd;lU_FNpWsXlq35Ad<V`@>-<>G7q)d=
zPFSC7@DUtNZa-(&mV?yt0XkD#WA8KR%eg;%b@-;P?`vyk$93L`nNwVsbaq_f=pCw>
z)6l}+aYJH3{C&@RM>iad)qc|m?VGQ0f1hHu{a2qh9qlzYYqXs1GWY0b#`{9gJkmL*
zUySYgn(Nt?x>ks-5J(D=HAQ{0+g5<Q37|p!SX;sQb+@hH(91V$a5DHs3KgzErQYbl
zi4&J3<F&7xWAFIZ-+k98U=;HZoaEuUu~DUV@UFdYgo1a^4~@-zZ*GLsegJ*B^)2Ba
zzW4RL_8;GGW?)&b`52E=cv&`L06ro}ayRN?0~-gIW=9f0vDMo-$1tw-3|R1@QFycZ
zp!wIyECjPtY@EZzN(9v#VeLZmwb`*u)}(*_<Mua*ottO=HI{SE4}V`;zt39&Wdw|f
z>wG5ExSCRX(Vl1izKnLCe{LV8v@YMi>yMEyyZ?$WX=FxgB$th#xmekmM<W$|ylqKP
zUZKwXLL+ano)9d{l4&K1o{S~0Q|+E5$$6*L)GpLn0uCqRC1s6n*3on)XR@s{<_Xm@
z+5P?dcWjf^G|&6|Bob;Pu!q%KR8UeYTQ>fDy6>Guwc2;*|1CDVzSsV5`Le!;&rxvF
z%lU1BzbQ%akf_Yd{rMmBO~a>0dm3`1!hzk88tPw<<NYggii_WbJ<(WqkB^9~HXdi6
z1l`)OM=LV=Gas7$38b)M&sV&H<A;sv3xJhC8VOwuoO_$U=9fD-fi-bTGO4>~(1z?s
zS)&sN&*+k#4~G{%T2Z_b1zIvtlyBfTI`=PvWsKsVBwFV3ckuHjoZ$)q700S?jg0u1
zslql?X+LhBHu|d(g^9OJ2G{;YejrKf5NLlC*=NA1hqSpE?|cy5XgW%$3LnIyvX<AJ
zpuQj{2VgXj@{|Ofc%<;-)&QlY8&W{2ucw122^@-?RMH#J3*o$HbY_124c}6mNakx$
zZUe6z^BmXLC|w(xwv2~+U1Cy+^yY4RrxA!S`5y7}hh&SoX5a8VCpUiPggMqM)$N?%
zIeleDjh_=fnCyeKbHWB0awfV_a;2=29&>_Xg^;w@*9o5Na<?4$-A{Y;gB4pulU=XP
z$u=W=Iqwo7Ff)?jyoPi1Uw`5^&XQo@GDz-wsro4;5OB_D1?%EzjmmN$gMdn!h3p7y
z-q00CKBg&t&yJ*IKyjC$!mdZx$<{U&z9qru!Yj&qGvCSlBB$veb@=`z)O?#kPwN>C
zDke|PRA@(z_s#*6=H_XmzkXgf{`oTB>S^qxo8g&(m&q3nD!5u~bXmnF5&{>UqGYem
zZsiGc2@?JT7G*{DmfY99c)rKg*08M=U#-K5nDy2@JwayQ7CFPTM^Ra|F0b6iLFg<)
zxdddmhAe0pwWwv5GwYP+#^5%P%bfnd+%I@$3oQiY9Kx*0-8#^Ez`iXO{S_UF4Bi>9
zubJkWf}njg)=eT(RLMTsz2o^qy@iZoDY!9^TqP{~sDZC*zyGLiO4s}Jt&=8;S6RdN
zgalV8cprE5yC9YN;I*+|7k+Ag%?MKU2&>Z1Uje-hPi@_77X&5oG~KO?MeRCzoW$Z#
zZ`>%6N0{*VRx(7QwhC!2(e5YKv*BznsBq->pZVV2f422=|Jk0L`|m>c{pav43GIv=
zscGlW%2+$wM<UymInvv%qm}h`)y>ythn)M*?k9Wy+5Lx5Y7EMVHv4sduXe=R-KKSO
z5=>9bxpDnAr_6k9PNbO;bAH|YnbU4&+e);vGH>$laDfmfM|PVRjdkHpGqpIEtDJG+
zTf?=u)o?97I6GXe7H6G?)W)uQGF{KYOKym+<t7>~O2KapcO;}L;Iq<EE}6cbG`|&L
zGQJ@it9u@`8m_^ehHG(f@x$U64LUwm<Q0TOmj0nOLlq5|6d8$IKo_GSgeY26D1)Q9
zgA;m+E(=0TPwCQd7kX>B3;+D@yXK2R*uwk*4#lx=&6mkxw3|4uhDP*&v$-vJn&JTy
ze1fgVIGLY$;Yf<7H(`@kY<9Lf6XS4eUg*)FEsi6fgp*EF7r0y>_IhH+v2eZUIO~ZE
z1rPaDgQh7TDl71$Q&(a%JmDo2X58rM(x4Zr8Z=p*qH&t9Ie}%=b6epO)#!2B+G3nR
ztD7@kMY2F4M;o7oBN>_EO>va3q6@yudZPZC%=b4<+~Riqt%m*$cbYp{L;(udcie0A
z20v@WNyJ0E)(HHd#Eb~PMx@ctnZmV3NLn6qz1GNT^mdJq5E<0T>uVGWskN+@p*{+8
zM$ZKI1DC_E%BHEig58qLpRke-BMdqGyvsw?=;8foa>F@EY48MZ>9Q^=X9VTed(T|w
z95vf27nnm&${b@e=VygeLhcoQ?89TH8-Cn&i?e+MT?{LlqjY_ZRJn8AO{jLLZv#><
z>s~Iis09Is$DD#=qw3ejj>8C>RFpTUJ>3SsZAXI_L^@t}?7{tsaClDaL3`jO*ClPy
zb-iiuGOM$H1Y=^ph2jsJcz<6-H{q-|O(i8><8btpcUOo(xuI#arL$~H-r4MDjbP!2
zQm!=`c(>g8wMGLqkz;?X(ZI{<)~_|P{)e+h7QK8J2FGhP^#a8>i+WAQ$YLq71kS2U
zl7yROwejv_0XtXsCt{c}<i!!f`<gBJ^5G7VK#cWXPk+N1-1&kI&M%#22o~p6qYJ$7
z?usbDmh~OhC{-+F2)gyE2RSn6*rJcQ>Cd>?%8=y<7<klK&<FPxw81mf@TnRF4T<%p
z1davgIpzK#4lNoF$<Vd-h+wkU7WPQXb@>A((#`)^+vV~t3c94>@kI)LYj95EJM!%t
zZf=g-_W_D49R9cOW8v!i=(ut%&fWq^7b!kQ+Ar!`$boD2!pBkBt)ura$#q`+j3hjG
zTEr;Q$wXPBN!w{WQ0Mzt`0e}HIJ8pn&B!m-DQFxpXQY3eR-Anwg%t_)eblBN0f=?c
zCwb%}>z>#i5$F35^y&K${PVz#PvqR;-*D%HdiSBcujgLrCDWak%iy<{X5+{l7sA7T
z=x{p|4j*7(u#DL_&+()iqv@~G*{ZT4hyy7)CW2VY(}g_9vQnKi9QBmOAr>M0T-fdx
z>ipve_x^E%C*%^Wx?{Q&wZz_~t0d@-9_&Ep*`+_0j~I4hPKr;mFv5?HeDEpFAgvbO
z=iaL*=<j1i1^+zO?HlgAXb^{4ytdAZ=I~Tv*XYs&w_5Ii8u;w8_bVl~<F-wq)@)94
z1F#J;G>QZ~7ryD(X6Yx2B>8sO>w%DzMxDNR<NWtMm&MCF?L+p0__1;A5AZ@8>EP1;
z#G$~vd3@MaEFS__eb6Y~ni*s=3@y$FYP@;|?_go&WxJP=)&E3B#3&j=q#cw64IGkO
z5y!^SSeDdtWQ|YK)~U`i_g=k)s#lLhr+B=~*N8$Vi7}yOai8kd8?8+32VT%C!vi?8
zhXijLwPRdvK*kr}5l5;_9uHa7$W7N4{^}hhoNm%u*Y_jG<u#;bi*dC-LqB-R`*)jq
zV;SGxQR%;W8Dr!!z;?8S9k$|SJTqgxjCLMjl*Pu{k^LGuCu&)~M><A9Ibuj{yw)@1
z?PZ)K+vZyR#I-FrA$Xd3?Ue0h-00<HG&pSr&OksY*=0pNCxvEo`5s9n&USxmKk(4M
z+~=XNfaEBaJ3pDL4R8#~owsk^O8@;i&!&BM{!M?JyfFQ@J_{LbtIMaanRm?09G}I7
zI<M!(w>>N?l&iOg?Rr{!*slJuhwV-|7OwMp8hhC8Li4rRvBzg&_qX*~*z+Jhi^ZEf
z=SO@NwcY0p0k+U{y3eQco|^N_-=kK-b^f{iuIw2jFBqTE;38jk{}o@-$c)xVE;BRM
z3v1`mNJaCtk)X$~VCAj#D~NQ~mD_#=cO!1U!t4F{yW&$7sYV|+tHHNl0qBf5dcOj*
z5A~#2zXC>?$w>2l1@=IXQPgw3e9hipy=_*^Yb7l^USH#h!fe{ITEm?mG_*B#v7LYa
z@~7kb(iEp5j&gQf=bcz_JaP+X#|gur;@QU3oh3VtcMyMHG*=K((IeIKYCrca`5*Cs
z{e7Ib?T_=-I==?7qeU6plB>7<uXx3oM;N`}x?W#{QI@l}{pHQ}$hYke$wK=nd)wc|
zUbgM;P$$V8uC~8KjKo)cY=4ntL(Y`3{r`$Dk?|uw61M%7$CHtsX7H}{H$nh^tUWX~
z|Gm2rR{JS1Pi+70BR;mi*Z$*sl0Nf%U*)C)6PW$@E~>}Q=o}xYxmgX4R8@KpSIx}C
zw=?beIsAIkO<qa2ENf4!)hB&`%#^Ab2-Z%qu}Bxs-1fZPh30FsW1&+}zcdcE_IE^?
z%evx--{P(3{P6d2)cd?~H8+yG_xS{2kjr>n=b67xA>Zep+fRBv-{Qsl`?j=X>A%M1
zmNYV>HImClxm`T_%%hQt=4&HCd4&pd!;QSfdeVv8mJD59q9<eZa~MBPlJibUC12<j
z-#2&%eN(<hW>mE?Xp7awCX7>fTWf#+{>48Si#O@d4_QuhH|2VtH>9OUA+h^>`tOZJ
zb=r65|BXMfzSsV5`J&%<+Au0d=o)U<jIqWh^{U?P&;Q2PBh`AM`~#`?1r>aHz{UD6
z;T5ZnSNR72c%1pDoq4AoPw<hU{BFP_gNk<%1v%~`lb%3|CM`7$pb><*z_vQH2NLv|
z+kmzo@G1ss>pvjU4xsFNk~WaZj9RiN+JJgXT5`8I`p4G-Hj--vnT#9s8u`Tt&j@JG
zkZV0l|0+Lp<F+~Teat$V*(SF!xiEd!k#{J=9$oXqZ5SLDUC+|LNk0_p)UjjwWL~+t
zA95x#9@%xyXqi*cGa9p&c1|L)!VXk0v|mTg7r9$b6(L4OrSy?m18yU6iXz5Q`lv}8
z$RpXM4b)5La#a^fml)?Z_V`3VYJE*QI-`kGBIT=hu&i3qJ!0k$K2c81{<&~Sm|6Dx
ztvRu{os*5bUqxjfW~8_|!F3P|bCcbiWGOj)jUJVK@<g%I3zc-S*PIjt@5Y*w)iSE-
zRZc)}`+>O9tX=2z^qS6UL8$)6jc}jf_wx=d9B)gp1L+1aGxD#;-HEq&M%H<Z9%!OF
ztP2`4Xrg@jT1|XfS)fLa?K2*b-$hn=j5@dtR303;3tBlhwmaDyWvOu_!Nxy=LrtB&
z6{OnBX%_#Bc;^oG#NEHf3TZBWG^lY(`e^YZx2Qew26sF2ZNA}YbbA6ttqY0*UNU*(
zUiNZM?mE+W;GKzw=qEDy^0OdD$=GedNowSpt+fo5$vBcz+Nf|Y2bJKtB7p^?Jx*x@
zIsRjED7TR~P06^vrtueCcfMuPZvyQ2yB`IQr)#--z30}B(4uQT{7P^YjZ~_x#Na%;
z{SSOhJS*W!6doUlV^zpxLh*1`(I}}fA(w)jhk@tqq|u}$$Lc6u@xURF6p(SV!pA~r
zBLiS^8_b2LURe}v5I#UGzrIGvIOGcTEpre8r@{9F@w9>*9In?xiuqMPLW{2X&^8wC
z=8yg(@&mc=xZAH5KdVV761rUb6`4GlM|$m(bC23xg*u-NHDBBgJhIU3S0g#i*G9^k
zmW@ny{V)>T^xB+kGeU=&{rV~gSVDw}(qhoy3v!S~WV&JrF%fW!wBQCO6o!1}xoZ48
zC?!EtYFW{YEUhww33;I^b`=!00wt8uJY{zyx%U_>H!X^k05g}>#=<Mo&ES2wYnd~m
z$JTs5PzfOvm7Av5px4mE^4DjCQk72HIP<a5Uzw*)O6UD`(>FMb=23#8we|ITB*#`i
zP;q)l|M)Rd(_OjtD!;R7GN%T`ligNzJ`Rp_Z*;w+d&eU-pLYMoKv_mck%MChT97l{
zqAb-ASH+tNUYUtH*mD1&AP}<6@%r}G<d%X+sC?ed4r!Hx3&Wy%|A9u}_Sr`?b+S}*
zxmrp5xJ7pq*&=dVB3~5(7u>&$+?(8XU3qbN@6h70-fZqHP_0O0r3-DSf1%pG!QnE<
zJw9%}!etDlCt%%4|L~?Y<*0WV417jA2Mf!xMnaOCFXQD^%X;_Y5i6rKIUJE;tzzJD
znMGAMAuE}8y#1QJ%&;$j_M-hjk%+<Th2NV}L7LY$PgyZAGHR1H;N8g52JP%rM2|5j
z8!KmzY#cOOE~epHp5Q|F;rmgLwu!`$v~hZky1)@r<3?!qs+kYJR~x4#57*b=!&Tl*
z1@91YQk@J1&-4^DuBxDWl74XTIY5my?e)3aizINr^n<-WE=^$Xr_Y7sK_VB$;a^Ox
zI_cuhhLbtwEN%QFI9<Iwc85>+Xi|0S`w{s^5|Yn*u3R!Yi2R#e5yb5%BOBcQquVeR
zx<Ul6oZOA?J=)AHE$J6y=ar0H1xM~#JYF63SUE8vHo<$UB0Z45vuHQaHoysU=#q2(
zCOdNRbK#v|z!hl)mAH!B9+G;J`&UyaDlhQxTxILFkU2|t4KhaX`{Z7>H{r{@`FrWy
zgDe0N_~q8Q5AG!lCm|<m>Xtl6Hl7-i*jSw#B}-AK&+FVk19kn@xjS{3l&$1-ZlG9O
zuX7*N>)h_^t#iAUx6Xa_W9!_m*ZYjv5n6Q3$92-+H;AP_bn9<89t89fA38Tb37|Rl
zI(LwV*q6>7aKQ>!#p&G0D%3{3bZ!(#nju~~_eL+B+kSm?Zrk$Fxm`bu&TV>av}iLz
zi>~>&bZ$3)Mx*$G`~7P1vzkZewkv;hZof~C&TV(q(YfsoJUX}AuSVxKUmKm<v}|;4
z*AJs}n_iofZAR!&vtM83fau)kPD81KHsI&;65`;OBtZ3!3bOIXx8w1BlOEjOx*f?2
zGeTeXjt1K2_Mq+?9mVKye|cSj%MeQm?F;R*)LU2J(t4b()VEB!6SDGO{ow2w>DCpb
zM9?f=R{&c3s9sk%sFxfE|6Dk8f0izNc9zBM&f2)!Sx`!1ZprT~bgPGw?wv)0K)H4A
z(?e0zz|__og`RZZfgLLQM20-qGU5fTU0ztAco7{gPan!^XU@~(M%YmVVa)5KZS<Pg
zjbHQHQLK8ZpU<q1$IohR+^sxHdgYOt-zS|*52y`bb`?Z<jh7aSLOL-8wgEgkloRUk
z0T<z1yL+{aC%U<dCU^P)L5_DQ_kJB*#809ZXN3D?zsrI3n(X$kPL6Xv<0*oxlmIvI
z|G-`RW#M=HW#b8tdXnlLsEIPg<36SQ4K#_C8VODI&qLqd7EjJqaK!XVQth`SDBm1C
zAhk6<<1d0f<1d1%w=*C$q;Cav+*0Zqf1%5ne-Xv5$nfvdzZ{dU5*HktUE?nya~V(E
z>LvER;x7o1Ug#Bn*|?3re2dF~Z3-f%;7F*OSG)#A%cjO<lJF`79|*t+9)+JFI3foN
zul)Lq@tMoic_AyMMvd=~ejEI3`S{MB^T_G&*i&M@hODR&+$a9Ufbg!!8?cmgjmf+i
zCl0|ma5=t1`UOh8MWl+MoucUM93OM2i|-g5X)nPk5D7OB;pA1Dq<u%}9m3~Bz4IY)
z{8;fW5kufe1@~DvGMXt~m^sDk230RfJP4wpKH@=FoM^58SKN8&zr>X+P7;mzFn7Gk
z;C78R?$(G?_;1^4tx+CK(GK?-;gK&==K0ltB{mSzzEKlzGC0cdAsL*uoOzAddLC=#
zB0u<M8AQet*Mrwyqnst<4Gz*D9bqiRO0su(DDfu$ztG9=EGhXm%Xl4UaQ@8{pk6Qv
zm+Tajj7B~^{Nf4Oj&!CH>Y@owUynPg7Ln^L-RKpWGkBae>-kCiB%Rj)gw(P6!M=*g
zM8sIrnkljs)~>3^nW*=5hH`47j8~*m&^zL}aFt90ML_??&5kv=+xZSh)~$Rb-;lT!
z*Y)6>pt2GyzW5}<N|+0OL~Qr>sl@et&12dA_^~K*fi!{?{AxsIyv7^7BFY92od3|R
zQDom(Nq&vMs9`$nwMHZn5gv(tjZSpjN#KR552A9?*!yeJE3?MZbF1QmK#HPJ`jWso
z^~;L77yttgs*|?Tm|ArtpTs>;?7H`HuV=zzt`y<}zizmVyZElb6N+ZfDi$|sOI7b+
zkYA?U*dSm{S%=O~g?R6xwtSwt5}`s(6D|gHE<amVbFg!3HI0R<KMm!FJ%0f@OrvRx
z`ipc;bn%jeD7OSML~+s^^|a*CXVTGxaYaa3qnL^96pLDo!r<SSGJoJA-#%aD;b%qW
z>A0r1$o#_Z$o$5Ut|7}BC8T8>Q_vN$KtA(YdzG;^E-b+-2MeUHh&|~stUtr(Xko|e
zyGHk2WM0r`WM1$UnXjV^-wLwIGYxV5B8p(MZ@A;(i1tsaDTr2DQ3Xv$1O4HS*Y}EN
z<{ovC`GY%2`7L5^aeL?6Nd7nciu^y;^Yg;N5Sjk(qen;99}nGMxEsO3-Hx$1(kG}5
zg*xv@w#suqMp&_;N*4K0xzKt`%ePO`dddGrX0}E~Xghb^1DT&<-8)0j%X--OM|LAw
z&G4PuRyyQ-8*}|4vbHcf%4GS<{X^P}UzuCfkI<byq~LvEQgjK6#gcozQD;3I{9aLm
zo4fdBJ>NJUol`JAIUa&v_T3-2<Af;w;Dl@(6hpkglV4>6o}<`w^4e7Ek#6)LDCB!t
zQj_$?95p_U+5zgHhLs^`DKR}cA%d!ZnzW(PuCE~|8~ahY<+S|MWPjHA=tse0#$0@_
z&#AT}w5a2R9NcjfzHvo7UQ3H_9FlLi;g;~jrTiD}IVT3^=j9wZL-A&s#UN-<uN-b}
zuG+y|kCLT&jMzA-@hT%tNJ-28jjK`FB{eD6!*NaoUH<Pja=*UDQ-oOaY8h`b*hig|
zJA{4|$)U_R-p7yCYZS5~6xj~SsB46c?Rbki&dI^u{C(r1c>Ju7=cs(c4R-~@6DG+w
z+;dtCes&{T=c*8H=c3+qOZjo$CW{VuVC;E=b{X)N)}0{FY1!w^*q`QWV}F|SX6#Sb
z4`Y9tUK@+jjL@Nu({k)jE3Ynm%ePlKxh3e*{Vhw*F>lODT#OvJ?Yyl36uFeVt$>k|
z9?@=Ff$OwqRMNJ#!o@i<D<P=b3Mr)}C->J-OTpCFmLW1EeoF#4UH!mLY4qFO_4;B;
z=?EQaC7;1>cGkuRGDFPgiLkgmSr=ZpKHwktbwU^JB%j4euuZ%pWi->KQ5lj8@{_Y1
zA_W%uJS5IQ-DZ&%i7N-HBqEiDBlv?IAob?p8OgU$Zi5Yk7X8<qi4$$EmO&2}+YHZ^
zwI8IgY!7A^j|%s?2G&nKb8w(8(uG>dXYiY?xN$q*_6D-Jy~!?oF)hF1*NwQDnO5?7
z#^&0M$WfD;oS?IF8w!!JH_-2Mc%)}s`(Mu+$F@_A*Lm}r#yM{dY-09yyRY&11K~t>
z-e3>n3BuiviVWAWG~a8_q+KJls6B7SPW-~&{R@w6jyH+;4L6eYMNYo42n!zCEEXZ$
z?9JlBM@eII!CH#S-V1m;D(s6&=c6tLU_rVG!SULN?<^R0vKNt?zaU|}M=uuP!ZCU9
zF8*lCxhq4AjFMip9|_628O3Q0i$zGAkhPnNa1Q(YWQ29`PST9&$s!a~S%hRPjQeW@
z6Gbi&8p~K{?xGtb>pyQiWf69iDiItMoBHFl1F#6mf+!d2ScC`nEJBAP{k8H1I|5^Z
zB5BQ&MJTAY{a_br+oXEHv%}wqu^50P_i_%(x`{b0mJ{J%MJ&8(T!is5+QLVdxJbhT
z8|1R$T}Ado)kra14#Dq0&r%fh$x;+tS&F@fFs@b-H2$VLlNNAPIr+39WX~g4JyZfc
zwQXj;XHb!(#H=TOSy7x2u5i@Gq8CeX;WtZh<0$HmPKm7HfUj`%S{=)}DvkRge7_hs
z&!<i1ih?CJqR26%bE#}GWn|`Q`N>igbg>lMO!fL2&lmBcP`G3AE(hxvkTU8=xMKlZ
zU`1gw9#=EokilHOCQ%ucrHB*|<3cZ%;>IUVLyj8vMH(zY;o|M9A9zH`b63F0S&>{a
z_@kbMP<zs7C5l~Te-=DT@tg&CqGA~B@pb5RD7THShN8Zup75Me&SaZo+m#tt{SWgI
zk;csXr<kSKORE>^Sc(VtEJcI!1N^vJsf~F|MoM{>;*n{dr6~B5rT7hZtj3N^SU<{`
zoJ(7j5<qJ|&|HLtzq1|bdz!|e-<P!FtT?!pB|%1sj2u;dladsJ-?5$rdG<HsVvB5C
zWg8u%**3m3U|b-*>dsHteWK5IesU!z4NrT;QV6h{WQWHAX`;4LZh@^ceh18KE^8Gb
zRu@^CIMlHw5AIo$2FEJ`c(}xpDS`D42(66gfnxXJHMz*O*z&PLXbVl1-zc@HyswNx
zt=G-}q9^=5G>8NT#Z(QVgD}mrvT>eQ68pIdn#jP?cWPwNR+X^5ZA&rYKbYqWRVbl^
zwX@=IpErK5;!tyATHM~44i7MEhQ=7jjC`&TcZHB$?3%$l9FlibWj0QxrcT|lg|pD`
z7|DW|%J?2M@}ye9K>b5ye5X<GTX*wzKM!0O;vdn>kZq+}TwY4h-Bnd4_rfd>ytWvj
zSLt`?p`Q009U?~YT<bc4q%N#+(xxtP@qg4?&%2E?KI_RxNe%Zt<0&Z|ZX}Mwjf66I
zLAtu=aA#F;ttEM#Vo`hZ8r<Ey7ROcydHK6TT=xOpG()uxNsc1gRc~=i&|byH<C_L$
zg?YBplsgP8dD<oSO|wwFdFhsBo6>#_DnQSQ))8|Sl=O@(J4P6rLls*LsxQ=$F1{XX
z5lQ**2EA_HjdNmcVLDAt+@>hrtf$qFC>lrOw4H6;yf{dUuTC2!{^$t%n1084O+?V;
z(N+7)ex3Qjk=_{v+yl{wu+z17AjOa6olZ;y;E|Jto_+LARx8$gq4wrAxVw2R4%<!{
zVFBJe=K1oYmM%IN;^CP!6iD8j+FTl2&7!e!oxGma0v@BVzF;J#)od4f-QF8tk+mFp
zzgiiZvPx_;8v16)O<oxg!bWRblY4(pG&wPT)bD5Nb;+ufW>GDcjOvmXjyxd4?(Ivq
z-MAR%?kpH@6yAnJGAbYFzA-IsZ%l_HRvf4DnUPzf3)<(b+iogB-;Cj_v}84MdZ_%O
zi-&zT6NPA7a?<X$BnABy`Av#+xWCS%PDHj->fpSvUC@#;-=X{xDz1Jc6m8FH700N(
zHgD@DmroBKy)A3=#*g-9(bs$=^k!H)qOabSIJf0C@bpG4YpHm;G>9~Rbc8hxzXRX&
zgy*{pP6IZc?=BX8*-T&Y>z#(;k9Qgyhq8ijgpGrNL0(E8J`M&JI;~o~<6z8Lueta*
zSjTmpLE}sAoyJ0a9L#;a<6zQqDn1T&^<&4uY_E@%U`J?C_fF&36z<)?xAz+!51QxZ
ze%J90H}5@8T<aU|-+>r>Acc3m;$TRI!o@jU91IC6QEcyyg9T0p(62Zc%2G#tf8pMN
z2ztfA?AIp_#x2vq@o_NpgF5$!gK@80yW(Ix!j`W%n12Uya5sP7-iLVntdD;;@(nld
zNsiCy3x2&bG5FbyCk|$J?umo>eSYF#_Pm`qm_0%EoryVbCJtu4HgPa>-b@_K^~1!$
zOs|bqW=7~x_s-<la8_P9+{m|AIeEvy+{-oh8pf=I!(r~#=Hp-(6F3+?4hEF$p>fB-
zFf)kx`8e414#>Rt5!A=Q+}Aq}CM~Dw<6y2ICJttL?OreK5jxaLKBF7lFQyD$XMRS8
z9qvz-!&m(358R#5g*(Y-agfZBOw7f>0%8!oUU4v_>?Q5_5eGv$#*oGp2eYr&oa7Vq
zii4T2O&p9{F8PXsN$TMEh=ZZmTq)eY=EDfb9UXI$&*1k9LW7_A_BYVM{Y~cZWh4H9
zyBl%8mb8-3;%7IWIGEkJCl2QK`H6#>^Jd~;?lq@-5qi$siG#VXcO1-~w-X2R{Wx(j
z+iUx}^^DM>_PiMz>dTATzi_g%!c!uC$Bkrtk&|yP`^X%hZ!h}<zjVhxaQ6~$;qJws
z#~Tye{D?j7Uk)04`|l5K{rCK<b9(^Pe~*`gw5!wYzsJi#<e~Had!Vz<JTCNlIk<5W
z<2h9CzsDQFEF5^_zXu9(`R%{wSAV4!@4p91*4pJ&Iq0uD(FgxLaPy+@=)_-f`_k~+
z3q*^<In>7UWun2YF0yf_i*U%HuUCaj7a<gmx^{FChy#9^NLuZ!bu>;e*q*3)nP_lS
z?^3?}(Q<kKANlS_2b(_}7X9iqUKK`U4s|00p*Twn$-hh#^jf!#e;&Abv3S<!EACz_
zetY3)a1@}8i!EzjK05rIw~f2=hKxT!Y-)4f2!%g8+~*C(%goHKHzx>>*jvfvfx4HE
z3#UsNi3htsZ-XCMaa7Tqw}FQja2H?aZE%vd-28dl67F42{=P_1`a`ow9{=XSt$!0}
zBw0P3e-r&CDYo)`Z2u<kh*X%)lgY0>lQ4Shd(vyB3?4~r1?S(y8niH1{uA|Y0u7uI
z%lkL6lC>AsS&o0xy?1qQX7grX`W-0vr6c@-yB)jn>kY5L<$dt;1RdO;#En}`-o7(F
zT0fykEE2qp0Qz=n=SAVND3IAS@QvbLQj;Q3a%dNNy_q(6<b0>=byw*k^T0Xjz8`Rd
zwtnJBtJjT7ftBoSmGl1ldP6SgeWNV=n(sewcSCIaded(39724%u?+5RK7*h0wsCjf
zkOHZT@7tU=X4k}U#}j~up0bY|a8`iW`;A_jfWbo#-NzH4P0&vdA5VZrGRJ<KbIx0>
z%pLIY1eXuNXhsYDy)>zXKQ%0;ku9C|8~!cF!ymZFz0Vgp`T1{|dK1bwh0bq+3rHzs
zOhLv1N9ihu6B^*?Uti+^H=RDx?opz;F**=%kT@i8(ji6^9BEvmd`&CBFZT-al;99~
z6tR)P+1(wUa4NgJa87t|CD!GIOCEoRGfL+mO+iOT@dHAk@{IMSjdm^9lVF^*7ik+&
zE<Cj$6oJ<&??T`UM-nuLX6Q4GYqdBWY>$aQKNpT$sv;T;w3Y@dl5?<Tbd}K%<W*cD
zQ>`N`#cktBa^TV6^=m|EhERA4qRb#y2Om?=z_kty%59)xBFAIg*O8yg$E#(iWRm6B
z_akt9k$CkQ9?z8GH9~`~`Or2NzUS}bam;q<+zP5o#LPR2Rt&Wps-W;>ePvu5&+~tw
zP$&+CQZ&V(KxvT%rxcf>#jP#wF2S8rB)Gd2hvJq%DH1%m6eqYPxWg}>?}Pu7|ATwo
z?%m$(yl3aNH@7!Cv&x}Qwuo;<qs8_~zRmMv&uY!u`E%|YI<nPNs)78t(;onei_jK7
zi({yXqc74S?==O1Ct0AZa3w+*==>c>U~QUPhwCwjd!h}>mCs|=Y8NS4l$A9up{=gT
z_XE>cr>HA(j^5t&MPfA{Ja>ZjX_m3tr;$=mWtl|XUh{dGLYovh3oSwMVM$&td`!Xo
zX=vAkGPP;7f8wTW3+=3>1EM}GvF9^@p7006taCm@Zn%wy_Lk?hF_o!j)hhF<OnC=u
zXnol&UrJGqqRDncaqV*WVU4pw@ynW&7}5Is`V;sCF$H}~PpB=+Y3@En_9(8An%c;<
zd1ZEIQfs|+%lxx{@g9R!(NZJV=&v0dA_)!p0rG!V543p!ZiL`l+9&YFX8}YSTfbM&
zwpY*TO*t8{e>8X1CBJMmE9H8;S*kw<O9;_;vax+kraBfDLPzVWNv}zKp}T;b9q4Kr
zx@()tXJ&1&>vea*wAp%1`NNTls_M;YubqU|WO6=;$F7ESBB*RjF0J*Y$wh)$q3<U(
zfx;7oIYI4L24Z!g^d!1spIg^PFYi1sxVX}1mmb29%e0FZSt~OA`^<bQAU5rm(eUi#
z_qq%F(<5ACSvNbB`nqE?wjDU1tn4eN=eaEj^3E#&&oBCRW_^jt%YSv=fC1lna3;dj
z!C?=3{+m?}PU7nCVp-&vu)f<f)FjH51ASIVzreFhd$T$*^u490jltCdrzKvmi)JLV
zFSwb!QluV_@1I~7Rr{T|jLyBV8Qlu36aN!<DvX|lVikfhXZ=ouw^qp;G&13PY5b~1
zAq{Kp%6Vqm!|3eD+~BPD#(lAv?U>k$kXX=~0Zg=I`hCz=IIo~K3`<c*t<_zb%<~lr
zCA`IsVo%Beu!jy*nFdF^kJDM3c%SYp=?$KJpU#k^cr46%IzuzT3ZhG#PiGg{b5qW9
z(+!?|PrT=@e0e_e-e|}G2DzzqSDxLkqH80ib{mP9eGk9$qxTwyg6LjwhL}|u!#3Qd
zw`P=J8(KAWv2w5mk&PW{oO9t{3zjceZqNHJk3I<h5_&ERbKCCQN!v=IqMOW;=Pdj1
zzaHX)nl_o<`$@$5HbTYg=3>Y4w(j&7;kjL;$?_xnX-~tR%0(K(uq;(iGQH>$PcbL&
zywRLy3V7C-(ogND;am#;vhLkUld2<-sWB}GAY}RSmTuAyisrX2-Vz;7<zfDTj&8Ea
z#Z8%y3C+Q&CAzS1(ILc%P;(XMa)1YQgOenLe?duOV|S6@LeqZ>TRUk-7T&EekJt{S
zr`cQ$Gu)JF)xE2t&8;c}L%c$xrNA#GQA~J>E<#x}<?f^6>Mb5|i;?UFY9Zbl-fKDq
zMD96BAtK-bAaN9|*W2IQm|$6G^(Cb7vz254N9~BZ9Pi)*tr71nv*2DE1o<>p&P%KE
zL9pD5oO(`PL5$}$7C+b<KGX%>?p<{{e>P*W^U$4XAj3A;fu~sRu1$=;+&S#}&s%Rf
ziE%&BpjP21A@~y}lb9G!@Lts`5dLk=Zea1e=TKHE4RER-WaG~}G5fD$T*JY-(wMSC
zD#kNZ?iFm4&pC%OL<AmnUYl1}rE3(lzl<%jTip|t-t$Xs^)5<Ru8nlPjlv+ZtVRo#
zNFm!rap)i61&_*8g%2%Tu88sGp>qdQ9*GG&TPeY*O2o@56tVvJLL%>Co9yxlhk~hI
zHn&R*^RK{U!Ntf<QGwuUgCz1QFTd=MSlf2ua^kB;1?Qa2zN?wl`7K#Ufm9Xv8g;%T
zkLt)@N7a!&As${izvuSpplK9c!>~KS)e#`X-00JH+L3wk^eEcB!5lsoCCm|HhxgUW
zB87b=C9-4a!)d98yWDNA>PO1_uLs8SA~T^x!A13(h|<8pXiDNyxzRU9E@cZy2_+E+
zCgZA*Cg9N0i|u(K#BokGAN|x0xp=ib_U4hM%J|4@hnmpKjalDQx-=VrgFBfbyhK0T
zKp{dHKH3GfgspDRbQ#ey=T@}l^KJ*4<P5v!s(0G1dQNXGevNhuAPR6WMozB`RhvDM
z;8z9oYB-d7e|Ju=Ajv3jYnGli@TO(l#ev+|!(ZQ<R0mJa@)<pF#$jC(#z-B;*gARE
z>q8j4k`rv$8!H7e`%%oUpLpNw#?qMu_s1635{rJ;Sz+XM(p&%$jOIrgX)vzfdz5gW
zUA7HSRs&g94-6z*&&3nBl$k0@`}U>Ru6;<$JhIt)FuD=aRY)qi$XJc)nS6$bLrEjC
z+JryRFa;t$`k5Jp1^H@<euQ+YhX)_7f=rYVOkl;XGwy_JaZlHAQBNVFO*i<sq&>5L
z)kmi`JK>j^_>u_8eSfj|1t)48Z#Dz5Gy;lc?5yjz2dQl`8v^6=Z1$t4G}=3=^K?E3
zI0Pn$Lq%JE0SF_97nW>aJicS%FKv$`@`o7`sIc~XP2zs=w|@C-JGI5vz#&V$O6pHK
z7sftOr4zE2HIXc*6P+}CTr|B%mn|NPl`(~6G3Ndg^q0-LrHZDzvq0PH5O1J2y9lSf
z+@XUIkV83Uq&J6|hYpn^Il+<eIn{4O&`+qLlD*Nu;j??bcesyzR`0k!p(o=lTk$3%
z=?o@3&PskqPRo(idO}FiLGH*MJ?}BvqBFf(t;=^v8AYR3#bv#mdT?Ll*!;Mx*yR@0
zeXkQ$NN_`E1bZ`WH!m(phcVLgnVX<dA2m~UMYqlkkj#C*R}WXdyCq)KGZZm)a5Rj{
zHNcS?)i9b^Rx`Xe?>!jy3#a{IsMOPsv&iT)2jBnY+p4qjox`m0yjl0>DxhY;VR5$!
zMIJ%Tv-DD>k#=3Gxwor|!=#Nn_Bw5M!XBwR*tbSY=L|~UGqig0Xmu_%BkrWv(&~4c
ze86=iutK1K#6SBoJ~&`~r28`ujwYFl<NuutqvK+6=CX04^*awkcy%r1KN9EzRpRkV
zA~f^pg4CP=r1coRW++%@f6v`yih@4iH1ET!B1qZ|0;)yQZ7OGPp0c5ros+lbh<3^E
zKh?~Q_T{5Cb(e0Keo7@+$;7zb2PL$&*;PUxXj99Ezw+)AH;h^3*3wC$k1mOQL#+$8
zWx*=C`k^4H(a2|!?jOrZVzC+QWyM;|u)acud^nFsvHk1&uHsT3$E01W54JybNz1>t
zBz^56?U`eB^~}ANDI{cM1VmYEK0p$LDG}oOy50YeqFP7og-BCas$Cxw@+(z@t=&k}
z6jmr!{_$n&F>MQPSh7@&%YHpGb^q865957$Dxu`f7mkX@{%{w$HSM$g`VM0B24Wvw
zrjIg6E<p_~Vq{@YRK)nP%Ur&Wn*(AjT|LHF|CxfpOsq#YyF>>-cU;sxyi<l)#*ud4
z2W#1_FYcql<++{IvZQZ}ink$SZnK$_ApfNPAQ+rf06ci?p6`w^NEsE8#{3;QcPc#X
z_Nydk?@Q|moT64nw$&>?)$Cn7V#;(^<?@-L;`>tt@DZUxQhNK5yW^;426g==_-KUm
zV9@YDNdxcZHm)+bq9;Z}ay_!S$pERR`b^=5{B(choj08$Fywl9k)Ykrg2;{8^z>dR
zI{5Y(UrYOQx{leE_b)DPo{p3`S5?(Npp)p?8}EZ}Gmn(3Esv<knBUL-bU2$J_@Lsc
z?zmY8#m&~c_l8~Ig)B7^FW}2c$L`iaU+cZGtZw0Fk<1-;?aEECt^Z=YIb+ZOjf?bw
zF%UT*NN6WZ8LkDf3K)~$wu=x2%?)NjuLQBwT0WnIwOQSE8GX4oAYVq1ee;vuChS0v
zd|>ohC;4dIGXP^C*)MjDLkeO!@do__OT9ME;_Y;WsJ+ORXaSGXWHDQPkLl`RXj$I)
zF#=-{1k)W(i4b+gpD#v%rJl$*bXmF?s{taMOpt=14Z~WU%Cy0^l9)%aQt~yuI@XLk
zqJPP&TiT*V7rfeIMt!nkHBX#zjnlCRVSNl<bn}fn2$H(J{A<C`sQLCCNFIFW4*g~;
zyb!5IQCyDuh9D<R*GaaD(gj0BQdx-@N(5N}5%1U@es1CKAxMt)3o8KEU)|kTz=ahH
z#(={GwB4e^AF$@hAAm3{GDX8*AIdXFpT18O9iE|u^1}mgqIloK5SYN2lRNH<mZfi(
zAMM|U@9QL4_hn662$CNu-6#lxgl!NB{k83b##M#JwI3Pvkb8W!^GF4cl$z64q5V6Y
z7b(?p{lOWxUU=raAm^?c<vm(j4>Wg+!fZs}97|tBpf2YlrP5r{>>vF%v!KQ6ihH$I
z1eT&*>|+RA7t2CRF9sToX6iW3f!vQaIGs3hWm#})x#gKBu%egq`JkRJEvBuu;(<6(
z5S{#Az9nbeQF*=AJ!qs9>TUl0I)Vh}{(c3@hkfacyD%6j<&@GmEMB}X9VF!oV|bS_
z7MK43D%e0n_+6DN7<w3)isd7kx-o}%?~FV76U`bGzcVgyg_Y==HcbD$B@5l&l|{Jg
zrUN6acf!crKEM8H6}Q=CMPrzkr)v(CEq-?5szX88jbP}lH;iGp^}X|t3V;aFn)jig
zi%;k?ci?!Jqw#W|P`8ek4c0Ty+nzNMB4;O>h(9$NfDkm)FdRgz)W=f>&fhmbx>s9l
zvs9<7%EL`}`L#miAZDM%iMrC;oo?F%v9=Fw%9fpR2awt5#|RWYjpt;P=ZO=ob)YX=
zw~_-Q;{2zaVGKpHVrXRtzjI0Uj1Z>Z?Ggh|t&!^88qx;q{A$`jkU(P1YY$Y>H8I#K
zg2W?27t}g-%i4T9>{Qgbp4!_eG=0%`Zn*EhpCuUDp6@}s-Uj!e{o9Z8BEku{IRw4A
z&0Q9-@PCX9P`+^P{UCcYAMjkRvt_ts>dQg$%FL%@nR5jTBeNuSY4@+P`P#PAQW<Xl
z0HH32kbJ9ybXRHK99esPXgxz9lSyI{{?9(czcIXeu16m}#OeT?@7EpDmH$2$8$^4q
ze@FcD=$LhD{W6t&!BoU4p6`;COU(R%$1w9NJXaQGn^5_js>Z$xzvd;p^ta5ff8Srd
zmN+CK7a&Y(k84G*As>-`%lfS=NQm5`suChMCu?B5uV+_$#&($7OEddq>Vpf1l)5ln
z%LhlbrEek5^3y`zLs&yP7(!{rrEJ5kf#K{j<fW}L`1|D5)7irfkfMC)yM!Lrc)QOR
ziCy@eYnxoe)pTv0a@<)mJ@+<}TyLfXLjH9Jv&(HQeeKhXd)XW=#%6nlT^6Js@o$8@
z;3q{Rp6Jh4W;4gSSw%1BFLq&7uZ|MQiel<Jz8*`LCGL4hVfTuo9Nvjo=JsE@;#CRb
zkn^*vuV<Rw$W;F8q=#q0nFgYn=EVl)tW>AAl|%p!*!8eojY47tfo`5ZPV7t~S?V?#
zqUen|w|%#0kAuT6{A<nTCj7q?&5oa6ykcsW{HJJTH2%?6{cVzeQOVm=FVuUM@$hI|
z9Dy?U1)aqIf_g>Q(Fw?{NbOuFr2Yf5xo(})-|z6zn>cM*iD*)#T0D1n@YlL<X?=Ss
z;6UN=*p_k((Rt%{<<A_~EZ4d<E&mzqb@LA-CfJ#VS6FJtcY2QvKrbe}wQO~H%}|6h
z3WwSJ7A!og$ijb7t2W^@4jY8S$_r|f7`K1R`uF{MANDd%Ic%K1=mXtyD}`BMi~5AU
zw}HJK#Hk#0f-vao`^bU6LOe5>uqf9w`~03A0RxlNxP&)++cM36cq`P>sbt3~=RId4
zTGw}plxG#mVCp^SN5>u;=oj^L;PUrKjt{fIq1M~EsE7~KwxQLtVi}GS)korQ1jIzn
zPf|ROdn5Pe`b)fEN?Yy}m!6oWiWo|ih@ODHm9CEorhiSF;K!i<R5mVT?-ld&h?xv#
ztu!pI!i<#&PPG);%Yjb`aIJd&%|&!p<!B|IpJtE<e0S=&E>a(wTJ%rD^m*0N@-fte
z_ANs?iTq?f4Z9upPdn{cXx@!mZx|<&bohsH_x=z4pNlBYLFLAw)F?lt3Io1>r?Y|!
z*a0i`M;6Apy==^h;zcn!kqUgbYIS>y)G1y047ec<2nd+0+`M90Kn)Qz{(gU*EfHfd
zUVXXn$LZS{E9q}mvb#SBr+@Fgsx{gv{$@|hfX_^l#22*jJ~-i?tURx%l+}Ed;R*H3
zkzAT_dK{GL_iIy*R_5{I?@C;N_-}8b%LuB5vsPCgIYtHC$hT>We{Sbc=A<bMX6SI0
zmC0(me&ak;{T%bb=?4FjdJ#BsboW+NPW{!>>RjylWufm!eZ4Jaf}W>;u9V%af0W6G
zCZk4=1hUuA+s7N@rzZ8mITS2R!3g~}Z>_6<eqEyF9|qQ2+4)<|ay*322)8@b!JZ{j
z&~KC6(n!PSQ1z2s9D%X}P-heq=9xc#9p}^-Q4)^cLLjblckvyuP3tYRdnRTdS^bk4
z?RVk4VPlG8>2^Us+g|l=HnOm0eZ8L*wB3gwuC3GyQpw?gQYDkhyS9$mS^#4k&ILy%
zPPq1=vN1N?->h8UD0-+MZ7l{oaBXO&)DhJ9_nxHupIbhgEwVgE*7M@?Rlc~iDMVc|
zrJVaIx)ky=IPHw)Y8k7(Q@Qa~rzM9T2WP%;a|$4%qZd@4Ja6}+7hmh|yctMUK(Ba0
zn+TgbQ$edp%O$p?m*30@ZD@_gspu6rmlO4krdap2uCMy>-rivvLEi}creOru-_Sjo
zr;a<EDNJQv_WE|AedjDf)F82eDRHaGsjAcT%Kh`K1FL9Kt;*uR>&S|f$f|t@R>{Y+
z=LA+E`+c7}syiGMMH7_0@hJza-gwO_ZvJt7@1^e_rKY%&@f;H>gAz0=daf7P>OnOY
zTvdHD*q=4a&U7afJ8F_H+I1tfMv_v`s%FHjE$)ooXv0T?EVTem4dy9@3ssl8Xjpez
zO9;<atYs{-%Rzkk+#Hx!NL^I&>oTI_-oBZx>u<^}Pw(lXD4b)XVD_B!1f&cDU1hFr
z)%WxOp!O%%FHME0hwObMoZ};M%@YxA{`CWtM|LNUO~Pc23M?H8;pTWO14JJSSy28(
z>2m4Ns}g%KQr$rsmDEKbd>AFYF7lCOqMc{e&(No*XlyVOH#Gb!-aV&S!KNzclE2L3
zhii)2k`Rs2!t(Qjp*kPo{Tp))BQr`S3G*L5Sai*$tI6|zs*58#f06N2v?)KXmuw9k
zjpMUy7mZ2D*6Q`q!EQJ1x$IIxmBOI_3XF2VH|}ITu$&aq&Iux-!NRLZZK}ObCvY+t
zW^7E_3%x{SHuoUXRYo%@H)$LooXiQIeg>?j&i1Zaet9Q)W7i9R;#JKQ=CsAhQ-ja=
zVu(>W*%HXaX1;yusQuT+2usUavU4O^e`NM|m<z&FrOm-cHQ()X$1R2c^v8^&w>_5t
zdWsdU8R~<2_97abL)J%?T%C}`*Wn__k!2ner)}u<)?uw6UP$QG8Kw{|={+NTa#($C
z*bz)iDT8b6ANGg<);Z?5pDq|DVn`O3t)nrYKI_w7{Y|)2b2L5_@{tCIgC<_cUhibG
z5bMe8QnEj}d2;YOg5s!!uin0TIdos*)p^vErN-4Pe7u9O{Lsgxe!6`aH&!G`hKZTa
zrvl6B06V`k(tE4e;_q?}<3soj2N?_a4afCE*Oa}J-&C+}<TzhBw!#WYR|0bokOR7b
zCM%Y`sJnY83!kroA*b&GPeF-;A-}lBBRLC8M;TPNb>~GP|AI69Z85$9g+RYNXS=V_
z*U3LAZR4(gt9Tqn4z~Yx>Gkt*-#2oD={b~K-`=~wTfvrL*Z(0Guo>C~ImvUVO#8&u
z=wp(<VjcYOfLu-w-dB)$3qD3UvubRWKlTnT=8+veXpK!zp5#`K>zeFSwaU~a+Mt3m
z2qpg2O&wFKnb@dDj`R8K2PR~voSe*R@Pu-L6~n^>yy?Ha`I$gs3QxT>!AE}q1qPog
zEWMBEbYgms_KB_O?)vDRxQcTL>;f(>vKy#AhTpz8ay~er*i05)yO4H@_7jDJSvj<F
zKKPB~Bo9yLemY~DT%4lW%*;@Dc`gk5x_F*b?MmP<Us<s^N&I{0dzwy-edTuaSm8D;
z;EvSfpWvJHt&6ENE{EC4HH-VsHI)#)TK;widXvI+;h}m%zA-h%iWFZs<!+5z!8&Sx
zX3or@0`fm`gMC8<^YkK(Y_4%hF(&?*LhV}7iA&zFZN6d$Fz}|c@i(H9z#q33CB*uF
za04&|6FM#dLvl~3ZEb$O0d(c}ZMk1<F}0)s0bS?aC{n{3bRov+lyuSem3VMAI!Duw
zr=F!Z4j%wP$`Zn!&YOg4;+Sf}`BHvNnczQ_n|Y3bKtRyE6O$56CU{j1QRs}O<}~!8
zfqF>pD{H;19Tx!OzL16RCnq2XHleA`lXODrwa8C?p5iF}NqRSAPUyDkJYR3|X3<V$
zX4W#`97SqJObqCXg`JQd?4S#yQ)^6uQ&-Y-9oM)Xy+nYn>Y7caxh1D7T#s#9@xS{*
z=7&*l8v~ra_if((ZfWc{HGMSXNrkUB(ltR2b-4jSGeH(~y$J-P+%j!Zy7fTy9(iHX
zc}<xW*%TqRLjG!I@h{cE(;K6apXrl`ISr^}y3`yBUHWc3@{2~s$daeS*N+~+zlqaU
z&tqqmazuP#20<zFB?Z)uF?R7g?Y1u*v2!9e?1heJaBU-An%$%qVE+o}a~U`x*L}7o
z@cWVaq&#WHZ>WJ|d#7;ap4~7<%x%S%>GKFWmg>>BklX8eFR2-TaW<2mUd6`xzs3Fd
zI$dS2iPo9>=<G&=j3L(gj21O;On<vOzq4QS5o<LVs+~FI1FZUL($vxM3_;D_qHMSq
ze!e9Xv9mXK$~=`O89Uz7W1p4yhpB`~>#f_!WQ_#Sr?YOj!qBZe0G55fjv8Uj^B5>a
zW~rXPBM$uebn%p&aoAf!3sQ_}{X!6<JhO}`<jxlmY2GP5G1BB~mXCzRXEn{rouD1N
zr{*|nT=wd{@OJzrX~R=W0_iAk;uN2Um%R4k#36ph^Zu<N2ybq@^hePh_9llkQJXbq
zX33wDI0BdRzm7SWs6V~^T&h8#0*X>xehMHwBKM5=E}*KUzQf<TMN#ZsxeV(0IrQ0m
zkn<CxC^r2!>#T44C~_}x6!QV>l-yY0mso(|X5TTno8REzO@kL6WdD<ch*H7{>D!T^
zRd)QEc?3`u<CdtQs+X7|2U9IUS@Rkf&45T`lH)WaspJn2kv>;Bh(on2KXt3|ctms6
z^P7yIdql|-eu@D)M-bl5%126nE>#TnvL?xTnm4K#2nX)!VF@$|uW17H|6mSf&gO|?
z&-BaRmPzE4pi-YjBnhIUp4Z?0I?i5c6vbXp9n$=bs1wB&Ax<fIT|X1CKB&1$RjuG%
z55lXX&%mBWk(-^jIlca%+EsnF#vyn%K@02v;d#L5a)Os~Q%b&ip007sWe0fSrEax=
z@Vu*kB6zY~cQ%W5f;x&vH2)wIHmb+h7v&NZjHsRuYCh2?wSPE9Gc;{rQePm7U83rk
z6D(DezI3(4@g$}{<=zy82RUNUl0nNw@cHjwhM1ciC|$+W;dC@6M2^<p>Z_c;It$od
zxEh~fDDvN@QYn=TDJ3N8?wOU6y+GBqza!6uTO=ZhRz$IH+tKXZT7&RvnzGkz>A6%T
zEk5tRvd_VUJ0<Gwt#R~wPnF+QjcCSA)2O?Wy;1Gb>&q-z9aAE6^gSg%h!qjVZkOOz
z?K;}(*8DB<h$64fv_2*8xWyAxUudiSpo#%x$#&KQc58kW9eGb#EsEVWbYf|jgL!l~
zBR~xW;eE6=4_Q7Q)co3xv5Ww~HJ=!(e?!4e$SVb$z3_;jz8`4NJX*IZZFrrM7XcW`
zbJ5g`X3dYqlS}?E(N<NY6pLc#fXUXqMbP?d;%C6S!cvV)F3H=kzcR@zLD?iqICpCX
z#>C7jI5yq<&8~VF31@?N#2crS{Am)a3OynHpt@Eu0$<@|8%L2B-LsPopvXI}aF=0?
za)#e2#M9O|dip$azJ0+(OFDA1#iv{p`?`Z#HVj4H;5T0rUh)KTN$$RdCh~VF`t2Qk
zI$H79+zlO<6Gk*!AS`Itc`R#}w%++SVJ{1p6Jjs<*0~vK-wSNX>Dw(WCqN)abQhLg
zyVCbiwO+(ToK+P%M(lDzj8DZwCS~tBYsW$5iDS!Y+n+z|_cRY@eXo3BVy)*{34PB6
zj-K;xO%SXw@i-FDSG`sJiK3jNnPjnT(R+@JnZLtMVN9<`U8upI+xrU?yTiT+8cw)f
zBKA_=^7pJqn<;|-nJJFLeLRlQUA217ywcAuMW<6g%08sMktnOsEDU8Is_&Dx)z;~$
z`#G(fUv@cXXm)qfcW`yH88d(Eez2Lchue`n%5_m|toNlhbxnQacla6c@%*Mj{(a`O
z#K-!<8!x%8)3_;`L}#zJXD5B^N6@z`5PtfS!?|S$5WTl~I$oOE<T#?)5|JrDl5Rz6
z=}GW3kD_5P3jD-TH7lGaC_*!OVv9Cs*9qh^>P^o*=1&+^6n*%f%s6z8XLFvo$>UR5
z$1IGuj;Ud1^H9$t=~Ue3u74ib3SqgJAkGe0xG6eN)b*8v%jD7y)fdNm%&=`HheZw5
zi>JGCz5U5^W2X8LGu}v+3H)O$-1c<h+#TlgFH3vqz1BP_J7YZ3|0Dky<Sw{kb|%6L
z9f`G_45!nhuG=Si^H7?0F_$X>LGlP_5y}7Q6KUlv>gjm!84LU@LPj>Zt>^EbO!{JL
zWAQqe0PC!p_xIuRWloh8!IsoQv+H-9Yb+~zKpqa@N{A^IsREWECxx&+O~r%(^}&nE
zJN@!EAxy`)-i2e41`|)cH9e_Yr%HxWbB<UFVo2vQXA#u1&+t04UDyPw>4ef9hs!$;
zT0S^g6%P`RwKQ4n)mQEO=xID0vAxDki=WXLMDJ=U94@PM-ei*A>OGr2*~PhH|GfMr
z(|93mlqz2iK2mXIKs&IS33jpmh;vDu(#>ZBeT)%_QFacX=OTI_s{8#;k#%yS#%iS&
zhW(t7gj-|DRCd}UZJRu?+EQbM=g8cq=Tv@CsA=DV8P%7YFt2bDVff&9UTD3uDvj$n
zd_qmuX_>mv_0Ru#7H}isrWW!nuV_vcZYw`#sBi3hF=G29$D%xE_6h&9vMXmVLLz|=
zb=|<4u0{xmuo@6PyXp-E5juos&aQ5Cqo@z=^h{*JZxo-Y{}x;_^^!EIpYc>PmfDKu
zvev?whlEFGak(q^CeJ=0=VAB<-V{Ka7jCp2Ai|G)0GuJ)j}m{zCkbvcXP-dA(kXO|
zpMt|)`05)!?K49AAg-KH%R5U)Ui;rJayj_9HPP+UG<14<5jI6c%zlNLf(Sj%&;`pq
z6g91lZz<6V<XQW7^o7~k6Y2v8L3GWP2<@(s#aqL`ps7K%c9E>RsE;xWc9lhVUke&9
ze1pOtnx=1gr30!4)}q%z!Mt_+qbf1?A+)?dj|4@WCK^Ki6;fNmUvpP3R)~xqskwH(
zS{%3z^)<rQnT$!@90wwAgPyTEREWhU>4g?>!8ZtIoE*ow-_|_^)opN}yz)vJK5)uA
znF5USFBasBj)~`|TGRZTlz5ETQt*l;ioh5pAjvCQP&D@GStWVNlJu~aglpZe%rV`>
z^eIFO*)mnD9J-#>lT6X#(uDbsboEvL!y@~?S95>MlJ{+Yb1PAGm}m4$o(dxUqeth*
ze<1}L4j2xY(Q`=k_38&KfX9P4aaL0CG~R>_u~B*g$era})G|9H{T=o8G%M{UzEt`Q
zzLb?D>$}LQT)Mw_N9?B)PZgRb1Enf1#YI{siRn5#fn%QnymJWdUqJqF165gTWh9zd
z*-N<GJq{`0i3-DQl=%Nn%&t^8$x7atgd~b>-q%@E-KZ!WZw)+w7h1p*Yn$t-@?}P@
z1zK_?q8xLgTSo|0pFvsiZJb3vsP;uKq0HX-FuVH7;&;Y|H?Pg0>%U8O=s9|ugY830
zA#)7*I7ch!bP%0cy}xoM$(msn=pY(LiH;Hrb;*{$0#qK-AI#rs7-zyyFsxPneRgn=
zb=oJ$`6>~xMI=yf?;ugnOC+$}y_|eOD|jala*fEK=~~P`dU)qq3bh}lvvK^D>SMRP
zz4}PePz!+jbP)yPtZzYa-#V^wA;XTDsie4&*dpZD#9~P7c2Lq7`eel+WD{zBY8;3&
z$0?C=nea8gsP@cy6Dl}`&Q!hvp|sZ9I9r1{Nw}y2kzqccUzTh`e{bOC`z+(b<>K)Q
zQZ7%*)sdj&Ea{ZXg8fOyWqd><T!a`_oK8cVVP2MV8SICZ(7Fvp9T9WvR_u@XbkWO9
z$W9L@Ut%V))>l|mLntGRGp_r9NNo1Qpj8l$FY6~|bmg9gLC24y211!v7M|=Z1>#9R
zrI{_$6ZwFYL1hsGWEnpOM|^mRe%k85toh6I1`xT)Lntvz^7t3J^*F*P*l7#mY06Ex
z{0=h*@p#a4A!RH+FZ<9hM-4kI7-FqK`@Q9(yH1SF&WnVX*PwIB;{WlH(u?M!_o$`Y
zr}lR8#Q4BL9Fp32n*6>Bk~&m32cZ<xx!;091_vUtzk+zUVs<gl(fqlUJ%js5!WF*s
zYPH)O8}rVlf^D^vF4qsLMtq!i1nOzfLd<*Lvw?=T5=UA{n?B-$Vf;O7Fj;3Ae=N|9
z=s%&egbH|c5N<+!8|{ywQ*|B?$_a(Cdi^dq$~Z7_aR?3W|JhLxO0*qy`5kRX@zgXu
z-WYHHhhoM>!w|&7+bvLS6ZqFB{+#4(#3r<VuUPAa7KmrmwGPBX1Z6({|G-hUpAsWC
z+tNQEH`{q4r}C<^0Np-oG;Tj;yHAX<cq;F8(Zku$#91-34qaV#(5sW6TgF$**gQaE
zIfefoLn9$tM-Q&<{wm6t*8BSGLkEawqVC-T5i;!deM?6o0_s#VX_!8eborO5$h1QA
z`z93SJFMZbJfyQyG7Ri|QxBmu$_1So8~c4wT|^nLhA>Q5K(AfU@$ZFJd_`Y$;iK)R
z%TI0eS0Ka|)c5@P@uj^@O7w_N{KY;5#AD(sk3{@q8dW<85Jh5(QS<d>UVf_E0)!HH
zs3u=BuGq2)q48W;KiP$$6&xWpGUC(f1T4hwl(RsM_<-nUGlBM}#$T&qILMAr%z=vI
zM47oyjqCNp<jhve>RC!XFV+;E*tfnNjW}VZ^#)Cnd(K<|c`~~R!M%DFL~NTs$$vk}
z&1W(zBp{RvZ^dPD^1@D?au#J*0&eqO$p;?ABX22LG>Xl?sZ7X|gkYwPBZA-Dl%?kq
z=Fc#Cpk7JU$$t<PWvmUd{D&vwWSFNQYGxaWL##kC#wani>Zf_ved~b={tlv*`UptY
z!>-z447uW|yo{-)3!b1WkH>D>D{+VH2@PG5@inyPRV1D7`n^bk67?(VZ&iq>cDKh(
zfLu4zu>TtGMA;$I76Bp7!h&{6$ED3zj6G5o%guxa5(VJP&&R~b%x(oa`n`GEBAwDp
z!W*#;47obZ$$vCH(^|u~Gd4}sG)2XAbgk4jhr_xcCa-S<eo#mM-21&`DWlZvhaib%
z;fUPHkY?hM7p-iB>?ayGVyV**_pvHQFy3;Tp1#>v$Z}hE;rDj0S=!B~J{0<gD&nO}
z;tSOKbU30mVkPVVh}@r%vBE9`PZZ2x8-;F4{7H}Hq*SnvwN*MuE=*_w$VZ%dQu^DQ
zfA1ye3%L0R<v{Paw5EPMs(iSH_yP3Ec|$7TOsl>)uqcI1km<mS$fQKdISEVm@y2Zj
z4C6~odM_K38mGa13p|m-+s8-Q*S|d-Q~N0q3t>4;^ZR&pzr@;V^+&zyw=yHlcXwx<
zUzXk`VE93NENVKIp&=^<5r?{Ez)gqJVRzOD5g;s9CVRjg{#iie!}cGNd;gjTKSx6o
z&#=Z*#tT@?U_EPRYh5ft?#FUxw59hI>35cfd{FBk7*~8)({oc28RK*8RquWGTYZkq
zhONHtWcx);pRT=_DCIEJadg77@>T5ki1{=qN%Hidp}QO8v9-4L6_9A1uHl7$AzBvM
zmsGIkLMxHOK9QnT-upsE`xD$mB}w#=srh?`K47!M&)KArn#vf=+;SS3fEdM54?2Di
zK*jou#_N1(p*J<T*K@1|Hw}nvQV0$8`3(f#cqM?#t}@xz2iw-X<d^w)-QIN=wmS!p
z`kO1s^M=yZ;JQ#AieSEAS(MJn{j2_K*lrf(_N}5m-1RBB@THFfim<<B8D8o~a4`C=
z;F7iNN^WsvErR&W3X2l#3=K^Dl=BHnJEO<Sajwm6Ss0nn6P$4o*Bh^N-S>7sC6nk2
zPkOwpjFuAPfDS#sRk?Who`4p(a4c(Qn4JdeB6!EQtPU6gC!}gr8XM)nE;pZGVO<F#
zr$aqRvwc3hCr_3-wkZ#;^IbK3JsRh%%EZK>Wy&)l$UHdua9BlcEhj-e*|*E(N#i~w
zCE$Hy=Q>9afALDarp#E>rku!xaj{-@^Y%kS9&_UINc}6$fQ{BnJz9K@U%`{|75dy#
zoO>;FWFVZ9x09xl*?wDs=od_O@2233hrXDW9QwRN?bzQmZ}NA(l-2ltt@^%!)^7*W
ze`8F85jB^4kF_}}QpJC{NSWax74H_`c#`3Dq~e(t5LLt%LiqBmYRa8?H?y^T1vP{y
z#2|dDT5~0_p3nGG9nMXXJzuJA7vf#5WrqO)%X+UO5ZPhs=t9~W`pUTzgs;<oS!b?=
z2G&1<Fni6+KUY2|tGP@y7WrK>fDu`lpP6{U+JWu^YAdkWErMTqTK4P?H5wRvQeAp7
z`i@92HCe&K%kq!<n!595_OYRSj8080`i7$hU5aco5i<Ij^dkd01Oj{ku`GAAg77<i
z(BVN2gHb1=cfO)XWlM?1t>%+ax8h3imXlG;z3;CuBp`hE-wg^`2Sp~4wzWy!BB$+Z
z=+>jHkoubKq{h8)6)UNVa1oPY7!;?9<=ykG<$wb4@xG7$2Bn&-lm#}WZBUjDm89v1
zB}o(@nNDi2oZfJBdYYf4MAhYkb)EKka)-KtN5_C-Lx#;5hDOq}9r4&472==BtS`A>
z!C<AE*i(xQyd?b`=PyU`P0F%a>P*CvX05s3dMQT6<vZ!a*F{{B9UlBaRleUMcnsTR
zP6hU4_Xil=S20y^zWv@_TaSL34*&G#IUg@B1$c>^+|01`w#O9K%GZ)<o9Y?&ZcoYo
z_$p5HXC{aW-iyG+b8GTi%9Q-Hz*Hqjl;n`#IqkWq-W}9?R{O5I*Vr5cGXjV7xkIn&
ztJTQxvwnmo6b)pF41Ty+Re#FDslXdez0t7a&29RjkR4#fv*q$c#(0tJOGQUq)AQU7
z75YujIQG59<ZbJs4=EWr!0yDX;ZYaF>XYa>TZgG_>2NCHshY&W*t_aP#SCg~gJO;O
zwV@V~H@<S7a;-H-4s^{@n0ptAFyzsxV~5BzxEpCJvFC$#M}Ukx-gh4BlpGCnz0`Wh
z78dhbC>^pfpzR<l!YHfLyM02}p+WI!58~x=Rk`G}$tj6B{&s25RHK7zgQ6}l>9NL_
zCB?pwdE|qHFUzWRQi0I^picSKSNjb5U%thG&titwB5HaZk9@2*12#F21#kKXchD`V
z+>tLiC^`~`)es=`{r&evCBfUAe$zevquvIMx!pPwNK?81B9q8tp-Ri{H5M`I?Cw@q
zJ7Pg(yS|FD?zLhiD9LV#3EjZc`{-q(b_bc-j#&9PhY3d>Sk@EOt%E6il2R=ZQ8QHp
zu$qYu>el&tr3TYBy&crCsZ2X8Pxeeg-zxd5@p5vF^Z8q!!PDedJhwCF>K$bKP%h{w
zrpc~J#y2{VM|?0f!ZBmx-UzN!=S=?)f0BF$5j7d83EAd6F8^Hi)9YHX?yq0@QJF8x
zHGQL%PI|Y_dX0|Dc&xyn&IFIWclk*&=8aVm4jMB${e;N?QWdUq(teF5Gur7}EXO3~
z%Oa)|4?8=J$|Aq#?bt;n>v~TP9MW&U|MewtRQ_7=<2Y;ceWWkTaBh!4Zpx4jp7+ff
zC-#}%d<XyyT7$iK;_n*g@jZY06ut|31mYI;alTwDic*FeJbHDI!F?)0S8{_oH`A<t
zPwQFsjm&*n#7W&;cSa?Ai?vBe*|m<lb-bNCgWuAte*Z&kGVoZv&3WzY-7%q)Ii54?
zj`C&E6IlCW(veX4d#bhlKajQ@;8Rrc#=iM(w#SuX*Sa`*n8g#WRwHUQJQp`PukUxS
z75#zeCswXgYt9yxBWljtiGwQy=VIKi6k9ly$ZY3Nld)>9&j`^vw9?{}k-LFPext)b
z8S5BPgVo?Runh5KX{woMGL}KtA;jkHfR2Rb@wfjCEzb_R8)ips*~>M~0m1Sw)y}>w
z^zH@<Lh^$;>r}C3eig}RWlFNGUsOVH-tX}xp3^Vo=yW9b=bGO!AvpaS&n28;I>G00
z3I>l`Pv41NJ@G#!{DYTo^tS?WrO2JH{lqht*tgik@A(~MX3o`@1r+cia^p&|^NPL$
zzCWDS5$pb17~Q41%FNmhDtRybwZ8kjJi1RfTUo&Rwc^PGOZ(h$a^U3e%<9E8PBAZC
z_3o8)p*vJ^$LM}0rG@LW*%C@wCy_=WJ=wTbNa6m-US5><URhe9-slVcooIw4)xTaZ
zm%><DZmgmgypbXWUHC6hSjHJQc707YjAqKwHi$GSF%~{_Zora6@_}D>IfgG`Fi^OR
z?*{7EPvBxrM1BorA1W6o0K!M8f$+SmCF}HYrH43wS}RF~t;M7t4I!cve$d>!OjsWN
zx>?!(_9Z7!L*d@bYUaa2`or3=zEg>nR9R|-b~X4%hjC6wqO_StE(B!TV^<J{695Df
z9d!_3%R@y!?DbYv_N4k-{s?qde^f`E;NI+RlHQ%4h%N(e#XHyOB)w<;pi;_2%bs-t
zuFOz)(`8UM>R@e|2Eo5TO_rX*Nj}>m6kem5KYiUItVBm%?Hq4BZo)gq!ootr@ol(D
zsj_e^o?|oUjbhD!?8yArk8*SZ^8~dRjMNZI6Nroi;K~TOBjeIy<%pr9R6u?z<jluh
zE5fVuE6z_tztzK;Y7mlE1eyMdaY|IA0Np{z@Md`e-w5nyI_sV>PrXM7UM(JM9RR2V
za(TxmmeA9nFGN1r-#dP^^&!=Bpaah1g{qdgioY~LM!34h(NCE?Lc1mWuUEH}d@NU;
zJIOF2Xq3uXg>q?aA&ZV=J5NOZo|%@?L?;lwn`~V9Sxci};*^px02~n{>gcz$r1fQZ
z-~U}8lFp1w;Yci5gy{VHrEuNkr1{iq*DWnBZBzIB>KgtWa!Co*tW~)8<5Oa`vsJof
znjUTjPVLz@oOGX)X2=^nV%&jVKc|1Oa5Q+s-$>#G=LWoDp>VMI%wER$s92|IK<@&6
zXl&Zv#cMRrQj~B>QE-`ncGSl_6*o>UEoJtT727MR@lP;*D3DCRUaT@{VIX=~<R@ZN
z&+r82IOdr#AK07tJ2g;?Vrlfk#W^xkvCwWJuK%hBjdEETlIjmXlC%7@YC(TLwzu<|
zf>#z}v@ldnqY$gEQr;O$kPkNE=8*P#0>8?BYsPSKpkvZgPiR1Ih^Ww2p#nBUrONlh
z$_yu9-4-JP&IB^FYu2maHQbqUeW34`$lf<|o^Hn~))83x2D&4R>6@hCl%8qq>1Cu|
zkHG<)5ycLoG7ai*EmMYFs9+7WceUDL9_)~b^4!$WB9rWI^@`XpMPf2K^8zFsFuMZ4
zroNqk2e5mTu;-AK`Ca5)JUXr<M8nT+EvH2%*Zd1-KoQ?Li$R3(CfMzRnugXHN-mHx
zqsfAiBLK^4G^57%iV4GAJR}hCAn$d$1`c%=e2{;2jxJEqKgjD6!vMAC^}d#;OKyVi
zbsD*B(NwCjvbfQnKujM?zNq8gk&+?VeWxjO9&pF1L93|}WNO<8wCM(ZQf1^lX#9ZN
zCz&cYb2A?yfk~U*@sl$kbX%jb?Q9MFbs4H?9KQ{YD~_(FoVc95el2$7mvTXm-uz@z
z_BcHRIA(&}kxBsIfaChkJJL>#|B==tLX*DY@wjF}Z>f9uarn&qCwoAThf2T4t-ngT
z#HT?F;bw(Hvu%-+mP@O%gg-5G`4yLN9^|+CdeeAWKt45|e-Pao6Rb@pTYPrw@Q734
z3Cn!ia@&iB@H6L04ef00vL}j^8($)SQE+4KT~%NJP)eyRs!^}MCz*jX+*mdb69z2q
ztcT50nd!-s0_8NORR28n{9TCr`WB!SO6PBTe<uw($EUaPe|G0qfT8cXEcT8paDtV;
z3VGJ@O+nV%dDRk~*er&+y#8I=#Q{dINL-{uiF<~aYN3P!&pF6d@}*xnQjpiH$97t9
zZ+J6CF^2D~wBmaAI3^*;de1@jka1b3bA9dB>+Xx;E{QGFa$ow*w4N}dv28}OzfG%K
z9kupyid<o`iLe}V10KSNqf_;+?Z$7@X5=i~qL`NE*s*IDx#0bDfrs%7Xj_B4s$M*;
zZzUUoFBZm%AU6#d?UVO;A4CNs#|I6q^J1D5DOL=>ztoKjN6iT|{tim)U_=I50PC08
zNXETC_222S&ZoN6SG}wlt^HhOwiNH5b>N?^v4E9fR3U|Ap2*PnnteYlBFuv5p4?9v
zTrqTit8(#rsXFbM=S?35(#nX%<#YS+8fPr8D%3GC+GJy=EHeZcGtsP-{Ei+^#iE>-
z4K79MI}^ng(d@T(z)p-k5oocHoLeAD-XA-C#vKtcp?5eXY7LXZ$k}0?8FtyscO!YU
z0s5(c*f9t*GP{Y1WtO@8OnHc9`qWcptBHtZWQ|lUI#6n6;Tkx*Cu&||Rt9C_o?h%G
z0>TCo6PHn9HKOF#;@!f+bo6+LLOs>kZXk$XDuSs@s;>GiF}6sv#V)2dh}}0q!By?q
z@mfBLgE>TAKx#ApiBa*FX@cYkvN1V6(W|xmC&f=W4#3?~Yl+G>8N5G;iNoM_DUEHS
z<axzPI9WqdyN0Jmx1Pf2UP>)Jog({j#g%}DAoj6W3L%5#3iR}Yo&3tos5^Xc#<nB%
zF4`!QI!2s{l1uQQ3;U}e_BtC|_G(dby*2%+i%68(mCuG5g*qBv$8wzw=b+TF$<2ux
z+8k@bkq{+ca2|xK(f?e@&52m|Jl)K{$_@argDrf#*uAT5R!g#6ulg0HHM=v3h{HBT
zvlkDYWe0regqb$;zi#xa8U`>DhaoHL?6i_1$j<J&rJnE9*ZoH|Fa6>7-LWWn6P2v}
zPkMU16(5iuF*{lkpRKs>V5e$c%YLs!Hc@K+ja4Yf#S?T(aZ(QVrR#`@Pb&#WTD$Fg
zAa>#-m9bug0s&fJS1adecq(wIYa5?`rwv5&IXd(|D>Jl{g+$4XziIrr0l=l=kqmk)
zIT4H|ss|ZEQqNOv*YdH>;(Pw%25oW@_g-w@y#TSJO)@mt>(q!7v`H3m($4cVOgw5y
zHzMLMaOWld(5V`hsy5pVO6`@&(j8ibf_;1%8j_sRI+a&^ROJadQM=k=>y`FVr=wR)
zP2xh-z9H_NSBgcCEUd&0g&t90GmBk(w^Y3IMv;Kse=4;UGg~1_p1#)Lzd0z?<(*V?
zUq(y3sk1^;Q?Y>wqW|d+KwQ$%59;K0u^oA_qcGwy)H<%o2#7mES9}R{XWmSpdGeMd
za;g{v3W+9}_>tZDQjC@%^80TaGjkC6ckA6(;x&8-;RyFMVNvqv9|zxHX&mKr1>)24
zy|U$^<RE{+zG#%%#{ER|z^PiGsu}S^q-YWjF{jOy2wwz%esC7#ce<6;CUh`Tmf+)A
zf$_&NgkDA)qk&(FZvgZBxZ%U#aZg;hS?%XG*)AZ4zNP?qvDIXV_;OZAVdOiFI_xEz
z3PPfowA@l9909kif+$u%&BXrZwYsW$=GF^Eu6I*IA^I&@LFuguYh3}Sc!X8O=s6Hd
z)Cr0gJ+i6Bs_AmPLb!iQE(us2-zRr2i#*+hwt1Zy3*G&5dHj>zyuS)=9$G7TLHuX~
z(7V_F*I44Zv}CuGs|p76>)t$+DAt@&f46nusgTK=7Nd8ZEhC)}a?!E~$oVz&E_+$%
zpDivu$NP*NXA+erc&YPL`di4N9D3fgLU|a8dNul=2Fv(5sVtUw9sotXMt*IuJ^t)m
zZU`yl8n&RLwt4Yb_S@iMbnkPw!<ZGH^*8%8pnbI25;RV6xhGS0&&IFA;Oy5D@+H)|
zqzT_=^1^|;qxg7g;$CKaevFNJ&mX_hNLNJ4(4ZrJ#=}`Vq2ds&Cz%!>ruRRK2nLf`
zm)-|jMEQE-4XW}_<0zE#O{S?OSY2OX+8D@il0{<|MC}x#jt8DsVjl|i7+2J@x1B7{
zSN>F}%Uu~)KjF`0HB_1q<Z#i~dcmrtDqR11F!q^;1?<v}RK4xd3;l~!#fEQ9@RZ21
zVU_mzKQ+2Z{xM>nOdFJ$p;^?AqcZQO{OJkYuKtxQj=4oE2XmnPTj=E_l+@3N1`_dL
zqDsHL!lfycOtZVUirFvUlK2wlSJLZ+mD`K5Fn+Q+^eVH+Cbe*=ieu)r4e^(AT8HX)
zD_Alla|hOMak@+jn!kYM!jx01JJkOvYTEZ`oJ=@oy`<hMZJccDn^dTs2X5&|he%~*
zhpzKFN+0P1Vq#7Cc&1Z2Y8&`!nMMclpZ-p&<xm;ep%^Vam@qb}&5pC8kr_Z7Yd#OZ
zbcTCqH~u0<4$n^-n1=f`vnv-I<CV#W)ToGfz?SvFp+W*q^pS2ht4{oZcG(mwn0y{@
zE83(w=d^ey{#1Gp4?Hc~#1ImmZOS+nP;FwF!vI!Qyz-7L!8uQWt*IA?&_2*k#@&sq
zItO%%w)A@V_vU8q^#ntntsYNe5V3R1)rm(>a1&h~D~lPJGw*Zbh}P(x4_SjnV!y^$
zMjMUN6R!HJ&Y86)ZCh94O;=(jT(msRh-bZyed-&+%S~@tcv0IfA_ev){4-zh2zKr<
z5ZTf!yd@;gV4!k12V6yj@1itaH^;y5&<lKvDBK#nDdjj@RdE%+Dh$G*P1zQ1>5Wn&
zif#&BEwa`-%<Ym}U-!$vR-Y3T^Afu%N9ew6-%wY6sT!rrRP;UG`ihkPtk#!SC0sT4
zyKRtYUgI-`4g1DFHxvJG*+VqEc|Wsrm-P<0Te@iMViPM>j$NED-*!%Cb3C2e&Wdgi
zeB;u>XMO)BX+c2j;VHx^AT97kMyo`00ZNQTk~2f-?i;|)Qm5Ah!sP6f>zw2hNHuB&
z+qyCp*A)&U%|@9Y`_Vc(6emsQUTt-C4O~PQB4XE0>0}A(x<5ui-${LfWt_ye)8q7t
z$VVq}o1CvUsJy^xnW_BcYP%kS52r*8KD%`py@lbtEqs1O)#|OHKyd&U&2K}FJna2`
z<HpV9hVz3{i9OrAt%}jxFOwA5q~Xg)m-U?Zj4EOV9j-G2*(JCa>^ybOHcCQT&xmx|
z|F&Z?U&BnN^rv<?-3K2yB5R^`$NU=V5+gWLT#-dIu#>Y;?rMp02TXO$uRKcAw!Tzj
zL1aqmOZ&c$H7$gf947K?6Zq5K;FI~d!>XkopQ?Zl)1Ru`+AzJyk8qHV&M29wb-{)G
zDL<zp(<Ulx2-jZu!iXS+P7EW)2;_n0;ZOY-<iD56U*R8BILqAKz1ekD4zc<c`q5TP
zZ+A;dgU-g<@!Q46UAWCEPZ-@s!P&RY>k{Ph8G5lwC|2s?-b<F-(oB@kt<*p#!iVt9
zdSA(Lr&lY`-#4cWVd>fkkT@MuINsk#=l0j?p4`R{1?D2pqY=JK@AleV?+EC;1xj1s
zZ!|n~6C-a=C>LvN|G;b7UaZURjB2KVMf@Btj*8lnUABcQIZ=eMtEc>-^U)s9hhFi{
zXa>MAxar4B1@|~h?g+&8W~P+{0#u&*7kA&w@F*Nz6)d*aA8YK5E-E#k6I&pesAfNY
zp)T8fjAGkZg%40Q)cJgArBQQ;e`~yR`TFd)kHm5-u|IsEt2;edq&%<ES1_o^Id8_@
zn;8o=NM-XaRBcmmf?A#V*;jdRXkcN-%#D0-->(04Jl2oH0v;6S^ECGVW9qA-+W6jR
z%Z~!3SaFBqrMOFQm*Q5uP>Q=d6nBaj_X5Q|xD|JIm*4?{1W4fKe;@9;4|CQx^Kdd}
zWipxBdw+W)fz)$otnv87lXnVS%8X#3zP7Z46G4R!=F@XzSZw?aTZ5N=V!+&}&`5l)
z4+0cjgZNy+drTAc*i0c;Vp@UsFA}_HqxZP7jH5<}xlFq$i%n2V_A;$89_%ZSp`Vx7
zJ>!kW-c%3Z{`rNUYPFKf-SRld_9$e%rg|>?Xa@!doi62;J6FDwvk^4ra})kpok!U^
zt{dTo`VoK~Il>Fk@bg1F?ukQtshm6oE;mwBf`6wZB(Mfl4rod$G#D#)^!jS{l?r(*
z+oBOk8Lq*#c!+Ni8w`XjP6oJ|V30cW@%_%N(#=~P^v~wX2Btg^l$T%5^U_Vt?yfoy
z&yf9aJyi9errfvt@Jub@ALI;V{4#b0m&`1^0BnO3Cw?Y_Af;x^w~Nc6V(I;TnevNr
zu$Kw<Y<}VA7Zmm)qw#0B;y5*mqW|u5F;v|aKCk)V7O}zPr**Q5{RiTWL;Of{w3=B*
zM!w0RdWYc)Imay1`_k`cKAOiUPxB06_|bkfzb#B-+j;+{ELL6hE2(WXJ+`Y1?^jxE
z`Eslue7BSR$mW+!WGw$&><R8b?}zy>4X}v$e@-^$fs$e?&q5+7KTBHY3FY3AEq?u`
zhaHe&Xn%sqrd|{Dv&deBHP`ho3x-#7E^fezruaRq!b;gIK$yh{2rO~t9~oNHaFa}*
zlK=vW605zgrcg?6Z3H_~(L)WI;c66U-N&D;!h6<>M5b*;vcsc*HD6B*xFX@X6Swfi
zr2yypV$;zNSN&CKFi>-cO$VE(A8%cifV9;fcJa4UDpN(Wx%y&f3bTvh7ptN9&p1yC
zsG!IZqaB&;93lJ<W+P#mq}&NY)epk3*~Kb>szTSU<CE^!W6ZWEk!R^KJcse>$inGK
zXXi9vltYOV)MTkP-l8-IQ^9wk`K6Qe*Nou9lPeDpG%)!M9Qm?rX#)062s(wJc6fK9
zQwH_~-MXzlpe=t`oY{Xsqf29ry$uZF)Ks*;#R*zh@~A-z;6(;Ku!v@&I&4!*HonbJ
zg1)>Hb^V?Tdgjq0<ZZfw16q~Y7;I6|;J1VCUYOfzrXkrIPe&bG*a=_5*bMWr`&NBR
z*3<Nt%De~-3;d>UZfg)XGjQP}#vEywMuW23u?qg|uvfA7)hz62-p4u1{rTwZ5erAG
zV9AFeXh7Uw8cn=$uQg*)_bU>Vz*khv`Rs5Y4;`;^9VWb?rO-(tZE*?5OLQ7BACZi_
zQ8T4Hy(M@rtW7bzSO_bZWg(l!q<n%#5WHStQEsd-nY6ZlNh>yFhV*;0A!-;|t)X$m
z;2Al0UPR5Q(!Nhtbk1<kKNuO@<YHX#%HzRtx*R-p&EtN&PcHmC@faKkAr<wmVGe*W
zz$4J8=Y{loc51;VJ65``{TYMe9w;(Y+OdZDcjhNFe83Gae8m(^m}4UN#9yFAx=dHr
zS&dko!wu$mzU_G8Mp2i1Mk1Q<Wcw#Df(om<ta4axJ7u8Oec$xlM_w`N+GS@yDO)64
z<cNBiPSMJQF5{pB78szGr`!)E6OA<CfMv%|DIVYTA73U{9QrC<jgYf_JHEpcwO^t;
zk*&3OppxjB7jc}mfe$(c%0yd?Llst6xGvcmX^<@SV<>`_Gna{=1Yp%hC;+V7zI6)W
z^;Jw-)AENQ5?W190oZ@?93lN{<z2(~Q!~YZWkN8~3T$e-Dkr9wox}rY=$-Q`vKQWn
z&%aO$FK8y=%&giEVq>I&w$hfoyAT-VkTYN#>r>9(!q|D1)oCxc_C0(db>rCpfif1c
zeZh8flIGZNKvH2|1y5o#^em~~(lX^48gTTDaEW-3Nu-FVaR|1LTFWwlk-f2=hyHds
zgtxm_aMN4{d*tEoSsL<<hb;0#u_rE<z(BCDO5a6efsGJ_3?hP*k3TXp;B^O-1B(zR
zJBSwa9i?)~T@*RE`G~GhrC=icE1Ol+_I;PP_FSqMRWwXCFi3`QM#{DH23JQATI>do
z=+TG@?fCRBGzDw+&u;wX2D`W8qd`UoPL0s;=z&jJkSq_Cf3f>!#;3@E#2P=B+OwN=
zwD)a3#>CbJes6=!l0L~#`^Z-lX(X&J8R0z12vMlo&Uw2VsM7yFoV78OB>0P#%a5TN
zvF?jFreX()cO`j}6T(as9tC?x#RzW5%2N3sX=Lr9mueE4cCf}4VL}slUo`C4Ut?<C
zb{3s%!Q$FQfF~hnIPE)cBDp4sJo=EjuiFl5*#(8y=oIV^rrdiuLgqAau{1J*i}Um6
zAJhNoDYSsgA-fZWo&%K-q<s8E&aNphwaW*{E8EseCO^4HcdTD7j`gZ_|FMTy9J%U(
z9thc_#kQ2a<)4no0~6Vv7MgtMaQpJ&MV5c4zV4|;D_zrp_FUz9{1EO4kq3a<4&z!_
z@-^^WqR#`Zr90DDsAO+$R?&vGsy6tIm{$PZ<g{WN1V;GEhW!X&ub<YVMKyBIKe#S<
z=Jhty5dL^9MxW0uY~sBsf4KB%WCzOto3`zE;^il5w70XPSa)&0JC_jm-7yo2Fp-$U
zg3HHxNz14}&2Ft5+x=-j>32^L`*OG&uxw@fsUf2&KS-g_V`?@g(;qksI~erH@?z-!
z>SZ*A;8)mRg7#$jqZ&OMmT)*4cEyGBTXyK|M|4&^uoH_j?t=O@7FcghFuulMt=cKl
zs`x{c0&3>eyJ^u|n;F<|`p#$qd`eJBt#XTEoOgwvwOl1sYktU_cr-1hcRue8GrdA~
zBA163pE@{|IBFB0n}1ZpcDw_OuG8qFe=sTg|6EEq>Rvh-DcY}m4G*DE4@AR@o*$c@
z$0BSk$&T@Jlb`C%q28Au#fzSUYT&rfZ9p;$5q1*&`&RHkDhemk`%C^(WGUIM2Dbfd
zb#Qx;yW$BHXf2(z8C;Mhw^iqLoL8sH#OwCb{Yj(+<C%v8XAvwuEq(XADBn!Z9;2xj
z>qJ8Uui<SdNV?@Ouw<{n?mz65cs}xS3!N_X-qm)Io5h-H*XB+5{FYbRcpF3+;nt@Y
zuku!e#%y8Bp(m<|+YwALByUZY4cQ#97Zj@2$t|9Qaa+NKDG9*G1(N3tA}{#Yb<`rN
zEWp{7h}or*X|+S)v`%W_<W7bx<G!b)9NM9?a_N1UQr)XK>+RrQ^_n8fl!Nbm^${ei
z!bb-YHLsl0q&$J*BEw{XNEhe$xzs!jIvM8e-szb_lWxI{;m-rUX#TG4Ua$C5fYjD3
zdBN521(LNQh7)~RV}eJO_SO-0PLuxg*ln&^es$MdjW@s7Dc;_miw8vRTJ^k$cq11U
zpBXC1sZ@?@?!5VRO<3`&D4$u9dZElOlCt=5l{S$RqEodVwn?ykNxq~+zWqG6-UkWo
zIuL`>&EjwO%j!{-{v7t^uIrQuyrSztXkkS`UcVf-`zJr%{WDbdJUbQ*p(yL)1H#|!
zLJIj<&X7g(3WBM1zk5T>BqCe{yDdoWu5H6fsTeI0SoXR*pkL277P#W1SmG-sRdT@F
z08e+f+5|uDm5GP$hMC8$wQijL3D3=UCarPxgnZg?$UXa$mS?c>TwVawaAql*DkiuZ
zc*S%QgH3Z{55Hm-i^0^y2gYAv?LFJM)X;o~yvwf%Dv|U2maS!JK4`okHqT%CC%X|e
z*Ls9{y7?P&I$JIz!8pF>^})qnsK9(xJ(Ab{3(<Ta{I4w!U4ptt{`C~dRw?jaukwcF
z&=a^%83EbJ@3tE5dCY4POz>lemxD>~c`%QS^&-6%9<>0pJCw2>$x8U`QU!dq2}Vn{
z?WbdD@RhEDbYoS1`58*HSX%U!rXm(8Jrzw1j~}^o>;sHcf+g?x>w^l13-4T>_ep^M
zd&I+B=>{<#Hy0>theLf=M(Yuh7jx<I`=VrdmqWPkobqz0jbMVeTQqhFZX$&;H4Icz
zIpj|i#uv6tdrRwS_H1?Zb+qnbe@1iJKoJp2!_HLb(m{QJaoGJEc^dt!pGW~0#LZx+
z!kjZUtz*Z55>-!e%|Y}t7*QD39$W*Sv;A>L_f<XR9~)|thxY@md~;O9+UA+sAM3ET
zcI}dK6@8hpa(HCXWz(n^`@cmf7*XA={V^C=!EFOCPOMp~I-bqQ*v3=b)m361dKJG9
zT>xIG6+7y3;WTz-YTbN(PMH#f9(=j%OM?M*eB)^YP&Zg}zqqmNY4p&EIG(|4&IZ$H
z;KyGgY2Yizk(nd>z9~`HKNJS!#0fo}^%yuU%!>6a(qGMV@z_qsT<?2UF2!GGL8TGg
z;-=vPXrptL3slyEfeHehf_63`7{ux>yZT&P*^h5*CpUd_UFzl113sx(iv=TrBxR_n
zgLi9jc6K7`$0-GGT52A~Rt^ILG-v5KJ%3K;glTz^bo^?ufUC-;)jvbuV1LhWsuW!d
z%#-6drSV|6KH6GDn~{6u#!f}XBdVn4`}^raIG<Gb_8N)g<>?J}LaVbX8u*pXh{I^g
zrguMbUQ>^1O~@(T_JQuo_HNQLX$w6j(LImaXg2D>K1=14P`6vbA|E!8ArVo3^)R8k
z+=0%Z)BKrXHN!0?kw))i>=^cDcG#KZE-`VJ^OR<myVWIT>#cT^t>T&G(P&`6$iJfI
zxzf6aIRM5F`O-^rSOxDKCH&2~-(Wbw?C|h6=-GEcZ>gMi{*<ZgMpO*t*DQDcCP9PB
zU;JN1#ZZOMv;r`%8p_0lA!cds)7)O6Bw0(9K>?VNZLb{L14IFPdayf1iq5_tBTKs5
zWjL(<+ULK`c`tr+csiWK4~RvZ{QEvSRjsWv|8cRsBEyXRdO$Wmtl%_70g#QhFB1PY
zF>5-TM`RATIdW5nol^37x)?1fjATHLt=&Xkw9e)(#E*D=tGJKJ<$A|23Of46+n<Cu
zQ4BLu%|1K#^{o$zj=7?a{lb&+$Ed~{$qb-}UqQToHCr7t8_IbcNSOVO%Cijx=>3St
zc2+bS>2iHM;4Jt|nDQiVn@$L-LFcJp=T*1Ty{ui}>yKTX(e$du1YBphDk%&lP&v&x
zJ=C9S?Y_R-zYp>~9XCIEKD=mP7*@H43Sa~XQko%E=sKFD`c(e8X5%%?c>Hx`$goyP
z;X;E8FEDWx6j8vAECwp?P58VF3a2dT4wY32i+vq;%_h){$g2L9uW9pN+>=S9Qht5Q
z1s}wIIG6Fb%<F>lIq0rkC~?clJCy?4$p~l?5Ma$*`}p3O%0Xy&241CgF87mV(NvyI
zu`9=~n7kCq)Ow#9Is9cxA(bNJ2B6-}r>J86z>Cq-az1HJ?5^FDYAY*}z?YcHW;CS5
zZJR8kypvh|dHHw1TTf$&&;uZp#Run-`)$bE2jFWSlKg0r(SK8Zv`K?SY0cx`s2IVi
zjLil0XrK>_B4<Nv%KzS0%Ml6UOd%Q*eDpWt5rH5ft<EV3Dhl&x?1lS9_Qc}7A3m1=
zxheG~Z>(tY=JD}fxjx$M$o1ItrcNZnw_3jO!>!Z8L4X|cu-viZ+BKVVx8(_MT*GHx
zucZSQH#-w*GMTkZ^G@u=RLezsioRV-E&oz`vaI`xeR~{sgHot`6G(((u><N;K|cLN
z>kx3}y`Z?5y}VxBe%MJB6^g2|CEFgt2);^5L~g3(`hJP6zV^)!5~TV^Z9kTeM=Ko?
z@^3kqNJ-hdRt%4r_mQP`N3kgWNz8bsiCK63D|domd#2|F;&FqoVdI|1mN?U$$K877
z009B|M5eH73Mf0TaB6utTNX!`WirR<u<?DOJ=~r(5D}+$9G-T&b7=Wc7-_?Iy*i$Q
z4YH>hl6(|`R)HQ37Hi|kB<6_!Yo*(i(SHyl9RqBY%;JfWa+-qo^EqZCQf6;t$lnIp
z4+rhg2%C9FsmkQAPYPo(LG)cE!syglv+8wI*c<j{6<*_9y<xiM@mnv!-#_U10?2A~
z*@p=pFE;ws9QJ<XqT8iR5y<*YF0;?#9PhAw1xaYQ_=+Cm!v&$ci-7eFm#bU{Dw5|Z
zey>bq#L)Ie?RMV+TVxiea^l2eB50T0V9%MFEgC9UFyO3Nzq%Yl6<3{EOPJg5IxlQf
zLX({c$|zU<H|u+4$ji9nPI(mEcqGr%ZFp{ZUr05^?YSr%Z<9rkvm<&}GW(m$GSJ;m
z=KE&~ATHJ{No0Q9J0BjuR%5xaxMHV_B<(NKR6M!u<jJ@+JQHjOV*cW<)GiA7xP34C
z#%$w~kF8J@vV5I48jQSlQ*I8E9)Jmx7Da`u+%@Y7WNfao6x{0q8b=T3OP8*RwL)^8
zo<6zxH{|lv2DpTI5DONa=TxPfoM`5HjtNd>&&b%m@Z9f|@msl!z)K14mKL48oGi8&
z++-<wW8=&VU9ryH>k^|NXf4#~dUV^R5+R~`6PXWyM;Gp?iVLCTknUXG{z44y8KfV~
z+n9Jh79`5J19>Hv1?;E@Tpbmk8(o6MhCf9oX{v}Tenm=Jx#czF7a3q=v2MoLh64X5
z0wAk&k0N3g{4;4A$m9j-`}xBoDCH(7D1I40c_;vD1tN57ZvgqV2OUs+uRF{~#xD*>
z$R=WJ>#ee+wdCy0g+yo-<~bgFneDxHNfUkJXF52>%L)aq!PLC}jBzgaD|-gN)2U)K
z_6*tt4M@X?Ubchw)QpyQ`C0DOam2umDBt>%2SqM@b>@eN@t9sHEZv@q^IUfwJ2-Yd
z|9<C3GaeET@F0adik@=2Q0Qe`7k95k=bK4L8!cZ6)c9SY5?ju<&ZLb#CPeWbIToXW
zm-do>{I)0*a%?FVidp5}CbXtr@|p#*!*}OKgqaUvD8F2$jO?5LitTmT>dZnW64F5+
zZsjBb?n_~8Q$H#)-0z+7=H9i~)cy3R*c!#%j}3><znYCLFUWGGGnapreW3Ga_xlMi
z-60fLYh+qF71^CM7GbKW-hc@%Jg^*f>>3U&xBc`Kp7vV2Mty2>IHLV#e9DgwRfc6c
zGb>e0w=S`<i&|}GA^l`0Aj{aQzN#$(-Z@tO2CF=kda?g)O4)o#Ir-XYXnV$HtJB%2
zpc;>c<#G}`40P{x$S|dx$bYxkw;>eh!I@FG<IWkx-7~uF6!$yje>?y8$p41AUxnX<
zzry!<2&8V|7N10pMR&1rm^SwPe^1COXU9E||0c&jY;s>no3@wF)7G<lPjx%7X_nd6
zCpzm5p6NEv`){n2PMyUI&uBw>MrqFMH%B@_bTg(}$I6t9A7JxmGkg4&r#JNQD3~J(
z6@c~n%_IlZR+%Isp1kt1<5V(cN=?}^v#$)RbS7c>`-qCeBcl!pU*tAt5Ew}qV%QnT
zPKuL#e{{PKWpew`tGMx3)G1Jc{b!>J?HrOGb=XcDb?0I%2VgX<wd6FFo=K*^k&sE3
zb&Xmfz~KYITr??@qs+i|{-2z7{d!V^nDg|$^Me8`PfzPizJQrt9_RBCXDu{}j!xO!
zx!iYUS`m<acO@~0kFBVP{fUuYJnaA_Kdg?F>3NFNhAJk&Ffh%M%Os8*tuvq~=~)B7
zpP6kYv8i%#RdDi_g5i6&%@^XtEWKWw=SwdUYiG2FZMHpr7Lx?7e8S#~lvu9$OJ5oj
zrWcdf&0a1e#qNfba?=B_8D^&H6L$pm3ugrOR?_JR(TIehXF}3VKw29kkN*+!A>CVs
zczeBA#S~FpoP<9g$c!bbG`6K|4+S;fg$1)efWydVuD}y?Z%sOOEq1E>i&PsM4&N<?
zKV!V7t6*xoQxiKGP{7kBRTSc}5*L{?4s3T#eBS~5x8C!ou<`cq+&PBUXc2PB`$Mn1
zPg|WU;&{v9*Y=o<Rr`ZXMsFN9Jz8rg;&5Kma$3OM<?_@+^L?WGCjyMx|IX&fv~i?Q
z1w=Uiirt?~6Hk%b|G0xim=eK~P+ogCF)65;f+D}uIWB4JrgL<xZ{-=WV49W`-~8P`
zBEP@wX|ut{PAl<3z1eNI*@)W7qm27-JE+I)KjrCixl{r4EhArU{FJ38@T>kwe#J9+
zeW&3(FU7gx+}V+vX<?`=$(?g<^kxb#N%rx{hAH`eQ>=d3B(0|%2vKOp-&iLI_&1GD
z%46I>JkajH&$tHpfE&0;8X21lpm?l3C~0^uqPk=1+n-kTfNq*@-=Dm4Rn|7f8VDPQ
zAa(Qwmx`*k(;p`$UzkC0uH=-y)UNLz3n8rzig-p9U|uB8yzNn&^Tuk=yD=UUb)VmZ
z>W25QkLO7(XKfsA5~_&TQI+y+D;K#6l3*}U(8kzn-Ie)JR3&TwxS$e|OiOAlC@qzP
zeHM_kO#LELDHauY`Q#Y2U~x`l(R(%j34_HLh(XFBJ>04h;ew_OQkCO+*l<@Xp4U+g
z7#1jwT>8DVf16ND_r2|qQhpN`kzqDWDyO|9y=?~7@5x6SHcam%-`Eo-WH78|c`ucJ
zLuH#O+)Xn%0-?Uh>$oHDEnPUBvlg<!f(4-A)uyV2-WmwL-GAY^1vi>vz2f@M{*8wc
zE!3_H6m?1J(Glp%*$%y{@;K|5Wwhl+LwfWpF+HBQyDPM&r31;%hBts9*aN$k2W3ID
z2{6$>F&OR5!+V}KIJ7rLTF=PmAs4G1o*Xy@2J*-suA!)KR?SOZCkWNeR}~fSh~wfs
z)9l%~F8pUbXB%h)ce@UhFmBZDxc>56YN7{SN~$*fM+N|>Az_zHHFar}g7PJ1`hSA$
zg1o+}GaoW^q>fb3q(x$?xs&I<0!gGlxqz*9+ApUaE0P%&Qwqd~s%>Q8mg%1YH+@X6
z{1lmH+#1jiJv;i#!#tZA27)isUyJ+_myjppSrF$bSX2NT$8`N7GyO6Epa{G_n+|pJ
z6q}~%0e(&->$__*(}zH9)3=&Zl!ec_EhZ6$YGcedQCjmQuUQ?;-J1gT9PVM5LsSOi
z5d>)r0!b+wXhHPC58qf+^eALH817OSs}8FLdXq+|fn(rUKYbkDB-&gAus}IBBGqCj
z55}F^HarGi%8wXNy_fok8!lngAtFEw0%Hl1?q%2GxY<k#zJF-&bt-S>)-v74LLq3X
z@|HHfy(EafBzb}CI5RR_JKT$Lu~vKy!zd(7^S<;$^{4s3;*pIBqLfFKS#%7z1xU{#
zk?Ve6+eus@QC{5Ao!|s{ZQ#1rY}<Q?9KTsthb|)JN5u*R4Eyj1SGx^z2L0D&uazw5
zO2S8B`E6s6bS(ki-7_$?Y?L#x@$YrCZEeoydM_@S$k9Z1u9@hSG2@SMjPAwUh~U!)
z%WE{&lhJ)gx&r!<d;r#>_NlI8+Aa)xW8EfBUJpvy`p^l5FIG-MaZNUv{(lStD)~Bu
z5B?tp(Y2b}#EI?2zFEFW>WPr0nd(K-vG$QJisMYJBFmO4Mmj(vyMh5;vpmFTAuD;(
ztryx6lem+rkCew@TR(J8lt$J&+kMVXXSu+5!*cry*qVQ-<XIdjdDC5j3x|IKtCI+?
z-elR@E5fA1iWX>!&%ch17GG1{sktR=Mz5}9D{3A8P<9_0D)h?^gPa~+%v3SvFtxw5
z#eAZm4rTeYqb>C|dpHd_!9OI4Irj&gOpuR}@|W$`AI*Bo03{OtOyNvI3iaoNM0zYx
z@4i=t(I~#^X;ScXo8_oho?AgONC<8FAXX{QuR&;m@5_zg2KY-NhLvflB4zGA{rS6;
zT=Xny(hVkp`Z(h!ZWZ>lH9kM5yH%a}FR$T81&@A&KcMwN1<_5_-EV}6s&*fZe|!Re
zbso`Do1VXV&tEy^wzV;v6No8}oz7{^$egP?4b=D5@jRatR7RNH#CR`&-zBd5_MG{;
zOrH9=GjjHIuO5eF$E$XH^UhIUcrj49<7!y{z;-(FtAfYw-URJLPxmJFVyd!tT3MDr
z1cwJKe{QfAI)UPtBg34d(pTo3_Y=fNA$H#fN(vyi3D`p}&{D&|K12PPQzI5UiJcRL
zO5HnHjMKY&bzR`j`D)I-I@6h<xSm;Ritl=!Y>6znwUpE9NuYq9Yp1`K{5z?$4fD(~
z@afH4KI-0d3Y-Vtf78D%$6-fY9zlHyPbBgg_gjDjGU8BYBm{T-1bu@U6z~R{DXo;S
z{(k%@#ya^da?s4Z)_~WKqs;Pwx3M_;4*yGWj#g7?L-o!(O4x{Tr~!(x130aO=m6aP
zRwTbebh@SeGQd|&XPrt`AtuKIuSkRpgmwiQo>?CL23+%Q`VR8#M9(1xEQXw_AEPiJ
z;sF8f@yR;NUowj9icf%kCg1$grjZkD{^na>aUtLlk{p4bw>tBu$H7dKF&|I1BjRyB
zcOGc*O%i3S5{xg<jf*EDkcb}vyvyq1vR7OPmG}1#2&NXNJF<Hr8IBSZfQR5bo1@f1
z;zs|H0=|14{ODtn^p(^KlFHOs0ra{tZz5Liwa9xqqNso66Gc7sOpm#kZErvN{YGsb
zjnyGnfTsuV6ZC0ui0ghf)H2N<iK_Y7H)^-oFJ@BR{y7RYKWw+};e$&Ok2tkhT&z5G
z#6V$KjOp+w%dhvXIT9AySc3Ook(m`g`=?aVoXJ+RssEl&zhtQU#j`F`0-4}rizKjV
zXD+J68Ms<TV7d1!4FR#H6AgRiZNflTyu?}sC-fScY;B_coZ4b*;`p4{oV}rn54#cY
zK<Y{{!WT8^`0w*&pUG0ajaY>yU+wEYd+9hhB#EqYOKBgiw1iYomIf%O9|TcVyJX+)
zN|R}D2vJbcM-I50>Lo$2csvy49(QyV42Lr!v~i0m0mozwgcDlaEWgGz*ELVHT8=!7
zr(3pdBD%Nu2E@JWS9XtPpRp2?>2_ida`Gm>=$-uHiRxC5QH{R)uM}Ws0k|v8vu}@~
zaHu!>#aVr<;3`)nprw8nMWp&KN^Rejs4IAz)e}iL`j45=gq`CZabccEa-KZNU9vU0
zNTbdnnPpVdZ(@(+{k_@)55bGLdzBDVk*&8#Opo7<quzo5mcLv}C}UGIM*yX6SYA_i
zXEPiV&oh5zz5rpOV81)N-{M_W^>k#2<%J$xc}x0T7v?E*i!<cEJ7`ZLU{hg`mz~=`
z_xzr~?(yk^&!>IwL%k`ovT_Hq(<0)K7x*;!#fO|`QVafS{XIi<bAIAj)0w})`AG3m
zyfc5+Fxgx2<7wa}?gPzR5j#d1Y1f?)POSKapEj%B4)2(D><}<SPowCzmaxf3%{Prl
z;0qHy^ew6cj!d-v!oZ*>g^c9`I&22bYW8;BzqUOV`K9c>cfTv_jwmT1$rCB5Cs1ob
ztmG>Hz+Zn<?!6Lk#_VoPOm_eNPQJUyH`%$@U#{ohWlTP{RMl;RBp_QZAXqky=aGY4
zGnrZhxbYDzf~_fOj*d-kshaeSvz6OVY?nOC&=t<VNv~hb*duHA=tDr&1X_F*>y0*T
z*k<%?`kQZjm4rDA>VS$(3sh9Z{^ssKC)1)5L~DP@*2Z-auxScI3E=Y?2<nz0SNDS%
zHc4I$d&1Bzi}0}@X3-O^%6F1^F#HplsVwP@r&?IEkdE}01^?yD*<CMxlK&?^b!T`>
zw}YNZK&8jhD&Xg*q*aWK-|ZP4_$A7EJ%HY^Wd7ZrmJ#~D$<$)%%If<9nx|doBf}}{
zY_}JaO1`zDoF3_h)8<Jb*V*xy7NMD;_=c_H$b$S?oW9xwp_ibm4{Sof#B`ZX?o}O^
zIkD0pf{Wrgm3G<;gZ2rAXuH}VIb&K?qT?r`co%3$K-YilCK?9fegHhlx5m8ElbkZK
z(T$ew>iVy8E!15Xr}qOzT$w)QNC8D$XiQ!H7p3VE<ma1m8>Q|9uW2s5`X4`K`tPrh
zppZ*Xo0Apce~aK_3Uckqe|2(En0u3bdUdQac=y0D^+~jYmprK{;YSt^^C%fd(Wd5e
zeMmv@7^?s<EXaJqrs#GlaMr5S=-jS&|E~d{gGp9VR2D2n6?t`cHK<M?Gb|~6p?Si@
z=NZd%_Y1tnyA1xfv*Anf^ss6Z0l}t-!gh}b-*qoOZExUr+jVm>W8MvrzvK}>B41-(
ziSl8T8NZKNaH);Jw;!ZMy@V}PCH-kOP9!uGcf00^Te%M}%hgzkn-vhMlk0E9T8!Cz
zi{ej5_V59PnZ&>Q3Yulqect<_W95;DhV%3Gt5=wOJ$NYm1{^_K<We&|)B-U(zVijd
zRY$1(o`Nnu1j`(*kl9&lC+)K~+}ea21bevg|JXxPF9)L($^9CIk2O@p&n?bB+!Bgz
z>64QmBXvlx18kcazhZpS>88(;Ml@_Y*F<7lS2&cR1?<(JJzOtt@73dO{~|ZtYwFph
z39NkC-o9o+APxWoa8YZr_r6X%`)u&vojKS`ji~t42t!%qaKIIQuKW+^*hofhl5wqO
zYCIGmu=wK!fL%5Y)Bs%kL-c9W)c9SKEPDu2#M>P!jQz@^fPUP7NUHKu3dbt{u}KcM
z+u@i*Qs&h*X2R<+eB9(@OEwVW^V%O$-H2>oqQ2hBe_eq@49M%N;FsA+0{h<0%$Xbe
zr&<D!WHGwwy->ZK7X2aaTo&<<*jYYAo4G_D)*B=tCp?a<<&Vl5+MmVP@>ZJmvYE8x
z5U=0rV2l<;p?xC9x*ewcDCfm%^;FvLJj_;tnQviiFLAU)C$7mZ^g4J+n?G_+bOb9?
z?o$4=A*<ItnH>2^_j3omj(N1)-q-pcjyvwYv77l^-&nGwD3K3r+I2E|+VMi56|4#k
z#i63E;Nx#E6tURpd2TS3mq2dwna^)@YICspMK3)#rvN!dR^un%By7r>^w0+UhX~lX
z<hE_xN{H{6Hg<Qz{5oCE4l3-@)Lxb@)vG)f9L~_eIeEqHqz)~AeL9X=a(`6MeKFb$
zub?!-3DFmCRN2fdIc^?!Dg>{nb)y-ez(}T=c}S-Xi(B!j0^5W>RPVLp#RPG3OhGF1
zL1uAWCf`)Pi0b<sIv9<aw0clh=9Jy%I7?0v>l*4$&s)2xv!TsweObnLsH=wyzKj}4
zKK5C5MOo)PDu`*`Cm-H@fk<-ZO+8In8oe31px?*O`6Ngg=IGO5Pt!PYnORw~7rRu-
z^*wA;#@Ag{gk#n5W5W$Y=$pXXc514Rp1SLmV&&qydASE_-WF`D>|Vm909@5FOwjO2
zs{a}=q2M%i9Qw(Z8?NF|{*-E+-wL8=ly^KpjIT9o*<ity_10yc(-Fo-Qs0IA?}_4B
z2?I7~=}u(xgT+UO&cof$lwM>x18}ccR<Uftjn96IRwxn@lbYWFV_kiNL2@w19g-Sz
z(?^8`j++P0h=P>B@0gS@Gfc`H?LGZ;xfaL)3A5GWxj`D24F3M#FV6gQ|9(*2C)49(
zyHtOp2Oc}e72}dA(+KBQm0X=nRMgtfod6*3v>Q`YGT6rR50}o9<3*CbuB=RV7m9v$
zs#}wPwxCD<8%Hm^RxGB5BU2h)7$E?%$o%l_!zxf-&*nb7!eaJku3P{Jo$#B=IBm}v
zLhu7ImjBbB*jm?kdAiCJ+ahW@YV&*<>w9Y^Lb<_{7x-PuhvG0w@6|#99w8q0H!<J|
z5)MH%)c16zNZLtcg`!beIwSmJMYe#fbW_x^&>RP+hrTCPTfKtQY3l0DH$2bz8@#E=
z2L{bI{wY~2D>VN@Ejq_Lp<<#cDZ1tsM(upeHCr|Z(|_8qF>v%>`&&{rP~F$E-`R*T
z^{H<SIyY8FK}Zc9)*geK0W$g1Kh_l~-L+NE`ScEJ|8qJOMcLBczJ|yQVRkU*dpr)Q
zG=U6_A8VeIz+K9oC4r?+ObS09WJOQaLWT!avHl-y;WUG5gTjw;vcXwZc6*8;n99AR
z_A~jjg4{=Kz2ELv4)If4w?Zh@vTjvq50_H)UsD5`*G!9*Kk#EHjnR`les{hNIp>bt
zqjW#vWBerqW7-oWsTk`z-o|%+s6@k|3&S_3Ll&GUbF0#0RTB66x|Z^&5m+kxNjRk=
z5J2#EQYz$P`?XWBA4{}`CFcWgBjqrXPHhpxVPnmC*p7EaKFtQ&O#NOv)otzVnha);
zFHHW)uW0i)#wpWCu9N*y_H9#J5Mw8Sg2j$TMrr2?m*nu<*59D0o}+}^ca?=l?6q3^
z?k1OhF=HPMmk2PWE>hl?{yDrs%QWRYJg_ADBqWFS+r?dFXqr=rsd10Eus(Idc%JgT
zm4vPNB3h2jqf}_vmE{Zzk(br={_pZUiTmbGWbH@UWm@p#)ZmUce8z~}6DvPkl%~#G
zcCFWwCRHo*Ed6es4??v?NK|J*|Gil;kA6raD{9pT%FW~D!xN(nD#}&408rgJiJ+kc
zP5tzXUDqIQrUO2tZ3mIB7b#$;Y*&Xd5tt+b0*iG`K$q3q2N-9Op?<212Jq1r(~ZpC
zfAcWK;F4fv4xc9^ImyVq&ngmTo!|5dz1CFCFLo=F?uK~G&EuaOQ2+BNr}_j4;g<n9
z;S{?<9weh57Qe3f@SgvT9gzRYtr^sxU79CX9n>#aQ0nD<{y4tvQVa|-k?v^P(sym9
zp3xnM5zIVV0v81B`^rZ@9s=rKcyLWr>uUEmKU}#9d;uPuR10ljNu11CjP8O_-L07r
zfr8Eg&fA`<=GWUKqHav`So@p3T}iVkyQ|Dp4?K6^XvB+qM?zrOgX0zC+AB04-bD^m
z+U)2nesT16M%3Bh&7EPyT!=1s0Vt_S#pUwAHWohmP-Ut!8th#+?(bM9$!a0`jUm&j
zk7|;YfkTm7=FeRxmTU?lYiv^@MP9iSm%58xs{u#?30GYk<(tbMJnn$L>PT^oM*7tG
z6NH4!dnMyil*6&-)U%7c5J2N7wky)M+A$B(9m~~DG|8m6rt5=e*ET)uUwMU6-*qV>
zn(?dm5vO4sX!_JK4mN)vYTe)DXouhqfmBnn<1?(ij<yf--8-B<G7g-mRK^Dq?u5N^
z?9E7zgdIII>`;cs?^fi-vxL@ZM^2X&o6r}2+KUyWX}I}TrNC;L99<{z_m^=ZqqzO-
z#MI@+)`3i)UT|)lc<%8c@zm${(mD%xeySp;%kg+Fo#Yu7iXKC)AC>bbX61)ImIZy8
zR{}>fu`$)+Jj#ALVd@&jr=IoOqr6n@^lJoMJ5uca>(J=H2U{Mib{Zx+?`=MX<BJ2s
zejxb9jo*}at)vWx#0JdWm=!sGBa~|ErZ<?3t#5PuA8`1OWdvvrNjKkG5ycDCr{vCx
zxa8=EelmI^T-5UV^1`(9KfMezxG$%n6UFEk?QvGx@T4(ByZ_6dEH-k1_v?SPmHqm*
z#e~YaOfn-r8xRue=V#}nkPpA--%Z>p_rB^x2@H+<?66C$QCwx!BHRz13Ag&$Ms68O
z_5-~_+U$s`*<-KE%|-L@fz_}F;ZlfOTkiJpsbsg48kJbuiXd>2_S4u$Hc6Wv_D#E$
zxhSN@L!|$16F|P$s?9#C&tX~uCqO#Y4$gS->&f_M>1rzqXi30vt4pyQ{aXi-J<LQb
z!li*35R3|Ow=y&JrHEJjWkRmXA9?gASEt?MuaXUcpiWz;U*-9!)0-`<lqJD6@xa&c
z?2(IQXMD-vxPMkFUEw}8q0@jsm%<gIakqx|db8K@?6ZLM7mSOrM@Kn5p>v0zM&~Z=
z?)sih0atvQ1O<$=R}ta%VelkQ#QaE?ESni!mgaDzs-z(N=Bozs>M!gQ(G>E)hPKct
zY4Fz#@1nTnEQt57l1owCo}N?sD)PdV6U3E@>fGq{5N^oq)hfulA%olMH{P|n>4Ny8
z<=l%sAIh=|JM1=nq2$>whdsrGmoA<4dU7y|w!0TL7N@o0+=nx`Y{AZ2i<N)n$AtU?
zfoc2TIib;6x4QzXT#-P%#h%ANBysH5E?7Bu`HrU(&{rGTQ%`I_JHcmaIJ0kN+WsH|
zdpX^_L;QThppQ_<fmM)NzG;P@Ci1EKZ7{V8VglRdKnfGI`{Hi0#{Athn?TVJ3-@Pk
z1-aJPTnl%=*2(du|69t<T*k6uzi3a7Tc?{uhJC417xMEqX^-`AJmS|_Z$Y6QtY2#o
zgDxs@@Z&!LHoT=+M~M=I%@-AKS-2sZHTyTx5APk=l#NZo-2MKLOJ3!E{##x1lLar#
zR4R!c-5k%~bA%}Ekz@=kVZ7M)&={1(o1VT5vAi{~`}jqC|M=rh!ME=u9`blPM6pi@
zBb){*7<S}y%FwE4M|bkpK4`oPy16?O;x{>s9XSpxy{;bsfM$-YB17qZpDDOR7W2`q
zeub~@eo3tC5CtJ6TrQl8tYl{rYs__|;C8RMJy<PZDaV<3m_;BMf~{RMIN3j2X6myG
zmmX6(M^k)Cy_m6;=R+26g)|V=y`n5uYL4cH4&l~ClG4Uco&J!E&01@_n7pOw`Ow(4
z3(#bg82|M|xC?Jh#bbhSj(7I1fY3+0|C9u8UZ^*19Nb}4Y$qyuF?G=3`N3JfElDE5
z6@7`(1qEBIVsWl+#toPoTl{9zUl;uy3+H$?!Bv$gZr1ca4DtX!hg2^rK84SLXhs9(
z@z63rO!M+%C+U#{$O(VAkL>>UbUB*UUKh_n!>q&eU4d6Hz40<tU*auf$12EezNq5q
zQV1jGc1BZWdQ{SPK&f%i4K>w16|dQgUUViiXP14?%NcUponO|+ChML#+YW3bU=oPa
zUodStnP>1p^B<L_6}al8yGWhoUs@{DI#ddlz;Hn6C`{L-USoEt0CYb{TCMiiBa?Q2
z{JDc%hHGB)A{vwUA63EYV(IE1p|}q=$n^8~0BUxuWisU_fFC;+T8nL}2TQ1LyJ=;V
zNq9egwV2wx3L?%;b~MU+h5b%iN^Oe8<~jj~=|*YD38bycS)mcFm~2l6uD+XDV(esJ
z62N|e<U1FkGI@j9S)LC?DUf%QnVTF2#$X(K@?iL5uZ}Y6TJlPgUhz>s%f^5Fr`v0m
zU1ym(4wQo*KEDI)F1Te5*IWHUfni4lkD3mMV@Z8s24^Q7t{&Nyz1db4(F|P3uIyN_
zia-+e3?A+hi(iWVrqKEHFf_S27K2-W)%a~HEhMjN^^-y;t;zJ(M~f13|F?^cKa*o}
ziexF&z0Oc!W1J6`OamK&A((E(p4=0YGl~qYRFV+^>p?4-yqFsxyw-hgChOFzo~VJu
zDAbNyVqB1~jQ?iA7x^jIfy-C^xe}TLbyn{$d7{a!L*{|{D#sT8CM33)>1Er>P<Ba;
zO<2ifL&7*P+&v1!(I1G5tr;Gm1?X1)8FVhblXYWG`fN2!tBCz%8{o;hkAGMIOJE>4
z$l3~-d?{-Ajyy$gJa=?RTq;R!Sc7s&E@{YSIbGDyQib38k;?xWAQW01YJt7<QT<)^
zIU8mgxtY_8?2Lgm|B2)U0MYjv*!?^mTFfG0*4Pi<I|$sduLEAwH~<N!=rJHjm1e9{
zgxHPS$KzR#=AJCFpMKuSf}>-Ax#d@bQ_=6YmvhVO$Ponql#^69y%GJsV@^E4i*qaI
z^K0cgxWhH=9cd(h+8@qn85=$y7T0T{U;dPW;MKU2yK}dD{2TOrHj9{zyLfk|qz<R!
z`%@l~<t=(9f+4-S`Gb4BKk7dJdy*n2^Si|QLu46K)ojpk>FiFYogoyXQmI#}=fdSj
zuz4UUzUyT~L8;)G#VwW?nqI{F^EuXe_fLKPwF)~x<FKS{HJHDVJJwLZ4VbKDjz3Y2
zpt7(j2G=sVT(0t?0C4_2FQ&u^1H-yI5;lF2RWqiPuM(wwq+YIQ7=dMVR-`IIiSjt#
zA<XkX|4z?;+b96Y`9pT3l1?bmcCBl#;?}^ufB~mxP0uRRzOW(fk_8yY<wWRN!e+qK
zr3-pYRe%0_$?T?>KxK<V<`^m-TD5mfXPuuL<;;y)rxefxEV0P)<8ib-KZ5gO^C_Pp
zJGn#(1Ue6~lsbLn80rFIsZ}hcF*%-%X3b_!_>;nr@6C}Ou3O`EHB&>c-CI?JzZ_IE
z=F=6{7CggVV}bK}rbb}70?N)g=ftD1ZXR<SC}Q0?{@|Ty#-?7+M0?x=%sD33!)q&i
zY$`~C5rN!jHz_##qyU^bJS;flfKpAeUygRVRRf>kECAg<K=&?Ns+@3Dt>Tr1-Uc)u
zP27cPJ%*%claZa!d*Emxw@0opL{`gLAML4=K@`uU2EKCB4tCid;03P7l+8-gIT5DS
zNktYk<4Chf5jd;2w7P$e7fhzs$3&(qzJZ6swkO{9=djp{T(wHB)HczdVdX6vP&|f@
zH(096D+tKDK&ynYM{VqX=Kw$}e2EBo8T*%W$5&nvY<)-6ha>c7J>C`0gh7pASX@>k
z!|I<qL_=J4WcPqGakK?Ri(8N`dHD7}^BdEMb%WBUYf7`QgSCCVvS;yW4Z{tZFj_M)
znf~j9enJLF-~*}s;L_P}poh007`Js^9hg8U@3uM0oEw`9e#lAdi?5UBjh<cA!eYu+
z_eL5-eGj6%`0QPGZBtWkv?VY=u5al#+!x+)aOqlHW5iTHDL4?d1-ZPU<M7G-^Vj3j
z1eVm6$Q{qDOgw1NpoxEP0*r<mJo~MK`K;!zU;YGa<hAaES!fsSCsjpjZ#(CGaJA8@
zLJoR@&6ku^cdkQ@SdjanIhdIHbZyy^y)jOTMxFH~K-%bz;i<i4Fqq>ZWy7et&v1Dx
zzx>X3!>*MSiyimywRiTH9vfd%9hsskH`C|kt!<EGoJ4hF(2mJ726Q(5#=hW7)y}ke
z>PusS{Mi`(Du#{h1&13bxm(M~^i!YRpm85~<W;ul7NU|_!F>a<oGQ0@Tzm<plf5Fn
zlNftc(0IluZ#)x8_~WJXgo~Hp$kPvt(Ec-+Ne%2t5)rfhUex`eI5)lCcQRi6Hqb%D
zt7MYlL}N^F!%Es+Y7IkO{8;QGPau^pl@(f8fUA0^H1Nuv@wtq6<0H$U!1vI*K26#<
z<TQt@tCP)g+`r{1@L5O1U%No^F#JieG`8k!v#!rn<XkUtyB7WZE|KC{w}`o!mU)&L
zLYRGJqP3x;@}5ZaCO9@AV{r=}qs<=XmtO{W3d>4->CA-a_&t)KDXmgE!AP4^D7+%J
z56}%+NYieTl;DwR?s%m}t<f&rZ!$g~e3A|ZBS-E}`O9JNe=f>!x!dapCJWSN@`5Eu
z^tcnyg-yR1B{hT!d+B%14gt;GE9GCE%io2=Sull$fwa$=@P6h4AnZ-PkvDf_>l;~F
zIAvhH1vH$c5g85*P9ghex;ynJSf@@u+Jz@*rco71ypn9oKBrYMVf<HYF~68`PN55U
z&zEG(?qUhd4c)WNZ@tPO#e21YIQBzd+VjOc$#NY?KHP2ESbL-spM7!!&qOmZAoq0!
z6VbC*!!LRNTwW9IdXb?ID4iO{0vw$639hxCav6WX3g11p4bUX57(rM(W~|C6VXHO|
zY%kfHrnjamiPPXn0C|ts<plL@l~(Wc-w1(uVufQ9;^CiJkZ2aRe;RaYS&C<Y5y)@5
z!ee`Dhb8lKJ+G|FHd~>&5y`g|JHtJfWj#x9q&8iB@R&dbWarat_yYIn#A&~xKJb0V
zq1YU?*W|LKo7pJS_w+}R$4p9MKC6_%4B$<EYV`Ag>-(q7ac1Z=8kMU^5-O}AM3jmr
zGjJRo3+Qbw<|fN=Y3XrQ_n&4q0~lzcuJDl4Zt`_=6oCGN*<d%0?SY{;W*xa%NaX1#
zMp&d!<2%f8<Ph{miv+FpwZfru8*7bivTYa~aep``4jCmRyyel;cAgxOHv0`?a~>#?
zSf@Uu2{xc>OVAQIiq9Uf(Iw-i>pNH!Qc~ly&`6-U!HrQ$7oyeHNd5sWNTacm^Pi-F
zKPHN9vkDJP>Ic!cx?@Ingw}0jEMO4$I}D(m@{_Adb3`nQuo8PPMi1lgX9|Pv`^b|z
zT(6!(#_(r;^Bp7d+x=efx8j;mD#~_-`>>@iy6N|~&P~7hE0y`=s)=I{F?41680*^j
z4oQN~B7!Du4nd$f!Lyy3o2)Y>bGM4195Km7qh+ptMTiWb7_^yDh8#ZEHNlX|wwg~Y
zf1ao{9U70?letRMnU&mA6OHsF#odfif~M;IVga}_(uVp%dDJVDm94jV`|&Meey!f-
znT1HNXI_siZ8amm+4kN9GC=w;qT;l+yKz<U-5oZhMEXr2OA7x*2Uo1_0Iw5K;|qF}
zEVW@#`Wn+p=ubIUq51Y#4f(BK2r})7l)s|z(LlqbONENrtJl%X=;-3q|NX18^8u%B
zwl|n4h8}o?M^bL_uG)N(q-CNI<geeuw<w_=uxkY|*+!jA$@`ebA6E&LI<7C<UqWDb
z6iqOCzC;&nH(UTd>I+%AgV>GgpXdkewNSCuqlkgL^9`Hf9#WOE8KP%3611jdT9=0)
zi-F=f3)|Dd3&L)8KxU)mq(>2ky+CA{|5bK#HxMaumyJ}_^H^I*<hS>PDM9X08nyg<
z1`lAz;^On}?4Rlt^l7`ShnmKLubxDEr9mPHqfg!lF(%kf`eaRqh^|x}{!d#JmPCSS
z93X~Kl!+Sj4^B-zcKc%4l2cvEsLC6|N0|W?2f-zqJ^To_iL^&`ZpJv|R=m{B2MRi*
zO4?tzmdBs9y(b4}<OhU-wi3sMov-2IWGTC~2!MBY*WcC|8z*aLaI?z%#|J|scAr+$
zwn)Qhg6YRV0cX75tRxJd$EJ?pMX!IQJ_?^$5r$M&_KO@1sYvcKxEFp~puV?F2#M&*
zX*O+<L7nBbv`De+1<m~O0ZZ$JKU0)7VNHKug)7?$F8E3OSCr%T=*Nd#GcbM@1v32n
z8P1*6RzHpAYNzWSy7L~TIYtFT#pCj^KrIb<04-+G!^AYujZo#?GlSa&8r1^<i`NS=
zYsZhLHTk<xtGt}~-*UdoD2r}S6XVW?@<Ylj#LH2v|B=_UL<ca?v$2P9_7i)o1y&V(
zJhmc4u~LSa7$ad`Wxy}5z5Ba$zeBs#g6z>kWAUa=Uuj=nZu&x5oq4W+rqRJ}(zkO(
z7X51}juln6!otg_l9Fk8te`YjxA~W#TCbmY2kUuie_hP;J!S>bwznOOjEWTF1OPN~
ziJ=efSF2&5urV(?H&OBvBpO{YgHJT6#53M_6nSl>HH(-wU6qb?@@c-*g4FVf<&6eu
z<U6zji~@a2j~za$-C#rC<?u>(j*9*J=B;Sa+Oq@@5B=ZV4{)Uwm3TkhXO7bn*VHhG
z^`(ova3=Nrz7tf-s>HD#uq8}~CLV|}HC9`+Zrp=%^HeEU*tz}RB9dknQKViE3c>-?
zY09;V#}!7TmYd{846A&3x5|4sNdxg7ae!5uDE>>V@;Uu22%9=p;_mrx*=cuq{F%+d
zBLm8lu-zXNeb#z)Y&iUH_q6qD`{IcWCfK>%pZJ6*Fl&c*E5844TFR9DR*CqS5`ET7
zHoi@J1(<oGFS+Pq1+I;Cqygx^+sU?$$v=+OU*{SR`XLju-|l6lDe(t<bcppFcLZX)
zdQHC_;0{Y}$0Dv%N3Y_eS^%&iEW2<Wy*^>IZ9Y$!(Mud&+^xvw5qNMZEV3l<SWTtW
z3vP??&}6@~JXEbVL=r>TR-U2w{IWC#dwoAaT2_YQWn)Yo!3xxJQ$q~{<)Dt)C?`fP
z6z6&?LS5VOT_560e`oLBeHHQ0OxWJ9NO6Txy`%zLf%qP9su!3~Ph<x2G8mWs=GxCc
zZ96$P!Inknj_D8e_5Q;fg9yt)iXJp|?y`2DgbDD^N9{Swc(0FvI5oIDvcq?a-};p(
zdxjeuhQUbwlXn)6yJxql@j^N3=bGJ|%&7ZuP9<6=)+C{C*|y|z)%YmCwAQ>7n3V}p
zEPeUWHtv+}hm@`+_W=-x?1_h8<WaU-Zl*K&5A4k2-Uh!u$nAI$ssO3xlXiv}nLJ<i
zZDM&}d(R7Pocxyj4`oBK0j*WP&G(HX%1VPt#o%2CrC7SV)b%#jm)A*Ah?EEOSE$9l
zEU(gi@Vw_i?s+%4msWZ4kV`KIQrYzL=1T1U0pdU%zfnt$-_6wy@Hd_Fn}nOu`Az&O
ziB-bvL|wm$KY!kDBBxb!%j-AsC;R$M9@J?H7r%ZJF9)vQ#E--KP5h{@-^9<*S8sEg
zlk=MdP0R16+_d-jKk%@RFCO=Oz}-0s8sx>JChG7zt5`M9R^a+g{Cau6iT`fbZxST(
z@tb^=-=_i=eXbGslK+eNTLJ6f=<(I0t_j>C8ka_iZq7!W(ubvMjChYMUAw+k#`^h>
zJug0qbmKp$n1%k7T7v>^lj`u@4=#0=1@E~XTxzhR!WNo+81I?;jY@5u)M}4fWUR1t
zb<tR1>*}IxiDj$WYH#75(>obgO?6Rps9w!7e6KEwq=mZri3o}=3V-}A%d(hN7maAB
zuw}T@MfuIArk?4dZX7`ub)$B=sGFhFMPr4ntBb}8TUQsw_E=JZ*1ZL_iIV1$gK$_`
zn*%ApJgnRRRdqkcC4R<uQ)vhs=CI*Y`jDZr)!0l>z@DXp(yHO#D|OvUSa=@!w}R72
zoRaG?(E7N}7OQLxlD4h$IrQjL!RyrIdMbFiT3u-(tjXvknUn-YyO|{wyugiMO_^H>
z?NfOSO|gsMt8sN|uHZ$M-lJ{D3SQSnjupJF&OW4VXpV0|V6=_Ph~83DiY|;QRU3GG
z$lKHkUWnM~Y(Qq4@-!)>rP|EF_lT&k;N|d8sq44OULHrInr#)yT!pKE)7s|EH}JuE
zXSJ25{c1(qPL>?24dWu={Ai^u<O-=b2yGQQe+Lq2q?{DZ6I+<lgNBM<4(G_RydxvB
z%e+4J2(MCX9HlDj3v8=l=LCgKw2IfNoogKN3}@9yHOR;HqvDsKpB29Z|A}(uA9$z`
zX82nn?BEl}OQZ@nx?2_#m|Oz^vSzojH8Pn{aYe=m^3b%Z9lK`RS0E}p)>Etyc5Sd&
zA?(^<Qnk;reC;jVAvaqzc{lEDkNc~QlC(N>T3Y1-w<7|B8Y3km4IPlf%{$S+gKzt9
z_p#p8$gs$KtHqnz;S*sUmiSNyTOG;)SaWo(Nr@?F2L2#(NKR&#L~6AjQRum=^eH7j
z)>B-mYlFp=y*3#9i*1ajk|_6DU(2H4nd?2{3-_$`tC51aw2}~aL|>9kzL{O|)Q!Z<
z=`Y8FhT4A@|E+f2uefn3U&#@0bP~wId35#l3TuW*(Atwox59}c`s~h2V(eT~vX-KL
zWF$hUhC&C7IrzAmxe@q_hFXCK$DJ{kRjb5RBr=Ia+|nBsg&{PK4%;c4<XD^}%aTnB
zK*|hBC$SX2F{DCisGTV2-w%l_xJu-a#w`EFg9JA`N)Cska7f{Lnn<H-Iq9h)8PW7c
z>SPRV-6?df>ssMFq^x%%?JB9wxKKsnwW;IHcx~!<lU^MkJyv>MJH7>Jw%kZve{mMA
z)M;^k9v{-0Ra+=oD<w`YQ^mRk%v`M~JT%cJqJG~yJZSPBN0JO_(lQb>o*1J0EZUe|
zMqRRamrxih74?2G-jdcR80fNQ8dS-BXT!By7<OT|I)5mIo=ir3sik_J7dgw%H(@?u
zf5J{xk7k~U>mPzoNa}2`@}ef{ZAGuSdYcdzYnL+->&uc=JJdgGz6Z#quKo`1d%%G#
zr#_zf9(<kK>wEBZbstUM;pThbHy2|Kn(x7lBlsTNsGaY@&Cu8Vb(W3yJ$OsV`yQZ+
zv^E|O2C^<lfN6A~kfp)9YF>*X!T3|(-><ch`T17P^JaZ6ZX?6iCwRnTd%PZe*6Q$d
zc*j$^w(;$l`%o@1m@oZLxJkj_&4c}d9`&01xBFP)U?^77cg#2c--F*c*k(DoHR5G)
zFtCZM)?4v$FnXbsa|m%T5cISfs?*M6EzhIlKearMj{mP3pCo8LYQK0q)@1x%6ZFBa
zO&Dv1I{ePc*@|ujTpY};SBQf_;o6d?=Hg)POSm|gL&HgoxW&QTcXM$tH;xbobE9@~
zFgHWzHHfuBkMH5B6?%LRT=8+7Tx@*{szcI^H>?he_#RMUl0@>>(|mjnT#qvEe4={n
zdsqcN&3Y=Xi0|P+U9HfIU*7}2xg0;N`X2l^yzjw}`uZOH4DU{OYK0!(!&58t?5BU#
z5G762qHJIBxbJ_dIU4bMu3{}xhu>M<Q|njY#=-o0`8b&WZZ{6*zr>A$1vJzmb@+*c
z`R{h)V167v4(3OF<6wS<*Lr$tkzN}t)*`(&m^&rT26HFM#lhV93vn<f2V5M?OXM2|
z`zF6nm1Z*LXMZKT$8Q`AgxFH;?G^{ys1hJrN{EAjR9lKwW3xCI{b8@1G!iPVhLt)t
z*t4?72E%uN|1a8L_-3fW*X<Yk(ET@%w_@YdI2gWsNm|YI#KA(v+7ky0=u`Ff;3p0y
zZ!SZlwi*ZX<M44XKk6F?^E31ne8b5*I{R}{kIoL9*1hL{<Ke^`{z{I6JKZu!Adh=V
z7VtYOUpe`%z|}?ldU;*cf48fPh6>I{7Y!AopDNG}S6$S9x2uc#ad=(SkNWDOeuloH
zwY%xOF6wVauZy}<;wy3A6XoJy?)-%~7@yW+Rq`wj=1#VYgGDq{6*t_)!JHg$aWFTI
z5C?Okc5yH_Lti1?X->|z37S^efB281JAKC=jm_{^^K-a6CqaX}ws6!$9e!u!E7RW<
zaB(oVULg+VzMG4Kd5L`EVBh5TsWM&a7Uuj@W!msiO*-ON7mHP?FCME>2fX%{zCG{o
zP{rEtw~F<_(Tu*aRK%|)sq_F-tCupRigj&b{UGr@NzDnaVhze6uL08J3u{^M1vSY7
zM*uD3K6tBG3;I{9SSPUx{nH6~=k|0Ss5i*fs(aa^*f{Evai9YA9+KTKm|jz*UUl!i
z4Vz)v?LnU^)&~#Os(-6)9q_9&#;Vu9;qE;ZGaVl{g2Q8#Y=>Xnt4qxH(Y-ozp7Mw8
z)w3nJizb9@8>x~#HOKzyUa?B{(Y;U)8|=_WQ{xoBWLaIN)j^of-sU?FR0hCR6Gu%b
z_@X_|(4$Y4Y{O$U?BA+q2mF4YSXKKs+`R`?IF|MJ`HqJw+z!9zjov=A`lmZ@gyQp@
zeQxKiZm!pw;(4pMN@p4I1jQ=c_q^4CVn(SvPovJ`wx{j95ejczd(T^CYPQ@s_q=(D
zc+cB6Ie8=~O}Nf464c?SfT9(_a}w`pN2_7(ngVq6*0f$}noGNnRJb{7(poU1^*N;0
zI9kf+)2G(BTPZ{N9k{@hMc|&^tZHw2Gpd9#+P6fScpR<k4u>2Yec7l{!64RN#|(??
z@PJ;)<ngE8`@#L)?00Oy-Ohh-t5yFi{+ysw+ulnik6+CmWnt;FMK&BaDNn*&2sQ&4
z9dli7pI8{;N_ef2D4DKJ!w$e?m99?@0PZ<qHA@mw+ytHF)W^BwV3$yxkL}`n5!@Mi
z)JrCZzx@vm?$_Jj5CL~LO~6r`W$yMbJp8W1y=02Goi`K(&b!Tc-U!|7bbZbnD(!F*
zM>ua_%9J&BJV9O)@aGK$-{{cx=jqB-lV?0{T<%TnC4b%qf?%gVfSotro8z9hh~D$&
z@c-97A>PIan%!^sqam8y`we&BP5T(swzINF$zJJIs-TkuSj93jQ3sp7+k)4!3`h3I
z!Q~V%p0id>hi-N(9HfYB>3h)FP08~brA<ZmF4;0N7d+}%O=#?NP;}Mk_UhXA07c3p
zpa1E5aQ&F*d(hWt&(o-cR>rV5Bi6&64Cp8udopveEq(_=n=5S_b>cogdxD=gwf<dc
zi8YXofM@HrPV_5ck$&rk@be#iUaEx1dau(DfvoD$&-d9E-&$vl7gM5CFYfy)92^=E
zvpBfh0!_4-_B7#ZMPG%{tJQa+<=49A38kUA*okOnxHuTirHsgVc={?FoezB#NK?1^
zaOY`!9jQ-G=pfyp3YxWN2BdJwa>~&wfi|$!1E6h}w68+uv_D2^>vPq5vJSU;MYz4t
zl#ZB!=W*~R*-(N@wm9Qwz2VX<63s;&2Q;<&`Mp2GgQGmVNXpo^;Ws?=d7#ZITow1b
zYk@B(dWavV;HAuGUV`U3{W>t-{=3Z&hE<!WApx|FbGOdLoygJu0s8v+9&Kq)hsyn2
zi+#N^w)TaXrzezY_pvX;wFS@@0y*W+(+T;NZHFC)z7S-STix%oKOxId>?ViZ%o47S
zd29jR`2qDe?t^m~)}LSG<dLALZ2VTv2{>;0%)Pll@XEs~T+m?PX#q+b-TdCI7pYEy
z`Pbd84te4$kJk{@`yxl?S=p=0EPU>oAI)dsS}*o3(I>tO+G&&M86r(@>epdK%1&JE
zoS6u;(#}&2XQ#Y$?}(#B=DoZ6^ZwD9gshij^)QfUA~@-Sr3%-AOCh#>@FltiZ^)u|
zqCY_n4<|9;;NW)2=6Ug{rOMs!LcWklS^XL3*Ul~H`I(Df2gT9kxZA2RqZ6_&jcnE8
zYv-PrKzncLe2<ZaNl~($>|5u|m2bFb%}6mL<(0%|UvNJhTt&~*bg_}P*Tas(jesf>
z_1T}mLC=l5nY;Cn%5m~kc;^Sycgy%kC!n;u;hh!lAH9W(^p}En6uAo*&&#q0Xur0L
zr&G0d57Sr%<kL`%rEQUMgwiC6=2_6?!?7*W6K0*J5s;=^B!Wpet*zCTD4aOYx&{fs
z5<SB~GjaZ9?%y=Cb$dEbLzD03ji%khu~BTW(XBcKdJf6i+U(37*2lSXx8TLgwyYOp
zC%6hq+QrE)$<?%*-#b@f>iews$R-iDax~=o%!7Y)-1+%MPX2u9#52~I?Mo*f!GAt*
z*P&-Yh1<#%OLOZl<LHzkIRP}uUW8lyYeydx6UtJJn4ix&W0Z+$(nFlzzsA2h0DYgA
z&Uhhg%33l00==zd#yrxh*$5>5i|akqx^`Mw6Oq_EQmIG{F}GEl*wE|B>F1G5)^4Px
zuc|c&=_8f;v7#RLGYB}o@k}4@`8F@@g+%)~NtOE83+dvq7gE5L|G*t>npSf@{0E?<
zw^-$u!+$_8B(g|Oe<R^Ppchi<sl?oirx(((8@Lw|T~Yga8qD;5I;#rL0X>f}F|}U~
z&w=|GwcgICndbnsZ{<oHp2LHNUPy+Ao=3m+NQ(H0|3AHx9G>B+N`arlU5H3`J~2q)
z1puWjWxbRSF902m`p|5_!wUeqbGQC4$_ohS(>v+l$8#%hE{~VjkHh<f{iv@8+0W2f
z9<g`QwNqm6q{9n%_VI7{?X~p2N$%PI{pbDV6F0{=LF{^N@y=C?bM$I$&friVlk+`c
zy+}W(+wNudJ%tWb$M+P_=Sv*?#LeZ+&2qgoZtln7<K}+UH*W4{=sR+Soq6Ks&rUvZ
zJl|pLAGkXat|M8HGy&H*Gtde7`p3tafzr6Gd&G$|LmogijQN(3DSJqDYu_==NgAgI
zaF4br9SZ!@$mVM%+ccgG6m{K|V|n7q*lS}5H}=Mpxr1DmN@q8o{Gd+KT-@#C-@1u?
z-`}Up7>%55=C{k3;cu6*gLAbvCgBz)QHs}ogObk*E`GJNtns?N3Tw57uVQ%4(szgP
zZoPH)N=3Vmfuoa6qawvlyKOPv&GR<bYW3o4Sw0_nM;X4iRB3?|yH7rRHN!==gOBR%
zVrF*@_o71emHa#nUt+O}6LO1jmn$h{7w$ail$9m!b8bjRE2plw+w?_47c;{V&?{V(
zA1La@DW`)>k*QtG2K13X>_J8k=+g~s(Bd1O_dMOe#*_-_z`4TXk90ljN!~NK@Xp1*
zcSFPW*8Wd;KI?Zt&xj_`b|e~XX;X@h3?wocMY%BvI(js8NxOLLlIHLUvh~on*e{~w
zol@4__)r?N&n5k$zI9J~=FiX9x!?8TDuvtOy1rcP5E9_v`X0hjA6;;%YN**ww3FC)
zbYB`Weu$au(WeXB!Hv15J5FytW4VR>={Rv=Hy;LF*!kyHeY>#P-5gGpfBK$4LXnHR
z{)F?2YVf7$cW~#M@zmNY4}fz*!6QH594kw^DLHw=_?+G0IU6qi+#t<XL6vB}2EC+2
zC&j|fop16}dS-z=S)~G4l&lWl$o%0CP_iafRBm~eB+0FCm&&c4#nkIcCPBaVr^EA7
zSCyZKRj(`d|55fOyPD=Ya{GFUe1hAWhqV{IHu?#S1lnGlGHl%U2doHE5~=f_>}%8}
zEAmVI8YzlHa4qz%Q=RfmY2)AO-|g>PzcHTS)`46*X0Oze{=D>1aj$EBo2lC8cE+}8
za36J~7e8Nv9&2nXqC`0oMTVp9fE^Plbqq(})lnpZQfdw68ISH%dwEcIQVfoyN=Z)0
zu+OBSr!8xl6nLe(@ODCL&d3M)FX}1AC3|-CZ5`oA#E>L{1!Q>2w5xb2W#eH>O5l=v
z0X&Tmx0DM@&C_hur9aVVjM_CZN6oBS4bn7W(Yr$(?r(U5XGjnx{g_{5bx|RSH2njw
z`v{|L3A)DvypNII@e|)C&dgV3{^5ul|5kr<f3NF-@4Hs-(bbcD@pa6ml)5%64X5#X
zn?Ae6->eQ7O-y&(=uT^M`_t%nZZ{u|(CvI%>(po(SJ!l>%6@%MAnJWrQ3B0*rA9G!
zJ<Xr$xn6mI@0;XjIr&jLiwA{`f2$XJz8Cq#?`vpVf^KOBD$tOq?i$I5Jyb{T59)6C
z5AySC*UyCY>WQ{?xT}-t@f}N-pL&}Y_w_anj-#K4Yll}v;DMDDX;R&F;Ef!D+D4E%
zrxgj;?phCG&3cHV2Bit@wMUIUDm{rPFz8cnbK`Hl&4a@wDV1&ci;|DjBeZHMB8UD(
z$s=EPKWZUM+vHY|Y*>_T4cuxRxfB6q?x?s9e7#LUzt`Io{H<#E)Zv7`Km7rJ>vJA_
z+aF|0?K(=^{y@cZz1Mc+$F@JH`03r{C2+IOtemq~Yw`6tuZ}}b@f7Cs_0m9VI@LT?
zdjj`J>{|o7x)%1}(8&C&nb{qFwYX3FUMtGBe?akh7#2N#Z$ySnNLHn}Ju6GvmGR!S
z2*(H#$6#*eHTJZo#92VznYwpA3xxDtGiZMe_F(9yyXD#>A#e9UEG1mS+UC}2#Zr=8
zJ=Se0@u<D+4es}t!&g7j{IFLq?)SXG*MW-?34d^^a>$*oa+=`topScd65)FGmRuWg
z%LdRzB{``}I~bb8982M>FkLxp+K+>}il-O%6;BPG5yVz^LU5PJ1q6#`G3v2@bJw`<
z3<c0yyi2H*ecKHwWyX=mr&^$sq4rj@GWSNyyt3HH?z@A3!kwqWt=y?H`_!sExUMMp
zVI58dYP}8R-N~XXSrzsewEh@M{M07*J?3CW@d?n2v!y1O+%=PWoq1Vuhu)PlxLY}k
zR|KpiZM#j0tRb^*-W6<j|0;Mugrnb$hGyE?m4sxE+*hzQwQ93w&*i69ZPv)y7k4#m
zx0L<~cQu1Q*S!6_p1RWJ?Aoft2KT>g@Eb|zM__R~6Am9RmJAoEM|4T`&5XP>&7eD`
zB5qXB9+FglqX8k5s2S`_(-N(Lc?dg-KaSGcgE~Fn;$9ChIJz38?lyi=Y`35{SaPKK
z{t4fAKh=%*XgY#hh5pfuyhD=?ZTcN^&{q%G_$zaN#!c1Zwbu}5AY5mr>aoRb71Re;
zTN-OqHsR;Jb~m8w>fV_~$4ZB)$M9#n%v@GI&bQ{e>VQwx<6|vk?aUaw=E*vnP<{{h
zEgwoi*D>xYF}G)m)jF5%ee;RonIZ}fmb^y@&(w>$s>d7mRgZtFhK%U(P?RfW{lC}|
zP$fA}d2FJv4OvV6R6W__+mrQHRsIQg)t1+rJE@N=A-HAZ>rUIO88GH#slwdm=*oQ4
z2I`lv+HwqSvrMg*TGZ;ok=tHbGh!ws4bXM^_9eN79JC5^K;cJ0BO=~^Jyn=}bzwYn
zg6H0N@V9F7!9n@Wf|Ni@kh=~A8uElY95r9p2^04H%%FL#bd0J^S~ndoA8L1~8;khN
zC}>P{Q$AIj1=Xs}xsLRHjX+Du_+iVu@PH0fX8G0+1Z<RD-}3Z&AOj(XXM_fQsy1)@
zt=jxkHD?4PR=Yl5QlS~5FFdO`Y2FCW$|K%f{4;K!NWNs6epkW%m&ay)+&eHKPFmHs
zy<c}5Z}sP|Z}>eAzAE%jxM?TBLcKl2OA#0{FYrYT$uz`y4o&P-f2uCM=59Y9KjLrI
zX@hTho0vb+hnKhT?Z=$AoICP1Ava~5O42HCVT~HYb9}#5r?0$CWOA(e`FftJe@5Pd
ziy5BFSKemi>S*lJmA7DV&03B4%3F_`s?!&DRi{0^1fAGpBJJYJEYwkaDeAf*9j9dV
z9j92O_M+gz;ze8{zZFk&+ig*Q{Fhd>Ugv06qy~vpl$99kigNz*x2pAd?LJklw^v=H
z!a8UE6%5I;F4dih9>f*_GzE!mLBKfZ$E58K)vmt;??oyWOi)2q@t{DOEp2+UYp)jo
zmJ5<ki-fwKxGLCpJiZF{9S^EtN2%CmS_w3#pE_o1nVQ`Dc^><;%s1NxUUx44TDPKY
z125;bA5qd_>nlxUCD%X2Z+Z;(%l4ps(ubtV_R?m`tVen^1cd%Azr3CcJ0E}Y`L8|t
zR>%8mf1h&N-^20qB^u3ortLTSdX}(;ZooV8iE4aj_*es;71`csu3uTAwEI>f%f=10
zOSBeQsTDgZ9;R|ckmkLU>XOp>E*$)1@1&aM=5!Cess_<uMBSc_)}~ZW?}*Ks?dgd-
z0e3w9#N6>D*lR`$zLf;?L%TCbidmrRy!2@2`}d#g)GvXR#{RyjM9<KO`ZgcVhKLZw
zdzPwwULrBOOt?mVz@4P`xI|(QjZIecL}F0x*4g%3e@9{vM_pBy@lV-}*dK2lcaq-N
z5h&4O+FZHkYZAWgyG8BpT!)$u1NXMl17G@lP;MKw>0>pQY-wkNwEsWomGlOGZ%Tv1
zFdh#cdR5K3rQCF{WZGRd3TLTm_1yHc#OWBJziR*ncbbI5!&G1Ai-)|qrE9Oczm^uX
zr0U_gDKT}?jZphh@2@E-d_Yqb6F;TYy5g?(R^>Mv>|9ATz^aj+16Mv%dw`}PcM;|>
ztDTm3R(8Fmxhxf}ZB5VMP6OPy*Q^arraFivob$P!Rz=Wtl13J^Xr2#Pz}DdB){2qG
z(nSBAC_(&-DE7Oey`+898O>VI-*R)ck!pIr#_cjf-7RO)w;2Xe%eQ_cvdGP+*Xx38
z@?NzgG^o?8FaEwv3~uH-p~_($c6}5_3_*ET6YrQZ)3frRc^V;n+b0pZqb)tVDxiXM
z$j=VMYhB|S_kR5?FF}-+OYi>nFUpJim#M)as3bo5#YdAkWc+TO`#x+4Y~kwTJjbb;
z3-B=aOQeE%^8@Z)+#7fD*5g~=uKO1HPw?^<xA59?+dg~bEi$+Ggm>~58V#IuUV>Un
zhLyKrsb#bE`FssOU)#2mEpJgTB%d6-D{li_#BJx#ZF!5Vtt<gkM&5eVSTZi|?km`K
zlJGda_&0q>G^J8#fpgVg{`R=FI6wID3Ia!DQ+jbkxTfwcMT)P@{xW_LFPgc96mHO$
z6K|-IA=zd0u}ZDa^*zIPljhN4QVzcQ6EsIX)3e8R7=oAcZa;~AHNte*bI)&oK>nF?
zeZ8h@K30EH_||`LO{(4D5BQx=gIn*O!;g0_g6w)77Vq7QtQ<HuC)M%pMN}WHWyj~L
zcQ1nMI`o|zxix##Kihso`#$IhWg9z#>wFy!1LgJZMU<19d8XYD_3lM6w4OK`@$LbY
z=ce`UIn;QrEDrlWM4GJ602j8f(>WZD3FS3~GAum03(riT)=0X55)Fd0EOk@+&3Yt`
zzQ2!JQ}ajM-mn&j;!m;;wBD5+7aOWEQ83b|q&F-$uBUjwV&lM%AEi?P!3k(ZLKz!q
zL>U=q_y0lB2J+~aikhFVk@Qg|Zk6{&R5a(gD^=cpz+0<MSJUf-u4xtv`W>M~?G0;j
zJAY_9_iYz*cpk!VBI~0zSHxVG!xzyK$~7nsr>L$!7(W$fHg_+7z}<PX_&slEy{OOi
zp0`4l{e1TMK5qzd$n!=F%6VhTR`m6`@djDbpN2byY@<O-&*}LZHj2Ez-si0_{%6}o
z?s+Tx@xJ5S^t@R~f6v<|`Tu+04C^Lq4^OMdk2f8CSz9XZIDYY_18s5i<I7fWI!3u9
z>yE@$Z#vNR_}ff|`=#h->b^I@p3!D_-pNQw-%*jrn~s%1VcL@ws6KV9FZ3Us6ZNSB
z%}6!gBcxB=p;j^(-0w7lOaAoP$+PsJJ2PpOZ|?jhf$5!qr5H6|Hx6UF;!B~B=(h)V
zC+Of-GFiN_EP0i)zuqiK<<*Qdn*!}U?V7gh_1@E#D!HVpk||Uw{6KL8Ro38N*Kd+Z
z(BE>C*QlWn_iKbk$KJNL4l1pnZQV-Y?FRy;tJpnEuNx}XNo9I7LW^3-WN|0i9lqvU
zy)3}Hgf7sMFV#ooX6nk`RS^%qH5SzQNW0$3(pXd{w)k^nZQMyFi{JCsSU7%X$n5h5
z*Kn4g3wPc+GFH;I3GVaO5gho$roNiMJ#R~IXmAESU&9G5eh+ir5KOhJ9oX{*+Ww-f
zTlc(yhdb19MkwdaqV~KQ{MDq4M)nyuu@+9V`w6%0a08Z|cemcXTcdzxDq*uYHc|LQ
zbpNN#7Z-X6&1j}Q?(dUYxsid?WhU8vZsUUnefwi^+kdNx|Aapp{g&rH;Xbxxy(-pY
zwlsBx=Y)zuxETg=tmTBTvdiGx8_(8J#9NNaE~G|t=&jG-@m<+PT3*Ub`DH4*NI&Y3
zEZSSy1?-xz@=$L%m0gG;7C-+oHCYxKVZPnp?#eDpATswUxUau}Bg;~9_irmeXBMA2
ze~}M~1RKwkx?<?xn9PY^II}Fr84X>jK<ga4dh)u&@V0cQnJ0&@S<Tp8+OpRF!3vP%
zjQv2l99^%VCt7+fx*1cXktv`f6b6M;<Hyg(Mmg7J{%)lpoo$KNxvj{`)Tp6F$Z80>
zj(P5S8dxJ)N8)kpeU_8@JwENfvopt%j~bS_6tl*tC;ToF8>ak=H9_=zB9FXEzTT;|
z;YV~UcK8{%l{tvd)}#BLvsl;9>ztPe9(Jz8y3?Yr&sdVMOWVxhyY)x#iX}RSNJ~bL
zGRw@NZbvvg#)1czv@E_*2;WKP4f|2$j_Y)Bh;4$s9>VU#dMv!^WrQ`k+AV%QHu~;}
zTLDIAdxYd#;mV)@*Z##IGGn5$WY%wY1sLL4y`!fB4AC&VRHfP#U|!Tn7=t&Mglhk#
zEo<Z=o<j^EW<R>tj$(Ft&AW}ZG&;>Tk8$7mpZ4E3nF%t|jO?gKW}+6zx_670j?h6$
zpq<I0Fn(5vNPKXx?l&(pp<K1R$GK%D6tOVWuWw`~!c^fu_c9X{X+rQ~SNNdM2|4&9
zGjA(aX5tsi4AaX@_OGx8larauqMIUNuN36Sd3`?UnJ0&1R%?k~X37f8;AJM(i?ke%
z%tRH8_2i0PW?s$H&c{KY6LRoJW*Ys~$V~iVqsz$3Od+>bP0z?o;H9gD_S63RCNo>1
zPqe-=6MA!|N@!(fLjoTiM{YzLeRjmbADMYuu`-jt7-SZ&%w!!x^>JF63CiBJDAP+v
zzM{a-<x#gI9Ig>QR%RmTT8w2@W+K0noK26+Y^c)GNA)rj^uB=w7TtVo^xY8~e`Mxu
z#mY?nViTEhWhVQlS#nlpax^&yFC95@CILLCkuV0wtkT6`WhPdjGUV3EOzfu=$9QGt
zT3tN5^D8sY{#!fq*MI)?-`9Wt_pg8ZZ~yUse*OOEugL%Y`TKwW^>6?FAOGXm|NQ5g
zdqiStG^e#uI6R;ZE5-~o;V20j2VDn1+pZ$Dv)8b$$QT)UXPuq=*M#DXLsDm<*;E!B
zOfa`^U8<AFtv{&AI<vUVI&(P6i7_75{vy_@hQMFE{X6-_zyEUMvDspF^q@6BiJo6>
zrjQlZ8KGiP>vwqY)yJ$~=OE#=Fv{Rs7Ie(KJu7{UMI<>=^+v7keX>S_P*>&d*{_g=
zM$|6s?rp;POJt!e&({emRo)y&@Vx;AQ&`{Cp(XnZZA?Zub@d#aY_2p(D_=E{W65A-
z&!x$_kaGI(O=D4$wPkUem+f$5ERyKd{^9_e0N*^ee<!<@W546E*{XK*c%QFxu5+?y
z>Tn^rc|9oGzN=uqHY;{t{&sy4GqQGk+k0g1h7+sdPb7<|h576A`GxiIKi9cmf7?+s
zO|pgD={ESu1qTW;PenCvoV{76$Yq)DUbflZtaRdCqHk;#d!qYN+c8=1KT8P&Sc)Iu
zWYw$mC^X?^lY<Ww6sDU6N%Hj_>ZHfTz4S2n;SR9BczFhF{|+m`BlRqcfgQhPJ+Sj-
zSrY90T2=+S9*2eD>n~lskTsW8IUDRsUw#LRdg<hFjlbj`E5S1{iInX5Wn$u9*RVDd
ze~EJuNsMYEDj(@|;xBRLVtjm?Jhw}s8ESt~-VLBjMVnhnlBGjWd9Q~z<*<4Pu6enJ
z1q9M!UDxTbi70D`;`6YHD9ec8!k%|nNmTmvs0_r1!z7V-K)qv!@5G^x^xOC={SJP(
z1MDweo&npx!%FbmkH@kY*zsG|13O=qCBe?GWmT~2aab4>->Y{y8|+G7Z_OiJk8j8B
zBJ;J`ao4wF_owyka5v}ckrLmIlZeN+^HF}%x5HBy<F0h;^rnL!TQktw^5%zBTXUlL
zI?=bs)(jk+g2y6ETQhH#E`E1&hxnN~wr1e73-h1-I^mkxYoojiiJY$I9uk&@Ki-pI
zV{Y3QbXXt~wQ8}~TGoh<_we~%;-C&Ig`S|;nq+Al4h!skaE~Z&hVorF)Jk}RI|*;`
zlRIvI@#dM^{++D!Kk7Yq{5I>|&X>)S|EO2(?{z&+7QX5yd-ZP4zFldn4I0U6;&1FO
zGGCh=cjIsD{<QHovYV4<o^m_?#@{@s(}OpDxfFnc9U=U(ybIKml=1SgH2fEO`l!ky
zZ&)C3kFOi8>l^W~MhJemArH%h;C=HE2`h!->*zcj7I=A->yKBy3x`?>Z*V8!Eq=H+
z>@QxP4%@%O>har;$FhLf@mtmqJ71P%<m0<;f3NFtSWFbh%SH7^<vei`@$jR3l%K!<
zr8n!^rik;KBzOdkd<>C{nh6i?b@D)^M%fEIt>@($s(g*w#|3(dM{$4}^A#PA;SfiZ
zDU8Q#xii^;EjL^g`YqLd+HV(LutfZt_9p$hp57r;Mq4&0eq<`2rNiOW*RRD1LK;3q
zRh|)^Z{ZI&V>x(G{0nU(<xX&%No}RWw4q<4rn1bFMW^=q_g@ZgS;xN6aQX-P+n%S6
z3R)RNbluLi86##@e{s!TyelyG$S;cZy7OdkxGD7)8<OPti&W{Q4YO}XGi`j@PhWgP
z{TDltkrfPK^*eF(2#@F9-A;^Td6BR0PIRc59gE+c7{S1$E#IBE-ioNwBj1{x7*X3r
zzrH&$mc-sQw-YUDccR13PQ(bi{^H$<5fy;+_v}t|xY>#Hs8(tF?!?GyFZzpTCpy&Z
zM2p{@$VeFN-`$D$y_kev*6u_*#=8?Sd*!ac-1Br%yAvILb|PA?`iplb+I?ep;>Z2;
zFYUycJ9!K+!v$RSjouNmSdKABoxAWZGYn42reEV9en2Av5ihsy#zBTFvjYxG<N_D@
zW0sLkW?#s+NPtW_!;|?Q$Q%aanzqfKnHx<Y@MS*?3c~Q)hQS-MiKW-Dt;h&N*=vVB
z4}<O#VQ>&351nC<j_&y*q4Mruw{0gKqeZ9o`uATBk7=LpnZc5xGg2?Qo+MemO-LL*
zZQL=gSv@ln7#7o&c=$V-T^j~3_v?h{c>W^D{mL2P-Z$u|9m}`<^sns1ycAmePLF;k
zN}TC9xa`D*uDz8KW$)RE9=$u!;b$i<6ugOP6F$p+;qPVrJ+l)fk_T@MyAv6+GdH?-
zqC?G2^!VP16203~D0U~Z&wJcvCtBR@L`LW6{N0_%SuMAfq+_(`-H8rAJ8_}y^zZCM
zi8M-rnw{vzh@H595pm1<_1=jN#ZI(yeQ;I|lwYK@Wy{!!y5?rzU?<)-KJ2G|NhXez
zv4`uk6W7y7WI%B;aUjD(zrHfjp++WJ{K~`;BW2=nG7-PGc3gdS;=&tcqT7kAO*=Pw
zWTHi_Omz5>iGx`~GQukp(PxaiJ~GkZPA0PcZe}Y+CSq1i+bR<sYGk6tuS^`wFV`74
zG7%Mghy0$CiFS-vCSvyDUV$SMEt*{$1~2#Pu}5fRqTM%ECVt#c|I$v(NR7&{Ap4z|
z*NI$btPQslGvWmG>$?*jYIdT<?@r7eBr($R-HG@;yjb3ym^*Ln=67O7rJDWq*@+gl
zJJI21CuT^ZDlOlgh(4ch%}zA9+lhIkJ%45=Vphv-MR%e@%}%uV-H92dPMy8G6En?D
zwe@Ew+A$uP$k_`UJv-5&MkacE%f$7IOHy_gn!7U5?HeN#Kkui1X(z(Gg|F8ey&|T1
z!aBcpBANNxgsrQfNKa@|PXmSm5I#lVumMhV5onKOjVdVpR10baz*q-Aeg}#W*dR3#
zV3aP60b{_|ZxwzGb}*)Wmw|c~u+k(L0^7Q%qD9$8Wh`iVzHV42SSVb}cw8|f?dit=
zyH@B=ufaLbXmU3~7(5u9edhxjdO(If88YwueLZ+(d8@VMftEr(h6+nzLglW6oWT+z
zj3X7*Q*)H6EXWN6Tgm`FL4`E<HMqFxbq0!nH@qO2i-)pj24x$WmALxzb=uV$fZ}Wx
zpok48V@;*m19n!n5jLL#dc9s%m0y!-stiHbWTF}X7zB`n#x_VtP9__;$(PJ#oJK8D
zgN!xK7{(dM!0&PBPAn;J+EE-Nvc>-@$<Y{xWO|4I_c~c^(v1h9Kv?(eM$fRBR#J5{
zMKT%T&UW)Elr*qa_^(lmhc!jbim^OPM%gUCzBqg9O)71i-QZ5-**PE2DeK^pb})C2
z1}c5WWa0$VvA|63i}M7Z6ICH4L(r4`sU23ah#7JE^eH<TVetSnrDXnj9BYRFEQAdq
zyn%ZkGJehX6l+JwG#FPD$6Al`vMmH5qU6=W6Vf}IT02sV@I3*ACO|6#3NkXD>!QEK
z>Jl<*72B^1oX254EibXTE>_O3>jx|Woi=~l>w@ev${9OCi|+Z*HZ~qX)Dff16A1Pu
zY4`A(YyZmLk4UeBn2{b<dXiD{0gli3j0OSk5`62&-hiX9o59gGauL#K&kQ0ra?n@I
z(RbvlEtH;USut38Br0(!Uf>F5-M}@ENNZUOg6dlk!;tnIrPQ!+DCQ(gnOB1gwSZLS
zayV@Jsb^^=w+c6NMX?nM80p74Q5a)F^kGpe7b@o!l1NrO?@^@-qk-heTz6<dEZK~r
zai|amX@60)0nI3&RI2})94_H)88*klbL{%DWLvDP*=>6b{Y+|V*%4ZF&j;JM_?f@2
z2XElPS;vj&nkxhx)rd$j_=CCTiOD!znOXMT)tTE|*#=8r;-+JsXB*N6;_(qr;r7!(
z(MDy-7v3)i|MGhtlp?8=_TuiowD`R*&FM4ur8%qazBDJ>+?PfQm>bZ@40m4|31h#$
z(#W=aWtZ!Rk#wflR*K#cev++}>j@S8co5fRhWHIc!T;@X(1F1tLo2?)K{J!!{aWZ6
zk7R{oM|4~ZK-X#p1|(zE`cgT0ORv90n0uq73aT`%msZ67u9RzVq7Udv34Cykwe=t!
z*3Oq2$_bnkqCWvo6{(O!h4eurW<^<GqU$XnHw7ZfyHt5i9Khg?4ah?QmF!aX)^KOZ
zUUsE~mdkLG4sEbf#4JuSVxF)%vGw9x!CJPEwH3Gy3($%*qpUYeV{kRw#*qt2+kp0o
z{$;-2WaL@Z<b`(Rjy4@jE+{X}HU@||rEMr_eXt*s;pS8Bn<bJ_GdUGxL``X#$y!xB
zCTnAWk7LUGt*6A`*Ab~gEeX1wx*SWve6V)ry|dT`tS>$3%3vR%9|Z!7NjH@JNOuOB
zS=g<}4cBv(I!)_z|6}eu_3n^@2&W)pSsQC0NQr3c^g04f;2V=R4!#x>5nJ@4dmPMu
zte}>d?@B5XXz7UC#x5)542${>$y8?9wxks3izD~i`8Acl+T0srbqF=x%Y0rOse*Ns
zA=~b2rdZ^sWuzxce!lMqTqB+J=WMT0RJ@b>$d1sWdp@)c#hnCo_>nK>7mX}3{d1Db
zjK;`0Gjbyn%{(~?YG&1beOJJ?eAmnO<F2mlwb?mlgciLL)Z;KC1ZD+tug273lkamw
zl)KySm4*T6G&nO$3dzd{#X+}+aGl4c#YMfBK)u)G?1DU{3)&}wr+EI`)ZZK6!j`&W
zkS(aFtZ#+Xmkj$w>9lU->|Y^Pmbtk$vhUy+V`89HdR7daPY5qp6mijlCdpH&yv(a;
z9tp}xWpx|ir6W?FXpqz^zMV?uDOi$uZT;%rJ(S}J2ViJB#=eFC4G3r)`koyB=oP{-
zF-HK5dpb{RHDsP>lhYR^^1cwf&l{qz8(CXkBCcjZW6AqPHBgjN+CaTm@=F0PB%&d@
z)^NWX*C-~&0<+H$%?fMF8<TCUZBeqk1Q8*P=O%BkiL4|+q5tT;R$?29o>wsLOhl6D
z4z791$Pw(-i@x~Q^zb%`v@Xi21F>)1cVpi9BG|uUfMjc-xSkSaek~*kopN(aNz#Qv
z^9xn`5n0H&3XX#FyrU7GN?tXf>%5F0D5&O(JxA0PkklpjKj<4q5q-mGEue-+O3G(l
zMzkC=+fK`|_!2+8P*Q^ZaWJ9^=v>Ei$U1`N3A4Q}sJ7lwVXu0ha!VJO^+M7;vc``f
z)C!6P)(R#HPQ58;S$B8ZyDtcJMI~hfD|OnvT0qAEzD@4yrFv1PL_F$xK+8<wbS!bn
zU+g5c?{a2V!}5y=L1cIW&ezf(LlktWC0QimI;Be+<_(KT+=7rTp7Yg?j1Z<JWCS>=
zaL`91I=E^?QCOdBEAW8oOVRuyE9As9-~JU)4mSBsM39GmZtwM)p#GUBqb|Fb*_i=0
zqdh22Ue@_DctSo)Vf>rNp(P^5+x;R$TdAUT-2P#TTkl5-@9}`<bAo4=bAmY(n@wb1
zeN^eZrX={ck)2ojHnQtr-$q!qlE{T+TY(Rx<*qNO9wO!3>TF+<W=Q`cGm2F@Z#f*H
zJ?hGbe=IeTXEMTVh!URMmzi|K3k5adkV@j%#U)QlcpfYW1fGPo>a;IHY$n!|mQ1n{
z^}X4Zq1v52{KK%WRxd+Ak&OEG9z8FY-#^FzTAmnL$WS<AQThA9kNpMliA#|!YS~g-
z4I&(ao@{H`VMOFoR>m)D2SQBcn#C~u>tHEsO9t>%x;Msv^bajQU&FVAt4CUHvbzUE
zL&Z9TGVo31=wL{vSitZ?V{iyijVYxLKTxULqi}-;)kg;Sa~dr&1rah+b!Q}H<(O4Y
zt*<GK5wBWVJp}RyOvLy_6!LCKq!)x<(z|n#l3Sz~sbF}APZax*(HNOA*L;*(918zL
zU{rT_CC}3LSWrER9GC^nau04Tiw-~Qo}o_&_l;TijI&TkVCU97<M^*Vo!q*wcNWgb
zV=K(4E}fX$>()Jk;j^SMp0B}fUPgRc23cC^?OQ)!T|<(o?=@m6r`Xo+2rX(Xix#(U
z0f!$=+5Y0ys%`(Q4sJ(tHFi7lt6AE4vihl=Rr~c_0o(FjFV_#Vx~A7=Czugh)Vu{8
z4kaf_&GH-&gOc`)hz3Z!fdpZ{OW=gYD&Uzudwxa(_QAj!2wpcgXTj;_$g2p|dlV=g
z%J!zP1QKs8cq2;`?+tU3YuvJ{tf#!bZ3-!8DE}rBAN0oVAaNtQwgSfvdaICCkNhNC
zDRna}&6)Y5&ff2E6l0(CR6<EEEG$+@xB|A8g@SS@iT`HLI939coLb7Nv4F1vbJ!3B
zSVXTo(j*I4k@Vb36BIGx;d-Qr!R>u(+wu7Q)q4-y9#VZS2qd!OiMV=um)&VbA92xu
ze9p}jw%F?7cu;$aEq>3uY1zmJ(+?+2Os|dXF(Wi`%FKt8Y9MdOjXTy_%)~>@3^Usb
zQgvJ0wz2(-%qJj6mG9qR-S6bRKS0+%jL*m|YUjz|ZrvxVVYTl#NHG{YZ+8`G)@RLr
z2Trg<ik{{6>x3kja*FTno*;-}6&rgJENZ2X#jmWgEnm52`(dS^>9vuWW`sr}nfY+i
z*sQyiNOqT)R?Lnvzi7|3?VptbcQjUF+>w8hFMJIy)ei=e*{sd$?+1s^WU%s|$5Dg_
zPBY}gAwLmW^aUzm1G5E4no$D<H&?-iW}+=;1)l`Q44~jpL>}_m-OP(&?7})0Ey00c
zCCo+r$+@^cIj)s+a_leOljHk$PmUeUJqvc^7TxpYPmZ&#Ivme=TtMy@!AV?NNxpvw
zhQM28$H45-%)lUt_{)tPlnY%>nVF}9dWn8<&fi@H(~4O!^NVJEUH{B(Fr%?M=Z^f-
z{^QOp;NqV-I!)_uk6TUE;YYHSr9Fia#m{=AU`cR@s7Kz&%!1munVG{z!WL8!Pvpcj
z(zv9_8jenXMH{FLqVHbwH5~knqyn~Oyl(sG<?RP70b{h`dyQ(|6D82x2rX)4x5Z&l
zYK{EVsO3vztNPc)vq8Kw%U-=B;v0vxne}Cx9}SA7N$EL1c9;vnvHIL+1-yfq<UO{P
z)@WqgHy6X1Q0WFQyrMpEVU9)HjE0>_y%+_0*!mjLEQm1sWvvE4Yp;~YATdeE^<^7t
zz@s;JUwl3Ik(xk}o9ca`XgjC;&4OO~(!5KX!AWoQI!d(>Bk9*?|3I1f*Sd_cue&7m
z=WE!{($qHALl?d|%w7sPsP%UJnw-7@Vv?Do`a%&4!&wC_5bG?{J_-iI2gNIP1lfN`
zpX+MtfR;X{%oEZ(5W4+K>=$bS**|1I588kc*qgDT7m5hJxuX*XE_i7h+ISEfNCHy?
ze0BwqIbB9`HAB0ftevNT{G-<K>X&xUqYT5^^zFsnx?B9NyE%Pk-OX8b>uyfAS$87^
z%t{)W;nv+q82j~=My6#WyIenvq%*y?QuL1SlWY~KJ7INVJ$7duwz&0yTO4kKrKw=;
zCpy+d&xfSyxP{A{D3n84f~W|V+gUxYh-;fcqIF0h2`^3!h&f<I9>}kCx!@*(_&_nt
zC{m!;O1^?bkrlhxoM6}J(ElrI+^98yY>qJkMY?B`o5J|O(cn74TLP*Nys}<GN?!U`
zTH%t9>OmW*h!T2uHG1ISvha4Ridrr-x{42cz24D31gnA}Nzek)K(?Ln$=o-~8ad8L
zg)O=CV*?S}SEX00cJ+Zr(6mS!YsYUdb0(Q4W)(Hj*H+sW6NyHu^p_n!`cjdj%o78(
z>(tvRMvzYtU43hM(^j$(fMWzFOeFsjOieO}6OGUzN`wQ-T7wHa!C<|f0eMF<1n`Fv
zU0U$exQE<R(D?ut8rfXAq!_{ax<~~ZU2_yMMnB-U2Z@59eN?e@1D~S|^`qBDkA(zA
zX1Vck9WfpZsQd``USK6zwt>nHV@so0;FbeLD1xnNfxEU|i&~4U#f?SQ<EW>F+fdLX
zaiawsOE@M(HM$ly$+eYru94GLTTy$&5}ZN5#&*DZUB6Lf)?T9J8VUhzqdG>E+6aQ9
z%qH8YBmrR?Fm8Z1jA%#vlDzk%stMbGo3{nEE-bMzI2L4C2Jv<+K`>BijOfx##8*q^
zza-~t4R_t95^;nA=OE+a%CvPID7v=2j0IQ26h9_{oo3WE2YFAFc-}-lkt{o;HHjrb
zW!(X{5_c1}vikm3pXG&#{X0Ug`##;#vN#3nYmwwI_7~1b#?SZa<-3&?_BODx#l9M`
zjWAJ9D{wn>i9M+-0XuOT5fB(s*0z!DCT9j!UXu7z@Z79jWL#veEwxDEI>p$bHl{we
zAAS3Wfg`X$aU4EM<_Z5z)z>wApp?LC5~O|u(2S?D$Xdkc)TU9(>pceFE{^dGb!rT9
z8VCdud7Z1=$Hun{JT@lc<8JF^9eaFT*Cf;(R{#|$$xYCN<%BT^Q<x-pZ}gzP?z`#`
znNd6#@XHRS12XVv-3tAe_sim5%R=XC{Ic#QJ?HD={mPq{VhMZkxp^Ia{IZzW5Q6v)
zj$f9uy;SG%%ll<%5~CB!`ehjmq%mLDFAH?3P2AbmFUwUAq=PViSq818CSKCxm*sxS
ztQzF}vfO=Y%f5bDQQTuyDWZN^I^Qbm`Z&KQ_WQa<y4sl3ONz6B2eY$Cxszn=nfBya
z`xS5~wcfkSTUxd9LZZ!_{4HHzaSW=7FqAv((G(Vxa<?=%kJ2o>?+W-ByUre_Nu^7r
z!&D`950i79vB^W&c4dZXx?9>>o9WOUtWJkDj||@=+N9hS_szP2U-a%uhg+@B;wTLk
zqv$Q<_>)*h+#QXQXpM2bJ-facQkZ)3);uj;nCp9Dv}LZVyu|K1z^<2l2iWzs?|{n4
zkr0}11+kBF6m6vqRN>-28<m7w_#^Id-Dg=1Ma0);M$Q8MA>0(|?~SA;;(mwQq`YH{
zi1&?CeYopSA?gX^(@8wLwKqL?s40*I9S{}!?B-6+bIfXQFg`k|0Do^}Oo~OFcJWEJ
zd?`mA0+m6zQq+fo@Zq*Ik|2UL4sdN`@!<##wMy_hSesUH%_jn0%Gh|LqmeOqDIlnV
z8BFVOQ-Vb7#mR^mWH5o8K<#Ozw{kL=5O<-uN+=dqB!dZo##vA>uH|nTOoINF45q<i
zN&ahwlMQWSog~RV0^?eln%A_H%qCeVU=gjFrG;Jx+@B<2X(+NFBaDdBOr-E@YSk;)
zs59<1zGXIHp74F;-K_IHIDf2-U3&<7eX>X^;vEkidBr7NpBFz7-xhBSW=N7DHF|D4
zQY)ea95bYPZTpqE9#P~lW`<NNM>oONjgldic&V&w8p=U~@7!ic9rU+kNP*ZdJYU0e
zId&X)M?9@$NWpNeHt~RJe$qyuXzi+lM3BZZ7pe=<G_{RLD+f>%G3zq!*o5U<@UE7B
z1`uS~-^ArEA)c$Q56k84Sg4l3A@=o$Oe>Gi0Se3S8CXBzE@Nxm<diP%cTp*0X}#s`
zCvl0lcH<(hI`y6h#S!H__pDKiM}`*&uXP7xmI`Ht*BVg^dp-1~U<s2nw(kN3Ewf~J
z^+EzRv(h%h%kB$gc!l*IozK_no?UlMbvq6jUS(^&W`C0KZz+0yH&enb8DHGacc}3m
zy*P9v&eJD3N&hYL%GUd0+Lr!)@Fjc#eFo@ziYH@l-CxiJNJ%+HP_KJ$QfWMqF1JZU
z2|5sH9l=~-BDb$7V;$byIYHUR(uoJH`tEC1%<Vdd>m?PNtT1?7^kk*frmoI_86jz`
z?Rv(ICc9)kwu5TyAhA+(T{l&A@P!T?%TGCmAa@zk@AW+@cFE3%iqeaopp2V%pNNpe
zzlR5WlPc5x1X<jkM2F*58+VkX!`CI>$Md_8I=S{b-hO_{!93rW9Tg(;pg4?Cdk3Jt
zl*l?%2}pZ};qfLqXWKcVhzC&#h#Gi#?1%{ls3xfbox9%`Pp<0O7m(W_$vExTtRuKv
z)*Xi%Ar#Sv?Eb|45n|tKs=Jwax3%xsc-{F9H7D**IlX1epmnJ$&zao99mZYWlnti3
zi|45~ZUa^B#iQg<0}m<@Szmy+3-0Z<6#FW7e@={f#T}0gs5#AL9WF)FtP*jJ4CwXR
z+!@eoSu6DzP{Qli5!cTck7lw_wvoxg^nRUKFeC1k3%r&jWSr#MWIsk#sfFme(W>I>
zNRBL8)>0i}(-GF%6-|{zJ~$s$y_SE<K~I%0U->=+xq%?xmU!R(gFN*-e9E2u`aw>9
zeaoo@4?|zd>YG!$@vlGR+9Gx?Oj`dIUXs*C<jlu)KdH?!Q?>h3ZtlQSs&BvHI$JsH
zoZXq^ZbkcRh5H|Jc|VU!M_g&9PVz61?iDy<_Owrp+X%JWo|YZ?xQ;>%x2NiFEUagy
zGXx3%vp`J0M9Cpx`}-C{9N~yXN6^6|_+dsb?nh>D)M4-O6aH;nC#yNIOs>BrE&gUT
z9~^f2*_!0<H4>q!ojD5%`tH0l!AePDt478kY?11}T*8}Kn;8~ck=IMSuEm0$=(3tO
z`dhM^V~NuC{Ti0RA~CdVxv(FwA||pbvLAG9|JH2Fpz({iq%m6yMRc=Tr7=S0uQ}9Z
zHDBCiHUE_DOoOq=alC9p9(`v)mzL7b$6hySIQTlA>bn4)T{-wH+XDi-MB7=@IY>0~
z!j}+ZekGDJ*2m4ymd%>Bb8EAvH?CRJa8Om>N=N*8C?~UTv>;j2J@@VTFSKd=maJ*q
zkeUs*q+(!xbf$o<GAqc}tPkq4rZ4WZrVWn%!Pd^K={_qp@|2NKl{9O*N6GO@1x$F7
zj}(P6R5Es9m*>k9S<?s{Rdhrsxo_6ApuZ(+8e+9RUn5moJjQGp0nE&fUQZ2agC#RH
z19xdzUC8X&>sonNBeS^$S~WRBY+jE(S<@STv!)Ne4&A^qadmsuY*^&qB*}gctTL~*
z6_ibqwpkHSVryZE36UAXjTIZSdR^uOdG4DvE$HuWS<`}l{UMv01c!Qdkf=7Ao++f6
ziWeARyfH}p>d)EN_ssr;`>bq(Hx~U1znt{os|G<qPS)@Zl&Z>!E1CFWLM=ik#muYQ
z$UOH(Hxkl*eWfW|=8M6~Ui4!i_VV{%PEuC}+e$yoEdVOb@eOqzY36p1TAa@K_k&~S
zN8!JOsZL}35CjOfA^R<cY|&kN7f%MV%uzmFJsF)P5IJ^~ecf@`sulbE^{Yc8jDFpZ
z@7K_1<BqKcAB-|r&LDOY_5(E7T(PJj&)Vy>IWIt8-nI_iXMa$uLmT|f|2O!0tBHmq
zw}ZqYBsf?`I6FV7uVC%`^>pfG<2bFv;iXSvJ#Z(;;`Ssue8O~1@A1KT_SeZT8cDo*
zgKRp;i7LgSm~*qew&Y@nVugs%J2OuS*dLa_@4wXJ8hM*q)Jk@PJIQYGh;pg$Q2+%6
zzveh0wNB-1nc|Tn%~~$nc4e84D3Vr+K~q+*U6}M9SWR%ZS;@XpwgDCe*>C1+<kp~a
z^lrJ3Cl$JX5E}vdK_j2ufa__*sCD*Q-iYM(5b28%wuyXPhg!*Qa3|R<j`XU=lQvKp
zIP!*$>}pnClMt(D3P?b1l2gUHrfZs1D}seG>Ftn&vkCgiRC(|CRRpDEcYG{@b6+CL
zBgE-jfupd_&2zARIw-n^m6VNTeXr;84}3AmXx?lIUFtpQ?a;g4R4^9h_YA@b5fF{>
z;*aLGai<Ym9Hdl%94SV61Plb%hm$pdZl-)VdbVT=uvL$){KZ>}nc4C@KX=ZJgtT8@
zY08$FQDJ2-`w^qc-Ycom>oIv+ja0`7X;|>6)rddc4PTqfBWQ%;%jL20m&;@0h<IzL
z=0<d>R9Pe2(A^?j9_x;d+q(pgQ}iamW}YN>1g7?+nX7?3$b3DptWYbOflPWVUCAk4
zC&9(WOuWlZA->-Kb>met8?ntsIm{DFiwlws9jG!BZMinhoL>Dd`r0U3?ea4x$d}*<
zbPR$cRz&jo;oNHyVTe;f*SBzm1hFw*joopD7`@+dg&4h`Tp^_v|JFio=#nXN4q^U~
zTpf5xN89fb5GKeRf>9=notc5sK22BwR<Dc7gO(WC478`XV|xdA%zg`32y(@BFGJx9
z!Z(0A30qFg%8c}N($=!>cqnj?N**6JUKGBD0J@GAl`CW_vl3PzNOm7i_F8!56=^Z(
zSjb*IvaT6|Jfq~+uE$K)7+L6pY#F6JW>T&YRKJkiB?SEp<slicT!krFyCW&L3poLX
zqBEo&57i;dcN^b0M7{(^{MYyy|HdtHa6C5|^P3nkG{ozN*{1yqoD{t?!vPkpu(qr0
zS4Ka@pg9O@6Y*5SH6Qxp3w*dmjxP`l8*AOl`!%vor}Pdj^W6mQ4$%0h<u4?)xRL)O
zF!z_e4n^u3z$aa^+8|4t=|vs4$iW|O5rdz1fc&Cl<KK6H>7RQCn9-PbfEl^b>@By5
zeFvCXwO`*AFz*1fUhW+rtE(J+=N({o&V2_s^x+mcxZ@W2iF1UNIkLv}tX<X*7YR0<
zYR^4O#vbnNnRdPqO7bcr526@#4UqH@_qmQU??~GMbEwFMb;VZomnB$TMZOF~rOQkq
z?m2B46;j!mLA@~+j+{tA;<3$a8(Hbr#>m!#e<>G96kXM{0z$M&k2X;RBPbV1k(ERd
z__gD-?MRj^^%zaM^@TxU)SVMGGCdSP5#_LBozos8*cos+30@G=E4lG&k#?*zvPi1%
zJHSezdo?tK;r>=Oh!S@8)8IwQ8>npN9h69^!s^k`yQr~uscpU`M2V~eq^D+Gdt^k2
zxGrngIQiBj`+uQJ0oeR!r4D6sKpKCYdk?P-Lq-WaKDuVx;>S^OM)|l>(|xn{yXLOr
z36nzDSq3>rW%UBTrsmbQh;2xAk(nf;y^;n+&k~3VlKMAM-yyUnUn8PO^SjnEmn2*y
zcv35x*E!a)Ae~Yp#hDk+JbdtJNA(86xRqs2;b&DoI0pYKH`6DMk}tv6l~goxZk@m+
z9AJp-i$#3!xGpoZ*R7TY=CaPL+E2QhGPHpOY>sc-B^F<Q%#s_AsFxx)ZIPfhWoTLZ
zMXV;U_-I5Y@m`}w_pL=O!qowMCSmqTe5AIG=N%)6P^QY9e$4r-S>@E~($MwES#vTn
zqKr%3t2ukz%t#;(&>gWvbvl0O+LfKAjyUz(HGp<B#y)aXOVUU^s|L7U+EMoj{06#T
zdl5!U?zNus-rZS>>QWXDL>LH5#FnA!2+blbBf>Rx-Sg{!sK$g-)-`?uLBxeTML3f=
z9QN2Mas=l$Xr?2oUCne@=)lmW-uoUanWD&=QInp@$s`-1YumM*7a5c*liVAnZEoMy
z(K1EqjG6PkBWpSQcA%YBIYROum3~Wc8+wzCBK$xwgJ#L!2Dehr)c%lhU;57UKt!^(
zfwj$Pdtw9mA}O0QYXTZ;(ZecrY)cOdmEfu+qZs`3tsp)yi&hAm6Q3x;h8J?zdkHGA
zYRL!-)(BkW<Iy$%UAFB^lm<OiZbIA!q3k$@mX&P^+9^~}!IuiMIqQ%@pjqqd1a#Fb
zGdbk-9Bp<b1jmjtG~c(a#^=7l5B}Wj2e%rN#g9D@=w{8h_CV+_HK>)<*aN|tR>B<K
z9ta(%#5{waZO_Jb*NkE5t-N1@p;8%;k3A6RoU^_5KxlL`kL2xvWR`0+Dwmbo108BL
zri*(G+~T;tm`%oCEGz>-Kk<+=cKZj-cij{vZp~6hLw@hjg_-Y++<38_25x-bW>)Rj
zcLk*7O2)LiUeXT`FzMbwNdD<{DEe;DoggEuva=0pHE^?U{0rvduw-=vpsU8Y6n%MH
zqbOOcbK|M1jSF0FQTXiOwavWu5GbKqM!_XeX_pJ2>C4l+_QbLPJ6RW*K~B83Iarp|
z&Uz->&Jscyi*^|**J&?mDOe(eZv;?8t=9C_Il!&Db=DRYjag~~^7Y$`=o3hxYO+T%
zih{@EX)c+%SO%NP$ZAg-2qM@T?%FU_d8T1JRT;IE>!>-Oph401{j6nkEJTF!NgEk5
zbidhW$btR9#X5G5m0F)3_R(Xjde};jeGsyLX^6A?R>-=fIYk)_24$C<OZ@3vXQnTz
z<pd9FwZ|bXv~A1DsKRjtyu?{H4n=c&DwkqjrS-MvcPl7Zy0yqIF-uUMU|K!*{mTNY
zZNmkt7Nr@bS~E40(&yBSxljvb8lsKYyKb{<bVltYZpM~0CL7tMGKU}}t)g#ZDoWzL
zY_u-W$4;^>Thwt*ebU{;R)^5&DgIH<NM~?V)t%hQsM*rQUJkcdok#c2ML3gSDyy5z
z5b3MpwLlbn6}C{WviL`FKwFslszAE$&WE5<u5S=z8ED-7QUJ&shj&a?UN&g+Z8LwZ
zv(S~1uJ#mE8(6!oh*trLS5cVLpl9?f@&7Qjg6NefDq<*#i2As-lCrs;I@Ir=J2@gU
zsnw0c7yTs~NS?wgjqI$6QoPhaR<|X03`Sopw`Z{1=%axgeB0^j*x3)e6`a>5Iy8T=
zai3%)1y5n1S^WdIm9+hV+3xEv{eHA?zVEV=AvKqHQ^vatP4?hLIKhBdsX{7vl{jPI
z>ls$J4WKFOB2oxT-z>S?!mz|&g<yNohaqp{FGJqJ*Nw!-y!;~SjQkQmOckk8SbcVG
zPg5DH!G2=Sd&ZCNYmvAOJ6{w6L2cTZ<xZnouS0_&d*e~&3pgpK6qkRjeDY-~1K$$I
zRju9XXMY&@j-UNu;5&YHGVtjgW?D&!6|6O)1%bzElUQ&5qF#|ox+vZMd8sJMtiA54
zy6w&=?JDTHY=@rCMrvUC0wHP3KFfWcEQ@uu6n$Yt)UXhAqS}Yb15m7pd_#&w*)ruD
zGoRYU;X_eRBUER7L83-V5-$&Ld-=^P-9Wgd+_eVvjC~(u<k#l&Og*G;tmOuGo(_XY
zhENP;3Y_cBz2jfT44b(Va%0a{>SqShdMj&wH|pBfJp-uMqw|<!ooVCiP;EYjb-zpN
zU@R$3qd@Q)je;&+py*xGOW&4{3HL_Sy9tjQwLSGD@yARU1D&2&ukzU5<TepDr*E>{
zHBSc#CAli6C#t?|{weWDyPdqzM<QCkHqOa<|9XEn&r~aQ$C0eNmr^BH=8o;k4SBO1
z|HzG5@rIlGWUlx0+>$JgS=F1>@#s1DOs#G__xt^n8Y;w_WDHQJ9hvug!terL7DfZc
z6!jeIgKo+9=+Q?~K6-R!V0~6Q@45%%K7{!&^SvQgbWt5)>A$JH647&=-tpu6rA&r*
zzShkGj>Tl~77w27{HAhn-Oun{PI<Ey7P(BDle9=&8TqXAmUCRMf<6-Q;3^T<HQbAD
zC6WKS?~KJ6%eK2l@ztPzDEW2l6fbwJ>b8S{`|^EB;)kZJtit%m+{Dh8(LzH|dm9|}
zsj8h8VF^=iVZ_%R4%2m%Wo{w;MC(Ip8pE(9+jU}+iRK`-A~*p^PodHb*-%07T#8tA
z8}s~=Xk|TI2I4GMWRT(Ky!(MQlW6%uo>t+3Hqwxej+lOZmXW_V-|0F{5+(5PogVze
zp0XY{-Ymat>?v!vt7Xo{o`MIp=TMakPGe8OcN%v!gzMq7e5ck=ibA$SY}fYdMrQ2Y
za%NOF7!B)YPsmJd5<LqXrlCcBx2-e9IT^Tg@=(w5+H%y4E$aAAKk%SpN6Gh9V^x>T
zYjOgo*nyP^dQDH8`}?1GQ!8?L6)zf%L*~>RHXAhfOVD>xQ}w+Ekw6s$g<hfA#XW6S
z;0Y~bM3n}W<SFD+T_<Gk`mMoQK2@U!J3dvT2mi>k3O990TSf#_J|vE}L}+}yK+B|C
z;_J`6tdYr7KjSZ7>%q^y1-hj7=IPaa3!cy3g|W!)+f3<EYjXP*%%bZp+5Ap)e642R
zg0*x>XNkQvU$5sa4|_H-)8IqxNqzn%W}2L;K~Ktwna&B>d{aF0CuZ8Aj<5CNp0Cy5
z$G>WS@%mS7|Ez!2j^_GT?Z~h9&CZkc;n`WWU*8qD{#CnP*1u|3_xe}uPPqP6hdz9*
z2e*8!Kk>LyOUq(Gjfh-Q{ymf(*%=`n?x!9u-nI?D)m+NOCH9y&C}6*Y54M6OUuIxw
zJmf+|c9ZHyX0{9;tn-hWv+Vq%OQwt<>uLO>V2e)2pRjgSpghEz=rDtIginb)1izCo
z%!6Bm4kF$JNHA80lci`D<%3-kyXY;5BQM&h;_={mdkdb`vH;><xxM91DtnKYA+q4T
z!%7g=tB-e^vV4P<MR+3cH&J71abvBS58Bf;aMeFQG1`9Z?}e{}-#2|>4`k=|q#Ov7
z3H_Y23IB-9*}67p{Thg|6TW{Kq1R;V?b*qlx%16N;A<3;Kh)v#+aBiMV~c;7f{*`%
zyux}@-c~XL&NORrDLG5Wfy_dAohUaD{8|t=()LeG#<*=qi2M5-^OgKXIAHK(jay=)
zHitxfEj*+t+4K)?PM*Q7M6>wue*kSEr=6WA{tw8PwZHS8+wK1VPxO*!Su;Y_{{b1b
zj^(LQqqF51sPCMEhpdG0e%%n?UG#LR{{xaWgtAZn@qYkcSKW>cQU3?ov{BgQm-T-*
z)JimiyBpHtCx+7g;*FuS{j)KYb~HDJ(vJLElpjX(W0$tGYQMfKaAPR#df6CCySg`q
z((Z&CL+Ma^LmJ#`7zPJXOcv=Rl0Rj|GpPeq6B0)*W#7`t#0m*KHRX*l@1I9=y6+;-
zXm4=Fi_T<m>UI&vMb*DjV;!uC`g^f#4wjPjjXLqvlz7g95R$-ZYfC2uw?!3g5=@G!
z2^Wpq#A~DmwZak?E+^nQOOC1F?Yv&_colq*@L#2HDw>V2c<WoEp89ru@uO)Q9MSDk
zZ4Q-oYuquNVeP~$?*qISRo`2ZKz(k5Troj?GKo)QO5o8|XS|*eUxDHJQxNx^gg4B7
z9ZAA4+`i>K5H)Vs>|5L?HJpf3-M4xxZT2_aw+=P?_6Iig&v)BlSznJ)&ldgngCqPD
z)ciytb5+A>BpoB`a-%DYQn`g7J1dhLARlhC$f!T?Jg;w)do_5Lb^FG!EbI1-@dx(x
z*jr0~z#aSgPi*ZTKQ`Nk#ogc-mBbNWTdvH&Ec;i}<W0l*>O-?V@=!i~nO%v9i6DZh
zLs{JSN|42I_Vl0+i~GUvOF+UF%H|=|SA$tM_r@^mW?m#_-OTI7vbfu~j%9H-vCLp(
zUgxp<EK{&IgM{O}u8`hBuIEO#=hHvt4(1)jzemFa^p>h0xkVj|`^DWp`H9`#;&vZe
z)^~@)Loi$PyL^&uX*7Q#Ci3EgL_FE^GvQ&Jk}Gyk+w3q72}8?0nHF`d?*_kbI<$<$
z>0j<mXZvB_bf(wlO=m`E-W_H>+?&qq6Z`J4yUMg;cA)u1D`#x~%<eX$u@dZ#{FA&B
z)^~Ep_v&Is{(kVQVc~~*Dcx&hEDe`W?Y*PBNuF5iUejxE*tMOLxV1vhkAHPY&!>O&
z_6c$G@K|uof^b9GUxXgPB&Mf-YvtF&f6vt(4Qm6Goc+ix`qURVcxJ^_-BSa_-+u9Z
zlNuvAT|Xj-CnYN1^*SKlQfejK5ne6lskd-!%g+hEx|OhK#qej`o%oGAUD@JSS4J_;
zGGq6;GHRiqK>MpJcZAAmO;TzGtnAVeOQKODSNrw#Fs`ob>t~!84!f&ND`p28?cD5F
z*FUqn&1lR?FeA69yNL{r&>1AdYRkg?jYy%TZtimvnq=_@+8IurmRxGmJW8-zr+sd6
z^u8%~GaKKOyUC4jDkBSfw*Ka5I^1al7x$Wl!|%TG8p_3eJsE@Fbu+u%N{)LXtemmu
zhqEgjgyyta33gBBCwX`3UxZYL%TxLL!JqmU2M5t`gvS~v$SkK+lIR`WIIM%vgh{C|
z$+L+c8+8-Ff)cbw#lXv+l^3FN*K}yVcrw2AF9h{E$HkA%K?{^?1z`@XtuDVP`;+_w
z%qH~x6TSj?)$C}l7GXzjQCI)M;I96K!Eu6G*;Q#o%R$A6^)TqWf1(qizQj7*LG`Vp
zL7^JOx|d7+Wwk9-u2{zhvD8of3qk!!x%k&#x(b1{k4-CFF$`FL5y@q`zRF2x`-j~S
z#teQmcIVuYf7*Y#GqGn|$lrFR!SOy!tc25e8l;YfWS>mw_fipr6NoVeP30+0T3`$)
z3)Z0&4aW|yy|Jr&kk!-8)JC5jcyP|(k?gLOa|_5XvQC4!GkpK<4P!@hZzDT$i<-Dj
zhuafuab$iC_5{CJBjZjxDCFRI*Z$ETfRnIhU3CbKrd6#cQ?;TIMn0IK%qlZ5iu)aS
z&}Ro8TzBC5yOw<`jirBk-M@%{e_7v9^L+cq-4MuNWkzFn&K<c$?Fs(0|Gsu*mT)r;
zTxFJxzm-`Ietc3u*TLP4OzM+D6@zuAP96H~lS0)4#M>XX9r~nDH(@Ej&A-!JWft>J
zLrn%$iG04!iI=T^0ixOi=&a)N9%ID_CeqmVSjo(v=*R2E_n1RnWtNM($}B%sY{{h4
z-*0849!XUT<a@5etxQp=*Dx;L;@o%<AB^I=?&ZS85>?<r&Em^oW-R%<S@|WX_xjG3
zt^8u=)>eKoZ(!60K~dM_TWO$*7LN!tG<db7D#}8K#=)jA#ahJ5Dp^=0;VzPxT-0Hi
zrSBM@)dF6OsM&&yaLysf#D{Q&Z+usTVJzv_#mB)VB4#NI>z?YH>v5eTv2rSY@)L(f
z*}nL#EMxHFg=4*$tW565V}}v7F?a3m<KM&hae~8sA<`R&$};Ow=)GR9vW$I`qOwdH
zv(M*ivUcv;;&sA#&I&T4jO_<m8k$HfREt?cuWPnK4U7T?8oTmVf^C$Uv<`KZWj<7#
z`TA>rpLbqntl~|<{uxayhzKq#a0!0>sX`6D?^Ah*(tuf4@m^BW^<T@tQ{JGBq|Mum
z2)`tiYf4Ewo)T$`TAc?5i*^{R2Qq0`xu%K6V60(J<(d;8`BbhsHnkrs+EhfcrCk?i
z#u&8H4Rhp%#+g>|@xL;}SHQV4=O^4(#xeM@C|K!ttq)dKT3dyctk<$(rLftFMrONx
zYb3n=`rZcSM3}q7ogZ`4nA2u&v3oK<-ECTrjE>LbA_@L}@Z)y_Dwl)xyP@BR#VXq-
zp?)`1`pIde?Hv=p8^#VoedoP=YX}{i$$E1lZu0SrVz#GdC|uhJR%S-w__4MTtmLSz
zonEJ1cPy<7VtW?FHsVlY8?pFXgX!R)E*%oX$lFahUK7fAbn!nGI6eEUD&LouBX38X
z2&jziMf{#1hnth=a5$-I_AhIk{WweCJVXiEjg%88E~F>FlHTsONTFE7-wzTEq!s=m
z+Ot%Iima3%)y^{f#d0$tx2M+A1`>x=!hy(oYza45N<t)A)M$UH?<E#>NYD}DxVS{S
z6Q41D!mq?NI794e71`fX*tWjO0$#i)YCTL|OUD%-Jt~ux^~K(|P!FVn+Y$l~2kley
z?C#rjkAWT5XGG%8LoKQ2M1T*tw({-#fFZk`YApM-p?(`)ul{6O)b86q)P_r4$B3<(
zB;N+V8Co4%(<quR{IT|&`M#g;r<@CnDN7t9SsLY5U9(b@u^G0b99dHYY|H89_<-M2
z)}ewheb);FRZ5p#i@b5q((}~lJ2tkbrr)u#K@Z&8fN2FuEG_I<!z#Sb&@k82sw(eH
zq%!yWPc;Yey~Kyg_qu0!yY+3~S~Jz>D?=9E!87^|e>CTfyBCSYk9E&VziSD!veMcO
ztz^AcMk|HQZ24M|cg~H3w_o4e;QCVS-C=#H_NKYMRC_C3U#dgxi{#VY_O<K5tsAwz
zxmgx}>%natA!Xz(AlhmZ7RZVODcA&1C9W$Y50cu}D_`zwuxVG7sxS=2!fG{v#2iJ|
zI3=Wbvr633&5LGlu4nwN<wl}XnQ_$hBFh9PZZjPrg<(p?AW#pC?MJL>S3mhwC+<t|
z)ybx>y~B&d^tutY4^MfK<QfUhvC8`TapoQ6>c^RP6zj*${<eZ@DQng=%5s3$MJv-x
z%_2oeY~MB4l7>QXw}FBoNoAUBYIaU$rm->&?1X~0-ilNbL8fLCW;>2CmmxK1mP)s4
zQ0Gu~J(#eB(DrFIt>6v3lDL9+s})>ZNE%2Z%)P$@`6m#PvTnZ35Z6&NPTCkKUNhBd
zpXZP^5CYOqO!F+P4YW|C_V37v+O!%Gn9zb+Adr=Ugj`nqDpOgT8ehXfs)He}PNNMn
zOE~@3T4GTw;z*wCX=**Pb+cw=Tmnm85_HX+%pJn1yI8wE)|LAb{M6qY<e#a6Bki+_
zrybO9v9o>|Y(bgtL7cIUr@KRay}66~dUFO}+ohrG5m7wiH3ok@2#5Y+R0aVE_@r5}
zOd_blribYMP8J6Z$(EW%2=r&&b|yoT*h%stn`V44wV(+j4}K;WsR~DW->Q+^sF<uZ
z>*6^17&$2K3j@ZJ*0KXZ|CC=OOI_O@Xfm&{-rQ<=DhoknKFV*YH&-=px+0yjNsU1y
z$Er@i>mh5sx%ISd>aC8b|GC$<%@j1gWKAS%WGyrV<+@<nB&)d<*dY&d`Xmz(+n{}N
z`*P=~N%sgWrKPEMGH1|Qajc{$OoWGn=Ic*&>%a~hcFmKeVrctd`U|7$n`(@}Dx4Xw
z?CDu!o$Ru2I4kR{Kb+LRy*=DgEUPpmlLU-JS?ex=l{0PL3?bC}EfvM$x~}$1u*RVE
zn7{#|FV8gq*5IPM?XYPq1!Gr7V%4vrEFdEy=#A)VtSOqAJ(=W?3$q?HP-IO>8`OuQ
z+D6t?Hmzs3RGQ7^+osfMWLmyxh*+DHCCgd~{I;zqa@!G&Q+Zz~X1i84P2xkMy@bxR
z-%`&mcZtr!uIe#s)zm&`R<BqAhnS$X<jn(=SdvHY&I<F~#>3Qm4>wsk-*0Xo+~at)
zY)`gu`#8<vaQl4JC$#eHAa~}Q$LR3G?E@WQ=?+cf{*>E?<N>`D<?1=yJ|8RheaUPg
z-z@6)U9&O7<SPsVm6gImmN{P+UQ%9@6v$dF)PA+8r7J|`Mv>K=b@TE>WFK?w*YpRC
zus}Iitw=k-*QaYdM`>qQg%D1?5n7yp!bG8GI8D~vrQ><Y+WiKas2QibyXkEK>&Fyr
zDl$=eX!Hhrv|7y%?liR)pg62njf^ZEv1<VdpCk=cRqA=dPS}dn{sS3o3Oj~)y(muI
zz6|ezp1#CPeAcvFuODBT=Ba>r-ilAf%o7*FT5@Z$J?9GR<#mZd2XD|oa2h2b7_YQy
z<a&MREew3KSOZVu5fprG`;KrXspMU!a@SB!L923otQfk#A8GS9EvZ&jg2Sn8b`=T?
zNnP3+gYM*}RXuTMOv!t~eyvICJ0jJskE&n8lfLhxC{}hd>jc)=Elez}8dttVfmrKs
z1J){$Mexb95HfE|lw?wLsQ|2ZN3Ii*n1yAc;;ryH=gyKs>BA;puf>rl05GjFZ(GVm
zYQ!Y?qJre;%KsG6Kq}*rwc_nkXqsjWE`2~+?qC4jvAC&gejyVUqu8|zEVYacAi7py
zsBV**=uHN-wGR#MY9AULmSom7=NKE5jbCEFtuyO-CC!gu&H7xA#<y;nyzz9}hMj4)
zUE@B?y?4^}bHQ~B$|b2-Thr92lgR)F?z3L%=9@(ra^Bi5=s`5Iub@1m=*H_MEbk;(
zC8}udxE?h|5zEnU)#ee$_RzGLDHk(*3q7dDoJd4XeICTfs&%h(Ip@~?;Wgi^s3_+w
zZ-tn|#{s_@sFU>sgJeTcREyL$P&8odJj}I&cQsAaF4){HEV#?}O=n>rd2IyEABD_V
zFPXSs*@a#u7H`RI^V2|6n)0Fo368$gC&?_>M!?f(Y98hwQK7umT7URyp330I2Jlo8
zKXw;7wN__63${=TrJ`}x%1<K%F~aF#`Dug*X6zRZLdnkyb}r3e^VTpFn>ZLFBnlJd
zo+LJvIz{b8ZBd!UX?UlWA#I~HY}RVHcyhKX8YyfsTG<<!IH_;WWY|fxB0LHqDnkW)
z;$n}O$hnc6AP^sLJWdlpt@*~N0E^le&PRRXODgSxhI#BNVW!fq!4KaIYwC8fTVB2y
zR@7a+7$RW~-wY|Fvc$n(z8P6HsY`hIW=Ja)#l~s*X6WQCaZ5nun;}ilx{vi$rF=7d
z09MIavV1e7J=okQhi`^j^puJbmv4qQ_ENqzZ}#xb5O4bGGki0GOWj1vH$#eSeUo3l
z8M)y@^)c|SGOvk&ca?cfj4{vDn42qRx030R+u6D(4XBlQmpp2EJLT<<0zOCI95?Ij
z(~`br)}NG_XX)b9Bq23s51L_|cZIA<?vzwd=6cRrgSV72cdkeoQT2~j+U6c=rR%(Y
zs@VG__}aep<i7{WETP2gQfCK52suWr*}L?KsuiGDXGeO_r;_i+-%7q4M`DlGt_OoQ
zjbp;>ROQCb<<w1&e2K)lC26kW7X~v&r1hO^qs+3`FZxvSJ$})rlJD`0@`plrat%lf
zGDK&>mR>tx=*uyru&YJvm<=r&vn&398EdLtZsg4~vd-yDa-No|($rG9RC3{q#+h7~
z63<hFS+KHNF<*|QZ=cQ(`OjcajoE}zE2g7~f2;7TcEh2Z@AUKx)oKGt9L4tws+2bM
z1-hjaQnXU(-J`zp?+01;wd;+qCtr9O@-6Omiovl{*3&r2TLj_CyE+7X7W#Icp{uWB
z&4ub9l#W`nhgODK_Y9<=F|iGA?S62azl|eyOj;kUZEl~X_6~jBk1jRrLBCdpcz@~K
z3u24o?ws;UNpx@Ss?Ux5XCz&Tc~=h-!mi(2vgPfIMBda?$p#_u%X$#qPByW*Zs!|6
zB+ki_2GR4zP&-L;Gu6QC6h)$daD0z3K{5ZmYkf;35EzNpXoKoyL2M>W<8D$f{Gx8B
z7~EL|Ee?%H^l@l+GZ)po*Sg4yizS|h-dsz!h;8e95ivB1XRT^LJfyBS;L;I$+jxKq
zqPVb$P(G%#tIC6sv8dJ;M^Sb$WZtU23qyx8k__JFQRcN)ImdXpG<o-Cmhg(2A+xsm
zZUa8(wk?S2-vqiYkKm%~-<t9#M*pcne`25+aI*G)_pLxc1zE|<|DwBf_xkX^2<1^2
z%3*Q%U-<nxi~IY{|3aD9<7RVH{ujE}wNBIJf1%?oo?OYp|3d8~l(FA!!v8{<*R=BL
z;eQczG4MQD{ugRbONGe$7A60SR5};-h0FgU5=LXi4gU*pkhB%SmH)*_wZs4NQP%zb
z>wo?F&%gfr`tSe#^>6>}KmO0J-~ap-`QJZ(|L?#4?ce|7fBgEN|NILq49x0f6gP^;
zfCK372WLfcwF|J4QDqhMAMxGJi#Nu?VJ;8_3d@e5J;|w)iqAX3G)zzjVlGg@d5}FF
zc!8=RU&podNzhiw>RiQ#9J)o>1`Y}Nzunh(uuFwh+cJ24S}foC(fAB4Pp@IiC%={*
zp+)z6Xd4HIWa$#|R1s^D=@I`CpD1&m`*$1_!ZY8@Eun{ujD`ELijS`0T(r!H^2ur}
z+84gxa}^wQdvNPFmcwIIH6AddQnzlA7TIi3wt-DBxHk6dfG(BfTL#s>R;YLVkRT^=
z=$c-`v^^Skjv1jv_k3s@8+Y>uS__gc`~kQ7)#7(GVHyi$ezPkNih2}Se)kCsqK$k^
zc2`xtA42szu%h}odHVf+g)60#v(J5v=Xu{b7pG;cuhbXu{QwDEV4S(_wK>^lgdgMp
zE!V4MjE31CXU6~bxRV5^_KS{u!w0N;O-F?45TXT57yvVOh5H`)j$pO?1MW_Q#qWNZ
za96NujNMzvn(SoX@H-Kev00eW?OW8>Zi({1?D2_L5pQ>YB9IZ6a(TZ-j0o9HT+672
z%P5<tA7H^{)Pw6a=pw0SxDguEo(O}ZXf55lTn9+mv>B_{O)s&S4oA7d?NjqOA_<@a
z58jA8Zv*AZL5)Ck>2E<RP8YWQTiQTj8LfcRC87~KVy(VZqRzMm!NY9#$wAph$1cy|
z`5H+Ce2uu4>0gcgTR)(dN1jaEYgQSRdeLTt4wd=PHV*FQFToWqCl(9_pvrh~w_h!O
zS97qe^XPu%(E%2}diKeXWa8|16>>oI1ezTPzP4DmOuqYd(9$2CuRCjBhv{2Jy2Tu2
zzWrb|Ke8X&UR%j=NBBveK+^o@(o_)gjk+ayeA7n^Zl!_8m(HwjE3dy?-0Lq6U%R<{
zYsceG-#PfB?;M<E<S3yRS_U}_fUa-p$6aU`v+F$p&iJ(To%I;*nmf~y#3Qh>r0Pta
zc~{|^z9XpWJL|-69p-%9Nf0-7%YkpEhJZ~n%Sk^{ySmC?G>r7RQe#E5<Px2Ak1*4s
zWYI_8Ik?kne$s;+jz5hL`q59g)0=W+%+8Pat4|$#X!@A69?0Ad6duYf`cx0J7~>R3
zprGngnL*=nk}8a2)SLzlltkAfo;thNrv%;l)VgZM^L2phjB<-Di?<aqzA^6G>h=TW
zh+@gZ_nMVYLrs2!7Jc-ojeEW6Cq2vIcYVD6^%L&&ve~oba{h!r`r5(od6PPrsrvKA
z+7NtG`SXU*l2*@4LeCrYwW>PbJwaYyyXTFeFGmMEU*ly9Y8`jp;M^?q%lq>NnbjD5
zVb7bDaQD1@l9QsZQR{2joy5N%93g&@9x{ae^szH=Tbxt%%pS=s26U3(RYw_0+1Y+M
zutGV5E+V~bPAhdYC8*9ef{WTW?YLK!%V@bbT}PNA((Xr6FDi>h(RL`k?lLD%OJA?!
z`s(ghGFklDX$D_gtHuvI*5GdEJAA)t{(!p^bY4MLGWpk0f{RAZZAU3>L0iq-;Rq=r
zWfjpmM>wyv633Q7OCB(?46+6ViToY!C6l0RgY|*R`!#&_bHC|eqEQKn#DVs$A28)J
z-qH2iy;}DOEovo`!M$X6_?>TmLm1rMG!CCtEd@X0?#4Q}l}r}D=M8slATO9bZ^$&r
zvxfJ)HKwnOb1LM#!ImKzbIxkvG=Y2Gpf@1D<oOzWUTME1_jy|=N^H&dyfJS)m7QU)
z=gnJj_Ib0YJ#QBO|FtNE_3W+s9`TypPq@(#jokYQzw4$i-qu-Z@7s%a<G!a3H@c&H
zAz$3TkR9IW{`!EE%$#^*bv}JjuRE;hK0t);{Nqb|bh^OK_uI2M5gbO|QE9(OofqIW
zwN~H$_!qmu-HYAfRk&dOgu561#@`qI!LJ50X|2n}Yde$aJte=o(ZVZDz)q9G3xBGW
z;A&m|g@1Ll^=cpEyxPy#yw}QUxiQXiqQ+FJTSr@Ov-3J{VF;fCdL3!02Mb_GMI|8|
zLh(VL7yicG3;(B=KdcIwwQ_J?L(GyZRY6&RYyB5rv?;XuXG;Mo4p`aaXWUv4Jihd+
zs1}4Z<5Az@5!_aS)<jEt;W3FCc>n?h68FpNKXt}`gSUI>S6b~WGN0aC5H`9k2qg-m
zh4~tE{&L^3W%2Q?S3ZhBr*Hj0bnEwCH?kd-XM_%Q7KDR43&Ky9g@y#dInMfMgfVOd
zmEIJt=hzt>f3QUKHNN}@{IyUV{GPW#Yvb(xyn*+9q|n~;Mh>TXY-f7j$WozJj(dW<
zh2ow!SSaeTI_$5(OTVs%ZIRaV26o}bym5ctAd5+N;?A3u^!L1dlK*N8on(!0*7(04
z92!h#3`2*Xc$B!c9Wu=TUE67>#suxQZyO5el8+`;g3d|Gxji;|KT}sn!?uxp{Kp=I
z0H@@&KkyYtX2f|NZIIElH?O04yVTavENUf_!QY)`@H|U7J9f1g)q6C0xjSEDvskfu
zB42gm+m468q4*JZC+OhLw&`%hb?LdSg;mLcqH=N)6g4(gPNX(N*-|Ctk=0(=5F9U3
z1*w8+tuz)-W7`z;x7^sM&iVc8wL;s9xmxa3BxFJbfp7f)TkaHI9@A@Mr!^yVsF6$t
ze{91BU-RAb#u4tF&-#qAZ<><Z_6DMicsMsu7uz`2p9YujxWBO!_nLsg?|H*r%fM@Q
z-X=mQXG-sRBNt+<=Tyji!Fu0B?t2e_(FE>!gWizDr(?fH&|%uP(|z71`1E`H_BMm2
zGUcsp&YSmJ?DJ+(rwLsA|JR4&bZD>H{e+u#5(u=KYH%<eN28ezwQyjQ86S}NUBL6x
zG*ebJ(;3e9BW}%i9j%Z~`(ysu$K>$af3J!Egd2_i%JZLavmgHzPy2f4b>#G|t81z3
znSsA$-5tbXeRVkKIFY8czb+ZObD{7=!IQhtMDq&XR>TX*U5KyY)goU<W>PE^g`1JZ
z?9o60Q+690N5TQCm3=Lo@9MF3^UwHc=f&@@Hs)Wq>3ay~f%WhR?|2$00>NVCM&D4M
zz0cxj3dvPr6gPip19q7Pwtx3E)9qV%<`wB6>x6xqSMZdEr4jmGqo8mq<(XHD+IclN
ziaJNB0rBF2G5_ut5u4Z${_pz7a%+?4-i-#4#1&KNMvn4Ay|4{4PY2~(-&wU^-xV+|
zoAq-2Fso~NZFYhgp+{vte*1j`V)}IhC(e`Emp|cdUOm2l)tnI1Lvx<oc+BZDqc<nj
z%#=CTZeAhGXKBy8;zDR}#QT;fiNl_GMRF9f3`(%QCb~AFw6RC{qI+H)ZqBL4_bzt7
zXeG(*pO-s#G*(L8kz0xOLH<FjUOFhfhb^wZAuAe;a*&J&X6R|D2nJs$YEXhzkLbG2
z2WGG{F<Ve<(n#Ar_c2mZ$FDLb_?yJGA*W%aHROdO5;m}Hcs&wGm=-G4qg7@Ua$z9i
zZr$>eEQ>s=opo~;jxy;;WwYmcpqxhq4YNZ@$Uj?nq{9FO{zSiB%TPN9R2|okQP;sQ
zv297Wdp*F@0_D(+5ZYq{^NO1fc);5p%bmXg+Yo9OaGt>M1*H!-6OkKd8~O$)9#Jb`
z^<)Zq*72ff8>(SO{)YQ{Fp94{Eu&rv3M<=w=!sk>XsMT`-(PZju7$17DDlLrNQ-ha
zf@fkxNV}Uq?s>!tCOg~qeB71s=v_yLpH+7)n;l~M;r5g1wb^}Ugl4Cj`8fNUbA9IT
zo&(GiCk=^g?$kiZuOJ5SC+x#{)RRiWpNL%oVHg6Vs`2DR25QZMFExy-0LDn94GX$j
zsm<?_gX%7c71SB-Ygh^rZx-7!->66*GyUKU7V^V3U4_w;-U)@YKAc%NJwi@S69Sq;
z?_NLhC)MHubQOt`8`Wts`9yO^iYn2>GVVmf2z!jT-!PakB8#hox<7cDLGwixS4=Wf
zlSQhDu6KmY>YcxX{{G9&w*C69jBWX@<LL*bB?4=})gXIb^HYc~okYGzWNl9Veg``7
zlMia=&)_Ij(gSz5X&Eb1wdLE7vyQ)i*neN#nfG=XjU|1v+#yE39^7kRqtNOX+Bba7
zS3=N+)xQSlHVSf0DR<Z7BoGBHEMB==dkukYAk}2fsbfMPFeW6_w8AzTy^6hClx?sg
zVRT<p9xqusL{6Jlz_Qe3r;ySBaXGN<psQnQ|JE)Ojg)R=*!yKP0~M>COvlLE5?l|u
z=Sg?l!8>?^^i^;*C-iUBQjVMsOm-y>o`NK@4U_=EkH)N}o0F?oxUY{60u-q!UZc8e
z;591X>qXhUMunMLGI+EHMWRW`uSSLW%d~D0UCJC$CQtWA-vhe-neGuYe-$N^P^$6k
z!SO<#?abev6OZ3HIk@{(<i8iJnwt~Sw3pG|IjN|b93OphfCMrjMa!XZDhJIKb@;ke
z#u#3k1d3YcUYi^UnOV)h+9dFqK(gXScuw%=^R9Ok2u>0;mNO%Nd)%FPk4JE1{UVx>
zJOh+&u+9@jjt!nxNntN??=X@}bQwh8_s02#j}>tcf(E9Ox|4lSp7<*X4*n%LGDPds
zN})P2pI^+(9Gh?dAZ3%D);k&_k<G|GdQZH;-46UT-}Ix}J&_X2+<ueE2lukKuSH+t
zth_JfK0!nRE?oOk?l7%|IQ&Z)C@RvuFXfJ>AlX3dOBrYibNH9?Mg2?JeSKcaw&nX$
z_WigoW!vjJw|0aU-ShFR1YU))bX^IgrXU*hXB-Sny~Okl2k!+6vJfp~IA17=6eiIa
zI&zkxq7kV^TaMKkrHv)}+o1l_k-#jwGqAM#)@Qcna?s!M{u^<|?7v2Jtv*8ZEkjd^
zji<r&13r#gxWi4a2WZ2x{Nf#<MfZGY8yk1?XEeVbaKB$IepmBaAneLt3xwY%_a3#o
z>RKS|4!p9^@7F6i-PcFTx|WYjw*9aY{Px<O>^nk_-u?Pn4!l}hhtqPvzvCsu#UDw4
zCo+jXzT+X*@JI--K9x2f34xF<aF)Fif{7jAv2qduVS=^HM?xI*kr4LlD<MqFMnbrL
z7ztr|ZDfHNp+{vtyoBgDxa)#_W%Z9Z0%1d&;Tw*7qx0_RU?t?4@3__5sH%g4@T3d6
z{+Lu#1e+GTpbN*_E73*-9?`Xtr=UoD45G1SvW6K{_5L8bv-=uhJ3RBQ<)hs`{b=Y%
zm`|^dzU4+}&^;esYxDDG_OZwB2|Tzvf$(-9f6|{oM3BxJUhS--3IfYGxU&W~bHX#^
zMZuEvYG)l~M><GsT+4VdqNKX-2Lxho@zu_7CQHO|b0a(__4B#jG5)V55Je@fCnSQj
z!QhmH8QHypf)=BT-0U5(2}HqWTF)z;%;~gLR+PKcS9(<+OJtyFe^BQMxw!Lq{Ny3=
zI2af|c}{-9jYs8ZX+PrL(_-*DDzqLz>E&hsigrK}?lWIas^O$PyHPZc^)n^T;8((X
zS_Ivm7Dl+cuSuGP#d7Ngs;buZ+TVUaf-fmCe6Ooi>3G)7qK~I#<FBXX;4I%Vx1DzN
zDhiqcf@!sXX<hKN#IKHyvTujVNCe{R8jM+QhozBsvGJqs?srd%pn5y3LAUgLjTI=;
z540?=ajw^raBn}jx`^R(y*4|+jL@Ra({gd=QTfROV{s(TwesCF^AqkoHuqfpgnLhp
z!SASe!t+M=3_u=05WVw7>465_x>3@AY16HQ_vGAlV@gxV&$_|kpF&S|-6&IIY;QkA
z0!QSyn_e$8f~a<*GD43!PtL`?C&%FXl;|%m<<_1k?OzVx<N!v4@{L{&VB~n{KN9(a
z{QmvubMyy+UR)$Q()7cY;ezuw*F<DRh3JxKClMR_-H;u>XE2ePo;cpoufHmS3n0Dd
zl@Q*ac6Zu~hl%Jl{l(C9b!yTZZ<6V?2pU3D+b%~_#*~#`dUcO_KW5O|y`IFg(>D5B
z=5OgXqd#AxsM*?TyXD@xps{7y*{&az^&ryIYvcdiBYe>-Aq@WdTn!G=+)pR|;$EUS
zeEW<4fIA6v{L5BCczlmanc=6OfrfZD<fcCJ1toEgEg|;0L6gteOy2)(B)eTVWL&M+
z+VeH&R(s9OuNx>PYb)Q@4Ticr+Ouvp9^j79qj%kGyn@vfEWS^P{vt@p%!$(e<@fyQ
zXrO%RY3<_eB*9<V9$-D$UQ-ZszmLEQ`g{%cX;emZa)9eKw<r4cgR3jEYI<$sOYR6Q
zYBdFezcDQaFCoNF8r#La=I8KzPX2&94f4eA*mbk`9TiV_9?uNW4LEnK%AGGrkM%>{
zuNx)JkX1Gk`Gfra<fC5#x?LZ=c)Bhw?=`Th3!12A@y!?4Ll7&9T4W%n-o9ttPVwO6
zg;X5Tg^I`RyGIZ-4A1m^7V-fdd@27MPt1o<yowJII7$X;3;+_ns(4o66`Zo80}FD{
z3%l;=Hsn;K49-aUY@xxXed5*&RN@N|jtv4ft8vnQHNmvx&^HF);4n^r1#Gt*=&47l
zQWK5y_G7>soO0X}X!m-6iZ-(!W`xLt&l)jx=L1gov}Srs!aaY2hy2br@v!ZOXMF}A
z*GYZyvYzSSv6}Bu-$QX!V$&D{M9pe^z{I7gZ}4@vG{&GXaQ}@l5Ol{FG?bEXUk{p_
z>hvwI30e!DhV6&?&esN+^X)hB(dIkOiT^>Bs%Kt+chDU^^GH04FLuwnS_wkM<=|Ec
z!K$tG>Q@v2@FcHw>rY*!k)+b>7ONTFo#jy%!*KDlYo+C-lN7(hO+VauFugXX$BfXN
zG&3LPT>kd+=gzU2Z+GtR`gl3<V=P4Z2kz0N-&f&dV~hk;_an6`?IDPf7=6b`90~V9
z9)6OPv0>`|7VB~(FNncqhc^8>Aw7pW!eC7=>Vc?yfilW_hc*V&DxOE*BWmCy+c+|c
zb;gj+9Aw^SDD&*lZ_y+B`}IU>`}@}Wwr`=LpW-m{g`?YsCTm^5C8pM`AztxGYSnsn
zXpCcMv{Xvixz0m~Jr|B8d82QX&A}lEV;%cVgR2zE8zQ`W_5B!N7jGdQtGM<W8w5ej
zzuX815|@$H;^qUP$V*2#JM?oj(w%R9KU#R!2T@JAg;Aaz>Z7jsePQ4EePRwOcMF1%
zlSracI;|vwM6_kg&-MS`C8eO-hS^al&3|1{m1oPo-ExN#P$>~kKmHgkhVRGsaYDnZ
zU83CVynKpA+uyes+`Q|JjTGZ&m7s%`7@rlbuuM+gA8!3=;o-a8?v|?|-<{>r=f>Xn
z*|odnlI#w5{V?aj_1c^sGeUFH%zT`4`N!zSJKyfy-}Uiw;#2hG`M&ba#P7lEyQ2bY
zu3<~9aiRi4;hV`wxKHx%M3bSAn#%c6KyabaWHU>&%@nHhF0CV3eaD!U7QaW63A&@n
z5;(}+*O0+kA`eW<2!X0`xPCm*S|-{^z85<lzpv@qt3nk&=EOs1XiNw2mPF444sH10
zswD!i`Lu(|<=Rf|3vt$J#!sa(yk+}|Rx>!tIY-ecR?C?y1hkGZ6paxz2PK9rt&P0f
z_!h;c{agEXYZdGJ9mR%usX_G~P@k8Le~x-fuwZO_$>bz@5_GvFku-yzny%jCwG0xy
ziO8(jzDL6ex})KAE$r7Mfp2}c+;~E<4|8dK_ZwT`i8gcn=J&_~+22Q5&$iYRWqovB
zhVZ`%-sar%HTsrj!1KP%@;cUa+x6k~(<r<~D~OBX0G(DG?K^6s?Jkb=+mV}Egi8-a
zqwUrsT3*`dcM)xX`!=a`0bc9HTYASS_#E%N$hlB^@aL$#&*%SZONKU3q({yvBnKq}
zsz#<#G%he_$shV0FZi{;uj70VqD{pE>I=#U5V;qfwSe)URVDI8-+0D@BXAd~sM>PP
z`yPpL+vnG@=XeI{k;HAy|2f`rkCWf`D|h$2&^K3VF!;Q9G~eI--gBQj@}pP1cQG$>
zYOLS7xQ3#kNz}AIVS;MZ#_FfXB|c+jd56%aShGmj^(Q&$)Ms<w5_TPv6gNI&-I5{C
z9Omiwl{_e{J#=0&7*{V|)4@wIxV)i=>xrBoq%T3`U~Ef1IBO_Zlx0gi`osfo9J^&o
zOek6oRZbW*1I@XDUmJmmx({cZ|5dzlCI|1{=Of>F0SC)I7pY%76ukuzr*m#9oZ9{U
z+LzkSY7|jAf)B(diXItR3}~UCOHK2=VK=H07S$N%^EGzXEXB9nSwCcE+mGLSe-0Tx
z`<>#u&(Hb)6z5ykGx1ZLui)PI_b1%N1#kR~3qCl~sn`Fg#+Q(@%}7uL%2&}x!Dx+9
z<*tdUTU%S3op{5EDH;J?ByIxnt6=H*9v3X=_qbreHBw`(KWu2W6<A!7yqNKeU4F46
zW_?g9uKwZL9Xmo|DN5u2G50RJmgO*(*gU@?z96CJmNfRvfDITuG&~9$Xc#vK?TLTi
zT%;b0I{QYJy93=(KvhMq*r7u`NRbpDGcLF$G`-e+E=k`tG%h%_TrTvA3*I=#1%DSW
z+|&iG5}=@MM?1a}xrh3U^?f30k}rG&_2>W>g|r>KKWX8$)P;|NE_sTJu57O|D1>9@
zj#kUZ9iKHn?|<&={r;yB&002;-~YOn|IXol|LfW!1`U**#|0(FAH;2Y)WsbWE~l;H
zf-swSJgU8wpo=iAa4|T;M90V>?{_}5t=xE@5(l_>+Y}d0S^FafgPtJm<JYHz{zd%q
z+W&8H7d`q-ytBvCK<RrQX>;Lck2dc12qs(HuY+rk;7$$w#Ja6Ls@g~p`S!f(T8c}n
zc{A$cpb3wEqolfji$!F!+zQ3N#R5e$*8441WfPQF_ZE93*}FWv-(oeII--Gxe~Udh
zzr_N5Iy5DIiv=2GS?;%3%u*Ee@EPqbcTl;}D`I>{oon6EmD@PqT!BWI&+g3?JM)Ct
zwzqM<xdI3M&Aqw0=y!K=480@q7d~~Q887xLoK7s^?&LdMl(CUX@~KXsT?<>zixX2y
z7E6v2Sh<gde`FG@?{O2Y?`z#}+H%f%Giiawcfs!lau<#Os6bc0)Y|Bk>9BERUulIe
z-XpYTh%=Yt?2$+~h@|^n9C8vd4*p%-Wo<YKZ0LL!uUhZ#{@U6|&Rmna;>A$DByR~^
z+7(fIWu`nxc3BxA0lhLw@>x8-_QYLQ&e>0N87gV%EDom|j&PTEKzNj;L+uDf(fVQD
z!M&6=?8X+|W>niB(N@;WS<=SulXf{0L%nvepIg6H%WDp2ZM~*p__RT4No8E4p#N1@
zivquxtG;aMJJVxl4f=FjnW->qtG;2$Y-9zm$bHo)dTN)i&1n>bf0x1aExzR2*EjO;
zYh{e2nTdL5j4b@l7$H2BY<mQCKdOyWRD$aJJu3g|L#Lv#^qI-_X!Wa=?IB{oUgp5#
zP0!-&<nWm>V(4eah~Zy`BdVZWqZGN}W8QikdjFUO+Qq<F^wp^+s1G8wxMq`=b-VLO
zvR(o01Eq|SgF8w2T_%ag&)x1bOuoZiM#{&2e!b)dnN0uZ<Cl-DCma74xSPSk-HGwI
zsN^d;VT_>G8FKAgsM8)mn(N%XR$EWY8xxzop9qfD7r}NF3^t{|Ou-`m=wvMPvK}`6
zWv3DR{P<BC<a`Nr{i69Htq{wT7kw*#x4}m}(mXM8jP*nd+Cxk$yDC{d0gsaPaPWIa
z38%aGWj{Z2kK`D}r+?-iE&Q_YzQwOxrHOy!Ds3Fyu1fN;rpTfYy}kQbQ)FTY_3@51
z)x3?mUpZ#1X+x2s9Lt@nv``;w>b~BwrZ)0CLp#>g({W-=nd-yUJVQoZuF{bKE_dd;
z943#WAM#sn(|0)KJi)gZ>#uO13q?5UEtNX`#UkF-PSl1xIj)>)b&_gklAPXhY~Nf~
z#*$b8ZRJ7*lSTn?qOpDELK(Vpp_=6k($@&u&lZ88BMU2<uT2i>8d>(Z=at9Qv=Q>8
z`gvx~Jo?AQHNz*D3w60r2Y2iDU5=E;&;Iz_sqb*gsXFf#-{4oS72)SJo)}?1xhF>0
zpYszV%=~s@gqedl*NXY=*q`p}ZGRqqWBZfoVEgk>%@*aEp+{Y=)v-TGUU~e;w|6<Y
zCFs)qDSOjrgq@x6IE1YBFC$w4b82-oZz}*z#ky~?t$>wjXmI6hg)0}1vfj$<@6Iu_
z?&}>xYa^%OV`wirb_}hfnlkv-3_Z${kNm@T)*#_^<oL!B2lt%i@Tv`se~CK|UAU8c
zjO*)Ej6bG_xar%EHe?q)WJVgqNA>xj@268Y>FD>=)cb;F?;-W+Ic|^Dec{|tC;1Fj
z$%hspwYBT(CZ>l)AL+;?XG296kD2Y6Q;OSz*`oQ`L3N3$pK?YkX4w0Uvg9ND&Y~s!
zthc{`4(@L<hc8|57r46-cg8SFKE}^!Jh9Jwa!>5DKj$a*nfdL+KD&%&mlb{Z?ZiI2
z%<3Kc%=~s@pFJHX_L-^X4DT~TMw#EpPW&dT{8#w%gzza5zsE_kzR1b9>{eOq@s{0c
z_@z7k0(aT43%|2rH;y9oBVRgbMZKjyE*-RLFUs_xgCdi4^m^%_6%~q}tFqidFCCP>
zK02t5-0G!+Iyy)PC8|l=q!}{mvSAPIvNONSl4Tq%aANt)p8XELvTCOt`YnEE+in~s
z*{A-9?BQxCmM&V%LPFoGJW=`M)I%CNcc`VLnX<Lk`3@w*Ju`nc6{|((vuzEXuX3_M
zD>rw4jX)we@8-xwV+ZhN6bfDvjgFPYtg%37%xP4I){}cRvKfXI>ATS@+jil8{l3Y<
zWt{hivvVDObheE<oo!CSzZn31hDkrCvq8}xdH6R2<l&-+clkgmJNMuy?2L}2?#%#s
zxN-+R{>=cgAZUv~|7M^vq9R6_-wcjKd6!G~n}O!|h8piTgM;&%0npg6^!#Sfv^|-{
z-SL|N@Yq_qbC3~eoUST_A9>7#$5xwvGr%6ev*q6mfQGRu0+No2;uWm~|7PHFvRz)c
zp`Ur+hI^mxuW&lCl#}ix0pZ%nyG>qu5K&>MFld~pSc#gKjY0!(-tV_{L^m2PU)%dU
zA|KHAL%A63gg+&Lp)=02_Nc4EU!!$iec~Fqn@>m6=fmW96!A|>BFQIZQ(diM)%NJv
z43YEUQ6~uweoIoqX}z69KDd|o4qv*|FK~B5>>3Sx^Ljj>OPJTms*1~g>11ePCD#3i
zPKGu|&xn^!#x*49=3VHelW{GJqm${#JzP4Oql0uZqMB=JoEdub+`NQ;SI6TQxXGEX
zZ{*T{tnP9y74gn!9W6Qs-f=`?iA)n53h3i;K`VSX3k}tpU7<Tw?uH^TA!_eL#Y0Jk
zi<XPxO!zvZCW4{bDkR-#mg$5($2fREmG__#5V=Hn;1S^VJ-)}e@$;+bp{?zD9EDNq
z@EgkWiFk;bW1QKe_q?WTxRna16H$jlF@~5}h;F#Q?hx1G8d;1q(c;Gk9Rb&I9v9Vu
zmORHeGh~$4b>j$$_&bSVVe7<r6&bTfv0p@gOK2v+(U*tT<u75+(PpE#C^uow(Po}C
zP(RNx);bZYYrR(0eZ6<UjlB2kqGRu_qk5kNH$z6(di?y$;dmm2iLL9j&*k^HTUW-<
zuWk-;6mEXH=Cira&3<#LTdB?0*Sey<Pti_%?rZE#9{0#Y`=@@;fhc@fp`L2(%{a$6
zGh~$4b>kPGGJa0+{zWfI7JaweS+ns{YR%kBv={jYZBN!&Zuf?#9%LP9spY7WF(Xqc
zG>7MsM3=N~*8@#Gqct#0!cB3aaBNxZw4T@$wPS)_FwI`c_0-pr^wi^WNY*4kcqF11
z8c@u$YYRK!r_k)wS516+;^J)iXHjvOhx6;h*Ht5!ZnSjmED>+%fT#pKz~0g!7u<$x
zlqDSmm77TCPSQb^vZ#@ENr$YBO-l6A0Xe~Oj&Y>JMlb0=Uz2p8kx4o@I!HPY)x_^K
zLq^wnT+(5$-<QWLQdX+AiH({`U^|1C=c>Ca2O9lICo1aE96Jq!Ea=%mtWR#;#?CVL
zf}ljjTZuY$MgUT?(;6UDlx{x53&q%&T8kfFKkC)IM@DGa(;OYjWf56kwK3gO(uJa3
zCU}-4|7b-Bb?1+8cm5bZyF*fxc9Nv1+jo+pbV^8y(upD|>dqfYQU3Z!Q6Bk7QAY<!
zQKFjUCC!jgK7WL}^G7(iy;yTx=)+Ho%_KvQb7uznXW2d?2x6=`Hsl%E7-+qf!(69Y
znxTlvY-_D$HEaw-NUd{LP*$+&FKUC#N9jNbl~nbd;n_ae=|k9-tm%iWM95XQ^G=c#
z%P`U{h2LbhNpl><WOPRj@2}nTT%<DC>^Cm7z+Yfz2em0;)25sSVefX%a0?ZS15-Sv
zXW<aa`Za=^=NL#8Qs#7MmisW*IR@bg6?xY$?vW8dU~SHrj)2xfV~#;oqt&T0IL|N)
zJr;_d_1Ng->M?hczfR~JlP6k6T&S$|LeVC!FYYam(HBtWYL0Pu7gtxXHD$DE{$IZ&
z0P+U{`k`GC0Qm+b?XmOFE~Y?{+BWHH=*GaPO6>t(i=HUiuUJ#Fu|)xpnXA-Bosy^r
zsmLE=&I?^9B%+_8-9Q`Fu?y~M|Mi#M_-HzJj}rct?bZ8DyI?#@cYrQo+JOuwm)Bg^
zfYL~FY?KXDQO$R9gug+r3`PT*yY<$un;p3m!i2eBH@oIfg-Hp#;@Qv#nd#a-Driil
zp(3MVTyu|z&NDo#Bc<EjncDms?QpG?x=gq08x^5C2A;7{iOqkFP(qzKP!Sb|c1@w_
z_IoiuZSQZ$dEq_JF_7^b4HbRqF@9te&zf{bHvX&&(2a}&6d~VqbS=v;#~`XZ8vU*F
zv}btEDzAq-s}+?<+WmD=x4=Z@jvW()JAb0RZaUCV1nw~9rM#%#I*Mj_h2Cy-osUb?
z+2`rfbRZc@t#g!Tw1qAyLcHN*4)M~)zYG_(wte6Q{*GpRz4rIZ<X;Yx-%&rt_8k{s
z&I?^9ie&?zKRmj$kS89y&8H%!MWrRsF?UkqH<Nvf9OW%TMQbgONuvj0kNWkwlQr9_
z7>5zM<=l0%Z@GBg>`;!wF!~TaYPv*3hO$W)y1`*%J!8pMw8OM9aO~2Yqb%jrQ%FL+
z-JA19-MWz|DNw1#qc<u^l8s*yMtkSv{DC8HqoLxHSr2l=6-5iUqV2K+x<h6?$<U61
z<uj|~k=ffA&}_PX9g#t5ydy>%y3anwf9Uh;(5Y{iX1u*|)we;cvJ8)s%MvX7iy+l(
zLr-6ZNbQE7*@(sy>Kx<DoY1{adb=MS4$M&J`q4gkeCwzOXB`!2)6rQ+)hvWE=5HPy
zRdW`KjX`G?Zd%QJ_Gr@TzRz`%5s8dEx95i+8O`m}xap`!u5XXG==Ds6(d+ZW&2XQz
z_j9=|`guK`75T^G?qo6^L5)(brKzf+L9;Csh2Eq}n?|M!Q_Y=^f2W=o9v@rpj78Q9
z2od4Pr2)z(aG~=~+$VP7Uxo*>V0jeW7-4>Wele<QztBUU2!<Z*CZXBTEkHA8lust%
z?gYNA_t&g*dwX7*rrb@>b8HBYC0wnxR07_|)K62xlg#dr?Zx{yJV1z5DocB8W#Cl>
z{vwf*&zM@`@@XS5xN3V>Mla9v!kvftJCC%-Mb^H0s=vdX2itb!d;IonZ~V*(qsM@1
zRlEW*X*Nf_*DK<+MJr#}>RJO{(N59J?Ai(M**0`}wqtM4^>u?c3U8ylZ$Z1l;>E(#
zfxBQJEXh$Fw0-lqX2|H}*$&Ike0jDvj#nSCOQxROwKphynW?3xEc)bbH_vCqAWH)m
z>j=GX)qAR~X6DRQcw0(wdhu)<I(=8dhaR^bKw#b)8U2aoezoVh>CoLx`J(#pGS86F
z%d@?3=fVEY<L&X3)2k=^JKTB5^YpZQhu@y_jh|U5hqovB6;OGQa=6#4+CLnA-&E2d
z(Z%hA_ne=7Lo(#FuK8;bvDP`8_YE3g!t3Ql$Aj|Xh@Nm%<C$2D^=pQVI?wsSZ_hd5
zhfDB_Pw(TBgrF}PXFIuxumN;3c5*;x{-ktC<QMsUX@=&1FKJ13Bq1XCo^VCQupE;X
z1T9RjRLN*huBez)+N(w9BNGl&ve(d-ZoS_J(9BG((F<h>!S5G*(ipF3P1olrLUo#Z
zChS=9qA!nNC}P34XRwLx(rxEa)neEjh0=Jxuh2<b=+w`%#w_@+E8-i_P1#0{HQ0$C
zXcYKCM}bWmZ>s6N>CBK(K52w|PIWjU{NFhK;9hb#e0ku1fjbGb-}89i7(cUuizMk0
z;}w8;)M}0QdclH7Jr2KbcxMoO{(i|M$<F%*Cs-XNU0>sY2laE@zR67@+#jBsjsUkM
zN+UU{`Th0GkWt<@ejjED!T8}4{l#ZQ&rwRB*0c5er?WvTx5=$&y)<Xu(#6?cQ!sSB
z-pE~7{MXn4M6r4~p!<b@*NYC_U9C#QRP%fOnIWSr2ME74EyB~2UNyFZd(DsV6aVlF
zoHR&^m*9P4{LD%@yr$t-K;?l}rSj_q>48!Oe&1BmXy->KkzeHZ+nZ=f;k=249`rqA
z<N7B0$Z1dJxkn`zwQ?SGKT>W*A|5(yn*EK^(4cVQMe8X|{AnA{&+(|LdrIFN9x-1w
z{{FTK4{Su2b}Kp;&YLUL()s2(QZ18f`_SI%c>Q=H%H$YVw5LUTE9o<?R5=Tw&^oqo
zew{piG|q|wBnV=3=>6up@cYem<3($Lte4xVw`N!sB}A{c3W~C{`PN(UUiF}^z0+F-
zMX{~VH&;V1y_LQuy;Vmpy2qrqIyy*iC8|jir5Q4My}2&@esf)TMaW}@$W`BBMO9_n
z1KHAPBcuC9HuMoowk>a~98$ea6|ck2An>Njkl{%2{xYADXiHDAGu2Zo8-IPfO(^An
z)Z+O)T6@knT~XLVu<vCH)Jn=IlL+fp(PzHd6Ax~5z3Iw<e6FwYbf=CHH!|MlQBaQP
z&@o=#dcO=Wh&sRLDT`4%>SSN*0$g@2-Rr10$`#SND=yMpn7R60BF&$6l+gRlc;WY(
z@y5^TBKv_(BH0h_+>-r3{6qEwafE*}KKw)W1Al$&2jU;H9~>QIKM>VqDbNfVb#KN8
z_ix4r*9eimG;4%N>&_q=8s!m{K0M<VlY?M^u;&<LyG?4MC_=DxYUoF55>{^ZH1%1F
z>o$2DQJrLJogZ(>Uw_T-M;hz<pmmA$H5B#V_3laN&8Gf+G*NFg&o|~0(MDB$s3J76
zJa(7#v3;u_Z_i(U&F>#<wtfH1yC>r}TRJxzmJPfX=DQu;f^T=`=WY5Rzi8d2vRyUV
zZMty%&GevPoT6f}scoiCJ1oCa82U5vn$Z)KjSR1?tr^K~*0S*O%vD4VM77^Un@ohw
z+WWJ%xYGCgqIH}tvLa4yMd#d7_Rcl*HeGn?ed#ZvODdlzE>hZXG;ka1T!`VhUM-%M
zEglAMqN+fsU8VJ1^u&p1O>tSQD2+Iyo#fKFyvsPtB5_OcsFNHViNTV?<Dot)ielM=
z8Er<po-DElGoIUG>9;)ycW5=wKiPvEDdHrDp_e_#Umtr=M^3$Yd(hKy>_MiQB4^GF
zJ$fVu;ZAZ8Ug6kA)`dz~Q5>JC{h&a*&OCwxl@8gjr04IK(L@o|$nC~RuyN+u(b926
z^&c%2Y?ZeRf7C&tcnw+~XyVy!FyOh&?;ou%r#y?83FIIv2clR>Fch^%KclG()msy#
zL5AME{59S^Mtl6oq5*(^Gt)6&pYVSFK{s$=-gM6sUVgcd(!DNk(PZoU2fkcd_oX!<
z4b|@wS=6+nggXA=NIK>pkFV23b~&9yvdi7MCA*yXhwO5WA#|GS;UBWgeZ=9i%ZY!;
zE_Za0T~1VU<l~v4M-TrH?)Zmrjn;aWE-#l~o+rOOdI*&2XWpd+5kY;=QBIucc}Uwv
zUY4#?!{3>NMP-EPRfbMHwK-YS6qZe$AJZ-r7h7vtPAFJ1Z(g}<w3d)sW_9{?^e!1=
z;~!D4`}=5j48HHvViP;Dm!{f;-fUt%{jfOO$M%?S!IwMpGr|j*Y4JpOp{RFa++qb#
zr2B`xYm2oR?7l-8FPuVnONWT{6`ciRuNt1@XK|ktRI~^y!V6B+aiLd)*T$jPj};}>
zb5uQ4j=Eg1bxb<iqk1Spg5~mzE5a+IQ|%9nh-g!j!VGsz0Isah2roldgjZ-EU!y<i
zvqnZ<QZ}?z(}xk1)E6BUh4)N*wgXw+`<liqjNDdS0iiC!YvLafUJLI7neK7=`_Xqk
z&$zD^ULw2<{rT68Thz>oO+{wdjGGxPPx}rc*Q6{2sOVmVhi67g$dP=?#^u@@3tumu
zQ6p30JXNS6JR=T7(^MUWP9R5+E%c5cTln%{gcPoGj6gqB-L+p#T4G40MA7PYdNQBq
zN!w3>+o{;ulz&*O_edaw3oa0k-VtOI|A-)4IBKe+;_&n?$|Y1R76zhsOwU70dF)uM
zP_}1KBweyNn+8s?dnbu>2|%GHl#d9qg{}y)6@^A$w^@qY;(E$suWsOXRCZESexk)4
z{Ut0_EW${ZDXTXaK}cgokO|-9exX+c*~U>`1MPh0$WM(H1@y?SmPrTl!ffsG1NC=C
zkoByFyhi2qtU83wF!$nl!AFoCUWiD>$RS)`Be|laWay*y_!KQguMXwOG19Znq@2B{
z8eYN4&O@USWZmo?Mz096<)67D$Tp5vsT!o9s2D2UODP{gc4V55AT#_kg6uooMVz5z
z;`3uhvn{O((Yax+c*dOK#@{2+kOW=YjD(a+vXm8}7NOJGc|&Y`HTf<3nXVJdGK|kR
zaM9}=zI`Y&GFFvotyE}sGuj>*-iv9cNKeFkXRO?adZWRxMo(=!;m9@I7E;nO=z7L`
zh$=UZ#{g%!HC3A!^$~5yzu+U<2p<Td>C=J>Bcy7#Wsd5&)rg;Nei6h}M|hN{g_N{x
zyh_0sZH%h*<86#1G2irrw;1sf>e3)GioUhLxUMTQaf00eHKX!?S+B$FK!jbUT(_NC
zLwu%;m4DHqw@78~a);*|<r|Y?rreE5c*lWM2ermh)fpoSCtxbmj*eA5)!GfFtQaFW
zxeI#p=!q3WyUzF;Vd6feX3ZAqg%jBHkj`k_W&gj#RDONn7QOprni)zgS0B||hTdHh
zmGhvpfhVGb{21LaglO*?z(vCv3&(I@3r9ls#9K*=!~2ueGl|nS`m=Gd8`YlNvGbRt
zxbb~^U--Vg9i9<E?{Q}#A+&L34lv3$@4@}e%eZz>S=O4!e&{sX<3jF|U?_Sj%o|1Y
z>-GLwP@sL(dDB3w*qst<S&_}M=^r=ELg&pZ*OEyI`Wk`KYE}X*eOj0(I$+cx8um$J
zdf-u$A=r(K$Ba?4-I_b@TFbDfI~x1Cc{h$EAk#xJvV|@HMLJ7gbVR$4vldl<*3FAz
zBV%bI>N2w#K5h6D>topso%<#1AKLY`sQInx9gANSD}KJ9iY;o~iba3s`4#~nx5SwG
z)4;v&EKJ+2Cnt}(o0sfMck>dik2`rqY!!q+o8(2Y+G%&n1#dDCr8Zk@OJgff2~%@M
zP<ox#yol4sOH7{|Vd!;xZ+yi!wx<3>9tCBg`uatvvvHk;k-E{>TUa*jcex%&SQ+X)
z)9+g^OIB6w-lC^f%+j*)$7nof`<87E2fwR-hI!$5%CK)pm?<80HzxVj+>OaN9Ep~j
zfESHw9zNJ=aHuc4si@_Ov<>jqmetv8acDsOu~<kr&@DrZGl=M3T<A}e->9Q-eJ%34
zMe`)%Y4x#@3ktn-v!ElYVoy5Yy-()%68xD|bKVp5B+E@;)LGVq>)9;xYuV)-_KDC}
zbEU)lhOpf9;b2<U=mHhC2BC4VI>TsZjc)!IJ>e}TzV-AP6L0usGyMX0G4u<+W9S!-
zNb-O#w#vz|q0WUyoeRM`d#7t~7-H0A#mkPN&-ONlh<0>Xo-u`TNv0Y7jzrPV7<xlL
zW9SW^G4v&cdW`~?S=P4;`$dyKxuNBZ-v3Hp2)4^wkR6?u=WI}+Q{OX62s?&8Jo)kH
z9Yeox7peSRY`w=rZLcx+gzq=LgYz4oj$SPz`@HcX=01g-ww5>F__~$|Yva<YwKPij
zKwZo|;n={fQ(G*c#@s{RZ#q<WM$G-AilmDL)H4Y8^UQg%SU@_l@8|xFBZAgXaj}4e
z=MxL4w1}M%%a43w0TqRtxcXQ?olmU^pSa8dQQT`+8;j8^JAv>39sLKt@pNlTqtPGd
zjR!mPj9PYN=zQbpnoX?_;`GMjGA-Q6Y2Rdbw3CB?2!rx(IK|u_+~+bJ9NlZmV_6Fw
zu21zlfbC{pCt9$Gey@C~cV@~f!r-wai=Lr!CiQnBN}-21Ght-W;+@N|&^wo5;Y)9}
z*Igb38U6PDYQLzaNYM)`s4r0I3%xE~scFxxIh#;@l-!(oC?0hZg7ELMmwtiUIsW?Q
z+<)1t@5vwWStyiO;&zU3R647DW}##e_?RmmuSH?g7id&K7;&PqK_?4E&a>*^+8d{;
zY|l9RPpXEB68w>cve0|y7QVE!frip<6kM(WU1#Sn>LY|&S#_v(@94ws2W3>A4d<qu
znKOE2p)A~S#CO>#9zQbNXRUmP6UV*m=hsWVk@4<7AHRHfn(Vk=;BE#BcPEDNh^L-D
z?LlORCtG7Vxav`X8>J4le`KE?C^O4z2#+7mFLH}oQY!!ocgZVn2`=+n8(8SA4J>>{
zJJqOWJ&yv#05$5@FGjWTGzMy{GkWODa1De~{cN%Z*e+gKGiQ`f4B>a)65;JFAB^z-
zNS!To$3!e7f@dOH1SCAC{p0aRYx$vS9Z=bmXQHCo87d2q(3nNguFu8VCojo*iur6~
z!2MM9YpYY!Cz^|mfzYE-lS45E7G`Li&%wVuo>1}|DVe}&9FL!0-MFJLiGWo@%FQQf
z|Fvwi(CibUoox(SsZ=z)?ndEhg{$VLUsu$rEqF-uBcpJ1Z#Ny<nW=rOYmzgjhQFU7
z)C3!Y*JGg=qiVg!QW?iOAuBTA;&P*CiNd+s=NCmWk?{>>`k=_bQ|D)cdaiAbac0ga
zuM^{ERe9vI155|+7gK$9muGlR0<XtH_57ijgStZec_Q4MOB%=F^s990i9+HKnvdfr
znmutJtrT%8p_{L-b+s~#^;*{^d-J)!Xf=KI_fXxCBQW>(%n*esn~g#1vC*HNPd9$?
zDUCuWo_>+|!_i0FM6+Q@cV_-3|Fo*A=)8zq#am@8@c3c$e=Z!2;Iod?P<}*TWFthA
zs%mmmAgWD66JxOlQKJw~Z1xC?bKIZV5jWwHO*Ee=OX55aaEQvhr_4Z{Jy5h5t!+t%
zme#2s=w&-`G@vj_(BU-3a!H5L@R(L^>5$<zDK*^EA*+jIc&VXiujTR5LH;bJPk3(W
zkl`XJ&*P;7&^qQATRJ$Dq=Un^bZ{eY>EP%f>ENi|(!tGeO9!_eEFF0LSUR8+fp&g(
zG6sFTOIUXkj`l=DZuTvlK#NnmR+F`}gHBm>%rk=LbbSlN`77&;AfQL1tYblU3X`sk
zt~0D-6W+l@_BD+>wA{o*7abLmAfwK?AG*c*MH11R`<dnQ%yJuUMM(b9`thyL>&;S>
zcjt`4J9(ri?>kFTJ|#zr@`*Z9lu?$V4&SnbM?P|g>0l|vR3DkfGd%K-*TYFsT0bX6
z!R@u(Qgq-L+0HZ=C1XrEB1YqqmQ72*=ouME-49b<){*Rtbdml2nesA)dCv45dTD?)
zhc!mQfiYb#&O&;EYV4$bjm}{67AIMW2r^w$j6sqWZs2U^oux4J?^<v4oOhAtSy&5=
zT<|xKrXra%zwn^5SF~!w2|;DiTGZ2kTL@_gKv4(1&eMP_iCk<9RN}C+1Dm&^Sg)cY
zq6~$9I~9lO7zpZn`u#P8TMGBci29!+J37$Gy@Z=;yg|<~&I~<j>!D*1jzHe9zOHeO
zjG&>mMjov%^r?F;c%zzQv{_nE(J|(l9^TEUQQnI~F@}a%cW)&?0-(-YPnR44+AUrN
zXt2}ZP;}-=dGA-RXcLZ3<g*?2mz@RS8KoOWUkvLktP^4%e4t&;FB_ZjhPyiNu{Vy+
z8gm!$tTOaOrK~UH^W@ZStDT@r)Vj||%(hkuQz&_!5jet|zmwr;iY+-**A<a8?Qu8$
zTvrhX9*5Tg!3=5Y7-7-}FYYK?A8AXXL5pm*-U*@gHU=EMGXH5!4dqFX>cjdP<KQSp
zQtiY)8mwZd+(E-;{-D^{Sm+p2>HtSuo5%L|nL7rDY3_P*U@+%72A+b9=8ft)A-;Kz
zeZEG2ji)}>$f&tJQvaX>!YzexQB9|kW=N=8561CE8rR8wijAC5<m*`@%VsSbx0i8v
z>6ug~6i(BQfI!2tB9ErS=YupIcb-VoQOWRx()=hSMUqz6ctMRfE}64=>FWc}dLw-K
z{e85n`=kZM=kvso6O{6G(%_9>r-4wG4RFn;ux_#^<#qnT+)1<s9bxf7jV6nlX86qY
zhO<4CFz;E>+v+?!(R_@2vy+_To1Nt%-|ShN-98>y$$+HGX1`d<lmWOd=eO$ypYktu
z+cVL1+SF6{CTvJ~{y@(?fg81HU<e-coacyfmM{e=#Wg+c1Anw>y_a7a8!xA+ndFiG
z#Xe{yzcKohm$6r~r_{69+p?!p)%{T)VvdU+niku2C>(xco^Zys=jCIk%HgP*mW`70
zi+Ipg8SUt+GPc@=7@KCJ*+51K%^Z*9!N#C<+9-An!I~j>{LABeA8!2UsL=7}=%k~H
zJy0u>$SxhVBPuBvesokV3{Xq=XRvF6ap?C+wuUFq{dGjkzHpBm5a*sg=x8V@*X$P$
z)qDca4ByVBomg6t^5~1Ao>*S-jqAyTxVXL-6fX!RO%x=~y+i`BqR^Y-Jeg>JR_549
zgq>rcVrEJcjiyCAbe%vQ<KX+met8_O5VP0#7ja|Mo-g_mdOfE#_L)sWX}ib1J~Ka3
z-ElDA4YaQAZg^X7?Xd+9eDA}biGMs^wMEaA5rm`2tZ8QIukY1Reb&-d)QV@#P`uSH
z83FJ4Gsi$Ut!j>zQT6n0Yu;+IF+@>`8nts!jDhyHDfGtpm&bVp_%}Tc?{!VxuP^kz
z7VYcpk<hx@L$ep1{{nbQkIC8X?ckL<o)L$VAI0I@>*7Y<9vVjn`EwlA+xz2Yc%(Y7
z2Wh2l{rGNx7S^6ix78?unAVNay6rnmq12wKHOD1?3U2h0)}3K<M;jnm<x3w=(fE>4
zI^m4FeP<kvd*;|#8`V22)aZMR>g{vUu@MttW5}7GI(D&MFsU&oxOLj7?!h^)j&BHO
zD@uPe1aFH?d|-BrE9Js+OEZ}M70j{*(=OP*f;B-<@6;})e}z}-_*WQZ|BA!6Wap93
zEx>f}oxxO}8-{0iZX;d~zPn!K)T$JyzGIPwuWx4y$6T$4lX{w~-I`BVgQ1%bJGYXi
zmns$%Gnj8Y(DQ<=c~LR1-ti#HbTzGYOkY30oh|f!J6rhmc6Pt1h0=eC`!|qp-rziL
zcgpA69N}kH=MLf(NJ!Q}+dQ{k3F*g=_4cyW)%ZE^vk0V;ez=_wX$b#gxzOuvZsSR#
zp09mN$V3(G`l3UdK8%ljONefUGs?{n={M6mOY5=G>uql1>kY}?mU$E{V4q7_zbMv=
zz1^T=TblIs$2wK(`%luiVw(->J1HsxX}!(W2enW=dcDnU9IKl4OJ34Uc-sNgJMeTs
zTME{7+fj|()!uYGLpllmZO+iox4Cnke(`44#M=24?$7-<Z+wh1U-8=?<1{PcT3P|+
z@KCOOQ+ZJ1$G$xpD_yUBQ%NIwk4Nvfzl}#kGQ?}&M5=bp#dUPRhE)^w+BZnVgdSjS
zh7F#d^78iA){S?){TY7A0UCukN`Fyk_xz{ymFGhaU^Z#=OAcV>n)vrFzwPZ0FNjZm
zmFyeGLKHo<u#w9M(>f`dyP{~fJZ?}JSVEMcp?JU%hcYEZ92$$sFPwg*480`8#^*_U
zz<z!d^L(ur2qaz?Ls2k%(RU;Su2#+Z(%IyJp6Kp{7&BKNl0)4|b1&7Sp}OiES+h2P
zrfxGQI^c21E$x%GsD4na6=_~>hV)|YU)>G;`N6@@^7H}^!YluRJC0xYEjc#6H1=Bp
zG0u{VaherJDx4KS>Uz^o%Di59J5D`+?3>`RqsEPom?#?dbnTm$?1U$6k$UZ0LN7>E
zS@Lv5*dP64-=Ll2HOKE8MUeO?6hkiwvGElhFu8;yUk*nlD{c`z|0#W2LV#Pf;)Klx
zjmI5l>&!z)7kX(58!uX*=8^-t12tcA0Q;3w{g4B?ySA!4!*ddNJr;Utc>eq)Bw+p;
zzcjXm-<luc#3xRJJh+eIBK*vXBf-uJD2MlW?VHMj96t6<r3Y%+xt)Ndd3w3_?K7&Q
zs^IyI>ex7Pvk)GrZ;xp92?}M(C{&W|r7~F%Z_Fs|F}pY$t_h)ri#BgB_Q18wisITE
z;me{xa?<=PeG}5s6korJ4nc$Yx^UE(s4HqDbglM=(-=Z7!=grzkCLWNC;Xf2wO7RY
z;tDZvG!Im84L+~ariPQKT5Q62>_vezPI`4_y_H|7S#Q-h?LIuN@8Y4R6=O2>R-kP>
zNQrTJtG>9G5WU_Cbd<EBMyB5C&?{<W<6CdFkz?_CtD}STR!8;LTX}{@Z@r>Mj^65{
zMvmS(Dr!kBi)U%S*n_A|uJm;zpd_lI8I5~?sP8XDk#8$1Bi9hi!cmHGMr8<Fm-T(J
zIy-u%A|5?|sAnV3`a{2nK9TRc<{IetC0P&Hq(u~-GNV$SfC_zz<{5PaUtAmcMqN}2
z;b6x{ZC)N3-D8^C6+}nH`#=umj+)ugD%U*my&R%^ugjyQ{KvuPIx7C;vyOA!f!EkK
zzIF-kNm_Bx?I>yf9Q8u>x{G=t`+-l_8HG>cu^;%{vi-pPbL<D^h+{u6dPlu%eA^Gq
zKgWJxI@o?-s*nA^Gd!CA74>rL2Osrv><2`>gcgPyMdRTLO8qDrk-s~m=R#e+q#-K9
zv!Y&5b7Fa(>d4KaUQ+3L_cT<}LPChi<AE;nc2jlhnf@LPv*h=vdD?a;i4qM*6P%!$
z+oLr=Mz<)L+J|`nQJ=3{oEK{9G~GvZ#VhFVJnx>5=$Uo*^nv_P`+jJ>y>+ui<%guH
z_vMGb1yK?dC3xTO%z2yYMf`G`5<axB-@HwGiYVX%9vlhvnv_C0(8_5QLH|~l(r|S5
zTX^k#%}7=bMFR})8tpDP>g$>=jwBbkz;wNeRxnY1fG>NfR*V}n#%Jzae!#6i=S>>5
zkB{OFx#{bMl^Ldmm-Z}N6!0?aT!_x7=K{&Ha(E}7h#HcjojBx+&gifb>yuWzCPJ2`
zJt#6qwIDgmF=$;Ow&eWD-}d0eDcc?dK19X(j4?yiuK7Ma?Lly+2+=y<-om+gp&7(6
z`Fq-fF4k?^gATnU2gTe?d(cLntG(?(ri1N4rux`}JVTECbMb@69`x~sM?W2S{~Wfz
zM?ZzEM+(i9yZKR{%Ru=IJAZNm2nUXR^S;MJ;`^tq?`!S*hOKfmlW{|lJB4t~+cDf~
zJ55~ET@;T`oH(Ms^0VF#IxZnapICQ<=k%U3dc}io9B*dkZKjdsPR~6l7ZV)?qIHyg
z^Dep-&!gP)1fIn#y4MBjdO-Q%FTajE9(I3k>yGbJc+QPHcPZg{1T}!%j*=b4nitto
zPE#X$iBFf05nd<p*yVg~*)C`PId-{=Ro-^FLodyB<J&H0{yBEJql4^nNA<SL-3%#q
z+r@t$yWGc%AG;hk?=$0(j$J-L_4Mm&A?cV+4%U*=oJ)wf;#RzA(JV>KUCyz3(L};N
zsE2FoBt}u6H?ORzz3Dxw6X$jFj-pj56pwkHHO1@F<`K#h_FW>31iS>KNSBR&#O?3z
zHJ{zSFVm9Kn=RNG7ds@#_4~u$f~b$5?KXY6GiQt{*r2?`s1h!!f|fF|$ed|yYTz9@
zy;(%z)S)$fBhOQas-M|b7xAU0TO-m?&RCuCrJ?7S7*#`8jB0zz{WZ+xDN{97PW8}S
z@ki62HC1lvp@`{{O-+mH+=E4iiAfjs3};jmp;wIR#<gJj`nrcXa>e~%BO?ZH(xEjG
z79Fs$w+@bwuVT@ts0Puzrp+;`tgmy7D(mZ7V!Dm!M?vIjt}7aKgs8vh(G!RE7P~sf
z#xryJF=KA4NlompDA`$k5*eyPCA_HAR6Lh{aP2Oj@r`m@g%zhNdXDO}c-VjR?UGL*
z+%u>>aiJ~-mT(sXOL&Ew9v%sex)lwq7~eP4Z?uz{^OQ>o72i!m!`T!Yq|Wy>xlBi$
zF|aY~9Y7uiidl4i3W{-beu}C!0aYucQScHU<I1aRT9RN!lR}wP`ku67|IkoF>#Jz|
zMZ$ZopooKy>&EDhzF|1j#lRjM+jQb+#llbv6Vb^chq|FLR@-;*`!oF%5Av`r>i|pE
zW1Li%&{ni7+E;(Zz#6(@V6}6a`x?d1AI*o=k<F&Z+C9@YR65es+7MTqw4Ibv-BIt#
zoqC<&^IW`e$G~nJsa;h$TdQ>US`Do-+ce`TgH}S)GpWwV$*XdKju~--2i-bjU|~W0
zaDE#f1H1h;R}Ad-+o(M1kN4*|DFwYG<`>k(z;67CfhGLJz<w7Si+J4nm|qBPL4+vI
zm|0Zh8z!Z(nj3$QrPabvW+9={MAMqUdfuKA;<QzpnxgK+B6K4?AE=A5z3?&lPjRiX
zVLp@<$%tm`Pc74@(Gag?CqG+xT-X}20i)RoM`3uin@|9vnSV2DDU)KBng+|ZW@lNh
zrr|vXS4{5qJ6tij+wY(;xiX<^l&sx%j6O7V$YI{NO@yGL5v4z;cBYXgkNFY?(m0+=
z?!qn!HpZKtu(Mo5M7(CXY#b*PZxDJ1l%@@2@S7F!?sogj$*RRD6hfvQC^9x6ZO7(=
z@@vV?bF@-QY+?G9I(DjG*<+__)s>OGwF~*vLw=?YDWg7;?XXxM_CAT&pw!!vcrDeM
z>^z8Bpf={C{R39i4WhEb&L^nzMn~9KSkn6=Dtw;$m4EOpj<mPuX)9X%(b+&e>)oYv
zk5Khyz#$#h1$*Mtixkn}piNFgMSAl9D2~F|>$HVtkrOhbSo6eB_D|B{Rc23KI7teJ
zlf)sMZ*Pywy-=p+Rx~8WSx77?+0J6g%668ViwF+(qo9)IQ&wD%C}yJ5nA{ibZpv)o
ziK)@yrh)6n=7SsQv3n`yxbr6h>ePAE-82VB5fZs$i+x?AMIYlKD@1)|&@R7uWedq)
z*GUJ8oN2A#s6miftuigJG}@h$LO1V1=b1>N5`AW{jAni~9XaZ)iPza=R-n>RrpB+C
z-dZypIO>F+lfQHeVfi{ddS~Noyy0a@Jv8{mt~KYN<BSA%yUwMTVVV!3m&4H_LhP%y
zfv8q(-t{9*`~29QK09gKomV!~wmY*Hw@)eiQJ}2kVjP0*&_gx0tf8!FTFb(o^Jc&@
zq^VKLMI+~MYNbnJ;;n5o(}M}++naIbCB~uV2EDm7qGgO~J0m}>zlfuiweYU)`4D?@
z(f69IrkV0+H!{yioHsq3pVeME9vEAq4lR70ZPd*Y6)nEtWN8o%ejjV!nmRO{zs+as
zZGYR9-S-^Y(a>z9=0}08R_4nuUNp?ZhoWjZg*l%-mOl_0P#k$$Lb<~h_c@SaV+_r4
zb*Qr>9Ud&gALx_k$Ou^OHgZAh7^4GMO<Z)~1*vF^C@OWq7M{0%wiC;lo6fQ}^ygpe
zY}Wg0JrQ<~VC1A)l~$?If>TOIY{6*|V^Lkwb&hq0xt9<0%IXn*dd=!txXT+P+}To;
zg~2%I5O^G~e0}&gVyy`ndYZ9~qLo0$(~5uvC7P6zQK`3Tv@YrwX@Z>cY(P~Z%lD~P
zyxBDW7=}mhETDzoSwI^{6uxTn_KQhnFTAXH{95!?)nidYI}VFHvDwV*2Dt8^49uBZ
z4k!v}YH4Jj1+>tgR~FF1zkZz^G)n&^erFAB{JimLaa(Qq$!~mGa$8H#`8U3f#kag*
zdgDXZ(5NfpXKBekYv}0O$QlYyY}eOO<$YQsn;qRnf=?TXV*zmn(Zq7*=gn9^cfxlp
z;On{H93kxZ$`Kpiv4EfjeeKq3iNyi}?Kzb7wz6UYF`rWNm>TYk1<cwApv5~k%B|GV
zsquQKk7IX^me`>ylWM*3ph;^C%O*K*Jn-~SA3eSCaIV;S<6)HFcnH5w8sVrG`*vbC
ze&xRr4wG=chb}y7Kg?(mN>$szKo`+|4K=G5pyGOOrkiPxpOMwJ5q_1WYR$N~cZ;_v
zxDe797s}aKgu84k!jWyL_xJoo^FNAAf~{K@eKpRUlp=RXHVJ{*X#Wn4&WURA%$Zx9
z(8;jz`IJXj^7)rXSNbL|lh5&YI7x`lJUYvO`^=*={A=dXMJ-_IGUlpw&sY*w;B08`
zJ7Po_#5hHzWYzAh7N3O@hL-DA%gUn*s_S^v<<TA7=g}P;T3RX4l<gOz*%^3;LLGfa
zAFQmH%9QPAHd@;Sij$i;XV<wry5nE+d349W^o#tuC9A)~IiK;He7yJl+&i7_%*cN{
ze*f~u*}mf$5bjpO;YG_yI9%5l$<!-ruAw}$?o)p1(#Z#c5N$`~6K#a6I|Ywlvm8q~
zM{BR^K#gjLI&FY(rwuTU%FgOfv0p6e3z4%6yFYsR@V2VOE9Qw=v%%V?oaTvHGcOI6
z#JEn(Mz0gI@oOKx#XmAK(ZlR5BXi+*M&`mx*9V|HGY5y3U&Z+7kytFR5pPe!R-kHO
znxB>(Dc6v`*kBb)R0#k*yIB1yG=B``B_q?&pC1{ShJXD!Q!}>oOWb8@ewW$l@y)AO
z#wX!&IVG)g%aQ=E94##W^UQI=DvH&#@<8*-al)FT%*2fUoH<Us6DP;Xp;yM|#&?dB
zjXdm)dgnMfIw;4<QN44Vc!s3G(|Yh546mQF1GJf-MfuVw@P~x+?kp->vb@AcLv)mC
zEX~dygrPcLln~vMEqkz!zAXBPE(#ZVWqdCD&iLFo`U-@UY!p;w%f@d7|JUe~Wm?)s
zZ(*K$^X{m}0osWeBynbZj@)M4N3d5-m+`sKpI64`!oPl%3EDK*<yW}N1pO{^lyQ3V
zbQz@%NA6(pxaMr4-1+nu%-BVsve3F-9J`3sEu)U<|DUmoyb~vOk<mM&bmQBuv5{Mv
zdhfJrm=3mUnCfHK@C=Woa%GfmyXML$-ERn&{QV9;8L0P2ruYBz*Zs@e$6n0;{5afr
zC{DX)+X+QqG3P4<*$Kc$XwBORE-!c62@bt>g7SlBESQZvEPi&!f-xN&3&vERSTLR;
z=PA2f=k1%iPWbjs0k2l%_gA>%h=t#|*My@E%NvIt+~;-^J~ZOk;du8#;U)EPB7HHX
zr`v8KUM!fz5n*!nt!leZ(+5z%-0u+X<&28b9_88xgu9!N@v1LwbLVQE@%kApjPOnm
z`sCj|Gxw&X(&yNL?H(&nZ!;H_f9CZpyT{iG*mloVTVUHg#Tuix%X)%N(u~JX&XD%@
zl-p&}v2%vB(nOk-Hg?XCYCE~DyL9FZIh1c+#&^z;jhyR_4%3_=M+fB$IjVQgkeeaZ
zjiB|QHyF2mtaGD^)zg2CUmDQDZ%u0BtG3ClkulDiox`<lxW@ldjg)LJclF1#0}*l%
zts3{#Mj!3Qo7S55W;HA1+{=E};&-TMO|4u#>T4?;oGUSXQybu2F8{}>aclRV`lv>X
zt$qTOn14L3HC>{1(t`5U)hmY<wo$Zg^ml;cK%bB0kGQ>_$2vB_v~9{`YVe9sw(hsk
z@`Cp5Gb7fz{K6w$w0b^_k8UlRvHHjg)-ll556>oAvAk-TKOF-%K(jt7c;nGHXrS}?
z9laey7+6cEh0abBBc<B>*T_JtrDQ)c!cm9Df_gfz`KgzSYJ}N68iT?!EC>(LZo_9i
zX2&_SQK-CrvvYzu`E<2Y(=bDH(?C~;VmmXcmONo}@8j&qv2nz%KOy{ZBWJCUryXR7
z4pf-W<=LHy7Tx+33dhCl?YL%%=k%aOE_g*CPD{29!Dsy*RH<K`+-S8CD%9*}XlEXE
z%eHGDH>zjh>^gsaP6&-m=gHAQr;n(nlS(tBbG_F?&->wny?)x&`EZRrIO)PO=N0*5
zv+mz7{Am4S;QX<Ebp@82Mm>U4llFhtmQEU#G_*e(Og<6Da}uFEPrOh*C5)q?u|A3M
z$Y^-d;yQGT4uoRh)p+d!T-&-T;E=Alh&JV3`fOeNh~%xd5X15u(ZnlS&^Pb!MrX&P
zku}nrzb@$FliD0v$Q#<%3fH;n-AYG)W?y+^NLv@IL-*{xC?ee2BOujkjM+)L#-Obp
z@CG`2qBH8ajPSGCG&1cB(XsbY=~Jyyn@ysXTn}w_N=417vKm&^qUk(XkuJA%G88G{
z@se~4)%8O*Ny`2D8ja8&Yu`>IpMBhP{QTzpS$B_C5gfmoY9c(sx_c15<tt_cpOE$F
za(IPMeAG5tO)Ed}fFu<Jq20LLdvX-yj}<k_O19AvHKb1xKnKe3nEV#S)4KLmG>EJF
z#;8LJJk)^VW?7r3otvSehrGohx_hK*UF9dH>ucnrMQb2^Mn>*h)2h^-j;Psx+Ek6G
zMwb}*@9byD=vt3C#=^H8)O9KdPEwh|xbP%`f~>713jEejeDCLtYcFvnx5EjhUIc9x
zRlD9WXr-Gpo?TV#Z0{k0L(Zzl5>okz+Fr3B%01}&H%oBDxJMh#$@|t35%Bcu>xQns
zsrr!x4OM%Hc{<vI`u^)4SXA>#J~Mnf-#=$fCY9Jxn+bkuPz%>Mpr=l$-_f_r?sOcL
zsX>LVl@y=>zy<ZJ8wHHE@mj2>tK!vUKJe8o51}-opXzBw!PeEUMe)}2!o%EY#WfR7
zaU|R<4NYWrYj*BN*Yc!Vcda*V02ZJWH|tgdi&=Z#;6%$}_1z;2{Z%KoWJ`%N=`u$S
z+F2l9a%-VWLz8=P_^(B07*Ssv=E$a9AqlwX9~~XVIwC)wYSCRps;aU^GelucZQ@Jo
zv3fI>Xfl}BPw{Nr%<EmXcb2y3a{Hrr4bR@sTn?_i<mUcQ*^h{?khPgO^zG8@dhOZ-
zBG}0qK^?S=-WuS>MaTr}UqmBk_<^k(J<*Xh6tb43p)R@=ucO@aRJ`YOuM0w{pQbs^
zZXJQQP-q=(-4)LvFAa0;5&~y)P$5P;iq_7e=_SAaC=QhCy7$j%L4adUY3dH^WIbA1
zLYc;En1*iM#!fANeNMQJ99NH}#Se}S;vS-!IE`jVe7V=-r{`n0e#G}~y-7~E{rOf?
z)vRc3+K2BWjDguBwnxpDR;9rTbvntX)eWBb<6Rz_1}lFvs&>KpkdzxoEO%B}tjQMD
zG+}fnZ+dRgctotPNug+idF$R#>&wCs0sFOZq(K?3E~zQuVk%|YG%1B?bG_;I`}??7
zKE+!1I3sCqLp7?}u*F7I5?fycBNpp;sPWlh-;_Pgj?<{F-$R%;SB!Y6F{?%x_qr+h
zgf4VSN;%`<y8VzEHbM$(Wb0h14~V^|n~qYU?~m%K#<N-pY7Ws1g)_x8XpPt7Uu?yu
z<*KjsuG$hX#Cw0<Y|;IFe){^pt`6!bGhVIrAJVck^aZG>^JAW@6p&l*Q70)6j`#Nv
z$LwRjMurD022}uw4tN_&o&JDtZTT}#d|y#=_*$2M*NQOD?VGP)e{buq-`6(3Kf8ni
zyIETt@{R_iG-$vL?>}@+J-$;?uG12<td1)Cbh3^fd-+rhUAFi<wfyxt;W{$Bu#O)b
z9mG9EHE|lvkoa=1$G`ZV7T>$|COP5u=gqgZzqbaOw*TvUNUf%tEM8JWT|K#%go7?P
zX7At^dAMzTxqR&^fH{MB(0>d^2I#PHP-1`D={;!%j#{66=q1DGW$SMos~+og9juYH
z1xPi2!Jz|zt73n|+ZJ@TbVAqKt`{u6uPD8+d;qcqv#~a!#Ex$u>MN_^aC$CW{z0Ai
ztofq2oKTa_S-U4snJBk|UZ+*_UdCk$Z*=++dREUZe_gae_Xu-jYjy&(C2JX6H48c(
zTmAMiOj}*PuVsI~^h6ll!7hQSDb#)8uRaNUFPjnO_wrL4Z#bJ%o>`k%^)pxpGxb%7
zGIyhwuVUi}3s1XOxfXP`lhw>eWpqDdo<q@JK71+U3z*->btuylT3qY$AW!~>`V>TH
zYc{mu#e9WP{}}VZi>?>&jEKpJC-B-2^;mSROr$%C?T>~QvD`0T(nhB*B%%lC^>tIV
zzOIqY*J|gsZMtiizAnY}7ZpbxmVKU|7Vmi~UzmH!t;@Sl<(>b(mShlv-|ijc^okyA
zJ#$gnU!%nE%Ng&(M$wBm=WBg$8n=Eg`skVg`fryXvpsq=L4kfF=HCi^6%}zSywKIb
zImC2*je7*@@)|j-QC=)HaMCBr`M-I?5b4}wz2}MZYgw>oT{hmz#>eckZ1|X#)rcW(
zZy*w!rtm8$HetLpkc%>TCWMqP^y09MBN!7EvF6DAnYsw78@I)GqfH5bu+g$OtXUSd
z;=PA<=<aEn(xNFZ3rY)mm_IcmIwJ<c^%6FG?z7>cZ@g^@CR?hcRrE`5>RZ8%X3ds@
z|5Y^fa_OQQo!rr3{#{=~GZ=dDVdQE`jP`kYOb<tHZz*JPy?K-MoGbU@`(EPaFyRY*
zq|$Xshm(-i(dRmjXU<dc`A`5njHw48I3(-*QD#6y?-XXi;-l5P6WO0G^txd;9<(~%
z^TUm-ah$o#L$>I^IZO}+KR4Y^UguL33!10r|LujX!pGAU;JmO4cV1Y=mv3d_+iS}>
zdu=bgY<+h;o8RAeTWwKARf(-NN~`uJD2m#fQlm;yd+$-ZNGPRh7d4C6GsKL&M{FX9
zO~js0`u*L%=lR|D{rqvgUal*boX`1;_xYT6&iNcehGTp#K0g&=T(TJJ&0Hec=GN97
zbAn!k!n`~J0)iGzkYKAP55b!^olJQGSEcRojnc~GqLTjleDZsJ97b_eK*YAU-NR7F
zA2i;13mhuV9A05@8)Fa%KM*r?Kq2Krc6(>l`?<T>VVy+7aKKi!Sc@m?f#Q#6q2-n$
zO>LoKkp0$l{VCMi*y;H`6XTq396d>`@@b2vUVDZtS!h-#Z$7}_om%3_yXv&*2+wKX
z93mzWx7g<Prlb_7-!SWG6?zHVBgrXfcG3pijbf;XsL<aoIXx<(%a4=*LuLu5Y*C&U
zbOATLUQqV;lP6BLR&~F9-SF&>Lg854A1<S@{RloyUfyWM+xyGrR&NW1xanQbPsK?%
zQ?7b%EL8<U-NL7&Sn!Z#C#uqpDL0vDW$RiQk6+^GUq60p1Y2A~EvZK}R0*WRjqyf<
zJSZX-0O}l_%|rvbk@aT~-#1?mu*Gqzi0|n^*4~u#lqHZ0+G6rFt#nn2U$unkX5I&3
z8Hp~ZU5bBF5Jdw^vpn2})!iFHo+W*e>fC7u*Cdr|-mY_=b*MS4-XZ-i3loZfb{_Kf
z+2=&|w{deXkE!Dc?)N9WAzhYLjbd>Z9(?~sfW{7Bk@k+5<AFKMx!$v4hxW^5Xn<?e
z*T`b}0U)y&U-kxts(rKIml*2kTan=4LT63zTfIi@qRE*uYMVaIh>ABXm(7|s<0cxN
zF79~%-9Pc2JR5`RX*1Wtdp`jVSg7OVo^wMMX<$Ia_mvCK$%sSYvDD&qa!$~7pQ)x7
z;|(*uhU7*0we}>#y~IzpOK#F?cj!KK%buaR!FeTOdLu2o%3s2wU*LYZz6`vEz+R&Q
z_0R7^r8Fbk7^8`4ou9^Ek?D|LeHcA~T_LU>f0SDhi(V(aHxe49pMBJq8QuLDc}W#`
znSZkpctzCvx?jHQhQs`3NUAsXM(+CN<_Z;fBh?nmc!M_W&MT=jD829Pb*t6HFiN3O
zQ~oOF_)bM4BJIk812&QwXmFcTb<x8V-*(6g++T2Qen;bmZCwP&G7}!~xJ(lyy)udr
z5Tuzdxm8+z<3_&|Xlg4dmc7J02lyl!wSM^Z5qsTTxyh_-yt@oYQxJ3dgRCEh4@2N*
zB%Y{Cs}t@vNv<0&X!bi=c_n6<DYv*zrWl60{FN<%s-G!TL7?jd-bZq?8U|DT;FhkU
zDszi*ARU85*D-elbENka)xFj6ZNP~4{`VO0$A{S|&3V*J<5kr3j$39!8#nFLkbC}e
zVj%RF0fqwTd7GElY09D)yxsVq$4j+3DHTIC5vX#j9G_UR_|07&6mLD+He-f*8qyLd
zj*4V;m`#^JMZO5BH5Pe7-~MQq3WSpxMiqN=k3XYb7!?VReoytHszXWiDbI<#Tm*sM
zJKbHo6G7`Fh&X?S>_&^YAAd%Sk==DfB5pYKim^FQv8<!s^Ov}O0+&?_GY8%$LA83H
zw|WgnEI2^J6E8miSsH;@Tbg9etFF6`e22evD82b&4rEGd&MO@0cDNUShca_=OHc=(
zI?WzZa>2#xtjhQYJx>R`4!P-2ya80)dg5&p<?#=gIJI`DxouEWFDD}|XsYmKNm0DL
zpsrIhAjs&s&%4Nt4{-CM4cio?85D7JDoX`nzQ;m_68%sa@w4Tl?E(l<3D5K6VF<qQ
zX{J_xc#iRl`N!%czWd)I5`W&Z1U~-{kyr;_$yz5_0Y#NRl%cf*2~Qq+{8bZm>@}{7
za8gvRrNY#UMC$65%qW`I85o!0yGzJDg<OfJPCuz*H7)<XVzv@*x6-bpg3r&Ot!g^<
zkQCKa+Qr!B#r(M>vfYbhYCDMLI#YPz^+_W@mz<(R$`KkfNW{o2?sknjEwnlKPodJ|
zt{z<8hmW-hRLmnk0*PrK-H!&K=;!#SsL|q=mcVmB42DVyl!PDSL>Ft$3bm?viEW^Q
zyj#24Kgk(gc(e}(b+Pj^pdv7C76XhQ^*)OI#3XDwAsxaaFeV6;x*612RG-d?3IY?=
zm-qE7{iSlnh61Ap>X$XHx`t9+!y;JpZ1x5za2jH89HfBVfdyfTk`D__K>7ob@m#YY
zr=bs4X?y#rm~~STxcMcIiJ-9DPE2BvsGv<F6@=0p7$~LZn)G{{>c4cO>sqP<vEifd
z_fiq`SLFwSP8t|)ny4V*2So7ivKO8@>X=x3?yWVKt1cvg{<gX_TV0UWlIHa#O8PhU
zaH5xYX!E1x_^G-c#XX^UMC|jdMP|msVKckBeNc_Gfq2PCH+#kGb8~tzl5;F~-uV)+
zo&Vs%htA=W5oSt^5#+vb->)p{VNfr<QqrKQjN+&@CHz!m(|pWvZ)GPUHjcD+t3w2`
zNuBJuG~9a8se?sWg#!;}eJ&L*!mz&&BXiGUZyc39Ue6PWXC0s!3z~x--^qXw%=-yi
zNbcG?DV<X#4-cpxFOFo;Xi9_SA6oZ2W685pGZSV)u>FJG0oQ?}%}a9@Gl28GCLb(|
z$%PDha;FctifE=%=!lIYocAM_(%S=dbNB~jo`e;yLWcUiEHZ8~tGLln(9!bxSswn~
z-bKF<o^R^S&&Dxe+?igXv}gN0S?yTTl>2@Mq&|mW(rbwVbSAF7q3*pc4BHMuR3QK+
zr1nRNEy3f<VC5{g*wyaVzzc_!b}6VD2wTL^yi70R*Ll(D*J+xWjO}*Z!l1VS6>b*~
zZ@)I{%a!6;7{-&)r`X*i13ha9rx|Fco8-Te4!oYwXy&Jt9Y##5O{8sGS;&ym^W8`4
z5;HyQVg?+_pZ-Gq;=8Z;*Z)7S;KFk3xbN=SXmQ&Dce~~dyoxWi{)P3{D|{0+8AL!b
zjhrcSw~Zf2Wj(9?*cQ2tXKqLx3p(Dv3W*6Rz2f^D+|R(54Ge+90nai8=F#Vj5#)fo
zZb9{DM4z@Toj@q=CruYC+|uoAfxNxw6ioX)-~o~<uN?!>RK1krXSwz<j+L^5Eu2O>
zE#FB$8!)X>i-FncI$pPt_#FUp{7R{%j9Qo(W6Z?p0?8&iOa)|@Avl>`kGEcoN%&&`
zsE&IC?`Rk=!-|6Xh=wl1;`28`U~MsPP;rFrxO0s$0I<rXoEuLd@5G_tz&H7Te_9*G
z38QB8i~nW`QmK{!bJLYNB@!Q&l7Bvq0U&X0@L>QWt(ToTV+a9RnlpEaYu{Z2Ok_FE
zB|qbU(H`H=Ff$~~Hny~2I+oWqn4fO0;GGogKF#K(N6ri$fuq5`M<Zlp8|}IReoRkg
zj-qj#ja#`6k-u*X>iH5uB2%3?l0D<!WVJ3I@IH3&(fPX+-4}`E$6wQbGMu(`Iuuz)
zQV%~#+vkq({4L5B&5d?$Zud^R*}l%xec*2a-5FNsSj?Fy{wY)<mGb)`oQC}vTy;mL
zQ>#KrX}uS2s_#2`XGef9=g6y*KIVKQ*1tqTZyQielcK5MW~T%H@YiBy(^;{QEldP3
zI!kczP{_++P6P|`;QT5qY?Ir4#_7sjv?8^!CO=?zMdzK9K}$Labd|Tf7IX7*0P2W4
z%<;R;oz^hGf@tN0wy3E9!Zz;LG1sLTw1l2U3MjvbMrQ&~X!j|SYDf9!H}#&mL^E<-
zl?m)ehTiCUufd70aS4@Z7nx)LwG^~~Ij5-r#g!N0&HEl2(KY{&l)L#aAV(9jhMIU`
zmSW5wKkx|LXG(#<Fii2TlHO#xL{bV1>z&cGp3pi44`|&+otLxrPV)l48#An=%W+B0
zE;sGqF_(#ou|rF^Ph>^}fhX{<P^QAnS74MpoOFn#Duu8B)p40vRMSduv<x3t`Evp#
znh81=Ptsh&y&$~VEfl!SoflHiOY!|#dms)9=T31BP9WS1xkog#Kj-DNM!ixM;F9xB
zzu*9yl`j){wjy8U^fHs#aoiQvnrt=L-ESH}G6asWIXTM6qCK;h2*4ATA0HXtG|!+N
z(bH5ju0PUgqeqO0EFuBIql+RA7MJ@EJ4S|ODEdu#IRG6_&di1pJ;aj?H`VfIIn6<|
z$r}Gi_R*qVFcqPlOtL1Q_csAyaPY(Vb0}@deKCKRzb)VCrSW&ldH$u@DMv`{d`VtY
zB}3f-Sb&Cy@DHWMCBsPQan_vJ-I9<M{tKP8t~sEBb4_)CaCo*rr=K%3vfmvz=vjxB
zzouQ2k6_FoY#po~Q`G)iK<1luE}uU)m2*Q=m2<zC@&5{h99ch$-uU2PQ6#);Syzww
zn{+t5f$l};`8aj)Blj?E-~!l1VIfH<Gpb()j{h<&<pPWgH0RsM4t{|O6hyVF6P)^w
zqEPVKqf_F!sR7sFR5V;9-g!Q^kZ-px=I<b17k3SJW=5r2ecbaY{WGRx&gj8LJOp-r
zgOblLq}frun?swdxqK(W(ZP+G@%p3KS6ceN0l)8r+VZ)io)hVHGccNaD}q(Y82q+;
z%Atzr82~$r83Kjj8wnU@#((TaJJj7_`X&M;pPd4e<X?$1MWBS8%=s5v>jWmI2K2v|
zii4fI+y!uXP$&3MIEI#53OLput(~qQSd(Y;?VuAp02MjHKy3r4<syd&KjDmu`)}?+
zC$Ykukovg7Jjmzp2wL2i4lThK^2U~z<=Y~ys-h<Gh1(YQ;ov3}{b-c@VdM3RybL|y
zks45znLLn;K87~Z=K8$<n*t8G7F)ovXCxWQ+F*5rC&;-;ndiT2C&G&1RJO{34U5p8
zND}4ZR`cse9K5-yKKm38bEp1CAm&)V)4%5O>yOTH&HA@Qq)0eVI%U%QTM>*3?HK)X
zUHQ=luzp*91rz9E?wj`>9_y#kbuW~BX!!qXs2<b*tsdk4*RyTr8}~!|@?YYytDZIg
z8w5<}-Ug!T;xO&}6PM3oVLL_M>IeS9df4TMLyZ$a4fP{t^4>WdNXRps?E}VI=eqxb
zZF@Ty2TN8?=3`o~Gd*$M$WO@HBw5GX=6&ETEX1kn=86jWfy>9pH|xGQt-<;ETv1u=
zxa&Xd#o%#&vlHA26+El2i*x!P_R{WW9KE#H&vuq>tkd-6s~HczIUgSUU!r6}y#H+~
zc_o4)leCaZ0Qz@I1pv*G=aadqXzp&hm!L0vAm5~Zw6tw2%3Nu>HjHc%`Hz6N%_v66
z_eQuIb%?mq$71Ps>*H?1>qn3~tm;2bqYt#{g|#w@FMO<;8{!CAxtvbd<a@ufUc0zG
z5*GUhp}l*)U*Xj|BjoDpoKZ1W9-a5POdBOb&~WX6Aedw#qt{A^j{{Hy+fO}>LFA#9
z;i}aaK10LKC|p=ix{zhisv8gtfkVYhb8y24x5ICk^IW%=?+ZZdrF*Xc4#!uS<`9jy
z?#A}ByE3C9Xw~Zp*8V~sCLwwW*ZI|4qmIlja6a%G4m!j$ro$rW0(bc20K&W3^1EBc
zw|c<Pk!V`s-8$#k{!90D93~ccnC?+G#4S#uYV}kP=DdoSy&YKQoaw<>`T*yDLGP^c
z1j`ykyQJF{RhZIYnkn`+=D)(^@BL+`8;>yG{|nk@xbIl;{-=wDu&zt@q9fc*^%YKP
zl3%p{YgB54oIITWn;*T8#>eSJ?v8};<Np~PYSfar=BtKWQ7;(Qn-^AZ&3A|L3G)Ti
zVV;m$;4tGSZSvollUE(it#KeW*ZGm#VXh99Y#jdMZ0kwM(VUmkTm!^Y)QI8i*MAI(
zMsszA9&>e8>vb3$(AyFl4}tUbO40KF6X5#`<@+w(Z4fx|1l{HljW0|84eJ>+4gIDn
z_^!<Vnv)3sGX#S3EgSw(zM`W^ns(#WGW>L{Q&bl@-;JD)c6I6kV+NvK|4Z{|VeUa3
z&P{3^Nb>C_fKK9^LmRzxXmIn8DD7OBvvUzB^R!w!A>DjljnI>k+Eb~g5#s6WCCrya
zN8NQA2@=m;5#@{7Sn3w}XIRM)nfN<ft0S9tT&%+^_48*xf_gb?nC|X46rT-5YhzOZ
z=>OEf-?X3+lKC$o?mO76i5GaL*$6wT!nP&g|6`a_(dJf*l2ofsJ^5{tQuOV^+`8+t
z#N)_}xPRf3xiGid(Lb&rgk9D-Ip6y)b3Af*h5Fm=HR`IIo5ST_)K{s1d>~FUT8mH-
ze4J^V){^=8u!w))V8&l!0V;w+652Wp@1k_mvW_-CP8j|of`26_{|}pD&t&}`radfN
zAZNUd&sA1Xvm&6IV=P~q@o)Ur=8ggX3o$MJna3jG|7b?@`A(yR$Ok|##bNHOEPEij
zb_Veb=I%?dQ8F7Md&HPu>p%)zc~R7N*NM;sH$y9RoM*Uva49NB{pe{^l;8TK*9XpD
zzbu~sOtwez2>tB`yz*L&=MnBS=m3j|Wk&uoz%X$=V3zFldsMfCDRvw;Ke-p6@LW|>
zZChXJ))_dD_gr7syv>-x;;)g5V)}1_|1gU~GYEXKO1k=cA|yv<S&ooDF?0&G+l@$=
zWL4&7H%V?$2g%|@+<bTALU~R|5wrL|KqHncfTJ+@Ft{PFovC6|_d@JAPtO$AAn|C|
z69d9U?;h6`QEekAbAD&v<%6XI%tyBgVp<I`uPuPC4BZ(~YwTm+<3d?^;`Zs`oOsVc
zcu}R~8aL&ip8u;V2jKATOtHv^MP=TmYJ*6!%YAQDR_CQvY9h}9?zxWRAIzj>SOn0M
zio8Xb;k&Xax>kq-*V&LFYL(Ww^b`84j{;dP?!HgwJa@%$dE6rX)w*e2OaLe|CZIK;
zX8Er5gS_SHU21MQZNccR;}2DR-KDTN+4>wtRDO=BfNrITo{O84g4DkpJ0{?7+RJ0|
zpdh$fpec}RiD$vfwlcU3hO<{iGq=6oU2tYmo-A4_CbQ@{>0ho!1kUU-gaB6aSC|GZ
z#^pPD1T;DTr{8`mbE+K${x4c2r7QPTFQo@aUt$DG>PKk>-^}>2v*M=T3DmKecCQ{F
z*MK{piyIG04qN9nH?YsMfD79fAjI{ty&hfJG_!=Gy`DuBY5?Az9l&Su5_d;ebW;bd
zHb6d$O#J%a_z;B+c302ZKQJ<yMBCPyKPRt{8Lfl3gi;ta0(1IH!9a_-{1Tv+dcB+b
zFpVen6%i5Jj!-*w!dTnf4UK=;kkyZ$_~Xr4^FpX&|COEmB_2r4phl$(H8?Kh*}5|6
zd#}U=D(?JRh8n))B-~RRi`8OA%5YHjn7jql^=~?^Wv}3uHKe)OHFJ_zXK&T||HFgm
z_Z#+>a+Fy6o$sbY^ir~C4UXEEVKsoGZAYMd@?WMzfBVW`BzJVA71Z^wT)^vJwu(&B
zAG@6@an~PX^J9OZUGFXK4<_+#?FqMnYt;4H#L6>L4&K{1)`H8Qei532^Bp{tE>QqY
zZIJ=zoShN4li+_6MY^sstX2cLHb_&Hp5ULbED4i|V#;@V5$6Avg!ADJ#&|ZF#1i<g
zG#l=VOS8i;@Kqz{7BlGenvp2va|UK`Hua*R8AsA=W@71lfjAQ8c?+*eplj*=xb+Gq
zHJt-})Xl%(4Z(su|2r20ZHA(FInqz~hrH1Au`o$)*M2V$-(OyB@9zh^|E6G6xc9tZ
z(U=wJ<y7%eLfJcxW*~kpZ1$(%dE8Ou;y~AFqXFb;8*F9#>V}H$wi$B6=b*Dx>8)<_
zeYVRjvC(7M>zYT{#!wKv+t}m9_@zbSG`=GzGFDw<!}Ma&ef)6ll>Fw0=`IOCASX#{
z_cf;Lcf6?%z1c)YP%k4H?01FkAmWkG7)0~#rSyt|KaG%f9&^Dfqj)LbD%<*TDmzd}
zpBhk=vTvOk+I#0HJ15Qb&G&*hxLjs2$Ezeu^Sx;|v;O_6Qq#R;yhP;7mkXKhV(aRS
zM1PDpA~D>td;X^#3ZMcW0)ZnsX~pe8sZ~Os#Sd+_YYMEN1fneY8}2D^R#|ufBC|d9
zF2$qoN2aS=PmF(4)*-SH$$8C`MI~E@3>w*kQQ9j`7RpOi{Hn;$opbwT*jP3$S1lD}
z8}5icK#%gRMSWlk1LXaXW^+aPe3bKyep}6A<e~aJE;FCj&;n{<?R)=?9c|s8kCn#X
zCAg#oJlo~oJ|lW;9qrG~Dx<?yK(jpTeg{oOw8(b6)i$#C>xby^xtzdgJf1kvzl}&&
z&AF<4$Zo~vQKIY+?|_kpoAkOA5TAQIvp*!zzj7gO&x}Tb)YzF!jG18d#>nfo>r-xd
zl3#SGz^D@Cx755}tD|2fwdYncYJ@eWCz1qB_VO4EGdJtmQ;?Ns;eV&E7Dylax=!$M
zOUpu-ah~y2;1e#v4Xln1ueQV^gsf0x{52)~_1*m9$bDHIrMJO79X{VB%yhcG6k&>a
zj}fwCUn*$N$mC=3c;95iuysq>l}N;F;*&keomjCvy=&0@$On1ULgnROBo}kLgfStE
z-S=t8oA*0ZHXT!%*HfC%#liAobLen&te6mzK96MZDfpF@^m7ftAJ@YppA0J=J)5Ny
zo|n)Qg_iu}bG0nIOs~|tCC+h&@Y&6Fp~KaeD7DG$@yv<vw9nPT`-{`mKXj}Zn~cO8
zcbga3I>6AOF}W^D|2Kl^Iw{Z6w<;NY7K9noj@rGYj6x<Hye!U<qADzf)=*TJxKv92
zHocgdjR#Ff8R2*B#%^K)y2KCk_8L5D->V->3dfMD3#zdus71ER4MnG<FUjvdx~RV1
zckA}o)PmRo9;p{{q+T;jQ~^3OpZ4E25>Xh`FK<eCUndzJL+1YJbA+&1iKOPsozmYB
zGD3iF2D4PIWcUMcjriH#BlDLYQCVca_j%?`!)t%OuQK>ilyi&X2r@`PCa1r}!{2KJ
zKQ*xzK3Jeu=$h$z0k*LzoNC%{u`55?BG4^vw`ee;D^K>nOo;mf1H2o>G<}%}m-qDt
zr!>v8aN)|NVumr;RIF7VkqNN{CUwV8n_`DCLiRy$mZ}4fi5tyV+t9&_P_~p%iW2(r
z{nw2~ZuT~ro80YDY$Kd+PF0c@+J?WPS=jV;C)ZgT-u-sb?ZGsyNI8kJcWyPRQ@)^5
zsFx4djYD+{(+BrGTFn+C>WVJWy?RJ(jN8F%XQUD^^1Wjl;oj?F&EO@tKF$&IQ0bjw
zrdMH;PWy$qcX)8kx4xCa#}V>zQ4Y_Q3{!oN6Xv#AP%qSDW_b)7E|tn5a!fR&eKKEp
zI?pKSc|q3f{TX_=W6~Y*K68CUQ~QVJ_;WpRki$NjtejQ1du^RiHYfA2LD*$Kd=7WG
zxO9XnVFt&Nftn!v3jiWCPcI!}azFS%Aye<294fp9H+h=u8$+S@$1EneJ;VA5Phsn?
z-|9vmWjAz(&3(|SqvmUvl<k^2HGpxq+dgJE{6pLoy<Ru4r$XjXGB9{&k2y`)i{qq`
z1Rwkoy&HOqzGv``qH!E?VEbw5iRd3b!4WaZ!L3#a7=J*Wv_`q+@_w4OoVu4!k#HvA
z!W-n<430l#_7F2KlF|cGWxlhvOOxpP{z+R~Oj2C5Uf^Pz_h3f1uPkz;b<vynW2$E<
z&$9aW@TCs45QOu8Y@KQ*Iw}bU%u+yhTLd*)awI!WhNOGMTW|d)amCG{PthVKIW0My
z?-zFfM01ugnK}x+XOTk3Ym(PuIr!KyC`lI|t`q^^@Ce)JyNA{2Z1v$s8JJTFGH)(J
zJ?E_xZ0bdi1D6{{UR9dmiZMc*v?t`faN$4zGF#+u-$<B{j+Bg4b=N}r?9rMUqQ^#~
zL)j}>+~Bp`OZOphlHBjB`}n0nd;zC%W)UZ&Tw*k7B<*Q#DuP<!&hDqw4#aIG_#3nz
zd2WndRCX$4sTm1YBA7_%t}ig5he6EV%o`8~BaP%xYbER!Q|b@mM1HFoJ+c?k#SFtt
zAH^dJ`5yw}krQ|?_1t>KJin2PCF7Pai^Er!JNB;knPr0}&p*eI{N$~;D|BCzGwD5r
z;7vqk7Tsb>6{RSyt^>q<zRpyiyKv~*=yXAKH2*W&_lYxaim2;}=<S#KNOpvG7=_Nr
z2|T@@;nO|-ajsYf^<l6&ERNRu;wK&bN}P+1;|;~ox0U<2?Xr@NE-mr%OuNesoGq*G
zS?3h*Xg15C0qb}XwSg9pWFfCj7opge_<O<6<0g2CQ4aME+jpz)h(l{Pq^NRolOvy_
zd#m0-BRcdXW{_#U^)pnV(K5U~6%h~N)%Sc6c6w&NM{I>S(UEe#PlK92R=hr>HmG%I
zG!R%(Ls+!bixyjI>Fe8jUOzC&$NgM5hvyQc0EgM_ek82!$hTk4Zbx`8w6Sxr1q|L_
zCs(T1lni4q%`aP0Wl8CB&y<<L^L&uH9<p|c)c%_Im_p&~AgwKYR+kImlrB?j8jTXG
z<V4N2yR9^m6ueS%L>RLjGmn04?>f&?HUKpR#)@Yig+T<#szQ5gtyGsx;&QI$Y#%$*
zwU1q<yb;K+b38oz_G7f^d4>Oh0)(6W!S_=JgWs0@sN?hyeczOTJJ~bN$0<l!*q@s)
zeW&-tH(oJ|buO29o-P4ti6eYIi@%IP2g&P9xztf}Un0YwKcNzCVbka@4f@JBv{GQQ
zEtiMticTkx0ay+33N^E|BEoX|%8opiOy?wR^J4ucfvKp<wPZ%)Rz>+y3NK>=eJ|rZ
zZvR`C+{YwjEAdUMe8_A2KGZ?i<*T%XZj#-_ZjzWJrb9+cBh$nOo9|NT6gGO#?kCE9
z&S*9hHTwi}WED|UjS)`HZ8ncg)3Hh{<*lmf%DDz_FI|H{`ww7==Wd4p+mw{3ODlqC
z$tQc7_Sp%zwN0t2oY;8|wh5iJ{!F`t0haryx`l2^A6Ojcr4Lc#;^4|DaEN>VLKW;(
z{{Ra@7FeDIjmbSY{NQL)z#{NTsJNkOVSH)KfR7E|y5T%;av<tUUAy^US87TYR#jEc
zrm3X_LKegl?5KD!?tahgqPyw(mDutjE$ZRg@wl8j{ZQ;hXe{N^7bZhZXA%4zJv<zk
zWr8+e-K$&cUU_V<@4AGD7Co7y%KY3Dc|3cNlDlsHxp$Ur?KdO<&$9hseowfkQj2zC
zV)APdZz&{aVbK{(H-dd4uDt@;%w|qT+`FKSpHEY&KDKb<E_Bi<+;z#isIj`l)#@aY
zO1|flJ{59-K!)U0^qK2j!V~j9!dG)0Z%J6^lGZD()~FqO5Jw~xsBcji7ZZ+Q!`yQw
z?Qa2O@lzl<WRjso?v9DL0*i_G`u@Bdk=3T#WAYu$f$tAj#Y{I{f_8aX-}H~Urd5wF
z`pG3F*RF5RE63BEV`UF$u3yBZ-_1myil?!5pgAg=NCTVsXeCXPD;XG0GC;2m@((H8
zp8{t6I!h*?VP!8dc~vG~bLi&zN`}djwqFtOyrZ-Q9mzoS*TNPd{j{XnGT~J#6?9?V
z=4`w}4C<NNF3M$Rf!C{+A@j8)V4!P&uLq<*JOJ0m^-)kG0{!9-taIM>=EC;qB49T?
z1G<GGB!C4bJ7Jyu2A7rsSP3Gi^hsZwDU}^lU*pSW+VMUPCix^}>}^CS&V?+T2c}kt
ze%d7QGJzC{yFDQ%Ise#RFm|70xB7P5C!3EW5sX+sgo~h$Tw)ho@=&@Vv`!6`3|>-Q
zxd8Iou6Y?fa60rJG+cN8C={^MUVEwlm2ntzfG$%AmHOplZqe5&4~}6aA9I=d$L>_{
zj}`5lgO0I~$dgF`SMR<LY=<dgtIalfuK{neaVPCva)n}OQiwh_gw_OC$TQ>g5ydkB
zY+Yo6J>@*p-7dPFS4<|IyMfaSTJot3Axw>_dce?I=X$eMomIQ>MPGKPP2L}29)*_z
zx_L5IngfOzALYg&y0ZqnzP`FYS-0M@1*4OS)}Pj4)_Sd@7HvPx?^l(5m(H<@fq&s?
zpCU2hoZ4ifX7xyZuI;S{E#{ia0TSdY)ee`No)tO2H|P}|6rc{5d-l{wnwfpSGb*$-
zdN<4jLrDuDmgCC13{imZkeZ%>YJa-DR&WrlsalqPJ|E7_jZMx+meF4|v<Tlpw7Kp-
zZfnEDRADS8`S)w~o0RJm<!TDhC)@09rD-yl3sPdv2g1qdle8bDJEH^FB5cvs7K}sA
zZkw()^N5Skt?ucn==T3y<LNz#%18a@8c$uLw|k%W0tvAmT7|j-!M7Ve#>1|VtZ8#E
z1tT!HC7#zt@mc{rYFO46!ZG5!g@=3HpNBqW472Tam)`ko_oR)^nqxGVB|2Nv4`ek^
zMNm%^xYYHNL&(Q(?SYhx&-+samVxu;Y46sPjbs!ltGx=$1TwRV@5@<ZAFX^7@m@v!
zzFPaiVx*F!x_;}H<NV}@u~Z`7H`!d?+!fIZX7BG8gR2l*w#i^BE%Vso_&a8KZ|^j$
z-!jcA)^gDa!PkW3)KlL{G#_TdEtz~{+0!h!W9azyQF+F=;p&w)_|kB(w%N%#`IDlO
z=FQPPe(O76xjebFz$5l&ldq)e?CCdISdsTg;_@$-;+}<QuXFI(j|O=jQIX|f`?~8T
z)Grt|6HNipY7FL!uNdRJFD@3=z|0kX31LIVZT{ieoJjmV_TA<m+T9K}N5<UQeBB_w
z)ckv159`+${VJxy4}_0#RniJ^967n9f?6x4U9M~G--~T=hR~18h}fI=`JU!<fu&Jw
zXhs;tRo{5OA~dvQA!A}82dQ%-AM{F0p5v^r+ufk4^wX*|`Z0~Zg|Q+Z_gIDk=_fd>
zQwTK>N5DId-&zn|%xv`Vy;&D-^i`ltestWO8gpCSo{=$5|4Dt`BD#EmM6NL9gxp49
z;*5j~8~J%7xg`^dnOVPJ5SGlKuSaBw+>}wp7fbLsQGQQLqV_**nLi+_w_1;yBWjXD
zAe`21fGIJrpi<R$>npahbDq_iZRC2sSp<P()Ayk;;Xn9up#7g^ldCVB<<6TFZuOqL
z%}iZn{_w%ybiYbuHMzO{#W^S~WXHPKVDUS36BC|rsoum-=g@l+LAcD!%a^C25#F;z
zS3}dLu(BKpeZL4{KU(;~Mno2}u5Ls5X{h2BJ}JimH2<;+oTQhhe(TcaoX|&UB7ewv
zIfou5fCou|1^L~RJlH>dP)5ZU=i_gTj5CIPwM@m5{BX4`7yLykXB)7Kh5AtkH@aqw
zN~oivAMd(*$A0ib-#}QY54xSNRVN6h0=JW7tu0STpUH&oXRkAR9M}dj>h}kRz2I@?
zC7Us#w>wQZ#+{7Sq~8iD%lh6Psx8yl49A_B9P*h$%~;OY+N{)xg1qSJ{dS?zem#z_
z#M0L0T5P#ERX;#R5SYz3M#a|bi!i6&S->1btyo)koXcv4e&i<P=-1&MccwzBUR(2e
zit%Mssq}H0cP>Op+WG{|al2?ca8am{j**IIX!d2zGS!8f_>Xn{F`gKW%KUl{-rH)s
zaLOK<RJNaSEaGH7aQcw_YC@#A+FBArAAw}qmSKyCjI-DJ)*Nm*ya^)M5RB+Ct5`5s
z9OVkUuAQ<MtsS~<=4_((i#vzLtypfKEm5}r**fai=U-|<l<iODAT|6{*`#mFh@d!?
z=n>-yWmAoAS^C@O@US`1FBPeZwBn3WsF^UmNCfktd;5cVPHwvQ2S>y=dq1tbc8ne_
zN|D@r^<MBA*?NfP{XAFq*+6C$FIaHxtf$a!z^NY?7fSNNzKd6%r>PSdy*qI&b-eJY
ztAY;kI1R0TTK5H4@A)(>Jm(9;Phy9hYsM0}CQA3J`GNL+=Ew8Nkqw{9UGPceG@r=D
zCB)3Er=clOw-*uu;Ol6_I`Jr+nr)RK6H_z&?eW11UbNlXW^zX5-O|)|@*b|PeV+h{
zWO>%4huz)`r*YWJ1frb}(haergB=vI<iMrn!59jCzaoD~V1K%v*NMV{iAzzYQ=+YX
zdWq|*QZT$@tG7`O>9{RAm9?02%Y8tbA$gkhXL1NVa;l$hyGA|YS?abCjp)>XqAOnY
zU@9M9rDg$QHC`2x-Hf(`xzE&h4EE4VxzrE}PZi3^(z?@vXwjt}liyBqowlYYFS|pn
zzt5__=)OxllIs1PakZ4pAjh6<PqXouS?hO+YYm&2YmIFz#Q|dAo#2U&rB~Ohy;t~B
z8P4LTuStrx1j#!D`J$E97bX~<<tPjux0t%rFuK-<5XPXbmcXJ(M|Rn<<t6Fo8QyLW
zY~VE+KEY7?*nHhYy?f(6rv~?U1k17px}ud#*}(iK7d!VBx1`abQph*>&8tNtpV3gV
zRM48Z1J$L`kV9H=rb{1Q4YBDCf9Vb<YIZ?r(<_YK+IM!?@}sKcj=dclYFVG*tgN<M
z)NzcW`rd>ndUk;c4FnrWo{K3_CL@l8m_o@_fIFNAo%YVsv$J2v<4lZ|j(?0Wqy3f?
z2J7K{poBL)jhpok_9InK2zb@dTm7`w{Hty7zJ6kb?Xc#dLY2AvAo1>+{vy;SYth5V
z2$Q5bW|)H7MHD%s=nj40R!ufNm)5w>o%qbT;$k%k{`-0bHDg`fRG*3R7f~jz^NV6J
zwDm!=&m$R}ZQN#_)FpR)BYU{<V`%2Lt6~h@sRTnh9;|E31N}Jul;%zD&Pu)NdA~@p
zv`fxNQcEnf>BV08UM(yC7I&(^1##X|X@h3TbQ+OW5=;xD;+7e>4UAwMJIYNjbre~h
z5|08@DLVRk?PO?ma$1~lBJVevDLNQjI$|$yr&sJtmS&DRcfX<4)Q^Q*EjJ3>EYcaY
zZX0U=^>==d2X2Wcxe9GP1oXRqpY9j&*f)-NE+@>7KU+A~k*nB@s4)C36zc2~@jOuz
z5P2vj<@u0}+R_}zb)2LVcNXvBfzMX8weK|*b>PL6{bzwqm36ttqp?UL7}Gvjee^g1
z8hE*tuluswBHC4QplW^n6LMvj2)if*62bUV^cR(Rx5aKUwc)*^+`A(YpaK!>BiPj|
zlyN9Hu{@t0Ns7~ty=LpS**va$k-O5aaQfrZnir(^>8B0-S9-4uyC)e<XKNI2V}i!u
zXB|=RwBzTDBWt3L17Vy2F5oxgCNFg3O_>F*-z4Umo+`UjBCQ3N01R`7Z_)};AjV-i
z4tEJVXebRrZBagsK2uno^fhutk<QDRIpnNm)@Iie__&GwoZ`2kASqq$lj;lk=Cj#$
z^+@}psb(%4#j!OD>f^(O85{aWV{xH6<n5ZX!*;Z_6)Zt~Mo(ktrY2sVw<uk2l@XX!
zvvTz<x~&IqE-|>b(vq&PT4xp^dIy$wQBY{#U7jQK)<bkyC}&U&BC;kTvAf3o+n_12
zgx=b<{#-4;=$W`!QEl)*={iKhr6KozxpsIK!||}M?*TH}O*<yVwrKk|8DDS45j^&L
zWLqsXsA~ytXsBg&s<COh@&)>5N>s*KxDbFRUt4{qr`X%3*}6oA)gF8M&*baau?BGB
zk^Ashv$?#=0Bocd(v44I-y^i=I6RfCvh}=!=uI%{SmcPDchZ$^8n02S9&*DonF!zL
zP)!`LbEIB8rX1j!g*>-+EGL>3@x{0I-O@yoTOA!&)v5)L?iO^6$ARn}jn5Wlfg2D_
zq`B<G@uZ@bzhZuqeX}A~$awsil0n&3ptz<MRM9kFw*cAIjqnV#uDbQ7V7{Q}{(&*F
zVN(Oep>S1TGFMk>!a{dj>wWCcM-TdY*LlhY*$W2vT#R#u*js4RA5T!TqIR_(Q=Edb
zHFTTaie#wDdf)s49(&H!9^$I<k{&*CWaufr|K7;_T`36AKS_Y#?9gng+kF+Y*_pU_
zT3H0IF_*g_H_{c9)RpGrvMNR1xC;JiGgJJiQ#Vd66ll9(SX0eo`+VfSr3c|>%3R+l
zIlgAA+TZKJv=ecx?i)<s(n`i7`F(U0xag!z^f_}2D`Am@x@t>p5z&?TZ$CS9)@ss!
zwsmH9*-l04$-7(3{_Gl{YuKGi+U$;L)>H7fOxV&CtY1UNY`uePC+5OERo>{EK5njx
z+kK<x`pFa1X)S@DQnV+?Qnm06iDa#6=OCD7R{eTV%9>Mju7%7A51yo*&|sG=2oJ7b
z5PSlZ5i8%^?DOB9m`J*q`?G^2SDQ#t`JC>!5SzS&eY9(8N8E5i4YvqRKibZDe%tzj
zpM>Vm^V{*|pC$-nQts-uH`qKT(V1xFqT?X4`Yk<uG)5DHVka2(`-L@m;6B)~EVdNo
z(R{mJ{;gmW3u%M0R!V=fynNMr9~L00D~js0ua{}=?Y;J`2lI6%8==C_I!6>OmV<wY
zIBY%Yd+kbC{>scvFd=$(*mmm+g2qRUZ-z*2BR|WwL3N`^m`dW+Vw-;F>-;%?E4N>^
zlVd89P<rp*1MUn~?#P)lP1<jA5B)>41`TI)QKg$J;y#AWk(mbp@CgzDj4K<n-ztnz
zd>MW;sB}6iKk@#<XD$s?n^BnTP<cDPB6f63)difA^evVF-<oB`NMtxiy{#>YRCx>R
z|86Y=cllhD0cAGNegPpn?KbN66D`2w%<h8CvQ{ZngD<?P^vZ!vze#*yS>woK?*YPn
zhsIQLRg)3sY|N-G;^JMbDfvg|O}@txji~K&<oXNUiL4cB*230C%`R{f*Fo_gJN`&D
z^Mc*u1$46Q$3`oqbpuA&evV`Sl6pib$ycy0_H%~s>`h-zfK-)s(hl1k%K$^*;rXuR
zkNILafeYKSBg~E)&r86}tA<l8#>Ejv?jsC+;DzEma97osvy$P(xrx~`cWh7NhSYDe
z#huf2{s%+cM`<*zm0O8HWG_-AYU^Q8(erbpa~H3yvf<Rw%+C<<;hgJ?{f&sX53SsT
zeg+V*>}IEy_ijY|x^5<H7>w%Mjrj1~2@Amv#-3lSMtrR~%SIh&ea-|KB)4AW-Ko@*
zb*UV6gHMY~o>TWqyp{Uo3GDYf{HP*Tl4BxO-ILKM^IhlXX;X|T()Zfk|At)6&53Vs
z-jrcKhw)1rnoe-@t+j_w%(sk1y)sdBw_fDb6A1-Mbf^w#;a0#c-<aQHu03m~H02#)
zdtmt{&SA?;tA4+U*(iINbqg2Hqne0S+M^nM-&1qL-r$Dd=v)@R@!4R&*xuv91tDb@
z4<7gPgq#J+96Rxm72GFE+@YHl2OkrEpOV~ik)wANX)YZV{j7Ts<wzu8Sx7nF%o$2O
z3Z+kJ=JX7jYA%sK*<3hPMn{JE5>Dm=z`7!zo7<eNcKe7u8y6i>`CX9mj5sdAt0Noj
zlv8B|@KF=7>)Kiqd2v{B_1f0tUF(f`8ePV3_RiyUSyEql;q<1;96t@*dC+f*Skp^z
zeUGLZ-E`nZe{D?K79C|b_|QfUUs$x2A4;4%YhhJmH#1z)u;i2}ZdzWmqBn$+I_Nw@
zZvH|s@WokgmiaBHLG4wJ<+!~fv_*Cj9w@{pJ&20wkCnxq$IvWh=8$NyiEiCZf7Mg|
zCqby3c>&zmS@4^{^jAF{@=g8CebiiFh|_ooQ<G1>OM$oBs!Vk<^=0SCj+V#j2>-*J
z&)Nd0l(*15-|w6T`b23Nhy!U-b^EhlvGg%D{=RLoVs;Zf=4-oY>Dte)C&lycey;1S
zms}UTLnP+&JM^hP^o!7q@^aJFsj%KXXps<a7OHOb=e(-lllhm!#>_u5M{-<y+hPY_
z5D72-DX}~>b!Of&+ANFql4;AdI4ls`mQ2~UqzHht?=pLu=;~#rYwM*Qtfy5hCk)Z+
z9%tNy{vi=MA$fIjX2dUH->?}cdpeB@+jmz3%9lBF61Js&H_+zUG)m5egbU))yH8b!
z9lyW(hlExnV~B=dtBaX>;GDS$ab(bWOiPlWP71<q1Yv|i1EeMcN8BYG^$_rB?mnj7
z;oL1H`i1YHyxCiKsp9|0nx{-0ZR+i9D^~5E$58K_&h|kikbm%pgn?}sbSAP)s8oMs
zT$!5eBpg#~+PlwNqkTu~3RZuu<O+%GaM!>RINPvY5_@$tMi6v3&~d=L^}ad?JpqK3
z=d4HaYUrrQMUn~9oj7Y9YYsmP2$=66*H$q8PNEblFmwH?o{NS&Hr`zuKQQ$D#td&k
zzv;uTA<WN=F@Pl+!@>dm972PP$)3gWZrK?lM^Vnhh#y;Rt)_4MLu6Y;v?CQy`Og97
zWY_&Yj6T}^kP~aIy<0Yi-PGwWcZl1Pj221!hVEQ34Nzh7*OKIAXI?Y24b*Qis*#@u
zCet<B8Vy}$M6wxy59I?r#>CESDDxL4<+{2Wx+yxDL!+NpUj>#@qMhw**j?P>9<sRn
zSvL@Or%~ODNJzCpxFbNWF0vzvL||iqqRCEp^%H_FR)yWPZtiR{K7qmkTYkHAsSpOs
zY)>K4LQeV|XCcpdxo30l0QGr%0!{wLrU*F&+|`9{_{PU9$7%^Y{+eKV-O27v@)kCH
zDaffh>a7I6KQCrSEFYUTVs5N*X#^lztQ-#1tjnV&zy57sm|+UaJIgb%mEAU*`Xz|Y
z3xsSjVH;le7kGew))mVEvl1>0?cS%88kY{gUK9n561%*8#5rus82f$vNV4}Vnq(*W
z{M9((h~ElXBT21*5~#BJ3H#bku~sbd@E6u<#fF?e?e`<^cR%cYSJ8Nk3X?t!q-9PT
zepbaY6vv@D%U>+`U5_ARIf`JJhawWR^tw1;BpctSdu@f(G5W3BYcSmKOfFwxklpqv
zQVEaxujnIQ66S50K)Y<TerfA4t<2{TkWq?A`I@z|0@il~R$G{Cn<Vn;xT9Jg_|63$
zr&;btTCuNwYIfE))s^YQiHt}OcIH2>bj8P|*7RsONynt7-Q6&Q<F*PfQCQ0a!Sev6
z;QgIk>&WogZUKg=KCiaV;qCJm!>0@gRmpAln~rwkf)@v0$!tjV8B#ml^A8lhG+2II
zi<u{ROwCRM?uvO{w%kFE=a80MSLj8Qm9<Xu{eoL)><RuSnfBu+)apB3^WV~w04lk;
zE6mO7X{YD9i<vggy3Xsi@tARQU<+?Xk^G+TY=0z)qIYP4&3M7^{z12^ShEKo5!)w$
zDyj?ca{F%iBZLQ5nwceGrPu4#thTwg)bj5?U{>H=*G^Sunv>gP{;**U4X4@RiqCzT
zzkLs+8T4GpJw@BUlTuEU8vpqgwT-_DZrjRaNNnp{GuI|5n0&XslCxvk%0-j9)pUX(
zI57xYZDnIHvGQ9c90l`a>Hrxid(qt4f7UML)`k$O=CSuNmM45J@&;<5*al6JlF6%R
zXoYa#49WIL*~ApH6_IPXg49|)>eLibFI$|L<OVo+9F!tNZLTXA2)Ga}*4kqo9Wt$X
zdy-d*<ZUd!K;2^-+j%^Rp$aUM%*T@`p6Hl<DPd5Kx7ToKGoRt~>8Q6%Nd5FPF`!wV
zb=?0VHvU#IgU!g+Gw!7tCTsEEw2e)1QIYZEDs+=h=UX3%WlQQAOvMX{D{K}%l-qP(
z?e;`;PU9t6Mr}2d43Rx9Dn`PmH|bAjoJqIp_uG9Wk-bG~{@xwaMUn<)@SYRx$+H%)
ztJ+!AM|5$O$ohCrsvfV-oCcwd>cJ<&$+gnRT2THcCYkBr!D@y$P!LJf1BnuBTi@5X
zhrOLKUh0YiXllP-^NI?oA%=ZbgEjOn^8ExQRbyp?V}m8+ShI9Q{YBZ})*PqMOPGfA
zkxXT17x(fN4ayaGCd*TqocLQIq?Qyat}wW6md+Mnhz|Si-o~A>Oroq8$Nml*J>PEq
zJ6WQ{oZ9=PBm?Eq$H3J&|4Z&IH$1Ty7WspU2dQeiDfa{!?m>dHUpv2B`&M-L^~vDH
zti8m?4>rAB451!Rro-`ce<UAwznHE~YO376;=KF$Cw>)u;q0yZfgUy=g0oT{+tDhy
z(K`mR+}MMFYV!uZb)!}8r4j<#XPU=}4|W$z1Okz!3HUGj##;s$9ggwDBnw8Y8LeZ|
zG^@3G0PRG-)|-XcyZBI+6r8sA8RLIHd?NSLp>*6jp5DsGN;6whe*LOU3?OBbC1vvJ
z>6zw5F@`+t)pKO;!DEv>aY2*~n^)UJOojgmo6+9*k0DOkzMvn^Jt2B`j|Y~9NfjZC
z+ZFd$U%6J-H_O&&=X?)!G)(SNYg(pp>E(?t&1;tLf(WSdo71=R6O_(64k%DcF1Na`
zx%SbR1&GwzT^_noGQ2BY;SIa+mPh$sGdi!fhBYqsix}j8>670hQKsx@@8$O3j+$4-
zxsUXtBMHvU&g<*bcMn?-4tTTU)NWM;olN|ZZa?>h!NTdn)9QX>X24%zCH=RN#MKp^
z#7`U>NveE}7M3dR?S^;Xv44&a4y|g$RMQ67$?oJy7kpQc0f56$F1G$n?7nWAuDeTk
zSi=Z}tWkbO_PvcU0_`-vG9cx7h<iM)0V^WBMT|r(o20r%=-6jv4U6icN(0%EI{??h
z<IeC4LE)`&Hf!F&R6JsHlJV(sq%&4JVeIF<0er5u=frDbjx+*o&@P#SpX<*MVT>-E
z0heo85D?am%V@xl&|HvRqLui1C9L{^;;ETmlVI6z)sSJ}+S0K8+>#?rG~df?Cws`*
zmmI6U=;mxsce$k7f^F3mdmc;syU<pYK4q+OvnQSL$t%>y+6Dv&q*_@0hfe&7fcLLu
ziVh^3;GO|P)7R>uK~T-eiK9PT6fNU;xufnl>ZRJTgM2|$+Xlqyi5k0=g}>7iH4S#l
zVa>X5U+B6GR`?U`DlbGjSwr0GI*ao~e59*8vt?55Gym^z=LLj3-;x>}@VgI`$)Z@y
z!_$sWx+&b8ms7>g<*581BIOdyaC&wD{uDqn>zL!n&&RD}hR(m<2ON}5W=mg&shSUg
z-0J$!KrS8Y&}x}eTj20dF=8D!xZKXaBL0bk$>C5ZC)*_A=&EHlOVmJ4;%%aknm|7x
zgmx`;hbFMee(49ndzBxIvj|T6noeKKCra3YeZei4^SCJ~+po)|j~NF^)Qz_oarGD6
z)9RidmCX0|m=He5b<f$a?tRDPD_3#pb;TFxTaE26lWUxUnNcS(8mzYVcueg!j~$2$
zOBU<9J|QEX67ijXtr<gmZdhja%erK<zXJFvfK$KudBNMju*zMd9{kNXG-HTKYpErO
zy~8Q({Y#UdZ+54IkD?7`oZjc3^?f~hQmeO0ryA@mbCgNr{W5inGe2z8bphVBNkn;d
z@H47kJvM2C`+m>*4m*}DE(LSMKrGkrdF4U6%P8i66H$w2TG;}tvjUx=&Q?e4?3dyk
z2kJK$|5&P#EDDxd1q^kNm&*I(!1zK*OtUXsAy!eVeY<bB)Sbmb?2Iy{2^3^g<RS)N
zJ;>)LLhgS%r+<oER(-bn_yRKH!4xykTuGg7c~@@sTh*m-WMg;oJ@ip9<Z6c0*^*k4
zGiS43MkJ*>i6*>@9UUl|{`2dv=_Nd8fVA(&zWv)|o){FAtm_?*%%R6)fu{2>ME(+$
zza>bAtdiX)eOk_5Vcm{J_XTgdlE3al{f5G{J8HCJKgpl@bm$GfA-Tsd{xSNEPwU8w
z0cShhgK0o2$)N~2Csef9JH5^4)jKsQ@U#}GB%en?)$RZ#f{OA1$ss|XSZ4+Bxlcyq
z^MKwX5ss2G@0KI#%?-QUeXnRTp2019q)ihA)OokPd|@V;quT%aQxk>rLT~wk(^^V?
zfXqa4^nUOH2Kml$6nX~{fqVC^g|?r8<LEOt&?iXkC*-b&)^=^Y4t=~oWBynTL<GJn
zd@&FH)kCo&b$dXo_EmwR_guHo;6-{eh>b>|a+FP(<#tx(Mr6_0M%&4m2|GZPEc@e~
zSV<B|zn7&s1B(@wN=1wF-74WL=iDjoZL@6ltg&Tk`G#Y6_8xf~Tq;}+Peo>?sGrXB
ztwva@PL8B_4=xdOLB$`9hl%VdoU4XRMJC7?{wQ2jCRjL4q7P%{6rXHifB&2w^WsGq
zk0Vgy?#qH`p$tEfC;c;@k|_}+VJ|xU$C#@S)?ojylT-NKQYagS=K;F{q2D8Zc@*0o
z#yguh66tT1>{Q!x6Lk3~TR#RI^!X^q7wg6x{dnZ-di~DP>d*!GgIUS7Nstk@w=L#q
zQo}9I%fRui2pG<|Wv}ot)|yL>TlX+&<?0E=f@Tog<%@>PQ0_+0U3S_)u;CH;CCISz
z%a==dCrph{Hz9atxnzU={8vMOQnAp`m}df0Fpsk^>RPj*2dw=`&_L`&IpJBtt2tk2
zpu#EV`8_C=6y~VO!gz%*$5a>TC9<-VkMhSizKnIXmN}cIvG=$FP0|I99C0QyN3D6@
zwX$?vhgcoU-*mp>Ft>6f*i3awA6)px?;DTLnh4-#{Xdkw1yq|$*FSoCDim6v6!#W)
zcLEeCuBEty;uhQqaEcZPP~4$Fu_B?kQ{3H(OK=Ysg5@91EBF2G{ocFoT`TKZk$Gm%
zY@6SnXJ-%cXWC;e4ZaR+tfq;pZYEGS-N>s2my`y270Xps2ssra*?3WcUpDpJno@=a
z-;~`}$bz`zvzT7@#S5!_V*kjVi{rc@Tr#)_?GpUi-DmRetlZIC9gmNVObAhdzE#JV
zz1A8=2VHuf`d5Dl<dl`lYJH43;d65yQm^A8GEQWrU8qQM_%vqqL!~b%Z|XqFyyTi-
zvMz_YApraM=slE3WF6xWsJuOk$Ii9>En`zmB7fyePY8*p$Am8KuXNp|2LC6=e#}!o
zu3ikGCw6XMXR5BVX4-PqE(4LDZYr;+y%rQ^tb@W~Nl^C8B6?RD(qszc_g}zc&5$AW
zjJdaGFFVfq8I#0rz>RZhxnr~g^(Xlu>tR<8c(pxPp0)36YW+v6zP>-IGRCEhq0upx
z7!IxRCJ`#D>$T1Yb3%4676WvgYVMzoE{VstnA|7(rFt`%RWFeJG_T$Ku!DDDcvTr8
zx)8>`Gjch8>0x#AazBIKrJ~aBJlbnc0(cx0SWQ<XvJmDpaEVtfTp>09sPYRwrWtK5
zwx@0%ZymRGtc?=Okv{oc`JF`2dfG5l?jQ{;E7Q21ztV1mznVhIR-NyRxZ-bx`h~*9
z()e+Q2Ofv@=()j3g_QTF>c>RU8Iv3BdBx5GD%bw2+ROg)S4y{j@JVFyag`C7pj>2d
z1_gNPwR9KI)|GF7HQ9MLjvsb#MnD5qvZOxOdo-*h#j^`w)y;s91t?__UX=&2&B@5g
z@adl0&jRzzSjcdq$kR6VAn|0dWctWKGvCHh$=OlKCgk~C^TG2zX9n=$bL*x+mDNSO
z9p7+Y#)fw~=TL;k*^Q~G$vwt$_8Zcb?bc)%yNJYb;|x35VJTg2)>(Y1aO+Xb#+<OU
zOT%<kxKBdJcGWgj&Jx3DYvYXpT1v2cr!}P)@W?*JGDWk`Gka#1cjCvm({}~&p5(9w
z|CdLZBIPsb?VZLue}GHXkjoxwku$D^E6&EK*_*iwzwLmz<j<qy4tC!i5|hzVat>%d
zu^{yHATb!rq%1f*9Kj)<5tbR9`()ogtzeQnX=X?CmI8=Kn1Z{PdRTr@yG!!0?q-WQ
z+-(gg&t9%5+j4F3_6~uzdf8*kO`TuJbgxWa>zq3xvG$++SV-<hH4~3?{}$G-o;sv5
z;0;hTMckd$*R-GIt3=uYj_@(FCu|nH%?-CY=KzkR(uyACbYY0%aV`SKWD?Pu=i=@4
znJg10S*nlk7+%!gy_@z!?};Abtx-ArMM;X|WiE6{Ue92$%@_cpMBIn~e?)0EQFIX9
zd5mtn+V(Rw2!(~dx-&wj7>Hi`WdDW>r=ONmYPKJlZ;*Q5zn@FRH=ZB6{Up&fNT(VV
z>QaSXRK<?)8U2?TIl#jmSMPz-5cm7BD!oxh>ZokNFllo04LwCC1=sRx&!*jin=Yp5
z>QLwL6Z`yeJg?$mEC`sx`rDykR#c(0H2t$G<cc3)hXpjp8vAoW*Gxox;$4s4W5T0N
z@60u|T32G*W>%V%34iAk#u|>4wZKcoNz}VZsg;XI#~%wE%{I8kjFh(e6ejnwKINw-
z>O8ki9((___}#X%$%{SWPl+vt;@0;SE@O!tMdRv6Tv3KOvB;`fU*iy{9!VQXY1+?`
z?2le0$iqDN3^QnlHo5%OcVW4$C&S0@QOgCE<qH?E0^g-G)~NcGzo_e1gvs|TZ!vWQ
zw^$9<AI-jQU8$h1Ul4w^w{?g9@`Cf!yJ_S3VwDcS3Ti&W;N3C({78=>I4pB1hfc9R
zjWi@IGZP+MLW+YZ#g2kH8*QGo57_RW(TH)oX<r<*=fM^rg_Vx7gwfH(JE?P`<nn^H
z4WcAS%pDVx?>t6F&$T_u&bht{3Ne+C6}(6f&iLhN>>)GCSnR_{z-I^**AcqvOeYzJ
z;$RTk95?unujMdOx5O%5v;%93t%`fLzION5^|C+99Uu4IJ!iI-a(_hAj|NAt$;d~e
zH^}n(M&0gbTJTO@L&!bf4l5k_iKewBnbb~MTXQ5Tn^GkruI;>)ymMjVPg?+7f}z{1
z7@qg5Lzhc7Uw9V?6+NY~9FxQo=Yr_IEgz&W%Cd_Kc-D{VgDY-XcB$9EzyY4|tEB#s
ztS#V@XCoW_NS0;l!GR6c=17({(~=tXRbQ5Ng3e|2dQfE{;Vi3fnp}NVAru|Ce|OfK
z`4P9;)H5An1yK4<&br(_zP~*cEJY^s^(lzMRnaf%+@qmVKd;%4-^JerpH|4xjzomI
z)j9J|sC~JniPA5@61-l}?yKCQ-y+u`#XyQBpTqu@J)T_IDiOP)Sl$8FET{a>g5EKz
zG``V7F_iUo(O*WW!b18wT@IAdPslTRshk6ZdPW7k#|!9<#N|2|dZX0#h68oZ*(T9B
z3w9zgl$rKhna=|blMa_s%bLxcs1A-YI`yiW_YYnggnXcoT4VJkw#NUl$b6s-+=@Q?
zO}p$&Atbkj^o>5_y2#8Q$~b^nqT4C1h1)2H9}L+hQEz`@z3(VkL)J!EdXCU;2R-Iw
z<RE)(xRUKzAiR&i{j=&Gu0pua+Dqz<qTQ=T;W1V_5UiMEBKJZ33N+?siMM?;@zwo4
zlS5nsXMI;$?(-;l=@iicvzVO*fKz_JxmfQ-iinM%vlQ!R4P!ybv6k%X972Ut&Hd!7
zylGY5PNG9o)JUrhOH8H@Wih~G4<SF-H$@)DlUyACeZaM#H9mn*MT~_xNI%DI&niRA
zF9d4uaNmtCH*xEnB@|<6m3Y?Y`AlRm{Oq@0c}B159aZYU5q5uDy{Lliy~m0I)$ox<
zKdn`Q>K)`PTz<`$XouLQ=Zge?8z0%kGcsYD5fzj%f4nLJvY)!bi#C|p<sHpJrOoLw
zz$J{JPK~f6eglolFF=Ob*U#l1Hzvr*4a^VC2r+iAN9|r4NX6bvn|s!NJI_ie^zkun
z1Yj<y`PKHWcv?1zT&SD_E;RfBw<8387Z{1BE!quzUx5(eXie(It(Yq1A4MTlh2rL1
zTjFURr~S3r$20wS#Nh6p$6~5}_&SBHg_Cbg-{x!|*6?c@?IJbD6nTHdIgxeMjC3vN
z*Wn|av#H94$?NWBw7|0Gl1DDZca<t0TB1evHt^y&i)DMnxhQf!FqtL3T<lkb+w_&Q
zu~7}iFS~=fk)}%%#O}uYV>J1J5MKZZ0eb($PhwUrv0q=JF}k)hmfdeAqnS<AqtN_>
zX62V1#8pS7X9nrVoil=zl(ju99D6;V3r-z{xixN~9_d&G6;77+2vYhD(1S<EM|8G@
z=aG8=xeO?}4*l7*-kvDXD5sa%bBz_)qB)W~jQ)7V#2l^Mp9tkJT=2i1L+<$nOY+Ej
zv|dkB-3yIsXFxf!<PA2noRKPwqdHElB4e*JMbD<YXKfAh9W$WiBd4suyLZgm(pLjI
z!~?&@+nie)PsZ7PpbE~WL-wb1?nZQuX{#?FpsxTXpplLKSdvYqe)fs98Kb|g_}Z|{
z_PZptQ^iU;-v%C?-1t_-7TY4d){wTY@EL@71JVz_?>x+CGCB6f-i$qrGkt887m05X
z*?BeKyd^v@Jc6DWY{<3RHN!hvh@o)ZNA&b_-B!8|Fb2BdL6ASE8ACVEb4$8XdQ>sk
zkoL3bj_!!W{-i{Is7oeEt@McqUp0Ta@z$i|vY5o$FX(kH0ISE>AIn~9A!tGGTlCO5
z3ujz^H05cZw<qk-6aMUEENYjVsd<dj=OZTZySSbHi3#|+-N*2=-nHcV*b9Y^UyXmi
zl%i-$k*3^!sXG-*+s0DhMC52-M5O`W+tkk<JtOfZe=np?s5O733BJeNZayy&JJ4WC
zp0NS;q7&L+pTo^8R6Y%T^%2FA&ob;7<gA=~#Q$um&7ySp(V274;~>0vMq@2b$4-h(
zieX(?-m{Z080BQYXsJ?apPbx=2qh~&HR3HRvANG>?!2*w#T~p|b8KPxOaJ$x*)$2Z
z@mq<!;O^De26=LTllSEVXDDX>sJ8njg<dcV@fBm5w#kAv>b9X;e|L&|On->U`t|uc
zA*zJ-bZ8($y30`|C&v(}%|gnCKSTc}zs-nz)XoOe8Sw_Zk?N+#3y@y&31_%|nbcVY
z`^46?2!pW8pv3u%7zXjJqdrc1ao^m$KWDKo9b;j}*XKm&)}3DU{iye`Mbz6{$QvMH
zX92uSGgvYsLo*0cQh^LoeLac$Em+RK#`|<O?VMLWDRp%|+TW6yH?Y}OGS}SWiZmPt
z0;HYl<LA`!V7U;p=ll)WeH`<lr~vthiY`QNI&GCAtrXWIO8b(8j_|TeA_)@hcD!RL
z3JZ-36l?WZan?=I;%u3bQSEQYRu@8$)+b*kW-t#k9%gElsT1xpfGz9?v+x?NTB@2t
znsn(T675t(jQ4*?k~Y8s>&~XiC3hRPzCac}yE<H(bu|Y7<qBW}e$?mt17$G~#E|Gn
znbm#6Ot4%NFG7z;bP$-sa;kdu<IN5)!3JGr3HCMkx`NmAFp2g9yw$l(VK!kp+~T7c
zMJ%EoX>AJwj}qlW$K3=QCB3K8D*Ro`FrgUbhpQKzHE)`i>peEO1J(BR{M7b=<BYyJ
zS8s1RY8WW0em`8^^zWqq#V#j;dp3ImXtq<i0+epWk96|gxOLF0pz9Q3>R!!AMd*F)
z`7jh{r(!wOk-4AK%Qi50jp-zbF|vQSD=XRRX=8OCbHR2lT0Rr7U3f&6Aa(2Z_gs`_
zzR*c0MUKNPP1hD!J{W#xW9lYMXvwedK+CEA&*Lx2cW3nFztH2*`JGyWzC65JU9^g3
zJy5oBM^#q-ARLG@MKkuy#>>j{Y%bMKCF?k4KpFY5VQZ`u;54Fwu`H8Z*fVT+3HQTZ
zaXY&C29zr-Ok@pcp%opuH?-@>TS~pzvvjmTvL@(oz)AxD8oh6tM_&xne_5f7>^iIh
zT4U&xWcgo%FSntHxq#WUleug=6@QQI`H_2zG2@yywsPO*@oH$*%fjdJu6!3&_)m|%
z2Q={-*Llq`Yz3?y7HQ2|yRHn<`<gGyLDL=P_4J~LR|~WH@>^y3WjOptzD}j}H7qIa
zsEjfm?Sm_1N5xl09UnLg176K^Tt*&3M=oY`oo0#TEYK0hl@?B5(4?L=XuwcH7yKB#
zX>ccf(UPQHriK(R)T3;ksTvz)&e%sKNprVR-=gIllT?al<!?XOy%P)jc>*G|2=(z}
z(o;`WV--71Xi1zy@OoNKrMana3)?D<Fh2Uhze{DHvU{b!PR`q8@ef_;A9Zorx?a<N
z<&Hk577u;V$9K<NKeoAJy{^m1{jBz&Epbh;-=7Ljr@6(jo0rhLE=a_rYoXaUj#<t>
z2fcFc{-b4GZu;qYMD~yO-*j$^Ts|+a<gs9c{18P&?UNg$Q#PJHG$4Iwu=&v7G{_j9
z#}W%037Af!@VqaX2{wkCvD^?!+;`taWN$gPt@q~59UsH{NX3qB(ZK_f6Fl1C-yLIR
z-?m=3?TP+*zQP!;ndUm#W*~sIgoL8|H2n+R=iZ+_-D=Y`W32uk8{QosYa|9q={?5O
zA?v&PQU5?#1Wj18hT=SeTFd{T5q&OSl&wmFrMB_geL{(XN+28tT!dcP++VW#1Jds9
zsbVrTX5MuqK11j9d_t4utp&m-&zgX6Gth77)z7V+1BSGf$oov_Rf~CEsUbx^9<Ck>
z8A24QXaNPRv6NUe&mg|oVM>^{TQ430=o2Z=f=levh>;o4t783lSn`V)ujW<+uVIwQ
zdLbQ=DnE^4F63;832^Z82czMzQ@xe84LD|>Ase@CJxor=H$?4hqm+N<0*mP?=&9pV
zd&4moxy;10p^*EXJ7^j$bB)N00O>Lus{5qmgD(-ycV9*K)^wC2-xfcK&I}zzKe(VG
zbN}?nv*Xu7G_9k5jO|a!$9_MFq5wA4X64OwIQOdyIE&T8a@K8+a6wAU9};cS0HPr8
zL6Cfex>X2nFQ4oZkUUg=fP7JNbQ#Ob613`Z%1-$zO~%A~728<7nXbY*@783@`iD@P
z>S?gI(AE}D+nrW*w$_`RGnpfSUr&O)nzaAGW#q6v@6#0@cgyXRn(2wP0x$Xq^na;)
z|FL4W!GTaYBknWqct%R})_An-7TpMR|7*%YuEi~lVWZ09TS=W)S4Mn){#X*l<`cvN
z#mYb5vk?tA9Obb_908`OihyQ%d|O8%=BC?_XwAz61bSP;zl%w$;kh|(I9G)4VZR_?
zxIMhxLX(;vryOP{Cdheqqg3XE(@&%7FjvvpSF|j8WZ0{j)^?CKFdwdOcxI-|@g|?`
zQnWK%;K)eSr2h8Wz3P`G`0#7a%OgsU2!+S9pQIac8ejWnzgR?uj$lko&qu`j!t(KP
z$`C_WwMR9ZX}%z}<{WtpQYMF&#A%GSVGe=MvOqR%DWn1WLNkYblUzX(&J!3B`{m-Y
zbba;9Wp+6o*@QP5=d-U#4>PJM8C0tm3dSY4%emKMf9ixk;p8(-Hl|pFgH;IlOd!Cv
z9@`XaBi>cKjwPR}t=j@M$F?!4?O5jd5e}P|O&;v_5;RF1{pyPqrBQF6;B8p`7H+n|
z>3^fQAsUFO(pb*k!eu$~R4)wYEe@-nU%L%{@&UdO@4{~b3_h~E@5WA^W|0PVeed1!
ztiAHqlzA`jh~uSy)Sk0-1S6L6R4i|)B4w}v!F)(-s(l34No~GfEW|FX(Q@y*bP7R^
zCt1!Dx735t(r;_?t9hh&@<#J~0^{}Er!>hQK2+kEP08)RcXX2DMxEzMLi5zh`sQg%
zz~HEsVeF}>i&=m9Yd=h~&iP_;s;?AuxWntO-*}P@|C#!EJuySF;b(9UZYyeeu`FZI
zE3`Td-UUqN?_qOg9ZrB{ut#outp$DOh<V>BRWLWqxYyIXI`GY=rCPZEjMxYlsO7DS
z^(b4I^VyOh&$5B7V&)bn83hg2h*?wsZ$r?BC)=-dDlu(1f<ogRl<_>te|3^5-89Zg
zEOHst%Srp@WN74`atu+vGq<f65y|QS^G`);-~2qsh+6O&uWbdTsl1>J3}2~ORCy14
zF?%0f+#t~K)(2ak&Z%}KMpxp~fg}ifeyh3Kl`yyb7bx3~j+@`$S$_~zh%V;5@3Z3a
z{TQ+4eChSQ@;lvm3p~k78Z%D!Ov?8kyvX79r-Ix4q|A>J1XwKBaeS2zt|v-YrWzRB
z4;Uu8cp7uEzy4hEi7Y5GyEE}UigRQI{RZY}TptMcZ={2}EEl5298g<^AXVe4$i6n0
z-$SCFI;s9HSyGxd)`>&C=XxtBdZMz!Kk5}a9kD?#ObK7`l!OF{*Z$?QUm#KIx}W4{
zv+PR#G`AR(F-cZ~pP@?&VW%mnSHiAiZ8caEn022xspoc%liU~=_w|o*8U1qCpU1pa
z@W>$85k5KCY62+;pd9#i$aR=w;IcySBl}6(pXNhy5iM(7R4?NGf?0<x*)hz|4x15(
zFWSpb9r{;Gb$SeLZW#(j2DM1fGxf)FWXc-MT7G-R&LM&g7+$dXwWhl-@@$vp&lkt)
zzs0S8J0R><%GMVXIb3g8sYgDuS<<)<Zfy@})o=KP7YO9nn03FoD~F04EaV$hM0Ip@
z1X-6TuQ~o|qW|b6{XSX`l`F*<AmzI@Y(eP)o<!f|xj=rMM#LB6mxx?o(%z*S?OC~>
zmJ3*CW4?YbOB^6UwQ;9JjlsLz9J2AOron-<*U>Y&C;VHUMTTVNVqnT+LL)hktexwg
zm1{D2>1=^Sb#uW(U|~)%S=0jJlc7|HSrUmH_quLgJ~VL5v!GQvLc&a`PUXc@P%+{D
zjLq7&D1!)m$D)IM<~<;t8=SFPu(jvRW7YSZyN^wVojF6%r7m7^83*;oKPAcYZ1gl-
zkdKC!mY%;8!r}L7{spnlr~Y&}U_|9KaxA_fElg$c7WC1)vZu;9R^gS{&$NN0gu2Ny
z9c$OCgRH@*!G()Rfi>?*RiP61YWsO5Y5^9J`g1E-ZqRFmz*_Favees1NP)Y^$1Ad!
z8AmEH?F7=Dq$%S7#pP<_#AXZkY$1a`(>{f$`dz_I)ch?%n!9V)Hv(Uc*w2n39?O0C
zc<N-o@WTv#0<q6rwvu*6GW8pfgRCSpHNGTuTP*|0&%d+9rK%<n?s-6>;I+steY%De
zCM&^amF`|Ca_lX1)jd3i0UhtY=$kfw2HA~UL5!!#xrz|1l_2&a!-N5CBIUDBmB-Rr
zrUy{Vj_@sLRicUFcmk;f_iI&Cx&Z^OA&kh_26QR7V1OjCH~1YyX!dR4DgiCbw*r&u
zuifop_LLNQ1}!yi+2#)ncMM3ojEM9RA(d1OBHA@R-CX6sx8eyT;da+)vhoRzr&oWG
z1jU;ui*@&1QI*P#hnO2xnS6i6-Vr-t>L#BPPsegkR(z{sRo$S@6dCJ8#-_p0{)$==
z(uJ<?N=r8&_(1<o;GMsIcr08@mlauc@~0kGLB!oaA&IZN07YZuLV||}VCZQcn{0<o
zg-q%bX)qJ_>)CVusIN>b8*nA=0VDPUg>loVD++sQI3NzwcG8KEKXq=m>^sP(hVs42
zN%t<aN(le0?Eu8#lCbqz2@_{Klej!2;y)(foaI<`sLIXLiV?Z$6&roWMiP8F|FS?6
zGOYd7dsW$Qskw8@V)F+x?|>;?#xtb^1+K2J*R;;)>ZQ-aPgSU>UzstPs!cG<_8?50
zEn+K|l?}V|a#{&oBQypE@;k8tmZVo_>;@o}B$$QmuPt7`gy(e08=`B?N#%m$dojAc
z7=MZyc8Z8~CS%i|^#(mPN-PB=&{LRJZ#99)CC7o}yTSUU1w;Rpf3mkc<Z9^AKU=^7
z>~tm6m|&6l2wo1p?FoFWL|!_xG~wSP*lz8bqyG9q#>(C=LXjriJhODNWN*Xa3^BmS
zpNDq!+w6s)k5^P|AHEK)sps`k{*?2b@0qaI>LyIT7a1^88>`jGLCZh^B9q!B|375#
zh+7su7$NbX0QN;*xil1kl7EORsj;xj0^Z_(&wLROH7JAMU5;lVs|N|5GzsUy482k}
zr7PdHBYUgS+7EkddLD<5fA}~1VjHt@!pNemy8J^lA$@;Td<g6Y8f@4Ll^8LH{6E>3
z^(_)0{zjJ8f3AdtbS0?!u@|T55P#%dL>LJ#*++wOZFL|l;twQYM5UAh1ajQYv&l}f
zB^@4H&%izLTmd5JeS1w1WKcuV%d2YHRk?y|=yNO-9<f>@v0D*zvmI+O))Q1e4aQ;_
zQGU9h`lf)c3v<^lX!%A12PLDI6OS8yVsA+HRo}3e+d}Yom4N!iQ|kXzYjLGNAsa!%
z-yxn+u=06#ZXfSw=IG=%+Kr7@eiSP`?15W7{&La!Gr&A4cp^^@N9FV9a#v8?BqpVn
z-52Q2u-DUCw_+XtVIv?$h_R2;YSK!%7wwuVhewxhl%%ofpVAZZjlJZLU$5ow_sX`5
zM<@g)m;P~027Q}yKZZ87sShJL9e6Xl8j`v8mJWgIW;x#^(TWE+RY5Yu;C{h#9INdl
zN|F;j9#sN{bk5e4FSxEm8|WDiNIhvRJovq3ZL&}e3A_t7(EJ$r0~#BRP)r@`?u`lH
zjwTk;Od8>r(c>@xUj1gWwl7ESi%Avyt<JieNf-p+)Vi@_GP%ZL&ex|UvMhYTIi&fH
zwYog*l~V2gu>#BOd(c>)`26X&nhb96w={2>ku=>NKy%Fz*2j@ZT_)>SXcLbCYogU-
z)>H<EAnw9xH(|IwD?q}@Z4d9oOz7nO%eNPHz7k0omGEt~<H70Byf~q?#*8)&tq(Jm
zxuxn=A6^k~uv<4ir5&(lycp<}itUp%JcfD)r=My)SS&Ak2knB5g_q~&GA_laVGqxQ
zVA?T_Fkhb>DXD*fe9<H?%K`1#XiidcYb_JdD+k@9E0P3vLgrmu{Fl>_XbW*7Eb%Y@
z;Y2b^S?MroI0p_1W}@<96<)vCs>r`!1ObdQ$-~Qvc+r2*3XdQu`8Yv-S0kAN1p3IJ
zSs6C=W>HW=m5oHRhj5jZ`bA>(z%akxFzw2NWBo!BKO|r|Ff^3n8AU5<%VrzqHY5&}
zhmj3RD}ruba(t}*mAh{27TTJ`cMQKMP~KUW?vfW0ak$8@V-^LxIqT?^eGiGWyHAsA
zWk$P7ZjhVbvshGeEeYo6WK(Bz+C3z%^MzBqA6?IdBe6&|9;E@~o=nvR@6L1pBBCh3
z&<x7;*RN1%0Cip_#)RO2GXCwd<m~h8Pfnrqyx=DEg0}1c^wBoN;AS8GW0cK)k`lXf
zry|Npsq|W3An<L9ie64ASgk_?lH8lSoB$i5R|j`xa_7`PtUoenEsQysvKxQ1@7u6~
zC70&0V)}JhAW5!>R!b$+w%1g@=*zF1rYbhE>qY_v7hJR*V>he>``WNfyJ8DiG~=D2
z<=X3}T8@|nbf_R%Vq&hM#A1v~OXv~l@a7EjYR$uPw0$dJCmOy&Cb1^jyG|&3DqZbE
zk^y<<*{>~R+0nhx{&W)QPv=oQ0U~vGoYENny|%<^LS*=^6;qk7kI8yPaa87XR_W4X
zzl%U>R9@@#V<l=rx;_O?0_DQzQi_=IZ9R(r>N!MMKBHr4VqOp#Y)^@a8u-Xoj<lmf
zKG=oa$W$DB{_Krq_xR0cSZb4V!KHO3tEoL}ezZ3>X@OB?3Nee7?a%QzH3cAyy`Acv
z$pGX7J2}itf)T=dkqgO-B;`&Y?v=G*A)3AY=js>xT#aB92$@m74VV=&4dMOkFXO$r
zFGNF69397_D}El6CO(gO&){-$ZO6Jv&T3(z{$Oi(R2|qN#e--+jJ~6z3aMM9+>OQ*
z|MWC;%S^%{vyjS=5(v*ekawWj?Jw{!6YKECBF{izn?(Zqc^^}{5F;CCAVZ@TDa1R#
zFe{R0AFXbc(9#DpBei(D%sW7&N@{_r)@aN#VB27ou<16)6clumrcpaan`gg{ZvA0~
z)FK`?Q=_&4{l+y|B=6uoRa>h}-<1tPFU_@166j++05&UqcZirjt;qAY-XImM`Ku?P
zi;3fp*S`h1_n{g}vH9sFe|rwT=ZMZg<^c~20p9<+%dG#^#hrsc2zxCFTYr=%Djof3
zj?4LrNrL+3o9>sYIVKX{7QR)Fu0j107oxv0^X?@ZX$mb9oSh!AXx3Iiq~V{6>x2G=
zNe^m@`(<2d)hG+v-S5A3%NrfvQcsV4afkq8-rbuT)AQS0F$Y#a<9JkWqvWT6f>{gx
zSlQ{!_>EV8V0X|{J*tz@kUcO}eg*%jo*IF+@P9*}=iV}IP}{CWCIN4W6UZK1T=(Ok
z;snNCs_df=0@g}GGOHe`>Q%Br^1VM=RX?;au#bjUN-c53y)|5BtMRKyuOwi&pmSU|
z%i|$LTe?ro*9S{~#7)M?``pxGrJJdFggjn=iJ%cDbn8%2I@4O&f`I0oaWns&!rGmC
zY>Silwiq+M{w3v?p6#gc+zg#ern6Xt5oFybpiH)v3AhQj<1V1dQT@a_{0`OB!`tWs
zX@9m+Mih=cYE9vfsi&)fW@DZrmy!)>0O)J7dQ^e3b#CtC5QOLU8`)e6okvt>c!;Ne
z{pUiaC-SndjcA}TQp4*U)+6&9YQa@)EAjz46O*b@k*zKv_Dl%~iw)!;$$fBW)~}9w
z(E~fs>Bc-;D|QG$%fovk{Q+~~<q_}=ylkxQsKr7|)a2o6r>O~t8}{NwJ2GMI-KY~|
zU5=~Lk}^krhtk?MQR<iRT1ZhQ7Bf*KhWS;<koIOU_YC(+S+EHFd!3;*mEjHH@Po-o
z{DpX&d@#r%i!M0SJa17N4-g-(`4wlQR^)E01l@t6PX=Et<+6}vq?R&UD^IN#>aJ&M
z5`j9T#zaMs5YOITP`!Ovw;r1+fA~r-5hb^?rHY-N(CDHBy8KP$GK;-J+f!90mEO)n
z!s2if#Zv{_w=D0Zu$Q!TrY_A~rsHECl04MS*`Wltk2&ur$@Z4#F%eR1-e6+aU~F!^
zcNEVhaJ=B|>8@#(o3N3G53j;#Vt_>Frr(PVEIy`(HE0wXey{0zPB&|lct~cKp<>#V
zF$HHo|8$J=eqQ}~R&raA_-DV-uV1e=T9xC2<F;DnV8#LK-U7ORJ-H=e%_7g{{rn;=
zIyaeeG6kI<lBSTyHkW(i3q2?HzSWQ5fv+bD18sud0)lI>zxn>srTCP%AzABi>!R*!
zpCI?N@}5kLB#a=OCnpP`+ta!HOu(XU04Eh!2Ym|~@cq*jHurD=QIe&e;Tmf;I0EE=
z){WS!P?K8%<?el)%)1b*oBFg74)ot4r5F7~(M$PY`9RP3tl7&XCWEG@RmcioVU~Y;
zd^Cu0ZaPBH&e+Y8hB~oQW?Yj#i{e$G&^Q{8qX`leB$*f1jiQIwmrMf5;q_)y37AIU
z+pFZB*iNnyuE@$V8=`Z3YVt(hq4l)3e}k<Y)}Mzzjq6mWATS!UjG~*<=VEDM*M8<J
z#PL#_GE2$EQ$SI@0#S`zP0NHJtY9U^&)mP?&kYP-!XV98zl$=8&|2_M7yXF4Ks>0R
z*XJ<e_|>w9rUXos^l6QSY!!y|PdkVdeQQwFM-RyW%J0LgLm1f!nCzmw8n8ZjDtM*}
zDR%|w&p9yL$92(kG|c$NA|7j<cP>3y+;NQ2iXRyptu?Y<vzYOXue*<V(3&n-7jiGM
z)=v?R$zvfaY?11usK+pnP^k=d8sKsLSFnN_zP-QnwD5=Odnmjyo-KjUdY1zOk64he
zJaU)Hi&u)u4-28i`q@mZQwIjNJ+V@YoRX<L`Wn$MG|}*}u{OKyAJONnHmL1&UI)U&
zGZFB@a(2p&`v?ns@1wKN`!~*yCka0#dU@7vYW_FQR~tjSc&!EKLy&M#9%t2lkmkeQ
zWAu3xcx>zU-$I)Q5=0LnOOs;O(<-~Y8WPW^;sGrs7pXk|B^)%Uxzm3D`bR9@L__7p
zv!;uLS9|+fWuyOyeuL--=t$Nd0)T&^kCh*XR@}B=oTQSCI+OZ>tnNO-tJ{n68LR&q
zEtbvuvp)oS|NFH6m++>}_NL|`I$6>>WlJ&Agm%}no*?&){$Iy5YigeHtm(&w9#>O=
zaip`(>e+0Qe)fNhKmW;CGB&OLc$1<6<M3FPe^H=+2x<ot>P%8_iD+F_OuysBk)WX^
zdJ^=qA^($4|C}~D%3|b32dT9GBS>|ezO;Mjs;T7v-<bZt33~&xu@6>91NevRbTKhQ
zX;>8@1Yv7X&!JEz)`Tv!*05<V2cplbM{hj5rj7dA<%LF6UDjPh@;wpck1p{X`7-aK
zl<wb@4}+mk+<Ac-<<~w^5erLRt_k9(Q+Ivz>3aYjUz3kK%$8hr3*X0MT&)BZ&4%yY
zQ|fwlKC#Dkb5*_(u*JY87%waS74Io_9(h_b?nqITT}0kiq<$2oAXMJ1tu~rL$G>G&
zU$+}g`^dCN`;_;`9!xuODzn9BBX@)C4rhHQLc*tGYhsxCLyuF4B8xxz5z>czs<P|G
zZ)u?1NEc_9c7u*~IrxX6X=hRBXk@bLPmgG>n3}e6dfc3!PW0%V?WGinwI9jsu&6R2
zukeXPiYEGM+l?BcYA4F(K3GUKW{4zhm^U`i&=7c>=wu|=1}5(&**ybUEnU1+g01e{
z<T%0{QE`m=V9zx5hMGoFd=9_CWH;MaHa%8`3RPs@w9ox3dcvvsuF9Z70i!UV4sXM@
zxYx^Gdux*CkeHH!<y9?}@Kp!HM&|^fvF7!<k>L**Q}4<Uj_R!@z6yZ=X`a?lqG%}G
z<KkUV_T~$(mliEjX59)qH5zf-<89F&l9(<yot8Wr#&$;D9HMmi6{{Y{%cdR^%YRZQ
z(bDmnEXiWpllAPx=>QpvDG6BUHVLJ3vWYhnOb-3DFaIgESh`vKI@rlCWXLq09hYu@
zlRk!BjGzP>_o``}Z$iq;xHj~Dr^WmSd40Cl5+BTK^zEo^R6aF1W%nPne8a$PKvU-{
z3jpA8_5vlC#G6&h^v48|$=Ex={qS<Uv^UI)6CqifZ*kLb!AiJq6=q>(G`pm~5)kYg
zAgnB67(Cab@UvdVCmmW1>^w{K<1X9|h4e3#2AmUI)QW21b`!RwYwr+PZ@h~xXeP+3
z5qqx{5U03$;bv^U##4=ndKm(r3T)w!`1kemxZVhSR3vp;P|#H4C=XRuko8E%rX`cx
zU|`{2mc5Swj@*1T!#+kOzb;-A&Ltj#(T+UJ{~I@Z$?B#Bk)DFrzB!>c^3A1|Hq4k;
zd^DPeYS@Ayise{$I*YG(@9_3&KIA>E{B>IF$iB0lf|SaXpVPDGAD4i#j@;&(MP6#v
z*Q&`{x`wnGAbmTClkWW1r?2P(L<C$Uxu~eAfxTix8<vfq%LNY(zD%Z+`!zkr0%RKZ
zF))8T6Btvndah7+s&w<?yp?!ZuShqE#g1VInl4Q0ZX)IV?aqyzvzm*#-hA*bE~-8$
ztRu9w7fBSo_-8kg-F=Y9i_mkdXVTn^@Vr_oXWYL_Eq#-Sy5We-89&O+TfvNIdp^<R
zQ-ClnjzLe+POpAc@WNdGH%%&m=@5`8<@r1H9cF_NG7RHwoG*B)WS<s*2X2qif2mAe
z{L5Xqe~*mso5P*4vbL%I8IL*RzQ<@;nA{ksgT=ZF5=I>9R71VA4<qJFC)t_KyjeMb
z-;TDaKaWC@poXhaBLT`)YUVO-OdkP*(*b99K-q!CP4xM6QRWjo_m8mjl|U$D(l+p7
z0d>|E(%+qXi<ndv`rdS&4bn8|$u4Inx}IDTwhoK_x>=l?+@>PxFOcU%p#?vW6>51D
zv$eGe5VR6fbmAuyT|(CRZ>nz&to^D2L?^ROdi#EZW@^!GU|G$H-TN618v5_wCDtJ!
zk6||2mCRYR9IHnD?ExKCxYOV8<@|4NK3iRv^;a1VQZ&b+lW$JJ>w0Tp8HZk_d+=l8
zrRT3n#l2>l=iI+~kEN<?YY7_fPy+&nBRVLbO#HbJh@4~{s5|4rxfHfLJnymK{-&T*
zn5qt-#K8AiosKw5shK)Dm#E7<YP+}}SOD`SI!~zP=2@QGux0CMAXa=(n2vM-A)Mag
z@LLPkA1Lj~QK!>V?{wBZJu9NjNQaDb)KEl6tK)qZ;Zr$*2)iFO_$th~LR0!8*1jL|
z55s$6jX~d0=}Gg6_l!DI7j?@(@AUZ|A-nB@yqdF5Y}xu6vnxIUTTz?P6Z%octTu=D
zYjuGXPjR#O9qrzW?G5Fg{UGN&NA*R-c{m+8!ml?<2{uVh%QBhpBTnB`CgJR@o$Ppu
zIb+K4dtQD0??j}k`qxgri8x|QAZU`>I+6jLfb4ULhTQLNtT3eA@LBtUzJ{7e)o$}%
z&x<>W%G_7+`xwP$?>C*nHywl_&n?|*v#1DIX3QpkxMIjDVOv`X!I=amGL2XM>$IdM
z-Klg%v%Soatl<8$jxz;RJS$e)^yOE#Q}9Wx_Eh|cy$G}sE`=H`Et(jbS=qP<@t<%n
z#2{2jju!onf5R-1<-v3r?+j>ZWxZ1?FWPr(X*(6DiE^G9QIWIT?$i~p$t`c=_jV|m
z%|>fQBB3r?Es*=#AHViVZcD;Ty$x9R6s!a?b(XwxP?x)3zsrF*%bC^%V*>Zh?YBkS
zk^6oVf;g?3sl;Anf-T;9VkciC>7KxD0!gk|IV`-0MTEDH-zL6=-Zfz{iu1Sj=AYQp
zc61I4j<qS(ub;7G6B{81c^oZmPrg~S!p#n_81=YSE8jP&FT68`zqBI_6PtJYTCjUi
zGDN5fwgty1t<f1=G(mW?b&%l9p^~ZB$^P{6W^?saO+9s`1ge!~eGyG-HQoVGSK{mI
z0Hjfrqc|=&N(uI#ccJVI?*H{tUC8w#2D~FE1wFP6h|ea0`mdvI_gBCsS2&&$^#YUi
zjQIiI%z_;|6AYZg-mb+_?gg&G5d~Uj&#BBZtT1$5+!aUT1qklX5$t}Rw^X>MTOdW;
zFC%R;a*|WB^PKom==y9#&}OfReB-wCwA!i37j1lxP_OpoBiy}!_DqnVa@-jVtBH0{
z)yM}_uU;K#X&uORGouBTAXX2^zt_=qL}gQCIA^4zkbL_^a#hSZz7Qtmw8mCFROAOM
zg(kR~Neks|3xMK;zI1lS)Jlwmmrc3Dl~(M0)_*h<?`buC+C?D>bKg4)u&{FXBw_|%
zXzfyLx365qm@H|nJuvv$w?RCTS?n>a&K@eUmg{&*vQaTa4|irA#`U%=SyROeoDoS9
z4jOrhkumscs@J<0;&VeQs6QRaN5%a|Cz<Of0x-3e*I2|Cwj^YXak3P$)Bux?VrR9R
z#c=Yw_-#6@v6PUZaMW1hyuY^K5dd&@TS^{)a3P@8m8>C`tfZqKaJdPUX~TPa>pI9i
z&!ahz&<Cqm!wu^*`?|#=?>gnBe4_RjYhv33YQx2xO1CB;y)KHCzv1tXXlF9Sa@)6%
zRM_K)wnB;kgMU##b-B2;d+{z7A7U2lez`UGybZ^{nf2^7-NrLEct;?(<!-+?V+dPF
za};sJJ#TaHWLs;U1VaQn%$j4k!FNYjeXjM#(P@Hlg&mF$Ki{S}EP8uwA@v0Bk2aYw
zcwzL4G#FLxjSAf7(+o{{$j-r7wuINhdLr~Lm0M&hGls>tiTAUI(TeEt3U=tJls|L=
z-Vk2&lp7}R*IX042G)uCEB|}ALoPCZl!bW>2>r~v=NvoQ8ReH}J&W}0-8&|#2)#Kf
zf`f(yA4Gz_OFJR5ly~^}RMxBYI6D1-NX*|HmpvUqEWuN^+gkslV>G8_Dt^z{ue)gv
zmWE>To(C_Dx7vqa@uFg@^8P*E7$d*aoKu~L-dU#aLCeoa(LD_&(GH%4TWPP!Ez4&i
z(Vfn@+=7<s&rXKUsvN)!$4`v3S{DS!78X?VovnK6Wj<g~2iFacLaQn|G(nMV$CooX
zU#3G|`RL3ET{#$7-5UqKXU^$qakP9R%@KhEyKN$$1;0l71OHh<w@!mwPI25@hV0QL
zO@ZaOldrg``2G-!^=)*fp?L`79y*=sE9kG03&tLPD)^H`{-bZ5La3u2{_J4Z)Z>-u
z$|W$>m5O+Fg7=qt@JKNg592M#VAtqRN5lRfx`3yds(wW27A_*&G`X&7H{w)oB-<-X
z^;_{y^k;WX`nBn!kK6jU<9Sd}5c1!zuOQ@<82E-Wo5Y^2USm{&?Qz7GoEQ11X=Ccd
zU)qGCO>4~KYuT_@xHr=%08SYop5Fmk^D_JB9wm&UMtWc9^c?rTJglvM?YO}2_9+f3
z@TCO)>npCX9rNTH;T5oB=utC=e^eA|I=;=_Ye+n7b$p8y8jJ8MbDv<Mx7rn^&?(65
zP@!09V;0FTIKB*Yyv`Oy8n~tNfG|pjI&Xlh*fDo*B4lmjsKtKZxZx={;I_<aSzzR}
zc@q5%3gHeL>Es=yo``Dm?ru2F=d4dAv}*I|R@lz1;QOR7o$h4hyj)+R?Yl8ztW7bF
zsw9*HG^3s_Coxc5McpTt3B_&Sz|dwaE7X6ciW<~j#Q48DwCGMf?w<Bu`+iwZxpto`
zHey9u0}Z2;ZkzVN>N~2?fmEq5hzu|QcLQ9ypW1klfrT&YS2o#Kz2EbVOQ4;CTDed`
zzwct_gO_lw0UAEEyDN79oSgKX^}4|vjh(lt>U0)~51oCd=A%Kyw!Yo<O|~_){b&WP
zT|cKnG&O@%gigrsI1QYAVtlXA^M1a4x32gwO!WPq!{o9g3djR`BhFSPck;cCoMVJl
z1H8LK=4GQUQ^P1Dy+l1%?V%((0^XD30!Uf(ddksw)RJNrb7Qoe>zMXRSq$;_Qu)7(
zvi89XY#_}V;eyb5vzSPrfAm7$jEB9F)&gtKl2!?BIyety!K!-f+%~u{6Z{x0o=U<(
zM19zb&sLPvGAG&%*mwJ>KbZaLE&kG#;mvAxnMgJnLRc2##?DG<bNt=!bJWhW4!o$Q
zo9wpPcUPQ0KO^XiE)r8c-k>WW4tI+^@d&62af+C@qPJ`o0?Gl;5TT6TlsRelzixa2
zXbrsKZ+h^LhldnDJvcUrIjO5_gJWp(=8MsgdH8EefN|wKTpY5g$sQb1;L0<*U$>m?
z{QxZn&l0!e?->oA7cL(RhXid0)lExXDOi0OiF9ZlL%Hvlv{e_33Hyb-n@(c^widV?
zmBsECXTRUj9I4T4=Cg|^Ts+ZM3s6-VJXA!*+wJ{}Xlb^L-0t5Xqae7TS@rvcrdK>7
zJo-ZQROc#bn{|{Ctqsgbc5l*yipObnH3eC2p*v{oq=3RLW9CappY^p>DGqf3Ruz0-
z@@i+)m&gZs%P6_CXD_AQ{i^z{u#eMVv>Wig<mT)F5DpS&4bJVgPHJ2uxsuds8wI_h
z<WVyldiqn;Xk;@uzUSX}wu+QOvFa~*Qt^$Z2`=s3=km&+k*?}>fUU~hR!~w~HzF?-
zrYKSD+z_YcIKtuBPT_TUd`oe2lX+j5z6AUmUxU{giYyV4IHS9hy5e&O_ooK&R^G?E
zt5F-k5le&-dIdyhTkf^db6QXW?3Ou(k8qcMyBWK~zN5ls2z&$@PU{XdTl^ZE7trj`
zPwtJb0)H3ttttsSo?R%z&DiwFM-d(#jiTY~COgoJ!>Z{fn)MD$GPu34L|&aYdyTn#
z!nE5@KG>FVc+>;{dW)ku(B$jgw7;r%R<N+N;$}JNJsw4T9bm0OsV09r?l*A33ylf$
zZ}eYQMt+Sswz54|1@jxux-?CoB0>?{4}dU<6OdfB=2w_^{s5*Oy^hCZfcx9{j%+9w
zf#%~=@Fwy*$^!eCe-y*9aqaH?zw|=WZr~Qg9kJ{I$P2m7$-Zk&y?vWKHhNQ@;UzI!
z=$hS#rjYa>6gK}&!P{|67Pwz{!cevsgVqL4xxt&aqdHk?*TC`9<vjYkPZ)fTjhlZ{
zDtQPF5{?C>2?BzSiLX-yvs!@%+bW)2PDKhgp9dS3lRA5wCQ%Uu|3PT?Uxe&^Vn{mR
zXaND&8>oMxmEineN|3fJ$M;(T9q{ZHAc!;HqCvFt#0s$uYLY?#aB)!5e7t9rKHfuL
ze)^+b#gji8E*KSdEf%`-edEh6U`=Klb$_Wp1+<Ai4hX2E{`|geWlD8M1>8SdAa7ET
z8WhlUCDu&^MApf{mX10F90fM!x(lze-K(lfLOa2u`?8c15)L$|QPc&xQmea5l>Ui&
zwT;iy)VTs$c~Y-{U!Z;}$0MvgI1^`zqqQu4Mf5X1%_1+G=_DG_UtO-<U_QQ_pFgRg
zErnd_Uo5^wJiD&(Xoi0(#4$wrwq*JF{k(?`>)jiJ4qTHy&rWR*`5~5M>xAuS4|u1G
zlE(L*694AcJB!yFOaMBeZYB>3=gp_JIQZCE{eMvK2z@tE{_WYBI(d+;9?;`YY8WvQ
z<&*0lBH>Bz4gyv-CmryPp7~~P*HVpfKjDNxYewqr29mD<tRnI%6~y3i3HA-gvxBx?
z9xv&L?FzL(wU%rzxuw;2Icv8>*GpSH2hb&5Z052=*jT>Tw<uYdw6Qwp%3;B$%UPQ;
zUhmvS&06Pi>rifNG8MV?+;OLE;w+5WoRe99r`a)~aRD8>G64#+YD&*^*(~d;tkZY9
zh!ZNr_wo8mX(}R)4=9m-y~5GUS~})c5ImZ}=C?r;U}AlA^K<0)&f7*dh4}Y&)+3r!
z4dYopI<3h__uu-n5Jbj8MT4CZDC+4|))^Pb`q!D3V41M{K`-OQjO-ebT9II$-Il(c
zELNdObLH~ZT2qN@HeECN+?z7~T+L6LJqVraY$H1_yr$vT#+q`MHffh{`8<EWWKXOA
z=AUP2o6*^{K?!QB-Xb9H8<W9r+vcWL$x%)MRu}D(T+iKid(^)#zLu4Ie35hi3&gDj
zcqzHY?gkn!0@`6;B^aC~^yt28aNZW#Ge$o@Ud^k2-^uPf2ce^LQU9FLV{6xoCn`%d
z-?vT1C+$O1=pd}vJ9*patC2G}Ul4L#zilyjQW-tS4fKclgtQJJt=uIBK*n{nM8c7s
zmgplnB^To=R$$eMpB5UrJUAR81)Noo+dDBB;;kl!L;R)_DK`iV3Z%Uf<H3wMRaKr?
zfsJ~qo$bP=Nw*#A<4hOc^iWD)0c*YhL5CKXvwcxd;`6C+nZk4-oLG5RusrEUUm(@x
zRm-uk$7mHPZ*P;W@k}6MwU#%mX1i-M#)tPLG|8iyTH6mwdinIAqEO=A{rb809Pp6#
z_uHIKxfId-Q@o+LyER$}6qmZatR>asuEKh80}<DQOn2?@RibEgIndz8J-pqZs@Vxh
zLg%&}Al~@gieDz@tf*LR_ZJ*;`X6&@?t2F~cUF;kWFj*8afBK=%gs1bvvg^NW`GOh
z6SbEP3m5g)D_8f`Y-vh@HX~Z6;`SSc`@R>y_PSyFq9UM;+A3eMMW?&S;MW28cko|`
zLW@teey*K$R6ajT%@<_qjw?Oz+Q9n1SA;#Y4wRlNFR-=zkqCkkg9f#mM<_F{st$;a
zuI{__^rfEPL$l=bY_=oxV=<EF72%0EQzOCdG#3TbMUSh&RH`bsyWZEGZ!^T6{A6*R
zew)H=741an$K*vompeDYx@<<CKC<xGuM7m8z&0v|;BDf`K_ToLcfanq1RN=$_;qHF
ziTPgg%|?kh3ybBM24_6^9e3ZD;!U7aL|izZ!Kc_oqk{eqTgI56Oe8T^m?;tCi+L^<
zJ_y_H_cmG9&%5IIwi~~V)W`}jBBFtOm%gbEHSfP{J-z6BhlSl_q2D8bEPz{<4u7w-
z+KMjszJ-Hp-mtuC!g^<Ilz?+co($~u()0I`UXs~I+bQ3dKj~z9NvDVF2k*%ibaeg*
zx#Wevh+=pafSez2fMIxcw(^set1Zih$fiy90ufsoOJ~exh$PoG(iu>W85`@e?u>(1
z{4(X;MymAs&`1bxQd)XmTu%zKcCl02VR_F&<Dsu#`FmMGn%6ZkkCXE4-H^V)o$IA%
zpL#wFcEIqL??*3130m2gs251TFX>?Qc||*^cFvQg{k9{^nGyKZ9#z6?Hi4xjiwMaX
zh;Z#~w*0pH(F=e2W%jFbNLz44*s$*}yi>lxmUbmy*Ww=cq958xQe;@ZlB}TJ;2=bW
z7X)1b2^Qdxmt0PU*I$dt__f(Vbf}cpesYfCC-JVSh+NL(q}%;yTeGyCFkivV%oJaY
z!SlsGl`?7es-Fi;3MqG`aJ}EgWE4U5`NaxyK@`wg^66`h^g9cB9UPbfoB>P3QMp4B
zPQc(gqV#w3S##!-(aqld_o2Qk1=I#=M{x(vKSO(Z=H3l{@w>I=dzF(3oIN%s%0Pf@
z6(K4ZVi4&SA@VeG6fs$YFfvH?CY5jdd|-vTk<*qZ<~6r$n=;_h>fMZw*`$-Bb6lHI
z{p}>;{cwdP<~yax>8(sT*q*t>RC{Y@)7Gbo+uox{fWC8D<+gWyo9+FiKnE7C#bHf^
zYLPVl3e`>k2hMDb|BgPyjMMM<>bfl4vwGK4NS!W(VnwQrcG;f{80MS>Vp5HQ*+~E-
z$Gy#8Jg0V`z<c)?!58I$WKa-s&8&$xCo>e3=C%12A8^z1ykX9r3gjiqhdXaai&stg
z?0VKRLsnFTDU1@MxAH4@(tV`&<Oz(JeBRM<>KNH*I^E%(>P6N1L7EjzAN%2V(i5qa
zQ!dt#v6K4kK^#LmqwVH;dYf8ne;HT*^M<FONoR?+OZ0ZL#YkE55dP#gm;FuHuf2}_
z+8lT;H8JH)25SB?;?4D3ABM0B_QH`OkyzkU2Mh$yECFl;Qnq{eO|z|uZ+126-fEWY
z!}Bx>iY<xqMZEUHWsc^YXU1@uJOk_HB0bl=li-P8!}X)~!OoqF0eE%UMiS}cw@34-
zvt0Am^;<Po0jq%msF{N3OQr(Z&aos(vvHhGD`EoLuydVT`7>^foX`6MFuVSvno6Md
z`}Z3gHv?`q2j$q^Z!P*nO6zl1l~kQ6E}puRtGGTp$UT5j(ViFzw6=|GA1rU*RyD3b
z6jMCDdy@`Yt~gyOD`C*-Sp62}yf$i7p%V?e(n9&HMVxYuQR9NaK8J5q0p_h|WJmRo
z+yi9BOmWoQh~s3+CU>^Kzu4$(u8v2ZvwT$<Z|+)>k!)P2Ve+TnnQ})QJKIN*BP~#l
zmB-w(E!o|l_Pur7JNI_Qe#fN0pL6{aN7j`(#%yV=J~mk^TNLl+&u|3A|KaPcqv8s_
zt-&OO03o=0aEIUy!7Vt!CAdrDP6$rp8az0`T^mSncWt~I_r{&C^Ly{jeBaEP`Gd8Z
zTX)@4XIItj>V5X9b4<-*ynBWf7Sa%hIS@@M+MU>OjTJT~;1?nfJ;TC}$$S(gFw^#p
z$n-QBAm2W!sn1<0z<-)JKbktW+;7%xLVOsR)om9hTNcS^?Fw;N7~pq~8};zt1jLb~
zU|GbnkNV370Kk<U1tu@cyxymQe4S#fsC5ahDIf}7muhkykw8Cx*^-#c<>#s^=N{vV
z^VKjX!_KoOUEK|^$1q>q#-MN7LtVJVO1(#%<+!14z{lHjV1E;PuTy4w%jFx7CHr<^
z8<HLKTk5E;28jpH&X+Ct>Rr@JjGOLmeKO6UR|kH`tWzlrSSNt*n2cvD6m-kcJ>O{n
ziBtfqObVL$(KCM|7fg}}{;@g#7UN5qeevpRw?hf7&EgMc7xS<tUmX*ZR-13X&^@Pa
zL$wT)F^F?`eW?lRAT1}=SmU+O4GHTeQ_XXEgdrDrf)BAQRefB0j0_=VUTEyA#1VF5
z>K{Apj4KQ)yMhA}+=bPrxFY@zsSh7quJKqOoLRhdT`}RL`5AxQqHX_4sebqz#tK2?
zBqTbh6`&O$=G;YXBR(#bUvF}kx5PSTu*YAp^Lyy<a3_()lIVE%huh?z$zfH2d*a{D
zmcIgIa6cog(8@^nV)2%~K<>fe{)tEmyU!-n1cLq8;V$CjW^o|-)7XIX(I9@Vaa${v
zIlRQ3*sn~WRxekvc`w2M{6ePA!qaCX!d=NamZ?hA;2Fpk8EW&QQ0M?XXl%2|Ao}$7
zFc(Y&W^%MF@OCcU3#rz(^jg7h;iH~?9~X53ydFObg}=8(kadV#$!C6_eM;n5<3^|M
zl1N;{Er!3s%~rMg3i8c$dd!O*&WoJ(Z5WOa(Y6ja$hFIqplVUC7k<8b-sSbt86=(Z
zDjy;@VpQ5~*?njZeyx1iX)T)*$dTP&p>i7dBIs;{3SfWv(`+cvu+J)x>ckLXf6t}x
z^c>R-8rtnj*tGDOipX{v+faeJ-*k4R`&y~HqJr#L2Cl^dtH+-94J(-+&F@fFKJEIL
ziHOuc*C`ftu^0=4{yfO=OQ^{0SKNIGld>X_8eAy;l-k0z<|p^ZxZgquMrFIY9Wm3G
z>mtP(db~Y7I3J;npNn|cHhN@?PxE6+Lk-O~^Br&xCeXKNxmc2CF&=^u2|M(1qibeG
zNBO1{O<rvKrAgAwDnd;{P8&ZkKW?3MHDmQ<epL+>l7Gy7!@6MzRejpyZUcaHQe{mF
zy46%zLgO8p5^RA1ZLe*VXvLXX>edw=x<3gj>QpeM0~nobfwg3x=Wd#~7k-lo6=-)2
z?m<-Q%J4e}s2PjZ-4~l$b_}^Cd0{Ib0>3Cd)32>S!KE1p17=fWTFtDwP;G%6**%2|
zz>9v#3O8_)n-KqXim^LxH5fOOj)$6r(8=|?y_*K**V{w#JF)1UVzoIm0jyX`yiCQ1
z42A+}7j`jAQC_BWx52yWV~SflTp8ZhltKoavfGdFgV2V#yUT@pm7a_ZD8D=mJe|ID
zv3#GdFlbD=4m|7j+86woBI+=6XwcXbA8l%m*bkDylJ)0>avqSNGghkMpr@nDTj7Eo
z?l3}S=ETAEjWjX3_Sk6A6S|~KN}3-7`7iDXPz)c(bV+YVSUeux@k!WAE>lQz&luN@
z`@Z$sSSuJ#tx(=^fIbm?8B<*=Ix;ii7Ed!t`DDM~fR{&jZ9o_@a#k!iRfiw<dVF&X
z(UobnSEZ<(b?vG>O&U)3<GWK#wU+k$tSdJVZAJL_!tcqms&!!qt&MF$P&Z9#*Bu({
zCbO3Esw&@Cr)AXXHc`=h^|hj7E=U?WGnx8bjK#@SF4H6md=8$St%Vt0Eilp~glHru
znfJNheWDn%dE+pc)Dru(pXy;AUOd8wPrv0zz^pj_V!DORED(G9)J)!&PhWBT$6RN~
z^#YAeo^aZ+g;4-@SKH~XYxxi@FWwjj*IKGI)&+JrZunAMix9?mU0yIQ$&He+H1pD{
zCYagvMC+fv1RQGRF0bv=0rqH#6G>E=xA{_N+C|x}GdjQYOKYiqd_)Bn11HT~_&UE*
z<_$LH*d}Eqtt*x!Hr6hTBLVZMJe<qeW26}$=AOPsV3>?cJL5faDEVS>dmdSELkhQD
zx1u{+-0qUgTHLO)f@X>`fg6HxU0?#4bd)!0?#mICt6ExlVhuvy{*04>V+3~{%2U(4
zW_*_V9qqO{bI2PW#&1+ell{+pO+39B8Byg$GWTfI+dWI7uVqrqK!6M-+-mMq=3+D6
z1<XtPHOsq7p_5ir<8;B}mT(+@mz6ndskn&*ikar7Uzv}N6RMAQd-zrS8Q<#3rdXQ`
z*d2lbKeo-iJeHWcD!pdOscV&L?sw(EUd=G<d3oN``g9z4ZrF*vN=&NY1}q4FF?U0~
zg6Dxvy7@^p!z)>@#5%6(KI-S||7|K-nzziEs$A+ji+0=&WNDl8z^XU|A5BF#qH(~l
zJ6pg|3-sAGzRbloLtFUKxHk`U25&_RTagvRv{mjt?{a4OffCB%Le=z^cM4+z`OSWb
zgn;^bG$(~wTQ{=dSygvBa<}Ahpj`y4EjQ9#`%Ds$Ysy%VZ}Q0qi6;{Jn9X`PLf0@X
z$%;fLr0KF=<Pnj*PgSXJ?&O$CFoFj`1R{mCEfzhz!#!adGNKiRTj%s8y-5Tj>5%g}
zDTFJ;!>~vsY?MunP7@~14^T?B3DNfU<88Zo*+l$B`uAlk6y}3zPwmiF)0#1GAA#QK
z9Y-}v2=2F-<rAiw73?7jQAC(w+uvDUZrc{aZQHkt@NG&h<Nzw==fDJjyElf<W{&&+
zy%<}_C%V77saV#+uyu@_FkBvWa7TuyUyadktCoY3V|?N|UwI(oA4iPThzh+OVF>?*
zqAf1yRJ7N{thR_GS7Z=EF^uO3OqQJ4g=8BX^a;thv8)jVwGVG6rHcNju8Lh2?6f15
zjmT4A2;1M0jK$PYGT~?wJRkZr`;lE>oI#6%tIkJKNV%n_yX|z0heKRn=dh^NcKkl%
zVAGICUPpQfZ_EDQ0<?C{ZWoTUBd}l*_>IL`=2;o4Q87eaIK{BriE$;VPN8VfJ};<_
zX#dsWx6~DnydHx}uycBvu}p2wwZkk`s0^!3x;DKf4FjW0FZj(Gvv6UAr-0pp0`Dn#
ziojhKs{E;=E9L!3xZ3lO==}&o>Q?WN#$Os?fc%dZ9C4I6>EGBN1i9t*I9f^Qzslh$
zUTbD1ZrwmA$<0+3#>24@d}y-|6wTCz1Mo1UM!Q#l8%(!{+(T5K)n^Z>KJRRg45Ii0
zR?iu~wm1%DaXGg*`eLo@z|7QGj1vMK$B6pg@3DfpuQ54^y?#9Atu6wM9Ok|rTKKkC
zCWK$PEu09gQvgj3m;6uT!c$M!Yba%ECD#j<;3x2qZG_I)zoYTpo{^ivj9mhap6h!~
zx)OA9x`V}4=<m0Fm9rxIJaV2R6}YFYYYP|qa2sjUA4PW-U~5*oc=F`G>he->$DMi^
z*C-1NLZMlxy71eMJzaTx8vpCW8+e)xhz{XozQ?R2;e1O-b!JVI{>`wqKv%%g5uJ3*
z{w@7~Nb-fpr{{kp`7!EtOv$QT_MVi6#|5mU*01=^w`3plq-Y(UoxLJJ4kwZEI=8$x
z;aq6z&gr?nQjmg(_dIB9=X64_{vU0P`eZCtdPbl%3zHh6FjT`c^j3(yo*ZYIphC>V
z*w-|l;uW@CA-b%<Gf@0TldFgt1^&}({C0>=^1vqJDNr%Hn@x(7sJ8)$G-!BT2+W#o
z*Zf~5hwx~-=DZl_C*VAJKDoQ)RO=p`C!eTbc#5Alk~yHPWY<+2mrBozZ}bpMYIBS2
z7}Q;EoXKes-ZFQYSBDd%TTyM#^AF5U8q0*cc#Zqk$8b)$L@Rl+xBgmBNXY598D0WZ
z{`tM}Iq1v}9$uv`JJ%0J+PT|s5XrwU<jNeE{zsFWOK-LgblJqYXqiUS4QL1f<pz=^
z1-&K;nod=I3wZZ4{&bW3=Nt2Xg#eTs%(5C?XQsga82L)L_&_OVncQN0?jQf3xQjDk
z+?>DFOzd>h@aCUaIdJOwKVHREFkB+RuIuuj|B#0sD2+~TUJ1k@B{)k4%E_7*i$2U8
zN?tKpUY?!6B`2+L`NBWR$t-Wbt`HwtWi|#J#ec4D5q(vlhl@@u5L1P7y`J0t;kTuw
z{9lTY{n29AshFf^xHyI3u_`cbf#6=AV3VpSTU<H4b6!#~FSk&G9~O{tv-AI_2AR3d
zz&Q5XirM<7IzjzUG^2Eq8fkw;8)I!g%4arR`ad$7mjpb#X-RVkMn&nON?R2vm`E~h
zyp=%u_bCr7Sub%$7*eTc3uh4x{v%@9cCaOZR%B<!&X0%J`q@eskqbn~t{f%s{qKU4
zt>$+aQC4Gcxk(&+?iskjgA1}+xWp{ahDOE*^o9iJ$6tOc?ymf;&pP)P@ZVlhx!@pG
zhZFw)+a$0$UU6&i_!kUfR<O<(N3gRxNr?2SBK<$j5Mz{-`23I1gkY6_zq~|an{oDF
zvR@QJ)WM(gE?(<$F7N4~e;t>6a=SS;2P(CTVkH<@hIc*TYFW@X^3DO-`XOk|0Di$Q
zj0>{LardAimVI!hG1N;(5)AIX`!I>tj0hPaOVK`j;Cic7_ju;^Ms;`I6`6=>6>uZ+
zu6?b<T0eR;Yzym^ba^1|&$-}tXM)aW9PS&#>&8x@Pvrt5gWlbW?0Bc)&g?c^dLJM4
zjU;o276V<GkBn>LqNJA_e$~dMNi$zn8&}p$eQ2<1r8o+N&HVm(?lpShRcJZZMdLoU
zOUoNuqQNB+$+OSDMZWkHGLQN+Au1nEAeL!&@|lZ=W2{7Ri*~Y>n2yalhk9!7u2PeF
z{?subd+MXaJaP^uF*v4}!)$wFZgL3exlta0Jt($1;a(VCk|iKX%7)=SN*VXA7#)LG
zdY@X@W@FHRAm`n}UR-NeRj`oTd`{^T`GQZHr-mQ}gXR)<w~PiU!xOps5<VLHp<#=R
z=hQRLS`~>IU^$W7dlBX^^P1$yOQLUy$Jjbhpi@R~Alc0@(GsZDzjjtIQTbbP-eS*8
z@@bw8WX`!WkLqcL-b0KE)^=1XT@C~LSkD*^h(7q4dvrTEa^rx{l$VX7&QRN<+1Bii
zF=J=v8|NdGlcQ@gl>Me&E-&H$V~oU?J69}Zf`;_)7!g4HP-@0g%zO#G9R7oB%;t0M
zK<tQ}B|zklkZkyFj$jPSMEwR)PRzJVhtCEY>-v)v3|D6XU*=*GKX2-c(JExJzaC_L
z{=R%obrutJ&N1~@_ET_w?{<1$4UL4R1a2HkIcu*8-UH5WSF|0<4%nCFI#Mr7fdBFC
zg2TWVDy#Pp_)`pVocEDRvXK?cVqC2Jf&BChS~*Upcn<GF*bTiQACk9D^rW`${=Cz2
z>&AwPayenR-_P@jssCa+LK<bZ(h-DmIY1ldptV^Px$J&YeA~l@-wv_eS*<nP!Zb_S
z;f>cC8k{q7zE3Hv6QH{mS5I-V2REi;e=ms7lH^gcuUKZmFT=Tc3sx@-HZPFniGbr>
zfdhuKYuD$3G>f_23=`vz=)Qv2q}NzY)dhZUh2|Tsv5Jp{{6d7Ulpc`n0<}fE3jw#t
zz<#BGTz|*J8+@V1cC)x{4f-q8>r&~L85Q$l)<%B6w42(lFU$`wO*gz9t;d2Hi+(Tf
z;}A$?*D0WvG>9~x^TNet#y=w4b90t;t^1X-t1FHKbU2*4mObQjcU-OQ4jSM}t0l{+
z6$b)GhLan43Hd7h3Fk$>WR}28P?xHN)_AsMEcC{Oc?g*Ge%7m31twibp0baaF3GJl
zmd)(2kO%;peAetMC#;(j5N>*^{X71$Yu(xRl*D;K9!Ba05A|OQj7Z{lD?r@0TIs@T
zUG7_rzE@8HKkif?$sXO>HIJAy<u=UJ{TTtKKE`}K*$z8pPwjsGCaa(U-U)fLCTDDi
zu~wnJ_=Fh}V!9l5Uy`frppw(1o2GPQy2i~0KZ4Mt+e;*6gI@h1a<1^gNAl%wi3TcK
z?BTn->#@<y{-jgjkzLQzpM^w?Gh!{-5eXQlu@GS<14-T>Nm`+Prf@R^JI1x3(0W66
zp6&e-xVC<bd)_0>x<%aV*V8M;%V63mL8yH28bOd{mVj-8*k;s?aT9wgx8YgHJMCHE
z7{?jUJG=AOrwy>;zQiliS}wg^%d5N+4ax?#cN%>@)G$uv>06P7pdB0SQ7}-s;Z)6z
zpu^hGT7P|kC9+ARcFE>fhPF2KlHdi?mXPP_JG_a9A2d^Hmc91;x;{dzII6X$r=sIh
z?JwMZq>ORFm*aZ`H>7^!D|6!6MOvxF{l+}8yR5~H@m>eJi;wxmhl#;m3#=k6BcF@9
z=$&=4Ovr6BZNEIA(~}<x3TfZgxQR7!{`!oq;JsPF85=$$bG#LB`$Ryl9wGMZ#`K<e
z&hhV-v*WF>PjU<QvrBDDPo=&VqSF@G9sZM7!&k+V@#yu~VX5TiZ~cyEY&HRf;G3YA
zMdvVLHB0oAS+pfxl78w$gZI8tLLYJvh<olfXMQt{2YY@%hvkPJdL_utJxdzwp{Kb$
z_j_R}A-`-nBkfY)vY$`RNP?_4&)x7&T@0YopH*N~D@UMy;2Yt1MG$<;2cz17VzTQ!
zKG}mx<A|<vL7$&Wq6ktnvDmu-rg}`_UI}O857Iqixa@k+3aGS~%{DGO#8VC(MkS2p
z6-B^$zfQm|(ORnkx4~)DP~fXi#{RyT93m};(hfJGph60f7VouK&{h2<2Dkddb-)Yj
z%npRS$73WVv}*=paAvTIBS7qo>ly%l&w)sLZNZ4yyL(I)ys+FhaM^zdSHY;{PKnte
zQr(iEh@^8i7}YO$TmKon7o6@U0ks1_-lvwm#hX6h?cIVT2wCMa8zLQKT+@-$he!$~
zABW&SodO9cz0ctev_un3CHh1VycX#L{<sPEQbWFjyIvYg@Oz$%GXyE88kYaZ>BR^t
z{iho4-dn#I0#?ldAbu58I&nCPU=z>)@3?!4GK?y9o!02>B{BOOpC|$cs6}jn7tsaW
zN|0sF01LfAKah~jZ;VS&r^|w5erT(kXZvO<jYPDQ-RSKTZ%>>kgwv>3oubsZNd(Aa
z*#|5%G@{S@JWx9lMGz#TXO&|yR8LMN8P$$(?+@?AfOiyui3l9a8YB4dfjB83(mDum
zPy*IZu-Shg`9%@Hh@B${g06Xt-YUbdUt^)es461i7-?<Vfg=1v;G;iu`T)m7lYJx!
z+={P@#dp_D%(EY83_`v))H3jZ4-=<Z8+wHo)_hpr6*C)dH-GLFjLOK^QcMektQkh%
z1d#^iS6T-dyl9Qy{JDWc{R_vYZ#*Q%px#Q_M^wTc6ydN-dWaKHJ8VS~5YbiP6aatr
ze9afbR4r`r{MLieS{E6-b>a@W?oPP?Sz)~a;369a*hY6_Rz!Wwcs^h%^fWh)Kw1{{
zXZhl>11vw~?;_tq;3uQr(`hn@^ueV#>6PIbIlG>lk<(tFpi#(ymj~Mcb{Yv3kNth=
zM}7!3mr=;>EuA1#8g&jvwdB(W#D#y(=#Tn0u<)ig1NeYGAbuHCy6!59fYGfV$Q^^n
zo>-}Ej$ExZ-s2f0Q_E-wht$)LmVML<EBc&=(=B)$@aP7LSU1XI`Uv29y2N8YZ&Vg@
z`+q-1z0wMVyb_}`0bdO8*<yZ($8O54LNSV7J&gR~(g!5$>IJ64-z;$0E_Dy0UIyzG
zBB2KN@VQOl6+=+l<rzs}6R5IL!yn!<Nrp}iU!OMn0lY?U7m!p+z|XT!>*Va}J*}H1
zUJ0DfrnN17O8osmXI!5cf<`1APh5>tT=q9{@W$Riexq4Oz4&bDyBVKYg2s$<iUDAV
zr{$<{q3Fx=`Cox!b&ajzposoW@4ag<b;bR+mRR40AWK`)1Y$kk7p?hVF8(lyF@q0o
zbq&Ga=7&bX_pcAHoGi#JQidd@j@5;`l)~7W21p_GN&&d9YdSp^RBOqdbYJ>Cv8i(0
zZXS<x<c=c`w2EJ$YU7+3Gen*gyV(=6|Lv?MUccLT>n+rwLx0EZMGA_XGQq;2;PS41
zyFOSL=cSTvx6$@}PdwLzR}88EF`r)h<Sn)mD52rd?Gftsibrv%`O-$YZtwnnOHDmE
za9To7u!~>7wz}l8#*g**f@MV&5)X>v6riEC9^G)Pzp6T|JW9TNU{P1pWA`TTdw3|H
zc5eu?5Z;iRUucxwAAs`f3}&LB7O@i)9+@N~|8C)XLO+D=9349i3EKAPB>^t6ozZv%
zMz8roXWA4xiQI0k2y(0&Vs|i>=umUVf}LWJz{yfg#MOM4Hw6(BurJSIWs$Orszdd?
zv=cml&240*RAEK99I*Ihs_|Y(eod|Y;eLT;KOXOO`s#Bh)LZ`OA`vtfMZ$VNy?0^e
zY)(3KS&*RskFg5-9%a@^SDuAxlVat&AD0uYO{}OcFLyqw^JA|L)z_#*aZ2dL)NPsN
zOHqIHkale;o1bc&mr+YC-ICl)vXl3|I%9}?mKw>CkZiXm#a(?47$_4VviS2{*Px%T
zgp@{WIB<CM1X)?-uX_LbVtH7`3xu`cXF8pFblj>H0;L|ZJ~%#gf?z2UEP6w{lrKQS
zYq1lnx5b!F2fD(-Lt1z*)f`|)5v0P^M#YIyYkgV>7pt$83`UVyCmUOM&%(92KFRb+
zJzcqf87<qIzv&$4iM8)*XN+2JNa2aQSW!zRKtwzLrOD<KC|)OAWBB4T%5ldH6l_uj
zkb7NM^SUwF-9d7rGy>W`g~ajs2(QXEFqmBsj<c-brikm6UB1MdY-UMKOZ!dh>6-&i
z8b<A{(#^KdoDpIP7vY7s0cEVPsOlSp56PpR{W}IcvCX#FoHa?k%!&Ggp<ldOKc?qg
ze4P3+vND*d%D-aPPix`482g!q0@c5DUqzp(2<@iZF*ndS43UpmJuijtBww!ucPJZ~
zr&A%xdWwzIN!Th8iJ&~oi#GR{s$D?(_a?_#e^b4Dy@ogRVgmf<?{kPP&Kb^-)rjd=
z^coQS@7(e4HkM(Eh2>9sCH0S6XlFjhU8MQ-ejIL3?A8WnPFk-c$JI7&KDHRds84UL
zV4aHScty4x8T)-bE{E&bF!erik>XLKm#ETih7y3d5LtZ=lF^i3myy|U`V=DF*V**{
zp(G-9*QZLGZ|^G#V>M9Jfv^mi&qvswcj%O>2#UUNrKgIWl0rWHG|N(Hm~Q!W{zqfq
zdm{qB8CqRVkClO{GYTK?a}VbMk-FXQcCVlgtM)#tT=xs}>s~^Eqd|QlD=Qr&#xjn)
zKg^z@dt5+!P8QQ2gLrGwVjA*1G?Q}-59kRQaI6DXybTThwC=kH|B>#5LYS=_N)y%g
zsT<6_^`zr<`gw*EhbFePi%e;s%V31LlGSR(&ZKxZ*HNNp&%{QB<J+3`ji(!;V@MzH
zVzXo&<1(+N=yT1W)2_5UE12x&pD|Mm7}8UzI~6yg!=5!0cqP>gu=!uK>aHJC-DDW#
zhV?dcQ>J<wxB6$&h-oRhy3|XzBQsf7i19;w$Yx7(?*asbCoahd7@Q0C*{{U5<O{_c
zHN$KUf!Lu>39vufc0PnuJEGc{+4d!gHA0kWry0Cme|;nbi6SY(=ubtgK8_RgE3HdC
zhW1=HC6#=oD-Mu(!aBw1ihWjl3tL5pA3fjPkQ{%c*q2lS4f5<nnq;e1^;Q4$OyoR6
zdF7L72~Qjeyty5xe0Vt6R89UH@`?y*%^tllKyCEsm>KB2X#db}q6OU2<|dgB_6SB9
zK>r=vx>(7yR2~n<3(yiLuQL}^&@WMq`+HB3w4V671{6%No{PNZ{Fe6K&(okLwn^fL
zVpGo6tj}CYT4ra!afgNuY0G!ySj9WW$NHz7mejE0YLG4W_`pR&^jZ8~O>)>#38R9H
zY^O@<`6lDY`Jmip2^oz8m{b=Nx6VPID{^4C<onSmK_{{7+Lh34;l+J9{_J^vtKkWN
z_*)3W5|PRzBDRVTQkvWNqp{187%k3HS_rF0j9*LP*;bC-Y5UeDey&@S=-LKeBWy)H
zjIX88b>~H$wwYqu1rbu){`b`Tw`RDU@P*9vv_;zDLERVZ3GR$y>=L}~C0so|ggg`!
z{e~hf1_`R12iUpd=Av`ELc6nk>&KZs37mh+^)3Zxw4O3e39_`g<OG%zl-JGsff31G
zMQbtDQy_dzusJb;aYFz#+kZG(6<pI%%xYqXDk`Bj91o-oCKfXy(I|h7^bo)_s_UJq
z|BM}G$zjo60F0vxkCYT`8WUGST!{KZ(fJcOCQq^3=#FG>gnc!0N$<)}Rm&yA541Aq
zv~bEGY0a7>L_f~D$5*sI<&=ECcOT<6ZEC8<ue86L;R0hpxj*i>ct7{}K5K`1$tSo6
zDBY^5C$QvV^F+?jj|a8`YVa#4&JdGpq$cAr-NxTS^wjZ1gon)*POFiLzSfpwx-{t^
zBaWN)e7bP!?OELNXU4rWu==uzHKbaqNyAtWTJ5`w4-P$IJ$^$wZb}^oM*2TN5ap)&
zJ%k+x)f<rc@SY=DPQvtS<~P)EZNsNewW`T<CP6Ny`=16;!}F7iGk$QEhuFPuzt!18
z9RQ&+`txEtl>}{}CU%vS&Q2CLoR)cu^8~&z?!Zcxo<RKfwoF);-M{xB=xD%e;Pbnd
zW777LVL;d7x~ei%JprqVN17cwrs}DtHklqubVdbiR)cs$X6N6TNXEbLS3KS4OVI|t
zv6}m7_vaUj!(j0nvoiASn?b|m_0<lG!fb)_UhA7M&q*8Y6?M%!7h})YYA<;yQh)Mv
z7<%L{@3PAo)(6a_CHMjSW!K4s_;Ju7%cF(mwQTQ8Xxk_Sq}JRktD!_<7$9S0kOnm#
z{F)0}xjnKUv12%lp85DWaAJ$kaZbstVTZCdr0Ffqr&BNrgMvhOL%$$J|2;;n95d~?
zkM%pRaJkR>F1Rdf=<Yt%ngchr)@ojrI!ViF-$*56e(W;F5{44*4d^^>#Xfa->iLb=
zq^64yn@$&r&hoF1LBF?aFKv42K_=A#7N1Cs?&=?(`pQ=m#2;=rBGgF=Y(I!;Td<K%
zzcHN=`_U7)g{g=V;1S`(dd(M0<BLmyzKsE(lKFBD5HlB}#p2);qUNhV9q)dQ#oJgH
zA>11SJ=%_SeD1uby!5K{yjQ#?=}eCI7HHe*F~D9Uf>sA08`kY7i2HTf>XdD{<B`@<
z5=)b_3X^43vaifV|MEl&nvhhzVg9&Sw@I$u4ElNu0B^$HGIZ@p1mHUKNeTt$Wk>)1
zjOy*5s(OT=8W*7wba$6=kp9l-1i7;y=jK=_>S2pEv=h(JYr9@<M+K7d0b3yZ*N@$D
z>%UgGHaJV%&wj;Mq>ocglk`XLYcW1=@Hee(Wbyhq#xzem6C9xcNv?iP{dB=*nA*7E
z;dGdwUAyH%R>O;y+_<O+@&$A8k)q`4j)Y7RSM3oh(&EG_C%W$G*`bElG!WJtChrn{
z((~>Gla~_4ar6}SZO@4&@}vxwhU@ontGXAxE1#n4!nJOQaU{#dp)n=4pmBSJ#{Jw>
z5G<5$@_y)@08i#)bV)7UD*Ne%2Az<o#SgdF(HW_cfQAyu)CD@6PTNC4Q43QR&U4Tl
zCx<hZ8j{+`+ubK}o8|Yr*0S#_uL`qnD?g3@(C~ZZ*>oSoS9LW?E+RbPN!o=R8Sepg
zex<o~8J){-DV(;n<V<sr5ZfGsoR><5I-2mE57j=?e-_HC57-pIcIao-{R1Az`65wb
zGFa7Hm*;B9M~q65y5ZiVrpeJFV-ZmMHsfi|{;{zc;~|=$gL37vmDR_nRJzosAN5jt
z#2r%2citcQ8NF1+ykJC~evPKefqmFfH_c%MpeLlzL_C4Gz?|h|ogbrg!r=15AwHED
zB^h7+h`)O_=3Q=`XEOVHBUJ;-vZVfA*wvAuod_erh}uI8MyKGqL-kfhA>oIr?`7mw
z3GwIg)L1qP@@7Zfyx7<Sehr;V$i1;P<U;jOESE*+ETkzu`i#V5Yo*pP^TqEbNj4?v
z*x0XvE|Pw)v<Z{g(d%V+FyS_p#>I52Nu}&&<dgo9UA&7pBQ)5nO&aIf^dbo7@w<vw
z+p2$+eU4e0SpEl2wlD!(m)CeiNknBeHcYorwwbh~_fe|T!aCj*RhyFG5f2_(^scO{
z)*3PSRiQ<l8<5~qm^!E$Of-sLJ6EEqle=^XgI_mc;?0f3INWKL?wVzW#`CZJfC*>l
z@C`OwGek+(S(?TG<}hY67JZD>l1FqgCi+}BM7xK4`+*<5e}y%Y&<e<vSIQU%G^&$r
zQRuD`y9?Nn@BNB?Q&|iDmiWO%RT!v0<i6?Cj>ql+BxiCPE|}73DdMQ_;ECChLOn!Y
zutljYXh{{g{}DYY2pcU|<H#B&L;}0vF|^Xne~rXOtJ28GztDpQ5kOR+46p4At`L+2
zTA6KKj0>3Fybnta)ZvM?v9Cw5z|5Du7v6k~Qd<bEq69I$%VcMG&v{pcN{m5D;l1jN
zT5g#kldyRcZHcR6alB)T$;%Z;gwNcXM;(M)u*v<Pz^z1LUHx_p%MQQ)JAeLH-TZjw
z`Q5!G7hnoTUH%=4t~}Gvku(2$0-OtNRZ7lU?Y>9p8Ou)!4gBD#8WHxIl`jaVh>6&I
zvk7TC><lqDRd-xykxA~X6)<vw)K#gWluu}lgOMB#pa|L->v%pzjnF&h8r%w44I{VR
zy9}?mAEsWBsnjtN$_ybXdK1!zA>GRXzk*#PM6K;hHxTeT6~<X+`mUxGmLx;pdoz$e
zr<;w@8LxjBCO=HJv390I=iUPECd%SA&o~?GqEy;gd>=U423K85dc9G|4WWNEqKXOD
zY^k9-2KE_Ea_}XOVY%*K{m?f0YP5Y@_toua2~_t?YX-Ij5>PDB;}Q3zjyG~>?A4+D
zK|6LLi9PaNznU<iQPRJWyLu4*b;TI>Br&{-?y82l444i7RAqxQT**(r051*Ht5AHD
zuQT)!hnVMZ?j&51khYHP2}s9B@?9@Juac(}clTaFA4`nEpEXO!yivjjcd_M{UG{BY
zV4kJ{jMlerGqblbbci87xQt&Y_NIT(Ox26>A;Ii8=i#hXjre_<r{T0HpG&%Rs+-^K
z%IE!HGBVL-nY4+@vwc_Q;h9}6Kjd6}fQY~2Tn~?Iq43rhYKr*l@wF0%VtIqxdBiyO
zLa-KoC=@GVMGF{-P+6?paJPa;UK6RL5i+5)?%U6$T%kR)`%WRuEPrfwe($`MN7T<z
z$@_LCBW~LjwJLOi)rSFOO^E^j=Z-N~e{*_92U@@B%3Xw1Cu4NGBB7Ez!P=kz|9}uW
zQ8~5kY6tIS#`#$*55>stya7h8{+06*AtQ#(?^uslqMn;fCQIQA3k`fRsEVpEy-&lF
zt)6G{Rs#bHdII{ZUm7agQdqpk^9t-@-Z{GL2Q2AKF(0TRw%og1Ro86)mWpYTK$f#T
z7jKs7lgQu@SMwNb7;S~`?To%!`^QAtZ9U`Pn`(+^?w#Xtcd{U{;UtE~`*-%u$>;Wm
zTfSCm@^G`(l8#<Um;hx5yzyl7^s~liyGH!rpV0P0G36}j(c^w-;TtSbey$Rx#UG<H
zm%M4gpPapT`=^se$<H|^@l{blc{sKqm(qq_fO%fLH}Q&Z%cOSb#8e2<wj$cF;#*sJ
zgy8kd5WB+SSd~gDUqxnDbUkA<&O6Sxc~^LNSV`r?vYqCCx2cP&KeO^!yXxFFol%xe
zi0_x@z-F37z(HvN`XsyM-14!o<XC3A8fcF8)q>)q#fI;r#U{T}!&KQdKR~t(aweq8
zJaqosKgxXXA(q7?a}mnEWt+}h|G~DoBvn_}`c3pLYR>(8k}@be>H;h+QoEvrgD#dg
z{#<sxZ`dN(aO7)oLf-yeFO1-vMDhd{{29%__}F!@HhUGj@elo{FclyMEN!~uLgZP!
zKlYl9t%s|t;TF{oCHx*)ge_P#-pP*qgiKkul@v)C!j3Z`Fc(WNE4h63L2;5=0R5e`
zLYmsNKI?^|pVcPO&9+a-2MzwK($8{vw{(EV&9fb)n5H-pZ?UXw1W>*`msKxO9UgUJ
zF#We`Saw(wEKf~(pLmWK{PWQuMUf$LViSj`hfZw#6%|&)%;Vb!i+AL8$0c_S^|U|{
zXT6DAT(Vjzu-Mg<%4KU%E>wy*7uwYqcXB2j?jh)WvexqzBoA?o-VpEC!qbn&%EL$b
z;YdPV2Nazf7HsP;%`VU^AFu}U#c)8pa1{0}BdOP<9zG>?|2i5Bk}^OcSQxk=r5FL#
zI8gOyju94^TL;*Vq-~BR)a4#iR?x~;f&_FFBB}2cgaUU$Kd7J^s{iCny(@O_Ywt9g
zq2saKi4W-ME$VNj&pge!byO;x>l<m*lDEx|=N(5KqB6+$#f!`WsLGsE$%N5yzu(~z
zwRgnFE79%sQ3$pJBiXCTTw>A_664kDL-frxAlJm&VCTv^Z2EPYlr|`y(|1Jel5Jpu
z6_qYyMqbr~L9$+qf0z+<Q-Mg8*yVN6+Zn+5n9^}U5P=(6wT{5X^{>RX27Z@l(lX?<
zHrXNoZ|csHF9o&N-<CDfW{z{YpnS&S0XgY`T|!1p{f*FqYp)|L4;*<rAqDbxW4Vq&
zhI<JCV7rF7V_t+;?HP+!lx07B*b2k&fcV5h{pl>Z6#Ow?VF4r)4xyR1P3ml<p`L?v
zmXQ}vcwnB{mHBTZiuT^G_}we~`}$)dYRlpal3Z*L+lNY*sS4*@I7rzNm^J%7@z@~k
z?*~R~#~U6I7k?Wp>%L?2F6uXqg4bcj4rW}@X31cpnf91A9W>ucol5ZKJdTQIny~xD
zo>{_sR*uvx+-b9Z;@s$BKz)(=0wGRs<|07ih>6m3ek02wREODyWT`6);MKC8m>Kv{
zVPoHk4`OP1B26zL(zFHUlyFmDG>p_r7wDS@YzlIAoq252c#6gH9z5Cef9+W)Ola8w
zWDS*~AWt_B`neVV3=ll}joKu=lVHB!-hI@{|7Ml?0wK_!-c)Si%-6tDZbj;L0xBTW
zw(OQ2ObKHR{|w2?B|8=Qd7D~L;|vrjUdlh@$EfqNsLDGd2J;v3p0V&$V7A8bvVJcW
z9;e<`K#z3~mYD;S69E!hz^b*rsx6Bma-_5__LTJX{v7ah`p};af0Y8yv~RuQd5CX1
z!uu!JvQi`1^vxtjw&8`zI|P6A_4`+;TyAr^6rG0N0NQ&jVv!t$ZY5&}dfnLu!Y2IJ
zQ*k(9tn}ua48qyGq*Jy|zB^={8ES+SSWYe|{`>6%{90dn2ZoY&14NbDRK(PRvYTd@
z>E8xzqNNB>zG3IjJ*N)to$Q?$^AYkhx(L#{oZ=<<*xLVOtcP}xbg)_Xnu%U&@l^^A
zmHi)~R;tUC8$dd<OPYSZbJkg}<alH+wKE0YxMzHwyrrs2i*w`$%y2;kv!Y$QDc0S$
zeMRSsIFdX9?Y#qSF3MorJk@O1I%i=UUB3|lN~E%ofajPal$qO)L8&X_U6E$@Yl>Y-
z($DAo?Yzj;01UFR$$)7kp$y4!dC6)4dbB`)K7yjS2@y6|wG$U@USZhpYn~E|O$`!6
zHtw{E1sifgo^`@8zZmtgW)F{Vo4r7yS<nbF%uaKsLC)_)Y{4(-L8UKzF_5Wh_gUlG
z`B<zuE7e=3X1js=@yZnA)Hwlxno()}#epO;=;nwjIkMG!OOx-q#I^dfNKC`G=v7Pn
z)Hu+}&nz%=>FBRkZPn6oHa-3*b*%c83{rwyd*OcW?kNYqKO-N%BBJ&27(H^=#`GR+
zjwY+06YlW_)1jluE(yH6X0r<UGdG&Ze;SF-rMY2StVl{ubu3WVYa(f_P}r3DS1>Zl
z%K+t7l}=m>5!m+L@h-mIK(SsWC?lCwBX&oBIA9_-DOJVl=x<`vJi~Q27c%|3mUpXn
zHGWp{H<ta)0JEwN6153p>ScLzYTV>})%0M&hfh~4W&YAOEr~bnw|YTutF$;{R44%Y
zSoED1`fPr-(A3%`o-{SPM2(9WZLc~D_e`fFT3p2$(-G2bR5Ezk$wdFQvmc(7Q5jB0
zJ(DiB**gdie@*Ua7Pe3*jpfGpT2(Z27QpnjDh|guPW3(rW!iH$&K6jwb%+xlF6LNN
z)zD;Vet^DOF!4Mhy>r4fLe^n;sW@ZPwx7vUh<k0R;nwnCo)IF8z9WB5vU3)yjNs|*
zmm$bnW0yG=I<78tDK(y+reVYN-tuF9AJ<v*v>dJ|(mRTVqEQhNdQGEw!G$w%{s|<2
zBA3tNx$@gK3oJI$5_HnlaQ~rf&aMXQpPXH&nxli$7qu5y2~h4z`eT%zb_RqB9_CoQ
zr{5;1?Du$p&bNe*++~p*^wNmFbWp3#Z<pxCE0gJrZli2RL{S2F(*Rin10N5QP25d<
z;}P=>{F5(i2qiEQeziyuE;QO~vk98QE>;jT^Q30*J(nVa_X1(v2td+3HNV#)71Et>
zfh%blQ^fNzWAW&%1I8xbUsK}gU!5hCVhim#MREZ+5=O#y4!?(LnwF-cI4TThbBY!x
z?NT9&K=B=e_EsjQEZ?uoIap0}RCTlGPuN6Po$XN~La3g;XCEPh7kQLJSr}pYU}{Ay
zZ-5QlD5M+5IwVIU%!ORU5~wLM(Q4NDjcZvItaN7dLDzl~TPVK<fBWdCot~<J7*W1J
zz>qqr^@w_JzAex(8xu?7@0Lt@Dy)|%%>9JoZ#Wb$^@^~F&et-ePamj$=!;QbPQp}=
zOH2N<WUw+xy0;~-VXH)D$<o?jMkKoUSU0NhA@ZUhS$1~KIW@mrRI_n;RyWGdsjMD%
zVGZ{hxwF}ky#luYIqDAe-&5G&f1>rcr*#AZW}LUPyGBj4R7ObtzeJ_i#x}QFKPEhM
z*vo3ZFtc6pe0N&`7_tj{eixD|S~~q!i-t`+k_zs36L-fi>;~FgRBt|3nfCZ9<GMJ4
zN*cSoS0_V??-Ih8uImFQtX4KMwZ29(JUp8tIvnUGm4ZoqrDCEzoLTJ>>D*Oo+eGYK
zj#92GhHB{{qqhf&n!e2AtpmkAN9LT$a{^9c`1Tljnr!ZIVfBO&GLG$-1{kUyY5sw`
zcjnJ~^dL8k{6d$@kND_lSBte&OtMwrh(sOI#ZTcJ)5ZgI3mMBssO9j$x2b=13TiZ0
z_3l=DCQS!XhiTPqyb(v*X)xf-OHWc`lPufaV&$TMRnn3qjE|@X#JG2tfEO*CF0Svh
z#%P2#Q9(;IZn;3_g5iHev|cD9IU|>lKaR0belm<1h{V@Ytx%4;d!c1)cQXnGBR*RP
zQK2-Y<C88OkMqfQ){yI0<sWF|2JzBr(~%Fl?t@d+z-7xF-{Eywy~PT$M`bg|5EoJ<
zAkz>zzlt^D-4*^B;pXUNMnQV_kzL2Vrt_!{`OSxbA=&EEZ=gX%PVX%G?h=#sT<qa1
zZbfBRs)>|h!F3f}8z<R-w^l<7VAq4Za%V)IvWrcE*nu&u9_FmOFcC#bo9Gyark)JP
zpxWF@-kYy8UZC39dD&^f!$si762_KWnv2|~hu3I`Xt+Z19_?m-yn~-c(;0gJNP0}i
z6&D-SH3RFy38orxGZwQ7Z7c2{E8QQ^koP0yvL;T<X3SUC<NUj1t5h0=*@uRH`RiXq
z40>i7y#>uCd^PNeXPkagNNi_6POt39xZavKLJOd97*b@6de1p?_EXA%;h1W(_V4+0
zKV$MqZGumsqqkWR&p7W((zVr5iZXD?<4+}efyBZ=2h@zshP3tUHeH~dx}<m^LP77@
zl(vID+|PVa0EG0i=AR!WXE=1x6k*3K;zmgO{$3PWs5+8w)e<DLP9c!gvSMQm;)iC&
z$$Yc%*5Ja?UAl5FE?Nk3_dq0#vugC8FZ{t}bLdmWU8(+hgvM99fwMOUi_B2S6`B%$
zJ6Lq#0P}WNM7tUnNwnrJ^GrNcCW#U8zI2e)S1O6N|EiM`fb)L$5$%fq`uNcF&4RyG
zwi;)B<#VCO!>XXaSasg7*Q;M*eMMo#ScEI$OWU2cR=1hi7<%|2NNNQX2I2XaEjOP+
z?%l3&`a6K1(bx9ZqzA5^qR?`Ee;?=c_cr?yqgGFrqshMWj(I|#j}C662i4a5r~^KY
z>z16P+|xk5g&I?hALhIp_{&{(YV*af|1a_OmJGfmFqlzPiu4OW1p2Kk+%E0ciA_XD
zSX&9@HF5I|pDGe_N8HE*iRX<7ZYRX>o;;!#AXM3a^EVP&jL3wxD4q@d_8Haoq>mmC
zsmCEkF0~>$S}ivCb!AH+$4O8_rqKJjo6q>7kZ&=Z=~yrDPK+XH%LJ+eYWf>7vcyE8
z-zvk0N^WVW^dCgxv5=NegQEEtpPu3cL~mL^6fT~*<~_T*vmO)X@a@Dl(cH8F7W}le
zD#$m}&Pe{BKgFrgi`D$$jnwFLJDCx|HlkXjUtC2X|NPKyTIEXjZ9mQ#T3L3uK0_zC
zQKzBBLYkqbycR7rAq3<XUyGiVPcK4a_;pN{H6)K(1HAP_D=rv!0}ea-{$4s{!*4Dn
zj|`3D*C{aYp*#5B9^V%3+NgbwDH=R&zRC5G^NVQ2#ObDw%oo4*gvK+xh3Ws^K&-hs
z>NexB8$1Z&ilXHLYP!`JPu1gUWB3V=k~sPRu{+Vh`^$FJa337*wpiQnk?fL_CPW11
z|A8dXUb`C~%dZ0kzrBvJBCWXkWI1#C9JB0qFS8L5e9Sx?;fdni1suV%hAg8=M^1D=
zo2Zoi+F!Sx{f=>|ZspeQ{Tq@~4#&s|j**jVEdS3=kus4OxHtcG=@t|4sqZQ}_&0f#
zVZu46cTK_D*3`+}bA}gph06zH!86Lq@htn;ynQJx0TIx$MDKjJjg~9A?SbRG@u2i4
z)OS4i5!o1C8Kue*UBNGF9a@g8k`l1+J9{0Wk9?&N;J7w^3UHm=1|WIC8+Sfldn+jp
zM1nd6TE<WBc7FBDd~D+pHk<tsh`oE$LP=P%-VVS2FwWx)kagI6;rr{g<5yCV-n$N&
ztFgbKz)X8jzV~>Ye#ZVYXXt5sm?mE#zAX!UIJBaESjEaws=LSUZ>c^5Y^|Dog;G?m
z)txWaVhhB!G9zi5M=$oJkN9xH*?(k4Qr@BsjP-u*#*p_BXbJi$LZv1|(SSXfn_SV_
z<TuaZNEb`4pt=6#=$5W4lLYvl09xQkx3+m7MtxEWiaX4VL(RQFo3;5`>eHFmE&dlU
z!MkpqtwiINJLlK4mh(Y+@<M6V5BFm14A@P%w?{lLtOxeeZi84XGXL$G@ae1_E8Aj{
z5?F7L&VtnyWc%%V7N|9ByYcyKUij6YL%Vglx9;eaDOmDD@BMH(xPw?y6LvE{*WZi<
zWAe#fkxc<QQCj;qjshldRS0JZ=`FIH-mvlj5Iwy+bp_sp@tthn?F6hhW;@wx>d=KM
zD$U%Uk$J>q-||x9i=HBN0jr5<PH_}RXkeQ|2(;RHnki53gf>a<l9$PYa@mXUq)!=c
z@!iB5B&xcHIU{e;jtJ3;`ScH?e`XTZ@_?BZx*6DXid!y%>XpDeGGmRPmku8WHJfz0
z&LI`3;+jwB&)cRqtfbW;B^a<qQ+We;7vk=;TD5@G^=!K&^A<QR3#=UL{4am*%XTxN
zBtL8x%K<OO3z$DID*JLC8_{2T$B!lHU!VaH2Cx)F)-g$_?Nl%QmJcW|?}}A9)@h!X
zz#pdhzUHiwv582T+?+UbI37=#8gi^%EtszypURH7>r<#H&vx(jILIa<trcz%eE33W
zaoEcA?4|Zv%@{X2;MRYB{Z=sQ@lw6d+~G@lW49}jHCxBG>!P2nN~JR5z8ND<G^mqn
z$}p?e!n(%6yCMFR>oAH~O072+?^a57yFne#5+`pRjNWtw7C9dP_u-*gAIZSL>>-}<
zy7s3^FVTR*<6(WlvuOV9Agip0_R9d{CW09Wc8tJ>huGb#%4XlS!vEwl4Al4X3EbSI
zcORbu9YeD2uxN)a`bh+2{41Q?WG3PA|Ip|Di<?mfHgnGmwZ5v{b?$;UYb><kwDw@4
zyF2yHzLG*57&39@8Jev8XW{Qn^2c&7K(2$^%4TM#{Xg}y%Hpy%yGq8L+y$}g2f{rj
zZbD8H&%^Ioyw_ll4qQ=P()Tu=@EibFnbrO1U#@d8+0SvK47NB)Bq>*c9x)23$8S0J
zlRfC-f(N4`(h`*=2!D9MbCH>s<+9otf0OM80%XX#t~|C`$-Gj*jC%~np#70FOWc`;
zQlVds7pZ)d{|>n{@?QI&8#f)sOZBq_4*wV$2Yi#E%t?DRk$L(<Ed2nli`wk#@3&tK
zsWDJQGOQLDSUoIYeQj^P0&3@aVjnMsHm_BIiV!B$g%HV#vibb)rlSP|?9RT_dm01(
z8_J93F@|USvFp{tWv@)G17)kX+2xK$mx1OoltL%`1p(h;x_y((=^-cLDbaQfejX)-
z8h2D3jO`2BBFlqyzW%cJ##w3uP928ciby#{9`6Megq-fri-^9;`+h3-#E9~CjXqpr
z`%iX5%q{}FQ~$A+y&KakP;l~Zv<~`}U#u)~O<6Z5MoWi<3^hEetIyeHk{u8|i;oK(
z76C`mzdM!+JqlkMiQJ#(ms6VEHgv5^3aMo;tJsax)pniSb8ILYFN*(TLnx=qL1xaw
z1@piWk^A2W?L`;DvouhjDALtlw+`;O&1-l0%H%=bBH11lXEz;l5~Xnsn5H=;w6$)g
z%W^yAOs78+Sk1!powV1cgRBG!-u@48b;nyD?a6U3v^b#|@FDt_5>hREdfCNWaI2r^
zxbD+_#%noSIgTtyu-Y>Dl0bw<))QzN<5G2u-s5;m=8@i#SSLS#x0ZBU2X(N@^8Ejt
z2mfrJp3(i^-oTn$6gK+ncm6XAbls}jYG+>3iKLB1a<BYfh_{!O7h05r{Ff~<Ru54Z
z<#8N6K*!NfJFD6MGkyLa^Gve_Gyz*~)rGPecqjcQho=7`2<~&T6Frj6#l6ScPITK0
zk@#*IiO@gL9(S_DWW2f_DlphR0o5KDObv#`>)L0F9@AAP{2u*t3#*4h(=QPCy!x-j
z%hISZsRs6*Nn;;lC{F(@XSYk{r2e0jpnvDeL82i}0z2aRug8|N)I0^L_YB<4O4hx0
z(sG{aon9K!>z_*`=UK^73ezP6L;k)Ob_KtEtbSR3xf>CE8c6cJ=ewVHxw#B{THo2<
zf4Sqxu)AKKab2&HS-Ff}6OraZ>9P^N-!(_I!g*&dN_<bG)QxwLiZ)wD6wWe5kRPNV
zN;8qK4|UIyD3;d1-#ge~4~6~^`~9Yl4bcK<^-aWz7)6xsJ@F5_DZNWoRnehfiXXSe
z<O!B8214y8)3{z=<VGO2KZAU*SZ=8FA;6fjqdqC!3@`2SwnDw;4<qWq`7COTN|8|8
zm?1w!JyqT!5vG#6pA3qw09HL9`TJpd@6Q=hh|TSk=Su2t1}vPNTCnYFRFfe=RE$eC
z<H+dr!--{&#dUL)3EQMYr}N2(WtYku3Dr0dH#zm#nx05^nKKTx)LDpL1HK4uvdXy^
zmb`iH-2{@YEwch`%iu#+OGx#ZaB*=cgI~K+;>gebRGa|n1qMC11mu8Cy_ogkF`q}*
zSOfdP5?Ch%J!t6e`I!+_M=_%V+gvErHmIJj3kRO7k;f_f05|z6!A+^fe=dGz;M>&V
z_ci1=BXy{l%>mo!I{FYPGBS?xBIbXm+@3|%Nu_WjlK0PQCa?bNkHToC>wx$)rivIO
z$DM!Y1~lTtc>_{Y5|jVHZ8c>?Ng2#e4Vrv0>od_w%DL~s_<iABYCSd)F0d#iuA8r*
z{$|3=mTA}<euJ!0k`bUoZ-ks}Sk^m>?g@!W&X!d5<%7jz8D>Sds~>L=vtVKL`&zk{
z3xk{(ApDd-4L9VXPXzbps44>a#jm5*hvrM!B&yWmI5G(qI_pJaiM>M;CnCsv^FEm2
z{}^ZJ6pB*)8+P_zE30%$K~@Ht$St8c8#={<)_p~=sQ=a0Re(j+HGdTZ0bQgKNy(*_
zW)~0;q@^1c5DDp6x&=fem8GPSmXvM~Q0eYa8l)Q*ssF|I)$jk|x6i}F?(d#+=ETgL
zxifR`5s)k)A&`Iw+4Mz3=If^Oy($XD?zjP1(ypS#G@7E~O3rX;qVXN%o1hXNlF_vC
zAMaB=k(e1lt#6bzKmieD8R(QsjyEcXv(?@+MYrA$e_fvNT|Vl7-Ol<TM>lfI##{=Y
z$HbRe21{sfuQx}T0qkJk_wFp~0`2CVrgAeNzQvTXu+z_c9-+FDAV)U8#4O_p8)$&l
zJ`()aP|ftghP}o%+_AjI$)QHB4;ZQ*eGo)SM@3(uazVW22l6*B&l{3_E0tTFYM6~c
zAu_xiob!|wD%S%X`@I}8{GESL2!5-2O#_xwlU1GTjEISf9b`Lx%U-kao7J9@eB+NT
zi_%lMVGv&S{5gqboMR1r;DE$Ycf{eu`=joaa7k6-oB=`K|3%v<Wr_+G!Z}k|xY)TT
z%uXUbhxZ2KJw{R(UBELm13g)|z-tX0g@SHQ`~DX}4b%ZK@Hg?*W`h<K*qU)ODk1>0
zGE$||*d?C3*6C$1&9{RChsAa{mD6adi3=ofNfy(ED4pwR@5nF*bjq8Vvy*2Qu`vg}
zXCUq3C+U@AI=?Mfm<dygF@3;5KvE7bK(kpD?3LgmHVLu-%Eo$?268ij)5#Id9a%sz
zX;r&RVZCI!k82dgn8Ch9$6y&Oa!Fr4bPV@Emq>Dw&X=&l?Q+6Ef}4R~ckWxsl!JI@
zD2H7^?^R=R07gfn%nQI~?l2ZG3fTI9ddIZ(?LPu*+;|qTM@m4cEXf`OX|`Y%QV5JY
z4SOE7nfk%cTF0f3wwlc~qenIh9wD8@<sid9Jdye?Q=Gz6Mmx1x2RtPosI5{lSRLc3
zH5)8fC}G(z{^*$QO`x9rz%7*@p`(oDfFx$OkkcAGHsMiR);WBDqbal-pir33pqtJr
z`{ZA~tx5ouW>{r8upM(W6UD+qM$!WPc4a8ngIiyhurf(i$;i&w2y|r}^QeD3$;M0U
zDJQd?4VDt>Q1k1qDYwonP0wOgq6ho7u5ie8m<x=`UIehP|5}Ngi@-@V)jEUN9fhW2
zieUN%a$|(=>}U5y<MhKjwUnj~^-a`n&@U?^zDX<jN$x?i04H=l0+@{(V79`_Kg{Mj
zcA)S|PkxQxT-FoTR{W7bHy@E@0?AkllX(m(DXQVMCC>xLmxuz22OuHi1{*};uDHt;
zYFduBNE|caI@cQ+YI1McqX$7SVZ_4E3uS;3;w$d0ZJ-jI8YkoD0$TFgserOE0F`9a
zC7QPfI@Z(wmfY5@#BdSEw_hO?u8+|U9_h5U>zOGy3L;A=i$Zrp$n8abYMY5j(?VWn
zWm?D&fKIRZrm-rq<mY@=9*jydlY#9_CY<#5inTt{nb)cKM^B@s9_h@^-({2cJ()`S
z;Y=5e#=JLMAHQVBVy@swp5a!<RjA_-p)I@}0jT`UYP<Ow0yZ$C8m;sR=kR|uq=ji7
zfy-K+fo_9vNt=uythTyNXX#RP;5xdJTshCqu285mZ^pVCk)QEvg$BJdVEsr0C`)ik
z=c3!OmwvS5AMMoo{AePlBIKjOMDrbdgQgs~?x&pGPwGp|L&foIT>(c)tojNA1x7gV
zo4`DAO;PU<g(9OgXJmJ2THr`aJVJtpgxAX=g($yUl5`p-&A6Cjd)`b(EWW^F94!14
zy&iDeVR6V$S-ld(W|xU(hOa(Ah{BeX>0q&=KYnY--d=tyIEXU%+Jp>c-6(@FEMJvh
zM&_~s^Xs%keJbP~93<Zv(s^SbszD<`Xqs&K)l4{Q08_G%(u0dWMK6fIs;2w1TF)6v
z14|#X`+fs)&^3ftk{8EXE_Fn&F@?VL4-E2~1oiyDly%(U^f$W`(6JFs_eeW+_nP?J
znyZ|OzLX&n*UgThTED>LA0?99McJ^DL!X^dz3o)D*w*$IWcRSfi7+bz4C;YDZaSO@
zr_r>WYNr_$vi!9Hpai}nqehkAA+w;+$UobsP@LWue}w>p<F`m8Py%rimp?<J)r&Gf
z2DI1|C&#2br5{F8Kufv6(QnpqLmi3#yO{-X%0!tzQZ1-?noeQZ#ujB%=@tHYlpUHu
zOt)*%O8#upASaP$!T^2Rxk;wd*}4_ZYvSAStB970zMyG);FQ7t(+x+X@5|1Nzh{EC
z%W*&-Hq@Mi<JJSF3^1o}C_SpIVAIO<H~qCf6F22LEL&NR-=0{u|K4?)PS)P)FfpzJ
zU7WZXIOO+OAms^y>1ed6QqOL<z-y9ot&T4U*tk45{OA|Ujbc38&dUD?aaF?5#YIim
z*sfX%tF>P;E9J4c8<8&QISX>eeDKW;M_a{<wTpAfSE!Z7)5@?^S%)(@6W|Oh$zGMs
zCfc94@{j52=Y~t-20hQiqO@AimY?ijP_tizopU=FHPP(+d@}e>h{(cM)*O{BnQ?JG
z+CM0~nExbs862zo<vOV(i#F>Mml?X4F*s#pwV!A!o{MbGN)Y2~)(Y`tj9Z+<@aa&>
z^VS~?u}pA?kfym89uzJbWtAU{(8`&i<p>MM=_g()nt!OH!Hm7v3o(8CO3979fYHbN
zeRteey|!!9)5By)$FOkHVkOIWe*r%acj4Hrk%-1rI;N-67+d_&##ps`W6{QU!e;|9
z-ik3}G@(hY=+`MS27aRxItwz=`ap+6<Ud19nUeAIPR9)*Pab-0e{N&l4E(|672LZG
z)+Z&f^(w=lk|`Y-44q8;<)Bg|>%m%7sc7`6%@Ho{?b8GNC)*KqFWs;h7-DyCy^t8_
z$X?x<F?G}m`0o9_(4|rIRpoon4SoZQ&6<~t&!(#T=BSq5C>|L#7I7c9`0KV$O${8Q
z-JZ*mXoT#)AxxdwN&$-^;<wvoL^RND`ZUsr4i>#So}5NL8gLS_wTX;<au*kB%`xKf
z{czU&9(>OGjA;9=hSTFG^NG`%RbT5;FCVQeo^(nfOql22`nn-7irFWWF8w4@{WIA@
z#+dh(xa$Z{SV-}jcrsst3l;vn|B2SA=fXEzaM07+Q-t~WWiHu@GjaB0DKF0MTC*tA
zdCeB#Pq${zG%>Q0y^<SQeph{#(HOS3QhQR*y`HMQVe7-9msb|ZV4>wff@>SbuO?l!
zI`pYhm~5AYOJAv~g<l|h>pT?1a7YOec<t9So#&5-yQ$~Iar5K_XbuAn#=$#vJ~A(P
zqS~q$ZaXhIz?jtS9DDS681*si)84Cd;^`lW4Ib4es1G%LlyCf@LOmr%U*?M~(4-Xh
zICjF8+j>zk9;dR)yWdj!A6;05)#gejXBITdVcMtE!$s7(>YIp;tgLM+-`V=C*|!+k
zxK^6q=ZANO&=Xd+d(2Lvpp&h$py{t0``<c~W_u5ADqgRCQMy_H0gGB2O`LGqcRPT2
zMDE_N`|@iXuR#_3x`oakNup4~6rTq%SBx=@yhSlZ%mrmL!ZaP1xNKY($U-*Rw}Ncv
z#T}n9S4_>_Pa1TASne!a2@LdzVL2Iu9Pg;BOonVe@tlv#7wvKVc?P;1;t97v+t#wa
zI+|^sR}lyqY148bUPdfbLhREM$h;6ceAgd12bSaqhzn9yM^f0zIJymF;+|Boc~V`p
zxVTW9CfZIOVkGy19Su~P3ACM3Fma|`U-@Vj)b88=>Vl6X=0hwI1ND|_4~o-oCW|ij
z_VcV_p7v$DxmVZ5M2&9s?A7z|PAp%lukMjhDs7Vz8Ed+`lKbQ<4NY;NJ6blhvfj4z
zN5QPQy?vH-k+*t9B!!x#TY6lX=rO-4p1zhPOd%nae`4qR;n?vg!BSS#!usYZ?t?R1
z#o3jM)C&<@>75b}o7!RLsxA?8(U}&9_L6L4d!{yItM7`UXIzHW1j$frQ2Lk)iO7LT
ze7oNGek`|j>cAWCxO}IJcjt)5V?U%C*OSEsWF~tVfFdQ{ndA*t*-Pb++NHxWl;hET
zgI8{^t*uYC2itgEj(@JaB&nTx;~ifnc+&;N18NB-U7<obHtR-W`qEl9pRQ-OIDpT$
zS6(u9d27rVTXnAt&c?Cs_j*sv`8KuWJ1aFFn<r`Qq_`dbtRJRSSJ`{#({imv)kR*r
z)1i(34g4X8nZcoC*B(@WLlJAXm#^xz&0&d|C*#LTlpr*;t=a5Gn!KBNtGi;EQYD%p
z$GeV=@l&d&Z!sbd$1a{?JftkM);Q)Ty`2_3b$m1$y^XbH(^{fdblm!p`PkIvrM^F8
z`dq{L>ukBf1lIt=<Xnw`*w-W7+Mbx;M+}qA2KFYn38r;y)^~ERMV8ODcm!&yvM?*(
z4Ht_3)O5go=2d!lGdaS~rj20SExBrG+>}nIRf{j#7t>!30z3o-39L^UP+Sf2>4Cwv
zUxk3$m)j0cUvkS%QocMOX>EF0y`%R7XB<KPV?wLqd?)PM<95H#MA$w>)PByA284H1
z3Boy%(`FF(dsQ4dAK)Ph`jd1=$$jrx6_ry7#ji&gKwkgaVrs6fe&>d*lQi`K4p04T
zwqtLV*n7RQthpK!PA1J@>QOQKf*VIUsAyMTT-fAXUfP5HgD<o{)67IA`{!?M9$;vi
z<?VHA#u5AAd;#7uk`mC!9CwQuU(Y}&4Z@E&n;_NSPkS?aPxD8V@V!^TqaV-sUfFG@
z%#PR?<*c{=X{?P?XdXLhAojGKGwLkDC}(LTt)#o^{0pu7yTDe?{JF;~rzdvViBqcL
z`t0cH6vrj)WXYj8E(^CbS4qirrzqXBhPjtL5))18RN-(ziY)zYG0%{qt%mR0+~mf^
zR{Qf(4kx+^i4sI#jJV`^_K{08*2bRYz$xC_&A50AVYMEf{n|3xjf(<4Q|%2Of?K`_
z+vH~8vJV*bovj4mc&_Je;(TnFH#>6%UKWyl++W`*b`maI+sedycgOI)xe>8_rL1|@
zr*v>{&cx6hRY(s7`-+e&i`qFapY+15uSvB*4r+rD1T!jA)%sO)3Wpebysh|0-<gCo
zQ2MX6R`l87z4HVYKk6aI>5-NF)(8^R^TqpNU#=^a#oE`jWYXP6DCSN#vTO@JtZK#4
zx3%3Y9`F~0%Wl%8jP~lGx1?|Ku)?;)6yo?ys-w!h)MjLF`Snno-|t|%&|$7zP+)dp
zZgUT>m8L7KCa8~)W%Wq63xV4SS=IGxSDkML`Dkn|P+$y?>TTj&<a<Wr=K(b7lhioR
zHWq7f8VCJ7;7q^h4ZwgC8#*Y=MD5mN`4&NZlH^W{VQxWkG|~btsO4zgvvMVyFG))A
zPb0n9-?sN0H1oQo@rwni+tMk3nz--%r~y}gK5$VyO+RW%)8W95-9Q)s<7A1}dNT;j
z7kXX8O!vP8J;B8zzyL1^YE=8MG`%~gAu;<IypQ`}f^Sv_@hUP3734fuP`@15)w9$d
z0p4??lX+V=ajfCRzPXvR=5X3y*f|j8@)?cU;P|e%4~@fY8?x!_))2V@C5g5Y$Jb`H
z86qn&ad*%VEqkMXdPAZey8i}OWw_#Xeir*p84%_nwr?KkE3qEl{!iB0zDuF&k0%N_
z!-56}I^XDegl5sdpGj!{K3DZXQ}m%l;*=$;h^r1cgz0Ugo`rYwg1<R$7fl6oKnrlY
zYq*e7c}|+c;<rhu8f|=|XGe?N{#~+COVIfPBM7)p>m8TDH?{k9e3bN4Qw20m)J?6S
z`1^P1tf|m&yPGLC%Lf^&LvShs6ydbf+b+KM9{Gx3)+!y#5?SLh=T1mRZ55`*+c#;2
zjC{};(l1RaS?t^aOryF}{3^!fX}sy`hYxW^LvgR8+0^&Fm6+Zf>07s3!s1sk3QLB#
z$e*Kkh|g5T$Eg=YKm&beCmLqZ4WgLhu*<><5)Yg0C!<j~^4>TuWzofDanB|^hskcv
z<~MO~mLneRwv5%S3!->G@i#7}p7`APd2!2M|L54x$?0c(D_d0e9Zln3wqmK^x2p47
zq<G$UEOE~Hs>&T&x~yxVnsY<lpItY^kgnr8o;mLiKir2us=QP18ok}?nb68{H>vUg
z?}Lchbv}ZvbKdO>2ax9(6=G)eni1&?yG}aByYq(@_G9@NuJ7GnNLX_6?7R5B%6eFX
z;8=$EoRBqORFbl$iMiThFW>K2@H>3;m}jKiuqhEM_K}qt)#p#Vw~Z|yzV_cm^M9Rh
zA2r(YRKA0q))F{6hMww%Nu#G7o9?C8QOa$9fGQ<{>jJs@Jd>>J7V*@X#^j@TL~k4^
zH`9}2c>9W6`L|`ND(95G`p{t4Bj}u^G2^pZgOsXd!>;?`I-SWC!Ni&J9~TiDV7sC2
zy`1*yc}C%)dxR;g9`>H@v(=Ar)@jq6Y^`y0{O9p2VhW_NyU+@U9^_UX-Hg3}BAr7l
zNeFM=Y7aJm4+i0Q>)WF09^-DA5?BXbl=q?(8+$*V`UGyIFBZ~!`-a|DeB9)Cn}r$A
ze$)!9m$+rrDd?Pp%4uwh^po{%E|$|SqVPO2i|SxH{O>z9iDBK)aSaIaGd@}J&Uf&j
zt93b(!&Bya!}oA@L9fM6$b-Z~(N@>TJKks~p}g}uU7Mqy1THeKqn_|hEe2rv$8Rnu
zynGK1FZ)=1uP?QE*jQ=lKJLULpMgHAz`3VAF^qMIIF(sRvTRf7>r7^~hA}Fp+}cKi
z3Q(a_3g>WHFLo_G>PUiV+;A>!{8mh5=qdBYb_iSaTKbBdAp~zxDVVLdT7Z3A0Uxu2
zmy#AcF-^-mfWn9ny9;ucCoxNhqClCIBpqW&kt|35M&2F5Ks(=9G4i~d!Wu1f-PXtl
z#Rubfcf6~EA65eyKC>Tjr{%&BHaY>Uv%Z1FFVaI(!KbUr32CfP;g6@43l~VW@@~)b
zI$l&!^EPhhNex)`aIms(>N|WDwW*T8Qp=Y+)z^r`Pj^nk`eKT4XCWc|Ez!J<9fgpH
zqLG&DXN{$f7|Pg%;yJ_H^7qC2-a)H>STV?{E(Zwqkgs9r&Jb4)%RXE69R)o>kd}5q
z@VI<@sXCh0#jkY_H}U@jCAy17ovhw}+e5)AuF~{SfF$9kV2dQQ6wKJNSk;i%{#G{C
zscWVlmmP;inSJc3B@20#o#IzK&ruCn+YA3!x_rS_Vr^ghWIr$Z#Sy&OJ9|PviE}6S
zTyi@p-j`8@H1Lx|fp*1*_S_Yr;3t}sU)d^lnz(!)Q%+}X^brhLGb)dac6o3Hl<M8*
z&fwd4CEiM+Xw-39ANpY$)Mc)J!U3w?6B-ikIqFS??8y$Jdc8I=sCGTPYZPCi3#+>@
zN125(KCH_V3>fV)n(JIyprc_WSR{IZ$$ZFwG{r94W2<77p1*%$N}axW&)|zB(jv9V
zY!gS8{rzoYiJP1{Pwi+a%<sC2y%$zTV3~#8h8sfTpD!1SUdz0<P-AlYW8j!8T5IM#
z{a&H(qf8kb3o#;$gn?hMgCB4%$h~9~iXk>rf|rI;ax)L2Q{Q=zmoWR?$p9C|wHXvc
zU1GQIWrzP!V=(xq+9#}TsgRu@J8FC|zEVjpope@M^Sd#wyW!{z-pSGQ5`GVil<(TS
zU+EH_lJWNV_QAyw-JzxQCQ6xNhe_hJR=^L@l+nt5Bs@Sys&id%B!aLe+;#AX^|}Bu
zX+uD)0WZHSF#Pk=+Hlu8rRMTRIET&Z>q`5fbFL~)AxCtJ&*}}#GljH7xLO~FeZx_O
zw58spR+7|Id26>;G$2ngDIPJ~4&uGJ8PGtw{at9hCW|%`#!e~FtSK2E{&FB+?Ngq3
ze_SE$_HMG43izE>Z8)?F_WXE50FnQ$&0^H1EF)&;K(nnay2a-xIA~Fcb7wwxIfo|L
zT#7X}cNwRMjm#|mxpF&rM)N|_Qoq+@GGJFnN*Fze|HsIzG>jbebcJ20DH{hK;i1eh
z^Ql$LjUo<kZ2l9^NXc<mNZ?Q@tddimS^qYG-2bdE{K0#+a{caSz7cbCg)$FN*{z*P
z&$M!>J4}zAi2!H3Id&q0g{<%pqs(|Qp6rIGgtSAdm+b)H<^0E0<UYKI7HCVR=!(X4
zyqPXAmEh)A>G5_*toj+uBCeT6tss5IPB~l(L=^tP;<lzbJj&k2F?vYMV|cHp-0EMK
z{&?<kftp|ml~uV)&W)pI9ZhWe(1gNg_{YN<@(<pPAU_Isjx0%!lcQXZGwn(l_R`=T
zL2m*Mo6nLg#|0?BKu}=YSTe{1b+GuLJK%(OQHl4(>8(_;m6trx!2>ZAinJ2L@tzpQ
zGA*jaQS{82VEfB9LV2y3lA^NI`oH|{M?ZsukR2+^zBCIiY5__Heew{-lwm7_d@CE8
zYZI^F^J|e9Cx@w38K~MQ7tYds$nE+*_s6mMl0|E7p^4S#Q#7g0qn6h=FOtdi3c384
z#rLf63#qFmQH*;J-SW7b6Ifp7j%Mk-C}%ImMA=Zn5I<@w+YgM%u|qyxq?))Af-Ly=
zk2_6>+s<}leKge!x`MOM1nwE*uPh$8`7WF9FppZaQcf?LM5Bg}zH3ZykckbMIciiY
zFm~Xp7xm%@u^ve%IZFvArqcY!n^%!JY!pPN=@tt_vC3SBiJ^4lrP>bqhhjRnc6U<z
zTk}+Nc^lQppD0Js15VfNk5eR%#@RH17fWf~YCo`G^QdB?T5PHyJR)Q#Z!i~n5~A7O
z6bz0H#q<hC?y9Ij>*k@A7D+b)BY^-|26}S#m&mA2Wfch-i$6gt&!5)Wh>!TTWJS+9
z<Vjizy+S_nXlx=-@U&`3Nx7hkGo$5!-0U+*2~&dITnl<;bEM^X4f*B5qS&*$79As(
znn(3B7FM2(mD@%PMAecf0xyP^sHkvw6b<-^Gr)GmB-&A7W0lh8*hEC|&VSwbLUD4!
zz<TbKlYq@@NEwppOwy1;jt0h-j8J&gw+QioqWagVR^2ixKv&TJIE3fJBU)GP+=#Fu
zsVe+t7m7U{z!>;L=3+$ix`=bAS&^hioksDJ(K0%HutkxQnp7#SUTUw`yo<!{N3{JH
z>yCOV{0*dNlswK#b^Kwp?G1#&VN!(ma82-5r7WAuMGfqhS%evdvU7B^2~2{>WQ=B^
zMK1jh-07HTu@Q?#?;(x99lB9c{8=Krt`|xHcMUuTp%0F7d>;_`RWziR&$*|`(x|OD
z0x?!b^IPQO!U0qWk|?={JH<+wcT39GXVW~RT16hw#C!jgGV@N6IAe*FD9ed8Og>MO
z7#8rR*>25W+w$3BTtGzw`el-PjH}_bRJ#(E!K^WEQYEx@(Wn~vD$}}vBAi}wGN|G1
zo!vrdy}(S00^orf*!FcYoWO^4{PiyxW$sn%b+n2-GO}mW&8EGKcnB5?!(1=u0;*Vf
z&!3sQjronUTI)VJGo3|u*K$8IHK$+nS~(z*n<Q>4)1Ih!rw=@-Zn$!gkQohxNKuo7
zX)9F@aw6jdt}m8q?-cHcY9idRiB>#ZA9aVhrp~*juI-3I43ti=3Vr;Rq>6|~+%k%$
z=OSInPprAvjTFg`?fYYR;b#^JBkV74kB-^q{i8IVMpoJJA5I3Bz;+GkE(3{4;g=C(
z)SWhgH~TK;>_XvZ6?xoRcjYMs6^29V4zq`ri>G4>I&bSpci=}4L{;5Cv6gV#gqHJ+
zo~!+dUvJ-k%S#FM9K5_r)>O<G{*{v6Bs$}(w{H1wMRD0N2^a-^bVdgHZ!dk|RJ%|2
z%D8-M!dEs-jU9Kh5Q+H3eMgz13IYlR#r@8e6{N5VA0xq`+*~(rvG_m|!okQ{m{=e&
z*&=3eQ0Lb)Q|ionH<x&<dn3k-tfm{ky0H_hKWOYVJ5j%A%%685Uuirci@hwAvX+v1
zEOAt{ZTik7P}%`FC&M;y=az&^#_oiQgNo;#N5_N`+Qz2A=1u&^f7oeq*5aAVg}`Ek
z(|6#I9LI~@i5Cw4M3de~eQWed6Pt>{5?f|}In5(n3K5FAVLN%f^ENuu(&MpD^U@<r
z&YvFWT(Y)~jQ9-qiI|Fh92pWfZuBxh`EP8&$^A!>vd})VAay&=Yc}tToL*1PlRNbC
z_DqUi71Ax03YA}<#d*YZWw0vK%lr1O<H)#~SeTg?X2KC{{|3QD<0);{0$TXPfU9Ip
zFQU}4xp)Z!)n$U=1V6n;3L<ChRAO>Q1Ua9z@J2*wX1yBm0e|=c`0{^gvK{-MSyY;D
zCv@L?)xP@dv)j2UJ$-v=ZzW;q_!btm_3iO(qnC7)>+c$+rMwF7;V#v1%%8!7y~>Ej
zuQ$1B&2_{sKDKnpSO<B&c=f6CT_dtYkx|$a$wNF^;sjF>Zl71~y!%9A<>#j$PuX~!
zWfWSk!5oXw^Ebgh>|JIx$gJ1(swwU1otgEU4Lb7=@K)K)J8*`9l!|+Mnkt8b)}sUP
zpX}8!1;85`0EwcOC+uoK06L6o$(93d%!YViCoI$P91Mo%aE_3Do4^5)nD{Ix%~g4h
zEEQ#tPsyk>$;hx3nyj%(S}6m4iPXk!N{$%?Ch7}x%uZ_wE!j(eb?^EcUU-aKU7}l>
zRd{D!^YSxRa8ZEnE={akd%2Ytg1Tqd)s<^<Fl{Gmr<!!Ik0Qp6UcR_XH3hd*NItfO
zt4Ik*?dbgi#8_}DW3rT#o64<{K%J-BltOVE?Raj3D0rwjI&Np(+(%{^ikRc4-G*_R
zIU}_#T#!pLYmHHAP}aR%AksR{>2b=SD5BpV(&rqxyh3mfi(Tkw`3sfw5bK;y1KyTI
z{xt4$u;*NDBMY+is6)qjwXN;RDxQnf<V*uN(b_4jpif3nFYIMazm6SKU#vmjP2p<Z
zTqmdsh*9|UtIx1K?2z(|^+CW^K!^=2xX<P;NA7A<;%<ca_@tg+_b-Cu0SN-?ua%+Y
zKuq*T2o18JB?19G+>LF{PG<%~vNdF6t3Dyu0`ig-JD$6p5?~mt&IOKRHX4Dgn@3i0
z<J&MrPz3nyuI?xzYLyD*nNGimRxWYH&IwrK4U7RkfyQQ?l5&^|AEvOVIB*fGqj>^L
zIKw&$*r8UWfpB%N!W%`<&@><FLWk7nso`lwljhG;aC}NPi5;5(bven7h2V>3b*G7q
zOt))9l$|6f>tC7=Z&Uc2>eyTbzJc<YskC1KGg>NltF=jkD7OkzXSPlPt%<{oQJlzE
zz<N;OlM*&=cmaf>6r_Np8=*wVjIQU@WC#yQL)y;<iSN~-`yJQb*1tWz(I9aU*~4zf
zhL*be1U*O=h&M|d&@V<`Pt5?Q&HTxo@ZY=Xd1)i<5Dg!(?IuS8mC1GJ!QrdvDle_9
z(E~$DV2GS;qT$%6L1h&#15rR?|4H{r+`D<c*mZjS`4VHkYweIJ;z`Ok5l_U!Qep$M
zvK<>MxjP&;FYrx#CJ-8wIz8SgD}d%o5d8kb*12x6Y(DJ#@~;l~tD0xarm#)7AKMuj
z40o9~df!R`0bY7z`*6cG-N%afR2=i7?kAE1^m3Z8p@-IDA&s#xcRR^gA=z<e(;^6z
zxo2$YkYN>0ahkd9Mo9xMD#f9vn^gs3jcbk>z^<9z@T40)Gmo&L+aW@V*XS}dJ`OyH
z;*t1>+y1l)3!eK~j%CM?GzqXGJ>GBMLq<kvq7>vD3i>W5=+IMHxC3n<f9LaT!q?~0
zpnm!Z+fS?^+evduu3p3TkBHRpA`1!@>{KeAgXkN?5XfEZY4bA@BtBrCD~FF=l5aJ?
zR+nW^Qn3SPt3GxekBlw&A)JCSBUam+(6wYO>$xEzW^odbbI3+hSb>NoKoKMO1Of%B
zXiZ#Z(0I@r4j&+aO^(I|26X2i^J$x%vFxOd-2jN=mXly@WZ89DOh51dO1%FjHd0Hq
zs=gQQf0@G|?+e&M8FhzjvhmF>|4D?X>%=<#1dL`>pRO#SS$k201yq0}+>#I*E=U5*
zdS}3_za)wfkd@s;{5D*Wt@g1F2diRn?KS<(1-exv4z8wmTd9|NEbb4HCy%%PGWals
zwPJAipMi=(R}pixguH=_ztv}PeHdX2KfMbmm~^7mywK-ZbpM9psIW%RbG51Jle4G$
zbH%vlFX89BMCW~KsI%GQQgQuo9$+`ZG=1HZ+obN<PPi=0`XQG_M8$cz;Y<Z3`<OUt
zlv-AJ;jLUDiGFxg?=Fh*c6AFk8Lp(gh~XK><Y}ojgyZ}XEvkC!{AJWRFX#E`XVk*>
zskJz}S%Z09c&QnUknoUg0lfi^x;VQXp!<8gPBOQ7deZ1kNEAF-)$UY(>Wlz1i_hfS
zPFnP%4@mzMp~Z6?U)_e4!#s^i+-f%OnZ^_ICZnTi@04YLv%$lVmHeMgiE51*k*l$e
z8fQp_T&gaa137`b1{cQRX}~U027Y|F`~kt$sr6ZX>*HF+*7=B~E;+nH)6m}OGZQF$
z==#2eb$C>FvHz->2N6ze6mWr_u6RQBH#cvQTeFzU{#%7!-a~joze*@yA9zub`}=K2
zfeHP9FXcSFQj=-r>xKdp)|TcS>2P{*Q1)Q|Av0?sG;}%Lx_?3zq$o8hyG5rD{LA}T
zHFB}nUjgi-TENdElQvxbsRxZ>_r5pI#(2-aN>DWY-V;Hau?_R_%3muSOI#CPavGG@
z!g%BIx%DAWzW_Nn5DiFR0<P09@{ZC|4RA>VVg6saDsKX}8W;q(B+P*niXMYG%Wp&p
z4tg@GS{QXnoLldMM!dfRnHQJF{=b#WdA@`xT&9Knb9>@qVD#`(F#(iW_X@}2*Mh~}
z<e*t@xbhX@z>OP>5~hYqY((zHujyQ5W&oS@zxf}GwpGV!OB;#s%%5y^UC>fR^KV2B
zmO7t@H6DL#Col9cOS`;3`K7^4<f|oM*#uND8M2T+_b0~ed-_8R-9fSUo*#mXYM*g4
z6l8!Oj14V2;mViklcdrw23VM5*X4sNnU>44vZMalFWKDLfn2txNZ8`#&2x&qDOr=7
zChKx!20{ZFf7JKq7Ui<pn5YmznOx|l1!I-;<ux0i$Mf4yw-mJ&F3wh_ea>9yQeWU;
zo7fmTI3i38tuMdXKC{5)<EG}IzWl<?&BM*l^Bew+3JGCD)ZFY$s3A&*&rKY#A#&!%
z4%FDX*nB`W6>L3hh`6njjUzQDHbe<wYou!8NUaM|dMrr|Q8RIMq=v{?1J%U-{V%SE
zEiC+-f-Azr6q|#Zj}M#U&xe|imzSHD+LZba#>q?l>ngR)AB>Zm^S?13UOuk>RSwGW
z-{pXYxcINM$H~RX$pH-Z^7H>_aC359!8kcMpgezJoE%p%Za!X)EB)gDFs`dK0E{1Y
zr9EywK4A3!-4_6Z{oNiv5C31~pnr{nn-9wSHx1ZdbH&XE<Nu2WKQLKWX+Zg5(7!M!
z=T#a!FevQm-1ER-f6Xa?@m+0?7g(gLbIQxX!+&-D01WmQ#tZ$s94{31S9^S1JpTjZ
zyNdDg@c%CidUcKXcmXE5GA{te{TBx1{A<nmpj-gw{r8&lLHT(A`MUi4;Yk4FyNW?M
zd3dk(8Nm4eE(iUqe^5^7U;TqZVX&)w53D5T)p>@(xcRU48NjZtIVT4v|5aJI#IDK$
zCkNMGvISs&$rdLEANN)M12CSe{0CrAt}8rwiSb;;IJtSR$_yufUFAPcP9Bb{<GsZG
z8ZXdg=#}{c^b0@F6%5c<oLA==D96QpMHVjWa{a%$jtE0@D-#6vrA}5gcQ*laCp9)i
u#>Ui^8jxN<8$(oVZ5^qB8o+lz(K<L9A{>9IS%4xpu!`99^b(4a*#8G#BsbCk

literal 0
HcmV?d00001

diff --git a/examples/03-potentiometer/potentiometer.rb b/examples/03-potentiometer/potentiometer.rb
index 3db77b09..3a6c98d7 100644
--- a/examples/03-potentiometer/potentiometer.rb
+++ b/examples/03-potentiometer/potentiometer.rb
@@ -12,7 +12,7 @@
 # The center is the wiper, and should be connected to one of the board's analog
 # pins. On most boards these pins start with 'A' and can be given as strings.
 #
-# See potentiometer.png in this folder for a hook-up diagram.
+# See potentiometer.pdf in this folder for a hook-up diagram.
 # 
 potentiometer = Dino::Components::Potentiometer.new(pin: 'A0', board: board)
 
diff --git a/examples/04-pwm_led/pwm_led.fzz b/examples/04-pwm_led/pwm_led.fzz
new file mode 100644
index 0000000000000000000000000000000000000000..be5b874cea8da5ae9574e1d2550d9526efec93f8
GIT binary patch
literal 4458
zcmZ{oS2P@4*T>ZuEk+lE(W19t)M!yd)XeBL7@`w>45Ig_5u-(CwCG)8l;|Qx#2~up
zy*vq$&-31V@6EgRI&1Iqzt|W1cg|XS{S9;oiRkbEcOm6qZd^o|r@R5g!;5po$0NhT
z!}AJow{dfH5P=6DSS@(0w=y7)OaO{9%Gb6i#xzc<bbh%xhWui6l>cujFE?50p|=$C
zIoxL^KN%;pS&iC;Tixc<gbl@Isc0=S)kF;w5eK?HHaGvs<eJ+od94!vaiqfk-eeg@
zm!$Cbvhix};#%?O_MhFZL^HA8!p?8p=WmxciayTJvIFt@K;axi$nA3u0?!|pk2w9o
zm+mq{4pHh;ry6MSch_w_Cd+1xmWxFFUfpp@kHhQ+uYNg(%y)$X6z>-<9*?pL$No9M
z-mXvVEw7b$BEEgK&|4a__BjrfqYw^S+_f+{#9T{t=X9Qy|9Qg3GU9Ry+%=>65f~IO
zzy1lHBwJ!O)%mJtp=;Ce4FP<N^CL6&1ZZO+;AHj{_|zR%C>$n}k=;wWv?_zXX}f83
zTB6Xj@#tUq0scr@t`azZJ;yDeuqSms6c)T}Nz8nDQ_#{*&Zaml`fy*tRp!Fuc8~qK
z#^Xeh0$#uL@|azJ$BfIbN8fr|#99gIduwrFVT)V2fD3B`9J;liYw&u^zFnBolwR<7
zR&2zYvU)3?%4ppghUgcZe^`IiJ<YgmB_x9Ah@4yX+6YYmhfD<{F1F6<>*TXFja^1`
zZdjfzwaY5(^@G7avyCEYd&G<{mq)J>&bw-8Z8|a<Lxrk4XKZd7uK5r}{SQUXid^=>
z?w!h#TorZq+bU9IC-(6HtbRHAq)pMRPL0K`oI$M+_&m#7JwMCUCURo?7Adp!N4Vkz
zwYg(w5WlE@f~^d1x7|n3uRtF{yhruk*wpTajE46ZNlm`_v2C)e+ru;vR?lXGASpZo
z1waIUBTtdg`WK!}*3heOl<-6Gkj7qqbP4c9mlOYnV_0zKe*A^T;FLl~zd7RGUa6Q?
zVc5&;RN?Nco0YR3a0s~5W`qjq+5E2F|DGlw(?6z9|LhkQG%_c9%ouq^N)ovmq8Lc~
zkIr27(z?K&2*2jltK0H_Qq+5Rf+$Y0goXVA)bKZ4*O$NQZwv3o7o<?~6{Tvv0gzgs
zrxu@WGOdqYaRJCtZDu2*e~e0WFI6t1`g41K(Xw%+1e=!(TM6T)w=d8Zs1##Fsuzpl
zu{{=GgezAGDruBcF~#?A2_W$VupXRjsq4D&{~(~bJ=tQ#EWD&UvWzZ1arz*Kmt{d#
zVk<()&_3m?_Ns(hMat`4oF-R0QZiv^l4?i2H<<iLga55#;L(s2$tE7=T#m*SvTLWj
z*|*G_5iO{z??(GxD6`@`u{Q*feYh^(Qf3DY{-$P*-*BQGa9)|%(DrT&{I~kr0qI>>
zpu3<eWWsDS<<)iV?WV}U`XlZJ0BQpZXRUmR4f9!d1>sLpRRt4_&w;*+grC`0mgAlI
z6Yfg_yyjEQD&0y{1^<*Z-_B=WC*{aU!!N1dfYrdV+k;&2<?<c%KuOEStZ5o*^S=gW
zra@a^V`Qi)vTRTIZ>axzjCt~k;}Ta_sj;YYD8*E0UyC)%JJ8?)sZS`&9KD0}mjUC~
zdEhZW;`yPAi0(v_H|_<^&2uuzmnd;s$3dWM0eQhVJk9a=WNBf|mf~{+c<Qf+=gdbx
zr1ZH4GH6c$12JqCB`>t>u-`*y#3@}D2_1`fQmM`t??VCX^V`<(xi(UJ!`6Rpg;iPR
zeF1ji9jrY>QY%vMjpjc{=n6(|1F0?mjM2i{a#9)$w{?a$o>d$ku+<+tKEBz+&jjZC
zu7{p2dKIGPH?M(!Tybg=D1c~uYd=uBiz)NZ;;4hvRmh3m0dljQ50{1*#wER0=O|b0
zWG7DYiEZg2rx`G;?qZ*7B$qnmc@w_`54SDY^}`p#>FqmW3cbUlGb|IEw$0PJ@;34}
z0dd2^%T`XZE|I)7f{QiM0|y%gGuI$}WksUz^DR-s!=LdJ^iC<FSi(<lB3EU**vY4K
z21itWs%dNSUe20t2SkVYk#yu!gm4Csanep&je5#}R2BV)P06lF^A?qN#rp!Op`TA{
zZyx9ADJu1MBaPPgYVLc4xNtoymwKYim*fb95+(?<zXoO4H|;?=#OIwFZtHqx(pFIG
z>C?qKTFK9IB68Z8;EQbU%o6Ra1NvPlByKAt#JJ+vXZ*f853ne;Fz)$9Y;_OM*O6mK
zwLApBR`MB_@dkabUm%xoV+=ZGxN`oEVoSCSh*6z<I{h2uF6SF?Pjw<~s7Bs^JeFSF
zwB@yVh>Iw853T-+_6Uhcvp&Kyi;84wWiY&n-_s(ubO?5i^i7<%f6gxDq6bEl59qLB
z3^!=j9Lk6=;bnU)dd=T^#tK#>-Rk?Qac0sV^q2x>Nor_^^8N5!Th<!J4sDjg57B2P
zyx+EKewwsRF2X+6Yvgw{>De6o_6fMBT<d*U({CdGzH9ezmU6pJ4&m3|QC(+!;N|hi
zbKmE@6-k@tVr{(;7$lAE{WNynEu$PM-O?0l-D7Zwt}qeJl;7K%b<@lfK_D(7JFEX#
z_q3NZvDw_p`I;bm&Hc6~gOQN^sig;G5Y5h}0vpPrL-dh}Qf1ff?JU(!-S04nTIb+?
z!x&+RVpkHnYTTlgF*zwJzvBnn#>j$nlR<X*=cOS|RA5gmZ?0N_Tju`qgQKw+x6OGC
zZ~er-hyk=fLx~z(|CG=ldVlB(Qi=74hzP>%T8a_<t?RR+jHRiBr@-C|3Nhnc`Q-GT
zOt;EE7d5tuEJ0%xe3~m01~24)Oiu`Q%$yOfb9`}sVtS+qNsF8IEJ20jQsMZY+gE1A
zO;hd6xB+sAjxXPnH)u14`@A){N1V6%0_R2a)HKpiIW5xW87lyvdrZRb*>PN7d6hjC
zP`XcYpyAtAPn$QEdE5W%kj|A)_m6C8XAd(dVK+y3N#S4vV?wSo^O~va8OJr%E`^_b
zRf&HKeHT;!E$q8tMM#xlaWcRWWq%*q+phb&AMl~FeC=c9?(_!3+IoYSk88<pN|bKy
ze0OfB=o#fv!j@6W^5r92N|fLhc?_O+I(L)50~<ZHW}#TPT{EJ$F^_2_q9;!wX$@zE
z_KFp8Eyh(f<DN1=_=Uf+*fZ6_jL-%#iqBne=tkUA5U-Kh-L_ycjPQ7FKIL7zYta=u
z(sMbS-9}OFQE8t0u=jd7Z0F+~c;L6$38k@Kf1rfL51d(}jw!ji?jLu56lD=-)7R&b
zB+}!XTm8Q4Nv8JJkc@Yt%!E;dGP>!fq#!Y&&8?Iaf%rw6XAxfT34_N^#(^m^h#0M#
z2V5;*)NfyBh^7;&v3(*EtJ@CKzz#>aWw8kT*22PCr*GNagO_&CfN#_LxucS}e^FLZ
zN*7!W?F5&(WPHQh&|}%iLKDzVE-Lz_1azf4xL44&#6H%bV4^ud#vw20;#Dt@2^G}i
z*G{!MH8!z?BWm7?DZM~EyH@(ruj7UQE@c=Ir}-vHPB$uJqn7Zgn&bq%qy36xYEQ2u
z!ibW;D}DIbJ57`BgOEKt&4W|#uOcW_YZ^(L=pUsAxW}T6=J#c}oJ@PVkMf5jZl7b0
zH*b5E!=$sKXh*N#9LDrYLMv{SLO&k<y`1q>uf9leoDsn;@tz(Y4lVucYg7UqX0ZNF
z1TUJNwh13G<~(|8SJlzwf&8j(Q8V=srA<z0PfquoVn47wy<P~@x@A`6N>?&1XL^fu
z?w#P3=--W+_YfU#R~LIFZ0E7aqKoMP@Qb>lc5;Ecc}8*aQlIWq#{;va=t`xkYx;GP
zAtVH#&kk?YZ@3a`9ng*S0%6Vm{yxwhZhS#2T3~=Z(^r;ty(ATs{o*A4_IcxDse$;3
za4jhTn)C{o^KltEPpn8J^|z|quh&1JvQv)~-fsOx32C;bZSGw?Pz-Lm&haB^V1>!S
z@L+Q$A8A$JUGfFI0M4*&`ro&|m?BE?r>K;p{cfkLN6gTWIKHYJ=Uc3|x~l_7eT>N<
z?E@-<7MR$)>9-ujSCjSkXTne}1uZ5f>hd@q;>De&8TxHsM8+kxokF5m(3&M9yOs7J
z8Sj<hy}(9zuFR*J9&D;eGp;VM+DY9ebwP(7qDumYyo$~tv@{Y(jfNu@_Kg~F1WVQ!
zXJv;fVj`G2gQqVdcK{keT~-womKuS9{6sR%8icJ1+&B%)*17ybUsJy~^XaG-{=5wS
zvSTd1oJ}gkYnS|;C%vXG@MM=?8JNVwht|&{i1mKq@HTY7?wduyTYg*t<yP4)`a!W6
zb9E`ymaJ*~^xVzP|GqAMl~7$^#+rbglBQNy^y4u>Xg79IMVb8x&HX4B#dg&yF>M`M
z=A_MDQv2GrO(MhxX^<#Z)xII=@v+{_NFRH02*|MvZ1@h(n3CJO?lfU;m|6pxl}W~J
zM_>Y>jy5#rXQ$7iA4(PwY%Quub+3*Oi#{XFXjjNEPRXIKq{5d1JsoLlU+@tqRM@xN
zq)U)i?Bl#ptM=WHZzn+g3OA>TPJ0eX9q1V4H{{Y}l7-z(E$U98zLQ@LeL?#qumtfI
zM{dxK2G%>2!3qg9ny};>aXE|{Tn^P`QyR}|VZxKG)yw;fA-VD#6~(jVwRr%mH}5g7
zy+7SE)6$6{5u>T<D!KCPXq*oH1watW1!J;;8Ocr3AB1=2yG=*6q7_Mj89WlWqQFGe
zT{V7;{qOY;rk0L=A2{_isErr0L0M(V8BbSgl~h#)uwdt>(Q0EVnpE*w+_X+oA86N<
zEf}0|^J~7&(6=!Tb{JzPZ8`{P4Jro{SCek^THx97ZqiP1X!JvN*$51cu0V}siBo5!
zx|(+`HWrVTZr;dn+LtSl?~CUEOoDruwJAeA<8{dE@n+>_ZB~ce3AJco{1Vp0%sCnJ
zHRaJb14BhwoJ2m|yMYeZ5&&1Nwl;l=SguK40q=O;C%RNLdelSGgZ_+7Xc|gkVrAmu
zi~Y}wlFP^}mR3PuwC06hppx&oaJ)~4&>{;wj$v-#s*QlfeWM~_{dfOBDOtSh$P%!c
z)EWwRh*|6io<mNe3=R0%v*<HtN+X`g61O-`+H_{pE%4BkQSU)O5B_CKmXJGv<)};K
zNeaPP{fkc@0=xst+r<+qhN~)tvI9!;T{uZg@;MI%s$F@>a<O_LuVynN$+(V^@H1;s
zyQ<+)Lg#@mw8@#>(vm-_M7EM@(l?iVUEB)8$+UH_LFiBJ+4DQn)ki4rFi61*m2`73
zd}s;Bc$6A_Z3b^rqX0jB9EPu2f+z7_X%;eS)2Mm+LuM0mivHT+LcX??EWFc3xLrR?
zFiif+&|?D&x6q?b^Q3bY#?ooSuQ;q<@Or1=p2FTjnH5^Ppzp~_DqP;jze+Y}FgL?g
zR^375NkXCH1)k*z90b7z>6&usp1ZkwNC+&>OOh>sgK{z%n&&vLLnAL)XtM>J$4H&)
z=keaNJxQp4r)BYylhWQqtJYQxd-!jkIP`1INtl{!%cCf2gNJ1V>P+}BT3sgmtjlgR
z!RSlL3n)vReu&0GylBq%3V5(_nNmrqKWxlosdezaH0TPV9XSz$cL9Xz9dz48%^n&>
zL&mp|6=m_S=waRdZ^hQorO+bMrm*FmDhxmna>UrT8(#t7pcJTfu#$xz%T|jPUBEA9
zBW}*y&S4rd=uM*kd>b?!_R^KL=$oqXVB*9h^-oXv2nl!N)<Vdh0JpenR`D>idNvxC
z5AIfoS0rl2h?ga7MOn<Cma~{Ni-%?F1Jm~_7oM`h9OllP%ywP?_v%cRZ@~sSB!K^R
tKn!&73D^k#w>xrYkl^9pozmC;R{!sn80Zk+`&Yrg3z@sjLjCXU{{Ssqfx7?z

literal 0
HcmV?d00001

diff --git a/examples/04-pwm_led/pwm_led.pdf b/examples/04-pwm_led/pwm_led.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..2c81478a0a1681d4e3b4eab4e20cbb8059f74a10
GIT binary patch
literal 457670
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

literal 0
HcmV?d00001

diff --git a/examples/04-pwm_led/pwm_led.rb b/examples/04-pwm_led/pwm_led.rb
index 70792863..9a72e598 100644
--- a/examples/04-pwm_led/pwm_led.rb
+++ b/examples/04-pwm_led/pwm_led.rb
@@ -22,7 +22,7 @@
 # Note: If you have pins labeled "DAC", do not use them here. DACs generate steady
 # analog voltages, not waves, but we access both DACs and PWM with #analog_write.
 #
-# Set up LED on a PWM pin. See pwm_led.png in this folder for hook-up diagram.
+# Set up LED on a PWM pin. See pwm_led.pdf in this folder for hook-up diagram.
 #
 led = Dino::Components::Led.new(board: board, pin: 11)
 

From de8b22af1163b08aa06aca7139793cc450b6cfdc Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 26 Feb 2023 13:10:19 -0400
Subject: [PATCH 292/296] More consistent pin numbers for some examples

---
 README.md                         | 4 ++--
 examples/dht/dht.rb               | 2 +-
 examples/i2c/ds3231.rb            | 2 +-
 examples/ir_emitter/ir_emitter.rb | 2 +-
 examples/one_wire/ds18b20.rb      | 2 +-
 examples/register/shift_in.rb     | 2 +-
 examples/register/shift_out.rb    | 2 +-
 examples/register/shift_ssd.rb    | 2 +-
 examples/stepper/stepper.rb       | 2 +-
 9 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index d79fa7fd..ec6eb8e2 100644
--- a/README.md
+++ b/README.md
@@ -14,9 +14,9 @@ button.down do
 end
 ````
 
-Dino doesn't run Ruby on the microcontroller board either, like [mruby](https://github.com/mruby/mruby). The board runs a C++ firmware that exposes as much low-level I/O as possible, so we can use it in Ruby. It becomes a peripheral for your computer.
+Dino doesn't run Ruby on the microcontroller either, like [mruby-esp32](https://github.com/mruby-esp32/mruby-esp32). The board runs a C++ firmware that exposes as much low-level I/O as possible, so we can use it in Ruby. It becomes a peripheral for your computer.
 
-High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They "multitask" a single core microcontroller, with thread-safe state and callbacks for inputs, but no "task" priority. If you need more, integration is seamless. Simply connect another board and instantiate.
+High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They multitask a single core microcontroller, with thread-safe state and callbacks for inputs, but no "task" priority. If you need more I/O, integration is seamless. Connect another board and instantiate.
 
 Each physical component you connect to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between. See supported hardware [here](HARDWARE.md).
 
diff --git a/examples/dht/dht.rb b/examples/dht/dht.rb
index f2f07ed5..6366fbe2 100644
--- a/examples/dht/dht.rb
+++ b/examples/dht/dht.rb
@@ -5,7 +5,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-dht = Dino::Components::DHT.new(pin: 4, board: board)
+dht = Dino::Components::DHT.new(pin: 5, board: board)
 
 # The DHT class pre-processes raw data from the board. When it reaches callbacks
 # it's already hash of :temperature and :humidity keys, both with Float values.
diff --git a/examples/i2c/ds3231.rb b/examples/i2c/ds3231.rb
index 676486a1..45d3949c 100644
--- a/examples/i2c/ds3231.rb
+++ b/examples/i2c/ds3231.rb
@@ -18,7 +18,7 @@
 # On the ESP8266, 'D2' and 'D1' also map to SDA and SCL respectively.
 # This is for convenience when working with common development boards.
 #
-bus = Dino::Components::I2C::Bus.new(board: board, pin: 4)
+bus = Dino::Components::I2C::Bus.new(board: board, pin: 'A4')
 
 # The bus auto searches for devices on intiailization.
 puts "No I2C devices connected!" if bus.found_devices.empty?
diff --git a/examples/ir_emitter/ir_emitter.rb b/examples/ir_emitter/ir_emitter.rb
index 92344e27..f3678c7e 100644
--- a/examples/ir_emitter/ir_emitter.rb
+++ b/examples/ir_emitter/ir_emitter.rb
@@ -37,7 +37,7 @@
 # The IR emitter can be set up on most pins for most boards, but there might be conflicts
 # with other hardware or libraries. Try different pins if one doesn't work.
 #
-ir = Dino::Components::IREmitter.new(board: board, pin: 4)
+ir = Dino::Components::IREmitter.new(board: board, pin: 3)
 
 # NEC Raw-Data=0xF708FB04. LSBFIRST, so the binary for each hex digit below is backward.
 code =  [ 9000, 4500,                                 # Start bit
diff --git a/examples/one_wire/ds18b20.rb b/examples/one_wire/ds18b20.rb
index 49ce8f43..4ba58256 100644
--- a/examples/one_wire/ds18b20.rb
+++ b/examples/one_wire/ds18b20.rb
@@ -5,7 +5,7 @@
 require 'dino'
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-bus = Dino::Components::OneWire::Bus.new(pin:16, board: board)
+bus = Dino::Components::OneWire::Bus.new(pin:4, board: board)
 
 # The bus detects parasite power automatically when initialized.
 # It can tell that parasite power is in use, but not by WHICH devices.
diff --git a/examples/register/shift_in.rb b/examples/register/shift_in.rb
index b179e9d0..2c193d2b 100644
--- a/examples/register/shift_in.rb
+++ b/examples/register/shift_in.rb
@@ -15,7 +15,7 @@
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 
 shift_register = Dino::Components::Register::ShiftIn.new  board: board,
-                                                          pins: {latch: 10, data: 12, clock: 13},
+                                                          pins: {latch: 8, data: 11, clock: 12},
                                                           rising_clock: true
                                                           # bit_order: :msbfirst
                                                           # bytes: 1
diff --git a/examples/register/shift_out.rb b/examples/register/shift_out.rb
index 9439232b..f8b87587 100644
--- a/examples/register/shift_out.rb
+++ b/examples/register/shift_out.rb
@@ -10,7 +10,7 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                     pins:  {latch: 9, data: 11, clock: 13}
+                                                     pins:  {latch: 9, data: 11, clock: 12}
                                                      # bit_order: :msbfirst
                                                      # bytes: 1
                                                      # buffer_writes: true
diff --git a/examples/register/shift_ssd.rb b/examples/register/shift_ssd.rb
index 31a77fa6..689887b7 100644
--- a/examples/register/shift_ssd.rb
+++ b/examples/register/shift_ssd.rb
@@ -14,7 +14,7 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 shift_register = Dino::Components::Register::ShiftOut.new  board: board,
-                                                           pins: {data: 11, clock: 13, latch: 9}
+                                                           pins: {latch: 9, data: 11, clock: 12}
                                                            # bit_order: :msbfirst
                                                            # bytes: 1
                                                            # buffer_writes: true
diff --git a/examples/stepper/stepper.rb b/examples/stepper/stepper.rb
index 6e03e21b..916a8eb9 100644
--- a/examples/stepper/stepper.rb
+++ b/examples/stepper/stepper.rb
@@ -6,7 +6,7 @@
 
 board = Dino::Board.new(Dino::TxRx::Serial.new)
 stepper = Dino::Components::Stepper.new board: board,
-                                        pins: { slp: 6, enable: 7, direction: 8, step: 9, ms1: 10, ms2: 11 }
+                                        pins: { slp: 6, enable: 7, direction: 8, step: 10, ms1: 11, ms2: 12 }
                                         
 # Default is 8 microsteps. Set to 2 so we can move faster.
 stepper.microsteps = 2

From 3a3361ab2c1169e8b3ca6d80190ca274a314c8da Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 26 Feb 2023 13:26:07 -0400
Subject: [PATCH 293/296] Update readme and hardware.md

---
 HARDWARE.md | 22 +++++++++++++++-------
 README.md   |  6 +++++-
 2 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/HARDWARE.md b/HARDWARE.md
index 7da24340..4ae043e6 100644
--- a/HARDWARE.md
+++ b/HARDWARE.md
@@ -21,23 +21,31 @@
 
 |    Chip               | Status          | Version| Product          | Notes |
 | :--------             | :------:        | :----- | :--------------- |------ |
-| Wiznet W5100/5500     | :green_heart:   | 0.11.1 | Ethernet Shield  | Wired Ethernet for Uno/Mega pin-compatible boards
+| Wiznet W5100/5500     | :green_heart:   | 0.11.1 | Ethernet Shield  | Wired Ethernet for Uno/Mega pin-compatibles
 | HDG204 + AT32UC3      | :man_shrugging: | 0.12.0 | WiFi Shield      | WiFi for Uno. No hardware to test, but compiles
-| ATWINC1500            | :man_shrugging: | 0.12.0 | WiFi Shield 101  | As above, high memory use, Mega only
+| ATWINC1500            | :man_shrugging: | 0.12.0 | WiFi Shield 101  | Same as above, high memory use, Mega only
 
 ### Espressif Chips with Built-In WiFi
 
 |    Chip        | Status          | Version| Boards           | Notes |
 | :--------      | :------:        | :----- | :--------------- |------ |
 | ESP8266        | :yellow_heart:  | 0.12.0 | NodeMCU | SoftwareSerial and LCD don't work yet
-| ESP32          | :yellow_heart:  | 0.12.0 | DOIT ESP32 DevKit V1 | No LCD or SoftSerial. SPI input bug. See changelog
-| ESP32-S2       | :test_tube:     | 0.12.0 | LOLIN S2 Pico | Might work, not tested yet
-| ESP32-S3       | :test_tube:     | 0.12.0 | LOLIN S3 V1.0.0 | Might work, not tested yet
+| ESP32          | :yellow_heart:  | 0.12.0 | DOIT ESP32 DevKit V1 | No LCD or SoftSerial. SPI mode bug (see changelog).
+| ESP32-S2       | :test_tube:     | 0.12.0 | LOLIN S2 Pico | Should work, hardware limits will be wrong
+| ESP32-S3       | :test_tube:     | 0.12.0 | LOLIN S3 V1.0.0 | Should work, hardware limits will be wrong
 
 **Note:** There are too many boards using these chips to be comprehensive. Most should work. These are the exact ones used for testing, chosen based on popularity.
 
 **Note:** For these boards, "pin" numbers are always based on GPIO numbers defined by the CHIP, not the pin numbers labeled on the BOARD. They might coincide, but not always. Keep a mapping reference handy for your particular board.
 
+### Raspberry Pi Microcontrollers
+
+|    Chip        | Status          | Version| Boards           | Notes |
+| :--------      | :------:        | :----- | :--------------- |------ |
+| RP2040         | :heart:         | -      | Raspberry Pi Pico (W) |
+
+**Note:** There are many boards built around the RP2040. Check your board's GPIO pin map, and use GPIO numbers in dino.
+
 # Supported Components
 
 :green_heart: Full support :yellow_heart: Partial support :heart: Planned. No support yet
@@ -66,7 +74,7 @@
 | Hardware Serial  | :heart:        | Hardware  | -        | - | For boards with native USB and UARTs
 | Maxim OneWire    | :green_heart:  | Software  | 0.12.0   | `OneWire::Bus` | No overdrive support
 | Infrared Emitter | :green_heart:  | Software  | 0.12.0   | `IREmitter` | Library on Board
-| Infrared Receiver| :red_heart:    | Software  | -        | -           | Doable with existing library
+| Infrared Receiver| :heart:        | Software  | -        | -           | Doable with existing library
 
 ### Generic Components
 
@@ -96,7 +104,7 @@
 | :---------------     | :------:       | :--------           | :-----   | :---------------  |------ |
 | Servo                | :green_heart:  | PWM + Library       | 0.11.2   | `Servo`  | Maximum of 6 on ATmega168, 16 on ESP32 and 12 otherwise
 | L298N                | :heart:        | PWM Out             | -        | | 2ch DC motor driver
-| A3967                | :green_heart:  | Digital Out         | 0.12.0   | `Stepper`| 1ch microstepper (EasyDriver)å
+| A3967                | :green_heart:  | Digital Out         | 0.12.0   | `Stepper`| 1ch microstepper (EasyDriver)
 | PCA9685              | :heart:        | I2C                 | -        | -        | 16ch 12-bit PWM for servo, DC motor, or LED
 
 ### Displays
diff --git a/README.md b/README.md
index ec6eb8e2..1167a503 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,11 @@ Dino doesn't run Ruby on the microcontroller either, like [mruby-esp32](https://
 
 High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They multitask a single core microcontroller, with thread-safe state and callbacks for inputs, but no "task" priority. If you need more I/O, integration is seamless. Connect another board and instantiate.
 
-Each physical component you connect to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between. See supported hardware [here](HARDWARE.md).
+Each physical component you connect to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between.
+
+### Supported Hardware
+
+See a full list of supported mircocontroller platforms, interfaces, and components [here](HARDWARE.md).
 
 ## Getting Started
 #### 1) Install the Gem

From 00c4224e898b1de5ebd65e99cc8cf326e6eef95e Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 26 Feb 2023 14:51:06 -0400
Subject: [PATCH 294/296] Move dependency installation out of readme

---
 DEP_INSTALL_CLI.md | 47 ++++++++++++++++++++++++++
 DEP_INSTALL_IDE.md | 82 ++++++++++++++++++++++++++++++++++++++++++++++
 README.md          | 63 +++++------------------------------
 3 files changed, 138 insertions(+), 54 deletions(-)
 create mode 100644 DEP_INSTALL_CLI.md
 create mode 100644 DEP_INSTALL_IDE.md

diff --git a/DEP_INSTALL_CLI.md b/DEP_INSTALL_CLI.md
new file mode 100644
index 00000000..d9b5cd88
--- /dev/null
+++ b/DEP_INSTALL_CLI.md
@@ -0,0 +1,47 @@
+## Install Arduino Dependencies for Dino (CLI)
+
+Once `arduino-cli` is installed, you can copy and paste into your shell for easy installation.
+
+**Install Everything:**
+````shell
+arduino-cli config add board_manager.additional_urls https://arduino.esp8266.com/stable/package_esp8266com_index.json
+arduino-cli config add board_manager.additional_urls https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
+arduino-cli core update-index
+arduino-cli core install arduino:megaavr
+arduino-cli core install esp8266:esp8266
+arduino-cli core install esp32:esp32
+arduino-cli lib install Servo
+arduino-cli lib install LiquidCrystal
+arduino-cli lib install WiFi
+arduino-cli lib install IRremote@4.0.0
+arduino-cli core install esp8266:esp8266
+arduino-cli lib install IRremoteESP8266@2.8.4
+arduino-cli lib install ESP32Servo
+````
+
+**AVR-based Arduinos & Clones Only:**
+````shell
+arduino-cli core update-index
+arduino-cli core install arduino:megaavr
+arduino-cli lib install Servo
+arduino-cli lib install LiquidCrystal
+arduino-cli lib install WiFi
+arduino-cli lib install IRremote@4.0.0
+````
+
+**ESP8266 Only:**
+````shell
+arduino-cli config add board_manager.additional_urls https://arduino.esp8266.com/stable/package_esp8266com_index.json
+arduino-cli core update-index
+arduino-cli core install esp8266:esp8266
+arduino-cli lib install IRremoteESP8266@2.8.4
+````
+
+**ESP32 Only:**
+````shell
+arduino-cli config add board_manager.additional_urls https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
+arduino-cli core update-index
+arduino-cli core install esp32:esp32
+arduino-cli lib install ESP32Servo
+arduino-cli lib install IRremoteESP8266@2.8.4
+````
diff --git a/DEP_INSTALL_IDE.md b/DEP_INSTALL_IDE.md
new file mode 100644
index 00000000..75abcee6
--- /dev/null
+++ b/DEP_INSTALL_IDE.md
@@ -0,0 +1,82 @@
+### Install Arduino Dependencies for Dino (IDE)
+
+### Installing Cores
+
+Some microcontroller platforms require board manager cores that do not come with the IDE. To install a core:
+  * Open the Preferences window of the IDE, and find "Additional boards manager URLS:". Click the button next to it.
+  * In the editor that opens, paste the given URL on a new line at the end (if it doesn't already exist).
+  * Confirm and exit Preferences. Wait for the IDE to finish downloading indexes from the new URL.
+  * Click on Tools > Board > Board Manager.
+  * Search for the platform you are installing by name, and click Install, optionally selecting a version.
+   
+### Installing Libraries
+
+All platforms will require libraries to be installed. To install a library do the following:
+  * Click on Tools > Manage Libraries.
+  * Search for the library you are installing by name, and click Install, optionally selecting a version.
+
+### Platforms:
+
+**Install Everything:**
+  * Board Manager URLs:
+    ````shell
+    https://arduino.esp8266.com/stable/package_esp8266com_index.json
+    https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
+    ````
+  * Boards (latest version unless specified):
+    ````shell
+    Arduino megaAVR Boards
+    ESP8266 Boards
+    ESP32 Boards    
+    ````    
+  * Libraries (latest version unless specified):
+    ````shell
+    Servo                       by Michael Margolis, Arduino
+    Liquid Crystal              by Arduino, Adafruit
+    WiFi                        by Arduino
+    IRremote          @ v4.0.0  by shirriff, z3to, ArminJo
+    IRremoteESP82666  @ v2.8.4  by David Conran, Sebastien Warin
+    ESP32Servo                  by Kevin Harrington, John K. Bennett
+    ````
+
+**AVR-based Arduinos & Clones Only:**
+  * Boards (latest version unless specified):
+    ````shell
+    Arduino megaAVR Boards (only for Atmega4809 / Nano Every)
+    ````    
+  * Libraries (latest version unless specified):
+    ````shell
+    Servo                       by Michael Margolis, Arduino
+    Liquid Crystal              by Arduino, Adafruit
+    WiFi                        by Arduino
+    IRremote          @ v4.0.0  by shirriff, z3to, ArminJoß
+    ````
+
+**ESP8266 Only:**
+  * Board Manager URLs:
+    ````shell
+    https://arduino.esp8266.com/stable/package_esp8266com_index.json
+    ````
+  * Boards (latest version unless specified):
+    ````shell
+    ESP8266 Boards
+    ````    
+  * Libraries (latest version unless specified):
+    ````shell
+    IRremoteESP82666  @ v2.8.4  by David Conran, Sebastien Warin
+    ````
+
+**ESP32 Only:**
+  * Board Manager URLs:
+    ````shell
+    https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
+    ````
+  * Boards (latest version unless specified):
+    ````shell
+    ESP32 Boards    
+    ````    
+  * Libraries (latest version unless specified):
+    ````shell
+    IRremoteESP82666  @ v2.8.4  by David Conran, Sebastien Warin
+    ESP32Servo                  by Kevin Harrington, John K. Bennett
+    ````
diff --git a/README.md b/README.md
index 1167a503..07bcdb37 100644
--- a/README.md
+++ b/README.md
@@ -14,11 +14,11 @@ button.down do
 end
 ````
 
-Dino doesn't run Ruby on the microcontroller either, like [mruby-esp32](https://github.com/mruby-esp32/mruby-esp32). The board runs a C++ firmware that exposes as much low-level I/O as possible, so we can use it in Ruby. It becomes a peripheral for your computer.
+Dino doesn't run Ruby on the microcontroller (try [mruby-esp32](https://github.com/mruby-esp32/mruby-esp32) for that). It runs a C++ firmware that exposes as much low-level I/O as possible, so we can use it in Ruby. It becomes a peripheral for your computer.
 
-High-level abstraction in Ruby makes hardware classes easy to implement, with interfaces we expect. They multitask a single core microcontroller, with thread-safe state and callbacks for inputs, but no "task" priority. If you need more I/O, integration is seamless. Connect another board and instantiate.
+High-level abstraction in Ruby makes hardware classes easy to implement, with intuitive interfaces. They multitask a single core microcontroller, with thread-safe state, and callbacks for inputs, but no "task" priority. If you need more I/O, integration is seamless. Connect another board and instantiate it in Ruby.
 
-Each physical component you connect to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not all the stuff in between.
+Each physical component connected to your board(s) maps to a Ruby object you can use directly. You get to think about your hardware and appplication logic, not everything in between.
 
 ### Supported Hardware
 
@@ -30,7 +30,7 @@ See a full list of supported mircocontroller platforms, interfaces, and componen
 gem install dino
 ```
 
-Before using the microcontroller in Ruby, we need to flash it with the dino firmware (or "sketch" in Arduino slang). This is needed **only once** for each board, but future dino versions may need reflashing for firmware functions.
+Before using the microcontroller in Ruby, we need to flash it with the dino firmware (or "sketch" in Arduino lingo). This is needed **only once** for each board, but future dino versions may need reflashing for firmware functions.
 
 #### 2) Install the Arduino IDE OR CLI
 
@@ -43,55 +43,9 @@ brew install arduino-cli
 ````
 
 #### 3) Install Arduino Dependencies
-Dino uses Arduino "cores" which add microcontroller support, and a few libraries. Let's install them now.
-
-**IDE method for Arduino & Clones:**
-* Go to: Tools > Manage Libraries.
-* Find and install the following libraries, at the version numbers given:
-  * `Servo by Michael Margolis, Arduino` at latest version
-  * `Liquid Crystal by Arduino, Adafruit` at latest version
-  * `WiFi by Arduino` at latest version
-  * `IRremote by shirriff, z3to, ArminJo` at `version 4.0.0`
-
-**CLI method for Arduino & Clones:**
-````shell
-arduino-cli lib install Servo
-arduino-cli lib install LiquidCrystal
-arduino-cli lib install WiFi
-arduino-cli lib install IRremote@4.0.0
-````
-
-**IDE method for ESP8266:**
-* Go to Tools > Board > Board Manager.
-* Search for `ESP8266 Boards` and install the latest version.
-* Go to: Tools > Manage Libraries.
-* Find and install the following libraries, at the version numbers given:
-  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.8.4`
-
-**CLI method for ESP8266:**
-````shell
-arduino-cli config add board_manager.additional_urls https://arduino.esp8266.com/stable/package_esp8266com_index.json
-arduino-cli core update-index
-arduino-cli core install esp8266:esp8266
-arduino-cli lib install IRremoteESP8266@2.8.4
-````
-
-**IDE method for ESP32:**
-* Go to Tools > Board > Board Manager.
-* Search for `esp32` and install the latest version.
-* Go to: Tools > Manage Libraries.
-* Find and install the following libraries, at the version numbers given:
-  * `ESP32Servo by Kevin Harrington, John K. Bennett` at latest version
-  * `IRremoteESP82666 by David Conran, Sebastien Warin` at `version 2.8.4`
-
-**CLI method for ESP32:**
-````shell
-arduino-cli config add board_manager.additional_urls https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
-arduino-cli core update-index
-arduino-cli core install esp32
-arduino-cli lib install ESP32Servo
-arduino-cli lib install IRremoteESP8266@2.8.4
-````
+Dino uses Arduino cores, which add support for microcontrollers, and a few libraries. Install only the ones for your microcontroller, or install everything. They are no conflcits. Instructions for all supported microcontrollers are here:
+  * [Install Dependencies in IDE](DEP_INSTALL_IDE.md) 
+  * [Install Dependencies in CLI](DEP_INSTALL_CLI.md) 
 
 #### 4) Generate the Arduino Sketch
 The `dino` command is included with the gem. It will make the Arduino sketch folder for you, and configure it.
@@ -106,8 +60,9 @@ dino sketch serial
 dino sketch serial --target esp8266
 ````
 
-**For ESP32 over WiFi (2.4Ghz and DHCP Only):**
+**For ESP8266 or ESP32 over WiFi (2.4Ghz and DHCP Only):**
 ```shell
+dino sketch wifi --target esp8266 --ssid YOUR_SSID --password YOUR_PASSWORD
 dino sketch wifi --target esp32 --ssid YOUR_SSID --password YOUR_PASSWORD
 ````
 **Note:** [This example](examples/tcp.rb) shows how to use a board over a TCP connection, but the WiFi sketches fall back to the serial interface if no TCP client is connected. You should be able to run the examples over serial while still connected.

From 6302f36233ee1a7741d3aa794b8b754527de98ff Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 26 Feb 2023 18:04:22 -0400
Subject: [PATCH 295/296] New RGBLed example and diagram

---
 examples/04-pwm_led/pwm_led.rb     |   8 +--
 examples/05-rgb_led/rgb_led.fzz    | Bin 0 -> 6094 bytes
 examples/05-rgb_led/rgb_led.pdf    | Bin 0 -> 489852 bytes
 examples/05-rgb_led/rgb_led.rb     |  71 +++++++++++++++++----------
 examples/05-rgb_led/rgb_mapping.rb |  76 +++++++++++++++++++++++++++++
 5 files changed, 126 insertions(+), 29 deletions(-)
 create mode 100644 examples/05-rgb_led/rgb_led.fzz
 create mode 100644 examples/05-rgb_led/rgb_led.pdf
 create mode 100644 examples/05-rgb_led/rgb_mapping.rb

diff --git a/examples/04-pwm_led/pwm_led.rb b/examples/04-pwm_led/pwm_led.rb
index 9a72e598..8a5f8ce2 100644
--- a/examples/04-pwm_led/pwm_led.rb
+++ b/examples/04-pwm_led/pwm_led.rb
@@ -34,7 +34,7 @@
 end
 puts
 
-# Now let's add the potentiometer from the previous examp to control it.
+# Now let's add the potentiometer from the previous example to control it.
 potentiometer = Dino::Components::Potentiometer.new(pin: 'A0', board: board)
 
 # Helper method to calculate brightness.
@@ -44,10 +44,10 @@ def map_pot_value(value)
 
   # Linearization hack for audio taper potentiometers.
   # Adjust k for different tapers. This was an A500K.
-  k = 5
-  linearized = (fraction * (k + 1)) / ((k * fraction) + 1)
+  # k = 5
+  # linearized = (fraction * (k + 1)) / ((k * fraction) + 1)
   # Use this for linear potentiometers instead.
-  # linearized = fraction 
+  linearized = fraction 
   
   # Map to the linearized 0-1 range to a 0-255 range for 8-bit PWM.
   (linearized * 255).floor
diff --git a/examples/05-rgb_led/rgb_led.fzz b/examples/05-rgb_led/rgb_led.fzz
new file mode 100644
index 0000000000000000000000000000000000000000..8ed8cf45eab3ac5a1954179a42ef2aacd1008a19
GIT binary patch
literal 6094
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
Pcr?++G2~IT2LS#D!1>ZT

literal 0
HcmV?d00001

diff --git a/examples/05-rgb_led/rgb_led.pdf b/examples/05-rgb_led/rgb_led.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..2750a7144b52b10c1c1cdfd0eadceb4c9af504ec
GIT binary patch
literal 489852
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

literal 0
HcmV?d00001

diff --git a/examples/05-rgb_led/rgb_led.rb b/examples/05-rgb_led/rgb_led.rb
index 20e45031..686e65b3 100644
--- a/examples/05-rgb_led/rgb_led.rb
+++ b/examples/05-rgb_led/rgb_led.rb
@@ -1,37 +1,58 @@
 #
-# This is a simple example to blink an led
-# every half a second
+# Example 5: RGB LED
 #
 require 'bundler/setup'
 require 'dino'
 
+# Set up the board, connecting with serial over USB
 board = Dino::Board.new(Dino::TxRx::Serial.new)
-led = Dino::Components::RGBLed.new(pins: {red: 11, green: 10, blue: 9}, board: board)
-potentiometer = Dino::Components::Sensor.new(pin: 'A0', board: board)
 
+#
+# To set up an RGB LED, connect its cathode leg to ground, and each of its 3 color
+# anodes to PWM-capable pin on your board, through a current limiting resistor. Make
+# the green resistor much larger. Since green is usually brighter, we want to limit
+# its current more than the others. See rgb_led.pdf for a hook-up diagram.
+# The values used are 4.7k Ohm for green, 220 Ohm for red and blue.
+#
+# An RGB LED is really 3 individual LEDS in one, sharing a cathode (sometimes anode).
+# We could initailize them separately, or use the RGBLed class, which takes all 3 pins.
+#
+rgb_led = Dino::Components::RGBLed.new(pins: {red: 11, green: 10, blue: 9}, board: board)
 
-delay = 500.0
-
-potentiometer.on_data do |data|
+#
+# We can call methods on the RGBLed as a whole. For example, these 8 defined colors.
+#
+print "Press Enter to cycle through RGBLed defined colors..."; gets
+[:red, :green, :blue, :cyan, :yellow, :magenta, :white, :off].each do |color|
+  rgb_led.color = color
   sleep 0.5
-  puts "DATA: #{delay = data.to_i}"
 end
 
-  sleep(2)
-loop do
-  puts "DELAY: #{seconds = (delay / 1000.0)}"
-  p 'red'
-  led.color = :red
-  sleep(seconds)
-  p 'blue'
-  led.color = :blue
-  sleep(seconds)
-  p 'green'
-  led.color = :green
-  sleep(seconds)
+#
+# Or we can access the individual Leds through the #red, #green and #blue methods.
+# This makes an orange color with them.
+#
+rgb_led.red.write 255
+rgb_led.green.write 100
+rgb_led.blue.off
+print "Done. Changed to orange. Press Enter to continue..."; gets
+
+# Let's bring the potentiometer back from the previous examples.
+potentiometer = Dino::Components::Potentiometer.new(pin: 'A0', board: board)
+
+#
+# In a separate file (rgb_mapping.rb), there are methods to map the 0-1023 values
+# received from the potentiometer into RGB values that create a rough color spectrum.
+#
+require_relative 'rgb_mapping'
+potentiometer.on_change do |pot_value|
+  # Use the mapping methods to calculate values and write them.
+  rgb_led.red.write   map_red(pot_value)
+  rgb_led.green.write map_green(pot_value)
+  rgb_led.blue.write  map_blue(pot_value)
+  
+  print "Potentiometer value: #{pot_value}   \r"
 end
-#led.color(224, 27, 106)
-#sleep(1)
-#led.color(255, 149, 7)
-#sleep(1)
-#led.off
+
+puts "Turn potentiometer to change the RGB LED color. Press Ctrl+C to exit..."
+sleep
diff --git a/examples/05-rgb_led/rgb_mapping.rb b/examples/05-rgb_led/rgb_mapping.rb
new file mode 100644
index 00000000..4dcc882b
--- /dev/null
+++ b/examples/05-rgb_led/rgb_mapping.rb
@@ -0,0 +1,76 @@
+# Maximum and minimum PWM values.
+OUT_MAX = 255
+OUT_MIN = 0
+
+def map_value(value, input_steps, reverse=false)
+  # Map it to a 0-1 range first.
+  fraction = value / input_steps.to_f
+
+  # Reverse if needed.
+  fraction = 1 - fraction if reverse
+  
+  # Map to the output range
+  value = (fraction * OUT_MAX).floor
+  
+  # Clamp within the range just in case.
+  value = OUT_MAX if value > OUT_MAX
+  value = OUT_MIN if value < OUT_MIN
+  value
+end
+
+def map_red(pot_value)
+  # Red full on at low end.
+  return OUT_MAX if pot_value < 171
+  
+  # Red fades out from 171-341
+  if (171..341).include? pot_value
+    return map_value(pot_value - 171, 170, true)
+  end
+  
+  # Red full off in the middle third.
+  return OUT_MIN if (342..682).include? pot_value
+  
+  # Red fades in from 683-853
+  if (683..853).include? pot_value
+    return map_value(pot_value - 683, 170, false)
+  end
+  
+  # Red full on at high end.
+  return OUT_MAX if pot_value > 853
+end
+
+def map_green(pot_value)
+  # Green fades in from 0-171
+  if (0..170).include? pot_value
+    return map_value(pot_value, 170, false)
+  end
+
+  # Green full on from 1/6 to 1/2.
+  return OUT_MAX if (171..511).include? pot_value
+  
+  # Green fades out from 512-682
+  if (512..682).include? pot_value
+    return map_value(pot_value - 512, 170, true)
+  end
+  
+  # Geen full off above 2/3.
+  return OUT_MIN if pot_value > 682
+end
+
+def map_blue(pot_value)
+  # Blue full off until 1/3
+  return OUT_MIN if pot_value < 342
+  
+  # Blue fades in from 342-512 (170 steps)
+  if (342..542).include? pot_value
+    return map_value(pot_value - 342, 170, false)
+  end
+  
+  # Blue full on from 513 to 852
+  return OUT_MAX if (513..852).include? pot_value
+
+  # Blue fades out from 853-1023 (170 steps)
+  if (853..1023).include? pot_value
+    return map_value(pot_value - 853, 170, true)
+  end
+end

From e421bc50ba7346b315175f11ff34f264b1b04ed5 Mon Sep 17 00:00:00 2001
From: vickash <vickashmahabir@gmail.com>
Date: Sun, 26 Feb 2023 21:48:01 -0400
Subject: [PATCH 296/296] Potentiometer test

---
 lib/dino/components/potentiometer.rb  |  7 +--
 test/components/potentiometer_test.rb | 61 +++++++++++++++++++++++++++
 2 files changed, 63 insertions(+), 5 deletions(-)
 create mode 100644 test/components/potentiometer_test.rb

diff --git a/lib/dino/components/potentiometer.rb b/lib/dino/components/potentiometer.rb
index 272a85b8..51d3b271 100644
--- a/lib/dino/components/potentiometer.rb
+++ b/lib/dino/components/potentiometer.rb
@@ -7,15 +7,12 @@ class Potentiometer < Basic::AnalogInput
       def after_initialize(options={})
         super(options)
         
-        # Read 2x as often than regular AnalogInput.
-        @divider = 8
-        
         # Keep values to smooth with moving average by default.
         self.smoothing = true
         @moving_set = []
         
-        # Start listening immediately.
-        listen
+        # Start listening immediately. Read 2x as often than regular AnalogInput.
+        listen(@divider = 8)
       end
       
       def smoothing_on
diff --git a/test/components/potentiometer_test.rb b/test/components/potentiometer_test.rb
new file mode 100644
index 00000000..f9dc617a
--- /dev/null
+++ b/test/components/potentiometer_test.rb
@@ -0,0 +1,61 @@
+require 'test_helper'
+
+class PotentiometerTest < MiniTest::Test
+  def board
+    @board ||= BoardMock.new
+  end
+
+  def part
+    @part ||= Dino::Components::Potentiometer.new(board: board, pin:14)
+  end
+
+  def test_setup
+    mock = MiniTest::Mock.new.expect(:call, nil, [14,8])
+    board.stub(:analog_listen, mock) do
+      part
+    end
+    assert_equal part.divider, 8
+    assert_equal part.smoothing, true
+    assert_equal part.instance_variable_get(:@moving_set), []
+  end
+  
+  def test_smoothing_on
+    7.times do
+      part.update(10)
+    end
+    part.update(50)
+    
+    # 120/8 = 15
+    assert_equal part.state, 15
+  end
+  
+  def test_smoothing_off
+    part.smoothing_off
+    7.times do
+      part.update(10)
+    end
+    part.update(50)
+    
+    # Give latest value.
+    assert_equal part.state, 50
+  end
+  
+  def test_on_change
+    mock = Minitest::Mock.new.expect(:call, nil)
+    
+    # Turn off smoothing and set an initial value
+    part.smoothing_off
+    part.update(100)
+    
+    # Add the callback
+    part.on_change { mock.call }
+    
+    # Send a few updates
+    part.update(100)
+    part.update(100)
+    part.update(101)
+        
+    # Should have only been called once.
+    mock.verify
+  end
+end