This repository contains two PowerShell®-compatible scripts for configuring the MTCH9010 through the Enhanced Configuration mode via a serial communication:
send_param_basic.ps1: Basic Configuration Scriptsend_param_enh.ps1: Enhanced Configuration Script
- PowerShell 5.1 or newer
Two PowerShell®-compatible scripts for configuring the MTCH9010 are provided in this repository:
send_param_basic.ps1- this script transmits a predefined configuration to the MTCH9010send_param_enh.ps1- this script allows the user to transmit the desired configuration parameters
Open a PowerShell terminal. From the command prompt, go to the directory where the scripts are located. Run one of the following commands, depending on which script you are using:
.\send_param_basic.ps1 or .\send_param_enh.ps1
Before running the scripts, the device must be configured in Enhanced Configuration mode through the corresponding slide switch. The following configuration must be made on the MTCH9010:
- ECFG configured to ON
- LOCK configured to OFF
To ensure proper communication with the hardware, verify the COM port assigned to the device before running the script, as incorrect port settings can lead to connection failures. The specific COM port for the MTCH9010 Evaluation Kit can be identified by checking the Ports section in Windows Device Manager.
The COM port used in these examples is COM37. Additionaly, the coresponding serial port must be configured as it is shown below.
$port = New-Object System.IO.Ports.SerialPort COM37, 38400, None, 8, 1
- 38400: Baud rate of 38400 bits/second
- None: No parity bit
- 8: Eight data bits
- 1: One stop bit
send_param_basic.ps1 transmits a predefined configuration to the MTCH9010. The following
parameters are set in this example:
Operation Mode: Conductive (option1)Sleep period: Four seconds (option3)Extended output mode: Serial data enabled (option1)Extended output format: Standard measurement and delta (option2)- Confirm the
reference valueprovided (option0) - Provide the
threshold value:800
send_param_enh.ps1 allows the user to enter the desired parameters. A reset is needed to start configuring the device. After the configuration is done, the script displays a message, followed by the measurements made by MTCH9010. The configured parameters can be saved in the Nonvolatile Memory (NVM) and restored at every start-up. To enable this functionality, configure the MTCH9010 as follows :
- LOCK configured to ON
- ECFG configured to OFF
The following table describes the available options when it comes to configuring application parameters through the Enhanced Configuration mode:
| Parameter | Value | Configuration |
|---|---|---|
| Operation Mode | 0 | Capacitive |
| 1 | Conductive | |
| Sleep Time | 0 | Wake-up on request |
| 1 | 1 second | |
| 2 | 2 seconds | |
| 3 | 4 seconds | |
| 4 | 8 seconds | |
| 5 | 16 seconds | |
| 6 | 32 seconds | |
| 7 | 64 seconds | |
| 8 | 128 seconds | |
| 9 | 256 seconds | |
| Extended Output Moode | 0 | Disabled |
| 1 | Enabled | |
| Extended Output Format | 0 | Delta measurement |
| 1 | Standard measurement | |
| 2 | Both standard and delta measurements | |
| 3 | MPLAB Data Visualizer Data Stream protocol format | |
| Capacitive/Conductive Reference Value | 0 | Set the standard measurement as Reference Value |
| 1 | Repeat the capacitive/conductive measurement | |
| 2 | Set custom Reference Value | |
| Capacitive/Conductive Detection Threshold | 0 | Set custom Detection Threshold |
Once the System Lock is enabled, the saved configuration will be used at power-up. The user can view the values acquired with the new configuration after applying a reset. The send_param_enh.ps1 script will continue running until any key is pressed.
Note: A reset is required before sending the parameters to the MTCH9010 in both scenarios.
The next demonstation GIF presents a showcase of how to configure the MTCH9010 using the send_param_enh.ps1 script.
These PowerShell®-compatible scripts are used for configuring the MTCH9010 through the Enhanced Configuration mode via a serial communication.