D2S2 Satellite Simulator

WARNING: THIS IS A PREVIEW VERSION OF D2S2, INTENDED FOR DEVELOPMENT AND TESTING. NOT ALL FEATURES ARE PRESENT

Command-line interface for the D2S2.
Supports running simulations and scripts from .d2s2 scenario files.

The D2S2 snap is strictly confined. USB-serial and CAN bus interfaces
require manual connection after installation.

command line usage:

d2s2-preview <task> <task parameters> --user <username> --pwd <password>
d2s2-preview <task> <task parameters> --license <license file>

<task> can be one of the following
runsim : run a simulation from a provided scenario file.

           possible parameters for the runsim task are:

             --scenario <scenario file>, where <scenario file> is the file path to the scenario file to use

             --useropts <user settings file>, where <user settings file> is the file path to the user settings file. (optional)

           example usage:

             d2s2-preview runsim --scenario c:\temp\scenario.d2s2 --useropts c:\temp\useropts.xml

runscript : run a script

           possible parameters for the runscript task are:

             --scenario <scenario file>, where <scenario file> is the file path to the scenario file to use (optional)

             --useropts <user settings file>, where <user settings file> is the file path to the user settings file. (optional)

             --scriptname <script name>, where <script name> is the (fully qualified) type name for the script. Use the 'list' task to obtain a list of available script names.

             --scriptopts <script options file>, where <script options file> is the file path to the script options.

           the runscript task required that either scriptname, or scriptopts is specified.

           example usage:

             d2s2-preview runscript --scriptname D2S2.Simulation.LoggingScript

             d2s2-preview runscript --scriptopts c:\temp\options.d2s2-script --scenario c:\temp\scenario.d2s2 --useropts c:\temp\useropts.xml

list : list available scripts

makescript: save a template script options file. Use this command to create a .d2s2-script file with default options for the named script.

           possible parameters for the makescript task are:

             --useropts <user settings file>, where <user settings file> is the file path to the user settings file. (optional)

             --scriptname <script name>, where <script name> is the (fully qualified) type name for the script. Use the 'list' task to obtain a list of available script names.

             --scriptopts <script options file>, where <script options file> is the output file path with the default script options.

           example usage:

             d2s2-preview makescript --scriptname D2S2.Simulation.LoggingScript --scriptopts c:\temp\options.d2s2-script

Authentication:
<username> and <password> arguments are optional.
<username> and <password> are the credentials that the user would use to sign in to the UI application.
If <username> is not provided, this console app will attempt to use the same credentials for the last UI application sign-in
Alternatively, you can specify the file location of a valid license file using --license <license file>

Enabling USB-serial support
---------------------------

1. Enable hotplugging support.

sudo snap set system experimental.hotplug=true

2. List the available serial devices.

sudo snap interface serial-port

3. Connect the interface to grant the snap access to your port.

sudo snap connect d2s2:serial-port snapd:<slot-name>

Enabling CAN support
--------------------

1. Enable the network configuration interface for your snap.

sudo snap connect d2s2:network-control

2. Enable CAN bus access for your snap.

sudo snap connect d2s2:can-bus