Abov A31G213CLN User manual

Global Top Smart MCU Innovator
www.abovsemi.com
A31G213CLN
Shield Board
Quick Start Guide
Version 1.00

Contents A31G213CLN Shield Board Quick Start Guide
2
Contents
1Introduction ....................................................................................................................................4
2User requirements..........................................................................................................................5
2.1 Hardware.............................................................................................................................5
2.1.1 Starter Kit................................................................................................................5
2.1.2 Shield Board ...........................................................................................................5
2.2 Software ..............................................................................................................................6
2.3 Reference documents .........................................................................................................6
2.4 System requirements ..........................................................................................................7
2.5 ABOV website .....................................................................................................................7
3Building and running project (Shield Board) ..................................................................................8
3.1 Prepare the Starter Kit and Shield Board............................................................................9
3.1.1 Hardware components of the Starter Kit ................................................................9
3.1.2 Hardware components of the Shield Board..........................................................10
3.2 Set up the Starter Kit and Shield Board ............................................................................11
3.2.1 Set jumpers to control the Starter Kit ...................................................................11
3.2.2 Connect to Starter Kit to use Shield Board...........................................................12
3.3 Connect the Starter Kit to your PC....................................................................................13
3.3.1 PC connection via USB on the Starter Kit ............................................................13
3.4 STKS Practice ...................................................................................................................15
3.4.1 Compile with Keil uVision5 for C51 ......................................................................15
3.4.2 Download and Debugging with A-Link..................................................................16
3.5 Library description .............................................................................................................18
3.5.1 user.h ....................................................................................................................18
3.5.2 main.c ...................................................................................................................19
3.5.3 Library usage example .........................................................................................26
Revision history .....................................................................................................................................28

A31G213CLN Shield Board Quick Start Guide List of figures/ List of tables
3
List of figures
Figure 1. A31G213CLN Starter Kit Board (Hardware) ............................................................................5
Figure 2. A31G213CLN Shield Board (Hardware) ..................................................................................5
Figure 3. Compiler (Software) .................................................................................................................6
Figure 4. Reference Documents .............................................................................................................6
Figure 5. Window PC and Mini-B Cable .................................................................................................7
Figure 6. ABOV Semiconductor Website ................................................................................................7
Figure 7. Starter Kit B/D ..........................................................................................................................9
Figure 8. A31G213CLN Shield Board Description ................................................................................10
Figure 9. Starter Kit Jumper and Switch ...............................................................................................11
Figure 10. Connect to Starter Kit to use Shield Board ..........................................................................12
Figure 11. Starter Kit and USB Connection ..........................................................................................13
Figure 12. USB Composite Device at Device Manager ........................................................................14
Figure 13. Execute Keil uVision5 for C51 .............................................................................................15
Figure 14. Build the Project...................................................................................................................15
Figure 15. Download and Debugging with A-Link.................................................................................16
Figure 16. Run (Start Code Execution).................................................................................................16
Figure 17. Touch and Display................................................................................................................17
Figure 18. Touch CH Activation.............................................................................................................18
Figure 19. Sensitivity for Each Channel in Normal Mode .....................................................................19
Figure 20. Sensitivity for Each Channel in Adjust Mode .......................................................................20
Figure 21. Change of Touch Data according to SUM_COUNT ............................................................21
Figure 22. Base-Line Trace Parameters ...............................................................................................22
Figure 23. Press Threshold and Release Threshold ............................................................................22
Figure 24. Reverse Situation Parameters.............................................................................................23
Figure 25. Debounce Count ..................................................................................................................24
Figure 26. IIR-Filter ...............................................................................................................................24
Figure 27. Touch Key Value Assignment...............................................................................................25
Figure 28. user.h ...................................................................................................................................26
Figure 29. #include in main.c ................................................................................................................26
Figure 30. main() in main.c ...................................................................................................................27
List of tables
Table 1. Shield Board Description .........................................................................................................10

1. Introduction A31G213CLN Shield Board Quick Start Guide
4
1Introduction
A31G213CLN Shield Board Quick Start Guide introduces software environment and development
recommendations for the ABOV 32-bit Cortex-Mx Touch Starter Kit.
In this document, a CMSIS-DAP debugger which is called “A-Link”is introduced. This eliminates the
need for additional devices for MCU programming and debugging. In addition, a method to operate
A31G213CLN Shield Board is introduced with examples.
By reading this document thoroughly, you can learn the easy way to develop the ABOV 32-bit Cortex-
M0x Touch MCUs.

A31G213CLN Shield Board Quick Start Guide 2. User requirements
5
2User requirements
2.1 Hardware
2.1.1 Starter Kit
Figure 1. A31G213CLN Starter Kit Board (Hardware)
2.1.2 Shield Board
Figure 2. A31G213CLN Shield Board (Hardware)

2. User requirements A31G213CLN Shield Board Quick Start Guide
6
2.2 Software
1. Keil complier (uVision5)
2. Keil MDK5 software pack (including Starter Kit sample code) or EVK software
Figure 3. Compiler (Software)
2.3 Reference documents
1. Starter Kit Quick Guide
2. Starter Kit HW Manual
3. Starter Kit Schematic
4. Product User’s Manual
5. Example Code
Figure 4. Reference Documents

A31G213CLN Shield Board Quick Start Guide 2. User requirements
7
2.4 System requirements
1. Windows PC (7, 8, 10)
2. USB mini-B type cable
Figure 5. Window PC and Mini-B Cable
2.5 ABOV website
For detailed information about corresponding software and documents, you can visit our website at
https://www.abovsemi.com.
Figure 6. ABOV Semiconductor Website

3. Building and running project (Shield Board) A31G213CLN Shield Board Quick Start Guide
8
3Building and running project (Shield Board)
Running application code makes it easier to start the Shield Board. Following the steps below:
Step 1. Prepare the Starter Kit and Shield Board
Step 2. Set up the Starter Kit and Shield Board
Step 3. Connect the Starter Kit to your PC
Step 4. Run the application Project
Step 5. Compiling application Code
Step 6. Download application Code
Step 7. Debugging application Code
Step 8. Check the application Code Operation

A31G213CLN Shield Board Quick Start Guide 3. Building and running project (Shield Board)
9
3.1 Prepare the Starter Kit and Shield Board
3.1.1 Hardware components of the Starter Kit
1. The Starter Kit board is comprised of a device board and an A-Link (CMSIS-DAP) board. The
two boards can be separated if necessary.
2. Device board configuration
A. ABOV 32-bit MCU, X-tal (optional)
B. Pin headers connected to MCU
C. LED, switches and jumpers to check input/output, reset, and debugger pins
3. A-Link (CMSIS-DAP/UART) board configuration
A. A-Link for programming and debugging with ABOV 32-bit MCU(connected to USB port of
PC)
B. UART support
Figure 7. Starter Kit B/D

3. Building and running project (Shield Board) A31G213CLN Shield Board Quick Start Guide
10
3.1.2 Hardware components of the Shield Board
Table 1. Shield Board Description
Function
Description
Remark
CS0 ~ CS7
User SW
Touch Only Pin
Touch Indicator LED
User SW
PF0~PF7
Common Anode Segment
User SW
COM3~COM6, SEG0~SEG7
Buzzer
PWM
PE1/PWM30AB
Figure 8. A31G213CLN Shield Board Description

A31G213CLN Shield Board Quick Start Guide 3. Building and running project (Shield Board)
11
3.2 Set up the Starter Kit and Shield Board
3.2.1 Set jumpers to control the Starter Kit
1. The Starter Kit uses USB power-①
A. Choose 3.3V and 5.0V (check the maximum operation voltage by referring to the
specification sheet).
2. External Power-②
3. Boot mode selection-③
A. Open : User Program operation mode(As a default mode)
B. Short : Boot operation mode(Debugger always enabled)
4. MCU RXD0 PC TXD Connection-④
5. LED Control (PE0~PE5) -⑤
6. Reset(S1), GPIO Input(PF6) -⑥
Figure 9. Starter Kit Jumper and Switch

