diff --git a/README.md b/README.md index cfbcde69..d9dafc94 100644 --- a/README.md +++ b/README.md @@ -125,10 +125,21 @@ git clone https://github.com/arduino/ArduinoCore-zephyr ### Pre-requirements Before running the installation script, ensure that Python, `pip` and `venv` are installed on your system. The script will automatically install `west` and manage the necessary dependencies. -On Ubuntu or similar `apt`-based distros, make sure to run the following command: +#### On Ubuntu or similar apt-based distros ```bash sudo apt install python3-pip python3-setuptools python3-venv build-essential git cmake ninja-build zstd jq ``` +#### On macOS +Make sure you have Homebrew installed. Then run: + +```bash +# Install Xcode Command Line Tools (needed for compilers and make) +xcode-select --install + +# Install required tools and libraries +brew install python cmake ninja zstd jq git +``` +Note: Homebrew’s Python installation already includes `pip`, `setuptools` and `venv`. ### Run the ```bootstrap``` script ```bash @@ -169,16 +180,37 @@ associated variant will be updated. ### Flash the Loader -If the board is fully supported by Zephyr, you can flash the firmware directly onto the board using the following command: +To flash the loader, run: + ```bash -west flash +west flash -d build/ ``` + +The `` appears in the build output when you run the build script. For example: + +```bash +% ./extra/build.sh portentah7 + +Build target: arduino_portenta_h7@1.0.0//m7 +Build variant: arduino_portenta_h7_stm32h747xx_m7 +-- west build: generating a build system +... +``` + +In this case, you would flash with: +```bash +west flash -d build/arduino_portenta_h7_stm32h747xx_m7 +``` + This can also be performed via the "Burn bootloader" action in the IDE if the core is properly installed, as detailed below. ### Using the Core in Arduino IDE/CLI After running the `bootstrap.sh` script, you can symlink the core to `$sketchbook/hardware/arduino-git/zephyr`. Once linked, it will appear in the IDE/CLI, and the board's Fully Qualified Board Name (FQBN) will be formatted as `arduino-git:zephyr:name_from_boards_txt`. +Remember to also install and/or update the officially published core in the IDE Board Manager to get the latest tools and dependencies. +[⚙️ Installation](#️-installation). + ## 🚀 Adding a new target > [!TIP] pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy