接口ARM无线电APRSS服务器,并将分组数据保存到一个RevsDB数据库中
aprs2influxdb的Python项目详细描述
#APRS2流入 [![生成状态](https://travis-ci.org/FaradayRF/aprs2influxdb.svg?branch=master)](https://travis-ci.org/FaradayRF/aprs2influxdb)
该程序连接ham radio aprs-is服务器,并将数据包保存到influxdb数据库中。aprs2infloxdb使用行协议格式的字符串处理从aprs-is到infloxdb数据库的数据连接、解析和保存。还定期向APRS-IS服务器发送状态消息,以防止超时,从而保持与APRS-IS服务器的连接。
支持的APRS数据包格式: *未压缩 *麦克风-E *对象 *压缩的 *地位 *宽x *信标 *公告 *消息
APRS数据包中的非ASCII字符被替换!
##入门 使用pip安装的aprs2infloxdb可以用源代码以可编辑模式安装,也可以从[pypi](https://pypi.python.org/pypi)安装。
###先决条件 必须安装并配置[infloxdb](https://www.influxdata.com/)数据库。这是他们的开源[github上的项目文档](https://github.com/influxdata/influxdb)。
###安装 强烈建议使用virtualenv在虚拟环境中安装aprs2infloxdb。这有助于在windows和linux上顺利安装。可能找不到可执行文件并返回“importerror:”module“对象没有属性…”,这表示已安装的脚本找不到已安装的文件。Virtualenv解决了这一切。只要它与python安装分离,就不必安装在一个离散的虚拟环境中。
####派皮 pip安装aprs2infloxdb
####源代码 如果您只是使用源代码安装,请导航到源目录并运行:
PIP安装。
如果要以可编辑模式安装以进行开发,请导航到源目录并运行:
pip安装-e.
###运行APRS2INFORXDB 程序默认使用标准infloxdb登录信息以及示例aprs-is登录信息。如果正确安装了infloxdb,则需要指定自己的数据库信息。此外,您还需要一个业余无线电许可证,您可以使用该许可证使用呼号登录APRS-IS。
####命令行选项
- –dbhost dbhost设置infloxdb host(默认值=localhost)
- –dbport dbport设置infloxdb端口(默认值为8086)
- –dbuser dbuser设置infloxdb user(默认值=根)
- –dbpassword dbpassword设置infloxdb密码(默认值=根)
- –dbname dbname设置infloxdb数据库名称(默认值=mydb)
- –呼号呼号设置APRS-IS登录呼号(默认为nocall)
- –端口设置APRS-IS端口(默认值=10152)
- –间隔时间设置APRS-IS心跳间隔(分钟)(默认值=15)
- –调试将日志记录级别设置为调试(默认值=false)
####示例 假设infloxdb服务器正在运行并配置了“mydb”数据库,那么启动aprs2infloxdb很简单。请注意,APRS-IS忽略“nocall”的登录,因此您将连接,但如果您不指定您的业余无线电呼号,则很可能什么也看不到。
aprs2infloxdb–dbuser infloxuser–dbpassword123–dbname mydb–callsign nocall
上面的命令使用未指定选项的默认值。APRSIS端口10152是全流,而其他端口存在,这是最有用的。aprslib默认为rotate.aprs.net以选择aprs核心服务器。有关详细信息,请参阅[APRS-IS服务器](http://www.aprs-is.net/aprsservers.aspx)。
<> >退出ASPS2EnrxDb在Windows和##运行测试
单元测试将在以后的拉取请求中实现
##部署 这已经在Debian9(Stretch)服务器上进行了测试,并且在开发过程中使用Windows7进行了本地测试。
##作者 *bryce salmi-初始工作-[kb1lqc](https://github.com/kb1lqc)
另请参阅参与此项目的[贡献者](https://github.com/FaradayRF/aprs2influxdb/contributors)列表。
##致谢
- [@phirephly](https://github.com/PhirePhly)回答我的aprs问题!
- [@hessu](https://github.com/hessu)还回答我的aprs和aprsc问题,以及提供令人敬畏的[aprs.fi](https://www.aprs.fi)网站。