samples: drivers: Add auxdisplay_digits sample

This commit introduces a new sample for the Auxiliary display driver.

The sample demonstrates counting from 0 to 1000, with an interval of 100ms
between each increment.

This sample primarily serves to demonstrate the capabilities of segment
displays.

Signed-off-by: Chen Xingyu <[email protected]>

Author: xingrz

samples/drivers/auxdisplay_digits/CMakeLists.txt

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+
+find_package(Zephyr HINTS $ENV{ZEPHYR_BASE})
+project(auxdisplay_digits)
+
+target_sources(app PRIVATE src/main.c)

samples/drivers/auxdisplay_digits/boards/esp32c3_devkitm.overlay

@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2024 Chen Xingyu <[email protected]>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/dt-bindings/gpio/gpio.h>
+
+/ {
+	auxdisplay_0: digi-display {
+		compatible = "gpio-7-segment";
+		columns = <3>;
+		rows = <1>;
+		segment-gpios = <&gpio0 5 GPIO_ACTIVE_LOW>,  /* A */
+				<&gpio0 9 GPIO_ACTIVE_LOW>,  /* B */
+				<&gpio0 3 GPIO_ACTIVE_LOW>,  /* C */
+				<&gpio0 1 GPIO_ACTIVE_LOW>,  /* D */
+				<&gpio0 10 GPIO_ACTIVE_LOW>, /* E */
+				<&gpio0 6 GPIO_ACTIVE_LOW>,  /* F */
+				<&gpio0 2 GPIO_ACTIVE_LOW>,  /* G */
+				<&gpio0 0 GPIO_ACTIVE_LOW>;  /* DP */
+		digit-gpios = <&gpio0 4 GPIO_ACTIVE_HIGH>,  /* DIG1 */
+			      <&gpio0 7 GPIO_ACTIVE_HIGH>,  /* DIG2 */
+			      <&gpio0 8 GPIO_ACTIVE_HIGH>;  /* DIG3 */
+		refresh-period-ms = <1>;
+	};
+};

samples/drivers/auxdisplay_digits/prj.conf

@@ -0,0 +1,2 @@
+CONFIG_AUXDISPLAY=y
+CONFIG_LOG=y

samples/drivers/auxdisplay_digits/sample.yaml

@@ -0,0 +1,11 @@
+sample:
+  description: Demonstration of auxdisplay driver for segment displays
+  name: Auxiliary (segment) display sample
+tests:
+  sample.drivers.auxdisplay_digits:
+    tags: auxdisplay
+    harness_config:
+      fixture: fixture_auxdisplay
+    platform_allow: esp32c3_devkitm
+    integration_platforms:
+      - esp32c3_devkitm

samples/drivers/auxdisplay_digits/src/main.c

@@ -0,0 +1,119 @@
+/*
+ * Copyright (c) 2023 Jamie McCrae
+ * Copyright (c) 2024 Chen Xingyu <[email protected]>
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <math.h>
+#include <string.h>
+#include <zephyr/kernel.h>
+#include <zephyr/device.h>
+#include <zephyr/drivers/auxdisplay.h>
+#include <zephyr/logging/log.h>
+
+LOG_MODULE_REGISTER(auxdisplay_sample, LOG_LEVEL_DBG);
+
+#define AUXDISPLAY_NODE        DT_NODELABEL(auxdisplay_0)
+#define AUXDISPLAY_DIGIT_COUNT DT_PROP_LEN(AUXDISPLAY_NODE, digit_gpios)
+
+static const struct device *const dev = DEVICE_DT_GET(AUXDISPLAY_NODE);
+static uint8_t data[AUXDISPLAY_DIGIT_COUNT * 2];
+
+int main(void)
+{
+	int rc;
+	int i, len;
+
+	if (!device_is_ready(dev)) {
+		LOG_ERR("Auxdisplay device is not ready.");
+		return -ENODEV;
+	}
+
+	/* Light up all segments */
+	for (i = 0; i < AUXDISPLAY_DIGIT_COUNT; i++) {
+		data[i * 2] = '8';
+		data[i * 2 + 1] = '.';
+	}
+	rc = auxdisplay_write(dev, data, strlen(data));
+	if (rc != 0) {
+		LOG_ERR("Failed to write data: %d", rc);
+		return rc;
+	}
+
+	k_msleep(500);
+
+	/* Blinks it once */
+
+	rc = auxdisplay_display_off(dev);
+	if (rc != 0) {
+		LOG_ERR("Failed to turn display off: %d", rc);
+		return rc;
+	}
+
+	k_msleep(500);
+
+	rc = auxdisplay_display_on(dev);
+	if (rc != 0) {
+		LOG_ERR("Failed to turn display on: %d", rc);
+		return rc;
+	}
+
+	k_msleep(500);
+
+	/* Clear the display */
+
+	rc = auxdisplay_clear(dev);
+	if (rc != 0) {
+		LOG_ERR("Failed to clear display: %d", rc);
+		return rc;
+	}
+
+	k_msleep(500);
+
+	/* Test cursor movement by filling each digit with a number */
+
+	for (i = 0; i < AUXDISPLAY_DIGIT_COUNT; i++) {
+		snprintf(data, sizeof(data), "%d", i);
+		rc = auxdisplay_write(dev, data, strlen(data));
+		if (rc != 0) {
+			LOG_ERR("Failed to write data: %d", rc);
+			return rc;
+		}
+
+		k_msleep(500);
+	}
+
+	k_msleep(500);
+
+	/* Count from 0 up to fill all digits */
+
+	for (i = 0;; i = (i + 1) % (int)pow(10, AUXDISPLAY_DIGIT_COUNT)) {
+		snprintk(data, sizeof(data), "%d", i);
+		len = strlen(data);
+
+		rc = auxdisplay_clear(dev);
+		if (rc != 0) {
+			LOG_ERR("Failed to clear display: %d", rc);
+			return rc;
+		}
+
+		/* Right-align the number */
+		rc = auxdisplay_cursor_position_set(dev, AUXDISPLAY_POSITION_ABSOLUTE,
+						    AUXDISPLAY_DIGIT_COUNT - len, 0);
+		if (rc != 0) {
+			LOG_ERR("Failed to set cursor position: %d", rc);
+			return rc;
+		}
+
+		rc = auxdisplay_write(dev, data, len);
+		if (rc != 0) {
+			LOG_ERR("Failed to write data: %d", rc);
+			return rc;
+		}
+
+		k_msleep(100);
+	}
+
+	return 0;
+}