Saltar al contenido principal

Guía de usuario del firmware de fábrica del Wio-LR2021 Dev Kit

Cada Wio-LR2021 Dev Kit se envía con un firmware de prueba que expone las radios, sensores, pantalla, cámara, ruta de audio y flash de la placa a través de una única consola serie. Esta guía te lleva desde el primer encendido hasta una comprobación funcional completa, e indica qué aspecto tiene un resultado correcto en cada paso.

nota

El firmware de tu placa es la autoridad para esta página. Escribe help para listar los comandos que el build realmente registró; si falta algún comando aquí, tu placa ejecuta una versión diferente.

Qué proporcionan los comandos del firmware​

  • Enlaces Sub-GHz y 2.4 GHz: lora_tx con lora_rx en dos placas; el contador del receptor aumenta.
  • Modos de modulación: gfsk_tx, flrc_rx, lr_fhss_tx; se cuentan los paquetes correctos y los errores de CRC.
  • Potencia de RF: lora_cw; un medidor muestra la portadora.
  • BLE — ble -a 1; un escáner lista wio-lr2021-*.
  • Wi-Fi e IP: sta_connect, ap_set, ping; got ip: y contadores de respuestas.
  • GPIO, I²C y raíles: gpio_get, i2c_scan, io_exp_print; responden 0x21 y 0x3D.
  • Batería: battery_get; milivoltios y una estimación de carga.
  • Pantalla, cámara, audio: oled_test, camera_capture, audio_slot_play; patrón, PASS, reproducción.
  • Flash: flash_info, flash_speed; el código de retorno 0 significa aprobado.

Preparación​

Paso 1. Colocar las antenas y conectar la placa​

Enrosca la antena Sub-GHz en SUB-1G y la antena de 2.4 GHz en LR-2.4G. Conecta el USB-C con un cable de datos — un cable solo de carga alimenta la placa pero no proporciona puerto serie.

precaución

Nunca transmitas sin una antena. El PA entrega hasta +22 dBm en Sub-GHz y +12 dBm en 2.4 GHz a una carga desadaptada, lo que puede dañar el LR2021.

Paso 2. Encontrar el puerto serie​

Abre Device Manager y despliega Ports (COM & LPT). La placa aparece como USB Serial Device con un puerto como COM5.

Paso 3. Abrir un terminal​

HerramientaPlataformaDónde conseguirla
PuTTYWindowsputty.org
screenmacOS / LinuxIntegrado; ejecuta screen /dev/cu.usbmodem* 115200
MinicommacOS / LinuxInstálalo mediante el gestor de paquetes; ejecuta minicom -D /dev/ttyUSB* -b 115200

Todas las herramientas necesitan la misma configuración de línea:

AjusteValor
Baud rate115200
Bits de datos8
ParidadNinguna
Bits de parada1
Control de flujoNinguno

Paso 4. Confirmar el prompt​

Pulsa Enter. La placa responde con su prompt:

cmd>

Escribe help para listar todos los comandos registrados.

cmd> help

Inicio rápido​

1. Listar los comandos​

cmd> help

2. Leer la batería​

cmd> battery_get
I (737306) bsp_battery: calibration scheme version is Curve Fitting
I (737306) bsp_battery: Calibration Success
I (737386) bsp_battery: VBAT channel=7 raw_max=0 sense=0 mV battery=0 mV
I (737516) bsp_battery: VBAT channel=7 raw_max=2362 sense=2068 mV battery=4136 mV
I (737516) SENSOR_TEST: Battery probe: BAT_ADC_EN=0 -> 0 mV, BAT_ADC_EN=1 -> 4136 mV
I (737516) SENSOR_TEST: Battery voltage: 4136 mV, estimated level: 92%

Informa del voltaje de la celda en milivoltios y de una estimación de carga. Sin batería instalada, la lectura sigue la alimentación USB.

3. Transmitir un paquete LoRa​

precaución

Coloca la antena Sub-GHz en SUB-1G antes de transmitir. Mantén la placa a un metro de otras antenas mientras esté en funcionamiento.

cmd> lora_tx -f 868000000 -d hello -n 1
I (922806) LR20XX: Power = 10 dB
I (922806) LR20XX: Frequency = 868000000 Hz
I (922806) LR20XX: SF = RAL_LORA_SF7
I (922806) LR20XX: BandWidth = RAL_LORA_BW_125_KHZ
I (922806) LR20XX: CodingRate = RAL_LORA_CR_4_5
I (922816) LR20XX: CRC = 1
I (922816) LR20XX: IQ = 0
I (922816) LR20XX: SyncWord = 0x34
I (922816) LR20XX: LDO = 0
I (922816) LR20XX: Interval = 0
I (922816) LR20XX: Num = 1
I (922816) LR20XX: half_power = 0
I (922816) LR20XX: duty_cycle = 0
I (922816) LR20XX: lf_slices = 0
I (922816) LR20XX: is_config_pa = 0
I (922816) LR20XX: tx len 5, payload: hello
I (922836) LR20XX: Starting LoRa TX #0
I (922876) LR20XX: LoRa tx done

I (923886) LR20XX: End of send!

4. Recibir paquetes Sub-GHz​

cmd> lora_rx -f 868000000 -s 7 -b 3               
I (47044) LR20XX: Frequency = 868000000 Hz
I (47044) LR20XX: SF = RAL_LORA_SF7
I (47044) LR20XX: BandWidth = RAL_LORA_BW_125_KHZ
I (47044) LR20XX: CodingRate = RAL_LORA_CR_4_5
I (47044) LR20XX: Header_type = RAL_LORA_PKT_EXPLICIT
I (47044) LR20XX: CRC = 1
I (47044) LR20XX: IQ = 0
I (47044) LR20XX: SyncWord = 0x34
I (47044) LR20XX: LDO = 0

W (82904) LR20XX: rx_done 0
W (82904) LR20XX: rx_hdr_err 0
W (82904) LR20XX: rx_crc_err 0

I (82904) LR20XX: End of receive!

Ejecuta el comando lora_rx -f 868000000 -s 7 -b 3 en la placa A, y lora_tx -f 868000000 -s 7 -b 3 -p 14 -d hello -n 10 en la placa B. El contador de A aumenta con cada paquete y B vuelve tras diez. Detén A con Ctrl+C para imprimir los totales. Un contador atascado en cero significa que las placas no coinciden en algún ajuste de radio, o falta una antena. Mantén -i en 200 o más, o el receptor registrará líneas hdr err.

Termina la prueba con Ctrl+C en ambas placas, para que ninguna permanezca en modo de recepción.

5. Estación Wi-Fi y ping​

cmd> sta_connect <ssid> <pass>
cmd> ping 192.168.1.1 -c 4

La unión se ha realizado correctamente cuando aparece una línea que contiene got ip:.

6. Cámara a través del hotspot​

cmd> camera_start
cmd> camera_http_start

Únete a wio-lr2021-camera con la contraseña 12345678 y abre http://192.168.4.1. Los fotogramas en vivo prueban la cámara y la pila Wi-Fi a la vez.

Termina la prueba con camera_http_stop y camera_stop, luego vuelve a unirte a tu red normal.

7. Dibujar un patrón en la pantalla​

cmd> oled_test -m text
I (2177034) bsp_oled_ssd13xx: OLED initialized (128x64, addr 0x3d)
I (2177064) OLED_TEST: OLED test pattern displayed: text
cmd> oled_test -m checker
I (2262024) OLED_TEST: OLED test pattern displayed: checker
cmd> oled_test -m clear
I (2316714) OLED_TEST: OLED test pattern displayed: clear

8. Grabar y reproducir audio​

audio_slot_record -d 5000
audio_slot_play

9. Identificar el chip de flash​

cmd> flash_info
I (2491984) FLASH_TEST: ==== SPI flash identification ====
I (2491984) FLASH_TEST: JEDEC ID : 0xEF4018
I (2491984) FLASH_TEST: Manufacturer : 0xEF (Winbond)
I (2491984) FLASH_TEST: Memory type : 0x40
I (2491984) FLASH_TEST: Capacity (ID) : 0x18 => 16777216 bytes (16.00 MB)
I (2491984) FLASH_TEST: Physical size : 16777216 bytes (16.00 MB)
I (2491984) FLASH_TEST: Configured size : 16777216 bytes (16.00 MB)
I (2491984) FLASH_TEST: Partition "flashtest" : addr=0x00C10000 size=1048576 (1.00 MB) subtype=0x06
I (2491984) FLASH_TEST: ==== Tail boundary authentication ====
I (2491994) FLASH_TEST: head sector off=0x00000000, tail sector off=0x000FF000
I (2492114) FLASH_TEST: head verify : PASS
I (2492124) FLASH_TEST: tail verify : PASS
I (2492124) FLASH_TEST: boundary auth: PASS

Comportamiento y límites​

ComportamientoComandosQué ocurreCómo salir
Recepción continualora_rx, flrc_rxCuenta paquetes, sin promptCtrl+C
Transmisión infinitalora_tx -n 0, flrc_tx -c 0Envía sin detenerseCtrl+C
Onda continualora_cw, lora_cw_paPortadora no modulada, sin payloadlora_cw_stop
Tarea en segundo planoflash_endurance -a startDevuelve de inmediato, sigue borrandoflash_endurance -a stop
Duración del hotspotap_set, camera_http_start, audio_slot_sendLa radio permanece activa hasta que se cierrewifi stop, camera_http_stop, audio_slot_stop
  • Un comando es el dueño de la consola: durante un bucle de recepción o transmisión el firmware ignora la entrada.
  • La salida es texto plano; activa el registro del terminal para tener un registro de la prueba.
  • Algunos terminales asignan Ctrl+C a copiar; confirma que el tuyo envía la interrupción.

Seguridad y conformidad​

1. Una antena por banda. El conector SMA y el pad U.FL de una banda comparten una red de RF a través de un enlace de 0 Ω. Montar ambas deja ninguna antena adaptada.

2. Nunca dejes una portadora funcionando. lora_cw y lora_cw_pa transmiten una portadora continua sin payload. Deténlas con lora_cw_stop antes de mover la placa.

3. Revisa tu plan de bandas. La salida Sub-GHz alcanza +22 dBm y 2.4 GHz alcanza +12 dBm. 868 MHz sirve a Europa, 902 ~ 928 MHz a las Américas. Confirma tus límites nacionales y usa una caja apantallada para las pruebas de certificación.

4. Batería y solar. Usa una celda Li-ion de 3.7 V en BAT-3.7V, respetando la polaridad serigrafiada. El cargador CN3165 entrega unos 495 mA y no tiene entrada de termistor, así que no cargues sin supervisión.

5. Credenciales por defecto. Los hotspots de cámara y audio se envían con la contraseña 12345678, y la página de la cámara no tiene inicio de sesión. Cambia la contraseña y cierra el hotspot en un banco compartido.

6. La resistencia de la flash desgasta el chip. flash_endurance borra sectores reales de la partición flashtest. Ejecútalo solo en unidades de muestra, nunca en una placa que aún necesites.

Recurso​

Soporte técnico y debate sobre el producto​

Gracias por elegir nuestros productos. Estamos aquí para ofrecerte distintos tipos de soporte y garantizar 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...