Build Environment Notes
LOGGER was developed on a computer that is also used to develop Teensy applications and ESP8266 applications. The Arduino environent is shared. This environment setup has been tried and found to work on machines without the Teensy environment, but, that testing is not continuous. There may be issues if the Teensy environment is missing.
An excellent discussion of how to load the ESP8266 is at http://www.allaboutcircuits.com/projects/update-the-firmware-in-your-esp8266-wi-fi-module/
Espressif, the designers of the ESP8266 integrated circuit, have created a specific piece of software to update the firmware in their chips. It's the ESP Flash Download Tool.
This might be a way to decode a stack dump: https://github.com/esp8266/Arduino/blob/master/doc/Troubleshooting/stack_dump.md
To reboot the module press the SW2 button.
Loading a New Image
Press and hold the SW1 Button then press SW2 to reboot while still holding SW1. The D1 LED should be on at a dim level. Then initiate the upload in the Arduino environment.
Development Environment Setup
Download and install the Arduino development environment from
1.8.13 was used
copy as a zip file).
Early development was done on a system that had the Teensyduino development environment installed. This should not be necessary development continued using Arduino 1.8.2, 1.8.10, 1.8.12 and 1.8.13 without the Teensyduino installation. The Teensyduino development environment from PJRC http://www.pjrc.com/teensy/td_download.html was used. Development was done with Teensy 1.34 beta for Arduino 1.8.1 (local copy). Arduino must be installed first. Teensy modifies the installation.
Adafruit has add on boards for the ESP8266 wifi module. Discussion at: https://learn.adafruit.com/adafruit-huzzah-esp8266-breakout/overview Update the Arduino installation by going to Arduino >> File >> Preferences and adding:
https://adafruit.github.io/arduino-board-index/package_adafruit_index.jsonto the Additional Boards Manager. Then going to Tools >> Board >> Boards Manager locating ESP8266 in the list and INSTALLing that board. (Select Type: Contributed to narrow the search). Version 3.0.0 was used. Previous development used version 2.7.4, 2.7.1 and 2.5.2. Early development was on version 2.3.0. Later versions are likely to work. Development will continue on later versions when they are released.
Adafruit circuit playground was installed version 1.11.2 is being used.
Adafruit GFX library was installed version 1.10.2 is used. Version 1.10.1 was used previously.
Adafruit RTClib was installed version 1.12.0 is used. Version 1.11.2 was used previously.
The onewire library from the Teensy world is used. Version 2.3.5 was used. Earlier development was done on 2.3.3 and 2.3.0. It is required and may have to be manually added. It comes from https://github.com/PaulStoffregen/OneWire (local copy of 2.3.5) (local copy of 2.3.0) Go to Sketch >> Include Library >> Add .ZIP Library... Then update to the latest version.
The SparkFun BME280 library is installed. Version 2.0.9 was used.
The SparkFun CCS811 library is installed. Version 2.0.1 was used.
The SparkFun Micro OLED Breakout library is installed. Version 1.3.3 was used.
The SparkFun VCNL4040 Proximity Sensor library is installed. Version 1.0.2 was used.
The SparkFun VL53L1X 4m Laser Distance Sensor library is installed. Version 1.2.9 was used.
The TimeLib library is also common with the Teensy install. Version 1.6.0 was used. Earlier development used version 1.5.0. It is required and will have to be manually added. It comes from: https://github.com/PaulStoffregen/Time (local copy of 1.6.0) (local copy of 1.5.0) Go to Sketch >> Include Library >> Add .ZIP Library...
The ATT M2X environment is used
to uplink data to the cloud. The library used does not report a
version it came from
and is packaged as a zip file for inclusion at
M2XStreamClient.zip Go to Sketch >>
Include Library >> Add .ZIP Library...
There is a bug in core_esp8266_si2c.cpp the patched file is in the logger release. Copy this file to the
appropriate directory if the library has not yet been patched or
fixed. A simple note about the patch is in the
file. Search for MJN and ???.
Once all of the environment is installed remember to set the target platform, Generic ESP8266 was used. A flash size of 4M with 1M SPIFFS was used.
A common debugging module for the ESP8266 is the FTDI Friend from
ADAfruit. Drivers for this module must be installed, they are
Windows 10 automatically installs the drivers. Other versions
Once the device is connected figure out which port is used. The
Logger uses 115200 baud. Several of the line endings work, Newline
Development Environment Setup
To enable building for the ESP32 update the Arduino installation by going to Arduino >> File >> Preferences and adding:
https://dl.espressif.com/dl/package_esp32_index.jsonto the Additional Boards Manager. Then going to Tools >> Board >> Boards Manager locate ESP32 in the list and INSTALLing that board. (Select Type: Contributed to narrow the search). Version 1.0.6 was used.
This is a place to collect instructions minimal testing has been done on the ESP32 platform to date using the 'ESP32 Dev Module' board.
Documentation for the ESP32_DevKitc_V4 among others is found at the Experssif Devkit Getting Started Guide.
Schematics and Layout Releases
You must be logged in to see the hardware designs.
LOGGER Firmware Releases
See Binary Images for images released in support of the LOGGER.
See the Code History for a complete history of changes to the LOGGER code.
LOGGER pages copyright 2016-2021 by Dragonnorth Group (Michael Newman).|
Send comments and corrections to: