Lightbug Documentation

Appearance

10008: Base Page ​

Draw a base device page. Base pages are pre-defined pages in the device firmware, such as the home page. These may differ in their appearance between device types.

Payload ​

FieldNameDescriptionTypeUnit
3Page IDThe page to draw.

Possible values:
  • 1: Home Page— The preset home page programmed into the device
  • 5: Diagnostics Page— The preset diagnostics page programmed into the device
uint8
5Status bar EnableShow the status barbool
6Redraw TypePossible values:
  • 0: Auto— Automatically choose the redraw type, based on page id. No page id provided will assume the same page id as last set. Same page id as last set will do a partial redraw, and leave the buffer intact. Changed page id will clear the buffer and do a full redraw.
  • 1: PartialRedraw— Only redraw the parts of the screen changed in this message. Leaves the buffer intact. Will occasionally do a full redraw if the firmware thinks it is needed.
  • 2: FullRedraw— Clear the screen buffer, and redraw the entire screen
  • 3: BufferOnly— Do not redraw the screen, only update the buffer. Will clear the buffer if the page id has changed. Similar to Auto, but will not redraw the screen. Similar to ClearDontDraw, but only clears the buffer if the page id has changed.
  • 4: FullRedrawWithoutClear— Redraw the entire screen, without clearing the buffer
  • 5: ClearDontDraw— Clear the screen buffer (always), but don't redraw. Similar to BufferOnly, but always clears the buffer.
uint8

Pages ​

This is what the base pages actually look like.

1: Home page ​

RH2 ​

Examples ​

Request the home page (page 1) to be drawn
Protocol
03
3
Length
2000
20 bytes
Type
2439
10008 (Base Page)
Header Count
0100
1
Header Types
01
1
Message ID
0457480000
12345
Payload Count
0100
1
Payload Types
03
3
Page ID
0101
1 (Home Page)
Checksum
24173
18929
📡 Real example from RH2 ESP32 Toit. on 2025-10-10This example is captured from an RH2 device as part of normal communications over I2C with the ESP32 co-processor, where Toit on the ESP32 make the request.
Request the diagnostics page (page 5) to be drawn
Protocol
3
3
Length
200
20 bytes
Type
2439
10008 (Base Page)
Header Count
10
1
Header Types
1
1
Message ID
4574800
12345
Payload Count
10
1
Payload Types
3
3
Page ID
15
5 (Diagnostics Page)
Checksum
1179
2421
📡 Real example from RH2 ESP32 Toit. on 2026-08-07This example was generated using the generate tool, and tested against an RH2 device, sent from Toit.

Code ​

For convenience, the following constants can be used to reference this message type.