hal/nxp: s32K344: flash_c40: add C40 features, IP aliases; init ret

- fsl_c40_flash.c: Initialize `ret` in FLASH_Erase() to
  `kStatus_FLASH_Success` to avoid potential use-before-set warnings on some
  toolchains/static analyzers (no functional change).

- S32K344_features.h: Define C40 array geometry for S32K344 using unsigned
  constants:
    * FSL_FEATURE_FLASH_C40_BLOCK_SIZE_CODE (1 MiB)
    * FSL_FEATURE_FLASH_C40_BLOCK_COUNT_CODE (4)
    * FSL_FEATURE_FLASH_C40_BLOCK_SIZE_DATA (256 KiB)
  Note: erase/program granularities are controller-level and handled by driver.

- S32K344_glue_mcux.h: Provide conditional aliases mapping FLASH↔IP_FLASH and
  PFLASH↔IP_PFLASH to harmonize SDK naming and improve build portability.

- fsl_device_registers.h: Local to the flash_c40 driver in order to make the
  correct SoC headers selection during twister build
Signed-off-by: Sumit Batra <[email protected]>

Author: sumitbatra-nxp

mcux/README

@@ -244,6 +244,13 @@ Patch List:
    - PR: https://github.com/zephyrproject-rtos/hal_nxp/pull/597
    - This patch is in hal_nxp but is not in mcux-sdk-ng 25.09.00.
 
+  - hal/nxp: s32K344: flash_c40: add C40 features, IP aliases
+   - Commit: https://github.com/zephyrproject-rtos/hal_nxp/pull/618/commits/64395f565184964bbf21e247df6ca88dc4d7cf83
+   - This patch is in hal_nxp but is not in mcux-sdk-ng 25.09.00.
+     This patch was merged after PR https://github.com/zephyrproject-rtos/hal_nxp/pull/618/commits was created.
+     Also since the additions about C40 Flash geometry in S32K344_features.h and defining local Flash Aliases in
+     S32K344_glue_mcux.h, are for S32K344 SoC so they are not present in the mcusdk-core repo.
+
 Note:
    - The SAI driver should not be updated during hal_nxp updates, since the latest SAI driver will cause runtime issues
      on MCXN947 for Zephyr I2S-related test cases.

mcux/mcux-sdk-ng/drivers/flash_c40/fsl_c40_flash.c

@@ -818,7 +818,7 @@ status_t FLASH_Erase(flash_config_t *config, uint32_t start, uint32_t lengthInBy
 
 status_t FLASH_Program(flash_config_t *config, uint32_t start, uint32_t *src, uint32_t lengthInBytes)
 {
-    status_t ret;
+    status_t ret = kStatus_FLASH_Success;
     size_t chunkSize;
     size_t sizeLeft = lengthInBytes;
     uint8_t *src8 = (uint8_t *) src;

mcux/mcux-sdk-ng/drivers/flash_c40/fsl_device_registers.h

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2025 NXP
+ * All rights reserved.
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ *
+ */
+
+#ifndef MCUX_FLASH_C40_FSL_DEVICE_REGISTERS_H_
+#define MCUX_FLASH_C40_FSL_DEVICE_REGISTERS_H_
+
+/*
+ * Shim layer for MCUX C40 flash driver.
+ *
+ * This header is intentionally located next to fsl_c40_flash.c so that
+ * #include "fsl_device_registers.h" from fsl_common.h resolves here first.
+ *
+ * For each supported CPU_xxx, we include the SoC-specific headers that
+ * define:
+ *
+ *   - FLASH / PFLASH register structs
+ *   - FSL_FEATURE_FLASH_C40_* macros
+ *
+ * This keeps fsl_c40_flash.c generic and pushes SoC knowledge into the
+ * integration layer.
+ */
+
+#if defined(CPU_S32K344)
+
+/* S32K344 RTD headers you already have: */
+#include "S32K344.h"
+#include "S32K344_features.h"
+#include "S32K344_glue_mcux.h"
+
+#else
+/* Add other SoCs here later, e.g.:
+ * #elif defined(CPU_S32K3XX)
+ *   #include "S32K3xx.h"
+ *   #include "S32K3xx_features.h"
+ */
+#warning "MCUX flash_c40: no device header mapping for this CPU_xxx yet"
+#endif
+
+#endif /* MCUX_FLASH_C40_FSL_DEVICE_REGISTERS_H_ */

s32/mcux/devices/S32K344/S32K344_features.h

@@ -236,4 +236,13 @@
 /* @brief Memory map has offset between subsystems. */
 #define FSL_FEATURE_MEMORY_HAS_ADDRESS_OFFSET (1)
 
+/* FLASH Module features */
+
+/* @brief Code flash (PFLASH) implemented as 1 MiB blocks */
+#define FSL_FEATURE_FLASH_C40_BLOCK_SIZE_CODE     (1024u * 1024u)
+/* @brief Code flash (PFLASH) has 4 blocks of 1 MiB each total size = 4 MiB */
+#define FSL_FEATURE_FLASH_C40_BLOCK_COUNT_CODE    (4u)
+/* @brief Data flash (DFLASH) window: 256 KiB */
+#define FSL_FEATURE_FLASH_C40_BLOCK_SIZE_DATA     (256u * 1024u)
+
 #endif /* _S32K344_FEATURES_H_ */

s32/mcux/devices/S32K344/S32K344_glue_mcux.h

@@ -208,4 +208,24 @@
 #define FLEXIO_BASE_PTRS                        IP_FLEXIO_BASE_PTRS
 /** Interrupt vectors for the FLEXIO peripheral type */
 #define FLEXIO_IRQS                              { FLEXIO_IRQn }
+
+/* FLASH - Peripheral instance base addresses */
+/** Peripheral FLASH base address */
+#define FLASH_BASE                               IP_FLASH_BASE
+/** Peripheral FLASH base pointer */
+#define FLASH                                    IP_FLASH
+/** Array initializer of FLASH peripheral base addresses */
+#define FLASH_BASE_ADDRS                         IP_FLASH_BASE_ADDRS
+/** Array initializer of FLASH peripheral base pointers */
+#define FLASH_BASE_PTRS                          IP_FLASH_BASE_PTRS
+
+/* PFLASH - Peripheral instance base addresses */
+/** Peripheral PFLASH base address */
+#define PFLASH_BASE                              IP_PFLASH_BASE
+/** Peripheral PFLASH base pointer */
+#define PFLASH                                   IP_PFLASH
+/** Array initializer of PFLASH peripheral base addresses */
+#define PFLASH_BASE_ADDRS                        IP_PFLASH_BASE_ADDRS
+/** Array initializer of PFLASH peripheral base pointers */
+#define PFLASH_BASE_PTRS                         IP_PFLASH_BASE_PTRS
 #endif  /* _S32K344_GLUE_MCUX_H_ */