Support for NXP's i.MX8 SoCs timer IPC
authorAnson Huang <Anson.Huang@nxp.com>
Tue, 15 Jan 2019 02:22:06 +0000 (10:22 +0800)
committerAnson Huang <Anson.Huang@nxp.com>
Thu, 17 Jan 2019 02:49:48 +0000 (10:49 +0800)
NXP's i.MX8 SoCs have system controller (M4 core) which takes
control of timer management, including watchdog, srtc and system
counter etc., other clusters like Cortex-A35 can send out command
via MU (Message Unit) to system controller for timer operation.

This patch adds timer IPC(inter-processor communication) support.

Signed-off-by: Anson Huang <Anson.Huang@nxp.com>
plat/imx/common/include/sci/sci.h
plat/imx/common/include/sci/svc/timer/sci_timer_api.h [new file with mode: 0644]
plat/imx/common/sci/sci_api.mk
plat/imx/common/sci/svc/timer/sci_timer_rpc.h [new file with mode: 0644]
plat/imx/common/sci/svc/timer/timer_rpc_clnt.c [new file with mode: 0644]

index f0a25027c24dea04a2c404e5b9deea5e4bb18795..1b2f699ae058ff1fb2f13bf79fac15f4b9311362 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015-2018, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2015-2019, ARM Limited and Contributors. All rights reserved.
  *
  * SPDX-License-Identifier: BSD-3-Clause
  */
@@ -15,5 +15,6 @@
 #include <sci/svc/pad/sci_pad_api.h>
 #include <sci/svc/pm/sci_pm_api.h>
 #include <sci/svc/rm/sci_rm_api.h>
+#include <sci/svc/timer/sci_timer_api.h>
 
 #endif /* SCI_H */
