A Conformance Test Suite for the IoT protocol MQTT written in TTCN-3.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
This Test Suite is written and tested with Eclipse TITAN, which is the recommended and required TTCN-3 environment.
The MQTT Test Suite has several dependencies to TITAN components (mainly ProtocolModules and TestPorts). The install script automates the installation of the required ProtocolModules and TestPorts.
The script has mainly two variables in the configuration section.
By default, PATH_BASE is set to ~/Titan and defines the base path where the Titan components and the Test Suite will be cloned to.
By default, PATH_CLI_WORKSPACE is set to ~/IoTTestware and defines the base path where your workspace for CLI operation will be located.
./install.sh
Now the required dependencies should be available in PATH_BASE.
With Eclipse Titan you are free to choose to work either from the Command Line (CLI) or from Eclipse IDE.
Open the Titan IDE in your desired workspace and use the import feature
File -> Import -> TITAN -> Project from .tpd file
Klick Next and choose the iottestware.mqtt.tpd from ${PATH_BASE}
Klick Next and choose importation options
Klick Finish and the IDE will import all the required Projects and open the properties for each. Make sure each project is configured to generate Makefile for use with the function test runtime.
If you like to build and run the MQTT Test Suite from the CLI than no further installation is required. The install script already created the ${PATH_CLI_WORKSPACE}/iottestware.mqtt/bin folder, linked all the required files and generated a Makefile accordingly.
Depending on your choice from the previous step you can now decide to build the MQTT Test Suite either from the CLI or IDE.
Note: Building from CLI is possible in both cases. You should always have a Makefile inside the /bin folder.
Right-click the iottestware.mqtt Project and select Build Project.
Note: Make sure you are in the TITAN Editing Perspective, otherwise the Build Project might be not available.
Within the ${PATH_CLI_WORKSPACE}/iottestware.mqtt/bin folder of the MQTT Test Suite you should have an automatically generated Makefile. Simply call the make command to build the executable Test Suite.
make all
Now you should have a newly generated binary file iottestware.mqtt
TODO
TODO
TODO
- Eclipse Titan - TTCN-3 Runtime
- GNU Make - Build automation
We use Github for versioning. For the versions available, see the tags on this repository.
- Alexander Kaiser - Initial work - relayr
See also the list of contributors who participated in this project.
Eclipse Public License - v 1.0
TODO