Bitmask Table

Overview

This widget helps display a table of values as LED indicators. The hardware sends a bitmask value, which the server parses to update LED states automatically. Each bit represents the ON/OFF status of an LED on the corresponding row.


What is a Bitmask?

A bitmask stores multiple true/false (binary) values in a single integer. Each bit represents a separate state (e.g., an error, alarm, or status).

  • 1 = ON (True)

  • 0 = OFF (False)


How the Server Parses the Data

When the hardware sends a bitmask as an integer, the server extracts individual bit states to update the table.

Example

A device has 11 error states, each represented by a bit in a bitmask value. If an error occurs, the corresponding bit is set to 1, turning ON the LED in the respective row.

  • Received Integer: 123

  • Binary Representation: 1111011

  • Mapped States:

    • Bit 0 → True

    • Bit 1 → True

    • Bit 2 → False

    • Bit 3 → True

    • Bit 4 → True

    • Bit 5 → True

    • Bit 6 → True

    • (Other bits remain False)

Bitmask Table Data Flow Visualization

Settings

  • Title – Optional widget title

  • Datastream – Select the datastream receiving the bitmask

    Only integer datastreams are supported

  • Label position – Labels on the left or right

  • Hide false values – Hide rows with a false (0) value

  • False color – LED color for false state

  • True color – LED color for true state

  • Bits mapping – Map bit indexes to specific rows

  • Inverse values – Reverse 1 and 0 logic (ON becomes OFF)

Bitmask Table Settings

Limits

  • Only integer datastreams are supported

  • Maximum of 50 rows

  • Maximum label length: 100 characters


Change Bitmask Table Properties from Hardware

Use this command in firmware to update widget properties:

Blynk.setProperty(vPin, "widgetProperty", "propertyValue");
  • vPin: Virtual pin assigned to the widget

  • widgetProperty: The property to change

  • propertyValue: New value to assign

Changeable Properties

You can dynamically update these widget properties:

  • label

  • isHidden

  • isDisabled

Example (Firmware)

Blynk.setProperty(V1, "isHidden", "true");

Example (HTTP API)

https://{server_address}/external/api/update/property?token={your_32_char_token}&pin=V1&isHidden=true

Last updated

Was this helpful?