Integrar radar pulsado Acconeer A111 con Raspberry Pi: guía práctica

Introducción

Productos experimentales: SparkX entrega tecnología punta rápidamente. Aunque estos items son probados rigurosamente, se venden sin garantías formales y soporte técnico en vivo no está disponible.

¿Necesitas detección ultra-precisa de distancia, velocidad, movimiento o gestos que supere ultrasónico e infrarrojo? Conoce el Acconeer A111 —módulo radar pulsado compacto de 60 GHz que aporta sensado alto rendimiento a tus proyectos.

El A111 es solución radar coherente pulsado (PCR) en single-chip con antenas integradas e interfaz SPI 50 MHz. Soporta detección distancia, gestos, movimiento y velocidad hasta dos metros, y puede rastrear múltiples objetos simultáneamente.

Nuestra breakout board añade regulador 1,8 V, traducción nivel voltaje y header hembra 20-pin 2×10 totalmente compatible con headers GPIO Raspberry Pi.

Materiales requeridos

Para trabajar con el A111 debes usar arquitectura ARMv7 o ARM Cortex-M4, ya que el SDK actual es closed-source y solo soporta estas plataformas. Esta guía demuestra integrar el sensor con Raspberry Pi, plataforma cuya arquitectura es compatible con el SDK.

La breakout board provee header hembra 20-pin 2×10 que encaja directo en cualquier modelo Raspberry Pi. Si prefieres cableado manual, la board también ofrece headers macho y los típicos 9 cables jumper macho-hembra.

Configurar hardware

Raspbian y SPI

Asumiendo que ya tienes Raspbian instalado en tu Pi, consulta documentación Raspberry Pi para instalación OS, o usa nuestro tutorial Raspberry Pi Headless para proceso optimizado.

Habilita SPI en tu Pi —ver nuestro tutorial SPI en Pi para guía.

La breakout A111 está diseñada para montarse encima de una Raspberry Pi. No ocupa todos los 40 pines GPIO de Pi B+ (o posterior), pero el header 26-pin 2×13 es totalmente compatible con cualquier modelo Pi.

Para instalar, suelda header 2×13 con lado hembra enfrentado lejos del IC A111. Luego conecta el shield de la breakout a la Pi, alineando texto "Pi Display" con header display de la Pi. El sensor debe mirar hacia arriba tras inserción.

Breakout A111 enchufado en Raspberry Pi.

Alternativamente, si prefieres cableado manual, usa pinout abajo para resto del tutorial:

Pin Breakout	Nombre Pin Raspberry Pi	Número Pin RasPi
CS	SPI0 CS0	24
SCLK	SPI0 SCLK	23
MISO	SPI0 MISO	21
MOSI	SPI0 MOSI	19
INT	GPIO25	22
EN	GPIO27	13
VCCIO	3.3V	1,17
GND	GND	6, 14, 20, etc.
VIN	5V	2, 4

⚡ Voltaje entrada y niveles lógicos: La board expone tanto VIN como VCCIO. VIN alimenta el sensor, consumiendo ~80 mA. VCCIO fija voltaje I/O y puede ser menor que VIN. Conecta VIN a 5 V de la Pi y VCCIO a 3,3 V; la Pi solo puede manejar 3,3 V I/O.

Habilitar SPI en tu Raspberry Pi

Consulta tutorial SPI en Pi para pasos detallados para activar SPI vía herramientas configuración Raspberry Pi.

Obtener el SDK

El SDK Acconeer A111 es propietario y actualmente solo soporta plataformas ARMv7 y Cortex-M4. Para descargar SDK, visita página Productos Acconeer y localiza sección A1 Software Development Kit. Clic en GET SOFTWARE, acepta licencia y solicita versión A1 SDK for Linux ARMv7.

Solicitando SDK ARMv7 desde Acconeer.

Tras proporcionar email, recibirás enlace descarga por email casi inmediatamente.

SCP el SDK a tu Pi

Una vez descargado ZIP, transfiérelo a tu Pi. En Windows, usa WinSCP. En macOS o Linux, usa SCP:

scp acconeer_evk_service_linux_armv7l_xc111_r4a_xr111-3_r1c_a111_r2c_v1_3_5.zip 192.168.0.100:~

Nota: Reemplaza 192.168.0.100 con IP o hostname de tu Pi.

Descomprimir SDK

En la Pi, descomprime SDK con siguientes comandos (instala unzip si necesario):

unzip acconeer_evk_service_linux_armv7l_xc111_r4a_xr111-3_r1c_a111_r2c_v1_3_5.zip -d a111

Navega a directorio a111/evk_service para preparar build software ejemplo.

Visión general SDK

El bundle SDK contiene código fuente, librerías precompiladas, headers y documentación. Directorios clave:

• doc – Documentación API generada con Doxygen.
• include – Headers describiendo la API.
• lib – Archivos estáticos precompilados.
• out – Binarios board y ejemplos compilados.
• rule – Reglas Makefile para construir boards y ejemplos.
• source – Archivos C fuente para boards y ejemplos personalizados.
• makefile – Makefile top-level invocando reglas recursivamente.

Añadir archivos ejemplo y board personalizados

El mapeo pines SparkFun A111 Breakout difiere del default del SDK. Descarga archivos personalizados desde nuestro repositorio GitHub (zip). Extráelos en directorios correspondientes del SDK:

unzip sparkx-a111-source.zip -d a111/evk_service_linux_armv7l_xc111_r4a_xr111-3_r1c_a111_r2c

Archivos incluidos:

• rule/makefile_build_sparkx_detector_distance.inc – Reglas build para ejemplo detector distancia.
• rule/makefile_build_example_*_sparkx – Reglas build para ejemplos SparkX breakout.
• source/acc_board_rpi_sparkx.c – Definición board con conexiones pines y ajustes reloj.
• source/sparkx_detector_distance.c – Fuente detector distancia modificado.

Asegura que estos archivos estén en mismas ubicaciones relativas que en ZIP original SDK.

Archivos ejemplo personalizados añadidos a directorio rule del SDK.

Compilar y ejecutar sketch prueba

Construir aplicaciones board y ejemplo

Con SDK y archivos personalizados en lugar, compila todos los ejemplos ejecutando make desde directorio top-level del SDK. El Makefile recursivo compilará definición board y todos los ejemplos incluidos.

Tras build exitoso, ejecuta binario deseado desde directorio out para iniciar sensor A111 y validar funcionalidad.

Para instrucciones build detalladas y troubleshooting, consulta documentación SDK en carpeta doc.

¡Feliz hacking con Acconeer A111 en tu Raspberry Pi!