Rev.1.1 S1V50300 サンプルプログラムマニュアル

Transcription

1 Rev.1.1 S1V50300 サンプルプログラムマニュアル

2 本資料のご使用につきましては 次の点にご留意願います 本資料の内容については 予告無く変更することがあります 1. 本資料の一部 または全部を弊社に無断で転載 または 複製など他の目的に使用することは堅くお断りいたします 2. 本資料に掲載される応用回路 プログラム 使用方法等はあくまでも参考情報であり これらに起因する第三者の知的財産権およびその他の権利侵害あるいは損害の発生に対し 弊社はいかなる保証を行うものではありません また 本資料によって第三者または弊社の知的財産権およびその他の権利の実施権の許諾を行うものではありません 3. 特性値の数値の大小は 数直線上の大小関係で表しています 4. 製品および弊社が提供する技術を輸出等するにあたっては 外国為替および外国貿易法 を遵守し 当該法令の定める手続きが必要です 大量破壊兵器の開発等およびその他の軍事用途に使用する目的をもって製品および弊社が提供する技術を費消 再販売または輸出等しないでください 5. 本資料に掲載されている製品は 生命維持装置その他 きわめて高い信頼性が要求される用途を前提としていません よって 弊社は本 ( 当該 ) 製品をこれらの用途に用いた場合のいかなる責任についても負いかねます 6. 本資料に掲載されている会社名 商品名は 各社の商標または登録商標です SEIKO EPSON CORPORATION , All rights reserved.

3 目次 1. 概要 ファイル構成 ファイル一覧 メインプログラムファイル (main_sample.c) メッセージプロトコル制御関数定義ファイル (asr_api.c) シリアルインターフェース制御関数定義ファイル (spi_api.c or uart_api.c) ダイアログ定義ファイル (dialog.c) シナリオライブラリ定義ファイル (scenario_lib.c) 初期化データ定義ファイル (init_data x_x_x x_x.c) API 関数呼び出しフロー S1V50300 の起動及び初期化 シナリオの実行 メインプログラムファイル仕様 (main_sample.c) クロック同期式シリアルインタフェース 調歩同期式シリアルインターフェース API 関数仕様 メッセージプロトコル制御関数 ASRSetUartConfiguration ASRLoadInitData ASRExitBootMode ASRSetKeycode ASRGetVersion ASRSetAdcVolume ASRSetDacVolume ASRStartDialogue ASRGetPromptFinished ASRGetRecognitionFinished ASRStopDialogue ASRTransferAudioStream シリアルインターフェース制御関数 ( クロック同期式 ) SPIInitialize SPISendMessage SPIReceiveMessage SPISendByte S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation i

4 5.2.5 SPIReceiveByte シリアルインターフェース制御関数 ( 調歩同期式 ) UARTInitialize UARTSendMessage UARTReceiveMessage UARTSendByte UARTReceiveByte その他の関数 ASRGetRecognitionWord ASRGetFileAddress 構造体 PROMPT_T 構造体 FILE_ELEMENT_T 構造体 RECOGNITION_T 構造体 DIALOGUE_T 構造体 FILE_ADDRESS_T 構造体 音声対話シナリオ ( サンプル ) ISC_RECOGNITION_FIN_INDメッセージ ii Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

5 1. 概要 1. 概要 本ドキュメントは EPSON 音声認識 LSI(S1V50300) を使用されるお客様に提供するサンプルプログラムについて説明しています サンプルプログラムのファイル構成やサンプルプログラムで使用される API 関数の仕様について記述しています 本ドキュメントは 別紙の S1V50300 メッセージプロトコルマニュアル を引用している箇所があります S1V50300 メッセージプロトコルマニュアル と併せて参照ください S1V50300 サンプルプログラムは S1V50300 の評価で使用した弊社のホストシステムに実装して動作確認を行っていますが お客様のホストシステムに搭載する上での動作を保証するものではありません S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 1

6 2. ファイル構成 2. ファイル構成 2.1 ファイル一覧 表 2.1 に サンプルプログラムに含まれるファイルの一覧を示します main_sample.c asr_api.c asr_api.h ファイル名 表 2.1 ファイル一覧 メインプログラムファイル 説明 メッセージプロトコル制御関数定義ファイル 上記ソースファイルのヘッダファイル spi_api.c シリアルインターフェース制御関数定義ファイル ( クロック同期式 ) spi_api.h 上記ソースファイルのヘッダファイル uart_api.c シリアルインターフェース制御関数定義ファイル ( 調歩同期式 ) uart_api.h isc_asr_msg.h 上記ソースファイルのヘッダファイル メッセージ ID& メッセージ長定義ヘッダファイル dialog.c ダイアログ定義ファイル ( サンプル ) dialog.h 上記ソースファイルのヘッダファイル scenario_lib.c ホスト CPU メモリ格納用シナリオライブラリ定義ファイル ( サンプル ) scenario_lib.h init_data x_x_x x_x.c 上記ソースファイルのヘッダファイル 初期化データ定義ファイル x_x_x x_x はバージョン番号を示す 2.2 メインプログラムファイル (main_sample.c) 本ファイルは 本サンプルプログラムの main 関数を定義したソースファイルです 音声再生と音声認識を使用して音声対話インタフェースを実行するための一連のシーケンスが記述されています 2.3 メッセージプロトコル制御関数定義ファイル (asr_api.c) 本ファイルは S1V50300 メッセージプロトコルマニュアルに記載されるメッセージ仕様に基づいて S1V50300 の制御を行う API 関数を定義したソースファイルです 2.4 シリアルインターフェース制御関数定義ファイル (spi_api.c or uart_api.c) 本ファイルは ホスト CPU と S1V50300 とのシリアル通信を制御する API 関数を定義したソースファイルです シリアルインタフェースの種類に応じた個別のファイルとして用意しています お客様が使用されるインタフェースに合わせてファイルを選択してご使用ください 本ファイルは 弊社で評価用に使用したホスト CPU とのシリアルインターフェース接続を例にした制御プログラムです お客様のシステムに組み込む際は お客様のシステム仕様に合わせて変更してください 2.5 ダイアログ定義ファイル (dialog.c) 本ファイルは 音声対話インタフェースを実現するためのダイアログ情報を定義したソースファイルです サンプルとして簡単な音声対話シナリオのダイアログ情報が記述されています お客様作成の音声対話シナリオで動作させる場合は 本ファイルの内容を書き換えてご使用ください 音声対話シナリオの内容については 7. 音声対話シナリオ ( サンプル ) を参照ください 2 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

