5GHz WiFi support for ESP32C5

Author: martin-ger

components/cmd_router/cmd_router.c

@@ -92,6 +92,9 @@ static void register_set_oled_gpio(void);
 #if !CONFIG_ETH_UPLINK
 static void register_scan(void);
 #endif
+#if WIFI_HAS_5GHZ
+static void register_set_sta_band(void);
+#endif
 static void register_set_vpn(void);
 static void register_set_tz(void);
 
@@ -298,6 +301,9 @@ void register_router(void)
     register_set_ap_channel();
 #endif
     register_set_hostname();
+#if WIFI_HAS_5GHZ
+    register_set_sta_band();
+#endif
 #if defined(CONFIG_IDF_TARGET_ESP32C6)
     register_set_rf_switch();
 #endif
@@ -1244,7 +1250,14 @@ static int show(int argc, char **argv)
         if (ap_connect) {
             wifi_ap_record_t ap_info;
             if (esp_wifi_sta_get_ap_info(&ap_info) == ESP_OK) {
-                printf("Uplink AP: connected (%d dBm)\n", ap_info.rssi);
+#if WIFI_HAS_5GHZ
+                printf("Uplink AP: connected (ch %d, %s, %d dBm)\n",
+                       ap_info.primary,
+                       ap_info.primary > 14 ? "5 GHz" : "2.4 GHz",
+                       ap_info.rssi);
+#else
+                printf("Uplink AP: connected (ch %d, %d dBm)\n", ap_info.primary, ap_info.rssi);
+#endif
             } else {
                 printf("Uplink AP: connected\n");
             }
@@ -1360,6 +1373,14 @@ static int show(int argc, char **argv)
             printf("  Enterprise: <not active>\n");
         }
 
+
+#if WIFI_HAS_5GHZ
+        {
+            const char *band_names[] = {"auto", "2.4 GHz", "5 GHz"};
+            printf("  Band preference: %s\n", band_names[sta_band <= STA_BAND_5G ? sta_band : 0]);
+        }
+#endif
+
         if (ssid != NULL) free(ssid);
         if (ent_username != NULL) free(ent_username);
         if (ent_identity != NULL) free(ent_identity);
@@ -2248,6 +2269,52 @@ static void register_set_ap_channel(void)
 }
 #endif
 
+#if WIFI_HAS_5GHZ
+/* 'set_sta_band' command - set STA band preference (5 GHz capable targets) */
+static int set_sta_band_cmd(int argc, char **argv)
+{
+    if (argc < 2) {
+        const char *names[] = {"auto", "2.4 GHz", "5 GHz"};
+        printf("STA band preference: %s\n", names[sta_band <= STA_BAND_5G ? sta_band : 0]);
+        return 0;
+    }
+
+    int band_val;
+    if (strcmp(argv[1], "auto") == 0 || strcmp(argv[1], "0") == 0) {
+        band_val = STA_BAND_AUTO;
+    } else if (strcmp(argv[1], "2.4") == 0 || strcmp(argv[1], "1") == 0) {
+        band_val = STA_BAND_2G;
+    } else if (strcmp(argv[1], "5") == 0 || strcmp(argv[1], "2") == 0) {
+        band_val = STA_BAND_5G;
+    } else {
+        printf("Invalid band. Use: auto, 2.4, or 5\n");
+        return 1;
+    }
+
+    esp_err_t err = set_config_param_int("sta_band", band_val);
+    if (err == ESP_OK) {
+        sta_band = (uint8_t)band_val;
+        const char *names[] = {"auto", "2.4 GHz", "5 GHz"};
+        printf("STA band preference set to: %s\n", names[band_val]);
+        printf("Restart the device for changes to take effect.\n");
+    } else {
+        printf("Failed to save setting\n");
+    }
+    return err;
+}
+
+static void register_set_sta_band(void)
+{
+    const esp_console_cmd_t cmd = {
+        .command = "set_sta_band",
+        .help = "Set STA band preference (auto, 2.4, 5; requires restart)",
+        .hint = NULL,
+        .func = &set_sta_band_cmd,
+    };
+    ESP_ERROR_CHECK( esp_console_cmd_register(&cmd) );
+}
+#endif /* WIFI_HAS_5GHZ */
+
 /**
  * @brief Format IP address with device name for /32 addresses
  * If the IP has a full /32 mask and a matching DHCP reservation with a name,
@@ -3004,13 +3071,24 @@ static int scan_cmd(int argc, char **argv)
 
     /* Print header */
     printf("\nFound %d networks:\n", ap_count);
