SLYU058D May   2021  – February 2024 TMAG5173-Q1 , TMAG5273

 

  1.   1
  2.   Abstract
  3.   Trademarks
  4. 1Overview
    1. 1.1 Kit Contents
    2. 1.2 Related Documentation From Texas Instruments
  5. 2Hardware
    1. 2.1 Features
  6. 3Operation
    1. 3.1 Quick Start Setup
  7. 4EVM Operation
    1. 4.1 Setup
      1. 4.1.1 Driver Installation
      2. 4.1.2 Firmware
        1. 4.1.2.1 Updating Firmware on SCB
      3. 4.1.3 GUI Setup and Usage
        1. 4.1.3.1 Initial Setup
        2. 4.1.3.2 GUI Operation
    2. 4.2 Rotate and Push Demo
    3. 4.3 Joystick Demo
    4. 4.4 Direct EVM Serial Communication
  8. 5Circuitry
    1. 5.1 TMAG5x73 EVM Components
    2. 5.2 SCB LEDs
  9. 6Schematics, PCB Layout, and Bill of Materials
    1. 6.1 Schematics
    2. 6.2 PCB Layout
    3. 6.3 Bill of Materials
  10. 7Revision History

Direct EVM Serial Communication

If desired, the SCB can communicate directly with the EVM without the use of the GUI through the USB serial (COM) port. Simply send the desired command string over the serial port and receive the results. This is useful for interfacing the EVM with custom setups/scripts/GUIs. Note that the TMAG5x73EVM must be connected to the SCB to receive any command responses from the SCB.

To read and write registers, follow the below format:

  • Read register command format: rreg ADR
    • Where ADR is the address in hex, and rreg is always lower case
    • Register addresses can be in upper or lower case, and do not need to be led by "0x". 0 padding register addresses is also optional. For example, to read register address 0xE, some valid commands include:
      • rreg e
      • rreg 0E
      • rreg 0x0E
        • When "0x" is used, the "x" must be lower case.
    • Figure 4-18 is an example response to this command:
    GUID-20220802-SS0I-JHPJ-S8QG-ZGSMCXZ0K5N2-low.png Figure 4-18 Example Register Read Response

    The number to the right of value represents the value read from the register. Note that this value is represented in decimal form and not hexadecimal.

  • Write register command format: wreg ADR VAL
    • Where ADR and VAL are in hex, and wreg is always lower case
    • Register addresses and values can be in upper or lower case, and do not need to be led by "0x". 0 padding register addresses and values is also optional. For example, to write register address 0x0 with the value 4, some valid commands include:
      • wreg 0 4
      • wreg 00 0x4
      • wreg 0x00 0x04
        • When "0x" is used, the "x" must be lower case.
    • Figure 4-19 is an example response to this command:
      GUID-20220802-SS0I-FFVN-FHQG-PZBKSVGX77QK-low.png Figure 4-19 Example Register Write Response

Other useful commands include the following:

  • Firmware revision command format: id
    • This command prints the EVM the SCB is configured for (TMAG5273EVM in this case) and the date associated with the version of the firmware loaded on the SCB.
    • Figure 4-20 is an example response to this command:
      GUID-20240206-SS0I-KWCL-CKB7-K9X9B0MPFZTD-low.png Figure 4-20 Example Firmware Revision Command Response
    • The date and time obtained from this command is the same date and time that appears in the GUI’s About screen (see Figure 4-21). Click the About option under the GUI's Help menu to view the About screen.
      GUID-20240206-SS0I-GZQC-L3X3-Q9HNHTH0DKSZ-low.png Figure 4-21 Firmware Revision Version in GUI About Screen
  • BSL command format: bsl
    • This command puts the device in BSL mode, which is necessary before reflashing the SCB firmware. An alternative to entering BSL mode is to enter BSL mode in hardware as described in step 1b of Section 4.1.2.1. Before BSL is entered, LED D1 is on. If BSL mode is successfully entered, then LED D1 is turned off so that only the Power LED (LED D5) is on. After entering BSL mode, the device does not accept any of the above commands.
    • Figure 4-22 shows an example response to this command:
      GUID-20220802-SS0I-NWXC-NP6G-LC0G2PCSCW3L-low.png Figure 4-22 BSL Command Response
  • Trigger conversion command format: rreg 0

    • If the device is in standby mode and new conversions are set to be triggered through I2C, then doing a register read at register 0 automatically starts a new set of conversions.