diff --git a/plat/imx/common/include/sci/svc/timer/sci_timer_api.h b/plat/imx/common/include/sci/svc/timer/sci_timer_api.h
new file mode 100644 (file)
index 0000000..f8423ab
--- /dev/null
@@ -0,0 +1,358 @@
+/*
+ * Copyright (C) 2016 Freescale Semiconductor, Inc.
+ * Copyright 2017-2019 NXP
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+/*!
+ * Header file containing the public API for the System Controller (SC)
+ * Timer function.
+ *
+ * @addtogroup TIMER_SVC (SVC) Timer Service
+ *
+ * Module for the Timer service. This includes support for the watchdog, RTC,
+ * and system counter. Note every resource partition has a watchdog it can
+ * use.
+ *
+ * @{
+ */
+
+#ifndef SC_TIMER_API_H
+#define SC_TIMER_API_H
+
+/* Includes */
+
+#include <sci/sci_types.h>
+
+/* Defines */
+
+/*!
+ * @name Defines for type widths
+ */
+/*@{*/
+#define SC_TIMER_ACTION_W   3U /* Width of sc_timer_wdog_action_t */
+/*@}*/
+
+/*!
+ * @name Defines for sc_timer_wdog_action_t
+ */
+/*@{*/
+#define SC_TIMER_WDOG_ACTION_PARTITION      0U /* Reset partition */
+#define SC_TIMER_WDOG_ACTION_WARM           1U /* Warm reset system */
+#define SC_TIMER_WDOG_ACTION_COLD           2U /* Cold reset system */
+#define SC_TIMER_WDOG_ACTION_BOARD          3U /* Reset board */
+#define SC_TIMER_WDOG_ACTION_IRQ            4U /* Only generate IRQs */
+/*@}*/
+
+/* Types */
+
+/*!
+ * This type is used to configure the watchdog action.
+ */
+typedef uint8_t sc_timer_wdog_action_t;
+
+/*!
+ * This type is used to declare a watchdog time value in milliseconds.
+ */
+typedef uint32_t sc_timer_wdog_time_t;
+
+/* Functions */
+
+/*!
+ * @name Watchdog Functions
+ * @{
+ */
+
+/*!
+ * This function sets the watchdog timeout in milliseconds. If not
+ * set then the timeout defaults to the max. Once locked this value
+ * cannot be changed.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     timeout     timeout period for the watchdog
+ *
+ * @return Returns an error code (SC_ERR_NONE = success, SC_ERR_LOCKED
+ *         = locked).
+ */
+sc_err_t sc_timer_set_wdog_timeout(sc_ipc_t ipc, sc_timer_wdog_time_t timeout);
+
+/*!
+ * This function sets the watchdog pre-timeout in milliseconds. If not
+ * set then the pre-timeout defaults to the max. Once locked this value
+ * cannot be changed.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     pre_timeout pre-timeout period for the watchdog
+ *
+ * When the pre-timeout expires an IRQ will be generated. Note this timeout
+ * clears when the IRQ is triggered. An IRQ is generated for the failing
+ * partition and all of its child partitions.
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ */
+sc_err_t sc_timer_set_wdog_pre_timeout(sc_ipc_t ipc,
+                                      sc_timer_wdog_time_t pre_timeout);
+
+/*!
+ * This function starts the watchdog.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     lock        boolean indicating the lock status
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * If \a lock is set then the watchdog cannot be stopped or the timeout
+ * period changed.
+ */
+sc_err_t sc_timer_start_wdog(sc_ipc_t ipc, sc_bool_t lock);
+
+/*!
+ * This function stops the watchdog if it is not locked.
+ *
+ * @param[in]     ipc         IPC handle
+ *
+ * @return Returns an error code (SC_ERR_NONE = success, SC_ERR_LOCKED
+ *         = locked).
+ */
+sc_err_t sc_timer_stop_wdog(sc_ipc_t ipc);
+
+/*!
+ * This function pings (services, kicks) the watchdog resetting the time
+ * before expiration back to the timeout.
+ *
+ * @param[in]     ipc         IPC handle
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ */
+sc_err_t sc_timer_ping_wdog(sc_ipc_t ipc);
+
+/*!
+ * This function gets the status of the watchdog. All arguments are
+ * in milliseconds.
+ *
+ * @param[in]     ipc             IPC handle
+ * @param[out]    timeout         pointer to return the timeout
+ * @param[out]    max_timeout     pointer to return the max timeout
+ * @param[out]    remaining_time  pointer to return the time remaining
+ *                                until trigger
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ */
+sc_err_t sc_timer_get_wdog_status(sc_ipc_t ipc,
+                                 sc_timer_wdog_time_t *timeout,
+                                 sc_timer_wdog_time_t *max_timeout,
+                                 sc_timer_wdog_time_t *remaining_time);
+
+/*!
+ * This function gets the status of the watchdog of a partition. All
+ * arguments are in milliseconds.
+ *
+ * @param[in]     ipc             IPC handle
+ * @param[in]     pt              partition to query
+ * @param[out]    enb             pointer to return enable status
+ * @param[out]    timeout         pointer to return the timeout
+ * @param[out]    remaining_time  pointer to return the time remaining
+ *                                until trigger
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ */
+sc_err_t sc_timer_pt_get_wdog_status(sc_ipc_t ipc, sc_rm_pt_t pt,
+                                    sc_bool_t *enb,
+                                    sc_timer_wdog_time_t *timeout,
+                                    sc_timer_wdog_time_t *remaining_time);
+
+/*!
+ * This function configures the action to be taken when a watchdog
+ * expires.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     pt          partition to affect
+ * @param[in]     action      action to take
+ *
+ * Default action is inherited from the parent.
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid parameters,
+ * - SC_ERR_NOACCESS if caller's partition is not the SYSTEM owner,
+ * - SC_ERR_LOCKED if the watchdog is locked
+ */
+sc_err_t sc_timer_set_wdog_action(sc_ipc_t ipc,
+                                 sc_rm_pt_t pt, sc_timer_wdog_action_t action);
+
+/* @} */
+
+/*!
+ * @name Real-Time Clock (RTC) Functions
+ * @{
+ */
+
+/*!
+ * This function sets the RTC time. Only the owner of the SC_R_SYSTEM
+ * resource can set the time.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     year        year (min 1970)
+ * @param[in]     mon         month (1-12)
+ * @param[in]     day         day of the month (1-31)
+ * @param[in]     hour        hour (0-23)
+ * @param[in]     min         minute (0-59)
+ * @param[in]     sec         second (0-59)
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid time/date parameters,
+ * - SC_ERR_NOACCESS if caller's partition is not the SYSTEM owner
+ */
+sc_err_t sc_timer_set_rtc_time(sc_ipc_t ipc, uint16_t year, uint8_t mon,
+                              uint8_t day, uint8_t hour, uint8_t min,
+                              uint8_t sec);
+
+/*!
+ * This function gets the RTC time.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[out]    year        pointer to return year (min 1970)
+ * @param[out]    mon         pointer to return month (1-12)
+ * @param[out]    day         pointer to return day of the month (1-31)
+ * @param[out]    hour        pointer to return hour (0-23)
+ * @param[out]    min         pointer to return minute (0-59)
+ * @param[out]    sec         pointer to return second (0-59)
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ */
+sc_err_t sc_timer_get_rtc_time(sc_ipc_t ipc, uint16_t *year, uint8_t *mon,
+                              uint8_t *day, uint8_t *hour, uint8_t *min,
+                              uint8_t *sec);
+
+/*!
+ * This function gets the RTC time in seconds since 1/1/1970.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[out]    sec         pointer to return second
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ */
+sc_err_t sc_timer_get_rtc_sec1970(sc_ipc_t ipc, uint32_t *sec);
+
+/*!
+ * This function sets the RTC alarm.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     year        year (min 1970)
+ * @param[in]     mon         month (1-12)
+ * @param[in]     day         day of the month (1-31)
+ * @param[in]     hour        hour (0-23)
+ * @param[in]     min         minute (0-59)
+ * @param[in]     sec         second (0-59)
+ *
+ * Note this alarm setting clears when the alarm is triggered.
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid time/date parameters
+ */
+sc_err_t sc_timer_set_rtc_alarm(sc_ipc_t ipc, uint16_t year, uint8_t mon,
+                               uint8_t day, uint8_t hour, uint8_t min,
+                               uint8_t sec);
+
+/*!
+ * This function sets the RTC alarm (periodic mode).
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     sec         period in seconds
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid time/date parameters
+ */
+sc_err_t sc_timer_set_rtc_periodic_alarm(sc_ipc_t ipc, uint32_t sec);
+
+/*!
+ * This function cancels the RTC alarm.
+ *
+ * @param[in]     ipc         IPC handle
+ *
+ * Note this alarm setting clears when the alarm is triggered.
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid time/date parameters
+ */
+sc_err_t sc_timer_cancel_rtc_alarm(sc_ipc_t ipc);
+
+/*!
+ * This function sets the RTC calibration value. Only the owner of the SC_R_SYSTEM
+ * resource can set the calibration.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     count       calbration count (-16 to 15)
+ *
+ * The calibration value is a 5-bit value including the sign bit, which is
+ * implemented in 2's complement. It is added or subtracted from the RTC on
+ * a perdiodic basis, once per 32768 cycles of the RTC clock.
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ */
+sc_err_t sc_timer_set_rtc_calb(sc_ipc_t ipc, int8_t count);
+
+/* @} */
+
+/*!
+ * @name System Counter (SYSCTR) Functions
+ * @{
+ */
+
+/*!
+ * This function sets the SYSCTR alarm.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     ticks       number of 8MHz cycles
+ *
+ * Note this alarm setting clears when the alarm is triggered.
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid time/date parameters
+ */
+sc_err_t sc_timer_set_sysctr_alarm(sc_ipc_t ipc, uint64_t ticks);
+
+/*!
+ * This function sets the SYSCTR alarm (periodic mode).
+ *
+ * @param[in]     ipc          IPC handle
+ * @param[in]     ticks        number of 8MHz cycles
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid time/date parameters
+ */
+sc_err_t sc_timer_set_sysctr_periodic_alarm(sc_ipc_t ipc, uint64_t ticks);
+
+/*!
+ * This function cancels the SYSCTR alarm.
+ *
+ * @param[in]     ipc         IPC handle
+ *
+ * Note this alarm setting clears when the alarm is triggered.
+ *
+ * @return Returns an error code (SC_ERR_NONE = success).
+ *
+ * Return errors:
+ * - SC_ERR_PARM if invalid time/date parameters
+ */
+sc_err_t sc_timer_cancel_sysctr_alarm(sc_ipc_t ipc);
+
+/* @} */
+
+#endif                         /* SC_TIMER_API_H */
+
+/**@}*/
index b277877ec87d6ec74106912786a31d2403f01c07..edaef4da61c4bdb7d83efe998441e28a1eca0e89 100644 (file)
@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2015-2018, ARM Limited and Contributors. All rights reserved.
+# Copyright (c) 2015-2019, ARM Limited and Contributors. All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
 #