+#if WIFI_HAS_5GHZ
+    printf("%-32s  %3s  %5s  %4s  %-12s\n", "SSID", "Ch", "Band", "RSSI", "Security");
+    printf("--------------------------------  ---  -----  ----  ------------\n");
+
+    for (int i = 0; i < ap_count; i++) {
+        const char *auth = auth_mode_to_str(ap_list[i].authmode);
+        printf("%-32s  %3d  %5s  %4d  %s\n", ap_list[i].ssid, ap_list[i].primary,
+               ap_list[i].primary > 14 ? "5 GHz" : "2.4 G", ap_list[i].rssi, auth);
+    }
+#else
     printf("%-32s  %3s  %4s  %-12s\n", "SSID", "Ch", "RSSI", "Security");
     printf("--------------------------------  ---  ----  ------------\n");
 
     for (int i = 0; i < ap_count; i++) {
         const char *auth = auth_mode_to_str(ap_list[i].authmode);
         printf("%-32s  %3d  %4d  %s\n", ap_list[i].ssid, ap_list[i].primary, ap_list[i].rssi, auth);
     }
+#endif
 
     free(ap_list);
     return 0;

components/http_server/http_server.c

@@ -1210,6 +1210,21 @@ static esp_err_t config_get_handler(httpd_req_t *req)
                                 disable_time_check = tc_val;
                             }
 
+#if WIFI_HAS_5GHZ
+                            // Save STA band preference
+                            {
+                                char band_param[4] = "";
+                                int band_val = STA_BAND_AUTO;
+                                if (httpd_query_key_value(buf, "sta_band", band_param, sizeof(band_param)) == ESP_OK) {
+                                    band_val = atoi(band_param);
+                                    if (band_val < STA_BAND_AUTO || band_val > STA_BAND_5G)
+                                        band_val = STA_BAND_AUTO;
+                                }
+                                set_config_param_int("sta_band", band_val);
+                                sta_band = (uint8_t)band_val;
+                            }
+#endif
+
                             // Check for optional STA MAC address
                             if (httpd_query_key_value(buf, "sta_mac", param5, sizeof(param5)) == ESP_OK && strlen(param5) > 0) {
                                 ESP_LOGI(TAG, "Found URL query parameter => sta_mac=%s", param5);
@@ -1506,7 +1521,13 @@ static esp_err_t config_get_handler(httpd_req_t *req)
 #else
     /* Chunk 5: STA Settings */
     snprintf(section, sizeof(section), CONFIG_CHUNK_STA,
-        safe_ssid, safe_ent_username, safe_ent_identity,
+        safe_ssid,
+#if WIFI_HAS_5GHZ
+        sta_band == STA_BAND_AUTO ? "selected" : "",
+        sta_band == STA_BAND_2G ? "selected" : "",
+        sta_band == STA_BAND_5G ? "selected" : "",
+#endif
+        safe_ent_username, safe_ent_identity,
         eap_method == 0 ? "selected" : "", eap_method == 1 ? "selected" : "",
         eap_method == 2 ? "selected" : "", eap_method == 3 ? "selected" : "",
         ttls_phase2 == 0 ? "selected" : "", ttls_phase2 == 1 ? "selected" : "",
@@ -2482,11 +2503,11 @@ static esp_err_t scan_get_handler(httpd_req_t *req)
                 "<tr><td colspan='%d' style='text-align:center; color:#00d9ff;'>"
                 "<span style='display:inline-block; animation: pulse 1s infinite;'>📡 Scanning...</span>"
                 "</td></tr>",
-                can_connect ? 4 : 3);
+                can_connect ? 5 : 4);
         } else {
             snprintf(scan_html, sizeof(scan_html),
                 "<tr><td colspan='%d' style='text-align:center; color:#888;'>No networks found</td></tr>",
-                can_connect ? 4 : 3);
+                can_connect ? 5 : 4);
         }
     } else {
         for (int i = 0; i < ap_count && html_offset < (int)(sizeof(scan_html) - 512); i++) {
@@ -2528,29 +2549,45 @@ static esp_err_t scan_get_handler(httpd_req_t *req)
                     encoded_ssid);
             }
 
