Mikroe Codegrip User Manual
C O D E G R I P U S E R M A N U A L
USER MANUAL
P A G E 1
Thank you for choosing Mikroe!
We present you the ultimate debugger and programmer over USB/WiFi solution for embedded development.
Elegant on the surface, yet extremely powerful on the inside, we have designed it to inspire outstanding achievements.
And now, it’s all yours.
Enjoy premium.
Table of contents
Introduction 5
1. Installing CODEGRIP Suite 6
2. CODEGRIP 8
2.1 USB connectivity 9
2.2 WiFi connectivity 9
2.3 Target connector 10
2.4 CODEGRIP adapters 11
2.5 LED indicators 13
3. CODEGRIP Link structure 14
2.1 Link types 14
2.2 Link states 14
4. CODEGRIP Suite overview 16
4.1 Menu section 17
4.2 Menu item section 17
4.3 Shortcuts bar 17
4.4 Status bar section 18
5. CODEGRIP Suite explained 19
5.1 Target MCU 19
5.2 CODEGRIP 28
5.3 POWER 38
5.4 OPTIONS 38
5.5 HELP 40
Troubleshooting 42
CODEGRIP is a unified solution, designed to perform
based microcontrollers becomes seamless and effortless,
programming and debugging tasks on a range of different
microcontroller devices (MCUs) based on the ARM
®
Cortex®-M
architecture. By bridging differences between various MCUs,
it allows a huge number of MCUs from several different
MCU vendors to be programmed and debugged. Although
the number of supported MCUs is absolutely huge, more
MCUs might be added in the future, along with some new
functionalities.
Thanks to some advanced and unique features such as
wireless connectivity and USB-C connector, the task of
programming of a huge number of various ARM
®
Cortex®-M
providing users with both the mobility and the complete
control over the microcontroller programming and debugging
process. The USB-C connector offers improved performance
and reliability, compared to traditionally used USB Type A/B
connectors. Wireless connectivity redefines the way the
development board can be used.
The graphical user interface (GUI) of the CODEGRIP Suite is
clear, intuitive, and easy to learn, offering a very pleasant user
experience. The embedded HELP system provides detailed
guidelines for every aspect of the CODEGRIP Suite.
C O D E
1. Installing CODEGRIP Suite
The installation process is easy and straightforward.
Download CODEGRIP Suite software application from the link www.mikroe.com/setup/codegrip and follow the steps
below.
INSTALLATION
P A G E 6
1.
Start the
installation
3.
Select the
components
to install
2.
Select the
destination
folder
4.
License
agreement
G R I P U S E R M A N U A L
5.
6.
Select the
start menu
shortcuts
7.
Installation
progress
Start the
installation
process
8.
Finish the
installation
process
INSTALLATION
P A G E 7
C O D E G R I P U S E R M A N U A L
C O D E
C O D E
2. CODEGRIP
The CODEGRIP device offers a set of unique and innovative
functionalities, some of which have never been used before
on a similar device. These functionalities include wireless
programming and debugging, power monitoring, advanced
debugging options with the SWO support, and more.
The CODEGRIP device comes in two different types: as a
CODEGRIP
P A G E 8
P A G E 8
stand-alone device and an integrated on-board module. This
manual will be focused on the stand-alone CODEGRIP device.
In order to better understand how this device is operated, this
chapter will give you a brief overview of its basic hardware
functions.
G R I P U S E R M A N U A L
2.1 USB connectivity
The USB-C connector is the latest upgrade of the conventional USB A/B
type connectors, typically found on most personal computers today. The
USB-C connector has many advantages over the USB type A/B connector
such as the completely symmetrical design which reduces the possibility
of the connector misalignment and the damage it might cause, higher
current capability, and more. However, if there is not appropriate USB-C
connector on the host PC, a USB-C cable adapter can be used.
2.2 WiFi connectivity
The CODEGRIP device can be linked with the CODEGRIP Suite over the WiFi
network, allowing it to program and debug the target MCU wirelessly. This
is a revolutionary new feature, which allows some unique usage scenarios,
currently not available on any other programming/debugging solution in
the world. The WiFi connectivity option offers a complete autonomy of
the development system. Running a toxic gas sensor application while
debugging the firmware in real time, programming it with a new firmware
during exposure, having sensor responses collected and logged remotely
from several different base points, debugging drone firmware while it is in
mid-air… This is just a simple example of what CODEGRIP can offer.
The WiFi module on the CODEGRIP device has an integrated chip antenna,
which allows good WiFi reception. However, if a stronger WiFi signal is
required, the CODEGRIP device offers an SMA connector for an external
WiFi antenna.
The WiFi link can be protected by a password, or by the MAC address
filtering option.
can be bought from the official Mikroe online store www.mikroe.com
CODEGRIP
P A G E 9
P A G E 9
N O T ETo use the WiFi functionality, a separate registration code is required. It
C O D E G R I P U S E R M A N U A L
2.3 Target connector
The CODEGRIP device can be used with any hardware, equipped with the
standard JTAG/SWD programming header. Packed in a sturdy casing with
rubber feet, it can be used independently, bringing all the powerful features
to a third-party hardware.
SWDIO/TMSVCC-TGT
GND
GND
PROG MUX/GND
GND
GND
GND
GND
The CODEGRIP device is equipped with the target MCU connector, which
contains JTAG/SWD and power supply pins. This connector is used to
interface the CODEGRIP device with the target MCU, allowing it to perform
programming and debugging operations, to provide the power supply for
the target MCU, and to be used as the power input when the CODEGRIP
device is powered from the connected development board.
N O T E When the connected host board provides power to the CODEGRIP
device, CODEGRIP input voltage must be in range 2.5V to 10V.
SWDCLK/TCK
SWO/TDO
TDI
TGT-RESET
TRACECLK
TRACEDATA-0
TRACEDATA-1
TRACEDATA-2
TRACEDATA-3GND
On the bottom of the CODEGRIP device there is the sticker which contains
additional information.
∫ Supported MCU family/architecture
∫ Unique serial number
∫ Unique WiFi MAC address
CODEGRIP firmware
The CODEGRIP device is based on the powerful 32-bit MCU, which utilizes a
complex firmware to provide all the required functionalities. The firmware
will be continuously improved so that additional optimizations, functions,
and support for new MCU families might be added in the future. Therefore,
the complete CODEGRIP programming environment is designed so that
the firmware upgrade process is effortless and easy.
2.4 CODEGRIP adapters
JTAG/SWD programming/debugging headers may vary across different
hardware applications. To ensure compatibility with various header
configurations there is a set of different adapters available as an additional
purchase option.
CODEGRIP
2.5 LED indicators
There are five LED indicators on the CODEGRIP device, used to indicate
different states of the device, providing visual feedback to the user.
Indicates the
USB-LINK
Indicates that the
connection has been
established via USB
NET-LINK
Indicates that the
connection has been
established via WiFi
ACTIVE
Blinking LED indicates that the
CODEGRIP device is
in the bootloader mode
Steady ON LED state indicates
the normal operation of the
CODEGRIP device
Indicates the data
transfer between the
target MCU and the
CODEGRIP device
POWER
presence of
the power
supply
DATA
C O D E
3. CODEGRIP link structure
CODEGRIP Suite can detect multiple CODEGRIP devices. In addition, a
single CODEGRIP device can be operated by multiple software applications.
To avoid any ambiguity, CODEGRIP utilizes the concept of links.
CODEGRIP Suite uses a link to the specific CODEGRIP device, in order to send
commands and receive responses. The link can be created, opened, and
destroyed by the user, employing some specific functions of CODEGRIP Suite.
Based on the link and its state, CODEGRIP Suite can always unambiguously
know which CODEGRIP device to use, and if the specific CODEGRIP device
is currently available. A single CODEGRIP device can have links to multiple
CODEGRIP Suite applications, while CODEGRIP Suite can have a link to only
a single CODEGRIP device at time. Still, it can easily switch the link to any
LINK STRUCTURE
CODEGRIP device detected during the scanning process.
3.1 Link types
Depending on what type of interface is used to establish the link, there are
P A G E 14
N O T E USB link is the primary link and it has the highest priority. Some
two types of links available: the USB link, and the WiFi link.
operations, such as the firmware update, are exclusively used with
the USB link. When the USB link is active, all the WiFi links to that
specific CODEGRIP device will be forced to a closed state.
3.2 Link states
Each link has several different states recognized by the CODEGRIP Suite.
The link is Closed: the CODEGRIP device is not available over the
communication interface (USB or WiFi). Either it is disconnected,
nonresponsive, turned OFF, or otherwise unavailable.
The link is Available: the CODEGRIP device is available over the
communication interface (USB or WiFi). Communication packets can
reach the CODEGRIP device, and it is able to send back the response.
The link is Blocked: this state indicates that the link was blocked because
the specific CODEGRIP device is busy servicing another link.
When CODEGRIP Suite actively uses the link for issuing commands to a
linked CODEGRIP device, other applications linked to the same CODEGRIP
device will have their links in a blocked state. As soon as the task is
complete, those links will revert to the available state.
The indicator showing the current state is visible at the status bar at
the bottom of the Suite. More detailed description about the Shortcut bar
commands find in the Chapter 4.
G R I P U S E R M A N U A L
Loading...