Saltar al contenido principal

Referencia de comandos del firmware de fábrica

Convenciones de símbolos​

SímboloSignificadoEjemplo
[ ]Parámetro opcional; se aplica el valor predeterminado cuando se omite[-p <port>]
< >Un valor concreto que debes proporcionar-g <gpio>
|Elige uno de los valores listados<0|1>
Palabras sin corchetesObligatorioping <host>
cmd>Prompt del firmware; no lo escribascmd> help

Los valores siempre se escriben como -flag value, por ejemplo gpio_set -g 4 -l 1. Cuando el firmware también registra una forma larga, la forma larga se muestra junto a la corta en la tabla de parámetros.

Índice de comandos​

CategoríaComandosQué verificaSección
General1Enlace serie y ayuda en el dispositivoGeneral
LoRa / RF7Transmisión, recepción, CW y FLRC en sub-GHz y 2,4 GHzLoRa / RF
BLE2Estado de advertising y estado de conexiónBLE
Wi-Fi y red14Modos STA y AP, escaneo, versión de protocolo, pingWi-Fi y red
Expansor de E/S8Niveles de pin, escaneo de bus y raíles conmutadosExpansor de E/S
Batería1Tensión de celda y estimación de cargaBatería
OLED3Patrones de visualización y estado del panelOLED
Cámara5Inicialización, estado y vista previa HTTPCámara
Audio7Grabar, reproducir y hacer streamingAudio
Flash3ID JEDEC, velocidad y resistenciaFlash

General​

1. help​

Enumera todos los comandos registrados con una descripción de una línea.

Este comando no acepta parámetros.

Ejemplo:

help

LoRa / RF​

Estos siete comandos controlan el transceptor LR2021 integrado mediante dos esquemas de modulación: LoRa para alcance y FLRC para velocidad. Cada comando de transmisión necesita una antena en el conector correspondiente: SUB-1G para frecuencias portadoras sub-GHz y LR-2.4G para la banda de 2400 ~ 2500 MHz. Una prueba de enlace entre dos placas necesita parámetros de radio idénticos en ambos lados.

Nota: lora_rx, flrc_rx, lora_tx -n 0 y flrc_tx -c 0 se ejecutan hasta que pulses Ctrl+C.

1. lora_tx​

lora_tx [-f <freq_hz>] [-s <5-12>] [-b <0-9>] [-c <1-7>] [-p <dbm>] [--crc <0|1>] [--hdr <0|1>] [--iq <0|1>] [--net <0|1>] [-i <interval_ms>] [-d <text>] [-n <count>] [-hp <n>] [-dc <n>] [-lf <n>]

Envía paquetes LoRa con la frecuencia, factor de dispersión y potencia configurados.

ElementoDescripciónDatos
-f <freq_hz>Frecuencia de transmisión150000000 ~ 2500000000 Hz; predeterminado: 868000000
-s <5-12>Factor de dispersión5 ~ 12; valores más altos son más lentos y alcanzan más lejos; predeterminado: 7
-b <0-9>Índice de ancho de banda0=31k, 1=41k, 2=62k, 3=125k (predeterminado), 4=200k, 5=250k, 6=400k, 7=500k, 8=800k, 9=1000k
-c <1-7>Tasa de codificación1 ~ 7; 1=4/5 es la más rápida, 4=4/8 la más robusta; predeterminado: 1
-p <dbm>Potencia de transmisiónSub-GHz -10 ~ +22 dBm, 2,4 GHz -17 ~ +12 dBm; predeterminado: 10
--crc <0|1>Comprobación CRC0=apagado, 1=encendido; predeterminado: 1
--hdr <0|1>Tipo de cabecera0=implícita, 1=explícita; predeterminado: 1
--iq <0|1>Modo IQ0=estándar, 1=invertido; predeterminado: 0
--net <0|1>Tipo de red y palabra de sincronización0=privada (palabra de sincronización 0x12), 1=pública (palabra de sincronización 0x34); predeterminado: 1
-i <interval_ms>Intervalo entre paquetesMilisegundos; predeterminado: 200; 0=espalda con espalda
-d <text>Texto de la carga útilPredeterminado: hello
-n <count>Número de paquetes0=enviar hasta Ctrl+C; predeterminado: 10
-hp <n>Registro de media potencia del PASolo depuración; déjalo sin establecer en uso normal
-dc <n>Registro de ciclo de trabajo del PASolo depuración; déjalo sin establecer en uso normal
-lf <n>Registro de porción de baja frecuencia del PASolo depuración; déjalo sin establecer en uso normal

Ejemplo:

lora_tx -f 868000000 -s 7 -b 3 -p 14 -d hello -n 10
nota

Coloca primero la antena y arranca lora_rx con los mismos valores de -f, -s, -b, -c, --hdr, --crc, --iq y --net en la segunda placa. Un valor fuera de rango muestra una advertencia out of bounds y el comando vuelve a un valor de reserva: -f a la frecuencia predeterminada, -s a 7, -b a 3, -c a 1; -p se limita al máximo de la banda. Un -f no numérico, o un -i o -n negativos, abortan el comando y no envían nada.

2. lora_rx​

lora_rx [-f <freq_hz>] [-s <5-12>] [-b <0-9>] [-c <1-7>] [--crc <0|1>] [--hdr <0|1>] [--plen <0-255>] [--iq <0|1>] [--net <0|1>]

Recibe paquetes LoRa de forma continua y los cuenta.

ElementoDescripciónDatos
-f <freq_hz>Frecuencia de recepción150000000 ~ 2500000000 Hz; predeterminado: 868000000
-s <5-12>Factor de dispersión5 ~ 12; predeterminado: 7
-b <0-9>Índice de ancho de banda0=31k, 3=125k (predeterminado), 9=1000k
-c <1-7>Tasa de codificación1 ~ 7; predeterminado: 1
--crc <0|1>Comprobación CRC0=apagado, 1=encendido; predeterminado: 1
--hdr <0|1>Tipo de cabecera0=implícita, 1=explícita; predeterminado: 1
--plen <0-255>Longitud de carga útil que espera el receptorBytes; 0=cualquier longitud en modo explícito, el modo implícito asume 5 cuando se omite; predeterminado: 0
--iq <0|1>Modo IQ0=estándar, 1=invertido; predeterminado: 0
--net <0|1>Tipo de red y palabra de sincronización0=privada (0x12), 1=pública (0x34); predeterminado: 1

Ejemplo:

lora_rx -f 868000000 -s 7 -b 3
nota

El comando bloquea la consola hasta Ctrl+C, que muestra rx_done, rx_hdr_err y rx_crc_err. Ambas placas deben usar el mismo valor de --hdr; implícito en un lado y explícito en el otro nunca recibe. En modo implícito establece --plen a la longitud de carga útil del transmisor: un valor más largo añade basura al final y uno más corto la recorta. El modo implícito con --crc 1 produjo fallos de CRC en las pruebas, así que combina --hdr 0 con --crc 0. Largas series de hdr err a corta distancia significan que los paquetes llegan espalda con espalda; sube el -i del transmisor a 100 ~ 200 y mantenlo más largo que el tiempo en aire de un paquete.

3. lora_cw​

lora_cw [-f <freq_hz>] [-p <dbm>]

Transmite una onda continua no modulada para mediciones de potencia RF.

ElementoDescripciónDatos
-f <freq_hz>Frecuencia portadora150000000 ~ 2500000000 Hz; predeterminado: 868000000; un valor fuera de rango o no numérico aborta el comando
-p <dbm>Potencia de transmisiónSub-GHz -10 ~ +22 dBm, 2,4 GHz -17 ~ +12 dBm; predeterminado: 10; limitado al máximo de la banda

Ejemplo:

lora_cw -f 868000000 -p 10
nota

La portadora se mantiene hasta que se introduce lora_cw_stop. Para cambiar la potencia o la frecuencia a mitad de la prueba, ejecuta lora_cw de nuevo con el nuevo valor; la configuración se reinicia por sí sola.

4. lora_cw_pa​

lora_cw_pa [-f <freq_hz>] [-p <dbm>] [-h <n>] [-d <0-31>] [-l <0-15>]

Transmite una onda continua con control directo de los registros del PA.

ElementoDescripciónDatos
-f <freq_hz>Frecuencia portadora150000000 ~ 2500000000 Hz; predeterminado: 868000000
-p <dbm>Potencia de transmisiónSub-GHz -10 ~ +22 dBm, 2,4 GHz -17 ~ +12 dBm; predeterminado: 10
-h <n>Valor de media potencia del PAPasos de 0,5 dB; sub-GHz -19 ~ 44, 2,4 GHz -39 ~ 24
-d <0-31>Ciclo de trabajo del PA0 ~ 31
-l <0-15>Porciones de baja frecuencia del PA0 ~ 15

Ejemplo:

lora_cw_pa -f 868000000 -h 22 -d 0 -l 0
nota

Proporcionar cualquiera de -h, -d o -l cambia el comando al modo de parámetros directos y anula la tabla de potencias. Los valores fuera de rango se limitan al máximo de la banda con una advertencia out of bounds. Detén la portadora con lora_cw_stop.

5. lora_cw_stop​

lora_cw_stop

Detiene una onda continua iniciada por lora_cw o lora_cw_pa.

Este comando no acepta parámetros.

Ejemplo:

lora_cw_stop

6. flrc_tx​

