Skip to content

Main Navigation Homepage Solution Notice

Xiaoan-AI

AiPi Open-source Hardware

Wi-Fi

LoRa & LoRaWAN

Bluetooth

Radar

Offline Voice

UWB

GPS

RF433

NearLink

NB-IoT

2.4G

Antennas

Ubases IoT

Alibaba Discussions

Tech Support

Product Compare

Product Discontinuance

Regulatory Certificates

About us Contact us

English

简体中文

English

简体中文

Appearance

Sidebar Navigation

Development Environment Setup

Quick Links

VMware Installation

Ubuntu Installation

WSL Installation

VSCode Installation

Ai-WB2 Tutorial

Product Introduction

SDK Installation

Ai-Thinker-WB2 SDK

Linux Platform

Windows Platform

Basic Peripherals

GPIO Output

GPIO Input

EXTI External Interrupt

TIMER

PWM

ADC

UART (Serial)

DMA Transfer

I2C Protocol

SPI Protocol

System Control

blog Log

Flash Operations

Sleep Mode

Software Timer

Software Reboot

Wireless Network

Wi-Fi

Wi-Fi Introduction

Connect Wi-Fi

Soft-AP Mode

SNTP (Network Time)

TCP/IP Communication

TCP Client

TCP Server

UDP Broadcast

UDP Client

UDP Multicast

UDP Server

HTTP/S

GET

POST

PUT

DELETE

MQTT Connection

MQTTS Connection

BLE

Ai-WB2 BLE Introduction

iBeacon

BLE Master

BLE Slave

blufi Provisioning

API Reference

System & Kernel (FreeRTOS)

System Init & Reset

Log Output (blog)

Software Timer (bl_os_timer)

Low Power (Deep Sleep)

GPIO

UART Serial

Hardware Timer (hosal_timer)

PWM (Register Level)

ADC

I2C Bus

SPI & DMA

Flash Storage & File System

Wi-Fi Management

Network (lwIP Socket)

SNTP Time Sync

BLE & Provisioning

MQTT & Cloud Platforms

Principles Deep Dive

Clock Tree & Boot Flow

GPIO Principles

UART Principles

SPI Principles

I2C Principles

Interrupt & Timer Principles

FreeRTOS Scheduling

BLE & GATT

Network Protocol Classification

SDK Peripheral Implementation

Wi-Fi Protocol Implementation

TCP/UDP Protocol Implementation

HTTP Protocol Implementation

MQTT Protocol Implementation

Best Practices

Connect Alibaba Cloud IoT

Connect AWS IoT

Connect Tencent Cloud IoT

BH1750 Light Sensor

DHT11 Temp & Humidity Sensor

SHT30 Temp & Humidity Sensor

DS18B20 Temperature Sensor

MPU6050 6-Axis Sensor

NTC Temperature Measurement

SSD1306 OLED Display

WS2812 RGB LED

TM1721 Driver Chip

LVGL GUI

AiPi-Clock-Mini

Developer Contributions

Contributions Overview

Quick Start

WB2 Example Code Tutorial---Peripheral UART (Contributed by ckdsx.cn)

WB2 Example Code Tutorial---Peripheral GPIO (Contributed by ckdsx.cn)

WB2 Example Code Tutorial---ADC (Contributed by ckdsx.cn)

Ai-WB2 Module MQTT over TLS Connection to Server Usage Example (Contributed by 爱笑)

Ai-WB2-32S AT+SOCKET Series Commands (Contributed by 黎明将至!)

Ai-WB2-32S http_server and http_client Demo Communication Setup (Contributed by 黎明将至!)

Ai-WB2-32S Basic AT Command Series (1) (Contributed by 黎明将至!)

[Ai-WB2 Getting Started] Ai-WB2 Overview (Contributed by 爱笑)

[Ai-WB2 Getting Started] GPIO Usage (Contributed by 爱笑)

[Ai-WB2 Getting Started] UART Data Transmission and Reception (Contributed by 爱笑)

