tuyaopen-onchip-spi

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]

TuyaOpen On-Chip SPI (master)

On-chip — no Kconfig, no TDD

• Platform-provided. Do NOT write CONFIG_ENABLE_SPI. No app_default.config change needed.
• No board_register_hardware(). Call tkl_spi_* directly with TUYA_SPI_NUM_<n>.
• Confirm which SPI port + pins (SCLK/MOSI/MISO/CS) with the user; record as onchip:spi<n> in used-peripherals.json. CS is often a plain GPIO you toggle yourself — see the gpio skill.
• Pins: a port's default SCLK/MOSI/MISO need no mux. Only call tkl_io_pinmux_config() (#include "tkl_pinmux.h") when routing to a non-default / alternate pin group — check the platform pinout.

Platform spec — read, don't hardcode

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

Init + send

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

API Reference

Troubleshooting

Reference example

SDK: examples/peripherals/spi/ (master init, send loop).