Skip to content

Commit 21feabf

Browse files
dobairolanddobairoland
committed
feat: Adopt cmake for project build system generation
1 parent 3268116 commit 21feabf

File tree

15 files changed

+11072
-4
lines changed

15 files changed

+11072
-4
lines changed

‎.astyle-rules.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,8 @@ submodules:
88
check: false
99
include:
1010
- "/esp-stub-lib/"
11+
12+
libraries:
13+
check: false
14+
include:
15+
- "src/miniz.*"

‎.check_copyright_config.yaml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,3 +21,4 @@ ignore:
2121
perform_check: false
2222
include:
2323
- src/ld
24+
- src/miniz.*

‎.github/workflows/build_and_release.yml‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
name: Build and release
3+
4+
on: [push, pull_request]
5+
6+
jobs:
7+
build_stubs:
8+
runs-on: ubuntu-24.04
9+
10+
steps:
11+
- name: Checkout ref commit
12+
uses: actions/checkout@v4
13+
14+
- name: Set up Python 3.13
15+
uses: actions/setup-python@v5
16+
with:
17+
python-version: 3.13
18+
19+
- name: Install Python dependencies
20+
run: |
21+
python -m pip install --upgrade pip
22+
pip install esptool
23+
24+
- name: Install toolchains
25+
shell: bash
26+
run: |
27+
mkdir -p toolchains
28+
pushd toolchains
29+
../tools/setup_toolchains.sh
30+
popd
31+
32+
- name: Build stub
33+
shell: bash
34+
run: |
35+
source ./tools/export_toolchains.sh
36+
echo $PATH
37+
./tools/build_all_chips.sh
38+
39+
- name: Upload stub JSONs
40+
uses: actions/upload-artifact@v4
41+
with:
42+
path: build*/esp*.json
43+
if-no-files-found: error
44+
retention-days: 3
45+
46+
create_release:
47+
name: Create GitHub release
48+
needs: build_stubs
49+
if: startsWith(github.ref, 'refs/tags/')
50+
runs-on: ubuntu-24.04
51+
permissions:
52+
contents: write
53+
steps:
54+
- name: Get version
55+
id: get_version
56+
run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
57+
shell: bash
58+
- name: Checkout
59+
uses: actions/checkout@v4
60+
with:
61+
fetch-depth: 0
62+
- name: Set up Python 3.13
63+
uses: actions/setup-python@v5
64+
with:
65+
python-version: 3.13
66+
- name: Install dependencies
67+
run: |
68+
python -m pip install --upgrade pip
69+
pip install commitizen czespressif
70+
- name: Generate changelog
71+
run: |
72+
cz changelog ${{ steps.get_version.outputs.VERSION }} --file-name changelog_body.md
73+
cat changelog_body.md
74+
- name: Download stub JSONs
75+
uses: actions/download-artifact@v4
76+
- name: Create release
77+
id: create_release
78+
uses: softprops/action-gh-release@v2
79+
env:
80+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
81+
with:
82+
body_path: changelog_body.md
83+
name: Version ${{ steps.get_version.outputs.VERSION }}
84+
draft: true
85+
prerelease: false
86+
fail_on_unmatched_files: true
87+
files: artifact/esp*.json

‎.gitignore‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
src/build/
1+
build*/
2+
toolchains/

‎CMakeLists.txt‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
cmake_minimum_required(VERSION 3.28)
2+
3+
set(ESP32_XTENSA_CHIPS esp32 esp32-s2 esp32-s3)
4+
5+
project(flasher-stub CXX)
6+
7+
option(TARGET_CHIP "Target ESP chip" "OFF")
8+
9+
if("${TARGET_CHIP}" STREQUAL "OFF")
10+
message(FATAL_ERROR "Please set target chip by TARGET_CHIP.")
11+
endif()
12+
13+
# TODO move these to esp-stub-lib
14+
set(LINKER_SCRIPTS_DIR "${CMAKE_SOURCE_DIR}/src/ld")
15+
16+
# CXX standard set based on the GCC version of the toolchain for ESP8266 (oldest one)
17+
set(CUSTOM_FLAGS --std=gnu++17 -Wall -Wextra -Werror -Wshadow -Wundef -Wconversion -Os -fno-common -nostdlib -fno-builtin -Wl,-static -g -ffunction-sections -Wl,--gc-sections)
18+
set(EXTRA_RISCV_FLAGS -march=rv32imc -mabi=ilp32 -msmall-data-limit=0)
19+
set(EXTRA_XTENSA_FLAGS -mtext-section-literals -mlongcalls)
20+
21+
set(ESP8266_FLAGS "-DESP8266" ${EXTRA_XTENSA_FLAGS})
22+
set(XTENSA_FLAGS "-DXTENSA" ${EXTRA_XTENSA_FLAGS})
23+
set(RISCV_FLAGS "-DRISCV" ${EXTRA_RISCV_FLAGS})
24+
25+
message(STATUS "Building for ${TARGET_CHIP}")
26+
add_executable(${TARGET_CHIP})
27+
28+
if(TARGET_CHIP IN_LIST ESP32_XTENSA_CHIPS)
29+
set(TOOLCHAIN_NAME "xtensa_toolchain")
30+
set(TOOLCHAIN_EXECUTABLE_PREFIX "xtensa-${TARGET_CHIP}-elf-")
31+
set(CHIP_FLAGS "${XTENSA_FLAGS}")
32+
elseif(TARGET_CHIP STREQUAL "esp8266")
33+
set(TOOLCHAIN_NAME "esp8266_toolchain")
34+
set(TOOLCHAIN_EXECUTABLE_PREFIX "xtensa-lx106-elf-")
35+
set(CHIP_FLAGS "${ESP8266_FLAGS}")
36+
else()
37+
set(TOOLCHAIN_NAME "riscv_toolchain")
38+
set(TOOLCHAIN_EXECUTABLE_PREFIX "riscv32-esp-elf-")
39+
set(CHIP_FLAGS "${RISCV_FLAGS}")
40+
endif()
41+
42+
set(CHIP_LINKER_SCRIPT "${LINKER_SCRIPTS_DIR}/${TARGET_CHIP}.ld")
43+
44+
target_compile_options(${TARGET_CHIP} PRIVATE
45+
${CUSTOM_FLAGS}
46+
${CHIP_FLAGS}
47+
"-T${CHIP_LINKER_SCRIPT}"
48+
)
49+
50+
target_link_options(${TARGET_CHIP} PRIVATE
51+
${CUSTOM_FLAGS}
52+
-Wl,-Map=${CMAKE_BINARY_DIR}/${TARGET_CHIP}.map -L${LINKER_SCRIPTS_DIR}
53+
)
54+
55+
set(CMAKE_CXX_COMPILER ${TOOLCHAIN_EXECUTABLE_PREFIX}g++)
56+
57+
add_subdirectory(${CMAKE_SOURCE_DIR}/src)

‎README.md‎

Lines changed: 48 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,58 @@ This project is experimental and not yet ready for production use.
66

77
The project's goal is to replace the legacy [flasher stub of esptool](https://github.com/espressif/esptool-legacy-flasher-stub/) in the near future.
88

9-
# How To Use
9+
# Build Dependencies
10+
11+
### Submodules
12+
13+
The project depends on [esp-stub-lib](https://github.com/espressif/esp-stub-lib/) in the form of git submodule. Don't forget to get/update the submodule as well before building:
14+
15+
```sh
16+
git submodule update --init --recursive
17+
```
18+
19+
### Toolchains
20+
21+
You will need the following toolchains set up and available in your PATH:
22+
1. [`xtensa-lx106-elf-*`](https://docs.espressif.com/projects/esp8266-rtos-sdk/en/latest/get-started/index.html#setup-toolchain)
23+
2. [`xtensa-*-elf-*`](https://github.com/espressif/crosstool-NG)
24+
3. [`riscv32-esp-elf-*`](https://github.com/espressif/crosstool-NG)
25+
26+
There is a convenience script for AMD64 Linux machines to download and install them into the `toolchains` directory:
27+
```sh
28+
mkdir -p toolchains
29+
cd toolchains
30+
../tools/setup_toolchains.sh
31+
```
32+
33+
Then run the following export script in every terminal where the project is used:
34+
```sh
35+
. ./tools/export_toolchains.sh
36+
```
37+
38+
# How to Build
39+
40+
### Build for one selected chip target
41+
42+
```sh
43+
mkdir -p build
44+
cmake . -B build -G Ninja -DTARGET_CHIP=esp32-s2 # Replace with your desired chip, e.g. esp32, esp8266
45+
ninja -C build
46+
```
47+
48+
### Build for all supported chip targets
49+
50+
```sh
51+
./tools/build_all.sh
52+
```
53+
54+
# How To Use With Esptool
1055

1156
1. Install esptool in [development mode](https://docs.espressif.com/projects/esptool/en/latest/esp32/contributing.html#development-setup).
1257
2. Obtain the flasher stub binaries as JSON files either from the [releases page](https://github.com/espressif/esp-flasher-stub) or from the artifacts of your pull request.
1358
3. Replace the esptool's JSONs files in the `esptool/targets/stub_flasher` directory with the obtained JSON files.
1459

15-
## Contributing
60+
# Contributing
1661

1762
Please install the [pre-commit](https://pre-commit.com/) hooks to ensure that your commits are properly formatted:
1863

@@ -34,6 +79,6 @@ git push --tags
3479
```
3580
Create a pull request and edit the automatically created draft [release notes](https://github.com/espressif/esp-flasher-stub/releases).
3681

37-
## License
82+
# License
3883

3984
This document and the attached source code are released as Free Software under either the [Apache License Version 2](LICENSE-APACHE) or [MIT License](LICENSE-MIT) at your option.

‎src/CMakeLists.txt‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
set(COMMON_SOURCES "main.cpp")
2+
3+
target_sources(${TARGET_CHIP} PRIVATE ${COMMON_SOURCES})
4+
5+
if(${TARGET_CHIP} STREQUAL "esp8266")
6+
target_sources(${TARGET_CHIP} PRIVATE miniz.cpp)
7+
set_source_files_properties(miniz.cpp PROPERTIES COMPILE_FLAGS "-Wno-error=conversion") # TODO this has no effect
8+
endif()

‎src/ld/esp32.ld‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
/* Note: stub is deliberately loaded close to the very top
2+
of available RAM, to reduce change of colliding with anything
3+
else... */
4+
MEMORY {
5+
iram : org = 0x400BE000, len = 0x1000
6+
dram : org = 0x3ffcc000, len = 0x14000
7+
}
8+
9+
ENTRY(esp_main)
10+
11+
SECTIONS {
12+
.text : ALIGN(4) {
13+
*(.literal)
14+
*(.text .text.*)
15+
} > iram
16+
17+
.bss : ALIGN(4) {
18+
_bss_start = ABSOLUTE(.);
19+
*(.bss)
20+
_bss_end = ABSOLUTE(.);
21+
} > dram
22+
23+
.data : ALIGN(4) {
24+
*(.data)
25+
*(.rodata .rodata.*)
26+
} > dram
27+
}
28+
29+
INCLUDE "esp32.rom.ld"

0 commit comments

Comments
 (0)