LunaUI is a Qt6 Widgets-based desktop application that accompanies LunaSys. As a desktop user interface, the purpose of LunaUI is to provide image viewing and video playback functionality for frames captured by the camera module used in LunaSys, ultimately acting as the application-level component connected to an embedded system. The UI also affords basic serial logging functionality.
At this time, only build instructions for Windows are available.
LunaUI is developed using Qt 6.4.1
, is built using CMake
and Ninja
, and is compiled using MinGW 11.20
for 64-bit systems. Qt6 requires a minimum CMake version of 3.16
. The easiest way to satisfy these dependency requirements is to simply download the Qt for open-source development for free and check off MinGW, CMake, and Ninja using the Online Installer. On Windows, add g++ (from MinGW), CMake, and Ninja to the system PATH. Add the path to the Qt binaries (<QT_INSTALL_DIR>\<QT_VERSION>\<MINGW_ARCH>\bin
) to the system PATH as well.
These steps are applicable only once the prerequisites have been met.
- Clone the project using HTTPS.
git clone https://github.com/Henchel-Santillan/LunaUI.git
- Go into the root of the cloned repository, create a build directory, and change into the build directory.
cd <path\to\LunaUI\clone>
mkdir build && cd build
- Once in the build directory, run the
cmake
command with the following flags:
cmake -DCMAKE_PREFIX_PATH=<QT_INSTALL_DIR>\<QT_VERSION>\<MINGW_ARCH>\lib\cmake -DCMAKE_BUILD_TYPE:STRING=Debug -DCMAKE_CXX_COMPILER:FILEPATH=<QT_INSTALL_DIR>\Tools\<MINGW_VERSION_ARCH>\bin\g++.exe -DCMAKE_GENERATOR:STRING=Ninja -DCMAKE_MAKE_PROGRAM:FILEPATH=<QT_INSTALL_DIR>\Tools\Ninja\ninja.exe -S <path\to\LunaUI\clone\root> -B <path\to\LunaUI\clone\build\dir>
<QT_INSTALL_DIR>
is the install path you specified using the online installer (e.g.C:\Qt\
on Windows)<QT_VERSION>
is the full Qt version of your installation, e.g.6.4.1
<MINGW_VERSION_ARCH>
is MinGW bundled with the Qt installation, specifying both version and architecture (e.g.mingw1120_64
)
- Run the
ninja
command. - Run
start LunaUI.exe
.
An alternative to doing steps 3 to 5 is to use the build-lunaui.bat
script in the scripts
directory. Ensure that the CMake option variables are configured for your setup.
- Configuring blocking (polling) method to work with UART and STM32 Virtual COM Port Driver via Micro USB Type-B connection
- Image Viewer feature module