README.md

SPARCS Mission CDH Repository : Learning Workspace & Future Development

Welcome to the SPARCS Mission Command and Data Handling (CDH) repository! This repo is currently a learning playground for our team as we explore embedded software development with Zephyr RTOS, F´ (Fprime), and STM32 microcontrollers. Our long-term goal is to build robust, modular, and flight-ready software for the SPARCS satellite.

📋 Table of Contents

• SPARCS Mission CDH Repository : Learning Workspace & Future Development
  • 📋 Table of Contents
  • 🎯 Current Purpose
  • 🚀 Long-Term Goals
  • 🗂️ Repository Structure
  • 🛠️ How to Use This Repo
  • 📚 Learning Resources
  • 📬 Contact

🎯 Current Purpose

This repository is a safe space for experimentation and hands-on learning. Here you’ll find:

• Zephyr RTOS sample applications
• F´ (Fprime) test projects
• STM32 microcontroller demos
• Notes and guides as we learn

All code here is experimental and meant for learning, not for production or flight software.

🚀 Long-Term Goals

As we gain experience, this repository will evolve into the core software platform for SPARCS CDH. Our goals:

• Build a modular, maintainable, and scalable codebase for satellite command and data handling
• Integrate Zephyr RTOS and F´ (Fprime) for robust, real-time operations
• Implement reliable interfaces for all major subsystems (ADCS, EPS, Payload, etc.)
• Develop fault detection, isolation, and recovery (FDIR) mechanisms
• Ensure clear documentation and traceability for every component and firmware
• Support both simulation and flight hardware environments

🗂️ Repository Structure

CDH/
├── zephyr-apps/        # Zephyr RTOS example applications
├── fprime-projects/    # Fprime test projects and components
├── stm32-examples/     # STM32 MCU sample code
├── docs/               # Learning notes, guides, and future design reports
├── tests/              # (Planned) Unit and integration tests
├── tools/              # (Planned) Utility scripts and build tools
└── README.md           # This file

🛠️ How to Use This Repo

• Browse the folders above to find example code for each platform.
• Each project folder contains its own README.md with build and run instructions.
• Feel free to copy, modify, or break anything-this is a safe space for experimentation.

📚 Learning Resources

• Zephyr RTOS
  • Zephyr official samples and demos
  • Step-by-step Zephyr tutorial
  • Zephyr example application structure
• F´ (Fprime)
  • F´ documentation and getting started
• STM32
  • STMicroelectronics STM32Cube documentation and examples
  • STM32 tutorial

📬 Contact