laze-project.yml

contexts:
  # base context that all other contexts inherit from
  - name: default
    env:
      bindir: "${build-dir}/bin/${builder}/${app}"

  # base context for all RIOT-rs applications
  - name: riot-rs

    env:
      RUSTFLAGS:
        - "-Clink-arg=--nmagic"
        - "-Clink-arg=-Tlinkme.x"
        - "-Clink-arg=-Tlink.x"
        - "-Clink-arg=-Tdevice.x"
        - "-Clink-arg=${LINK_ARG_PREFIX}--no-eh-frame-hdr"
        - --cfg builder=\"${builder}\"
      FEATURES:
        - riot-rs-boards/${BOARD}
      SCRIPTS: ${relroot}/scripts
      # laze doesn't know the concept of "export" as make does, so each variable
      # that needs to be passed via environment needs to be listed in that rule
      # or task's command list.
      # "CARGO_ENV" is used for that.
      CARGO_ENV:
        - >-
          OPENOCD_ARGS="${OPENOCD_ARGS}"
          SCRIPTS=${SCRIPTS}
          CARGO_BUILD_TARGET=${RUSTC_TARGET}
          ${CARGO_TARGET_PREFIX}_RUNNER=${CARGO_RUNNER}
          ${CARGO_TARGET_PREFIX}_RUSTFLAGS="${RUSTFLAGS}"
          CARGO_TARGET_DIR=${relroot}/${build-dir}/bin/${builder}/${app}/cargo
      BOARD: ${builder}
      PROFILE: release
      riot_binary: ${app}
      QEMU_SYSTEM_ARM: >-
        qemu-system-arm
        -machine ${QEMU_MACHINE}
        -nographic
        -serial mon:stdio
        -semihosting-config enable=on,target=native
        -kernel

    var_options:
      # this turns ${FEATURES} from a list to "--features=feature1,feature2"
      FEATURES:
        start: --features=
        joiner: ","

    rules:
      - name: LINK
        description: CARGO ${out}
        pool: console
        always: true
        cmd: >-
          cd ${relpath} && ${CARGO_ENV} cargo ${CARGO_ARGS} build --${PROFILE} ${FEATURES}
          && cp ${relroot}/${build-dir}/bin/${builder}/${app}/cargo/${RUSTC_TARGET}/${PROFILE}/${riot_binary} ${relroot}/${out}

      - name: GIT_DOWNLOAD
        cmd: "D=$$(dirname ${out}); rm -rf $$D && git clone ${url} $$D -n && git -C $$D reset --hard ${commit} && touch ${out}"

    tasks:
      exec:
        build: false
        cmd:
          - ${CARGO_ENV}

      cargo:
        cmd:
          - cd ${relpath} && ${CARGO_ENV} cargo ${CARGO_ARGS}
        build: false

      run:
        build: false
        cmd:
          - cd ${appdir} && ${CARGO_ENV} cargo ${CARGO_ARGS} run --${PROFILE} ${FEATURES}

      cargo-test:
        cmd:
          - cd ${relpath} && ${CARGO_ENV} cargo test --${PROFILE} --features=riot-rs-boards/${builder},riot-rs-rt/debug-console --manifest-path ${app}/Cargo.toml
        build: false

      debug:
        cmd:
          - cd examples/${app} && ${CARGO_ENV} cargo ${CARGO_ARGS} run --${PROFILE} ${FEATURES}
        build: false
        ignore_ctrl_c: true

      gdb:
        cmd:
          - arm-none-eabi-gdb -ex "target extended-remote localhost:1337" ${out}
        build: false
        ignore_ctrl_c: true

      bloat:
        cmd:
          - cd examples/${app} && ${CARGO_ENV} cargo ${CARGO_ARGS} bloat --${PROFILE} ${FEATURES}
        build: false

      tree:
        cmd:
          - cd examples/${app} && ${CARGO_ENV} cargo ${CARGO_ARGS} tree ${FEATURES}
        build: false

      flash:
        cmd:
          - >-
            _flash () { openocd
            ${OPENOCD_ADAPTER_INIT}
            ${OPENOCD_ARGS}
            -c 'init'
            -c 'targets'
            -c 'reset halt'
            -c "flash write_image erase \"${1}\" 0 elf"
            -c "verify_image \"${1}\" 0 elf"
            -c 'reset run'
            -c 'shutdown' ; } ;
            _flash ${out}

      flash-riotboot:
        required_vars:
          - FLASH_OFFSET
        cmd:
          - riotboot-genhdr generate ${out} $$(date +%s) $(${FLASH_OFFSET} + ${FLASH_SLOT_OFFSET}) ${FLASH_SLOT_OFFSET} - > ${out}.hdr.bin
          - ${OBJCOPY} -Obinary ${out} ${out}.bin
          - cat ${out}.hdr.bin ${out}.bin > ${out}.riotboot.bin
          - _flash () { openocd
            ${OPENOCD_ARGS}
            -c 'init'
            -c 'targets'
            -c 'reset halt'
            -c "flash write_image erase \"${1}.riotboot.bin\" ${FLASH_OFFSET} bin"
            -c "verify_image \"${1}.riotboot.bin\" ${FLASH_OFFSET} bin"
            -c 'reset run'
            -c 'shutdown' ; } ;
            _flash ${out}

      reset:
        build: false
        cmd:
          - >-
            openocd
            ${OPENOCD_ARGS}
            -c 'init'
            -c 'targets'
            -c 'reset'
            -c 'shutdown'

      size:
        cmd:
          - llvm-size ${out}

      objdump:
        cmd:
          - rust-objdump -S ${out}

  - name: cortex-m
    parent: riot-rs
    env:
      OBJCOPY: arm-none-eabi-objcopy
      RUSTFLAGS:
        - -Clink-arg=-Tisr_stack.x
        - --cfg context=\"cortex-m\"

  - name: thumbv6m-none-eabi
    parent: cortex-m
    env:
      RUSTC_TARGET: thumbv6m-none-eabi
      CARGO_TARGET_PREFIX: CARGO_TARGET_THUMBV6M_NONE_EABI
      RUSTFLAGS:
        - --cfg armv6m

  - name: thumbv7em-none-eabi
    parent: cortex-m
    env:
      RUSTC_TARGET: thumbv7em-none-eabi
      CARGO_TARGET_PREFIX: CARGO_TARGET_THUMBV7EM_NONE_EABI
      RUSTFLAGS:
        - "-Ctarget-cpu=cortex-m4"
        - --cfg armv7m

  - name: thumbv7m-none-eabi
    parent: cortex-m
    env:
      RUSTC_TARGET: thumbv7m-none-eabi
      CARGO_TARGET_PREFIX: CARGO_TARGET_THUMBV7M_NONE_EABI
      RUSTFLAGS:
        - --cfg armv7m

  - name: thumbv7em-none-eabihf
    parent: cortex-m
    env:
      RUSTC_TARGET: thumbv7em-none-eabihf
      CARGO_ENV_TARGET: CARGO_TARGET_THUMBV7EM_NONE_EABIHF
      RUSTFLAGS:
        - --cfg armv7m

  - name: microbit-base
    # this is a context, not a builder, to be used as parent by  "microbit" and
    # "microbit-qemu"
    parent: thumbv6m-none-eabi
    selects:
      - "microbit disabled due to missing nrf51 support in embassy"
    env:
      # override "${builder}"
      BOARD: microbit
      OPENOCD_ARGS:
        - "-f board/nordic_nrf52_dk.cfg"

  - name: nrf52
    parent: thumbv7em-none-eabi # actually eabihf, but riot-rs doesn't support hard float yet
    env:
      CARGO_RUNNER:
        - ${SCRIPTS}/debug-openocd.sh
      OPENOCD_ARGS:
        - "-f board/nordic_nrf52_dk.cfg"
      PROBE_RS_CHIP: nrf52832_xxAA
      RUSTFLAGS:
        - --cfg context=\"nrf52\"

    tasks:
      flash-erase-all:
        help: Erases the whole chip including user data. Unlocks it if locked.
        build: false
        cmd:
          - probe-rs erase --chip ${PROBE_RS_CHIP} --allow-erase-all

  - name: nrf52832
    parent: nrf52
    env:
      RUSTFLAGS:
        - --cfg context=\"nrf52832\"

  - name: nrf52840
    parent: nrf52
    env:
      RUSTFLAGS:
        - --cfg context=\"nrf52840\"
      PROBE_RS_CHIP: nrf52840_xxAA

    tasks:
      flash-rs:
        cmd:
          - probe-rs download ${out} --chip ${PROBE_RS_CHIP}
          - probe-rs reset --chip ${PROBE_RS_CHIP}

      debug-rs:
        cmd:
          - probe-rs gdb --chip ${PROBE_RS_CHIP}

  - name: rp2040
    parent: thumbv6m-none-eabi
    env:
      RUSTFLAGS:
        - --cfg context=\"rp2040\"
        - "-Clink-arg=-Tlink-rp.x"
      PROBE_RS_CHIP: RP2040
      CARGO_RUNNER:
        - ${SCRIPTS}/debug-openocd.sh
      OPENOCD_ARGS:
        - "-f interface/cmsis-dap.cfg -f target/rp2040.cfg"
    tasks:
      debug-rs:
        cmd:
          - probe-rs debug --chip ${PROBE_RS_CHIP} --exe ${out}


modules:
  - name: release
    selects:
      - release-arch
      - ?silent-panic
      - ?lto

  - name: release-arch
    context: cortex-m

  - name: debug-console
    context: riot-rs
    env:
      global:
        FEATURES:
          - riot-rs/debug-console

  - name: silent-panic
    context: riot-rs
    env:
      global:
        FEATURES:
          - riot-rs/silent-panic

  - name: lto
    context: riot-rs
    env:
      global:
        RUSTFLAGS:
          - -Cembed-bitcode=yes
          - -Clto=fat
          - -Ccodegen-units=1

  - name: inline225
    context: riot-rs
    env:
      global:
        RUSTFLAGS:
          - -Cllvm-args=-inline-threshold -Cllvm-args=225

  - name: build_std
    context: riot-rs
    env:
      global:
        CARGO_ARGS:
          - -Zbuild-std

  - name: no_overflow_checks
    context: riot-rs
    env:
      global:
        RUSTFLAGS:
          - -Coverflow-checks=off

  - name: opt_speed
    context: riot-rs
    env:
      global:
        RUSTFLAGS:
          - -Copt-level=3
        # note: this overrides CFLAGS_OPT in riot-rs context
        CFLAGS_OPT: -O3

  - name: opt_size
    context: riot-rs
    env:
      global:
        RUSTFLAGS:
          - -Copt-level=z
        # note: this overrides CFLAGS_OPT in riot-rs context
        CFLAGS_OPT: -Oz

  - name: thread_info
    # enable thread names & stack info
    context: riot-rs
    env:
      global:
        FEATURES:
          - riot-rs/thread_info

  - name: cross-language-lto
    # use clang/lld to link, enables cross-language LTO.
    # This requires rustc's llvm and clang's llvm version to match.
    context: riot-rs
    depends:
      - lto
    env:
      global:
        RUSTFLAGS:
          - "-Clinker-plugin-lto"
          - "-Clinker=clang"
          - "-Clink-arg=-fuse-ld=lld"
          - "-Clink-arg=--target=${RUSTC_TARGET}"
          - "-Clink-arg=-v"
        LINK_ARG_PREFIX: -Wl,

  - name: riotboot
    context: nrf52840
    env:
      global:
        FLASH_OFFSET: "0x2000"
        FLASH_SLOT_OFFSET: "0x400"
        CARGO_ENV:
          - NRF52840_FLASH_OFFSET=${FLASH_OFFSET}
          - NRF52840_FLASH_SLOT_OFFSET=${FLASH_SLOT_OFFSET}
          - NRF52840_FLASH_SLOT=0

  - name: probe-rs-run
    selects:
      - ?debug-console
    env:
      global:
        CARGO_RUNNER: "'probe-rs run --chip ${PROBE_RS_CHIP}'"

  - name: network
    selects:
      - network_device

  - name: wifi-cyw43
    context:
      - rpi-pico-w
    provides_unique:
      - network_device
    env:
      global:
        FEATURES:
          - riot-rs/wifi-cyw43

  - name: usb-ethernet
    provides_unique:
      - network_device
    selects:
      - usb_device_port
    env:
      global:
        FEATURES:
          - riot-rs/usb-ethernet

  - name: usb_device_port
    context:
      - nrf52840dk
      - rpi-pico
      - rpi-pico-w

builders:
  # host builder (for housekeeping tasks)
  - name: host
    rules:
      # currently, laze requires a LINK rule for every context/builder
      # that gets an application configured.
      # so, provide a dummy one for `host`
      - name: LINK
        description: "HOST LINK (no-op)"
        cmd: "true"

    tasks:
      install-toolchain:
        build: false
        cmd:
          - rustup target add thumbv7m-none-eabi
          - rustup target add thumbv7em-none-eabi
          - rustup target add thumbv7em-none-eabihf

      install-c2rust:
        build: false
        cmd:
          - echo "Installing c2rust..."
          - 'echo "WARNING: This uses *a lot* of memory!"'
          - cargo install c2rust

  - name: nrf52dk
    parent: nrf52832

  - name: nrf52840dk
    parent: nrf52840

  - name: dwm1001
    parent: nrf52832

  - name: nrf52840-mdk
    parent: nrf52840
    env:
      OPENOCD_ADAPTER_INIT:
        - " -c 'source [find interface/cmsis-dap.cfg]'"

  - name: microbit
    parent: microbit-base
    env:
      CARGO_RUNNER:
        - ${relroot}/${SCRIPTS}/debug-openocd.sh
      OPENOCD_ARGS:
        - "-f board/nordic_nrf52_dk.cfg"

  - name: microbit-qemu
    parent: microbit-base
    env:
      CARGO_RUNNER:
        - '"qemu-system-arm -machine microbit -nographic -semihosting-config enable=on,target=native -s -S -kernel"'
      QEMU_MACHINE: microbit
    tasks:
      qemu:
        build: true
        cmd:
          - ${QEMU_SYSTEM_ARM} ${out}

    disables:
      - periph_rtt

  - name: microbit-v2
    parent: nrf52840

  - name: lm3s6965evb
    parent: thumbv7m-none-eabi # actually eabihf, but riot-rs doesn't support hard float yet
    disables:
      - riot_support
    env:
      QEMU_MACHINE: lm3s6965evb -cpu cortex-m3
      CARGO_RUNNER:
        - '"qemu-system-arm -cpu cortex-m3 -machine lm3s6965evb -nographic -semihosting-config enable=on,target=native -kernel"'
    tasks:
      qemu:
        build: true
        cmd:
          - ${QEMU_SYSTEM_ARM} ${out}

  - name: rpi-pico
    parent: rp2040
    env:
      BOARD: rpi-pico

  - name: rpi-pico-w
    parent: rpi-pico
    env:
      BOARD: rpi-pico-w

apps:
  # define a dummy host application so the host tasks work
  - name: host
    context: host

subdirs:
  - examples
  - src