You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/hardware/04.pro/boards/portenta-h7/tutorials/lauterbach-debugger/content.md
+32-27Lines changed: 32 additions & 27 deletions
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,13 @@
1
1
---
2
2
title: 'Lauterbach TRACE32 GDB Front-End Debugger for Portenta H7'
3
-
description: 'This tutorial will show you how to use the Lauterbach TRACE32 GDB front-end debugger to debug your Portenta H7 or Nicla Vision applications via GDB on a serial interface.'
3
+
description: 'This tutorial will show you how to use the Lauterbach TRACE32 GDB front-end debugger to debug multiple Arduino applications via GDB on a serial interface.'
4
4
coverImage: assets/por_ard_trace32_cover.svg
5
5
difficulty: advanced
6
6
tags:
7
7
- Debugging
8
8
- Lauterbach
9
9
- TRACE32
10
-
author: 'Marco Ferrario, Lauterbach Italy, Sebastian Romero, Marta Barbero'
10
+
author: 'Marco Ferrario, Lauterbach Italy, Sebastian Romero, Benjamin Dannegård, Marta Barbero'
11
11
hardware:
12
12
- hardware/04.pro/boards/portenta-h7
13
13
- hardware/06.nicla/boards/nicla-vision
@@ -17,34 +17,37 @@ software:
17
17
- web-editor
18
18
---
19
19
## Overview
20
-
This tutorial will show you how to use the Lauterbach TRACE32 GDB front-end debugger to debug your Portenta H7 or Nicla Vision applications via GDB on a serial interface. It also explains how to obtain a free license of a fully functional version of TRACE32 using your board's serial number.
20
+
21
+
This tutorial will show you how to use the Lauterbach TRACE32 GDB front-end debugger to debug your Arduino boards' applications via GDB on a serial interface. It also explains how to obtain a free license for a fully functional version of TRACE32 using your board's serial number.
21
22
22
23
## Goals
23
24
24
-
- How to get a free license key for TRACE32 GDB Front End debugger for Portenta H7 or Nicla Vision - M7 core
25
+
- How to get a free license key for TRACE32 GDB Front End debugger
25
26
- How to download and start the Lauterbach TRACE32 GDB Front End debugger
26
27
- How to Flash and debug some ready-to-run demos
27
28
28
29
### Required Hardware
29
-
-[Portenta H7 (ABX00042)](https://store.arduino.cc/products/portenta-h7), [Portenta H7 Lite (ABX00045)](https://store.arduino.cc/products/portenta-h7-lite) or [Portenta H7 Lite Connected (ABX00046)](https://store.arduino.cc/products/portenta-h7-lite-connected) or [Nicla Vision (ABX00051)](https://store.arduino.cc/products/nicla-vision)
30
+
To use the TRACE32 GDB Front End debugger, you will need one of the following boards:
31
+
-[Portenta H7 (ABX00042)](https://store.arduino.cc/products/portenta-h7), [Portenta H7 Lite (ABX00045)](https://store.arduino.cc/products/portenta-h7-lite) or [Portenta H7 Lite Connected (ABX00046)](https://store.arduino.cc/products/portenta-h7-lite-connected)
-[Arduino Nano 33 BLE (ABX00030)](https://store.arduino.cc/nano-33-ble)
34
+
-[Arduino Nano 33 BLE Sense (ABX00031)](https://store.arduino.cc/nano-33-ble-sense)
30
35
- USB-C® cable (either USB-A to USB-C® or USB-C® to USB-C®) for Portenta H7
31
-
- Micro USB cable (either USB-A to Micro USB or USB-C® to Micro USB) for Nicla Vision
36
+
- Micro USB cable (either USB-A to Micro USB or USB-C® to Micro USB) for Nicla Vision, Nano 33 BLE and Nano 33 BLE Sense
32
37
33
38
### Required Software
34
39
-[Arduino IDE 1.8.10+](https://www.arduino.cc/en/software) or [Arduino IDE 2.0+](https://www.arduino.cc/en/software)
35
-
- Lauterbach TRACE32 software build 144320 (6 Feb 2022) or higher for Portenta H7, available [here](https://repo.lauterbach.com/download_demo.html)
40
+
- Lauterbach TRACE32 software build 144320 (6 Feb 2022) or higher for Portenta H7, Nano 33 BLE and Nano 33 BLE Sense, available [here](https://repo.lauterbach.com/download_demo.html)
36
41
- Lauterbach TRACE32 software build 161373 (31 Jul 2023) for Nicla Vision, available [here](https://repo.lauterbach.com/download_demo.html)
37
42
38
43
39
44
## Instructions
40
45
41
46
### TRACE32 GDB Front End Debugger
42
47
43
-
In this tutorial, you will load on the board (either Portenta H7 or Nicla Vision) an application that includes the MRI (Monitor for Remote Inspection). This is a GDB-compatible serial monitor which is included with the ThreadDebug sketch in the IDE Examples for these boards (M7 core) and with all examples in the TRACE32 /demo directory.
44
-
45
-
Throughout this document the **double-tilde (~~)** is used as a placeholder for the directory where you unzipped the TRACE32 software.
48
+
In this tutorial, you will learn how to upload an application that contains an MRI (Monitor for Remote Inspection) to your Arduino boards. This is a GDB-compatible serial monitor, which is included both in the ThreadDebug sketch in the IDE Examples and in all the examples available inside the TRACE32 /demo directory.
46
49
47
-
***This tutorial assumes that you have already installed the Arduino IDE and configured it to support the Portenta H7 or Nicla Vision board. Please refer to [Setting Up Portenta H7 For Arduino](https://docs.arduino.cc/tutorials/portenta-h7/setting-up-portenta) before you proceed.***
50
+
In the next steps, the **double-tilde (~~)** is used as a placeholder for the directory where you unzipped the TRACE32 software.
48
51
49
52
### 1. Downloading the TRACE32 Debugger
50
53
@@ -54,21 +57,15 @@ Extract the zip file to a directory of your choice. On Windows systems, please a
54
57
55
58
### 2. Registration and License Key
56
59
57
-
Without a valid license, the TRACE32 debugger only works for a few minutes in demo mode. Lauterbach can generate a **free license** based on the serial number of your board. The license will be valid for one year and can easily be renewed for free after this period using the same procedure. In order to obtain a license, please register here:
Enter the board's serial number (instructions below), your name and e-mail address and you will receive your license key.
62
-
63
-
60
+
Without a valid license, the TRACE32 debugger only works for a few minutes in demo mode. To avoid this limitation, Lauterbach may generate a **free license** based on the serial number of your board. The license will be valid for one year and can easily be renewed for free after this expiration using the same procedure.
64
61
65
-
There are two alternative ways to detect the board serial number:
62
+
In order to obtain a new license, you need to first get the serial number of your board. There are two alternative ways to do so:
66
63
67
-
- In the Arduino IDE select the "Tools->Get Board Info" menu command after selecting the port to which your board is connected to. This should show a 24 character (96bit) long serial number.
64
+
- In the Arduino IDE, select the "Tools->Get Board Info" menu command after choosing the port to which your board is connected. This should show a 16-character (64-bit) long serial number for your Nano BLE devices and a 24-character (96-bit) long serial number for your Portenta H7 or Nicla Vision.
68
65
69
66
70
67
71
-
***If you only see a 16character (64-bit) long serial number, then you need to update your Arduino IDE and the "Arduino mbed-enabled Boards" core from the boards manager in the IDE. Details on how to do this can be found on the Arduino website. Also, make sure your Portenta H7 or Nicla Vision has the [latest bootloader](https://docs.arduino.cc/tutorials/portenta-h7/updating-the-bootloader) installed.***
68
+
***For Portenta H7 and Nicla Vision only: if you only see a 16-character (64-bit) long serial number, then you need to update your Arduino IDE and your boards' core from the boards manager in the IDE. Details on how to do so can be found on the Arduino website. In addition, make sure your board has the [latest bootloader](https://docs.arduino.cc/tutorials/portenta-h7/updating-the-bootloader) installed.***
72
69
73
70
- Use the TRACE32 debugger. Check section "3. Start the TRACE32 Debugger" to learn how to get started. Click the menu item "Board S/N and License State". Your board's serial number will be printed in the AREA window and a dialog LICENSE.state will be opened.
74
71
@@ -78,7 +75,15 @@ There are two alternative ways to detect the board serial number:
78
75
79
76
Either copy & paste the displayed serial number manually to the Lauterbach registration page or click on the provided link in the dialog window.
80
77
81
-
Note: Newer TRACE32 software version should automatically detect and show the board serial number, at the first connection to the target.
78
+
***Note: Newer TRACE32 software version should automatically detect and show the board serial number, at the first connection to the target.***
79
+
80
+
At this point, you are ready to register at the Lauterbach registration page below:
Enter the board's serial number, your name and e-mail address, to get your new license.
85
+
86
+
82
87
83
88
When you receive the email containing your license key, follow the instructions provided at the end of the message:
84
89
- Copy the complete line of code provided in the email and paste it into the **license.t32** text file in your TRACE32 installation directory. Create the file license.t32 if it does not exist yet. On Windows, the TRACE32 system directory is by default "C:\T32".
@@ -97,23 +102,23 @@ To use the debugger, launch the appropriate executable for your host operating s
97
102
98
103
`~~/bin/linux64` for 64-bit Linux hosts.
99
104
100
-
For easy access, we suggest creating a link to the corresponding executable file on your desktop:
105
+
To simplify the access, we suggest creating a link to the corresponding executable file on your desktop:
101
106
102
107
- for Windows, this is t32marm.exe
103
108
104
109
- for Linux, this is t32marm-qt
105
110
106
-
### Setting Up the Serial Port
111
+
####Setting Up the Serial Port
107
112
108
113
On Windows systems, the TRACE32 start-up script will automatically search for the right COM port attached to the board.
109
114
110
-
On Linux systems, you will need to edit the system-settings.cmm file to manually add the serial port to connect to the board. This is a text file and can be opened with your favorite text editor. Edit the line that defines &GDBPORT to refer to the serial port, for example: `&GDBPORT="/dev/ttyACM0"`. This must be done **before** you start the TRACE32 software. After changing the port you can start the TRACE32 debugger or re-start it in case it was open while you made the changes.
115
+
On Linux systems, you will need to edit the `system-settings.cmm` file to manually add the serial port your board is connected to. This is a text file and can be opened with your favorite text editor. Edit the line that defines &GDBPORT to refer to the serial port, for example: `&GDBPORT="/dev/ttyACM0"`. This must be done **before** you start the TRACE32 software. After changing the port, you can start the TRACE32 debugger or re-start it in case it was open while you performed the changes.
111
116
112
-
***The manual port setting is also useful for Windows systems where you have multiple Portenta H7 or Nicla Vision boards connected and you want to select a specific board to be used by TRACE32 for debugging. The automatic port selection is disabled when a &GDBPORT definition is found in `system-settings.cmm`.***
117
+
***The manual port setting is also useful for Windows systems when you connect multiple boards simultaneously and you would like to select a specific board to be used by TRACE32 for debugging. The automatic port selection is disabled when a &GDBPORT definition is found in `system-settings.cmm`.***
113
118
114
119
### 4. Running Your First Demo
115
120
116
-
A number of pre-built demo programs are available. They can be accessed from the "Portenta H7 Projects" or "Nicla Vision Projects" menu. The following instructions relate to the T32ThreadDebug example. However, the other examples follow a similar pattern.
121
+
A number of pre-built demo programs are available in the tool. They can be accessed from the "Arduino Projects" menu. The following instructions relate to the T32ThreadDebug example. However, the other examples follow a similar pattern.
117
122
118
123
The demo directory already includes the symbolic file (.elf) for debugging and the binary file (.bin) for Flash programming.
0 commit comments