pi2meter

FINDING THE RESISTOR VALUE

Solder a 10K resistor to the Zero's header connector hole at pin 12, and connect the other end to the meter plus terminal. The meter minus terminal is connected to pin 14. To test it type the following:

    sudo gpio -g mode 18 pwm

    sudo gpio -g pwm 18 100

The meter needle should move. Then re-type the second line, using different numbers in place of the 100, until the meter is at full scale. Don't go over 1023. If the meter is at full scale at less than 500, replace the resistor with one that's approximately double the value and test again. If you can't get it to go full scale even at 1023, use a lower value resistor and test again. Don't go much below 330 ohms. Your goal is full scale with pwm value somewhere between 500 and 1000. Since it may take a couple of tries to get it right, you might not want to solder the resistor in: you can just hold it in place with your fingers until you determine the correct value. When you have the right value solder it in.

CALIBRATION

The meter is probably slightly non-linear so we'll generate an equation to linearize it. This is probably overkill in this instance, but it's a technique that's very useful, so we'll go ahead and cover it. First we'll need to determine some calibration values. The process is simple if tedious: find pwm values for several meter needle settings. Try to get around ten equally spaced ones. For instance, my meter goes from 0 to 100, marked at 12.5 intervals. Here are my values, organized in x,y pairs with x being the meter value, and y the pwm setting:

    0,0  12.5,75   25,150   37.5,237   50,316   62.5,395   75,470   87.5,545   100,622

LINEARIZATION

Next we'll use Mathematica and these values to generate coefficients for a fourth order polynomial (Quartic) linearizing equation. Enter your values into a text file named meter.wm, formatted like the sample below. Here is mine:

    data={{0,0},{12.5,75},{25,150},{37.5,237},{50,316},{62.5,395},{75,470},{87.5,545},{100,622}}

    Fit[data,{1,x,x^2,x^3,x^4},x]

Then run the following command:

    wolfram < meter.wm > meter.bc

After a few seconds the meter.bc file will be written. Mine looked like this:

    Wolfram Language (Raspberry Pi Pilot Release)

    Copyright 1988-2015 Wolfram Research

    Information & help: wolfram.com/raspi

    In[1]:= 

    Out[1]= {{0, 0}, {12.5, 75}, {25, 150}, {37.5, 237}, {50, 316}, {62.5, 395}, 

    >    {75, 470}, {87.5, 545}, {100, 622}}

    In[2]:= 

                                             2                3             -6  4

    Out[2]= 0.47397 + 5.33866 x + 0.0449517 x  - 0.000653095 x  + 2.91207 10   x

    In[3]:= 

The important part is the Out[2] line. Note that the exponents are actually on the line above, and some coefficient may be in scientific notation. Edit the file to fix these and remove the unneeded stuff. The file should  be a single line when you're done. Mine looked like this:

    y = 0.47397 + 5.33866 * x + 0.0449517 * x^2 - 0.000653095 * x^3 + .00000291207 * x^4

Now we'll finish up by adding more text to make it into a proper bc program. Mine looked like this after I was done:

    #!/usr/bin/bc

    #linearize

    scale = 11

    x = read()

    y = 0.47397 + 5.33866 * x + 0.0449517 * x^2 - 0.000653095 * x^3 + .00000291207 * x^4

    #round up and output the result

    scale = 0

    print (y + .5) / 1

    print "\n"

    quit

Save the file as meter.bc and make it executable by typing sudo chmod 755 meter.bc

What's bc you ask? It's a command line arbitrary precision calculator program. We're using it because the meter control program will be written in shell script, which doesn't have floating point math capability. (We could use Wolfram instead of bc, but I want to eventually use this on a Zero with the Lite image. Gotta use up those 2G micro SD cards!) Since bc doesn't come with Raspbian we'll need to install it by doing the following:

    sudo apt-get install bc

USING IT

Now let's whip up a command line to grab a single value from my Sparkfun data stream and display it on the meter. I rendered the code as an image so it doesn't trip Google's malware detector:

You can modify it to get data from your own Sparkfun data page. They email you the access key you'll need when you sign up. As written, it gets the first field of the most recent value. You can put this code inside a shell script to update values periodically: I'll leave this as an exercise for the reader.

You can use the meter for other purposes too. The general idea is to get an input value from somewhere and pipe it into the meter.bc linearizing program, then take it's output value and use it to set the PWM value.

You could even use it to display how many Pi Zeros are in stock at Adafruit!

This site has been tested to display correctly using Epiphany on the Raspberry Pi