README.rst
1.. zephyr:code-sample:: grove-lcd
2 :name: Grove LCD
3 :relevant-api: grove_display
4
5 Display an incrementing counter and change the backlight color.
6
7Overview
8********
9
10This sample displays an incrementing counter through the Grove LCD, with
11changing backlight.
12
13Requirements
14************
15
16To use this sample, the following hardware is required:
17
18* A board with ADC support
19* `Grove LCD module`_
20* `Grove Base Shield`_ [Optional]
21
22Wiring
23******
24
25You will need to connect the Grove LCD via the Grove shield onto a board that
26supports Arduino shields.
27
28On some boards you will need to use 2 pull-up resistors (10k Ohm) between the
29SCL/SDA lines and 3.3V.
30
31Take note that even though SDA and SCL are connected to a 3.3V power source, the
32Grove LCD VDD line needs to be connected to the 5V power line, otherwise
33characters will not be displayed on the LCD (3.3V is enough to power just the
34backlight).
35
36
37Building and Running
38********************
39
40This sample should work on any board that has I2C enabled and has an Arduino
41shield interface. For example, it can be run on the FRDM K64F board as
42described below:
43
44.. zephyr-app-commands::
45 :zephyr-app: samples/drivers/misc/grove_display
46 :board: frdm_k64f
47 :goals: flash
48 :compact:
49
50.. _Grove Base Shield: https://wiki.seeedstudio.com/Base_Shield_V2/
51.. _Grove LCD module: http://wiki.seeed.cc/Grove-LCD_RGB_Backlight/
52
