Abov A31T216RLN User manual

Global Top Smart MCU Innovator, ABOV Semiconductor
www.abovsemi.com
A31T216RLN
Shield Board
Shield Board Quick Guide
Version 1.00

Contents A31T216RLN Shield Board Quick Guide
2
Contents
1Introduction ....................................................................................................................................4
2User Requirements ........................................................................................................................5
2.1 Hardware.............................................................................................................................5
2.2 Software ..............................................................................................................................6
2.3 Reference Documents ........................................................................................................7
2.4 System Requirements .........................................................................................................8
2.5 ABOV Website ....................................................................................................................9
3Build and Run Project (Shield Board) ..........................................................................................10
3.1 Prepare Starter Kit and Shield Board................................................................................11
3.1.1 Hardware Components of Starter Kit ...................................................................11
3.1.2 Hardware Components of Shield Board ...............................................................12
3.2 Starter Kit and Shield Board Settings ...............................................................................13
3.2.1 Jumper Settings for Starter Kit Control.................................................................13
3.2.2 Starter Kit Connection for Shield Board Use ........................................................14
3.3 Starter Kit Connection to PC .............................................................................................15
3.3.1 USB Connection with USB 2.0 Cable...................................................................15
3.3.2 Hardware Recognition on PC (Device Drivers) ....................................................16
3.4 Run Starter Kit Shield Board .............................................................................................17
3.4.1 Compilation with Keil uVision 5 ............................................................................17
3.4.2 A-Link Debugger Configuration and Download ....................................................19
3.5 Debugging .........................................................................................................................21
3.6 Library Description ............................................................................................................23
3.6.1 user.h ....................................................................................................................23
3.6.2 main.c ...................................................................................................................28
3.6.3 Library Usage Example ........................................................................................39
Revision History ....................................................................................................................................41

A31T216RLN Shield Board Quick Guide List of Figures/ List of Tables
3
List of Figures
Figure 1. A31T216RLN Starter Kit Board (Hardware) ............................................................................5
Figure 2. A31T216RLN Shield Board (Hardware) ..................................................................................5
Figure 3. Compiler (Software) .................................................................................................................6
Figure 4. Reference Document on the ABOV Website ...........................................................................7
Figure 5. Window PC and Mini-B Cable .................................................................................................8
Figure 6. Software and Documents at ABOV Semiconductor Website ..................................................9
Figure 7. Starter Kit Board ....................................................................................................................11
Figure 8. Components of A31T216RLN Shield Board ..........................................................................12
Figure 9. Starter Kit Jumper and Switch ...............................................................................................13
Figure 10. Connection of Starter Kit Board and Shield Board ..............................................................14
Figure 11. Starter Kit and USB Connection ..........................................................................................15
Figure 12. Serial Bus Controller Lists at Device Manager ....................................................................16
Figure 13. Project Open in Keil uVision 5 .............................................................................................17
Figure 14. Project Build in Keil uVision 5 ..............................................................................................18
Figure 15. Debugger Settings for Example Project Options .................................................................19
Figure 16. Firmware Download and Verification Result ........................................................................20
Figure 17. Debugging with ABOV A-Link and CMSIS-DAP ..................................................................21
Figure 18. T-type and M-type LEDs for Touch and Display ..................................................................22
Figure 19. Touch/LED Time-division Mode ...........................................................................................23
Figure 20. Touch/LED Independent Mode ............................................................................................24
Figure 21. Touch CH Activation.............................................................................................................25
Figure 22. LED COM/SEG Port Activation............................................................................................26
Figure 23. Touch CH Activation.............................................................................................................27
Figure 24. Sensitivity for Each Channel in Normal Mode .....................................................................28
Figure 25. Sensitivity for Each Channel in Adjust Mode .......................................................................29
Figure 26. CH_SHIELD_DIS, MESH_SHIELD_DIS .............................................................................30
Figure 27. CH_SHIELD_EN, MESH_SHIELD_EN ...............................................................................30
Figure 28. Touch Data Changes according to SUM_COUNT...............................................................31
Figure 29. Base-line Tracking ...............................................................................................................33
Figure 30. Press Threshold and Release Threshold ............................................................................34
Figure 31. Reverse Situation Parameters.............................................................................................35
Figure 32. Debounce Count ..................................................................................................................36
Figure 33. IIR-filter ................................................................................................................................36
Figure 34. Touch/LED Time-division Operation ....................................................................................37
Figure 35. Touch Key Value Assignment...............................................................................................38
Figure 36. Source Code: user.h ............................................................................................................39
Figure 37. Source Code : main() in main.c ...........................................................................................40
List of Tables
Table 1. Shield Board Description .........................................................................................................12

1. Introduction A31T216RLN Shield Board Quick Guide
4
1Introduction
A31T216RLN Shield Board Quick Guide introduces software environment and development
recommendations for the ABOV 32-bit Touch/LED-Driver MCU Starter Kit. This document also offers
an easy method to develop the Home Appliance Touch.
The Starter Kit Board in this document contains a CMSIS-DAP debugger ‘A-Link’, which allows the
MCU programming and debugging without additional devices.
By following the steps guided in this document, users can build a project and download firmware using
the Keil uVision 5, and learn how to debug the Starter Kit with the A-Link debugger.
In addition, we discuss how to operate the A31T216RLN Shield Board with examples, step by step.

A31T216RLN Shield Board Quick Guide 2. User Requirements
5
2User Requirements
2.1 Hardware
Users must prepare the A31T216RLN Starter Kit Board and A31T216RLN Shield Board shown in Figure
1 and Figure 2.
Figure 1. A31T216RLN Starter Kit Board (Hardware)
Figure 2. A31T216RLN Shield Board (Hardware)

2. User Requirements A31T216RLN Shield Board Quick Guide
6
2.2 Software
The software users must prepare is as follows:
Keil complier (uVision 5)
Example Code & Touch Library
Figure 3 shows the uVision Editor that includes all standard features of a modern source code editor
and is available during debugging.
Figure 3. Compiler (Software)

A31T216RLN Shield Board Quick Guide 2. User Requirements
7
2.3 Reference Documents
From the ABOV website, users can find more information about the A31T216RLN Starter Kit and Shield
Board as follows:
A31T216 Starter Kit Quick Guide
A31T216 Starter Kit HW Manual
A31T216 User’s Manual
A31T216 T-TYPE LED Structure
Example code
For detailed information, refer to the categories below.
Figure 4. Reference Document on the ABOV Website

2. User Requirements A31T216RLN Shield Board Quick Guide
8
2.4 System Requirements
Windows PC (7, 8, and 10)
Micro-B 5-pin USB Cable (for Starter Kit)
Figure 5. Window PC and Mini-B Cable

A31T216RLN Shield Board Quick Guide 2. User Requirements
9
2.5 ABOV Website
Users can find more software and documents at the ABOV website, www.abovsemi.com.
Figure 6. Software and Documents at ABOV Semiconductor Website

3. Build and Run Project (Shield Board) A31T216RLN Shield Board Quick Guide
10
3Build and Run Project (Shield Board)
Running application code makes it easier to start the Shield Board. Following the steps below:
Step 1. Prepare Starter Kit and Shield Board.
Step 2. Starter Kit and Shield Board settings
Step 3. Starter Kit connection to PC
Step 4. Run Starter Kit Shield Board.
Step 5. Debugging
Step 6. Library description

A31T216RLN Shield Board Quick Guide 3. Build and Run Project (Shield Board)
11
3.1 Prepare Starter Kit and Shield Board
3.1.1 Hardware Components of Starter Kit
1. The Starter Kit consists of a device board and an A-Link (CMSIS-DAP) debugger board as
shown in Figure 7. It can be used separately as needed.
2. Device board configuration:
A. ABOV 32-bit MCU, X-TAL (optional)
B. Pin headers connected to MCU
C. LEDs and switches to check input/output
3. A-Link (DMSIS-DAP/UART) debugger board configuration:
A. Programmable and debuggable A-Link with connections to PC via USB
B. UART Tx/Rx channel support
Figure 7. Starter Kit Board

3. Build and Run Project (Shield Board) A31T216RLN Shield Board Quick Guide
12
3.1.2 Hardware Components of Shield Board
Table 1. Shield Board Description
Function
Description
Remark
Touch (CS0 to CS13)
Touch only
-
Touch (CS14 to CS20, and
CS23)
Touch & SEG
-
Touch (CS20 to CS22)
COM only
Touch Not Available
LED T-Type Matrix
8 x 7 LEDs
ISEG0_ICOM0 to ISEG5_ICOM5,
ISEG7_ICOM7 to ISEG8_ICOM8
LED M-Type Matrix
8 x 8 LEDs
SEG: ISEG6, ISEG9 to ISEG15
COM: ICOM0 to ICOM5, ICOM7 to ICOM8
Figure 8. Components of A31T216RLN Shield Board

