A Cisco Wireless LAN Controller plugin for Homebridge.
This creates a Light Switch in homekit for the status of an SSID using RESTCONF.
This was tested to work with the Cisco Catalyst 9800CL. It should work with any other model of Cisco Catalyst 9800.
Run these commands:
% sudo npm install -g homebridge
% sudo npm install -g homebridge-c9800
NOTE: If you install homebridge like this:
sudo npm install -g --unsafe-perm homebridge
Then all subsequent installations must be like this:
sudo npm install -g --unsafe-perm homebridge-c9800
Example accessory config (needs to be added to the homebridge config.json): ...
"accessories": [
{
"name": "Guest WiFi",
"ipAddress": "192.168.1.115",
"username": "admin",
"password": "password",
"wlanName": "guest",
"model": "C9800CL",
"serial": "myserialno",
"timeout": 10000,
"debug": false,
"accessory": "Cisco 9800"
}
]
...
| Field | Description |
|---|---|
| accessory | (required) Must always be "Cisco 9800". |
| name | (required) The name you want to use for the light switch widget. |
| ipAddress | (required) The IP address of the WLC (should be static, not DHCP). |
| username | (required) The username used to access the WLC. |
| password | (required) The password used to access the WLC. |
| wlanName | (required) The WLAN Name associated with the SSID on the WLC. |
| model | (optional) This shows up in the homekit accessory Characteristics. |
| serial | (optional) This shows up in the homekit accessory Characteristics. |
| timeout | (optional) The timeout duration in ms for the web API calls. |
| debug | (optional) Enables additional logging. |
To make your WLC work with the plugin:
- Connect your WLC to your network.
- Configure your WLC.
- Enable netconf on the WLC.
- Enable restconf on the WLC.
- Write down the IP address of the WLC.
- Create your config file according to the above example (or using the Homebridge UI).
Check out https://github.com/nfarina/homebridge for more information about Homebridge.
This project is licensed to you under the terms of the Cisco Sample Code License.