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
Clientsfiltered by Mac Address. - Apply policy
Normal, Whitelisted, Group Policy/Blockedfor clients. - Enable/Disable prefix
C.forClientsname displayed in HomeKit.app. - Expose Contact Sensors in HomeKit app for exposed
Clients.
- Expose
- Access Points:
- Switch
ON/OFF SSIDsin the organisation. - Enable/Disable prefix
W.forSSIDsname displayed in HomeKit.app. - Hide
Unconfigured SSIDsnetworks, if the name contain word Unconfigured. - Hide
SSIDsfiltered by network Name. - Expose Contact Sensors in HomeKit app for exposed
SSIDs.
- Switch
- Switches:
- Switch
ON/OFFports. - Switch
ON/OFFPOE+ ports. - Enable/Disable prefix
Port NumberforPortsname displayed in HomeKit.app. - Hide
Uplinkports, if the port name contain word Uplink. - Hide
Portsfiltered by port Name. - Expose Contact Sensors in HomeKit app for exposed
Ports.
- Switch
- 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.jsoncan 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. |