Skip to content
Snippets Groups Projects
Commit 0323fe99 authored by burneykb's avatar burneykb
Browse files

Updated documentation and gitignore

parent ee7645fd
No related branches found
No related tags found
No related merge requests found
...@@ -44,8 +44,10 @@ obj ...@@ -44,8 +44,10 @@ obj
Cli Cli
#symlinks #symlinks
getpid getnodes
monitor addnode
setpid getoutput
setsetpoint setsource
getsetpoint getsource
getparam
setparam
...@@ -14,12 +14,11 @@ cd into the groundstation folder. ...@@ -14,12 +14,11 @@ cd into the groundstation folder.
make make
run the program with sudo privledges run the program with sudo privledges
sudo -E ./BackEnd ./BackEnd
If you wish to change the way the backend communicates to the quad and vice versa, look at src/config.h. If you wish to change the way the backend communicates to the quad and vice versa, look at src/config.h.
This provides a list of environment variables which you can set and use for your computer or time of use. This provides a list of environment variables which you can set and use for your computer or time of use.
Because the backend must be ran with sudo privledges, you will need to preserve the env. vars. with sudo rights.
Hence the "-E" flag.
## Modifying ## Modifying
See MODIFYING for the software architecture/organization and how to add new functionality. See MODIFYING for the software architecture/organization and how to add new functionality.
...@@ -32,38 +31,35 @@ socket path is writable by the user. ...@@ -32,38 +31,35 @@ socket path is writable by the user.
Once the backend is running, various CLI tools can be used to view the state of the Once the backend is running, various CLI tools can be used to view the state of the
quad and send commands. Each of these tools is given as the first argument quad and send commands. Each of these tools is given as the first argument
to the CLI program, for example, to monitor the quad, use `cli monitor`. Note that to the CLI program, for example, to get a node output the quad, use `cli getoutput`. Note that
the backend socket environment variable must be set to the same value as it the backend socket environment variable must be set to the same value as it
was for the backend. The CLI program also supports busybox-style symbolic links. was for the backend. The CLI program also supports busybox-style symbolic links.
For example, if there is a symlink named `monitor` that points to the `cli` binary, For example, if there is a symlink named `getoutput` that points to the `cli` binary,
running the `monitor` program will effectively run `cli monitor`. running the `getoutput` program will effectively run `cli getoutput`.
The names of the binaries is subject to change. The names of the binaries is subject to change.
For more in depth usage explainations, use the --help flag. For a list of cli commands and more in depth usage explainations, use the --help flag.
'./Cli --help' './Cli --help'
For help with the specific cli command you are running, use the --help flag once again. For help with the specific cli command you are running, use the --help flag once again.
'./Cli setpid --help' './Cli getoutput --help'
### Example ### Example
In one terminal or screen, run the backend: In one terminal or screen, run the backend:
`UCART_SOCKET=./ucart.socket ./BackEnd` `./BackEnd`
This will activate the quad and the backend, and the backend will be available for This will activate the quad and the backend, and the backend will be available for
connections from the frontend tools. One useful tool is the monitor. In another connections from the frontend tools. One useful tool is the getnodes. In another
terminal window, run the monitor forever: terminal window, run
`UCART_SOCKET=./ucart.socket ./cli monitor -f` `./Cli getnodes`
This will begin a periodic monitoring that updates 10 times per second. or alternatively with symlinks
Finally, in a third window, export the socket path: `./getnodes`
`export UCART_SOCKET=./ucart.socket` This will fetch the block_id, type_id and name of every node in the current graph
and then run any other tools to modify the quad, for example modifying PID constants:
`./cli setpid --pitch -p 1.000`
You can run any number of any combination of frontend tools at the same time.
\ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment