Optomotor module (LEDs + motors)
What it does
Section titled “What it does”The optomotor module combines mechanical and optogenetic stimulation of the same flies. Ten tubes of the arena each have an N20 geared motor that rotates the tube and an LED that lights it, so the ethoscope can wake a fly, light it, or both. The LEDs are switched on and off as single pulses or as pulse trains; their brightness is fixed by resistors, not by the firmware. The firmware is designed for red light at 620–630 nm, for example to activate CsChrimson. The module uses the same board as the sleep deprivation module, with the firmware set to MODULE 3: the motors plug into connectors M1–M10, and the ten LEDs sit on one LED board, cabled to the board’s V1-5 and V6-10 headers, with an optical fibre from each LED to its tube.
It is a new design (2026). This build has not yet been assembled in the lab, so the D check in Check the module is the proof that it is wired correctly.

What you need
Section titled “What you need”| 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. |
| Right-angled PCB header, 2 pins | 10 | 251-8654 | RS | Motor connectors M1–M10. |
| Pin header, single row, 2.54 mm, 6 pins | 4 | 173-0939 (cut from a 20-way strip) | RS | Two for the V1-5 and V6-10 headers of the module board, two for J1 and J2 of the LED board. |
| 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. |
| LED board | ||||
| LED board, version 1.1 (PCB) | 1 | — | any PCB maker | Board files, v1.1 (zip): Gerber files, the design source (.fzz) and front and back renders. 82 × 22 mm, two layers, for ten 5 mm LEDs. |
| Red LED, 5 mm, 624 nm, 15° beam | 10 | 904-7367 (Cree C503B-RAN-CA0B0AA1) | RS | Ten per LED board. Alternative: Multicomp MCL053MD, Farnell 1581137. |
| Resistor array, 100 Ω, 6-pin SIP, bussed (pin 1 common, five resistors) | 2 | 522-3466 (Bourns 4606X-101-101LF) | RS | Two per LED board, in J3 and J4; they set the current of each LED. |
| 6-way lead, 2.54 mm, female at both ends, straight (pin 1 to pin 1) | 2 | — | — | Two per LED board, long enough to reach it from the 6-pin headers of the module board. |
| Light path | ||||
| Fibre adapter for 5 mm LEDs, VCC THR_5_22 | 10 | — | Mouser | Clips onto an LED and holds the end of its fibre. Also Digi-Key THR_5_22-ND. |
| Flexible light pipe (optical fibre), VCC FLX_08 | 10 | 890-5782 | RS | One from each LED to its tube: 203 mm long, a 1.5 mm core in a 2.2 mm jacket, with a lens mount at the far end. Bend it no tighter than 40 mm radius. RS no longer stocks it: order the VCC part elsewhere. |
| Motors | ||||
| 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. |
| Silicone tube, 10 mm inner × 12 mm outer diameter | 10 short pieces | B01N3YIQ0Y | Amazon UK | Grip sleeve for each motor shaft. |
| Case | ||||
| Base (printed) | 1 | — | — | STL file, 90 × 189 × 24 mm, open at both ends, with slots for the LED board; no battery compartments. |
| Base with battery compartments (printed), alternative | 1 | — | — | For battery power, instead of the base above. STL file, 90 × 189 × 24 mm; the same part as the base of the sleep deprivation module. Its ends are closed, so the LED board stands in the spacer. |
| Spacer (printed) | 1 | — | — | STL file, an open frame 90 × 189 × 20 mm, with the same slots for the LED board; it fits either base. A Bambu Studio project holds its print settings. |
| 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: a fibre passes through each hole to the end of 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. |
| 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. |
| 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 and USB-C cable | 1 | — | — | For the USB-C socket. |
| USB cable, micro-USB to USB-A | 1 | — | — | From the Arduino to the ethoscope’s Raspberry Pi. |
| Battery power (optional) | ||||
| NiMH AA cell | 4 | 476-2033 (2300 mAh) or 611-8674 (1700 mAh) | RS | The other power source: four in series, 4.8 V. |
| AA battery contacts, single | 4 | B07HRSB12M | Amazon UK | Two at one end of each battery compartment. |
| AA battery contacts, double | 2 | B07HRV1DMT | Amazon UK | One at the other end of each compartment, joining its two cells. |
| 4.8 V NiMH charger with USB input | 1 | B07QTFY7JZ | Amazon UK | Example model. |
| Arena | ||||
| 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. |
- Soldering iron and solder
- Side cutters and wire strippers
- PA-09 crimping tool, if you use crimp housings for the motor leads
- 2.5 mm hex key for the M3 screws
- Filament (FDM) 3D printer
- A computer with the Arduino IDE or
arduino-cli, and a micro-USB cable
Solder the board
Section titled “Solder the board”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.

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.
-
Fit a right-angled 2-pin header in each of the motor positions M1–M10, pins pointing outwards.
-
Slip a small fold of paper under the headers so that they tilt slightly upwards, then solder them from the back.

-
Fit a straight 6-pin header in each of the positions V1-5 and V6-10 and solder them from the back. Leave the 2-pin positions V1–V10 and the 6-pin positions M1-5 and M6-10 empty.
-
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.
-
Solder the three arrays.

-
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.
-
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.
-
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.
-
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.

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: motors and LEDs run from the DC input.
Each motor connector Mk and the output Vk serve the same tube. The firmware drives them from these Arduino pins:
| Output | Firmware channel | Drives | Arduino pin, board v1.3 | Arduino pin, board v1.0 | Arduino pin, board v1.1 / v1.11 |
|---|---|---|---|---|---|
| V1 | 0 | LED | D8 | D1 (TX) | D0 (RX) |
| M1 | 1 | motor | D3 | D0 (RX) | D1 (TX) |
| V2 | 2 | LED | D9 | D2 | D2 |
| M2 | 3 | motor | D4 | D3 | D3 |
| V3 | 4 | LED | D10 | D4 | D4 |
| M3 | 5 | motor | D5 | D5 | D5 |
| V4 | 6 | LED | D11 | D6 | D6 |
| M4 | 7 | motor | D6 | D7 | D7 |
| V5 | 8 | LED | D12 | D8 | D8 |
| M5 | 9 | motor | D7 | D9 | D9 |
| V6 | 10 | LED | D1 (TX) | D10 | D10 |
| M6 | 11 | motor | A2 | D11 | D11 |
| V7 | 12 | LED | D0 (RX) | D12 | D12 |
| M7 | 13 | motor | A1 | D13 | D13 |
| V8 | 14 | LED | A5 | A0 | A0 |
| M8 | 15 | motor | A0 | A1 | A1 |
| V9 | 16 | LED | A4 | A2 | A2 |
| M9 | 17 | motor | D13 | A3 | A3 |
| V10 | 18 | LED | A3 | A4 | A4 |
| M10 | 19 | motor | D2 | A5 | A5 |
Older boards
Section titled “Older boards”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.

