Thingsee Support

Thingsee - Initial State integration instructions

Let’s first start with the Initial State registration and configuration:

  • Go to Thingsee's new dashboard page and use (one of) your device's serial number to login;
  • Once you have inserted a SN, you should see a page like this:
  • Go ahead and click on the top right corner of the left banner to add a new bucket;
  • Go to the bottom of the page and press ‘Create’;
  • You should be able to see on left side the bucket that you have created: ‘New Data Bucket’ if you haven’t re-named it;
  • Press on settings from the ‘New Data Bucket’. If you can’t see Settings press on the gear (on the top left corner, besides the search input box) followed by a click on a ‘list’ image, which is on top of the gear. It should say “Toggle Compact List” when the mouse is resting on top of it;
  • Press settings;
  • Rename the bucket to a name of your choice;
  • Before you Press Done on the bottom of the page go to CLOUD.JSN file edition instructions.

 

Cloud.JSN file edition:

  • Download the COULD.JSN file attached or copy-paste the code below into a code editor (e.g. WordPad or Notepad++):
{
  "connectors": [
    {
      "connectorId": 1,
      "connectorName": "Initial State Cloud",
      "api": "v2",
      "protocol": "http",
      "host": "insecure-groker.initialstate.com",
      "port": 80,
      "bucket_key": "YOUR-BUCKET-KEY",
      "acceptVersion": "0.0.1",
      "auth": {
          "deviceAuthToken": "YOUR-ACCESS-KEY"
      },
      "service": {
          "useHumanSenseID": true
      }
    }
  ],
  "connections": [
    {
      "cellularConnections": [
        {
          "accessPointName": "YOUR-OPERATORS-APN",
          "connectionId": 1
        }
      ]
    }
  ],
  "sms": {
    "min_interval_minutes": 0,
    "max_per_day": 24
  }
}
  • Rename the following fields according with the values given in Initial State bucket settings for your specific case:
    • In YOUR-BUCKET-KEY insert the ‘Bucket Key’ given in your bucket settings. E.g. 7XLDP3R66Q2G
      • If you are a less technical person please be careful to leave "" (quotations marks) surrounding the string (text), do not eliminate them.
    • In YOUR-ACCESS-KEY insert the ‘Access Key’ given in your bucket settings.
    • In YOUR-OPERATORS-APN insert the APN that you have been using before for your Thingsee device’s SIM card.
  • In case you are using WiFi connection, instead of modem, delete the code that starts in "connections":[ (included) til the end and paste the code below.
    Rename the fields YOUR-NETWORK-NAME and YOUR-NETWORK-PASSWORD with the correct ones. On the ‘encryption’ leave either wpa or wpa2 without empty spaces between quotations marks.
 "connections": [
    {
      "wifiConnections": [
        {
          "ssid": "YOUR-NETWORK-NAME",
          "encryption": "YOUR ENCRIPTION TYPE SELECT ONE  wpa OR wpa2",
          "password": "YOUR-NETWORK-PASSWORD",
          "connectionId": 1
        }
      ]
    }
  ]
}
  • Save the edited CLOUD.JSN file to your Thingsee device via USB-cable.
    NOTE IN CASE YOU USE THE ATTACHED FILE: In order to check that your CLOUD.JSN file is ready you shouldn’t be able to spot any capital letters on it.
    • Now you can press Done on the bottom left corner of your Thingsee dashboard.

 

Software Update:

  • UPDATE: If you already have the latest retail version update: 2016.10.21.2_Thingsee_SDK_Retail then you can move to the next phase: Profile.JSN files section since there is no need to update the FW of your device. On the other hand, if you haven't yet please continue reading.
  • Attached below there is an update.oci file. This file once copied to your Thingsee folder will update the software version of your device when you eject it from the computer, just as any other Thingsee software update.
  • Go ahead and copy paste it to your Thingsee device’s SD card
    Do not eject your Thingsee device at this point. You will still need to add more things to the SD card. Please, continue reading the rest of the instructions.

 

