Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Download Docker Desktop for Apple Silicon (https://www.docker.com/products/docker-desktop/ )

  2. Install the latest version of vagrant (https://www.vagrantup.com/downloads )

    1. For M1s, you can use brew or you can download the ARM64 version

  3. Clone the repo: git clone https://github.com/uw-midsun/box.git

  4. Go to your box directory and switch to master branch

    1. You can check if you are on the master branch if you run git branch

      Code Block
      ~ % cd box 
      box % git checkout master
  5. Before running vagrant up , make sure that you have docker open

  6. There is a current error with vagrant 2.4.1 (this issue may be fixed in future versions) which can be fixed with a one line change. Go into the box repository
    If you get this type of error, follow the instructions below:

    Image Added
    Code Block
    ~ % cd box 
    box % cd /opt/vagrant/embedded/gems/gems/vagrant-2.4.1/plugins/providers/docker
    # Using whatever code editor (or use sudo vim) to edit the driver.rb file in this directory
    # If you are not comfortable doing this, please ask a lead and they can help you
    # Go to line 352 and replace "if (config.size > 0 &&" with 
    
    # if (defined?(config.size) &&
                config.size > 0 &&

The end result will look like this, you will need to sudo save if you are using vscode or another editor:

...

Once this file is saved, you can return the box repository and continue on

  1. Run vagrant up --provider=docker

  2. Run vagrant ssh

  3. Run cd shared

  4. Run git clone https://github.com/uw-midsun/fwxv.git && cd fwxv (if you clone with https, you will need to set up an ssh key later which is covered in our setup page)

  5. Run scons sim --project=leds --platform=x86 to test that your environment is working correctly. If it compiles and runs your environment is set up. Correct output will be constant printing of “blink.” To stop the output, just click ctr + c.

  6. If you get to this step and are following the FW101 setup, please return to the setup page Setup and start at the ssh keygen section.

👾 Guide to flashing on M1s

...