[WIP] Update default installed toolchains

.github/workflows/library.yml

@@ -22,7 +22,8 @@ jobs:
  fail-fast: false
  matrix:
  os: [ubuntu-latest, windows-latest]
- variant: [esp8266, host, esp32, esp32s2, esp32c3, rp2040]
+ variant: [esp8266, host, esp32, esp32s2, esp32c3, esp32s3, esp32c2, rp2040]
+ idf_version: ["4.4", ""] # "" denotes default, currently 5.2
  include:
  - variant: esp8266
  arch: Esp8266
@@ -34,15 +35,33 @@ jobs:
  arch: Esp32
  - variant: esp32c3
  arch: Esp32
+ - variant: esp32s3
+ arch: Esp32
+ - variant: esp32c2
+ arch: Esp32
  - variant: rp2040
  arch: Rp2040
+ exclude:
+ - variant: esp32c2
+ idf_version: "4.4"
+ - variant: esp8266
+ idf_version: "4.4"
+ - variant: host
+ idf_version: "4.4"
+ - variant: rp2040
+ idf_version: "4.4"
 
  concurrency: 
  group: ${{ github.workflow }}-${{ github.ref }}-${{ toJson(matrix) }}
  cancel-in-progress: true
 
  runs-on: ${{ matrix.os }}
 
+ env:
+ SMING_ARCH: ${{ matrix.arch }}
+ SMING_SOC: ${{ matrix.variant }}
+ INSTALL_IDF_VER: ${{ matrix.idf_version }}
+
  steps:
  - name: Fix autocrlf setting
  run: |
@@ -72,8 +91,6 @@ jobs:
  "SMING_HOME=" + (Resolve-Path "../../sming/Sming").path >> $env:GITHUB_ENV
  "COMPONENT_SEARCH_DIRS=" + (Resolve-Path "..").path >> $env:GITHUB_ENV
  "CI_MAKEFILE=" + (Resolve-Path "../../sming/Tools/ci/library/Makefile") >> $env:GITHUB_ENV
- "SMING_ARCH=${{ matrix.arch }}" >> $env:GITHUB_ENV
- "SMING_SOC=${{ matrix.variant }}" >> $env:GITHUB_ENV
 
  - name: Install build tools for Ubuntu
  if: ${{ matrix.os == 'ubuntu-latest' }}

Sming/Arch/Esp32/README.rst

@@ -108,9 +108,9 @@ IDF versions
 
 Sming currently supports IDF versions 4.3, 4.4, 5.0 and 5.2.
 
-The default installed IDF version is 4.4. This can be changed as follows::
+The default installed IDF version is 5.2. This can be changed as follows::
 
- INSTALL_IDF_VER=5.2 $SMING_HOME/../Tools/install.sh esp32
+ INSTALL_IDF_VER=4.4 $SMING_HOME/../Tools/install.sh esp32
 
 The installation script creates a soft-link in ``/opt/esp-idf`` pointing to the last version installed.
 Use the `IDF_PATH` environment variable or change the soft-link to select which one to use.

Sming/Arch/Esp32/Tools/install.cmd

@@ -4,7 +4,7 @@ if "%IDF_PATH%"=="" goto :EOF
 if "%IDF_TOOLS_PATH%"=="" goto :EOF
 
 if "%IDF_REPO%"=="" set IDF_REPO="https://github.com/mikee47/esp-idf.git"
-if "%INSTALL_IDF_VER%"=="" set INSTALL_IDF_VER=4.4
+if "%INSTALL_IDF_VER%"=="" set INSTALL_IDF_VER=5.2
 set IDF_BRANCH="sming/release/v%INSTALL_IDF_VER%"
 
 git clone -b %IDF_BRANCH% %IDF_REPO% %IDF_PATH%

Sming/Arch/Esp32/Tools/install.sh

@@ -36,7 +36,7 @@ if [ ! -L "$IDF_PATH" ] && [ -d "$IDF_PATH" ]; then
  mv "$IDF_PATH" "$IDF_PATH-old"
 fi
 
-INSTALL_IDF_VER="${INSTALL_IDF_VER:=4.4}"
+INSTALL_IDF_VER="${INSTALL_IDF_VER:=5.2}"
 IDF_CLONE_PATH="$(readlink -m "$IDF_PATH/..")/esp-idf-${INSTALL_IDF_VER}"
 IDF_REPO="${IDF_REPO:=https://github.com/mikee47/esp-idf.git}"
 IDF_BRANCH="sming/release/v${INSTALL_IDF_VER}"

Sming/Arch/Esp8266/Tools/install.cmd

@@ -1,9 +1,8 @@
 REM Esp8266 install.cmd
 
-call :install "%ESP_HOME%" x86_64-w64-mingw32.xtensa-lx106-elf-e6a192b.201211.zip
-goto :EOF
+set EQT_REPO=https://github.com/earlephilhower/esp-quick-toolchain/releases/download/3.2.0-gcc10.3
+set EQT_TOOLCHAIN=x86_64-w64-mingw32.xtensa-lx106-elf-c791b74.230224.zip
 
-:install
-mkdir %1
-curl -Lo %DOWNLOADS%/%2 %SMINGTOOLS%/%2
-7z -o%1 x %DOWNLOADS%/%2
+mkdir %ESP_HOME%
+curl -Lo %DOWNLOADS%/%EQT_TOOLCHAIN% %EQT_REPO%/%EQT_TOOLCHAIN%
+7z -o%ESP_HOME% x %DOWNLOADS%/%EQT_TOOLCHAIN%

Sming/Arch/Esp8266/Tools/install.sh

@@ -2,13 +2,13 @@
 #
 # Esp8266 install.sh
 
-EQT_REPO=https://github.com/earlephilhower/esp-quick-toolchain/releases/download/3.0.0-newlib4.0.0-gnu20
+EQT_REPO="https://github.com/earlephilhower/esp-quick-toolchain/releases/download/3.2.0-gcc10.3"
+EQT_TOOLCHAIN="$(uname -m)-linux-gnu.xtensa-lx106-elf-c791b74.230224.tar.gz"
 
 if [ -d "$ESP_HOME" ]; then
  printf "\n\n** Skipping Esp8266 tools installation: '$ESP_HOME' exists\n\n"
 else
- TOOLCHAIN="$(uname -m)-linux-gnu.xtensa-lx106-elf-e6a192b.201211.tar.gz"
- $WGET "$EQT_REPO/$TOOLCHAIN" -O "$DOWNLOADS/$TOOLCHAIN"
+ $WGET "$EQT_REPO/$EQT_TOOLCHAIN" -O "$DOWNLOADS/$EQT_TOOLCHAIN"
  mkdir -p "$ESP_HOME"
- tar -zxf "$DOWNLOADS/$TOOLCHAIN" -C "$ESP_HOME" --totals
+ tar -zxf "$DOWNLOADS/$EQT_TOOLCHAIN" -C "$ESP_HOME" --totals
 fi

Sming/Arch/Rp2040/Components/libc/component.mk

@@ -8,4 +8,14 @@ LIBC_DEFSYMS := \
  __wrap_vprintf=m_vprintf \
  __wrap_printf=m_printf
 
-EXTRA_LDFLAGS := $(call DefSym,$(LIBC_DEFSYMS))
+LIBC_UNDEFSYMS := \
+ _close_r \
+ _lseek_r \
+ _read_r \
+ _write_r \
+ _isatty_r
+
+
+EXTRA_LDFLAGS := \
+ $(call DefSym,$(LIBC_DEFSYMS)) \
+ $(call Undef,$(LIBC_UNDEFSYMS))

Sming/Arch/Rp2040/Components/libc/src/libc_replacements.c

@@ -0,0 +1,86 @@
+/*
+ libc_replacements.c - replaces libc functions with functions
+ from Espressif SDK
+
+ Copyright (c) 2015 Ivan Grokhotkov. All rights reserved.
+ This file is part of the esp8266 core for Arduino environment.
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Lesser General Public
+ License as published by the Free Software Foundation; either
+ version 2.1 of the License, or (at your option) any later version.
+
+ This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ Lesser General Public License for more details.
+
+ You should have received a copy of the GNU Lesser General Public
+ License along with this library; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+
+ Modified 03 April 2015 by Markus Sattler
+
+ */
+
+#include <stdio.h>
+#include <sys/stat.h>
+#include <unistd.h>
+#include <sys/reent.h>
+#include <esp_attr.h>
+#include <m_printf.h>
+
+int _open_r(struct _reent* unused, const char* ptr, int mode)
+{
+ (void)unused;
+ (void)ptr;
+ (void)mode;
+ return 0;
+}
+
+int _close_r(struct _reent* unused, int file)
+{
+ (void)unused;
+ (void)file;
+ return 0;
+}
+
+int _fstat_r(struct _reent* unused, int file, struct stat* st)
+{
+ (void)unused;
+ (void)file;
+ st->st_mode = S_IFCHR;
+ return 0;
+}
+
+int _lseek_r(struct _reent* unused, int file, int ptr, int dir)
+{
+ (void)unused;
+ (void)file;
+ (void)ptr;
+ (void)dir;
+ return 0;
+}
+
+int _read_r(struct _reent* unused, int file, char* ptr, int len)
+{
+ (void)unused;
+ (void)file;
+ (void)ptr;
+ (void)len;
+ return 0;
+}
+
+int _write_r(struct _reent* r, int file, char* ptr, int len)
+{
+ (void)r;
+ if(file == STDOUT_FILENO) {
+ return m_nputs(ptr, len);
+ }
+ return 0;
+}
+
+int _isatty_r(struct _reent* r, int fd)
+{
+ return 0;
+}

Sming/Arch/Rp2040/Components/uf2/uf2conv.py

@@ -176,7 +176,7 @@ def get_drives():
  "get", "DeviceID,", "VolumeName,",
  "FileSystem,", "DriveType"])
  for line in r.decode().split('\n'):
- words = re.split('\s+', line)
+ words = re.split(r'\s+', line)
  if len(words) >= 3 and words[1] == "2" and words[2] == "FAT":
  drives.append(words[0])
  else:

Sming/Arch/Rp2040/README.rst

@@ -85,21 +85,30 @@ The following instructions should help.
 
 Compiler/linker
  The RP2040 contains two ARM Cortex-M0+ cores. Tools for all platforms can be downloaded from the
- `ARM developer website <https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads>`__.
+ `ARM developer website <https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads>`__.
 
  Unzip the archive to a suitable location (e.g. ``/opt/rp2040`` or ``c:\tools\rp2040``) and set :envvar:`PICO_TOOLCHAIN_PATH` accordingly.
 
  .. note::
 
- At time of writing the Ubuntu repositories contain an older version of this toolchain.
- It also does not contain GDB, but can be installed separately:
+ The Sming installer script can do this for you ``Tools/install.sh rp2040``
 
+ You can alternatively use the toolchains provided in your GNU/Linux distribution.
+
+ Ubuntu
+ ::
  sudo apt install gcc-arm-none-eabi gdb-multiarch
 
- To use gdb-multiarch you'll need to do this:
+ To use gdb-multiarch you'll need to do this::
 
  make gdb GDB=gdb-multiarch
 
+ Fedora
+ ::
+ sudo dnf install arm-none-eabi-gcc-cs-c++ arm-none-eabi-newlib
+
+ The standard GDB appears to work OK.
+
 Ninja
  This is used to build the RP2040 SDK code:
 

Sming/Arch/Rp2040/Tools/install.cmd

@@ -1,11 +1,11 @@
 REM Rp2040 install.cmd
 
 if exist "%PICO_TOOLCHAIN_PATH%/arm-none-eabi" goto :already_got
