js-aprs-fap v2.0.0

js-aprs-fap

APRS is a registered trademark Bob Bruninga, WB4APR.

This is an APRS parser based on Ham::APRS::FAP rewritten in JavaScript. Therefore, much of what is listed here is directly copied from the original repository.

Goals - work in progress

• Be lightweight
• Parse all message types
• Full code coverage with unit tests

Implemented features - parse

• normal
• mic-e and compressed location packets
• NMEA location packets
• objects
• items
• messages
• telemetry
• weather packets

Needs test cases to implement

• DX
• Capabilities

Additional Information

As of right now, this module's goal of functionality and behavior is to be similar to the original library. However, upon complete conversion, the code base and functionality will probably begin to diverge to better meet the JavaScript paradigm. Also optimizations will be made to try to imporove performance.

APRS features specifically NOT handled by this module:

• special objects (area, signpost, etc)
• network tunneling/third party packets
• direction finding
• station capability queries
• status reports (partially)
• user defined data formats

Optimizations Needed

• Quit leaking arguments (modifying them), explicitly return the $rethash value. Any errors thrown, should also be done explicitly.

Unit Tests Needed

• packet that causes a result code: srccall_noax25

May have issues

• _wx_parse
  • comments/software - trimming may not be accurate
• Uncompressed positions
  • Do lat/long need to be trimmed to 4 decimal places?

USAGE

Demo

https://github.com/KD0NKS/aprs-is-demo

npm

npm install js-aprs-fap --save

SEE ALSO

• perl-aprs-fap
• C library port of Ham::APRS::FAP
• Python bindings for libfap

ORIGINAL COPYRIGHT

• Copyright (C) 2005-2012 Tapio Sokura
• Copyright (C) 2007-2012 Heikki Hannikainen

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.