This library is deprecated

Csharp-client library is deprecated, and will not receive any further updates.

---

Csharp-client

Description

C# Client library for connecting internet of things applications to the AllThingsTalk platform

Features

supports:

• creating, updating & deleting devices
• creating & updating assets
• sending and receiving asset values, supported formats:
  • json
  • csv
• uses events for incomming asset values & commands

Depends on:

• Newtonsoft.json for working with Json data.
• m2mqtt mqtt library for pub-sub communication.

Installation

There's a nuget package available at: https://www.nuget.org/packages/att.iot.client/ for easy installation.

Usage

Full demo app

The following application will create a new device, add 2 assets to it and will wait for an incomming asset command or until you press a key upon which it will send an asset value to the cloud.
The 'MyLogger' object that is used, is a interface implementation that simply writes the text to the console screen (Console.WriteLn)

class Program
{
    static Device _device;
    static MyLogger _logger;

    private static void Init()
    {
        //provide a logger object
        _logger = new MyLogger();
        //create the device object with your account details
        _device = new Device("testjan", "5i4duakv2bq", _logger);
        _device.DeviceId = "your device id";
        _device.ActuatorValue += _device_ActuatorValue;
    }



    static void Main(string[] args)
    {
        Init();
        //update or create the assets on the device. 
		_device.UpdateAsset("1", "test actuator", "a test actuator", true, "boolean");
        //the id of the asset can be string, integer,...  
		_device.UpdateAsset(2, "test sensor", "a test sensor", false, "boolean");
        _device.UpdateAsset(3, "test sensor 2", "a test sensor without type, defaults to string, does not overwrite manual changes on platform", false, null);

        //wait to continue so that we can send a value from the cloud to the app.
        Console.ReadKey();                                          

		//send a value to the platform
		_device.Send(2, "true");
    }

    static void _device_ActuatorValue(object sender, ActuatorData e)
    {
        _logger.Trace("incomming value found: {0}", e.ToString());

        //check the actuator for which we received a command
        if (e.Asset == 1)
        {
            //actuators can send simple strings or complex json values. 
            StringActuatorData data = (StringActuatorData)e;
            //do something with the value
            if(data.AsBool() == true)
                _logger.Trace("actuating sensor");
        }
    }
}