К основному содержанию
скилл CX Codex

arduino-serial-monitor — скилл для Claude Code

Скилл arduino-serial-monitor для Claude Code читает и анализирует вывод последовательного порта Arduino: логи загрузки, данные датчиков и ошибки связи.

MIT 1 установок ★ 33 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add wedsamuel1230/embedded-engineering-skills --skill arduino-serial-monitor -a claude-code
Открыть на GitHub

Что делает arduino-serial-monitor

Скилл предоставляет средства для чтения и анализа данных из последовательного порта Arduino. Вы можете подключиться к порту в реальном времени, сохранять логи в файлы с временными метками, фильтровать вывод по ключевым словам или регулярным выражениям и автоматически выделять типичные ошибки.

Поддерживаются разные форматы данных: текст, JSON, CSV и бинарные. Фильтрация по уровню ошибок (ERROR, WARNING), анализ временнЫх меток и цветное выделение ускоряют поиск проблемы в загромождённом логе. Скилл работает на Windows, macOS и Linux.

Для структурированной отладки рекомендуется вывести на серийный порт строки с полями вроде t_ms=123 level=INFO event=sensor_read value=.... Без Python 3.8+ и uv 0.4+ скилл не запустится; зависимости pyserial и colorama объявлены в самом скрипте.

Какие задачи решает

  • проверить загрузку платы и причину перезагрузки
  • собрать данные датчиков и проверить их корректность
  • найти ошибки связи и таймауты в логе
  • отфильтровать нужную информацию из большого потока вывода
  • сохранить лог с временными метками для анализа

Примеры запросов агенту

  • Отслеживай вывод платы на порту COM3 с фильтром по ошибкам: uv run --no-project scripts/monitor_serial.py --port COM3 --filter "ERROR|WARNING"
  • Запиши логи температурного датчика в файл с временем: uv run --no-project scripts/monitor_serial.py --port /dev/ttyACM0 --baud 115200 --output debug.log --timestamp
  • Распарси JSON-данные с датчиков и покажи красиво: uv run --no-project scripts/monitor_serial.py --port COM3 --format json --pretty

Как установить arduino-serial-monitor

1Через Skills CLI (Vercel)

npx skills add wedsamuel1230/embedded-engineering-skills --skill arduino-serial-monitor -a claude-code

2Вручную: положить файлы

~/.claude/skills/arduino-serial-monitor/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/arduino-serial-monitor/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об arduino-serial-monitor

Как установить arduino-serial-monitor в Claude Code?

Выполни команду npx skills add wedsamuel1230/embedded-engineering-skills --skill arduino-serial-monitor -a claude-code, затем открой файл ~/.claude/skills/arduino-serial-monitor/SKILL.md.

Что делает arduino-serial-monitor?

Скилл подключается к последовательному порту Arduino, читает вывод в реальном времени, сохраняет логи в файлы, фильтрует по узорам и автоматически ищет типичные ошибки. Поддерживает текст, JSON, CSV и бинарные форматы.

Какие требования нужны для работы скилла?

Нужны Python 3.8+, uv версии 0.4 или выше. Скилл сам подгружает зависимости pyserial и colorama — их отдельно ставить не надо.

Исходный текст

SKILL.md · MIT
---
name: arduino-serial-monitor
description: Read and analyze Arduino or embedded serial output for structured runtime debugging across Arduino IDE, Arduino CLI, PlatformIO, and vendor-specific monitor tools. Use when boot output, sensor data, resets, communication failures, timing symptoms, or field behavior need evidence rather than compile-only reasoning.
metadata:
  triggers: "serial monitor, runtime logs, boot output, reset reason, sensor logs, structured debug, field symptoms"
  attribution: "Refined from the existing Arduino serial monitor skill; no separate serial-debugging skill is installed."
---

# Arduino Serial Monitor

For a desktop visualization/bench console, read
[desktop-console guidance](references/desktop-console.md). Wireless transport
and trace semantics belong to `wireless-telemetry`; do not duplicate its driver
or measurement workflow here. Native ESP-IDF logs are valid inputs to serial
diagnosis and do not imply an Arduino framework.

This skill provides advanced tools for reading and analyzing serial monitor data from Arduino boards, enhancing the debugging experience beyond the basic Arduino IDE serial monitor.

## Features

- **Real-time Serial Monitoring**: Connect to Arduino serial ports and display data in real-time
- **Data Logging**: Save serial output to files with timestamps for later analysis
- **Filtering & Pattern Matching**: Filter output by keywords, regex patterns, or data types
- **Error Detection**: Automatically highlight common error patterns and warnings
- **Multiple Format Support**: Handle different data formats (text, JSON, CSV, binary)
- **Cross-platform**: Works with Windows, macOS, and Linux serial ports

## Structured Debugging Workflow

1. Record the exact board/revision, firmware/image identifier, toolchain and
   versions, port, baud, reset cause if known, and timestamp source.
2. Prefer one line per event with stable fields such as
   `t_ms=123 level=INFO event=sensor_read value=...`; keep secrets and tokens
   out of output.
3. Capture the unfiltered log before filtering. Preserve the first boot lines,
   reset/brownout/watchdog messages, and the transition that reproduces the
   symptom.
4. Label conclusions as build, upload, hardware, system, or deployment
   evidence. Report the result by proof stages. A clean serial stream is not proof that pins, power, or the full
   system are correct.
5. Pair with `hardware-tdd` for a test matrix and `embedded-project-loop` when
   the next observation must come from a user-operated board.

## Recommended C++ Event Format

```cpp
Serial.print("t_ms=");
Serial.print(millis());
Serial.print(" level=INFO event=ready board=");
Serial.println(BOARD_ID);
```

Use a fixed, bounded format appropriate to the board's memory budget. Do not
log Wi-Fi passwords, API keys, certificates, tokens, or private data.

## Usage

### Basic Serial Monitoring

```bash
# Monitor serial port with default settings (9600 baud)
uv run --no-project scripts/monitor_serial.py --port COM3

# Specify baud rate and output file
uv run --no-project scripts/monitor_serial.py --port /dev/ttyACM0 --baud 115200 --output debug.log

# Filter for specific patterns
uv run --no-project scripts/monitor_serial.py --port COM3 --filter "ERROR|WARNING"
```

### Advanced Debugging

```bash
# Parse JSON data from serial
uv run --no-project scripts/monitor_serial.py --port COM3 --format json --pretty

# Monitor with timestamp and color coding
uv run --no-project scripts/monitor_serial.py --port COM3 --timestamp --color

# Detect common Arduino errors
uv run --no-project scripts/monitor_serial.py --port COM3 --detect-errors
```

## Script Options

- `--port`: Serial port (e.g., COM3, /dev/ttyACM0)
- `--baud`: Baud rate (default: 9600)
- `--output`: Output file for logging
- `--filter`: Regex pattern to filter lines
- `--format`: Data format (text, json, csv, binary)
- `--timestamp`: Add timestamps to output
- `--color`: Enable color-coded output
- `--detect-errors`: Highlight common error patterns
- `--timeout`: Connection timeout in seconds

## Common Arduino Debugging Scenarios

### Memory Issues
```
Filter for: "low memory|stack overflow|heap"
```

### Sensor Data Validation
```
Filter for: "sensor|reading|value"
Format as: json
```

### Timing Analysis
```
Enable: --timestamp
Filter for: "start|end|duration"
```

### Communication Errors
```
Filter for: "timeout|failed|error"
Enable: --detect-errors
```

## Integration with Arduino CLI

```bash
# Compile and upload, then monitor
arduino-cli compile --fqbn arduino:avr:uno sketch/
arduino-cli upload -p COM3 --fqbn arduino:avr:uno sketch/
uv run --no-project scripts/monitor_serial.py --port COM3
```

## Troubleshooting

### Port Not Found
- Check `arduino-cli board list` for available ports
- Ensure Arduino is connected and drivers are installed
- Try different port names (COM1-COM99 on Windows, /dev/ttyACM* on Linux)

### No Data Received
- Verify baud rate matches Arduino sketch (`Serial.begin(9600)`)
- Check USB cable connection
- Reset Arduino board while monitoring

### Permission Errors (Linux/macOS)
```bash
# Add user to dialout group
sudo usermod -a -G dialout $USER
# Logout and login again
```

## Evidence And Privacy

Record the board, firmware/image version, toolchain, baud, port, reset cause,
and timestamp source. Label serial output as hardware or system evidence only
when it was captured on the target. Redact Wi-Fi passwords, API keys,
certificates, tokens, and personal data before saving logs or sharing them.

## Dependencies

- Python 3.8+
- `uv` 0.4+ (the script declares `pyserial` and `colorama` inline)
- Run the self-contained helper with `uv run --no-project scripts/monitor_serial.py --help`.

## Examples

### Basic Temperature Sensor Monitoring

```python
// Arduino sketch
void setup() {
  Serial.begin(9600);
}

void loop() {
  float temp = analogRead(A0) * 0.488;
  Serial.print("Temperature: ");
  Serial.print(temp);
  Serial.println(" C");
  delay(1000);
}
```

