Uniot Badge
Last updated
Last updated
The Uniot Badge is a mini IoT development board. Made in the size of a credit card, this badge is designed to be both a fun gadget and a showcase of what IoT can achieve. The board has several interactive components, including colorful LEDs, a button, a vibration motor, and a sensor, all packed into a sleek form factor.
The Uniot Badge is equipped with the following hardware components:
VL53L0X ToF Sensor: A time-of-flight sensor for distance measurement.
Button: A button for user interaction.
Vibration Motor: A small motor that can vibrate to provide haptic feedback.
10x addressable RGB LEDs: A circle of 10 RGB LEDs for displaying colors and patterns (NeoPixel-like).
You can redeem the promo code by scanning the QR code on your badge. This promo code will extend your plan by:
Device: +1
Dashboard: 1
Script: +1
A script and a dashboard, both named 'Uniot Promo Badge,' will also be created on the platform for demonstration purposes. You can deploy the script to the badge and try it out in interaction with the dashboard.
The Uniot Badge can light up, vibrate, measure distances, and even react to your actions. With just the press of a button, you can activate various features like making lights flash in patterns or making the badge respond to movement.
Parameters:
Times (Number): Number of vibrations
Reads the value of the distance sensor.
Returns:
Distance (Number): Distance to obstacle in millimeters
Turns all LEDs off.
Sets an LED's color.
Parameters:
Index (Number): LED index (0-9)
Red (Number): Red color brightness (0-255)
Green (Number): Green color brightness (0-255)
Blue (Number): Blue color brightness (0-255)
Turns on the set LEDs.
The visual script generates the following code:
To demonstrate the functionality of the badge, this script uses several blocks:
Variables Initialization: The blocks initializes several variables.
led: The number of active (glowing) LEDs.
led_fill: The indicator of the pattern according to which the LEDs will turn on.
red: The brightness of the red color of the LEDs.
green: The brightness of the green color of the LEDs.
blue: The brightness of the blue color of the LEDs.
Function Block: Function map accepts 5 arguments and performs a linear interpolation to calculate the number of active LEDs relative to the distance sensor value.
x: The distance sensor value
in_min: The minimum value of the distance sensor (in millimeters).
in_max: The maximum value of the distance sensor (in millimeters).
out_min: The minimum number of active LEDs.
out_max: The maximum number of active LEDs.
Run Task Block: Configured to run every 80 milliseconds indefinitely (as the times parameter is set to 0).
Color Events Trigger Block: Responds to the red/green/blue events by updating corresponding variables to the event's value.
Distance Sensor Reading: Calls the tof_distance primitive and sets the value of the sensor to the distance variable.
Determining Active LEDs: Calls the map function to calculate the number of active LEDs relative to distance.
Update LEDs Block: Updates LEDs according to current data.
Turn Off Block: Calls the pixel_clear primitive to turn off all LEDs.
Set Color Block: Set the color for the active LED(s) according to the pattern (led_fill) using the pixel_set primitive.
Turn On Block: Calls the pixel_show primitive to turn on the set LEDs.
Event Trigger Block: Responds to the capture event by emmiting a global event distance with the distance variable value. Checks whether the value of the capture event is equal to 1 to generate the distance event only once when the corresponding Push Button widget is pressed on the dashboard (this widget generates an event with a value of 1 when pressed and an event with a value of 0 when the button is released)
With this script, you can turn the badge into a personal reminder tool. It can vibrate at set frequencies to remind you to take a break, drink water, or stretch. The LEDs are also used to show different colors based on the type of reminder – blue for hydration, green for stretching, red for break.
The visual script generates the following code:
Let's take a closer look at the individual parts of the script:
Variables Initialization
TASK_INTERVAL: The task execution interval (in ms).
WATER_INTERVAL: How often you want to drink water (every 60 minutes, in ms).
BREAK_INTERVAL: How often you want to take a break (every 180 minutes, in ms).
STRETCH_INTEVAL: How often you want to stretch (every 90 minutes, in ms).
water_timer: The water timer, set to the corresponding frequency value.
break_timer: The break timer, set to the corresponding frequency value.
stretch_timer: The stretch timer, set to the corresponding frequency value.
red: The brightness of the red color of the LEDs.
green: The brightness of the green color of the LEDs.
blue: The brightness of the blue color of the LEDs.
current_reminder: The numeric value of the reminder (1 for water, 2 for break, 3 for stretch).
Run Task Block: Configured to run every TASK_INTERVAL milliseconds indefinitely (as the times parameter is set to 0).
Process Reminder Block: The process_reminder function processes provided reminder type (numeric value of the reminder) and it's corresponding timer (timer). If the timer is expired:
Set Info: Sets variable active as true (an indicator that there is an active reminder). Sets variable current_reminder to the numeric value of the reminder (the type argument passed to the function).
Set Color: Sets color according to the current_reminder.
Notification Block: Runs vibration motor and turns LEDs on by calling the corresponding primitives.
Reset Reminder Block: The reset_reminder function, as the name implies, resets the current reminder.
Update Timers Block: Reduces the value of the timers by TASK_INTERVAL every task execution.
Check Reminders Block: Checks each type of reminder by calling the process_reminder function if no reminder is active (do not processes new reminders until the current one is acknowledged).
Button Check Block: Monitors if the button is clicked. When clicked, resets current reminder by calling the reset_reminder function.
With the following script the badge can act as as a control device for household appliances. There is a tap gesture (quick down-up motion) detection. The appliance state switched when tap is detected.
The visual script generates the following code:
The script consist of the following parts:
Variables Initialization
TASK_INTERVAL: The frequency of task execution (in ms).
distance: The current value of the distance sensor.
state: The appliance state (switched by a tap).
tap_state: The current gesture state:
0: No tap in progress.
1: Hand started moving within the thresholds.
2: Hand detected below minimum threshold.
3: Hand is back within the thresholds.
TAP_DURATION: The maximum allowed time (in ms) for a valid tap.
TAP_TRESH_MAX: The sensor distance below which gesture detecion starts.
TAP_TRESH_MIN: The sensor distance below which a tap state is considered as 2.
tap_timer: The timer to track a tap validity.
Run Task Block: Configured to run every TASK_INTERVAL milliseconds indefinitely (as the times parameter is set to 0).
Distance Sensor Reading: Calls the tof_distance primitive and sets the value of the sensor to the distance variable.
Gesture Recognition Block: The trackGesture function determines whether a tap has been performed and emits a global event if it has.
Update LEDs Block: Listens to a global event, changes the local state and updates LEDs according to this state.
With a few additions to the previous script, the device can turn into a motion detector with just one event (this event can be generated by a widget on the dashboard or by another device).
The visual script generates the following code:
This script has everything from the previous script and the following additions:
Variables Initialization
is_detector: Indicates that the device is operating as a motion detector.
fixed_distance: Stores the value from the distance sensor at the time of arming
Intrusion Recognition Block: The trackIntrusion function checks whether the value from the distance sensor has changed after arming, and if so, generates a global event alarm with value 1.
Check Guard Block: Responds to the protection event by updating the is_detector variable to the event's value. Fixes the current value of the distance sensor if the device is in armed mode, or generates an alarm event with a value of 0 if the device is in the switch mode.
ESP32-C3 Dev Board: The main microcontroller board that runs on the .
To start working with the Uniot Badge, you need to flash the board and add it to the platform. The firmware source code can be found . Instructions for flashing and adding the device to the platform are available in the section.
Learn more about this script below in the section. If you wish, you can delete these dashboard and script and create your own (the plan extension will remain).
To interact with peripherals, the firmware has corresponding primitives. Read more about primitives .
Vibrates the specified number of times (the period of one vibration is set in the ).
The Uniot Badge is powered by firmware based on . You can find the source code of the firmware .
Button Check Block: Monitors if the button (that occupies the register with index 0, learn more about registers ) is clicked. When clicked, inverts the state of the led_fill variable and calls vibro primitive to provide a haptic feedback.
