From 9b2ab66c0a608c08eabbb9f337822ea0966e4d6f Mon Sep 17 00:00:00 2001 From: Robin Mueller Date: Mon, 26 Jul 2021 00:42:33 +0200 Subject: [PATCH] readme update --- README.md | 600 ++++++++++++++++++++++++++++++++---------------------- 1 file changed, 354 insertions(+), 246 deletions(-) diff --git a/README.md b/README.md index 89e2514a..21ee5e40 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,23 @@ EIVE On-Board Software ====== -# General information +# Index + +1. [General](#general) +2. [Prerequisites](#prereq) +3. [Building the Software](#build) +4. [Useful and Common Host Commands](#host-commands) +5. [Setting up Prerequisites](#set-up-prereq) +6. [Remote Debugging](#remote-debugging) +7. [Direct Debugging](#direct-debugging) +8. [Transfering Files to the Q7S](#file-transfer) +9. [Q7S OBC](#q7s) +10. [Static Code Analysis](#static-code-analysis) +11. [Eclipse](#eclipse) +12. [Running the OBSW on a Raspberry Pi](#rpi) +13. [FSFW](#fsfw) + +# General information Target systems: @@ -36,16 +52,169 @@ The CMake build system can be used to generate build systems as well (see helper - Linux Host: Uses the `bsp_hosted` BSP folder and the CMake Unix Makefiles generator. - Windows Host: Uses the `bsp_hosted` BSP folder, the CMake MinGW Makefiles generator and MSYS2. -# Setting up development environment +# Prerequisites -## Installing Vivado the the Xilinx development tools +There is a separate [prerequisites](#set-up-prereq) which specifies how to set up all +prerequisites. + +## Building the OBSW and flashing it on the Q7S + +1. ARM cross-compiler installed, either as part of [Vivado 2018.2 installation](#vivado) or + as a [separate download](#arm-toolchain) +2. [Q7S sysroot](#q7s-sysroot) on local development machine +3. Recommended: Eclipse or [Vivado 2018.2 SDK](#vivado) for OBSW development +3. [TCF agent] running on Q7S + +## Hardware Design + +1. [Vivado 2018.2](#vivado) for programmable logic design + +# Building the software + +## CMake + +When using Windows, run theses steps in MSYS2. + +1. Clone the repository with + + ```sh + git clone https://egit.irs.uni-stuttgart.de/eive/eive_obsw.git + ``` + +2. Update all the submodules + + ```sh + git submodule init + git submodule sync + git submodule update + ``` + +3. Ensure that the cross-compiler is working with `arm-linux-gnueabihf-gcc --version`. + It is recommended to set up a shell script which takes care of setting up the environment + for convenience or to set up the + [PATH and the CROSS_COMPILE variable permanently](https://unix.stackexchange.com/questions/26047/how-to-correctly-add-a-path-to-path) + in the `.profile` file. + +4. Run the CMake configuration to create the build system in a `build-Debug-Q7S` folder. + Add `-G "MinGW Makefiles` in MinGW64 on Windows. + + ```sh + mkdir build-Debug-Q7S && cd build-Debug-Q7S + cmake -DTGT_BSP="arm/q7s" -DCMAKE_BUILD_TYPE=Debug -DOS_FSFW=linux .. + cmake --build . -j + ``` + + You can also use provided shell scripts to perform these commands + + ```sh + cd cmake/scripts/Q7S + ./make_debug_cfg.sh + cd ../../.. + ``` + + This will invoke a Python script which in turn invokes CMake with the correct + arguments to configure CMake for Q7S cross-compilation. + + You can build the hosted variant of the OBSW by replacing `-DOS_FSFW=linux` with + `-DOS_FSFW=host`. There are also different values for `-DTGT_BSP` to build for the Raspberry Pi + or the Beagle Bone Black: `arm/raspberrypi` and `arm/beagleboneblack`. + +5. Build the software with + ```sh + cd build-Debug-Q7S + cmake --build . -j + ``` + +## Building in Xilinx SDK 2018.2 + +1. Open Xilinx SDK 2018.2 +2. Import project + * File → Import → C/C++ → Existing Code as Makefile Project +3. Set build command. Replace \ with either debug or release. + * When on Linux right click project → Properties → C/C++ Build → Set build command to `make -j` + * -j causes the compiler to use all available cores + * The target is used to either compile the debug or the optimized release build. + * On windows create a make target additionally (Windows → Show View → Make Target) + * Right click eive_obsw → New + * Target name: all + * Uncheck "Same as the target name" + * Uncheck "Use builder settings" + * As build command type: `cmake --build .` + * In the Behaviour tab, you can enable build acceleration +4. Run build command by double clicking the created target or by right clicking + the project folder and selecting Build Project. + +# Useful and Common Commands (Host) + +## Connect to EIVE flatsat + +### DNS + +```sh +ssh eive@flatsat.eive.absatvirt.lw +``` + +### IPv6 +```sh +ssh eive@2001:7c0:2018:1099:babe:0:e1fe:f1a5 +``` + +### IPv4 + +```sh +ssh eive@192.168.199.227 +``` + +## Port forwarding for connection to TCF agent + +This is a required step to connect to the `tcf-agent` on the Q7S, which is required for convenient +remote debugging. Assuming the IPv6 + +```sh +ssh -L 1534:192.168.133.10:1534 eive@2001:7c0:2018:1099:babe:0:e1fe:f1a5 -t /bin/bash +``` + +You then need to connect to `localhost` with port `1534`. + +## Port forwarding for file transfers with `scp` + +```sh +ssh -L 1535:192.168.133.10:22 eive@2001:7c0:2018:1099:babe:0:e1fe:f1a5 -t /bin/bash +``` + +You then need to run `scp` with the `-P 1535` flag with `localhost` as the target IP address. + +## Port forwarding for TMTC commanding + +This requires using the TCP on sender side (Python client) and receiver side (OBSW TMTC TCP server). + +```sh +ssh -L 1536:192.168.133.10:7301 eive@2001:7c0:2018:1099:babe:0:e1fe:f1a5 -t /bin/bash +``` + +## Set up all port forwarding at once + +You can specify the `-L` option multiple times to set up all port forwarding at once + +```sh +ssh -L 1534:192.168.133.10:1534 \ + -L 1535:192.168.133.10:22 \ + -L 1536:192.168.133.10:7301 \ + eive@2001:7c0:2018:1099:babe:0:e1fe:f1a5 \ + -t /bin/bash +``` + +# Setting up prerequisites + +## Installing Vivado the the Xilinx development tools It's also possible to perform debugging with a normal Eclipse installation by installing the TCF plugin and downloading the cross-compiler as specified in the section below. However, if you want to generate the `*.xdi` files necessary to update the firmware, you need to installed Vivado with the SDK core tools. -* Install Vivado 2018.2 and Xilinx SDK from https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools/archive.html. +* Install Vivado 2018.2 and + [Xilinx SDK](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools/archive.html). Install the Vivado Design Suite - HLx Editions - 2018.2 Full Product Installation instead of the updates. It is recommended to use the installer. @@ -85,7 +254,7 @@ For Linux, you can also download a more recent version of the [Linaro 8.3.0 cross-compiler](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-a/downloads) from [here](https://developer.arm.com/-/media/Files/downloads/gnu-a/8.3-2019.03/binrel/gcc-arm-8.3-2019.03-x86_64-arm-linux-gnueabihf.tar.xz?revision=e09a1c45-0ed3-4a8e-b06b-db3978fd8d56&la=en&hash=93ED4444B8B3A812B893373B490B90BBB28FD2E3) -## Installing toolchain without Vivado +## Installing toolchain without Vivado You can download the toolchains for Windows and Linux [from the EIVE cloud](https://eive-cloud.irs.uni-stuttgart.de/index.php/apps/files?dir=/EIVE_IRS/Software/tools&fileid=831898). @@ -136,7 +305,7 @@ wget https://eive-cloud.irs.uni-stuttgart.de/index.php/s/2Fp2ag6NGnbtAsK/downloa sudo apt-get install cmake ```` -## Getting the Q7S system root +## Getting the Q7S system root It is necessary to copy the Q7S system root to your local development machine for libraries like `libgpio`. You can find the system root for the Q7S, the Raspberry Pi and the @@ -151,102 +320,58 @@ wget https://eive-cloud.irs.uni-stuttgart.de/index.php/s/agnJGYeRf6fw2ci/downloa Then, create a new environmental variables `Q7S_SYSROOT` and set it to the local system root path. -# Building the software with CMake +## Setting up UNIX environment for real-time functionalities -When using Windows, run theses steps in MSYS2. +Please note that on most UNIX environments (e.g. Ubuntu), the real time functionalities +used by the UNIX pthread module are restricted, which will lead to permission errors when creating +these tasks and configuring real-time properites like scheduling priorities. -1. Clone the repository with +To solve this issues, try following steps: + +1. Edit the /etc/security/limits.conf +file and add following lines at the end: +```sh + hard rtprio 99 + soft rtprio 99 +``` +The soft limit can also be set in the console with `ulimit -Sr` if the hard +limit has been increased, but it is recommended to add it to the file as well for convenience. +If adding the second line is not desired for security reasons, +the soft limit needs to be set for each session. If using an IDE like eclipse +in that case, the IDE needs to be started from the console after setting +the soft limit higher there. After adding the two lines to the file, +the computer needs to be restarted. + +It is also recommended to perform the following change so that the unlockRealtime +script does not need to be run anymore each time. The following steps +raise the maximum allowed message queue length to a higher number permanently, which is +required for some framework components. The recommended values for the new message +length is 130. + +2. Edit the /etc/sysctl.conf file ```sh - git clone https://egit.irs.uni-stuttgart.de/eive/eive_obsw.git + sudo nano /etc/sysctl.conf ``` -2. Update all the submodules - + Append at end: ```sh - git submodule init - git submodule sync - git submodule update - ``` - -3. Ensure that the cross-compiler is working with `arm-linux-gnueabihf-gcc --version`. - It is recommended to run the shell script `win_path_helper_xilinx_tools.sh` in `cmake/scripts/Q7S` - or to set up the [PATH and the CROSS_COMPILE variable permanently](https://unix.stackexchange.com/questions/26047/how-to-correctly-add-a-path-to-path) - in the `.profile` file. - -4. Run the CMake configuration to create the build system in a `build-Debug-Q7S` folder. - Add `-G "MinGW Makefiles` in MinGW64 on Windows. - - ```sh - mkdir build-Debug-Q7S && cd build-Debug-Q7S - cmake -DTGT_BSP="arm/q7s" -DCMAKE_BUILD_TYPE=Debug -DOS_FSFW=linux .. - cmake --build . -j - ``` - - You can also use provided shell scripts to perform these commands - - ```sh - cd cmake/scripts/Q7S - ./make_debug_cfg.sh - cd ../../.. - ``` - - This will invoke a Python script which in turn invokes CMake with the correct - arguments to configure CMake for Q7S cross-compilation. - - You can build the hosted variant of the OBSW by replacing `-DOS_FSFW=linux` with - `-DOS_FSFW=host`. There are also different values for `-DTGT_BSP` to build for the Raspberry Pi - or the Beagle Bone Black: `arm/raspberrypi` and `arm/beagleboneblack`. - -5. Build the software with - ```sh - cd Debug - cmake --build . -j + fs/mqueue/msg_max = ``` -## Setting up default Eclipse for Q7S projects - TCF agent + Apply changes with: + ```sh + sudo sysctl -p + ``` -The [TCF agent](https://wiki.eclipse.org/TCF) can be used to perform remote debugging on the Q7S. + A possible solution which only persists for the current session is + ```sh + echo | sudo tee /proc/sys/fs/mqueue/msg_max + ``` -1. Install the TCF agent plugin in Eclipse from the [releases](https://www.eclipse.org/tcf/downloads.php). Go to Help → Install New Software and use the download page, for example https://download.eclipse.org/tools/tcf/releases/1.6/1.6.2/ to search for the plugin and install it. +## TCF-Agent -2. Go to Window → Perspective → Open Perspective and open the **Target Explorer Perspective**. - Here, the Q7S should show up if the local port forwarding was set up as explained previously. Please note that you have to connect to `localhost` and port `1534` with port forwaring set up. - -3. A launch configuration was provided, but it might be necessary to adapt it for your own needs. Alternatively: - - - Create a new **TCF Remote Application** by pressing the cogs button at the top or going to Run → Debug Configurations → Remote Application and creating a new one there. - - - Set up the correct image in the main tab (it might be necessary to send the image to the Q7S manually once) and file transfer properties - - - It is also recommended to link the correct Eclipse project. - -After that, comfortable remote debugging should be possible with the Debug button. - -A build configuration and a shell helper script has been provided to set up the path variables and -build the Q7S binary on Windows, but a launch configuration needs to be newly created because the -IP address and path settings differ from machine to machine. - -## Building in Xilinx SDK 2018.2 - -1. Open Xilinx SDK 2018.2 -2. Import project - * File → Import → C/C++ → Existing Code as Makefile Project -3. Set build command. Replace \ with either debug or release. - * When on Linux right click project → Properties → C/C++ Build → Set build command to `make -j` - * -j causes the compiler to use all available cores - * The target is used to either compile the debug or the optimized release build. - * On windows create a make target additionally (Windows → Show View → Make Target) - * Right click eive_obsw → New - * Target name: all - * Uncheck "Same as the target name" - * Uncheck "Use builder settings" - * As build command type: `cmake --build .` - * In the Behaviour tab, you can enable build acceleration -4. Run build command by double clicking the created target or by right clicking - the project folder and selecting Build Project. - -## TCF-Agent +Most of the steps specified here were already automated 1. On reboot, some steps have to be taken on the Q7S. Set static IP address and netmask @@ -264,7 +389,7 @@ IP address and path settings differ from machine to machine. You can run it manually there. To perform auto-start on boot, have a look at the start-up application section. -# Debugging the software via Flatsat PC +# Remote Debugging Open SSH connection to flatsat PC: @@ -298,6 +423,7 @@ console of the Q7S like this to set it picocom -b 115200 /dev/ttyUSB0 ``` +The flatsat has the aliases and shell scripts `q7s_ssh` and `q7s_serial` for this task as well. If the serial port is blocked for some reason, you can kill the process using it with `q7s_kill`. @@ -325,13 +451,68 @@ ssh -L 1534:192.168.133.10:1534 eive@2001:7c0:2018:1099:babe:0:e1fe:f1a5 -t bash ``` This forwards any requests to localhost:1534 to the port 1534 of the Q7S with the IP address -192.168.133.10. -This needs to be done every time, so it is recommended to create an alias to do this quickly. +192.168.133.10. This needs to be done every time, so it is recommended to create an +alias or shell script to do this quickly. Note: When now setting up a debug session in the Xilinx SDK or Eclipse, the host must be set to localhost instead of the IP address of the Q7S. -# Transfering files via SCP +# Direct Debugging + +1. Assign static IP address to Q7S + * Open serial console of Q7S (Accessible via the micro-USB of the PIM, see also Q7S user + manual chapter 10.3) + * Baudrate 115200 + * Login to Q7S: + * user: root + * pw: root + +2. Connect Q7S to workstation via ethernet +3. Make sure the netmask of the ehternet interface of the workstation matches the netmask of the Q7S + * When IP address is set to 192.168.133.10 and the netmask is 255.255.255.0, an example IP address for the workstation + is 192.168.133.2 + +4. Run tcf-agent on Q7S + + * Tcf-agent is not yet integrated in the rootfs of the Q7S. Therefore build tcf-agent manually + + ```sh + git clone git://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git + cd org.eclipse.tcf.agent/agent + make CC=arm-linux-gnueabihf-gcc LD=arm-linux-gnueabihf-ld MACHINE=arm NO_SSL=1 NO_UUID=1 + ``` + + * Transfer executable agent from org.eclipse.tcf.agent/agent/obj/GNU/Linux/arm/Debug to /tmp of Q7S + + ```sh + cd obj/GNU/Linux/arm/Debug + scp agent root@192.168.133.10:/tmp + ``` + + * On Q7S + ```sh + cd /tmp + chmod +x agent + ``` + + * Run agent + ```sh + ./agent + ``` + +5. In Xilinx SDK 2018.2 right click on project → Debug As → Debug Configurations +6. Right click Xilinx C/C++ applicaton (System Debugger) → New → +7. Set Debug Type to Linux Application Debug and Connectin to Linux Agent +8. Click New +9. Give connection a name +10. Set Host to static IP address of Q7S. e.g. 192.168.133.10 +11. Test connection (This ensures the TCF Agent is running on the Q7S) +12. Select Application tab + * Project Name: eive_obsw + * Local File Path: Path to eiveobsw-linux.elf (in `_bin\linux\devel`) + * Remote File Path: `/tmp/eive_obsw.elf` + +# Transfering Files to the Q7S To transfer files from the local machine to the Q7S, use port forwarding @@ -355,7 +536,11 @@ From a windows machine files can be copied with putty tools (note: use IPv4 addr pscp -scp -P 22 eive@192.168.199.227:/example-file ```` -# Launching an application at start-up +More detailed information about the used q7s commands can be found in the Q7S user manual. + +# Q7S + +## Launching an application at start-up Load the root partiton from the flash memory (there are to nor-flash memories and each flash holds two xdi images). Note: It is not possible to modify the currently loaded root partition, e.g. @@ -420,58 +605,7 @@ creating directories. To do this, the parition needs to be mounted. systemctl status example ``` -More detailed information about the used q7s commands can be found in the Q7S user manual. - -## Setting up UNIX environment for real-time functionalities - -Please note that on most UNIX environments (e.g. Ubuntu), the real time functionalities -used by the UNIX pthread module are restricted, which will lead to permission errors when creating -these tasks and configuring real-time properites like scheduling priorities. - -To solve this issues, try following steps: - -1. Edit the /etc/security/limits.conf -file and add following lines at the end: -```sh - hard rtprio 99 - soft rtprio 99 -``` -The soft limit can also be set in the console with `ulimit -Sr` if the hard -limit has been increased, but it is recommended to add it to the file as well for convenience. -If adding the second line is not desired for security reasons, -the soft limit needs to be set for each session. If using an IDE like eclipse -in that case, the IDE needs to be started from the console after setting -the soft limit higher there. After adding the two lines to the file, -the computer needs to be restarted. - -It is also recommended to perform the following change so that the unlockRealtime -script does not need to be run anymore each time. The following steps -raise the maximum allowed message queue length to a higher number permanently, which is -required for some framework components. The recommended values for the new message -length is 130. - -2. Edit the /etc/sysctl.conf file - - ```sh - sudo nano /etc/sysctl.conf - ``` - - Append at end: - ```sh - fs/mqueue/msg_max = - ``` - - Apply changes with: - ```sh - sudo sysctl -p - ``` - - A possible solution which only persists for the current session is - ```sh - echo | sudo tee /proc/sys/fs/mqueue/msg_max - ``` - -# PCDU +## PCDU Connect to serial console of P60 Dock ```` @@ -496,102 +630,6 @@ p60-dock # param get out_en[0] GET out_en[0] = 1 ```` -# Debugging the software (when workstation is directly conncected to Q7S) - -1. Assign static IP address to Q7S - * Open serial console of Q7S (Accessible via the micro-USB of the PIM, see also Q7S user - manual chapter 10.3) - * Baudrate 115200 - * Login to Q7S: - * user: root - * pw: root - -2. Connect Q7S to workstation via ethernet -3. Make sure the netmask of the ehternet interface of the workstation matches the netmask of the Q7S - * When IP address is set to 192.168.133.10 and the netmask is 255.255.255.0, an example IP address for the workstation - is 192.168.133.2 - -4. Run tcf-agent on Q7S - - * Tcf-agent is not yet integrated in the rootfs of the Q7S. Therefore build tcf-agent manually - - ```sh - git clone git://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git - cd org.eclipse.tcf.agent/agent - make CC=arm-linux-gnueabihf-gcc LD=arm-linux-gnueabihf-ld MACHINE=arm NO_SSL=1 NO_UUID=1 - ``` - - * Transfer executable agent from org.eclipse.tcf.agent/agent/obj/GNU/Linux/arm/Debug to /tmp of Q7S - - ```sh - cd obj/GNU/Linux/arm/Debug - scp agent root@192.168.133.10:/tmp - ``` - - * On Q7S - ```sh - cd /tmp - chmod +x agent - ``` - - * Run agent - ```sh - ./agent - ``` - -5. In Xilinx SDK 2018.2 right click on project → Debug As → Debug Configurations -6. Right click Xilinx C/C++ applicaton (System Debugger) → New → -7. Set Debug Type to Linux Application Debug and Connectin to Linux Agent -8. Click New -9. Give connection a name -10. Set Host to static IP address of Q7S. e.g. 192.168.133.10 -11. Test connection (This ensures the TCF Agent is running on the Q7S) -12. Select Application tab - * Project Name: eive_obsw - * Local File Path: Path to eiveobsw-linux.elf (in `_bin\linux\devel`) - * Remote File Path: `/tmp/eive_obsw.elf` - -# Running cppcheck on the Software - -Static code analysis can be useful to find bugs. -`cppcheck` can be used for this purpose. On Windows you can use MinGW64 to do this. - -```sh -pacman -S mingw-w64-x86_64-cppcheck -``` - -On Ubuntu, install with - -```sh -sudo apt-get install cppcheck -``` - -You can use the Eclipse integration or you can perform the scanning manually from the command line. -CMake will be used for this. - -Run the CMake build generation commands specified above but supply -`-DCMAKE_EXPORT_COMPILE_COMMANDS=ON` to the build generation. Invoking the build command will -generate a `compile_commands.json` file which can be used by cppcheck. - -```sh -cppcheck --project=compile_commands.json --xml 2> report.xml -``` - -Finally, you can convert the generated `.xml` file to HTML with the following command - -```sh -cppcheck-htmlreport --file=report.xml --report-dir=cppcheck --source-dir=.. -``` - -# Special notes on Eclipse - -When using Eclipse, there are two special build variables in the project properties -→ C/C++ Build → Build Variables called `Q7S_SYSROOT` or `RPI_SYSROOT`. You can set -the sysroot path in those variables to get any additional includes like `gpiod.h` in the -Eclipse indexer. - -# Q7S Utilities and Troubleshooting - ## Core commands Display currently running image: @@ -786,7 +824,76 @@ EIVE implementation - Folder `tm` for telemetry - Folder `xdi` for XDI components (e.g. for firmware or device tree updates) -# Running the EIVE OBSW on a Raspberry Pi +# Running cppcheck on the Software + +Static code analysis can be useful to find bugs. +`cppcheck` can be used for this purpose. On Windows you can use MinGW64 to do this. + +```sh +pacman -S mingw-w64-x86_64-cppcheck +``` + +On Ubuntu, install with + +```sh +sudo apt-get install cppcheck +``` + +You can use the Eclipse integration or you can perform the scanning manually from the command line. +CMake will be used for this. + +Run the CMake build generation commands specified above but supply +`-DCMAKE_EXPORT_COMPILE_COMMANDS=ON` to the build generation. Invoking the build command will +generate a `compile_commands.json` file which can be used by cppcheck. + +```sh +cppcheck --project=compile_commands.json --xml 2> report.xml +``` + +Finally, you can convert the generated `.xml` file to HTML with the following command + +```sh +cppcheck-htmlreport --file=report.xml --report-dir=cppcheck --source-dir=.. +``` + +# Eclipse + +When using Eclipse, there are two special build variables in the project properties +→ C/C++ Build → Build Variables called `Q7S_SYSROOT` or `RPI_SYSROOT`. You can set +the sysroot path in those variables to get any additional includes like `gpiod.h` in the +Eclipse indexer. + +## Setting up default Eclipse for Q7S projects - TCF agent + +The [TCF agent](https://wiki.eclipse.org/TCF) can be used to perform remote debugging on the Q7S. + +1. Install the TCF agent plugin in Eclipse from + the [releases](https://www.eclipse.org/tcf/downloads.php). Go to + Help → Install New Software and use the download page, for + example https://download.eclipse.org/tools/tcf/releases/1.6/1.6.2/ to search for the plugin and install it. + +2. Go to Window → Perspective → Open Perspective and open the **Target Explorer Perspective**. + Here, the Q7S should show up if the local port forwarding was set up as explained previously. + Please note that you have to connect to `localhost` and port `1534` with port forwaring set up. + +3. A launch configuration was provided, but it might be necessary to adapt it for your own needs. + Alternatively: + + - Create a new **TCF Remote Application** by pressing the cogs button at the top or going to + Run → Debug Configurations → Remote Application and creating a new one there. + + - Set up the correct image in the main tab (it might be necessary to send the image to the + Q7S manually once) and file transfer properties + + - It is also recommended to link the correct Eclipse project. + +After that, comfortable remote debugging should be possible with the Debug button. + +A build configuration and a shell helper script has been provided to set up the path variables and +build the Q7S binary on Windows, but a launch configuration needs to be newly created because the +IP address and path settings differ from machine to machine. + +# Running the EIVE OBSW on a Raspberry Pi Special section for running the EIVE OBSW on the Raspberry Pi. The Raspberry Pi build uses the `bsp_rpi` BSP folder, and a very similar cross-compiler. @@ -802,7 +909,7 @@ sudo apt-get install gpiod libgpiod-dev to install the required GPIO libraries before cloning the system root folder. -# Flight Software Framework (FSFW) +# Flight Software Framework (FSFW) An EIVE fork of the FSFW is submodules into this repository. To add the master upstream branch and merge changes and updates from it @@ -819,4 +926,5 @@ After that, an update can be merged by running git merge upstream/master ``` -Alternatively, changes from other upstreams (forks) and branches can be merged like that in the same way. +Alternatively, changes from other upstreams (forks) and branches can be merged like that +in the same way.