@@ -8,4 +8,5 @@ BL31_SOURCES    +=      plat/imx/common/sci/ipc.c                       \
                        plat/imx/common/sci/imx8_mu.c                   \
                        plat/imx/common/sci/svc/pad/pad_rpc_clnt.c      \
                        plat/imx/common/sci/svc/pm/pm_rpc_clnt.c        \
-                       plat/imx/common/sci/svc/rm/rm_rpc_clnt.c
+                       plat/imx/common/sci/svc/rm/rm_rpc_clnt.c        \
+                       plat/imx/common/sci/svc/timer/timer_rpc_clnt.c
diff --git a/plat/imx/common/sci/svc/timer/sci_timer_rpc.h b/plat/imx/common/sci/svc/timer/sci_timer_rpc.h
new file mode 100644 (file)
index 0000000..6716399
--- /dev/null
@@ -0,0 +1,69 @@
+/*
+ * Copyright (C) 2016 Freescale Semiconductor, Inc.
+ * Copyright 2017-2019 NXP
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+/*!
+ * Header file for the TIMER RPC implementation.
+ *
+ * @addtogroup TIMER_SVC
+ * @{
+ */
+
+#ifndef SC_TIMER_RPC_H
+#define SC_TIMER_RPC_H
+
+/* Includes */
+
+/* Defines */
+
+/*!
+ * @name Defines for RPC TIMER function calls
+ */
+/*@{*/
+#define TIMER_FUNC_UNKNOWN 0   /* Unknown function */
+#define TIMER_FUNC_SET_WDOG_TIMEOUT 1U /* Index for timer_set_wdog_timeout() RPC call */
+#define TIMER_FUNC_SET_WDOG_PRE_TIMEOUT 12U    /* Index for timer_set_wdog_pre_timeout() RPC call */
+#define TIMER_FUNC_START_WDOG 2U       /* Index for timer_start_wdog() RPC call */
+#define TIMER_FUNC_STOP_WDOG 3U        /* Index for timer_stop_wdog() RPC call */
+#define TIMER_FUNC_PING_WDOG 4U        /* Index for timer_ping_wdog() RPC call */
+#define TIMER_FUNC_GET_WDOG_STATUS 5U  /* Index for timer_get_wdog_status() RPC call */
+#define TIMER_FUNC_PT_GET_WDOG_STATUS 13U      /* Index for timer_pt_get_wdog_status() RPC call */
+#define TIMER_FUNC_SET_WDOG_ACTION 10U /* Index for timer_set_wdog_action() RPC call */
+#define TIMER_FUNC_SET_RTC_TIME 6U     /* Index for timer_set_rtc_time() RPC call */
+#define TIMER_FUNC_GET_RTC_TIME 7U     /* Index for timer_get_rtc_time() RPC call */
+#define TIMER_FUNC_GET_RTC_SEC1970 9U  /* Index for timer_get_rtc_sec1970() RPC call */
+#define TIMER_FUNC_SET_RTC_ALARM 8U    /* Index for timer_set_rtc_alarm() RPC call */
+#define TIMER_FUNC_SET_RTC_PERIODIC_ALARM 14U  /* Index for timer_set_rtc_periodic_alarm() RPC call */
+#define TIMER_FUNC_CANCEL_RTC_ALARM 15U        /* Index for timer_cancel_rtc_alarm() RPC call */
+#define TIMER_FUNC_SET_RTC_CALB 11U    /* Index for timer_set_rtc_calb() RPC call */
+#define TIMER_FUNC_SET_SYSCTR_ALARM 16U        /* Index for timer_set_sysctr_alarm() RPC call */
+#define TIMER_FUNC_SET_SYSCTR_PERIODIC_ALARM 17U       /* Index for timer_set_sysctr_periodic_alarm() RPC call */
+#define TIMER_FUNC_CANCEL_SYSCTR_ALARM 18U     /* Index for timer_cancel_sysctr_alarm() RPC call */
+/*@}*/
+
+/* Types */
+
+/* Functions */
+
+/*!
+ * This function dispatches an incoming TIMER RPC request.
+ *
+ * @param[in]     caller_pt   caller partition
+ * @param[in]     msg         pointer to RPC message
+ */
+void timer_dispatch(sc_rm_pt_t caller_pt, sc_rpc_msg_t *msg);
+
+/*!
+ * This function translates and dispatches an TIMER RPC request.
+ *
+ * @param[in]     ipc         IPC handle
+ * @param[in]     msg         pointer to RPC message
+ */
+void timer_xlate(sc_ipc_t ipc, sc_rpc_msg_t *msg);
+
+#endif                         /* SC_TIMER_RPC_H */
+
+/**@}*/
diff --git a/plat/imx/common/sci/svc/timer/timer_rpc_clnt.c b/plat/imx/common/sci/svc/timer/timer_rpc_clnt.c
new file mode 100644 (file)
index 0000000..a82be96
--- /dev/null
@@ -0,0 +1,396 @@
+/*
+ * Copyright (C) 2016 Freescale Semiconductor, Inc.
+ * Copyright 2017-2019 NXP
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+/*!
+ * File containing client-side RPC functions for the TIMER service. These
+ * functions are ported to clients that communicate to the SC.
+ *
+ * @addtogroup TIMER_SVC
+ * @{
+ */
+
+/* Includes */
+
+#include <sci/sci_types.h>
+#include <sci/svc/rm/sci_rm_api.h>
+#include <sci/svc/timer/sci_timer_api.h>
+#include <sci/sci_rpc.h>
+#include <stdlib.h>
+#include "sci_timer_rpc.h"
+
+/* Local Defines */
+
+/* Local Types */
+
+/* Local Functions */
+
+sc_err_t sc_timer_set_wdog_timeout(sc_ipc_t ipc, sc_timer_wdog_time_t timeout)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_WDOG_TIMEOUT;
+       RPC_U32(&msg, 0U) = (uint32_t)timeout;
+       RPC_SIZE(&msg) = 2U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_wdog_pre_timeout(sc_ipc_t ipc,
+                                      sc_timer_wdog_time_t pre_timeout)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_WDOG_PRE_TIMEOUT;
+       RPC_U32(&msg, 0U) = (uint32_t)pre_timeout;
+       RPC_SIZE(&msg) = 2U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_start_wdog(sc_ipc_t ipc, sc_bool_t lock)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_START_WDOG;
+       RPC_U8(&msg, 0U) = (uint8_t)lock;
+       RPC_SIZE(&msg) = 2U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_stop_wdog(sc_ipc_t ipc)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_STOP_WDOG;
+       RPC_SIZE(&msg) = 1U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_ping_wdog(sc_ipc_t ipc)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_PING_WDOG;
+       RPC_SIZE(&msg) = 1U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_get_wdog_status(sc_ipc_t ipc,
+                                 sc_timer_wdog_time_t *timeout,
+                                 sc_timer_wdog_time_t *max_timeout,
+                                 sc_timer_wdog_time_t *remaining_time)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_GET_WDOG_STATUS;
+       RPC_SIZE(&msg) = 1U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       if (timeout != NULL)
+               *timeout = RPC_U32(&msg, 0U);
+
+       if (max_timeout != NULL)
+               *max_timeout = RPC_U32(&msg, 4U);
+
+       if (remaining_time != NULL)
+               *remaining_time = RPC_U32(&msg, 8U);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_pt_get_wdog_status(sc_ipc_t ipc, sc_rm_pt_t pt,
+                                    sc_bool_t *enb,
+                                    sc_timer_wdog_time_t *timeout,
+                                    sc_timer_wdog_time_t *remaining_time)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_PT_GET_WDOG_STATUS;
+       RPC_U8(&msg, 0U) = (uint8_t)pt;
+       RPC_SIZE(&msg) = 2U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       if (timeout != NULL)
+               *timeout = RPC_U32(&msg, 0U);
+
+       if (remaining_time != NULL)
+               *remaining_time = RPC_U32(&msg, 4U);
+
+       result = RPC_R8(&msg);
+       if (enb != NULL)
+               *enb = RPC_U8(&msg, 8U);
+
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_wdog_action(sc_ipc_t ipc,
+                                 sc_rm_pt_t pt, sc_timer_wdog_action_t action)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_WDOG_ACTION;
+       RPC_U8(&msg, 0U) = (uint8_t)pt;
+       RPC_U8(&msg, 1U) = (uint8_t)action;
+       RPC_SIZE(&msg) = 2U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_rtc_time(sc_ipc_t ipc, uint16_t year, uint8_t mon,
+                              uint8_t day, uint8_t hour, uint8_t min,
+                              uint8_t sec)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_RTC_TIME;
+       RPC_U16(&msg, 0U) = (uint16_t)year;
+       RPC_U8(&msg, 2U) = (uint8_t)mon;
+       RPC_U8(&msg, 3U) = (uint8_t)day;
+       RPC_U8(&msg, 4U) = (uint8_t)hour;
+       RPC_U8(&msg, 5U) = (uint8_t)min;
+       RPC_U8(&msg, 6U) = (uint8_t)sec;
+       RPC_SIZE(&msg) = 3U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_get_rtc_time(sc_ipc_t ipc, uint16_t *year, uint8_t *mon,
+                              uint8_t *day, uint8_t *hour, uint8_t *min,
+                              uint8_t *sec)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_GET_RTC_TIME;
+       RPC_SIZE(&msg) = 1U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       if (year != NULL)
+               *year = RPC_U16(&msg, 0U);
+
+       result = RPC_R8(&msg);
+       if (mon != NULL)
+               *mon = RPC_U8(&msg, 2U);
+
+       if (day != NULL)
+               *day = RPC_U8(&msg, 3U);
+
+       if (hour != NULL)
+               *hour = RPC_U8(&msg, 4U);
+
+       if (min != NULL)
+               *min = RPC_U8(&msg, 5U);
+
+       if (sec != NULL)
+               *sec = RPC_U8(&msg, 6U);
+
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_get_rtc_sec1970(sc_ipc_t ipc, uint32_t *sec)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_GET_RTC_SEC1970;
+       RPC_SIZE(&msg) = 1U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       if (sec != NULL)
+               *sec = RPC_U32(&msg, 0U);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_rtc_alarm(sc_ipc_t ipc, uint16_t year, uint8_t mon,
+                               uint8_t day, uint8_t hour, uint8_t min,
+                               uint8_t sec)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_RTC_ALARM;
+       RPC_U16(&msg, 0U) = (uint16_t)year;
+       RPC_U8(&msg, 2U) = (uint8_t)mon;
+       RPC_U8(&msg, 3U) = (uint8_t)day;
+       RPC_U8(&msg, 4U) = (uint8_t)hour;
+       RPC_U8(&msg, 5U) = (uint8_t)min;
+       RPC_U8(&msg, 6U) = (uint8_t)sec;
+       RPC_SIZE(&msg) = 3U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_rtc_periodic_alarm(sc_ipc_t ipc, uint32_t sec)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_RTC_PERIODIC_ALARM;
+       RPC_U32(&msg, 0U) = (uint32_t)sec;
+       RPC_SIZE(&msg) = 2U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_cancel_rtc_alarm(sc_ipc_t ipc)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_CANCEL_RTC_ALARM;
+       RPC_SIZE(&msg) = 1U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_rtc_calb(sc_ipc_t ipc, int8_t count)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_RTC_CALB;
+       RPC_I8(&msg, 0U) = (int8_t) count;
+       RPC_SIZE(&msg) = 2U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_sysctr_alarm(sc_ipc_t ipc, uint64_t ticks)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_SYSCTR_ALARM;
+       RPC_U32(&msg, 0U) = (uint32_t)(ticks >> 32U);
+       RPC_U32(&msg, 4U) = (uint32_t)ticks;
+       RPC_SIZE(&msg) = 3U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_set_sysctr_periodic_alarm(sc_ipc_t ipc, uint64_t ticks)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_SET_SYSCTR_PERIODIC_ALARM;
+       RPC_U32(&msg, 0U) = (uint32_t)(ticks >> 32U);
+       RPC_U32(&msg, 4U) = (uint32_t)ticks;
+       RPC_SIZE(&msg) = 3U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+sc_err_t sc_timer_cancel_sysctr_alarm(sc_ipc_t ipc)
+{
+       sc_rpc_msg_t msg;
+       uint8_t result;
+
+       RPC_VER(&msg) = SC_RPC_VERSION;
+       RPC_SVC(&msg) = (uint8_t)SC_RPC_SVC_TIMER;
+       RPC_FUNC(&msg) = (uint8_t)TIMER_FUNC_CANCEL_SYSCTR_ALARM;
+       RPC_SIZE(&msg) = 1U;
+
+       sc_call_rpc(ipc, &msg, SC_FALSE);
+
+       result = RPC_R8(&msg);
+       return (sc_err_t)result;
+}
+
+/**@}*/