Each group automatically gets assigned to a Git Repository on the Systems Engineering Chairs Gitlab Instance.
Please find your groups repository and clone it to a suitable location with the URL presented under the blue button "Code":
cd <path-to-suitable-location>
git clone git@se-gitlab.inf.tu-dresden.de:robolab-spring/<term>/group-<id>.git
cd group-<id>
Make sure to clone with SSH, not with HTTPS!
To give you some guidance at the beginning, we initialized the group repositories with a helpful template.
It contains a Rust Project with all essential dependencies, skeleton source files for each task and a justfile for convenient compilation, testing and deployment.
Look here for a template explanation
Just is a modern command runner that conveniently executes commands pre-defined in a justfile.
Unlike Make, it isn't a misused build automation system but was created specifically for this purpose.
It can be installed using your system's package manager:
winget install Casey.Just # Windows
brew install just # macOS
apt install just # Debian, Ubuntu, Linux Mint
pacman -S just # Arch
dnf install just # Fedora
cargo install just # Others
just --version
> just 1.46.0 # must be at least 1.37.0
Please make sure to have at least Version 1.37.0 installed, otherwise uninstall and install with cargo
Commands are defined in a file called "justfile", and can be listed and run by invoking the just command in the same directory:
just
> Available recipes:
> ...
just setup
Please make yourself familiar with all the commands, as they are used to build, test and deploy your code. Also there are helpful commands to manage your code and robot.
It is also beneficial to read the justfile and try to understand how each command is implemented.
Make sure your SSH Connection works (> SSH-Brick), and configure ROBOT_IP in config.just.
Make sure to not include leading zeros (172.30.1.21 instead of 172.30.1.021)
To make sure all required toolchains and tools are installed, please run the setup routine first.
just setup
After that, run just deploy to build and deploy your first code to the Robot.
You should get the output "Hello from bot!" in your Terminal.
just deploy
[...] // A lot of first-time compiling happens
Finished `release` profile [optimized] target(s) in 0.11s
[...] // Copy and execute binary
Hello from bot!
If you instead get a
no authentication methods succeedederror while the command is trying to getrobolab-bot-base, then please make sure, that your ssh-agent is running and knows your private key. > How-To > SSH