Skip to main content

Resumen

Este wiki explica cómo actualizar el firmware más reciente del núcleo inalámbrico Realtek RTL8720 en el Wio Terminal, así como instalar todas las librerías dependientes para habilitar la conectividad inalámbrica.

Actualizar el firmware del núcleo inalámbrico​

Primero, necesitamos actualizar el firmware del núcleo inalámbrico Realtek RTL8720 en el Wio Terminal. Esto es esencial y se debe actualizar al firmware más reciente antes de continuar con los ejemplos.

icono de atención

Atención

¡Por favor actualiza el núcleo Wi-Fi antes de usar!

Paso 1 - Borrar el firmware inicial de fábrica​

Cuando recibes el Wio Terminal por primera vez, debes borrar el firmware inicial del RTL8720 y flashear el firmware más reciente. Hemos preparado una herramienta llamada ambd_flash_tool, que primero habilita una conexión serial desde el SAMD51 al RTL8720 para instalar el firmware en el RTL8720, porque no se puede comunicar directamente con este chip. Después, esta herramienta permite borrar el firmware existente y flashear el firmware más reciente.

NOTA: Solo es necesario borrar el firmware de fábrica la primera vez. Después puedes flashear nuevo firmware para sobrescribir el existente.

Para Windows​

  • PASO 1: Abre Windows PowerShell en tu PC y ejecuta los siguientes comandos para descargar la herramienta de flasheo
cd ~
git clone https://github.com/Seeed-Studio/ambd_flash_tool

NOTA: El comando cd ~ te dirige a tu carpeta de usuario y git clone descarga el repositorio desde GitHub.

  • PASO 2: Navega al directorio ambd_flash_tool
cd ambd_flash_tool

  • PASO 3: Conecta el Wio Terminal a la PC y enciéndelo

  • PASO 4: Ejecuta el siguiente comando para borrar el firmware inicial

.\ambd_flash_tool.exe erase

NOTA: El proceso de borrado puede tardar. Por favor espera y no cierres la ventana.

¡El puerto serial conectado del Wio Terminal se detectará automáticamente!

NOTA: Para ver la ayuda de la herramienta, ejecuta .\ambd_flash_tool.exe

imagen herramienta Windows

Para Mac/Linux​

  • PASO 1: Abre Terminal en Mac/Linux y ejecuta los siguientes comandos para descargar la herramienta de flasheo
cd ~
git clone https://github.com/Seeed-Studio/ambd_flash_tool

NOTA: El comando cd ~ te dirige a tu carpeta de usuario y git clone descarga el repositorio desde GitHub.

  • PASO 2: Navega al directorio ambd_flash_tool
cd ambd_flash_tool

  • PASO 3: Conecta el Wio Terminal a la PC y enciéndelo

  • PASO 4: Ejecuta el siguiente comando para borrar el firmware inicial

python3 ambd_flash_tool.py erase

NOTA: Asegúrate de tener instalado Python 3 en tu Mac/Linux; el script descargará automáticamente las librerías dependientes.

Si en tu sistema solo tienes Python 3 disponible como python, reemplaza python3 ambd_flash_tool.py por python ambd_flash_tool.py

NOTA: El proceso de borrado puede tardar. Por favor espera y no cierres la ventana.

¡El puerto serial conectado del Wio Terminal se detectará automáticamente!

NOTA: Para ver la ayuda de la herramienta, ejecuta python3 ambd_flash_tool.py

imagen herramienta Linux

Paso 2 - Flashear el firmware más reciente​

Para Windows​

  • Dentro del directorio ambd_flash_tool, ejecuta el siguiente comando para flashear el firmware más reciente en el RTL8720
.\ambd_flash_tool.exe flash

Para Mac/Linux​

  • Dentro del directorio ambd_flash_tool, ejecuta el siguiente comando para flashear el firmware más reciente en el RTL8720
python3 ambd_flash_tool.py flash

Flashear un firmware antiguo (Opcional)​

Si deseas probar tu código con una versión antigua del firmware, sigue estos pasos. Si prefieres usar el firmware más reciente, puedes omitir este paso y seguir directamente el Paso 2.

Para Windows​

  • PASO 1: Visita el repositorio RTL8720 Firmware en GitHub

  • PASO 2: Elige una versión de lanzamiento y descarga el archivo xxx-seeed-ambd-firmware-rpc-vxxx.zip

  • PASO 3: Navega al directorio ambd_flash_tool y ejecuta el siguiente comando

.\ambd_flash_tool.exe flash -d [ruta-del-firmware-RTL8720]

NOTA: Reemplaza [ruta-del-firmware-RTL8720] por la ruta donde descargaste y descomprimiste el firmware. La carpeta debe contener estos 3 archivos: km0_boot_all.bin, km0_km4_image2.bin y km4_boot_all.bin.

Si todo sale bien, verás un mensaje de éxito y habrás flasheado el firmware en el núcleo RTL8720.

Para Mac/Linux​

  • PASO 1: Visita el repositorio RTL8720 Firmware en GitHub

  • PASO 2: Elige una versión de lanzamiento y descarga el archivo xxx-seeed-ambd-firmware-rpc-vxxx.zip

  • PASO 3: Navega al directorio ambd_flash_tool y ejecuta el siguiente comando

python3 ambd_flash_tool.py flash -d [ruta-del-firmware-RTL8720]

NOTA: Reemplaza [ruta-del-firmware-RTL8720] por la ruta donde descargaste y descomprimiste el firmware. La carpeta debe contener estos 3 archivos: km0_boot_all.bin, km0_km4_image2.bin y km4_boot_all.bin.

Si todo sale bien, verás un mensaje de éxito y habrás flasheado el firmware en el núcleo RTL8720.

Verificar versión del firmware RTL8720 desde Arduino IDE​

Después de instalar el firmware, puedes verificar si fue instalado correctamente subiendo el siguiente código al Wio Terminal desde Arduino IDE

#include "rpcWiFi.h"
#include <erpc/erpc_port.h>
 
void setup() {
    Serial.begin(115200);
    while(!Serial); // Esperar que se abra el Monitor Serial
    char* version = rpc_system_version();
    Serial.print("Versión del firmware RTL8720: ");
    Serial.println(version);
    erpc_free(version);
}
 
void loop() {
}

Al abrir el Monitor Serial, deberías ver impresa la versión del firmware.

Actualizar Seeed SAMD ArduinoCore​

  • PASO 1: Abre el Arduino IDE, y haz clic en Tools -> Board -> Boards Manager, y busca Wio Terminal

  • PASO 2: Asegúrate de tener instalada la versión más reciente (1.8.1). Si no, selecciona la versión más nueva en el menú desplegable y haz clic en Install.

ArduinoCore

También puedes consultar el código fuente del Seeed SAMD ArduinoCore aquí.

Instalación de librerías​

Hay varias librerías Arduino necesarias para la conectividad inalámbrica. Hemos incluido todas las librerías relacionadas con Wi-Fi para el Wio Terminal en el Arduino Library Manager, así que solo debes abrirlo dentro del IDE y buscar las librerías que necesites para instalarlas fácilmente.

Cómo instalar una librería desde el Arduino Library Manager​

  • PASO 1: Abre el Arduino IDE, y haz clic en Sketch -> Include Library -> Manage Libraries...

  • PASO 2: Escribe el nombre de la librería que necesites y selecciona la versión más reciente del menú desplegable (si está disponible)

  • PASO 3: Haz clic en Install

Instalación de librerías

Librerías necesarias para Wi-Fi​

Necesitas las siguientes librerías para comenzar a usar Wi-Fi en el Wio Terminal. Puedes buscarlas por nombre en el Arduino Library Manager.

Para tu comodidad, hemos agrupado todas estas librerías. Por ello, para futuras actualizaciones solo necesitas instalar rpcwifi y se instalarán todas las librerías dependientes de Wi-Fi automáticamente.

Librerías Wi-Fi

Lanzamientos​

Fecha de actualizaciónAutorDetalle
10.12BILL y LAKSHANTHAAgrupación de todas las librerías requeridas

Soporte Técnico y Discusión de Productos​

Si tienes algún problema técnico, por favor envía tu consulta a nuestro foro. ¡Gracias por elegir nuestros productos! Estamos aquí para brindarte soporte y asegurar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para adaptarnos a diferentes preferencias y necesidades.

Loading Comments...