Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
S
SRC OBDH TMTC
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Deploy
Releases
Package registry
Container registry
Model registry
Operate
Terraform modules
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Robin Mueller
SRC OBDH TMTC
Commits
f82dc9b0
Commit
f82dc9b0
authored
5 years ago
by
Robin.Mueller
Browse files
Options
Downloads
Patches
Plain Diff
New info on run config, unit test init
parent
71a4ed5f
Branches
Branches containing commit
Tags
Tags containing commit
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
README.md
+35
-12
35 additions, 12 deletions
README.md
with
35 additions
and
12 deletions
README.md
+
35
−
12
View file @
f82dc9b0
...
...
@@ -5,38 +5,49 @@ TMTC Client
Manual installation of crcmod might be needed
1.
Install pip if it is not installed yet
2.
Install crcmod and all other reqiored packages:
Command: p
ip
install crcmod
Command: p
ython
<version>
-m pip
<version>
install crcmod
or use IDE (interpreter settings -> pip in PyCharm)
## How To Use
The script can be used by specifying command line parameters.
Please run this script with the -h flag
or without any command line parameters to display options. GUI is work-in-progress
or without any command line parameters to display options.
GUI is work-in-progress.
It might be necessary to set board or PC IP address if using ethernet communication.
Default values should work normally though.
## Examples
Example command to test service 17,
assuming no set client IP (set manually to PC IP Address if necessary) and default board IP 169.254.1.38:
```
sh
OBSW_
Udp
Client.py
-m
3
-s
17
```
sh
ell script
OBSW_
TmTc
Client.py -m 3 -s 17
```
Example to run Unit Test:
```
sh
OBSW_UdpClient.py
-m
5
```
shell script
OBSW_TmTcClient.py -m 5
```
Example to test service 3 with serial communication, printing all housekeeping packets,
and exporting to a log file. COM port needs to be typed in manually (or set with --COM
\<
COM PORT>):
```
shell script
OBSW_TmTcClient.py -m 3 -s 3 -p --hk -c
```
## Modes
There are four different Modes:
1.
GUI Mode (-m 0): Experimental mode, also called if no input parameter are specified
2.
Listener Mode (-m 1): Only Listen for incoming TM packets
3.
SingleCommandMode: Send Single Command repeatedly until answer is received,
only listen after that
4.
ServiceTestMode: Send all Telecommands belonging to a certain service
3.
SingleCommandMode
(-m 2)
: Send Single Command repeatedly until answer is received,
only listen after that
. Single command needs to be packed (see function below main())
4.
ServiceTestMode
(-m 3)
: Send all Telecommands belonging to a certain service
and scan for replies for each telecommand. Listen after that
5.
SoftwareTestMode: Send all services and perform reply scanning like mode 3.
5.
SoftwareTestMode
(-m 4)
: Send all services and perform reply scanning like mode 3.
Listen after that
6.
Unit Test Mode: Performs a unit test which returns a simple OK or NOT OK. This mode
6.
Unit Test Mode
(-m 5)
: Performs a unit test which returns a simple OK or NOT OK. This mode
has the capability to send TCs in bursts, where applicable
In sequential mode, the Client listens for a specified time before sending the next
telecommand. This time has a default value but can be set with the -t parameter (e.g. -t 12).
The TC timeout factor is mulitplied with the TM timeout to specifiy
when a TC is sent again, if no reply is received.
...
...
@@ -48,4 +59,16 @@ Please ensure that python.exe UDP packets are not blocked in advanced firewall s
and create a rule to allow packets from port 2008.
## Serial Communication
Work-In-Progress
\ No newline at end of file
Implemented.
## Unit Test
Some more information will follow on how to write Unit Tests.
## Import run configurations in PyCharm
The PyCharm IDE can be used to comfortably manage a set of run configuations (for example tests for different
services). These configurations were shared through the version control system Git
and should be imported automatically. If these configurations dont show up, try to open the tmtc folder as
a new PyCharm project in a new window.
To add new configurations, go to Edit Configurations... at the top right corner in the drop-down menu.
Specify the new run configurations and set a tick at Share through VCS.
\ No newline at end of file
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment