Demo Project using Git Submodule

This repository demonstrates a custom feature built upon space_station_os, which is included as a Git submodule.

Purpose

(Describe the purpose of this demo here, e.g., testing custom thermal control logic, evaluating new GNC algorithm, etc.)

Prerequisites

(List your prerequisites here, e.g., Python 3.10+, Gazebo Harmonic (or compatible simulator), ROS 2 Humble, etc.)

Setup

Clone this repository with submodule: git clone –recurse-submodules https://github.com/yourname/demo_xyz.git cd demo_xyz

Then build the workspace: mkdir -p ros2_ws/src mv demo_xyz ros2_ws/src/ cd ros2_ws colcon build

Notes

  • This project uses a fixed version of space_station_os as a submodule.

  • This approach is suitable for development that is planned to be upstreamed later.

  • You are free to explore and modify the code locally.

Optional: Updating the Integration Repository

If you wish to fetch a newer version of space_station_os, you can:

cd space_station_os
git checkout main  # or a specific tag
git pull
cd ..
git add space_station_os
git commit -m "Update submodule"

Caution: If you plan to contribute your changes back to the integration repository, you must submit a pull request with appropriate justification and testing. Do not push directly to the main branch.