-            /* Build signal bars HTML with active/inactive styling */
-            char signal_bars_html[128];
-            const char *bar_chars[] = {"▂", "▄", "▆", "█"};
+            /* Build signal bars HTML with CSS divs */
+            char signal_bars_html[384];
+            const int bar_heights[] = {4, 8, 12, 16};  /* px */
             int sb_offset = 0;
+            sb_offset += snprintf(signal_bars_html, sizeof(signal_bars_html),
+                "<span class='signal-bars'>");
             for (int b = 0; b < 4; b++) {
                 if (b < bars) {
                     sb_offset += snprintf(signal_bars_html + sb_offset, sizeof(signal_bars_html) - sb_offset,
-                        "<span class='%s'>%s</span>", signal_class, bar_chars[b]);
+                        "<span class='bar active %s' style='height:%dpx;'></span>",
+                        signal_class, bar_heights[b]);
                 } else {
                     sb_offset += snprintf(signal_bars_html + sb_offset, sizeof(signal_bars_html) - sb_offset,
-                        "<span style='color:#444;'>%s</span>", bar_chars[b]);
+                        "<span class='bar' style='height:%dpx;'></span>", bar_heights[b]);
                 }
             }
+            sb_offset += snprintf(signal_bars_html + sb_offset, sizeof(signal_bars_html) - sb_offset,
+                "</span>");
+
+            /* Channel / band info */
+            char ch_info[80];
+#if WIFI_HAS_5GHZ
+            snprintf(ch_info, sizeof(ch_info), "%d <span style='color:#888;font-size:0.75rem;'>%s</span>",
+                     ap_list[i].primary, ap_list[i].primary > 14 ? "5G" : "2.4G");
+#else
+            snprintf(ch_info, sizeof(ch_info), "%d", ap_list[i].primary);
+#endif
 
             html_offset += snprintf(scan_html + html_offset, sizeof(scan_html) - html_offset,
                 "<tr>"
                 "<td>%s</td>"
-                "<td>%s <span style='color:#888;font-size:0.8rem;'>%d dBm</span></td>"
+                "<td style='white-space:nowrap;'>%s<span style='color:#888;font-size:0.8rem;margin-left:0.5em;'>%d dBm</span></td>"
+                "<td>%s</td>"
                 "<td>%s</td>"
                 "%s"
                 "</tr>",
                 safe_ssid,
                 signal_bars_html, rssi,
+                ch_info,
                 web_auth_mode_to_str(ap_list[i].authmode),
                 connect_cell
             );

components/http_server/pages/page_config.h

@@ -1,5 +1,6 @@
 /* Configuration page templates */
 #include "router_config.h"
+#include "wifi_config.h"
 
 /* Configuration Page - WiFi settings and MAC addresses */
 /* Config Page - Chunked for streaming */
