soc: nxp_s32: rename s32k to s32k3 for series alignment

To accommodate support for S32K1 devices, it is necessary to rename
the existing `s32k` directory, which currently houses support for
the S32K3 series, to align with the respective series names. This
adjustment is necessary given the distinct differences in core
architecture, MPU, peripherals, and other key aspects between
the two series.

Signed-off-by: Manuel Argüelles <manuel.arguelles@nxp.com>

soc/arm/nxp_s32/s32k3/Kconfig.defconfig.series

@@ -6,7 +6,7 @@
 if SOC_SERIES_S32K3_M7
 
 config SOC_SERIES
-	default "s32k"
+	default "s32k3"
 
 config SYS_CLOCK_HW_CYCLES_PER_SEC
 	default 2000000
@@ -32,6 +32,6 @@ config NET_UDP_CHECKSUM
 
 endif # NET_L2_ETHERNET
 
-source "soc/arm/nxp_s32/s32k/Kconfig.defconfig.s32k*"
+source "soc/arm/nxp_s32/s32k3/Kconfig.defconfig.s32k*"
 
 endif # SOC_SERIES_S32K_M7