FIFO 内蔵シリアルコミュニケーションインタフェース

R20UT3292JJ0102 Rev.1.02 Page 172 of 325 2020.03.13

AP4 3. API関数

AP4 3.　 API関数

R20UT3292JJ0102 Rev.1.02 Page 173 of 325

2020.03.13

FIFO内蔵シリアルコミュニケーションインタフェースを制御するうえで必要となる初期化処理を行います。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

R_SCIFAn_Create

void R_SCIFAn_Create ( void );

R20UT3292JJ0102 Rev.1.02 Page 174 of 325 2020.03.13

AP4 3.　 API関数

FIFO内蔵シリアルコミュニケーションインタフェースに関するユーザ独自の初期化処理を行います。

備考 本API関数は，R_SCIFAn_Createのコールバック・ルーチンとして呼び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

R_SCIFAn_Create_UserInit

void R_SCIFAn_Create_UserInit ( void );

AP4 3.　 API関数

R20UT3292JJ0102 Rev.1.02 Page 175 of 325

2020.03.13

割り込み要因TXI（送信FIFOデータエンプティ（TDFE)による割り込み）の発生に伴う処理を行います。

備考 本API関数は，送信FIFOデータエンプティ割り込みに対応した割り込み処理として呼び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

r_scifan_txifn_interrupt

void r_scifan_txifn_interrupt ( void );

R20UT3292JJ0102 Rev.1.02 Page 176 of 325 2020.03.13

AP4 3.　 API関数

割り込み要因RXI（受信FIFOデータフル（RDF)による割り込み）の発生に伴う処理を行います。

備考 本API関数は，受信FIFOデータフル割り込みに対応した割り込み処理として呼び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

r_scifan_rxifn_interrupt

void r_scifan_rxifn_interrupt ( void );

AP4 3. API関数

R20UT3292JJ0102 Rev.1.02 Page 177 of 325

2020.03.13

割り込み要因BRI（ブレーク（BRK)またはオーバラン（ORER）による割り込み）の発生に伴う処理を行います。

また、割り込み要因ERI（フレーミングエラーまたはパリティエラー（ER)による割り込み）の発生に伴う処理を 行います。

備考 本API関数は，ブレーク（BRK)／オーバラン（ORER）／フレーミングエラー／パリティエラー

（ER)割り込みに対応した割り込み処理として呼び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

r_scifan_brifn_interrupt

void r_scifan_brifn_interrupt ( void );

R20UT3292JJ0102 Rev.1.02 Page 178 of 325 2020.03.13

AP4 3. API関数

割り込み要因DRI（受信データレディ（DR)による割り込み）の発生に伴う処理を行います。

また、割り込み要因TEI（トランスミットエンド（TEND)による割り込み）の発生に伴う処理を行います。

備考 本API関数は，受信データレディ／トランスミットエンド割り込みに対応した割り込み処理として呼 び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

r_scifan_drifn_interrupt

void r_scifan_drifn_interrupt ( void );

AP4 3. API関数

R20UT3292JJ0102 Rev.1.02 Page 179 of 325

2020.03.13

トランスミットエンド割り込みの発生に伴う処理を行います。

備考 本API関数は，トランスミットエンド割り込みに対応した割り込み処理r_scifan_teifn_interruptのコー ルバック・ルーチンとして呼び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

r_scifan_callback_transmitend

void r_scifan_callback_transmitend ( void );

R20UT3292JJ0102 Rev.1.02 Page 180 of 325 2020.03.13

AP4 3. API関数

受信FIFOデータフル割り込みの発生に伴う処理を行います。

備考 本API関数は，受信FIFOデータフル割り込みに対応した割り込み処理r_scifan_rxifn_interruptのコー ルバック・ルーチンとして呼び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

r_scifan_callback_receiveend

void r_scifan_callback_receiveend ( void );

AP4 3. API関数

R20UT3292JJ0102 Rev.1.02 Page 181 of 325

2020.03.13

エラー割り込みの発生に伴う処理を行います。

備考 本API関数は，エラー割り込みに対応した割り込み処理r_scifan_erifn_interruptまたは r_scifan_brifn_interruptのコールバック・ルーチンとして呼び出されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

