You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

28 lines
1.3 KiB

# 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. This mode of operation is intended to allow RealSense 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.
* `-l <filename>` - load commands specification file.
* `-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)
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
```