Measure

Measure This activity was bundled sources in projects/measure TST Measure Tickets all - active - new Pootle — POT .xo Bundle – measure v14.xo Adviser: Walter, Core Development: Arjun, Contributor(s): Cody Lodrige (drawing code optimization), Nathalia (translations) see more templates or propose new

SAFETY FIRST!

* WARNING: ELECTRICY CAN KILL. RISK OF ELECTROCUTION: DO NOT, UNDER ANY CIRCUMSTANCES, APPLY AC LINE VOLTAGES FROM A WALL OUTLET OR MOTOR-GENERATOR OR OTHER POWER SUPPLY (E.G. CONVERTER OR INVERTER) INTO THE MICROPHONE INPUT, THE SPEAKER OUTPUT, OR ANY USB PORT.

• Make measurements of AC line voltages with the proper equipment only -- for example, a multimeter designed for the purpose. The laptop is not a multimeter.

• Read the following article. If you don't know what you are doing or are unsure, don't do it. Electricity can be dangerous.

* CAUTION: RISK OF BURNS, FIRE or EXPLOSION: Even a AAA battery stores enough energy to cause burns, and it may cause equipment damage if applied directly to the microphone input. If a 9 volt battery carried in a pocket makes contact with coins it will cause burns, and it will cause equiment damage if it is applied directly to the microphone input. Higher-power sources present increased risk of burns, fire, explosion and electrocution, the nature of which is unpredictable.

* CAUTION: RISK OF EQUIPMENT DAMAGE. DO NOT, UNDER ANY CIRCUMSTANCES, EXCEED THE INPUT AND OUTPUT SPECIFICATIONS; DAMAGE OR DESTRUCTION OF THE EQUIPMENT WILL RESULT.

Introduction

Children learn by doing things. It is said "Give the child a hammer, and the world are his nails".

This activity is a tool that allows kids to express their curiosity. It is a tool that allows kids to explore and learn by doing, by connecting and observing, span physical phenomena and real world events. Kids would learn by recording and observing the physical phenomena and by connecting their observations to a previously learned concept, or even better - learn the concept based on the experiments and observation. This activity enables children to measure DC and AC voltages by observing them on an oscilloscope-like interface, to watch waveforms in a frequency domain (spectrum analyzer), logging data at a specified time interval and drawing the graph of logged data.

Elements of the Measure activity

• There is a 1150 X 800 pixels window in which one sees the waveform. There is a light Grey colored grid in the background which is like the scale.
• Measure Toolbar which allows one to switch between AC and DC modes, Toggle Bias Voltage On/Off, View waveform in time domain or frequency domain, Select frequency range display, and be able to pause waveform on the screen.
• A Log Toolbar which allows one to select the data logging interval, start and stop the logging, display the log

Screen shots of Measure Activity

Signal in time domain

Signal in frequency domain

Displaying result of a logging session

Version 14 of Activity

A short video

<youtube>FE1ufEIXLVo</youtube>

This video is of Release Version 8 of the Activity. The latest release features an improved UI and few more features.

Measure Activity activities

1. Record animal sounds , for example, sounds of birds and observe their waveforms. Which of these are high frequency sounds, which are the low frequency ones ? Adjust the frequency sliders accordingly.
2. Whistle into the mic and compare the loudness and frequency of whistles by observing the waveforms.
3. Turn the sensitivity slider up to the maximum and observe ambient noise - in a quiet room , near a noisy road
4. Measure the voltage of an AA size pencil cell. What settings do you use ? AC or DC ?
5. Measure resistance of water , other liquids
6. Log temperature using a temperature sensor at one hour intervals. When in the day is it the hottest ? The coldest ?
7. Some very interesting sensor ideas given by Arnans Roger , see - http://padthai.media.mit.edu:8080/cocoon/gogosite/documentation/makingSensors.xsp?lang=en

(Ideas 1 and 2 given by Erik Blankenship)

Downloading and running the activity on the XO

The link for the latest version of the activity is http://dev.laptop.org/~arjs/Measure-11.xo . Other previous versions can be found at http://dev.laptop.org/~arjs/

To install the .xo bundle, in the sugar shell (do not do this as root) type

sugar-install-bundle <path>/Measure-11.xo

Activity has been found running well on build 575 and higher. Since it is a CPU intensive activity, it works best on B3 and B4 machines. Also pre-B4 machines might not fully support the DC mode.

Measure Projects

