---
title: "Backlight"
canonical_url: https://developer.repebble.com/pebbleos/docs/samples/drivers/backlight/
last_updated: 2026-11-17
sdk_version: 4.44
---
# Backlight

Source: https://developer.repebble.com/pebbleos/docs/samples/drivers/backlight/

This sample ramps the backlight from off to full brightness and back in steps of 5, then, at full brightness, sets it to red, green, blue and white. A backlight without color refuses colors with `-ENOTSUP`, and the sample says so. It turns the backlight off at the end.

On a watch, the screen lights up and fades out. The emulator shows the backlight on its window.

Run:

`pbl samples samples/drivers/backlight`

Boards:

every board

## Sources

src/main.c

```
#include \<errno.h\>#include \<stdint.h\>#include \<stdio.h\>#include \<pbl/drivers/backlight.h\>#include \<pbl/kernel/delay.h\>#define STEP 5#define STEP\_MS 50static int prv\_set(uint8\_t brightness) {int ret;ret = pbl\_backlight\_set\_brightness(BACKLIGHT, brightness);if (ret != 0) {fprintf(stderr, "backlight: set to %d failed (%d)\n", brightness, ret);}return ret;}static int prv\_ramp(int from, int to) {int step = from \< to ? STEP : -STEP;int ret;for (int b = from; b != to + step; b += step) {ret = prv\_set((uint8\_t)b);if (ret != 0) {return ret;}pbl\_sleep\_ms(STEP\_MS);}return 0;}int main(void) {static const uint32\_t colors[] = {BACKLIGHT\_COLOR\_RED, BACKLIGHT\_COLOR\_GREEN, BACKLIGHT\_COLOR\_BLUE, BACKLIGHT\_COLOR\_WHITE};int ret;/\* Brightness goes from 0 (off) to PBL\_BACKLIGHT\_BRIGHTNESS\_MAX. \*/ret = prv\_ramp(0, PBL\_BACKLIGHT\_BRIGHTNESS\_MAX);if (ret != 0) {return ret;}printf("backlight: ramped up to %d\n", PBL\_BACKLIGHT\_BRIGHTNESS\_MAX);ret = prv\_ramp(PBL\_BACKLIGHT\_BRIGHTNESS\_MAX, 0);if (ret != 0) {return ret;}printf("backlight: ramped down to 0\n");ret = prv\_set(PBL\_BACKLIGHT\_BRIGHTNESS\_MAX);if (ret != 0) {return ret;}/\* Backlights without color refuse it with -ENOTSUP. \*/for (unsigned int i = 0; i \< sizeof(colors) / sizeof(colors[0]); i++) {ret = pbl\_backlight\_set\_color(BACKLIGHT, colors[i]);if (ret == -ENOTSUP) {printf("backlight: no color\n");break;} else if (ret != 0) {fprintf(stderr, "backlight: color failed (%d)\n", ret);return ret;}printf("backlight: color 0x%x\n", (unsigned int)pbl\_backlight\_get\_color(BACKLIGHT));pbl\_sleep\_ms(500);}ret = prv\_set(0);if (ret != 0) {return ret;}printf("backlight: off\n");printf("Sample done\n");return 0;}
```

## Output

```
backlight: ramped up to 100
backlight: ramped down to 0
backlight: (no color|color 0xff0000)
backlight: off
Sample done
```

Generated from PebbleOS [9e782207f](https://github.com/coredevices/pebbleos/commit/9e782207f53f8f1c02f7b13ea40cdc092d7bab3d). This page is maintained in the pebbleos repository: [docs/samples/drivers/backlight.md](https://github.com/coredevices/pebbleos/blob/9e782207f53f8f1c02f7b13ea40cdc092d7bab3d/docs/samples/drivers/backlight.md).
