Skip to content

Latest commit

 

History

History
50 lines (46 loc) · 4.5 KB

README.md

File metadata and controls

50 lines (46 loc) · 4.5 KB
Raw

NodeMCU-NightScoutDisplay

Display Nightscout data using a cheap NodeMCU and OLED display (instead of using an old phone or tablet).

Displays: NS BG with direction arrow, yellow hihi,high,low,lolo alarms, stale data indication(value crossed out if NS data is old), displays 'Loading' when data is old due to repeated wifi connection attempts

Components/Wiring/Requirements

  • Display: 0.96" Inch Yellow Blue I2c IIC Serial Oled
  • WIFI NodeMCU: NodeMCU LUA ESP8266
  • MicroUSB Cable
  • Wiring:
    ** D1 on WIFI NodeMCU -to- SDA on Display
    ** D2 on WIFI NodeMCU -to- SCL on Display
    ** 3V3 on WIFI NodeMCU -to- GND on Display
    ** GND on WIFI NodeMCU -to- VCC on Display
    ** MicroUSB(powered/plugged into wall or computer, ect) -to- WIFI NodeMCU USB port
  • wifi is required

Directions

  1. Download this repo NodeMCU-NightScoutDisplay and extract the files
  2. Open the NightSout.lua file: line 20, and change any other constants you want to change in the "--constants" section (starting on line 19)(and save file)
  3. Open the init.lua file and enter your WIFI info (ip, netmask, gateway, wifissid, wifiPassword) (and save file)
  4. Wire together (solder or use breadboard) the Display and WIFI NodeMCU (see 'Components/Wiring' section above)
  5. Flash the firmware to your NodeMCU, using NodeMCU-flasher:
    • Connect the NodeMCU to your computer (using the MicroUSB)
    • Open the NodeMCU-flasher
    • In the Config tab:
      • Browse to the firmware file (from this repo, which you downloaded in step1: /NodeMCU-Firmware/nodemcu-master-14-modules-2017-04-08-22-15-36-integer.bin)
      • Set Offset to 0x00000
    • In the Operation tab:
      • Select the COM Port (that your NodeMCU is connected to)
      • Click the Flash button (Wait until finished, then close NodeMCU-flasher)
  6. Upload .lua files onto the NodeMCU using ESPlorer:
    • Connect the NodeMCU to your computer (using the MicroUSB)(if not already)
    • Open the ESPlorer Program
    • Select COM port
    • Set Baud rate to 115200
    • Click Open (you'll probably see an error that you can't communicate)
    • Click the reset button on the NodeMCU
    • Click the 'Upload button' and upload the (2) lua files (from this repo, which you downloaded in step1: /NodeMCU-lua/NightScout.lua and /NodeMCU-lua/init.lua)
    • Click the reset button on the NodeMCU (you should see "WiFi connection established, IP address: " and "You have 5 seconds to abort", and more ongoing scrolling messages afterwards to know it's working, and ready to unplug and use wherever you want to put it that has a wifi connection)

Disclaimer, Known Issues

This project is for research only. Don't use it for any medical decisions.
This is my first first time programming anything real from scratch. I'm sure it can use improvements! It seems to work ok (but includes a workaround to reset the nodeMCU after continued failed https connection attempts, and you'll see 'Loading...'!)
This display is only 0.95" wide - you'd probably want to use (and modify code for) a larger display if you want to see it further than a few feet away

Acknowledgements

  1. This project relies on The Nightscout Project - Thanks to them for helping so many people - Please consider donating to NightScout
  2. Instead of using this project, you could, make a display of your Nightscout data using arduiono and Adafruit Featherwing hardware (a bit pricier, but looks cool and is bigger) - ruuddotorg/nightscout-display
  3. If you have an old phone or tablet around and don't mind forcing it on all the time, you could, instead of this project, just display your Nightscout data on it, using Nightscout Remote Monitor. Or use this large colorful with BG and arrow instead: Nightscout Remote Monitor
  4. NodeMCU-Wixel - Allows you to not carry a G4 receiver and phone around the house with you!, using xdrip, xdrip wixel, and NodeMCU with lua