This repo contains descriptions and scripts to install a development enviroment for the Rust-on-embedded workshop in Gouda, March 5th.

Preparing your laptop for the meetup

There are two ways to prepare:

1. Use the provided Virtual Machine
2. Install the required tools on your Linux of MacOS machine

Note: for Windows users, please use the provided Virtual Machine

Virtual Machine

DO THIS BEFORE MONDAY EVENING !!! (our WiFi is limited)

The Virtual Machine was created with VirtualBox and was exported as an 'appliance'. It can be downloaded from https://goo.gl/9EJEx3.

Some facts about the VM:

• based on Ubuntu 17.10
• automatically logs in to the 'rustacean' account
• that account's password is 'rust'
• which allows you to do 'sudo'
• it has the entiry toolchain installed

Install the required tools

Again, two choices:

1. use the scripts in the setting_up directory in this repo (Linux only)
   • for Ubuntu-like system run the 'install_ubuntu_packages.sh' script, on other systems look in that file and install the necessary dependencies
   • run 'setup.sh' (this script can be run multiple times)
2. do it by hand using the following guide:

Install by hand

Commands to be entered on the command line are shown like this.

1. Install Rustup
   • install from https://rustup.rs
   • or update your Rust installation rustup update
2. Install the Rust nightly compiler
   • rustup toolchain add nightly
3. Select the nightly compiler as default
   • rustup default nightly
   • or remember to set it as an override for every project during the workshop
4. (NEW) Install the GNU ARM Embedded toolchain
   • from https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads
   • put the bin directory in your $PATH
5. (NEW) Install dfu-util using your platform's package manager
   • on Debian-like systems: sudo apt install dfu-util
   • on macOS, you can use homebrew: brew install dfu-util
6. Install Xargo
   • cargo install xargo
   • to update cargo install --force xargo
7. Install Bobbin (from my fork)
   • cargo install --git git://github.com/egribnau/bobbin-cli
   • to update from my fork cargo install --force --git git://github.com/egribnau/bobbin-cli

Install optional tools

These tools are installed in the VM, but are optional:

1. Visual Studio Code
   • install from https://code.visualstudio.com/
2. Rust Language Server
   • rustup component add rls-preview rust-analysis rust-src
3. Visual Studio Code RLS support
   • install the Rust (rls) addon package, typically by hitting Ctrl-P in Code and then entering ext install rust (rls). Install the top one.

Fallback

On March 5th, we will provide support if you cannot get the tools installed. We will have a limited amount of USB-sticks with the VM available.