# Tuyaopen/onchip Adc

> 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、采集。

- Skill: `tuya/tuyaopen-onchip-adc` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tuya/tuyaopen-onchip-adc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tuya/tuyaopen-onchip-adc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tuya (https://skillmd.com/u/tuya)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tuya/tuyaopen-onchip-adc

---


# TuyaOpen On-Chip ADC

## On-chip — no Kconfig, no TDD

- Platform-provided. **Do NOT** write `CONFIG_ENABLE_ADC`. No `app_default.config` change needed.
- No `board_register_hardware()`. Call `tkl_adc_*` directly with `TUYA_ADC_NUM_<n>`.
- Confirm **which ADC unit** + **channel** (and its input pin) with the user; record as `onchip:adc<n>` in `used-peripherals.json`.

## Platform spec — read, don't hardcode (channel ↔ pin is fixed)

`.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.

## Init + read single channel

```c
#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);
}
```

## API Reference

| 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 |

## Troubleshooting

| 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 |

## Reference example

SDK: `examples/peripherals/adc/` (init, read_single_channel, deinit).