Skip to content

Tutorial for hello_world incomplete/buggy #21733

@thoastbrot

Description

@thoastbrot

Description

Trying to follow the tutorial at https://guide.riot-os.org/rust_tutorials/create_project/, I stumble about various issues.

  • it says to create a directory (hello_world) and change into it, then checkout RIOT. Few steps later, I create a crate, supposedly that directory. Could have been streamlined: create crate, init git, checkout RIOT as submodule.
  • Makefile references RIOT a few levels up - doesn't really matter, but poses the question why it was placed in the project directory in the first place (instead of somewhere shared, like this suggests)
  • I then should make info-rust, which complains that the $(RIOTBASE) is a directory(. Stop.)

I don't know what that was supposed to do or if the directory tree is wrong...

Steps to reproduce the issue

Follow the guide.

Expected results

Should lead to a buildable hello world project, so I have a stable base to continue exploring RIOT-OS.

Actual results

Stuck with errors I shouldn't be dealing with.

Versions

Operating System Environment
----------------------------
         Operating System: "Arch Linux" 
                   Kernel: Linux 6.16.7-arch1-1 x86_64 unknown
             System shell: GNU bash, Version 5.3.3(1)-release (x86_64-pc-linux-gnu)
             make's shell: GNU bash, Version 5.3.3(1)-release (x86_64-pc-linux-gnu)

Installed compiler toolchains
-----------------------------
               native gcc: gcc (GCC) 15.2.1 20250813
        arm-none-eabi-gcc: missing
                  avr-gcc: missing
           msp430-elf-gcc: missing
       riscv-none-elf-gcc: missing
  riscv64-unknown-elf-gcc: missing
      riscv32-esp-elf-gcc: missing
     xtensa-esp32-elf-gcc: missing
   xtensa-esp32s2-elf-gcc: missing
   xtensa-esp32s3-elf-gcc: missing
   xtensa-esp8266-elf-gcc: missing
                    clang: clang version 20.1.8

Installed compiler libs
-----------------------
     arm-none-eabi-newlib: missing
        msp430-elf-newlib: missing
    riscv-none-elf-newlib: missing
riscv64-unknown-elf-newlib: missing
   riscv32-esp-elf-newlib: missing
  xtensa-esp32-elf-newlib: missing
xtensa-esp32s2-elf-newlib: missing
xtensa-esp32s3-elf-newlib: missing
xtensa-esp8266-elf-newlib: missing
                 avr-libc: missing (missing)

Installed development tools
---------------------------
                   ccache: missing
                    cmake: cmake version 4.1.1
                 cppcheck: missing
                  doxygen: 1.14.0
                      git: git version 2.51.0
                     make: GNU Make 4.4.1
                  openocd: missing
                   python: Python 3.13.7
                  python2: Python 2.7.18
                  python3: Python 3.13.7
                   flake8: error: /usr/bin/python3: No module named flake8
               coccinelle: missing

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions