diff --git a/boards/shields/mikroe_flash_8_click/Kconfig.shield b/boards/shields/mikroe_flash_8_click/Kconfig.shield new file mode 100644 index 0000000000000..893fc6b3bf9f9 --- /dev/null +++ b/boards/shields/mikroe_flash_8_click/Kconfig.shield @@ -0,0 +1,5 @@ +# Copyright The Zephyr Project Contributors +# SPDX-License-Identifier: Apache-2.0 + +config SHIELD_MIKROE_FLASH_8_CLICK + def_bool $(shields_list_contains,mikroe_flash_8_click) diff --git a/boards/shields/mikroe_flash_8_click/doc/images/mikroe_flash_8_click.webp b/boards/shields/mikroe_flash_8_click/doc/images/mikroe_flash_8_click.webp new file mode 100644 index 0000000000000..31e3d5755b38b Binary files /dev/null and b/boards/shields/mikroe_flash_8_click/doc/images/mikroe_flash_8_click.webp differ diff --git a/boards/shields/mikroe_flash_8_click/doc/index.rst b/boards/shields/mikroe_flash_8_click/doc/index.rst new file mode 100644 index 0000000000000..c409ca5c4b7cb --- /dev/null +++ b/boards/shields/mikroe_flash_8_click/doc/index.rst @@ -0,0 +1,48 @@ +.. _mikroe_flash_8_click_shield: + +MikroElektronika Flash 8 Click +================================ + +Overview +******** + +`Flash 8 Click`_ is a compact add-on board representing a highly reliable memory solution. + +This board features the GD5F2GQ5UEYIGR, a 2Gb high-density non-volatile memory storage solution +for embedded systems from GigaDevice Semiconductor. It is based on an industry-standard NAND Flash +memory core, representing an attractive alternative to SPI-NOR and standard parallel NAND Flash +with advanced features. The GD5F2GQ5UEYIGR also has advanced security features (8K-Byte OTP region), +software/hardware write protection, can withstand many write cycles (minimum 100k), and has a data +retention period greater than ten years. + +.. figure:: images/mikroe_flash_8_click.webp + :align: center + :alt: Flash 8 Click + :height: 300px + + Flash 8 Click + +Requirements +************ + +This shield can only be used with a board that provides a mikroBUS™ socket and defines a +``mikrobus_spi`` node label for the mikroBUS™ SPI interface. See :ref:`shields` for more +details. + +Programming +*********** + +Set ``--shield mikroe_flash_8_click`` when you invoke ``west build``. For example: + +.. zephyr-app-commands:: + :zephyr-app: samples/drivers/flash_shell + :board: frdm_mcxn947/mcxn947/cpu0 + :shield: mikroe_flash_8_click + :goals: build + +References +********** + +- `Flash 8 Click`_ + +.. _Flash 8 Click: https://www.mikroe.com/flash-8-click diff --git a/boards/shields/mikroe_flash_8_click/mikroe_flash_8_click.overlay b/boards/shields/mikroe_flash_8_click/mikroe_flash_8_click.overlay new file mode 100644 index 0000000000000..6c7c081fa06b0 --- /dev/null +++ b/boards/shields/mikroe_flash_8_click/mikroe_flash_8_click.overlay @@ -0,0 +1,26 @@ +/* + * Copyright The Zephyr Project Contributors + * SPDX-License-Identifier: Apache-2.0 + */ + +&mikrobus_spi { + status = "okay"; + cs-gpios = <&mikrobus_header 2 GPIO_ACTIVE_LOW>; + + spi_nand_mikroe_flash_8_click: spi-nand@0 { + compatible = "jedec,spi-nand"; + reg = <0>; + status = "okay"; + spi-max-frequency = <104000000>; + + /* gd5f2gq5ue parameters */ + jedec-id = [c8 52]; + size-bytes = ; + erase-block-size = ; + write-block-size = ; + block-erase-duration-max = <5000>; + page-program-duration-max = <600>; + page-read-duration-max = <200>; + reset-duration-max = <500>; + }; +}; diff --git a/boards/shields/mikroe_flash_8_click/shield.yml b/boards/shields/mikroe_flash_8_click/shield.yml new file mode 100644 index 0000000000000..01f2414d87fb2 --- /dev/null +++ b/boards/shields/mikroe_flash_8_click/shield.yml @@ -0,0 +1,6 @@ +shield: + name: mikroe_flash_8_click + full_name: Flash 8 Click + vendor: mikroe + supported_features: + - mtd