메뉴
On-chip hardware timer for TuyaOpen using the tkl_timer API: periodic or one-shot callback at a microsecond interval. 硬件定时器、定时器、周期回调、定时中断、tkl_timer、微秒定时、单次定时。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | tuyaopen/onchip-timer |
| description | On-chip hardware timer for TuyaOpen using the tkl_timer API: periodic or one-shot callback at a microsecond interval. 硬件定时器、定时器、周期回调、定时中断、tkl_timer、微秒定时、单次定时。 |
| when_to_use | Use when the user wants a hardware timer: a periodic or one-shot callback at a precise interval. For simple software timeouts inside TDL flows use tal_sw_timer instead (see the hardware-vibe-coding entry skill). |
| id | onchip-timer |
| surfaces | ["embedded"] |
| tags | ["timer","hardware-timer","interrupt","on-chip","tkl_timer"] |
tkl_timer (this skill) — a real hardware timer: precise, fires in
ISR context, microsecond resolution. Use for exact periodic sampling, signal
generation, tight timing.tal_sw_timer — software timers (what TDL/flash/blink use). For ordinary
app timeouts/delays prefer those; they run in task context, not ISR.CONFIG_ENABLE_TIMER. No app_default.config change.board_register_hardware(). Call tkl_timer_* directly with TUYA_TIMER_NUM_<n>.onchip:timer<n> in used-peripherals.json..tuyaopen/ide/platform.json → peripherals.timer.spec: ids (which timer ids
exist), mode (valid modes), bits (counter width). Pick an id from ids.
#include "tal_api.h"
#include "tkl_timer.h"
#define APP_TIMER_ID TUYA_TIMER_NUM_0
#define PERIOD_US 1000000 /* 1 s */
/* Runs in ISR context — keep it short, no blocking calls. */
static void app_timer_cb(void *args)
{
/* set a flag / post to a workqueue; do not block here */
}
void app_timer_init(void)
{
TUYA_TIMER_BASE_CFG_T cfg = {
.mode = TUYA_TIMER_MODE_PERIOD, /* or TUYA_TIMER_MODE_ONCE */
.cb = app_timer_cb,
.args = NULL,
};
tkl_timer_init(APP_TIMER_ID, &cfg);
tkl_timer_start(APP_TIMER_ID, PERIOD_US);
}
| Function | Description |
|---|---|
tkl_timer_init(id, &cfg) | cfg.mode (TUYA_TIMER_MODE_PERIOD / _ONCE), cfg.cb (ISR callback void(void*)), cfg.args |
tkl_timer_start(id, us) | Start; period/delay in microseconds |
tkl_timer_stop(id) | Stop (re-startable) |
tkl_timer_get_current_value(id, &us) | Remaining/elapsed value in µs |
tkl_timer_get(id, &us) | Read configured period |
tkl_timer_deinit(id) | Release the timer |
| Symptom | Likely cause | Fix |
|---|---|---|
| Callback never fires | Forgot tkl_timer_start | Start after init |
| Fires once then stops | TUYA_TIMER_MODE_ONCE | Use _PERIOD for repeating |
| Crash / watchdog in callback | Blocking/long work in ISR | Set a flag; do work in a task / workqueue |
| Period wrong | us is microseconds, not ms | 1 ms = 1000 µs |
SDK: examples/peripherals/timer/ (periodic timer init, start, callback).
End-to-end IoT product development orchestration for TuyaOpen projects. Guides from requirements gathering → Tuya Platform product/DP creation → complete embedded firmware generation. State-machine: detects project state and picks up from wherever development currently stands.
TDL audio codec usage for TuyaOpen: discover the audio device, capture microphone PCM frames via callback, play PCM back to the speaker, and set volume. 音频、麦克风、录音、播放、喇叭、扬声器、speaker、mic、声音、语音、codec。
TDL button input handling for TuyaOpen: create button, register event callbacks for single click, double click, long press, and multi-click. 按键、单击、双击、长按、多击、按键事件。
TDL camera control for TuyaOpen: find device, configure resolution/fps/format, open with frame callbacks for YUV422 and JPEG/H264 encoded output. 摄像头、相机、拍照、视频流、YUV、JPEG、H264、人脸识别、图像采集。
TDL display control for TuyaOpen: driver registration, open, brightness, and framebuffer flush via tdl_disp_* APIs. 显示屏、LCD、屏幕、显示、绘制、亮度、刷屏。
TDL thermal printer usage for TuyaOpen: discover the printer, print UTF-8 text (auto GBK conversion on ESC/POS), print 1-bit bitmaps, feed paper, and monitor paper/temperature status. 打印机、热敏打印、打印、小票、票据、出纸、ESC/POS、printer、DP48A。