These boards have no 6-pin headers for the LED board. Wire each LED instead on its own two-wire lead, with a series resistor, to the V connector of its tube (the LED of the tube turned by Mk on Vk), with the anode on the square pad.
Build the LED board
Section titled “Build the LED board”An LED board carries ten LEDs in a zigzag, LED 1 at the left end and LED 10 at the right, and four 6-pin positions with no printed names: J1 and J2 along the top edge (J1 on the left), J3 at the left end and J4 at the right end. J1 and J2 take the leads from the module board, J3 and J4 the resistor arrays. Pin 1 of each is the square pad.
- Fit the ten LEDs with the long leg (anode) in the square pad and the flat side of the LED towards the top edge, as on the outline printed on the board, and solder them.
- Fit a resistor array in J3 and another in J4, with pin 1 (marked with a dot) in the square pad at the top end, and solder them.
- Fit a straight 6-pin header in J1 and another in J2, and solder them.
The resistor arrays set the current of each LED: R = (supply voltage − 2.1 V across the LED − about 0.7 V across the Darlington array) / LED current. The 100 Ω arrays on a 5 V supply give each LED about 20 mA, within the 10–30 mA that Cree recommends for this LED.
Not yet documented: the irradiance at the fly.
Connect the LED board to the module board with two straight 6-way leads, pin 1 (square pad) to pin 1: J1 to the V1-5 header and J2 to the V6-10 header. On the module board the V6-10 header has pin 1 (the rail) at the bottom, so its pins 2–6 carry V10, V9, V8, V7 and V6.
Run an optical fibre from each LED to its tube:
| LED on the LED board | 1 | 3 | 5 | 7 | 9 | 10 | 8 | 6 | 4 | 2 |
|---|---|---|---|---|---|---|---|---|---|---|
| Output | V1 | V2 | V3 | V4 | V5 | V6 | V7 | V8 | V9 | V10 |
| Tube (ROI) | 1 | 3 | 5 | 7 | 9 | 12 | 14 | 16 | 18 | 20 |
Each of these tubes then has its LED on output Vk and its motor on connector Mk.
Prepare the motors
Section titled “Prepare the motors”-
Cut a length of two-core ribbon cable for each motor, long enough to reach from the motor’s slot in the holder to its connector on the board, with some slack.
-
Solder one end to the two terminals of a motor, with the cable leaving at a right angle to the motor body, so that the joint does not take the strain.

-
Fit a 2-way connector to the other end: solder it (RS 251-8171), or crimp a 2226TG terminal onto each wire and push both into a 2226A-02 housing.
-
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.
Print the case
Section titled “Print the case”- Print the base, or for battery power the base with battery compartments.
- Print the spacer. Its project file uses PLA, 0.25 mm layers, 15 % infill, 3 walls and no supports.
- Print the motor holder.
- Print two covers with holes.
- Print ten motor shafts.
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.
Assemble the module
Section titled “Assemble the module”-
Fit the board in its support in the base.
-
Stand the LED board upright in the slots at one end of the base, with its LEDs facing outwards, and cable it to the module board, as in Build the LED board. On the base with battery compartments, whose ends are closed, fit the spacer first and use its slots.
-
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.

