関数仕様 - ソフトウェア説明 - RX113グループ　アプリケーションノート　CTSU 相互容量方式タッチ計測

4. ソフトウェア説明

4.9 関数仕様

サンプルコードの関数仕様を示します。

4.9.1 main

main()

概要システムメイン関数宣言

void main(void)

説明この関数は、タッチAPIをコールすることでシステム全体の制御を行います。

タッチ計測は、20ms周期にて行われます。もし、計測時間が20msを超えた場合、

毎2ms周期で計測開始を確認し、計測を行います。

コール関数 R_Set_Cap_Touch_Create()

R_Set_Cap_Touch_measurement_start() R_Get_Cap_Touch_Data_Check() R_Get_Cap_Touch_Initial_status() R_Get_Cap_Touch_Function_Data() R_Set_Cap_Touch_Initial_Tuning()

R_Set_Cap_Touch_Next_Method_Change()

引数 - -

リターン値 -

4.9.2

touch_parameter_address_set touch_parameter_address_set()

概要タッチパラメータアドレス設定

宣言

void touch_parameter_address_set(void)

説明この関数は、タッチパラメータのアドレスを設定する関数です。

設定されるパラメータは、g_key_info[]構造体のメンバです。

コール関数 -

引数 - -

リターン値 -

4.9.3

touch_parameter_set touch_parameter_set()

概要タッチパラメータ設定

宣言

void touch_parameter_set(void)

説明この関数は、タッチパラメータを設定する関数です。

設定されるパラメータは、以下の構造体のメンバです。

g_touch_paramter[]

g_touch_function[]

g_calib_info[]

g_key_info[]

g_touch_tuning_info[]

g_touch_all_result[]

g_sliderInfo[]

g_wheelInfo[]

コール関数 touch_sensor_index_set()

引数 - -

リターン値 -

4.9.4

touch_sensor_index_set touch_sensor_index_set()

概要タッチセンサ番号に計測チャネル番号を付与する処理宣言

void touch_sensor_index_set( method )

説明この関数は、タッチセンサ番号に計測チャネル番号を割り当てます。

コール関数 -

引数 uint8_t method 計測方式番号リターン値 -

4.9.5

touch_calibration touch_calibration()

概要タッチキャリブレーション処理宣言

void touch_calibration( method )

説明この関数は、タッチ/非タッチ判断を行うための基準値を設定するタッチセンサ番号を判断します。

基準値の設定は、キー機能に割り当てられているタッチセンサにのみ設定されます。

コール関数 touch_key_function_check() touch_initial_reference_set()

引数 uint8_t method 計測方式番号リターン値 uint8_t status … CALIB_RUN(0), CALIB_FINISH(1)

4.9.6

touch_initial_reference_set touch_initial_reference_set()

概要タッチ初期基準値設定

宣言

void touch_initial_reference_set( method, loop )

説明この関数は、タッチ/非タッチ判断を行うための基準値を設定します。

基準値は、CALIB_TIMEに設定された回数分の計測データを取得し、設定されます。

コール関数 -

引数 uint8_t method 計測方式番号

uint8_t loop 基準値を設定するキー数

リターン値 -

4.9.7

touch_key_decode touch_key_decode()

概要タッチデコード処理

宣言

void touch_key_decode( method, value, number )

説明この関数は、タッチ/非タッチ判断を行うための関数を制御します。

コール関数 touch_judgement_parameter_create() touch_judgement()

touch_drift_correction()

引数 uint8_t method 計測方式番号

uint16_t value 計測データ

uint8_t number センサ番号

リターン値 -

4.9.8

touch_judgement_parameter_create touch_judgement_parameter_create()

概要タッチ/非タッチ判断パラメータ生成処理

宣言

void touch_judgement_parameter_create( method, value )

説明この関数は、タッチ/非タッチ判断パラメータを生成します。

生成するパラメータは、タッチ/非タッチ判断しきい値とタッチ変化量の2パラメータです。

＜相互容量＞

タッチ/非タッチ判断しきい値 = 基準値－ユーザー設定タッチ/非タッチ判断しきい値 g_mutual0_thr[] = g_mutual0_ref[] + g_mutual0_user_thr[]

タッチ変化量 = 計測データ－基準値 g_mutual0_delta[] = g_mutual0_ref[] - value

コール関数 -

引数 uint8_t method 計測方式番号

uint16_t value 計測データ

リターン値 -

4.9.9

touch_judgement touch_judgement()

概要タッチ/非タッチ判断処理

宣言

void touch_judgement( method, value, group, offset )

説明この関数は、touch_judgement_parameter_create()にて生成したパラメータを用いて、タッチ/非タッチ判断を行います。

＜相互容量＞

タッチ＝タッチ/非タッチ判断しきい値＞計測データ非タッチ＝タッチ/非タッチ判断しきい値＜計測データ

コール関数 -

引数 uint8_t method 計測方式番号

uint16_t value 計測データ

uint8_t group タッチセンサグループ

uint8_t offset タッチセンサ番号オフセット

リターン値 -

＜相互容量＞

相互容量計測は、タッチ電極間に発生する容量の減少を検出して判断します。よって、図4.20に示す通り計測データは、減少します。

図4.20 相互容量計測データ変化

基準値：g_self_ref[]

タッチ/非タッチ判断しきい値：g_self_thr[]

計測データ：value タッチ非タッチ

4.9.10

touch_drift_correction touch_drift_correction()

概要タッチドリフト補正処理

宣言

uint8_t touch_drift_correction( method, value, group, offset )

説明この関数は、g_touch_drift_freq[]に設定した回数分の計測データを元に基準値の補正を行います。

