Skip to Content
Version 9.1 by Mark Kohlmann on 2021/08/20 22:14
Hide last authors
Mark Kohlmann 6.2 1 (% class="box warningmessage" %)
2 (((
Mark Kohlmann 8.1 3 Buttons 5 and 6 presently cannot be exposed to ShowRunner and will only work locally.  ZUMMESH-KPAV type keypads are not supported with this approach and require an AVBRIDGE.
Mark Kohlmann 6.2 4 )))
5
Mark Kohlmann 8.1 6 ShowRunner™ supports receiving button presses from ZUMMESH-KP* keypads.  Overriding buttons is done on a per button basis.
Mark Kohlmann 5.2 7
8 Requirements:
9
10 * JBOX w/ NETBRIDGE
11 * ZUMMESH Firmware v1.07.016 or newer
12 * NETBRIDGE defined in ShowRunner as a load controller
Mark Kohlmann 9.1 13 * ZUMMESH-KP or ZUMMESH-KPBATT (Excludes ZUMMESH-KPAV series keypads are not supported due to lack of firmware support)
Mark Kohlmann 5.2 14 * ShowRunner™ 3.004 or newer
15
Mark Kohlmann 8.1 16 Keypads have 6 buttons, 1 through 4 can be exported individually, 5 and 6 are supported by ShowRunner but not Crestron:
Mark Kohlmann 5.2 17 [[image:ZUMMESH-KP Buttons.png]]
18
19 Keypad definition in ShowRunner config:
20
21 ##//**DeviceConnectionId**//## is the KeypadId used to uniquely identify the ZUMMESH-KP.  This must be between 1 and 255.
22 ##//**DeviceHostId**// ##is the IP-ID of the RF Gateway that owns the NETBRIDGE
23 ##//**DeviceHostBranch**// ##is the RF-ID of the NETBRIDGE on the gateway
24 ##//**Model**// ##may be the actual keypad model excluding the color and finish.  Example ZUMMESH-KP10GBATT-GRY-S is "ZUMMESH-KP10GBATT".  "ZUMMESH-KP" or "ZUMMESH-KPBATT" may also be used.
25
26 ## "7": {
27 "AreaId": 2,
28 "LinkedAreaIds": null,
29 "Id": 7,
30 "Name": "Zummesh KP",
31 **~ "//DeviceConnectionId//": "1",**
32 **~ "//DeviceHostId//": "B0",**
33 **~ "//DeviceHostBranch//": 5,**
34 "SerialNumber": "",
35 "DisableOff": false,
36 "DisallowDisable": false,
37 "FlipRaiseLower": false,
38 "MasterRaiseButtonIndex": 0,
39 "MasterLowerButtonIndex": 0,
40 "HoldTime": 0.5,
41 "DoubleTapTime": 0.5,
42 "//**Model**//": "ZUMMESH-KPBATT",
43 "Enabled": true,
44 "KeypadType": "A",
45 "ControllerIds": [],
46 "DirectLoadIds": null,
47 "Actions": null,
48 }##
49
50 ==== Automatic Setup: ====
51
Mark Kohlmann 6.2 52 This method will automatically enable all buttons to report to ShowRunner™
53
Mark Kohlmann 5.2 54 * Console to ShowRunner
55 * Obtain the keypad address by querying the devices on the NETBRIDGE:
56 ##sr zummesh show devices [Gateway IP-ID in hex] [NETBRIDGE RF-ID in hex]##
57 Example: ##sr zummesh show devices B0 1A##
58 [[image:1626996842264-632.png]]
59 * Setup the keypad buttons that will report to ShowRunner™:
60 ##sr zummesh keypad custom buttons [Gateway IP-ID] [NETBRIDGE RF-ID] [Keypad Address] [Keypad Id] [List of Buttons to Override Local Logic, comma/dash separated list]##
Mark Kohlmann 6.2 61 Example: ##sr zummesh keypad custom buttons B0 1A 52E5 1 1-6##
Mark Kohlmann 5.2 62 [[image:1626997279912-938.png]]
63
64 ==== Manual Setup: ====
65
Mark Kohlmann 6.2 66 Use this setup method if you wish to assign specific ShowRunner™ button IDs to ZUMMESH-KPs or selective send buttons to ShowRunner™
67
Mark Kohlmann 5.2 68 * Connect to RF Gateway console
Mark Kohlmann 6.2 69 * ##RFRCON [NETBRIDGE RF-ID] DISPLAYDEVICES## to obtain the Addr of the Keypad
Mark Kohlmann 5.2 70 [[image:1626997350133-604.png]]
Mark Kohlmann 6.2 71 * Calculate Button IDs:
72 Keypad IDs are 1 to 255
73 Button Numbers are 1 to 6
74 Tap Action is 0
75 Hold Action is 1
76 Release Action is 2
77 ExportId = (Keypad ID << 8) + (Button Number << 4) + ButtonAction
78 Example for keypad id of 2 button 2 w/ hold action
79 ##(2 << 8) + (2 << 4) + 1 = 545 or 221h##
80 Example for keypad id of 128 button 5 w/ tap action
81 ##(128 << 8) + (5 << 4) + 0 = 32848 or 8050h##
82 * Send command per button to enable reporting:
83 ##rfrcon [NETBRIDGE-RFID] setbuttfunc [KEYPAD ADDRESS] [ButtonNumber] 22 [Tap-ExportID in hex] [Hold-ExportID in hex] [Release-ExportID in hex]
84 rfrcon 03 setbuttfunc 52E5 2 22 220 221 222##
85 [[image:1626997728072-241.png]]