Related Manuals for Abov A31T21 RLN Series
Summary of Contents for Abov A31T21 RLN Series
- Page 1 A31T21xRLN Shield Board Shield Board Quick Guide Version 1.13 Global Top Smart MCU Innovator, ABOV Semiconductor www.abovsemi.com...
-
Page 2: Table Of Contents
Hardware .......................... 8 Software ........................... 9 Reference Documents ....................10 System Requirements ....................11 ABOV Website ....................... 12 Build and Run Project (Shield Board) ..................13 Prepare Starter Kit and Shield Board................14 3.1.1 Hardware Components of Starter Kit ..............14 3.1.2... - Page 3 A31T21xRLN Shield Board Quick Guide Contents 4.1.1.19 #define THD_RELEASE_RATE_CHxx [n] ........... 35 4.1.1.20 #define BASE_TRACE_SPEED_CHECK_RATE_CHxx [n] ......36 4.1.1.21 #define BASE_TRACE_FAST_SPEED_CHxx [n] ........36 4.1.1.22 #define BASE_TRACE_SLOW_SPEED_CHxx [n] ........37 4.1.1.23 #define FILTER_IIR_GAIN_CHxx [n] ............37 4.1.1.24 #define DETECT_DEBOUNCE_CNT_CHxx [n] .......... 37 4.1.1.25 #define RELEASE_DEBOUNCE_CNT_CHxx [n] ........
- Page 4 Contents A31T21xRLN Shield Board Quick Guide 4.4.1.6 void Init_User_Function (void) ................ 48 Revision History ............................ 49...
- Page 5 Figure 4. Reference Document on the ABOV Website ................. 10 Figure 5. Window PC and Mini-B Cable ....................11 Figure 6. Software and Documents at ABOV Semiconductor Website ..........12 Figure 7. Starter Kit Board ........................14 Figure 8. Components of A31T216RLN Shield Board ................15 Figure 9.
- Page 6 List of Tables A31T21xRLN Shield Board Quick Guide List of Tables Table 1. Shield Board Description ......................15...
-
Page 7: Introduction
Introduction 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. -
Page 8: User Requirements
2. User Requirements A31T21xRLN Shield Board Quick Guide User Requirements 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) -
Page 9: Software
A31T21xRLN Shield Board Quick Guide 2. User Requirements 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. -
Page 10: Reference Documents
2. User Requirements A31T21xRLN Shield Board Quick Guide 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... -
Page 11: System Requirements
A31T21xRLN Shield Board Quick Guide 2. User Requirements 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... -
Page 12: Abov Website
2. User Requirements A31T21xRLN Shield Board Quick Guide 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... -
Page 13: Build And Run Project (Shield Board)
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) Build and Run Project (Shield Board) Running application code makes it easier to start the Shield Board. Following the steps below: Prepare Starter Kit and Shield Board. Step 1. Starter Kit and Shield Board settings Step 2. -
Page 14: Prepare Starter Kit And Shield Board
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. Device board configuration: ABOV 32-bit MCU, X-TAL (optional) Pin headers connected to MCU C. LEDs and switches to check input/output... -
Page 15: Hardware Components Of Shield Board
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 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 Touch & SEG CS23) Touch (CS20 to CS22) COM only... -
Page 16: Starter Kit And Shield Board Settings
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide 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: The Starter Kit uses the USB power. -
Page 17: Starter Kit Connection For Shield Board Use
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 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. -
Page 18: Starter Kit Connection To Pc
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide 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: The power LED on the device board is turned on. -
Page 19: Hardware Recognition On Pc (Device Drivers)
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 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. -
Page 20: Run Starter Kit Shield Board
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide 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: Install ‘Keil uVision 5 for Cortex-M’. -
Page 21: Figure 14. Project Build In Keil Uvision 5
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) Build the project as shown in Figure 14. Figure 14. Project Build in Keil uVision 5... -
Page 22: A-Link Debugger Configuration And Download
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide 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. 3.4.2.1 Debugger Configuration Before downloading firmware to the target, the A-Link debugger must be configured in options panel of... -
Page 23: Firmware Download
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 3.4.2.2 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. -
Page 24: Debugging
Run ‘Start/Stop Debugger Session’ to enter debugger mode. The Starter Kit must be connected to the PC for real-time, interactive debugging. In debugger mode, the program can be executed per Run/Step/Stop Debugger Session. Figure 17. Debugging with ABOV A-Link and CMSIS-DAP... -
Page 25: Figure 18. T-Type And M-Type Leds For Touch And Display
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) Figure 18 describes T-type and M-type LEDs’ operation for Touch and Display. Run ➔ LED-Matrix (M-type) and LED-Segment (T-type) display Figure 18. T-type and M-type LEDs for Touch and Display... -
Page 26: Function Description (Using Touch Library)
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide Function Description (Using Touch library) Touch Parameter Description 4.1.1 touch_config.h touch_config.h defines the parameters applied in the touch library. 4.1.1.1 #define CSxx_USE X ━ If using CSxx PIN as the touch channel, set X=1, otherwise set X=0. Figure 19. -
Page 27: Define Mesh_Shield_En X
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.1.2 #define MESH_SHIELD_EN X ━ If using CS23 pin as the mesh-shield, set X=1, otherwise set X=0. ━ It is a function that prevents water droplets from falling on the PAD and the touch sensitivity from decreasing. -
Page 28: Define Touch_Clk_Val [N]
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide 4.1.1.4 #define TOUCH_CLK_VAL [n] ━ Set touch clock frequency. ━ Default : TOUCH_FREQ_4M Figure 21. Touch clock setting select option (in touch_lib.h) 4.1.1.5 #define TOUCH_CLK_OFFSET_VAL [n] ━ Basically, the touch sensor performs touch sensing twice at two frequencies (F0 & F1). ━... -
Page 29: Define Touch_Mode_Val [N]
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.1.6 #define TOUCH_MODE_VAL [n] ━ Set touch sensing operation mode. Figure 23. Touch sensing operation mode select option ━ TS_MODE_NORMAL The most common mode of operation ◼ In this mode, parasitic capacitance value for each channel is not adjusted. ◼... -
Page 30: Figure 25. Sensitivity For Each Channel In Adjust Mode
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide ━ TS_MODE_ADJUST It is a mode that automatically adjusts the capacitance value of each channel to be the ◼ same by using the capacitance inside the IC. Adjusted based on channel with highest capacitance. ◼... -
Page 31: Define Touch_Port_Sel_Val [N]
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.1.7 #define TOUCH_PORT_SEL_VAL [n] ━ Set port condition when touch channel is waiting sensing. ━ Default : MODE_OUT_LOW Figure 26. Touch sensing port select option 4.1.1.8 #define TOUCH_VHS_VAL [n] ━... -
Page 32: Define Timer_Base_Reverse_Sample [N]
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide 4.1.1.12 #define TIMER_BASE_REVERSE_SAMPLE [n] ━ This feature prevents malfunction when Rawdata is outside the baseline. ━ This function sets the reverse (Rawdata > Baseline) holding time. ━ When the reverse hold time reaches the set time, Baseline is initialized to the Rawdata value ━... -
Page 33: Define Base_Release_Hold_Cnt_Val [N]
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.1.14 #define BASE_RELEASE_HOLD_CNT_VAL [n] ━ Baseline is not updated as many as [n] frames during touch release. ━ By setting value, sensing is repeated, and cumulative summing is performed. Therefore, it can serve as a low-pass filter, but there is a disadvantage that the sensing time is prolonged. -
Page 34: Define Touch_Lpf_R_Chxx [N]
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide 4.1.1.17 #define TOUCH_LPF_R_CHxx [n] ━ Sets the values of the resistor and capacitor for the IC internal low pass filter. ━ The greater the setting value, the greater the sensitivity. Figure 29. -
Page 35: Define Thd_Release_Rate_Chxx [N]
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.1.19 #define THD_RELEASE_RATE_CHxx [n] ━ Set the release threshold for each channel. ━ In the key detect state, a key release event occurs if the Diff data is less than the release threshold. -
Page 36: Define Base_Trace_Speed_Check_Rate_Chxx [N]
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide 4.1.1.20 #define BASE_TRACE_SPEED_CHECK_RATE_CHxx [n] ━ Sets the level for changing the speed of the baseline. ━ In the Release state, if Diff is greater than the set value, BASE_TRACE_SLOW_SPEED is applied. -
Page 37: Define Base_Trace_Slow_Speed_Chxx [N]
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.1.22 #define BASE_TRACE_SLOW_SPEED_CHxx [n] ━ Set the gain for baseline slow speed. ━ The greater the setting value, the slower the baseline. It should be set to a value greater than FAST_SPEED. -
Page 38: Define Release_Debounce_Cnt_Chxx [N]
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide 4.1.1.25 #define RELEASE_DEBOUNCE_CNT_CHxx [n] ━ Set the debounce value used to remove glitch noise. ━ If the debounce count is too large, it takes a lot of time for touch recognition and release recognition, so you need to set the appropriate value. -
Page 39: Define Ref_Ch_Sum_Cnt_Val [N]
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.1.28 #define REF_CH_SUM_CNT_VAL [n] ━ This function to adjust the amount of change in Ref CH sensing data.. ━ The operating principle is the same as TOUCH_SUM_CNT. ━ Setting range [0~15] : Default 8 4.1.1.29 #define REF_CH_LPF_C_VAL [n] 4.1.1.30 #define REF_CH_LPF_R_VAL [n] ━... -
Page 40: User_Function.h
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide 4.1.2 user_function.h Description of the touch parameter among the parameters of ‘user_function.h’. 4.1.2.1 #define TOUCH_FREQ_SEL_EN X ━ If the Ref channel and the Touch channel change in the same direction, set X=0. Otherwise, set X=1. -
Page 41: Define Hold_Key_Release_En X
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.2.4 #define HOLD_KEY_RELEASE_EN X ━ If you want to use hold key release function, set X=1. Otherwise, set X=0. ━ When the key remains in the Detect state for a long period of time, it is a force release function and is used to prevent malfunction. -
Page 42: Define Multi_Key_Reset_En X
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide 4.1.2.5 #define MULTI_KEY_RESET_EN X ━ If you want to use multi key reset function, set X=1. Otherwise, set X=0. ━ This feature initializes all keys when more keys are recognized than the number of multi-keys allowed. -
Page 43: Define Channel_Grouping_En X
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) 4.1.2.8 #define CHANNEL_GROUPING_EN X ━ If you want to use Cannel Grouping function, set X=1. Otherwise, set X=0. ━ Divide groups by key and ignore key inputs from other groups when key inputs occur. ━... -
Page 44: Led Parameter Description
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide LED Parameter Description 4.2.1 user_function.h 4.2.1.1 #define LED_DRV_EN X ━ If you want to use led driver function, set X=1. Otherwise, set X=0. ━ Setting top options for LED driver actions. When set to 0, LED driver-related operations are not performed. -
Page 45: Define Led_Use_Com_Num [N]
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) Figure 37. Comparison of noise effects depending on the use of touch/LED time division 4.2.1.3 #define LED_USE_COM_NUM [n] ━ Set number of LED COM ports (ICOM) used. 4.2.1.4 #define TIME_LED_OPREATING [n] ━... -
Page 46: Define Comxx_En X
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide Figure 38. LED current select option 4.2.1.7 #define COMxx_EN X 4.2.1.8 #define SEGxx_EN X ━ If you used ICOM/ISEG channel, set X=1. Otherwise, set X=0. -
Page 47: User Parameter Description
A31T21xRLN Shield Board Quick Guide 4. Function Description (Using Touch library) User Parameter Description 4.3.1 user_function.h 4.3.1.1 #define UART_DEBUG_EN X ━ If you want to use debug.c (UART), set X=1. Otherwise, set X=0. ━ Data on Touch can be checked during project development. ━... -
Page 48: Main Function Description
4. Function Description (Using Touch library) A31T21xRLN Shield Board Quick Guide Main Function Description 4.4.1 main.c 4.4.1.1 void Port_Init (void) ━ A function that sets the default value for GPIO. 4.4.1.2 void System_Setting_Config (void) ━ A function that sets the default value for SCU. 4.4.1.3 void Change_SysClock (void) ━... - Page 49 A31T21xRLN Shield Board Quick Guide Revision History Revision History Revision Date Notes 1.00 21.07.08 Document created 1.10 22.09.15 Update Touch Library document 1.11 22.09.21 correction of typo 1.12 22.11.02 Revised the font of this document 1.13 23.09.25 [Library code version : 1.2.0] Library Code Change structure and add functionality...
- Page 50 ABOV Semiconductor ("ABOV") reserves the right to make changes, corrections, enhancements, modifications, and improvements to ABOV products and/or to this document at any time without notice. ABOV does not give warranties as to the accuracy or completeness of the information included herein. Purchasers should obtain the latest relevant information of ABOV products before placing orders.