Qlite interface configuration
- Wolfgang Granzer
- Andreas Bernegger (Unlicensed)
The interface configuration can be edited in the NETx Core Server Studio at Modules > Qlite> Interface Definitions
Col# | Parameter | Description | Scope | Unit | Default value |
|---|---|---|---|---|---|
1 | Name | Name of the interface. Must be unique. | string | None | |
2 | IP address | IP address of the QL-NE100 device. | IP-Address | None | |
3 | Port | UDP port of the QL-NE100 device. | Port number | None | 57277 |
4 | Send interval | Time delay between sending two messages. | integer | ms | 200 |
5 | Log messages | If set to true, all received and sent messages are logged in <WorkspaceDirectory>\LogFiles\nxaQlite-<InterfaceName>_<Datecode>.log | boolean | None | False |
6 | Ping after | Start pinging the interface after not receiving packets for this time period. | integer | s | 50 |
7 | Ping interval | Time between sending pings to the interface. | integer | s | 10 |
8 | Ping retries | Connection to the interface is considered lost after this amount of failed pings. | integer | None | 2 |
9 | Channel Ranges | Defines the channels that shall be available as server items. It is possible to define comma separated list that also contains ranges. E.g. 1-10,15,250-310. If left empty, no channels are available. | integer list | 1 - 512 | None |
10 | Show Service Items | If set to true, five service items will be shown for each interface. | boolean | None | False |
Send interval
The NETx Server has to request the current values of all devices on startup. This means a lot of requests will be sent at the same time. In order to avoid overloading of the bus, these messages are queued.
The send interval parameter sets the time delay between sending each of the queued messages. Write requests have a higher priority than get status requests.
The queue sizes can be monitored with the corresponding server items NETx\XIO\Qlite\<InterfaceName>\Request queue size and NETx\XIO\Qlite\<InterfaceName>\Write queue size.
Log messages
If enabled, all received and sent messages are logged. This can be useful for troubleshooting unintended behaviors. However, logging is disabled by default to save disk space.
Ping
The NETx Server is monitoring the connection to each interface.
If the NETx Server has not received any packets from the interface for the timespan set in "Ping after", it sends a ping packet to the interface.
When the NETx Server receives a response, the timer is reset.
If the NETx Server does not receive a response, it keeps sending ping packets after every "Ping interval" seconds.
If the NETx Server has sent the number of ping packets as set in "Ping retries" without a response, the connection to the interface is considered lost and the interface's GATEWAY item is set to False.
When the connection is reestablished (the NETx Server receives a ping response or any other packet), the GATEWAY item is set to True and the values of all devices/channels are requested from the bus.
Interface items
Channels:
All 512 channels of a QL-NE100 device are represented as items under the "Channels" branch. This items can be used to indicate and set the value of channels.
Services:
The status of the following services are represented as items:
Key Card Inserted
Key Card Off
Do Not Disturb
Make Up Room
Laundry
These items are read only.
Â