Skip to content

Air delivery module (electrovalves)

The air delivery module puffs air, or air carrying an odour, into individual tubes of the arena when the ethoscope decides to act, as a stimulus or to probe arousal. Ten three-port solenoid valves (electrovalves), five on each side of a printed valve base, each feed one tube. The splitters that bring air to the valves and collect their exhaust are built into the printed parts, so little piping is needed. The valves are switched by an Arduino Micro on the module board, which takes its commands from the ethoscope over USB.

The module comes in two forms. The valves-only module carries the cradle of the optogenetics module on its valve base and works with either of two arenas: the arena for long 5 mm tubes, which holds ten tubes, or the 20-tube sleep arena. The motors and valves variant puts the motor holder of the sleep deprivation module, with its ten N20 motors, on top of the valve base, so that the motors sit against the tubes and the same flies can be woken mechanically or with a puff; it uses the 20-tube sleep arena.

Five valves mounted on one side of the valve base, wired in red and black to the module board, with the joiner pipe feeding their inputs

Part Qty Catalogue no. Supplier Notes
Electronics
Module board (PCB), version 1.3 1 — any PCB maker Board files, v1.3 (zip): Gerber files, the design source (.fzz) and front renders. Order 78.0 × 54.0 mm, two layers, 1.6 mm thick. The printed module bases fit this board (2.0 mm mounting holes, 73.66 × 49.53 mm apart centre to centre). Boards of versions 1.0 and 1.11 also work: see Older boards.
Arduino Micro 1 771-7667 RS The ethoscope recognises the module by its USB ID, 2341:8037 on a genuine Micro. A clone with another ID has to be added by hand (see Troubleshooting).
Darlington transistor array, 18-pin DIP 3 168-6833 (ULN2803A, sold as a tube) or 168-8906 (ULQ2803A) RS Also Farnell 1094428 (ULN2803A) or 2849693 (ULQ2803A). The two parts are pin-compatible: use either.
Pin headers, single row, 2.54 mm 2 × 17 pins 173-0939 (20-way) RS To solder the Arduino to the board, if your Micro has no pins fitted. Cut to 17 pins per side.
JST connector, 2.54 mm pitch, board side 10 1516276 Farnell Valve connectors V1–V10.
JST housing, wire side 10 1516264 Farnell One per valve.
JST crimp terminal 20 1516301 Farnell Two per valve.
Pin header for the jumper block, single row, 2.54 mm 7 pins 173-0939 (cut from a 20-way strip) RS One piece of 3 pins (row In) and two of 2 pins (rows 5V and 3V).
Jumper link, 2.54 mm 1 251-8503 RS On the In row, middle and right pins (see Solder the board).
DC input connector, 2 pins, 2.54 mm pitch (optional) 1 — — The two leads of the power source go into the DC input, soldered or through this connector. See Power.
Valves
Solenoid valve, three ports, 4.5 V version 10 32881849871 AliExpress Draws 260 mA at 5 V; about £2 each. Supplied with a two-wire lead.
Printed parts
Valve base 1 — — Holds the ten valves and the board; the waste channel and its 5 mm outlet are built in. STL file, 100 × 189 × 27 mm.
Joiner input pipe 2 per odour — — One for each row of five valves; slots onto port 1 of the valves. Onshape. STL export to follow.
Cradle 1 — — Valves-only version. STL file, 93 × 189 × 33 mm; the same part as the cradle of the optogenetics module. A raised strip at each end has ten 3.2 mm holes, 6.4 mm apart, in line with the tubes; the steel tubes pass through them.
M3 nut and M3 hex socket cap screw 4 + 4 837-262 and 467-9802 (12 mm) or 467-9824 (20 mm) RS 12 mm with stand-offs or a spacer; 20 mm also works.
Plumbing
Silicone tube, 5 mm inner diameter — — — Joins the input pipes (5.5 mm outer diameter at the joints) and fits the 5 mm waste outlet.
T connector 1 — — Breaks one joint of the input pipe to bring in air or odour.
Aquarium air pump, Tetra APS 50 1 — — Up to 50 l/h, with its own flow control; takes 4 mm inner-diameter airline. Feeds the input pipe.
Flow meter 1 — — Sets the flow by hand.
Silicone tube, 1 mm inner × 3 mm outer diameter — — — For the connections to the steel tubes.
Semi-rigid tube, 4 mm outer diameter — — — Fits the push-in fittings of the odour containers.
Steel tube, 2.8 mm outer × 2.2 mm inner diameter, 50 or 100 mm long 10 — AliExpress Carries the air into the end of each glass tube.
Negative-pressure pump for the waste (optional) 1 — — Collects the exhaust better.
Odour container (one per odour)
Wide-mouth jar, 60 ml, polypropylene copolymer, with a 53 mm polypropylene cap 1 2118-0002 Thermo Fisher (Nalgene)
Push-in fitting, straight, 4 mm tube to 1/8 in male thread 2 176-1276 RS Nickel-plated brass.
1/8 NPT brass locknut 2 — JTM Plumbing
Parafilm or grafting tape — B08DVD65DR Amazon UK Example grafting tape.
Power and connection
USB-C socket with two leads 1 1005007148475800 AliExpress Sold in packs of ten as a “USB Type-C waterproof female socket with welding wire”. Its two leads go into the DC input. See Power.
5 V USB charger, rated 3 A, and USB-C cable 1 — — For the USB-C socket. Ten valves draw 260 mA each.
USB cable, micro-USB to USB-A 1 — — From the Arduino to the ethoscope’s Raspberry Pi.
Arena
Arena and glass tubes 1 — — The arena for long 5 mm tubes (ten tubes) or the 20-tube sleep arena: see Plumb the module.
  • Soldering iron and solder
  • Side cutters and wire strippers
  • PA-09 crimping tool, for the JST crimps
  • Filament (FDM) 3D printer
  • Drill with a 3 mm wood bit and an 8 mm bit, and a socket set, for the odour containers
  • A computer with the Arduino IDE or arduino-cli, and a micro-USB cable

