background image

3. Build and Run Project (Shield Board) 

 

A31T216RLN Shield Board Quick Guide 

 

10 

3

 

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.

 

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 

 

 

Summary of Contents for A31T216RLN

Page 1: ...Global Top Smart MCU Innovator ABOV Semiconductor www abovsemi com A31T216RLN Shield Board Shield Board Quick Guide Version 1 00...

Page 2: ...f 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...

Page 3: ...igure 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...

Page 4: ...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 t...

Page 5: ...quirements 5 2 User 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 Hardw...

Page 6: ...tware 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 edi...

Page 7: ...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 Exa...

Page 8: ...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...

Page 9: ...LN 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...

Page 10: ...d 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 Sta...

Page 11: ...d 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 sw...

Page 12: ...ion 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_...

Page 13: ...pers 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 mod...

Page 14: ...hield 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...

Page 15: ...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...

Page 16: ...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...

Page 17: ...rd 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 uVisi...

Page 18: ...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...

Page 19: ...wn 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 DA...

Page 20: ...uick 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...

Page 21: ...5 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...

Page 22: ...d Board A31T216RLN Shield Board Quick Guide 22 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 ty...

Page 23: ...ng led_driver c set X 1 otherwise set X 0 2 define DBG_MSG_EN X If you are using debug c set X 1 otherwise set X 0 3 define TS_LED_TIME_DIV 1 Touch operation is performed during the stable VDD section...

Page 24: ...3 Build and Run Project Shield Board A31T216RLN Shield Board Quick Guide 24 4 define TS_LED_TIME_DIV 0 Figure 20 Touch LED Independent Mode...

Page 25: ...A31T216RLN Shield Board Quick Guide 3 Build and Run Project Shield Board 25 5 Touch CH activation Set 1 for active CH and 0 for inactive CH Figure 21 Touch CH Activation...

Page 26: ...3 Build and Run Project Shield Board A31T216RLN Shield Board Quick Guide 26 6 LED COM SEG activation Set 1 for active COM SEG port and 0 for inactive COM SEG port Figure 22 LED COM SEG Port Activation...

Page 27: ...A31T216RLN Shield Board Quick Guide 3 Build and Run Project Shield Board 27 7 CH Shield activation Set 1 for active CH Shield and 0 for inactive CH Shield Figure 23 Touch CH Activation...

Page 28: ...d It initializes library variables It must be called before using the library API 4 Set_Library A TS_Set_Mode unsigned char mode TS_Set_Mode NORMAL_MODE In this mode the parasitic capacitance value fo...

Page 29: ...Board 29 TS_Set_Mode 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 c...

Page 30: ...ch_shld 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 If mesh_shld is MESH_SHIELD_EN the CS23 channel operat...

Page 31: ...It sets SUM_COUNT register value SUM_COUNT determines the number of consecutive sensing times for a channel SUM_COUNT can act as a low pass filter but it has a disadvantage that the sensing time beco...

Page 32: ...the threshold for each channel This can be used with NORMAL_MODE F TS_Set_NoiseTHD_Rate unsinged char rate This function sets the noise threshold level Noise threshold level is rate of the THD thresh...

Page 33: ...acking unsinged char iir_1 unsinged char iir_2 unsigned int period iir_1 The coefficient N of IIR filter for baseline tracking under the Noise THD iir_2 The coefficient N of IIR filter for baseline tr...

Page 34: ...on sets the level for key release judgement Key release judgement level is rate of the THD threshold Figure 30 Press Threshold and Release Threshold J TS_Set_Reverse_Rate unsigned char rate This funct...

Page 35: ...k Guide 3 Build and Run Project Shield Board 35 K TS_Set_Reverse_Time unsigned char time This function sets the reverse holding time unit ms After this time rawdata and basedata are matched Figure 31...

Page 36: ...ise 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 Values in the range between 0 and 3 are recommended...

Page 37: ...t 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 slot_ms is the LED occupancy time...

Page 38: ...s 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 If two or more keys are recognized t...

Page 39: ...A31T216RLN Shield Board Quick Guide 3 Build and Run Project Shield Board 39 3 6 3 Library Usage Example user h Figure 36 Source Code user h...

Page 40: ...3 Build and Run Project Shield Board A31T216RLN Shield Board Quick Guide 40 main Figure 37 Source Code main in main c...

Page 41: ...A31T216RLN Shield Board Quick Guide Revision History 41 Revision History Revision Date Notes 1 00 21 07 08 Document created...

Page 42: ...es and shall not be responsible or liable for any injuries or damages related to use of ABOV products in such unauthorized applications ABOV and the ABOV logo are trademarks of ABOV All other product...

Reviews: