Munin plugin for the Motorola Surfboard 6120 Cable Modem
===========================

Description
===
This script uses the Munin monitoring framework to graph SNR (signal-to-noise) ratios and power levels of your SB6120 cable modem. This script will handle the possible multiple bonded channels your cable modem can use with your ISP.

Requirements
===
* Python
* A Motorola SB6120 Cable Modem (http://www.motorola.com/Consumers/US-EN/Consumer-Product-and-Services/Cable-Modems-and-Gateways/SURFboard-Cable-Modem-SB6120-US-EN)

Installation
===
Grab source from Github repo: git://github.com/jforman/munin-surfboard6120.git

On Debian or Ubuntu:
1. cp surfboard6120_.py /usr/share/munin/plugins
2. ln -s /usr/share/munin/plugins/surfboard6120_.py /etc/munin/plugins/surfboard6120_snr.py
3. ln -s /usr/share/munin/plugins/surfboard6120_.py /etc/munin/plugins/surfboard6120_pwr.py

Restart munin-node

Several iterations of the munin-cron service will need to run for graphing to start.

Example Output
===

$ ./surfboard6120_snr.py config
graph_title SB6120 Signal to Noise (dB)
graph_vlabel dB (decibels)
graph_category network
downstreamsnr0.label Downstream Channel 51 
downstreamsnr1.label Downstream Channel 52 
downstreamsnr2.label Downstream Channel 53 
downstreamsnr3.label Downstream Channel 54 

$ ./surfboard6120_snr.py
downstreamsnr0.value 38
downstreamsnr1.value 38
downstreamsnr2.value 38
downstreamsnr3.value 38

$ ./surfboard6120_pwr.py config
graph_title SB6120 Power Level (dBmV)
graph_vlabel dBmV
graph_category network
downstreampwr0.label Downstream Channel 51 
downstreampwr1.label Downstream Channel 52 
downstreampwr2.label Downstream Channel 53 
downstreampwr3.label Downstream Channel 54 
upstreampwr0.label Upstream Channel 3 

$ ./surfboard6120_pwr.py
downstreampwr0.value 5
downstreampwr1.value 5
downstreampwr2.value 4
downstreampwr3.value 4
upstreampwr0.value 46

Contact
===
If you find bugs or have feature suggestions, don't hesitate to send me an email:
github _at_ jeffreyforman.net

Cheers,
Jeff