Installation

How to Install the TilliT Ignition Module

Download the TilliT Module

Navigate to the following link and a download of the latest version of the module should automatically start: https://tillit.cloud/assets/ignition/TilliT-Module-signed-LATEST.modl

Take note of the location of the file TilliT-Module-signed-LATEST.modl as you will need to navigate to there later.

Install the TilliT Module

Navigate to the Ignition Gateway in your browser and then go to Config and select Modules.

At the bottom of the page the TilliT Module should be present in the list and running:

Configuring the TilliT Ignition Module

Navigate to your TilliT environment in your browser and then in the left menu expand the Settings menu and click the Edge option.

Click Create, and a popup should appear. Enter a recognisable name such as Ignition Module and a description if required. In the Type drop-down ensure you have selected Mqtt then click Save.

Now download the certificates for the edge you have just created and take note of the Thing ID that has been generated. This is always available by opening the Edge screen and seeing the Basic Information panel.

Back in Ignition, Navigate to the Ignition Gateway in your browser and there should be a new menu item TilliT, click the settings option:

In the configuration section enter your tenant and the environment you are connecting to. If you’re from Australia you can leave the region blank, otherwise if you’re from the US enter us.

In the security section enter the user details, it is suggested that you create a specific ignition account. Refer to https://help.tillit.cloud/tillit/knowledge-base/users/manage to create a user. After creating the account, ensure it is logged into at least once to complete the setup. During this initial login, a new password must be set, as the temporary password will not work in the Ignition Module.

In the MQTT section we will require files from the .zip file that was previously downloaded. Firstly in the Thing ID field, enter the Thing ID which is associated with the Edge, for example, TilliTEdge-123456. Note: 123456 can be any combination of alphanumeric characters, such as 12a34b. Then extract the contents of the .zip. Then click Choose File for the Private Key and select the file called privKey.key. Next, click Choose File for the Certificate and select the thingCert.crt file. Lastly, click Choose File for the Root CA and select the rootCA.pem file.

Check the keep alive is set to what you desire, default is 1200 seconds. Keep alive is the total amount of time the cloud will keep your MQTT connection enabled so that you can still receive messages from the cloud if you get disconnected. 1200 is the max seconds supported.

Click save and you are done. If you did everything correctly, you should be able to open the Ignition designer and see a new Tag Provider created. If you failt o see it, check your logs. Common issues are, wrong tenant/username/password combination. Setting the certificate files in the wrong place.