A31T216RLN Shield Board Quick Guide 3. Build and Run Project (Shield Board)
13
3.2 Starter Kit and Shield Board Settings
3.2.1 Jumper Settings for Starter Kit Control
The circle numbers in Figure 9 represent the order in which the jumpers are set to control the Starter
Kit:
1. The Starter Kit uses the USB power. Select 3.3V or 5.0V. (See specifications for the maximum
operating voltage.)
2. Boot mode: ‘Open’ allows User program operating mode (default) and ‘Short’ allows Boot
mode (debugger is always enabled).
3. USB to UART Connector
A. Set jumpers to use UART through the USB connector on the A-Link board.
B. Use to connect UART Rx and Tx.
Figure 9. Starter Kit Jumper and Switch

3. Build and Run Project (Shield Board) A31T216RLN Shield Board Quick Guide
14
3.2.2 Starter Kit Connection for Shield Board Use
Connect the header sockets on the Shield board and the header pin on the Starter Kit Board, as shown
in Figure 10.
Figure 10. Connection of Starter Kit Board and Shield Board

A31T216RLN Shield Board Quick Guide 3. Build and Run Project (Shield Board)
15
3.3 Starter Kit Connection to PC
3.3.1 USB Connection with USB 2.0 Cable
Connect a USB 2.0 (Micro-B type) cable to the Starter Kit as shown in Figure 11. When the PC is
connected correctly to the other end of the USB 2.0 cable, the following actions are performed:
1. The power LED on the device board is turned on.
2. The status LED on the A-Link board (debugger) is turned on.
Figure 11. Starter Kit and USB Connection

3. Build and Run Project (Shield Board) A31T216RLN Shield Board Quick Guide
16
3.3.2 Hardware Recognition on PC (Device Drivers)
The A-Link board (debugger) uses a USB interface.
When the A-Link board (debugger) is connected to a PC, it is displayed as ‘USB Composite Device’in
the Serial Bus Controller List, as shown in Figure 12.
The A-Link does not require the driver installation on Microsoft Windows.
Figure 12. Serial Bus Controller Lists at Device Manager

A31T216RLN Shield Board Quick Guide 3. Build and Run Project (Shield Board)
17
3.4 Run Starter Kit Shield Board
3.4.1 Compilation with Keil uVision 5
Using Keil uVision 5, users can compile the provided project files and run the Starter Kit Shield Board.
To do so, follow the procedure below:
1. Install ‘Keil uVision 5 for Cortex-M’.
2. Open the provided project file (a31t216.uvmpw).
Figure 13. Project Open in Keil uVision 5

3. Build and Run Project (Shield Board) A31T216RLN Shield Board Quick Guide
18
3. Build the project as shown in Figure 14.
Figure 14. Project Build in Keil uVision 5

A31T216RLN Shield Board Quick Guide 3. Build and Run Project (Shield Board)
19
3.4.2 A-Link Debugger Configuration and Download
When the compilation is completed without errors, users can begin programming the Starter Kit.
Downloading is enabled since the Starter Kit is connected to the USB port on the PC.
Debugger Configuration
Before downloading firmware to the target, the A-Link debugger must be configured in options panel of
the project as shown in Figure 15.
The circle numbers in Figure 15 represent the order in which the A-Link debugger is set:
Figure 15. Debugger Settings for Example Project Options
1. On the Debug tab, check if the CMSIS-DAP Debugger is selected. The A-Link debugger uses
the CMSIS-DAP Debugger Interface.
2. Click the ‘Settings’ button and check if the A-Link CMSIS-DAP is selected on the Debug tab
of the newly opened window.
3. When the A-Link debugger is well connected to the target board, the target IDCODE and
Device Name are displayed in the SWDIO field of the SW Device menu.
4. On the Flash Download tab, check if the flash loader of the device is displayed correctly.

3. Build and Run Project (Shield Board) A31T216RLN Shield Board Quick Guide
20
Firmware Download
To download firmware to the target, click the download icon (①in Figure 16) and check if the download
begins. Users can view the download results in the Build Output pane (②in Figure 16).
Figure 16. Firmware Download and Verification Result