# com

**Repository Path**: near2u/com

## Basic Information

- **Project Name**: com
- **Description**: 类 screen 的 Windows 串口终端。连接 COM 端口，提供交互式控制台界面、日志和 COM 枚举。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# com — Windows 串口终端

类 screen 的 Windows 串口终端。连接 COM 端口，提供交互式控制台界面、日志和 COM 枚举。

## 特性

- 交互式终端，支持 Ctrl+A 转义前缀
- 可配置波特率、数据位、校验位、停止位
- 串口输出记录到文件，附带时间戳
- 自动命名日志文件（`-o` 不带文件名）
- 列出可用 COM 端口及占用状态（`-l` / `--list`）
- 日志中会话开始/结束标记
- 日志输出过滤 ANSI 转义序列
- 通过 Ctrl+A c 干净退出（基于 CancelIo）

## 用法

```
com [options] <COM port | port number>

Examples:
  com 27
  com --baud 115200 1
  com 27 -o
```

### 按键

| 按键 | 操作 |
|------|------|
| Ctrl+A c | 退出 |
| Ctrl+A ? | 显示帮助 |
| Ctrl+A a | 向串口发送 Ctrl+A 字面值 |

### 选项

| 选项 | 说明 |
|------|------|
| `--baud <b>` | 波特率（默认: 115200） |
| `--data <d>` | 数据位（默认: 8） |
| `--parity <p>` | 校验: n[o], o[dd], e[ven], m[ark], s[pace]（默认: n） |
| `--stop <s>` | 停止位: 1, 1.5, 2（默认: 1） |
| `--output, -o <f>` | 串口输出写入文件（省略 \<f\> 自动命名） |
| `--ignore-dsr` | 忽略 DSR 信号 |
| `--list, -l` | 列出可用 COM 端口 |
| `--help, -h` | 显示用法 |

## 构建

```
make debug     # 构建带调试符号 (3.1 MB)
make release   # 构建剥离版本 (2.0 MB, 默认)
make format    # go fmt
make vet       # go vet
make clean     # 删除 com.exe
```

`debug` 和 `release` 在构建前会自动执行 `go fmt`。

### 交叉编译

覆盖变量:

```
make release GOOS=windows GOARCH=arm64 BIN=com-arm64.exe
```

## 日志格式

```
=== com log started at 2026-06-26T11:28:39.000+08:00 ===
[2026-06-26T11:28:40.123+08:00] [wlab@doorbell_hub_ad102p ~]#
[2026-06-26T11:28:41.456+08:00] ls -l /
[2026-06-26T11:28:48.789+08:00] drwxr-xr-x    2 root     root      772 bin
...
=== com log ended at 2026-06-26T11:28:51.999+08:00 ===
```

- 每行数据前缀 `[RFC3339 毫秒时间戳]`
- ANSI 转义序列（光标位置、颜色码）已被过滤
- 行尾: CRLF
- 会话开始/结束标记附带时间戳