Homebridge Meraki Control

Homebridge plugin for Meraki Dashboard and Devices control using RESTFull API.

Package Requirements

Package	Installation	Role	Required
Homebridge	Homebridge Wiki	HomeKit Bridge	Required
Config UI X	Config UI X Wiki	Homebridge Web User Interface	Recommended
Meraki Control	Plug-In Wiki	Homebridge Plug-In	Required

About The Plugin

• Dashboard:
  • Expose Clients filtered by Mac Address.
  • Apply policy Normal, Whitelisted, Group Policy / Blocked for clients.
  • Enable/Disable prefix C. for Clients name displayed in HomeKit.app.
  • Expose Contact Sensors in HomeKit app for exposed Clients.
• Access Points:
  • Switch ON/OFF SSIDs in the organisation.
  • Enable/Disable prefix W. for SSIDs name displayed in HomeKit.app.
  • Hide Unconfigured SSIDs networks, if the name contain word Unconfigured.
  • Hide SSIDs filtered by network Name.
  • Expose Contact Sensors in HomeKit app for exposed SSIDs.
• Switches:
  • Switch ON/OFF ports.
  • Switch ON/OFF POE+ ports.
  • Enable/Disable prefix Port Number for Ports name displayed in HomeKit.app.
  • Hide Uplink ports, if the port name contain word Uplink.
  • Hide Ports filtered by port Name.
  • Expose Contact Sensors in HomeKit app for exposed Ports.
• Siri can be used to switch ON/OFF SSIDs, Policy, Ports.
• Home automations and shortcuts can be used for all functions.

Configuration

• Run this plugin as a Child Bridge (Highly Recommended), this prevent crash Homebridge if plugin crashes.
• Install and use Homebridge Config UI X to configure this plugin.
• The sample-config.json can be edited and used as an alternative.
• Be sure to always make a backup copy of your config.json file before making any changes to it.

Key	Description
name	Here set the accessory Name to be displayed in Homebridge/HomeKit.
host	Here set the API Path like https://n123.meraki.com, do not use https://api.meraki.com.
apiKey	Here set the X-Cisco-Meraki-API-Key.
organizationId	Here set the Organization Id.
networkId	Here set the Network Id.
dashboardClientsControl	This option Enable/Disable dashboard clients control.
enablePrefixForClientName	This option enable prefix C. for Client name displayed in HomeKit app.
enableSonsorClients	This option expose Contact Sensor in HomeKit app for all exposed Clients.
dashboardClientsPolicy.name	Here set the Name to be displayed in the the Homebridge/HomeKit for this Client.
dashboardClientsPolicy.mac	Here set the Client Mac Address which You want expose to the Homebridge/HomeKit.
dashboardClientsPolicy.type	Here choice the policy Type to be appiled for this Client.
dashboardClientsPolicy.mode	Here Activate/Deactivate this Client control.
accessPointsControl	This option Enable/Disable control of Access Points.
hideUnconfiguredSsids	If enabled, all Unconfigured SSIDs will be hidden and not exposed to the Homebridge/HomeKit, the name of this SSID must start with Unconfigured.
enablePrefixForSsidsName	This option enable prefix W. for SSIDs name displayed in HomeKit app.
hideSsids.name	Here set SSID Name which You want hide and not expose to the Homebridge/HomeKit.
hideSsids.mode	Here Activate/Deactivate this SSID control.
enableSonsorSsids	This option expose Contact Sensor in HomeKit app for all exposed SSIDs.
switchesControl	This option Enable/Disable control of Switches.
switches.name	Here set the Name for this Switch.
switches.serialNumber	Here set the Serial Number for this Switch.
switches.hideUplinkPorts	If enabled, all Uplink ports will be hidden and not exposed to the Homebridge/HomeKit, the name of this Port must start with Uplink.
switches.enablePrefixForPortName	This option enable prefix Port Number for Port name displayed in HomeKit app.
switches.enablePoePortsControl	This option enable POE control for controled ports.
switches.enableSensorPorts	This option enable POE control for controled ports.
switches.mode	Here Activate/Deactivate this Swich control.
switches.hidePorts	Array of hidden Ports.
switches.hidePorts.name	Here set Port Name which You want hide and not expose to the Homebridge/HomeKit.
switches.hidePorts.mode	Here Activate/Deactivate this Port control.
enableDebugMode	This enable deep log in homebridge console.
disableLogInfo	This disable display log values and states on every it change.
disableLogDeviceInfo	This disable display log device info on plugin start.
refreshInterval	Here set the data refresh time in seconds.