Skip to content

Commit

Permalink
v1.1.6 updates
Browse files Browse the repository at this point in the history
  • Loading branch information
ogiewon authored Aug 17, 2019
1 parent d896599 commit fc55f43
Showing 1 changed file with 13 additions and 10 deletions.
23 changes: 13 additions & 10 deletions HubDuino/README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
HubDuino v1.1.5
HubDuino v1.1.6
================

**WARNING** - If using an ESP8266, make sure you are using v2.5.2 of the Arduino ESP8266 Board manager (v2.4/2.4.1 introduced a memory leak causing ST_Anything to crash after an hour or two) along with Arduino IDE v1.8.9.

**Recent History:**
- 2019-08-17 HubDuino v1.1.6 - Added support for Arduino NANO33IoT
- 2019-06-28 HubDuino v1.1.5 - Added support for MKR1010, Arduino 1.8.9, ESP8266 v2.5.2, updated numerous libraries, etc...
- 2019-03-24 HubDuino v1.1.4 - Added support for I2C device - SHT31(temp, humid)
- 2019-02-10 HubDuino v1.1.3 - Significant overhaul of ES_Servo class and Child Driver - Thanks Jeff Albers!
Expand All @@ -12,15 +13,16 @@ HubDuino v1.1.5

![screenshot](https://user-images.githubusercontent.com/5206084/41016005-e382479e-691a-11e8-871f-e62964c0e0c0.png)

Note: The HubDuino v1.1.5 release is based on the ST_Anything v2.9.5 baseline and was built using the Arduino IDE v1.8.9. Please make sure to upgrade your Arduino IDE.
Note: The HubDuino v1.1.6 release is based on the ST_Anything v2.9.6 baseline and was built using the Arduino IDE v1.8.9. Please make sure to upgrade your Arduino IDE.

Turn your Arduino UNO/MEGA/MKR1000/MKR1010, NodeMCU ESP8266, or ESP32 into Anything you can imagine! HubDuino/ST_Anything is an Arduino library, sketch, and Device Handlers that works with your hardware to create an all-in-one SmartThings device.
Turn your Arduino UNO/MEGA/MKR1000/MKR1010/NANO33IoT, ESP8266, or ESP32 into Anything you can imagine! HubDuino/ST_Anything is an Arduino library, sketch, and Device Handlers that works with your hardware to create an all-in-one SmartThings device.
- Arduino with SmartThings ThingShield
- Arduino with W5100 Ethernet shield
- Arduino with W5500 Ethernet shield
- Arduino with WiFi101 Shield (or Adafruit ATWINC1500 module)
- Arduino MKR1000 (has integrated WiFi101)
- Arduino MKR1010 (has integrated WiFiNINA)
- Arduino NANO33IoT (has integrated WiFiNINA)
- Arduino with ESP-01 for WiFi
- Standalone NodeMCU v1.0 ESP8266-12e
- Standalone ESP-01 (or really any ESP8266 based board)
Expand Down Expand Up @@ -65,7 +67,7 @@ This package currently implements the following Hubitat Device Capabilities:
- Temperature Measurement (using a BMP280 I2C sensor)
- Pressure Measurement (using a BMP280 I2C sensor)

Note: Attempting to use all of these at once on an Arduino UNO R3 is likely to result in running out of SRAM on the UNO (the UNO only has 2 kilobytes of RAM.) Using an Arduino MEGA 2560 with 8 kilobytes of SRAM is recommended if you want to run everything at once. The ESP8266, ESP32, and MKR1000 platforms also have a lot more memory available.
Note: Attempting to use all of these at once on an Arduino UNO R3 is likely to result in running out of SRAM on the UNO (the UNO only has 2 kilobytes of RAM.) Using an Arduino MEGA 2560 with 8 kilobytes of SRAM is recommended if you want to run everything at once. The ESP8266, ESP32, and MKR1000, MKR1010, NANO33IoT platforms also have a lot more memory available.


## Overview
Expand All @@ -76,7 +78,8 @@ HubDuino/ST_Anything consists of four main parts:
- ST_Anything_Multiples_MEGAWiFiEsp.ino - Arduino MEGA + ESP-01 WiFi module with "AT Firmware"
- ST_Anything_Multiples_WiFi101.ino - Arduino MEGA + WiFi101 Shield (or Adafruit ATWINC1500 module)
- ST_Anything_Multiples_MKR1000.ino - Arduino MKR1000 (has onboard WiFi101 chip)
- ST_Anything_Multiples_MKR1010.ino - Arduino MKR1000 (has onboard WiFiNINA chip)
- ST_Anything_Multiples_MKR1010.ino - Arduino MKR1010 (has onboard WiFiNINA chip)
- ST_Anything_Multiples_NANO33IoT.ino - Arduino NANO 33 IoT (has onboard WiFiNINA chip)
- ST_Anything_Multiples_ESP8266WiFi.ino - NodeMCU v1.0 ESP8266-12e development board (no Arduino!)
- ST_Anything_Multiples_ESP01WiFi.ino - ESP-01 (ESP8266-01) module (no Arduino!)
- ST_Anything_Multiples_ThingShield.ino - Arduino UNO/MEGA + ST ThingShield
Expand All @@ -86,15 +89,15 @@ HubDuino/ST_Anything consists of four main parts:
- The ST_Anything Arduino libraries + required 3rd party libraries
- The SmartThings libraries - A modified, more efficient version, now with added support for LAN-to-Hub based communications too!
- The HubDuino Parent + Child Drivers that support sketches above.
- hubduino-parent-ethernet.groovy (LAN-to-Hub, - automagically creates child devices based on your Arduino sketch,Arduino/W5100/W5500, Arduino/ESP-01, NodeMCU ESP8266-12e, ESP-01, ESP32, MKR1000)
- hubduino-parent-ethernet.groovy (LAN-to-Hub, - automagically creates child devices based on your Arduino sketch,Arduino/W5100/W5500, Arduino/ESP-01, NodeMCU ESP8266-12e, ESP-01, ESP32, MKR1000, MKR1010, NANO33IoT)
- hubduino-parent-thingshield.groovy (Thingshield-to-Hub - automagically creates child devices based on your Arduino sketch)
- child-xxxxxx.groovy (get these from the ST_Anything HubDuino folder at https://github.com/DanielOgorchock/ST_Anything/tree/master/HubDuino/Drivers)
- currently 24 child device handlers are available!

## Pre-Requisites for using LAN-to-HUB Ethernet connectivity (Arduino/W5100, Arduino/W5500, Arduino/ESP-01, NodeMCU ESP8266, ESP-01, ESP32, MKR1000, MKR1010)
## Pre-Requisites for using LAN-to-HUB Ethernet connectivity (Arduino/W5100, Arduino/W5500, Arduino/ESP-01, NodeMCU ESP8266, ESP-01, ESP32, MKR1000, MKR1010m NANO33IoT)
- Your Hubitat HUB must have a Reserved/Static TCP/IP Address assigned via your router's DHCP Server. Since this procedure varies by router model, Please Google it!
- ***The Hubitat hub listens on port 39501. This is different than the ST hub which uses 39500 - MODIFY YOUR ARDUINO SKETCH ACCORDINGLY!***
- You'll need to identify a static TCP/IP address for your Arduino/W5100, Arduino/W5500, Arduino/ESP-01, NodeMCU ESP8266, or ESP-01, ESP32 as you'll need this later when setting up the sketch. Choose an unused IP address outside of the range your router's DHCP server uses, but in the same subnet.
- You'll need to identify a static TCP/IP address for your Arduino/W5100, Arduino/W5500, Arduino/ESP-01, NodeMCU ESP8266, ESP-01, ESP32, MKR1000, MKR1010, or NANO33IoT as you'll need this later when setting up the sketch. Choose an unused IP address outside of the range your router's DHCP server uses, but in the same subnet.

## Arduino IDE Setup Instructions
- Download the ST_Anything repository, focusing on the ST_Anything/Arduino/ folders
Expand All @@ -116,15 +119,15 @@ HubDuino/ST_Anything consists of four main parts:
-Find the lines of the Sketch where it says "<---You must edit this line!"
- You must ensure your Hubitat hub's LAN IP address does not change. Use your router's reserved/static DHCP assignment feature to make sure your Hubitat Elevation hub always gets the same IP Address! Enter that address in the corresponding line in the sketch.
- ***The Hubitat hub listens on port 39501. Make sure your Arduino sketch reflects this port number change!***
- The Arduino must be assigned a static TCP/IP address, Gateway, DNS, Subnet Mask, MAC Address(W5100/W5500 only), SSID+Password(ESP8266,ESP01,ESP32,WiFi101,MKR1000,MKR1010)
- The Arduino must be assigned a static TCP/IP address, Gateway, DNS, Subnet Mask, MAC Address(W5100/W5500 only), SSID+Password(ESP8266,ESP01,ESP32,WiFi101,MKR1000,MKR1010, NANO33IoT)
- *** NOTE: If using the W5100 Shield, YOU MUST ASSIGN IT A UNIQUE MAC ADDRESS in the sketch! Please leave the first octet in the MAC Address '06' as certain MAC addresses are UNICAST while others are MULTICAST. Your MAC must be UNICAST and be a 'Locally Administered Address' Please see https://en.wikipedia.org/wiki/MAC_address#Address_details for more information ***
- *** NOTE: If using the W5500 Shield, YOU MUST ASSIGN IT A UNIQUE MAC ADDRESS in the sketch! Use the one packaged with the W5500 shield.
- Note: If using an ESP-01 for WiFi-connecticity (i.e. as a WiFi dongle/shield) with an Arduino, the example assumes you're using an Arduino MEGA 2560. Attach the ESP-01 to Hardware Serial "Serial1" and make sure your ESP01 has current 'AT Firmware' installed.
- Your IDE Serial Monitor Window must be set to 115200 baud **** Please note recent change to 115200 ****
- With the Serial Monitor window open, load your sketch and watch the output
- The MAC Address will be printed out in the serial monitor window. Write this down as you will need it to configure the Device using your web browser connected to the Hubitat hub. (Note: MAC Address must later be entered with no delimeters (i.e. NO COLONS!) in the form of "06AB23CD45EF" (all UPPERCASE and without quotes!))

WARNING: If you are using an Arduino UNO, you may need to comment out some of the devices in the sketch (in the setup() function) due to the UNO's limited 2 kilobytes of SRAM. Failing to do so will most likely result in unpredictable behavior. The Arduino MEGA 2560 has 8k of SRAM and has four Hardware Serial ports (UARTs). If you plan on using many devices, get an Arduino MEGA 2560, a MKR1000, a NodeMCU v1.0 ESP8266-12e, or a ESP32 board.
WARNING: If you are using an Arduino UNO, you may need to comment out some of the devices in the sketch (in the setup() function) due to the UNO's limited 2 kilobytes of SRAM. Failing to do so will most likely result in unpredictable behavior. The Arduino MEGA 2560 has 8k of SRAM and has four Hardware Serial ports (UARTs). If you plan on using many devices, get an Arduino MEGA 2560, a MKR1000, a MKR1010, a NANO33IoT, a NodeMCU v1.0 ESP8266-12e, or a ESP32 board.

## Hubitat Elevation Hub Setup Instructions
- Using your Web Browser (Chrome works well) connect to your Hubitat Hub
Expand Down

0 comments on commit fc55f43

Please sign in to comment.