The components go on the labelled side of the board. In the steps below, “up” means towards the title lab.gilest.ro - Etho module v1.3 and “down” means towards the end marked USB, where the Arduino’s USB connector points.

Layout of the version 1.3 board: output connectors V1–V5 and M1–M5 on the left with the 6-pin headers M1-5 and V1-5 beside them, M6–M10 and V6–V10 on the right with the 6-pin headers V6-10 and M6-10, arrays IC1 and IC2 to the left of the Arduino Micro and IC3 to its right, the jumper block (rows In, 5V and 3V) and the DC input (GND, Vcc) at the top, to the right of the Arduino, and USB at the bottom

Each output connector has two pads: the upper, square pad is the positive rail (+) and the lower pad is the switched output of its Darlington array (−). The four 6-pin headers repeat the outputs of five connectors each, with the rail on pin 1 (the square pad); they are used only for the LED boards.

  1. Fit a board-side JST connector (Farnell 1516276) in each of the valve positions V1–V10 and solder it from the back. Leave the four 6-pin headers empty, and the motor positions M1–M10 too, unless you build the motors and valves variant.
  2. Fit the three Darlington arrays with their inputs (pins 1–9) facing the Arduino: IC1 and IC2, on the left, with the notch pointing down; IC3, on the right, with the notch pointing up.
  1. Solder the three arrays.

    An earlier version of the board with its connectors and the three Darlington arrays soldered

  2. Fit straight pin headers in the jumper block, to the right of the Arduino: three pins in the row marked In, two in each of the rows marked 5V and 3V. Solder them, then fit one jumper link as described below these steps.

  3. At the DC input, above the jumper block, fit a 2-pin 2.54 mm connector for the power leads, or solder the leads straight into the pads later. Vcc (+) is the right-hand, square pad and GND (−) the left-hand pad.

  4. Check once more the orientation of the arrays, then place the Arduino Micro on its footprint with its USB connector pointing down, towards the USB mark at the bottom edge.

  5. Solder the Arduino directly to the board. A socket would make it removable, but a tall socket does not fit in the case, and a soldered Arduino cannot easily be taken off again.

    An earlier version of the board, finished, with the Arduino Micro soldered in the centre between the arrays