@@ -83,14 +84,30 @@ setTimeout(\"location.href = '/'\", 10000);\
 </form>"
 
 #if !CONFIG_ETH_UPLINK
+/* STA band preference row (5 GHz capable targets only) */
+/* Uses %s x3 for: auto_selected, 2.4_selected, 5_selected */
+#if WIFI_HAS_5GHZ
+#define CONFIG_CHUNK_STA_BAND_ROW \
+"<tr><td>Band</td><td><select name='sta_band'>\
+<option value='0' %s>Auto (strongest signal)</option>\
+<option value='1' %s>2.4 GHz only</option>\
+<option value='2' %s>5 GHz only</option>\
+</select></td></tr>"
+#else
+#define CONFIG_CHUNK_STA_BAND_ROW ""
+#endif
+
 /* STA Settings section - uses %s for: ssid, ent_username, ent_identity,
-   eap_method selected x4, ttls_phase2 selected x4, cert_bundle checked, no_time_chk checked, sta_mac */
+   eap_method selected x4, ttls_phase2 selected x4, cert_bundle checked, no_time_chk checked,
+   [if WIFI_HAS_5GHZ: band_auto_sel, band_2g_sel, band_5g_sel,]
+   sta_mac */
 #define CONFIG_CHUNK_STA "\
 <h2>Station Settings (Uplink)</h2>\
 <form action='' method='GET'>\
 <table>\
 <tr><td>SSID</td><td><input type='text' name='ssid' value='%s' placeholder='Uplink network'/></td></tr>\
 <tr><td>Password</td><td><input type='text' name='password' placeholder='unchanged'/></td></tr>\
+" CONFIG_CHUNK_STA_BAND_ROW "\
 <tr><td colspan='2' style='padding-top: 1rem; color: #888; font-size: 0.85rem;'>WPA2 Enterprise (optional)</td></tr>\
 <tr><td>Username</td><td><input type='text' name='ent_username' value='%s' placeholder='Enterprise username'/></td></tr>\
 <tr><td>Identity</td><td><input type='text' name='ent_identity' value='%s' placeholder='Optional (defaults to username)'/></td></tr>\

components/http_server/pages/page_scan.h

@@ -26,11 +26,13 @@ h1 { font-size: 1.5rem; font-weight: 600; color: #00d9ff; margin-bottom: 1rem; t
 .data-table td { padding: 0.75rem 0.5rem; border-bottom: 1px solid rgba(255, 255, 255, 0.05); font-size: 0.9rem; }\
 .data-table tbody tr:last-child td { border-bottom: none; }\
 .data-table tbody tr:hover { background: rgba(0, 217, 255, 0.05); }\
-.signal-excellent { color: #4caf50; }\
-.signal-good { color: #8bc34a; }\
-.signal-fair { color: #ffc107; }\
-.signal-weak { color: #ff9800; }\
-.signal-poor { color: #f44336; }\
+.signal-bars { display: inline-flex; align-items: flex-end; gap: 2px; height: 16px; vertical-align: middle; }\
+.signal-bars .bar { width: 4px; border-radius: 1px; background: #444; }\
+.signal-bars .bar.active.signal-excellent { background: #4caf50; }\
+.signal-bars .bar.active.signal-good { background: #8bc34a; }\
+.signal-bars .bar.active.signal-fair { background: #ffc107; }\
+.signal-bars .bar.active.signal-weak { background: #ff9800; }\
+.signal-bars .bar.active.signal-poor { background: #f44336; }\
 .connect-button { background: linear-gradient(135deg, #667eea 0%%, #764ba2 100%%); color: #fff; border: none; border-radius: 6px; padding: 0.4rem 0.8rem; font-size: 0.8rem; font-weight: 600; cursor: pointer; text-decoration: none; display: inline-block; }\
 .connect-button:hover { transform: translateY(-1px); box-shadow: 0 4px 12px rgba(102, 126, 234, 0.4); }\
 .refresh-note { color: #888; font-size: 0.8rem; margin-bottom: 1rem; }\
@@ -51,6 +53,7 @@ h1 { font-size: 1.5rem; font-weight: 600; color: #00d9ff; margin-bottom: 1rem; t
 <tr>\
 <th>SSID</th>\
 <th>Signal</th>\
+<th>Ch</th>\
 <th>Security</th>\
 %s\
 </tr>\

include/wifi_config.h

@@ -12,6 +12,22 @@
 extern "C" {
 #endif
 
+/* 5 GHz band support — currently only ESP32-C5 has dual-band WiFi */
+#if defined(CONFIG_IDF_TARGET_ESP32C5)
+#define WIFI_HAS_5GHZ 1
+#else
+#define WIFI_HAS_5GHZ 0
+#endif
+
+/* STA band preference (only meaningful when WIFI_HAS_5GHZ) */
+#define STA_BAND_AUTO  0   /* Connect to strongest signal regardless of band */
+#define STA_BAND_2G    1   /* Prefer 2.4 GHz (channels 1-14) */
+#define STA_BAND_5G    2   /* Prefer 5 GHz (channels > 14) */
+
+#if WIFI_HAS_5GHZ
+extern uint8_t sta_band;   /* STA_BAND_AUTO / STA_BAND_2G / STA_BAND_5G */
+#endif
+
 #if !CONFIG_ETH_UPLINK
 extern char* ssid;
 extern char* ent_username;