菜单
On-chip PWM for TuyaOpen using the tkl_pwm API: init a PWM channel with frequency + duty, start/stop, and change duty at runtime. PWM、脉宽调制、占空比、调光、蜂鸣器、舵机、呼吸灯、tkl_pwm。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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。
| name | tuyaopen/onchip-pwm |
| description | On-chip PWM for TuyaOpen using the tkl_pwm API: init a PWM channel with frequency + duty, start/stop, and change duty at runtime. PWM、脉宽调制、占空比、调光、蜂鸣器、舵机、呼吸灯、tkl_pwm。 |
| when_to_use | Use when the user wants a PWM signal: dimming, buzzer tone, servo angle, motor speed, or breathing-light brightness on a PWM channel. |
| id | onchip-pwm |
| surfaces | ["embedded"] |
| tags | ["pwm","duty","frequency","on-chip","tkl_pwm"] |
CONFIG_ENABLE_PWM. No app_default.config change needed.board_register_hardware(). Call tkl_pwm_* directly with TUYA_PWM_NUM_<n>.onchip:pwm<n> in used-peripherals.json. Don't reuse a confirmed peripheral's pin.spec.channels[].pin) — pick the channel for the pin you want. There is no tkl_io_pinmux_config for PWM..tuyaopen/ide/platform.json → peripherals.pwm.spec: channels[] maps each PWM
channel id to a fixed output pin — so pick the channel whose pin is the
one you want; there is no pin mux for PWM. duty range (e.g. 0–10000) and freq
range come from spec.duty / spec.freq — read them, don't assume.
#include "tal_api.h"
#include "tkl_pwm.h"
#define PWM_PORT TUYA_PWM_NUM_0
void app_pwm_init(void)
{
TUYA_PWM_BASE_CFG_T cfg = {
.duty = 5000, /* 1–10000 → 50.00% */
.frequency = 1000, /* Hz */
.polarity = TUYA_PWM_POSITIVE,
};
tkl_pwm_init(PWM_PORT, &cfg);
tkl_pwm_start(PWM_PORT);
}
/* Change brightness/duty at runtime (e.g. breathing light) */
void app_pwm_set_duty(uint32_t duty /* 1–10000 */)
{
TUYA_PWM_BASE_CFG_T cfg = { .duty = duty, .frequency = 1000, .polarity = TUYA_PWM_POSITIVE };
tkl_pwm_info_set(PWM_PORT, &cfg);
}
| Function | Description |
|---|---|
tkl_pwm_init(ch, &cfg) | cfg.duty (1–10000 = 0.01%–100%), cfg.frequency (Hz), cfg.polarity (TUYA_PWM_POSITIVE / TUYA_PWM_NEGATIVE) |
tkl_pwm_start(ch) / tkl_pwm_stop(ch) | Start / stop output |
tkl_pwm_info_set(ch, &cfg) | Update duty/frequency at runtime |
tkl_pwm_deinit(ch) | Release the channel |
| Symptom | Likely cause | Fix |
|---|---|---|
| No output | Forgot tkl_pwm_start | Start after init |
| Duty seems inverted | Wrong polarity | Flip TUYA_PWM_POSITIVE / _NEGATIVE |
| Duty out of range | duty not in 1–10000 | Clamp to 1–10000 |
SDK: examples/peripherals/pwm/ (init with duty/frequency/polarity, start).