[Ai-WB2 Getting Started] DMA Data Transfer (Contributed by 爱笑)

[Ai-WB2 Getting Started] Timer Usage (Contributed by 爱笑)

[Ai-WB2 Getting Started] Watchdog Usage (Contributed by 爱笑)

[Ai-WB2 Getting Started] PWM (Contributed by 爱笑)

[Ai-WB2 Intermediate] RTC Real-Time Clock (Contributed by 爱笑)

[Peripheral Porting] Ai-WB2 + MPU6050 (Contributed by bzhou830)

[Ai-WB2] Porting the OLED Library, Powerful Features (Contributed by 沈夜)

Let's Monitor the Ai-WB2 Device Temperature Together (Contributed by WildboarG)

A Small Tool for Quickly Generating Ai-WB2 Projects (Contributed by WildboarG)

Push Messages to Personal Notifications with AI-WB2 (Contributed by WildboarG)

AI-WB2 + RD04 Sentry Check (Contributed by WildboarG)

[AI-WB2 Application] Dynamic Password Lock (Contributed by WildboarG)

High-Performance WiFi + BLE Dual-Mode Ai-WB2-32S-Kit Unboxing and LED Blink (Contributed by 大锤子)

Fastest Deployment Challenge - Ai-WB2 (Contributed by 沈夜)

[wb2] HTTP GET Application (Contributed by WildboarG)

[AI-WB2-32S-Kit Review] 02 Startup Flow (Contributed by OldNewman)

[WB2] Devices Discoverable at a Glance (Contributed by WildboarG)

[WB2] Auto-Discovering Devices on the LAN (Contributed by WildboarG)

Environment Setup

Ai-WB2-32S AT+SOCKET TCP Server Setup (Communication Between Two Modules) (Contributed by 黎明将至!)

Flashing Ai-WB2-32S on Linux Ubuntu (Contributed by 黎明将至!)

[Ai-WB2] Windows Development Environment Setup (Bouffalo SDK) (Contributed by 沈夜)

[Ai-WB2] WSL Development Environment Setup — As Easy as Pie (Contributed by bzhou830)

[Ai-WB2] Arch Development Environment Setup (Contributed by WildboarG)

Ai-WB2 Environment Setup: Pitfalls and Lessons Learned (Contributed by putin)

[Ai-WB2-32S Dev Board Review] Introduction, Environment Setup, Firmware Flashing (Contributed by 无垠的广袤)

Ai-WB2 VS Code Development Environment Deployment (Contributed by 沈夜)

Ai-WB2 (Bl602) One-Click Environment Deployment Package (Contributed by 沈夜)

[Ai-WB2 Review] Three Ways to Set Up the VS Code Environment (Contributed by sujingliang)

[AI-WB2-32S-Kit Review] 01 Setting Up the Development Environment (Contributed by OldNewman)

Build & Flash

Ai-WB2-32S Firmware Flashing and RGB LED Lighting (AT+SYSIOMAP) (Contributed by Limingjiangzhi!)

[Ai-WB2] Flashing and LED Blinking (Contributed by Shenye)

[Ai-WB2] Cloud Compilation (Contributed by WildboarG)

Bouffalo Lab Smart IoT Tool (Flash Programming) (Contributed by Shenye)

Simple Analysis of Ai-WB2 Flash Programming (Contributed by Shenye)

A Solution to the WB2-12F Automatic Download Issue (Contributed by iiv)

Ai-Thinker-WB2 Project Update and ws2812 Build Guide (Contributed by Shenye)

Peripherals

Test and Light Up an LED with the AI-WB2 Module (Contributed by WangChong)

Ai-WB2-32S IIC Driving a Temperature and Humidity Sensor (SHT31) (Contributed by 黎明将至!)

Ai-WB2-32S SPI Writing to an SD Card (Contributed by 黎明将至!)

Ai-WB2-32S GPIO Driving an RGB LED (Contributed by 黎明将至!)

