boards: shields: add adafruit adalogger featherwing

Add definition for the Adafruit Adalogger Featherwing. This shield compatible with the Adafruit Feather family is equipped with an SD card slot and a PCF8524 RTC. This work is based on the Adafruit Data Logger shield definition. (cherry picked from commit 8084111) Original-Signed-off-by: Philip-Dylan Gleonec <philip-dylan@gleonec.bzh> GitOrigin-RevId: 8084111 Cr-Build-Id: 8730937883239782945 Cr-Build-Url: https://cr-buildbucket.appspot.com/build/8730937883239782945 Copybot-Job-Name: zephyr-main-copybot-downstream Change-Id: I42ee70074463fa285ef74b4632b5c56555ba99e0 Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/zephyr/+/6028675 Tested-by: Tristan Honscheid <honscheid@google.com> Tested-by: ChromeOS Prod (Robot) <chromeos-ci-prod@chromeos-bot.iam.gserviceaccount.com> Reviewed-by: Tristan Honscheid <honscheid@google.com> Commit-Queue: Tristan Honscheid <honscheid@google.com>
coreboot · Nov 18, 2024 · eff6802 · eff6802
1 parent c7548bf
commit eff6802
Show file tree

Hide file tree

Showing 4 changed files with 104 additions and 0 deletions.
diff --git a/boards/shields/adafruit_adalogger_featherwing/Kconfig.shield b/boards/shields/adafruit_adalogger_featherwing/Kconfig.shield
@@ -0,0 +1,5 @@
+# Copyright (c) 2024 Philip-Dylan Gleonec <philip-dylan@gleonec.bzh>
+# SPDX-License-Identifier: Apache-2.0
+
+config SHIELD_ADAFRUIT_DATA_LOGGER
+	def_bool $(shields_list_contains,adafruit_adalogger_featherwing)
diff --git a/boards/shields/adafruit_adalogger_featherwing/adafruit_adalogger_featherwing.overlay b/boards/shields/adafruit_adalogger_featherwing/adafruit_adalogger_featherwing.overlay
@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2024 Philip-Dylan Gleonec <philip-dylan@gleonec.bzh>
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	aliases {
+		rtc = &rtc0_adafruit_adalogger_featherwing;
+		sdhc0 = &sdhc0_adafruit_adalogger_featherwing;
+	};
+};
+
+&feather_spi {
+	status = "okay";
+	cs-gpios = <&feather_header 17 GPIO_ACTIVE_LOW>; /* D10 */
+
+	sdhc0_adafruit_adalogger_featherwing: sdhc@0 {
+		compatible = "zephyr,sdhc-spi-slot";
+		reg = <0>;
+		spi-max-frequency = <12000000>;
+		status = "okay";
+
+		sdmmc {
+			compatible = "zephyr,sdmmc-disk";
+			status = "okay";
+		};
+	};
+};
+
+&feather_i2c {
+	status = "okay";
+
+	rtc0_adafruit_adalogger_featherwing: rtc@68 {
+		compatible = "nxp,pcf8523";
+		reg = <0x68>;
+		alarms-count = <1>;
+		battery-switch-over = "standard";
+		status = "okay";
+	};
+};
diff --git a/boards/shields/adafruit_adalogger_featherwing/doc/adafruit_adalogger_featherwing.webp b/boards/shields/adafruit_adalogger_featherwing/doc/adafruit_adalogger_featherwing.webp
diff --git a/boards/shields/adafruit_adalogger_featherwing/doc/index.rst b/boards/shields/adafruit_adalogger_featherwing/doc/index.rst
@@ -0,0 +1,58 @@
+.. _adafruit_adalogger_featherwing_shield:
+
+Adafruit Adalogger Featherwing Shield
+#####################################
+
+Overview
+********
+
+The `Adafruit Adalogger Featherwing Shield`_ features an `NXP PCF8523 Real-Time
+Clock/Calendar with Battery Backup`_, and an SD card interface.
+
+.. figure:: adafruit_adalogger_featherwing.webp
+   :align: center
+   :alt: Adafruit Adalogger Featherwing Shield
+
+   Adafruit Adalogger Featherwing Shield (Credit: Adafruit)
+
+Pin Assignments
+===============
+
++-----------------------+---------------------------------------------+
+| Shield Connector Pin  | Function                                    |
++=======================+=============================================+
+| D10                   | SD card SPI CS                              |
++-----------------------+---------------------------------------------+
+| MOSI                  | SD card SPI MOSI                            |
++-----------------------+---------------------------------------------+
+| MISO                  | SD card SPI MISO                            |
++-----------------------+---------------------------------------------+
+| SCK                   | SD card SPI SCK                             |
++-----------------------+---------------------------------------------+
+| SDA                   | PCF8523 RTC I2C SDA                         |
++-----------------------+---------------------------------------------+
+| SCL                   | PCF8523 RTC I2C SCL                         |
++-----------------------+---------------------------------------------+
+
+Requirements
+************
+
+This shield can only be used with a board which provides a configuration for Feather connectors and
+defines node aliases for SPI, I2C and GPIO interfaces (see :ref:`shields` for more details).
+
+Programming
+***********
+
+Set ``--shield adafruit_adalogger_featherwing`` when you invoke ``west build``. For example:
+
+.. zephyr-app-commands::
+   :zephyr-app: tests/drivers/rtc/rtc_api
+   :board: adafruit_feather_m0_basic_proto
+   :shield: adafruit_adalogger_featherwing
+   :goals: build
+
+.. _Adafruit Adalogger Featherwing Shield:
+   https://learn.adafruit.com/adafruit-adalogger-featherwing
+
+.. _NXP PCF8523 Real-Time Clock/Calendar with Battery Backup:
+   https://www.nxp.com/docs/en/data-sheet/PCF8523.pdf