Zummesh Keypad Custom Programming

Last modified by Mark Kohlmann on 2024/04/05 19:48

Buttons 5 and 6 presently cannot be exposed to ShowRunnerCLC™ and will only work locally.  ZUMMESH-KPAV type keypads are not supported with this approach and require an AVBRIDGE.

ShowRunnerCLC™ supports receiving button presses from ZUMMESH-KP* keypads.  Overriding buttons is done on a per button basis.

Requirements:

  • JBOX w/ NETBRIDGE
  • ZUMMESH Firmware v1.07.016 or newer
    • NETBRIDGE firmware v1.013.0021
    • ZUM-KPBATT firmware v0010000113
    • ZUM-JBOX-SIM firmware v0010000067
  • NETBRIDGE defined in ShowRunner as a load controller
  • ZUMMESH-KP or ZUMMESH-KPBATT (Excludes ZUMMESH-KPAV series keypads are not supported due to lack of firmware support)
  • ShowRunner™ 3.004 or newer

Keypads have 6 buttons, 1 through 4 can be exported individually, 5 and 6 are supported by ShowRunner but not Crestron:
ZUMMESH-KP Buttons.png

JBOX-SIM is supported.  O is button 1, V is button 2, and D is button 3.

Keypad definition in ShowRunner config:

DeviceConnectionId is the KeypadId used to uniquely identify the ZUMMESH-KP.  This must be between 1 and 255.
DeviceHostId is the IP-ID of the RF Gateway that owns the NETBRIDGE
DeviceHostBranch is the RF-ID of the NETBRIDGE on the gateway
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.

    "7": {
      "AreaId": 2,
      "LinkedAreaIds": null,
      "Id": 7,
      "Name": "Zummesh KP",
      "DeviceConnectionId": "1",
      "DeviceHostId": "B0",
      "DeviceHostBranch": 5,
      "SerialNumber": "",
      "DisableOff": false,
      "DisallowDisable": false,
      "FlipRaiseLower": false,
      "MasterRaiseButtonIndex": 0,
      "MasterLowerButtonIndex": 0,
      "HoldTime": 0.5,
      "DoubleTapTime": 0.5,
      "Model": "ZUMMESH-KPBATT",
      "Enabled": true,
      "KeypadType": "A",
      "ControllerIds": [],
      "DirectLoadIds": null,
      "Actions": null,
    }

Automatic Setup:

This method will automatically enable all buttons to report to ShowRunnerCLC™

  • Console to ShowRunnerCLC™
  • Obtain the keypad address by querying the devices on the NETBRIDGE:
    sr zummesh show devices [Gateway IP-ID in hex] [NETBRIDGE RF-ID in hex]
    Example: sr zummesh show devices B0 1A
    1626996842264-632.png
  • Setup the keypad buttons that will report to ShowRunnerCLC™:
    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]
    Example: sr zummesh keypad custom buttons B0 1A 52E5 1 1-6
    1626997279912-938.png

Manual Setup:

Use this setup method if you wish to assign specific ShowRunnerCLC™ button IDs to ZUMMESH-KPs or selective send buttons to ShowRunnerCLC™

  • Connect to RF Gateway console
  • RFRCON [NETBRIDGE RF-ID] DISPLAYDEVICES to obtain the Addr of the Keypad
    1626997350133-604.png
  • Calculate Button IDs:
    Keypad IDs are 1 to 255
    Button Numbers are 1 to 6
    Tap Action is 0
    Hold Action is 1
    Release Action is 2
    ExportId = (Keypad ID << 8) + (Button Number << 4) + ButtonAction
    Example for keypad id of 2 button 2 w/ hold action
    (2 << 8) + (2 << 4) + 1 = 545 or 221h
    Example for keypad id of 128 button 5 w/ tap action
    (128 << 8) + (5 << 4) + 0 = 32848 or 8050h
  • Send command per button to enable reporting:
    rfrcon [NETBRIDGE-RFID] setbuttfunc [KEYPAD ADDRESS] [ButtonNumber] 22 [Tap-ExportID in hex] [Hold-ExportID in hex] [Release-ExportID in hex]
    rfrcon 03 setbuttfunc 52E5 2 22 220 221 222
    1626997728072-241.png