Ai-WB2-32S UART RX Timeout Interrupt (Receive Idle Interrupt) (Contributed by 黎明将至!)

[Ai-WB2 Intermediate] ADC Analog-to-Digital Conversion (Contributed by 爱笑)

[Ai-WB2] Easy Peasy: Lighting Up the WB2 (Contributed by bzhou830)

[Ai-WB2 Intermediate] DAC Digital-to-Analog Conversion (Contributed by 爱笑)

[Peripheral Porting] Ai-WB2 + BH1750 Light Intensity Sensor (Contributed by WangChong)

[Ai-WB2 Intermediate] I2C Communication Interface (Contributed by 爱笑)

[Ai-WB2 Intermediate] SPI and WS2812B Driver (Contributed by 爱笑)

[Peripheral Porting] Ai-WB2 + AHT20 Temperature and Humidity Sensor (Contributed by WangChong)

Peripheral Porting: Ai-WB2+SHT30 Temperature and Humidity Sensor (Contributed by WangChong)

Peripheral Porting: Ai-WB2+Modbus 485 RTU Remote Control (Contributed by ckdsx.cn)

Peripheral Porting: Ai-WB2+INA266 (Contributed by WangChong)

Peripheral Porting: Ai-WB2+Dual-Axis Joystick Module (Contributed by bzhou830)

Peripheral Porting: Ai-WB2+FPM383C Fingerprint (Contributed by WT_0213)

WB2 Genshin Impact Startup OLED Display (Contributed by 沈夜)

[Ai-WB2] Playing a Video of a Famous Artist Playing Basketball on a 0.96-inch OLED (Contributed by 沈夜)

AI-WB2 Software-Simulated SPI to Light Up an LCD Screen (Contributed by putin)

Ai-WB2 SPI Testing (Contributed by WildboarG)

AI-WB2 SPIFFS File System: Data Survives Flashing and OTA (Contributed by 小何)

Ai-WB2 SPI Testing (WS2812) (Contributed by 沈夜)

AI-WB2 Adding a Button on IO08 (Long Press, Single Click, Double Click, Release) with MultiButton (Contributed by 邦邦)

Adding the LHAL Driver and DS18B20 Temperature Detection to the AI-WB2 Component (Contributed by Bangbang)

[Ai-WB2 Review] BLE+PWM RGB LED Control (Contributed by sujingliang)

[Ai-WB2 Review] Sampling NTC Thermistor Temperature with ADC and Reporting It over BLE (Contributed by sujingliang)

Ai-WB2 Reading the DHT11 Temperature and Humidity Sensor (Contributed by WildboarG)

[WB2 BLE Learning-1] BLE Data Broadcasting (Contributed by Dachuizi)

[WB2 BLE Learning-2] Callback Functions (Contributed by Dachuizi)

[AI-WB2-32S-Kit Review] 04 Reporting Temperature and Humidity to the Alibaba Cloud IoT Platform (Contributed by OldNewman)

[WB2 BLE Learning-3] Implementing Connection Status Indication (Contributed by Dachuizi)

Ai-WB2: Web-Based Control of WS2812 LED Strips (Pending Testing) (Contributed by Shenye)

[Major Update] WB2 SDK WS2812 Driver Fully Upgraded! (Contributed by Shenye)

Ai-WB2 BLE HID Three-in-One Composite Device (Contributed by bzhou830)

Networking

[Tutorial] Ai-WB2 Series Module / Development Board Connecting to AWS Amazon Cloud (Contributed by Aixiao)

Ai-WB2 Module HTTP Client POST Request Method (Contributed by Aixiao)

Ai-WB2-32S AT+HTTPCLIENTLINE Command Usage (Contributed by Liming Jiangzhi!)

Ai-WB2-32S AT+MQTT Command Series Usage (Contributed by Liming Jiangzhi!)

Ai-WB2-32S MQTT over TCP (Contributed by Liming Jiangzhi!)

[AI-WB2 Advanced] TCP Wireless Communication (Contributed by WildboarG)

