菜单
On-chip ADC for TuyaOpen using the tkl_adc API: init a channel and read a single conversion (raw value or internal voltage). ADC、模数转换、采样、电压、模拟量、读电压、tkl_adc、采集。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | tuyaopen/onchip-adc |
| description | On-chip ADC for TuyaOpen using the tkl_adc API: init a channel and read a single conversion (raw value or internal voltage). ADC、模数转换、采样、电压、模拟量、读电压、tkl_adc、采集。 |
| when_to_use | Use when the user wants to read an analog value: a sensor voltage, a potentiometer, or the internal supply voltage on an ADC channel. |
| id | onchip-adc |
| surfaces | ["embedded"] |
| tags | ["adc","analog","sample","voltage","on-chip","tkl_adc"] |
CONFIG_ENABLE_ADC. No app_default.config change needed.board_register_hardware(). Call tkl_adc_* directly with TUYA_ADC_NUM_<n>.onchip:adc<n> in used-peripherals.json..tuyaopen/ide/platform.json → peripherals.adc.spec: ports[].channels[] maps each
ADC channel id to its input pin — pick the channel for the pin you want (no pin
mux). bits is the sample width (e.g. 12) and mode lists valid modes. Read these
instead of hardcoding the channel/width.
#include "tal_api.h"
#include "tkl_adc.h"
#define ADC_PORT TUYA_ADC_NUM_0
#define ADC_CHANNEL 0
void app_adc_read(void)
{
TUYA_ADC_BASE_CFG_T cfg = {
.ch_list.data = 1 << ADC_CHANNEL, /* bitmask of channels to convert */
.ch_nums = 1,
.width = 12,
.mode = TUYA_ADC_CONTINUOUS,
.type = TUYA_ADC_INNER_SAMPLE_VOL,
.conv_cnt = 1,
};
if (tkl_adc_init(ADC_PORT, &cfg) != OPRT_OK) { PR_ERR("adc init failed"); return; }
int32_t value = 0;
tkl_adc_read_single_channel(ADC_PORT, ADC_CHANNEL, &value);
PR_NOTICE("adc ch%d = %d", ADC_CHANNEL, value);
tkl_adc_deinit(ADC_PORT);
}
| Function | Description |
|---|---|
tkl_adc_init(port, &cfg) | cfg.ch_list.data (channel bitmask, 1<<ch), cfg.ch_nums, cfg.width (bits), cfg.mode (TUYA_ADC_CONTINUOUS / _SINGLE), cfg.type (TUYA_ADC_INNER_SAMPLE_VOL / external), cfg.conv_cnt |
tkl_adc_read_single_channel(port, ch, &val) | Read one channel's converted value |
tkl_adc_read_data(port, buf, len) | Read multi-channel buffer |
tkl_adc_read_voltage(port, buf, len) | Read as voltage (mV) where supported |
tkl_adc_deinit(port) | Release the ADC |
| Symptom | Likely cause | Fix |
|---|---|---|
| Value always 0 / full-scale | Channel/pin mismatch | Confirm channel ↔ input pin mapping |
| Noisy readings | Single-shot at a bad moment | Average several reads; check reference |
| init fails | Unsupported width/mode on this chip | Use the example's defaults for the platform |
SDK: examples/peripherals/adc/ (init, read_single_channel, deinit).
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。