IoT Portal Part 2 - Creating a Thing definition

If you already have a Thing definition, then you can skip this part and go to IoT PortalPart 3 - Creating an Application token

The Thing definition is analogous to a class in object oriented programming. A class is a template for defining objects. It specifies the names and types of variables that exists in an object, as well as "methods"--procedures for operating on those variables. Similarly in the Management Portal a Thing definition contains the attributes, functions and properties that exists in a Thing.

thing definition models the attributes, alarms, properties, methods, tunnels, presentation information, and other characteristics of a particular type of item that is a portion of your IoT solution.  To define a thing definition, do the following:

  1. From the  Developer main screen in the  THINGS group, click  Thing definitions.
    The  Thing definitions screen appears.
  2. Click the  New thing definition button

    The  Adding thing definition page appears.
  3. Enter the following fields to create a new Thing definition:
    1KeyThe key for the thing definition. For more information on key formats and limitations, see Field Formats and Limitations
    2NameThe name of the thing definition
    3Auto def attributesAllows the thing to auto define its attributes
    4Auto def propertiesAllows the thing to auto define its properties
    5Allow ad-hoc tunnelsAllows the thing to connect to ad-hoc tunnels
  4. Define the characteristics of the thing definition using the following characteristic tabs
    AttributesAttributes are simple key value string pairs for storing meta-data for a thing. For example, The VIN on a car, a serial number of a piece of equipment, a customer name, and so on.

    Alarms are implemented as a state machine, where the events are defined as alarm states. For example: For a thing that represents a tank, defining an alarm for low level. For a thing that represents an engine, defining an alarm for whether the engine is on or off.
    Things can have multiple alarms. Each alarm can have multiple states. Alarms are graphed since they have a state and timestamp component.

    PropertiesProperties are used to store historical data for a thing, at a specific timestamp. The data could be anything, it is stored as a floating point value with the "real" value, as well as aggregations at 1 hour and 1 day for averages, minimum, and maximum values.
    Properties are graphed since they have a value and timestamp component.
    MethodsMethods define the interface to functions that are implemented in a gateway trigger (using  TR50 Method trigger event type) or are implemented in an application. The "calling" of a thing's method can be from a gateway trigger, from an application, from the thing's page in the Management Portal, or from a cloud trigger within the IoT Portal.
    TunnelsTunnels support a client application to connect to a server application on a gateway, using the IoT Portal as the communication mechanism.
    Locations Locations are used to define how things that have this thing definition respond to location information.
    FirmwareFirmware tab is used to define the Firmware.
  5. Click Add.