The HTTP interface is used to send and receive data from and to an HTTP server. The HTTP data point definition table defines all HTTP data points that are used within the projectWithin this configuration file, the channels of the connected HDL Buspro devices can be configured.
| Info | ||
|---|---|---|
| ||
<WorkspaceDirectory>\DataFiles\xio.HTTPHdl.DatapointDefinitions.datChannels.dat |
| Code Block | ||
|---|---|---|
| ||
HdlDemoCase;1;1;SingleChannel;7
HdlDemoCase;1;3;AcControl;1 |
Each channel has its own row with the parameters separated by a semicolon. (CSV-format)
The channel definitions can be edited in the NETx Core Server Studio under Modules > HDL > Channel Definitions
| Col# | Parameter | Description | Scope | Unit | Mandatory / default value | |
|---|---|---|---|---|---|---|
| 1Name | Interface name | The name of the data point. In combination with the Path, it must be unique. | string | none | mandatory | |
| 2 | Path | The structure that is used to represent the data point. In combination with the Name, it must be unique. | string | none | empty | |
| 3 | Data type | The type of the data point. | BOOL, STR, BYTE, CHAR, INT8, UINT8, INT16, UINT16, INT32, UINT32, INT64, UINT64, FLOAT, DOUBLE, DATE, TIME | none | STR | |
| 4 | Access mode | The access rights of the data point. Allowed values are R (read-only), W (write-only), RW (read and writable). | R, W, RW | none | R | |
| 5 | Polling Url | The URL which is used to retrieve the data point value. The server polls by HTTP GET requests to this URL. If empty, polling is not available. | string | none | empty | |
| 6 | Polling interval | The polling interval in milliseconds. | 50 – 65535 | ms | 5000 | |
| 7 | Polling Resource | The resource that is used for polling. It has to match the name that is used in the HTTP resource definition. | Reference to HTTP resource definition | none | empty | |
| 8 | Polling Parameters | A comma-separated list of parameters that are used to replace the placeholders within the polling resource ({0}, {1}, ...). | string | ms | empty | |
| 9 | Update Url | The URL which is used to update the data point values. The server issues HTTP PUT, POST or GET requests to this URL. If empty, updating of the values is not possible. | string | none | empty | |
| 10 | Update Method | The web update request method. | POST, PUT, GET | none | POST | |
| 11 | Update Resource | The resource that is used for updating. It has to match the name that is used in the HTTP resource definition. | Reference to HTTP resource definition | none | empty | |
| 12 | Update Parameters | A comma-separated list of parameters that are used to replace the placeholders within the update resource ({0}, {1}, ...). | string | none | empty | |
| 13 | Persistent | If enabled, the last known data point value is restored after server start up. | true/false | none | false | |
| 14 | Synchronize | If enabled, the value is synchronized with the backup server if used. | true/false | none | true | |
| 15 | Authentication User | Username for Basic or Digest HTTP authentication if required by the HTTP server. If empty, no HTTP authentication is used. | string | none | empty | |
| 16 | Authentication Password | Password for Basic or Digest HTTP authentication if required by the HTTP server. If empty, no HTTP authentication is used. | string | none | empty | |
| 17 | Additional HTTP Headers | A list of additional HTTP headers which is included in each HTTP request, e.g. for authentication purposes. Additional headers must have the following form: "<key1>: <value1>\r\n<key2>: <value2>\r\n<key3>: <value3>..." | string | none | empty | |
| 18 | Authentication Method | The authentication method (Basic or Digest) if required by the HTTP server. | None, Basic, Digest, Bearer | none | None | |
| 19 | Authentication Config | If bearer authentication is used, the bearer definition name must be specified here. It has to match the name that is used in the HTTP bearer authentication. | Reference to HTTP bearer authentication | none | emptyinterface the device is connected to. (As defined in HDL interface configuration) | string |
| 2 | Subnet ID | HDL Buspro subnet id of the device. | 0 - 254 | |||
| 3 | Device ID | HDL Buspro device id of the device. | 0 - 254 | |||
| 4 | Type | Device type. See list below. | string | |||
| 5 | Channel | Channel number. See list below. | 0 - 254 / string |
Available Types
| Type | Description | Number of created server items |
|---|---|---|
| SingleChannel | Creates a single server item NETx\XIO\HDL\<InterfaceName>\Single channel\<SubnetId>\<DeviceID>\<Channel>\Level | 1 |
| UniversalSwitch | Creates a single server item NETx\XIO\HDL\<InterfaceName>\Universal switch\<SubnetId>\<DeviceID>\<Channel>\Value | 1 |
| CurtainSwitch | Creates a single server item NETx\XIO\HDL\<InterfaceName>\Curtain switch\<SubnetId>\<DeviceID>\<Channel>\Value | 1 |
| AcControl | Creates server items for all available AC control values (Mode, status, temperatures, ...) under NETx\XIO\HDL\<InterfaceName>\AC control\<SubnetId>\<DeviceID>\<Channel>\ Channel equals AC number. | 14 |
| Temperature | Creates a single server item NETx\XIO\HDL\<InterfaceName>\Temperature\<SubnetId>\<DeviceID>\<Channel>\Temperature | 1 |
| HotelRoomAc | Creates server items for all available hotel room AC control values (Mode, status, temperatures, ...) under NETx\XIO\HDL\<InterfaceName>\Hotel system AC control\<SubnetId>\<DeviceID>\<Channel>\ Channel equals AC number. | 11 |
| Doorbell | Creates server items for all available doorbell status flags under NETx\XIO\HDL\<InterfaceName>\Doorbell\<SubnetId>\<DeviceID>\ Doorbell does not use channel numbers. Set the parameter to 0. | 8 |
| RoomStatus | Creates server items for all available room status fields (state, current scene, doorbell flags, alarm flags, channels, ...) under NETx\XIO\HDL\<InterfaceName>\Doorbell\<SubnetId>\<DeviceID>\<Channel>\ Use HDL Mac as hexadecimal string without spaces as channel. eg: HdlDemoCase;1;1;RoomStatus;1637e5664c23301f | 66 (Includes integrated doorbell, alarm flags and 48 channels) |
| SceneControl | Creates a single server item NETx\XIO\HDL\<InterfaceName>\Scene control\<SubnetId>\<DeviceID>\<Channel>\Scene Channel equals area no. | 1 |