| 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();
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).
