diff options
Diffstat (limited to 'docs/MCU_Commands.md')
-rw-r--r-- | docs/MCU_Commands.md | 14 |
1 files changed, 5 insertions, 9 deletions
diff --git a/docs/MCU_Commands.md b/docs/MCU_Commands.md index f5019814..c576ad88 100644 --- a/docs/MCU_Commands.md +++ b/docs/MCU_Commands.md @@ -12,7 +12,11 @@ format of commands and their transmission. The commands here are described using their "printf" style syntax - for those unfamiliar with that format, just note that where a '%...' sequence is seen it should be replaced with an actual integer. For example, a description -with "count=%c" could be replaced with the text "count=10". +with "count=%c" could be replaced with the text "count=10". Note that +parameters that are considered "enumerations" (see the above protocol +document) actually take a string value which is automatically +converted to an integer value for the micro-controller. This is common +with parameters named "pin" (or that have a suffix of "_pin"). Startup Commands ================ @@ -23,14 +27,6 @@ commands available for that purpose. Unlike most micro-controller commands, these commands run as soon as they are received and they do not require any particular setup. -Several of these commands will take a "pin=%u" parameter. The -low-level micro-controller software uses integer encodings of the -hardware pin numbers, but to make things more readable the host will -translate human readable pin names (eg, "PA3") to their equivalent -integer encodings. By convention, any parameter named "pin" or that -has a "_pin" suffix will use pin name translation by the -host. - Common startup commands: * `set_digital_out pin=%u value=%c` : This command immediately |