Командная строка для Arduino UNO: быстрое и надежное управление скетчем

Компоненты

• Arduino UNO — 1 шт.

Зачем нужен CLI на Arduino

Часто требуется изменить параметры скетча «на лету»: считать значение датчика, подать команду роботу («поверни налево»), прочитать или установить переменную, настроить цифровой потенциометр. Простейший способ — текстовый интерфейс через последовательный порт.

Архитектура решения

Весь функционал инкапсулирован в заголовочный файл CommandLine.h. Достаточно подключить его в основной скетч:

#include "CommandLine.h"

void setup() {
  Serial.begin(115200);
}

void loop() {
  if (getCommandLineFromSerialPort(CommandLine)) {
    DoMyCommand(CommandLine);
  }
}

Возможности интерпретатора

• Команды состоят из имени и аргументов (чисел или слов), разделённых пробелами или запятыми
• Поддержка Backspace при вводе
• Автоматическое приведение к нижнему регистру
• Минимальный расход памяти: используются C-строки, а не String
• Парсинг аргументов через стандартную strtok() и atoi()
• Легкое добавление новых команд через таблицу if-else или switch-case

Примеры команд

add 5, 10
sub 10, 5
blink 3
setPWM 9, 128

Ключевые функции в CommandLine.h

• getCommandLineFromSerialPort() — накапливает символы до '\n', обрабатывает Backspace, возвращает true при готовой команде
• readNumber() — читает следующий числовой аргумент
• readWord() — читает следующее слово
• DoMyCommand() — диспетчер команд, вызывает соответствующие функции
• addCommand(), subtractCommand() — примеры пользовательских команд

Интеграция в свой проект

1. Создайте новую вкладку в Arduino IDE с именем CommandLine.h
2. Скопируйте туда полный код из раздела «Code»
3. Добавьте #include "CommandLine.h" в основной файл
4. Реализуйте свои команды по аналогии с add и sub
5. Загрузите скетч, откройте Serial Monitor (115200 baud) и тестируйте

Советы по расширению

Для большого числа команд удобно использовать хеш-таблицу или массив структур {name, function_ptr}. Аргументы можно собирать в глобальный argv[] уже в DoMyCommand. Макрос print2(label, value) упрощает отладку.