-set TOOLCHAIN_VERSION=10.3-2021.07
-set TOOLCHAIN_BASE_URL=https://developer.arm.com/-/media/Files/downloads/gnu-rm
-set TOOLCHAIN_NAME=gcc-arm-none-eabi-%TOOLCHAIN_VERSION%
-set TOOLCHAIN_FILE=%TOOLCHAIN_NAME%-win32.zip
-curl -Lo tmp.zip %TOOLCHAIN_BASE_URL%/%TOOLCHAIN_VERSION%/%TOOLCHAIN_FILE% || goto :EOF
+set TOOLCHAIN_VERSION=13.2.rel1
+set TOOLCHAIN_BASE_URL=https://developer.arm.com/-/media/Files/downloads/gnu
+set TOOLCHAIN_NAME=arm-gnu-toolchain-%TOOLCHAIN_VERSION%-mingw-w64-i686-arm-none-eabi
+set TOOLCHAIN_FILE=%TOOLCHAIN_NAME%.zip
+curl -Lo tmp.zip %TOOLCHAIN_BASE_URL%/%TOOLCHAIN_VERSION%/binrel/%TOOLCHAIN_FILE% || goto :EOF
 7z -o"%PICO_TOOLCHAIN_PATH%-tmp" x tmp.zip || goto :EOF
 del tmp.zip
 move "%PICO_TOOLCHAIN_PATH%-tmp/%TOOLCHAIN_NAME%" "%PICO_TOOLCHAIN_PATH%"

Sming/Arch/Rp2040/Tools/install.sh

@@ -6,14 +6,13 @@ $PKG_INSTALL ninja-build
 
 if [ -d "$PICO_TOOLCHAIN_PATH/arm-none-eabi" ]; then
  printf "\n\n** Skipping Rp2040 tools installation: '$PICO_TOOLCHAIN_PATH' exists\n\n"
-else
- TOOLCHAIN_VERSION="10.3-2021.10"
- TOOLCHAIN_BASE_URL="https://developer.arm.com/-/media/Files/downloads/gnu-rm"
- TOOLCHAIN_NAME="gcc-arm-none-eabi-$TOOLCHAIN_VERSION"
- TOOLCHAIN_FILE="$TOOLCHAIN_NAME-$(uname -m)-linux.tar.bz2"
- TOOLCHAIN_URL="$TOOLCHAIN_BASE_URL/$TOOLCHAIN_VERSION/$TOOLCHAIN_FILE"
+elif [ -n "$PICO_TOOLCHAIN_PATH" ]; then
+ TOOLCHAIN_VERSION="13.2.rel1"
+ TOOLCHAIN_BASE_URL="https://developer.arm.com/-/media/Files/downloads/gnu"
+ TOOLCHAIN_FILE="arm-gnu-toolchain-$TOOLCHAIN_VERSION-$(uname -m)-arm-none-eabi.tar.xz"
+ TOOLCHAIN_URL="$TOOLCHAIN_BASE_URL/$TOOLCHAIN_VERSION/binrel/$TOOLCHAIN_FILE"
  $WGET "$TOOLCHAIN_URL" -O "$DOWNLOADS/$TOOLCHAIN_FILE"
  mkdir -p "$PICO_TOOLCHAIN_PATH"
