.. _adafruit_data_logger_shield:

Adafruit Data Logger Shield
###########################

Overview
********

The `Adafruit Data Logger Shield`_ rev. B features an `NXP PCF8523 Real-Time Clock/Calendar with
Battery Backup`_, an SD card interface, two user LEDs, and a prototyping area.

.. figure:: adafruit_data_logger.jpg
   :align: center
   :alt: Adafruit Data Logger Shield

   Adafruit Data Logger Shield (Credit: Adafruit)

.. note::
   The older revision A of the Adafruit Data Logger Shield is not supported.

Pin Assignments
===============

+-----------------------+---------------------------------------------+
| Shield Connector Pin  | Function                                    |
+=======================+=============================================+
| D3                    | User LED1 (green) [1]_                      |
+-----------------------+---------------------------------------------+
| D4                    | User LED2 (red) [1]_                        |
+-----------------------+---------------------------------------------+
| D7                    | PCF8523 RTC INT1 [2]_                       |
+-----------------------+---------------------------------------------+
| D10                   | SD card SPI CS                              |
+-----------------------+---------------------------------------------+
| D11                   | SD card SPI MOSI                            |
+-----------------------+---------------------------------------------+
| D12                   | SD card SPI MISO                            |
+-----------------------+---------------------------------------------+
| D13                   | SD card SPI SCK                             |
+-----------------------+---------------------------------------------+
| SDA                   | PCF8523 RTC I2C SDA                         |
+-----------------------+---------------------------------------------+
| SCL                   | PCF8523 RTC I2C SCL                         |
+-----------------------+---------------------------------------------+

.. [1] The user LEDs are not connected to ``D3`` and ``D4`` by default. Jumper or jumper wire
       connections must be established between the ``L1`` and ``Digital I/O 3`` pins for ``LED1``
       and ``L2`` and ``Digital I/O 4`` pins for ``LED2`` if they are to be used.

.. [2] The PCF8523 RTC ``INT1`` interrupt output pin is not connected to ``D7`` by default. A jumper
       wire connection must be established between the ``SQ`` pin and the ``Digital I/O 7`` pin in
       order to use the RTC interrupt functionality (i.e. alarm callback, 1 pulse per second
       callback). The ``INT1`` interrupt output is open-drain, but the shield definition enables an
       internal GPIO pull-up and thus no external pull-up resistor is needed.

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

This shield can only be used with a board which provides a configuration for Arduino connectors and
defines node aliases for SPI and GPIO interfaces (see :ref:`shields` for more details).

Programming
***********

Set ``-DSHIELD=adafruit_data_logger`` when you invoke ``west build``. For example:

.. zephyr-app-commands::
   :zephyr-app: tests/drivers/rtc/rtc_api
   :board: frdm_k64f
   :shield: adafruit_data_logger
   :goals: build

.. _Adafruit Data Logger Shield:
   https://learn.adafruit.com/adafruit-data-logger-shield/

.. _NXP PCF8523 Real-Time Clock/Calendar with Battery Backup:
   https://www.nxp.com/docs/en/data-sheet/PCF8523.pdf