# sample

**Repository Path**: xuanwu_s3/sample

## Basic Information

- **Project Name**: sample
- **Description**: 玄武S3测试硬件功能示例代码
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Linux 嵌入式测试工具集

本项目包含两个用于 ARM64 嵌入式 Linux 环境的测试工具：

1. **linux_uart_test** - 串口通信测试工具
2. **linux_gps_test** - ATGM336H GPS/北斗定位解析工具

## 环境要求

### 交叉编译工具链

需要安装 ARM64 交叉编译工具链：

```bash
git clone https://gitee.com/xuanwu_s3/toolchain.git
```

## 编译说明

### 默认编译

使用 `aarch64-none-linux-gnu-gcc` 交叉编译器：

```bash
make
```

### 指定交叉编译器

如果需要使用其他编译器，可以指定 `CROSS_COMPILE` 环境变量：

```bash
make CROSS_COMPILE=aarch64-linux-gnu-
```

### 清理编译产物

```bash
make clean
```

## 工具使用说明

### 1. linux_uart_test - 串口测试工具

**功能**：测试串口收发功能，支持多波特率配置

**使用方法**：

```bash
./linux_uart_test <串口设备> <波特率>
```

**参数说明**：
- `<串口设备>`: 串口设备路径，如 `/dev/ttyS0`, `/dev/ttyUSB0`
- `<波特率>`: 支持的波特率：9600, 19200, 38400, 57600, 115200, 230400, 460800, 500000, 576000, 921600, 1000000, 1152000, 1500000

**示例**：

```bash
./linux_uart_test /dev/ttyS0 115200
```

**说明**：
- 程序启动后会持续发送测试数据 "12345"
- 同时接收串口数据并打印
- 收到 "exit" 或 "EXIT" 命令后退出

### 2. linux_gps_test - GPS/北斗定位解析工具

**功能**：解析 ATGM336H 模块的 NMEA 语句，支持 GPS/北斗单模及双模切换

**使用方法**：

```bash
./linux_gps_test <串口设备> <波特率> [模式]
```

**参数说明**：
- `<串口设备>`: 串口设备路径，如 `/dev/ttyS0`, `/dev/ttyUSB0`
- `<波特率>`: 通信波特率（最大支持 9600）
- `[模式]`: 可选参数，工作模式：
  - `gps`: 纯 GPS 模式
  - `bd`: 纯北斗模式
  - `both`: GPS+北斗双模（默认）

**示例**：

```bash
# 默认双模模式
./linux_gps_test /dev/ttyS9 9600

# GPS 单模
./linux_gps_test /dev/ttyS9 9600 gps

# 北斗单模
./linux_gps_test /dev/ttyS9 9600 bd
```

**说明**：
- 程序会实时解析 GNGGA 语句并输出定位信息
- 支持按 Ctrl+C 或输入 "exit" 退出
- 定位状态为 0 表示未定位，1 表示已定位

## 项目文件结构

```
.
├── Makefile           # 交叉编译 Makefile
├── README.md          # 项目说明文档
├── linux_uart_test.c  # 串口测试源码
└── linux_gps_test.c   # GPS/北斗测试源码
```

## 编译产物

编译成功后会生成两个可执行文件：
- `linux_uart_test` - 串口测试工具
- `linux_gps_test` - GPS/北斗定位工具

## 部署说明

将编译生成的可执行文件复制到目标 ARM64 设备上：

```bash
# 假设设备 IP 为 192.168.1.100
scp linux_uart_test linux_gps_test root@192.168.1.100:/usr/bin/
```

## 注意事项

1. 确保目标设备已正确配置串口权限
2. 使用前请确认串口设备路径和波特率正确
3. GPS 模块需要在开阔环境下才能获取定位信号
4. 建议使用 9600 波特率进行 GPS 通信

## License

GPL-2.0