Update documentation for rs-terminal with example of commands from a …

…file.

Minor fixes/enhancements

src/terminal-parser.cpp

@@ -106,16 +106,15 @@ namespace librealsense
         }
 
         if (tokens.empty())
-            throw runtime_error("Wrong input!");
+            throw runtime_error("Invald input! - no arguments provided");
 
-        auto command_str = tokens.front();
+        auto command_str = utilities::strings::to_lower(tokens.front());
         auto it = _cmd_xml.commands.find(command_str);
         if (it == _cmd_xml.commands.end())
-            throw runtime_error("Command not found!");
+            throw runtime_error(to_string() << "Command " << command_str << " was not found!");
 
         command = it->second;
         for (auto i = 1; i < tokens.size(); ++i)
             params.push_back(tokens[i]);
     }
-
 }

tools/terminal/readme.md

@@ -1,7 +1,9 @@
 # rs-terminal Tool
 
 ## Goal
-`rs-terminal` tool can be used to send debug commands to camera firmware. The tool can operate in two modes - if you have access to the specification of debug commands for the exact firmware you are using (provided in XML form) the tool will provide help and auto-completion based on the information within the XML. If you don't have access to the spec, you can still operate the tool in HEX mode, sending binary commands directly. Later mode of operation is intended to allow Intel support team to troubleshoot the hardware remotely by providing the user the exact binary commands to input. 
+`rs-terminal` tool can be used to send debug commands to camera firmware. The tool can operate in two modes - if you have access to the specification of debug commands for the exact firmware you are using (provided in XML form) the tool will provide help and auto-completion based on the information within the XML.  
+The tool may accept specific parameters input from files as well as the console
+If you don't have access to the spec, you can still operate the tool in HEX mode, sending binary commands directly. Later mode of operation is intended to allow Intel support team to troubleshoot the hardware remotely by providing the user the exact binary commands to input. 
 
 ## Usage
 After installing `librealsense` run `rs-terminal` to launch the tool in HEX mode. 
@@ -10,6 +12,19 @@ After installing `librealsense` run `rs-terminal` to launch the tool in HEX mode
 * `-d <number>` - choose device by device number
 * `-n <serial>` - choose device by serial number
 * `-a` - broadcast to all connected devices
+* `-c` - execute a sequence of FW commands listed in a file. (The file must be ANSI/UTF-8  format)
 
+Example:  
+>`rs-terminal -l cmd.xml-c sequence.txt`
+
+Run the tool, load the FW command specifications/mapping file and then iterate over and execute the FW commands listed in `sequence.txt` file
+
+Possible content for `sequence.txt`:
+```
+gvd
+oemr
+oemw /usr/tmp/tbd.bin
+gvd
+```
 
 

tools/terminal/rs-terminal.cpp

@@ -52,9 +52,9 @@ void xml_mode(const string& line, const commands_xml& cmd_xml, rs2::device& dev,
     }
 
     if (tokens.empty())
-        throw runtime_error("Wrong input!");
+        throw runtime_error("Invald input! - no arguments provided");
 
-    auto command_str = tokens.front();
+    auto command_str = utilities::strings::to_lower(tokens.front());
     auto it = cmd_xml.commands.find(command_str);
     if (it == cmd_xml.commands.end())
         throw runtime_error("Command " + command_str + " was not found!");