Pular para o conteúdo principal

Guia do Usuário do Firmware de Fábrica do Wio-LR2021 Dev Kit

Todo Wio-LR2021 Dev Kit é enviado com um firmware de teste que expõe os rádios, sensores, display, câmera, caminho de áudio e flash da placa por meio de um único console serial. Este guia leva você desde o primeiro acionamento até uma verificação funcional completa e descreve como é um resultado aprovado em cada etapa.

nota

O firmware na sua placa é a autoridade para esta página. Digite help para listar os comandos que a build realmente registrou; se um comando aqui estiver ausente, sua placa está executando uma versão diferente.

O que os comandos do firmware fornecem​

  • Links Sub-GHz e 2,4 GHz: lora_tx com lora_rx em duas placas; a contagem do receptor aumenta.
  • Modos de modulação: gfsk_tx, flrc_rx, lr_fhss_tx; pacotes válidos e erros de CRC contados.
  • Potência de RF: lora_cw; um medidor mostra a portadora.
  • BLE — ble -a 1; um scanner lista wio-lr2021-*.
  • Wi-Fi e IP: sta_connect, ap_set, ping; got ip: e contagens de respostas.
  • GPIO, I²C e trilhos de alimentação: gpio_get, i2c_scan, io_exp_print; 0x21 e 0x3D respondem.
  • Bateria: battery_get; milivolts e uma estimativa de carga.
  • Display, câmera, áudio: oled_test, camera_capture, audio_slot_play; padrão, PASS, reprodução.
  • Flash: flash_info, flash_speed; código de retorno 0 significa aprovado.

Preparação​

Etapa 1. Instale as antenas e conecte a placa​

Rosqueie a antena Sub-GHz em SUB-1G e a antena de 2,4 GHz em LR-2.4G. Conecte o USB-C com um cabo de dados — um cabo apenas de carga alimenta a placa, mas não fornece porta serial.

cuidado

Nunca transmita sem uma antena. O PA fornece até +22 dBm em Sub-GHz e +12 dBm em 2,4 GHz em uma carga desadaptada, o que pode danificar o LR2021.

Etapa 2. Encontre a porta serial​

Abra o Device Manager e expanda Ports (COM & LPT). A placa aparece como USB Serial Device com uma porta como COM5.

Etapa 3. Abra um terminal​

FerramentaPlataformaOnde obtê-la
PuTTYWindowsputty.org
screenmacOS / LinuxIntegrado; execute screen /dev/cu.usbmodem* 115200
MinicommacOS / LinuxInstale via o gerenciador de pacotes; execute minicom -D /dev/ttyUSB* -b 115200

Todas as ferramentas precisam das mesmas configurações de linha:

ConfiguraçãoValor
Baud rate115200
Bits de dados8
ParidadeNenhuma
Bits de parada1
Controle de fluxoNenhum

Etapa 4. Confirme o prompt​

Pressione Enter. A placa responde com seu prompt:

cmd>

Digite help para listar todos os comandos registrados.

cmd> help

Início Rápido​

1. Liste os comandos​

cmd> help

2. Leia a bateria​

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%

Ele informa a tensão da célula em milivolts e uma estimativa de carga. Sem bateria instalada, a leitura acompanha a alimentação USB.

3. Transmita um pacote LoRa​

cuidado

Instale a antena Sub-GHz em SUB-1G antes de transmitir. Mantenha a placa a um metro de distância de outras antenas enquanto estiver em operação.

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. Receba pacotes 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!

Execute o comando lora_rx -f 868000000 -s 7 -b 3 na placa A e lora_tx -f 868000000 -s 7 -b 3 -p 14 -d hello -n 10 na placa B. O contador de A aumenta a cada pacote e B retorna após dez. Pare A com Ctrl+C para imprimir os totais. Uma contagem travada em zero significa que as placas discordam em alguma configuração de rádio ou que uma antena está ausente. Mantenha -i em 200 ou acima, ou o receptor registrará linhas hdr err.

Encerre o teste com Ctrl+C em ambas as placas, para que nenhuma permaneça em modo de recepção.

5. Estação Wi-Fi e ping​

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

A associação foi bem-sucedida quando aparecer uma linha contendo got ip:.

6. Câmera pelo hotspot​

cmd> camera_start
cmd> camera_http_start

Conecte-se a wio-lr2021-camera com a senha 12345678 e abra http://192.168.4.1. Quadros ao vivo comprovam a câmera e a pilha Wi-Fi ao mesmo tempo.

Encerre o teste com camera_http_stop e camera_stop, depois reconecte-se à sua rede normal.

7. Desenhe um padrão no display​

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. Grave e reproduza áudio​

audio_slot_record -d 5000
audio_slot_play

9. Identifique o 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

Comportamento e Limites​

ComportamentoComandosO que aconteceComo sair
Recepção contínualora_rx, flrc_rxConta pacotes, sem promptCtrl+C
Transmissão infinitalora_tx -n 0, flrc_tx -c 0Envia sem pararCtrl+C
Onda contínualora_cw, lora_cw_paPortadora não modulada, sem payloadlora_cw_stop
Tarefa em segundo planoflash_endurance -a startRetorna imediatamente, continua apagandoflash_endurance -a stop
Duração do hotspotap_set, camera_http_start, audio_slot_sendRádio permanece ativo até ser fechadowifi stop, camera_http_stop, audio_slot_stop
  • Um comando é dono do console: durante um loop de recepção ou transmissão o firmware ignora a entrada.
  • A saída é texto simples; ative o log do terminal para registrar o teste.
  • Alguns terminais associam Ctrl+C a copiar; confirme que o seu envia a interrupção.

Segurança e Conformidade​

1. Uma antena por banda. O conector SMA e o pad U.FL de uma banda compartilham uma única malha de RF por meio de um link de 0 Ω. Instalar ambos deixa nenhuma antena adaptada.

2. Nunca deixe uma portadora ativa. lora_cw e lora_cw_pa transmitem uma portadora contínua sem payload. Pare-as com lora_cw_stop antes de mover a placa.

3. Verifique seu plano de bandas. A saída Sub-GHz atinge +22 dBm e 2,4 GHz atinge +12 dBm. 868 MHz atende à Europa, 902 ~ 928 MHz às Américas. Confirme seus limites nacionais e use uma caixa blindada para execuções de certificação.

4. Bateria e solar. Use uma célula Li-ion de 3,7 V em BAT-3.7V, observando a polaridade serigrafada. O carregador CN3165 fornece cerca de 495 mA e não possui entrada de termistor, portanto não carregue sem supervisão.

5. Credenciais padrão. Os hotspots de câmera e áudio são enviados com a senha 12345678, e a página da câmera não tem login. Altere a senha e feche o hotspot em uma bancada compartilhada.

6. A resistência do flash desgasta o chip. flash_endurance apaga setores reais da partição flashtest. Execute-o apenas em unidades de amostra, nunca em uma placa de que você ainda precise.

Recurso​

Suporte Técnico e Discussão de Produto​

Obrigado por escolher nossos produtos! Estamos aqui para fornecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.

Loading Comments...