This repository offers comprehensive web interface for controlling and monitoring OpenEarable. A hosted version of this dashboard is available here. The dashboard offers acces to different sensors, audio controls, button events and the RGB LED of OpenEarable. In addition, it shows real-time graphs of accelerometer, gyroscope, magnetomer, pressure, and temperature sensor data. Users can use the dashboard to label incoming data and download the labeled data as csv file (edge-ml.org compatible format for no-code machine learning).
This repository also includes the OpenEarable.js JavaScript library in the assets/js/OpenEarable.js
folder. This way, researchers and developers can easily integrate OpenEarable into their own workflows.
โ
โGet OpenEarable device now!โ
โ
The dashboard runs directly in your browser. You can connect to OpenEarable without having to install anything as it works via WebBLE (latest Chrome version is recommended).
dashboard.mov
If you want to run the dashboard yourself and have python3 installed, you can use the following command to run the website from the root of this repository. This will start the webserver at http://localhost:8000
.
python3 -m http.server
OpenEarable.js is a JavaScript library that provides a seamless interface to connect, manage, and interact with OpenEarable. The library abstracts the complexities of BLE communication, making it easy to fetch device details, manage sensors, LED, and audio, and subscribe to device state changes.
To use OpenEarable.js simply integrate the library found under assets/js/OpenEarable.js
into your project as follows.
<script src="./OpenEarable.js"></script>
The following example shows how to use the OpenEarable library.
const openEarable = new OpenEarable();
// Read device information once connected
openEarable.bleManager.subscribeOnConnected(async () => {
const deviceId = await openEarable.readDeviceIdentifier();
const firmwareVersion = await openEarable.readFirmwareVersion();
const hardwareVersion = await openEarable.readHardwareVersion();
});
// Connect to OpenEarable
openEarable.bleManager.connect();
// Disconnect from OpenEarable
openEarable.bleManager.disconnect();
// Subscribe to the sensor data
openEarable.subscribeOnSensorDataReceived((data) => {
// Process the received IMU data
console.log(data);
});
// Enable IMU at 30 Hz
sensorManager.writeSensorConfig(0, 30, 0); // 0 sensorId, 30 samplingRate
OpenEarable allows playing mono, 16-bit, 44.1kHz *.wav files from the internal microSD card. In addition, it is possible to generate a constant frequency on the OpenEarable directly or play one of the built-in jingles.
// Supported audio states: AUDIO_STATE.PLAY, AUDIO_STATE.PAUSE, AUDIO_STATE.STOP
// Play audio file from microSD card with the name "music.wav"
openEarable.audioPlayer.wavFile(AUDIO_STATE.PLAY, "music.wav");
// Play a constant frequency sine wave at 22 kHz
// Wave types: WAVE_TYPE.SINE, WAVE_TYPE.TRIANGLE, WAVE_TYPE.SQUARE, WAVE_TYPE.SAW
// Loudness: 0 to 1.0
openEarable.audioPlayer.frequency(AUDIO_STATE.PLAY, WAVE_TYPE.SINE, 22000, 0.5);
// Play a default NOTIFICATION jingle from the internal OpenEarable storage
openEarable.audioPlayer.jingle(AUDIO_STATE.PLAY, JINGLE.NOTIFICATION);
// set the LED color to red (accepts values from 0 to 255 for R, G, B)
openEarable.rgbLed.writeLedColor(255, 0, 0);
openEarable.buttonManager.subscribeOnButtonStateChanged((state) => {
// process button state here
})
openEarable.subscribeBatteryLevelChanged((batteryLevel) => {
// process battery level here
});
// Supported battery states: BATTERY_STATE.CHARGING, BATTERY_STATE.CHARGED, BATTERY_STATE.NOT_CHARGING
openEarable.subscribeBatteryStateChanged((batteryState) => {
// process battery state here
});
Distributed under the MIT License. See LICENSE for more information.
- developed by the TECO research group at the Karlsruhe Institute of Technology
- icons by Bootstrap Icons