The HID Scope comes in handy for debugging purposes. You can easily specify which values you want to monitor, whether it are Analog inputs, filtering floats or boolean states. Please refer to this bitbucket repository for the PC scope application: https://bitbucket.org/tomlankhorst/hidscope

It is possible to see what is going on in your device live. This step by step instruction will guide you through the process and it will be easy to adjust this setup to your needs.

Step 1, using the HIDScope on your MBED¶

If there is no project you currently working on, create one first. Now simply import the HIDScope library into your project by clicking on 'Import Library' on the homepage of this library.

Include the HIDScope library in your header

#include "HIDScope.h"

And define the HIDScope beneath your #include-s, outside of any function. The only parameter that it takes is the number of channels you would like to use. In this case we will use one channel.

HIDScope    scope(1);

Now set the data and send it over USB! This example reads and sends at 100hz the value of the analog in.

#include "mbed.h"
#include "HIDScope.h"

HIDScope    scope(1);
Ticker      scopeTimer;

AnalogIn    a0(p2);

void scopeSend()
{
    scope.set(0,a0.read());
    scope.send();
}

int main()
{
    
    scopeTimer.attach_us(&scopeSend, 1e4);  // send data at 100hz    
    
    while(1)
    {
    }
        
}

If you have a control-loop running at 10kHz you certainly wouldn't want to transfer the data at 10kHz (that isn't even possible using this device). You could SET the data in the 10kHz loop and SEND the data in a 50hz loop. See the following example using 2 channels:

#include "mbed.h"
#include "HIDScope.h"

HIDScope    scope(2);
Ticker      scopeTimer;
Ticker      controllerTimer;

AnalogIn    a0(p2);
AnalogIn    a1(p3);

void superFast()
{
    scope.set(0,a0.read());
    scope.set(1,a1.read());
}

int main()
{
    
    scopeTimer.attach_us(&scope, &HIDScope::send, 2e4);     // Send data @ 50hz
    controllerTimer.attach_us(&superFast, 1e3);             // Control at 1kHz
    
    while(1)
    {
    }
        
}

Upload it, you are ready! (With your MBED)

Step 2, installing the HID Scope software¶

The software is compatible with Windows, OSX and Linux.

Installation - Windows¶

You have to go through 2 installation steps and 1 step to start the scope.

Installation: NodeJS¶

Go to NodeJS website and click INSTALL follow the instructions

Installation: Get the HID Scope¶

• Download the HIDScope zip-file and extract it

Run: Start the HID Scope

• Open the just extracted folder and start 'windows_start.bat'

• Open in your browser http://localhost:18082

Installation - OSX / Unix¶

You have to go through 2 installation steps and 1 step to start the scope. Please note: [tilde] should be replaced by the same-named symbol.

Installation: NodeJS¶

Go to http://nodejs.org/ website and click INSTALL follow the instructions

Installation: Get the HID Scope¶

• Open ‘terminal’

• Clone the HIDScope repository using

git clone https://bitbucket.org/tomlankhorst/hidscope.git

• Go to the server directory inside the hid scope directory you just cloned

cd ./hidscope/server

• Remove the node-hid node-module and reinstall it (compile for OSX instead of Windows)

sudo rm -rf ./node_modules/node-hid sudo npm install node-hid

Run: Start the HID Scope¶

• Start the scope by executing the following command in Terminal

node ./server.js

• Open in your browser http://localhost:18082