Horizon

Getting Started with your Developer’s Kit

1. Unboxing

You should have the following components inside your Developer’s Kit box:

  • 1 x Horizon GPS board
  • 1 x Horizon ARTIC R2 board
  • 1 x information card with your Argos ID (you’ll need this to register for airtime)
  • 1 x micro USB cable
  • 1 x picoblade cable assembly (to connect the two boards together)

You’ll need to purchase an antenna (we’ve suggested a good one) and provide power to the board if you want to take your tag outdoors, but before you do that you can start programming your tag straight out of the box.

The complete Horizon ARTIC R2 Developer’s technical manual should also be downloaded as a PDF so you’re ready to go.

Unboxing the Horizon GPS developer's kit

2. Installing Tools

To talk to your tag you’ll need to install the Horizon Python tools.

We recommend using Ubuntu 20.04 LTS as the Linux operating system. If you’re using a Windows PC then you can use Oracle’s VirtualBox to setup a virtual machine and access your tag that way. Once you have installed VirtualBox on a PC be sure to setup USB to it passes through from the host. Here’s a useful guide showing you how.

To install the tools enter the following commands into Terminal. Tools and firmware are cloned from our Github repository so you should inherit the latest release.

If you run into any problems then be sure to look at our troubleshooting page too.

 

sudo apt-get update

sudo apt-get install -y git python3 python3.7 python3-pip libglib2.0-dev libyaml-dev usbutils python3-dev
sudo pip3 install python-dateutil==2.8.0
git clone https://github.com/arribada/horizon.git

cd horizon/tools

sudo python3 setup.py install

The tools is installed as tracker_config and can be called from the command line by running sudo tracker_config

To confirm that the tools installed successfully you can run the following command. It should return the version of the tools you have installed, i.e Version: 2.0.0

sudo tracker_config –version

3. Connecting your tag

Now that you have installed the Horizon Python tools we can connect the tag to your host computer and start to talk to it.

Connect your tag using the provided micro USB cable.

You should see it light up and two LEDs will be active (power and activity).

Horizon GPS LED status

We can now call the tracker_config tool and provide it with arguments to talk to your tag. Let’s send a status request first and see what we get back. Enter the following command:

sudo tracker_config –status
You should see the following returned:
{
“gps_module_detected”: true,
“cellular_module_detected”: flase,
“sim_card_present”: “N/A”,
“sim_card_imsi”: “N/A”,
“satellite_module_detected”: false
}
We can see here that the tag has informed us that there is satellite board connected (we haven’t pllugged it in yet) and that there is no SIM card (your Horizon boards support cellular too via a plug in module).

For a full list of commands that you can use type the following;

sudo tracker_config –help

4. Configuring your tag

To configure your tag and start using the Argos / Kineis satellite module we can download the tag’s configuration file and made some edits.

The tag uses a JSON configuration file so it’s nice and easy to make changes and apply them.

Let’s start by downloading the default configuration installed on your tag from the factory.

To do this run the following command;

Note – you call the file downloaded anything you like, but in this instance we have just called it default.json

sudo tracker_config –read_config default.json

You should now have the configuration file default.json on your computer.

Open that file up in a text viewer and you’ll be able to see what’s inside. You can also open it from terminal by typing;

sudo nano default.json

The default configuration file found on the Horizon GPS out of the box

We can now see the configuration of the tag. For information on what each configuration value does (and means) you should download the complete Developer’s Kit operating manual.

Your tag straight out of the box has been configured ready to go with the following configuration:

  • Wake every 30 minutes
  • Take a maximum of 3 GPS fixes
  • Transmit the GPS location and battery voltage via Argos / Kineis
  • Aquire the time from the GPS fix
  • Log everything locally to the tag

You’ll notice that “iot“, “enable” is set to “false“. This is the only value you need to change to start using the Argos / Kineis functionality. It is disabled by default so we need to change this value and upload the new configuration file to the tag.

To do this manually change “false” to “true” and save the file (in nano you would press CTRL+ O and then press enter to save the file.

Once saved, let’s upload it to the tag by running the following command;

sudo tracker_config –write_config default.json

That’s it.

Your tag is now ready to go. You’ll need to provide power and attach an antenna to the satellite board, also not forgetting to register an account with CLS so you can see your data in the ArgosWeb dashboard.

Remember, your Argos ID is printed on the card inside your Developer’s Kit box.

We’re all in this together