====== Relay / Multi-hop Commands ======

This page documents AT commands for configuring relay or multi-hop networking in HaLow firmware 2.x modules.

===== AT+R_SSID – Set Relay SSID =====

**Query:**  
  <code>AT+R_SSID=?</code>

**Set Relay SSID:**  
  <code>AT+R_SSID=relay_ssid_example</code>

**Response:**  
  <code>+R_SSID:relay_ssid_example
OK</code>

**Notes:**  
  * Sets the downstream SSID for the relay to connect to the next-level STA  
  * Required for multi-hop network connections  

===== AT+R_KEY – Set Relay Encryption Key =====

**Query:**  
  <code>AT+R_KEY=?</code>

**Set Relay Key:**  
  <code>AT+R_KEY=87654321</code>

**Response:**  
  <code>+R_KEY:87654321
OK</code>

**Notes:**  
  * Key must be ≥ 8 hexadecimal characters  
  * Used for encrypting relay connections to downstream STA  
  * If key is too short, command returns: ERROR need 8 bytes at less  

===== Notes =====

* Relay commands are only relevant in APSTA (relay) mode.  
* Ensure the relay module’s WIFIMODE is set to `apsta` and basic network parameters are configured before setting relay SSID/key.  
* Proper relay configuration allows STA devices to connect through intermediate nodes for extended coverage.