Starting with the CheckFox & CheckFox dashboard setup

What are the steps I need to take after buying the CheckFox?

 

You need 4 things to get started with your CheckFox:
(the whole setup takes around 12 mins)

A. Working SIM card
B. Connectivity to the Sigfox network with special contract
C. Properly configured Sigfox backend and CheckFox dashboard
D. Update Checkfox to latest firmware

    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.

    If you wish to use your own SIM card please follow these instructions.
    Don't forget to change the APN, that is operator-specific.

    B. Connectivity to the Sigfox network with special contract
    We no longer offer Sigfox connectivity as majority of 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 RSSI, SNR and repetitions you need to ask your Sigfox operator to enable meta data on your contract. Without meta data neither dashboard nor Sigfox will work. It is a free service. If you are a Sigfox operator yourself see below.


    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

    1. Go to https://checkfox.simplehw.eu/
    2. Login with your Google account (we only collect email addresses and other ways of authentications are planned for the future)
    3. Once logged in, enroll your company by filling in its name
    4. Now you need to login with your Google account again
    5. Add your Checkfox by clicking on the Devices tab and pressing New
    6. Add additional users by clicking Users and entering their emails (optional)

    C.2 Sigfox backend setup

    1. Go to https://backend.sigfox.com and login with your Sigfox credentials
    2. Go to Groups and click on New - you need a separate group for your CheckFox(es)
    3. 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:
      1. CUSTOMER [R] in order to see messages (DEVICE [R] should be sufficient as well)
      2. OPT_INTEGRATOR in order to see IDs of base stations and repetitions
      3. COVERAGE TOOL in order to see and use the coverage API
      4. 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
        Add OPT_STATION_INSTALLATION in order to see meta data as metadata cannot be enabled on Sigfox operator group contract.
        If you are using subgroup contract let Sigfox enable network metadata on your contract.
      1. 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 - instruction
    1. 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)
    2. Under your new CheckFox group in the Sigfox backend, create a new Device type and name it accordingly (e.g. CheckFox_companyname_internal)
    3. Register your CheckFox as a new device under this Device type (register the device as a prototype, more can be found here: https://support.sigfox.com/docs/register-as-a-prototype); for this step, the ID and PAC of your CheckFox is required (you should have it in your inbox or you can find it in the device following this guide)
    4. Go to the Information tab of your new Device type and hit Edit on the top right
    5. Switch the Downlink type to Direct and input sixteen 0s (0000000000000000) into data and hit Ok - this is necessary for the device to function properly
    6. Go to Callbacks and then create custom callbacks according to the specs below:

    DATA CALLBACK

        Type DATA, UPLINK
        Channel URL
        URL pattern https://checkfox.simplehw.eu/api/scbmeasurement?type=uplink
        Use HTTP method POST
        Send SNI Check this ✔️
        Headers/Header Authorization
        Headers/Value Unique per company - found in the dashboard in Company settings
        Content type Application/json
        Body
        {
        "device":"{device}",
        "time":"{time}",
        "data":"{data}",
        "seqNumber":"{seqNumber}"
        }


        SERVICE CALLBACK

        Type SERVICE, DATA_ADVANCED
        Channel URL
        URL pattern https://checkfox.simplehw.eu/api/scbmeasurement?type=data_advanced
        Use HTTP method POST
        Send SNI Check this ✔️
        Headers/Header Authorization
        Headers/Value Unique per company - found in the dashboard in Company settings
        Content type Application/json
        Body
        {
        "device":"{device}",
        "time":"{time}",
        "data":"{data}",
        "seqNumber":"{seqNumber}",
        "lqi":"{lqi}",
        "fixedLat":"{fixedLat}",
        "fixedLng":"{fixedLng}",
        "operatorName":"{operatorName}",
        "countryCode":"{countryCode}",
        "deviceTypeId":"{deviceTypeId}",
        "computedLocation":{computedLocation},
        "duplicates":{duplicates}
        }

         

        D. Firmware update
        After you've setup the callbacks, please update the firmware - follow this guide: https://ask.simplehw.eu/ota-firmware-upgrade

        If everything is not perfect please use the CheckFox troubleshooting guide.