-
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. Run the motor cables above the LED board.
-
Stack the base, the spacer and the motor holder, and fix them with the four M3 nuts and screws: 12 mm screws with stand-offs or a spacer, or 20 mm screws.
-
Fit the two covers with holes over the rows of motors.
-
Run each fibre from its LED to the hole of the cover in line with its tube, following the table in Build the LED board and bending it no tighter than 40 mm radius.
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. Two power sources fit:
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.
Batteries. The NiMH pack of the battery base, four AA cells in series (4.8 V), is wired to the DC input. Recharge the cells with a 4.8 V NiMH charger.
- Link the In row of the jumper block, middle and right pins.
- Connect the two leads of the USB-C breakout board to the DC input, + to Vcc and − to GND; or, on the base with battery compartments, wire the battery pack to it as below.
To run the module from batteries:
- In each battery compartment of the base, fit two single contacts at one end and a double contact at the other, so that its two cells connect in series. Join the two compartments in series with a wire: four cells, 4.8 V.
- Wire the battery pack to the DC input: the positive end to Vcc, the negative end to GND.
- Insert four charged NiMH AA cells, two in each compartment.
Mount the module on the ethoscope
Section titled “Mount the module on the ethoscope”- Stand the ethoscope on the module, with tube 1 of the arena at the end with the empty black spot and the ethoscope’s I2C power connector next to ROI 20.
- Load the arena, with each tube that should rotate in a wider slot, against the silicone sleeve of its shaft.
- 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.
Firmware
Section titled “Firmware”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.
Get the sketch and set it up
Section titled “Get the sketch and set it up”-
Download the folder, for example with:
Terminal window git clone --depth 1 --branch dev https://github.com/gilestrolab/ethoscope.gitcd ethoscope/accessories/hardware/ethoscope_multimodule -
Copy the configuration template:
Terminal window cp versions.h.example versions.h -
Open
versions.hand set the two values for this module:#define PCBVERSION 14 // 14 for a v1.3 board; 11 for v1.1 or v1.11; 10 for v1.0#define MODULE 3 // 3 = motors and LEDs
Flash with the Arduino IDE
Section titled “Flash with the Arduino IDE”- Open
ethoscope_multimodule.inoin the Arduino IDE. Keep it in its folder, next toversions.h. - Choose Tools → Board → Arduino AVR Boards → Arduino Micro.
- Connect the Arduino with the micro-USB cable and choose its port under Tools → Port.
- Click Upload.
Flash with arduino-cli
Section titled “Flash with arduino-cli”From the ethoscope_multimodule folder:
arduino-cli core update-indexarduino-cli core install arduino:avrarduino-cli board list # find the port, e.g. /dev/ttyACM0arduino-cli compile --fqbn arduino:avr:micro .arduino-cli upload -p /dev/ttyACM0 --fqbn arduino:avr:micro .Check the module
Section titled “Check the module”Open the serial monitor of the Arduino IDE (or any serial terminal) at 115200 baud, with lines ending in a newline, and send:
T: the module reports itself as JSON. Check for"mAGOLED Motor and Optogenetic LED Module","type":3,"motors":10,"leds":10, andFW-1.60;HW-14(HW-11orHW-10on an older board).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 toPCBVERSION 14the order is V1, M1, V2, M2, … V10, M10. For each of the tubes 1, 3, 5, 7, 9, 12, 14, 16, 18 and 20 in turn, its LED lights and then its motor turns. On the LED board itself the LEDs light in the order 1, 3, 5, 7, 9, 10, 8, 6, 4, 2. This is the wiring check: an LED or a motor that works out of turn is cabled, fibred or plugged wrongly.P 0 1000: LED 1, the LED of tube 1, lights for 1 s.P 1 750: the motor on M1 turns for 750 ms. The LED channels are 0, 2, … 18 and the motor channels 1, 3, … 19.W 0 100 900 10: LED 1 gives 10 pulses of 100 ms on and 900 ms off.B 3: all LEDs on for 3 s.X 100 900 10: all LEDs give 10 pulses of 100 ms on and 900 ms off.A 5: all motors turn for 5 s.
H lists the commands. Three limits of the firmware matter for experiments:
- a duration in
P, and each on or off time inWandX, can be at most 32,767 ms; - the module switches outputs in steps of about 50 ms, so on and off times shorter than about 50 ms are rounded up, and pulse trains faster than about 10 Hz are not possible;
- the LEDs are either on or off: there is no dimming, and an intensity value sent by the software is ignored.
Pulse trains are useful when continuous light could cause depolarisation block.
If Python and pyserial are installed, python test_multimodule.py /dev/ttyACM0 in the same folder runs these checks, and --identify turns the motors one at a time.
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.
Set up in the node
Section titled “Set up in the node”- 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.
- Check it with Options → Module Info: it should report 10 motors and 10 LEDs.
- Click Start Tracking. Under Configure Stimulators, click Add Stimulator and set the Trigger and the Stimulus (Motor pulse, LED pulse or LED pulse train). Leave the active period empty to stimulate for the whole run, or give it a date range or a daily window.
- 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.
- 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.
A stimulator drives either the motors or the LEDs. To use both in one experiment, add two stimulators with different active periods (for example LED stimulation by day and sleep deprivation by night).
| Setting | Default | What it does |
|---|---|---|
| Trigger | Inactivity (sleep deprivation) | Acts when the fly has been still for the set time |
| Minimal inactivity time | 120 s | How long the fly must be still before it is stimulated |
| Velocity correction coefficient | 0.003 | Movement threshold; below it the fly counts as still |
| Minimum seconds between stimulations | 60 s | Refractory period after each stimulus |
| Probability the stimulus will be delivered | 1.0 | Below 1, some decisions are logged but not carried out (sham controls) |
| Stimulus | Motor pulse, LED pulse or LED pulse train | |
| Pulse duration | 1000 ms | Motor pulse and LED pulse |
| LED ON duration per cycle | 100 ms | LED pulse train |
| LED OFF duration per cycle | 100 ms | LED pulse train |
| Number of ON/OFF cycles | 5 | LED pulse train |
The firmware switches outputs in steps of about 50 ms, so ON and OFF times shorter than that, or trains faster than about 10 Hz, are not reproduced.
Which tubes are stimulated. Motor and LED serve the same ten tubes of the 20-tube arena; the other ten tubes are unstimulated controls:
| Tube (ROI) | 1 | 3 | 5 | 7 | 9 | 12 | 14 | 16 | 18 | 20 |
|---|---|---|---|---|---|---|---|---|---|---|
| Motor connector (channel) | M1 (1) | M2 (3) | M3 (5) | M4 (7) | M5 (9) | M6 (11) | M7 (13) | M8 (15) | M9 (17) | M10 (19) |
| LED output (channel) | V1 (0) | V2 (2) | V3 (4) | V4 (6) | V5 (8) | V6 (10) | V7 (12) | V8 (14) | V9 (16) | V10 (18) |
| LED on the LED board | 1 | 3 | 5 | 7 | 9 | 10 | 8 | 6 | 4 | 2 |
Troubleshooting
Section titled “Troubleshooting”| 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 nothing lights or turns 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 outputs served by one Darlington array works |
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. |
| Five LEDs of one board stay dark (1, 3, 5, 7, 9 or 2, 4, 6, 8, 10) | Their lead is missing, turned round or on the wrong header, or their resistor array is missing or reversed | The J1 lead and the array in J3 serve LEDs 1, 3, 5, 7 and 9; the J2 lead and the array in J4 serve LEDs 2, 4, 6, 8 and 10. Check that the lead is straight (pin 1 to pin 1) and on the right header, and that pin 1 of the array is in the square pad. |
| One LED stays dark while the others light | LED fitted the wrong way round, a bad joint, or a failed LED | Check that its long leg is in the square pad; check the joints; replace the LED. |
| The LEDs are too dim or too bright | Resistor arrays not matched to the supply | Fit arrays of another value: about (supply voltage − 3 V) / LED current. |
T reports "leds":0 or "motors":0 |
Wrong MODULE value |
Set MODULE 3 and flash again. |
P 0 1000 does not light LED 1, or P 1 750 does not turn M1 |
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, an LED lights the wrong tube or a motor turns out of order |
Fibres crossed, LED leads on the wrong headers, or motors plugged into the wrong connectors | Follow the fibre table in Build the LED board, with J1 on V1-5 and J2 on V6-10, and re-plug the motors M1 to M10 in slot order. On the left side of the board the labels sit below their connectors, on the right side above. |
| Pulse trains with short on or off times run slower than set | The firmware switches outputs in steps of about 50 ms | Use on and off times of 50 ms or more. |
| Flies see light when no LED is on | The Arduino’s own LEDs shine inside the module | Mask the LEDs on the Arduino with opaque tape once the module has been tested. |
| A motor turns but its tube does not | Tube in a narrow (fixed) slot, or the fixed version of the arena | Use the rotating version of the arena, with the tube in a wider slot against the silicone sleeve. |
| 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": ["opto_LED"], "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. |
| 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. |
| ::: | ||
| ::: |