robotframework-aprslib

robotframework-aprslib is a Robot Framework keyword collection for the aprslib Python library. It allows licensed ham radio operators to establish a connection to the APRS-IS servers and send/receive/decode APRS requests.

Installation

The easiest way is to install this package is from pypi:

pip install robotframework-aprslib

Robot Framework Library Examples

In order to run these scripts, you need to add your call sign to the script's configuration section:

# This is your APRS-IS call sign. Replace this place holder with your personal call sign
${callsign}   YOURCALLSIGN

Replace the current placeholder with your call sign and you are good to go. The Robot Framework 5 examples use the new WHILE loop for an 'eternal' loop; all other code samples use finite FOR loops and will terminate after processing 10 records in a row.

• Echo incoming APRS messages
• Send and receive a single APRS message
• Receive a message, acknowledge it if necessary and then respond to it
• ROBOT FRAMEWORK 5: Echo incoming APRS messages
• ROBOT FRAMEWORK 5: Receive a message, acknowledge it if necessary and then respond to it

Library usage and supported keywords

Default settings for a new APRS-IS connection via robotframework-aprslib

When you initialize an APRS connection without explicitly setting parameters such as server, port, user/pass and filter, the following default values are automatically applied:

• server = euro.aprs2.net
• port = 14580
• callsign = N0CALL
• passcode = -1
• aprs-is filter = not set
• aprsis_msgno = 0 (this is equal to AA if you rather want to use the more recent replyack scheme)

This default set of values will allow you to establish a read-only connection to APRS-IS, assuming that the respective APRS-IS server that you intend to connect with permits such a connection.

Change the server / port / etc

You can either specify all parameters during the initial setup of the library or alternatively via separate keywords

Option 1 - set as position parameters

*** Settings ***

Library  AprsLibrary  server_value  port_value  user_value  passcode_value  filter_value  message_value

*** Test Cases ***
My first test case

Option 2 - set as named parameters

*** Settings ***

Library  AprsLibrary  aprsis_server=server_value  aprsis_port=port_value  aprsis_callsign=user_value  aprsis_passcode=passcode_value  aprsis_filter=filter_value aprsis_msgno = msgno_value

*** Test Cases ***
My first test case

Option 3 - Use Robot Keywords

Other Robot Keywords supported by this library

Known issues

• When you need to define strings which contain multiple spaces, escaping these strings won't work as Robot will try to interpret these as list values. You need to construct them as Robot-conform strings with ${SPACE}. Example: ABCD${SPACE}${SPACE}${SPACE}${SPACE}EFGH results in ABCD____EFGH (four blanks between the variable's value).

• Apart from minor helper methods for the connection setup and field check/retrieval, this Robot Framework library does not offer any additional keywords for exchanging data in a proper way. (Almost) every feature that the original aprslib offers is supported by this Robot library - nothing more and nothing less.

• The Receive APRS Packet keyword has no timeout which means that it will only return from its code if it has found a message that is to be returned to Robot. If you depend on timeout, you may need to amend your APRS-IS filter settings and handle the filter process in your code.

• The keyword Send APRS Packet will not check whether the APRS-IS connection has been establised read-only (N0CALL call sign) or read-write.

The fine print

• APRS is a registered trademark of APRS Software and Bob Bruninga, WB4APR. Thank you, Bob!
• This is a hobby project. It has no commercial background whatsoever.
• Exchanging data with APRS(-IS) requires you to be a licensed ham radio operator. If you don't know what APRS is, then this library is not for you. Alternatively, you may want to explore the option of getting your own amateur radio license (it's a great hobby).