```bash
uv run --no-project scripts/monitor_serial.py --port COM3 --filter "Temperature" --timestamp
```

### JSON Data Parsing

```python
// Arduino sketch with JSON output
#include <ArduinoJson.h>

void setup() {
  Serial.begin(115200);
}

void loop() {
  StaticJsonDocument<200> doc;
  doc["temperature"] = analogRead(A0) * 0.488;
  doc["humidity"] = analogRead(A1) * 0.146;
  doc["timestamp"] = millis();
  serializeJson(doc, Serial);
  Serial.println();
  delay(2000);
}
```

```bash
uv run --no-project scripts/monitor_serial.py --port COM3 --format json --pretty
```

## Shared Output Contract

Use [the shared Arduino skill contract](../../docs/arduino-skill-contract.md):
state assumptions, required tools and versions, implementation steps,
tests/evidence by proof stage, known limitations, and recovery/security notes.

© wedsamuel1230 · MIT · wedsamuel1230/embedded-engineering-skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
Serial MCP qarnet Связывает ИИ-агента с микроконтроллерами через UART и USB-serial. Через диалог с агентом можно отлаживать платы Arduino и STM32. CX Codex +1 ★ 21звёзд репо Arduino MCP Server hardware-mcp MCP-сервер связывает ИИ-агента с Arduino: помогает находить платы, собирать и загружать скетчи, читать Serial и проверять безопасность распиновки. CX Codex +1 ★ 26звёзд репо uart-serial-baremetal mohitmishra786 Скилл uart-serial-baremetal помогает настроить bare-metal UART и USART на микроконтроллерах для вывода логов, расчёта битрейта и отладки. CX Codex +1 391установок serial-mcp-server es617 MCP-сервер serial-mcp-server даёт агенту инструменты для работы с последовательным портом: открыть соединение, отправить команду, прочитать ответ, дёрнуть DTR. CX Codex +1 ★ 27звёзд репо arduino-azure-iot-edge-integration официальный github Скилл arduino-azure-iot-edge-integration для GitHub Copilot помогает спроектировать связь Arduino с Azure IoT Hub и IoT Edge. Описывает телеметрию, команды устройству и работу при нестабильной сети. CX Codex +1 100установок lgt8f328p-minievb alexex1993 Помогает разрабатывать прошивки под плату LGT8F328P MiniEVB в PlatformIO. Агент учитывает скрытые отличия китайского клона от Arduino Nano при настройке тактирования, таймеров и пинов. CX Codex +1 ★ 29звёзд репо

Из того же набора19

Весь набор →
code-review-facilitator Скилл code-review-facilitator проверяет проекты Arduino, ESP32 и RP2040 на типичные ошибки, проблемы с памятью и недочёты структуры. Подходит для ревью перед публикацией или после новой функции. CX Codex +1 154установок readme-generator Скилл readme-generator генерирует README.md для проектов на Arduino, ESP32 и RP2040. Подходит, когда проект нужно документировать перед публикацией на GitHub. CX Codex +1 147установок sensor-calibration-workbench Скилл sensor-calibration-workbench ведёт калибровку CO2-сенсоров, тензодатчиков и других датчиков: от прогрева и эталонных измерений до хранения коэффициентов и проверки дрейфа. CX Codex +1 137установок i2c-bringup-diagnostician Скилл i2c-bringup-diagnostician помогает выявить сбои шины I2C на платах Arduino и ESP32: от подтяжки резисторов до ошибок библиотек. CX Codex +1 134установок freertos-patterns Скилл freertos-patterns подсказывает паттерны FreeRTOS на ESP32 и многоядерную координацию на RP2040 — очереди, мьютексы, задачи, уведомления. CX Codex +1 120установок ota-deployment-guardian Скилл ota-deployment-guardian защищает удалённые платы ESP32 и Arduino Uno R4 WiFi от окирпичивания при OTA-обновлениях. Помогает настроить откат прошивки и разобрать сбои сетевых портов. CX Codex +1 115установок mermaid-diagram-generator Скилл mermaid-diagram-generator для Claude Code строит диаграммы Mermaid по коду Arduino и описаниям встроенных систем. Показывает состояния, последовательности сигналов и архитектуру задач FreeRTOS. CX Codex +1 113установок field-power-and-connectivity-triager Скилл field-power-and-connectivity-triager для Claude Code помогает найти причину сбоев питания и связи, когда плата работает от USB, но ломается с рабочим источником. Проверяет просадки напряжения, пиковый ток, стабилизатор и проводку. CX Codex +1 113установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой