User manual CUE SENSORCUE

[. . . ] 11 Software and Firmware License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 User Manual sensorCUE www. cuesystem. com Page 3 of 14 1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . sensorCUE is a temperature and daylight sensor in one small enclosure. The temperature sensor can be used for temperature monitoring and heating control. [. . . ] Each sensorCUE has its production number in the following format: CS0265. abcd. The number cd is pre-set in the factory as a default panel address value for each sensorCUE. For example, a sensorCUE with serial number CS0265. 0258 has the panel address 58. User Manual sensorCUE www. cuesystem. com Page 7 of 14 5. Programming (REMARK: the following text is relevant for sensorCUE firmware versions 20 and higher) The standard command for reading out the data from sensorCUE is: RemoteVariableGet (reference as Word, paneladdress As Byte) as Word The reference allows to identify which measured value should be read while the paneladdress identifies which sensorCUE unit is to answer. The following reference values are supported: · Reference = 0 sensorCUE firmware version · Reference = 1 temperature value · Reference = 2 lighting level value Reference = 0 sensorCUE firmware version Response value is in range 0 - 65535 The latest firmware version is 20. Example: Fw = RemoteVariableGet (0, 34) This command has assigned the firmware version number of sensorCUE-W (with the serial number CS0265. 0134) to the Fw variable. Reference = 1 temperature value The temperature is measured using 12bit resolution sensor. It covers the measuring range from +125 °C to -55 °C The temperature value is encoded into a 16-bit response value according to the following rules: Response value bit weight BIT 15 S 14 S 13 S 12 S 11 S 10 26 9 25 8 24 7 23 6 22 5 21 4 20 3 2-1 2 2-2 1 2-3 0 2-4 S means sign. S=0 for positive and S=1 for negative values. User Manual sensorCUE www. cuesystem. com Page 8 of 14 Temperature ­Response data relationship: TEMPERATURE +125°C +25. 0625°C +10. 125°C +0. 5°C +0°C -0. 5°C -10. 125°C -25. 0625°C -55°C RESPONSE VALUE (binary) 0000 0111 1101 0000 0000 0001 1001 0001 0000 0000 1010 0010 0000 0000 0000 1000 0000 0000 0000 0000 1111 1111 1111 1000 1111 1111 0101 1110 1111 1110 0110 1111 1111 1100 1001 1000 RESPONSE VALUE (hex) 07D0H 0191H 00A2H 0008H 0000H FFF8H FF5EH FE6FH FC90H Example: T = RemoteVariableGet (1, 68) This command has assigned the temperature from sensorCUE-W (with the serial number CS0265. 0168) to the T variable. Reference = 2 the lighting level value The expected response value range is ( 1 - 30000). The lowest values mean the highest lighting levels and the highest values mean dark. The typical expected return values are as follows: For straight full light the return values are below 100 For bright room the return values are about 700-800 For dark room the return values are about 3500-5000 Example: Light = RemoteVariableGet (2, 47) This command has assigned the lighting level from sensorCUE-W (with the serial number CS0265. 0047) to the Light variable. User Manual sensorCUE www. cuesystem. com Page 9 of 14 6. Program module for sensorCUE For easier programming you can use the module sensorCUE. csm. You can find it on the CUE Application CD in folder XPL Drivers and Modules. This module has two functions: Public Function Temperature (PanelAddress As Word, ByRef TemperatureAsText As String) As Integer GetTemperature returns current temperature measured in 1/10 degrees of Celsius as integer value (it allows negative values). Returned values are -550 (-55 °C) to 1250 (+125 °C). The first parameter is the panel address of sensorCUE-W, the second parameter is string, where temperature value will be stored as string ("-55. 0" to "+125. 0"). Example: Declarations: Public TemperatureInt As Integer Public TemperatureString As String *10 Program: TemperatureInt = GetTemperature(38, TemperatureString) This command has assigned the temperature from sensorCUE-W (with the serial number CS0265. 0138) to the TemperatureInt variable. If current temperature is for example +23. 5 °C, in TemperatureInt variable will be value 235. In string TemperatureString will be value "+23. 5". Public Function GetLight(PanelAddress As Word) As Word GetLight returns current lighting level as a word value. Returned values are 1 (straight full light) to cca 30000 (dark). Example: Declarations: Public LightLevel As Word Program: LightLevel = GetLight(48) This command has assigned the lighting level from sensorCUE-W (with the serial number CS0265. 0248) to the LightLevel variable. User Manual sensorCUE www. cuesystem. com Page 10 of 14 7. [. . . ] If You have purchased a Site License, You may complete only the number of installations specified in the License Agreement accompanying the Software. Copyright: The Software and software built into CUE hardware ("Firmware") are protected by copyright law and international treaty provisions. You acknowledge that no title to the intellectual property in the Software and Firmware is transferred to You. You further acknowledge that title and full ownership rights to the Software and Firmware will remain the exclusive property of CUE, and You will not acquire any rights to the Software and Firmware except as expressly set forth in this License. [. . . ]