magic7s / homebridge-meraki-control

Homebridge plugin for Meraki devices using RESTFull API, publish as independent external platform accessory.

Homebridge Meraki Control

Homebridge plugin for Meraki devices using RESTFull API.

Package

1. Homebridge
2. Homebridge Config UI X

Installation

1. Follow the step-by-step instructions on the Homebridge Wiki for how to install Homebridge.
2. Follow the step-by-step instructions on the Homebridge Config UI X for how to install Homebridge Config UI X.
3. Install homebridge-meraki-control using: npm install -g homebridge-meraki-control or search for meraki in Config UI X.

Know issues

1. If use with Hoobs possible config incompatibilty.

HomeKit pairing

1. Each accessories needs to be manually paired.
2. Open the Home app on your device.
3. Tap the Home tab, then tap .
4. Tap Add Accessory, and select I Don't Have a Code or Cannot Scan.
5. Enter the Homebridge PIN, this can be found under the QR code in Homebridge UI or your Homebridge logs, alternatively you can select Use Camera and scan the QR code again.

Note

1. Versin 0.6.0 and above need to be used with Homebridge min. v1.3.x.

Info

1. This plugin control ON/OFF configured WLAN networks in Your organisation(MR devices).
2. More comming soon...

Configuration

1. Use Homebridge Config UI X to configure the plugin (strongly recomended), or update your configuration file manually. See sample-config.json in this repository for a sample or add the bottom example to Your config.json file.
2. In host set the baseUrl like https://n123.meraki.com, do not use https://api.meraki.com.
3. In apiKey set the X-Cisco-Meraki-API-Key.
4. In organizationId set Your organizationId.
5. In networkId set Your networkId.
6. In deviceSerial set device serial.
7. In wlanControl set numbers of configured SSIDs in Your network. (removed in 0.5.0 and above)
8. In refreshInterval set the data refresh time in seconds.
9. If disableLogInfo is enabled, disable log info, all values and state will not be displayed in Homebridge log console.
10. If displayOnlyConfiguredWlan is enabled, all unconfigured SSIDS will be hidden.
11. manufacturer, model, serialNumber, firmwareRevision - optional branding data displayed in Home.app

        {
            "platform": "Meraki",
            "devices": [
                {
                    "name": "Meraki MR52",
                    "host": "https://n123.meraki.com",
                    "apiKey": "01032453453421923",
                    "organizationId": "123456789",
                    "networkId": "L_0123456789",
                    "refreshInterval": 10,
                    "disableLogInfo": false,
                    "displayOnlyConfiguredWlan": false,
                    "manufacturer": "Manufacturer",
                    "modelName": "Model",
                    "serialNumber": "Serial Number",
                    "firmwareRevision": "Firmware Revision"
                }
            ]
        }

Whats new:

https://github.com/grzegorz914/homebridge-meraki-control/blob/master/CHANGELOG.md

Development

• Pull request and help in development highly appreciated.