7 2. ファイル構成 2.6 シナリオライブラリ定義ファイル (scenario_lib.c) 本ファイルは ホスト CPU メモリ格納用シナリオライブラリを ASCII コードによるデータ列として定義したソースファイルです ホスト CPU 側のメモリにシナリオライブラリを格納して 音声ファイルや LM ファイルをホスト CPU から S1V50300 にストリーミング転送して動作させる場合に使用します 既に サンプル音声対話シナリオのシナリオライブラリが記述されています お客様作成の音声対話シナリオで動作させる場合は 本ファイルの内容をお客様のシナリオライブラリに書き換えてご使用ください 2.7 初期化データ定義ファイル (init_data x_x_x x_x.c) S1V50300 の起動直後にホストから転送する初期化データを ASCII コードによるデータ列として定義したソースファイルです 初期化データは S1V50300 起動後 必ずホストから S1V50300 に転送する必要があります 本データを転送しない場合 動作保証の範囲外となりますのでご注意ください S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 3

8 3. API 関数呼び出しフロー 3. API 関数呼び出しフロー 3.1 S1V50300 の起動及び初期化 S1V50300 の起動から初期化までの API 関数の呼び出しフローについて示します シリアルインタフェースとしてクロック同期式を選択した場合は図 3.1 調歩同期式を選択した場合は図 3.2 を参照してください Start シリアル I/F の初期化 (SPIInitialize) ハードウェアリセット 待機時間 160ms CNF[2:0] 端子 0x6 0x3 初期化データの転送あり? Yes No 初期化データのロード (ASRLoadInitData) ブートモード すべてのデータを転送終了? No キーコード タイムアウトの設定 (ASRSetKeycode) Yes メインモードに移行 (ASRExitBootMode) 音声出力ゲインの設定 (ASRSetDacVolume) メインモード 待機時間 20ms 音声入力ゲインの設定 (ASRSetAdcVolume) 3.2 節の図 3.3 or 3.4 に続く 図 3.1 起動および初期化時の API 関数呼び出しフロー ( クロック同期式インタフェース ) 4 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

9 3. API 関数呼び出しフロー Start シリアル I/F の初期化 (UARTInitialize) ハードウェアリセット 待機時間 160ms CNF[2:0] 端子 0x6 0x5 S1V50300 の通信条件変更 (ASRSetUartConfigration) ホスト CPU の通信条件変更 (UARTInitialize) 待機時間 10ms ブートモード 初期化データの転送あり? Yes 初期化データのロード (ASRLoadInitData) No すべてのデータを転送終了? Yes No メインモードに移行 (ASRExitBootMode) キーコード タイムアウトの設定 (ASRSetKeycode) 待機時間 20ms 音声出力ゲインの設定 (ASRSetDacVolume) 音声入力ゲインの設定 (ASRSetAdcVolume) メインモード 3.2 節の図 3.3 or 3.4 に続く 図 3.2 起動および初期化時の API 関数呼び出しフロー ( 調歩同期式インタフェース ) S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 5

10 3. API 関数呼び出しフロー 3.2 シナリオの実行 シナリオの実行開始から終了までの API 関数の呼び出しフローについて示します シナリオライブラリの格納先が内蔵 Mask ROM または外部シリアル Flash メモリの場合は図 3.3 を シナリオライブラリの格納先がホスト CPU の場合は図 3.4 を参照してください 図 3.1 及び図 3.2 からの続き キーコード タイムアウトの設定 (ASRSetKeycode) ダイアログを実行 (ASRStartDialogue) ダイアログに音声ガイド情報が含まれる? No Yes RTS 信号 音声再生終了通知を取得 (ASRGetPromptFinished) ダイアログに音声認識情報が含まれる? No Yes RTS 信号 音声認識終了通知を取得 (ASRGetRecognitionFinished) 認識結果の文字列 番号を取得 (ASRGetRecognitionWord) 次のダイアログを実行する? No Yes End 図 3.3 ダイアログ実行時の API 関数呼び出しフロー ( シナリオライブラリ格納先 : 内蔵 Mask ROM または外部シリアル Flash メモリ ) 6 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

11 3. API 関数呼び出しフロー 図 3.1 及び図 3.2 からの続き キーコード タイムアウトの設定 (ASRSetKeycode) ダイアログを実行 (ASRStartDialogue) ダイアログに音声ガイド情報が含まれる? No Yes RTS 信号 音声データをストリーミング転送 (ASRTransferAudioStream) すべてのデータを転送終了? No Yes RTS 信号 音声再生終了通知を取得 (ASRGetPromptFinished) ダイアログに音声認識情報が含まれる? Yes No RTS 信号 音声認識終了通知を取得 (ASRGetRecognitionFinished) 認識結果の文字列 番号を取得 (ASRGetRecognitionWord) 次のダイアログを実行する? No Yes End 図 3.4 ダイアログ実行時の API 関数呼び出しフロー ( シナリオライブラリ格納先 : ホスト CPU 側のメモリ ) S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 7

12 4. メインプログラムファイル仕様 (main_sample.c) 4. メインプログラムファイル仕様 (main_sample.c) メインプログラムファイルは音声対話を実行するための一連のプログラムが記述されており S1V50300 の起動から初期化 音声再生 音声認識による音声対話の実行までの一連の処理を行っています 本プログラムは クロック同期式および調歩同期式の両方のシリアルインタフェースの対応しています 本プログラムのファイルの先頭でプリプロセッサ定義により クロック同期式または調歩同期式のいずれかのシリアルインタフェースを設定して使用してください 4.1 クロック同期式シリアルインタフェース プリプロセッサ定義でクロック同期式シリアルインターフェースを選択した場合のサンプルプログラムの処理の流れについて示します (1) ホスト CPU 搭載のシリアルインターフェースの初期化を行う (SPIInitialize 関数の実行 ) (2) S1V50300 にハードウェアリセットをかける (3) S1V50300 のメッセージ受信可能状態になるまで 160ms 待機する - CNF[2:0] 端子が 0x3 の場合は (4) の処理へ - CNF[2:0] 端子が 0x6 の場合は (7) の処理へ < ブートモード起動 > (4) 初期化データを S1V50300 にロードする (ASRLoadInitData 関数の実行 ) (5) ブートモードからメインモードへ移行する (ASRExitBootMode 関数の実行 ) (6) S1V50300 の動作モード移行待ち時間として 20ms 待機する < メインモード起動 > (7) キーコードおよび音声認識タイムアウト時間の設定を行う (ASRSetKeycode 関数の実行 ) (8) 音声出力ゲインの設定を行う (ASRSetDacVolume 関数の実行 ) (9) 音声入力ゲインの設定を行う (ASRSetAdcVolume 関数の実行 ) - シナリオライブラリの格納先が内蔵 Mask ROM または外部シリアル Flash メモリの場合は (10) の処理へ - シナリオライブラリの格納先がホスト CPU の場合は (15) の処理へ 8 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

13 4. メインプログラムファイル仕様 (main_sample.c) (10) ダイアログ単位で音声認識タイムアウト時間を変更する場合 再度 設定を行う (ASRSetKeycode 関数の実行 ) (11) ダイアログ情報を S1V50300 に送信し ダイアログを実行する (ASRStartDialogue 関数の実行 ) (12) ダイアログ情報に音声ガイド情報が含まれている場合 S1V50300 から音声再生終了メッセージが通知されるまで待機する (ASRGetPromptFinished 関数の実行 ) (13) ダイアログ情報に音声認識情報が含まれている場合 S1V50300 から音声認識終了メッセージが通知されるまで待機する (ASRGetRecognitionFinished 関数の実行 ) (14) ダイアログ情報に音声認識情報が含まれている場合 音声認識終了メッセージから認識ワードの文字列およびインデックス番号を取得する (ASRGetRecognitionFinished 関数の実行 ) - 次に実行するダイアログがある場合は (10) の処理へ - 次に実行するダイアログがない場合は (25) の処理へ (15) ダイアログ単位で音声認識タイムアウト時間を変更する場合 再度 設定を行う (ASRSetKeycode 関数の実行 ) (16) ダイアログ情報に音声認識情報が含まれている場合 ホスト CPU に格納されたシナリオライブラリにアクセスして LM ファイルの読み込みを行う (ASRGetFileAddress 関数の実行 ) 更に 取得した LM ファイルをダイアログ情報に設定する (17) ダイアログ情報を S1V50300 に送信し ダイアログを実行する (ASRStartDialogue 関数の実行 ) (18) ダイアログ情報に音声ガイド情報が含まれている場合 ホスト CPU に格納されたシナリオライブラリにアクセスして EOV ファイルの読み込みを行う (GetFileAddress 関数の実行 ) (19) ダイアログ情報に音声ガイド情報が含まれている場合 EOV ファイルを S1V50300 にストリーミング転送する ストリーミング転送は ファイルサイズに応じてブロック単位で行い ファイルの終端に達するまで繰り返し行う (ASRTransferAudioStream 関数の実行 ) (20) (19) の処理で EOV ファイルのストリーミング転送終了後 S1V50300 に転送終了通知を送信する (ASRTransferAudioStream 関数の実行 ) (21) (18) (19) (20) の処理をダイアログ情報に設定されている EOV ファイルの数だけ繰り返し行う (22) ダイアログ情報に音声ガイド情報が含まれている場合 S1V50300 から音声再生終了メッセージが通知されるまで待機する S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 9

14 4. メインプログラムファイル仕様 (main_sample.c) (ASRGetPromptFinished 関数の実行 ) (23) ダイアログ情報に音声認識情報が含まれている場合 S1V50300 から音声認識終了メッセージが通知されるまで待機する (ASRGetRecognitionFinished 関数の実行 ) (24) ダイアログ情報に音声認識情報が含まれている場合 音声認識終了メッセージから認識ワードの文字列およびインデックス番号を取得する - 次に実行するダイアログがある場合は (15) の処理へ - 次に実行するダイアログがない場合は (25) の処理へ (25) プログラムを終了する 10 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

15 4. メインプログラムファイル仕様 (main_sample.c) 4.2 調歩同期式シリアルインターフェース プリプロセッサ定義で調歩同期式シリアルインターフェースを選択した場合のシナリオ制御プログラムの処理の流れについて説明します (1) ホスト CPU 搭載のシリアルインターフェースの初期化を行う (UARTInitialize 関数の実行 ) (2) S1V50300 にハードウェアリセットをかける (3) S1V50300 のメッセージ受信可能状態になるまで 160ms 待機する - CNF[2:0] 端子が 0x3 の場合は (4) の処理へ - CNF[2:0] 端子が 0x6 の場合は (10) の処理へ < ブートモード起動 > (4) S1V50300 に通信条件 ( ボーレート 転送モード ) の設定変更を通知する (ASRSetUartConfiguration 関数の実行 ) (5) ホスト CPU の通信条件の設定を変更する (UARTInitialize 関数の実行 ) (6) S1V50300 の通信条件の設定変更が有効になるまで 10ms 待機する (7) S1V50300 に初期化データをロードする (ASRLoadInitData 関数の実行 ) (8) ブートモードからメインモードへ移行する (ASRExitBootMode 関数の実行 ) (9) S1V50300 の動作モード移行待ち時間として 20ms 待機する < メインモード起動 > (10) キーコードおよび音声認識タイムアウト時間の設定を行う (ASRSetKeycode 関数の実行 ) (11) 音声出力ゲインの設定を行う (ASRSetDacVolume 関数の実行 ) (12) 音声入力ゲインの設定を行う (ASRSetAdcVolume 関数の実行 ) - シナリオライブラリの格納先が内蔵 Mask ROM または外部シリアル Flash メモリの場合は (13) の処理へ - シナリオライブラリの格納先がホスト CPU の場合は (18) の処理へ (13) ダイアログ単位で音声認識タイムアウト時間を変更する場合 再度 設定を行う (ASRSetKeycode 関数の実行 ) (14) ダイアログ情報を S1V50300 に送信し ダイアログを実行する S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 11

16 4. メインプログラムファイル仕様 (main_sample.c) (ASRStartDialogue 関数の実行 ) (15) ダイアログ情報に音声ガイド情報が含まれている場合 S1V50300 から音声再生終了メッセージが通知されるまで待機する (ASRGetPromptFinished 関数の実行 ) (16) ダイアログ情報に音声認識情報が含まれている場合 S1V50300 から音声認識終了メッセージが通知されるまで待機する (ASRGetRecognitionFinished 関数の実行 ) (17) ダイアログ情報に音声認識情報が含まれている場合 音声認識終了メッセージから認識ワードの文字列およびインデックス番号を取得する - 次に実行するダイアログがある場合は (13) の処理へ - 次に実行するダイアログがない場合は (28) の処理へ (18) ダイアログ単位で音声認識タイムアウト時間を変更する場合 再度 設定を行う (ASRSetKeycode 関数の実行 ) (19) ダイアログ情報に音声認識情報が含まれている場合 ホスト CPU に格納されたシナリオライブラリにアクセスして LM ファイルの読み込みを行う (ASRGetFileAddress 関数の実行 ) 更に 取得した LM ファイルをダイアログ情報に設定する (20) ダイアログ情報を S1V50300 に送信し ダイアログを実行する (ASRStartDialogue 関数の実行 ) (21) ダイアログ情報に音声ガイド情報が含まれている場合 ホスト CPU に格納されたシナリオライブラリにアクセスして EOV ファイルの読み込みを行う (GetFileAddress 関数の実行 ) (22) ダイアログ情報に音声ガイド情報が含まれている場合 EOV ファイルを S1V50300 にストリーミング転送する ストリーミング転送は ファイルサイズに応じてブロック単位で行い ファイルの終端に達するまで繰り返し行う (ASRTransferAudioStream 関数の実行 ) (23) (22) の処理で EOV ファイルのストリーミング転送終了後 S1V50300 に転送終了通知を送信する (ASRTransferAudioStream 関数の実行 ) (24) (21) (22) (23) の処理をダイアログ情報に設定されている EOV ファイルの数だけ繰り返し行う (25) ダイアログ情報に音声ガイド情報が含まれている場合 S1V50300 から音声再生終了メッセージが通知されるまで待機する (ASRGetPromptFinished 関数の実行 ) (26) ダイアログ情報に音声認識情報が含まれている場合 S1V50300 から音声認識終了メッセージが通知されるまで待機する (ASRGetRecognitionFinished 関数の実行 ) 12 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

17 4. メインプログラムファイル仕様 (main_sample.c) (27) ダイアログ情報に音声認識情報が含まれている場合 音声認識終了メッセージから認識ワードの文字列およびインデックス番号を取得する -(28) の処理へ (28) プログラムを終了する S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 13

18 5. API 関数仕様 5. API 関数仕様 S1V50300 を制御するための API 関数仕様を以下に記載します 5.1 メッセージプロトコル制御関数 メッセージプロトコル制御関数は S1V50300 メッセージプロトコルマニュアルに記載されたメッセージ仕様にしたがって S1V50300 の制御を行う関数です ASRSetUartConfiguration [ 機能 ] [ 入力引数 ] [ 出力引数 ] int ASRSetUartConfiguration ( unsigned char unsigned char unsigned char ucbaudrate, ucstopbits, ucparity); S1V50300 に対して調歩同期式シリアルインタフェースの通信条件を設定します ucbaudrate ucstopbits ucparity ボーレートを設定します ストップビットを設定します パリティビットを設定します 上記引数に設定する値については S1V50300 メッセージプロトコルマニュアル表 6.3 ISC_BOOT_SYS_CONFIG_REQ の uart_baud_rate / stop_bits / uart_parity_selection の各フィールドを参照してください [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す ERR_ARGUMENT_SETTING -4 引数に範囲外の値が設定された場合に返す [ 機能説明 ] 本関数は シリアルインタフェースとして調歩同期式を選択した場合にのみ使用する関数で ISC_BOOT_SYS_CONFIG_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください 14 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

19 5. API 関数仕様 ASRLoadInitData int ASRLoadInitData ( unsigned char *pucinitdata, int iinitdatalength); [ 機能 ] ホストから S1V50300 に初期化データを転送します [ 入力引数 ] pucinitdata 初期化データを格納したメモリ領域の先頭アドレスを指定します iinitdatalength 初期化データのサイズを指定します [ 出力引数 ] [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返す ERR_NULL_PTR -1 引数が NULL ポインタの場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数は ISC_BOOT_LOAD_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください 本関数でロードする初期化データは弊社より提供されます ただし 通常使用時においては初期化データのロードは不要です S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 15

20 5. API 関数仕様 ASRExitBootMode int ASRExitBootMode ( void ); [ 機能 ] Boot モードから Main モードへ移行します [ 入力引数 ] [ 出力引数 ] [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード値説明 ERR_SUCCESS 0 正常終了した場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数は ISC_BOOT_EXIT_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください 16 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

21 5. API 関数仕様 ASRSetKeycode [ 機能 ] [ 入力引数 ] [ 出力引数 ] int ASRSetKeycode ( unsigned long unsigned short ulkeycode, ustimeout); S1V50300 にキーコードおよび音声認識タイムアウト時間を設定します ulkeycode ustimeout キーコード (16 進数 ) を設定します 音声認識のタイムアウト時間 ( 秒 ) を設定します ustimeout の設定値については S1V50300 メッセージプロトコルマニュアル表 6.10 ISC_TEST_REQ の asr_timeout フィールドを参照してください [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数は ISC_TEST_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 17

22 5. API 関数仕様 ASRGetVersion [ 機能 ] [ 入力引数 ] int ASRGetVersion ( unsigned char aucdeviceversion[5]); S1V50300 のデバイス バージョンを取得します [ 出力引数 ] [ 戻り値 ] aucdeviceversion バージョン情報を格納する配列の先頭アドレスを設定します 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード値説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します [ 機能説明 ] 本関数は ISC_VERSION_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください 18 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

23 5. API 関数仕様 ASRSetAdcVolume [ 機能 ] [ 入力引数 ] [ 出力引数 ] int ASRSetAdcVolume ( unsigned char 音声入力ゲインを設定します ucadcvolume ucadcvolume); ADC のゲインを設定します ucadcvolume の設定値については S1V50300 メッセージプロトコルマニュアル表 6.25 ISC_ADC_VOLUME_REQ の volume_select フィールドを参照してください ) [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード値説明 ERR_SUCCESS 0 正常終了した場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数は ISC_ADC_VOLUME_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 19

24 5. API 関数仕様 ASRSetDacVolume [ 機能 ] [ 入力引数 ] [ 出力引数 ] int ASRSetDacVolume ( unsigned char 音声出力ゲインを設定します ucdacvolume ucdacvolume); DAC のゲインを指定します ucdacvolume の設定値については S1V50300 メッセージプロトコルマニュアル表 6.27 ISC_DAC_VOLUME_REQ の volume_select フィールドを参照してください [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード値説明 ERR_SUCCESS 0 正常終了した場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数は ISC_DAC_VOLUME_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください 20 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

25 5. API 関数仕様 ASRStartDialogue [ 機能 ] [ 入力引数 ] [ 出力引数 ] int ASRStartDialogue ( PROMPT_T RECOGNITION_T unsigned char *pstprompt, *pstrecognition, ucmedia); ダイアログ ( 音声再生および音声認識 ) の実行を開始します pstprompt 音声ガイド選択構造体のポインタを設定します pstrecognition 音声認識設定構造体のポインタを設定します ucmedia シナリオライブラリの S1V50300 側の格納領域を設定します 1 pstprompt に NULL を設定した場合 音声認識単体で実行することが可能です また pstrecognition に NULL を設定した場合 音声ガイド単体で実行することが可能です 2 ucmedia の設定値については S1V50300 メッセージプロトコルマニュアル表 6.15 ISC_START_REQ の attributes (strage media) フィールドを参照してください [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数の内部では ISC_START_REQ/RCV_IND の送受信を行っています 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 21

26 5. API 関数仕様 ASRGetPromptFinished int ASRGetPromptFinished ( void ); [ 機能 ] S1V50300 からの音声再生終了通知メッセージを取得します [ 入力引数 ] [ 出力引数 ] [ 戻り値 ] 再生が終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード値説明 ERR_SUCCESS 0 再生終了した場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数は ISC_PROMPT_FINISHED_IND の受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください 22 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

27 5. API 関数仕様 ASRGetRecognitionFinished [ 機能 ] [ 入力引数 ] int ASRGetRecognitionFinished ( unsigned char *pucrecognitionfield); S1V50300 からの音声認識終了通知メッセージを取得し 認識結果の情報を受け取ります [ 出力引数 ] [ 戻り値 ] pucrecognitionfield 認識結果を格納するメモリ領域の先頭アドレスを設定します 設定するメモリ領域のサイズは 256 バイトで確保してください 認識が終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード値説明 ERR_SUCCESS 0 認識終了した場合に返す ERR_NULL_PTR -1 引数が NULL ポインタの場合に返す ERR_GET_ERROR_CODE -2 受信メッセージにエラーコードが含まれる場合に返す ERR_GET_UNEXPECTED_MESSAGE -3 予期しないメッセージを受信した場合に返す [ 機能説明 ] 本関数は ISC_RECOGNITION_FIN_IND の受信を行い ISC_RECOGNITION_FIN_IND の recognition_result フィールドに格納される認識結果を取得します 取得した認識結果は 引数で指定するメモリ領域にコピーして関数の呼び出し側に返します 以下に 認識結果の例を示します 選択肢 1: メニュー設定 2: 終了 3: もう一度 認識結果の例 認識結果 < 上記選択肢の中の メニュー設定 を認識した場合 > 01 0D A B F : インデックス番号 0D: 文字列の長さ : 文字列 メニュー設定 n < 上記選択肢に合致する認識結果を検出できなかった場合 > ***NO WORDS FOUND*** n < タイムアウト時間内に認識処理を終了できなかった場合 > ***TIMEOUT STOP*** n S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 23

28 5. API 関数仕様 本関数で使用しているメッセージの詳細については 8. ISC_RECOGNITION_FIN_IND メッセージ を参照してください また 認識結果の情報から認識結果のインデックス番号と文字列を取得する API 関数を用意しています 詳細については ASRGetRecognitionWord を参照してください 24 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

29 5. API 関数仕様 ASRStopDialogue int ASRStopDialogue ( void ); [ 機能 ] ダイアログ ( 音声再生および音声認識 ) の実行を停止します [ 入力引数 ] [ 出力引数 ] [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード値説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します [ 機能説明 ] 本関数は ISC_FSTOP_REQ/RCV_IND の送受信を行います 続いて 次の REQ メッセージの送信までの待ち時間として 20msec 待機します 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください ISC_FSTOP_REQ を送信すると音声入出力ゲインの設定値が初期化されます 本関数を実行した後は ASRSetDacVolume 関数および ASRSetAdcVolume 関数を実行して音声入出ゲインの再設定を行ってください S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 25

30 5. API 関数仕様 ASRTransferAudioStream [ 機能 ] [ 入力引数 ] int ASRTransferAudioStream ( unsigned char int unsigned short *pucstream, istreamlength, usattributes) 音声データをホストからデバイスに対してストリーミング転送を行います [ 出力引数 ] [ 戻り値 ] pucstream istreamlength, usattributes 音声データのポインタを設定します 音声データのサイズ ( バイト ) を設定します ストリーミング転送の終了通知を示すフラグを指定します usattributes の設定値については S1V50300 メッセージプロトコルマニュアル表 6.22 ISC_DECODE_REQ の attributes フィールドを参照してください 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します [ 機能説明 ] 本関数は ISC_READY_IND を受信し 続いて 音声データのストリーミング再生を行う ISC_DECODE_REQ/RCV_IND の送受信を行います 本関数で使用しているメッセージの詳細については S1V50300 メッセージプロトコルマニュアル を参照してください 26 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

31 5. API 関数仕様 5.2 シリアルインターフェース制御関数 ( クロック同期式 ) シリアルインタフェース制御関数 ( クロック同期式 ) は クロック同期式シリアルインタフェースを介して ホスト CPU と S1V50300 との間でデータ送受信の制御を行う関数です SPIInitialize void [ 機能 ] [ 入力引数 ] SPIInitialize (void) ホスト CPU のクロック同期式シリアルインターフェースの初期化及び通信設定を行います [ 出力引数 ] [ 戻り値 ] [ 機能説明 ] ホスト CPU 搭載のクロック同期式シリアルインタフェースモジュールの初期化を行います 本関数では 弊社評価環境で使用したホスト CPU のクロック同期式シリアルインターフェース (SPI) 仕様に基づいて 以下に示す手順で初期化を行っています (1) SPI を無効にする (2) SPI の割り込み設定を無効にする (3) 入出力端子の設定を行う (4) SPI のクロック周波数を設定する (5) SPI のクロック信号の極性および位相を設定する (6) SPI をマスタモードに設定する (7) データ転送間ウェイトサイクルを設定する (8) 受信データのビットマスクを設定する (9) SPI を有効にする S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 27

32 5. API 関数仕様 SPISendMessage int SPISendMessage ( unsigned char *pucsendmessage, unsigned char ucchecksumflg) [ 機能 ] S1V50300 に REQ メッセージを送信します [ 入力引数 ] pucsendmessage REQ メッセージが格納されたメモリ領域の先頭アドレスを設定します ucchecksumflg チェックサムの有効 / 無効を設定します (0: disable / 1: enable) [ 出力引数 ] [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します [ 機能説明 ] 引数指定した REQ メッセージのバイト列を S1V50300 に送信します チェックサム機能は Boot モードメッセージの送信のときのみ使用できます Main モードメッセージの送信では チェックサム機能を有効にしても使用できませんのでご注意ください 28 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

33 5. API 関数仕様 SPIReceiveMessage [ 機能 ] [ 入力引数 ] int SPIReceiveMessage ( unsigned short unsigned char *pucmessageid, *pucreceivedmessage) S1V50300 からの IND メッセージを受信します [ 出力引数 ] [ 戻り値 ] pucmessageid pucreceivedmessage IND メッセージのメッセージ ID を格納する変数のポインタを設定します IND メッセージを格納するメモリ領域の先頭アドレスを設定します 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します ERR_GET_ERROR_CODE -2 S1V50300 からの受信メッセージにエラーコードが含まれている場合に返します ERR_RESERVED_MESSAGE_ID -3 S1V50300 からの受信メッセージが予約された ID の場合に返します ERR_ISC_VERSION_RESP -4 ISC_VERSION_RESP の内容が仕様に一致しない場合に返します ERR_TIMEOUT 1 設定したタイムアウト時間内に S1V50300 から通知されるメッセージが受信されない場合に返します [ 機能説明 ] S1V50300 から通知される IND メッセージを受信します 出力引数である pucreceivedmessageid には 取得した IND メッセージの ID の値が格納されます また pucreceivedmessage で指定されるメモリ領域には IND メッセージのデータ全体が格納されます ( 開始ワードである 0x00 0xAA を除く ) 本関数の外で IND メッセージのデータを使用しない場合は pucreceivedmessage に NULL を指定してくだい S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 29

34 5. API 関数仕様 SPISendByte [ 機能 ] [ 入力引数 ] [ 出力引数 ] void SPISendByte ( unsigned char 1 バイトのデータを送信します ucsenddata [ 戻り値 ] [ 機能説明 ] ucsenddata) 1 バイトの送信データを設定します S1V50300 へ 1 バイトのデータを SPI 経由で送信します 30 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

35 5. API 関数仕様 SPIReceiveByte unsigned char SPIReceiveByte ( void ) [ 機能 ] 1 バイトのデータを受信します [ 入力引数 ] [ 出力引数 ] [ 戻り値 ] 1 バイトの受信データを返します [ 機能説明 ] S1V50300 から 1 バイトのデータを SPI 経由で受信します S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 31

36 5. API 関数仕様 5.3 シリアルインターフェース制御関数 ( 調歩同期式 ) シリアルインタフェース制御関数 ( 調歩同期式 ) は 調歩同期式シリアルインタフェースを介して ホスト CPU と S1V50300 との間でデータ送受信の制御を行う関数です UARTInitialize [ 機能 ] [ 入力引数 ] [ 出力引数 ] void UARTInitialize ( unsigned long int ulbaudrate, itransfermode); ホスト CPU の調歩同期式シリアルインターフェースの初期化及び通信設定を行います ulbaudrate itransfermode [ 戻り値 ] [ 機能説明 ] ボーレートを設定します 転送モードを設定します ホスト CPU の調歩同期式シリアルインタフェースモジュールの初期化及び通信設定を行います 本関数では 弊社評価環境で使用したホスト CPU の調歩同期式シリアルインターフェース (UART) 仕様に基づいて 以下に示す手順で初期化および通信設定を行っています (1) UART を無効にする (2) UART の割り込み設定を無効にする (3) UART 用受信バッファにデータがある場合は そのデータを取得する (4) サンプリングクロックの分周比を設定する (5) ボーレートおよび転送モード ( データビット ストップビット パリティビット ) を設定する (6) UART をマスタモードに設定する (7) データ転送間のウェイトサイクルを設定する (8) 受信データのビットマスクを設定する (9) UART を有効にする 32 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

37 5. API 関数仕様 UARTSendMessage int UARTSendMessage ( unsigned char *pucsendmessage, unsigned char ucchecksumflg) [ 機能 ] S1V50300 に REQ メッセージを送信します [ 入力引数 ] pucsendmessage REQ メッセージが格納されたメモリ領域の先頭アドレスを設定します ucchecksumflg チェックサムの有効 / 無効を設定します (0: disable / 1: enable) [ 出力引数 ] [ 戻り値 ] 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します [ 機能説明 ] 引数指定した REQ メッセージのバイト列を S1V50300 に送信します チェックサム機能は Boot モードメッセージの送信のときのみ使用できます Main モードメッセージの送信では チェックサム機能を有効にしても使用できませんのでご注意ください S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 33

38 5. API 関数仕様 UARTReceiveMessage [ 機能 ] [ 入力引数 ] int UARTReceiveMessage ( unsigned short unsigned char *pucmessageid, *pucreceivedmessage) S1V50300 からの IND メッセージを受信します [ 出力引数 ] [ 戻り値 ] pucmessageid pucreceivedmessage IND メッセージのメッセージ ID を格納する変数のポインタを設定します IND メッセージを格納するメモリ領域の先頭アドレスを設定します 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します ERR_GET_ERROR_CODE -2 S1V50300 からの受信メッセージにエラーコードが含まれている場合に返します ERR_RESERVED_MESSAGE_ID -3 S1V50300 からの受信メッセージが予約された ID の場合に返します ERR_ISC_VERSION_RESP -4 ISC_VERSION_RESP の内容が仕様に一致しない場合に返します ERR_TIMEOUT 1 設定したタイムアウト時間内に S1V50300 から通知されるメッセージが受信されない場合に返します [ 機能説明 ] S1V50300 から通知される IND メッセージを受信します 出力引数である pucreceivedmessageid には 取得した IND メッセージの ID の値が格納されます また pucreceivedmessage で設定されるメモリ領域には IND メッセージのデータ全体が格納されます 本関数の外で IND メッセージのデータを使用しない場合は pucreceivedmessage に NULL を設定してくだい 34 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

39 5. API 関数仕様 UARTSendByte [ 機能 ] [ 入力引数 ] [ 出力引数 ] void UARTSendByte ( unsigned char 1 バイトのデータを送信します ucsenddata [ 戻り値 ] [ 機能説明 ] ucsenddata) 1 バイトの送信データを設定します S1V50300 へ 1 バイトのデータを UART 経由で送信します S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 35

40 5. API 関数仕様 UARTReceiveByte unsigned char UARTReceiveByte ( void ) [ 機能 ] 1 バイトのデータを受信します [ 入力引数 ] [ 出力引数 ] [ 戻り値 ] 1 バイトの受信データを返します [ 機能説明 ] S1V50300 から 1 バイトのデータを UART 経由で受信します 36 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

41 5. API 関数仕様 5.4 その他の関数 ASRGetRecognitionWord [ 機能 ] [ 入力引数 ] [ 出力引数 ] [ 戻り値 ] int ASRGetRecognitionWord ( int char unsigned char *piwordindex, *pszwordstring, *pucrecognitionfield); 認識結果の文字列およびインデックス番号を取得します pucrecognitionfield piwordindex pszwordstring ASRGetRecognitionFinished 関数で取得した認識結果を格納したメモリ領域の先頭アドレスを設定します 認識結果のインデックス番号を返します 認識結果の文字列を返します 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します [ 機能説明 ] ASRGetRecognitionFinished 関数で取得した認識結果の情報から 認識結果のインデックス番号と文字列を取得します 本関数では 認識結果文字列が NO WORD FOUND の場合 インデックス番号に 0 をセットして返します S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 37

42 5. API 関数仕様 ASRGetFileAddress [ 機能 ] [ 入力引数 ] [ 出力引数 ] [ 戻り値 ] int ASRGetFileAddress ( unsigned long long unsigned char unsigned long unsigned long *pulstartaddress, *pllength, *pszfilename, *pucasrfileaddresstable, ulscenariolibraryaddress); ホスト CPU 側のメモリに格納されたシナリオライブラリからファイルを読み出すためのアドレス情報を取得します pszfilename pucasrfileadresstable ulscenariolibraryaddress pulstartaddress pllength ファイル名を設定します シナリオライブラリ用アドレス情報テーブルの先頭アドレスを設定します シナリオライブラリの格納先アドレス ( オフセットアドレス ) を設定します ファイルの先頭アドレスを返します ファイルのサイズを返します 正常終了した場合は 0 を返し それ以外は以下に示すエラーコードを返します [ 機能説明 ] エラーコード 値 説明 ERR_SUCCESS 0 正常終了した場合に返します ERR_NULL_PTR -1 引数が NULL ポインタの場合に返します ERR_NOT_FINDE_FILE -10 ファイルが存在しない場合に返します 本関数は ホスト CPU 側のメモリに格納されたシナリオライブラリからファイルを読み出すためのアドレス情報を取得します シナリオライブラリに含まれるファイルの先頭アドレスを定義したアドレス情報テーブルを参照して ファイルの先頭アドレスとサイズを関数の呼出し側に返します 第 5 引数に シナリオライブラリ格納先のアドレスを設定した場合 そのアドレスを加算した値でファイルの先頭アドレスを返します 38 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

43 6. 構造体 6. 構造体 ASR 制御 API 関数で使用される構造体の仕様を以下に記載します 6.1 PROMPT_T 構造体 typedef struct tagprompt { } PROMPT_T; unsigned short unsigned short FILE_ELEMENT_T usreserved; usfilecount; *pastfileelement; [ メンバ変数 ] [ 説明 ] usreserved 予約 ( 設定値 :0x0000 固定 ) usfilecount 音声ファイル数 ( 最大 64) pastfileelement 個々の音声ファイルの情報を定義した FILE_ELEMENT 構造体の配列テーブルの先頭アドレス 本構造体は 音声再生情報を設定するための構造体で ISC_START_REQ に含まれる 音声ガイド選択構造体 に相当します メンバ変数 pastfileelement には 後述する 6.2 FILE_ELEMENT_T 構造体 の配列テーブルの先頭アドレスを設定します S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 39

44 6. 構造体 6.2 FILE_ELEMENT_T 構造体 typedef struct tagfileelement { unsigned short unsigned short unsigned char } FILE_ELEMENT_T; usdelay; ustype; aucfilename[12]; [ メンバ変数 ] usdelay ustype aucfilename[12] 音声ファイル再生後に挿入される無音区間の長さ [ms] 0x0000 ~ 0x0064 (100ms) 0x0065 ~ 0x0FA0 (101ms ~ 4000ms) 音声再生方式の種類 0x0001: シーケンス再生 0x0003: ストリーミング再生音声ファイル名 音声ファイル名は 8.3 形式で最大 12 バイトです 11 バイト以下は NULL( 0 or 0x00) 終端で設定してください [ 説明 ] 本構造体は 個々の音声ファイルの情報を設定する構造体で ISC_START_REQ に含まれる 音声ガイド選択構造体 のサブ構造体である 音声ファイル設定構造体 に相当します 各メンバ変数の設定値については S1V50300 メッセージプロトコルマニュアル表 6.17 音声ファイル設定構造体 の delay_ms / type / eov_file_name フィールドを参照してください 40 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

45 6. 構造体 6.3 RECOGNITION_T 構造体 typedef struct tagrecognition { unsigned char int } RECOGNITION_T; *pucdata; ilen; [ メンバ変数 ] pucdata ilen LM ファイルの実データを格納したメモリ領域の先頭アドレス または LM ファイル名の文字列を格納したメモリ領域の先頭アドレス LM ファイル名は 8.3 形式で拡張子含めて最大 12 バイトです LM ファイル名が 12 バイト未満の場合は 12 バイト目まで 0x00 で埋めてください LM ファイルの実データのバイトサイズ または LM ファイル名の文字列のバイトサイズ pucdata に LM ファイル名を設定する場合は 12 バイト固定です [ 説明 ] 本構造体は 音声認識情報を設定するための構造体です ISC_START_REQ に含まれる 音声認識設定構造体 に相当します メンバ変数 pucdata の設定値は LM ファイルの使用形態によって異なります ホストから LM ファイルを転送する場合 LM ファイルの実データを格納したメモリ領域の先頭アドレスを設定する 内蔵 Mask ROM または外部シリアル Flash メモリに格納された LM ファイルを使用する場合 LM ファイル名の文字列を格納したメモリ領域の先頭アドレスを設定する S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 41

46 6. 構造体 6.4 DIALOGUE_T 構造体 typedef struct tagdialogue { PROMPT_T } DIALOGUE_T; [ メンバ変数 ] pstprompt pstrecognition RECOGNITION_T *pstprompt; *pstrecognition; 音声再生情報へのポインタ音声認識情報へのポインタ [ 説明 ] 本構造体は ダイアログ情報を定義するための構造体で 音声再生情報を格納する音声選択構造体と音声認識情報を格納する音声認識設定構造体を含みます 42 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

47 6. 構造体 6.5 FILE_ADDRESS_T 構造体 typedef struct tagfileaddress { unsigned char unsigned long unsigned long } FILE_ADDRESS_T; aucfilename[13]; uladdress; ullength; [ メンバ変数 ] aucfilename[13] ulstartaddress ullnegth ファイル名 (*.eov または *.lm) ファイルの先頭アドレス ファイルサイズ [ 説明 ] 本構造体は シナリオライブラリに含まれるファイルの格納先アドレスとファイルサイズを設定する構造体です シナリオライブラリからファイルを取得するアドレステーブルを定義するために使用します S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 43

48 7. 音声対話シナリオ ( サンプル ) 7. 音声対話シナリオ ( サンプル ) 本サンプルプログラムで実装されている音声対話シナリオのダイアログ遷移を以下に記載します ダイアログ番号音声ガイド認識選択肢 1 認識選択肢 2 シナリオ実行開始 No.1 効果音 0 : NO WORD ダイアログ No.1 を実行 1 : 電気点けて No.2 点けます ダイアログ No.1 を実行 ( 認識選択肢 ) 2 : 電気消して No.3 消します ダイアログ No.1 を実行 ( 認識選択肢 ) 3 : 明るく No.4 明るくします ダイアログ No.1 を実行 ( 認識選択肢 ) 4 : 暗く No.5 暗くします ダイアログ No.1 を実行 ( 認識選択肢 ) 5 : 終了 No.6 終了します シナリオ実行終了 ( 認識選択肢 ) ダイアログ No.1 は 10 秒間の認識待ち受けで動作し その間に認識しなかった場合は No.1 を再実行する 44 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

49 8. ISC_RECOGNITION_FIN_IND メッセージ 8. ISC_RECOGNITION_FIN_IND メッセージ 以下に ISC_RECOGNITION_FIN_IND メッセージの詳細について記載します 表 8.1 ISC_RECOGNITION_FIN_IND バイト フィールド 値 0 length(lsb) 0x size(r) 1 length(msb) 2 msg_id(lsb) 0x000B 3 msg_id(msb) 4 error_code(lsb) 0x0000: ノーエラー 5 error_code(msb) 0x0001-0xFFFF: エラーコード 6 recognition_result 認識結果構造体 (R) 表 表 に記載本フィールドの最大サイズは 256 バイト 6+size(R) reserved - 表 recognition_result( 認識結果検出 ) バイト フィールド 値 0 Index 認識結果のインデックス番号 指定できる範囲は (0x01-0xFE) 1 string_length 認識結果の文字列の長さ 文字列の最大長は 255 バイト 2 (string_length+1) string 認識結果の文字列 文字列の終端は改行コード ( n or 0x09) が設定される 表 recognition_result( 認識結果未検出 ) バイト フィールド 値 no_phrase_string "***NO WORDS FOUND*** n" 選択肢に合致する認識結果を検出できなかった場合に 上記文字列が格納される 表 recognition_result( タイムアウト ) バイト フィールド 値 no_phrase_string "***TIMEOUT STOP*** n" タイムアウト時間内に認識処理を終了できなかった場合に 上記文字列が格納される S1V50300 サンプルプログラムマニュアル Seiko Epson Corporation 45

50 8. ISC_RECOGNITION_FIN_IND メッセージ 46 Seiko Epson Corporation S1V50300 サンプルプログラムマニュアル

51 改訂履歴 改訂履歴 Rev. No. 日付ページ種別改訂内容 Rev /05/31 全ページ新規新規制定 Rev /11/12 P.2 追加表 2.1 に init_data x_x_x x_x.c の説明を追加 Rev /11/12 P.3 追加 2.7 初期化データ定義ファイル (init_data x_x_x x_x.c) を新規に追加 Rev /11/12 P.23 追加 ASRGetRecognitionFinished に タイムアウト時の認識結果例を追加 Rev /11/12 P.45 追加 8. ISC_RECOGNITION_FIN_IND メッセージ を新規に追加

52 マイクロデバイス事業部 IC 営業部 東京 大阪 東京都日野市日野 TEL(042) ( 直通 ) FAX(042) 大阪市中央区博労町 エプソン大阪ビル 15F TEL(06) ( 代表 ) FAX(06) ドキュメントコード : 年 5 月作成 2013 年 11 月改訂