Tuyaopen/onchip 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).