Welcome to EnviroDIY, a community for do-it-yourself environmental science and monitoring. EnviroDIY is part of WikiWatershed, an initiative of Stroud Water Research Center designed to help people advance knowledge and stewardship of fresh water.
New to EnviroDIY? Start here

Jumper settings

Note: This page has two sections: the top half covers the newest Mayfly v1.x boards (released October 2021), and the bottom half covers the original Mayfly v0.5b boards (bought between 2016 and 2020).

Mayfly v1.0 & v1.1

The Mayfly v1.0 (revA3) has 20 user-configurable solder jumpers. All solder jumpers on the v1.0 board are now fully soldered; no trace cutting between pads is necessary, as on older versions.

The Mayfly v1.1 board has 21 user-configurable solder jumpers. All are the same as the v1.0, with the addition of SJ27.

SJ1: Connects the RTC Square-Wave Interrupt line to pin A7 (default) or D10. This lets the RTC wake the Mayfly from sleep mode. The default position is connected to A7. Remove the solder bridge to free up pin A7 for something else. Add a solder bridge to connect the center pad to D10 if you’d like to use the RTC square wave on the D10 hardware interrupt.

SJ2: Connects the user pushbutton to pin D21. Default position is ON. Remove the solder to free up D21.

SJ3: Enables the red LED (LED3) to be lit when the switched power 3.3v/5v/12v lines are turned on. Default position is ON. Remove the solder to disable the LED.

SJ4: Enables the yellow LED (LED4) that is lit whenever the LiPo battery is being charged. Default position is ON. Remove the solder to disable the LED.

SJ7: Connects the Bee socket Ring Indicator to A3. Default position is OPEN.

SJ8: Connects the Bee socket TX signal to Mayfly TXD0 (UART 0) or TXD1 (UART 1). Default position is TXD1.

SJ9: Connects the Bee socket RX signal to Mayfly RXD0 (UART 0) or RXD1 (UART 1). Default position is RXD1.

SJ12: This jumper allows you to easily connect the onboard 1M-ohm pull-up resistor to D10. The default position is OFF. Add a solder bridge if you want to connect D10 to the onboard pull-up resistor. This is handy for using D10 as a hardware interrupt. DO NOT use this jumper if you have modified SJ1 to use D10 as the RTC interrupt. Also, DO NOT use this jumper if you use D10 for any other input besides something that needs a pull-up.

SJ14: Charge/power controller input current limit: 500ma or 1A (default). This jumper lets you select the maximum current the Mayfly draws from the USB or battery source. The default setting is 1 amp (solder jumper closed). Remove the solder bridge to decrease the current limit to 500mA. Most computer USB ports are limited to 500mA, so use caution if you leave this in the 1A setting and try to draw more than 500mA from a USB source.

SJ15: LiPo battery charge rate: 500mA (default) or 1A. This jumper allows you to select the maximum charger output current of the onboard LiPo charger. The default setting is 500mA (solder jumper open). Add a solder bridge to increase the rate to 1A. Note that you’ll also need to close jumper SJ14 (set input limit to 1A) in order to get 1A charger output. Change this setting only if your input power source can supply more than 500mA. Setting the rate to 1A also makes the bq24074 charger chip extremely hot during charging, so use caution.

SJ16: Bee power LED enable. Enables the white LED (LED7) that is lit whenever the Bee power pin is active. Default jumper position is OFF. Add solder to enable the LED.

SJ17: Bee network status LED enable. Enables the blue LED (LED10) that is lit to show Bee module network status (if available). Default jumper position is OFF. Add solder to enable the LED. (Only for use with certain Bee modules that offer status output on Bee pin 15, like the Digi XBee boards)

SJ18: Bee regulator control: D18 (default) or 3.3v. Allows you to control the Bee socket power using D18 (default) or by connecting to constant 3.3V power.

SJ19: Mayfly pin D19 to Bee pin 12 (default) or 13. This jumper is used to select which Bee board status pin gets connected to Mayfly pin D19. For Digi brand Xbee boards, change this jumper to 13. But for most other modules (like EnviroDIY LTE cell boards), leave this jumper at the default pin 12 setting.

