Installing the IDE ❖ Windows copy - EPFL-MICRO-315/TPs-Wiki GitHub Wiki

⚠ WARNING ⚠

This page was for 2023 TPs.

The new tools for 2024 are still in development then thank you to wait until this page will be updated and this warning removed!


👉 Step 1

  • download the .zip of the setup program here
  • extract the .zip (right click - extract)
  • launch As Administrator the install script Create_VSCode_e-puck2-RefTag/windows.bat. The simplest way is to do a <Right-click> on this batch in the Windows Explorer then Run as administrator

drawing

drawing

Enter Yes in order to accept to launch this batch in Administrator.

  • 💡 this window pop-up because the install script is not signed, however there are no risk so you can click on More info
  • then run anyway

drawing

drawing

👉 Step 2

  • type y and enter to proceed the installation of IDE VSCode_EPuck2
  • type y and enter to install git and its tools git-credential-manager
  • 💡 it's highly recommended to type y if you are not sure whether or not Git Credential Manager is installed
  • click on Yes to authorize the Git installer to proceed
  • inside the git installer, click on next (many times) in order to use default choices and at the end click on finish. Make sure that Git Credential Manager is selected

drawing drawing

👉 Step 3

  • the IDE is by default installed under C:/Users/UserName/AppData/Roaming, it is however possible type another path if needed

drawing

  • if the install script encounters no errors, the output should look something the pictures below

drawing

drawing

drawing

👉 Step 4

  • by default, the workplace folder is located at C:/Users/UserName/Documents/EPuck2_Workplace, it is however possible type another path if needed
  • type y and enter to have shortcuts on the desktop and start menu
  • if the install script encounters no errors, the output should look something the pictures below

drawing

Congratulations ! The IDE VSCode EPuck2 has been successfully installed 🥇

⚠ First launch of the IDE

When you first launch the IDE VSCode EPuck2, the windows firewall will alert you about some functionalities that has been blocked

  • click on cancel

drawing

Change the default shell of the terminal to Git Bash by performing as follows:

  • Open the command palette with Ctrl + Shift + P (Cmd + Shift + P on MacOS);
  • Execute the Terminal: Select Default Profile command;
  • Select Git Bash.

⚠ DFU-Util - Adapt the Driver

Will be introduced in detail later then you can skip this section for the moment

  • In the case you have to program the main processor using the DFU mode, you might need to install a driver for the STM32 BOOTLOADER
  • You can see whether or not a driver is installed for the STM32 BOOTLOADER by opening the device manager and searching for STM32 BOOTLOADER
  • ⚠ the epuck2 must be connected and booted in the main processor DFU mode

drawing

  • Go to your InstallPath/EPuck2Tools/Utils
  • Run zadig-2.3.exe
  • Chek that STM32 BOOTLOADER is selected
  • Select libusbK
  • click on Install Driver

drawing

💡 Further readings

⚠⚠⚠⚠ QUICK FIX for missing Library ⚠⚠⚠⚠

  1. Ensure you have Git Bash as default profile for terminal, as explained in first launch of the IDE;
  2. Delete the Lib folder under the Workplace folder;
  3. Delete the broken link e-puck2_main-processor inside the TPs folder;
  4. Open a Git Bash command line in the Workplace (the folder that contained the Lib folder before Lib was deleted);
  5. Execute the command: git clone --recurse-submodules https://github.com/EPFL-MICRO-315/Lib_VSCode_e-puck2.git Lib;
  6. Execute the task in VSCode Link library epuck2 main processor to workspace.
⚠️ **GitHub.com Fallback** ⚠️