Skip to content

Instantly share code, notes, and snippets.

View juancols's full-sized avatar

Juan Cols juancols

  • Zürich, Switzerland
View GitHub Profile
@juancols
juancols / the-perfect-project-directory.md
Last active December 19, 2022 06:55
The perfect directory for embedded C projects loosely based on "The Pitchfork Layout (PFL)".

The perfect project directory

This is (my) perfect directory for embedded C projects. It is loosely base on The Pitchfork Layout (PFL) which is a convention for laying out source, build, and resource files widely accepted by the C/C++ community. It is designed to provide a clear and organized structure for the project, making it easier to maintain and debug.

Top-level directories

The original PFL describes 11 top-level directories. Depending on the simplicity of the project, you can consider some of them non-essential like data/ or examples/. So feel free to skip them depending on your needs. I've added bin/ which contains the binary files for a specific architecture.

bin/
@juancols
juancols / stm32-on-macos-m1.md
Last active May 14, 2024 22:10
STM32 toolchain setup on macOS M1

STM32 toolchain setup on macOS M1

Note: these steps were tested on a MacBook Air M1 2020, 8 GB RAM and macOS Ventura 13.0.1

STM32CubeProgrammer

1. Download

You can get the latest version of the STM32CubePrg-Mac package at STm dev-tools website. The version I used in this guide was the 2.12.0. image

2. Installation