flrc_tx [-f <freq_hz>] [-p <dbm>] [-b <0-7>] [-l <1-255>] [-c <count>]

Envía paquetes FLRC con una carga útil incremental, un paquete por segundo.

ElementoDescripciónDatos
-f <freq_hz>Frecuencia de transmisión415000000 ~ 940000000 Hz; predeterminado: 915000000; fuera de rango vuelve al valor predeterminado
-p <dbm>Potencia de transmisión-10 ~ +22 dBm; predeterminado: 22; limitado al máximo
-b <0-7>Combinación de tasa y ancho de banda0=2,6 Mbps (más rápida) hasta 7=0,26 Mbps; predeterminado: 0; fuera de rango vuelve a 7
-l <1-255>Longitud del paqueteBytes; predeterminado: 200; fuera de rango vuelve al valor predeterminado
-c <count>Número de paquetesPredeterminado: 100; 0=enviar hasta Ctrl+C; los valores por encima de 500 se limitan a 500

Ejemplo:

flrc_tx -f 868000000 -p 14 -l 200 -c 100
nota

Sale un paquete cada segundo, así que una ejecución de un minuto envía unos sesenta paquetes. Establece -c 0 para transmitir sin parada hasta Ctrl+C.

7. flrc_rx​

flrc_rx [-f <freq_hz>] [-b <0-7>]

Recibe paquetes FLRC y cuenta los paquetes correctos, errores de cabecera y errores de CRC.

ElementoDescripciónDatos
-f <freq_hz>Frecuencia de recepción415000000 ~ 940000000 Hz; predeterminado: 915000000; fuera de rango vuelve al valor predeterminado
-b <0-7>Combinación de tasa y ancho de banda0 ~ 7; predeterminado: 0; fuera de rango vuelve a 7

Ejemplo:

flrc_rx -f 868000000 -b 0
nota

Ctrl+C detiene el receptor y muestra los contadores.

BLE​

Bluetooth no se inicia al arrancar. El primer ble -a 1 inicializa la pila BLE y comienza a hacer advertising; ble -a 0 detiene el advertising y descarga la pila para liberar su memoria. El nombre del dispositivo comienza con wio-lr2021- y el anuncio acepta conexiones.

1. ble​

ble -a <0|1>

Activa o desactiva el advertising de Bluetooth.

ElementoDescripciónDatos
-a <0|1>Interruptor de advertising1=iniciar advertising (inicializa la pila en el primer uso), 0=detener advertising y liberar la pila; obligatorio

Ejemplo:

ble -a 1
nota

Busca wio-lr2021- desde un teléfono con nRF Connect; el dispositivo está en buen estado cuando aparece en la lista. Después de conectarte, la app puede enviar comandos al dispositivo y leer las líneas de registro que imprime.

2. ble_status​

ble_status

Imprime el nombre del dispositivo, la dirección MAC, la potencia de transmisión, los parámetros de advertising y el estado de la conexión.

Este comando no acepta parámetros.

Ejemplo:

ble_status
nota

Si Bluetooth no se ha inicializado, el comando te pide que ejecutes primero ble -a 1.

Wi-Fi y red​

Wi-Fi se inicializa y se inicia automáticamente al arrancar, por lo que ninguno de estos comandos necesita un wifi init manual. La mayoría envuelven el componente de pruebas de Wi-Fi de Espressif y tienen muchas opciones; las tablas de parámetros siguientes enumeran las documentadas. Unirse a un router requiere tu propio punto de acceso de 2,4 GHz y su contraseña.

1. wifi​

wifi <status|stop|start|restart|init|deinit>

Consultar el estado de Wi-Fi o iniciar, detener y reinicializar la radio.

ElementoDescripciónDatos
statusMuestra el estado de inicialización e información de conexiónConsulta más común
stop, startDetiene o inicia la radio, el driver se mantienePruebas de potencia y eliminación de interferencias
restartReinicio completo: stop, deinit, init, startRecuperación después de deinit
init, deinitInicializa o descarga el driverSolo depuración de I+D

Ejemplo:

wifi status
nota

Ejecutar wifi init en un sistema ya inicializado se omite con una única advertencia WiFi already initialise.. wifi deinit detiene primero la radio cuando aún está en funcionamiento, y wifi status imprime initialized y started por separado.

2. wifi_count​

wifi_count [query|clear]

Imprime o reinicia los contadores de paquetes transmitidos y recibidos por Wi-Fi.

ElementoDescripciónDatos
queryImprime los contadoresPredeterminado cuando no se da ningún argumento
clearReinicia ambos contadores a cero—

Ejemplo:

wifi_count

3. wifi_mode​

wifi_mode <sta|ap|apsta>

Establece el rol Wi-Fi del dispositivo.

ElementoDescripciónDatos
staSe une a otro hotspot, como un teléfono—
apActúa como hotspot—
apstaAmbos roles a la vez—

Ejemplo:

wifi_mode sta

4. wifi_protocol​

wifi_protocol [protocol] [-i <ap|sta>]

Consulta o establece la combinación de protocolos 802.11.

ElementoDescripciónDatos
<protocol>Combinación de protocolosb, b/g, b/g/n; predeterminado: consulta el valor actual
-i <ap|sta>Interfaz a la que aplicar el ajusteap o sta; predeterminado: sta

Ejemplo:

wifi_protocol b/g/n

5. wifi_bandwidth​

wifi_bandwidth [20|40] [-i <ap|sta>]

Consulta o establece el ancho de banda del canal.

ElementoDescripciónDatos
<20|40>Ancho de banda del canal en MHz20 o 40; predeterminado: consulta el valor actual
-i <ap|sta>Interfaz a la que aplicar el ajusteap o sta; predeterminado: sta

Ejemplo:

wifi_bandwidth 20

6. wifi_ps​

wifi_ps <0|1|2>

Establece el nivel de ahorro de energía de Wi-Fi.

ElementoDescripciónDatos
0Sin ahorro de energía, máximo rendimientoRequerido
1Ahorro moderado—
2Ahorro máximo—

Ejemplo:

wifi_ps 0

7. wifi_country​

wifi_country [code] [-s <start_channel>] [-n <channel_count>] [-p <auto|manual>]

Consulta o establece el código de país y el rango de canales utilizables.

ElementoDescripciónDatos
<code>Código de país de dos letrasPor ejemplo US; predeterminado: consulta el valor actual
-s <start_channel>Primer canal del rango permitidoNúmero de canal; predeterminado: no establecido
-n <channel_count>Número de canales en el rangoCantidad; predeterminado: no establecido
-p <auto|manual>Selección del plan de canalesauto o manual; predeterminado: no establecido

Ejemplo:

wifi_country US

8. ap_set​

ap_set <ssid> [pass] [-a <authmode>] [-n <channel>] [-m <max_conn>]

Convierte el dispositivo en un hotspot Wi-Fi para que un teléfono o PC pueda unirse a él.

ElementoDescripciónDatos
<ssid>Nombre del hotspotRequerido
<pass>Contraseña del hotspotAl menos 8 caracteres; opcional
-a <authmode>Modo de seguridadopen, wep, wpa2; un nombre no reconocido se informa y el hotspot vuelve a open; predeterminado: no establecido
-n <channel>Canal del hotspotNúmero de canal; predeterminado: no establecido
-m <max_conn>Máximo de clientes simultáneosPredeterminado: 2

Ejemplo:

ap_set MyTestAP 12345678

Alias: ap (igual que ap_set).

nota

Cambia la contraseña antes de dejar el hotspot activo en una red compartida, y deténlo cuando termine la prueba.

9. ap_query​

ap_query

Muestra la configuración actual del hotspot y cuántos clientes están conectados.

Este comando no acepta parámetros.

Ejemplo:

ap_query

10. sta_connect​

sta_connect <ssid> <pass> [-n <channel>]

Se une, como estación, a un hotspot Wi-Fi que tú proporcionas.

ElementoDescripciónDatos
<ssid>Nombre del hotspotRequerido
<pass>Contraseña del hotspotRequerido
-n <channel>Canal al que unirseOpcional; un canal conocido acelera la conexión

Ejemplo:

sta_connect MyHomeWiFi 12345678

Salida esperada:

got ip:192.168.<x>.<y>

La dirección IP cambia con cada red; el criterio de éxito es la línea got ip:, que aparece entre las líneas de registro de la conexión.

Alias: sta (igual que sta_connect).

nota

Wi-Fi debe estar inicializado y en marcha, que es el estado al arrancar. Después de wifi stop o wifi deinit, el comando se rechaza con una sugerencia de ejecutar primero wifi restart. Ejecuta sta_disconnect antes de unirte a una red diferente.

11. sta_disconnect​

sta_disconnect

Se desconecta de la red actual y detiene la reconexión automática.

Este comando no acepta parámetros.

Ejemplo:

sta_disconnect

Alias: disconnect (igual que sta_disconnect).

12. sta_scan​

sta_scan [<ssid>] [-n <channel>] [-h]

Escanea los hotspots cercanos e imprime nombre, intensidad de señal y canal.

ElementoDescripciónDatos
<ssid>Muestra solo el hotspot con este nombreFiltro opcional
-n <channel>Escanea un único canalNúmero de canal; opcional
-hIncluye redes ocultas; la forma larga --show-hidden hace lo mismoSin valor

Ejemplo:

sta_scan

Alias: wifi_scan y scan (igual que sta_scan).

nota

Un escaneo es la comprobación más rápida de la antena Wi-Fi y de la ruta de recepción: una lista vacía significa que la radio no está recibiendo.

13. wifi_txpower​

wifi_txpower [-u <value>] [--reset]

Lee o establece la potencia de transmisión de Wi-Fi.

ElementoDescripciónDatos
-u <value>Potencia de transmisión en unidades de 0,25 dBmPor ejemplo 80 = 20 dBm; predeterminado: lee el valor actual
--resetRestaura la potencia predeterminadaSin valor

Ejemplo:

wifi_txpower -u 68

14. ping​

ping <host> [-c <count>] [-i <interval_s>] [-s <bytes>] [-W <timeout_s>] [--abort]

Envía solicitudes de eco ICMP a un host e informa de la latencia.

ElementoDescripciónDatos
<host>Dirección IP o dominio de destinoRequerido
-c <count>Número de solicitudes de ecoPredeterminado: 5
-i <interval_s>Segundos entre solicitudesPredeterminado: 1
-s <bytes>Tamaño de la carga útil por solicitudPredeterminado: 64
-W <timeout_s>Tiempo de espera de la respuesta en segundosPredeterminado: no establecido
--abortDetiene un ping en ejecuciónSin valor

Ejemplo:

ping 192.168.1.1 -c 4 -i 1
nota

Wi-Fi se inicializa al arrancar; ejecuta primero sta_connect para que el dispositivo tenga una dirección y una ruta.

Expansor de E/S​

Los números de GPIO son números de GPIO del ESP32-S3; las funciones de los pines se enumeran en el Mapa de pines del Wio-LR2021 Dev Kit. El expansor de E/S es el PCA9535 en la dirección I²C 0x21. Expone 16 pines numerados del 0 al 15; cuatro de ellos conmutan los raíles de la cámara, audio, OLED y Grove.

nota

Un pin que ningún periférico reclama permanece como entrada flotante tras el encendido (resistencias de pull desactivadas), por lo que un gpio_get en bruto lee ruido. Ejecuta primero gpio_config: -m 0 para entrada con una resistencia de pull opcional, -m 1 para salida push-pull, -m 2 para salida de drenador abierto.

1. gpio_set​

gpio_set -g <gpio> -l <0|1>

Fuerza un GPIO a nivel alto o bajo.

ElementoDescripciónDatos
-g <gpio>Número de GPIORequerido
-l <0|1>Nivel de salida1=alto (unos 3,3 V), 0=bajo (0 V); requerido

Ejemplo:

gpio_set -g 4 -l 1
nota

Configura la dirección con gpio_config -m 1 antes de forzar el pin, y verifica el nivel con un multímetro o un cable de bucle de retorno hacia otro GPIO.

2. gpio_get​

gpio_get -g <gpio>

Lee el nivel actual de un GPIO.

ElementoDescripciónDatos
-g <gpio>Número de GPIORequerido

Ejemplo:

gpio_get -g 4

3. gpio_config​

gpio_config -g <gpio> -m <0|1|2> [-p <0|1|2|3>]

Establece la dirección y las resistencias de pull de un GPIO.

ElementoDescripciónDatos
-g <gpio>Número de GPIORequerido
-m <0|1|2>Dirección0=entrada, 1=salida, 2=salida de drenador abierto; requerido
-p <0|1|2|3>Resistencias de pull0=flotante (predeterminado), 1=pull-up, 2=pull-down, 3=ambas activadas

Ejemplo:

gpio_config -g 5 -m 0 -p 1

4. i2c_scan​

i2c_scan [-b <0|1>]

Escanea uno o ambos buses I²C y lista las direcciones que responden.

ElementoDescripciónDatos
-b <0|1>Número de bus a escanear0 o 1; predeterminado: escanea ambos

Ejemplo:

i2c_scan -b 0
nota

En una placa en buen estado, el bus 0 muestra el PCA9535 en 0x21 y, una vez que el raíl de la pantalla está encendido, el OLED en 0x3D. Una dirección ausente significa que el chip no está soldado, no está alimentado o no responde.

5. io_exp_set​

io_exp_set -i <0-15> -l <0|1>

Lleva un pin del expansor de E/S a nivel alto o bajo.

ElementoDescripciónDatos
-i <0-15>Número de pin del expansor0 ~ 15; obligatorio
-l <0|1>Nivel de salida1=alto, 0=bajo; obligatorio

Ejemplo:

io_exp_set -i 3 -l 1
nota

Los pines 0 ~ 3 conmutan los raíles de periféricos; accionarlos cambia el estado de alimentación de la cámara, el audio, la OLED y los conectores Grove.

6. io_exp_get​

io_exp_get -i <0-15>

Lee un pin del expansor de E/S.

ElementoDescripciónDatos
-i <0-15>Número de pin del expansor0 ~ 15; obligatorio

Ejemplo:

io_exp_get -i 3

7. io_exp_config​

io_exp_config -i <0-15> -m <0|1>

Configura un pin del expansor de E/S como entrada o salida.

ElementoDescripciónDatos
-i <0-15>Número de pin del expansor0 ~ 15; obligatorio
-m <0|1>Dirección0=entrada, 1=salida; obligatorio

Ejemplo:

io_exp_config -i 3 -m 1

8. io_exp_print​

io_exp_print

Imprime la dirección y el nivel de los 16 pines del expansor en una tabla.

Este comando no acepta parámetros.

Ejemplo:

io_exp_print

Batería​

1. battery_get​

battery_get

Lee el voltaje de la celda en milivoltios y estima el estado de carga.

Este comando no acepta parámetros.

Ejemplo:

battery_get
nota

Se debe conectar una celda al conector BAT-3.7V para obtener una lectura significativa; el cargador informa de su propio estado en los pines 11 y 12 del expansor.

OLED​

El primer comando OLED de una sesión alimenta el raíl de la pantalla e inicializa el panel, por lo que no se necesita un paso de preparación separado. El panel es de 128 × 64 píxeles y está en el bus I²C interno en 0x3D.

1. oled_test​

oled_test -m <mode>

Dibuja un patrón de prueba en el panel OLED.

ElementoDescripciónDatos
-m <mode>Patrón a dibujarclear=todos los píxeles apagados
solid=todos los píxeles encendidos
checker=damero
stripes=rayas verticales
border=fondo negro con un borde
text=texto de estado como OLED OK y la resolución
scan=líneas de escaneo; obligatorio

Ejemplo:

oled_test -m text
nota

-m text es la comprobación de aprobado/suspenso más rápida del panel: el patrón de texto lo dibuja el mismo controlador que dibuja cualquier otro patrón.

2. oled_line_demo​

oled_line_demo -m <checker|scan>

Refresca el panel segmento por segmento mediante un pequeño búfer de línea.

ElementoDescripciónDatos
-m <checker|scan>Patrón a refrescarchecker=damero, scan=líneas de escaneo; obligatorio

Ejemplo:

oled_line_demo -m checker

3. oled_cycle​

oled_cycle [-d <dwell_ms>]

Reproduce seis patrones de prueba en secuencia y termina por sí solo.

ElementoDescripciónDatos
-d <dwell_ms>Tiempo que cada patrón permanece en pantallaMilisegundos; por defecto: 800

Ejemplo:

oled_cycle -d 1500
nota

La secuencia es clear, border, text, checkerboard, stripes y scan lines. Un solo ciclo cubre todo el panel, por lo que la línea de producción lo usa para la inspección visual.

Cámara​

La cámara es la GC2145 de 2 MP en el Media HAT; el firmware de fábrica la lee como RGB565 y transmite fotogramas JPEG. camera_http_start es la comprobación de extremo a extremo más corta porque levanta el hotspot, la cámara y el servidor web con un solo comando.

1. camera_start​

camera_start [-q <1-100>] [-r <qqvga|qvga|vga>] [-F <hz>]

Enciende e inicializa la cámara.

ElementoDescripciónDatos
-q <1-100>Calidad de compresión JPEG1 ~ 100; por defecto: 80
-r <qqvga|qvga|vga>Resolución de capturaqqvga=160×120, qvga=320×240 (por defecto), vga=640×480
-F <hz>Reloj del bus de control de la cámara (I²C)Hz; por defecto: 100000

Ejemplo:

camera_start -r vga
nota

Ejecutar camera_start de nuevo con un -r o -F diferente reinicia la cámara y cambia el ajuste. Los primeros fotogramas tras el arranque se descartan como calentamiento. El comando también es la forma más rápida de confirmar que la cámara se inicializa.

2. camera_stop​

camera_stop

Detiene la cámara y la apaga.

Este comando no acepta parámetros.

Ejemplo:

camera_stop

3. camera_http_start​

camera_http_start [-s <ssid>] [-p <pwd>] [-c <1-13>] [-q <1-100>] [-f <1-30>] [-P <port>] [-r <qqvga|qvga|vga>] [-F <hz>]

Inicia el hotspot, la cámara y la previsualización web MJPEG con un solo comando.

