| Library | License |
|---|---|
| Lua libs | |
| liblua5.2 | MIT |
| json4lua | MIT |
| lua-stdlib | MIT |
| lua-lpeg | |
| Qt libs | |
| Qt5.3 WebSockets | LGPL 2.1 |
| Qt5.3 Network | LGPL 2.1 |
| Qt5.3 Core | LGPL 2.1 |
| Qt5.3 Test | LGPL 2.1 |
| Other libs | |
| lpthread | LGPL |
| libxml2 | MIT |
| ldoc | MIT/X11 |
For ATF usage:
sudo apt-get install liblua5.2 libxml2 lua-lpeg
$ git clone https://github.com/smartdevicelink/sdl_atf
$ cd sdl_atf
$ git submodule init
$ git submodule update
1 Install 3d-parties developers libraries
sudo apt-get install liblua5.2-dev libxml2-dev lua-lpeg-dev
2 Install Qt5.3+
sudo chmod +x some-qt-build.run
./some-qt-build.run
2 Setup QMAKE environment variable to path to qmake
export QMAKE=${PATH_TO_QMAKE}
You can get path to qmake this way:
$ sudo find / -name qmake
/usr/bin/qmake
/opt/Qt5.3.1/5.3/gcc/bin/qmake
/usr/bin/qmake in most cases does not work as it is just soft link to qtchooser
2 $ make
- If during executing "make" command you have the following problem: Project ERROR: Unknown module(s) in QT: websockets
Solution: You have to change location of qmake in Makefile in atf root directory Find location of qmake executable on your local PC: (It should look like: .../Qt/5.3/gcc_64/bin/qmake)
and put it into Makefile to the line: QMAKE= Sometimes you will need reinstall QT Creator to get correct qmake executable Also you can open QT Creator. Then go to: Tool->Options->Build & Run. Find Qt Versions Tab. Here you can find qmake location.
./start.sh [options] [script file name]
Download and install ldoc
sudo apt install luarocks
sudo luarocks install luasec
sudo luarocks install penlight
sudo luarocks install ldoc
sudo luarocks install discount
cd sdl_atf
ldoc -c docs/config.ld .
chromium-browser docs/html/index.html
You can setup path to SDL via command line with --sdl-core option.
Example :
./start.sh --sdl-core=/home/user/development/sdl/build/bin ./test_scripts/ActivationDuringActiveState.lua
Or via config file(modules/config.lua) with config parameter
Example : ATF config : modules/config.lua :
config.pathToSDL = "home/user/development/sdl/build/bin"
also you can copy modules/config.lua to root and rename to local_config.lua.
local_config.lua is added to .gitignore
Usage example:
./start.sh -clocal_config.lua ATF_script.lua
ATF is able to connect to already started SDL. Note that you should be sure that:
- ATF is configured not to start SDL
- SDL is configured not to start HMI
- mobile and HMI sockets options match each other in SDL and ATF configs.
Example :
ATF config : modules/config.lua :
config.autorunSDL = false
config.hmiUrl = "ws://localhost"
config.hmiPort = 8087
config.mobileHost = "localhost"
config.mobilePort = 12345
SDL config : smartDeviceLink.ini :
[HMI]
; Open the $LinkToWebHMI in chromium browser
LaunchHMI = false
; WebSocket connection address and port
ServerAddress = 127.0.0.1
ServerPort = 8087
[TransportManager]
; Listening port form incoming TCP mobile connection
TCPAdapterPort = 12345
make test