====== Firmware Overview ======

This section documents firmware behavior, update procedures, device modes, and command interfaces for Wi-Fi HaLow modules.

The aim is to provide working knowledge for developers, experimenters, and operators who need dependable control over HaLow radios in real deployments.

If you are trying to bring up a board, verify RF operation, or integrate into an embedded system, start here.

===== What This Covers =====

* Firmware versions and feature differences  
* AT command interface and usage patterns  
* Device configuration and network roles  
* Sleep and power management controls  
* Debugging and test modes  
* Upgrade and recovery procedures

===== Quick Start =====

If you want to talk to the module right now:

  * Configure UART or USB serial interface  
  * Open a terminal at the correct baud rate  
  * Use AT commands to query and set parameters  

Example:

<code>

AT
OK
AT+VERSION?
2.0.x

</code>


For full command details see:

  * [[software:firmware:2.x:at-commands:index|AT Commands (2.x Firmware)]]

===== Device Roles =====

HaLow modules support multiple wireless roles:

* Access Point (AP)
* Station (Client)
* Relay (Device-to-Device Repeater)

Each mode has unique configuration steps and performance considerations. Dedicated pages cover setup for each role.

===== Power and Range Considerations =====

HaLow targets long range and low power operation. Firmware often exposes:

* TX power control
* Receiver sensitivity adjustments
* Sleep modes (DSLEEP, wake triggers)
* Bandwidth and channel plan settings

Use these features when optimizing for battery systems or rural links.

===== Test and Debug Capabilities =====

Firmware provides built-in tools for:

* RF output verification
* Packet testing
* Logging and debug prints
* Configuration resets

These are critical for validating link conditions and diagnosing range or stability issues.

===== Firmware Updates =====

Upgrade and recovery instructions vary by module. Topics covered here include:

* Flashing procedures
* Factory reset commands
* Safe recovery workflows

Expect detailed vendor notes and command sequences.

===== Next Steps =====

Start with the command interface reference:

  * [[software:firmware:2.x:at-commands:index|AT Command Reference]]

Then explore examples and real-world setup guides:

  * AP mode configuration
  * Client setup
  * Relay testing
  * Iperf and link quality checks
  * Diagnostics and troubleshooting

===== Contribute =====

Firmware insight grows through shared logs, captures, command sequences, and field results. Contributions are welcome, especially:

* Verified working configs
* Power and range measurements
* Debug tricks and recovery notes
* Module-specific quirks

Your data helps strengthen open HaLow knowledge for everyone.