Skip to content

Latest commit

 

History

History
99 lines (73 loc) · 4.62 KB

README.md

File metadata and controls

99 lines (73 loc) · 4.62 KB

Computer Systems Oribtal

Welcome to the GitHub repository for the Space And Systems Satellite Club's Computer Systems Team! Our goal is to design and build a CubeSat that will be launched into space. This repository contains the code for our team's computer systems, which will be responsible for controlling and monitoring the CubeSat's various subsystems.

Getting Started

To get started with our code, you'll need to have a basic understanding of programming and the tools we're using. We're primarily using C++ for our code. You'll also need to follow the instructions listed in the following sections:

Prerequisites

A list of software that must be installed before hand:

STM32CubeIDE:

https://www.st.com/en/development-tools/stm32cubeide.html#get-software

STM32 ST-LINK Utility:

https://www.st.com/en/development-tools/stsw-link004.html

Contributing

Contributions are always welcome!

See contributing.md for ways to get started.

Please adhere to this project's code of conduct.

Running Locally

Create a personal access token

A personal access token is need for EGit authorization. To start go to

https://github.com/settings/tokens

Once the webpage has loaded selectGenerate new token-> Generate new token(classic)

Under the "Select Scopes" check the boxes repo and gist and click the Generate token button located at the bottom. You will be given a randomly generated token MAKE SURE TO SAVE THE KEY.

Install EGit

EGit is a marketplace plugin that allows git integration into the STM32CubeIDE.

To setup EGit in STM32CubeIDE

Navigate to

  Help->Eclipse Marketplace

In the "find:" search bar type

  EGit - Git Integration for Eclipse

Hit install and restart STM32CubeIDE when complete.

Cloning the repository

Right click on "Project Explorer" and navigate to Import->Git->Projects from Git->Clone URL. Enter in the "URL:" field

https://github.com/rbretmounet/CS-Ortibal.git

Enter in your github username under user and your github token under password. Click next until the project is imported.

Setting up the project properties

The project properties must be configured so a .bin file is generated when the project is built. In order to do so you must right click orbital_r1 and select properties at the bottom of the list. A new window should open and you must navigate to C/C++ Builds->Settings->MCU Post build outputs. Tick the boxe that says `Convert to binary file (-O binary).

Developing on the board

Connecting the board

The current ST-Link Board has a few pins on the other side, which have a note next to them marking which pin connects to which pin on the Orbital Platform's SWD ports.

Connect the ST-Link Board to the Orbital Platform via the SWD pins.

Connect the board to your computer's USB port and open up STM32 ST-LINK Utility.exe. Navigate to Target -> Connect the device memory should popluate with addresses if successful.

Flashing the board

Navigate to Target->Program. The application with ask your for a file that ends in .bin,.srec, or .hex. If STM32CubeIDE is correctly configured See how to configure. These files are generated in the projects Debug folder. Navigate to the project directory ~/orbital_r1/Debug/ and select the file that ends in the correct file format.

Resources

STM32L476 vendor documentation