Overview

What is Sigfox?

Sigfox is a French global network operator founded in 2009 that builds wireless networks to connect low-power objects such as electricity meters and smartwatches, which need to be continuously on and emitting small amounts of data.

What is Sigfox Service?

Sigfox Service is a service on Murano that supports the integration between Murano and Sigfox.

What Sigfox Service does

How Sigfox Service works

How Sigfox works

Preparation

Setup a group, api and devicetype in Sigfox Backend

Create a group in Sigfox backend

Create a group in Sigfox backend

Create an API access in the group

Create an API access in the group

Create a devicetype in the group

Create a devicetype in the group

Create a devicetype in the group 2

Create a devicetype in the group 2

Check the domain, apiUser and apiPassword

Check the domain, apiUser and apiPassword

Quickstart

1. Add Sigfox to your Business

Subscribe to Sigfox in Exchange for your Business. If you are not familiar with Murano’s Exchange Element, you can refer to this doc: Adding Exchange Elements.

2. Configure Sigfox

Configure Sigfox

Format

Name Type Description
serviceConfig Array List of credentials for base access authentication of sigfox backend.

Example

[ 
  {
    "domain": "$(sigfox backend domain)",
    "apiUser": "$(login)", 
    "apiPassword": "$(password)" 
  }
] 

Note. alias is optional and not supported yet

4. Setup Murano Product

Ignore this step, if you already have a product in Murano!

Setup Murano Product

5. Call createCallback lua function to initiate the callback

payloadConfig: this is sigfox decoding rule, please refer to Custom message type decoding grammar

IMPORTANT: Using the string $2$ in any position in the value will result in malformed data. Same as $2 at the end of the value. Those character sequences needs to be escaped.'

productResources: the key at first level of the resources should be one of Murano product resource name.

    return Sigfox.createCallback ( {
      apiUser = "************************", 
      productId = "*****************", 
      deviceTypeId = "************************", 
      payloadConfig = "temperature::uint:8 humidity::uint:8 alarm::bool:7", 
      productResources = {
          data_in_obj = {
          temperature = "{customData#temperature}",
                humidity = "{customData#humidity}",
                model = "M3"
            },
          alarm = "{customData#alarm}",
          model = "M3",
          temperature = 66
      }
    })

6. Check the callback in Sigfox backend

Now, you could found the callback!

Check the callback

Once a Sigfox device sends a uplink first time, you can find the device in the Murano device gateway as well.