Starting with the CheckFox and the CheckFox Dashboard
Introduction
You need 4 things to get started with your CheckFox:
A. A working SIM card
B. Connectivity to the Sigfox network with a special contract
C. Properly configured Sigfox backend and CheckFox dashboard (this guide is relevant for Sigfox API V2 released March 2020)
D. Latest firmware in your device (can be updates OTA)
Let’s elaborate a bit more on each of the steps.
A. Working SIM Card
Every new CheckFox is now being dispatched with a global €10 prepaid SIM card so you don't have to disassemble the device. The SIM card has to be activated and you can find the guide for that here.
Don't forget to change the APN if you want to use your own SIM card, that is operator-specific!
B. Connectivity to the Sigfox network with a special contract
We no longer offer Sigfox connectivity as majority of CheckFox users wanted to use their own. If you do not have your own connectivity, you can get it from your local Sigfox operator or buy it at buy.sigfox.com (please note that buying from buy.sigfox.com is available for some countries only, if you do e.g. international tracking, it's preferable to buy the connectivity from your local SO).
In order to get Basestations IDs, RSSI and repetitions you need to ask your Sigfox operator to enable meta data on your contract (NETWORK METADATA contract option). Without meta data neither the dashboard nor Sigfox will work. It is a free service. If you are a Sigfox operator yourself, see step C.26.
C. Proper configuration setup in Sigfox Backend and CheckFox dashboard
In order for the device to work correctly, please take the following steps. It should take no longer than 5 minutes.
C.1 CheckFox dashboard user, company and device registration
Go to checkfox.simplehw.eu
Login with your Google account (we only collect email addresses and other ways of authentications are planned for the future)
Once logged in, enroll your company by filling in its name
Now you need to login with your Google account again
Add your Checkfox by clicking on the Devices tab and pressing New
Add additional users by clicking Users and entering their emails (optional)
C.2 Sigfox backend setup
Go to backend.sigfox.com and login with your Sigfox credentials
Go to Groups and click on New - you need a separate group for your CheckFox(es)
When the new group is created, you need to go to the API access tab and there, create a new API access and give it following rights:
CUSTOMER [R] in order to see messages (DEVICE [R] should be sufficient as well)
OPT_INTEGRATOR in order to see IDs of base stations and repetitions
COVERAGE TOOL in order to see and use the coverage API
If you are a Sigfox operator, you can also give it:
OPT_STATION_LOCATION in order to see location of BTSs and distances) - group must be created directly under the Sigfox Operator group and not under a subgroup.
OPT_STATION_INSTALLATION in order to see meta data as metadata cannot be enabled on Sigfox operator group contract. If you are using a subgroup contract, let Sigfox enable network metadata on your contract.
If you don't have access to the rights, ask you local Sigfox operator, you can also find API credential documentation and tutorial provided by Sigfox here
Location of basestations is not public information. Only Sigfox operators using their APIs and configuring CheckFox Dashboard properly can see the precise location and distances of basestations.
Now back in the CheckFox dashboard, input the API login and password into the Company settings tab and save your credentials (you can find them in the API access list)
Under your new CheckFox group in the Sigfox backend, create a new Device type and name it accordingly (e.g. CheckFox_companyname_internal)
Go to the Information tab of your new Device type and hit Edit on the top right
Switch the Downlink type to Direct and input sixteen 0s
0000000000000000
into data and hit Ok - this is necessary for the device to function properlyGo to Callbacks and then create custom callbacks according to the specifications below:
DATA CALLBACK
Parameters
Body
SERVICE CALLBACK
Parameters
Body
D. Firmware update
After you've setup the callbacks, please update the firmware.
Before you start, make sure the battery voltage is at least 3,9V
Go to Service menu
Select Firmware update
The device will now download the latest firmware - the size is 64 kB so it will take about 3 minutes
After it's done, go to Service menu and then About to confirm the firmware has been updated
If you are experiencing any issues please use the CheckFox troubleshooting guide.
Additional useful info
Last updated