Nerfed Poet Melancholia

    grove-lcd-rgb

    0.1.0 • Public • Published

    Grove LCD RGB API for Node.js grove-lcd-rgb

    This a port of Arduino library for Grove LCD RGB display with some additional functions. It follows Node.js' non-blocking semantics and targets Raspberry Pi.

    Usage

    Enable I2C using raspi-config or by uncommenting/adding dtparam=i2c_arm=on to /boot/config.txt

    Install library using:

    npm install --save grove-lcd-rgb

    See Wiring for wiring details.

    API

    GroveLCDRGB

    constructor({ characterSize, lines })

    Creates an instance of GroveLCDRGB by trying to open a I2C device with address 0x3e on bus /dev/i2c-{0-2}. Throws an Error if a bus was not found.

    • characterSize

      Sizes of a character in pixels. Defaults to: CharacterSize._5x8. See CharacterSize.

    • lines

      Number of lines a screen has. Defaults to: Lines.Two. See Lines.

    on()

    Turn the display on.

    off()

    Turn the display off.

    clear()

    Clear text from the display.

    blinkOn()

    Turn the cursor blinking on.

    blinkOff()

    Turn the cursor blinking off.

    cursorOn()

    Turn the cursor on.

    cursorOff()

    Turn the cursor off.

    cursorLeft()

    Move cursor left.

    cursorRight()

    Move cursor right.

    home()

    Set the location at which subsequent written text will be displayed to column 0, row 0.

    setCursor(col, row)

    Set the location at which subsequent written text will be displayed.

    • col the column at which to position the cursor

    • row the row at which to position the cursor

    autoscrollOn()

    autoscrollOff()

    scrollLeft()

    scrollRight()

    leftToRight()

    Flow text from left to right. Default mode.

    rightToLeft()

    Flow text from right to left

    blinkLEDOn(ratio)

    Control the backlight LED blinking.

    • ratio Blink ratio. On time in 1/256 of a second. Defaults to: 0x7f, half a second.

    blinkLEDOff()

    Turn off backlight LED blinking.

    createChar(location, charmap)

    setRGB(red, green, blue)

    Set backlight LED to specified color.

    • red Red component.

    • green Green component.

    • blue Blue component.

    setPWM(color, pwm)

    setTextRaw(text)

    Print text to the display without any additional formatting.

    • text Text to print.

    setText(text)

    CharacterSize

    _5x8 default for GroveLCDRGB constructors.

    _5x10

    Color

    Blue

    Green

    Red

    Lines

    One

    Two default for GroveLCDRGB constructors.

    Wiring

    Wiring

    LCD Raspberry Pi
    GND Any GND (e.g. pin 6)
    VCC Any 5V (e.g. pin 4)
    SDA SDA (pin 3)
    SDL SLD (pin 5)

    The LCD (at least v4.0) works correctly when wired to Raspberry Pi GPIO pins directly without a level-shifter.

    Examples

    TODO

    • Adapt to work on other devices.

    License

    MIT

    Install

    npm i grove-lcd-rgb

    DownloadsWeekly Downloads

    1

    Version

    0.1.0

    License

    MIT

    Unpacked Size

    13.5 kB

    Total Files

    5

    Last publish

    Collaborators

    • georgesapkin