blob: f144b21c8c6369088c9907894f8a01ecf347d307 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
/**
@page TouchSensing_1touchkey 1 touchkey sensor example
@verbatim
******************************************************************************
* @file TouchSensing\TouchSensing_1touchkey\readme.txt
* @author MCD Application Team
* @brief Description of the TouchSensing 1 touchkey sensor example.
******************************************************************************
*
* Copyright (c) 2020 STMicroelectronics. All rights reserved.
*
* This software component is licensed by ST under Ultimate Liberty license
* SLA0044, the "License"; You may not use this file except in compliance with
* the License. You may obtain a copy of the License at:
* www.st.com/SLA0044
*
******************************************************************************
@endverbatim
@par Application Description
Use of the STMTouch driver with 1 touchkey sensor.
This application also uses the Environment Change System (ECS) and
Detection Time Out (DTO).
Observed behaviour:
- The LD4 is HIGH GREEN when the TS1 sensor is touched.
- The LD4 is Low GREEN when the TS1 sensor is approached.
- The LD4 is BLUE each time the ECS process is finished.
- The LD4 is RED in case of error.
- On the LCD are also displayed:
* The ECS state (ON/OFF).
* The TS1 touchkey sensor state (RELEASE, DETECT, ...) and the delta value.
- The ECS is ON when no touch is detected (sensor is in the RELEASE state).
The ECS is always present but its behaviour can be modified using some parameters in
the tsl_conf.h file.
- You can experiment the DTO by touching a sensor for few seconds. The RELEASE state
is automatically entered and a re-calibration is performed after the timeout is reached.
This timeout is programmable by the TSLPRM_DTO parameter in the tsl_conf.h file.
@par Keywords
Touch sensing, TouchSensing
@par Project Directory contents
- TouchSensing_1touchkey\Inc\main.h Header for main.c file
- TouchSensing_1touchkey\Inc\stm32wb5mm_dk_conf.h Discovery Module configuration file
- TouchSensing_1touchkey\Inc\stm32wbxx_hal_conf.h HAL Library configuration file
- TouchSensing_1touchkey\Inc\stm32wbxx_it.h Header for stm32wbxx_it.c file
- TouchSensing_1touchkey\Src\stmCriticalSection.h Header for stmCriticalSection.c file
- TouchSensing_1touchkey\Inc\tsl_conf.h STMTouch driver configuration file
- TouchSensing_1touchkey\Inc\tsl_user.h Header for tsl_user.c file
- TouchSensing_1touchkey\Src\main.c Main program file
- TouchSensing_1touchkey\Src\stm32wbxx_hal_msp.c HAL MSP module file
- TouchSensing_1touchkey\Src\stm32wbxx_it.c Interrupt handlers file
- TouchSensing_1touchkey\Src\stmCriticalSection.c STMStudio lock/unlock mechanism file
- TouchSensing_1touchkey\Src\system_stm32wbxx.c System initialization file
- TouchSensing_1touchkey\Src\touchsensing.c Touchsensing instances configuration file
- TouchSensing_1touchkey\Src\tsl_user.c Touchsensing channels/banks description file
@par Hardware and Software environment
- This example runs on STM32WB5MMxx devices.
- This example has been tested with STM32WB5MM Discovery Kit board. It can be
easily tailored to any other devices that embed the TSC peripheral and to
any other development board supporting touchsensing sensor.
@par How to use it ?
In order to make the program work, you must do the following :
- Open your preferred toolchain
- Rebuild all files and load your image into target memory
- Run the example
* <h3><center>© COPYRIGHT STMicroelectronics</center></h3>
*/
|
