Skip to content

An Arduino library for the ARGOS ARTIC R2 satellite communication chipset

License

Notifications You must be signed in to change notification settings

sparkfun/SparkFun_ARGOS_ARTIC_R2_Arduino_Library

Repository files navigation

SparkFun ARGOS ARTIC R2 Arduino Library

ARGOS ARTIC R2 Shield

ARGOS ARTIC R2 Shield

The ARTIC R2 chipset allows you to send and receive short data messages to and from anywhere via the ARGOS satellite network. Dedicated to programs which are related to environmental protection, awareness or study, or to protecting human life, the ARGOS constellation provides full global coverage including the polar regions.

The ARTIC is an integrated low power small size ARGOS 2/3/4 single chip radio. ARTIC implements a message based wireless interface. For satellite uplink communication, ARTIC will encode, modulate and transmit provided user messages. For downlink communication, ARTIC will lock to the downstream, demodulate and decode and extract the satellite messages.

The ARTIC can transmit signals in frequency bands around 400MHz and receive signals in the bands around 466MHz, in accordance with the ARGOS satellite system specifications.

The ARTIC is compliant and certified for all ARGOS 2 and ARGOS 3 TX standards. It contains a RF transceiver, a frequency synthesiser and a digital baseband modem.

This library provides access to the ARTIC via its SPI interface. Full support is provided for both standard mode and burst mode communication.

Library written by Paul Clark (SparkFun).

Repository Contents

  • /examples - Example sketches for the library (.ino). Run these from the Arduino IDE.
  • /src - Source files for the library (.cpp, .h).
  • keywords.txt - Keywords from this library that will be highlighted in the Arduino IDE.
  • library.properties - General library properties for the Arduino package manager.
  • CONTRIBUTING.md - Guidance on how to contribute to this library.

Documentation

v1.1

From v1.1.0 of the library:

We were instructed by Kineis to ensure that the Platform ID was written directly into each module and not stored in a configuration file accessible to standard users. To comply with this, SparkFun ARTIC R2 boards are now shipped with the Platform ID programmed into PMEM. When you buy a board from SparkFun, it will come with a card showing what the Platform ID for that board is. You will need to contact CLS or Woods Hole Group to have the Platform ID added to your account.

The library functions have been modified so that the Platform ID is read from PMEM instead of being a passed as an argument. The library examples and functions read the Platform ID from the ARTIC R2 memory using readPlatformID. Early boards will return a value of zero, later boards will return an ID starting with (e.g.) 0x3368. If the example stalls because the Platform ID is zero, you can:

Booting

The ARTIC R2 can either boot from on-board flash memory, or the firmware can be downloaded by the MCU via SPI. This library supports both methods but defaults to booting from on-board flash.

If you want to change this, you will need to edit the library header file and uncomment the line which says #define ARTIC_R2_UPLOAD_FIRMWARE. From then on the ARTIC R2 will be booted via SPI instead.

Note: the ARTIC006 firmware occupies 127KBytes of program memory. You will need an MCU with adequate memory if you choose to boot via SPI.

License Information

This product is open source!

Please review the LICENSE.md file for license information.

If you have any questions or concerns on licensing, please contact [email protected].

Please use, reuse, and modify these files as you see fit. Please maintain attribution to SparkFun Electronics and release any derivative under the same license.

Distributed as-is; no warranty is given.

  • Your friends at SparkFun.