Software Development Environment¶
The Software Development Environment (SDE) is a tool that creates a virtual machine with all the tools needed when developing towards a PELUX platform. More specifically the SDE is setup using vagrant to generate a VirtualBox instance. In order to facilitate this, the SDE requires an instance of the SDK to be present in the root directory (same level as Vagrantfile) while provisioning the VM.
Starting the SDE¶
Dependencies:
Vagrant
VirtualBox
Self-extracting SDK package to install into the SDE. See, Building the SDK installer.
Note
Ubuntu 16.04 default repositories do not provide the latest version required. Please check the latest version of Vagrant and VirtualBox at those links.
To start the SDE VM, check out the repository, put the SDK into its root directory and from that directory (the same directory as the Vagrantfile is located in) run:
SDK_FILE_NAME=<SDK installer> vagrant up
The username and password for the SDE VM is vagrant
.
If this is the first time the SDE is started then the machine has to be provisioned as well. Meaning downloading the Ubuntu base and installing all software. As stated above, during provisioning an instance of the SDK is required in the root directory.
Used environment variables¶
Following is a list of environment variables used by vagrant when provisioning the SDE.
SDK_FILE_NAME: Name of the self-extracting SDK package to install into the SDE. Can include bash wildcards. Defaults to oecore*toolchain*sh.
NO_GUI: Will create a headless SDE when set.
Developing and Extending the SDE¶
Adding new tools¶
To add a new tool to the SDE create a new directory in sde-cookbook with the name of that tool, add your installation and configuration scripts there and configure the Vagrantfile to run them in the right order.
The SDE is developed using TDD, so first write some tests and then write the code which will make them pass. It's really important to have automatic tests which will test for any regressions if someone changes parts of the code.
Tools list¶
Following is a list of tools already installed into the SDE.
QtCreator: IDE with a template wizard provided to speed the process.
DLT Viewer: Visual application to interact with the dlt-daemon.
Test framework¶
The test framework is used to ensure that no existing functionality is broken while developing new features for the PELUX SDE. All tests are located in the test directory and are run through pytest.
Dependencies:
pytest
To run the test framework, run the following command in the root directory:
test/run-tests.sh
Note
In order to do clean tests, this script will tear down and destroy the VM if it is already created
Note
Python 3.x version required
Adding new tests¶
The tests are divided in base tests and the rest, the idea is to create a new directory in scripts if you add a new tool or functionality and have those tests in that directory so they can be run independently.
Stubbed SDK¶
Since the SDK takes a long time to download and a long time to extract the tests use stubbed versions of a SDK. The stubbed version sets mock values for everything that is needed during the setup but nothing is actually installed. For instance is cmake setup by the stubbed SDK as a symlink to /bin/true.
Keep in mind that the stubbed SDK is intended to be minimal. Meaning it will not set all environment variables and provide fake installations of all tools installed by a real SDK. Therefore when developing new features for the SDE, it is likely necessary to extend the stubbed SDK with more environment variables or stubbed instances of tools.
Downloading the PELUX-SDE¶
The Software Development Environment for PELUX BASELINE can be found at PELUX SDE GitHub Repo.