Texas Instruments TMAG5170D User manual

User’s Guide

TMAG5170DEVM

ABSTRACT

This user’s guide describes the characteristics, operation, and use of the TMAG5170D evaluation module

(EVM). This EVM is designed to evaluate the performance of the TMAG5170D. Throughout this document,

the terms evaluation board, evaluation module, and EVM are synonymous with the TMAG5170DEVM. This

document includes a schematic, reference printed circuit board (PCB) layouts, and a complete bill of materials

(BOM).

Table of Contents

1 Overview..................................................................................................................................................................................2

1.1 Kit Contents........................................................................................................................................................................2

1.2 Related Documentation From Texas Instruments.............................................................................................................. 2

2 Hardware................................................................................................................................................................................. 3

2.1 Features............................................................................................................................................................................. 3

3 Operation.................................................................................................................................................................................3

3.1 Quick Start Setup............................................................................................................................................................... 3

3.2 EVM Operation...................................................................................................................................................................4

4 Schematics, PCB Layout, and Bill of Materials................................................................................................................. 12

4.1 Schematics.......................................................................................................................................................................13

4.2 PCB Layout...................................................................................................................................................................... 15

4.3 Bill of Materials.................................................................................................................................................................17

Trademarks

Firefox™ is a trademark of Mozilla Foundation.

Google Chrome™ is a trademark of Google LLC.

Windows® is a registered trademark of Microsoft Corporation.

All trademarks are the property of their respective owners.

www.ti.com Table of Contents

SBAU420 – MARCH 2023

Submit Document Feedback

TMAG5170DEVM 1

1 Overview

The TMAG5170D is a dual-die, 3-axis linear Hall-effect sensor. This device integrates three independent Hall

sensors in X, Y, and Z axes on each die. A precision analog signal-chain along with integrated 12-bit ADC

digitizes the measured analog magnetic field values. The device can be configured further to select one of three

magnetic field ranges that suits the magnet strength and component placements during system calibration.

Table 1-1. TMAG5170D Device Summary

PRODUCT SENSITIVITY RANGE OPTIONS

TMAG5170DA2 ±75 mT, ±150 mT, ±300 mT

TMAG5170DA1 is not yet available and is not currently installed on the EVM.

1.1 Kit Contents

Table 1-2 lists the contents of the EVM kit. Contact the nearest Texas Instruments Product Information Center if

any component is missing.

Table 1-2. Kit Contents

ITEM QUANTITY

TMAG5170DEVM 1

3D-printed Rotate & Push module 1

Handheld magnet 1

1.2 Related Documentation From Texas Instruments

This user's guide is available from the TI website under literature number SBAU420. Any letter appended to the

literature number corresponds to the document revision that is current at the time of the writing of this document.

Newer revisions are available from www.ti.com or the Texas Instruments' Literature Response Center at (800)

477-8924 or the Product Information Center at (972) 644-5580. When ordering, identify the document by both

title and literature number. Table 1-3 lists documentation related to the EVM. Click the links in Table 1-3 for

further information. The device name links to the product web folder on www.ti.com. The literature number links

to the document PDF.

Table 1-3. Related Documentation

DOCUMENT TITLE

DOCUMENT LITERATURE

NUMBER

TMAG5170D-Q1 data sheet SLYS052

TI-SCB user's guide SLAU839

TMAG5170 EVM Quick Start Video —

Overview www.ti.com

2TMAG5170DEVM SBAU420 – MARCH 2023

Submit Document Feedback

2 Hardware

The EVM is an easy-to-use platform for evaluating the main features and performance of the TMAG5170D.

The EVM includes a graphical user interface (GUI) used to read and write registers, as well as view and save

measurement results. Also included is a 3D-printed Rotate & Push module to test the common functions of angle

measurement and push button with a single device.

The EVM is intended to provide basic functional evaluation of the devices. The layout is not intended to be a

model for the target circuit, nor is the model laid out for electromagnetic compatibility (EMC) testing. The EVM

has both sensitivity variations of the TMAG5170D installed, and may be broken into two separate boards as

needed. The EVM is intended to interface with the TI-SCB, but may be used as a stand-alone device if desired.

2.1 Features

• Snap-apart PCB for TMAG5170DA2 sensitivity evaluation

• GUI support to read and write device registers, as well as view and save measurement results

• 3D-printed Rotate & Push module

• Micro-USB connector for power supply

3 Operation

3.1 Quick Start Setup

To set up and use the EVM, follow these steps:

1. Download and install the PAMB Windows® USB driver: http://www.ti.com/lit/zip/sbac253

2. Attach the EVM to the Sensor Control Board (TI-SCB) (see Figure 3-1).

3. Connect the EVM to a PC using a USB cable.

a. Insert the micro USB cable into the TI-SCB Controller onboard USB receptacle J2.

b. Plug the other end of the USB cable into a PC.

4. Access the GUI from the following link in either a Firefox™ or Google Chrome™ browser:

a. TMAG5170DEVM GUI: https://dev.ti.com/gallery/search/TMAG5170D

5. Configure the device through the register map settings:

a. Click Write Config to Both

b. Set OPERATING_MODE within the DEVICE_CONFIG register to "Active Measure Mode" (0b101)

c. Set MAG_CH_EN within the SENSOR_CONFIG register to "XYZ" (0b0111)

6. Navigate to the Plots panel and click Collect Data

7. Apply a magnetic field to the sensor by doing one of the following:

a. Wave the included handheld magnet around the sensor.

b. Use the Rotate & Push module by attaching it to the EVM (see Figure 3-10). For more details on how to

use this module, see Section 3.2.2.

8. Observe the outputs in the GUI. See Section 3.2.1.3 for more information on GUI setup and operation.

www.ti.com Hardware

SBAU420 – MARCH 2023

Submit Document Feedback

TMAG5170DEVM 3

3.2 EVM Operation

To use the EVM with the included TI-SCB Controller, connect the EVM as shown in Figure 3-1.

Figure 3-1. EVM on TI-SCB Controller

It is optional to snap apart the TMAG5170DEVM to separate the TMAG5170DA1 and TMAG5170DA2 halves. To

snap apart the PCB, flex the PCB at the indicated boundary shown in Figure 3-2.

Operation www.ti.com

4TMAG5170DEVM SBAU420 – MARCH 2023

Submit Document Feedback

Figure 3-2. TMAG5170DEVM Snap Apart Edge

3.2.1 Setup

3.2.1.1 Driver Installation

Download and install the PAMB Windows USB driver: http://www.ti.com/lit/zip/sbac253. This is a one-time step

per computer. Unzip the folder and run the .exe file with administrator privileges.

3.2.1.2 Firmware

The GUI can load firmware onto the TI-SCB as described in Section 3.2.1.3.1. Firmware updates will be pushed

through the GUI (requires driver installation). Downloaded offline GUIs may check for GUI/Firmware updates

depending on the version.

3.2.1.2.1 Firmware Debug

If the firmware gets corrupted or must be manually reinstalled for any reason, follow these steps to reinstall the

firmware. This is demonstrated in the TMAG5170 EVM Quick Start Video:

1. Configure the MCU on the TI-SCB Controller to Device Firmware Update (DFU) Mode.

a. It is possible that the MCU has already entered DFU mode. If so, the GUI will notify you and try to

update the firmware to the latest version after the GUI is connected to the PC.

b. DFU mode can be entered manually through one of the following methods while the TI-SCB Controller is

powered on:

• Through software:

– Send the command 'bsl' on the TI-SCB's USB Serial (COM) port.

• Though the hardware:

– Ensure TI-SCB is connected to the PC through a USB

– Short the two test points near PK1 and PK2 of the header pins (see Figure 3-3) with a pair of

tweezers (or wire) while pressing the RESET button.

www.ti.com Operation

SBAU420 – MARCH 2023

Submit Document Feedback

TMAG5170DEVM 5

Figure 3-3. Test Points Used to Enter DFU Mode Manually

c. LEDs D1 and D2 will be off if successful

2. With the MCU in DFU mode, upload the firmware through the GUI:

• Open the File menu and select Program Device

• The firmware update will initiate

• After the GUI re-initializes, the TI-SCB should automatically connect

If the firmware programming was unsuccessful, TI recommends to repeat the above steps with a different

USB port connection on the machine.

Operation www.ti.com

6TMAG5170DEVM SBAU420 – MARCH 2023

Submit Document Feedback

3.2.1.3 GUI Setup and Usage

Access the GUI from the following link in either a Firefox or Google Chrome browser:

• TMAG5170DEVM GUI: https://dev.ti.com/gallery/search/TMAG5170D

3.2.1.3.1 Initial Setup

To set up the GUI the first time, follow these steps:

1. Make sure that the above mentioned driver was installed successfully to ensure that everything works

properly and that the GUI can update the EVM firmware, if necessary.

2. With the EVM/TI-SCB Controller unit plugged to the PC, go to the GUI link:

3. To launch the GUI from the web browser, click the GUI Composer application to open the GUI Composer

window (see Figure 3-4).

Figure 3-4. GUI Composer Application Window

a. For first-time GUI Composer setup, follow the prompts to download the TI Cloud Agent and browser

extension (see Figure 3-5). These prompts will appear after you close the README.md dialog.

Figure 3-5. TI Cloud Agent

4. Optionally, click the icon in the GUI Composer window to download the GUI for offline use (see Figure

3-4).

www.ti.com Operation

SBAU420 – MARCH 2023

Submit Document Feedback

TMAG5170DEVM 7

3.2.1.3.2 GUI Operation

To operate the GUI, follow these steps:

1. Connect to and launch the GUI as described in Section 3.2.1.3.1.

2. With the EVM connected to the GUI, close the README.md file page. The text near the bottom-left hand

corner of the GUI should read Hardware Connected (see Figure 3-6).

Figure 3-6. Hardware Connected

a. If Hardware Connected does not show in the bottom-left hand corner of the GUI, check different

hardware COM ports under Options → Serial Port (see Figure 3-7).

Figure 3-7. Change Serial Port

b. If the hardware still does not connect, make sure you are using the correct GUI/EVM combination.

3. Click the Registers icon shown in Figure 3-8 (also available on the left-side menu) to view the register

map, change device settings, and enable automatic register read. Each die within the TMAG5170D may

be configured independently using the device select, or both sensors can be configured under the same

questions about registers, check the data sheet.

Figure 3-8. Registers Page Icon

4. Click the Plots icon to view and save graphical data from the results registers (see Figure 3-9). This is also

available on the left-side menu.

Figure 3-9. Plots Page Icon

Operation www.ti.com

8TMAG5170DEVM SBAU420 – MARCH 2023

Submit Document Feedback

3.2.2 Rotate and Push Demonstration

To use the rotate and push demonstration, follow these steps:

1. Attach the Rotate & Push module to the EVM as shown in Figure 3-10.

Figure 3-10. Rotate & Push Module on EVM

2. In the GUI register page:

a. At this time the Rotate & Push GUI will only show results for the device selected on the register map

page.

b. Make sure that the DEVICE_CONFIG → OPERATING_MODE says (TRIGGER_MODE Active).

c. Make sure that SYSTEM_CONFIG → TRIGGER_MODE is set to the default value.

d. Under the SENSOR_CONFIG register:

i. Make sure both the X and Y channels are enabled (MAG_CH_EN).

ii. Set X_RANGE and Y_RANGE to ±100 mT for A1 versions, and ±133 mT for A2 versions.

iii. Optional: Set ANGLE_EN to X-Y angle calculation.

e. At the top of the register map, set Auto Read to As fast as possible.

3. Go to the Rotate & Push tab inside the Plots page (see Figure 3-11).

Figure 3-11. Rotate & Push GUI Page

4. If the push button LEDs are not triggering at every angle or trigger when they are not supposed to, calibrate

the module by doing the following:

a. With the settings set to run the demo, slowly rotate the module 360° and use the Plots page to record

the absolute value of the minimum and maximum magnetic field measurements (in mT) for both the X

and Y channels.

b. Adjust the Push threshold calibration value found in the Rotate & Push tab to be about 3 mT to 5 mT

larger than the maximum value recorded above.

www.ti.com Operation

SBAU420 – MARCH 2023

Submit Document Feedback

TMAG5170DEVM 9

3.2.2.1 Optimizing Device Angle Matching

Each 3D Hall-effect sensor is fabricated on a die and the package assembly has these dies stacked vertically for

a minimal offset in the XY plane. Device tolerances for sensitivity gain and offset should be canceled out:

1. Capture the data for one full rotation on both devices with averaging set to 32x for minimal input referred

noise. Set the device to calculate angle using the desired axes.

2. Correct the gain for one axis on each device:

a. Find the maximum and minimum data points for each axis used in the angle measurement

b. If the maximum of either channel is more than 2x the maximum of the other, it will be necessary to

attenuate the channel with the larger input. Otherwise, TI recommends to amplify the output of the

smaller input

c. GAIN_VALUE in the MAG_GAIN_CONFIG register (0h11) is used to select the sensitivity gain

adjustment for the desired axis.

i. Gain is calculated from an 11-bit value / 1024. (For a value ranging from 0-2)

ii. Select the axis to amplify/attenuate using GAIN_SELECTION

iii. Set gain value based on the ratio of:

1. (Max Ch A - Min Ch A)/(Max Ch B - Min Ch B).

2. Where Channel A and B are selected based on step 2b.

3. Repeat step 1 to verify the amplitude matching and to start the calculation of the offset correction

a. For each axis, calculate the offset using:

i. Output Offset = (Maximum Value + Minimum Value) /2

b. Set OFFSET_SELECTION in MAG_OFFSET_CONFIG (0h12) to 0b11 to enable offset correction on

both axes

c. Set OFFSET_VALUE1 and OFFSET_VALUE2 using a 7-bit 2's compliment value to correct output offset

based on maximum and minimum peak data in step 3a.

After correction sensitivity and offset errors of the device, the sensors may still experience some measurement

error due to mechanical rotations of the package relative to the rotating magnet. The most straightforward

alignment method is achieved by placing the sensor on-axis to the rotating magnet.

Figure 3-12. Sensor Alignments for Angle Measurements

In an ideal on-axis placement, the X and Y axis data will observe a decrease in magnitude only, with no impact

to observed angle linearity. As the package is mechanically offset, peak input data for X and Y axes will vary, and

the severity of amplitude correction needed will become more significant. Additionally, package rotations may

cause angle offset relative to the position of the magnet or phase error between the observed X and Y axis input.

This happens as each sensing element detects the field which is orthogonal to the sensing element and the

sensor is no longer orthogonal to the rotating magnet. As a result, each sensing element detects a portion of the

vector component from either of the other two axes. This error may vary based on the installation of either the

magnet or sensor within the system. Often, end-of-line calibration for each sensor is required after full system

assembly to achieve the best results. For more information, refer to the Texas Instruments Achieving Highest

System Angle Sensing Accuracy application note.

Operation www.ti.com

10 TMAG5170DEVM SBAU420 – MARCH 2023

Submit Document Feedback

This manual suits for next models

Table of contents

Other Texas Instruments Computer Hardware manuals

Texas Instruments

Texas Instruments DAC8803/14 EVM User manual

Texas Instruments

Texas Instruments TMS320 Series User manual

Texas Instruments

Texas Instruments DRV8811EVM User manual

Texas Instruments

Texas Instruments TLV320AIC3101EVM User manual

Texas Instruments

Texas Instruments TAS5707EVM User manual

Texas Instruments

Texas Instruments TRIS TMS37122 User manual

Texas Instruments

Texas Instruments Tiva C Series User manual

Texas Instruments

Texas Instruments TPS65981EVM User manual

Texas Instruments

Texas Instruments TPS62065 User manual

Texas Instruments

Texas Instruments PGA2500EVMV2 User manual

Texas Instruments

Texas Instruments F280025 User manual

Texas Instruments

Texas Instruments AM57 Series User manual

Texas Instruments

Texas Instruments bq78350-R1 User manual

Texas Instruments

Texas Instruments CC2545 User manual

Texas Instruments

Texas Instruments TMS320F2807 Series User manual

Texas Instruments

Texas Instruments INA149 User manual

Texas Instruments

Texas Instruments MSP430x11x1 User manual

Texas Instruments

Texas Instruments MSP-FET430 User manual

Texas Instruments

Texas Instruments AM335 Series Product manual

Texas Instruments

Texas Instruments TMS320*2801 Series User manual

Texas Instruments

Texas Instruments controlCARD TMDSCNCD2800137 User manual

Texas Instruments

Texas Instruments TPA2013D1 User manual

Texas Instruments

Texas Instruments AM1808 User manual

Texas Instruments

Texas Instruments TMS34010 User manual

Popular Computer Hardware manuals by other brands

EMC2

EMC2 VNX Series Hardware Information Guide

Panasonic

Panasonic DV0PM20105 Operation manual

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 user manual

Gigabyte

Gigabyte B660M DS3H AX DDR4 user manual

Raidon

Raidon iT2300 Quick installation guide

National Instruments

National Instruments PXI-8186 user manual

Hauppauge

Hauppauge WinTV-HVR-2250 Quick installation guide

Kontron

Kontron CP6002 user guide

Manhattan

Manhattan 702843 user manual

Aphex

Aphex 230 instruction manual

AMD

AMD Phenom II Product data sheet

Intel

Intel NUC 12 Pro user guide

dbx

dbx Zone Pro 1260 user manual

Galaxy

Galaxy GHDX2-2430S-24F4D Installation and hardware reference manual

Intel

Intel AXXRMFBU4 Quick installation user's guide

Kontron

Kontron DIMM-PC/MD product manual

ST X-NUCLEO-SAFEA1B How to use

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 installation manual