From v4.7 to v5.1

Command Processing

The CommandProcessing service has been refactored and moved to a component. This means that the following classes CommandHandler, CommandExecutor and CommandOutput are no longer available.

Enabling

The command processing component used to be enabled by setting the directive ENABLE_CMD_EXECUTOR to 1 in your component.mk file or during compilation. This has to be replaced with the directive COMPONENT_DEPENDS += CommandProcessing in your component.mk file.

Including Header Files

To include the command processing headers in your C++ application we used to do the following

For example:

#include <Services/CommandProcessing/CommandProcessingDependencies.h>

becomes:

#include <CommandProcessing/Utils.h>

Usage

There is no longer a global instance of commandHandler. This means that you will need to create one yourself when you need it. This can be done using the code below:

CommandProcessing::CommandHandler commandHandler;

In order to register a command the old example code:

commandHandler.registerCommand(
        CommandDelegate("example", "Example Command", "Application", processExampleCommand));

becomes:

commandHandler.registerCommand(
        CommandProcessing::Command("example", "Example Command", "Application", processExampleCommand));

HardwareSerial no longer is dependent on CommandProcessing classes. And the following command will no longer work:

Serial.commandProcessing(true);

The line above has to be replaced with:

CommandProcessing::enable(commandProcessing, Serial);

See the modified samples CommandLine, TelnetServer and HttpServer Websockets for details.