Arduino Shell

A command shell to interact with built-in Arduino features via the Serial Monitor.

Right now it offers commands:

to print EEPROM contents in a hexdump-like form
to write bytes into EEPROM
to configure the pins for digital I/O mode
to save the pin configuration to EEPROM
to print the current pin configuration

Also useful, a super-simple command parser class that breaks a raw input string into a command and parameters, which can then be used by other logic to determine the next steps.

Quickstart

cd arduino-1.6.7/hardware/arduino/avr/libraries
git clone git@github.com:nuket/ArduinoShell.git
Start/restart the Arduino IDE.
Run the ArduinoShellBasics example
Open the Serial Monitor, set it to 57600 baud, with Newline line endings.
Type pin 13 high and press Return. The built-in LED on the Arduino should light up.
Type pin 13 low and press Return. The built-in LED on the Arduino should turn off.

Example

Startup

At startup, the saved pin configuration is reloaded and digital I/O pins are restored to their last HIGH or LOW voltage level.

Command Examples

`help`

Prints out the commands that are available the be played with.

Arduino Shell
(c)2015 Max Vilimpoc (https://github.com/nuket/arduino-shell), MIT licensed.

help
ADC Pin Shell commands:
    adc read <n>

Config Shell commands:
    config print
    config save

Digital Pin Shell commands:
    pin <n> in
    pin <n> in_pullup
    pin <n> high
    pin <n> low
    pin <n> status
    pin <n> reset

EEPROM Shell commands:
    p
    p <address>
    p <address> <rows>
    wb <address> <byte-value> -- writes the byte-value to the address

`adc read <n>`

Read analog pin and print the current voltage value.

`adc aref <reference>`

Set the ADC analog reference voltage source.

`config print`

Prints the currently running pin configuration, like so:

config print
ConfigBlock CRC: 0000b2b1
Config for Pin 00: DIGITAL_INPUT
Config for Pin 01: DIGITAL_OUTPUT_HIGH
Config for Pin 02: DIGITAL_INPUT_PULLUP
Config for Pin 03: DIGITAL_OUTPUT_LOW
[...]
Config for Pin 61: NO_TYPE
Config for Pin 62: NO_TYPE
Config for Pin 63: NO_TYPE

The config system does not do any checking whether the pins actually exist on your Arduino, so be careful.

`config save`

Saves the configuration to EEPROM with a CRC checksum of the pin configuration.

`pin <n> in`

Sets the pin to INPUT mode and that's all.

`pin <n> in_pullup`

Sets the pin to INPUT_PULLUP mode and that's all.

`pin <n> high`

Sets the pin to OUTPUT mode and sets the voltage level to HIGH.

`pin <n> low`

Sets the pin to OUTPUT mode and sets the voltage level to LOW.

`pin <n> status`

Prints the current setting of the pin. Useful for scripting. One of:

"NO_TYPE",
"DIGITAL_INPUT",
"DIGITAL_INPUT_PULLUP",
"DIGITAL_OUTPUT_HIGH",
"DIGITAL_OUTPUT_LOW",
"ANALOG_INPUT",
"PWM",
"SERIAL_HARDWARE",
"SERIAL_SOFTWARE",
"SERIAL_CAN",
"SERIAL_I2C",
"SERIAL_SPI"

`pin <n> reset`

Resets the pin to NO_TYPE mode, which means that when the Arduino is reset, there is no configuration performed on this pin.

`wb address byte`

Write the byte to the specified EEPROM address.

wb 0x51 0x45
command:  >>wb<<
param[0]: >>0x51<<
param[1]: >>0x45<<
0050 | FF 45 FF FF FF FF FF FF FF FF FF FF FF FF FF FF | .E..............

`p address rows`

Print rows rows, starting from EEPROM address.

p 0x00 10
command:  >>p<<
param[0]: >>0x00<<
param[1]: >>10<<
0000 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ................      
0010 | 42 41 43 FF FF FF FF FF FF FF FF FF FF FF FF FF | BAC.............      
0020 | 47 51 FF FF FF FF FF FF FF FF FF FF FF FF FF FF | GQ..............      
0030 | 57 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | W...............      
0040 | FF FF FF FF FF FF FF FF 44 FF FF FF FF FF FF FF | ........D.......      
0050 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ................      
0060 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ................      
0070 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ................      
0080 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ................      
0090 | FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF | ................

Building

Using the latest Arduino 1.6.6 IDE, the project will build with no modifications, as all C++ files are now compiled with -std=gnu++11.

License

Arduino Shell
Copyright (c) 2015 Max Vilimpoc

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

Name		Name	Last commit message	Last commit date
Latest commit History 81 Commits
examples/ArduinoShellBasics		examples/ArduinoShellBasics
src		src
.gitignore		.gitignore
Doxyfile		Doxyfile
README.md		README.md
clang-check.sh		clang-check.sh
keywords.txt		keywords.txt
library.properties		library.properties
platform.local.txt		platform.local.txt
screencast.gif		screencast.gif

nuket/ArduinoShell

Folders and files

Latest commit

History

Repository files navigation

Arduino Shell

Quickstart

Example

Startup

Command Examples

help

adc read <n>

adc aref <reference>

config print

config save

pin <n> in

pin <n> in_pullup

pin <n> high

pin <n> low

pin <n> status

pin <n> reset

wb address byte

p address rows