test-hardware

Guides loopback, port discovery, and signal line tests for serial hardware.

Updated Sep 3, 2024
One-click install
npx skills add https://github.com/eminboydak/duckTerm --skill test-hardware-eminboydak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-hardware
Source: https://github.com/eminboydak/duckTerm/tree/main/.opencode/skills/test-hardware
Command: npx skills add https://github.com/eminboydak/duckTerm --skill test-hardware-eminboydak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that a serial terminal application correctly communicates with real hardware like Arduino boards, ESP32 devices, and USB-UART adapters requires structured, repeatable test procedures that are easy to get wrong without guidance. ## Core Features & Use Cases - Loopback Testing: Step-by-step procedure to connect TX to RX, send ASCII and hex data, and verify echo across baud rates from 9600 to 115200. - Port Discovery Verification: Confirm that serial ports appear and disappear correctly in duckTerm when adapters are connected and disconnected. - Signal Line Testing: Validate RTS/DTR control output and CTS/DSR/RI/CD input reading with voltage measurements. - Use Case: An embedded engineer connects a USB-UART adapter, follows the loopback test to send hex bytes 0x48 0x65 0x6C 0x6C 0x6F, and confirms "Hello" echoes back at 115200 baud before debugging their firmware. ## Quick Start Ask the assistant to walk you through a serial loopback test with your USB-UART adapter at 9600 baud.

Frequently Asked Questions about test-hardware

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform a serial loopback test?

Connect the TX pin to the RX pin on your USB-UART adapter or Arduino, open the port in your terminal at 9600 baud, and send ASCII text. The same text should appear in the receive window; you can also send hex bytes like 0x48 0x65 0x6C 0x6C 0x6F to verify "Hello" echoes back.

How to test serial communication with Arduino or ESP32?

Use the built-in serial on the Arduino or a USB-UART adapter for ESP32, then run a loopback test by wiring TX to RX. Send data at multiple baud rates (9600 through 115200) and verify the echo matches exactly with no garbled characters.

Why is my serial data garbled or unreadable?

Garbled serial output is almost always caused by a baud rate mismatch between sender and receiver. Ensure both sides use the same rate; testing at the wrong baud rate intentionally produces garbled characters, which confirms the mismatch.

Why is my serial port not showing up on Linux?

A missing serial port on Linux is typically a permission issue. Add your user to the dialout group to gain access, and verify the adapter appears in the port dropdown when connected and disappears when disconnected.

How do I test RTS and DTR signal lines on a serial port?

Open a connection, toggle the RTS or DTR checkbox, and measure the voltage on the corresponding pin to confirm it goes high and low. To test CTS input, connect CTS to RTS on the adapter and verify CTS state changes when you toggle RTS.