Terry Richards
Using the Analog in and LCD, turn the MBED into a simple Oscilloscope
Dependencies: C12832_lcd DebounceIn mbed
Introduction:
The MBED Oscilloscope uses the Analog Input on pin 17 to display connected waveforms from another MBED or a function generator. Note that the above left photo shows the Ain 1/8" phone jack on the side of the MBED being used as the input for a function generator. The crude photo on the right shows the waveform displayed on the MBED LCD screen (this is using the Application board available to plug the MBED processor board into. It includes the LCD screen as well as buttons, pots, temperature sensor, wifly socket, speaker, etc).
The waveform that is displayed on the MBED Oscilloscope is: 
This is from a Digilent combination function generator, Oscilloscope, and logic analyzer. The arbitrary waveform generator shown is one of the features of the unit and allows output of several types of signals from its analog output.
Notice that the frequency is set to 1kHz. The MBED Oscilloscope is set to 512 uS per division (due to display limitations, the settings cannot be displayed with the waveform). The displayed waveform shows a complete period in approximately 2 divisions. The scope is indicating that the period is 1mS or 1kHz.
Capabilities and Limitations:
The scope can display waveforms up to 5kHz with some clarity (although 5kHz is pushing its resolution 2-3kHz is a good practical limit). For displaying waveforms from a function generator running on another MBED, this is not a significant limitation. Except for the square-wave function, the function generator output of the MBED is around 1kHz realistically (the square-wave can output much higher frequencies since it only has two levels). (NOTE: this limitation is not strictly due to the ADC input. it also has to do with loop delay i.e. display update times...etc)
When an input is configured as an Analog input to the ADC, it is not 5V tolerant. The voltage on the pin must not exceed the reference-voltage-plus (set to approx 3V on the MBED board). So the amplitude input is limited to 3V (Although I've input signals at 3.3V with no immediate issues). Again this is not a significant limitation if debugging signals from another MBED. However, if you are using an external function generator, you must ensure you do not overdrive the input.
Usage:
Using the scope is fairly straight forward. Once you have the waveform source connected to pin 17 (either via the 1/8" phone jack or a wire directly connected to p17 through the header), the waveform should be displayed.
To change the time-base, use the right and left joystick buttons. You can check the current setting by pressing the middle button of the joystick. As long as you keep the middle button pressed, the settings page will be displayed. It shows the current settings of the time-base, vertical or volt-base, and the trigger mode. The photo below shows the settings page:
Again, I apologize for the crudeness of the photo (a photographer I am not). Note that the time-base will change based on whether the grid is turned on. In the first photo above you see the grid lines painted on the display. You have the option to turn those off and there are instances where it is desirable. When this is done, the entire horizontal screen is viewed as one division. So the time-base will change accordingly.
Once you release the center button, the display will return to the waveform screen after about a second. If however you press the center button again within that window, you will be taken to the trigger selection window:
There are five trigger modes:
1. Rising-Edge Main Signal (this finds the rising edge on the signal connected to pin 17)
2. Falling-Edge Main Signal (Same as above but finds the falling edge)
3. Rising-Edge Ext Signal (this finds the rising edge on the signal connected to pin 18)
4. Falling-Edge Ext Signal (Sam as in 3 for falling edge)
5. Auto or No Trigger (this does not look for a trigger - useful for dc signals)
Note that only three modes are displayed on the screen. The screen will scroll as you move the selection down. This is done with the "up" and "down" buttons on the joystick. Make your selection by pressing the center button again.
Once you make your trigger selection, you will then be taken to the grid selection menu:
This allows the choice of whether to display the grid. Again there are situations you may want to disable the grid. Make the grid selection in the same way by pressing the center button of the joystick.
Once this selection is made, you will return the the waveform display.
The only additional control it connected to pot2. This is the pot furthest from the display. It controls the trigger level.
Know Issues:
1. The External triggering is not working at all right now. For some reason having two active signals connected to two different ADC inputs causes crosstalk that distorts both signals. I haven't looked into this yet so avoid using external triggering for the present. I will update when and if it is fixed. (any input or pointers would be appreciated)
2. The time base needs to be calibrated a little better. It is pretty close in most cases and good enough for rough work, but you would not want to keep time with it. It is a little like whack-a-mole and may never be perfect, but it can be improved.
3. The timeouts for the triggering mechanism may need some tweaking at some point as well. I think it is pretty good but may cause some fringe problems.
4. The trigger level is not currently displayed anywhere and should be part of the settings page. This would need to be added to a second settings page (and the menu system might get cumbersome at some point).
5. The pot is a little jittery for the trigger level. However, adding another menu to set it with the joystick will further push the problem in 4 of the menu system getting cumbersome. It may be good enough with some tweaks.
Future enhancements:
1. Getting the external triggering working is the first order of business.
2. Getting the time-base closer to reality will make things nicer.
3. I believe the grid would be nicer if the lines were dotted.
4. A classmate suggested adding FFT capabilities for a limited spectrum analyzer.
Any other suggestions?
Accessories:
I put together some faux scope probes by purchasing an inexpensive 3-foot audio cable (it is not shielded as the frequencies we are dealing with are fairly low). I cut this in half and soldered on some clips to connect the center and ground connections for the Ain 1/8" phone jack. The cable I got was actually stereo and I used a DMM to find which bare-wire was connected to pin 17 on the MBED. This accessory does make it nice in most cases.
However you can achieve the same results by connecting two wires directly one to pin 17 and the other to GND on the header connections of the application board directly to the input signal and GND of your waveform output.
Diff: main.cpp
- Revision:
- 4:8eeaddfebd37
- Parent:
- 3:fe3bab42f046
--- a/main.cpp Sat Jun 07 16:58:08 2014 +0000
+++ b/main.cpp Mon Jun 09 07:31:58 2014 +0000
@@ -1,3 +1,9 @@
+//************************************************************************************
+// Main.cpp - main entry point and code for MBED based Oscilloscope.
+//
+// Author: Terry Richards
+// Date: June 10, 2014
+//
#include "mbed.h"
#include "C12832_lcd.h"
#include "DebounceIn.h"
@@ -24,7 +30,7 @@
#define FIRST_TEXTLINE 3 //Positions on the LCD
#define SECOND_TEXTLINE 13
#define THIRD_TEXTLINE 23
-int rePaint(char menustrings[][26], int first)
+int rePaint(char menustrings[][MENU_LENGTH], int first)
{
LCD.cls();
LCD.locate( 0, FIRST_TEXTLINE );
@@ -53,7 +59,7 @@
int display_menu( int *cur_sel,
int *cur_min,
int *cur_max,
- char menustrings[][26],
+ char menustrings[][MENU_LENGTH],
int sel_start,
int menu_end )
{
@@ -139,6 +145,8 @@
time_base = next_tbase[tsel];
}
tbsel = tsel; //Global copy for menu
+ //TODO: may need to add menu to update the trigger
+ //level with the joystick. Pot is a little twitchy
trigger = pot2.read(); //set the trigger level
}
// Find an edge (either rising or falling based on trigger mode) and use
@@ -148,66 +156,65 @@
// Inputs - none
// Outputs - time sync with a correct edge of the waveform
// or quick return if "no_trigger" is selected.
-#define TRIG_TIMEOUT 100
+//The trigger loops below take approx 20us per loop
+#define TRIG_TIMEOUT 1000 //1000*20us=20milliseconds
bool get_trigger(void)
{
- int timeout=TRIG_TIMEOUT;
+ //add more timeout as the timebase increases
+ //TODO: may need to be calibrated more fine grain at some point
+ int timeout=TRIG_TIMEOUT + (tbsel*tbsel*TRIG_TIMEOUT);
//capture a rising edge on the main signal - default mode
if( trigger_mode == main_rising_edge ) {
- if( Ain.read() > trigger )
- while( (Ain.read() > trigger) && timeout-- )
- wait_us(1);
+ while( (Ain.read() > trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
- timeout = TRIG_TIMEOUT;
- while( (Ain.read() < trigger) && timeout-- )
- wait_us(1);
+ timeout = TRIG_TIMEOUT + (tbsel*TRIG_TIMEOUT);
+ while( (Ain.read() < trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
return true;
//capture a falling edge on the main signal
} else if( trigger_mode == main_falling_edge ) {
- if( Ain.read() < trigger )
- while( (Ain.read() < trigger) && timeout-- )
- wait_us(1);
+ while( (Ain.read() < trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
- timeout = TRIG_TIMEOUT;
- while( (Ain.read() > trigger) && timeout-- )
- wait_us(1);
+ timeout = TRIG_TIMEOUT + (tbsel*TRIG_TIMEOUT);
+ while( (Ain.read() > trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
return true;
//capture a rising edge on an external signal
} else if( trigger_mode == ext_rising_edge ) {
- if( Aintrig.read() > trigger )
- while( (Aintrig.read() > trigger) && timeout-- )
- wait_us(1);
+ while( (Aintrig.read() > trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
- timeout = TRIG_TIMEOUT;
- while( (Aintrig.read() < trigger) && timeout-- )
- wait_us(1);
+ timeout = TRIG_TIMEOUT + (tbsel*TRIG_TIMEOUT);
+ while( (Aintrig.read() < trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
return true;
//capture a falling edge on an external signal
} else if( trigger_mode == ext_falling_edge ) {
- if( Aintrig.read() < trigger )
- while( (Aintrig.read() < trigger) && timeout-- )
- wait_us(1);
+ while( (Aintrig.read() < trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
- timeout = TRIG_TIMEOUT;
- while( (Aintrig.read() > trigger) && timeout-- )
- wait_us(1);
+ timeout = TRIG_TIMEOUT + (tbsel*TRIG_TIMEOUT);
+ while( (Aintrig.read() > trigger) && timeout )
+ timeout--;
if( !timeout )
return false;
else
@@ -248,6 +255,7 @@
{
int timeout=100;
//Corrects the faster time bases for loop delay
+ //TODO: These need to be further calibrated. Maybe re-architected.
unsigned int tbase_correction[] = { 24, 6, 3, 3, 1, 1, 1, 1, 1 };
//While user has center button pressed, display the settings
while( Update ) {
@@ -329,7 +337,7 @@
unsigned int i;
unsigned int h = LCD.height()-2, w = LCD.width(), hhh;
while(true) { // thread loop
- if( get_trigger() || skip_first_trig ) {
+ if( get_trigger() || skip_first_trig ) { //go get a trigger
LCD.cls();
LCD.rect(0,0,NUMHORIZPIXELS-1, NUMVERTPIXELS-1, 1); //place boarder
if(draw_grid)
@@ -347,12 +355,32 @@
LCD.copy_to_lcd(); // LCD.pixel does not update the lcd
}
skip_first_trig = false;
- Update_params();
+ Update_params(); //see if we changed time or volt bases
if( Update ) { //Hit the center button once to display stats
skip_first_trig = true; //ensure quick screen update after menu
- menu(); //go get user input
+ menu(); //go get user input..Now on HID time
} else
wait_ms(50); //Delay to smooth twitchy waveforms
}
}
+#if 0
+Testing:
+1. You need another MBED with a function generator running, or a suitable waveform generator (suitable in
+that it must generate waveforms in the frequency band of 1Hz to 2kHz, and amplitudes between 0 and 3.3 Volts).
+2. Waveforms greater than 2kHz are displayable on the MBED Oscilloscope, but are not very interesting. They
+are two fast for the MBED processor to keep up with. The Analog Input takes 20 uS to get a reading so it is
+limited in the frequencies it can handle.
+3. See the writeup on the MBED site for instructons for the menuing system that sets the scope parameters.
+4. Connect the output of the other MBED or the function generator to pin 17 of the MBED running the Osc
+software, or use a "scope probe" connected to the Ain 1/8 phone jack on the side of the MBED running the Osc
+software. Note that the other jack (Aout) can be used as an external trigger if desired, however the two jacks are
+so close together on the application board that you will need to find very small 1/8 phone jacks to fit two
+together side-by-side.
+5. "Scope probes" can be constructed by obtaining an audio cable (stereo or mono will work), cut it in half so
+you have two cables with bare wires on one end and an 1/8 phone jack on the other. Use a DMM to determine the
+bare wires that are connected to the p17 and GND on the MBED (you can do this most easily by plugging the cable
+into the Ain jack and connecting one probe of the DMM to p17 and the other to the bare wires and see which one
+has continuity. Then do the same with GND). Now solder a clip to both the p17 wire and the GND wire so you
+can connect these to your device-under-test.
+#endif
\ No newline at end of file