Abov A31T21 RLN Series User manual

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

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

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

List of Tables A31T21xRLN Shield Board quick Guide
4
List of Tables
Table 1. Shield Board Description ........................................................................................................13

A31T21xRLN Shield Board Quick Guide 1. Introduction
5
1 Introduction
A31T21xRLN 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 A31T21xRLN Shield Board with examples, step by step.

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

A31T21xRLN Shield Board Quick Guide 2. User Requirements
7
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)

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

A31T21xRLN Shield Board Quick Guide 2. User Requirements
9
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

2. User Requirements A31T21xRLN Shield Board Quick Guide
10
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