tuyaopen-onchip-rtc - SKILL.md Agent Skill

name: tuyaopen/onchip-rtc description: >- On-chip RTC for TuyaOpen using the tkl_rtc API: set and get wall-clock time as epoch seconds. RTC、实时时钟、走时、设置时间、读取时间、tkl_rtc、掉电保持时间。 when_to_use: >- Use when the user wants the hardware real-time clock: set or read wall-clock time (epoch seconds), e.g. for timestamps.

id: onchip-rtc surfaces: [embedded] tags: [rtc, clock, time, on-chip, tkl_rtc]

TuyaOpen On-Chip RTC

On-chip — no Kconfig, no TDD

Platform-provided. Do NOT write CONFIG_ENABLE_RTC. No app_default.config change.
No board_register_hardware(). Call tkl_rtc_* directly. Single system RTC (no instance id / pins) — record as onchip:rtc in used-peripherals.json if wanted.

Set / get time

Time is epoch seconds (TIME_T = unsigned int). The RTC keeps running once set; on a board without a battery-backed RTC the value is lost on power-down, so set it from a trusted source (e.g. SNTP / user input) after boot.

#include "tal_api.h"
#include "tkl_rtc.h"

void app_rtc_demo(void)
{
    tkl_rtc_init();

    /* set: e.g. 2026-01-01 00:00:00 UTC = 1767225600 */
    tkl_rtc_time_set((TIME_T)1767225600);

    TIME_T now = 0;
    tkl_rtc_time_get(&now);
    PR_NOTICE("rtc now = %u", (unsigned)now);
}

API Reference

Function	Description
`tkl_rtc_init()`	Initialise the RTC
`tkl_rtc_time_set(time_sec)`	Set wall-clock time (`TIME_T` epoch seconds)
`tkl_rtc_time_get(&time_sec)`	Read current time into a `TIME_T`
`tkl_rtc_deinit()`	Release the RTC

Troubleshooting

Symptom	Likely cause	Fix
Time resets to 0 after reboot	No battery-backed RTC on this board	Re-set from SNTP / user after each boot
Time drifts	RTC crystal tolerance	Periodically re-sync from a trusted source
Get returns garbage	Read before `tkl_rtc_init` / before any set	Init first, set a known time before reading

Reference example

No dedicated SDK example; API is tkl_rtc.h (tkl_rtc_init/time_set/time_get/deinit).