The dashboard is a pure JavaScript application that starts by connecting to your board, then it queries which Bluetooth services are supported, and dynamically generates the dashboard to only show the services that are available. You can get to the dashboard by navigating in Chrome to https://adafruit.github.io/Adafruit_WebBluetooth_Dashboard/ or clicking the button below.
Connecting
Connecting to the dashboard is pretty simple. Just click on the button marked Connect. A dialog should come up showing you the various Bluetooth Connections that are available.
By default it will show only known boards. However, if you have a different board, you can uncheck Show only known devices and it will show you everything it detects.
Once you are connected, you should several panels appear. The exact number depends on the board and firmware you are using. Try playing around with the board and see what happens.
Types of Panels
There are several different kinds of panels and they are designed for different purposes. Some types of data can be displayed on different types of panels. For instance, sensor data could either be displayed with a text panel, which will show the latest values or it can be graphed with a graph panel.
Text panels are your basic panel which will show the data value as text. For each panel, a format field is applied so that it shows up in a more meaningful way. At this time, no text panels are being used. They are useful as a basis for testing new sensors.
Graph panels allow you to display the data as a graph. It can show either one data dataset as with the temperature or it can show multiple datasets such as with the accelerometer. The latest data will always show in the top half of the panel as indicated by the circles.
Color panels are designed for changing the color of NeoPixel LEDs. They are less flexible than most of the other panels due to their need to be pretty specific. It's possible to have multiple color pickers that each change the same set of NeoPixels.
The 3D panel is meant for displaying the orientation of the board and is also pretty inflexible since there is only one quaternion service and this displays the data from there.
The custom panel is for unique panels that are primarily used by a single sensor that have controls that are unlike other panels. The battery and tone panels are custom panels because of it made more sense to go this route.
Available Panels
There are over a dozen different panels currently available. These panels are:
Battery
This will display the battery percentage as both a graphic and text. The color of the battery will change depending on the charge level.
Temperature
This will display the current temperature in Celsius in a graph.
Light
This will display the current light level in a graph.
Accelerometer
This will display the X, Y, and Z axes in meters/second2 a graph.
Gyroscope
On older versions of the firmware, this will display the Gyroscope values X, Y, and Z axes in radians in a graph.
Magnetometer
On older versions of the firmware, this will display the Magnetometer values X, Y, and Z axes in micro-Teslas in a graph.
Buttons
This will display the current button or buttons as a graphical representation The number of buttons displayed depends on the type of board connected.
Switch
This will display the current switch position as a graphical representation if the current board has a switch. This is tied into the button service.
Humidity
This will display the relative humidity as a percentage in a graph.
Barometric Pressure
This will display the Barometric Pressure in hectoPascals.
Tone
Clicking the button in this panel will play a 440Hz tone for 1 second.
NeoPixel
This will give you a color picker and changing the color will change the color of the NeoPixel LED(s) on the board. On the Circuit Playground Bluefruit, it will light up the entire ring of NeoPixels.
3D Model
This will display a bunny and changing the orientation of the board should change the orientation of the bunny.
The Log
At the bottom of the page is a log that will show you some of the device information including some of the services and characteristics that were found when the device connected as well as messages about connecting and disconnecting.
There are a few other controls such as AutoScroll, which will automatically scroll the log, Show Timestamp, which will print a timestamp beside every line in the log, and a Clear Text button. The Clear Text button will clear any data that has transferred, but keep the connection open. The application is targeting 30 frames per second. It can actually run faster than this, but slowing it down gives the browser time enough to respond to notifications.
Page last edited March 08, 2024
Text editor powered by tinymce.