3. Building and running project (Shield Board) A31G213CLN Shield Board Quick Start Guide
12
3.2.2 Connect to Starter Kit to use Shield Board
Connect a header socket of the Shield Board and a header pin of the Starter Kit board as shown in
Figure 10.
Figure 10. Connect to Starter Kit to use Shield Board

A31G213CLN Shield Board Quick Start Guide 3. Building and running project (Shield Board)
13
3.3 Connect the Starter Kit to your PC
3.3.1 PC connection via USB on the Starter Kit
Connect the USB 2.0 (micro-B type) cable to the Starter Kit as shown in Figure 11.
1. If the PC is properly connected, the USB Power LED will be turned on -①
2. The status LED on the A-Link board (debugger) will be turned on -②
Figure 11. Starter Kit and USB Connection

3. Building and running project (Shield Board) A31G213CLN Shield Board Quick Start Guide
14
When the A-Link is connected, USB Composite Device in Device Manager is highlighted.
1. A-Link is one of the Universal Serial Bus(USB) controllers’ class and does not require driver
installation on Microsoft Windows.
Figure 12. USB Composite Device at Device Manager

A31G213CLN Shield Board Quick Start Guide 3. Building and running project (Shield Board)
15
3.4 STKS Practice
3.4.1 Compile with Keil uVision5 for C51
1. Install “Keil uVision5 for C51”.
2. Open the provided project file (A96T418Proj.uvmpw).
Figure 13. Execute Keil uVision5 for C51
3. Build the project.
Figure 14. Build the Project

3. Building and running project (Shield Board) A31G213CLN Shield Board Quick Start Guide
16
3.4.2 Download and Debugging with A-Link
1. Connection
A. Click ①(Start/Stop Debugging Session).
B. Check ②(Erase-Program-Verify).
Figure 15. Download and Debugging with A-Link
2. Run (Start Code Execution).
Figure 16. Run (Start Code Execution)

A31G213CLN Shield Board Quick Start Guide 3. Building and running project (Shield Board)
17
3. Run
A. A buzzer sounds when a touch is recognized.
B. The touch indicator LED lights up during touch recognition.
C. Display on LED-Segment with the rules of 0001(CS0), 0002(CS1), 0004(CS2), 0008(CS3),
0010(CS4).
Segment Display
Figure 17. Touch and Display

3. Building and running project (Shield Board) A31G213CLN Shield Board Quick Start Guide
18
3.5 Library description
3.5.1 user.h
1. #define _DBG_MSG_EN X
—If you monitor the touch data with Smart-Key, set X=1, otherwise set X=0.
2. Touch CH activation
—Set ‘1’ for active CH and ‘0’ for inactive CH.
Figure 18. Touch CH Activation

A31G213CLN Shield Board Quick Start Guide 3. Building and running project (Shield Board)
19
3.5.2 main.c
1. Init_Library (void)
A. Initialize library variables.
B. This function must be called before using the library API(ts_xx, led_xx, dgb_xx, .ut_xx).
2. ts_Set_OpMode (unsigned char opMode)
A. ts_Set_OpMode (NORMAL_MODE)
▪In this mode, the parasitic capacitance value for each channel is not adjusted.
▪Sensitivity for each channel is different.
▪Since the sensitivity is different for each channel, the threshold should be applied for
each channel.
Figure 19. Sensitivity for Each Channel in Normal Mode

3. Building and running project (Shield Board) A31G213CLN Shield Board Quick Start Guide
20
B. ts_Set_OpMode (ADJUST_MODE)
▪In this mode, the parasitic capacitance value for each channel is adjusted.
▪Sensitivity for each channel is similar.
▪Since the sensitivity is similar, a common threshold can be applied.
Figure 20. Sensitivity for Each Channel in Adjust Mode