ElementoDescripciónDatos
-s <ssid>Nombre del hotspotPor defecto: wio-lr2021-camera
-p <pwd>Contraseña del hotspot8 ~ 63 caracteres, vacío para una red abierta; por defecto: 12345678
-c <1-13>Canal del hotspot1 ~ 13; por defecto: 1
-q <1-100>Calidad JPEGMás alto es más nítido y usa más ancho de banda; por defecto: 80
-f <1-30>Límite de frecuencia de fotogramasFotogramas por segundo; por defecto: 20
-P <port>Puerto del servidor webEl flujo de vídeo usa este puerto más uno; cambiarlo mientras se está ejecutando reinicia el servicio web, y un valor fuera de rango avisa y vuelve al valor anterior; por defecto: 80
-r <qqvga|qvga|vga>Resolución del flujoPor defecto: qvga
-F <hz>Reloj del bus de control de la cámara (I²C)Hz; por defecto: 100000

Ejemplo:

camera_http_start -q 60 -f 10
nota

Después de cambiar -s, -p o -c y ejecutar el comando de nuevo, desconecta y vuelve a conectar el teléfono o el PC del hotspot. De lo contrario, el cliente seguirá mostrando una conexión mientras la placa no es accesible.

Uso: conéctate al hotspot wio-lr2021-camera con la contraseña 12345678, luego abre http://192.168.4.1 en un navegador. Una imagen en vivo significa que la cámara y la ruta Wi‑Fi funcionan.

nota

La página web no tiene autenticación. Mantén el hotspot fuera de cualquier red compartida o de oficina, y ciérralo con camera_http_stop.

4. camera_http_stop​

camera_http_stop

Detiene el servidor web y apaga la cámara y el hotspot.

Este comando no acepta parámetros.

Ejemplo:

camera_http_stop

5. camera_status​

camera_status

Imprime el estado de la cámara, el hotspot y el servidor web, la resolución y la calidad.

Este comando no acepta parámetros.

Ejemplo:

camera_status

Audio​

Una ranura de audio es un búfer de grabación en RAM, por lo que no se necesita tarjeta SD: graba en la ranura, luego reprodúcela o transmítela a un PC a través del hotspot del dispositivo.

1. audio_init​

audio_init

Enciende el circuito de audio e inicializa el códec y el micrófono.

Este comando no acepta parámetros.

Ejemplo:

audio_init
nota

El firmware ejecuta esto una vez al arrancar; úsalo para recuperarte después de audio_deinit.

2. audio_deinit​

audio_deinit

Apaga el circuito de audio.

Este comando no acepta parámetros.

Ejemplo:

audio_deinit
nota

La grabación y la reproducción permanecen no disponibles hasta que audio_init se ejecute de nuevo. Úsalo para mediciones de consumo de energía. Si el audio nunca se inicializó desde el arranque, el comando se rechaza, por lo que un segundo audio_deinit seguido no hace nada.

3. audio_slot_record​

audio_slot_record [-d <100-60000>] [-m <20.0-37.5>]

Graba desde el micrófono en la ranura de audio.

ElementoDescripciónDatos
-d <100-60000>Duración de la grabaciónMilisegundos; 100 ~ 60000; por defecto: 10000
-m <20.0-37.5>Ganancia del micrófonodB; 20.0 ~ 37.5; por defecto: 37.5 (máxima)

Ejemplo:

audio_slot_record -d 5000 -m 30
nota

La ranura contiene datos de micrófono en bruto sin procesamiento por software. Habla cerca del micrófono durante la grabación. El audio se inicializa al arrancar; después de audio_deinit, ejecuta primero audio_init o el comando será rechazado.

4. audio_slot_play​

audio_slot_play [-v <0-100>]

Reproduce la ranura grabada a través del altavoz.

ElementoDescripciónDatos
-v <0-100>Volumen de reproducción0 ~ 100; por defecto: mantener el volumen actual

Ejemplo:

audio_slot_play -v 80
nota

Conecta un altavoz al conector SPK del Media HAT. El comando reproduce lo que la ranura contenga en ese momento, así que graba primero; se rechaza cuando el audio no está inicializado o la ranura está vacía.

5. audio_slot_send​

audio_slot_send [-p <port>]

Transmite la ranura a un PC como un archivo WAV a través del hotspot del dispositivo.

ElementoDescripciónDatos
-p <port>Puerto TCP al que se conecta el PCPor defecto: 3444

Ejemplo:

audio_slot_send

Uso: conéctate desde el PC al hotspot wio-lr2021-audio (contraseña 12345678), luego ejecuta python tools/recv_wav_from_device.py -o slot.wav. El script se conecta a 192.168.4.1:3444, lee una cabecera de 8 bytes (magia AUDF más la longitud del audio) y luego los bytes de audio; el archivo se puede reproducir tan pronto como se escribe.

nota

El comando devuelve inmediatamente y la transferencia se ejecuta en segundo plano. El hotspot no se cierra cuando termina la transferencia, por lo que se pueden enviar varias grabaciones seguidas; deténlo con audio_slot_stop.

6. audio_slot_stop​

audio_slot_stop

