菜单
On-chip SPI master for TuyaOpen using the tkl_spi API: init with mode / data bits / bit order, then send (and receive) bytes. SPI、SPI总线、主机、片选、MOSI、MISO、SCLK、tkl_spi、SPI收发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | tuyaopen/onchip-spi |
| description | On-chip SPI master for TuyaOpen using the tkl_spi API: init with mode / data bits / bit order, then send (and receive) bytes. SPI、SPI总线、主机、片选、MOSI、MISO、SCLK、tkl_spi、SPI收发。 |
| when_to_use | Use when the user wants to talk to an SPI device as bus master: send a buffer, or send/receive. For a catalogued SPI display, use the display peripheral skill instead. |
| id | onchip-spi |
| surfaces | ["embedded"] |
| tags | ["spi","bus","master","on-chip","tkl_spi"] |
CONFIG_ENABLE_SPI. No app_default.config change needed.board_register_hardware(). Call tkl_spi_* directly with TUYA_SPI_NUM_<n>.onchip:spi<n> in used-peripherals.json. CS is often a plain GPIO you toggle yourself — see the gpio skill.tkl_io_pinmux_config() (#include "tkl_pinmux.h") when routing to a non-default / alternate pin group — check the platform pinout..tuyaopen/ide/platform.json → peripherals.spi.spec: ports[].pinGroups give each
port's CLK/CS/MOSI/MISO pin options (single group → default pins, no mux; multiple →
pick one and mux), ports[].freq the valid clock range (freq_hz), plus mode /
databits / bitorder valid sets. The example values below are illustrative —
confirm against the spec for the chosen port.
#include "tal_api.h"
#include "tkl_spi.h"
#define SPI_PORT TUYA_SPI_NUM_0
void app_spi_init(void)
{
TUYA_SPI_BASE_CFG_T cfg = {
.mode = TUYA_SPI_MODE0,
.freq_hz = 1000000, /* 1 MHz */
.databits = TUYA_SPI_DATA_BIT8,
.bitorder = TUYA_SPI_ORDER_MSB2LSB,
.role = TUYA_SPI_ROLE_MASTER,
.type = TUYA_SPI_AUTO_TYPE,
};
tkl_spi_init(SPI_PORT, &cfg);
}
void app_spi_tx(const uint8_t *buf, uint16_t len)
{
tkl_spi_send(SPI_PORT, (void *)buf, len);
}
| Function | Description |
|---|---|
tkl_spi_init(port, &cfg) | cfg.mode (TUYA_SPI_MODE0..3), cfg.databits (TUYA_SPI_DATA_BIT8), cfg.bitorder (TUYA_SPI_ORDER_MSB2LSB / _LSB2MSB), cfg.role (TUYA_SPI_ROLE_MASTER), cfg.type (TUYA_SPI_AUTO_TYPE), cfg.freq_hz |
tkl_spi_send(port, buf, len) | Send len bytes |
tkl_spi_recv(port, buf, len) | Receive len bytes |
tkl_spi_transfer(port, tx, rx, len) | Full-duplex transfer |
tkl_spi_deinit(port) | Release the port |
| Symptom | Likely cause | Fix |
|---|---|---|
| Garbage on the wire | Wrong SPI mode (CPOL/CPHA) | Match the device's mode (TUYA_SPI_MODE0..3) |
| Bit order wrong | MSB/LSB mismatch | Set bitorder per the device datasheet |
| Device never selected | CS not driven | Toggle CS GPIO around the transfer (gpio skill) |
SDK: examples/peripherals/spi/ (master init, send loop).
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。