- tar -jxf "$DOWNLOADS/$TOOLCHAIN_FILE" -C "$PICO_TOOLCHAIN_PATH" --totals --transform='s|^/*||'
- mv "$PICO_TOOLCHAIN_PATH/$TOOLCHAIN_NAME/"* "$PICO_TOOLCHAIN_PATH"
+ tar -xf "$DOWNLOADS/$TOOLCHAIN_FILE" -C "$PICO_TOOLCHAIN_PATH" --totals --transform='s|^/*||'
+ mv "$PICO_TOOLCHAIN_PATH/"*/* "$PICO_TOOLCHAIN_PATH"
 fi

Sming/Arch/Rp2040/app.mk

@@ -6,6 +6,7 @@
 
 # linker flags used to generate the main object file
 LDFLAGS += \
+ -Wl,--no-warn-rwx-segments \
  -Wl,--build-id=none \
  --specs=nosys.specs \
  -mcpu=cortex-m0plus \

Sming/Arch/Rp2040/build.mk

@@ -26,11 +26,10 @@ ifeq (,$(wildcard $(PICO_TOOLCHAIN_PATH)/$(CONFIG_TOOLPREFIX)))
 $(error PICO_TOOLCHAIN_PATH not set correctly: $(PICO_TOOLCHAIN_PATH))
 endif
 else
-PICO_TOOLCHAIN_PATH := $(shell which $(CONFIG_TOOLPREFIX)-gcc)
-ifeq (,$(PICO_TOOLCHAIN_PATH))
+ifeq (,$(shell which $(CONFIG_TOOLPREFIX)-gcc))
 $(error Toolchain not found, maybe set PICO_TOOLCHAIN_PATH)
 endif
-TOOLSPEC := $(dir $(PICO_TOOLCHAIN_PATH))$(CONFIG_TOOLPREFIX)-
+TOOLSPEC := $(CONFIG_TOOLPREFIX)-
 endif
 
 # select which tools to use as assembler, compiler, librarian and linker
@@ -42,7 +41,7 @@ LD := $(TOOLSPEC)gcc
 NM := $(TOOLSPEC)nm
 OBJCOPY := $(TOOLSPEC)objcopy
 OBJDUMP := $(TOOLSPEC)objdump
-GDB := $(TOOLSPEC)gdb
+GDB := gdb
 
 CPPFLAGS += \
  -nostdlib

docs/source/tools/vscode.rst

@@ -13,6 +13,17 @@ Software involved
 - `Visual Studio Code <https://code.visualstudio.com/>`__
 - `C/C++ extension <https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools>`__
 
+.. note::
+
+ Linux users may prefer `VSCodium <https://vscodium.com/>`__ which does not contain telemetry or tracking.
+
+ Standard C/C++ language support is available via the `cpptools <https://github.com/microsoft/vscode-cpptools>`__
+ extension which is not available in the vscodium repositories.
+
+ Visit https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools and go to ``Version History``
+ to download the .vsix file. Open the ``Extensions`` pane in vscodium and drag the file there to install,
+ or run ``codium --install-extension NAME-OF-FILE.vsix``.
+
 
 Installation
 ------------
@@ -70,6 +81,22 @@ To debug your application, follow these steps:
  VS Code debug selection
 
 
+Editor window titles
+--------------------
+
+As Sming is a multi-architecture framework there are lots of files with the same name.
+By default editor window titles contain only the filename, but in vscode this can be changed
+to something more useful, like including the parent directory name.
+
+Open user settings JSON (via F1 hotkey) and add this to the config:
+
+.. code-block:: json
+
+ "workbench.editor.customLabels.patterns": {
+ "**/*.*": "${dirname}/${filename}.${extname}"
+ }
+
+
 Manual configuration changes
 ----------------------------
 

docs/source/upgrading/5.1-5.2.rst

@@ -41,3 +41,16 @@ Espressif toolchains use forks:
 
 esp8266: https://github.com/earlephilhower/newlib-xtensa/blob/xtensa-4_0_0-lock-arduino/newlib/libc/
 esp32: https://github.com/espressif/newlib-esp32/blob/esp-4.3.0/newlib/libc/
+
+
+**Toolchain versions updated**
+
+Esp8266
+ The installer has been updated to use the latest toolchain (Feb 23), gcc 10.3.
+
+Esp32 IDF
+ The installation scripts now install IDF version 5.2 by default.
+ See :ref:`idf_versions` for further details.
+
+RP2040
+ The installer has been updated to use the latest toolchain (Oct 23), gcc 13.2.