Commit 634416bc authored by Piotr Dymacz's avatar Piotr Dymacz Committed by Chris Friedt
Browse files

drivers: hwinfo: add driver for TI SimpleLink CC13xx/CC26xx series 

Introduce hwinfo driver for Texas Instruments SimpleLink CC13xx/CC26xx
SOC series, with support for retrieving device's ID and cause of reset.

By default, the pre-programmed, 8-bytes length IEEE MAC address is used
for device's ID, with option ('HWINFO_CC13XX_CC26XX_USE_BLE_MAC') for
use 6-bytes length BLE MAC instead. By default, read-only values stored
in FCFG (Factory Configuration) are used but additional Kconfig option
('HWINFO_CC13XX_CC26XX_ALWAYS_USE_FACTORY_DEFAULT') is also provided,
which allows to use values from writable CCFG (Customer Configuration)
area. In all cases, device ID value is provided in big-endian which
matches what TI's UniFlash tool returns.

For reset cause, 'SysCtrlResetSourceGet()' function from TI's driver
library is used and its value is mapped to Zephyr's implementation.
Importantly, only root cause of reset is available on CC13xx/CC26xx
platform as described in MCU Technical Reference Manual ('RESET_SRC'
field in 'RESETCTL' register):

  "Shows the root cause of the last system reset. More than the
   reported reset source can have been active during the last
   system reset but only the root cause is reported."

Signed-off-by: default avatarPiotr Dymacz <pepe2k@gmail.com>
parent 42d8f7ff

drivers/hwinfo/CMakeLists.txt

+1 −0
Changes for drivers/hwinfo/CMakeLists.txt: 1 added line, 0 removed lines.
Original line number Diff line number Diff line
@@ -8,6 +8,7 @@ zephyr_library_sources_ifdef(CONFIG_USERSPACE hwinfo_handlers.c) 
zephyr_library_sources_ifdef(CONFIG_HWINFO             hwinfo_weak_impl.c)

zephyr_library_sources_ifdef(CONFIG_HWINFO_SHELL       hwinfo_shell.c)



zephyr_library_sources_ifdef(CONFIG_HWINFO_CC13XX_CC26XX hwinfo_cc13xx_cc26xx.c)

zephyr_library_sources_ifdef(CONFIG_HWINFO_ESP32       hwinfo_esp32.c)

zephyr_library_sources_ifdef(CONFIG_HWINFO_GECKO       hwinfo_gecko.c)

zephyr_library_sources_ifdef(CONFIG_HWINFO_IMXRT       hwinfo_imxrt.c)

drivers/hwinfo/Kconfig

+36 −0
Changes for drivers/hwinfo/Kconfig: 36 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -21,6 +21,42 @@ config HWINFO_SHELL 
	help

	  Enable hwinfo Shell for testing.



menuconfig HWINFO_CC13XX_CC26XX

	bool "TI SimpleLink CC13xx/CC26xx hwinfo driver"

	default y

	depends on SOC_SERIES_CC13X2_CC26X2 || SOC_SERIES_CC13X2X7_CC26X2X7

	help

	  Enable TI SimpleLink CC13xx/CC26xx hwinfo driver.



if HWINFO_CC13XX_CC26XX



config HWINFO_CC13XX_CC26XX_ALWAYS_USE_FACTORY_DEFAULT

	bool "Ignore CCFG and always use factory value"

	default y

	help

	  Always return factory pre-programmed values, stored in FCFG and ignore

	  values provided in CCFG (Customer Configuration).



choice

	prompt "Select MAC address type for device ID"

	default HWINFO_CC13XX_CC26XX_USE_IEEE_MAC

	help

	  Specify the MAC address type to be used as device ID by the driver.



config HWINFO_CC13XX_CC26XX_USE_IEEE_MAC

	bool "Use IEEE 802.15.4 extended address"

	help

	  Use 8-bytes length IEEE 802.15.4 extended address as device ID value.



config HWINFO_CC13XX_CC26XX_USE_BLE_MAC

	bool "Use BLE MAC address"

	help

	  Use 6-bytes length BLE MAC address as device ID value.



endchoice



endif



config HWINFO_STM32

	bool "STM32 hwinfo"

	default y

drivers/hwinfo/hwinfo_cc13xx_cc26xx.c

0 → 100644
+98 −0
Changes for drivers/hwinfo/hwinfo_cc13xx_cc26xx.c: 98 added lines, 0 removed lines.
Original line number Diff line number Diff line 
/*

 * Copyright (c) 2023 Piotr Dymacz

 *

 * SPDX-License-Identifier: Apache-2.0

 */



#include <errno.h>

#include <string.h>

#include <zephyr/drivers/hwinfo.h>

#include <zephyr/sys/byteorder.h>



#include <driverlib/sys_ctrl.h>

#include <inc/hw_ccfg.h>

#include <inc/hw_fcfg1.h>

#include <inc/hw_memmap.h>



#ifdef CONFIG_HWINFO_CC13XX_CC26XX_USE_BLE_MAC

#define CC13XX_CC26XX_DEVID_SIZE	6

#else

#define CC13XX_CC26XX_DEVID_SIZE	8

#endif



ssize_t z_impl_hwinfo_get_device_id(uint8_t *buffer, size_t length)

{

	uint8_t *mac;



	if (IS_ENABLED(CONFIG_HWINFO_CC13XX_CC26XX_USE_BLE_MAC)) {

		if (IS_ENABLED(CONFIG_HWINFO_CC13XX_CC26XX_ALWAYS_USE_FACTORY_DEFAULT) ||

		    sys_read32(CCFG_BASE + CCFG_O_IEEE_BLE_0) == 0xFFFFFFFF ||

		    sys_read32(CCFG_BASE + CCFG_O_IEEE_BLE_1) == 0xFFFFFFFF) {

			mac = (uint8_t *)(FCFG1_BASE + FCFG1_O_MAC_BLE_0);

		} else {

			mac = (uint8_t *)(CCFG_BASE + CCFG_O_IEEE_BLE_0);

		}

	} else if (IS_ENABLED(CONFIG_HWINFO_CC13XX_CC26XX_USE_IEEE_MAC)) {

		if (IS_ENABLED(CONFIG_HWINFO_CC13XX_CC26XX_ALWAYS_USE_FACTORY_DEFAULT) ||

		    sys_read32(CCFG_BASE + CCFG_O_IEEE_MAC_0) == 0xFFFFFFFF ||

		    sys_read32(CCFG_BASE + CCFG_O_IEEE_MAC_1) == 0xFFFFFFFF) {

			mac = (uint8_t *)(FCFG1_BASE + FCFG1_O_MAC_15_4_0);

		} else {

			mac = (uint8_t *)(CCFG_BASE + CCFG_O_IEEE_MAC_0);

		}

	}



	if (length > CC13XX_CC26XX_DEVID_SIZE) {

		length = CC13XX_CC26XX_DEVID_SIZE;

	}



	/* Provide device ID (MAC) in big endian */

	sys_memcpy_swap(buffer, mac, length);



	return length;

}



int z_impl_hwinfo_get_reset_cause(uint32_t *cause)

{

	uint32_t reset_src;



	reset_src = SysCtrlResetSourceGet();



	switch (reset_src) {

	case RSTSRC_PWR_ON:

		*cause = RESET_POR;

		break;

	case RSTSRC_PIN_RESET:

		*cause = RESET_PIN;

		break;

	case RSTSRC_VDDS_LOSS:

		__fallthrough;

	case RSTSRC_VDDR_LOSS:

		*cause = RESET_BROWNOUT;

		break;

	case RSTSRC_CLK_LOSS:

		*cause = RESET_CLOCK;

		break;

	case RSTSRC_SYSRESET:

		*cause = RESET_SOFTWARE;

		break;

	}



	return 0;

}



int z_impl_hwinfo_clear_reset_cause(void)

{

	return -ENOSYS;

}



int z_impl_hwinfo_get_supported_reset_cause(uint32_t *supported)

{

	*supported = (RESET_PIN

		      | RESET_SOFTWARE

		      | RESET_BROWNOUT

		      | RESET_POR

		      | RESET_CLOCK);



	return 0;

}

CRA Git | Maintained and supported by SUSTech CRA and CCSE