Versions Compared

Old Version 2

changes.mady.by.user Aaron Chan (RIT Student)

Saved on

compared with

New Version Current

changes.mady.by.user Yevgeniy Gorbachev (RIT Student)

Saved on

Key

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

...

...

...

...

...

...

MacOS/Linux

set -gx GCC_ARM_TOOLS_PATH
Expand
titleLinux Setup Procedure
Set up

Setting Up the Environment

  • Procedure written for a Debian Ubuntu environment, but the procedure can be easily adapted for any linux distro
  1. Install GNU ARM Embedded Toolchain
    1. Download  'arm-gnu-toolchain-??.?.rel?-x86_64-arm-none-eabi.tar.xz' from https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads
      1. On MacOS, you will want 'arm-gnu-toolchain-??.?.rel?-darwin-x86_64-arm-none-eabi.tar.xz'
    2. Extract code to desired directory.
      1. tar -xvf <gcc-arm-.tar.bz2>xz> -C <desired compiler location>
      2. the compile location should be somewhere permanent
    3. Set GCC_ARM_TOOLS_Add to PATH environment variable

      1. Edit shell's rc file's (~/.bashrc  or ~/.zshrc  depending on your shell and append the following line) PATH variable  

        Code Block
        languagebash
        themeMidnight
        export GCC_ARM_TOOLS_PATH=<your_path_to_gcc_arm>/bin

        On fish, it's ~/.config/fish/config.fish

Code Block
PATH=$PATH:<your_path_to_gcc_arm>/bin


  • On MacOS there are two possible locations you may need to put the line above. Execute the command below to determine where to place the line

    Code Block
    echo "$SHELL"

    If you got /bin/zsh  then add the export to ~/.zshrc , if you have /bin/bash then add the export to ~/.bash_profile .

  • Update environment
    1. Easiest way is to restart your shell (close & open the terminal window)

    2. source ~/.bashrc  or ~/.zshrc  or ~/.config/fish/config.fish 

    3. On MacOS source ~/.zshrc  if you have ZSH or ~/.bash_profile  if you have bash


    • Windows

    Expand
    titleWindows Setup Procedure

    Setting Up the Environment

    Install CmakeDownload Windows installer from: https://cmake.org/download/

    2. Choose Add to path option (can choose current user or all users)
      3. Install GNU ARM Tools Path
      1. Download Installer from https://developer.arm.com/open-source/gnu-toolchain/gnu-rm/downloads
        1. Should have a name similar to "gcc-arm-XXXXXXXX-mingw-w64-i686-arm-none-eabi.exe"
      2. To avoid problems later on, make sure you the path to the toolchain has no spaces
        1. You will have to manually modify the automatically generated path because it has spaces in it
        2. Ex: C:\Program_Files_No_Spaces\Arm_GNU_Toolchain_arm-none-eabi\11.2_2022.02
      3. Take note of the install location and save for later.
    3. Install Git for Windows
      1. Download Installer from https://git-scm.com/download/win


    SSH Key 

    Expand
    titleSSH Key Setup Procedure

    SSH Key Setup 

    This is so you can do git submodules which is necessary for pulling launch-core to the module repositories

    1. Run ssh-keygen in your terminal
    2. Walk through the installer
    3. Once the key has been generated, locate the files where the keys has been saved (chosen in the walkthrough)
    4. Copy the contents of the file ending in .pub into GitHub which can be found at https://github.com/settings/keys

    Editors

    Expand
    titleSetup Procedures

    Editor Setup

    Setting Up VS Code

    • Light Weight Fully Fledged IDE for C/C++ Editor for software development.  Provides the following useful features
      Syntax highlighted and easy code navigation
    • Helpful customizations to enable high efficiency coding
    • GUI Interface for GDB Debugger for debugging code with breakpoints and memory view
      1. Download VS Code: https://code.visualstudio.com/download
      2. Download necessary VS Code extensions
        1. On the left hand side of the VS Code window, there is an extensions tab. Click on this tab and search for and install the following extensions:
          1. C/C++ Extension Pack
      2. Github
          1. GitHub Repositories
      3. Github
          1. GitHub Pull Requests and Issues
    4. Clang-Format
      5. Set up a Github account if you do not already have one:

    Setting Up CLion

    • IDE for C/C++ development. 
      1. Sign up for a JetBrains student pack or GitHub student pack (will take a few days to verify)
        1. https://www.jetbrains.com/community/education/#students    
        2. https://education.github.com/
      2. joinUse this tutorial to setup/authorize your github account in vscode:
        1. pack
      2. Install either JetBrains Toolbox which will allow you to install multiple JetBrains editors or install just CLion
        1. https://
      3. docs
        1. www.
      4. microsoft
        1. jetbrains.com/
      5. en-us/learn/modules/introduction-to-github-visual-studio-code/Set up Clang ToolsDownload the LLVM Windows installer from
        1. toolbox-app/
        2. https://
      6. releases
        1. www.
      7. llvm.org
      1. Make sure the version is 13.0.0 or later
      2. The installer should be titled something like "LLVM-x.x.x-win64.exe"
    7. Run the installer, making sure to select the option to add LLVM to the system PATH
    8. Clang tools will not start working until after a restart.

    SSH Key 

    Expand
    titleWindows Setup Procedure

    SSH Key Setup 

    1. Run ssh-keygen in your terminal
    2. Walk through the installer
    3. Once the key has been generated, locate the files where the keys has been saved (chosen in the walkthrough)
      4. Copy the contents of the file ending in .pub into GitHub which can be found at https://github.com/settings/keys
        1. jetbrains.com/help/clion/installation-guide.html#standalone 

    Setting Up STMCubeIDE

    • IDE designed for STM32 development 
      1. Install https://www.st.com/en/development-tools/stm32cubeide.html