Wiki source code of Zummesh Keypad Custom Programming
Version 5.2 by Mark Kohlmann on 2021/07/22 23:42
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | ShowRunner™ supports receiving button presses from ZUMMESH-KP* keypads. AV keypads have not been verified for support yet, this only applies to regular lighting keypads. Overriding buttons is done on per button basis. | ||
2 | |||
3 | Requirements: | ||
4 | |||
5 | * JBOX w/ NETBRIDGE | ||
6 | * ZUMMESH Firmware v1.07.016 or newer | ||
7 | * NETBRIDGE defined in ShowRunner as a load controller | ||
8 | * ZUMMESH-KP or ZUMMESH-KPBATT (Excludes ZUMMESH-KPAV series keypads) | ||
9 | * ShowRunner™ 3.004 or newer | ||
10 | |||
11 | Keypads have 6 buttons, each can be exported individually: | ||
12 | [[image:ZUMMESH-KP Buttons.png]] | ||
13 | |||
14 | Keypad definition in ShowRunner config: | ||
15 | |||
16 | ##//**DeviceConnectionId**//## is the KeypadId used to uniquely identify the ZUMMESH-KP. This must be between 1 and 255. | ||
17 | ##//**DeviceHostId**// ##is the IP-ID of the RF Gateway that owns the NETBRIDGE | ||
18 | ##//**DeviceHostBranch**// ##is the RF-ID of the NETBRIDGE on the gateway | ||
19 | ##//**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. | ||
20 | |||
21 | ## "7": { | ||
22 | "AreaId": 2, | ||
23 | "LinkedAreaIds": null, | ||
24 | "Id": 7, | ||
25 | "Name": "Zummesh KP", | ||
26 | **~ "//DeviceConnectionId//": "1",** | ||
27 | **~ "//DeviceHostId//": "B0",** | ||
28 | **~ "//DeviceHostBranch//": 5,** | ||
29 | "SerialNumber": "", | ||
30 | "DisableOff": false, | ||
31 | "DisallowDisable": false, | ||
32 | "FlipRaiseLower": false, | ||
33 | "MasterRaiseButtonIndex": 0, | ||
34 | "MasterLowerButtonIndex": 0, | ||
35 | "HoldTime": 0.5, | ||
36 | "DoubleTapTime": 0.5, | ||
37 | "//**Model**//": "ZUMMESH-KPBATT", | ||
38 | "Enabled": true, | ||
39 | "KeypadType": "A", | ||
40 | "ControllerIds": [], | ||
41 | "DirectLoadIds": null, | ||
42 | "Actions": null, | ||
43 | }## | ||
44 | |||
45 | ==== Automatic Setup: ==== | ||
46 | |||
47 | * Console to ShowRunner | ||
48 | * Obtain the keypad address by querying the devices on the NETBRIDGE: | ||
49 | ##sr zummesh show devices [Gateway IP-ID in hex] [NETBRIDGE RF-ID in hex]## | ||
50 | Example: ##sr zummesh show devices B0 1A## | ||
51 | [[image:1626996842264-632.png]] | ||
52 | * Setup the keypad buttons that will report to ShowRunner™: | ||
53 | ##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]## | ||
54 | Example: sr zummesh keypad custom buttons B0 1A 52E5 1 1-6 | ||
55 | [[image:1626997279912-938.png]] | ||
56 | |||
57 | ==== Manual Setup: ==== | ||
58 | |||
59 | * Connect to RF Gateway console | ||
60 | * RFRCON [NETBRIDGE RF-ID] DISPLAYDEVICES | ||
61 | [[image:1626997350133-604.png]] | ||
62 | * |