
SeaTalk1
dotnet/iot
This repo includes .NET Core implementations for various IoT boards, chips, displays and PCBs.

A complete project to enable direct software control over the waste tray position of Tecan's Te-Chrom microchromatography module
Tecan tray is an open-source printed circuit board by niaid, from the niaid/techrom-tray repository on GitHub. It is a 2-layer board of 30 × 70 mm with 24 parts on 38 nets, routed with 79 tracks and 0 vias.
Its parts include 8 connectors, 5 resistors, 2 capacitors, 1 diode and 1 transistor. It belongs with the AVR (ATmega, ATtiny) boards of this library.
Primary authors: Elihu Ihms and Nathan Jones Organizational contact: Elihu Ihms (elihu.ihms AT nih.gov) Date of release: August 10, 2026 Version: 1.0 License details: See LICENSE file
Description: This repository contains firmware, hardware files, and host-side control tools for automating insertion and retraction of the waste tray on a Te-Chrom microchromatography module. The Te-Chrom is an optional module sold by Tecan for use with Tecan EVO and Fluent automated liquid handlers.
The automator is built around an Arduino Nano-compatible controller, a FS90R continuous-rotation servo, and 3D-printed housing parts. Commands can be sent over USB from the included browser UI, the Python command-line script, the Arduino IDE Serial Monitor, EVOWare, FluentControl, or any other program that can write single-byte serial commands.
| Path | Contents |
|---|---|
README.md | Project documentation |
techrom_tray.ino | Arduino firmware for the tray controller |
techrom_tray.html | Browser-based Web Serial control panel |
techrom_tray.py | Python serial-control CLI for automation software integration |
kicad/ | KiCad schematics and PCB design files |
pcb/ | PCB Gerbers, bill of materials, and reference files |
stl/ | Fusion 360 design files and STL models for the housing and moving parts |
nano/ | Arduino Nano reference diagrams and pinouts |
The automator consists of inexpensive, off-the-shelf components attached to a Te-Chrom microchromatography module without permanently modifying the instrument. Several 3D-printed parts provide the mechanical interface:
Custom PCB Gerber files are provided in pcb/ and can be submitted to a PCB manufacturer for economical fabrication in small batches. The use of through-hole components makes manual assembly straightforward. A bill of materials for the electrical components is provided in pcb/bom.csv.
Limit switches and status LEDs can be wired with standard jumper wires or female DuPont-style connectors. Refer to the PCB reference image at pcb/reference.png when wiring switch and LED headers. Male and female pin headers can be bought in exact lengths or cut down from longer strips.
The plastic parts for mounting the custom PCB and microswitches were printed in PLA with a 0.4 mm nozzle diameter on a Prusa 3D FDM printer. Default PrusaSlicer settings were used for slicing.
Inserts were not found to be necessary, and M3 stainless screws should be used to assemble the parts. A photograph of a fully assembled automator attached to a Te-Chrom can be found in stl/automator.jpg.
The pinion that drives the waste-tray rack incorporates a friction clutch. The clutch helps prevent damage to the servo or Te-Chrom if a hardware or software error causes the servo to continue running against an obstruction. Small variations in FDM printing may require adjustment of the clutch friction. The clutch must provide enough friction to move the waste tray reliably without slipping while still allowing the gear to freewheel if an obstruction is encountered.
Three separate friction values for the clutch are provided: stl/clutch_15.stl, stl/clutch_25.stl, and stl/clutch_35.stl. Selecting the appropriate friction value is largely a matter of judgment. The clutch is splined to match the 29-point spline pattern of the FS90R and should be secured using the 1.5 mm screw supplied with the servo's control-horn kit. Should additional friction values be necessary, the public OnShape model for the clutch and gear exposes a parametric clutchDrag variable that can be incremented or decremented as necessary.
The provided techrom_tray.ino sketch uses the standard Arduino Servo library and no additional third-party libraries. It can be opened, compiled, and uploaded using the Arduino IDE.
The microcontroller can be flashed either before or after it is installed in the PCB.
Remove the
D5 LOCK/DTRjumper before flashing when the microcontroller is installed in the custom PCB.
| Constant | Value | Meaning |
|---|---|---|
SERIAL_BAUD | 9600 | USB serial baud rate |
LOOP_DELAY | 5 ms | Delay at the end of each main loop iteration |
SERVO_SPEED | 50 | Servo write offset from neutral during movement |
SERVO_STOP | 90 | Default neutral/stop value for Servo.write() |
SERVO_TIMEOUT | 8,000 ms | Maximum time the servo may run for one movement command |
See the Nano's pinout diagram for a comprehensive list of all pin capabilities. The following GPIO pins are used in the automator:
| Arduino pin | Sketch name | Direction/mode | Function |
|---|---|---|---|
D5 | SERVO_PWM_PIN | PWM | Servo control signal |
D6 | SERVO_ENABLE_PIN | Output | Enables servo drive while moving; LOW when stopped |
D2 | OUT_LIMIT_PIN | INPUT_PULLUP | Out/retracted limit switch, active LOW |
D3 | IN_LIMIT_PIN | INPUT_PULLUP | In/inserted limit switch, active LOW |
D8 | OUT_LED_PIN | Output | Out/retracted status LED |
D9 | IN_LED_PIN | Output | In/inserted status LED |
D10 | M_LED_PIN | Output | Moving/error status LED |
The limit switches use internal pullups and are active LOW.
| OUT switch | IN switch | Interpreted state |
|---|---|---|
| LOW | HIGH | Tray is out/retracted |
| HIGH | LOW | Tray is in/inserted |
| LOW | LOW | Error: both limit switches are active |
| HIGH | HIGH | Start/unknown position |
At startup, the firmware reads both limit switches and initializes the tray state from those inputs.
During normal operation, the automator responds to single-character commands by emitting a single-character state value followed by a newline.
| Command | Firmware action | Response |
|---|---|---|
I | Move tray in/insert | Prints I when the in limit switch is reached; prints E if an error occurs; prints I immediately if already in. |
O | Move tray out/retract | Prints O when the out limit switch is reached; prints E if an error occurs; prints O immediately if already out. |
P | Query current tray state | Prints one of S, o, O, i, I, or E |
E | Clear error state only; do not move | Re-reads the switches and prints the resulting state. |
+ | Increment the servo neutral/stop value by 1 | Prints the new neutral value. |
- | Decrement the servo neutral/stop value by 1 | Prints the new neutral value. |
? | Read the current servo neutral/stop value | Prints the current neutral value. |
| Any other character | No action | Prints ? |
Movement commands do not print an immediate moving response when motion starts. They print only after the destination limit switch is reached, the tray is already at the requested limit, or when an error occurs. If you query with P while the servo is actively running, the state will be i or o.
For the FS90R continuous-rotation servo, small deviations from the 1.5 ms pulse-width signal can cause asymmetric rotational speeds or drift at the default neutral setting. The preferred fix is to adjust the small potentiometer on the servo itself. Alternatively, use firmware + and - trim commands carefully and in small increments.
Emitted state characters:
| State | Meaning |
|---|---|
S | Start/unknown position |
o | Moving out |
O | Parked out/retracted |
i | Moving in |
I | Parked in/inserted |
E | Error state |
The firmware enters an error state when:
SERVO_TIMEOUT, currently 8,000 ms.When an error occurs, the servo is stopped and disabled.
| Condition | Out LED | In LED | Moving LED |
|---|---|---|---|
| Tray out | ON | OFF | OFF |
| Tray in | OFF | ON | OFF |
| Tray moving | OFF | OFF | ON |
| Both limit switches active | ON | ON | OFF |
| Movement timeout error | ON | ON | ON |
| Start/unknown | OFF | OFF | OFF |
Send E to clear an error after resolving the mechanical or switch problem. If the underlying switch condition still indicates an error, the device will immediately return to an error state.
The automator can be controlled using the Arduino IDE Serial Monitor, a serial-terminal application, or any other program capable of opening and writing to a serial port. The included web app and Python script use the same command and response protocol. EVOWare and FluentControl can control the automator and receive status values by invoking the included Python script with the Start Application command or by using VBA.
| Setting | Value |
|---|---|
| Baud | 9600 |
| Data bits | 8 |
| Parity | none |
| Stop bits | 1 |
| Command format | One ASCII character |
| Response format | ASCII response ending in newline |
techrom_tray.htmltechrom_tray.html is a self-contained HTML application that uses Chrome's Web Serial API and is intended for troubleshooting. It provides buttons for:
The current web application does not include a disconnect button or servo-trim controls. Refresh the page if you need to reconnect, pick a different port, or recover from a browser-side serial state problem.
techrom_tray.pyThe Python script lets automation software issue commands to the automator and inspect stdout, stderr, or exit codes. It requires pyserial, which is not part of the Python standard library.
Usage:
python techrom_tray.py [-h] [-O | -I | -P | -o OFFSET | --reset | --debug CHAR | --detect] [COM[n]|/dev/ttyUSB0|AUTO]
| Argument | Meaning |
|---|---|
comport | Serial port to use; defaults to COM3; use AUTO to probe likely serial ports |
-I, --in | Move tray in/insert |
-O, --out | Move tray out/retract |
-P, --position | Query tray position/error status |
-o OFFSET, --offset OFFSET | Set servo neutral offset from 90; accepted range -10 to 10 |
--reset | Clear tray error status without moving |
--debug CHAR | Send one raw ASCII test character and print the raw response |
--detect | Probe likely serial ports, print the first matching port, and exit |
The action arguments are mutually exclusive; run one tray command per script invocation.
Detect a connected tray controller:
python techrom_tray.py --detectUse an automatically detected port:
python techrom_tray.py AUTO --position
python techrom_tray.py AUTO --in
python techrom_tray.py AUTO --outUse an explicit Windows port:
python techrom_tray.py COM5 --position
python techrom_tray.py COM5 --in
python techrom_tray.py COM5 --out
python techrom_tray.py COM5 --reset
python techrom_tray.py COM5 --offset 2
python techrom_tray.py COM5 --debug PUse an explicit Linux port:
python techrom_tray.py /dev/ttyUSB0 --position
python techrom_tray.py /dev/ttyACM0 --outThe script prints human-readable status messages to stdout.
$ python techrom_tray.py COM5 --position
In
$ python techrom_tray.py COM5 --out
Tray is OUT.
$ python techrom_tray.py COM5 --reset
Tray at start position.
$ python techrom_tray.py COM5 --offset 2
Servo neutral value is now 92 (offset +2 from 90).In addition to printing human-readable messages to stdout, the script itself returns meaningful exit codes so that automation software such as FluentControl's Start Application command can detect the result without needing to parse messages.
General exit codes:
| Exit code | Meaning |
|---|---|
0 | Success |
1 | Generic failure, unparseable response, unexpected servo trim response, or final fallback failure |
2 | Failure to connect to serial port, failure to autodetect a port, or missing pyserial |
3 | Failure to write to serial port |
4 | Failure to read a response before timeout, or failure while waiting for serial data |
5 | Failure to close serial port |
6 | Failure to decode response as ASCII |
7 | Tray is in error state when using --position |
21 | Negative acknowledge: movement blocked by error state, unknown response, or unexpected tray response |
24 | --reset was sent, but the device still reported error state |
When --position receives a recognized non-error tray state, the script prints the state and exits with the ASCII code for the returned state character.
| Response | Printed text | Exit code |
|---|---|---|
S | Start | 83 |
i | Moving In | 105 |
I | In | 73 |
o | Moving Out | 111 |
O | Out | 79 |
E | Error printed to stderr | 7 |
Movement commands exit 0 when the expected final state is reached: --in expects I, and --out expects O. If the device reports E, movement exits 21. If another known tray state is returned unexpectedly, the script prints that state to stderr and exits with the ASCII code for that state.
--reset exits 0 if the device reports any known non-error state after reset. It exits 24 if the device still reports E.
--offset exits 0 when the requested neutral offset has been reached. It exits 1 if the device reports an unparseable or unexpected servo neutral value.
All power for the Arduino and servo is supplied through the USB connection on the Nano, with commands sent over the same USB serial connection. Although a large capacitor helps suppress voltage drops caused by servo inrush current, the automator should be connected to a USB host capable of supplying at least 500 mA. Insufficient current may cause voltage transients that reset the microcontroller.
When first connected, the Arduino Nano power LED should illuminate.
Normal operation:
P, the web UI Query Position button, or python techrom_tray.py <PORT> --position.I to insert the tray or O to retract it.I or O means the requested limit switch was reached.E, inspect the tray motion path and limit switches, fix the cause, then clear the error with E or --reset.Hard reset options:
A hard reset clears RAM-only trim values and reinitializes state from the current limit-switch readings.
The Arduino sketch stores servo neutral trim values in RAM. The value is initialized to 90 after a reset, and the script treats offsets as relative to that value. For example, --offset 2 drives the firmware neutral value to 92, while --offset -3 drives it to 87.
Because the Arduino normally resets when a serial port opens, the D5 LOCK/DTR jumper on the PCB is important if you need trim values to survive repeated host-side serial connections, which is likely. Although the Python script keeps the port open during a single --offset operation, the current firmware does not persist the trim value across an Arduino reset or power loss, regardless of whether the D5 LOCK/DTR jumper is installed.
Check Device Manager on Windows or the equivalent serial-device list on your operating system. Arduino Nano clones commonly appear as Arduino Nano, USB-SERIAL CH340, or a similar USB serial adapter. If the port does not appear, install or update the driver for the USB-to-serial adapter used by your board.
The PCB includes a D5 LOCK/DTR jumper. When installed, it holds the DTR line low to reduce automatic resets when the serial port opens. Remove this jumper before flashing the Arduino in the custom PCB.
The browser UI and Python script both wait 2 seconds after opening the serial port to allow an Arduino reset/settle cycle to complete.
The firmware allows only 8,000 ms of servo motion per command. If the tray does not reach the target limit switch in that time, the firmware stops the servo and enters error state. Check for mechanical binding, reversed servo direction, disconnected switches, incorrect switch wiring, or insufficient servo power.
The browser UI and Python script wait up to 12,000 ms for a newline-terminated response.
Both switches active LOW at the same time is treated as an error. Check switch placement, wiring shorts, and whether both switches are being pressed mechanically.
A timeout usually means the Arduino did not send a response, the wrong serial port was selected, the firmware is not running, the serial protocol does not match, or the tray failed to reach a limit switch.
Check that the port is correct, the firmware is flashed, the Arduino has finished resetting after the port opens, and the serial protocol matches this README. The current Python script sends P for tray position, I for in, O for out, and E for reset.
First adjust the physical trim potentiometer on the continuous-rotation servo. If small firmware trim changes are still needed, use +, -, and ? over serial or use the Python --offset command. Remember that the current sketch does not save the trim value across reset or power loss.
It is the sincere hope of the VRC Data Science and Automation team that this addition improves the reliability and versatility of your Te-Chrom. If you publish data generated with the help of this device, please let the maintainer know; acknowledgments are appreciated.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 3 | 500 Ω | Resistor_THT:R_Axial_DIN0204_L3.6mm_D1.6mm_P7.62mm_Horizontal | R3, R4, R5 |
| 1 | 10 kΩ | Resistor_THT:R_Axial_DIN0204_L3.6mm_D1.6mm_P7.62mm_Horizontal | R2 |
| 1 | 10uF_16V | Capacitor_THT:CP_Radial_D5.0mm_P2.50mm | C2 |
| 1 | 1N5817 | Diode_THT:D_A-405_P7.62mm_Horizontal | D1 |
| 1 | 250 Ω | Resistor_THT:R_Axial_DIN0204_L3.6mm_D1.6mm_P7.62mm_Horizontal | R1 |
| 1 | 2N7000 | Package_TO_SOT_THT:TO-92_Inline_Wide | Q1 |
| 1 | 470uF_16V | Capacitor_THT:CP_Radial_D10.0mm_P5.00mm | C1 |
| 1 | Arduino_Nano_v3.x | Module:Arduino_Nano | A1 |
| 1 | ICSP | Connector_PinSocket_2.54mm:PinSocket_2x03_P2.54mm_Vertical | J4 |
| 1 | LEFT | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J7 |
| 1 | LIMIT | Connector_PinHeader_2.54mm:PinHeader_2x02_P2.54mm_Vertical | J2 |
| 1 | LOCK / DTR | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J5 |
| 1 | RESET | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J6 |
| 1 | RIGHT | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J8 |
| 1 | SERVO | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | J1 |
| 1 | STATUS LEDS | Connector_PinHeader_2.54mm:PinHeader_2x03_P2.54mm_Vertical | J3 |
The 18 most common of 24 parts.

dotnet/iot
This repo includes .NET Core implementations for various IoT boards, chips, displays and PCBs.

pascallanger/DIY-Multiprotocol-TX-Module
Multiprotocol TX Module (or MULTI-Module) is a 2.4GHz transmitter module which controls many different receivers and models.


rusefi/rusefi
rusefi - GPL internal combustion engine control unit

DraftShift/StealthChanger
Tool changing system for Vorons and other front mount printer motion systems, not just stealthburner.

VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group

hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

It measures 30 × 70 mm and has 2 copper layers, 1.6 mm thick.
24 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
From the niaid/techrom-tray repository on GitHub, at the commit this page was made from: the board is kicad/tecan_tray.kicad_pcb and its schematic kicad/tecan_tray.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask niaid before reusing the design.