Cellulo V1 Installation [Windows]

This guide covers the installation of the Cellulo framework on a Windows desktop for development on said Windows desktop and deployment to Windows.

Qt Bluetooth functionality, essential to Cellulo operation, is limited as of now to the Universal Windows Platform (also known as WinRT) and does not yet work on win32 (native Windows build). See https://bugreports.qt.io/browse/QTBUG-40698 and https://doc.qt.io/qt-5.10/qtbluetooth-index.html. This means that cellulorobotpoold will likely never work until Qt Bluetooth win32 port is complete, as UWP apps do not support interprocess communication. This also means that Windows 8 and earlier are unfortunately not supported.

Tested:

• On Windows 10 (will likely //not// work on earlier versions such as Windows 8 and 7)
• With Qt 5.10.1

###libdots installation

This is to obtain the command-line tool to overlay the dot pattern on PDFs for localization.

1. Install a Cygwin environment or alternative, I recommend Babun: https://babun.github.io/
2. Install cmake, libpodofo-devel, libfreetype-devel and gcc-g++ in your Cygwin-like environment:

• $ pact install cmake libpodofo-devel libfreetype-devel gcc-g++

2. Clone https://c4science.ch/diffusion/514/libdots.git, the tool is in tools/pdf-overlayer/.
3. Follow the build instructions at https://c4science.ch/diffusion/514/browse/master/tools/pdf-overlayer/README.md.
4. Use as $ libdots-pdf-overlayer -i mypage.pdf -o mypage-dotted.pdf from inside your Cygwin-like environment.

###Qt framework installation

This is to set up the development environment necessary for Cellulo.

1. Install Visual Studio 2017. When installing, select Universal Windows Platform development package from Workloads and from its optional components, select C++ Universal Windows Platform tools.
2. Download Qt Open Source installer from the internet, it should be named something like qt-unified-windows-x86-3.0.4-online.exe.
3. Launch and follow the installer.
4. Create an account or login.
5. Install in C:\Qt (should be the default). You can install somewhere else but you'll have to adapt the path accordingly in the future.
6. Select UWP x64 (MSVC 2017) from Qt 5.10.1, others are not necessary.
7. Finish install.

###cellulo-qml-plugin installation

This installs the Cellulo QML plugin which provides the API to work with the robots.

1. Clone https://c4science.ch/diffusion/505/cellulo-qml-plugin.git.
2. Set up your github ssh keys on your machine, you can follow https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/ and then https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/.
3. Follow the build instructions for Windows desktop at https://c4science.ch/diffusion/505/browse/master/README.md.

###Other qml plugins installation

These are necessary plugins that work alongside cellulo-qml-plugin.

1. Clone the following:
   • https://github.com/chili-epfl/qml-bluetooth-extras
   • https://github.com/chili-epfl/qml-logger
   • https://github.com/chili-epfl/qml-cache
   • https://github.com/chili-epfl/qml-extra-data-structures
2. Follow the build instructions at the README.md files within the plugins, they are the exact same as cellulo-qml-plugin.

###Test an application on the Windows desktop

1. Launch Qt Creator.
2. From Open Project in the main screen, load cellulo-qml-plugin/samples/cellulo-hello-world/cellulo-hello-world.pro.
3. Select the UWP 64bit configuration.
4. Select just the Release and not the Debug or Release builds.
5. When project is loaded, click the big green arrow button to launch (again, make sure Release build is selected there and not Debug or Release builds).