CONFIG_HOWTO - shawnchain/aprs GitHub Wiki

#TinyAPRS TNC 配置手册#

Copyright by BG5HHP 2015,2016,2017

1. 设置准备工作

首先,请先准备好:

  • 一个USB转TTL的串口板
  • 一个可以访问USB/TTL口的程序
  • 一根4芯的母头杜邦线
  • 确保程序可以正确打开USB对应的虚拟串口

接着进行接线:

  • 连接USB/TTL和TinyAPRS的GND脚
  • 连接USB/TTL和TinyAPRS的数据脚:USB/TTL的TX脚对TinyAPRS的RX脚;RX脚对TX脚交叉连接

连接并加电

  • 将USB/TTL插入到笔记本,并且用串口程序打开,(设置在9600波特率,8N1)
  • 连接USB/TTL的5V脚到TinyAPRS的5V脚 (注意我们这里从USB取电,请不要接任何其他外接电源,否则可能烧毁TinyAPRS或者你的笔记本USB端口!)

一切顺利的话,你将看到设备启动的提示信息。如果你按下TinyAPRS上的复位按钮,则串口程序会反复显示启动的提示信息。(此外,如果你在串口程序中输入一个问号 ? 并且回车,也可以得到同样的效果)

TinyAPRS (KISS-TNC/GPS-Beacon) 1.1-SNAPSHOT (f1a0-3736)
MyCall: N0CALL
Mode: 0
RX:0, TX:0, ERR: 0
Free RAM: 531
  • 如果你希望看到完整的命令帮助信息,请在串口程序中输入两个问号 ?? 并且回车。
TinyAPRS (KISS-TNC/GPS-Beacon) 1.1-SNAPSHOT (f1a0-3736)
MyCall: N0CALL
Mode: 0
RX:0, TX:0, ERR: 0
Free RAM: 448

AT commands supported
-----------------------------------------------------------
AT+CALL=[CALLSIGN-SSID]         ;Set my callsign
AT+DEST=[CALLSIGN-SSID]         ;Set destination callsign
AT+PATH=[WIDE1-1,WIDE2-2]       ;Set PATH, max 2 allowed
AT+SYMBOL=[SYMBOL_TABLE/IDX]    ;Set beacon symbol
AT+BEACON=[45]                  ;Set beacon interval, 0 to disable
AT+TEXT=[!3011.54N/12007.35E>]  ;Set beacon text
AT+MODE=[0|1|2]                 ;Set device run mode
AT+KISS=[1]                     ;Enter kiss mode
??                              ;Display this help messages

Copyright 2015, BG5HHP([email protected])

注意: 每个命令必须以回车或者换行符号结束,否则命令无法被系统识别。请检查你的串口访问程序,一般都有“添加回车换行”等选项。

接下来介绍各个设置命令。

2. 设置命令介绍

2.1 AT+CALL 设定呼号

在作为Beacon或者Digi的时候,需要给设备指定一个有效的呼号,每次向外发送定位信标,或者转发的时候,设备会使用该呼号

例如:设定设备呼号:BG5HHP,SSID:7

  • AT+CALL=BG5HHP-7

2.2 AT+SYMBOL 设定标记

SYMBOL命令接收两个字符作为参数,第一个字符是符号表(symbol table),第二个字符是符号索引,请参考APRS101文档获得更多关于符号表的定义。

例如:设定使用第一个符号表'/',符号对应是JEEP '>'。(这也是缺省设定的SYMBOL)

  • AT+SYMBOL=/>

2.3 AT+TEXT 设定Beacon Text

在固定信标模式下,用该命令来设定一个信标APRS文本

例如:设定固定坐标,symbol及comment内容

  • AT+TEXT=!3011.54N/12007.35E>TinyAPRS R0cks

2.4 AT+BEACON 设定Beacon发送间隔

在上面的参数都设置完毕后,接下来就是要设定发送的间隔了。固定的信标,或者Digi,会每隔固定的时间发送beacon信号。这里的设置单位是秒。

例如:设定每隔900秒,发送一次信标广播。

  • AT+BEACON=900

注意:仅在初始状态及DIGI模式下有效。在KISS及Tracker模式下,定期发送无效。

2.5 AT+MODE 切换设备工作模式

TinyAPRS 固件1.0支持三种工作模式:

  • 调试配置模式 (Mode=0)
  • KISS协议的APRS TNC模式 (Mode=1)
  • 读取GPS数据的 Tracker信标模式 (Mode=2)
  • 数字中继转发的 Digi模式 (Mode=3)

请使用AT+MODE=n 来分别切换这几种模式。

例如:将设备切换到KISS TNC模式。

  • AT+MODE=1

注意1: 缺省情况下,设备会工作在模式0状态下。即只接收AT命令,而不做其他操作。这时候如果你送入APRS音频信号,设备会向串口输出解调后的内容。

注意2: 设备在KISS及Tracker模式下,无法接收AT配置命令。因此固件会在每次加电重启后先进入一个特殊的配置模式,即Mode0,该模式下可以接收AT命令配置。经过15秒钟后,系统会自动进入对应的工作模式。

注意3: 为了兼容其他程序,TinyAPRS也支持KISS ON等OT初始化命令,如果你之前用OT++作为TNC,那么直接替换就可以工作。无需重新设置APRS4R/APRX等程序

2.6 AT+RESET=n 复位清除所有设定参数

目前固件版本中,仅在n=2的时候有效。

例如:清除所有的设定参数。

  • AT+RESET=2

注意: 执行完该命令后,请重新加电,否则修改不会生效。

2.7 显示参数

上述的设置命令,如果你不带任何参数,系统会返回当前设置的数值。

例如:查看当前的CALL

  • AT+CALL=

将会返回: MYCALL: BG5HHP-7

2.8 测试命令

为了便于调试,这里提供了一个测试命令 ! 例如:连续发送3个beacon信标,每个间隔2秒

  • !3

注意: 该命令仅在测试版本中有效。

3. 常用模式设置参考

3.1 注意:下列设置都按照同一种步骤,即:

  • 将TTL连接到PC
  • 用Putty或者串口访问程序打开串口
  • 按下TinyAPRS上的复位按钮
  • 看到板子重启后的信息,开始输入设置命令,每个命令以回车换行结束
  • 设置完毕,断电。

3.2 设置成用于iGate接收的KISS模式

  • AT+RESET=2
  • 按下板上的复位按键
  • AT+MODE=1 或者 KISS ON 或者 AT+KISS=1均可

3.3 设置成每隔15秒发送一次的测试信标

  • AT+RESET=2
  • 按下板上的复位按键
  • AT+BEACON=15

3.4 设置成测试Digi

  • AT+RESET=2
  • 按下板上的复位按键
  • AT+PATH=NOGATE
  • AT+MODE=3

3.5 设置成测试GPS定位信标

  • AT+RESET=2
  • 按下板上的复位按键
  • AT+PATH=NOGATE
  • AT+MODE=2
  • 断电,断开TTL
  • 连接GPS模块,重新上电

3.6 复位所有设置参数

  • AT+RESET=2

注意:以上命令均没有设置呼号,因此只能用于测试。在真实场景中,请参见前面的命令介绍来设定自己的呼号。