Skip to content

Optomotor module (LEDs + motors)

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.

Renders of the printed parts of the optomotor module: base (90 × 189 × 24 mm), open spacer frame (90 × 189 × 20 mm), motor cover (85 × 21 × 26 mm) and motor cover with a row of holes (85 × 21 × 28 mm)

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

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 right-angled 2-pin header in each of the motor positions M1–M10, pins pointing outwards.

  2. Slip a small fold of paper under the headers so that they tilt slightly upwards, then solder them from the back.

    An earlier version of the bare board with right-angled headers resting on a fold of paper, which holds them at a slight upward angle

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

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

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

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.

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.

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

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

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

    An N20 geared motor with its two-core cable soldered at a right angle to the motor body

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

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

  1. Print the base, or for battery power the base with battery compartments.
  2. Print the spacer. Its project file uses PLA, 0.25 mm layers, 15 % infill, 3 walls and no supports.
  3. Print the motor holder.
  4. Print two covers with holes.
  5. 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.

  1. Fit the board in its support in the base.

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

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

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

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

  6. Fit the two covers with holes over the rows of motors.

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

  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; or, on the base with battery compartments, wire the battery pack to it as below.

To run the module from batteries:

  1. 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.
  2. Wire the battery pack to the DC input: the positive end to Vcc, the negative end to GND.
  3. Insert four charged NiMH AA cells, two in each compartment.
  1. 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.
  2. Load the arena, with each tube that should rotate in a wider slot, against the silicone sleeve of its shaft.
  3. 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.

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 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
  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. Check for "mAGOLED Motor and Optogenetic LED Module", "type":3, "motors":10, "leds":10, and 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. 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.
  3. 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.
  4. W 0 100 900 10: LED 1 gives 10 pulses of 100 ms on and 900 ms off.
  5. 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.
  6. 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 in W and X, 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.

  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 motors and 10 LEDs.
  3. 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.
  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.

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