Resources and notes

• GH list of Self Hosted Runners:
  • From the org profile > Settings > Actions > Runners > Standard GitHub-hosted runners
    • You need to be admin in the organization to see this list
• List of runners
• CI & Services Wiki
  • VM runners Brno
    • How to hardcode USB device links
• You may request SSH access to the VMs to Tomas Sebestik
• If you need to reload attached devices on VM runner (because a devkit is not being detected): ssh brno.beeswarmGH ctlvm reload -m BrnoVMRS07
  • If getting a permision error: sudo ssh brno.beeswarmGH ctlvm reload -m BrnoVMRS07
  • See https://espressif.gitlab-pages.espressif.cn:6688/ci-services-wiki/#/ci-infra/runners/vm-runners-brno?id=usage-of-helper-script
• Github actions runs workflows under the espressif user of the VMs.
  • If anything needs to be installed for that user, just ssh into the machine with your user and the swich to it: sudo su espressif

HIL Testing Runners

espflash HIL

• BrnoVMRS01 self-hosted Linux X64 esp32 vm-runner
  • /dev/ttyUSB0 aliased to /dev/serial_ports/esp32
• BrnoVMRS02 self-hosted Linux X64 esp32s2 vm-runner
  • /dev/ttyUSB0 aliased to /dev/serial_ports/esp32s2
• BrnoVMRS03 self-hosted Linux X64 esp32c3 vm-runner
  • /dev/ttyACM0 aliased to /dev/serial_ports/esp32c3
• BrnoVMRS04 self-hosted Linux X64 esp32s3 vm-runner
  • /dev/ttyUSB0 aliased to /dev/serial_ports/esp32s3
• BrnoVMRS05 self-hosted Linux X64 esp32h2 vm-runner
  • /dev/ttyUSB0 aliased to /dev/serial_ports/esp32h2
• BrnoVMRS06 self-hosted Linux X64 esp32c6 vm-runner
  • /dev/ttyUSB0 aliased to /dev/serial_ports/esp32c6
• BrnoVMR07 self-hosted Linux X64 esp32c2-26mhz vm-runner
  • /dev/ttyUSB0 aliased to /dev/serial_ports/esp32c2

esp-hal HIL

• BrnoRPIRS01 self-hosted Linux ARM esp32c6-usb
• BrnoRPIRS02 self-hosted Linux ARM esp32s3-usb
• BrnoRPIRS03 self-hosted Linux ARM esp32c3-usb rustboard
• BrnoRPIRS04 self-hosted Linux ARM esp32h2-usb
• BrnoRPIRS05 self-hosted Linux ARM esp32s2-jtag
• BrnoRPIRS06 self-hosted Linux ARM64 esp32-jtag
  • Its a RPi5
• BrnoRPIRS07 self-hosted Linux ARM64 esp32c2-jtag
  • Its a RPi5
• BrnoRPIRS08 self-hosted Linux ARM64 esp32p4
  • Its a RPi5 (?)

Xtensa Rust builders

• linux-x86_64-self-hosted self-hosted Linux X64 linux-x86_64-self-hosted
• BRNOWIN004 self-hosted X64 Windows
  • Used to build x86_64-pc-windows-msvc and x86_64-pc-windows-gnu
• BrnoMAC0002 self-hosted macOS ARM64 macos-m1-self-hosted
  • Used to build aarch64-apple-darwin

Troubleshooting

x86_64-pc-windows-gnu permission issue

The Building LLVM for x86_64-pc-windows-gnu step fails with:

 [2618/3163] Linking CXX static library lib\libLLVMWebAssemblyDisassembler.a
  FAILED: lib/libLLVMWebAssemblyDisassembler.a 
  C:\Windows\system32\cmd.exe /C "cd . && C:\msys64\mingw64\bin\cmake.exe -E rm -f lib\libLLVMWebAssemblyDisassembler.a && C:\msys64\mingw64\bin\ar.exe qc lib\libLLVMWebAssemblyDisassembler.a  lib/Target/WebAssembly/Disassembler/CMakeFiles/LLVMWebAssemblyDisassembler.dir/WebAssemblyDisassembler.cpp.obj && C:\msys64\mingw64\bin\ranlib.exe lib\libLLVMWebAssemblyDisassembler.a && cd ."
  C:\msys64\mingw64\bin\ranlib.exe: could not create temporary file whilst writing archive: Permission denied
  
  [2619/3163] Linking CXX static library lib\libLLVMWebAssemblyAsmParser.a
  [2620/3163] Linking CXX static library lib\libLLVMXtensaDisassembler.a
  [2621/3163] Linking CXX static library lib\libLLVMXtensaDesc.a
  [2622/3163] Linking CXX static library lib\libLLVMX86Desc.a
  [2623/3163] Building CXX object lib/TextAPI/CMakeFiles/LLVMTextAPI.dir/TextStubV5.cpp.obj
  [2624/3163] Building CXX object lib/Passes/CMakeFiles/LLVMPasses.dir/StandardInstrumentations.cpp.obj
  [2625/3163] Building CXX object lib/TextAPI/CMakeFiles/LLVMTextAPI.dir/TextStub.cpp.obj
  [2626/3163] Building CXX object lib/ToolDrivers/llvm-lib/CMakeFiles/LLVMLibDriver.dir/LibDriver.cpp.obj
  [2627/3163] Building CXX object lib/Passes/CMakeFiles/LLVMPasses.dir/PassBuilderPipelines.cpp.obj
  [2628/3163] Building CXX object lib/Target/X86/CMakeFiles/LLVMX86CodeGen.dir/X86ISelLowering.cpp.obj
  [2629/3163] Building CXX object lib/Passes/CMakeFiles/LLVMPasses.dir/PassBuilder.cpp.obj
  ninja: build stopped: subcommand failed.
  thread 'main' panicked at C:\Windows\ServiceProfiles\NetworkService\.cargo\registry\src\index.crates.io-6f17d22bba15001f\cmake-0.1.48\src\lib.rs:975:5:
  
  command did not execute successfully, got: exit code: 1
  
  build script failed, must exit now
  note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
  	finished in 2290.054 seconds
Build completed unsuccessfully in 0:43:10

1. ssh into BrnoWIN004: ssh tunnel.BrnoWIN004
   • Leave the ssh sesion open
2. Connect to it with Microsoft Remote Desktop
   • Address: localhost:7777
   • User: admin
   • Pass: Espressif32
   • The next steps are executed on the Windows machine
3. Open services: Search > Services
4. Open the GitHub Action Runner (esp-rs.BNRONWIN004) service
   1. Stop the service: General tab > Stop
   2. Update user: Log On tab > Browse > Enter admin > Check names > OK
      • After checking names, the field should be updated to BRNOWIN004\admin
   3. Add password (see previous step)
   4. Apply and OK
   5. Start the service again
5. If there are some intermediary build artifacts, you may need to delete the C:\actions-runnner\_work\rust-build\ folder
   1. Select the folder with Shift+Click
   2. Press the folder icon on the top bar
6. Close the remote sesion and the ssh session

Errors

espflash

• ESP32 and ESP32-S2 failed with different causes
  • ESP32 issues resolved after reloading the USBs of the VM (ssh brno.beeswarmGH ctlvm reload -m BrnoVMRS01)
  • ESP32-S2 issues resolved after rebooting the VM.

esp-hal