Jumper block. The jumper block chooses the supply of the outputs. Its pins:

Row Left pin Middle pin Right pin
In Arduino VIN DC input (+) outputs’ rail
5V — Arduino 5 V outputs’ rail
3V — Arduino 3.3 V outputs’ rail

The outputs have no supply until a link joins one of the rows to the rail:

Link Effect
In, middle–right The DC input powers the outputs. This is the normal setting for motors, valves and LEDs.
In, left–middle Not used: it would feed the DC input to the Arduino’s VIN, which needs 7–12 V. The Arduino takes its power from the ethoscope’s USB.
5V, middle–right The outputs run from the Arduino’s 5 V, which comes from the ethoscope’s USB port. For small loads only.
3V, middle–right The outputs run from the Arduino’s 3.3 V regulator. For small loads only.

This module uses the In link, middle and right pins: the valves run from the DC input.

The firmware drives each valve connector from one Arduino pin. The motor connectors M1–M10 sit on the odd channels and are unused on the valves-only version.

Connector Firmware channel Arduino pin, board v1.3 Arduino pin, board v1.0 Arduino pin, board v1.1 / v1.11
V1 0 D8 D1 (TX) D0 (RX)
V2 2 D9 D2 D2
V3 4 D10 D4 D4
V4 6 D11 D6 D6
V5 8 D12 D8 D8
V6 10 D1 (TX) D10 D10
V7 12 D0 (RX) D12 D12
V8 14 A5 A0 A0
V9 16 A4 A2 A2
V10 18 A3 A4 A4

The module also works on boards made from the version 1.11 Gerber files or the version 1.0 Gerber files. Set PCBVERSION 11 in the firmware for a v1.1 or v1.11 board and PCBVERSION 10 for a v1.0 board (see Firmware). These boards have the same M and V connectors, with the square pad on the rail, but no 6-pin headers and no jumper block. Their supply is set on a single-row jumper, J1: left open, the DC input powers the outputs; linked 1–2, the DC input powers the outputs and the Arduino; linked 2–3, the outputs run from the Arduino’s 5 V; on version 1.1 and later, linked 2–4, from its 3.3 V.

The J1 settings of the version 1.0 and 1.1 boards: no jumper, external power to the outputs only; jumper 1–2, external power to the outputs and the Arduino; jumper 2–3, 5 V from the Arduino and no external power; on version 1.1 only, jumper 2–4, 3.3 V from the Arduino

  1. Print the valve base at 0.15 mm layer height. It takes about nine hours and needs little or no support.
  2. Print two joiner input pipes for each odour you plan to use.
  3. For the valves-only version, print the cradle.

Print the parts in PLA. PLA softens at the temperatures an incubator reaches when it fails: ethoscopes have deformed when an incubator overheated. PETG resists heat better.

Not yet documented: print settings other than those given on this page.

  1. Crimp a JST terminal (Farnell 1516301) onto each of the two wires of a valve.
  2. Push both terminals into a wire-side housing (Farnell 1516264).
  3. Repeat for all ten valves.

Each valve has three ports. When the valve is off, port 1 connects to port 3; when it is on, port 1 connects to port 2.

A solenoid valve with its ports numbered 1, 2 and 3: off connects port 1 to port 3, on connects port 1 to port 2

  1. Fit the board in the valve base, as in the photograph at the top of this page.

  2. Seat the ten valves in their slots in the valve base, five on each side.

  3. Plug the five valves on one side into V1–V5 and the five on the other side into V6–V10, in slot order, with V1 and V10 at opposite ends of the module.

  4. Slot a joiner input pipe onto port 1 of the five valves on each side.

    Render of the valve base with the joiner input pipe, in blue, under the row of valves; on the motors and valves variant the motor holder sits above

  5. On the valves-only version, fix the cradle on top of the valve base with the M3 nuts and screws: 12 mm screws with stand-offs or a spacer, or 20 mm screws. The variant takes the motor holder instead.

Choose one of two configurations.

Regular configuration: the flies receive a puff only when their valve opens.

  • port 1 → input pipe (air or odour)
  • port 2 → flies
  • port 3 → waste

Continuous flow: the flies always receive a flow, of air when the valve is off and of odour when it is on.

  • port 1 → flies
  • port 2 → odour input
  • port 3 → air input

Continuous flow has two drawbacks. Unless it is collected, the odour leaves the tubes and builds up in the incubator. And the flow must be adjusted by trial, because the flies are sensitive to it and move less when it is too strong.

For the regular configuration:

  1. Join the ends of the two joiner input pipes with 5 mm inner-diameter silicone tube. The joints are 5.5 mm in outer diameter, so the tube stretches tightly over them.

  2. Cut one of the two joints and insert the T connector; this is where air or odour enters.

  3. Connect the T connector to the odour container, or straight to the air supply for puffs of air.

  4. Fit silicone tube to the 5 mm waste outlet of the valve base. The waste channel, shown in blue below, collects the exhaust of all ten valves. A pump applying negative pressure to the outlet collects it better.

    The valve base from above, with the built-in waste channel shown in blue and its single outlet

  5. Connect port 2 of each valve to a steel tube. Pass the steel tube through the hole in line with its fly tube, in the cradle or, on the variant, in the cover with holes, and into the end of the fly tube. The air travels through tubing, so any valve can reach any tube; follow the table for your arena in Set up in the node. On the arena for long 5 mm tubes, V1–V5 feed the odd tubes 1, 3, 5, 7 and 9 and V6–V10 the even tubes 2, 4, 6, 8 and 10. On the 20-tube sleep arena, V1–V5 feed tubes 1, 3, 5, 7 and 9 and V6–V10 tubes 12, 14, 16, 18 and 20, the tubes that the motors of the variant turn.

  6. Set the flow with the flow meter.

Camera view of a 10-tube arena used with the air delivery module, each tube outlined as a region of interest

Use a different pair of joiner pipes for each odour. Joiner pipes can be reused between experiments with the same odour.

  1. With a small wood bit, make two 3 mm pilot holes in the cap of a 60 ml jar, about 12 mm from the centre.
  2. Enlarge each hole with an 8 mm bit, then widen it until a push-in fitting (RS 176-1276) fits.
  3. Push a fitting through each hole and secure it from the inside with a 1/8 NPT locknut, tightened with a socket.
  4. Put the odour in the jar and close the cap.
  5. Wrap a couple of turns of Parafilm or grafting tape round the cap.

Odour jars: a cap fitted with two push-in fittings, a cap with the locknuts seen from inside, and an empty jar

The two fittings are alike: connect either to the air supply and the other to the T connector.

The outputs take their power from the DC input, through the link on the In row of the jumper block (middle and right pins). Connect the power source to the DC input with + to Vcc (the right-hand, square pad) and − to GND.

USB-C. A USB-C socket, with its two leads in the DC input, takes 5 V from a USB charger. A USB-C charger switches its output on only for a device that identifies itself through the socket’s CC pins. If the module gets no power through a USB-C to USB-C cable, use a USB-A charger and a USB-A to USB-C cable. Use a charger rated 3 A: each valve draws 260 mA at 5 V, 2.6 A if all ten are open together.

  1. Link the In row of the jumper block, middle and right pins.
  2. Connect the two leads of the USB-C breakout board to the DC input, + to Vcc and − to GND.
  1. Stand the ethoscope on the module.
  2. Connect the micro-USB cable from the Arduino to a USB port of the ethoscope’s Raspberry Pi. Do not connect any other USB serial device to the same ethoscope.

This variant (firmware MODULE 1) carries the ten valves of the air delivery module and the ten N20 motors of the sleep deprivation module, so that the same flies can be woken by rotating their tube or by a puff. The motor holder sits straight on top of the valve base, in place of the cradle, so that the motors rest against the tubes. It is used with the 20-tube sleep arena only: the motors do not serve the arena for long tubes.