Detiene cualquier transferencia en curso y cierra el hotspot de audio.

Este comando no acepta parámetros.

Ejemplo:

audio_slot_stop
nota

Es seguro ejecutarlo sin que haya una transferencia en curso; el único efecto es cerrar el hotspot.

7. audio_slot_info​

audio_slot_info

Imprime el estado de la ranura: si existe una grabación, su longitud, frecuencia de muestreo, canales, duración y memoria libre.

Este comando no acepta parámetros.

Ejemplo:

audio_slot_info

Flash​

Las pruebas de resistencia y velocidad de la flash solo funcionan dentro de la partición dedicada flashtest, por lo que la imagen de firmware y los datos de usuario nunca se tocan. flash_endurance se ejecuta como una tarea en segundo plano y sigue escribiendo mientras la consola permanece utilizable.

1. flash_info​

flash_info

Lee el ID JEDEC de la flash, el proveedor y la capacidad y verifica el inicio y el final de la partición de prueba.

Este comando no acepta parámetros.

Ejemplo:

flash_info
nota

El código de retorno 0 significa aprobado; la comprobación de escritura en el límite detecta un chip flash con una capacidad sobrestimada.

2. flash_endurance​

flash_endurance -a <start|stop|status> [-m <minutes>] [-s <sectors>] [-d <ms>]

Ejecuta una prueba intensiva de borrado, escritura y lectura en la partición de prueba de la memoria flash.

ElementoDescripciónDatos
-a <start|stop|status>Acciónstart, stop o status; obligatorio
-m <minutes>Duración de la ejecuciónMinutos; 0 se ejecuta hasta que se detenga; valor predeterminado: 1440
-s <sectors>Sectores escritos por ronda0=toda la partición de prueba; valor predeterminado: 0
-d <ms>Retardo entre sectoresMilisegundos; 0=máxima velocidad; valor predeterminado: 0

Ejemplo:

flash_endurance -a start -m 60
nota

El comando devuelve inmediatamente y la prueba intensiva se ejecuta en segundo plano; comprueba el progreso con -a status y termínala con -a stop. Cada ronda desgasta la memoria flash, así que ejecútala en muestras en lugar de en todas las placas.

3. flash_speed​

flash_speed [-t <kb>]

Mide el tiempo de programación de página, el tiempo de borrado de sector y el rendimiento de lectura/escritura.

ElementoDescripciónDatos
-t <kb>Cantidad de datos usada para la prueba de rendimientoKB; valor predeterminado: 64

Ejemplo:

flash_speed -t 128
nota

El código de retorno 0 significa que cada medición está dentro de los límites de la hoja de datos.

Alias​

Se registran cinco alias de compatibilidad. Llaman exactamente a la misma función que el comando principal; usa el nombre principal en scripts y documentación.

AliasComando principalNota
apap_setMisma función; se prefiere el nombre principal.
stasta_connectMisma función; se prefiere el nombre principal.
disconnectsta_disconnectMisma función; se prefiere el nombre principal.
wifi_scansta_scanMisma función; se prefiere el nombre principal.
scansta_scanMisma función; se prefiere el nombre principal.

Cadenas de resultado y códigos de retorno​

El firmware informa de los resultados como líneas de texto plano en el puerto serie y luego vuelve al prompt cmd>. Los marcadores siguientes son los documentados para el firmware V2.1.0; el inventario completo de prefijos de registro está pendiente de una captura serie en hardware.

MarcadorDónde apareceSignificado
cmd>Cada comandoPrompt; el firmware está listo para el siguiente comando
got ip:sta_connectLa estación obtuvo una dirección; la conexión se realizó correctamente
Código de retorno 0flash_info, flash_speedTodas las comprobaciones pasaron; cualquier otro código es un fallo
AUDFCabecera de recepción de audio_slot_sendValor mágico al inicio de la cabecera de 8 bytes, seguido de la longitud del audio
Alias ofListado de helpLa entrada es un alias de compatibilidad, no un comando independiente
out of boundsAdvertencias de parámetrosEl valor fue limitado o reemplazado; el comando sigue ejecutándose
rx_done / rx_hdr_err / rx_crc_errSalida de lora_rxContadores de recepción impresos después de Ctrl+C
WiFi already initialise.wifi initEl controlador ya estaba inicializado, por lo que la llamada se omite

Un valor que no se puede analizar aborta el comando e imprime una línea de error en inglés; un valor fuera de rango normalmente registra out of bounds y vuelve a un valor predeterminado documentado. La redacción difiere según el comando, así que corrige el valor marcado y ejecuta el comando de nuevo en lugar de hacer coincidencias sobre la frase.

Soporte técnico y debate sobre el producto​

Gracias por elegir nuestros productos. Estamos aquí para ofrecerte diferentes 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...