This is a USB mouse(Device). The mouse positions can be changed with the potentiometers on the MBD

Dependencies:   C12832_lcd DebounceInterrupts USBDevice mbed

Fork of USBAbsoluteMouse by Adam Green

USB Mouse

Goal

To build a USB Mouse (Host and device) using two MBEDs and test the communication between them.

Details

This is a device part of the USB mouse Project. The USB mouse project uses two MBED boards.

There is a bubble on the LCD of the Host MBED. The position of this bubble can be controlled using the potentiometers on the device MBED.

Pin Mappings

  • Pot1 is used to control Y position of the bubble
  • Pot2 is used to control X position of the bubble
  • Right button on joystick is used to emulate the right click
  • Left button on joystick is used to emulate the left click
  • Center button of joystick is used to emulate the pressing of the wheel

Block Diagram/Connection diagram

/media/uploads/bhakti08/block_diagram.jpg

Design Constraints

The output of the USB mouse(device) is adjusted according to the limits of the LCD on the other MBED board(the host). Due to this this mouse positions may be incorrect for any other sizes of the LCD or the Host computer.

Complete Testing(For both device and host)

Case DescriptionOutput ExpectedActual OutputStatus
ConnectionThe USB device should be properly enumerated when connected to the hostConnection recognized by the hostPASS
If the device is disconnected from the host, there should be some error messageWhen the device is disconnected, the LED4 on Host turns OFF and "Connect the USB mouse" is displayed on the LCDPass
Move Pot1 on the device and check the position of bubble on the Host.The pot should be able to control the bubble for the entire range of the LCD.Using Pot1 the Y position is controlled and the bubble moves from topmost position to bottom most positionPASS
Move Pot2 on the device and check the position of bubble on the Host.The pot should be able to control the bubble for the entire range of the LCD.Using Pot2 the X position is controlled and the bubble moves from leftmost position to the rightmost positionPASS
Press the left switch of the joystick on the deviceThe left click should be detected and the LED on the host should turn ONLED2 on the host turns ON. Thus, a left click on the device is detected by the host.PASS
Press the right switch of the joystick on the deviceThe right click should be detected and the LED on the host should turn ONLED1 on the host turns ON. Thus, a right click on the device is detected by the host.PASS
Press the center switch of the joystick on the deviceThe click of the wheel should be detected and the LED on the host should turn ONLED3 on the host turns ON. Thus, a wheel the wheel being clicked the device is detected by the host.PASS
Disconnect the host from the deviceThe LED4 on the host should turn OFFThe LED4 turns OFF along with the message on the LCD "Connect the USB mouse".PASS

Testing Device Specific

Power ConsumptionThe power consumed by the USB Device should be less than the specified valueThe power consumed by the device is approximately 700mW which satisfies the specifications.PASS
Operation when connected to the HubThe device operation should not be altered.The device works as expected even if it is connected to the host through a USB HubPASS
Compatibitity with other OSTest the device with various OSThe device is being tested on windows 8. The device works but the cursor movement is not as expected. This is because the resolution of the LCD on MBED does not match with the screen. The buttons work as expected. This error can be resolved by using the absolute mouse instead of relative.Not tested with all OS.
Working on heavy trafficLoad the USB bus with various devices.The device should be working properly.Not tested

Device Code

Import programUSB_Project_Device

This is a USB mouse(Device). The mouse positions can be changed with the potentiometers on the MBD

main.cpp

/*****************************************************************************/
/*Function: This program is used to emulate a USB Mouse. The mouse position  */
/*          can be changed by the potentiometers. The output values of x and */
/*          y are modified to move the bubble on the LCD on another MBED     */
/*          acting as USB Host. The program for MBED USB Host can be found at*/
/*          http://mbed.org/users/bhakti08/code/USB_Project_Host/            */
/*Author:   Bhakti Kulkarni                                                  */
/*Date:     03/27/2014                                                       */
/*****************************************************************************/
#include <mbed.h>
#include <USBMouse.h>
#include "DebouncedIn.h"
#include "C12832_lcd.h"
#include "DebouncedInterrupt.h"

#define RANGE 0.02
#define INTERRUPT
#define X_MAX 120
#define Y_MAX 28
#define x_move 7
#define y_move 3

Serial pc(USBTX,USBRX);

DebouncedIn right_click(p13);      //Button enulating right click
DebouncedIn left_click(p16);       //Button emulating left click
DebouncedIn wheel(p14);            //Button emulating the wheel button
C12832_LCD lcd;
AnalogIn X_in(p20);               //Analog input to move bubble in x position
AnalogIn Y_in(p19);               //Analog input to move bubble in y position
 
USBMouse  Mouse;

int Xpos = 0;
int Ypos = 0;

/*****************************************************************************/ 
/*This is the main program. This reads the input from the potentiometers,    */
/*converts them into the values that are required for the lcd display        */
/*and then sends them as the mouse outputs.                                  */
/*****************************************************************************/ 
int main()
{
   float AinX_old = 0;
   float AinX_new;
   float AinY_old = 0;
   float AinY_new;
   while (true){
        if(left_click)
        {
            Mouse.click(MOUSE_LEFT);  //if left click is pressed,
                                      // emulate mouse left
        }
        if (right_click)
        {
            Mouse.click(MOUSE_RIGHT);  //if right click is pressed,
                                      // emulate mouse right
        }
        if (wheel)
        {
            Mouse.click(MOUSE_MIDDLE); //if wheel button is pressed,
                                      // emulate wheel button pressed
        }
        AinX_new = X_in.read();
        //check if the values are between the LCD values
        if (AinX_new >= AinX_old + RANGE){         
            if (Xpos < X_MAX)
                Xpos += x_move;
            else
                Xpos = Xpos;
            AinX_old = AinX_new;        
        }
        else if (AinX_new < AinX_old - RANGE){
            if (Xpos > 0)
                Xpos -= x_move;
            else
                Xpos = Xpos;
            AinX_old = AinX_new;        
        }
        else
            Xpos = Xpos;
            
        AinY_new = Y_in.read();
        if (AinY_new >= AinY_old + RANGE){
            if (Ypos < Y_MAX)
                Ypos += y_move;
            else
                Ypos = Ypos;
            AinY_old = AinY_new;        
        }
        else if (AinY_new < AinY_old - RANGE){
            if (Ypos > 0)
                Ypos -= y_move;
            else
                Ypos = Ypos;
            AinY_old = AinY_new;        
        }
        else
            Ypos = Ypos;
        Mouse.move(Xpos,Ypos);      //Send the values as the mouse output
    }
}

/*****************************************************************************/

Host code

Import programUSB_Project_Host

USB Host

main.cpp

/*****************************************************************************/
/*                                   USB MOUSE HOST                          */
/*Function: This program is used to connect the MBED USB mouse. The bubble   */
/*          on the LCD moves according to the input from the USB device.     */
/*          The program for the MBED USB Device can be found at following    */
/*          location:                                                        */
/*          <http://mbed.org/users/bhakti08/code/USB_Project_Device/>        */
/*Author:   Bhakti Kulkarni                                                  */
/*Date:     03/27/2014                                                       */
/*****************************************************************************/

#include "mbed.h"
#include "USBHostMouse.h"
#include "C12832_lcd.h"
#include "DebouncedInterrupt.h"
#include "DebouncedIn.h"

DigitalOut connect(LED4);     //LED to indicate USB Mouse connected
C12832_LCD lcd;
Serial pc(USBTX,USBRX);
BusOut button (LED1,LED2,LED3);   //LEDs for the Button pressed on Device

/*Global Variables to process the X abd Y values*/
int x_lcd=0,y_lcd=0;
int Xpos=0,Ypos=0;
uint8_t buttons; 
int8_t x; 
int8_t y; 
int8_t z;
uint8_t b;