Camera view of a 20-tube arena on the motors-and-valves module

Part Qty Catalogue no. Supplier Notes
Right-angled PCB header, 2 pins 10 251-8654 RS Motor connectors M1–M10.
N20 geared DC motor, 6 V, 200–240 rpm 10 32778906874 AliExpress The 6 V version, run from 4.8–5 V; it draws about 25 mA at 4.8 V.
Two-core ribbon cable 10 lengths — — One lead per motor.
2-way connector for the motor leads 10 251-8171 (solder type) RS Or crimp housings Farnell 2226A-02 with two Farnell 2226TG crimp terminals each.
Motor holder (printed) 1 — — STL file, 93 × 189 × 26 mm.
Cover with holes (printed) 2 — — STL file, 85 × 21 × 28 mm; one for each row of five motors. Ten 3.2 mm holes, 6.5 mm apart, run through it in line with the tubes: the steel tube of each valve passes through the hole in line with its tube.
Motor shaft (printed) 10 — — STL file, 11 mm across and 10 mm tall, with a D-shaped bore for the motor’s output shaft.
Silicone tube, 10 mm inner × 12 mm outer diameter 10 short pieces B01N3YIQ0Y Amazon UK Grip sleeve for each shaft.
Standard sleep arena, rotating version, with twenty 5 mm glass tubes (VWR 201-1005) 1 — — The tubes in the wider slots rotate. Model on Onshape. The fixed version of the arena does not let the tubes rotate.
  1. When soldering the board, also fit a right-angled 2-pin header in each motor position M1–M10, tilted slightly upwards on a fold of paper, and solder them from the back.

  2. Solder a length of two-core ribbon cable, long enough to reach from the motor’s slot in the holder to its connector on the board, to each motor, with the cable leaving at a right angle to the motor body, and fit a 2-way connector to the other end.

  3. Push a printed shaft onto the output shaft of each motor and slide a piece of the 10 mm silicone tube, cut to the 10 mm height of the shaft, over it.

  4. Place the motors in the motor holder, five on each side, lying on their long side, and pass each cable through the hole underneath its slot.

    Five motors in their slots on one side of the holder, cables leaving at a right angle

  5. Plug the motors on one side into M1–M5 and those on the other side into M6–M10, in slot order: the slot under ROI 1, at the end of the arena with the empty black spot, goes to M1, and the slot under ROI 20, at the end by the ethoscope’s I2C power connector, goes to M10.

  6. Fix the motor holder on top of the valve base with the M3 nuts and screws: 12 mm screws with stand-offs or a spacer, or 20 mm screws.

  7. Fit a cover with holes over each row of five motors.

  8. Plumb the valves so that every tube with a motor also gets air: V1–V5 feed the tubes in ROIs 1, 3, 5, 7 and 9, and V6–V10 those in ROIs 12, 14, 16, 18 and 20, the same tubes that M1–M10 turn.

ROI Motor (channel) Valve (channel)
1, 3, 5, 7, 9 M1–M5 (1, 3, 5, 7, 9) V1–V5 (0, 2, 4, 6, 8)
12, 14, 16, 18, 20 M6–M10 (11, 13, 15, 17, 19) V6–V10 (10, 12, 14, 16, 18)
2, 4, 6, 8, 10, 11, 13, 15, 17, 19 — —

The motor connectors use these Arduino pins:

Connector Firmware channel Arduino pin, board v1.3 Arduino pin, board v1.0 Arduino pin, board v1.1 / v1.11
M1 1 D3 D0 (RX) D1 (TX)
M2 3 D4 D3 D3
M3 5 D5 D5 D5
M4 7 D6 D7 D7
M5 9 D7 D9 D9
M6 11 A2 D11 D11
M7 13 A1 D13 D13
M8 15 A0 A1 A1
M9 17 D13 A3 A3
M10 19 D2 A5 A5

Motors and valves both take their power from the DC input, through the same 5 V, 3 A supply.

The firmware is the sketch ethoscope_multimodule.ino in the ethoscope repository, folder accessories/hardware/ethoscope_multimodule/. It needs no external libraries. Use version 1.6 or later, on the dev branch from 29 October 2026: earlier versions do not accept PCBVERSION 14. Flash it from a computer before you mount the module.

  1. Download the folder, for example with:

    Terminal window
    git clone --depth 1 --branch dev https://github.com/gilestrolab/ethoscope.git
    cd ethoscope/accessories/hardware/ethoscope_multimodule
  2. Copy the configuration template:

    Terminal window
    cp versions.h.example versions.h
  3. Open versions.h and set the two values:

    #define PCBVERSION 14 // 14 for a v1.3 board; 11 for v1.1 or v1.11; 10 for v1.0
    #define MODULE 2 // 2 = valves only; 1 = motors and valves
  1. Open ethoscope_multimodule.ino in the Arduino IDE. Keep it in its folder, next to versions.h.
  2. Choose Tools → Board → Arduino AVR Boards → Arduino Micro.
  3. Connect the Arduino with the micro-USB cable and choose its port under Tools → Port.
  4. Click Upload.

From the ethoscope_multimodule folder:

Terminal window
arduino-cli core update-index
arduino-cli core install arduino:avr
arduino-cli board list # find the port, e.g. /dev/ttyACM0
arduino-cli compile --fqbn arduino:avr:micro .
arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:avr:micro .

Open the serial monitor of the Arduino IDE (or any serial terminal) at 115200 baud, with lines ending in a newline, and send:

  1. T: the module reports itself as JSON. For valves only, check for "AGO Odour Arousal Module", "type":2 and "valves":10; for the motors and valves variant, "AGOSD Sleep Deprivation and Odour Arousal Module", "type":1, "motors":10 and "valves":10. The version string reads FW-1.60;HW-14 (HW-11 or HW-10 on an older board).
  2. D: the module switches on every channel in turn, from channel 0 to channel 19, for 500 ms each and 600 ms apart, about 12 seconds in all. On a v1.3 board set to PCBVERSION 14 the order is V1, M1, V2, M2, … V10, M10. Listen for each valve clicking, V1 first and V10 last, 1.2 s apart; in the variant, each motor turns between two valves. This is the wiring check: a valve that clicks out of order is plugged into the wrong connector.
  3. P 0 500: valve V1 opens for 500 ms. P <channel> <ms> drives any single channel; the valve channels are 0, 2, 4, … 18 (see the table in Solder the board).
  4. In the variant only, A 5: all motors turn for 5 s.

H lists the commands. Two limits of the firmware matter for experiments: a duration in P can be at most 32,767 ms, and the module switches outputs in steps of about 50 ms, so shorter or finer timings are rounded up.

If Python and pyserial are installed, the test script in the same folder runs these checks for you:

Terminal window
python test_multimodule.py /dev/ttyACM0

Once the module is on the ethoscope, the node shows the same information under Options → Module Info on the ethoscope’s page; its test button sends D.

  1. Plug the module’s USB cable into the ethoscope and power the module. On the node, open the ethoscope’s page: the module shows as connected.
  2. Check it with Options → Module Info: it should report 10 valves (and 10 motors for the motors + valves variant).
  3. Click Start Tracking. Under Configure Stimulators, click Add Stimulator and set the Trigger and the Stimulus (Valve/odour pulse). Leave the active period empty to stimulate for the whole run, or give it a date range or a daily window.
  4. To change the protocol during a run, add further stimulators with their own active periods. If two periods overlap, the first stimulator in the list wins.
  5. Start the run. If the stimulus does not match the module (for example Motor pulse on an LED-only module), the run does not start and the error names the module and what it drives.
Setting Default What it does
Trigger Inactivity, Activity, Midline crossing or Periodic Inactivity probes arousal of still flies; Periodic puffs at fixed intervals
Minimal inactivity time 120 s Inactivity trigger
Minimum seconds between stimulations 60 s Refractory period after each puff
Stimulus Valve/odour pulse Opens the tube’s valve
Pulse duration 1000 ms How long the valve stays open
Probability the stimulus will be delivered 1.0 Below 1, some decisions are logged but not carried out (sham controls)

