Configuring Firmware Toolchain¶
This page will describe the steps necessary to install the MDK-ARM Keil software for compiling the firmware, and the necessary steps to configure your firmware repository
Installing Keil¶
Here we will guide you through the installation of Keil. This installation requires Marco Accame to configure your license, so contact him in advance before proceeding with the installation!
Download Keil¶
You can download Keil at the following address: https://www.keil.com/demo/eval/arm.htm. This will require a registration, after which you will be provided with the download link:
Installing Keil¶
Run the installer that you downloaded on the previous step. During the installation you will be asked to input your data again, but instead of using your own email write Marco Accame's email: marco.accame@iit.it
Important Note: At this point it is fundamental that Marco knows you are installing Keil, and is expecting the email to arrive in his account, in order to speed up the process!
Configuring your license¶
Now that you have Keil installed, you need to configure your license.
Open Keil, and navigate to the File->License Management
menu:
This will open the license management box, where you can manage all your licenses.
To proceed with the configuration of your license, press the
Get LIC via Internet...
button.
In this form you will be asked to insert the name of your computer, and the PSN key. For the name of the computer, we strongly recommend you use your initials so it is easier to manage the licenses in the future. Marco Accame will provide you with the PSN key to complete the form.
Once this form is completed you may request the license, which will be sent to
Marco Accame, who will then forward to you. Once you have the key you can write
on the New License ID Code (LIC)
box and add it to your licenses:
This completes the Installation and license configuration for Keil!
Configuring iCub-firmware¶
Now that Keil is installed and running, you need to setup the firmware and its shared repositories, which can be cloned from the follow link:
You can clone these repositories anywhere in your computer as long as they are both in the same directory. Once you clone the two repositories, you will need an extra library that is available on IITs intranet in the following path:
\\storage05.icub.iit.local\repository\software\ipal-extra
Unzip this new library file into the following path (replace ${YOUR_DIRECTORY}
with the path where you cloned the two repositories):
${YOUR_DIRECTORY}\icub-firmware\emBODY\eBcode\arch-arm\libs\highlevel\abslayer\ipal\
To properly configure this library, open Keil, go to the Project->Open Project
menu, navigate to the path above and select the ipal.uvprojx
project file.
Now you should be able to visualize all the files from this project on the left
workspace of Keil:
The final step to configure the library is to press the Build
button highlighted
by the red box on the image.
Testing your toolchain¶
Congratulations! You just built your first project using Keil!
In order to verify that everything is configured properly, you can try building the project for the mc4 board located in the following path:
${YOUR_DIRECTORY}\icub-firmware\emBODY\eBcode\arch-arm\board\mc4plus\appl\v2\proj\
Select the mc4plus.diagnostic2ready.uvprojx
project, and press the Build
button
just like for the ipal
library. You should see on the output workspace (bottom
of Keil window) a similar output (with 0 errors):