Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Reference Voltage Calibration
Note: This page is updated to match release 02_03_16. Prior releases may not look exactly as described here.
A prime component of electrical power is voltage. Also, the AC line frequency is the heartbeat of the IoTaWatt. A reliable and accurate AC voltage reference is very important. You should have installed the device with a 9Vac voltage reference transformer plugged into the channel zero 5mm power jack. If your initial configuration has this channel pre-configured, your LED will be glowing green because it is rhythmically sampling that voltage.
Various transformer models produce different voltages, and it's important to insure that the VT specified matches the model that you have installed. To do this, select the inputs button in the Setup dropdown menu.
A list of all of the inputs will be displayed. The first entry will be input 0 and a default VT should be configured. Check to see if it's the same as your VT model. It's OK to unplug the VT to check the model number printed on it.
If your VT model doesn't match the model that is configured, you can easily change it. Click on the input channel 0 button on the left.
As you can see, the display changes to reveal the details of the input_0 configuration.
If your make and model is is listed, select it from the list. At this point, you can just click SAVE and the standard calibration for your VT will be used. That calibration should be good for all but the most discerning users. If you have access to a good voltmeter or other reliable high accuracy voltage reference, you can fine tune with the calibration procedure below, but for average users, you should be good to go on to the next step Adding Power Channel CTs
If your VT wasn't listed in the dropdown above, the generic entry is a reasonable starting point that will get you in the ball park for your 9-12Vac adapter. If your country is 230V or 240V select "generic240V". Now you must perform the calibration procedure below.
You will need a halfway decent voltage reference for this step. If you don't have a decent true RMS voltmeter and can't borrow one, go out and get a Kill-a-Watt. They cost less than $20 (some libraries lend them out) and I've found their voltage readings are quite accurate.
Follow the instructions on the page. Increase or decrease the "cal" factor until the voltage shown settles down and is a pretty good match with your reference meter. It's not possible to match exactly. .2V in a 120V installation is 0.2% variation. A very good meter accuracy is 1% at best. Just try to get the two to dwell around the same set of fractional digits.
As instructed on the page, click save to record the calibration factor. The new calibration factor will take effect immediately. Click the Status menu button to display the voltage:
Wait a few seconds then check that the voltage displayed is still in the ball park. If not, repeat the calibration procedure.
Once calibration is complete and verified, you will not need to do it again unless you change your VT transformer. The IoTaWatt has a very accurate internal calibration reference and will maintain its accuracy indefinitely. You should have no further need for the voltmeter.
Now the device is ready for the next step Adding Power Channel CTs