With the motors + valves variant, add one stimulator with Motor pulse and one with Valve/odour pulse, each with its own active period.

Which tubes are stimulated. On the arena for long 5 mm tubes all ten tubes are served:

Tube (ROI) 1 2 3 4 5 6 7 8 9 10
Valve connector (channel) V1 (0) V6 (10) V2 (2) V7 (12) V3 (4) V8 (14) V4 (6) V9 (16) V5 (8) V10 (18)

On the 20-tube sleep arena the valves serve the same ten tubes as the motors, so on the motors + valves variant each of these tubes gets both air and rotation. The other ten tubes are unstimulated controls:

Tube (ROI) 1 3 5 7 9 12 14 16 18 20
Valve connector (channel) V1 (0) V2 (2) V3 (4) V4 (6) V5 (8) V6 (10) V7 (12) V8 (14) V9 (16) V10 (18)
Motor connector (channel), variant M1 (1) M2 (3) M3 (5) M4 (7) M5 (9) M6 (11) M7 (13) M8 (15) M9 (17) M10 (19)
Symptom Likely cause Fix
Compiling stops with versions.h: No such file or directory The configuration file was not created Copy versions.h.example to versions.h in the sketch folder and set PCBVERSION and MODULE.
Compiling stops with Invalid MODULE or Invalid PCBVERSION A value outside the accepted ones Use a MODULE from 0 to 4 and a PCBVERSION of 10, 11, 12, 13 or 14.
T answers, but no valve clicks with D No supply on the outputs: no link on the In row of the jumper block, the power source off or flat, or a fault in the DC input wiring Fit the link on the In row (middle and right pins). Check the power source and the DC input: + to Vcc, − to GND.
T answers, but none of the valves served by one array clicks Darlington array fitted the wrong way round or badly soldered Check the orientation (IC1 and IC2 notch down, IC3 notch up) and the solder joints.
P 0 500 does not open V1, or under D the valves click out of order although each is on its own connector PCBVERSION does not match the board On a v1.3 board set PCBVERSION 14, except for the 20-LED module with two LED boards, which takes 12 (or 13). Set 11 for v1.1 or v1.11 and 10 for v1.0, then flash again.
Under D, valves click out of order Valve leads plugged into the wrong connectors Re-plug them so that they click V1 to V10 in slot order. On the left side of the board the labels sit below their connectors, on the right side above.
One valve never clicks Crimp or connector fault, or a faulty valve Send P <channel> 1000 for that valve; re-crimp the lead, or replace the valve.
Valves click weakly or not at all when several open together Supply too weak for the valves Use a 5 V supply rated 3 A.
Flies move less than expected throughout the experiment (continuous flow) Flow too strong Lower the flow until the flies’ activity is normal.
Odour builds up in the incubator Exhaust not collected (continuous flow, or waste outlet left open) Use the regular configuration, and collect the waste through the outlet, ideally with a negative-pressure pump.
Traces of a previous odour Joiner pipes shared between odours Use a separate pair of joiner pipes for each odour.
The node does not detect the module (Add Stimulator stays disabled) USB cable for charging only, or an Arduino clone with a different USB ID Use a data cable. For a clone, find its vendor:product ID (for example with lsusb) and add it to /ethoscope_data/config/modules.json on the ethoscope, e.g. {"micro_clone": {"name": "Arduino Micro clone", "family": "arduino", "model": "micro", "used_for": ["mAGO"], "id": ["1a2b:3c4d"]}} with your ID in place of 1a2b:3c4d.
Commands sometimes go to the wrong device More than one USB serial device on the ethoscope; the software picks one of them arbitrarily Leave only the module connected.
Puffs shorter than about 50 ms are longer than set The firmware switches outputs in steps of about 50 ms Use pulses of 50 ms or more.
The Update Firmware button in Module Info fails Ethoscope software older than 29 October 2026 cannot compile this sketch Update the ethoscope software, or flash from a computer, as in Firmware.