Universal filter function with code specification as value
Contents

1.Description

This module is used in conjunction with the DCS IP gateway (Gira Order No. 2620 xx). It evaluates code entries of a Gira Keyless In code lock and enables functions in the HS/FS to be run. Only those code entries will be evaluated which are confirmed by pressing the "F" button on the code keypad. The maximum code length is 4 characters in a value range 0 to 9.
With the optional assignment of the Inputs 2 to 8, the arriving telegrams can be filtered with regard to the following properties:
  • Bus addresses
  • Code to be evaluated
  • 1st code number
  • 2nd code number
  • 3rd code number
  • 4th code number
  • Sender type
  • Target address
This means that: With inputs set, only telegrams (with code commands) are evaluated which match the filter properties. Here it is irrelevant whether one or more inputs are assigned
Examples:
  1. With the bus address "0xABCDEF" set, only telegrams of a bus user are evaluated which have been sent from the bus address "0xABCDEF".
  2. By specifying a code with the value "123", all telegrams can be evaluated which contain code commands and for which a code 123 has been received.
  3. Filtering for the sender type (home station or door station) is also possible by specifying the desired value as the sender type.
"Any desired" scenarios can be evaluated by using a coordinated assignment of the inputs 2 to 8.
Note
If no filters are set, then all telegrams with code commands confirmed and completed with the "F" button will be evaluated.
Determination of the optional filter parameters
Two different methods are available for determining the filter parameters:
  1. Use of the HomeServer cheat sheet in the DCS IP gateway.
  2. Use of the logic node Display basic parameters in the "Door communication\Additional nodes" folder.
After the parameters are known, it is recommended that the inputs be assigned either group addresses or fixed values.

2.Inputs

No.NameInitialisationDescription
1Door communication Receive""
(14 bytes – Text)
Here the internal communication object Door communication Receive is assigned by the DCS IP gateway.
2Bus address""
(14 bytes – Text)

Optional specification of a bus address to which filtering should be applied.
The bus address must have the following format:
Example: 0xABCD07 or 0x42A305
Note
If this input remains free, the telegrams of random bus addresses are evaluated.
If a communication object is assigned but is not written to or provided with an initialisation value, then the object is considered not to be set. This means the incoming telegrams of all bus addresses are evaluated.
3Code (max. 4 digits)-1
Value range 0 to 9999:

Optional specification of a code to which filtering should be applied. The code is specified as value
The code has a maximum of 4 places.
Only numbers in the range from 0 to 9 are possible.
Note
Codes which begin with a 0 will not be evaluated.
4Code number 1""
(14 byte text)
Optional specification of the 1st number of the code to which filtering is to be applied. Numbers in the range from 0 to 9 are possible.
Example: Code position 1 = 1
All entered codes with a leading 1 will be evaluated.
Note
If a code is specified at the same time, then the digits of the respective positions must match.
5Code number 2""
(14 byte text)
Optional specification of the 2nd number of the code to which filtering is to be applied. Numbers in the range from 0 to 9 are possible.
Example: Code position 2 = 1
All codes will be evaluated which have a 1 at the 2nd position.
Note
If a code is specified at the same time, then the digits of the respective positions must match.
6Code number 3""
(14 byte text)
Optional specification of the 3rd number of the code to which filtering is to be applied. Numbers in the range from 0 to 9 are possible.
Example: Code position 3 = 1
All codes will be evaluated which have a 1 at the 3rd position.
Note
If a code is specified at the same time, then the digits of the respective positions must match.
7Code number 4""
(14 byte text)
Optional specification of the 4th number of the code to which filtering is to be applied. Numbers in the range from 0 to 9 are possible.
Example: Code position 4 = 1
All codes will be evaluated which have a 1 at the 4th position.
Note
If a code is specified at the same time, then the digits of the respective positions must match.
8Sender type0
Optional specification of a sender type to which filtering should be applied.
The following parameters are possible:
160 = Door station
161 = Living area intercom
162 = Living area intercom receiver
163 = Bus control device
164 = Switching actuator
165 = TC gateway
166 = Additional gong/Bus chiming mechanism
167 = Button interface
168 = DCS IP gateway
9Target address"0x000010"
(14 bytes – Text)

Optional specification of a target address to which filtering should be applied. The target address must have the following format here:
Example: 0xABCD07 or 0x42A305
Note
If the initialisation value remains unchanged, then the telegrams of any desired target addresses will be evaluated.
If a communication object is assigned but is not written to or provided with an initialisation value, then the object is considered not to be set. This means the arriving telegrams of all target addresses are evaluated.
......

3.Outputs

No.NameInitialisationSBCDescription
1Trigger - Module active0s
A 1 is sent on this output when the input telegram matches all filter properties. If filters are missing, then a 1-telegram will be sent each time the code command of a code lock is received. For input telegrams which do not meet the filter criteria, the output sends a 0.
2Trigger - Module inactive0s
With the module blocked, the output sends a 1 when the code has been correctly received. If the wrong code has been received in the blocked module, the output sends a 0.
3Bus address""s
(14 bytes – Text)
Output of the bus address in the format: 0xABEF07
4Code""s
(14-byte text):
Output of the entire code (maximum of 4 digits) Numbers in the range from 0 to 9 are possible.
Note
If the code is to be compared to several default codes, then the module 7x universal text comparator (text) from the folder Door communication\Additional modules can be used for this purpose.
5Code number 1""s
(14 byte text)
The 1st position of the code is output here.
Example: Code=1234
Output: 1
6Code number 2""s
(14 byte text)
The 2nd position of the code is output here.
Example: Code=1234
Output: 2
7Code number 3""s
(14 byte text)
The 3rd position of the code is output here.
Example: Code=1234
Output: 3
8Code number 4""s
(14 byte text)
The 4th position of the code is output here.
Example: Code=1234
Output: 4
9Sender type0s
Device type from which the TC bus telegram has been sent.

160 = Door station
161 = Living area intercom
162 = Living area intercom receiver
163 = Bus control device
164 = Switching actuator
165 = TC gateway
166 = Additional gong/Bus chiming mechanism
167 = Button interface
168 = DCS IP gateway
10Target address""s
(14-byte text):
Output of the target address in the format: 0xABEF07
11Number of digits0s
(Value 0 to 4)
The code length is output here.
Example: Code=123
Code length=3
12Error output0s
The output can be routed to the outside as a diagnostic output if necessary or during start-up in order to obtain information about possible errors.
Values in the value range 0 to 5 are sent.
0 = An error has not occurred.
1 = The default values must be checked.
2 = The characters of the bus or target address must be checked.
3 = A telegram with a different structure has been received (e.g. a light call).
4 = The logic is blocked.
5 = The (individual) characters of the code specification must be checked (numeric values from 0 to 9).
s = send, sbc = send by change

4.Other

Recalculation during start:No
Module is retentive:No
Internal designation:16948
Category:Door communication\Receive\Evaluate code from code keypad

5.Similar functions

Receive
Receive\Evaluate code from code keypad
Send
Additional modules