SJ20: Mayfly A5 to Bee Reset (default) or Bee RTS. This jumper lets you choose whether Mayfly pin A5 connects to Bee pin 5 for Bee Reset (default) or to Bee pin 16 for Bee RTS.

SJ21: Bee Reset pull-up enable. Default position is CLOSED. Remove the solder jumper if your Bee module needs Bee pin 5 not to be pulled high.

SJ22: SHT40 Humidity/Temp sensor enable. Allows you to remove power from the onboard SHT40 Humidity/Temp sensor. Default position is CLOSED. Remove the solder jumper to disable the sensor.

SJ23: Analog light sensor enable. Allows you to remove power from the onboard Analog Light Sensor. Default position is CLOSED. Remove the solder jumper to disable the sensor (also remove SJ24).

SJ24: Analog light sensor to pin A4. This jumper connects the analog light sensor output to Mayfly analog pin A4. Default position is CLOSED. Remove the solder jumper to disconnect the light sensor and free up pin A4.

SJ25: Boost regulator output voltage selection: 12v (default) or 9v. This jumper lets you change the usual “Switched 12 volts” output to “Switched 9 volts”. This is useful if you have a sensor that requires 9V but could be damaged by 12V. Note that all Grove jack power jumpers labeled 12V will be changed to 9V, and the 12VSW pins in the 2×10 headers will also be switched to 9V.


For Mayfly v1.1 (both RevA and RevB)

SJ27: Analog pin A6 connected to either the combination Voltage in (default) or direct LiPo battery socket. The default setting works best so that the Mayfly can sense the input voltage of whichever source is highest. With just a LiPo connected, A6 will see the battery voltage (~3.7 V). If you connect a solar panel, A6 will see about 4.2V in full sun. If you connect a USB cable, A6 will see 4.9V. To see only the raw LiPo battery voltage, independent of the higher voltage from the solar panel, change the solder jumper to Lipo.


For Mayfly v1.1 RevA only:

SJ26: Unused. Do not use SJ26 in either setting; leave it open (no solder). This feature isn’t used on the Mayfly v1.1 RevA. (It was originally intended to let users select the input source for the 12 boost circuitry, but that feature has been removed, and all boards were modified with a small black jumper wire on the top side of the board to hardwire the boost input to the bq24074). DO NOT attempt to solder SJ26 in either position; leave it open with no solder. Clear conformal coating was painted over SJ26 to prevent use. SJ26 was removed from RevB.


Jumper Settings on the Grove Jacks on the Front of the Mayfly v1.0 and v1.1

  • On the front of the v1.0 and v1.1 boards, five small T-shaped pin headers sit next to the Grove connectors. These headers let you select the voltage signal on the V line of the Grove connector by placing the small jumper shunt in the correct position.
  • The Grove connector labeled “I2C” has no voltage-setting adjustments via jumpers. The V pin of the I2C jack is constantly powered at 3.3 volts.
  • The Grove jack labeled D5-6 can be powered by either a constant 3.3V (default) or the switchable 3.3V or 5V signal (controlled by D22).
  • The two center Grove jacks labeled “D4-7” can be powered by either the switchable 3.3V line (default) or the switchable 5V or 12V line (both controlled by D22). These jacks are also the preferred connections for SDI-12 sensors, hence the SDI-12 label. These jacks have identical signal pins (D4 and D7), but the jumpers allow you to supply 2 different voltages if you’re using two SDI-12 sensors with different power requirements.
  • The Grove jack labeled D10-11 can be powered by either switchable 3.3V (default) or 5V or 12V (controlled by D22).
  • The two Grove connectors for the Auxiliary Analog converter can be powered by either the switchable 3.3V line (default) or the switchable 5V or 12V line (both controlled by D22). Both Aux Analog jacks receive the same voltage, determined by the jumper position.

The following photo shows an example of some non-default jumper settings to show how to provide different voltages to the different Grove jacks depending on your sensor needs.

Always adjust the jumpers with the Mayfly board turned off, using tweezers or fine-tipped pliers if needed, and make sure you don’t bend any pins. Also make sure the jumper is securely fitted to the header, or it could fall off during handling or shipping. These are 2.0mm pitch jumpers, so if you lose one, a standard 0.1-inch jumper will not fit securely and could cause intermittent voltage supply to the Grove jack.

Example non-default jumper settings for Mayfly v1.1 to output 5V or 12V to a Grove jack.
Example of non-default jumper settings for Mayfly v1.0 to output 5V or 12V to a Grove jack.

Mayfly v0.5b

On the back of the Mayfly v0.5b board (boards made between 2016 and 2020), there are 12 user-configurable solder jumpers

SJ1: Connects the RTC Square-Wave Interrupt line to pin A7 (or D10 on board v0.4). This lets the RTC wake the Mayfly from sleep mode. The default position is connected to A7. Cut the trace to free up pin A7 for something else. Add a solder bridge to connect the center pad to D10 if you’d like to use the D10 hardware interrupt.

SJ2: Connects the pushbutton to pin D21. The default position is ON. Cut the trace to free up D21.

SJ3: Enables the red LED to be lit when the switched 3.3v line is turned on. The default position is ON. Cut the trace to disable the LED.

SJ4:  Enables the yellow LED that is lit whenever the LiPo battery is being charged. The default position is ON. Cut the trace to disable the LED.

SJ5: Enables the 5V boost circuitry. The default position is ENABLED. Cut the trace and solder the middle pad to the DISABLE pad to deactivate the 5V boost circuit. Note: This jumper has been removed on board version 0.5 and later.

SJ6: Connects the RTC Reset or 32khz signal to pin D18. The default position is NONE. Solder the middle pad to only one other pad if needed. Note: SJ6 and SJ10 are both used for configuring inputs to D18. Do not use SJ10 if you select a setting for SJ6.

SJ7: Connects the Bee socket Ring Indicator or Associate lines to A5. The default position is NONE.

SJ8: Connects the Bee socket TX signal to Mayfly TXD0 (UART 0) or TXD1 (UART 1). The default position is TXD1.

SJ9: Connects the Bee socket RX signal to Mayfly RXD0 (UART 0) or RXD1 (UART 1). The default position is RXD1.

SJ10: Connects the microSD socket’s Card Detect line to D18. The default position is OFF. Solder this jumper together if you want to sense a memory card in either the horizontal socket or the vertical adapter board. Note: SJ6 and SJ10 are both used for configuring inputs to D18. Do not use SJ6 if you select a setting for SJ10.

SJ11: Controls power to the FT232RL USB chip. The default position is ON. Cut this trace if you do not want to use the USB port for programming.

SJ12: On board v0.5 and later, this jumper lets you easily connect the onboard 1M-ohm pull-up resistor to D10. The default position is OFF. Add a solder bridge if you want to connect D10 to the onboard pull-up resistor. This is handy for using D10 as a hardware interrupt. DO NOT use this jumper if you have modified SJ1 to use D10 as the RTC interrupt. Also, DO NOT use this jumper if you use D10 for any other input besides something that needs a pull-up.

SJ13: On board v0.5b and later, this jumper lets you select the power source for the Bee socket’s Vcc pin (Bee pin 1). By default, the Bee is powered by the Mayfly’s main 3.3V Vcc supply. By cutting the SJ13 trace and soldering the middle pad to the LiPo setting, you can connect the Bee Vcc pin directly to the Mayfly’s LiPo battery input.

On the front of the board, 4 small 3-pin headers sit next to the Grove connectors. These headers let you select which voltage signal goes to the V line of the Grove connector.

The two Grove connectors labeled “I2C” and “D4-5” can be powered by either 3.3v constantly or the switchable 3.3v signal (controlled by D22).

The two Grove connectors labeled “D6-7” and “D10-11”  can be powered by either the switchable 3.3v line or the switchable 5v line (both controlled by D22).

The two Grove connectors for the Auxiliary Analog converter can be powered by either the switchable 3.3v line or the switchable 5v line (both controlled by D22).