# gnssa

**Repository Path**: ymofen/gnssa

## Basic Information

- **Project Name**: gnssa
- **Description**: GNSS Assistant
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-25
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gnssa

## install
### windows
````
   wget http://119.96.169.117:3006/gnss/release/gnssa.exe -O gnssa.exe
````

### linux
````
   wget http://119.96.169.117:3006/gnss/release/gnssa -O gnssa && chmod +x gnssa
````




## build
````shell
go build -trimpath -o ./build/gnssa ./cmd
````

### windows
````shell
go build -trimpath -gcflags=all=-l -ldflags="-s -w" -o build\gnssa.exe ./cmd
````
````shell
copy build\gnssa.exe E:\workspace\gnssbin\.
````

````shell
go build -trimpath -gcflags=all=-l -ldflags="-s -w" -o build\file2caster.exe ./cmd/file2caster
````

## usage
for help
````shell
gnssa -h
````

### rtka
````shell
cd build
./gnssa rtka -e "conntype=tcpclient&addr=119.96.228.250:8070" -r "conntype=ntripclient&head.vrsstation=&connstr=yangmf:123456@103.143.19.54:8003&mp=RTCM33GRCEJpro&blh=30.5,113.31,11.2&interval=10" -b "conntype=ntripclient&connstr=yangmf:123456@103.143.19.54:8003&mp=RTCM33GRCEJpro&blpath.path=30.5,113.31;30.5,113.34;30.5,113.38;30.5,113.44&blpath.speed=50"
````

### rnxFilesSearch
````shell
cd build

.\gnssa.exe rnxFilesSearch -i "E:\bern\DATAPOOL\DATAPOOL\RINEX" -o "E:\bern\DATAPOOL\DATAPOOL\RINEX_TEMP"
````


### rnxExtract
````shell
cd build 
.\gnssa.exe rnxExtract -i "E:\bern\DATAPOOL\DATAPOOL\RINEX" -o "E:\bern\DATAPOOL\DATAPOOL\RINEX_TEMP\EXAMPLE.STA"
````

````shell
.\gnssa.exe rnxExtract -i "E:\bern\DATAPOOL\DATAPOOL\RINEX" -o "E:\bern\DATAPOOL\DATAPOOL\RINEX_TEMP\EXAMPLE.STA"
````

### rtcm freqCheck

````shell
.\gnssa.exe rtcm freqCheck --caption="RTCM33GRCEJpro" -i "conntype=ntripclient&connstr=yangmf:123456@103.143.19.54:8003&mp=RTCM33GRCEJpro&blh=30.5,113.31,11.2&interval=10" --checkConf "C2=B1,B3,B2&C3=B1,B3,B2a,B1C&E=E1,E5a,E5b&G=L1,L2,L5&J=L1,L2,L5&R=G1,G2" --runDuration 80s
````

### rtcm signalCheck

````shell
.\gnssa.exe rtcm signalCheck --caption="RTCM33GRCEJpro" -i "conntype=ntripclient&connstr=yangmf:123456@103.143.19.54:8003&mp=RTCM33GRCEJpro&blh=30.5,113.31,11.2&interval=10" --checkConf "C2=2I,6I,7I&C3=1P,2I,5P,6I&E=1C,5Q,7Q&G=1C,2W,5Q&J=1C,2L,5Q&R=1C,2P" --runDuration 20s
````


### msmExtract

示例（本地文件）：

```shell
gnssa msmExtract -i "LJGC0970.26b" -o "output.log" -s "2024-04-08 00:00:00" -e "2024-04-08 23:59:59"
```

示例（远端连接）：

```shell
gnssa msmExtract -c "conntype=ntripclient&interval=10&connstr=user:pass@127.0.0.1:2101/RTCM32GRC/GGA" -o "output.log" -b "1005,1125"
```

参数说明:

- `-i, --inputFile` : 本地输入文件路径（若设置则会以 `conntype=localfile&file=...` 形式使用），示例: `D:\raw\STA\2026\0408\LJGC0970.26b`。
- `-c, --connstring` : 连接字符串（当不提供本地文件时使用），例如 NTRIP/TCPSERVER 等形式：`conntype=ntripclient&interval=10&connstr=user:pass@host:port/mount`。
- `-o, --output` : 输出文件路径；若不指定，则输出到控制台。
- `-b, --msgBl` : 要提取的消息 ID 列表，逗号分隔，例如 `1005,1125`。
- `-s, --startTime` : 开始时间，格式 `YYYY-MM-DD HH:MM:SS`。若未指定，解码时使用当前时间作为参考，并不对早于该点的 GNSS 时间进行过滤。
- `-e, --endTime` : 结束时间，格式 `YYYY-MM-DD HH:MM:SS`。若未指定，则不对晚于该点的 GNSS 时间进行过滤。
- `-r, --outputRawBuf` : 是否输出 RTCM 原始 buf（`0` 或 `1`，默认 `0`）。设置为 `1` 时以十六进制格式输出原始 buf。

- `-m, --outputMsmSimple` : 是否输出简化的 Msm 数据（`0` 或 `1`，默认 `0`）。设置为 `1` 时输出 `MsmSimple` 结构，仅包含部分基础信息（例如 卫星/信号 列表、时间戳和要点字段），而不是完整的 `Msm` 结构，便于快速查看或日志记录。

- `--pw` : 卫星白名单（逗号分隔），例如 `C06,C07`，仅保留这些卫星的观测数据进行输出。
- `--pb` : 卫星黑名单（逗号分隔），例如 `C06,C07`，排除这些卫星的观测数据不做输出。
- `--sw` : 信号白名单（逗号分隔），例如 `2X,2W`，仅保留这些信号类型的数据进行输出。
- `--sb` : 信号黑名单（逗号分隔），例如 `2X,2W`，排除这些信号类型的数据不做输出。

说明: `msmExtract` 支持通过本地文件或远端连接提取 RTCM/MSM 数据，支持按消息类型和 GNSS 时间区间过滤，输出到文件或标准输出。

### nmeaEncode

示例（以经纬高输入）：

```shell
gnssa nmeaEncode --blh="30.5,113.31,11.2" --template="/path/to/template" --flag=4 --sta=1024
```

示例（以 ECEF XYZ 输入）：

```shell
gnssa nmeaEncode --xyz="3980581.2,-482680.3,4967037.1" --template="/path/to/template" --flag=2
```

参数说明:

- `--blh` : 以逗号或空格分隔的经度/纬度/高度（b,l,h），例如 `30.5,113.31,11.2`。优先使用 `--blh`。
- `--xyz` : 以逗号或空格分隔的 ECEF 坐标 `x y z`，若提供则会转换为 `blh`。
- `--sta` : GGA中的参考站 ID，整数，例如 `1024`。
- `--flag` : GGA中的定位质量，整数，默认 `1`，可选值示例 `1,2,4,5`，1=单点，2=差分，4=固定，5=浮动。
- `--template` : NMEA 格式模板路径或模板字符串，用于生成输出。

说明: 当同时提供 `--blh` 与 `--xyz` 时，优先使用 `--blh`。命令会将输入位置（`blh` 或 `xyz`）设置到服务配置中并启动处理，处理结果按模板输出。