Holtek HT32 MCU タッチ キー ライブラリ
導入
Best Solution が開発した HT32 タッチ キー ライブラリは、すべてのタッチ キーの基礎となるドライバー ライブラリを MCU に統合するライブラリです。 file秒。 このライブラリは、タッチ関連の MCU ハードウェアを事前構成しており、キー検出や省電力スリープ モードなどの一般的な機能を統合しながら、直感的で柔軟なタッチ キー感度設定を提供します。 HT32 タッチ キー ライブラリを使用すると、MCU タッチ機能の使用が簡素化されるため、ユーザーはすぐに使い始めることができ、開発期間を短縮できます。 このドキュメントでは、環境構成とライブラリの使用方法について詳しく説明します。
環境設定
HT32 タッチ キー ライブラリを入手する
Best Solution の FAE に連絡するか、その FAE を参照してください。 webサイト： http://www.bestsolution.com.tw/EN/
または、Holtek からライブラリをダウンロードします。 webサイト： https://www.holtek.com
HT32 ファームウェア ライブラリの入手
ファームウェア ライブラリをすばやく入手するには、次のリンクを参照してください。 https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
リンクを開き、図 1 に示すように [ドキュメント] オプションを選択します。赤いボックスは HT32 圧縮ファイルの場所を示しています。 file秒。 バージョン v022 以降のファームウェア ライブラリのみが HT32 タッチ キー ライブラリをサポートすることに注意してください。
Keil プロジェクトの構成
- ユーザーの PC には、Keil 開発ツールがインストールされている必要があります。
- ファームウェア ライブラリを解凍します。 の fileHoltek.HT2_DFP.latest をクリックしてインストールすると、図 32 のようなインストール完了画面が表示されます。
- 32 つのフォルダーを含む HTXNUMX タッチ キー ライブラリを解凍します。ampファイルとライブラリ。
- 元をコピーampファイルおよびライブラリ フォルダーを HT32_STD_xxxxx_FWLib_v022_XXXX フォルダーにコピーします。
- 実行..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (図 6)。
- 図 7 に示すようなインターフェイスが表示されます。 ユーザーの IDE に対応する番号を入力すると、図 8 に示すように、選択した IDE の前に「*」記号が表示されます。「N」を入力して次のステップに進みます。
- 以下に示すように、「*」を入力してすべての IC タイプのプロジェクトを作成するか、IC 名を入力して選択した IC のプロジェクトを作成します。
- 手順 1 ～ 7 が完了したら、図 11 に示すように、..\ex から Project_54xxx.uvprojx などの目的の IC プロジェクトを選択します。ample\TouchKey\TouchKey_LIB\MDK_ARMv5\ パス。
注記 各シリーズで最大のリソースを持つ MCU のみがプロジェクトの作成に使用されます。 例えばampHT32F54231 を使用するには、HT32F54241 プロジェクトを選択する必要があります。
考慮事項
タッチキー プログラムがスリープ状態になる可能性があるため、プロジェクトをパワーオン リセットに設定する必要があります。そうしないと、プログラミングに使用できなくなります。 設定手順は以下の通りです。
- ステップ1: 以下に示すように、Keil5 ツール メニューの ボタンをクリックします。
- ステップ2: [デバッグ] > [設定] を選択します。
- ステップ3: 接続フィールドで「リセット中」を選択します。
図書館 File説明
図書館利用資源
| キール プロジェクト | 使用可能なIC | ROM/RAM リソース | 使用済み IP | 最大。 キーの数 |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | タッチキー
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | タッチキー BFTM0
RTCC の |
28 |
- RTC は MCU をスリープ状態からウェイクアップするために使用され、スリープ状態処理のタイム ベースとして使用されます。
- プログラムが IC にロードされると、Keil は ROM または RAM のサイズを超えているかどうかを判断します。
- リソースの具体的な使用方法については、実際のライブラリ バージョンを参照してください。
環境と File 説明
HT32 タッチ キー ライブラリは、次のパスにあります。 ..\元ample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx プロジェクト (図 15)。 HT32 タッチ キー ライブラリ プロジェクトを開くと、メイン画面が図 16 のように表示されます。
関連する files は次のように記述されています。その中には、ht32_TouchKey_conf.h と system_ht32f5xxxx_09.c があります。 file構成ウィザードに含まれています。 図 17 を参照してください。
| File 名前 | 説明 |
| main.c | プロジェクトの主なプログラム file |
| ht32f5xxxx_01_it.c | 割り込みメインプログラム file |
| ht32_TouchKey_Lib_Mx_Keil.lib | タッチコントロールライブラリ file |
| *ht32_TouchKey_conf.h | タッチ制御パラメータ file |
| ht32_タッチキー.h | 外部宣言定義 file |
| ht32_TouchKey_BSconf.h | 基礎となる主なパラメータ file (変更はお勧めしません) |
| ht32_board_config.h | ハードウェア定義 file (変更はお勧めしません) |
| *system_ht32f5xxxx_09.c | クロック ソースとシステム クロック パラメータ file |
構成ウィザードのパラメータ
- ht32_TouchKey_conf.h 構成ウィザードのパラメーター:
名前 関数 パワーセーブ main.c で定義されているデフォルトのスリープ プロシージャをアクティブにします。 TKL_高感度 タッチ感度設定：高感度または低感度。 有効にすると、デフォルトで高感度に設定されます TKL_keyデバウンス キーデバウンス時間設定 TKL_RefCalTime 校正時間。 時間が短いほど、環境の干渉に抵抗する効果が高くなりますが、キーの感度が低下します。 TKL_MaxOnHoldTime キーが押される最大時間。 キーは n 秒間押した後、自動的に離されます。 KEYn_EN KEYn を有効または無効にする キーのしきい値 KEYn しきい値。 値が小さいほど、キーの感度が高くなります。 - system_ht32f5xxxx_09.c 構成ウィザードのパラメーター:
名前 関数 高速外部水晶発振器を有効にする – HSE HSE (外部高速発振器) を有効または無効にします 低速外部水晶発振器を有効にする – LSE LSE (外部低速発振器) を有効または無効にします。 PLL を有効にする PLL を有効または無効にする PLL クロック ソース PLL のクロック ソースの選択 システムコアクロック構成 (CK_AHB) システムCK_AHBのクロックソースを選択
Touch Key Lib インターフェイス関数の説明
取得関数の説明
| アイテム | 説明 |
| 関数名 | TKL_Get_Standby |
| 入力パラメータ | — |
| 戻り値 | カウント値 (500~60000) |
| 説明 | カウントダウンカウンタ値の取得に使用 |
| アイテム | 説明 |
| 関数名 | TKL_Get_KeyRCCValue |
| 入力パラメータ | キー値(0～最大キー値)、頻度(0、1) |
| 戻り値 | 静電容量値 (0~1023) |
| 説明 | 指定されたキーの静電容量値を取得するために使用されます |
| アイテム | 説明 |
| 関数名 | TKL_GetKeyRef |
| 入力パラメータ | キー値 (0 ~ 最大キー値) |
| 戻り値 | 基準値 (0~65535) |
| 説明 | 指定したキーの参照値を取得するために使用されます |
| アイテム | 説明 |
| 関数名 | TKL_GetKeyThreshold |
| 入力パラメータ | キー値 (0 ~ 最大キー値) |
| 戻り値 | しきい値 (0~255) |
| 説明 | 指定されたキーのしきい値を取得するために使用されます |
| アイテム | 説明 |
| 関数名 | TKL_Get_AllKeyState |
| 入力パラメータ | — |
| 戻り値 | 鍵の状態 (32 ビット)
BITn は KEYn 状態を表します Bit0 = 1 は KEY0 が押されたことを意味し、Bit0 = 0 は KEY0 が押されていないことを意味します |
| 説明 | すべての主要な状態を取得するために使用されます |
セット機能の説明
| アイテム | 説明 |
| 関数名 | TKL_Set_KeyThreshold |
| 入力パラメータ | キー値(0～最大キー値)、閾値(10～127) |
| 戻り値 | — |
| 説明 | 指定されたキーのしきい値を設定するために使用されます |
| アイテム | 説明 |
| 関数名 | TKL_セット_スタンバイ |
| 入力パラメータ | 睡眠時間 (500~60000) |
| 戻り値 | — |
| 説明 | カウントダウンカウンターの設定に使用（この機能の使用は推奨されません） |
状態とコマンド機能の説明
| アイテム | 説明 |
| 関数名 | TKL_Is_Time |
| 入力パラメータ | プリセット定数 (kT2mS、kT4mS…kT2048mS) |
| 戻り値 | — |
| 説明 | ユーザー参照用の時間フラグ。
次の例ではample、プログラムは 2ms ごとに関数に入ります。 |
| アイテム | 説明 |
| 関数名 | TKL_Is_AnyKeyPress |
| 入力パラメータ | — |
| 戻り値 | 1 = 0 つ以上のキーがトリガーされました。 XNUMX = キーはトリガーされていません |
| 説明 | キー押下フラグの取得に使用 |
| アイテム | 説明 |
| 関数名 | TKL_Is_KeyPress |
| 入力パラメータ | キー値 (0 ~ 最大キー値) |
| 戻り値 | 1 = キーがトリガーされました。 0 = キーはトリガーされていません |
| 説明 | 指定されたキーの状態フラグを取得するために使用されます |
| アイテム | 説明 |
| 関数名 | TKL_Is_Active |
| 入力パラメータ | — |
| 戻り値 | 1 = LIB の初期化が完了しました。 0 = LIB の初期化が完了していない |
| 説明 | LIB初期化状態フラグの取得に使用 |
| アイテム | 説明 |
| 関数名 | TKL_Is_スタンバイ |
| 入力パラメータ | — |
| 戻り値 | 1 = スリープ状態への移行を許可。 0 = スリープ状態への移行を許可しない |
| 説明 | スリープ状態フラグを取得するために使用されます。
※値 0 を返した場合、スリープ状態になると予期せぬ状態になる場合があります。 |
| アイテム | 説明 |
| 関数名 | TKL_Is_KeyScanCycle |
| 入力パラメータ | — |
| 戻り値 | 1 = スキャンが終了しました。 0 = 現在スキャン中 |
| 説明 | スキャンフラグの取得に使用 |
| アイテム | 説明 |
| 関数名 | TKL_リセット |
| 入力パラメータ | — |
| 戻り値 | — |
| 説明 | LIB に強制的にリセット アクションを実行させるために使用されます。
※LIBやRAMで使用するフラグは初期化されます。 ※パラメータ、AFIOは除きます。 |
タッチキー ライブラリの初期化関数の説明
これらの関数は main.c にあります。 それらの内容を変更することはお勧めしません。
| 名前 | 関数 |
| GPIO_Configuration() | I/O ポート構成 |
| RTC_構成() | タッチキーは RTC によって起動されます |
| BFTM_構成() | タッチキー ライブラリのタイム ベースは BFTM によって実装されます |
| TKL_構成() | タッチキー構成 |
キー状態クエリ
以下に示すように、メインプログラムにはタッチキーexが含まれていますampデフォルトではアクティブ化されないファイル。 この機能を有効にするには、#if の後の (0) を (1) に変更します。
スリープモードの説明
- ht32_TouchKey_conf.h で、PowerSave を選択してスリープ モードを有効にします。
- スリープ モードが有効になった後、キーが一定時間タッチ状態にならない場合、タッチ キーはスリープ状態になります。
- ダウンカウントには待機時間カウント関数を使用し、TKL_Get_Standby で現在時刻を取得し、TKL_Set_Standby で時刻パラメータを設定します。
- XNUMX つのスリープ モード オプションがあります。
モード 説明 USE_SLEEP_MODE スリープモードに入る USE_DEEP_SLEEP1_MODE Deep Sleep1 モードに入る USE_DEEP_SLEEP2_MODE Deep Sleep2 モードに入る - 以下に示すように、メインの「#define」を使用して必要なスリープ モードを設定します。 file.
結論
このドキュメントは、HT32 タッチ キー開発環境全体をセットアップするための手順を提供し、ユーザーがすぐに開始できるように支援します。 また、ライブラリが使用するリソースや各種関数、パラメータについても詳しく解説しており、開発がしやすくなっています。
参考資料
詳細については、ホルテックを参照してください。 webサイト： www.holtek.com またはベストソリューションにご相談ください webサイト： http://www.bestsolution.com.tw/EN/
バージョンと変更情報:
| 日付 | 著者 | リリース | 説明 |
| 2022.03.16 | 谢东霖、梁德浩 | バージョン1.00 | 最初のバージョン |
免責事項
ここに表示されるすべての情報、商標、ロゴ、グラフィック、ビデオ、オーディオ クリップ、リンク、およびその他のアイテム webサイト (「情報」) は参考用であり、事前の通知なく、Holtek Semiconductor Inc. およびその関連会社 (以下「Holtek」、「会社」、「私たち」、「私たち」または「私たちの」）。 Holtek は、これに関する情報の正確性を確保するよう努めていますが、 webHoltek は、情報の正確性について、明示または黙示を問わず、いかなる保証も行いません。 Holtek は、誤りや漏洩について一切の責任を負いません。
Holtek は、本製品の使用または使用に関連して発生したいかなる損害 (コンピュータ ウイルス、システムの問題、またはデータの損失を含むがこれらに限定されない) についても責任を負いません。 web任意の当事者によるサイト。 このエリアにリンクがある場合があります。 web他社のサイト。 これらは webサイトは Holtek によって管理されていません。 Holtek は、そのようなサイトに表示されるいかなる情報に対しても責任を負うものではなく、保証するものでもありません。 その他へのハイパーリンク webサイトは自己責任です。
責任の制限
いかなる場合も、Holtek Limited は、お客様による本書へのアクセスまたは使用に関連して直接的または間接的に生じたいかなる損失または損害についても、他の当事者に対して責任を負わないものとします。 webサイト、そのコンテンツ、または商品、資料、またはサービス。
準拠法
に含まれる免責事項 webサイトは、中華民国の法律に準拠し、解釈されるものとします。 ユーザーは、中華民国の裁判所の非専属管轄権に服するものとします。
免責事項の更新
Holtek は、事前の通知の有無にかかわらず、いつでも免責事項を更新する権利を留保します。すべての変更は、 webサイト。
ドキュメント / リソース
 |
Holtek HT32 MCU タッチ キー ライブラリ [pdf] ユーザーガイド HT32、MCU タッチキー ライブラリ、HT32 MCU タッチ キー ライブラリ |
