Skip to content

v2.5.1 - Clean Up Command Aliases in Dispatch Table (2026-02-25)

What Changed?

This release cleans up redundant and conflicting aliases in the command dispatch table. GET_TIME was registered as both a standalone command and an alias for GET_RTC_TIME, causing ambiguity. Six long aliases that simply duplicated the canonical command name with minor variation were also removed.

What's New

Main Feature: Remove Redundant and Conflicting Command Aliases

What it does:

Resolves a name conflict and removes 6 redundant long aliases:

Conflict fix (GET_TIME was mapped to two different handlers):

Before:
  GET_TIME  → handle_get_time      (standalone: RTC+GNSS+uptime composite)
  GET_TIME  → handle_get_rtc_time  (alias of GET_RTC_TIME: RTC seconds only)  ← conflict

After:
  GET_TIME     → handle_get_time      (unambiguous)
  GET_RTC_TIME → handle_get_rtc_time  (no alias)

Redundant long aliases removed:

Command Removed Alias
GET_STATUS STATUS
TEST_LED LED
GET_UPTIME UPTIME
GET_HELP HELP
SET_WIFI_ENABLE WIFI_ENABLE
GET_WIFI WIFI_STATUS

Single-character aliases (S, L, U, H, W) are retained.

Installation

Quick Start

# Get the release
git checkout 2.5.1

# Build
task v2:build

# Upload
task v2:upload

# Check it works
task monitor

What's Different from the Last Version?

🐛 Fixed

  • src/v2_command_manager.cpp: Remove GET_TIME alias from GET_RTC_TIME (name conflict with standalone GET_TIME command)

🔧 Changed

  • src/v2_command_manager.cpp: Remove 6 redundant long aliases (STATUS, LED, UPTIME, HELP, WIFI_ENABLE, WIFI_STATUS)

Is It Safe to Upgrade?

Backward Compatible: No (breaking change for alias users)

  • Scripts or tools using STATUS, UPTIME, HELP, LED, WIFI_ENABLE, or WIFI_STATUS must switch to the canonical names (GET_STATUS, GET_UPTIME, GET_HELP, TEST_LED, SET_WIFI_ENABLE, GET_WIFI) or single-character aliases
  • GET_TIME now unambiguously returns the composite response (RTC + GNSS + uptime + diff); use GET_RTC_TIME to get RTC seconds only

Tests Passed

  • ✅ Builds without errors

Release Details

  • Date: 2026-02-25
  • Version: v2.5.1
  • Files Changed: 1 (src/v2_command_manager.cpp)

Next Steps

Continued code quality improvements (see REFACTORING_ROADMAP.md):

  • Remove double discard_input() call (P2, pending real-device verification)