zephyr/samples/subsys/display/grove_display
Anas Nashif 6882b5d912 sampels: move display into subsys/display
This should align with subsys/display which we do not have yet. Plan is
to move lib/gui into subsys/display.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2021-03-09 17:48:18 -05:00
..
boards sampels: move display into subsys/display 2021-03-09 17:48:18 -05:00
src sampels: move display into subsys/display 2021-03-09 17:48:18 -05:00
CMakeLists.txt sampels: move display into subsys/display 2021-03-09 17:48:18 -05:00
prj.conf sampels: move display into subsys/display 2021-03-09 17:48:18 -05:00
README.rst sampels: move display into subsys/display 2021-03-09 17:48:18 -05:00
sample.yaml sampels: move display into subsys/display 2021-03-09 17:48:18 -05:00

.. _grove-lcd-sample:

Grove LCD
#########

Overview
********

This sample displays an incrementing counter through the Grove LCD, with
changing backlight.

Requirements
************

To use this sample, the following hardware is required:

* A board with ADC support
* `Grove LCD module`_
* `Grove Base Shield`_ [Optional]

Wiring
******

You will need to connect the Grove LCD via the Grove shield onto a board that
supports Arduino shields.

On some boards you will need to use 2 pull-up resistors (10k Ohm) between the
SCL/SDA lines and 3.3V.

Take note that even though SDA and SCL are connected to a 3.3V power source, the
Grove LCD VDD line needs to be connected to the 5V power line, otherwise
characters will not be displayed on the LCD (3.3V is enough to power just the
backlight).


Building and Running
********************

This sample should work on any board that has I2C enabled and has an Arduino
shield interface. For example, it can be run on the FRDM K64F board as
described below:

.. zephyr-app-commands::
   :zephyr-app: samples/display/grove_display
   :board: frdm_k64f
   :goals: flash
   :compact:

.. _Grove Base Shield: http://wiki.seeedstudio.com/wiki/Grove_-_Base_Shield
.. _Grove LCD module: http://wiki.seeed.cc/Grove-LCD_RGB_Backlight/