EnviroDIY / EnviroDIY_Mayfly_Logger

hardware design files, example code sketches, and documentation for Arduino-framework EnviroDIY Mayfly data logger
https://envirodiy.org/mayfly/
Other
31 stars 26 forks source link
arduino board environmental-monitoring monitoring sketches

EnviroDIY Mayfly Data Logger

The EnviroDIY™ Mayfly Data Logger is an Arduino-framework microcontroller board designed specifically for environmental Internet of Things (IoT) applications with the goal to facilitate professional-quality, do-it-yourself (DIY) environmental science and monitoring.

This EnviroDIY_Mayfly_Logger Github repository provides hardware design files and example code sketches, the EnviroDIY community provides support via project posts and forums, and the Mayfly Logger board is available for purchase on on Amazon for user convenience.

Features:

Pin-out for v0.5b

Pin Number[s] Function Access Notes
D0/D1 Serial Rx/Tx (UART) Connected to FTDI for USB programming Also accessible via programming port, 20 pin header, and XBee socket via SJ8/9
D2/D3 Serial1 Rx/Tx (UART) XBee socket Din/Dout (pins 2/3) Also accessible via 20 pin header, can be disconnected from XBee socket via SJ8/9
D19 XBee CTS XBee socket CTS (pin 12) Also accessible via 20 pin header
D20 XBee RTS XBee socket RTS (pin 16) Also accessible via 20 pin header
D23 XBee DTR XBee socket DTR (pin 9) Also accessible via 20 pin header
A5=D29* XBee Assoc or RI XBee socket Assoc or RI (pin 15 or 20) Not connected to XBee socket by default, use SJ7 to connect; Also accessible via 20 pin header
D16/D17 I2C SCL/SDA ("Wire") Grove connector Also accessible via 20 pin header
D13/D14/D15 SPI MOSI/MISO/SCK microSD card slot & SPI header
D12 microSD chip select microSD card slot & SPI header
D18 SD card detect OR RTC 32KHz 20 pin header Not connected to either SD or RTC by default, use SJ6 for RTC or SJ10 for SD, do not use both
A7=D31 or D10 RTC Interrupt 20 pin header A7 is connected to RTC interrupt by default; Use SJ1 to disconnect A7 and/or to connect D10
D22 Switched power/LED4 Switched power on all Grove ports Pin is not directly accessible, only switched power; Cut SJ3 to disconnect LED4 (red)
D21 user push button 20 pin header Cut SJ to disconnect button
D8 LED1 (green) 20 pin header
D9 LED2 (red) 20 pin header
A6=D30 Battery measurement None Connected via voltage divider - for v0.4 and newer, use multiplier of 1.27; for v0.3 and older, use multiplier of 1.47
D4-7, D10-11 General Purpose I/O Grove connector; 20 pin header
AA0-AA3 Auxilliary ADC Grove connector; 20 pin header Connected to Auxillary adc (TI ADS1115), not to Mayfly analog pins

Solder Jumper Connections for v0.5b

Number Function Default Connection
SJ1 Connect to interrupt from RTC Pin A7 connected to RTC interrupt
SJ2 Disconnect D21 from user button Pin D21 is connected to button (closed)
SJ3 Disconnect D22 from LED3 Pin D22 is connected to LED3 (closed)
SJ4 Disconnect LED4 from solar LED4 indicates solar charging status (closed)
SJ5* 5V Boost enable Boost enabled
SJ6** Connect D18 to RTC RST/32kHz Not connected (open)
SJ7 Pin A5 to XBee ASSOC or RI Not connected (all pads open)
SJ8 XBee Din to TX0/TX1 XBee Din connected to TX1
SJ9 XBee Dout to RX0/RX1 XBee Dout connected to RX1
SJ10** Connect D18 to SD card detect Not connected (open)
SJ11 USB FTDI programming enable FTDI enabled (closed)
SJ12 D10 external pull-up D10 (INT2) is not pulled up externally (open)

* SJ5 has been removed in versions newer than v0.4 ** SJ6 and SJ10 should not both be closed at the same time

Programming

Mayfly Data Logger can be programmed using standard Aruduino code and community libraries via the Arduino Integrated Development Environment (IDE) software or the more powerful PlatformIO extensions for Visual Studio Code or Atom.

To use the Mayfly with the Arduino IDE you must add "EnviroDIY ATmega Boards" using the Tools > Board > Boards Manager as described in the Mayfly Data Logger Software post

No addition set-up is required to use the PlatformIO. The proper enviroment settings for the Mayfly in a platformio.ini file are:

[env:mayfly]
platform = atmelavr
board = mayfly
framework = arduino

Additional Resources and Links

Design Files & Further Documentation

We share our EnviroDIY Mayfly logger hardware design files and documentation in this repository's Hardware Design Files pages and Documentation pages.

License

Software sketches and code are released under the BSD 3-Clause License -- See LICENSE.md file for details.

Documentation is licensed as Creative Commons Attribution-ShareAlike 4.0 (CC-BY-SA) copyright.

Hardware designs shared are released, unless otherwise indicated, under the CERN Open Hardware License 1.2 (CERN_OHL).

Credits

EnviroDIY™ is presented by the Stroud Water Research Center, with contributions from a community of enthusiasts sharing do-it-yourself ideas for environmental science and monitoring.

Shannon Hicks is the primary developer of the EnviroDIY Mayfly Data Logger hardware, with input from many other contributors.

The Mayfly was developed based on the SODAQ Mbili board hardware and the SODAQ Mbili bootloader software, designed by Gregory Knauff (GKNFF).

This project has benefited from the support from the following funders: