Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
resources:eval:user-guides:eval-ad5940:tools:keil_setup_guide [24 Aug 2021 11:34] – [How to Download Keil] Tracey Johnsonresources:eval:user-guides:eval-ad5940:tools:keil_setup_guide [11 Aug 2022 14:44] (current) – arm v5 compiler download instructions completed Hans Boot
Line 9: Line 9:
 Once the software has downloaded an evaluation licence is required. Keil offers two different evaluation licences, time limited and size limited. Choose the size limited licence. This limits the allowable code size to 32kB. All the AD5940 example projects are within this limitation. Once the software has downloaded an evaluation licence is required. Keil offers two different evaluation licences, time limited and size limited. Choose the size limited licence. This limits the allowable code size to 32kB. All the AD5940 example projects are within this limitation.
  
 +The latest versions of Keil use the ARM compiler v6, but the example code still uses v5, and refuses to compile under v6. Therefore, you will also need to download the legacy compiler, and install it at the correct location (not the default location), as shown in https://developer.arm.com/documentation/ka005073/latest
 ===== How to edit and run example code in Keil===== ===== How to edit and run example code in Keil=====
 To edit and run example code in Keil follow these steps: To edit and run example code in Keil follow these steps:
Line 17: Line 18:
    
 </WRAP> </WRAP>
 +//(**Hint:** Also download the included submodule in examples/ad5940lib. This can be done with the git bash in one step by executing: "git clone --recurse-submodules https://github.com/analogdevicesinc/ad5940-examples.git" (without the double quotes))//
 +
   - Navigate to the **examples->AD5940_ADC->ADICUP3029**   - Navigate to the **examples->AD5940_ADC->ADICUP3029**
   - Double click on ADICUP3029.uvprojx file to open the project in Keil [The package at https://github.com/analogdevicesinc/ad5940-examples doesn't contain ADICUP3029.uvprojx in **examples->AD5940_ADC->ADICUP3029** or other folders]   - Double click on ADICUP3029.uvprojx file to open the project in Keil [The package at https://github.com/analogdevicesinc/ad5940-examples doesn't contain ADICUP3029.uvprojx in **examples->AD5940_ADC->ADICUP3029** or other folders]
   - The project structure is shown in the left hand side of the screen. It is divided into 4 sub sections:   - The project structure is shown in the left hand side of the screen. It is divided into 4 sub sections:
-     * **AD5940Lib** - This conatins the AD5940.c source file which has all the AD5940 library functions. This file is common to all examples. The ADICUP3029Port.c file is located here also and contains port functions for the ADuCM3029 microcontroller.+     * **AD5940Lib** - This contains the AD5940.c source file which has all the AD5940 library functions. This file is common to all examples. The ADICUP3029Port.c file is located here also and contains port functions for the ADuCM3029 microcontroller.
      * **Application** - This sub section contains the application code and main.c file.      * **Application** - This sub section contains the application code and main.c file.
      * **CMSIS** - This contains the arm CMSIS math library.      * **CMSIS** - This contains the arm CMSIS math library.
Line 26: Line 29:
   - Double click on AD5940_ADCPolling.c to open the file in the editor.    - Double click on AD5940_ADCPolling.c to open the file in the editor. 
   - Modify code as required.   - Modify code as required.
-  - To compile and build the project go to **Project->Rebuild all target files**. IT may take a couple of seconds to fully compile all the source code.+  - To compile and build the project go to **Project->Rebuild all target files**. It may take a couple of seconds to fully compile all the source code. 
 +  - If you see build errors like 'Fatal Error[Pe1696]: cannot open source file "adi_cycle_counting_config.h"', you need to add/adjust include paths: 
 +     * Click Menu > Project > Options > C/C++ Compiler > Preprocessor > Additional include directories (click on the three dots on the right) 
 +     * Click on '<Click to add>' 
 +     * Find the file on your computer and add it, e.g. navigate to (and then select): 'C:\ad5940-examples\examples\AD5940_BATImpedance\ADICUP3029\RTE\Device\ADuCM3029' (adjust the path depending on where you stored the example folder, which example project you use and which include file is missing) 
 +     * Click OK twice, then Menu > Project > Clean 
 +     * Click Menu > Project > Rebuild All
   - To download the code to the evaluation boards first ensure the boards are connected to the PC or laptop. Then click on the red icon in the toolbar to download the source code and begin the debugging session. {{ :resources:eval:user-guides:eval-ad5940:tools:keil_debug.png?nolink&600 |}}   - To download the code to the evaluation boards first ensure the boards are connected to the PC or laptop. Then click on the red icon in the toolbar to download the source code and begin the debugging session. {{ :resources:eval:user-guides:eval-ad5940:tools:keil_debug.png?nolink&600 |}}
   - To set breakpoints click to the left of the line of code. A red dot will appear as in below screenshot.   - To set breakpoints click to the left of the line of code. A red dot will appear as in below screenshot.
   - To begin executing press the "Run" button which is highlighted in below screenshot. {{ :resources:eval:user-guides:eval-ad5940:tools:keil_debugger.png?nolink&600 |}}   - To begin executing press the "Run" button which is highlighted in below screenshot. {{ :resources:eval:user-guides:eval-ad5940:tools:keil_debugger.png?nolink&600 |}}
 +  - Hint: If downloading the code didn't work because of an error like this: 'Failed to load flash loader: C:/Users/YourUsername/IAR-CMSIS-Packs/AnalogDevices/ADUCM302x_DFP/3.2.0/\ARM\config\flashloader\AnalogDevices\FlashADUCM3029.flash':
 +     * Try this method instead: https://wiki.analog.com/resources/eval/user-guides/eval-adicup3029/tools/adicup3029_hw_drivers#daplink_drive
 +     * If your board doesn't start after this, give flashing/debugging using the steps described above another try - sometimes it works again.
  
resources/eval/user-guides/eval-ad5940/tools/keil_setup_guide.txt · Last modified: 11 Aug 2022 14:44 by Hans Boot