1.11.2.5. 関数
| プロトタイプ | librsu_init(void) |
| パラメーター | - |
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | LibRSU HAL APIを初期化します。 |
| プロトタイプ | librsu_exit (void) |
| パラメーター | - |
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | LibRSU HAL APIを停止し、開いている場合はMailbox Client Intel FPGA IPを閉じます。 |
| プロトタイプ | rsu_slot_count (void) |
| パラメーター | - |
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 定義されているスロットの数を取得します。 |
| プロトタイプ | rsu_slot_by_name (char *name) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 名前に基づきスロット番号を取得します。 |
| プロトタイプ | rsu_slot_get_info (int slot, struct rsu_slot_info *info) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | スロットの属性を取得します。 |
| プロトタイプ | rsu_slot_size (int slot) |
| パラメーター |
|
| 戻り値 | 成功の場合はスロットのサイズをバイト単位で返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | スロットのサイズを取得します。 |
| プロトタイプ | rsu_slot_priority (int slot) |
| パラメーター |
|
| 戻り値 | 成功の場合はスロットの優先度を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | スロットのロード優先度を取得します。優先度が0の場合、スロットには優先度がなく、無効になっていることを意味します。優先度が1のスロットが最も高い優先度をもちます。 |
| プロトタイプ | rsu_slot_erase (int slot) |
| パラメーター | slot – スロット番号 |
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | スロット内のすべてのデータを消去して、プログラミングに備えます。スロットがCPB内にある場合は、それを削除します。 |
| プロトタイプ | rsu_slot_program_buf (int slot, void *buf, int size) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | バッファーからのインテルFPGAビットストリーム・データを使用してスロットをプログラミングし、最も高い優先度としてCPBにスロットを入力します。スロットは最初に消去する必要があります。 |
| プロトタイプ | rsu_slot_program_callback(int slot, rsu_data_callback callback) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | この関数は、コールバック関数によって提供されるインテルFPGAコンフィグレーション・データを使用してスロットをプログラミングして検証します。スロット (パーティション) をCPBに入力します。 |
| プロトタイプ | rsu_slot_verify_buf (int slot, void *buf, int size) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | スロット内のFPGAコンフィグレーション・データをバッファーに対して検証します。 |
| プロトタイプ | rsu_slot_verify_callback(int slot, rsu_data_callback callback) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | コールバック関数で提供されるインテルFPGAビットストリームを使用してスロットを検証します。 |
| プロトタイプ | rsu_slot_copy_to_buf(int slot, alt_u64 address) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | スロット内のデータを読み出し、バッファーに書き込みます。 |
| プロトタイプ | rsu_slot_enable (int slot) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 選択しているスロットを最も高い優先度に設定します。 |
| プロトタイプ | rsu_slot_disable (int slot) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 選択しているスロットを優先スキームから除外します。ただし、スロットデータは残ります。 |
| プロトタイプ | rsu_slot_load (int slot) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 選択しているスロットをすぐにロードするように要求します。 |
| プロトタイプ | rsu_slot_load_factory (void) |
| パラメーター | - |
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | ファクトリー・イメージをすぐにロードするように要求します。 |
| プロトタイプ | rsu_slot_rename (int slot, char *name) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 選択しているスロットの名前を変更します。 |
| プロトタイプ | rsu_slot_create (char *name, alt_u64 address, unsigned int size) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 未使用のスペースを使用して、SPTに新しいスロットを作成します。 |
| プロトタイプ | rsu_slot_delete (int slot) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 選択しているスロットをSPTから削除します。 |
| プロトタイプ | rsu_status_log (struct rsu_status_info *info) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | ファームウェア・ステータス・ログを rsu_status_info 構造体にコピーします。 |
| プロトタイプ | rsu_clear_error_status (void) |
| パラメーター | - |
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 現在のステータスログからエラーフィールドをクリアします。 |
| プロトタイプ | rsu_dcmf_version (alt_u32 *version) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | フラッシュ内の4つの決定ファームウェアのそれぞれのコピーのバージョンを取得します。 |
| プロトタイプ | rsu_max_retry (alt_u8 *value) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | フラッシュから max_retry パラメーターを取得します。 |
| プロトタイプ | rsu_dcmf_status (int *status) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 決定ファームウェアのコピーがフラッシュ内で破損しているかを判断します。その際は、現在使用されている決定ファームウェアを基準として使用します。ステータスは4つの値の配列で、決定ファームウェアのそれぞれのコピーに1つの値が対応します。値が0の場合はコピーが正常であることを意味し、それ以外の場合はコピーが破損していることを意味します。 |
| プロトタイプ | rsu_create_empty_cpb (void) |
| パラメーター | - |
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | CPBヘッダーのみを含む空のCPBを作成します。すべてのエントリーは未使用としてマークされます。 |
| プロトタイプ | rsu_restore_cpb (alt_u64 address) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | メモリー内のバッファーからCPBを復元します。バッファーには4096バイトのCPBデータと、それに続いてデータのCRC32チェックサムを含む4バイトが含まれている必要があります。 |
| プロトタイプ | rsu_save_cpb (alt_u64 address) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | CPBをメモリーバッファーに格納します。合計4100バイトが書き込まれます。4096バイトのデータと、データのCRC32チェックサムを含む4バイトです。 |
| プロトタイプ | rsu_restore_spt (alt_u64 address) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | メモリー内のバッファーからSPTを復元します。バッファーには4096バイトのSPTデータと、それに続いてデータのCRC32チェックサムを含む4バイトが含まれている必要があります。 |
| プロトタイプ | rsu_save_spt (alt_u64 address) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | SPTをメモリー内のアドレスに格納します。合計4100バイトが書き込まれます。4096バイトのデータと、データのCRC32チェックサムを含む4バイトです。 |
| プロトタイプ | rsu_running_factory (int *factory) |
| パラメーター |
|
| 戻り値 | 成功の場合は0を返し、それ以外の場合はエラーコードを返します 22 |
| 詳細 | 現在実行されているイメージがファクトリー・イメージかを識別します。 |