/*****************************************************************************/
/*Function: OnMouseEvent()                                                   */
/*          This function is called whenever there is change in mouse data   */
/*          It copies the values of x,y and buttons from the device into     */
/*          variables that can be accessed by the main logic to move the     */
/*          bubble on the LCD                                                */
/*Inputs:   The x,y and button values from the Mouse.                        */
/*Outputs:  None.                                                            */
/*****************************************************************************/
void onMouseEvent(uint8_t buttons, int8_t x, int8_t y, int8_t z) {
    pc.printf("Mouse values: x= %d, y= %d\r\n",x,y);
    //pc.printf("Buttons are: %d/r/n",buttons);
    Xpos = x;
    Ypos = y;
    b = buttons;// & 0x03;
}
/*****************************************************************************/

/*****************************************************************************/
/*This thread is the mouse_task thread which will check for the USB Device   */
/*connectivity. If the device is not connected it will issue an error message*/
/*Once the device is connected, this thread will attach the mouse event      */
/*thread.                                                                    */
/*****************************************************************************/
void mouse_task(void const *) {
    
    USBHostMouse mouse;
    
    while(1) {
        
        // try to connect a USB mouse
        while(!mouse.connect()){
            lcd.cls();
            lcd.locate(0,0);
            lcd.printf("Connect the USB Mouse\n");
            Thread::wait(500);
        }
    
        // when connected, attach handler called on mouse event
        mouse.attachEvent(onMouseEvent);
        
        // wait until the mouse is disconnected
        while(mouse.connected()){
            lcd.cls();
            connect = 1;
            lcd.fillcircle(Xpos,Ypos, 2, 1); 
            wait(.05);
            lcd.fillcircle(Xpos,Ypos, 2, 1);
            pc.printf("%d\r\n",b); 
            button = b;
            Thread::wait(100);
        }
         connect= 0;
    }
}
/*****************************************************************************/

/*****************************************************************************/
/*This is the main thread. This will do nothing but initiate the mouse task  */
/*thread and then wait forever in the loop                                   */
/*****************************************************************************/ 
int main() {
    Thread mouseTask(mouse_task, NULL, osPriorityNormal, 256 * 4);
    while(1) {
        Thread::wait(osWaitForever);
    }
}
/*****************************************************************************/

Note:Two Programs should be downloaded on different MBEDs.

Committer:
bhakti08
Date:
Thu Mar 27 19:04:33 2014 +0000
Revision:
4:42fa048620b3
Parent:
3:976579c5ba99
Modified to add comments

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bhakti08 3:976579c5ba99 1 #include "DebouncedIn.h"
bhakti08 3:976579c5ba99 2 #include "mbed.h"
bhakti08 3:976579c5ba99 3
bhakti08 3:976579c5ba99 4 /*
bhakti08 3:976579c5ba99 5 * Constructor
bhakti08 3:976579c5ba99 6 */
bhakti08 3:976579c5ba99 7 DebouncedIn::DebouncedIn(PinName in)
bhakti08 3:976579c5ba99 8 : _in(in) {
bhakti08 3:976579c5ba99 9
bhakti08 3:976579c5ba99 10 // reset all the flags and counters
bhakti08 3:976579c5ba99 11 _samples = 0;
bhakti08 3:976579c5ba99 12 _output = 0;
bhakti08 3:976579c5ba99 13 _output_last = 0;
bhakti08 3:976579c5ba99 14 _rising_flag = 0;
bhakti08 3:976579c5ba99 15 _falling_flag = 0;
bhakti08 3:976579c5ba99 16 _state_counter = 0;
bhakti08 3:976579c5ba99 17
bhakti08 3:976579c5ba99 18 // Attach ticker
bhakti08 3:976579c5ba99 19 _ticker.attach(this, &DebouncedIn::_sample, 0.005);
bhakti08 3:976579c5ba99 20 }
bhakti08 3:976579c5ba99 21
bhakti08 3:976579c5ba99 22 void DebouncedIn::_sample() {
bhakti08 3:976579c5ba99 23
bhakti08 3:976579c5ba99 24 // take a sample
bhakti08 3:976579c5ba99 25 _samples = _samples >> 1; // shift left
bhakti08 3:976579c5ba99 26
bhakti08 3:976579c5ba99 27 if (_in) {
bhakti08 3:976579c5ba99 28 _samples |= 0x80;
bhakti08 3:976579c5ba99 29 }
bhakti08 3:976579c5ba99 30
bhakti08 3:976579c5ba99 31 // examine the sample window, look for steady state
bhakti08 3:976579c5ba99 32 if (_samples == 0x00) {
bhakti08 3:976579c5ba99 33 _output = 0;
bhakti08 3:976579c5ba99 34 }
bhakti08 3:976579c5ba99 35 else if (_samples == 0xFF) {
bhakti08 3:976579c5ba99 36 _output = 1;
bhakti08 3:976579c5ba99 37 }
bhakti08 3:976579c5ba99 38
bhakti08 3:976579c5ba99 39
bhakti08 3:976579c5ba99 40 // Rising edge detection
bhakti08 3:976579c5ba99 41 if ((_output == 1) && (_output_last == 0)) {
bhakti08 3:976579c5ba99 42 _rising_flag++;
bhakti08 3:976579c5ba99 43 _state_counter = 0;
bhakti08 3:976579c5ba99 44 }
bhakti08 3:976579c5ba99 45
bhakti08 3:976579c5ba99 46 // Falling edge detection
bhakti08 3:976579c5ba99 47 else if ((_output == 0) && (_output_last == 1)) {
bhakti08 3:976579c5ba99 48 _falling_flag++;
bhakti08 3:976579c5ba99 49 _state_counter = 0;
bhakti08 3:976579c5ba99 50 }
bhakti08 3:976579c5ba99 51
bhakti08 3:976579c5ba99 52 // steady state
bhakti08 3:976579c5ba99 53 else {
bhakti08 3:976579c5ba99 54 _state_counter++;
bhakti08 3:976579c5ba99 55 }
bhakti08 3:976579c5ba99 56
bhakti08 3:976579c5ba99 57 // update the output
bhakti08 3:976579c5ba99 58 _output_last = _output;
bhakti08 3:976579c5ba99 59
bhakti08 3:976579c5ba99 60 }
bhakti08 3:976579c5ba99 61
bhakti08 3:976579c5ba99 62
bhakti08 3:976579c5ba99 63
bhakti08 3:976579c5ba99 64 // return number of rising edges
bhakti08 3:976579c5ba99 65 int DebouncedIn::rising(void) {
bhakti08 3:976579c5ba99 66 int return_value = _rising_flag;
bhakti08 3:976579c5ba99 67 _rising_flag = 0;
bhakti08 3:976579c5ba99 68 return(return_value);
bhakti08 3:976579c5ba99 69 }
bhakti08 3:976579c5ba99 70
bhakti08 3:976579c5ba99 71 // return number of falling edges
bhakti08 3:976579c5ba99 72 int DebouncedIn::falling(void) {
bhakti08 3:976579c5ba99 73 int return_value = _falling_flag;
bhakti08 3:976579c5ba99 74 _falling_flag = 0;
bhakti08 3:976579c5ba99 75 return(return_value);
bhakti08 3:976579c5ba99 76 }
bhakti08 3:976579c5ba99 77
bhakti08 3:976579c5ba99 78 // return number of ticsk we've bene steady for
bhakti08 3:976579c5ba99 79 int DebouncedIn::steady(void) {
bhakti08 3:976579c5ba99 80 return(_state_counter);
bhakti08 3:976579c5ba99 81 }
bhakti08 3:976579c5ba99 82
bhakti08 3:976579c5ba99 83 // return the debounced status
bhakti08 3:976579c5ba99 84 int DebouncedIn::read(void) {
bhakti08 3:976579c5ba99 85 return(_output);
bhakti08 3:976579c5ba99 86 }
bhakti08 3:976579c5ba99 87
bhakti08 3:976579c5ba99 88 // shorthand for read()
bhakti08 3:976579c5ba99 89 DebouncedIn::operator int() {
bhakti08 3:976579c5ba99 90 return read();
bhakti08 3:976579c5ba99 91 }
bhakti08 3:976579c5ba99 92
bhakti08 3:976579c5ba99 93