Skip to content

Latest commit

 

History

History
66 lines (63 loc) · 3.72 KB

README.md

File metadata and controls

66 lines (63 loc) · 3.72 KB

Onethinx Core MAC OS-X dependencies pack

How to setup Visual Studio Code with the Onethinx Core dependencies pack

The instructions on how to update are way down below.

1. Download prerequisites

2. Install CMake, VS Code & extensions

  • Install CMake.
  • Install VS Code.
  • Install extensions:
    • ARM Assembly Support For Visual Studio Code (dan-c-underwood)
    • C/C++ IntelliSense, debugging (microsoft)
    • CMake language support (twxs)
    • CMake Tools (microsoft)
    • Cortex-Debug GDB support (marus25)
    • Output Colorizer (IBM)
    • Power Tools (e.GO Mobile)
    • Tasks (actboy168)
  • Apply the CMake path to VS Settings: "cmake.cmakePath": "/Applications/CMake.app/Contents/bin/cmake",

3. Install the Onethinx Dependencies Pack

  • Unzip the pack archive to your local harddisk (eg: /Applications/VSCode_OnethinxPack_macOS).
    • Hint: you might want to remove '-main' at the end of the folder name.
  • If you're on Catalina (macOS 10.15) or later:
    • If the file ~.zprofile doesn't exist, create it: Terminal >> cd ~ && touch .zprofile
    • Open ~.zprofile: Terminal >> cd ~ && open -e .zprofile
  • If you're on Mojave (macOS 10.14) or earlier:
    • If the file ~.bash_profile doesn't exist, create it: Terminal >> cd ~ && touch .bash_profile
    • Open ~.bash_profile: Terminal >> cd ~ && open -e .bash_profile
  • Add this to the end of the file (make sure you enter the correct path for ONETHINX_PACK_LOC) and save: 
    # Loading environment variables for the Onethinx Pack
export ONETHINX_PACK_LOC="/locationOfYour/VSCode_OnethinxPack_macOS"
source "$ONETHINX_PACK_LOC/variables.env"
  • Restart your machine (or log-out and log-in) to reload the environment variables.

4. Check

  • If CMake, Make and the compiler is correctly installed by typing the following into your terminal or terminal window of VS Code.
    • make -v
    • cmake --version
    • arm-none-eabi-gcc -v
  • If you have not done this yet, download the Hello World Project

5. Remind

  • After changing the device configuration (or project file structure) to use
    • Clean Reconfigure
    • Clean Rebuild in order to build the image properly
  • To delete the contents of the build folder
    • if you copied the project including build folder from another location / machine
    • when build fails.

How to update

  • Download the latest Onethinx Dependencies Pack
  • Delete the contents of the Dependencies Pack folder from you harddisk
  • Unpack the contents of the archive to the Dependencies Pack folder
  • Make sure the correct path is set in the environment variables (see step 3)
  • Restart your machine (or log-out and log-in) to reload the environment variables.
  • If not done yet, update your projects CMakeLists.txt: change ${TOOL_LOC} to $ENV{ONETHINX_TOOLS_LOC} (see the Project Examples for reference).