1. A low cost (possibly $2) probe that would increase the range of voltage that can be applied to the input.
2. An ultrasonic distance measurement system that connects to the XO and allows the XO to log data. This has immense applications in water level monitoring in villages and also in robotics applications.
3. A general purpose hardware kit that interacts with the measure activity. Something on similar lines to http://www.create.ucsb.edu/~dano/CUI/
4. Sensors could be distributed along with the XO as peripherals. The advantage of this would be that the measure activity can be calibrated against the known specs of the sensors.
5. Being able to measure resistance
6. A low cost version of LEGO mindstorms system built around the XO. The XO has good hardware and software capabilities to achieve this.
7. RS232 or serial interface would allow a host of electronic devices to interact and communicate with the XO.
8. Build a sensor network using a sensor connected to each XO and utilize the mesh networking capability of the XO. This would give us a highly powerful, robust and reconfigurable sensor network.
9. Build medical applications using sensors and the XO. See TeleHealth_Module
10. Do some Fablab projects using the XO. See http://fab.cba.mit.edu/labs/vigyan/
11. Collaborative music creation over the mesh using the music software on the XOs and giving input from an array of different sensors.
12. Integrate sensor input into LOGO / Turtle activity
13. Milk purity in rural areas. I remember reading about it in some FabLab's website - I think it requires an ADC, which we have.
14. Temperature Monitoring and Logging
15. Intrusion Alarm System

Hardware details

The Analog Devices AD1888 sound chip has the ability to sample DC voltages. Experimentally it has been found out that the range is fairly linear, however the range that it can sample is restricted to 0.3V - 1.9V , with all the internal gains turned to the minimum.

The XO hardware has been designed to facilitate measurement of DC voltages by the addition of an electronic switch that can be controlled via a setting on the Alsa mixer called 'Analog Input' . The high pass filter can also be turned on/off by a setting 'High Pass Filter' in Alsamixer. The ability to control V_REFOUT (bias voltage) is also available and is done by the control 'V_REFOUT' in alsamixer.

All the above settings are being handled in the activity by using an os.system("amixer <control name> <mute/unmute>")

Input specifications

* WARNING: ELECTRICITY CAN KILL. RISK OF ELECTROCUTION: DO NOT, UNDER ANY CIRCUMSTANCES, APPLY AC LINE VOLTAGES FROM A WALL OUTLET OR MOTOR-GENERATOR OR OTHER POWER SUPPLY (E.G. CONVERTER OR INVERTER) INTO THE MICROPHONE INPUT, THE SPEAKER OUTPUT, OR ANY USB PORT.

• There is a risk of electric shock resulting in death if the XO is used to measure mains voltage by direct connection. The audio input components are not designed for this. Dangerous voltages applied to the audio input may also be emitted on audio output, USB connectors, or the DC power input jack.

* CAUTION: RISK OF EQUIPMENT DAMAGE. DO NOT, UNDER ANY CIRCUMSTANCES, EXCEED THE INPUT AND OUTPUT SPECIFICATIONS; DAMAGE OR DESTRUCTION OF THE EQUIPMENT WILL RESULT

* -0.5 to +5.0 volts ABSOLUTE MAXIMUM input voltage.

* DO NOT REVERSE VOLTAGE: EVEN 1.5 volt BATTERY VOLTAGE IMPROPERLY APPLIED MAY DAMAGE LAPTOP

* The extent of the damage is not easily predictable.

* CAUTION: RISK OF EQUIPMENT DAMAGE AND/OR DEGRADED EQUIPMENT PERFORMANCE. DO NOT EXCEED THE OUTPUT-CURRENT SPECIFICATIONS OF THE USB PORTS. The extent of the damage is not easily predictable.

The following specifications are based on terminal measurements of a G1G1 laptop and examination of the AD1888's specification sheet. Please correct them where necessary:

Specifications: Microphone input (red, standard audio jack):

• Monaural only: 3.5mm (1/8 inch) audio jack input (Note 0) (white jack of a stereo splitter)

• Insertion of the audio jack routes external input to the A-to-D converter and disables the OLPC's speakers
• Red jack of stereo splitter is open-circuited (i.e. not connected) [??]

• Absolute maximum input voltages: -0.5 volts, +5.0 volts (CAUTION: Exceeding these voltages will damage the laptop. See Note 1)
• Input impedance with BIAS OFF: approx 1100 ohms (Note 2)
• Input-DC offset voltage: (Note 3) +1.178 +/- ?? volts
• Range of DC amplification: TBD
• Range of AC amplification: TBD

Note 0: A solderable connector is the Radio Shack 274-286 "Mono 1/8" Phone Plug" with solder terminals and screw-on housing. A possible stereo connector is the similar Radio Shack 274-284 1/" Stereo Phone Plug" with solder terminals and screw-on housing. Only 1 of the two input-terminals of the stereo connector is available for input. The cost of the Radio Shack Mono plug is $2.99 US for quantity two plugs; cost of the Stereo plug is $3.99 US for quantity two plugs (neither are gold-plated). Other sources for resistors, wire, solder, naked USB and audio jack-connectors, "ball clips" (probes) etc can be found at www.mouser.com and www.digikey.com. Quantity pricing (e.g. Kobiconn plugs, 3.5mm MONO Mouser Part Number 171-PA-3191-1-E) is much reduced compared to the Radio Shack pricing (e.g. $0.71 USD single unit, $0.45 USD at quantity 100).

Use insulated wire. To reduce electrical noise twist the attached wires approximately 1 twist per inch (1 twist per 2.5 cm).

Note 1: Measured between the center conductor and the shield (ground, i.e. +0 volts). When an input voltage is greater than +5.0 volts or less than -0.5 volts the input-protection circuitry draws currents greater than 100 milliamperes and will damage the laptop. Also, the AD1888 codec's absolute maximum voltage (given a 5.0 volts supply) is -0.3 volts to +6.3 volts.

You must use input protection resistors and voltage divider if voltages greater than +5 volts will be applied. Resistors and a fast-blow fuse are recommended. Resistors should be present in both the ground circuit and the signal circuit, and this may introduce noise. A better circuit is a high-impedance differential-input amplifier. Recommended circuit TBD: see Note 3.

Note 2: With BIAS ON, measurements indicate a back-bias of +0.785 volts exists at the input. With BIAS OFF +0.020 volts (20mv) is present at the input. The BIAS voltage's effective source impedance seems to be approx 790 ohms. Any circuit that is to drive into the input (see Note 3) should do so with the BIAS OFF and have low-enough source impedance to sink and source into the 1100 ohm input adequately.

Note 3: This is the DC injection-voltage necessary to move the trace from the botton to into the center screen.

A recommended protection circuit would be a differential amplifier (e.g. a single-operational-amplifier circuit that uses one half of an LM224 amplifier can process ground +0 volts as a possible input. Reversals of 1.5 volt cell battery voltages etc can then displayed. With a proper design ( e.g. a potentiometer-adjustable input-offset derived from a +1.25 volt bandgap reference and the second operational amplifier configured as a 2:1 amplifier) the input between the differential amplifier's inputs would match the AD1888's input range of +0 volts to +2.83 volts (2.83 volts peak-to-peak). +5 volts can be derived from the nearby USB port as described below. A naked USB connector-plug can be found at www.mouser.com (stock number 154-UAW16-E) at $0.68 USD. USB connectors with wires attached ("pigtails", "blunt end") can also be found at Mouser, Digikey, etc. for about $1.50 to $2.00 USD.

Simple differential amplifier

The following circuit allows the student or teacher to "input" both DC voltages (such as from a 1.5 volt battery, etc) and an AC voltage.

Specifications

• Maximum input voltage: +/-15 volts useable, tested to +/-30 volts

• I.e. apply the voltage of 15 volts (30 volts absolute maximum for testing) in both polarities by "flipping the battery"

• Signal-input plug: mono audio jack (3.5 mm, 1/8", see above)
• Power-input plug: USB connector

• Use either a "naked" connector or a USB cable cut and stripped to reveal the red (+5 volt) and black (0 volt -- common) wires. Cut the other two wires flush and tape-over their ends individually.

• Frequency specification: DC to 1000 hertz (1 KHz). Beyond this frequency significant aliasing occurs.

• "Aliasing" appears as wiggles on what should be a pure sine wave (an envelope that modulates the input). This is caused by the sampling of the waveform done by the input-converter (codec).

• Laptop settings: Set either (i) MEASURE to DC and OFFSET to OFF, or (ii) MEASURE to AC and OFFSET to OFF

• No harm will result if these setting are wrong, e.g. the activity starts in MEASURE = AC. The gain will be higher in AC, but the amplfier can be used in AC too. ).

• Input impedance: 100,000 ohms (100K) each side to circuit common
• Common-mode rejection: depends critically upon the matching to resistors R1 to R2 (100K) and R3 to R4 (10K)

• Matching of 0.1% is required either by buying 0.1% resistors, or buying e.g. a 100 or a 1000 of inexpensive metal-film resistors and sorting them.

• Gain: 1/10 (i.e. the circuit divides the input down by 10)
• +5 Volt power -- gotten from nearby USB port (red and black wires inside a sliced-open USB cable)

• Current draw -- a few milliamperes

Circuit description

This simple circuit is called a "differential amplifer" and although not very fancy it does the trick. It derives its +5 volts input power from the USB port. The circuit uses a couple tricks, to be described below.

This has the advantage of not presenting an input power greater than +5 volts, plus the USB-port's circuit limits its +5 volt output-current to about 1 ampere. Any supply voltage derived from another source should be less than +5 volts. For example, three 1.5 volt batteries will also work at +4.5 volts -- as long as the batteries are not accidentally reversed !! -- but four 1.5 volt batteries at 6.0 volts present a risk of inputting more than 5 volts into the microphone jack.

• Any externally-derived power voltage (batteries solar cells, etc) directly applied also risks of reveral. If a battery is to be used, add a reverse-protection schottky diode in series with the battery (.e. a 4.5 volt battery with a 0.4 volt diode drop). Details TBD.

Trick #1 -- Artificial "ground": The analog-to-digital converter (codec, A1888) converts (works only on) plus-DC voltages between +0 volts (minimum, corresponding to bottom of screen with high gain (control near the top)) and +2.83 volts (maximum, corresponding to top of screen with high gain (control near the top)) . A special highly-stable reference voltage called a "band-gap reference" provides a steady +1.225 volt "offset" to provide 1/2 of this range i.e. approximately +1.41 volts (one G1G1 unit +1.181 volts). This voltage will place the trace in the center of the screen. Thus, input-voltages less than this "centering-voltage" will drive the trace lower than center, and voltages greater than this "centering-voltage" will drive the trace higher than center.

Trick #2 -- Matched resistors: What is called the "common-mode rejection ratio", or the ability of the circuit to reject noise on both signal-leads simultaneously is related in large part to the precision of the matching of the two 100K resistors to 0.1%, and the two 10K resistors to 0.1%. The exact 100K-to-10K ratio is not particularly important, and will be good to 1% with typical 1% resistors. The resistors should also not "drift" with temperature; thus they should be of the same type. The recoommended type is a metal-film 1/4 watt resistor such as the CM55-type (commercial type similar to the RN55D type).

The recommended approach is to buy a bunch of resistors (e.g. from Mouser at www.mouser.com, a quantity of 100 cost about $6.00 US, a 1000 cost about $25.00 US) and then sort them into 0.1% categories. Unfortunately this requires a digital ohmmeter. Another approach is to just buy precision resistors (at about 10x the cost). Other approaches TBD.

More details to follow.

For software developers

1. See tickets assigned to measure-activity on trac for ways to help out!

Brief overview of the code

1. audiograb.py
2. drawwaveform.py
3. config.py

audiograb.py is the file that takes care of grabbing input audio samples. It uses a gstreamer pipeline in which the handoff signal of the fakesink element is used to intercept the data in the pipeline. Data logging is done in this class since we can use the sampling rate as a time reference; i.e. we know the sampling rate and also the number of elements in each buffer that is intercepted from the pipeline. So each atomic time interval is (1/Fs * bufferSize). This is the time interval after which we get a handoff signal.

drawWaveform.py is the class that handles the waveform drawing part. It creates and uses a cairo context to draw the background, the grid and the waveform. It uses a combination of pango and cairo for displaying the text as it was found out that cairo is itself not good at rendering text. All drawing occurs in the expose function which is the gtk expose event handler. It does drawing from the real time samples or from a file. In real time, it can either draw time domain or display the frequency domain samples. self.integer_buffer is one buffer that is obtained from audiograb.py and self.main_bufers is the buffer that accumulates all these buffers. The self.main_buffers is sampled at varying intervals of time, depending upon the frequency range selected, to form self.buffers which is the buffer that is scaled and drawn. self.main_buffers is sampled at a larger interval (set by self.spacing) for lower frequencies and at a shorter interval for higher frequencies. An example calculation is as follows. If we form 1 self.buffers by taking all consecutive elements, we would be sampling at 48khz. I have found that to draw a reasonable representation of a sine wave, one needs at least 8 -12 points. Hence the largest frequency that can be represented accurately is given by 48/12 = 4Khz, or less.Text is updated after every self.update_text expose events.

config.py contains all global variables.

Signals and timeouts used in the software

The handoff signal in audiograb.py is emitted whenever a new buffer is available. The signal handler is on_buffer which adds a gobject timeout. On timeout, _new_buffer is called which emits a custom signal new-buffer. The signal handler for this custom signal is _new_buffer in drawWaveform. Within _new_buffer, the new buffer is read and saved /stored. The expose event is queued in the main measure.py which causes the expose function to be called.

For content developers

I have yet to work on a to-do task list for the content. However, I wish to develop a complete page around each of the points (and more) enumerated in the Learning activities section mentioned above. Ideally I would want a short illustrative video on each page.

Output and related ideas

This page presents a solution for electrical signals to be input to the XO. For the corresponding problem on output, no such solution exists, but there are some ideas at Electrical output. One idea there is to use the modem connection as finely-timed output - clearly, this would also work for increasing the number of input signals, though it is probably more useful for timing than for fine measurement.

* WARNING: ELECTRICITY CAN KILL. RISK OF ELECTROCUTION: DO NOT, UNDER ANY CIRCUMSTANCES, APPLY AC LINE VOLTAGES FROM A WALL OUTLET OR MOTOR-GENERATOR OR OTHER POWER SUPPLY (E.G. CONVERTER OR INVERTER) INTO THE MICROPHONE INPUT, THE SPEAKER OUTPUT, OR ANY USB PORT.

• There is a risk of electric shock resulting in death if the XO is used to measure mains voltage by direct connection. The audio input components are not designed for this and damage is likely to result. The extent of the damage is not easily predictable. The only components intended for mains voltage are the pins of the AC adaptor. Dangerous voltages applied to the audio input may also be emitted on audio output, USB connectors, or the DC power input jack.

Temperature monitoring system

How to build

You need-

1. LM35 or any similar temperature sensor
2. USB connector
3. Audio connector
4. Some wire or a cable. You could use cut a USB cable and an audio cable from the middle
5. Measure Activity

The USB port has two pins which are of use to us. One is the ground and the other one is the one which provides a constant 5V. When you cut a USB cable in the middle, you could find out by trial-and-error by using a simple Voltmeter which are the two wires corresponding to these two pins. If you don't have a Voltmeter, try using a simple LED and a resistor to do the job.

We provide the +5V that this temperature sensor requires from the USB port. For this we connect the +5V wire to the Vcc of the sensor. We connect the ground to the Ground terminal on the LM35. We connect the Vout of the sensor to the Audio Input jack.

How to operate

Set the Measure Activity to be in the DC Mode and Turn Off the Bias Voltage. Both these can be controlled by using the first two buttons on the 'Measure Toolbar'.

The DC voltage is proportional to the temperature . The voltage that the XO can read varies between 0.9 V - 3V. The output of the sensor would be from 0-5V, so, for for different ranges of temperature one can either use a potential divider for higher ranges or using resistances add a bias to the Vout of the sensor from the +5V of the USB again.

Learn More

The LM35 has an output voltage proportional to the temperature. The scale is 0.01V/C. Read the [Data Sheet] to learn more.

One could log temperature over a period of time - say at an interval of 1 hour for a complete day to know when is it the hottest / coldest.

Video

(put video with flame demonstration here, put pictures here - including ckt diagram)

Intrusion Alarm system

How to build

You need-

1. A toy laser
2. An LDR or a Photo-Voltaic cell
3. Some wire
4. Measure Activity

Open up the toy laser and remove the batteries. Connect a wire to the spring inside and connect the other wire to the metallic body inside. Connect both of these wires to the USB power supply wires. Click here to learn about how to determine the USB power supply lines.

Connect the LDR to the Audio Jack.

How to operate

Set the Measure Activity into DC Mode and turn ON the bias voltage. Setup the LDR and the laser to be in line and facing each other. When the path of the laser light gets cut, you should observe a marked increase in voltage indicated by the position of the waveform shifting up.

Learn More

The resistance of the LDR - Light Dependent Resistor is proportional to the amount of light falling on it. The potential drop across the LDR is dependent on the resistance of the LDR. When the path of the light gets cut, the resistance increases hence we notice a marked increase in voltage indicated on the screen.

Click here to know more about Bias Voltage and how it works.

Video

Put a video here and some pics

Acknowledgments

Thanks to Mitch Bradley and John Watlington for their help and suggestions during the development of the Activity.