Profile.JSN files:

  • You can create your profiles.jsn files in Thingsee Creator as you always did and download them to your device.
    • Remember that the connection to Thingsee Cloud has been overridden. Thus, you will not be able to update profiles over-the-air anymore.
  • NOTE: GPS location is the only modification we had to do.
    That is, for Thingsee Creator we have a sensor ID for latitude and another for longitude, 0x00010100 and 0x00010200 respectively, (for more information about sensor’s ID please give a look at this article) and now for Initial State dashboard we added a new sensor ID for the GPS location since we needed to have the latitude and longitude coming on the same event. The new sensor ID is 0x00010700.
  • We provide you with an example profile.JSN file so that you can get started and study it. Copy paste it to your Thingsee device if you want to try it out.
    This profile has GPS, temperature and humidity sensors enabled, with a polling interval of 10 seconds.

Below there is the code of the profile.jsn file for a better understanding. 

NOTE: When you copy the code to a code editor software remember that the extension has to be .jsn and not other one such as .txt. Also Thingsee device only recognises cloud.jsn and profile.jsn, other names will be ignored.

 {
  "pId": "1",
  "apiVersion": "00.18",
  "initPuId": 1,
  "purposes": [
    {
      "puId": 1,
      "name": "Garage",
      "initStId": 0,
      "states": [
        {
          "stId": 0,
          "name": "Observing",
          "events": [
            {
              "evId": 0,
              "name": "Environment",
              "actions": {
                "cloud": {
                  "sendEvent": true,
                  "sendPush": true
                }
              },
              "causes": [
                {
                  "sId": "0x00060100",
                  "threshold": {
                    "count": 1
                  },
                  "measurement": {
                    "log": false,
                    "interval": 10000
                  },
                  "thresholds": {
                    "isAny": true
                  }
                },
				{
                  "sId": "0x00060200",
                  "threshold": {
                    "count": 1
                  },
                  "measurement": {
                    "log": false,
                    "interval": 10000
                  },
                  "thresholds": {
                    "isAny": true
                  }
                }
              ]
            },
			{
              "evId": 1,
              "name": "Location",
              "actions": {
                "cloud": {
                  "sendEvent": true,
                  "sendPush": true
                }
              },
              "causes": [
                {
                  "sId": "0x00010700",
                  "threshold": {
                    "count": 1
                  },
                  "measurement": {
                    "log": false,
                    "interval": 10000
                  },
                  "thresholds": {
                    "isAny": true
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
} 

 

Starting to observe some data in Initial State dashboard:

  • Now that everything is ready, eject and extract your device from your computer;
  • Your device will show the creation of the backup and update process evolution;
  • Once the software update ends wait for more than 10 seconds (or the polling interval of your profile.jsn if different from the one supplied) plus the connection delay and you should be able to see some values on your Initial State dashboard.
  • Be sure to select the correct Bucket and some Data Views from Initial State dashboard to observe the data streaming.

 

What's next?

Check a More complex purpose for new dashboard

Related articles:

How can I change back from Initial State dashboard to Thingsee Creator?

Attachements

Have more questions? Submit a request

Comments

  • Avatar
    Giuseppe Platania / Bell Canada

    How can I submit data from multiple ThingSee One to the same Initial state Bucket? For example I want to check the position and speed of 3 cars.

  • Avatar
    Giuseppe Platania / Bell Canada

    I assume that to achieve that you should reuse the same Bucket ID but be able to rename the events. Unfortunately seems that the event's name is in the OCI code, so it is not accessible from the purpose.

  • Avatar
    Thingsee Support

    Hello Giuseppe,

    You're right you would need to use the same Bucket ID, but currently the events sent is not possible to distinguish it if several devices send data to the same bucket.

    In our off-road case we used Kii cloud and it was possible to add a variable to the cloud.jsn file which would recognise from which device a specific data was sent.

    Unfortunately, this feature wasn't considered in the original SW version, but to incorporate a unique code in the events created and sent would not require much work.

    Regards,
    Paulo

    Edited by Thingsee Support