＜ドリフト補正停止条件＞

・タッチと判断された場合（タッチに該当するキーのみ停止）

・スライダとホイールは、ドリフト補正対象外

コール関数 -

引数 uint8_t method 計測方式番号

uint16_t value 計測データ

uint8_t group タッチセンサグループ

uint8_t offset タッチセンサ番号オフセット

リターン値 uint8_t status … DRIFT_OFF(0), DRIFT_ON(1)

4.9.11

touch_key_function_check touch_key_function_check()

概要タッチキー機能有効/無効確認処理

宣言

uint8_t touch_key_function_check( method, loop )

説明この関数は、タッチセンサ（TS）が、キー機能に割り当たっているか確認します。

説明この関数は、CTSUレジスタ初期値をg_ctsu_parameteｒ[]へ設定します。

＜設定されるレジスタ値＞

・CTSU 制御レジスタ0（CTSUCR0）

・CTSU 制御レジスタ1（CTSUCR1）

・CTSU 同期ノイズ低減設定レジスタ（CTSUSDPRS）

・CTSU センサ安定待ち時間レジスタ（CTSUSST）

・CTSU 計測チャネルレジスタ0（CTSUMCH0）

・CTSU チャネル有効制御レジスタ0-1（CTSUCHAC0-1）

・CTSU チャネル送受信制御レジスタ0-1（CTSUCHTRC0-1）

・CTSU 高域ノイズ低減制御レジスタ（CTSUDCLKC）

コール関数 -

引数 - -

リターン値 -

4.9.15

DTC_transmit_data_set DTC_transmit_data_set()

概要 DTC転送用、CTSU計測レジスタ値設定宣言

void DTC_transmit_data_set(void)

説明この関数は、DTC転送用の各タッチセンサ計測用レジスタ値を転送バッファへ格納します。

＜転送用格納バッファ＞

g_dtc_write_data[]

＜転送用CTSUレジスタ値＞

・CTSU 高域ノイズ低減スペクトラム拡散制御レジスタ（CTSUSSC）

・CTSU センサオフセットレジスタ0（CTSUSO0）

・CTSU センサオフセットレジスタ1（CTSUSO1）

コール関数 -

引数 - -

リターン値 -

4.9.16

R_Set_CTSU_All_Register R_Set_CTSU_All_Register()

概要 CTSUレジスタ設定関数制御

宣言

void R_Set_CTSU_All_Register( method )

説明この関数は、CTSUレジスタ設定関数を呼び出します。

コール関数 R_Set_CTSU_Module_Operation() R_Set_CTSU_Power_Supply()

R_Set_CTSU_Power_Operation_Mode() R_Set_CTSU_Power_Capacity_Adjustment() R_Set_CTSU_Operation_Clock()

R_Set_CTSU_Measurement_Mode()

R_Set_CTSU_Synchronous_Noise_Reduction() R_Set_CTSU_Sensor_Stabilization_Wait_Time() R_Set_CTSU_Measurement_Channel()

R_Set_CTSU_Channel_Enable0() R_Set_CTSU_Channel_Enable1() R_Set_CTSU_Channel_Enable2()

R_Set_CTSU_Channel_Transmit_Receive0() R_Set_CTSU_Channel_Transmit_Receive1() R_Set_CTSU_Channel_Transmit_Receive2() R_Set_CTSU_High_Pass_Noise_Reduction() 引数 uint8_t method 計測方式番号リターン値 -

4.9.17

R_Set_CTSU_Module_Operation R_Set_CTSU_Module_Operation()

概要 CTSUモジュール電源供給設定

宣言

uint8_t R_Set_CTSU_Module_Operation( mode )

説明この関数は、CTSUモジュールに電源供給するための設定を行います。

コール関数 -

引数 uint8_t mode CTSUモジュール電源供給設定値リターン値 uint8_t status … SET_SUCCESS(0), SET_ERROR(1)

4.9.18

R_Set_CTSU_Power_Supply R_Set_CTSU_Power_Supply()

概要 CTSU電源供給許可ビットとCTSU LPF容量充電制御ビット同時設定宣言

uint8_t R_Set_CTSU_Power_Supply( power )

説明この関数は、CTSU電源供給許可ビットとCTSU LPF容量充電制御ビットを同時に設定します。

・CTSU基本周期、基本パルス数設定ビット

・CTSU高域ノイズ低減機能OFF設定ビット

コール関数 -

引数 uint8_t cycle CTSU計測時間、計測パルス数調整ビット設定値

説明この関数は、CTSU チャネル送受信制御レジスタ0-1設定を行います。

コール関数 -

引数 uint8_t channel 下位8ビット：CTSU チャネル送受信制御レジスタ0設定値

上位8ビット：CTSU チャネル送受信制御レジスタ1設定値

リターン値 uint8_t status … SET_SUCCESS(0), SET_ERROR(1)

4.9.28

R_Set_CTSU_High_Pass_Noise_Reduction R_Set_CTSU_High_Pass_Noise_Reduction()

概要 CTSU 高域ノイズ低減制御レジスタ設定

宣言

uint8_t R_Set_CTSU_High_Pass_Noise_Reduction( mode, clock )

説明この関数は、CTSU 高域ノイズ低減制御レジスタ設定を行います。

コール関数 -

引数 uint8_t mode CTSU拡散クロックモード選択ビット設定値

uint8_t clock CTSU拡散クロック制御ビット設定値

リターン値 uint8_t status … SET_SUCCESS(0), SET_ERROR(1)

ドキュメント内 RX113グループ　アプリケーションノート　CTSU 相互容量方式タッチ計測 (ページ 32-47)