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.12 Global Top Smart MCU Innovator, ABOV Semiconductor www.abovsemi.com...
-
Page 2: Table Of Contents
Hardware ..........................6 Software ..........................7 Reference Documents ......................8 System Requirements ......................9 ABOV Website ........................10 Build and Run Project (Shield Board) ..................11 Prepare Starter Kit and Shield Board ................12 3.1.1 Hardware Components of Starter Kit ..............12 3.1.2... - Page 3 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.
- Page 4 List of Tables A31T21xRLN Shield Board quick Guide List of Tables Table 1. Shield Board Description ......................13...
-
Page 5: Introduction
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. -
Page 6: User Requirements
2. User Requirements A31T21xRLN Shield Board Quick Guide User Requirements 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) -
Page 7: 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 8: Reference Documents
2. User Requirements A31T21xRLN Shield Board Quick Guide 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... -
Page 9: 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 10: 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 11: 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: Step 1. Prepare Starter Kit and Shield Board. Step 2. -
Page 12: 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 13: Hardware Components Of Shield Board
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) Hardware Components of Shield Board 3.1.2 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 14: Starter Kit And Shield Board Settings
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide Starter Kit and Shield Board Settings Jumper Settings for Starter Kit Control 3.2.1 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 15: Starter Kit Connection For Shield Board Use
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) Starter Kit Connection for Shield Board Use 3.2.2 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 16: Starter Kit Connection To Pc
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide Starter Kit Connection to PC USB Connection with USB 2.0 Cable 3.3.1 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 17: Hardware Recognition On Pc (Device Drivers)
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) Hardware Recognition on PC (Device Drivers) 3.3.2 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 18: Run Starter Kit Shield Board
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide Run Starter Kit Shield Board Compilation with Keil uVision 5 3.4.1 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 19: 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 20: A-Link Debugger Configuration And Download
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide A-Link Debugger Configuration and Download 3.4.2 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. -
Page 21: Figure 16. Firmware Download And Verification Result
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 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 22: 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 23: 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 24: Library Description
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide Library Description user.h 3.6.1 #define LED_DRV_EN X: ━ An option to control the LED via the LED driver. ━ If you are using led_driver.c, set X=1, otherwise set X=0. ━... -
Page 25: Figure 20. Touch/Led Independent Mode
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) ━ #define TS_LED_TIME_DIV 0 : More noise is generated than when used. Figure 20. Touch/LED Independent Mode #define DBG_MSG_EN X: ━ Data on Touch can be checked during project development. ━... -
Page 26: Figure 21. Hold Key Release Event
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide #define HOLD_KEY_RELEASE X: ━ If you are using Hold Key Release function, set X=1, otherwise set X=0. ━ If one or more keys are continuously pressed for a certain period of time (default 10s), the function is judged to be abnormal and the entire key is initialized. -
Page 27: Figure 22. Touch Key Priority Define
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) #define FIRST_KEY_PRIORITY X: ━ If you are using Key Priority set function, set X=1, otherwise set X=0. ━ If you enter a key set to priority, other keys are ignored (the keys with the same priority are not ignored;... -
Page 28: Figure 23. Single-Multi Touch Key Type Define
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide #define MULTI_KEY_RESET X: ━ Set X=1 if you are using the multi-key reset function, otherwise set X=0. ━ If the number of keys that are not set other than the set multiple keys exceeds the set value, the input key is reset. -
Page 29: Figure 24. Touch Ch Pos Noise Thd Value Define
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) #define BIG_DIFF_CANCEL X: ━ Set X=1 if you are using the Big Noise Threshold feature, otherwise set X=0. ━ #Definition POS_NOISE_THD_CHxx30000: Setting range (4000 to 32767) ━ If the Diff data exceeds the set value (30000), it ignores major events. ━... -
Page 30: Figure 25. Touch Ch Group Define
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide 10. #define CHANNEL_GROUPING X: ━ If you are using Channel 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 31: Figure 26. Serial Register Select Option
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 11. #define SERIAL_REGISTER_EN X: ━ Noise may be reduced by setting a resistance value for the internal RC filter. ━ The resistance value for the internal RC filter may be individually set or collectively set. ━... - Page 32 3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide 12. #define CUSTOMER_FILTER_ONESENSING X: ━ If you are using Raw data User filter function, set X=1, otherwise set X=0. ━ Store sensing data by buffer size and sort them by size. Set the data of the range to be selected among the sorted data, and obtain the average value as a result.
-
Page 33: Figure 27. Touch Ch Activation
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 14. Touch CH activation: ━ Set the channel CSxx to use for KEY_CHxx_PIN. Figure 27. Touch CH Activation... -
Page 34: Figure 28. Led Com/Seg Port Activation
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide 15. LED COM/SEG activation: ━ Set ‘1’ for active COM/SEG port and ‘0’ for inactive COM/SEG port. Figure 28. LED COM/SEG Port Activation... -
Page 35: Figure 29. Touch Ch Activation
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) 16. CH Shield activation: ━ It functions to offset the touch sensitivity caused by water droplets. ━ Set ‘1’ for active CH-Shield and ‘0’ for inactive CH-Shield. Figure 29. Touch CH Activation... -
Page 36: Main.c
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide main.c 3.6.2 Init_Library (void): ━ It initializes library variables. ━ It must be called before using the library API. Set_TS_IO (void): ━ It sets the pin function for Touch operation. Set_Library(void);... -
Page 37: Figure 31. Sensitivity For Each Channel In Adjust Mode
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) ▪ TS_Set_Mode (ADJUST_MODE) ✓ It is a mode that automatically adjusts the capacitance value of each channel to be the same using the IC internal capacitance. ✓ The capacitance values for each channel are adjusted equally, so the sensitivity for each channel is adjusted similarly. - Page 38 3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide C. Touch_Set_Comp_RefV(unsigned int ref_v) ▪ Applies to 'Hisense Mode' only Setting range (3500 ~ 4000) : default 3700 ▪ D. Touch_Set_Frequency(unsigned char freq) ▪ You can adjust the touch clock. (Default :16MHz) ▪...
-
Page 39: Figure 32. Ch_Shield_Dis, Mesh_Shield_Dis
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) TS_Set_Shield (unsigned char ch_shield, unsigned char mash_shield): ▪ This function prevents malfunction of water droplets falling on the PAD and causing touch sensitivity. ▪ If ch_shield is CH_SHIELD_EN, the channels set as shield channels in user.h(#define SHLD_CSXX) act as shields when they do not operate as touch channels. -
Page 40: Figure 34. Touch Data Changes According To Sum_Count
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide G. Touch_Set_Inact_Port(unsigned char_state); ▪ Determines the status of PINs that are not used during detection. Set OUTPUT_LOW by default. ▪ H. Touch_Set_Sum_Count(unsigned char ch_idx, unsigned char raw_sum_cnt): ▪ A function that allows you to adjust the touch sensitivity. -
Page 41: Figure 36. Press Threshold And Release Threshold
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) TS_Set_Common_THD (signed int thd): ▪ Common Threshold is common to all channels. Considering the H/W status, it can be used when ADJUST_MODE. ▪ TS_Set_CH_THD (unsigned char ch_idx, signed int thd): ▪... -
Page 42: Figure 35. Base-Line Tracking
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide M. TS_Set_Reverse_Rate (unsigned char rate): ▪ This function sets the level for key reverse situation (rawdata > basedata+α) judgement. ▪ Key reverse situation level is rate % of the THD (threshold). ▪... -
Page 43: Figure 37. Reverse Situation Parameters
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) O. TS_Set_Reverse_Time (unsigned char time): ▪ This feature prevents malfunction when Rawdata is outside the baseline. This function sets the reverse holding time (unit: ms). ▪ ▪ After this time, rawdata and basedata are matched. ▪... -
Page 44: Figure 39. Iir-Filter
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide TS_Set_IIR (unsigned char offset_cnt): ▪ This function sets offset value of the IIR filter. data(n) = (data(n-1) * offset_cnt + data(n)) / (offset_cnt + 1) ▪ ▪ The recommended setting is 1, which may affect operability if set too high. Figure 38. - Page 45 A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) R. Touch_Set_Sum_Count_Ref(unsigned char raw_sum_Ref); ▪ A function that allows you to adjust the touch sensitivity. SUM_COUNT determines the number of consecutive sensing times for a channel. ▪ Touch_Set_CH_Serial_Register_Ref(uint8_t REG_value); ▪...
-
Page 46: Figure 40. Touch/Led Time-Division Operation
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide LED_Set_Actv_Time (unsigned char com_cnt, unsigned char slot_ms, unsigned char period): ▪ This function sets the time of LED occupancy during Touch/LED time division operation. com_cnt is the number of COMs used. ▪... -
Page 47: Figure 41. Touch Key Value Assignment
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) Variable ‘ts.detect_key’: ▪ This variable has a size of 32 bits. Bits are assigned sequentially from the lowest channel number among the activated ▪ keys. ▪ If no channel is recognized, this value is 0. ▪... -
Page 48: Figure 42. Source Code: User.h
3. Build and Run Project (Shield Board) A31T21xRLN Shield Board Quick Guide Library Usage Example user.h Figure 42. Source Code: user.h... -
Page 49: Figure 43. Source Code : Main() In Main.c
A31T21xRLN Shield Board Quick Guide 3. Build and Run Project (Shield Board) main() Figure 43. Source Code : main() in main.c... -
Page 50: Revision History
Revision History A31T21xRLN Shield Board Quick Guide 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... - Page 51 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.