{"id":326,"date":"2019-03-19T18:38:41","date_gmt":"2019-03-20T01:38:41","guid":{"rendered":"https:\/\/sysprogs.com\/tutorials\/?p=326"},"modified":"2019-03-19T20:35:48","modified_gmt":"2019-03-20T03:35:48","slug":"developing-kernel-modules-for-xilinx-zynq-devices","status":"publish","type":"post","link":"https:\/\/sysprogs.com\/VisualKernel\/tutorials\/xilinx\/zynq\/module\/","title":{"rendered":"Developing Kernel Modules for Xilinx Zynq Devices"},"content":{"rendered":"

This tutorial shows how to create, edit and debug a basic kernel module for a Linux kernel built with Petalinux<\/a>\u00a0that is running on a Xilinx Zynq FPGA. Before you begin, install VisualKernel 3.1 or later and prepare your Petalinux project for debugging as described in this tutorial<\/a>. Also ensure your target image includes an SSH server so that VisualKernel can automatically deploy the kernel modules on it.<\/p>\n

    \n
  1. We will begin with adding a new kernel module to the Petalinux project using the Petalinux tools. If you have already created the module, you can skip this step. If not, connect to your build machine via SSH and run the following commands:\n
    cd <Petalinux tools directory>\r\n. settings.sh\r\ncd <Petalinux project directory>\r\npetalinux-create -t modules -n <module name><\/pre>\n
    \"\"<\/a><\/li>\n
  2. Start Visual Studio and open the VisualKernel module wizard:\"\"<\/li>\n
  3. On the first page select “Import an existing kernel module” and ensure you have the Advanced Kernel Project Subsystem enabled:\"\"<\/li>\n
  4. On the target selection page set the following settings:
    \n\n\n\n\n\n\n\n
    Setting<\/th>\nValue<\/th>\n<\/tr>\n
    Targeted Linux Computer<\/td>\nYour Zynq-based board running the Petalinux kernel with debugging support<\/td>\n<\/tr>\n
    Build the module on<\/td>\nThe Linux machine that has the Petalinux tools<\/td>\n<\/tr>\n
    Compatible GDB binary<\/td>\nFull path to arm-linux-gnueabihf-gdb per\u00a0this tutorial<\/a><\/td>\n<\/tr>\n
    Kernel build environment<\/td>\nConfigure manually<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \"\"<\/li>\n
  5. On the next page configure the settings as shown below:
    \n\n\n\n\n\n\n\n\n\n\n
    Setting<\/th>\nValue<\/th>\n<\/tr>\n
    Kernel type<\/td>\nShipped with Linux distro or built manually<\/td>\n<\/tr>\n
    Kernel header directory<\/td>\nThe directory containing the vmlinux<\/strong> file with symbols\u00a0per\u00a0this tutorial<\/a><\/td>\n<\/tr>\n
    Kernel symbols<\/td>\nSkip it for now. We will configure them later.<\/td>\n<\/tr>\n
    Build the project using<\/td>\nCustom cross-compiler<\/td>\n<\/tr>\n
    Target architecture<\/td>\narm<\/td>\n<\/tr>\n
    Cross-compiler prefix<\/td>\narm-xilinx-linux-gnueabi-<\/td>\n<\/tr>\n
    Environment setup file<\/td>\nThe kernel environment setup file per\u00a0this tutorial<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \"\"<\/li>\n
  6. Now we need to point VisualKernel to the source code of the module created by Petalinux. It will be typically located under <Petalinux Project>\/project-spec\/meta-user\/recipes-modules\/<Module name>\/files<\/strong>:
    \n\"\"<\/li>\n
  7. On the next page proceed with accessing the source code directly via SSH:\"\"<\/li>\n
  8. Connect your JTAG programmer to the Windows computer via USB and ensure it is connected to the target board. Then pick it in the “Debug using” field, select your debugged device (depending on the Zynq revision, you may need to modify the scripts shipped with OpenOCD) and click “Test” to verify your settings:\"\"<\/a>
    \nIf you are using OpenOCD, ensure the Startup GDB Commands field includes the “mon cortex_a maskisr on<\/strong>” command as otherwise interrupts will interfere with stepping into\/over functions and also continuing after a breakpoint.<\/li>\n
  9. Press “Finish” to create a project. Once it is created, build it by pressing Ctrl-Shift-B. Initially, VisualKernel will warn that it cannot detect the kernel module name:\"\"<\/li>\n
  10. Add the KERNEL_MODULE_NAME variable to Makefile so that VisualKernel can configure IntelliSense. Then right-click on the project and select “Reload Kernel Project”:\"\"<\/li>\n
  11. Now the IntelliSense in the main source file should be very precise. You can double-check that it is loaded correctly by checking the Advanced VisualKernel Project Output in the Output window:\"\"<\/li>\n
  12. Now we will configure the debugging settings. Open VisualKernel Project Properties and go to the Debug Settings page. Clear the following settings:
    \n\n\n\n\n\n\n
    Setting<\/th>\nReason<\/th>\n<\/tr>\n
    Display kernel output by hooking printk()<\/td>\nThis slows down debugging due to JTAG latency<\/td>\n<\/tr>\n
    Build\/install a custom kernel module for collecting module information faster<\/td>\nThe Xilinx kernel does not support tracepoints required by the helper module<\/td>\n<\/tr>\n
    Automatically detect kernels with address space randomization<\/td>\nThe Xilinx kernel does not use the address space randomization<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \"\"<\/li>\n
  13. Go to the Module Build Settings page, open the Kernel Symbols for Debugging<\/strong> selector and click “Manage cached Linux symbols”:
    \n\"\"<\/li>\n
  14. Select the machine where you have Petalinux tools installed and click “Import symbols\/sources”:
    \n\"\"<\/li>\n
  15. In the import wizard select “Specify kernel symbols and sources manually”:
    \n\"\"<\/li>\n
  16. On the second page enter the following settings per this tutorial<\/a>:
    \n\n\n\n\n\n\n
    Setting<\/th>\nReason<\/th>\n<\/tr>\n
    Kernel file with symbols<\/td>\nFull path to the vmlinux<\/strong> file built by Petalinux<\/td>\n<\/tr>\n
    Source directory<\/td>\nKernel source directory used by Petalinux (typically <build directory>\/source)<\/td>\n<\/tr>\n
    Compatible GDB binary<\/td>\nFull path to the GDB binary used by Petalinux<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \"\"<\/li>\n
  17. Once the symbols have been imported, ensure they are selected in the VisualKernel Project Properties:
    \n\"\"<\/li>\n
  18. Now you can try debugging the project, however VisualKernel will normally fail to load the module because the insmod tool is located in \/sbin<\/strong> that is not listed in the regular PATH variable:
    \n\"\"<\/li>\n
  19. You can work around it by running “echo $PATH” from an interactive SSH or serial port session on the target and setting it via Tools->VisualKernel->SSH Host Manager->Host-wide settings:
    \n\"\"<\/li>\n
  20. Now you can start debugging and VisualKernel will be able to load your kernel module and handle breakpoints inside it:
    \n\"\"<\/li>\n
  21. Use the GDB Session window to load\/unload the module as you go:
    \n\"\"<\/li>\n<\/ol>\n
     <\/p>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to create, edit and debug a basic kernel module for a Linux kernel built with Petalinux\u00a0that<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[51],"tags":[50,20,48],"_links":{"self":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/326"}],"collection":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/comments?post=326"}],"version-history":[{"count":4,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/326\/revisions"}],"predecessor-version":[{"id":372,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/326\/revisions\/372"}],"wp:attachment":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/media?parent=326"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/categories?post=326"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/tags?post=326"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}