Certification

Sigfox Certifications

Sigfox Certification Handbook

Sigfox Verified

Be prepared for Sigfox RF & Protocol Tests v5.0.1Be prepared for Sigfox RF & Protocol Tests V4.0.1Sigfox RF & Protocol Test Specification v5.0.3Sigfox RF & Protocol Test Procedure

Helpful

CallbacksService callback

Data advanced

The DATA ADVANCED callback is delivered with a delay of approximately 30 seconds. The JSON format for the body is mandatory. The content of the variables marked as an object or array is not customizable. The engine will insert a JSON object or array in place of these variables with a predefined format content.

VariableTypeFormat

Description

time

integerEpoch time in seconds

the GMT timestamp corresponding to the message reception time

data 

stringHexadecimal

the user data (in hexadecimal)

seqNumber

integer

the sequence number of the message

lqi

string

the computed link quality with following values

  • "LIMIT"
  • "AVERAGE"
  • "GOOD"
  • "EXCELLENT"
  • "NA"

fixedLat 

float

the fixed latitude set in the device setting page

fixedLng

float

the fixed longitude set in the device setting page

operatorName

string

the name of the operator who received the message

countryCode

integer

the country code of the operator who received the message

duplicates

object "Duplicates"

the list of the duplicates with the base station ids, the number of repetitions, the SNR and the RSSI

Condition: for devices with contract option NETWORK METADATA

duplicates[].bsIdstringhexadecimal

id of the base station

Condition: for devices with contract option NETWORK METADATA

duplicates[].nbRepinteger

number of repetitions received

Condition: for devices with contract option NETWORK METADATA

duplicates[].rssifloat

the best signal to noise ratio of the received repetitions

Condition: for devices with contract option NETWORK METADATA

duplicates[].snrfloat

the best RSSI for received repetitions

Condition: for devices with contract option NETWORK METADATA

computedLocationobject "computedLocation"

the device location computed by the location service

Condition: for devices with contract option ATLAS service

computedLocation.latfloat

the estimated latitude of the device

Condition: for devices with contract option ATLAS service

computedLocation.lngfloat

the estimated longitude of the device

Condition: for devices with contract option ATLAS service

computedLocation.radiusinteger

radius limit in meters that defines the zone in which the device is located.

Condition: for devices with contract option ATLAS service

computedLocation.sourceinteger
  • 1 : using the GPS data inside the payload
  • 2 : by Network location
  • 6 : by WiFi location (External Provider)

 source from which the geolocation has been computed

Condition: for devices with contract option ATLAS service

computedLocation.statusinteger
  • 00: No position
  • 01: OK
  • 02: Fallback of WiFi location
  • 20: Invalid payload

status of the computation made by the location service

Condition: for devices with contract option ATLAS service

duplicates object content example:

{    "deviceId":"{deviceId}",    "data": "{data}",
"duplicates": [
{

    "bsId":"0001",
    "nbRep":1,
    "snr":0.0,
    "rssi":0.0
}
]
}

   

computedLocation object content example:

{    "deviceId":"{deviceId}",    "data": "{data}",
"computedLocation": [
{

    "lat":0.0,
    "lng":0.0,
    "radius":0,
    "source":2,
    "status":0
}
]
}

   

Can't find what you're looking for ?

Have questions? Our worldwide Community of expert fans can answer them.
Have answers? Join the Community and help!

slack logo

Ask the community >