EnOcean Range and Scale Values

Understanding Range and Scale Values

EnOcean device values are scaled according to the minRange, maxRange, minScale, and maxScale configurations specified in the XML mapping file.

For example, here is the XML for FIL1204:

<?xml version="1.0" encoding="utf-8"?>
<si:mapping xmlns:si="http://schema.deltacontrols.com/schemas/entelibus/SpecialInterface1.0" xmlns:eno="http://schema.deltacontrols.com/schemas/entelibus/enOceanMapping" type="enocean">
	<si:variable>
		<si:name>Supply voltage (OPTIONAL)</si:name>
		<si:type>AV</si:type>
		<si:advalue>
			<eno:analogValue>
				<eno:ioNumber>1</eno:ioNumber>	
				<eno:offset>0</eno:offset>
				<eno:size>8</eno:size>
				<eno:minRange>0</eno:minRange>
				<eno:maxRange>250</eno:maxRange>		
				<eno:minScale>0</eno:minScale>
				<eno:maxScale>5.0</eno:maxScale>
				<eno:value>0</eno:value>
			</eno:analogValue>
		</si:advalue>
	</si:variable>

In the above code, the raw value range of 0–250 corresponds to engineering values of 0–5 VDC.

The minRange may sometimes be greater than the maxRange, as in the following example:

<eno:minRange>255</eno:minRange>
<eno:maxRange>0</eno:maxRange>
<eno:minScale>-40</eno:minScale>
<eno:maxScale>0</eno:maxScale>

In the above code, the raw value 255 corresponds to -40°C (-40°F) and the raw value 0 corresponds to 0°C (32°F).

You can edit the minRange, maxRange, minScale, and maxScale values in the Translation table in the FIL object. See Working with Mapping Files.

The following example shows two mapping rows: the first shows a 0°C to 40°C (32°F to 104°F) temperature range and the second shows a -40°C to 0°C (-40°F to 32°C) temperature range.

For an AV mapping, the gateway does not support minScale and maxScale both having a range value of 0. If you do not want scales for an AV, match the scale values to the range values.

Using a BV Object to Show Off/On States

You can use a BV object to show the simple Off and On states of a device.

The EEP profile uses a scale and range match to determine the current state of the device. For example, in the A5-07-01 (FIL1204) profile for motion/occupancy sensors, a raw PIR value in the range 0 to 127 corresponds to OFF (unoccupied), while a raw PIR value in the range 128 to 255 corresponds to ON (occupied).

You could create the following objects to represent the device's PIR value:

Name	Reference (O3 Edge)
PIR Status - Off	BV3DD002 (e.g., BV301002)
PIR Status - On	BV3DD003 (e.g., BV301003)

A value greater than 128 would indicate that the room is occupied, while a value less than or equal to 128 would indicate that the room is unoccupied.