r_scifan_callback_error

void r_scifan_callback_error ( void );

R20UT3292JJ0102 Rev.1.02 Page 182 of 325 2020.03.13

AP4 3. API関数

SCIFA通信を待機状態にします。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

R_SCIFAn_Start

void R_SCIFAn_Start ( void );

AP4 3. API関数

R20UT3292JJ0102 Rev.1.02 Page 183 of 325

2020.03.13

SCIFA通信を終了します。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

なし

［戻り値］

なし

R_SCIFAn_Stop

void R_SCIFAn_Stop ( void );

R20UT3292JJ0102 Rev.1.02 Page 184 of 325 2020.03.13

AP4 3. API関数

調歩同期式モードで，送信を開始します。

備考 1. 本API関数では，引数txbufで指定されたバッファから1バイト単位のUART送信を引数txnumで指 定された回数だけ繰り返し行います。

備考 2. 本API関数の呼び出し以前にR_SCIFAn_Startを呼び出す必要があります。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

［戻り値］

R_SCIFAn_Serial_Send

MD_STATUS R_SCIFAn_Serial_Send ( const uint8_t * txbuf, uint16_t txnum );

I/O 引数 説明

I const uint8_t * txbuf; 送信するデータを格納したバッファへのポインタ

I uint16_t txnum; 送信するデータの総数

マクロ 説明

MD_OK 正常終了

MD_ARGERROR 引数の指定が不正

AP4 3.　 API関数

R20UT3292JJ0102 Rev.1.02 Page 185 of 325

2020.03.13

調歩同期式モードで，受信を開始します。

備考 1. 本API関数では，1バイト単位の受信を引数rxnumで指定された回数だけ繰り返し行い，引数rxbufで 指定されたバッファに格納します。

備考 2. 本API関数の呼び出し後，R_SCIFAn_Startを呼び出すことにより開始されます。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

［戻り値］

R_SCIFAn_Serial_Receive

MD_STATUS R_SCIFAn_Serial_Receive ( uint8_t * rxbuf, uint16_t rxnum );

I/O 引数 説明

O uint8_t * rxbuf; 受信したデータを格納するバッファへのポインタ

I uint16_t rxnum; 受信するデータの総数

マクロ 説明

MD_OK 正常終了

MD_ARGERROR 引数の指定が不正

R20UT3292JJ0102 Rev.1.02 Page 186 of 325 2020.03.13

AP4 3.　 API関数

クロック同期式モードで，送受信を開始します。

備考 1. 本API関数では，引数tx_bufで指定されたバッファから1バイト単位の送信を引数tx_numで指定さ れた回数だけ繰り返し行います。

備考 2. 本API関数では，1バイト単位の受信を引数rx_numで指定された回数だけ繰り返し行い，引数rx_buf で指定されたバッファに格納します。

備考 3. 本API関数の呼び出し後，R_SCIFAn_Startを呼び出す必要があります。

［指定形式］

備考 nは，チャネル番号を意味します。

［引数］

［戻り値］

R_SCIFAn_Serial_Send_Receive

MD_STATUS R_SCIFAn_Serial_Send_Receive(const uint8_t * tx_buf, uint16_t tx_num, uint8_t * rx_buf, uint16_t rx_num);

I/O 引数 説明

I const uint8_t * tx_buf; 送信データを格納したバッファへのポインタ

I uint16_t tx_num; 送信するデータの総数

O uint8_t * rx_buf; 受信するデータを格納したバッファへのポインタ

I uint16_t rx_num; 受信するデータの総数

マクロ 説明

MD_OK 正常終了

MD_ARGERROR 引数の指定が不正

AP4 3.　 API関数

R20UT3292JJ0102 Rev.1.02 Page 187 of 325

2020.03.13

R20UT3292JJ0102 Rev.1.02 Page 188 of 325 2020.03.13

AP4 3.　 API関数

ドキュメント内 AP4 統合開発環境 ユーザーズマニュアル RZ/T1 APIリファレンス編 (ページ 172-188)