Display

The Display interface provides an abstraction over a small screen. The Display interface is implemented for various hardware peripherals and can be used with various services.

• SSD1306 or SH110X, OLED monochrome, I2C
• ST7789, ST7735, ILI9163, ILI9341, LCD color, SPI
• UC8151, eInk monochrome, SPI

I8080 not supported

The drivers use SPI or I2C. The parallel interface (I8080) is not supported at the moment.

Indexed screen

The startIndexedScreen returns a local client for the screen service. Most importantly it wraps the native driver to enable simulation of the screen on the simulated device (simulation does not work on hardware device as the communication channel is too slow).

• Source

import { SSD1306Driver, startIndexedScreen } from "@devicescript/drivers"

const display = await startIndexedScreen(
    // implements Display
    new SSD1306Driver({ width: 128, height: 64, devAddr: 0x3c })
)
display.image.print(`Hello world!`, 3, 10)
await display.show()

Character screen

The user sets a message on the character screen and it will be rendered on the screen. Using the service is compatible with the simulator.

• Service: character screen
• Source

import {
    SSD1306Driver,
    startCharacterScreenDisplay,
} from "@devicescript/drivers"

const screen = await startCharacterScreenDisplay(
    new SSD1306Driver({ width: 128, height: 64 })
)
await screen.message.write(`hello
world`)

Dot matrix

The screen emulates a dot matrix of monochrome LEDs.

• Service: dot matrix
• Source

import { SSD1306Driver, startDotMatrix } from "@devicescript/drivers"
import { img } from "@devicescript/graphics"

const dots = await startDotMatrix(
    new SSD1306Driver({
        width: 128,
        height: 64,
        devAddr: 0x3c,
    }),
    {
        rows: 5,
        columns: 5,
    }
)
await dots.writeImage(img`# # . # #
# # . # #
. # # # .
. # # # .
# . # . .`)