{"id":108,"date":"2018-11-18T09:48:47","date_gmt":"2018-11-18T17:48:47","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=108"},"modified":"2023-09-20T21:52:58","modified_gmt":"2023-09-21T04:52:58","slug":"arm-keil","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/arm\/keil\/","title":{"rendered":"Developing Keil MDK-ARM Projects with VisualGDB"},"content":{"rendered":"

This tutorial shows how to use VisualGDB to create, build and debug an MSBuild-based project using the Keil MDK-ARM compiler.<\/p>\n

Starting from VisualGDB 5.4 Preview 10, the Keil compiler is fully supported on par with the GCC compiler, so you can use the regular VisualGDB\u00a0GUI to create your projects and manage their settings.<\/p>\n

    \n
  1. Open Visual Studio and begin creating a new Embedded VisualGDB project:\"01-prjname\"<\/a><\/li>\n
  2. Select “Create a new project” -> “MSBuild”:\"02-msbuild\"<\/a>VisualGDB\u00a0can also create\u00a0GNU Make-based projects using the Keil compiler, however the MSBuild-based projects\u00a0provide better GUI integration and build faster.<\/li>\n
  3. Select your Keil toolchain on the Device Selection<\/strong> page. Note that VisualGDB supports both the classic ARMCC compiler (V5) and the newer Clang-based compiler (V6):
    \n    \"03-armclang\"<\/a>If the Keil compilers don’t appear in the toolchain list, see this page<\/a> for troubleshooting instructions.<\/li>\n
  4. Once the toolchain is selected, pick your device from the list. When using the Keil toolchains, VisualGDB will automatically load device lists from the Keil packs, so you\u00a0will be able to target any device supported by the Keil\u00a0environment even if it’s not directly supported by VisualGDB:\"04-device\"<\/a>If no devices appear in the list when you select the Keil compiler, you might be missing the Keil device packs, or have them installed in an unexpected location. If you enable the View->Other Windows->VisualGDB Diagnostics Console<\/strong> prior to opening the wizard, VisualGDB will print a verbose log from looking up the Keil packs there. If your pack directory is not listed, you can specify it via Tools->Options->VisualGDB->Embedded->Keil->Extra Pack Directories<\/strong>.<\/span><\/li>\n
  5. Projects\u00a0created using the Keil toolchain always start empty, so simply press “Next” on the Sample Selection page:
    \n    \"05-sample\"<\/a><\/li>\n
  6. Finally select\u00a0the debug method for your device and press “Finish” to create the project:\"06-debug\"<\/a><\/li>\n
  7. VisualGDB will create an empty project with no source files that will target the selected device:
    \n    \"empty\"<\/a><\/li>\n
  8. If you are using the Custom edition of VisualGDB or higher, right-click on the project in Solution Explorer,\u00a0click “VisualGDB Project Properties” and go to the “Keil Components” page.\u00a0Ensure that the “Automatically\u00a0manage RTE_Components” flag is set:\"07-packs\"<\/a>For lower editions of VisualGDB, use the regular Add->Existing Item<\/strong> menu to manually adds sources and headers to the project.<\/li>\n
  9. Check the “Device->Startup” and “Device->STM32Cube HAL->GPIO” components. VisualGDB will automatically detect their dependencies and suggest adding them as well:\"08-getpack\"<\/a><\/li>\n
  10. Click “OK” to proceed. VisualGDB will\u00a0show a list of file templates\u00a0offered by the selected components. Check the “main module for STM32Cube HAL” template and click “OK”: \"09-template\"<\/a><\/li>\n
  11. VisualGDB will\u00a0automatically\u00a0add files from the selected components (including a copy of the main.c file) to your project, allowing you to build it:\"10-build\"<\/a><\/li>\n
  12. Open the regular VS Project Properties. Note that the properties reflect the Keil-specific flags (e.g. allowing you to use scatter files instead of linker scripts):\"11-props\"<\/a><\/li>\n
  13. Open the Keil Components page of VisualGDB Project Properties again, pick your development board from the list and check the “LED”\u00a0component:\"12-led\"<\/a><\/li>\n
  14. Include the\u00a0<Board_LED.h><\/strong> file from your main file and add the following code to the end of main():\n
    LED_Initialize();\r\nfor (;;)\r\n{\r\n    LED_On(0);\r\n    HAL_Delay(100);\r\n    LED_Off(0);\r\n    HAL_Delay(100);\r\n}<\/pre>\n
    Also add a basic SysTick_handler implementation:<\/p>\n
    void SysTick_Handler(void)\r\n{\r\n    HAL_IncTick();\r\n}<\/pre>\n<\/li>\n
  15. Press F5 to\u00a0begin debugging. Once the on-board LED starts blinking, set a breakpoint in the main loop and wait for it to trigger:
    \n    \"13-blink\"<\/a>Warning:<\/strong> if the breakpoint never hits and the target appears stuck in the initialization code, try settings the VisualGDB Project Properties -> Debug Settings -> Reset Device -> After Programming<\/strong> checkbox. It will ensure that the device is in the correct state after the FLASH memory programming is completed.<\/li>\n
  16. Note that VisualGDB will automatically load the memory layout and the hardware register definitions from the Keil packs, so you\u00a0won’t need to specify them manually:
    \n    \"14-regs\"<\/a><\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to use VisualGDB to create, build and debug an MSBuild-based project using the Keil MDK-ARM compiler.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[27],"tags":[53,147],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/108"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=108"}],"version-history":[{"count":7,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/108\/revisions"}],"predecessor-version":[{"id":8418,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/108\/revisions\/8418"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=108"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=108"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=108"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}