[Ai-WB2 Advanced] UDP Wireless Communication (Contributed by WildboarG)

AI-WB2 OTA Upgrade Tutorial (Contributed by Xiao He)

AI-WB2 EasyFlash File System: Data Survives Flashing and OTA (Contributed by Xiao He)

AI-WB2 Provisioning [Part 1] (Contributed by WildboarG)

AI-WB2 Provisioning [Part 2] (Contributed by WildboarG)

AI-WB2 Provisioning [Part 3] (Contributed by WildboarG)

[Ai-WB2 Review] Bafa Cloud MQTT (Contributed by sujingliang)

[Ai-WB2 Review] AiXing IoT Platform Practice (Contributed by sujingliang)

System

Technical Q&A — Ai-WB2 Module SPP Connection with Phone, AT Command Failure Issue (Contributed by 爱笑)

How to Locate and Analyze Static and Dynamic Memory Usage in Code During Ai-WB2 Series Secondary Development (Contributed by 爱笑)

API Compilation for Ai-WB2 (Contributed by WildboarG)

Adding the littlefs File System to AI-WB2 (Contributed by Bangbang)

Adding the FlashDB Database to AI-WB2, an Upgraded Version of easyflash4 (Contributed by Bangbang)

Ai-M6x Tutorial

Product Introduction

SDK Installation

Ai-Thinker-M6x SDK

Linux Platform

Windows Platform

Create a Project (In-SDK)

External Project (Submodule)

Basic Peripherals

GPIO Output

GPIO Input

EXTI External Interrupt

TIMER

PWM

ADC

ADC Keypad

UART (Serial)

DMA Transfer

I2C Protocol

SPI Protocol

I2S Audio

IR Infrared (NEC Protocol)

RTC Real-Time Clock

WDG Watchdog

Flash Internal Storage

DAC Digital-to-Analog

MTimer Machine Timer

EFUSE

PSRAM External Memory

RAM Speed Bandwidth Test

SDIO High-Speed Interface

EMAC Ethernet

DBI Display Interface

CKS Checksum

WO Wire Output (WS2812)

Audio Capture and Playback

CAM Camera (DVP)

SEC_ENG Security Engine (AES)

SEC_DBG Secure Debug

System Control

System Control Overview

blog Log

Flash Operations

Sleep Mode

Software Timer

Software Reboot

Power-Off Saving

Partition Table

Log Debug & Assert

Crash Debugging

System & Software

FreeRTOS Operating System

Shell Command Line

POSIX Interface

FATFS File System

LittleFS File System

Memory Stress Test

DSP Math Library

CPU Benchmark

Wireless Network

Wi-Fi

Wi-Fi Introduction

Connect Wi-Fi

Soft-AP Mode

SNTP (Network Time)

TCP/IP Communication

TCP/IP Stack Introduction

TCP Client

TCP Server

UDP Client

UDP Server

UDP Broadcast

UDP Multicast

HTTP/S

HTTP Protocol Introduction

GET

POST

PUT

DELETE

HTTPS

MQTT Connection

MQTTS Connection

WebSocket

HTTP(S) OTA Upgrade

RESTful API Server

BLE

Ai-M6x BLE Introduction

iBeacon

BLE Master

BLE Slave

BLE Provisioning

BLE CLI Debugging

BLE Low Power

Wi-Fi & BLE Coexistence

BLE HID CLI Sender

Multimedia

LVGL v9 GUI

LVGL v8 GUI

Audio Player

Audio Codec

MJPEG Video Capture

JPEG Decode & Display

Principles

Clock Tree & Boot

GPIO Fundamentals

UART Fundamentals

SPI Fundamentals

I2C Fundamentals

Interrupts & Timers

FreeRTOS Scheduling

BLE & GATT

Network Protocol Layers

SDK Peripheral Model

Wi-Fi Protocol & Flow

TCP/UDP Protocol & Flow

HTTP Protocol & Flow

MQTT Protocol & Flow

Best Practices

Best Practices Overview

Quick Start

Getting Started with the AiPi-M62-CBS_Kit Board

FreeRTOS Primer: Creating and Scheduling Tasks (AI-M61-32S-Kit)

GPIO Configuration Verified with a Logic Analyzer

Hello World (Ai-M61-32S-Kit Example)

Unboxing the Xiao An Pai and Setting Up the Development Environment

Environment Setup

AiPiEasyStart One-Click Development Environment Tool

Setting Up an Arduino Environment for the AI-M61-32S-Kit

CLion Dev (1): Porting CLinkSDK to the M61 Board

CLion Dev (2): Connecting the M61 Board to Alibaba Cloud

CLion Dev (3): Using Thing Models on Alibaba Cloud with the M61 Board

Building a Dev Environment for Ai-WB2 and Ai-M61/Ai-M62 (Context Switching)

How to Set Up the Xiao An Pai Development Environment on Mac

Building a Native Toolchain on Mac M1 with Flashing Support

Setting Up the Development Environment on Windows (Notes)

Setting Up a WSL Environment for Xiao An Pai Development

Build & Flash

Soldering the Auto-Download Circuit on the M61-32S-Kit

M61 Bluetooth Speaker Demo Firmware

Debugging BL6xx Chips with CKLink

Flashing Firmware for the Ai-M61 / Ai-M62 Series

Flashing a Bare M61 / M62 Module Without a BOOT Pin

Peripherals

Reading the DHT11 Temperature & Humidity Sensor with the Xiao An Pai

DS18B20 Temperature Sensor

Porting the FPM383C Fingerprint Module to the Ai-M61-32S

Lighting an LED from Scratch on the Ai-M61-32S

An I2C Wrapper Based on the Ai-Thinker Ai-M6X SDK

IO Interrupts on the AI-M6X MCU

Infrared Remote Control with the M61-32S

PWM Based on the AI-M61-32S

Driving a 1.8-inch SPI LCD with the M61-32S

Porting a 3.5-inch SPI Color LCD to the Ai-M61-32S

Porting the TM1637 Display to the M61-32S

UART Communication Based on the Ai-M61-32S [BL616]

Porting a USB Keyboard to the M61 Board

Porting a Matrix Keypad (USB Keyboard Supplement)

Porting a USB MIDI Device to the M61 Board

Porting a USB Mouse to the M61 Board

Porting a USB UVC Camera to the M61 Board

Designing a VGA Adapter Board for the M61-32S Kit

First: Controlling an LED from a Web Page with the Ai-M61-32S

WS2812B RGB LEDs as a Monitor Ambience Light with the M61

Networking

Bouffalo Bluetooth A2DP & AVDTP Source Release

AP Web Provisioning on the Ai-M61-32S

AP Web Provisioning on the Ai-M61-32S (Step 1)

AP Web Provisioning on the Ai-M61-32S (Step 2)

AP Web Provisioning on the Ai-M61-32S (Step 3)

Connecting the Ai-M61 / Ai-M62 Series to AWS

Building an A2DP Player with BTstack

Testing the M61 with BTstack

The Fastest Way to Connect WiFi (Xiao An Pai M61-M62)

System

The AI_M61-32S Core Board

Case Closed: Why Wasn't a CoreDump Generated?

Keeping Ai_M6X_SDK Docs Local

MQTT Debugging on the Ai-M61-32S-Kit

Simplifying the Code Structure

Connecting to WiFi and Sending HTTP Requests on the M61-32S

API Reference

Reference Overview

Kernel & System

Basic Peripherals

Multimedia

Security & Encryption

System, Storage & Upgrade

FreeRTOS

WiFi & Network

BLE

Shell & Logging

More services

🎉Technical support

🎉Alibaba

Volume Pricing

Page Navigation

Have questions?

For any other questions, visit the unified Q&A and discussion board: Ai-Thinker Discussions

Released under the MIT License. Build Time 2026-09-30 17:31:25

Copyright@ 2025 深圳市安信可科技有限公司