User's Manual
スマート・コンフィグレータ

ユーザーズマニュアル RX API リファレンス編
ターゲットデバイス
RX ファミリー

本資料に記載の全ての情報は本資料発行時点のものであり、ルネサス エレクトロニクスは、
予告なしに、本資料に記載した製品または仕様を変更することがあります。
ルネサス エレクトロニクスのホームページなどにより公開される最新情報をご確認ください。

www.renesas.com

Rev.1.09 2024.10

このマニュアルの使い方

対象者

このマニュアルは、スマート・コンフィグレータのドライバコード生成の機能を理解し、それを用いたアプリケーション・システムを開発するユーザを対象としています。

目的

このマニュアルは、スマート・コンフィグレータのドライバコード生成の持つソフトウエ
ア機能をユーザに理解していただき、これを使用するシステムのハードウエア、ソフトウ
エア開発の参照用資料として役立つことを目的としています。

構成

このマニュアルは、大きく分けて次の内容で構成しています。
1. 概説
2. 出力ファイル
3. API 関数

読み方このマニュアルを読むにあたっては、電気、論理回路、マイクロコンピュータに関する一般知識が必要となります。
凡例

データ表記の重み：

左が上位桁、右が下位桁

アクティブ・ロウの表記 ：

XXX

注

：

本文中につけた注の説明

注意：

気をつけて読んでいただきたい内容

備考：

本文中の補足説明

数の表記：

10 進数...XXXX（端子、信号名称に上線）

16 進数...0xXXXX

すべての商標および登録商標は、それぞれの所有者に帰属します。

目次
1.

2.

概説................................................................................................................................................................ 5
1.1

概要 ...................................................................................................................................................... 5

1.2

特長 ...................................................................................................................................................... 5

出力ファイル ................................................................................................................................................. 6
2.1

説明 ...................................................................................................................................................... 6

3.

初期化 .......................................................................................................................................................... 19

4.

API 関数 ...................................................................................................................................................... 20
4.1

概要 .................................................................................................................................................... 20

4.2

関数リファレンス............................................................................................................................... 21

4.2.1

共通 ............................................................................................................................................ 23

4.2.2

8 ビットタイマ .......................................................................................................................... 33

4.2.3

バス ............................................................................................................................................ 41

4.2.4

クロック周波数精度測定回路 .................................................................................................... 49

4.2.5

コンパレータ .............................................................................................................................. 58

4.2.6

コンペアマッチタイマ ............................................................................................................... 65

4.2.7

相補 PWM モードタイマ ............................................................................................................ 75

4.2.8

連続スキャンモード S12AD ...................................................................................................... 85

4.2.9

CRC 演算器 ............................................................................................................................. 100

4.2.10D/A コンバータ ....................................................................................................................... 110

4.2.11

データ演算回路 ........................................................................................................................ 119

4.2.12

データトランスファコントローラ ........................................................................................... 129

4.2.13

デッドタイム補償用カウンタ .................................................................................................. 135

4.2.14

DMA コントローラ .................................................................................................................. 146

4.2.15

イベントリンクコントローラ .................................................................................................. 160

4.2.16

汎用 PWM タイマ..................................................................................................................... 170

4.2.17

グループスキャンモード S12AD ............................................................................................. 187

4.2.18I2C マスタモード .................................................................................................................... 204

4.2.19I2C スレーブモード................................................................................................................. 237

4.2.20

割り込みコントローラ ............................................................................................................. 253

4.2.21

消費電力低減機能 .................................................................................................................... 269

4.2.22

ローパワータイマ .................................................................................................................... 281

4.2.23

ノーマルモード ........................................................................................................................ 287

4.2.24位相計数モードタイマ ............................................................................................................. 295

4.2.25

ポートアウトプットイネーブル ............................................................................................... 306

4.2.26

ポート ...................................................................................................................................... 317

4.2.27

プログラマブルパルスジェネレータ ....................................................................................... 321

4.2.28PWM モードタイマ .................................................................................................................. 325

4.2.29

リアルタイムクロック ............................................................................................................. 333

4.2.30

リモコン信号受信機能 ............................................................................................................. 360

4.2.31SCI/SCIF 調歩同期式モード .................................................................................................... 376

4.2.32

SCI/SCIF クロック同期式モード ............................................................................................ 400

4.2.33

シングルスキャンモード S12AD ............................................................................................. 423

4.2.34スマートカードインタフェース ............................................................................................... 438

4.2.35

SPI クロック同期式モード ...................................................................................................... 453

4.2.36

SPI 動作モード ........................................................................................................................ 475

4.2.37

電圧検出回路 ............................................................................................................................ 490

4.2.38

ウォッチドッグタイマ ............................................................................................................. 497

4.2.39連続スキャンモード DSAD ...................................................................................................... 505

4.2.40

シングルスキャンモード DSAD............................................................................................... 516

4.2.41Δ-Σモジュールインタフェース ............................................................................................... 527

4.2.42

アナログフロントエンド ......................................................................................................... 536

4.2.43モータ ...................................................................................................................................... 539

4.2.44

LCD コントローラ................................................................................................................... 552

改訂記録............................................................................................................................................................ 559

スマート・コンフィグレータ

1.

1. 概説

概説
本章では、スマート・コンフィグレータのドライバコード生成機能の概要について説明します。

1.1

概要

本ツールは、GUI ベースで各種情報を設定することにより、デバイスが提供している周辺機能（クロック発生回路、電圧検出回路など）を制御するうえで必要なソースコード（デバイスドライバプログラム：
C ソースファイル，ヘッダファイル）を出力することができます。

1.2

特長

以下に、コード生成機能の特長を示します。
- コード生成機能
GUI ベースでマイコンの周辺機能を設定し、設定情報に応じた初期化プログラムを出力するだけでなく、動作開始／停止、割り込み関数も出力します。
- レポート機能
設定した情報を各種形式のファイルで出力し、設計資料として利用することができます。
- リネーム機能
出力するフォルダ名、ファイル名、およびソースコードに含まれている API 関数の関数名について
は、デフォルトの名前が付与されますが、ユーザ独自の名前に変更することもできます。
本文書内では、ユーザが変更可能な箇所を<>で囲んで表記しています。
- ユーザコード保護機能
各 API 関数には、ユーザが独自にコードを追加できるように、ユーザコード記述用のコメントが設けられています。
［ユーザコード記述用のコメント］/* Start user code. Do not edit comment generated here *//* End user code. Do not edit comment generated here */このコメント内にコードを記述すると、再度コード生成した場合でもユーザが記述したコードは保護されます。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 5 of 533

スマート・コンフィグレータ

2.

2. 出力ファイル

出力ファイル

本章では、コード生成が出力するファイルについて説明します。

2.1

説明

以下に、コード生成が出力するファイルの一覧を示します。
表 2.1

出力ファイル(1/12)
周辺機能

共通

ファイル名

API 関数名<workspaceName>.c

maindbsct.c－resetprg.c

PowerON_Resetsbrk.c－vecttbl.c－vecttbl.h－hwsetup.chardware_setup

hwsetup.h－r_cg_hardware_setup.cr_undefined_exception
R_Systeminit

r_cg_macrodriver.h－r_cg_userdefine.h－r_smc_entry.h－r_smc_cgc.c

R_CGC_Create

r_smc_cgc_user.c

R_CGC_Create_UserInit

r_smc_cgc.h－r_smc_interrup.c

R_Interrupt_Create

r_smc_interrupt.h

－

Pin.c

R_Pins_Create

Pin.h

－

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 6 of 533

スマート・コンフィグレータ

表 2.2

2. 出力ファイル

出力ファイル(2/13)
周辺機能

8 ビットタイマ

ファイル名<Config_TMR0>.c<Config_TMR0>_user.c

バス－<Config_BSC>.c

R_<Config_BSC>_Create
R_<Config_BSC>_Error_Monitoring_Start
R_<Config_BSC>_Error_Monitoring_Stop
R_<Config_BSC>_InitializeSDRAM<Config_BSC>_user.c

R_<Config_BSC>_Create_UserInit
r_<Config_BSC>_buserr_interrupt<Config_BSC>.h－

定回路<Config_CAC>_user.c<Config_CAC>.h<Config_CMPB0>.c<Config_CMPB0>user.c<Config_CMPB0>.h
コンペアマッチタイマ

R_<Config_TMR0>_Create
R_<Config_TMR0>_Start
R_<Config_TMR0>_Stop
R_<Config_TMR0>_Create_UserInit
r_<Config_TMR0>_cmimn_interrupt
r_<Config_TMR0>_ovin_interrupt<Config_TMR0>.h

クロック周波数精度測 <Config_CAC>.c

コンパレータAPI 関数名<Config_CMT0>.c<Config_CMT0>_user.c<Config_CMT0>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

R_<Config_CAC>_Create
R_<Config_CAC>_Start
R_<Config_CAC>_Stop
R_<Config_CAC>_Create_UserInit
r_<Config_CAC>_mendf_interrupt
r_<Config_CAC>_mendi_interrupt
r_<Config_CAC>_ferrf_interrupt
r_<Config_CAC>_ferri_interrupt
r_<Config_CAC>_ovff_interrupt
r_<Config_CAC>_ovfi_interrupt－
R_<Config_CMPB0>_Create
R_<Config_CMPB0>_Start
R_<Config_CMPB0>_Stop
R_<Config_CMPB0>_Create_UserInit
r_<Config_CMPB0>_cmpbn_interrupt－
R_<Config_CMT0>_Create
R_<Config_CMT0>_Start
R_<Config_CMT0>_Stop
R_<Config_CMT0>_Create_UserInit
r_<Config_CMT0>_cmin_interrupt
r_<Config_CMT0>_cmwin_interrupt
r_<Config_CMT0>_icmin_interrupt
r_<Config_CMT0>_ocmin_interrupt－

Page 7 of 533

スマート・コンフィグレータ

表 2.3

2. 出力ファイル

出力ファイル(3/13)
周辺機能

ファイル名

相補 PWM モードタイ <Config_MTU3_MTU4>.c<Config_MTU3_MTU4>_user.c

R_<Config_MTU3_MTU4>_Create
R_<Config_MTU3_MTU4>_Start
R_<Config_MTU3_MTU4>_Stop
R_<Config_MTU3_MTU4>_Create_UserInit
r_<Config_MTU3_MTU4>_tgimn_interrupt
r_<Config_MTU3_MTU4>_cj_tgimj_interrupt
r_<Config_MTU3_MTU4>_cj_tcivj_interrupt<Config_MTU3_MTU4>.h－マ

連 続 ス キ ャ ン モ ー ド <Config_S12AD0>.c
S12AD<Config_S12AD0>_user.c<Config_S12AD0>.h
CRC 演算器<Config_CRC>.c<Config_CRC>.h
D/A コンバータ

API 関数名

R_<Config_S12AD0>_Create
R_<Config_S12AD0>_Start
R_<Config_S12AD0>_Stop
R_<Config_S12AD0>_Get_ValueResult
R_<Config_S12AD0>_Set_CompareValue
R_<Config_S12AD0>_Set_CompareAValue
R_<Config_S12AD0>_Set_CompareBValue
R_<Config_S12AD0>_Create_UserInit
r_<Config_S12AD0>_interrupt
r_<Config_S12AD0>_compare_interrupt
r_<Config_S12AD0>_compare_interruptA
r_<Config_S12AD0>_compare_interruptB－
R_<Config_CRC>_SetCRC8
R_<Config_CRC>_SetCRC16
R_<Config_CRC>_SetCCITT
R_<Config_CRC>_SetCRC32
R_<Config_CRC>_SetCRC32C
R_<Config_CRC>_Input_Data
R_<Config_CRC>_Get_Result－<Config_DA>_user.c

R_<Config_DA>_Create
R_<Config_DA>n_Start
R_<Config_DA>n_Stop
R_<Config_DA>n_Set_ConversionValue
R_<Config_DA>_Sync_Start
R_<Config_DA>_Sync_Stop
R_<Config_DA>_Create_UserInit<Config_DA>.h－<Config_DA>.c

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 8 of 533

スマート・コンフィグレータ

表 2.4

2. 出力ファイル

出力ファイル(4/13)
周辺機能

データ演算回路

ファイル名<Config_DOC.c<Config_DOC_user.c<Config_DOC.h
データトランスファコ <Config_DTC.c
ントローラ<Config_DTC_user.c<Config_DTC.h
デッドタイム補償用カ <Config_MTU5>.c
ウンタ<Config_MTU5>_user.c<Config_MTU5>.h
DMA コントローラ

API 関数名
R_<Config_DOC>_Create
R_<Config_DOC>_SetMode
R_<Config_DOC>_WriteData
R_<Config_DOC>_GetResult
R_<Config_DOC>_ClearFlag
R_<Config_DOC>_Create_UserInit
r_<Config_DOC>_dopcf_interrupt
r_<Config_DOC>_dopci_interrupt－
R_<Config_DTC>_Create
R_<Config_DTC>_Start
R_<Config_DTC>_Stop
R_<Config_DTC>_Create_UserInit－
R_<Config_MTU5>_Create
R_<Config_MTU5>_U5_Start
R_<Config_MTU5>_U5_Stop
R_<Config_MTU5>_V5_Start
R_<Config_MTU5>_V5_Stop
R_<Config_MTU5>_W5_Start
R_<Config_MTU5>_W5_Stop
R_<Config_MTU5>_Create_UserInit
r_<Config_MTU5>_tgimn_interrupt－<Config_DMAC0>.c

R_<Config_DMAC0>_Create
R_<Config_DMAC0>_Start
R_<Config_DMAC0>_Stop
R_<Config_DMAC0>_Set_SoftwareTrigger
R_<Config_DMAC0>_Clear_SoftwareTrigger<Config_DMAC0>_user.c

R_<Config_DMAC0>_Create_UserInit
r_<Config_DMAC0>_dmacni_interrupt
r_dmacn_callback_transfer_end
r_dmacn_callback_transfer_escape_end－<Config_DMAC0>.hr_cg_dmac_user.cr_cg_dmac.h
イベントリンクコント <Config_ELC>.c
ローラ<Config_ELC>_user.c<Config_ELC>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

r_dmac_dmac74i_interrupt
r_dmacn_callback_transfer_end
r_dmacn_callback_transfer_escape_end－
R_<Config_ELC>_Create
R_<Config_ELC>_Start
R_<Config_ELC>_Stop
R_<Config_ELC>_GenerateSoftwareEvent
R_<Config_ELC>_Set_PortBuffern
R_<Config_ELC>_Get_PortBuffern
R_<Config_ELC>_Create_UserInit
r_<Config_ELC>_elsrni_interrupt－

Page 9 of 533

スマート・コンフィグレータ

表 2.5

2. 出力ファイル

出力ファイル(5/13)
周辺機能

汎用 PWM タイマ

ファイル名<Config_GPT0>.c<Config_GPT0>_user.c

API 関数名
R_<Config_GPT0>_Create
R_<Config_GPT0>_Start
R_<Config_GPT0>_Stop
R_<Config_GPT0>_HardwareStart
R_<Config_GPT0>_HardwareStop
R_<Config_GPT0>_ETGI_Start
R_<Config_GPT0>_ETGI_Stop
R_<Config_GPT0>_Software_Clear
R_<Config_GPT0>_Create_UserInit
r_<Config_GPT0>_gtcimn_interrupt
r_<Config_GPT0>_gtcivn_interrupt
r_<Config_GPT0>_gtciun_interrupt
r_<Config_GPT0>_gdten_interrupt<Config_GPT0>.h－r_cg_gpt_user.c

r_gpt_etgin_interrupt
r_gpt_etgip_interrupt

r_cg_gpt.h－

グループスキャンモー <Config_S12AD0>.c
ド S12AD<Config_S12AD0>_user.c<Config_S12AD0>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

R_<Config_S12AD0>_Create
R_<Config_S12AD0>_Start
R_<Config_S12AD0>_Stop
R_<Config_S12AD0>_Get_ValueResult
R_<Config_S12AD0>_Set_CompareValue
R_<Config_S12AD0>_Set_CompareAValue
R_<Config_S12AD0>_Set_CompareBValue
R_<Config_S12AD0>_Create_UserInit
r_<Config_S12AD0>_interrupt
r_<Config_S12AD0>_compare_interrupt
r_<Config_S12AD0>_compare_interruptA
r_<Config_S12AD0>_compare_interruptB
r_<Config_S12AD0>_groupb_interrupt
r_<Config_S12AD0>_groupc_interrupt－

Page 10 of 533

スマート・コンフィグレータ

表 2.6

2. 出力ファイル

出力ファイル(6/13)
周辺機能

I2C マスタモード

ファイル名<Config_RIIC0>.c<Config_RIIC0>_user.c

R_<Config_RIIC0>_Create
R_<Config_RIIC0>_Start
R_<Config_RIIC0>_Stop
R_<Config_RIIC0>_Master_Send
R_<Config_RIIC0>_Master_Send_Without_Stop
R_<Config_RIIC0>_Master_Receive
R_<Config_RIIC0>_IIC_StartCondition
R_<Config_RIIC0>_IIC_StopCondition
R_<Config_RIIC0>_Create_UserInit
r_<Config_RIIC0>_error_interrupt
r_<Config_RIIC0>_receive_interrupt
r_<Config_RIIC0>_transmit_interrupt
r_<Config_RIIC0>_transmitend_interrupt
r_<Config_RIIC0>_callback_error
r_<Config_RIIC0>_callback_transmitend
r_<Config_RIIC0>_callback_receiveend<Config_RIIC0>.h－<Config_SCI0>.c

R_<Config_SCI0>_Create
R_<Config_SCI0>_Start
R_<Config_SCI0>_Stop
R_<Config_SCI0>_IIC_Master_Send
R_<Config_SCI0>_IIC_Master_Receive
R_<Config_SCI0>_IIC_StartCondition
R_<Config_SCI0>_IIC_StopCondition
R_<Config_SCI0>_Create_UserInit
r_<Config_SCI0>_receive_interrupt
r_<Config_SCI0>_transmit_interrupt
r_<Config_SCI0>_transmitend_interrupt
r_<Config_SCI0>_callback_transmitend
r_<Config_SCI0>_callback_receiveend－<Config_SCI0>_user.c<Config_SCI0>.h
I2C スレーブモード

API 関数名<Config_RIIC0>.c<Config_RIIC0>_user.c<Config_RIIC0>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

R_<Config_RIIC0>_Create
R_<Config_RIIC0>_Start
R_<Config_RIIC0>_Stop
R_<Config_RIIC0>_Slave_Send
R_<Config_RIIC0>_Slave_Receive
R_<Config_RIIC0>_Create_UserInit
r_<Config_RIIC0>_error_interrupt
r_<Config_RIIC0>_receive_interrupt
r_<Config_RIIC0>_transmit_interrupt
r_<Config_RIIC0>_transmitend_interrupt
r_<Config_RIIC0>_callback_error
r_<Config_RIIC0>_callback_transmitend
r_<Config_RIIC0>_callback_receiveend－

Page 11 of 533

スマート・コンフィグレータ

表 2.7

2. 出力ファイル

出力ファイル(7/13)
周辺機能

割り込みコントローラ

ファイル名<Config_ICU>.c<Config_ICU>_user.c<Config_ICU>.h
消費電力低減機能<Config_LPC>.c<Config_LPC>_user.c
ローパワータイマ

R_<Config_ICU>_Create
R_<Config_ICU>_IRQn_Start
R_<Config_ICU>_IRQn_Stop
R_<Config_ICU>_Software_Start
R_<Config_ICU>_Software_Stop
R_<Config_ICU>_SoftwareInterrupt_Generate
R_<Config_ICU>_Software2_Start
R_<Config_ICU>_Software2_Stop
R_<Config_ICU>_SoftwareInterrupt2_Generate
R_<Config_ICU>_Create_UserInit
r_<Config_ICU>_irqn_interrupt
r_<Config_ICU>_software_interrupt
r_<Config_ICU>_software2_interrupt
r_<Config_ICU>_nmi_interrupt－
R_<Config_LPC>_Create
R_<Config_LPC>_AllModuleClockStop
R_<Config_LPC>_Sleep
R_<Config_LPC>_DeepSleep
R_<Config_LPC>_SoftwareStandby
R_<Config_LPC>_DeepSoftwareStandby
R_<Config_LPC>_ChangeOperatingPowerControl
R_<Config_LPC>_ChangeSleepModeReturnClock
R_<Config_LPC>_SetVOLSR_PGAVLS
R_<Config_LPC>_Create_UserInit<Config_LPC>.h－<Config_LPT>.c

R_<Config_LPT>_Create
R_<Config_LPT>_Start
R_<Config_LPT>_Stop
R_<Config_LPT>_Create_UserInit<Config_LPT>_user.c
ノーマルモード

API 関数名<Config_LPT>.h－<Config_MTU0>.c

R_<Config_MTU0>_Create
R_<Config_MTU0>_Start
R_<Config_MTU0>_Stop
R_<Config_MTU0>_Create_UserInit
r_<Config_MTU0>_tgimn_interrupt
r_<Config_MTU0>_tginm_interrupt
r_<Config_MTU0>_tcivn_interrupt
r_<Config_MTU0>_tcinv_interrupt<Config_MTU0>_user.c<Config_MTU0>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024－

Page 12 of 533

スマート・コンフィグレータ

表 2.8

2. 出力ファイル

出力ファイル(8/13)
周辺機能

位相計数モードタイマ

ファイル名<Config_MTU1>.c<Config_MTU1>_user.c<Config_MTU1>.h
ポートアウトプットイ <Config_POE>.c
ネーブル<Config_POE>_user.c

ポート

API 関数名
R_<Config_MTU1>_Create
R_<Config_MTU1>_Start
R_<Config_MTU1>_Stop
R_<Config_MTU1_MTU2>_MTU_Start
R_<Config_MTU1_MTU2>_MTU_Stop
R_<Config_MTU1>_Create_UserInit
r_<Config_MTU1>_tgimn_interrupt
r_<Config_MTU1>_tginm_interrupt
r_<Config_MTU1>_tcivn_interrupt
r_<Config_MTU1>_tcinv_interrupt
r_<Config_MTU1>_tciun_interrupt
r_<Config_MTU1>_tcinu_interrupt－
R_<Config_POE>_Create
R_<Config_POE>_Start
R_<Config_POE>_Stop
R_<Config_POE>_Set_HiZ_MTUn
R_<Config_POE>_Clear_HiZ_MTUn
R_<Config_POE>_Set_HiZ_GPTn
R_<Config_POE>_Clear_HiZ_GPTn
R_<Config_POE>_Create_UserInit
r_<Config_POE>_oein_interrupt<Config_POE>.h－<Config_PORT>.c

R_<Config_PORT>_Create<Config_PORT>_user.c

R_<Config_PORT>_Create_UserInit<Config_PORT>.h－

プログラマブルパルス <Config_PPG0>.c

R_<Config_PPG0>_Create

ジェネレータ<Config_PPG0>_user.c

R_<Config_PPG0>_Create_UserInit<Config_PPG0>.h－<Config_MTU0>.c

R_<Config_MTU0>_Create
R_<Config_MTU0>_Start
R_<Config_MTU0>_Stop<Config_MTU0>_user.c

R_<Config_MTU0>_Create_UserInit
r_<Config_MTU0>_tgimn_interrupt
r_<Config_MTU0>_tginm_interrupt
r_<Config_MTU0>_tcivn_interrupt
r_<Config_MTU0>_tcinv_interrupt<Config_MTU0>.h－

PWM モードタイマ

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 13 of 533

スマート・コンフィグレータ

表 2.9

2. 出力ファイル

出力ファイル(9/13)
周辺機能

リアルタイムクロック

ファイル名<Config_RTC>.c<Config_RTC>_user.c

リモコン信号受信機能

API 関数名
R_<Config_RTC>_Create
R_<Config_RTC>_Start
R_<Config_RTC>_Stop
R_<Config_RTC>_Restart
R_<Config_RTC>_Restart_BinaryCounter
R_<Config_RTC>_Set_CalendarCounterValue
R_<Config_RTC>_Get_CalendarCounterValue
R_<Config_RTC>_Get_CalendarTimeCaptureValuen
R_<Config_RTC>_Set_BinaryCounterValue
R_<Config_RTC>_Get_BinaryCounterValue
R_<Config_RTC>_Get_BinaryTimeCaptureValuen
R_<Config_RTC>_Set_RTCOUTOn
R_<Config_RTC>_Set_RTCOUTOff
R_<Config_RTC>_Set_CalendarAlarm
R_<Config_RTC>_Set_BinaryAlarm
R_<Config_RTC>_Set_ConstPeriodInterruptOn
R_<Config_RTC>_Set_ConstPeriodInterruptOff
R_<Config_RTC>_Set_CarryInterruptOn
R_<Config_RTC>_Set_CarryInterruptOff
R_<Config_RTC>_Enable_Alarm_Interruptf
R_<Config_RTC>_Disable_Alarm_Interrupt
R_<Config_RTC>_Create_UserInit
r_<Config_RTC>_alm_interrupt
r_<Config_RTC>_prd_interrupt
r_<Config_RTC>_cup_interrupt<Config_RTC>.h－<Config_REMC0>.c

R_<Config_REMC0>_Create
R_<Config_REMC0>_Start
R_<Config_REMC0>_Stop
R_<Config_REMC0>_Read
R_<Config_REMC0>_Create_UserInit
r_<Config_REMC0>_remcin_interrupt
r_<Config_REMC0>_callback_comparematch
r_<Config_REMC0>_callback_receiveerror
r_<Config_REMC0>_callback_receiveend
r_<Config_REMC0>_callback_bufferfull
r_<Config_REMC0>_callback_header
r_<Config_REMC0>_callback_data0
r_<Config_REMC0>_callback_data1
r_<Config_REMC0>_callback_specialdata<Config_REMC0>_user.c<Config_REMC0>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024－

Page 14 of 533

スマート・コンフィグレータ

表 2.102. 出力ファイル

出力ファイル(10/13)

周辺機能

ファイル名

SCI/SCIF 調 歩 同 期 式 <Config_SCI0>.c
モード

API 関数名
R_<Config_SCI0>_Create
R_<Config_SCI0>_Start
R_<Config_SCI0>_Stop
R_<Config_SCI0>_Serial_Send
R_<Config_SCI0>_Serial_Receive
R_<Config_SCI0>_Serial_Multiprocessor_Send
R_<Config_SCI0>_Serial_Multiprocessor_Receive<Config_SCI0>_user.c

R_<Config_SCI0>_Create_UserInit
r_<Config_SCI0>_transmitend_interrupt
r_<Config_SCI0>_transmit_interrupt
r_<Config_SCI0>_receive_interrupt
r_<Config_SCI0>_receiveerror_interrupt
r_<Config_SCI0>_teif_interrupt
r_<Config_SCI0>_txif_interrupt
r_<Config_SCI0>_rxif_interrupt
r_<Config_SCI0>_drif_interrupt
r_<Config_SCI0>_erif_interrupt
r_<Config_SCI0>_brif_interrupt
r_<Config_SCI0>_callback_transmitend
r_<Config_SCI0>_callback_receiveend
r_<Config_SCI0>_callback_receiveerror
r_<Config_SCI0>_callback_error<Config_SCI0>.h－

SCI/SCIF ク ロ ッ ク 同 <Config_SCI0>.c
期式モード

R_<Config_SCI0>_Create
R_<Config_SCI0>_Start
R_<Config_SCI0>_Stop
R_<Config_SCI0>_Serial_Send
R_<Config_SCI0>_Serial_Receive
R_<Config_SCI0>_Serial_Send_Receive<Config_SCI0>_user.c

R_<Config_SCI0>_Create_UserInit
r_<Config_SCI0>_transmitend_interrupt
r_<Config_SCI0>_transmit_interrupt
r_<Config_SCI0>_receive_interrupt
r_<Config_SCI0>_receiveerror_interrupt
r_<Config_SCI0>_teif_interrupt
r_<Config_SCI0>_txif_interrupt
r_<Config_SCI0>_rxif_interrupt
r_<Config_SCI0>_erif_interrupt
r_<Config_SCI0>_brif_interrupt
r_<Config_SCI0>_callback_transmitend
r_<Config_SCI0>_callback_receiveend
r_<Config_SCI0>_callback_receiveerror
r_<Config_SCI0>_callback_error<Config_SCI0>.h－

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 15 of 533

スマート・コンフィグレータ

表 2.112. 出力ファイル

出力ファイル(11/13)

周辺機能

ファイル名

シングルスキャンモー <Config_S12AD0>.c
ド S12ADAPI 関数名
R_<Config_S12AD0>_Create
R_<Config_S12AD0>_Start
R_<Config_S12AD0>_Stop
R_<Config_S12AD0>_Get_ValueResult
R_<Config_S12AD0>_Set_CompareValue
R_<Config_S12AD0>_Set_CompareAValue
R_<Config_S12AD0>_Set_CompareBValue<Config_S12AD0>_user.c

R_<Config_S12AD0>_Create_UserInit
r_<Config_S12AD0>_interrupt
r_<Config_S12AD0>_compare_interrupt
r_<Config_S12AD0>_compare_interruptA
r_<Config_S12AD0>_compare_interruptB<Config_S12AD0>.h－

スマートカードインタ <Config_SCI0>.c
フェース<Config_SCI0>_user.c<Config_SCI0>.h
SPI クロック同期式モ <Config_RSPI0>.c
ード<Config_RSPI0>_user.c<Config_RSPI0>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

R_<Config_SCI0>_Create
R_<Config_SCI0>_Start
R_<Config_SCI0>_Stop
R_<Config_SCI0>_SmartCard_Send
R_<Config_SCI0>_SmartCard_Receive
R_<Config_SCI0>_Create_UserInit
r_<Config_SCI0>_transmit_interrupt
r_<Config_SCI0>_receive_interrupt
r_<Config_SCI0>_receiveerror_interrupt
r_<Config_SCI0>_callback_transmitend
r_<Config_SCI0>_callback_receiveend
r_<Config_SCI0>_callback_receiveerror－
R_<Config_RSPI0>_Create
R_<Config_RSPI0>_Start
R_<Config_RSPI0>_Stop
R_<Config_RSPI0>_Send
R_<Config_RSPI0>_Send_Receive
R_<Config_RSPI0>_SPI_Master_Send
R_<Config_RSPI0>_SPI_Master_Send_Receive
R_<Config_RSPI0>_SPI_Slave_Send
R_<Config_RSPI0>_SPI_Slave_Send_Receive
R_<Config_RSPI0>_Create_UserInit
r_<Config_RSPI0>_receive_interrupt
r_<Config_RSPI0>_transmit_interrupt
r_<Config_RSPI0>_error_interrupt
r_<Config_RSPI0>_idle_interrupt
r_<Config_RSPI0>_transmitend_interrupt
r_<Config_RSPI0>_receiveerror_interrupt
r_<Config_RSPI0>_callback_receiveend
r_<Config_RSPI0>_callback_transmitend
r_<Config_RSPI0>_callback_error－

Page 16 of 533

スマート・コンフィグレータ

表 2.122. 出力ファイル

出力ファイル(12/13)

周辺機能
SPI 動作モード

ファイル名<Config_RSPI0>.c<Config_RSPI0>_user.c

電圧検出回路ウォッチドッグタイマ

API 関数名
R_<Config_RSPI0>_Create
R_<Config_RSPI0>_Start
R_<Config_RSPI0>_Stop
R_<Config_RSPI0>_Send
R_<Config_RSPI0>_Send_Receive
R_<Config_RSPI0>_Create_UserInit
r_<Config_RSPI0>_receive_interrupt
r_<Config_RSPI0>_transmit_interrupt
r_<Config_RSPI0>_error_interrupt
r_<Config_RSPI0>_idle_interrupt
r_<Config_RSPI0>_callback_receiveend
r_<Config_RSPI0>_callback_transmitend
r_<Config_RSPI0>_callback_error<Config_RSPI0>.h－<Config_LVD1>.c

R_<Config_LVD1>_Create
R_<Config_LVD1>_Start
R_<Config_LVD1>_Stop<Config_LVD1>_user.c

R_<Config_LVD1>_Create_UserInit
r_<Config_LVD1>_lvdn_interrupt<Config_LVD1>.h－<Config_WDT>.c

R_<Config_WDT>_Create
R_<Config_WDT>_Restart
R_<Config_WDT>_Create_UserInit
r_<Config_WDT>_wuni_interrupt
r_<Config_WDT>_iwuni_interrupt
r_<Config_WDT>_nmi_interrupt<Config_WDT>_user.c<Config_WDT>.h
連 続 ス キ ャ ン モ ー ド <Config_DSAD0>.c
DSAD<Config_DSAD0>_user.c<Config_DSAD0>.h
シングルスキャンモー <Config_DSAD0>.c
ド DSAD<Config_DSAD0>_user.c<Config_DSAD0>.h

R20UT4360JJ0109 Rev.1.09
Oct.20.2024－
R_<Config_DSAD0>_Create
R_<Config_DSAD0>_Start
R_<Config_DSAD0>_Stop
R_<Config_DSAD0>_Set_SoftwareTrigger
R_<Config_DSAD0>_Get_ValueResult
R_<Config_DSAD0>_Set_Chm_DisconnectDetection
R_<Config_DSAD0>_Create_UserInit
r_<Config_DSAD0>_adin_interrupt
r_<Config_DSAD0>_scanendn_interrupt－
R_<Config_DSAD0>_Create
R_<Config_DSAD0>_Start
R_<Config_DSAD0>_Stop
R_<Config_DSAD0>_Set_SoftwareTrigger
R_<Config_DSAD0>_Get_ValueResult
R_<Config_DSAD0>_Set_Chm_DisconnectDetection
R_<Config_DSAD0>_Create_UserInit
r_<Config_DSAD0>_adin_interrupt
r_<Config_DSAD0>_scanendn_interrupt－

Page 17 of 533

スマート・コンフィグレータ

表 2.132. 出力ファイル

出力ファイル(13/13)

周辺機能

ファイル名

Δ - Σ モ ジ ュ ー ル イ ン <Config_DSMIF0>.c

API 関数名<Config_DSMIF0>_user.c

R_<Config_DSMIF0>_Create
R_<Config_DSMIF0>_Start
R_<Config_DSMIF0>_Stop
R_<Config_DSMIF0>_Create_UserInit
r_<Config_DSMIF0>_ocdin_interrupt
r_<Config_DSMIF0>_scdin_interrupt
r_<Config_DSMIF0>_sumein_interrupt<Config_DSMIF0>.h

－

タフェース

アナログフロントエン <Config_AFE>.c

R_<Config_AFE>_Createド<Config_AFE>_user.c

R_<Config_AFE>_Create_UserInit<Config_AFE>.h－<Config_MTU3_MTU4>.c

R_<Config_MTU3_MTU4>_Create
R_<Config_MTU3_MTU4>_StartTimerCount
R_<Config_MTU3_MTU4>_StopTimerCount
R_<Config_MTU3_MTU4>_StartTimerCtrl
R_<Config_MTU3_MTU4>_StopTimerCtrl
R_<Config_MTU3_MTU4>_UpdDuty
R_<Config_MTU3_MTU4>_StartAD
R_<Config_MTU3_MTU4>_StopAD
R_<Config_MTU3_MTU4>_AdcGetConvVal
R_<Config_MTU3_MTU4>_Create_UserInit
r_<Config_MTU3_MTU4>_CrestInterrupt
r_<Config_MTU3_MTU4>_ad_interrupt－

モータ(相補 PWM モードタイ
マ, シングルスキャン
モード S12AD)<Config_MTU3_MTU4>_user.c<Config_MTU3_MTU4>.h
LCD コントローラ<Config_LCD>.c

R_<Config_LCD>_Create
R_<Config_LCD>_Start
R_<Config_LCD>_Stop
R_<Config_LCD>_Voltage_On
R_<Config_LCD>_Voltage_Off<Config_LCD>_user.c

R_<Config_LCD>_Create_UserInit<Config_LCD>.h－

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 18 of 533

スマート・コンフィグレータ

3.

3. 初期化初期化

本章では、コード生成が出力するファイルによる初期化の流れについて説明します。
PowerOn_Reset_PC
割り込みテーブルレジスタ設定
例外テーブルレジスタ設定
単精度浮動小数点ステータスワード設定

青枠の処理は、
FIT ボードサポートパッ
ケージモジュールの処理となります。
詳細は、アプリケーション
ノート(R01AN1685)を参照してください。

mcu_clock_setup
システムクロック初期化
CLKOUT 端子出力初期化
ユーザウォームスタート時前処理
C ランタイム環境初期化
bsp_ram_initialize
RAM 初期化
init_iolib
C ライブラリ初期化
bsp_interrupt_open
コールバック関数配列初期化

bsp_maapped_interrupt_open
選択式割り込み初期化
bsp_register_protect_open
プロテクトレジスタ制御用変数初期化
hardware_setup
フラッシュメモリ ROM キャッシュ無効化
ポート設定
割り込み設定R_Systeminit
周辺機能初期化
bsp_non_existent_port_init
未搭載ポート初期化
bsp_adc_initial_configure
12 ビット A/D コンバータ初期化
bsp_bsc_initial_configure
拡張バスマスタ優先度制御レジスタ設定
プロセッサステータスワード設定
バスエラー割り込み有効化
Main 処理

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 19 of 533

スマート・コンフィグレータ

4.

4. API 関数

API 関数

本章では、コード生成が出力する API 関数について説明します。

4.1

概要

以下に、コード生成が API 関数を出力する際の命名規則を示します。
- グローバル関数名
先頭に “R” を付与し、構成単語の先頭のみ大文字。
ただし、ユーザが変更可能な<>内は、大文字、小文字ともに使用できます。
<>内に設定されるデフォルトの名前は、”Config”と周辺機能名、チャネル番号を付与します。
- スタティック関数名
先頭に “r” を付与し、全て小文字。
ただし、ユーザが変更可能な<>内は、大文字、小文字ともに使用できます。
<>内に設定されるデフォルトの名前は、”Config”と周辺機能名、チャネル番号を付与します。
- マクロ名すべて大文字。
なお、先頭に “ 数字 ” が付与されている場合、該当数字（16 進数値）とマクロ値は同値。
- ローカル変数名
すべて小文字。
- グローバル変数名
先頭に “g” を付与し、構成単語の先頭のみ大文字。
- グローバル変数へのポインタ名
先頭に “gp” を付与し、構成単語の先頭のみ大文字。
- 列挙指定子 enum の要素名
すべて大文字。
備考

スマート・コンフィグレータの生成するコードには、レジスタの反映待ち処理等でfor 文、
while 文、do while 文（ループ処理）を使用しています。
無限ループに対するフェールセーフ処理が必要な場合は、キーワード「WAIT_LOOP」を検索し、無限ループの可能性のあるコードを確認の上、処理を追加してください。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 20 of 562

スマート・コンフィグレータ

4. API 関数

関数リファレンス

4.2

本節では、コード生成が出力する API 関数について、次の記述フォーマットに従って説明します。
図 4.1

API 関数の記述フォーマット

(1) 名称API 関数の名称を示しています。
(2) 機能API 関数の機能概要を示しています。
(3) ［指定形式］
API 関数を C 言語で呼び出す際の記述形式を示しています。
(4) ［引数］
API 関数の引数を次の形式で示しています。
I/O

引数

説明

(a)

(b)

(c)

(a)

I/O
引数の種類

(b)

I

…

入力引数

O

…

出力引数

引数
引数のデータタイプ

(c)

説明
引数の説明

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 21 of 562

スマート・コンフィグレータ

4. API 関数(5) ［戻り値］
API 関数からの戻り値を次の形式で示しています。

(a)

マクロ

説明

(a)

(b)

マクロ
戻り値のマクロ(b)

説明
戻り値の説明R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 22 of 562

スマート・コンフィグレータ

4. API 関数

共通

4.2.1

以下に、コード生成ツールが共通用として出力する API 関数の一覧を示します。
表 4.1

共通用 API 関数
API 関数名

機能概要

r_undefined_exception

未定義命令例外の発生に伴う処理を行います。

PowerON_Reset

リセットの発生に伴う処理を行います。

hardware_setup

各種ハードウエアを制御するうえで必要となる初期化処理を行います。

R_Systeminit

各種周辺機能を制御するうえで必要となる初期化処理を行います。

R_CGC_Create

クロック発生回路を制御するうえで必要となる初期化処理を行います。
クロック発生回路に関するユーザ独自の初期化処理を行います。

R_CGC_Create_UserInit
R_Interrupt_Create
R_Pins_Create
main

R20UT4360JJ0109 Rev.1.09
Oct.20.2024「割り込み」タブから設定したグループ割り込みや高速割り込みの設定を行います。
「端子」タブから設定したマルチファンクションピンコントロー
ラへの設定を行います。
main 関数です。

Page 23 of 562

スマート・コンフィグレータ

4. API 関数

r_undefined_exception
未定義命令例外の発生に伴う処理を行います。
備考

本 API 関数は、未定義命令（実装されていない命令）の実行を検出した際に発生する未定義
命令例外に対応した割り込み処理として呼び出されます。

[指定形式]
void

r_undefined_exception ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 24 of 562

スマート・コンフィグレータ

4. API 関数

PowerON_Reset
リセットの発生に伴う処理を行います。
備考

本 API 関数は、パワーオンリセット回路による内部リセットに対応した割り込み処理として呼び出されます。

[指定形式]
void

PowerON_Reset ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 25 of 562

スマート・コンフィグレータ

4. API 関数

hardware_setup
各種ハードウエアを制御するうえで必要となる初期化処理を行います。
備考

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

[指定形式]
void

hardware_setup ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 26 of 562

スマート・コンフィグレータ

4. API 関数

R_Systeminit
各種周辺機能を制御するうえで必要となる初期化処理を行います。
備考

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

[指定形式]
void

R_Systeminit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 27 of 562

スマート・コンフィグレータ

4. API 関数

R_CGC_Create
クロック発生回路を制御するうえで必要となる初期化処理を行います。
備考

本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_CGC_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 28 of 562

スマート・コンフィグレータ

4. API 関数

R_CGC_Create_UserInit
クロック発生回路に関するユーザ独自の初期化処理を行います。
備考

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

[指定形式]
void

R_CGC_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 29 of 562

スマート・コンフィグレータ

4. API 関数

R_Interrupt_Create
グループ割り込みや高速割り込みの設定を行います。
備考

本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_Interrupt_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 30 of 562

スマート・コンフィグレータ

4. API 関数

R_Pins_Create
マルチファンクションピンコントローラへの設定を行います。

[指定形式]
void

R_Pins_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 31 of 562

スマート・コンフィグレータ

4. API 関数

main
main 関数です。
備考

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

[指定形式]
void

main ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 32 of 562

スマート・コンフィグレータ

4.2.2

4. API 関数

8 ビットタイマ

以下に、コード生成ツールが 8 ビットタイマ用として出力する API 関数の一覧を示します。
表 4.2

8 ビットタイマ用 API 関数
API 関数名

機能概要

R_<Config_TMR0>_Start

8 ビットタイマを制御するうえで必要となる初期化処理を行います。
カウントを開始します。

R_<Config_TMR0>_Stop

カウントを終了します。

R_<Config_TMR0>_Create_UserInit

8 ビットタイマに関するユーザ独自の初期化処理を行います。

r_<Config_TMR0>_cmimn_interrupt

コンペアマッチ割り込みの発生に伴う処理を行います。

r_<Config_TMR0>_ovin_interrupt

オーバフロー割り込みの発生に伴う処理を行います。

R_<Config_TMR0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 33 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_TMR0>_Create
8 ビットタイマを制御するうえで必要となる初期化処理を行います。
備考

本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_TMR0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 34 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_TMR0>_Start
カウントを開始します。

[指定形式]
void

R_<Config_TMR0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 35 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_TMR0>_Stop
カウントを終了します。

[指定形式]
void

R_<Config_TMR0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 36 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_TMR0>_Create_UserInit
8 ビットタイマに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_TMR0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_TMR0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 37 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_TMR0>_cmimn_interrupt
コンペアマッチ割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_TMR0>_cmimn_interrupt ( void );n はチャネル番号を、m はタイマコンスタントレジスタ番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 38 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_TMR0>_ovin_interrupt
オーバフロー割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_TMR0>_ovin_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 39 of 562

スマート・コンフィグレータ

4. API 関数

使用例
ワンショットタイマとして使用する
main.c#include "r_smc_entry.h"void main(void){/* Start TMR channel 0 counter */R_Config_TMR0_Start();while (1U){
nop();}}
Config_TMR0_user.cstatic void r_Config_TMR0_cmia0_interrupt(void){/* Start user code for r_Config_TMR0_cmia0_interrupt. Do not edit comment generated here *//* Stop TMR channel 0 counter */R_Config_TMR0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 40 of 562

スマート・コンフィグレータ

4.2.3

4. API 関数

バス

以下に、コード生成ツールがバス用として出力する API 関数の一覧を示します。
表 4.3

バス用 API 関数
API 関数名

機能概要

R_<Config_BSC>_Create

バスを制御するうえで必要となる初期化処理を行います。

R_<Config_BSC>_Error_Monitoring_Start

バスエラー（不正アドレスアクセス）の検出を許可します。

R_<Config_BSC>_Error_Monitoring_Stop

バスエラー（不正アドレスアクセス）の検出を禁止します。

R_<Config_BSC>_InitializeSDRAM

SDRAM コントローラの初期化を行います。

R_<Config_BSC>_Create_UserInit

バスに関するユーザ独自の初期化処理を行います。

r_<Config_BSC>_buserr_interrupt

バスエラー（不正アドレスアクセス）の発生に伴う処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 41 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_BSC>_Create
バスを制御するうえで必要となる初期化処理を行います。
備考

本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_BSC>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 42 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_BSC>_Error_Monitoring_Start
バスエラー（不正アドレスアクセス）の検出を許可します。

[指定形式]
void

R_<Config_BSC>_Error_Monitoring_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 43 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_BSC>_Error_Monitoring_Stop
バスエラー（不正アドレスアクセス）の検出を禁止します。

[指定形式]
void

R_<Config_BSC>_Error_Monitoring_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 44 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_BSC>_InitializeSDRAM
SDRAM コントローラの初期化を行います。

[指定形式]
void

R_<Config_BSC>_InitializeSDRAM ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 45 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_BSC>_Create_UserInit
バスに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_BSC>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_BSC>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 46 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_BSC>_buserr_interrupt
バスエラー（不正アドレスアクセス）の発生に伴う処理を行います。
備考 1.
本 API 関数は、処理プログラムが不正なアドレス領域にアクセスした場合に発生するバ
スエラー（不正アドレスアクセス）に対応した割り込み処理として呼び出されます。
備考 2.
本 API 関数内でバスエラーステータスレジスタ 1（BERSR1）の MST ビットを読み出すことにより、バスエラーの発生要因となったバスマスタを確認することができます。
備考 3.
本 API 関数内でバスエラーステータスレジスタ 2（BERSR2）の ADDR ビットを読み出すことにより、バスエラーの発生要因となった不正アドレス（上位 13 ビット）を確認することができます。

[指定形式]
void

r_<Config_BSC>_buserr_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 47 of 562

スマート・コンフィグレータ

4. API 関数

使用例
バスエラーが発生したアクセスのアドレスを取得する
main.c#include "r_smc_entry.h"void main(void){/* Enable BUSERR interrupt in ICU */R_Config_BSC_Error_Monitoring_Start();while (1U){
nop();}}
Config_BSC_user.c/* Start user code for global. Do not edit comment generated here */volatile uint16_t g_bsc_buserr_addr;/* End user code. Do not edit comment generated here */void r_Config_BSC_buserr_interrupt(void){/* Start user code for r_Config_BSC_buserr_interrupt. Do not edit comment generated here *//* Restore an address that was accessed when a bus error occurred */if (1U == BSC.BERSR1.BIT.IA){
g_bsc_buserr_addr = ((uint16_t)(BSC.BERSR2.WORD)>>3U);}/* Clear the bus error status registers */BSC.BERCLR.BIT.STSCLR = 1U;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 48 of 562

スマート・コンフィグレータ

4.2.4

4. API 関数

クロック周波数精度測定回路

以下に、コード生成ツールがクロック周波数精度測定回路用として出力する API 関数の一覧を示しま
す。
表 4.4

クロック周波数精度測定回路用 API 関数
API 関数名

機能概要

R_<Config_CAC>_Start

クロック周波数精度測定回路を制御するうえで必要となる初期化処理を行います。
クロック周波数の精度測定を開始します。

R_<Config_CAC>_Stop

クロック周波数の精度測定を終了します。

R_<Config_CAC>_Create_UserInit

クロック周波数精度測定回路に関するユーザ独自の初期化処理を行います。

r_<Config_CAC>_mendf_interrupt

測定終了割り込みの発生に伴う処理を行います。

r_<Config_CAC>_mendi_interrupt（デバイスグループにより、API 関数名が異なります。）

r_<Config_CAC>_ferrf_interrupt

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

r_<Config_CAC>_ferri_interrupt（デバイスグループにより、API 関数名が異なります。）

r_<Config_CAC>_ovff_interrupt

オーバフロー割り込みの発生に伴う処理を行います。

r_<Config_CAC>_ovfi_interrupt（デバイスグループにより、API 関数名が異なります。）

R_<Config_CAC>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 49 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CAC>_Create
クロック周波数精度測定回路（CAC）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_CAC>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 50 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CAC>_Start
クロック周波数の精度測定を開始します。
備考
本 API 関数を実行する前に、CAC ステータスレジスタ(CASTR)をクリアしてください。
フラグが立ったままの場合、本関数実行と同時に割り込みが発生することがあります。

[指定形式]
void

R_<Config_CAC>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 51 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CAC>_Stop
クロック周波数の精度測定を終了します。

[指定形式]
void

R_<Config_CAC>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 52 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CAC>_Create_UserInit
クロック周波数精度測定回路（CAC）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_CAC>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_CAC>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 53 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CAC>_mendf_interrupt

r_<Config_CAC>_mendi_interrupt
測定終了割り込みの発生に伴う処理を行います。
備考
本 API 関数は、クロック周波数精度測定回路が基準信号の有効エッジを検出した場合に発生する測定終了割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_CAC>_mendf_interrupt ( void );void

r_<Config_CAC>_mendi_interrupt ( void );備考

デバイスグループにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 54 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CAC>_ferrf_interrupt

r_<Config_CAC>_ferri_interrupt
周波数エラー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、クロック周波数が有効範囲（下限値から上限値まで）を外れた場合に発生する周波数エラー割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_CAC>_ferrf_interrupt ( void );void

r_<Config_CAC>_ferri_interrupt ( void );備考

デバイスグループにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 55 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CAC>_ovff_interrupt

r_<Config_CAC>_ovfi_interrupt
オーバフロー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、カウンタがオーバフローした場合に発生するオーバフロー割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_CAC>_ovff_interrupt ( void );void

r_<Config_CAC>_ovfi_interrupt ( void );備考

デバイスグループにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 56 of 562

スマート・コンフィグレータ

4. API 関数

使用例
周波数エラーをカウントする
main.c#include "r_smc_entry.h"void main(void){/* Clear interrupt request flag */CAC.CAICR.BIT.FERRFCL = 1U;
CAC.CAICR.BIT.MENDFCL = 1U;
CAC.CAICR.BIT.OVFFCL = 1U;/* Enable clock frequency measurement */R_Config_CAC_Start();while (1U){
nop();}}
Config_CAC_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_cac_ferri_cnt;/* End user code. Do not edit comment generated here */void R_Config_CAC_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here *//* Reset the error countor */g_cac_ferri_cnt = 0U;/* End user code. Do not edit comment generated here */}void r_Config_CAC_ferri_interrupt(void){/* Start user code for r_Config_CAC_ferri_interrupt. Do not edit comment generated here *//* Add the error countor */g_cac_ferri_cnt++;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 57 of 562

スマート・コンフィグレータ

4.2.5

4. API 関数

コンパレータ

以下に、コード生成ツールがコンパレータ用として出力する API 関数の一覧を示します。
表 4.5

コンパレータ用 API 関数
API 関数名

機能概要

R_<Config_CMPB0>_Start

コンパレータを制御するうえで必要となる初期化処理を行います。
アナログ入力電圧の比較を開始します。

R_<Config_CMPB0>_Stop

アナログ入力電圧の比較を終了します。

R_<Config_CMPB0>_Create_UserInit

コンパレータに関するユーザ独自の初期化処理を行います。

r_<Config_CMPB0>_cmpbn_interrupt

コンパレータ Bn 割り込みの発生に伴う処理を行います。

R_<Config_CMPB0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 58 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMPB0>_Create
コンパレータを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_CMPB0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 59 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMPB0>_Start
アナログ入力電圧の比較を開始します。

[指定形式]
void

R_<Config_CMPB0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 60 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMPB0>_Stop
アナログ入力電圧の比較を終了します。

[指定形式]
void

R_<Config_CMPB0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 61 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMPB0>_Create_UserInit
コンパレータに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_CMPB0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_CMPB0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 62 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CMPB0>_cmpbn_interrupt
コンパレータ Bn 割り込みの発生に伴う処理を行います。
備考
本 API 関数は、アナログ入力電圧とリファレンス入力電圧の比較結果が変化した場合に発生するコンパレータ Bn 割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void
備考

r_<Config_CMPB0>_cmpbn_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 63 of 562

スマート・コンフィグレータ

4. API 関数

使用例
比較結果の変化でフラグを立てる
main.c#include "r_smc_entry.h"void main(void){/* Start comparator B0 */R_Config_CMPB0_Start();while (1U){
nop();}}
Config_CMPB0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_cmpb0_f;/* End user code. Do not edit comment generated here */void R_Config_CMPB0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here *//* Clear the flag */g_cmpb0_f = 0U;/* End user code. Do not edit comment generated here */}static void r_Config_CMPB0_cmpb0_interrupt(void){/* Start user code for r_Config_CMPB0_cmpb0_interrupt. Do not edit comment generated here*//* Set the flag */g_cmpb0_f = 1U;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 64 of 562

スマート・コンフィグレータ

4.2.6

4. API 関数

コンペアマッチタイマ

以下に、コード生成ツールがコンペアマッチタイマ（CMT/CMTW）用として出力する API 関数の一覧を示します。
表 4.6

コンペアマッチタイマ用 API 関数
API 関数名

機能概要

R_<Config_CMT0>_Start

コンペアマッチタイマ（CMT/CMTW）を制御するうえで必要となる初期化処理を行います。
カウントを開始します。

R_<Config_CMT0>_Stop

カウントを終了します。

R_<Config_CMT0>_Create_UserInit

コンペアマッチタイマ（CMT/CMTW）に関するユーザ独自の初期化処理を行います。

r_<Config_CMT0>_cmin_interrupt

コンペアマッチ割り込み（CMIn）の発生に伴う処理を行います。

r_<Config_CMT0>_cmwin_interrupt

コンペアマッチ割り込み（CMWIn）の発生に伴う処理を行います。

r_<Config_CMT0>_icmin_interrupt

インプットキャプチャ割り込みの発生に伴う処理を行います。

r_<Config_CMT0>_ocmin_interrupt

アウトプットコンペア割り込みの発生に伴う処理を行います。

R_<Config_CMT0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 65 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMT0>_Create
コンペアマッチタイマ（CMT/CMTW）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_CMT0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 66 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMT0>_Start
カウントを開始します。

[指定形式]
void

R_<Config_CMT0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 67 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMT0>_Stop
カウントを終了します。

[指定形式]
void

R_<Config_CMT0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 68 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CMT0>_Create_UserInit
コンペアマッチタイマ（CMT/CMTW）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_CMT0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_CMT0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 69 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CMT0>_cmin_interrupt
コンペアマッチ割り込み（CMIn）の発生に伴う処理を行います。
備考
本 API 関数は、現在カウント値 “ コンペアマッチタイマカウンタ（CMCNT）の値 ” と
規定カウント値 “ コンペアマッチタイマコンスタントレジスタ（CMCOR）の値 ” が一致した場合に発生するコンペアマッチ割り込み（CMIn）に対応した割り込み処理として呼び出されます。

[指定形式]
void
備考

r_<Config_CMT0>_cmin_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 70 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CMT0>_cmwin_interrupt
コンペアマッチ割り込み（CMWIn）の発生に伴う処理を行います。
備考
本 API 関数は、現在カウント値 “ コンペアマッチタイマカウンタ（CMWCNT）の値 ” と
規定カウント値 “ コンペアマッチタイマコンスタントレジスタ（CMWCOR）の値 ” が一致した場合に発生するコンペアマッチ割り込み（CMWIn）に対応した割り込み処理として呼び出されます。

[指定形式]
void
備考

r_<Config_CMT0>_cmwin_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 71 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CMT0>_icmin_interrupt
インプットキャプチャ割り込み の発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_CMT0>_icmin_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 72 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_CMT0>_ocmin_interrupt
アウトプットコンペア割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_CMT0>_ocmin_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 73 of 562

スマート・コンフィグレータ

4. API 関数

使用例
ワンショットタイマとして使用する
main.c#include "r_smc_entry.h"void main(void){/* Start CMT channel 0 counter */R_Config_CMT0_Start();while (1U){
nop();}}
Config_CMT0_user.cstatic void r_Config_CMT0_cmi0_interrupt(void){/* Start user code for r_Config_CMT0_cmi0_interrupt. Do not edit comment generated here *//* Stop CMT channel 0 counter */R_Config_CMT0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 74 of 562

スマート・コンフィグレータ

4.2.7

4. API 関数

相補 PWM モードタイマ

以下に、コード生成ツールが相補 PWM モードタイマ用として出力する API 関数の一覧を示します。
表 4.7

相補 PWM モードタイマ用 API 関数
API 関数名

機能概要

R_<Config_MTU3_MTU4>_Start

相補 PWM モードタイマを制御するうえで必要となる初期化処理を行います。
カウンタを開始します。

R_<Config_MTU3_MTU4>_Stop

カウンタを終了します。

R_<Config_MTU3_MTU4>_Create_UserInit

相補 PWM モードタイマに関するユーザ独自の初期化処理を行います。

r_<Config_MTU3_MTU4>_tgimn_interrupt

コンペアマッチ割り込みの発生に伴う処理を行います。

r_<Config_MTU3_MTU4>_cj_tgimj_interrupt

コンペアマッチ割り込みの発生に伴う処理を行います。

r_<Config_MTU3_MTU4>_cj_tcivj_interrupt

アンダフロー割り込みの発生に伴う処理を行います。

R_<Config_MTU3_MTU4>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 75 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_Create
相補 PWM モードタイマを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_MTU3_MTU4>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 76 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_Start
カウンタを開始します。

[指定形式]
void

R_<Config_MTU3_MTU4>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 77 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_Stop
カウンタを終了します。

[指定形式]
void

R_<Config_MTU3_MTU4>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 78 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_Create_UserInit
相補 PWM モードタイマに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_MTU3_MTU4>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_MTU3_MTU4>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 79 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU3_MTU4>_tgimn_interrupt
コンペアマッチ割り込みの発生に伴う処理を行います。
備考
本 API 関数は、現在カウント値 “ タイマカウンタ（TCNT）の値 ” と規定カウント値“ タイマジェネラルレジスタ（TGR）の値 ” が一致した場合に発生するコンペアマッチ
割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void
備考

r_<Config_MTU3_MTU4>_tgimn_interrupt ( void );n はチャネル番号を、m はタイマジェネラルレジスタ番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 80 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU3_MTU4>_cj_tgimj_interrupt
コンペアマッチ割り込みの発生に伴う処理を行います。
備考
本 API 関数は、現在カウント値 “ タイマカウンタ（TCNT）の値 ” と規定カウント値“ タイマジェネラルレジスタ（TGR）の値 ” が一致した場合に発生するコンペアマッチ
割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void
備考

r_<Config_MTU3_MTU4>_cj_tgimj_interrupt ( void );j はチャネル番号を、m はタイマジェネラルレジスタ番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 81 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU3_MTU4>_cj_tcivj_interrupt
アンダフロー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、タイマカウンタ（TCNT）がアンダフローした場合に発生するアンダフ
ロー割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void
備考

r_<Config_MTU3_MTU4>_cj_tcivj_interrupt ( void );j はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 82 of 562

スマート・コンフィグレータ

4. API 関数

使用例
U 相の波を上限まで徐々に大きくした後は下限まで徐々に小さくする処理を繰り返す
main.c#include "r_smc_entry.h"void main(void){/* Start the MTU6 channel counter */R_Config_MTU6_MTU7_Start();while (1U){
nop();}}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 83 of 562

スマート・コンフィグレータ

4. API 関数

Config_MTU6_MTU7_user.c/* Start user code for global. Do not edit comment generated here */volatile uint16_t gu_pulse_u;
volatile int8_t g_pulse_dir_u;/* End user code. Do not edit comment generated here */void R_Config_MTU6_MTU7_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */gu_pulse_u = _xxxx_6TGRB_VALUE;
g_pulse_dir_u = 1U;/* End user code. Do not edit comment generated here */}static void r_Config_MTU6_MTU7_tgib6_interrupt(void){/* Start user code for r_Config_MTU6_MTU7_tgib6_interrupt. Do not edit comment generated
here */
gu_pulse_u += g_pulse_dir_u;
if(gu_pulse_u == _xxxx_TCDRB_VALUE){
g_pulse_dir_u = -1;}
else if(gu_pulse_u == _xxxx_TDDRB_VALUE){
g_pulse_dir_u = 1;}
MTU6.TGRB = gu_pulse_u;
MTU6.TGRD = gu_pulse_u;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 84 of 562

スマート・コンフィグレータ

4.2.8

4. API 関数

連続スキャンモード S12AD

以下に、コード生成ツールが連続スキャンモード S12AD 用として出力する API 関数の一覧を示しま
す。
表 4.8

連続スキャンモード S12AD 用 API 関数
API 関数名

機能概要

R_<Config_S12AD0>_Start

連続スキャンモード S12AD を制御するうえで必要となる初期化処理を行います。
A/D 変換を開始します。

R_<Config_S12AD0>_Stop

A/D 変換を終了します。

R_<Config_S12AD0>_Get_ValueResult

変換結果を獲得します。

R_<Config_S12AD0>_Set_CompareValue

コンペアレベルの設定を行います。

R_<Config_S12AD0>_Set_CompareAValue

ウィンドウ A コンペアレベルの設定を行います。

R_<Config_S12AD0>_Set_CompareBValue

ウィンドウ B コンペアレベルの設定を行います。

R_<Config_S12AD0>_Create_UserInit

連続スキャンモード S12AD に関するユーザ独自の初期化処理を行います。

r_<Config_S12AD0>_interrupt

スキャン終了割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interrupt

コンペア割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interruptA

ウィンドウ A コンペア割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interruptB

ウィンドウ B コンペア割り込みの発生に伴う処理を行います。

R_<Config_S12AD0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 85 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Create
連続スキャンモード S12AD を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_S12AD0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 86 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Start
A/D 変換を開始します。

[指定形式]
void

R_<Config_S12AD0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 87 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Stop
A/D 変換を終了します。

[指定形式]
void

R_<Config_S12AD0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 88 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Get_ValueResult
変換結果を獲得します。

[指定形式]
void

R_<Config_S12AD0>_Get_ValueResult ( ad_channel_t channel, uint16_t * const buffer );[引数]
RX130，RX230/RX231 の場合
I/O
I

引数

ad_channel_t channel;

説明
チャネル番号ADCHANNEL0：入力チャネル AN000ADCHANNEL1：入力チャネル AN001

ADCHANNEL2：入力チャネル AN002

ADCHANNEL3：入力チャネル AN003

ADCHANNEL4：入力チャネル AN004

ADCHANNEL5：入力チャネル AN005

ADCHANNEL6：入力チャネル AN006

ADCHANNEL7：入力チャネル AN007

ADCHANNEL16：入力チャネル AN016

ADCHANNEL17：入力チャネル AN017

ADCHANNEL18：入力チャネル AN018

ADCHANNEL19：入力チャネル AN019

ADCHANNEL20：入力チャネル AN020

ADCHANNEL21：入力チャネル AN021

ADCHANNEL22：入力チャネル AN022

ADCHANNEL23：入力チャネル AN023

ADCHANNEL24：入力チャネル AN024

ADCHANNEL25：入力チャネル AN025

ADCHANNEL26：入力チャネル AN026

ADCHANNEL27：入力チャネル AN027

ADCHANNEL28：入力チャネル AN028

ADCHANNEL29：入力チャネル AN029

ADCHANNEL30：入力チャネル AN030

ADCHANNEL31：入力チャネル AN031

ADTEMPSENSOR：拡張アナログ入力（温度センサ出力）

ADINTERREFVOLT：拡張アナログ入力（内部基準電圧）O

uint16_t * const buffer;

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

ADSELFDIAGNOSIS：自己診断結果

ADDATADUPLICATION：ダブルトリガモード結果獲得した変換結果を格納する領域へのポインタ

Page 89 of 562

スマート・コンフィグレータ

4. API 関数

そのほかのデバイスの場合
引数

I/O
I

ad_channel_t channel;

説明
チャネル番号ADCHANNEL0：入力チャネル AN000ADCHANNEL1：入力チャネル AN001

ADCHANNEL2：入力チャネル AN002

ADCHANNEL3：入力チャネル AN003

ADCHANNEL4：入力チャネル AN004

ADCHANNEL5：入力チャネル AN005

ADCHANNEL6：入力チャネル AN006

ADCHANNEL7：入力チャネル AN007

ADCHANNEL8：入力チャネル AN008

ADCHANNEL9：入力チャネル AN009

ADCHANNEL10：入力チャネル AN010

ADCHANNEL11：入力チャネル AN011

ADCHANNEL12：入力チャネル AN012

ADCHANNEL13：入力チャネル AN013

ADCHANNEL14：入力チャネル AN014

ADCHANNEL15：入力チャネル AN015

ADCHANNEL16：入力チャネル AN016

ADCHANNEL17：入力チャネル AN017

ADCHANNEL18：入力チャネル AN018

ADCHANNEL19：入力チャネル AN019

ADCHANNEL20：入力チャネル AN020

ADTEMPSENSOR：拡張アナログ入力（温度センサ出力）

ADINTERREFVOLT：拡張アナログ入力（内部基準電圧）ADSELFDIAGNOSIS：自己診断結果

ADDATADUPLICATION：ダブルトリガモード結果

ADDATADUPLICATIONA ：ダブルトリガモード A 結果
ADDATADUPLICATIONB ：ダブルトリガモード B 結果
O

uint16_t * const buffer;獲得した変換結果を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 90 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareValue
コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 91 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareAValue
ウィンドウ A コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareAValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 92 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareBValue
ウィンドウ B コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareBValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 93 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Create_UserInit
連続スキャンモード S12AD に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_S12AD0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_S12AD0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 94 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_interrupt
スキャン終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 95 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interrupt
コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 96 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interruptA
ウィンドウ A コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interruptA ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 97 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interruptB
ウィンドウ B コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interruptB ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 98 of 562

スマート・コンフィグレータ

4. API 関数

使用例
初期設定コンペア条件に一致した AD 変換結果を取得した後、コンペア条件値を変更する
main.c#include "r_smc_entry.h"void main(void){/* Start the AD0 converter */R_Config_S12AD0_Start();while (1U){
nop();}}
Config_S12AD0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint16_t g_s12ad0_ch000_value;/* End user code. Do not edit comment generated here */void r_Config_S12AD0_compare_interrupt(void){/* Start user code for r_Config_S12AD0_compare_interrupt. Do not edit comment generated
here *//* Stop the AD0 converter */R_Config_S12AD0_Stop();/* Get result from the AD0 channel 0 (AN000) converter */R_Config_S12AD0_Get_ValueResult(ADCHANNEL0, (uint16_t *)&g_s12ad0_ch000_value);/* Set reference data for AD0 comparison */R_Config_S12AD0_Set_CompareValue(1000U, 3000U);/* Clear the compare flag */S12AD.ADCMPSR0.WORD = 0x00U;/* Start the AD0 converter */R_Config_S12AD0_Start();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 99 of 562

スマート・コンフィグレータ

4.2.9

4. API 関数

CRC 演算器

以下に、コード生成ツールが CRC 演算器用として出力する API 関数の一覧を示します。
表 4.9

CRC 演算器用 API 関数
API 関数名

R_<Config_CRC>_SetCRC8
R_<Config_CRC>_SetCRC16

機能概要
8 ビット CRC 演算（多項式：X8 + X2 + X + 1）を実施するうえ
で必要となる CRC 演算器の初期化処理を行います。
16 ビット CRC 演算（多項式：X16 + X15 + X2 + 1）を実施する
うえで必要となる CRC 演算器の初期化処理を行います。

R_<Config_CRC>_SetCCITT

16 ビット CRC 演算（多項式：X16 + X12 + X5 + 1）を実施する
うえで必要となる CRC 演算器の初期化処理を行います。

R_<Config_CRC>_SetCRC32

32 ビット CRC 演算（多項式：X32 + X26 + X23 + X22 + X16 +X12 + X11 + X10 + X8 + X7 + X5 + X4 + X2 + X + 1）を実施する
うえで必要となる CRC 演算器の初期化処理を行います。

R_<Config_CRC>_SetCRC32C

R_<Config_CRC>_Input_Data

32 ビット CRC 演算（多項式：X32 + X28 + X27 + X26 + X25 +X23 + X22 + X20 + X19 + X18 + X14 + X13 + X11 + X10 + X9 +X8 + X6 + 1）を実施するうえで必要となる CRC 演算器の初期化処理を行います。
CRC 演算を行うデータの初期値を設定します。

R_<Config_CRC>_Get_Result

演算結果を獲得します。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 100 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CRC>_SetCRC8
8 ビット CRC 演算（多項式：X8 + X2 + X + 1）を実施するうえで必要となる CRC 演算器の初期化処理を行います。

[指定形式]
void

R_<Config_CRC>_SetCRC8 ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 101 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CRC>_SetCRC16
16 ビット CRC 演算（多項式：X16 + X15 + X2 + 1）を実施するうえで必要となる CRC 演算器の初期化処理を行います。

[指定形式]
void

R_<Config_CRC>_SetCRC16 ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 102 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CRC>_SetCCITT
16 ビット CRC 演算（多項式：X16 + X12 + X5 + 1）を実施するうえで必要となる CRC 演算器の初期化処理を行います。

[指定形式]
void

R_<Config_CRC>_SetCCITT ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 103 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CRC>_SetCRC32
32 ビット CRC 演算（多項式：X32 + X26 + X23 + X22 + X16 + X12 + X11 + X10 + X8 + X7 + X5 + X4 + X2 +X + 1）を実施するうえで必要となる CRC 演算器の初期化処理を行います。

[指定形式]
void

R_<Config_CRC>_SetCRC32 ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 104 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CRC>_SetCRC32C
32 ビット CRC 演算（多項式：X32 + X28 + X27 + X26 + X25 + X23 + X22 + X20 + X19 + X18 + X14 + X13 + X11+ X10 + X9 + X8 + X6 + 1）を実施するうえで必要となる CRC 演算器の初期化処理を行います。

[指定形式]
void

R_<Config_CRC>_SetCRC32C ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 105 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CRC>_Input_Data
CRC 演算を行うデータの初期値を設定します。

[指定形式]
void

R_<Config_CRC>_Input_Data ( uint8_t data );void

R_<Config_CRC>_Input_Data ( uint32_t data );

[引数]
引数

I/O
I

I

CRC 演算を行うデータの初期値

uint8_t data;
引数

I/O

uint32_t data;

備考

説明

説明
CRC 演算を行うデータの初期値

デバイスグループにより、引数のサイズが異なります。

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 106 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_CRC>_Get_Result
演算結果を獲得します。

[指定形式]
void

R_<Config_CRC>_Get_Result ( uint16_t * const result );void

R_<Config_CRC>_Get_Result ( uint32_t * const result );

[引数]
引数

I/O
O

uint16_t * const result;
引数

I/O
O

uint32_t * const result;

備考

説明
獲得した演算結果を格納する領域へのポインタ

説明獲得した演算結果を格納する領域へのポインタ

デバイスグループにより、引数のサイズが異なります。

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 107 of 562

スマート・コンフィグレータ

4. API 関数

使用例 1
CRC コードを生成し、送信データに追加する
tx_func.c#include "r_smc_entry.h"volatile uint8_t tx_buf[2];volatile uint16_t result;void tx_func(void){/* Set CRC module using CRC8 algorithm */R_Config_CRC_SetCRC8();/* Restore transmit data */tx_buf[0] = 0xF0;/* Write data to CRC input register */R_Config_CRC_Input_Data(tx_buf[0]);/* Get result from CRC output register */R_Config_CRC_Get_Result((uint16_t *)&result);/* Restore CRC code */tx_buf[1] = (uint8_t)(result);/*** Transmit "tx_buf" ***/}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 108 of 562

スマート・コンフィグレータ

4. API 関数

使用例 2
解析した受信データから CRC コードを生成し、受信データが正しいかチェックする
rx_func.c#include "r_smc_entry.h"volatile uint8_t rx_buf[2];volatile uint16_t result;volatile uint8_t err_f;
void rx_func(void){/* Clare error flag */err_f = 0U;/*** Receive (Restore the receive data in "rx_buf") ***//* Set CRC module using CRC8 algorithm */R_Config_CRC_SetCRC8();/* Write data to CRC input register */R_Config_CRC_Input_Data(rx_buf[0]);/* Get result from CRC output register */R_Config_CRC_Get_Result((uint16_t *)&result);/* Check the receive data */if (rx_buf[1] != (uint8_t)(result)){/* Set error flag */err_f = 1U;}}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 109 of 562

スマート・コンフィグレータ

4.2.104. API 関数

D/A コンバータ

以下に、コード生成ツールが D/A コンバータ用として出力する API 関数の一覧を示します。
表 4.10D/A コンバータ用 API 関数
API 関数名

機能概要

R_<Config_DA>n_Start

D/A コンバータを制御するうえで必要となる初期化処理を行います。
D/A 変換を開始します。

R_<Config_DA>n_Stop

D/A 変換を終了します。

R_<Config_DA>n_Set_ConversionValue

D/A 変換を行うデータを設定します。

R_<Config_DA>_Sync_Start

D/A 一括変換を開始します。

R_<Config_DA>_Sync_Stop

D/A 一括変換を終了します。

R_<Config_DA>_Create_UserInit

D/A コンバータに関するユーザ独自の初期化処理を行います。

R_<Config_DA>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 110 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DA>_Create
D/A コンバータを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_DA>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 111 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DA>n_Start
D/A 変換を開始します。
備考 RX23E-B/RX26T/RX64M/RX651/RX65N/RX660/RX66N/RX66T/RX71M/RX72M/RX72N/RX72Tを使用する場合は、この関数は、R_<Config_DA>n_Set_ConversionValue の前に呼び出してください。

[指定形式]
void

R_<Config_DA>n_Start ( void );備考

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

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 112 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DA>n_Stop
D/A 変換を終了します。

[指定形式]
void

R_<Config_DA>n_Stop ( void );備考

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

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 113 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DA>n_Set_ConversionValue
D/A 変換を行うデータを設定します。

[指定形式]
void

R_<Config_DA>n_Set_ConversionValue ( uint16_t reg_value );備考

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

[引数]
I/O

引数

I

uint16_t reg_value;

説明
D/A 変換を行うデータ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 114 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DA>_Sync_Start
D/A 一括変換を開始します。
備考 RX64M/RX651/RX65N/RX66N/RX71M/RX72M/RX72N を使用する場合は、この関数は、
R_<Config_DA>n_Set_ConversionValue の前に呼び出してください。

[指定形式]
void

R_<Config_DA>_Sync_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 115 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DA>_Sync_Stop
D/A 一括変換を終了します。

[指定形式]
void

R_<Config_DA>_Sync_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 116 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DA>_Create_UserInit
D/A コンバータに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_DA>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_DA>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 117 of 562

スマート・コンフィグレータ

4. API 関数

使用例
チャネル 0，1 の D/A 変換を一括許可する
main.c#include "r_smc_entry.h"void main(void){/* Set the DA0 converter value */R_<Config_DA>0_Set_ConversionValue(1000U);/* Set the DA1 converter value */R_<Config_DA>1_Set_ConversionValue(2000U);/* Enable the DA0, DA1 synchronize converter */R_<Config_DA>_Sync_Start();while (1U){
nop();}}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 118 of 562

スマート・コンフィグレータ

4.2.11

4. API 関数

データ演算回路

以下に、コード生成ツールがデータ演算回路用として出力する API 関数の一覧を示します。
表 4.11

データ演算回路用 API 関数
API 関数名

R_<Config_DOC>_Create
R_<Config_DOC>SetMode

機能概要
データ演算回路を制御するうえで必要となる初期化処理を行います。
動作モード、およびデータ演算を行うデータの初期値を設定します。

R_<Config_DOC>_WriteData

データ演算を行う値（比較／加算／減算する値）を設定します。

R_<Config_DOC>_GetResult

演算結果を獲得します。

R_<Config_DOC>_ClearFlag

データ演算回路フラグをクリアします。

R_<Config_DOC>_Create_UserInit

データ演算回路に関するユーザ独自の初期化処理を行います。

r_<Config_DOC>_dopcf_interrupt

データ演算回路割り込みの発生に伴う処理を行います。

r_<Config_DOC>_dopci_interrupt（デバイスグループにより、API 関数名が異なります。）

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 119 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DOC>_Create
データ演算回路を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_DOC>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 120 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DOC>_SetMode
動作モード、およびデータ演算を行うデータの初期値を設定します。
本 API 関数はデバイスの DOC の機能に応じて、2 つのパラメータで定義されている API 関数と、3 つのパラメータで定義されている API 関数があります。
•

2 つのパラメータ（ “mode” と “value” ）で定義されている R_<Config_DOC>_SetMode

備考 1.

備考 2.

動 作 モ ー ド mode に デ ー タ 比 較 モ ー ド COMPARE_MISMATCH 、 ま た は
COMPARE_MATCH が指定された場合、基準となる 16 ビットのデータ value が DOC
データセッティングレジスタ（DODSR）に格納されます。
動 作 モ ー ド mode に デ ー タ 加 算 モ ー ド ADDITION 、 ま た は デ ー タ 減 算 モ ー ド
SUBTRACTION が指定された場合、初期値として 16 ビットのデータ value が DOC
データセッティングレジスタ（DODSR）に格納されます。

[指定形式]
void

R_<Config_DOC>_SetMode ( doc_mode_t mode, uint16_t value );

[引数]
I/O

引数

I

doc_mode_t mode;

uint16_t value;I

説明
動作モード（検出条件を含む）の種類
COMPARE_MISMATCH：データ比較モード（不一致）

COMPARE_MATCH：データ比較モード（一致）ADDITION：データ加算モード

SUBTRACTION：データ減算モード

比較演算の基準値、加算・減算の演算結果

[戻り値]
なし

•

3 つのパラメータ（ “mode” 、“value1” と “value2” ）で定義されている R_<Config_DOC>_SetMode

備考 1.

備考 2.

備考 3.

動作モード mode にデータ比較モードが指定されて、値が COMPARE_NEQ(等しくない)または COMPARE_EQ（等しい）または COMPARE_GT（より大きい）または COMPARE_LT（より小さい）の場合、16 ビット/32 ビットのデータ value が DOC データセッティングレジスタ 0（DODSR0）に格納されます。
動 作 モ ー ド mode に デ ー タ 加 算 モ ー ド ADDITION 、 ま た は デ ー タ 減 算 モ ー ド
SUBTRACTION が指定された場合、初期値として 16 ビット/32 ビットのデータ value
が DOC データセッティングレジスタ 0（DODSR0）に格納されます。
動 作 モ ー ド mode に デ ー タ 比 較 モ ー ド COMPARE_IN_RANGE 、 ま た は
COMPARE_OUT_RANGE が指定された場合、16 ビット/32 ビットのデータ value1(範囲の下限値) が DOC データセッティングレジスタ 0（DODSR0）に格納されます。16 ビ
ット/32 ビットのデータ value2(範囲の上限値) が DOC データセッティングレジスタ 1（DODSR1）に格納されます。

[指定形式]
void

R_<Config_DOC>_SetMode ( doc_mode_t mode, type value1, type value2 );R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 121 of 562

スマート・コンフィグレータ

4. API 関数

[引数]
I/O

引数

I

doc_mode_t mode;

説明
動作モード（検出条件を含む）の種類
COMPARE_NEQ：データ比較モード（等しくない）

COMPARE_EQ：データ比較モード（等しい）COMPARE_GT：データ比較モード（より大きい）

COMPARE_LT：データ比較モード（より小さい）

COMPARE_IN_RANGE：データ比較モード（範囲内）

COMPARE_OUT_RANGE ：データ比較モード（範囲外）

I

type value1;-

ADDITION：データ加算モード

SUBTRACTION：データ減算モード

範囲比較を除く比較演算の基準値、加算・減算の演算結果Itype value2;-

範囲比較の下限値-“type” は “uint16_t” もしくは “uint32_t” に指定できる-

範囲比較の上限値-“type” は “uint16_t” もしくは “uint32_t” に指定できる

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 122 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DOC>_WriteData
データ演算を行う値（比較／加算／減算する値）を設定します。

[指定形式]
void

R_<Config_DOC>_WriteData (type data);

[引数]
引数

I/O
I

type data;説明
データ演算を行う値“type” は “uint16_t” もしくは “uint32_t” に指定できる

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 123 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DOC>_GetResult
演算結果を獲得します。

[指定形式]
void

R_<Config_DOC>_GetResult ( type * const data );

[引数]
引数

I/O
O

type * const data;

説明
獲得した演算結果を格納する領域へのポインタ“type” は “uint16_t” もしくは “uint32_t” に指定できる

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 124 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DOC>_ClearFlag
データ演算回路フラグをクリアします。

[指定形式]
void

R_<Config_DOC>_ClearFlag ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 125 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DOC>_Create_UserInit
データ演算回路に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_DOC>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_DOC>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 126 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DOC>_dopcf_interrupt

r_<Config_DOC>_dopci_interrupt
データ演算回路割り込みの発生に伴う処理を行います。
備考
本 API 関数は、データの比較結果が検出条件を満足した場合、データの加算結果が0xFFFF よりも大きくなった場合、またはデータの減算結果が 0x0 よりも小さくなった
場合に発生するデータ演算回路割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_DOC>_dopcf_interrupt ( void );void

r_<Config_DOC>_dopci_interrupt ( void );備考

デバイスグループにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 127 of 562

スマート・コンフィグレータ

4. API 関数

使用例
データ加算モードで配列データを加算し、“FFFFh”より大きくなったとき割り込みで加算結果を取得する
その後データ比較不一致モードに変更し、配列データに"000h"以外を検出した場合に割り込みを発生させる
main.c#include "r_smc_entry.h"
extern volatile uint16_t data[16];void main(void){
uint8_t cnt;
while (1U){
for (cnt = 0; cnt < 16U; cnt++){/* Write new data to compare */R_<Config_DOC>_WriteData(data[cnt]);}}}
Config_DOC_user.c/* Start user code for global. Do not edit comment generated here */volatile uint16_t data[16];volatile uint16_t result;/* End user code. Do not edit comment generated here */void r_<Config_DOC>_dopci_interrupt(void){/* Start user code for r_<Config_DOC_dopci_interrupt. Do not edit comment generated here *//* Get result */R_<Config_DOC>_GetResult((uint16_t *)&result);/* Configure the operation mode of DOC */R_<Config_DOC>_SetMode(COMPARE_MISMATCH, 0x0000);/* Clear DOPCI flag */R_<Config_DOC>_ClearFlag();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 128 of 562

スマート・コンフィグレータ

4.2.12

4. API 関数

データトランスファコントローラ

以下に、コード生成ツールがデータトランスファコントローラ用として出力する API 関数の一覧を示します。
表 4.12

データトランスファコントローラ用 API 関数
API 関数名

機能概要

R_<Config_DTC>_Start

データトランスファコントローラを制御するうえで必要となる初期化処理を行います。
データトランスファコントローラの起動を許可します。

R_<Config_DTC>_Stop

データトランスファコントローラの起動を禁止します。

R_<Config_DTC>_Create_UserInit

データトランスファコントローラに関するユーザ独自の初期化処

R_<Config_DTC>_Create

理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 129 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DTC>_Create
データトランスファコントローラを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_DTC>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 130 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DTC>_Start
データトランスファコントローラの起動を許可します。
備考
本 API 関数では、選択した起動要因に対応する DTCE ビットを操作することにより、データトランスファコントローラの起動許可を実現しています。

[指定形式]
void

R_<Config_DTC>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 131 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DTC>_Stop
データトランスファコントローラの起動を禁止します。
備考
本 API 関数では、選択した起動要因に対応する DTCE ビットを操作することにより、データトランスファコントローラの起動禁止を実現しています。

[指定形式]
void

R_<Config_DTC>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 132 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DTC>_Create_UserInit
データトランスファコントローラに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_DTC>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_DTC>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 133 of 562

スマート・コンフィグレータ

4. API 関数

使用例
コンペアマッチ割り込みで DTC データ転送を開始する
main.c#include "r_smc_entry.h"void main(void){/* Start CMT channel 0 counter */R_Config_CMT0_Start();/* Enable operation of transfer data DTC */R_Config_DTC_Start();while (1U){
nop();}}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 134 of 562

スマート・コンフィグレータ

4.2.13

4. API 関数

デッドタイム補償用カウンタ

以下に、コード生成ツールがデッドタイム補償用カウンタ用として出力する API 関数の一覧を示します。
表 4.13

デッドタイム補償用カウンタ用 API 関数
API 関数名

機能概要

R_<Config_MTU5>_U5_Start

デッドタイム補償用カウンタを制御するうえで必要となる初期化処理を行います。
カウンタにより U 相カウントを開始します。

R_<Config_MTU5>_U5_Stop

カウンタにより U 相カウントを終了します。

R_<Config_MTU5>_V5_Start

カウンタにより V 相カウントを開始します。

R_<Config_MTU5>_V5_Stop

カウンタにより V 相カウントを終了します。

R_<Config_MTU5>_W5_Start

カウンタにより W 相カウントを開始します。

R_<Config_MTU5>_W5_Stop

カウンタにより W 相カウントを終了します。

R_<Config_MTU5>_Create_UserInit

デッドタイム補償用カウンタに関するユーザ独自の初期化処理を行います。

r_<Config_MTU5>_tgimn_interrupt

インプットキャプチャ割り込みの発生に伴う処理を行います。

R_<Config_MTU5>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 135 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_Create
デッドタイム補償用カウンタを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_MTU5>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 136 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_U5_Start
U 相カウントを開始します。

[指定形式]
void

R_<Config_MTU5>_U5_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 137 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_U5_Stop
U 相カウントを終了します。

[指定形式]
void

R_<Config_MTU5>_U5_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 138 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_V5_Start
V 相カウントを開始します。

[指定形式]
void

R_<Config_MTU5>_V5_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 139 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_V5_Stop
V 相カウントを終了します。

[指定形式]
void

R_<Config_MTU5>_V5_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 140 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_W5_Start
W 相カウントを開始します。

[指定形式]
void

R_<Config_MTU5>_W5_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 141 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_W5_Stop
W 相カウントを終了します。

[指定形式]
void

R_<Config_MTU5>_W5_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 142 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU5>_Create_UserInit
デッドタイム補償用カウンタに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_MTU5>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_MTU5>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 143 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU5>_tgimn_interrupt
インプットキャプチャ割り込みの発生に伴う処理を行います。
備考
本 API 関数は、入力信号のエッジを検出した場合に発生するインプットキャプチャ割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void
備考

r_<Config_MTU5>_tgimn_interrupt ( void );n はチャネル番号を、m はタイマジェネラルレジスタ番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 144 of 562

スマート・コンフィグレータ

4. API 関数

使用例
MTU6，MTU7 を使用した相補 PWM 動作時の PWM 出力波形に対するデッドタイムを補償する
main.c#include "r_smc_entry.h"void main(void){/* Start the MTU5 channel counter */R_Config_MTU5_Start();/* Start the MTU6 channel counter */R_Config_MTU6_MTU7_Start();while (1U){
nop();}}
Config_MTU5_user.cstatic void r_<Config_MTU5_tgiu5_interrupt(void){/* Start user code for r_<Config_MTU5_tgiu5_interrupt. Do not edit comment generated here *//* Write the corrected value */if ( MTU6.TGRB > MTU5.TGRU ){MTU6.TGRD = (MTU6.TGRB - MTU5.TGRU);}/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 145 of 562

スマート・コンフィグレータ

4.2.144. API 関数

DMA コントローラ

以下に、コード生成ツールが DMA コントローラ用として出力する API 関数の一覧を示します。
表 4.14

DMA コントローラ用 API 関数
API 関数名

機能概要

R_<Config_DMAC0>_Start

DMA コントローラを制御するうえで必要となる初期化処理を行います。
DMA 起動を開始します。

R_<Config_DMAC0>_Stop

DMA 起動を終了します。

R_<Config_DMAC0>_Set_SoftwareTrigger

ソフトウェア転送要求をセットします。

R_<Config_DMAC0>_Clear_SoftwareTrigger

ソフトウェア転送要求をクリアします。

R_<Config_DMAC0>_Create_UserInit

DMA コントローラに関するユーザ独自の初期化処理を行います。

r_<Config_DMAC0>_dmacni_interrupt

チャネル n の転送終了割り込みに伴う処理を行います。

R_<Config_DMAC0>_Create(n = 0 ~ 3)r_dmacn_callback_transfer_end

チャネル n の転送終了割り込みに伴う処理を行います。
(n = 0 ~ 3)r_dmacn_callback_transfer_escape_end

チャネル n のエスケープ転送終了割り込みに伴う処理を行います。(n = 0 ~ 3)r_dmac_dmac74i_interrupt

チャネル 4 ~ 7 の転送終了割り込みに伴う処理を行います。

r_dmacn_callback_transfer_end

チャネル n の転送終了割り込みに伴う処理を行います。
(n = 4 ~ 7)r_dmacn_callback_transfer_escape_end

チャネル n のエスケープ転送終了割り込みに伴う処理を行います。(n = 4 ~ 7)

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 146 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DMAC0>_Create
DMA コントローラを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_DMAC0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 147 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DMAC0>_Start
DMA 起動を開始します。

[指定形式]
void

R_<Config_DMAC0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 148 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DMAC0>_Stop
DMA 起動を終了します。

[指定形式]
void

R_<Config_DMAC0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 149 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DMAC0>_Set_SoftwareTrigger
ソフトウェア転送要求をセットします。
備考
ソフトウェアトリガを使用して連続で転送を行う場合、CLRS ビットに直接 1 を設定してください。その後、この関数を使用することで転送完了後に連続して同じ転送が行われます。R_<Config_DMAC0>_Clear_SoftwareTrigger を使用することで転送を停止することができます。

[指定形式]
void

R_<Config_DMAC0>_Set_SoftwareTrigger ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 150 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DMAC0>_Clear_SoftwareTrigger
ソフトウェア転送要求をクリアします。

[指定形式]
void

R_<Config_DMAC0>_Clear_SoftwareTrigger ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 151 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DMAC0>_Create_UserInit
DMA コントローラに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_DMAC0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_DMAC0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 152 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DMAC0>_dmacni_interrupt
チャネル n の転送終了割り込みに伴う処理を行います。

[指定形式]
void
備考

r_<Config_DMAC0>_dmacni_interrupt ( void );n はチャネル番号を意味します。(n = 0 ~ 3)

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 153 of 562

スマート・コンフィグレータ

4. API 関数

r_dmacn_callback_transfer_end
チャネル n の転送終了割り込みに伴う処理を行います。
備考
API 関数は、チャネル n の転送終了割り込みに対応した割り込み処理
r_<Config_DMAC0>_dmacni_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_dmacn_callback_transfer_end ( void );備考

n はチャネル番号を意味します。(n = 0 ~ 3)

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 154 of 562

スマート・コンフィグレータ

4. API 関数

r_dmacn_callback_transfer_escape_end
チャネル n のエスケープ転送終了割り込みに伴う処理を行います。
備考
API 関数は、チャネル n のエスケープ転送終了割り込みに対応した割り込み処理
r_<Config_DMAC0>_dmacni_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void
備考

r_dmacn_callback_transfer_escape_end ( void );n はチャネル番号を意味します。(n = 0 ~ 3)

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 155 of 562

スマート・コンフィグレータ

4. API 関数

r_dmac_dmac74i_interrupt
チャネル 4 ~ 7 の転送終了割り込みに伴う処理を行います。

[指定形式]
void

r_dmac_dmac74i_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 156 of 562

スマート・コンフィグレータ

4. API 関数

r_dmacn_callback_transfer_end
チャネル n の転送終了割り込みに伴う処理を行います。
備考
API 関数は、チャネル n の転送終了割り込みに対応した割り込み処理
r_dmac_dmac74i_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_dmacn_callback_transfer_end ( void );備考

n はチャネル番号を意味します。(n = 4 ~ 7)

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 157 of 562

スマート・コンフィグレータ

4. API 関数

r_dmacn_callback_transfer_escape_end
チャネル n のエスケープ転送終了割り込みに伴う処理を行います。
備考
API 関数は、チャネル n のエスケープ転送終了割り込みに対応した割り込み処理
r_dmac_dmac74i_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void
備考

r_dmacn_callback_transfer_escape_end ( void );n はチャネル番号を意味します。(n = 4 ~ 7)

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 158 of 562

スマート・コンフィグレータ

4. API 関数

使用例
コンペアマッチ割り込みで転送開始し、転送完了でフラグを立てる
main.c#include "r_smc_entry.h"void main(void){/* Start CMT channel 0 counter */R_Config_CMT0_Start();/* Enable the DMAC0 activation */R_Config_DMAC0_Start();while (1U){
nop();}}
Config_DMAC0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_dmac0_f;/* End user code. Do not edit comment generated here */void R_Config_DMAC0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here *//* Clear the flag */g_dmac0_f = 0U;/* End user code. Do not edit comment generated here */}static void r_dmac0_callback_transfer_end(void){/* Start user code for r_dmac0_callback_transfer_end. Do not edit comment generated here *//* Set the flag */g_dmac0_f = 1U;/* End user code. Do not edit comment generated here */}Config_DMAC0.h#define _DMAC0_ACTIVATION_SOURCE(28U) /* Please assign dynamic vector in interrupt
tab */※この記述は保護されません。再度コード生成した場合は再度記述してください。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 159 of 562

スマート・コンフィグレータ

4.2.15

4. API 関数

イベントリンクコントローラ

以下に、コード生成ツールがイベントリンクコントローラ用として出力する API 関数の一覧を示します。
表 4.15

イベントリンクコントローラ用 API 関数
API 関数名

機能概要

R_<Config_ELC>_Start

イベントリンクコントローラ（ELC）を制御するうえで必要となる初期化処理を行います。
周辺機能間の連携を開始します。

R_<Config_ELC>_Stop

周辺機能間の連携を終了します。

R_<Config_ELC>_GenerateSoftwareEvent

ソフトウェアイベントを発生させます。

R_<Config_ELC>_Set_PortBuffern

ポートバッファに値を書き込みます。

R_<Config_ELC>_Get_PortBuffern

ポートバッファの値を読み出します。

R_<Config_ELC>_Create_UserInit

イベントリンクコントローラ（ELC）に関するユーザ独自の初期化処理を行います。

r_<Config_ELC>_elsrni_interrupt

イベント割り込みの発生に伴う処理を行います。

R_<Config_ELC>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 160 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ELC>_Create
イベントリンクコントローラ（ELC）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_ELC>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 161 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ELC>_Start
周辺機能間の連携を開始します。

[指定形式]
void

R_<Config_ELC>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 162 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ELC>_Stop
周辺機能間の連携を終了します。

[指定形式]
void

R_<Config_ELC>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 163 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ELC>_GenerateSoftwareEvent
ソフトウェアイベントを発生させます。

[指定形式]
void

R_<Config_ELC>_GenerateSoftwareEvent ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 164 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ELC>_Set_PortBuffern
ポートバッファに値を書き込みます。

[指定形式]
void

R_<Config_ELC>_Set_PortBuffern ( uint8_t value );備考

n はポート番号を意味します。

[引数]
引数

I/O
I

uint8_t value;

説明
書き込む値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 165 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ELC>_Get_PortBuffern
ポートバッファの値を読み出します。

[指定形式]
void

R_<Config_ELC>_Get_PortBuffern ( uint8_t * const value );備考

n はポート番号を意味します。

[引数]
I/O

引数

O

uint8_t * const value;

説明
読み出した値を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 166 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ELC>_Create_UserInit
イベントリンクコントローラ（ELC）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_ELC>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_ELC>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 167 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_ELC>_elsrni_interrupt
イベント割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_ELC>_elsrni_interrupt ( void );n はイベントリンク設定レジスタ番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 168 of 562

スマート・コンフィグレータ

4. API 関数

使用例
ソフトウェアイベントを発生させ、リンクさせたイベントを発生させる。
次々にリンクさせ、イベント割り込みまで来ると終了。
main.c#include "r_smc_entry.h"void main(void){/* Enable all ELC event links */R_Config_ELC_Start();/* Trigger a software event */R_Config_ELC_GenerateSoftwareEvent();
while (1U){
nop();}}
Config_ELC_user.cstatic void r_Config_ELC_elsr18i_interrupt(void){/* Start user code for r_Config_ELC_elsr18i_interrupt. Do not edit comment generated here *//* Disable all ELC event links */R_Config_ELC_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 169 of 562

スマート・コンフィグレータ

4.2.16

4. API 関数

汎用 PWM タイマ

以下に、コード生成ツールが汎用 PWM タイマ用として出力する API 関数の一覧を示します。
表 4.16

汎用 PWM タイマ用 API 関数
API 関数名

機能概要

R_<Config_GPT0>_Start

汎用 PWM タイマを制御するうえで必要となる初期化処理を行います。
カウントを開始します。

R_<Config_GPT0>_Stop

カウントを終了します。

R_<Config_GPT0>_HardwareStart

割り込みを許可します。

R_<Config_GPT0>_HardwareStop

割り込みを禁止します。

R_<Config_GPT0>_ETGI_Start

外部トリガ立ち下がり／立ち上がり割り込みを許可します。

R_<Config_GPT0>_ETGI_Stop

外部トリガ立ち下がり／立ち上がり割り込みを禁止します。

R_<Config_GPT0>_Software_Clear

カウンタをクリアします。

R_<Config_GPT0>_Create_UserInit

汎用 PWM タイマに関するユーザ独自の初期化処理を行います。

r_<Config_GPT0>_gtcimn_interrupt

インプットキャプチャ／コンペアマッチ割り込みの発生に伴う処

R_<Config_GPT0>_Create

理を行います。
r_<Config_GPT0>_gtcivn_interrupt

オーバフロー割り込みの発生に伴う処理を行います。

r_<Config_GPT0>_gtciun_interrupt

アンダフロー割り込みの発生に伴う処理を行います。

r_<Config_GPT0>_gdten_interrupt

デッドタイムエラー割り込みの発生に伴う処理を行います。

r_gpt_etgin_interrupt

外部トリガ立ち下がり割り込みの発生に伴う処理を行います。

r_gpt_etgip_interrupt

外部トリガ立ち上がり割り込みの発生に伴う処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 170 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_Create
汎用 PWM タイマを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_GPT0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 171 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_Start
カウントを開始します。
備考
RX260/RX261/RX26T/RX66T/RX66N/RX72N/RX72M/RX72T を使用する場合、カウント開始要因にソフトウェア要因カウントスタートが設定されておらず、すべての GPT 割り込みが禁止に設定されていると、この関数は空の状態で生成されます。

[指定形式]
void

R_<Config_GPT0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 172 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_Stop
カウントを終了します。
備考
RX260/RX261/RX26T/RX66T/RX66N/RX72N/RX72M/RX72T を使用する場合、カウント
停止要因にソフトウェア要因カウントストップが設定されておらず、すべての GPT 割り込みが禁止に設定されていると、この関数は空の状態で生成されます。

[指定形式]
void

R_<Config_GPT0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 173 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_HardwareStart
割り込みを許可します。
備考
本 API 関数は外部/内部トリガ(ハードウェア要因)によるカウント動作時に割り込みの検出を有効化するために使用します。

[指定形式]
void

R_<Config_GPT0>_HardwareStart ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 174 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_HardwareStop
割り込みを禁止します。
備考
本 API 関数は外部/内部トリガ(ハードウェア要因)によるカウント動作時に割り込みの検出を有効化するために使用します。

[指定形式]
void

R_<Config_GPT0>_HardwareStop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 175 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_ETGI_Start
外部トリガ立ち下がり／立ち上がり割り込みを許可します。

[指定形式]
void

R_<Config_GPT0>_ETGI_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 176 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_ETGI_Stop
外部トリガ立ち下がり／立ち上がり割り込みを禁止します。

[指定形式]
void

R_<Config_GPT0>_ETGI_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 177 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_Software_Clear
カウンタをクリアします。

[指定形式]
void

R_<Config_GPT0>_Software_Clear ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 178 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_GPT0>_Create_UserInit
汎用 PWM タイマに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_GPT0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_GPT0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 179 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_GPT0>_gtcimn_interrupt
インプットキャプチャ／コンペアマッチ割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_GPT0>_gtcimn_interrupt ( void );n はチャネル番号を、m はタイマジェネラルレジスタ番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 180 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_GPT0>_gtcivn_interrupt
オーバフロー割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_GPT0>_gtcivn_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 181 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_GPT0>_gtciun_interrupt
アンダフロー割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_GPT0>_gtciun_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 182 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_GPT0>_gdten_interrupt
デッドタイムエラー割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_GPT0>_gdten_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 183 of 562

スマート・コンフィグレータ

4. API 関数

r_gpt_etgin_interrupt
外部トリガ立ち下がり割り込みの発生に伴う処理を行います。

[指定形式]
void

r_gpt_etgin_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 184 of 562

スマート・コンフィグレータ

4. API 関数

r_gpt_etgip_interrupt
外部トリガ立ち上がり割り込みの発生に伴う処理を行います。

[指定形式]
void

r_gpt_etgip_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 185 of 562

スマート・コンフィグレータ

4. API 関数

使用例
インプットキャプチャ値を取得する
main.c#include "r_smc_entry.h"void main(void){/* Start GPT channel 0 counter */R_Config_GPT0_Start();while (1U){
nop();}}
Config_GPT0_user.c* Start user code for global. Do not edit comment generated here */volatile uint16_t g_gpt0_capture_value;/* End user code. Do not edit comment generated here */static void r_Config_GPT0_gtcia0_interrupt(void){/* Start user code for r_Config_GPT0_gtcia0_interrupt. Do not edit comment generated here */g_gpt0_capture_value = GPT0.GTCCRA;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 186 of 562

スマート・コンフィグレータ

4.2.17

4. API 関数

グループスキャンモード S12AD

以下に、コード生成ツールがグループスキャンモード S12AD 用として出力する API 関数の一覧を示します。
表 4.17

グループスキャンモード S12AD 用 API 関数
API 関数名

機能概要

R_<Config_S12AD0>_Start

グループスキャンモード S12AD を制御するうえで必要となる初期化処理を行います。
A/D 変換を開始します。

R_<Config_S12AD0>_Stop

A/D 変換を終了します。

R_<Config_S12AD0>_Get_ValueResult

変換結果を獲得します。

R_<Config_S12AD0>_Set_CompareValue

コンペアレベルの設定を行います。

R_<Config_S12AD0>_Set_CompareAValue

ウィンドウ A コンペアレベルの設定を行います。

R_<Config_S12AD0>_Set_CompareBValue

ウィンドウ B コンペアレベルの設定を行います。

R_<Config_S12AD0>_Create_UserInit

グループスキャンモード S12AD に関するユーザ独自の初期化処理を行います。

r_<Config_S12AD0>_interrupt

スキャン終了割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interrupt

コンペア割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interruptA

ウィンドウ A コンペア割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interruptB

ウィンドウ B コンペア割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_groupb_interrupt

グループ B スキャン終了割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_groupc_interrupt

グループ C スキャン終了割り込みの発生に伴う処理を行います。

R_<Config_S12AD0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 187 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Create
グループスキャンモード S12AD を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_S12AD0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 188 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Start
A/D 変換を開始します。

[指定形式]
void

R_<Config_S12AD0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 189 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Stop
A/D 変換を終了します。

[指定形式]
void

R_<Config_S12AD0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 190 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Get_ValueResult
変換結果を獲得します。

[指定形式]
void

R_<Config_S12AD0>_Get_ValueResult ( ad_channel_t channel, uint16_t * const buffer );[引数]
RX130，RX230/RX231 の場合
I/O
I

引数

ad_channel_t channel;

説明
チャネル番号ADCHANNEL0：入力チャネル AN000ADCHANNEL1：入力チャネル AN001

ADCHANNEL2：入力チャネル AN002

ADCHANNEL3：入力チャネル AN003

ADCHANNEL4：入力チャネル AN004

ADCHANNEL5：入力チャネル AN005

ADCHANNEL6：入力チャネル AN006

ADCHANNEL7：入力チャネル AN007

ADCHANNEL16：入力チャネル AN016

ADCHANNEL17：入力チャネル AN017

ADCHANNEL18：入力チャネル AN018

ADCHANNEL19：入力チャネル AN019

ADCHANNEL20：入力チャネル AN020

ADCHANNEL21：入力チャネル AN021

ADCHANNEL22：入力チャネル AN022

ADCHANNEL23：入力チャネル AN023

ADCHANNEL24：入力チャネル AN024

ADCHANNEL25：入力チャネル AN025

ADCHANNEL26：入力チャネル AN026

ADCHANNEL27：入力チャネル AN027

ADCHANNEL28：入力チャネル AN028

ADCHANNEL29：入力チャネル AN029

ADCHANNEL30：入力チャネル AN030

ADCHANNEL31：入力チャネル AN031

ADTEMPSENSOR：拡張アナログ入力（温度センサ出力）

ADINTERREFVOLT：拡張アナログ入力（内部基準電圧）O

uint16_t * const buffer;

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

ADSELFDIAGNOSIS：自己診断結果

ADDATADUPLICATION：ダブルトリガモード結果獲得した変換結果を格納する領域へのポインタ

Page 191 of 562

スマート・コンフィグレータ

4. API 関数

そのほかのデバイスの場合
引数

I/O
I

ad_channel_t channel;

説明
チャネル番号ADCHANNEL0：入力チャネル AN000ADCHANNEL1：入力チャネル AN001

ADCHANNEL2：入力チャネル AN002

ADCHANNEL3：入力チャネル AN003

ADCHANNEL4：入力チャネル AN004

ADCHANNEL5：入力チャネル AN005

ADCHANNEL6：入力チャネル AN006

ADCHANNEL7：入力チャネル AN007

ADCHANNEL8：入力チャネル AN008

ADCHANNEL9：入力チャネル AN009

ADCHANNEL10：入力チャネル AN010

ADCHANNEL11：入力チャネル AN011

ADCHANNEL12：入力チャネル AN012

ADCHANNEL13：入力チャネル AN013

ADCHANNEL14：入力チャネル AN014

ADCHANNEL15：入力チャネル AN015

ADCHANNEL16：入力チャネル AN016

ADCHANNEL17：入力チャネル AN017

ADCHANNEL18：入力チャネル AN018

ADCHANNEL19：入力チャネル AN019

ADCHANNEL20：入力チャネル AN020

ADTEMPSENSOR：拡張アナログ入力（温度センサ出力）

ADINTERREFVOLT：拡張アナログ入力（内部基準電圧）ADSELFDIAGNOSIS：自己診断結果

ADDATADUPLICATION：ダブルトリガモード結果

ADDATADUPLICATIONA ：ダブルトリガモード A 結果
ADDATADUPLICATIONB ：ダブルトリガモード B 結果
O

uint16_t * const buffer;獲得した変換結果を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 192 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareValue
コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 193 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareAValue
ウィンドウ A コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareAValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 194 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareBValue
ウィンドウ B コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareBValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 195 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Create_UserInit
グループスキャンモード S12AD に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_S12AD0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_S12AD0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 196 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_interrupt
スキャン終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 197 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interrupt
コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 198 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interruptA
ウィンドウ A コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interruptA ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 199 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interruptB
ウィンドウ B コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interruptB ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 200 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_groupb_interrupt
グループ B スキャン終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_groupb_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 201 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_groupc_interrupt
グループ C スキャン終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_groupc_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 202 of 562

スマート・コンフィグレータ

4. API 関数

使用例
グループ A と B の AD 変換結果を取得する
main.c#include "r_smc_entry.h"void main(void){/* Start the AD0 converter */R_Config_S12AD0_Start();while (1U){
nop();}}
Config_S12AD0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint16_t g_s12ad0_ch000_value;
volatile uint16_t g_s12ad0_ch001_value;/* End user code. Do not edit comment generated here */static void r_Config_S12AD0_interrupt(void){/* Start user code for r_Config_S12AD0_interrupt. Do not edit comment generated here *//* Get result from the AD0 channel 0 (AN000) converter */R_Config_S12AD0_Get_ValueResult(ADCHANNEL0, (uint16_t *)&g_s12ad0_ch000_value);/* End user code. Do not edit comment generated here */}static void r_Config_S12AD0_groupb_interrupt(void){/* Start user code for r_Config_S12AD0_groupb_interrupt. Do not edit comment generated
here *//* Get result from the AD0 channel 1 (AN001) converter */R_Config_S12AD0_Get_ValueResult(ADCHANNEL1, (uint16_t *)&g_s12ad0_ch001_value);/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 203 of 562

スマート・コンフィグレータ

4.2.184. API 関数

I2C マスタモード

以下に、コード生成ツールが I2C マスタモード（RIIC/SCI/RSCI）用として出力する API 関数の一覧を示します。
表 4.18I2C マスタモード用 API 関数 (RIIC)
API 関数名

機能概要

R_<Config_RIIC0>_Start

I2C マスタモードを制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_RIIC0>_Stop

通信を終了します。

R_<Config_RIIC0>_Master_Send

マスタ送信を開始します。

R_<Config_RIIC0>_Master_Send_Without_Stop
R_<Config_RIIC0>_Master_Receive

マスタ送信を開始します。
（送信終了時にストップコンディションを発行しない）
マスタ受信を開始します。

R_<Config_RIIC0>_IIC_StartCondition

スタートコンディションを発行します。

R_<Config_RIIC0>_IIC_StopCondition

ストップコンディションを発行します。

R_<Config_RIIC0>_Create_UserInit

I2C マスタモードに関するユーザ独自の初期化処理を行います。

r_<Config_RIIC0>_error_interrupt

通信エラー／通信イベント発生割り込みの発生に伴う処理を行います。

r_<Config_RIIC0>_receive_interrupt

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

r_<Config_RIIC0>_transmit_interrupt

送信データエンプティ割り込みの発生に伴う処理を行います。

R_<Config_RIIC0>_Create

r_<Config_RIIC0>_transmitend_interrupt

送信終了割り込みの発生に伴う処理を行います。

r_<Config_RIIC0>_callback_error

通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、アービトレーションロスト検出、NACK 検出、タイムア
ウト検出、通信シーケンスエラー検出に特化した処理を行います。
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、マスタ送信に伴うストップコンディションの検出に特化した処理を行います。
また、ストップコンディションを発行しないマスタ送信では送信終了割り込みの処理を行います。
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、マスタ受信に伴うストップコンディションの検出に特化した処理を行います。

r_<Config_RIIC0>_callback_transmitend

r_<Config_RIIC0>_callback_receiveend

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 204 of 562

スマート・コンフィグレータ
表 4.194. API 関数

I2C マスタモード用 API 関数 (SCI/RSCI シンプル I2C モード)
API 関数名

機能概要

R_<Config_SCI0>_Start

I2C マスタモードを制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_SCI0>_Stop

通信を終了します。

R_<Config_SCI0>_IIC_Master_Send

マスタ送信を開始します。

R_<Config_SCI0>_IIC_Master_Receive

マスタ受信を開始します。

R_<Config_SCI0>_IIC_StartCondition

スタートコンディションを発行します。

R_<Config_SCI0>_IIC_StopCondition

ストップコンディションを発行します。

R_<Config_SCI0>_Create_UserInit

I2C マスタモードに関するユーザ独自の初期化処理を行います。

r_<Config_SCI0>_receive_interrupt

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

r_<Config_SCI0>_transmit_interrupt

送信データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_transmitend_interrupt

開始条件／再開始条件／停止条件生成終了割り込みの発生に伴う処理を行います。
開始条件／再開始条件／停止条件生成終了割り込みに対応した割り込み処理のうち、マスタ送信に伴うストップコンディションの検出に特化した処理を行います。
また、送信データエンプティ割り込みを DTC または DMAC の起動要因に設定している際には割り込みの発生に伴う処理を行います。

R_<Config_SCI0>_Create

r_<Config_SCI0>_callback_transmitend

r_<Config_SCI0>_callback_receiveend

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

開始条件／再開始条件／停止条件生成終了割り込みに対応した割り込み処理のうち、マスタ受信に伴うストップコンディションの検出に特化した処理を行います。
また、受信データフル割り込みを DTC または DMAC の起動要因に設定している際には割り込みの発生に伴う処理を行います。

Page 205 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Create
I2C マスタモードを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_RIIC0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 206 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Start
通信を開始します。

[指定形式]
void

R_<Config_RIIC0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 207 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_RIIC0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 208 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Master_Send
マスタ送信を開始します。
備考 1.
本 API 関数では、データ（引数 adr で指定されたスレーブアドレスと R/W# ビット）をスレーブデバイスにマスタ送信したのち、引数 tx_buf で指定されたバッファから
1 バイト単位のマスタ送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本API 関 数 で は 、 マ ス タ 送 信 の 開 始 処 理 と し て 、 内 部 的 に
R_<Config_RIIC0>_IIC_StartCondition の呼び出しを行っています。
備考 3.
マスタ送信の終了処理として、r_<Config_RIIC0>_transmitend_interrupt にてストップ
コンディションを発行しています。
備考 4.
マスタ送信を行う際には、本 API 関数の呼び出し以前に R_<Config_RIIC0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS R_<Config_RIIC0>_Master_Send ( uint16_t adr, uint8_t * const tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I

説明
スレーブアドレスuint16_t adr;

15 14 13 12 11 10

9

8

7

6

5

4

3

2

1

0

スレーブアドレス(0～1023)

II

uint8_t * const tx_buf;
uint16_t tx_num;

送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ERROR1
MD_ERROR2

説明
正常終了
バスビジー
引数 adr の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 209 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Master_Send_Without_Stop【 RIIC 】マスタ送信を開始します。
（送信終了時にストップコンディションを発行しない）
備考 1.
本 API 関数では、データ（引数 adr で指定されたスレーブアドレスと R/W# ビット）をスレーブデバイスにマスタ送信したのち、引数 tx_buf で指定されたバッファから
1 バイト単位のマスタ送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本API 関 数 で は 、 マ ス タ 送 信 の 開 始 処 理 と し て 、 内 部 的 に
R_<Config_RIIC0>_IIC_StartCondition の呼び出しを行っています。
備考 3.
マスタ送信の終了処理として、r_<Config_RIIC0>_transmitend_interrupt にてストップ
コンディションを発行しません。
備考 4.
マスタ送信を行う際には、本 API 関数の呼び出し以前に R_<Config_RIIC0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
R_<Config_RIIC0>_Master_Send_Without_Stop ( uint16_t adr, uint8_t * const
tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I

説明
スレーブアドレスuint16_t adr;

15 14 13 12 11 10

9

8

7

6

5

4

3

2

1

0

スレーブアドレス(0～1023)

II

uint8_t * const tx_buf;
uint16_t tx_num;

送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ERROR1
MD_ERROR2

説明
正常終了
バスビジー
引数 adr の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 210 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Master_Receive【 RIIC 】マスタ受信を開始します。
備考 1.
本 API 関数では、データ（引数 adr で指定されたスレーブアドレスと R/W# ビット）をスレーブデバイスにマスタ送信したのち、 1 バイト単位のマスタ受信を引数 rx_num
で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 2.
本API 関 数 で は 、 マ ス タ 受 信 の 開 始 処 理 と し て 、 内 部 的 に
R_<Config_RIIC0>_IIC_StartCondition の呼び出しを行っています。
備考 3.
マスタ受信の終了処理として、r_<Config_RIIC0>_receive_interrupt にてストップ
コンディションを発行しています。
備考 4.
マスタ受信を行う際には、本 API 関数の呼び出し以前に R_<Config_RIIC0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
rx_num );R_<Config_RIIC0>_Master_Receive ( uint16_t adr, uint8_t * const rx_buf, uint16_t

[引数]
引数

I/O
I

説明
スレーブアドレスuint16_t adr;

15 14 13 12 11 10

9

8

7

6

5

4

3

2

1

0

スレーブアドレス(0～127)

OI

uint8_t * const rx_buf;
uint16_t rx_num;

受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ERROR2
MD_ERROR3
MD_ERROR4
MD_ERROR5

説明
正常終了
引数 adr の指定が不正
引数 adr の指定が不正（マスタ受信は 10bit アドレス非対応です）
バスビジー（タイムアウト検出，アービトレーションロスト検出）
バスビジー（ストップコンディション未検出）

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 211 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_IIC_StartCondition
スタートコンディションを発行します。
備考
本 API 関数の呼び出しに伴い、通信エラー／通信イベント発生割り込みを発生させ、
r_<Config_RIIC0>_error_interrupt が呼び出されます。

[指定形式]
void

R_<Config_RIIC0>_IIC_StartCondition ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 212 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_IIC_StopCondition
ストップコンディションを発行します。
備考
本 API 関数の呼び出しに伴い、通信エラー／通信イベント発生割り込みを発生させ、
r_<Config_RIIC0>_error_interrupt が呼び出されます。

[指定形式]
void

R_<Config_RIIC0>_IIC_StopCondition ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 213 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Create_UserInit
I2C マスタモードに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_RIIC0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_RIIC0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 214 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_error_interrupt
通信エラー／通信イベント発生割り込みの発生に伴う処理を行います。
備考
本 API 関数は、通信エラー／通信イベント発生（アービトレーションロスト検出、NACK
検出、タイムアウト検出、スタートコンディション検出、ストップコンディション検出）に対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_RIIC0>_error_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 215 of 562

スマート・コンフィグレータ

4. API 関数

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

[指定形式]
void

r_<Config_RIIC0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 216 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_transmit_interrupt
送信データエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RIIC0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 217 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_transmitend_interrupt
送信終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RIIC0>_transmitend_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 218 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_callback_error
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、アービトレーションロスト
検出、NACK 検出、タイムアウト検出、通信シーケンスエラー検出に特化した処理を行います。
備考
本 API 関数は、r_<Config_RIIC0>_error_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RIIC0>_callback_error ( MD_STATUS status );

[引数]
I/O

引数

I

MD_STATUS status;

説明
割り込みの発生要因
MD_ERROR1：アービトレーションロスト検出
MD_ERROR2：タイムアウト検出
MD_ERROR3：NACK 検出
MD_ERROR4：通信シーケンスエラー検出

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 219 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_callback_transmitend
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、マスタ送信に伴うストップ
コンディションの検出に特化した処理を行います。
備考 1.
本 API 関数は、r_<Config_RIIC0>_error_interrupt のコールバック・ルーチンとして呼び出されます。
備考 2.
マスタ送信を行う際には、R_<Config_RIIC0>_Master_Send を呼び出してください。
また、ストップコンディションを発行しないマスタ送信では送信終了割り込みの処理を行います。
備考 3.
本 API 関数は、r_<Config_RIIC0>_transmitend_interrupt のコールバック・ルーチンとして呼び出されます。
備考 4.
マスタ送信を行う際には、R_<Config_RIIC0>_Master_Send_Without_Stop を呼び出してください。

[指定形式]
void

r_<Config_RIIC0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 220 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_callback_receiveend
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、マスタ受信に伴うストップ
コンディションの検出に特化した処理を行います。
備考 1.
本 API 関数は、r_<Config_RIIC0>_error_interrupt のコールバック・ルーチンとして呼び出されます。
備考 2.
マスタ受信を行う際には、R_<Config_RIIC0>_Master_Receive を呼び出してください。

[指定形式]
void

r_<Config_RIIC0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 221 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create
I2C マスタモードを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 222 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Start
通信を開始します。

[指定形式]
void

R_<Config_SCI0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 223 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_SCI0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 224 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_IIC_Master_Send【 SCI 】マスタ送信を開始します。
（簡易 I2C モード）
備考 1.
本 API 関数では、データ（引数 adr で指定されたスレーブアドレスと R/W# ビット）をスレーブデバイスにマスタ送信したのち、引数 tx_buf で指定されたバッファから
1 バイト単位のマスタ送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本API 関 数 で は 、 マ ス タ 送 信 の 開 始 処 理 と し て 、 内 部 的 に
R_<Config_SCI0>_IIC_StartCondition の呼び出しを行っています。
備考 3.
マスタ送信の終了処理として、r_<Config_SCI0>_transmit_interrupt にてストップ
コンディションを発行しています。
備考 4.
マスタ送信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
void

R_<Config_SCI0>_IIC_Master_Send ( uint8_t adr, uint8_t * const tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I

uint8_t adr;説明
スレーブアドレス
7

6

5

4

3

2

スレーブアドレス(0～127)I
I

uint8_t * const tx_buf;
uint16_t tx_num;

1

0
W(0)

送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 225 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_IIC_Master_Receive【 SCI 】マスタ受信を開始します。
（簡易 I2C モード）
備考 1.
本 API 関数では、データ（引数 adr で指定されたスレーブアドレス）をスレーブデバイ
スにマスタ送信したのち、 1 バイト単位のマスタ受信を引数 rx_num で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 2.
本API 関 数 で は 、 マ ス タ 受 信 の 開 始 処 理 と し て 、 内 部 的 に
R_<Config_SCI0>_IIC_StartCondition の呼び出しを行っています。
備考 3.
マスタ受信の終了処理として、r_<Config_SCI0>_receive_interrupt にてストップコンデ
ィションを発行しています。
備考 4.
マスタ受信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
void

R_<Config_SCI0>_IIC_Master_Receive ( uint8_t adr, uint8_t * const rx_buf, uint16_t rx_num );

[引数]
引数

I/O
I

uint8_t adr;説明
スレーブアドレス
7

6

5

4

3

2

スレーブアドレス(0～127)

OI

uint8_t * const rx_buf;
uint16_t rx_num;

1

0
R(1)

受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 226 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_IIC_StartCondition
スタートコンディションを発行します。
備考
本 API 関数の呼び出しに伴い、開始条件／再開始条件／停止条件生成終了割り込みを発生させ、r_<Config_SCI0>_transmitend_interrupt が呼び出されます。

[指定形式]
void

R_<Config_SCI0>_IIC_StartCondition ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 227 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_IIC_StopCondition
ストップコンディションを発行します。
備考
本 API 関数の呼び出しに伴い、開始条件／再開始条件／停止条件生成終了割り込みを発生させ、r_<Config_SCI0>_transmitend_interrupt が呼び出されます。

[指定形式]
void

R_<Config_SCI0>_IIC_StopCondition ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 228 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create_UserInit
I2C マスタモードに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_SCI0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 229 of 562

スマート・コンフィグレータ

4. API 関数

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

[指定形式]
void

r_<Config_SCI0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 230 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_transmit_interrupt
送信データエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 231 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_transmitend_interrupt
開始条件／再開始条件／停止条件生成終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_transmitend_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 232 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_transmitend
開始条件／再開始条件／停止条件生成終了割り込みに対応した割り込み処理のうち、マスタ送信に伴うストップコンディションの検出に特化した処理を行います。
備考 1.
本 API 関数は、r_<Config_SCI0>_transmitend_interrupt のコールバック・ルーチンとして呼び出されます。
備考 2.
マスタ送信を行う際には、R_<Config_SCI0>_IIC_Master_Send を呼び出してください。
また、送信データエンプティ割り込みを DTC または DMAC の起動要因に設定している際には割り込
みの発生に伴う処理を行います。
備考 3.
本 API 関数は、r_<Config_SCI0>_transmit_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 233 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_receiveend
開始条件／再開始条件／停止条件生成終了割り込みに対応した割り込み処理のうち、マスタ受信に伴うストップコンディションの検出に特化した処理を行います。
備考 3.
本 API 関数は、r_<Config_SCI0>_transmitend_interrupt のコールバック・ルーチンとして呼び出されます。
備考 4.
マスタ受信を行う際には、R_<Config_SCI0>_IIC_Master_Receive を呼び出してください。
また、受信データフル割り込みを DTC または DMAC の起動要因に設定している際には割り込みの発生に伴う処理を行います。
備考 5.
本 API 関数は、r_<Config_SCI0>_receive_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 234 of 562

スマート・コンフィグレータ

4. API 関数

使用例 1
RIIC で、４回のマスタ送信を行う
main.c#include "r_smc_entry.h"
extern volatile uint8_t g_riic0_tx_buf[2];void main(void){/* Start the RIIC0 I2C Bus Interface */R_Config_RIIC0_Start();/* Send RIIC0 data to slave device [Slave address : 160 (10-bit address mode)] */R_Config_RIIC0_Master_Send(0x00A0, (uint8_t *)g_riic0_tx_buf, 2U);
while (1U){
nop();}}
Config_RIIC0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_riic0_tx_buf[2];volatile uint8_t g_riic0_tx_cnt;/* End user code. Do not edit comment generated here */void R_Config_RIIC0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_riic0_tx_cnt = 0U;
g_riic0_tx_buf[0] = g_riic0_tx_cnt;
g_riic0_tx_buf[1] = 0x01;/* End user code. Do not edit comment generated here */}static void r_Config_RIIC0_callback_transmitend(void){/* Start user code for r_Config_RIIC0_callback_transmitend. Do not edit comment generated
here */
if ((++g_riic0_tx_cnt) < 4U){
g_riic0_tx_buf[0] = g_riic0_tx_cnt;
g_riic0_tx_buf[1] += 0x01;/* Send RIIC0 data to slave device [Slave assress : 160 (10-bit address mode)] */R_Config_RIIC0_Master_Send(0x00A0, (uint8_t *)g_riic0_tx_buf, 2U);}
else{/* Stop the RIIC0 I2C Bus Interface */R_Config_RIIC0_Stop();}/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 235 of 562

スマート・コンフィグレータ

4. API 関数

使用例 2
SCI 簡易 I2C モードで、４回のマスタ送信を行う
main.c#include "r_smc_entry.h"
extern volatile uint8_t g_riic0_tx_buf[2];void main(void){/* Start the SCI0 I2C Bus Interface */R_Config_SCI0_Start();/* Send SCI0 data to slave device [Slave address : 80] */R_Config_SCI0_Master_Send(0xA0, (uint8_t *)g_sci0_tx_buf, 2U);
while (1U){
nop();}}
Config_SCI0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_sci0_tx_buf[2];volatile uint8_t g_sci0_tx_cnt;/* End user code. Do not edit comment generated here */void R_Config_SCI0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_sci0_tx_cnt = 0U;
g_sci0_tx_buf[0] = g_sci0_tx_cnt;
g_sco0_tx_buf[1] = 0x01;/* End user code. Do not edit comment generated here */}static void r_Config_SCI0_callback_transmitend(void){/* Start user code for r_Config_SCI0_callback_transmitend. Do not edit comment generated
here */
if ((++g_sci0_tx_cnt) < 4U){
g_sci0_tx_buf[0] = g_sci0_tx_cnt;
g_sci0_tx_buf[1] += 0x01;/* Send SCI0 data to slave device [Slave assress : 80] */R_Config_SCI0_Master_Send(0xA0, (uint8_t *)g_sci0_tx_buf, 2U);}
else{/* Stop the SCI0 I2C Bus Interface */R_Config_SCI0_Stop();}/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 236 of 562

スマート・コンフィグレータ

4.2.194. API 関数

I2C スレーブモード

以下に、コード生成ツールが I2C スレーブモード用として出力する API 関数の一覧を示します。
表 4.20I2C スレーブモード用 API 関数
API 関数名

機能概要

R_<Config_RIIC0>_Start

I2C スレーブモードを制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_RIIC0>_Stop

通信を終了します。

R_<Config_RIIC0>_Slave_Send

スレーブ送信を開始します。

R_<Config_RIIC0>_Slave_Receive

スレーブ受信を開始します。

R_<Config_RIIC0>_Create_UserInit

r_<Config_RIIC0>_receive_interrupt

I2C スレーブモードに関するユーザ独自の初期化処理を行います。
通信エラー／通信イベント発生割り込みの発生に伴う処理を行います。
受信データフル割り込みの発生に伴う処理を行います。

r_<Config_RIIC0>_transmit_interrupt

送信データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_RIIC0>_transmitend_interrupt

送信終了割り込みの発生に伴う処理を行います。

r_<Config_RIIC0>_callback_error

通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、アービトレーションロスト検出、NACK 検出、タイムア
ウト検出、通信シーケンスエラー検出に特化した処理を行います。

r_<Config_RIIC0>_callback_transmitend

通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、スレーブ送信に伴うストップコンディションの検出に特化した処理を行います。

r_<Config_RIIC0>_callback_receiveend

通信エラー／通信イベント発生割り込みに対応した割り込み処理

R_<Config_RIIC0>_Create

r_<Config_RIIC0>_error_interruptのうち、スレーブ受信に伴うストップコンディションの検出に特化した処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 237 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Create
I2C スレーブモードを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_RIIC0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 238 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Start
通信を開始します。

[指定形式]
void

R_<Config_RIIC0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 239 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_RIIC0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 240 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Slave_Send
スレーブ送信を開始します。
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位のスレーブ送信
を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
スレーブ送信を行う際には、本 API 関数の呼び出し以前に R_<Config_RIIC0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_RIIC0>_Slave_Send ( uint8_t * const tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I
I

uint8_t * const tx_buf;
uint16_t tx_num;

説明
送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
マクロ

MD_OK

説明
正常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 241 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Slave_Receive
スレーブ受信を開始します。
備考 1.
本 API 関数では、 1 バイト単位のスレーブ受信を引数 rx_num で指定された回数だけ
繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 2.
スレーブ受信を行う際には、本 API 関数の呼び出し以前に R_<Config_RIIC0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_RIIC0>_Slave_Receive ( uint8_t * const rx_buf, uint16_t rx_num );

[引数]
引数

I/O

O
I

uint8_t * const rx_buf;
uint16_t rx_num;

説明
受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK

説明
正常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 242 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RIIC0>_Create_UserInit
I2C スレーブモードに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_RIIC0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_RIIC0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 243 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_error_interrupt
通信エラー／通信イベント発生割り込みの発生に伴う処理を行います。
備考
本 API 関数は、通信エラー／通信イベント発生（アービトレーションロスト検出、NACK
検出、タイムアウト検出、スタートコンディション検出、ストップコンディション検出）に対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_RIIC0>_error_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 244 of 562

スマート・コンフィグレータ

4. API 関数

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

[指定形式]
void

r_<Config_RIIC0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 245 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_transmit_interrupt
送信データエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RIIC0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 246 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_transmitend_interrupt
送信終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RIIC0>_transmitend_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 247 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_callback_error
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、アービトレーションロスト
検出、NACK 検出、タイムアウト検出、通信シーケンスエラー検出に特化した処理を行います。
備考
本 API 関数は、r_<Config_RIIC0>_error_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RIIC0>_callback_error ( MD_STATUS status );

[引数]
I/O

引数

I

MD_STATUS status;

説明
割り込みの発生要因
MD_ERROR1：アービトレーションロスト検出
MD_ERROR2：タイムアウト検出
MD_ERROR3：NACK 検出
MD_ERROR4：通信シーケンスエラー検出

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 248 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_callback_transmitend
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、スレーブ送信に伴うストップコンディションの検出に特化した処理を行います。
備考 1.
本 API 関数は、r_<Config_RIIC0>_error_interrupt のコールバック・ルーチンとして呼び出されます。
備考 2.
スレーブ送信を行う際には、R_<Config_RIIC0>_Slave_Send を呼び出してください。

[指定形式]
void

r_<Config_RIIC0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 249 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RIIC0>_callback_receiveend
通信エラー／通信イベント発生割り込みに対応した割り込み処理のうち、スレーブ受信に伴うストップコンディションの検出に特化した処理を行います。
備考 1.
本 API 関数は、r_<Config_RIIC0>_error_interrupt のコールバック・ルーチンとして呼び出されます。
備考 2.
スレーブ受信を行う際には、R_<Config_RIIC0>_Slave_Receive を呼び出してください。

[指定形式]
void

r_<Config_RIIC0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 250 of 562

スマート・コンフィグレータ

4. API 関数

使用例
４回のスレーブ受信を行う
main.c#include "r_smc_entry.h"
extern volatile uint8_t g_riic2_rx_buf[2];void main(void){/* Start the RIIC2 Bus Interface */R_Config_RIIC2_Start();/* Read data from a master device */R_Config_RIIC2_Slave_Receive((uint8_t *)g_riic2_rx_buf, 2U);
while (1U){
nop();}}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 251 of 562

スマート・コンフィグレータ

4. API 関数

Config_RIIC2_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_riic2_rx_buf[2];volatile uint8_t g_riic2_rx_cnt;/* End user code. Do not edit comment generated here */void R_Config_RIIC2_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_riic2_rx_cnt = 0U;/* End user code. Do not edit comment generated here */}static void r_Config_RIIC2_callback_receiveend(void){/* Start user code for r_Config_RIIC2_callback_receiveend. Do not edit comment generated
here */
if ((++g_riic2_rx_cnt) < 4U){/* Read data from a master device */R_Config_RIIC2_Slave_Receive((uint8_t *)g_riic2_rx_buf, 2U);}
else{/* Stop the RIIC2 Bus Interface */R_Config_RIIC2_Stop();}/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 252 of 562

スマート・コンフィグレータ

4.2.204. API 関数

割り込みコントローラ

以下に、コード生成ツールが割り込みコントローラ用として出力する API 関数の一覧を示します。
表 4.21

割り込みコントローラ用 API 関数
API 関数名

機能概要

R_<Config_ICU>_IRQn_Start

割り込みコントローラを制御するうえで必要となる初期化処理を行います。
外部端子割り込みの検出を許可します。

R_<Config_ICU>_IRQn_Stop

外部端子割り込みの検出を禁止します。

R_<Config_ICU>_Software_Start

ソフトウェア割り込みの検出を許可します。

R_<Config_ICU>_Software_Stop

ソフトウェア割り込みの検出を禁止します。

R_<Config_ICU>_SoftwareInterrupt_Generate

ソフトウェア割り込みを発生させます。

R_<Config_ICU>_Software2_Start

ソフトウェア割り込み 2 の検出を許可します。

R_<Config_ICU>_Software2_Stop

ソフトウェア割り込み 2 の検出を禁止します。

R_<Config_ICU>_SoftwareInterrupt2_Generate

ソフトウェア割り込み 2 を発生させます。

R_<Config_ICU>_Create_UserInit

割り込みコントローラに関するユーザ独自の初期化処理を行います。

r_<Config_ICU>_irqn_interrupt

外部端子割り込みの発生に伴う処理を行います。

r_<Config_ICU>_software_interrupt

ソフトウェア割り込みの発生に伴う処理を行います。

r_<Config_ICU>_software2_interrupt

ソフトウェア割り込み 2 の発生に伴う処理を行います。

r_<Config_ICU>_nmi_interrupt

NMI 端子割り込みの発生に伴う処理を行います。

R_<Config_ICU>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 253 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_Create
割り込みコントローラを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_ICU>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 254 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_IRQn_Start
外部端子割り込みの検出を許可します。

[指定形式]
void
備考

R_<Config_ICU>_IRQn_Start ( void );n は IRQ 端子番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 255 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_IRQn_Stop
外部端子割り込みの検出を禁止します。

[指定形式]
void
備考

R_<Config_ICU>_IRQn_Stop ( void );n は IRQ 端子番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 256 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_Software_Start
ソフトウェア割り込みの検出を許可します。

[指定形式]
void

R_<Config_ICU>_Software_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 257 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_Software_Stop
ソフトウェア割り込みの検出を禁止します。

[指定形式]
void

R_<Config_ICU>_Software_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 258 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_SoftwareInterrupt_Generate
ソフトウェア割り込みを発生させます。
備考
本 API 関数の呼び出しに伴い、r_<Config_ICU>_software_interrupt が呼び出されます。

[指定形式]
void

R_<Config_ICU>_SoftwareInterrupt_Generate ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 259 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_Software2_Start
ソフトウェア割り込み 2 の検出を許可します。

[指定形式]
void

R_<Config_ICU>_Software2_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 260 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_Software2_Stop
ソフトウェア割り込み 2 の検出を禁止します。

[指定形式]
void

R_<Config_ICU>_Software2_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 261 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_SoftwareInterrupt2_Generate
ソフトウェア割り込み 2 を発生させます。
備考
本 API 関数の呼び出しに伴い、r_<Config_ICU>_software2_interrupt が呼び出されます。

[指定形式]
void

R_<Config_ICU>_SoftwareInterrupt2_Generate ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 262 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_ICU>_Create_UserInit
割り込みコントローラに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_ICU>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_ICU>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 263 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_ICU>_irqn_interrupt
外部端子割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_ICU>_irqn_interrupt ( void );n は IRQ 端子番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 264 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_ICU>_software_interrupt
ソフトウェア割り込みの発生に伴う処理を行います。
備考
本 API 関数は、R_<Config_ICU>_SoftwareInterrupt_Generate を呼び出した場合に発生するソフトウェア割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_ICU>_software_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 265 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_ICU>_software2_interrupt
ソフトウェア割り込みの発生に伴う処理を行います。
備考
本 API 関数は、R_<Config_ICU>_SoftwareInterrupt2_Generate を呼び出した場合に発生するソフトウェア割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_ICU>_software2_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 266 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_ICU>_nmi_interrupt
NMI 端子割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_ICU>_nmi_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 267 of 562

スマート・コンフィグレータ

4. API 関数

使用例
外部割り込みでスリープモードから復帰する
main.c#include "r_smc_entry.h"void main(void){/* Enable IRQ0 interrupt */R_Config_ICU_IRQ0_Start();/* Enable sleep mode */R_Config_LPC_Sleep();
while (1U){
nop();}}
Config_ICU_user.c/* Start user code for include. Do not edit comment generated here */#include "r_smc_entry.h"/* End user code. Do not edit comment generated here */static void r_Config_ICU_irq0_interrupt(void){/* Start user code for r_Config_ICU_irq0_interrupt. Do not edit comment generated here *//* Allow sleep mode return clock to be changed */R_Config_LPC_ChangeSleepModeReturnClock(RETURN_MAIN_CLOCK);/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 268 of 562

スマート・コンフィグレータ

4.2.21

4. API 関数

消費電力低減機能

以下に、コード生成ツールが消費電力低減機能用として出力する API 関数の一覧を示します。
表 4.22

消費電力低減機能用 API 関数
API 関数名

R_<Config_LPC>_Create
R_<Config_LPC>_AllModuleClockStop

機能概要
消費電力低減機能を制御するうえで必要となる初期化処理を行います。
全モジュールのクロックを停止します。

R_<Config_LPC>_Sleep

MCU の低消費電力状態をスリープモードへと遷移させます。

R_<Config_LPC>_DeepSleep

MCU の低消費電力状態をディープスリープモードへと遷移させます。

R_<Config_LPC>_SoftwareStandby

MCU の低消費電力状態をソフトウェアスタンバイモードへと遷移させます。
MCU の低消費電力状態をディープソフトウェアスタンバイモードへと遷移させます。
MCU の動作電力制御状態を変更します。

R_<Config_LPC>_DeepSoftwareStandby
R_<Config_LPC>_ChangeOperatingPowerControl
R_<Config_LPC>_ChangeSleepModeReturnClockスリープモードが解除された際に選択されるクロックソースを設定します。

R_<Config_LPC>_Create_UserInit

消費電力低減機能に関するユーザ独自の初期化処理を行います。

R_<Config_LPC>_SetVOLSR_PGAVLS

プログラマブルゲインアンプ動作条件を設定します。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 269 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_Create
消費電力低減機能を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_LPC>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 270 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_AllModuleClockStop
全モジュールのクロックを停止します。

[指定形式]
MD_STATUS

R_<Config_LPC>_AllModuleClockStop ( void );

[引数]
なし

[戻り値]
マクロ

MD_OK

説明
正常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 271 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_Sleep
MCU の低消費電力状態をスリープモードへと遷移させます。

[指定形式]
MD_STATUS

R_<Config_LPC>_Sleep ( void );

[引数]
なし

[戻り値]
マクロ

MD_OK
MD_ERROR1

説明
正常終了
異常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 272 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_DeepSleep
MCU の低消費電力状態をディープスリープモードへと遷移させます。

[指定形式]
MD_STATUS

R_<Config_LPC>_DeepSleep ( void );

[引数]
なし

[戻り値]
マクロ

MD_OK

説明
正常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 273 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_SoftwareStandby
MCU の低消費電力状態をソフトウェアスタンバイモードへと遷移させます。

[指定形式]
MD_STATUS

R_<Config_LPC>_SoftwareStandby ( void );

[引数]
なし

[戻り値]
マクロ

MD_OK
MD_ERROR1

説明
正常終了
異常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 274 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_DeepSoftwareStandby
MCU の低消費電力状態をディープソフトウェアスタンバイモードへと遷移させます。

[指定形式]
MD_STATUS

R_<Config_LPC>_DeepSoftwareStandby ( void );

[引数]
なし

[戻り値]
マクロ

MD_OK

説明
正常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 275 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_ChangeOperatingPowerControl
MCU の動作電力制御状態を変更します。

[指定形式]
MD_STATUS

R_<Config_LPC>_ChangeOperatingPowerControl ( operating_mode_t mode );[引数]
RX130，RX230/RX231 の場合
引数

I/O
I

operating_mode_t mode;

説明
動作電力制御状態の種類
HIGH_SPEED：高速動作モード

MIDDLE_SPEED：中速動作モード

LOW_SPEED：低速動作モード

そのほかのデバイスの場合
引数

I/O
I

operating_mode_t mode;

説明
動作電力制御状態の種類
HIGH_SPEED：高速動作モード

LOW_SPEED1：低速動作モード 1

LOW_SPEED2：低速動作モード 2[戻り値]
RX130，RX230/RX231 の場合
マクロ

MD_OK
MD_ERROR1
MD_ARGERROR

説明
正常終了
低速動作モードへの変更が異常終了
引数 mode の指定が不正

そのほかのデバイスの場合
マクロ

MD_OK
MD_ERROR1
MD_ERROR2
MD_ARGERROR

説明
正常終了
低速動作モード 1 への変更が異常終了
低速動作モード 2 への変更が異常終了
引数 mode の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 276 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_ChangeSleepModeReturnClockスリープモードが解除された際に選択されるクロックソースを設定します。

[指定形式]
MD_STATUS

R_<Config_LPC>_ChangeSleepModeReturnClock ( return_clock_t clock );[引数]
RX130，RX230/RX231 の場合
I/O

引数

I

return_clock_t clock;説明
クロックソースの種類
RETURN_LOCO：低速オンチップオシレータ

RETURN_HOCO：高速オンチップオシレータ

RETURN_MAIN_CLOCK ：メインクロック発振器
RETURN_DISABLE：クロックソースの切り替えを行わない

そのほかのデバイスの場合
I/O

引数

I

return_clock_t clock;説明
クロックソースの種類
RETURN_HOCO：高速オンチップオシレータ

RETURN_MAIN_CLOCK ：メインクロック発振器
RETURN_DISABLE：クロックソースの切り替えを
行わない

[戻り値]
マクロ

MD_OK
MD_ERROR1
MD_ARGERROR

説明
正常終了
現在設定されているクロックソースの指定が不正
引数 clock の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 277 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_Create_UserInit
消費電力低減機能に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_LPC>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_LPC>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 278 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPC>_SetVOLSR_PGAVLS
プログラマブルゲインアンプ動作条件を設定します。

[指定形式]
MD_STATUS R_<Config_LPC>_SetVOLSR_PGAVLS ( uint8_t pgavls_bit );

[引数]
引数

I/O
I

説明
プログラマブルゲインアンプ動作条件

uint8_t pgavls_bit;

0u：AVCC の電圧が 4.0V 以上、かつ PGA の疑似差動入力を有効にし、端子に負電圧を入力する

1u：AVCC の電圧が 4.0V 未満、または端子に負電圧を
入力しない

[戻り値]
マクロ

MD_OK

説明
正常終了

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 279 of 562

スマート・コンフィグレータ

4. API 関数

使用例
割り込みコントローラ使用例を参照

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 280 of 562

スマート・コンフィグレータ

4.2.22

4. API 関数

ローパワータイマ

以下に、コード生成ツールがローパワータイマ用として出力する API 関数の一覧を示します。
表 4.23

ローパワータイマ用 API 関数
API 関数名

機能概要

R_<Config_LPT>_Start

ローパワータイマを制御するうえで必要となる初期化処理を行います。
カウントを開始します。

R_<Config_LPT>_Stop

カウントを終了します。

R_<Config_LPT>_Create_UserInit

ローパワータイマに関するユーザ独自の初期化処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 281 of 562

R_<Config_LPT>_Createスマート・コンフィグレータ

4. API 関数

R_<Config_LPT>_Create
ローパワータイマを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_LPT>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 282 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPT>_Start
カウントを開始します。

[指定形式]
void

R_<Config_LPT>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 283 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPT>_Stop
カウントを終了します。

[指定形式]
void

R_<Config_LPT>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 284 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LPT>_Create_UserInit
ローパワータイマに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_LPT>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_LPT>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 285 of 562

スマート・コンフィグレータ

4. API 関数

使用例なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 286 of 562

スマート・コンフィグレータ

4.2.23

4. API 関数

ノーマルモード

以下に、コード生成ツールがノーマルモード（MTU/TPU）用として出力する API 関数の一覧を示します。
表 4.24

ノーマルモード用 API 関数
API 関数名

機能概要

R_<Config_MTU0>_Start

ノーマルモード（MTU/TPU）を制御するうえで必要となる初期化処理を行います。
カウンタを開始します。

R_<Config_MTU0>_Stop

カウンタを終了します。

R_<Config_MTU0>_Create_UserInit

ノーマルモード（MTU/TPU）に関するユーザ独自の初期化処理を行います。

r_<Config_MTU0>_tgimn_interrupt

インプットキャプチャ／コンペアマッチ割り込みの発生に伴う処理を行います。
（リソースにより、API 関数名が異なります。）

R_<Config_MTU0>_Create

r_<Config_MTU0>_tginm_interrupt
r_<Config_MTU0>_tcivn_interrupt
r_<Config_MTU0>_tcinv_interrupt

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

オーバフロー割り込みの発生に伴う処理を行います。
（リソースにより、API 関数名が異なります。）

Page 287 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Create
ノーマルモード（MTU/TPU）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_MTU0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 288 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Start
カウンタを開始します。

[指定形式]
void

R_<Config_MTU0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 289 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Stop
カウンタを終了します。

[指定形式]
void

R_<Config_MTU0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 290 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Create_UserInit
ノーマルモード（MTU/TPU）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_MTU0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_MTU0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 291 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU0>_tgimn_interrupt

r_<Config_MTU0>_tginm_interrupt
インプットキャプチャ／コンペアマッチ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_MTU0>_tgimn_interrupt ( void );void

r_<Config_MTU0>_tginm_interrupt ( void );備考
備考

n はチャネル番号を、m はタイマジェネラルレジスタ番号を意味します。
リソースにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 292 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU0>_tcivn_interrupt

r_<Config_MTU0>_tcinv_interrupt
オーバフロー割り込みの発生に伴う処理を行います。

1
void

r_<Config_MTU0>_tcivn_interrupt ( void );void

r_<Config_MTU0>_tcinv_interrupt ( void );備考
備考

n はチャネル番号を意味します。
リソースにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 293 of 562

スマート・コンフィグレータ

4. API 関数

使用例
ワンショットタイマとして使用する
main.c#include "r_smc_entry.h"void main(void){/* Start MTU channel 0 counter */R_Config_MTU0_Start();while (1U){
nop();}}
Config_MTU0_user.cstatic void r_<Config_MTU0_tgia0_interrupt(void){/* Start user code for r_<Config_MTU0_tgia0_interrupt. Do not edit comment generated here *//* Stop MTU channel 0 counter */R_Config_MTU0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 294 of 562

スマート・コンフィグレータ

4.2.244. API 関数

位相計数モードタイマ

以下に、コード生成ツールが位相計数モードタイマ（MTU/TPU）用として出力する API 関数の一覧を示します。
表 4.25位相計数モードタイマ用 API 関数
API 関数名

機能概要

R_<Config_MTU1>_Start

位相計数モードタイマ（MTU/TPU）を制御するうえで必要となる初期化処理を行います。
カウンタを開始します。

R_<Config_MTU1>_Stop

カウンタを終了します。

R_<Config_MTU1_MTU2>_MTU_Start

32 ビットカスケード動作のために MTU のすべてチャンネルのカ
ウンタを同時に開始します。

R_<Config_MTU1_MTU2>_MTU_Stop

r_<Config_MTU1>_tcinv_interrupt

32 ビットカスケード動作のために MTU のすべてのチャンネルのカウンタを同時に終了します。
位相計数モードタイマ（MTU/TPU）に関するユーザ独自の初期化処理を行います。
インプットキャプチャ／コンペアマッチ割り込みの発生に伴う処理を行います。
（リソースにより、API 関数名が異なります。）
オーバフロー割り込みの発生に伴う処理を行います。
（リソースにより、API 関数名が異なります。）

r_<Config_MTU1>_tciun_interrupt

アンダフロー割り込みの発生に伴う処理を行います。

r_<Config_MTU1>_tcinu_interrupt（リソースにより、API 関数名が異なります。）

R_<Config_MTU1>_Create

R_<Config_MTU1>_Create_UserInit
r_<Config_MTU1>_tgimn_interrupt
r_<Config_MTU1>_tginm_interrupt
r_<Config_MTU1>_tcivn_interrupt

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 295 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU1>_Create
位相計数モードタイマ（MTU/TPU）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_MTU1>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 296 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU1>_Start
カウンタを開始します。

[指定形式]
void

R_<Config_MTU1>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 297 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU1>_Stop
カウンタを終了します。

[指定形式]
void

R_<Config_MTU1>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 298 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU1_MTU2>_MTU_Start
32 ビットカスケード動作で使用する MTU チャンネルのカウンタを同時に開始します。カスケード動作に関連するチャンネルは、カスケードモードの GUI から設定できます。

[指定形式]
Void

R_<Config_MTU1_MTU2>_MTU_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 299 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU1_MTU2>_MTU_Stop
32 ビットカスケード動作で使用する MTU チャンネルのカウンタを同時に終了します。カスケード動作に関連するチャンネルは、カスケードモードの GUI から設定できます。

[指定形式]
void

R_<Config_MTU1_MTU2>_MTU_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 300 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU1>_Create_UserInit
位相計数モードタイマ（MTU/TPU）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_MTU1>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_MTU1>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 301 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU1>_tgimn_interrupt

r_<Config_MTU1>_tginm_interrupt
インプットキャプチャ／コンペアマッチ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_MTU1>_tgimn_interrupt ( void );void

r_<Config_MTU1>_tginm_interrupt ( void );備考
備考

n はチャネル番号を、m はタイマジェネラルレジスタ番号を意味します。
リソースにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 302 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU1>_tcivn_interrupt

r_<Config_MTU1>_tcinv_interrupt
オーバフロー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_MTU1>_tcivn_interrupt ( void );void

r_<Config_MTU1>_tcinv_interrupt ( void );備考
備考

n はチャネル番号を意味します。
リソースにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 303 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU1>_tciun_interrupt

r_<Config_MTU1>_tcinu_interrupt
アンダフロー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_MTU1>_tciun_interrupt ( void );void

r_<Config_MTU1>_tcinu_interrupt ( void );備考
備考

n はチャネル番号を意味します。
リソースにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 304 of 562

スマート・コンフィグレータ

4. API 関数

使用例
2 相の入力パルスにより、エンコーダ回転方向の確定を行う
main.c#include "r_smc_entry.h"void main(void){/* Start the MTU1 channel counter */R_Config_MTU1_Start();while (1U){
nop();}}
Config_MTU1_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_mtu1_dir;/* End user code. Do not edit comment generated here */void R_Config_MTU1_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here *//* Clear state */g_mtu1_dir = 0U;/* End user code. Do not edit comment generated here */}static void r_Config_MTU1_tgia1_interrupt(void){/* Start user code for r_Config_MTU1_tgia1_interrupt. Do not edit comment generated here *//* Set CW state */g_mtu1_dir = 1U;/* End user code. Do not edit comment generated here */}static void r_Config_MTU1_tgib1_interrupt(void){/* Start user code for r_Config_MTU1_tgib1_interrupt. Do not edit comment generated here *//* Set CCW state */g_mtu1_dir = 2U;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 305 of 562

スマート・コンフィグレータ

4.2.25

4. API 関数

ポートアウトプットイネーブル

以下に、コード生成ツールがポートアウトプットイネーブル用として出力する API 関数の一覧を示します。
表 4.26

ポートアウトプットイネーブル用 API 関数
API 関数名

機能概要

R_<Config_POE>_Start

ポートアウトプットイネーブルを制御するうえで必要となる初期化処理を行います。
割り込みを許可します。

R_<Config_POE>_Stop

割り込みを禁止します。

R_<Config_POE>_Set_HiZ_MTUn

MTUn 端子をハイインピーダンス状態にします。

R_<Config_POE>_Clear_HiZ_MTUn

MTUn 端子のハイインピーダンス状態を解除します。

R_<Config_POE>_Set_HiZ_GPTn

GPTn 端子をハイインピーダンス状態にします。

R_<Config_POE>_Clear_HiZ_GPTn

GPTn 端子のハイインピーダンス状態を解除します。

R_<Config_POE>_Create_UserInit

ポートアウトプットイネーブルに関するユーザ独自の初期化処理を行います。

r_<Config_POE>_oein_interrupt

アウトプットイネーブル割り込みの発生に伴う処理を行います。

R_<Config_POE>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 306 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Create
ポートアウトプットイネーブルを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_POE>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 307 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Start
割り込みを許可します。
備考 POE 割り込みが禁止に設定されていると、この API 関数は空の状態で生成されます。

[指定形式]
void

R_<Config_POE>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 308 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Stop
割り込みを禁止します。
備考 POE 割り込みが禁止に設定されていると、この API 関数は空の状態で生成されます。

[指定形式]
void

R_<Config_POE>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 309 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Set_HiZ_MTUn
MTUn 端子をハイインピーダンス状態にします。

[指定形式]
void
備考

R_<Config_POE>_Set_HiZ_MTUn ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 310 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Clear_HiZ_MTUn
MTUn 端子のハイインピーダンス状態を解除します。

[指定形式]
void
備考

R_<Config_POE>_Clear_HiZ_MTUn ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 311 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Set_HiZ_GPTn
GPTn 端子をハイインピーダンス状態にします。

[指定形式]
void
備考

R_<Config_POE>_Set_HiZ_GPTn ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 312 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Clear_HiZ_GPTn
GPTn 端子のハイインピーダンス状態を解除します。

[指定形式]
void
備考

R_<Config_POE>_Clear_HiZ_GPTn ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 313 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_POE>_Create_UserInit
ポートアウトプットイネーブルに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_POE>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_POE>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 314 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_POE>_oein_interrupt
アウトプットイネーブル割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_POE>_oein_interrupt ( void );n はアウトプットイネーブル割り込み要因番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 315 of 562

スマート・コンフィグレータ

4. API 関数

使用例
アウトプットイネーブル割り込み時に MTU0 端子もハイインピーダンスに設定する
main.c#include "r_smc_entry.h"void main(void){/* Start the POE module */R_Config_POE_Start();while (1U){
nop();}}
Config_POE_user.c
void r_Config_POE_oei1_interrupt(void){/* Start user code for r_Config_POE_oei1_interrupt. Do not edit comment generated here *//* Stop the POE module */R_Config_POE_Stop();/* Place MTU0 pins in high-impedance */R_Config_POE_Set_HiZ_MTU0();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 316 of 562

スマート・コンフィグレータ

4.2.26

4. API 関数

ポート

以下に、コード生成ツールがポート用として出力する API 関数の一覧を示します。
表 4.27

ポート用 API 関数
API 関数名

機能概要

R_<Config_PORT>_Create

ポートを制御するうえで必要となる初期化処理を行います。

R_<Config_PORT>_Create_UserInit

ポートに関するユーザ独自の初期化処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 317 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_PORT>_Create
ポートを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_PORT>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 318 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_PORT>_Create_UserInit
ポートに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_PORT>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_PORT>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 319 of 562

スマート・コンフィグレータ

4. API 関数

使用例なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 320 of 562

スマート・コンフィグレータ

4.2.27

4. API 関数

プログラマブルパルスジェネレータ

以下に、コード生成ツールがプログラマブルパルスジェネレータ用として出力する API 関数の一覧を示します。
表 4.28

プログラマブルパルスジェネレータ用 API 関数
API 関数名

機能概要

R_<Config_PPG0>_Create

プログラマブルパルスジェネレータを制御するうえで必要となる初期化処理を行います。

R_<Config_PPG0>_Create_UserInit

プログラマブルパルスジェネレータに関するユーザ独自の初期化処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 321 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_PPG0>_Create
プログラマブルパルスジェネレータを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_PPG0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 322 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_PPG0>_Create_UserInit
プログラマブルパルスジェネレータに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_PPG0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_PPG0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 323 of 562

スマート・コンフィグレータ

4. API 関数

使用例なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 324 of 562

スマート・コンフィグレータ

4.2.284. API 関数

PWM モードタイマ

以下に、コード生成ツールが PWM モードタイマ（MTU/TPU）用として出力する API 関数の一覧を示します。
表 4.29PWM モードタイマ用 API 関数
API 関数名

機能概要

R_<Config_MTU0>_Start

PWM モードタイマ（MTU/TPU）を制御するうえで必要となる初期化処理を行います。
カウンタを開始します。

R_<Config_MTU0>_Stop

カウンタを終了します。

R_<Config_MTU0>_Create_UserInit

PWM モードタイマ（MTU/TPU）に関するユーザ独自の初期化処理を行います。

r_<Config_MTU0>_tgimn_interrupt

コンペアマッチ割り込みの発生に伴う処理を行います。
（リソースにより、API 関数名が異なります。）

R_<Config_MTU0>_Create

r_<Config_MTU0>_tginm_interrupt
r_<Config_MTU0>_tcivn_interrupt
r_<Config_MTU0>_tcinv_interrupt

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

オーバフロー割り込みの発生に伴う処理を行います。
（リソースにより、API 関数名が異なります。）

Page 325 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Create
PWM モードタイマ（MTU/TPU）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_MTU0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 326 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Start
カウンタを開始します。

[指定形式]
void

R_<Config_MTU0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 327 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Stop
カウンタを終了します。

[指定形式]
void

R_<Config_MTU0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 328 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU0>_Create_UserInit
PWM モードタイマ（MTU/TPU）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_MTU0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_MTU0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 329 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU0>_tgimn_interrupt

r_<Config_MTU0>_tginm_interrupt
コンペアマッチ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_MTU0>_tgimn_interrupt ( void );void

r_<Config_MTU0>_tginm_interrupt ( void );

備考 1
備考 2

n はチャネル番号を、m はタイマジェネラルレジスタ番号を意味します。
リソースにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 330 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU0>_tcivn_interrupt

r_<Config_MTU0>_tcinv_interrupt
オーバフロー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_MTU0>_tcivn_interrupt ( void );void

r_<Config_MTU0>_tcinv_interrupt ( void );

備考 1
備考 2

n はチャネル番号を意味します。
リソースにより、API 関数名が異なります。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 331 of 562

スマート・コンフィグレータ

4. API 関数

使用例
PWM 出力を 10 回発生させる
main.c#include "r_smc_entry.h"void main(void){/* Start MTU channel 0 counter */R_Config_MTU0_Start();while (1U){
nop();}}
Config_MTU0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_mtu0_cnt;/* End user code. Do not edit comment generated here */void R_Config_MTU0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here *//* Reset the countor */g_mtu0_cnt = 0U;/* End user code. Do not edit comment generated here */}static void r_Config_MTU0_tgia0_interrupt(void){/* Start user code for r_Config_MTU0_tgia0_interrupt. Do not edit comment generated here */if ((++g_mtu0_cnt) > 9U){/* Stop MTU channel 0 counter */R_Config_MTU0_Stop();}/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 332 of 562

スマート・コンフィグレータ

4.2.294. API 関数

リアルタイムクロック

以下に、コード生成ツールがリアルタイムクロック用として出力する API 関数の一覧を示します。
表 4.30

リアルタイムクロック用 API 関数
API 関数名

R_<Config_RTC>_Create
R_<Config_RTC>_Start

機能概要
リアルタイムクロックを制御するうえで必要となる初期化処理を行います。
カウンタを開始します。

R_<Config_RTC>_Stop

カウンタを終了します。

R_<Config_RTC>_Restart

カウンタを終了し、カウンタを初期化したのち、カウンタを再開します。

R_<Config_RTC>_Restart_BinaryCounter

カウンタを終了し、カウンタを再開します。

R_<Config_RTC>_Set_CalendarCounterValue

カレンダ値を設定します。

R_<Config_RTC>_Get_CalendarCounterValue

カレンダ値を獲得します。

R_<Config_RTC>_Get_CalendarTimeCaptureValuen

キャプチャしたカレンダ値を獲得します。

R_<Config_RTC>_Set_BinaryCounterValue

バイナリカウント値を設定します。

R_<Config_RTC>_Get_BinaryCounterValue

バイナリカウント値を獲得します。

R_<Config_RTC>_Get_BinaryTimeCaptureValuen

キャプチャしたバイナリカウント値を獲得します。

R_<Config_RTC>_Set_RTCOUTOn

RTCOUT への出力周期を設定すると伴に、RTCOUT 出力を開始します。
RTCOUT 出力を終了します。

R_<Config_RTC>_Set_RTCOUTOff
R_<Config_RTC>_Set_CalendarAlarm

アラーム割り込みの発生条件を設定するとともに、アラーム
割り込みの検出を許可します。（カレンダカウントモード）

R_<Config_RTC>_Set_BinaryAlarm

アラーム割り込みの発生条件を設定するとともに、アラーム
割り込みの検出を許可します。（バイナリカウントモード）

R_<Config_RTC>_Set_ConstPeriodInterruptOn

周期割り込みの発生周期を設定すると伴に、周期割り込みの検出を許可します。

R_<Config_RTC>_Set_ConstPeriodInterruptOff

周期割り込みの検出を禁止します。

R_<Config_RTC>_Set_CarryInterruptOn

桁上げ割り込みの検出を許可します。

R_<Config_RTC>_Set_CarryInterruptOff

桁上げ割り込みの検出を禁止します。

R_<Config_RTC>_Enable_Alarm_Interruptf

アラーム割り込みを許可します。

R_<Config_RTC>_Disable_Alarm_Interrupt

アラーム割り込みを禁止します。

R_<Config_RTC>_Create_UserInit

リアルタイムクロックに関するユーザ独自の初期化処理を行います。

r_<Config_RTC>_alm_interrupt

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

r_<Config_RTC>_prd_interrupt

周期割り込みの発生に伴う処理を行います。

r_<Config_RTC>_cup_interrupt

桁上げ割り込みの発生に伴う処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 333 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Create
リアルタイムクロックを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_RTC>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 334 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Start
カウンタを開始します。

[指定形式]
void

R_<Config_RTC>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 335 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Stop
カウンタを終了します。

[指定形式]
void

R_<Config_RTC>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 336 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Restart
カウンタを終了し、カウンタを初期化したのち、カウンタを再開します。

[指定形式]
void

R_<Config_RTC>_Restart ( rtc_calendarcounter_value_t counter_write_val );

[引数]
引数

I/O
I

rtc_calendarcounter_value_t
counter_write_val;

備考

説明
初期値（年，月，日，曜日，時，分，秒）

以下に、初期値 rtc_calendarcounter_value_t の構成を示します。
typedef struct {uint8_t rseccnt;/* 秒 */
uint8_t rmincnt;/* 分 */
uint8_t rhrcnt;/* 時 */
uint8_t rdaycnt;/* 日 */
uint8_t rwkcnt;/* 曜日（ 0 ：日曜日， 6 ：土曜日） */uint8_t rmoncnt;/* 月 */
uint16_t ryrcnt;/* 年 */} rtc_calendarcounter_value_t;

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 337 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Restart_BinaryCounter
カウンタを終了し、カウンタを再開します。

[指定形式]
void

R_<Config_RTC>_Restart_BinaryCounter ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 338 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_CalendarCounterValue
カレンダ値を設定します。

[指定形式]
void

R_<Config_RTC>_Set_CalendarCounterValue ( rtc_calendarcounter_value_t counter_write_val );

[引数]
引数

I/O
I

rtc_calendarcounter_value_t
counter_write_val;

備考

説明
カレンダ値（年，月，日，曜日，時，分，秒）

以下に、カレンダ値 rtc_calendarcounter_value_t の構成を示します。
typedef struct {uint8_t rseccnt;/* 秒 */
uint8_t rmincnt;/* 分 */
uint8_t rhrcnt;/* 時 */
uint8_t rdaycnt;/* 日 */
uint8_t rwkcnt;/* 曜日（ 0 ：日曜日， 6 ：土曜日） */uint8_t rmoncnt;/* 月 */
uint16_t ryrcnt;/* 年 */} rtc_calendarcounter_value_t;

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 339 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Get_CalendarCounterValue
カレンダ値を獲得します。

[指定形式]
void
R_<Config_RTC>_Get_CalendarCounterValue ( rtc_calendarcounter_value_t * const
counter_read_val );

[引数]
引数

I/O
O

説明

rtc_calendarcounter_value_t * const 獲得したカレンダ値（年，月，日，曜日，時，分，秒）を格納する領域へのポインタ
counter_read_val;

備考

以下に、カレンダ値 rtc_calendarcounter_value_t の構成を示します。
typedef struct {uint8_t rseccnt;/* 秒 */
uint8_t rmincnt;/* 分 */
uint8_t rhrcnt;/* 時 */
uint8_t rdaycnt;/* 日 */
uint8_t rwkcnt;/* 曜日（ 0 ：日曜日， 6 ：土曜日） */uint8_t rmoncnt;/* 月 */
uint16_t ryrcnt;/* 年 */} rtc_calendarcounter_value_t;

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 340 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Get_CalendarTimeCaptureValuen
キャプチャしたカレンダ値を獲得します。

[指定形式]
void R_<Config_RTC>_Get_CalendarTimeCaptureValuen ( rtc_calendarcounter_value_t * const
counter_read_val );備考

n は、チャネル番号を意味します。

[引数]
引数

I/O
O

説明

rtc_calendarcounter_value_t * const 獲得したカレンダ値（年，月，日，曜日，時，分，秒）を格納する領域へのポインタ
counter_read_val;

備考

以下に、カレンダ rtc_calendarcounter_value_t の構成を示します。
typedef struct {uint8_t rseccnt;/* 秒 */
uint8_t rmincnt;/* 分 */
uint8_t rhrcnt;/* 時 */
uint8_t rdaycnt;/* 日 */
uint8_t rwkcnt;/* 曜日（ 0 ：日曜日， 6 ：土曜日） */uint8_t rmoncnt;/* 月 */
uint16_t ryrcnt;/* 年 */} rtc_calendarcounter_value_t;

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 341 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_BinaryCounterValue
バイナリカウント値を設定します。

[指定形式]
void

R_<Config_RTC>_Set_BinaryCounterValue ( uint32_t counter_write_val );

[引数]
引数

I/O
I

uint32_t counter_write_val;

説明
バイナリカウント値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 342 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Get_BinaryCounterValue
バイナリカウント値を獲得します。

[指定形式]
void

R_<Config_RTC>_Get_BinaryCounterValue ( uint32_t * const counter_read_val );

[引数]
I/O

引数

説明

O

uint32_t * const counter_read_val;

獲得したバイナリカウント値を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 343 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Get_BinaryTimeCaptureValuen
キャプチャしたバイナリカウント値を獲得します。

[指定形式]
void

R_<Config_RTC>_Get_BinaryTimeCaptureValuen ( uint32_t * const counter_read_val );備考

n は、チャネル番号を意味します。

[引数]
I/O

引数

説明

O

uint32_t * const counter_read_val;

獲得したバイナリカウント値を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 344 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_RTCOUTOn
RTCOUT への出力周期を設定すると伴に、RTCOUT 出力を開始します。

[指定形式]
void

R_<Config_RTC>_Set_RTCOUTOn ( rtc_rtcout_period_t rtcout_freq );

[引数]
引数

I/O
I

rtc_rtcout_period_t rtcout_freq;

説明
RTCOUT への出力周期
RTCOUT_1HZ：1Hz

RTCOUT_64HZ

：64Hz

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 345 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_RTCOUTOff
RTCOUT 出力を終了します。

[指定形式]
void

R_<Config_RTC>_Set_RTCOUTOff ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 346 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_CalendarAlarm
アラーム割り込みの発生条件を設定すると伴に、アラーム割り込みの検出を許可します。
（カレンダカウントモード）[指定形式]
void
R_<Config_RTC>_Set_CalendarAlarm ( rtc_calendar_alarm_enable_t alarm_enable、
rtc_calendar_alarm_value_t alarm_val );

[引数]
引数

I/O
I
I

rtc_calendar_alarm_enable_t
alarm_enable;
rtc_calendar_alarm_value_t
alarm_val;

備考 1.

説明
比較フラグ（年，月，日，曜日，時，分，秒）
カレンダ値（年，月，日，曜日，時，分，秒）

以下に、比較フラグ rtc_calendar_alarm_enable_t の構成を示します。
typedef struct {uint8_t sec_enb; /* 秒（ 0x0 ：比較を行わない、 0x80 ：比較を行う）*/
uint8_t min_enb; /* 分（ 0x0 ：比較を行わない、 0x80 ：比較を行う）*/
uint8_t hr_enb;/* 時（ 0x0 ：比較を行わない、 0x80 ：比較を行う）*/
uint8_t day_enb; /* 日（ 0x0 ：比較を行わない、 0x80 ：比較を行う）*/
uint8_t wk_enb; /* 曜日（ 0x0 ：比較を行わない、 0x80 ：比較を行う） */uint8_t mon_enb; /* 月（ 0x0 ：比較を行わない、 0x80 ：比較を行う）*//* 年（ 0x0 ：比較を行わない、 0x80 ：比較を行う）*/
uint8_t yr_enb;} rtc_calendar_alarm_enable_t;

備考 2.

以下に、カレンダ値 rtc_calendar_alarm_value_t の構成を示します。
typedef struct {uint8_t rsecar;/* 秒 */
uint8_t rminar;/* 分 */
uint8_t rhrar;/* 時 */
uint8_t rdayar;/* 日 */
uint8_t rwkar;/* 曜日（ 0 ：日曜日， 6 ：土曜日） */uint8_t rmonar;/* 月 */
uint16_t ryrar;/* 年 */} rtc_calendar_alarm_value_t;

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 347 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_BinaryAlarm
アラーム割り込みの発生条件を設定すると伴に、アラーム割り込みの検出を許可します。
（バイナリカウントモード）[指定形式]
void

R_<Config_RTC>_Set_BinaryAlarm ( uint32_t alarm_enable、 uint32_t alarm_val );

[引数]
引数

I/O
I

I

uint32_t alarm_enable;

uint32_t alarm_val;

説明
比較フラグ
0x0

：比較を行わない

0x1：比較を行うバイナリカウント値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 348 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_ConstPeriodInterruptOn
周期割り込みの発生周期を設定すると伴に、周期割り込みの検出を許可します。

[指定形式]
void

R_<Config_RTC>_Set_ConstPeriodInterruptOn ( rtc_int_period_t period );

[引数]
引数

I/O
I

rtc_int_period_t period;

説明
周期割り込みの発生周期
PES_2_SEC：2 秒

PES_1_SEC：1 秒

PES_1_2_SEC：1/2 秒

PES_1_4_SEC：1/4 秒

PES_1_8_SEC：1/8 秒

PES_1_16_SEC：1/16 秒

PES_1_32_SEC：1/32 秒

PES_1_64_SEC：1/64 秒

PES_1_128_SEC：1/128 秒

PES_1_256_SEC：1/256 秒[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 349 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_ConstPeriodInterruptOff
周期割り込みの検出を禁止します。

[指定形式]
void

R_<Config_RTC>_Set_ConstPeriodInterruptOff ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 350 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_CarryInterruptOn
桁上げ割り込みの検出を許可します。

[指定形式]
void

R_<Config_RTC>_Set_CarryInterruptOn ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 351 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Set_CarryInterruptOff
桁上げ割り込みの検出を禁止します。

[指定形式]
void

R_<Config_RTC>_Set_CarryInterruptOff ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 352 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Enable_Alarm_Interruptf
アラーム割り込みを許可します。

[指定形式]
void

R_<Config_RTC>_Enable_Alarm_Interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 353 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Disable_Alarm_Interrupt
アラーム割り込みを禁止します。

[指定形式]
void

R_<Config_RTC>_Disable_Alarm_Interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 354 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RTC>_Create_UserInit
リアルタイムクロックに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_RTC>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_RTC>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 355 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RTC>_alm_interrupt
アラーム割り込みの発生に伴う処理を行います。
備考
本 API 関数は、R_<Config_RTC>_Set_CalendarAlarm で指定された条件を満足した場合に発生するアラーム割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_RTC>_alm_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 356 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RTC>_prd_interrupt
周期割り込みの発生に伴う処理を行います。
備考
本 API 関 数 は 、 R_<Config_RTC>_Set_ConstPeriodInterruptOn で 指 定 さ れ た 周 期
period が経過した場合に発生する周期割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_RTC>_prd_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 357 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RTC>_cup_interrupt
桁上げ割り込みの発生に伴う処理を行います。
備考
本 API 関数は、秒カウンタ（RSECCNT）／バイナリカウンタ 0（BCNT0）の桁上げを行った場合、または 64Hz カウンタ（R64CNT）の読み出しと 64Hz カウンタ（R64CNT）の桁上げが重複した場合に発生する桁上げ割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_RTC>_cup_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 358 of 562

スマート・コンフィグレータ

4. API 関数

使用例
アラーム割り込みで擬似的に閏秒の補正を行う（特定日の日付変更直前の 59 秒時点で 58 秒に戻す）
main.c#include "r_smc_entry.h"void main(void){/* Start RTC counter */R_Config_RTC_Start();while (1U){
nop();}}
Config_RTC_user.c/* Start user code for include. Do not edit comment generated here */volatile rtc_calendarcounter_value_t counter_val;/* End user code. Do not edit comment generated here */static void r_Config_RTC_alm_interrupt(void){/* Start user code for r_Config_RTC_alm_interrupt. Do not edit comment generated here *//* Disable ALM interrupt */IEN(RTC、ALM) = 0U;/* Get RTC calendar counter value */R_Config_RTC_Get_CalendarCounterValue((rtc_calendarcounter_value_t *)&counter_val);/* Change the seconds */counter_val.rseccnt = 0x58U;/* Set RTC calendar counter value */R_Config_RTC_Set_CalendarCounterValue(counter_val);/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 359 of 562

スマート・コンフィグレータ

4.2.304. API 関数

リモコン信号受信機能

以下に、コード生成ツールがリモコン信号受信機能用として出力する API 関数の一覧を示します。
表 4.31

リモコン信号受信機能用 API 関数
API 関数名

機能概要

R_<Config_REMC0>_Start

リモコン信号受信機能を制御するうえで必要となる初期化処理を行います。
リモコン信号受信機能の動作を開始します。

R_<Config_REMC0>_Stop

リモコン信号受信機能の動作を停止します。

R_<Config_REMC0>_Read

受信データの読み出しを開始します。

R_<Config_REMC0>_Create_UserInit
r_<Config_REMC0>_remcin_interrupt

リモコン信号受信機能に関するユーザ独自の初期化処理を行います。
REMC 割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_comparematch

コンペア一致割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_receiveerror

受信エラー割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_receiveend

データ受信完了割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_bufferfull

受信バッファフル割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_header

ヘッダパターン一致割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_data0

データ“0”パターンの一致割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_data1

データ“1”パターンの一致割り込みに伴う処理を行います。

r_<Config_REMC0>_callback_specialdata

特殊データパターン一致割り込みに伴う処理を行います。

R_<Config_REMC0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 360 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_REMC0>_Create
リモコン信号受信機能を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_REMC0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 361 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_REMC0>_Start
リモコン信号受信機能の動作を開始します。

[指定形式]
void

R_<Config_REMC0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 362 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_REMC0>_Stop
リモコン信号受信機能の動作を停止します。

[指定形式]
void

R_<Config_REMC0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 363 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_REMC0>_Read
受信データの読み出しを開始します。
備考
本 API 関数は、データ受信完了時に REMC 割り込みルーチン内で読み出す受信データの格納先を設定します。

[指定形式]
MD_STATUS

R_<Config_REMC0>_Read ( uint8_t * const rx_buf, uint8_t rx_num );

[引数]
引数

I/O
O
I

uint8_t * const rx_buf
uint8_t rx_num

説明
受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ERROR1

説明
正常終了
引数 rx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 364 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_REMC0>_Create_UserInit
リモコン信号受信機能に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_REMC0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_REMC0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 365 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_remcin_interrupt
REMC 割り込みに伴う処理を行います。

[指定形式]
void
備考

r_<Config_REMC0>_remcin_interrupt ( void );n はチャネル番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 366 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_comparematch
コンペア一致割り込みに伴う処理を行います。
備考
API 関 数 は 、 REMC 割 り 込 み に 対 応 し た 割 り 込 み 処 理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_comparematch ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 367 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_receiveerror
受信エラー割り込みに伴う処理を行います。
備考
API 関 数 は 、 REMC 割 り 込 み に 対 応 し た 割 り 込 み 処 理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_receiveerror ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 368 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_receiveend
データ受信完了割り込みに伴う処理を行います。
備考
API 関 数 は 、 REMC 割 り 込 み に 対 応 し た 割 り 込 み 処 理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 369 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_bufferfull
受信バッファフル割り込みに伴う処理を行います。
備考
API 関 数 は 、 REMC 割 り 込 み に 対 応 し た 割 り 込 み 処 理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_bufferfull ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 370 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_header
ヘッダパターン一致割り込みに伴う処理を行います。
備考
API 関 数 は 、 REMC 割 り 込 み に 対 応 し た 割 り 込 み 処 理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_header ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 371 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_data0
データ“0”パターンの一致割り込みに伴う処理を行います。
備考
API 関 数 は 、 REMC 割 り 込 み に 対 応 し た 割 り 込 み 処 理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_data0 ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 372 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_data1
データ“1”パターンの一致割り込みに伴う処理を行います。
備考
API 関数は、REMC 割り込みに対応した割り込み処理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_data1 ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 373 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_REMC0>_callback_specialdata
特殊データパターン一致割り込みに伴う処理を行います。
備考
API 関 数 は 、 REMC 割 り 込 み に 対 応 し た 割 り 込 み 処 理
r_<Config_REMC0>_remcin_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_REMC0>_callback_specialdata ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 374 of 562

スマート・コンフィグレータ

4. API 関数

使用例
データ受信完了でリモコン受信を停止する
main.c#include "r_smc_entry.h"
extern volatile uint8_t g_remc0_rx_buf[8];void main(void){/* Start the REMC0 operation */R_Config_REMC0_Start();/* Read data from receive data buffer */R_Config_REMC0_Read((uint8_t *)g_remc0_rx_buf, 8U);
while (1U){
nop();}}
Config_REMC0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_remc0_rx_buf[8];/* End user code. Do not edit comment generated here */static void r_Config_REMC0_callback_receiveend(void){/* Start user code for r_Config_REMC0_callback_receiveend. Do not edit comment generated
here *//* Stop the REMC0 operation */R_Config_REMC0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 375 of 562

スマート・コンフィグレータ

4.2.31

4. API 関数

SCI/SCIF 調歩同期式モード

以下に、コード生成ツールが SCI/SCIF 調歩同期式モード用として出力する API 関数の一覧を示します。
表 4.32

SCI/SCIF/RSCI 調歩同期式モード用 API 関数
API 関数名

機能概要

R_<Config_SCI0>_StartSCI/SCIF 調歩同期式モードを制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_SCI0>_Stop

通信を終了します。

R_<Config_SCI0>_Serial_Send

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

R_<Config_SCI0>_Serial_Receive

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

R_<Config_SCI0>_Serial_Multiprocessor_Send【 SCI/RSCI 】送信を開始します。（マルチプロセッサ通信機能）

R_<Config_SCI0>_Serial_Multiprocessor_Receive【 SCI/RSCI 】受信を開始します。（マルチプロセッサ通信機能）

R_<Config_SCI0>_Create_UserInit

SCI/SCIF 調歩同期式モードに関するユーザ独自の初期化処理を行います。

r_<Config_SCI0>_transmitend_interrupt【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_transmit_interrupt【 SCI/RSCI 】送信データエンプティ割り込みの発生に伴う処理

r_<Config_SCI0>_receive_interrupt【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行い

r_<Config_SCI0>_receiveerror_interrupt【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行いまr_<Config_SCI0>_teif_interrupt【 SCIF 】送信完了割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_txif_interrupt【 SCIF 】送信 FIFO データエンプティ割り込みの発生に伴う処

R_<Config_SCI0>_Createを行います。
ます。
す。

理を行います。
r_<Config_SCI0>_rxif_interrupt【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行

r_<Config_SCI0>_drif_interrupt【 SCIF 】受信データレディ割り込みの発生に伴う処理を行いまいます。
す。
r_<Config_SCI0>_erif_interrupt【 SCIF 】受信エラー割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_brif_interrupt【 SCIF 】ブレーク割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_transmitend【 SCI/RSCI 】送信終了／送信データエンプティ割り込みの発生に伴う処理を行います。
【 SCIF 】送信完了／送信 FIFO データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_receiveend【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行います。
【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_receiveerror【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_error【 SCIF 】受信エラー／ブレーク割り込みの発生に伴う処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 376 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create
SCI/SCIF 調歩同期式モードを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 377 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Start
通信を開始します。

[指定形式]
void

R_<Config_SCI0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 378 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_SCI0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 379 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Serial_Send
送信を開始します。
（調歩同期式モード）
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数
tx_num で指定された回数だけ繰り返し行います。
備考 2.
送信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_SCI0>_Serial_Send ( uint8_t * const tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I
I

uint8_t * const tx_buf;
uint16_t tx_num;

説明
送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 380 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Serial_Receive
受信を開始します。
（調歩同期式モード）
備考 1.
本 API 関数では、 1 バイト単位の受信を引数 rx_num で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 2.
受信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_SCI0>_Serial_Receive ( uint8_t * const rx_buf, uint16_t rx_num );

[引数]
引数

I/O

O
I

uint8_t * const rx_buf;
uint16_t rx_num;

説明
受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 rx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 381 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Serial_Multiprocessor_Send【 SCI/RSCI 】送信を開始します。
（マルチプロセッサ通信機能）
備考 1.
マルチプロセッサ通信機能の送信は、受信局を指定する ID 送信サイクルと指定された受信局に対するデータ送信サイクルで構成されます。
備考 2.
本 API 関数では、ID 送信サイクルの処理として、引数 id_buf で指定されたバッファから 1 バイト単位の送信を引数 id_num で指定された回数だけ繰り返し行います。
備考 3.
本 API 関数では、データ送信サイクルの処理として、引数 tx_buf で指定されたバッフ
ァから 1 バイト単位の送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 4.
送信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
R_<Config_SCI0>_Serial_Multiprocessor_Send (uint8_t * const id_buf,
uint16_t id_num, uint8_t * const tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I
I
I
I

uint8_t * const id_buf;
uint16_t id_num;
uint8_t * const tx_buf;
uint16_t tx_num;

説明送信する ID を格納したバッファへのポインタ送信する ID の総数
送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 382 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Serial_Multiprocessor_Receive【 SCI/RSCI 】受信を開始します。
（マルチプロセッサ通信機能）
備考 1.
マルチプロセッサ通信機能の受信は、受信した ID が自局の ID と一致した場合に続いて送信される通信データを受信します。
備考 2.
本 API 関数では、 1 バイト単位の受信を引数 rx_num で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 3.
受信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
uint16_t rx_num );R_<Config_SCI0>_Serial_Multiprocessor_Receive ( uint8_t * const rx_buf,

[引数]
引数

I/O

O
I

uint8_t * const rx_buf;
uint16_t rx_num;

説明
受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 rx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 383 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create_UserInit
SCI/SCIF 調歩同期式モードに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_SCI0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 384 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_transmitend_interrupt【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_transmitend_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 385 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_transmit_interrupt【 SCI/RSCI 】送信データエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 386 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_receive_interrupt【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行います。
このハンドラ内で受信割込み要求禁止(SCI0.SCR.BIT.RIE=0 / RSCI10.SCR0.BIT.RIE=0) を行っています。これが問題となる場合は、お客様の判断でソースコードの編集を行ってください。

[指定形式]
void

r_<Config_SCI0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 387 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_receiveerror_interrupt【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_receiveerror_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 388 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_teif_interrupt【 SCIF 】送信完了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_teif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 389 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_txif_interrupt【 SCIF 】送信 FIFO データエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_txif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 390 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_rxif_interrupt【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_rxif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 391 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_drif_interrupt【 SCIF 】受信データレディ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_drif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 392 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_erif_interrupt【 SCIF 】受信エラー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、フレーミングエラーまたはパリティエラーによる割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_SCI0>_erif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 393 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_brif_interrupt【 SCIF 】ブレーク割り込みの発生に伴う処理を行います。
備考
本 API 関数は、ブレークまたはオーバランによる割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_SCI0>_brif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 394 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_transmitend【 SCI/RSCI 】送信終了／送信データエンプティ割り込みの発生に伴う処理を行います。
備考 1.
本 API 関数は、r_<Config_SCI0>_transmitend_interrupt および
r_<Config_SCI0>_transmit_interrupt のコールバック・ルーチンとして呼び出されます。
【 SCIF 】送信完了／送信 FIFO データエンプティ割り込みの発生に伴う処理を行います。
備考 2.
本 API 関数は、r_<Config_SCI0>_teif_interrupt および r_<Config_SCI0>_txif_interruptのコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 395 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_receiveend【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行います。
備考 1.
本 API 関数は、r_<Config_SCI0>_receive_interrupt のコールバック・ルーチンとして呼び出されます。
【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行います。
備考 2.
本 API 関数は、r_<Config_SCI0>_rxif_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 396 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_receiveerror【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_SCI0>_receiveerror_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_receiveerror ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 397 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_error【 SCIF 】受信エラー／ブレーク割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_SCI0>_erif_interrupt および r_<Config_SCI0>_brif_interruptのコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_error ( scif_error_type_t error_type );

[引数]
引数

I/O
I

scif_error_type_t error_type;

説明
割り込みの発生要因
RECEIVE_ERROR：フレーミングエラーまたは
パリティエラーOVERRUN_ERROR：オーバラン

BREAK_DETECT

：ブレーク

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 398 of 562

スマート・コンフィグレータ

4. API 関数

使用例
大文字'A'を送信する
main.c#include "r_smc_entry.h"
extern volatile uint8_t g_sci0_tx_buf;
void main(void){/* Start the SCI0 channel */R_Config_SCI0_Start();/* Transmit SCI0 data */R_Config_SCI0_Serial_Send((uint8_t *)&g_sci0_tx_buf, 1U);
while (1U){
nop();}}
Config_SCI0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_sci0_tx_buf;/* End user code. Do not edit comment generated here */void R_Config_SCI0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_sci0_tx_buf = 'A';/* End user code. Do not edit comment generated here */}static void r_Config_SCI0_callback_transmitend(void){/* Start user code for r_Config_SCI0_callback_transmitend. Do not edit comment generated
here *//* Stop the SCI0 channel */R_Config_SCI0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 399 of 562

スマート・コンフィグレータ

4.2.32

4. API 関数

SCI/SCIF クロック同期式モード

以下に、コード生成ツールが SCI/SCIF クロック同期式モード用として出力する API 関数の一覧を示します。
表 4.33

SCI/SCIF/RSCI クロック同期式モード用 API 関数
API 関数名

機能概要

R_<Config_SCI0>_StartSCI/SCIF クロック同期式モードを制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_SCI0>_Stop

通信を終了します。

R_<Config_SCI0>_Serial_Send

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

R_<Config_SCI0>_Serial_Receive

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

R_<Config_SCI0>_Serial_Send_Receive

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

R_<Config_SCI0>_Create_UserInit

SCI/SCIF クロック同期式モードに関するユーザ独自の初期化処理を行います。

R_<Config_SCI0>_Create

r_<Config_SCI0>_transmitend_interrupt【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_transmit_interrupt【 SCI/RSCI 】送信データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_receive_interrupt【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_receiveerror_interrupt【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_teif_interrupt【 SCIF 】送信完了割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_txif_interrupt【 SCIF 】送信 FIFO データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_rxif_interrupt【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_erif_interrupt【 SCIF 】受信エラー割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_brif_interrupt【 SCIF 】ブレーク割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_transmitend【 SCI/RSCI 】送信終了／送信データエンプティ割り込みの発生に伴う処理を行います。
【 SCIF 】送信完了／送信 FIFO データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_receiveend【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行います。
【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_receiveerror【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行いまr_<Config_SCI0>_callback_error【 SCIF 】受信エラー／ブレーク割り込みの発生に伴う処理を行

す。
います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 400 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create
SCI/SCIF クロック同期式モードを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 401 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Start
通信を開始します。

[指定形式]
void

R_<Config_SCI0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 402 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_SCI0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 403 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Serial_Send
送信を開始します。
（調歩同期式モード）
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数
tx_num で指定された回数だけ繰り返し行います。
備考 2.
送信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_SCI0>_Serial_Send ( uint8_t * const tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I
I

uint8_t * const tx_buf;
uint16_t tx_num;

説明
送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 404 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Serial_Receive
受信を開始します。
（調歩同期式モード）
備考 1.
本 API 関数では、 1 バイト単位の受信を引数 rx_num で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 2.
受信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_SCI0>_Serial_Receive ( uint8_t * const rx_buf, uint16_t rx_num );

[引数]
引数

I/O

O
I

uint8_t * const rx_buf;
uint16_t rx_num;

説明
受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 rx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 405 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Serial_Send_Receive
送受信を開始します。
（クロック同期式モード）
備考 1.
本 API 関数では、送信処理として、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本 API 関数では、受信処理として、 1 バイト単位の受信を引数 rx_num で指定された
回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 3.
受信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
R_<Config_SCI0>_Serial_Send_Receive ( uint8_t * const tx_buf, uint16_t
tx_num, uint8_t * const rx_buf, uint16_t rx_num );

[引数]
引数

I/O
I
I

O
I

uint8_t * const tx_buf;
uint16_t tx_num;
uint8_t * const rx_buf;
uint16_t rx_num;

説明
送信するデータを格納したバッファへのポインタ
送信するデータの総数
受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 406 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create_UserInit
SCI/SCIF クロック同期式モードに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_SCI0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 407 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_transmitend_interrupt【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_transmitend_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 408 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_transmit_interrupt【 SCI/RSCI 】送信データエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 409 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_receive_interrupt【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行います。
このハンドラ内で受信割込み要求禁止(SCI0.SCR.BIT.RIE=0 / RSCI10.SCR0.BIT.RIE=0) を行っています。これが問題となる場合は、お客様の判断でソースコードの編集を行ってください。

[指定形式]
void

r_<Config_SCI0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 410 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_receiveerror_interrupt【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_receiveerror_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 411 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_teif_interrupt【 SCIF 】送信完了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_teif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 412 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_txif_interrupt【 SCIF 】送信 FIFO データエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_txif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 413 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_rxif_interrupt【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_rxif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 414 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_erif_interrupt【 SCIF 】受信エラー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、フレーミングエラーまたはパリティエラーによる割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_SCI0>_erif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 415 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_brif_interrupt【 SCIF 】ブレーク割り込みの発生に伴う処理を行います。
備考
本 API 関数は、ブレークまたはオーバランによる割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_SCI0>_brif_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 416 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_transmitend【 SCI/RSCI 】送信終了／送信データエンプティ割り込みの発生に伴う処理を行います。
備考 1.
本 API 関数は、r_<Config_SCI0>_transmitend_interrupt および
r_<Config_SCI0>_transmit_interrupt のコールバック・ルーチンとして呼び出されます。
【 SCIF 】送信完了／送信 FIFO データエンプティ割り込みの発生に伴う処理を行います。
備考 2.
本 API 関数は、r_<Config_SCI0>_teif_interrupt および r_<Config_SCI0>_txif_interruptのコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 417 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_receiveend【 SCI/RSCI 】受信データフル割り込みの発生に伴う処理を行います。
備考 1.
本 API 関数は、r_<Config_SCI0>_receive_interrupt のコールバック・ルーチンとして呼び出されます。
【 SCIF 】受信 FIFO データフル割り込みの発生に伴う処理を行います。
備考 2.
本 API 関数は、r_<Config_SCI0>_rxif_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 418 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_receiveerror【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_SCI0>_receiveerror_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_receiveerror ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 419 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_error【 SCIF 】受信エラー／ブレーク割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_SCI0>_erif_interrupt および r_<Config_SCI0>_brif_interruptのコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_error ( scif_error_type_t error_type );

[引数]
引数

I/O
I

scif_error_type_t error_type;

説明
割り込みの発生要因
RECEIVE_ERROR：フレーミングエラーまたは
パリティエラーOVERRUN_ERROR：オーバラン

BREAK_DETECT

：ブレーク

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 420 of 562

スマート・コンフィグレータ

4. API 関数

使用例
受信したデータを送信する
main.c#include "r_smc_entry.h"
extern volatile uint8_t g_sci0_tx_buf;
extern volatile uint8_t g_sci0_rx_buf;
void main(void){/* Start the SCI0 channel */R_Config_SCI0_Start();/* Transmit and receive SCI0 data */R_Config_SCI0_Serial_Send_Receive((uint8_t *)&g_sci0_tx_buf, 1U, (uint8_t *)&g_sci0_rx_buf, 1U);
while (1U){
nop();}}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 421 of 562

スマート・コンフィグレータ

4. API 関数

Config_SCI0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_sci0_tx_buf;volatile uint8_t g_sci0_rx_buf;/* End user code. Do not edit comment generated here */void R_Config_SCI0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_sci0_tx_buf = 0U;
g_sci0_rx_buf = 0U;/* End user code. Do not edit comment generated here */}static void r_Config_SCI0_callback_transmitend(void){/* Start user code for r_Config_SCI0_callback_transmitend. Do not edit comment generated
here *//* Transmit and receive SCI0 data */R_Config_SCI0_Serial_Send_Receive((uint8_t *)&g_sci0_tx_buf, 1U, (uint8_t *)&g_sci0_rx_buf, 1U);/* End user code. Do not edit comment generated here */}static void r_Config_SCI0_callback_receiveend(void){/* Start user code for r_Config_SCI0_callback_receiveend. Do not edit comment generated
here */
g_sci0_tx_buf = g_sci0_rx_buf;
g_sci0_rx_buf = 0U;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 422 of 562

スマート・コンフィグレータ

4.2.33

4. API 関数

シングルスキャンモード S12AD

以下に、コード生成ツールがシングルスキャンモード S12AD 用として出力する API 関数の一覧を示します。
表 4.34

シングルスキャンモード S12AD 用 API 関数
API 関数名

機能概要

R_<Config_S12AD0>_Start

シングルスキャンモード S12AD を制御するうえで必要となる初期化処理を行います。
A/D 変換を開始します。

R_<Config_S12AD0>_Stop

A/D 変換を終了します。

R_<Config_S12AD0>_Get_ValueResult

変換結果を獲得します。

R_<Config_S12AD0>_Set_CompareValue

コンペアレベルの設定を行います。

R_<Config_S12AD0>_Set_CompareAValue

ウィンドウ A コンペアレベルの設定を行います。

R_<Config_S12AD0>_Set_CompareBValue

ウィンドウ B コンペアレベルの設定を行います。

R_<Config_S12AD0>_Create_UserInit

シングルスキャンモード S12AD に関するユーザ独自の初期化処理を行います。

r_<Config_S12AD0>_interrupt

スキャン終了割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interrupt

コンペア割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interruptA

ウィンドウ A コンペア割り込みの発生に伴う処理を行います。

r_<Config_S12AD0>_compare_interruptB

ウィンドウ B コンペア割り込みの発生に伴う処理を行います。

R_<Config_S12AD0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 423 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Create
シングルスキャンモード S12AD を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_S12AD0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 424 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Start
A/D 変換を開始します。

[指定形式]
void

R_<Config_S12AD0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 425 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Stop
A/D 変換を終了します。

[指定形式]
void

R_<Config_S12AD0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 426 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Get_ValueResult
変換結果を獲得します。

[指定形式]
void

R_<Config_S12AD0>_Get_ValueResult ( ad_channel_t channel, uint16_t * const buffer );[引数]
RX130，RX230/RX231 の場合
I/O
I

引数

ad_channel_t channel;

説明
チャネル番号ADCHANNEL0：入力チャネル AN000ADCHANNEL1：入力チャネル AN001

ADCHANNEL2：入力チャネル AN002

ADCHANNEL3：入力チャネル AN003

ADCHANNEL4：入力チャネル AN004

ADCHANNEL5：入力チャネル AN005

ADCHANNEL6：入力チャネル AN006

ADCHANNEL7：入力チャネル AN007

ADCHANNEL16：入力チャネル AN016

ADCHANNEL17：入力チャネル AN017

ADCHANNEL18：入力チャネル AN018

ADCHANNEL19：入力チャネル AN019

ADCHANNEL20：入力チャネル AN020

ADCHANNEL21：入力チャネル AN021

ADCHANNEL22：入力チャネル AN022

ADCHANNEL23：入力チャネル AN023

ADCHANNEL24：入力チャネル AN024

ADCHANNEL25：入力チャネル AN025

ADCHANNEL26：入力チャネル AN026

ADCHANNEL27：入力チャネル AN027

ADCHANNEL28：入力チャネル AN028

ADCHANNEL29：入力チャネル AN029

ADCHANNEL30：入力チャネル AN030

ADCHANNEL31：入力チャネル AN031

ADTEMPSENSOR：拡張アナログ入力（温度センサ出力）

ADINTERREFVOLT：拡張アナログ入力（内部基準電圧）O

uint16_t * const buffer;

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

ADSELFDIAGNOSIS：自己診断結果

ADDATADUPLICATION：ダブルトリガモード結果獲得した変換結果を格納する領域へのポインタ

Page 427 of 562

スマート・コンフィグレータ

4. API 関数

そのほかのデバイスの場合
引数

I/O
I

ad_channel_t channel;

説明
チャネル番号ADCHANNEL0：入力チャネル AN000ADCHANNEL1：入力チャネル AN001

ADCHANNEL2：入力チャネル AN002

ADCHANNEL3：入力チャネル AN003

ADCHANNEL4：入力チャネル AN004

ADCHANNEL5：入力チャネル AN005

ADCHANNEL6：入力チャネル AN006

ADCHANNEL7：入力チャネル AN007

ADCHANNEL8：入力チャネル AN008

ADCHANNEL9：入力チャネル AN009

ADCHANNEL10：入力チャネル AN010

ADCHANNEL11：入力チャネル AN011

ADCHANNEL12：入力チャネル AN012

ADCHANNEL13：入力チャネル AN013

ADCHANNEL14：入力チャネル AN014

ADCHANNEL15：入力チャネル AN015

ADCHANNEL16：入力チャネル AN016

ADCHANNEL17：入力チャネル AN017

ADCHANNEL18：入力チャネル AN018

ADCHANNEL19：入力チャネル AN019

ADCHANNEL20：入力チャネル AN020

ADTEMPSENSOR：拡張アナログ入力（温度センサ出力）

ADINTERREFVOLT：拡張アナログ入力（内部基準電圧）ADSELFDIAGNOSIS：自己診断結果

ADDATADUPLICATION：ダブルトリガモード結果

ADDATADUPLICATIONA ：ダブルトリガモード A 結果
ADDATADUPLICATIONB ：ダブルトリガモード B 結果
O

uint16_t * const buffer;獲得した変換結果を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 428 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareValue
コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 429 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareAValue
ウィンドウ A コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareAValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 430 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Set_CompareBValue
ウィンドウ B コンペアレベルの設定を行います。

[指定形式]
void

R_<Config_S12AD0>_Set_CompareBValue ( uint16_t reg_value0, uint16_t reg_value1);

[引数]
I/O

引数

I

uint16_t reg_value0;
uint16_t reg_value1;

I

説明
コンペアレジスタ 0 に設定する値
コンペアレジスタ 1 に設定する値

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 431 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_S12AD0>_Create_UserInit
シングルスキャンモード S12AD に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_S12AD0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_S12AD0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 432 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_interrupt
スキャン終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 433 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interrupt
コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 434 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interruptA
ウィンドウ A コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interruptA ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 435 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_S12AD0>_compare_interruptB
ウィンドウ B コンペア割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_S12AD0>_compare_interruptB ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 436 of 562

スマート・コンフィグレータ

4. API 関数

使用例
AD 変換結果を取得する
main.c#include "r_smc_entry.h"void main(void){/* Start the AD0 converter */R_Config_S12AD0_Start();while (1U){
nop();}}
Config_S12AD0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint16_t g_s12ad0_ch000_value;/* End user code. Do not edit comment generated here */static void r_Config_S12AD0_interrupt(void){/* Start user code for r_Config_S12AD0_interrupt. Do not edit comment generated here */R_Config_S12AD0_Get_ValueResult(ADCHANNEL0, (uint16_t *)&g_s12ad0_ch000_value);/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 437 of 562

スマート・コンフィグレータ

4.2.344. API 関数

スマートカードインタフェース

以下に、コード生成ツールがスマートカードインタフェース用として出力する API 関数の一覧を示します。
表 4.35

SCI/RSCI スマートカードインタフェース用 API 関数
API 関数名

機能概要

R_<Config_SCI0>_Start

スマートカードインタフェースを制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_SCI0>_Stop

通信を終了します。

R_<Config_SCI0>_SmartCard_Send

送信を開始します。（スマートカードインタフェースモード）

R_<Config_SCI0>_SmartCard_Receive

受信を開始します。（スマートカードインタフェースモード）

R_<Config_SCI0>_Create_UserInit
r_<Config_SCI0>_transmit_interrupt

スマートカードインタフェースに関するユーザ独自の初期化処理を行います。
送信データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_receive_interrupt

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

r_<Config_SCI0>_receiveerror_interrupt

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

r_<Config_SCI0>_callback_transmitend

送信データエンプティ割り込みの発生に伴う処理を行います。

r_<Config_SCI0>_callback_receiveend

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

r_<Config_SCI0>_callback_receiveerror

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

R_<Config_SCI0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 438 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create
スマートカードインタフェースを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 439 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Start
通信を開始します。

[指定形式]
void

R_<Config_SCI0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 440 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_SCI0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 441 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_SmartCard_Send
送信を開始します。
（スマートカードインタフェースモード）
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数
tx_num で指定された回数だけ繰り返し行います。
備考 2.
送信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_SCI0>_SmartCard_Send ( uint8_t * const tx_buf, uint16_t tx_num );

[引数]
引数

I/O
I
I

uint8_t * const tx_buf;
uint16_t tx_num;

説明
送信するデータを格納したバッファへのポインタ
送信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 442 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_SmartCard_Receive
受信を開始します。
（スマートカードインタフェースモード）
備考 1.
本 API 関数では、 1 バイト単位の受信を引数 rx_num で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 2.
受信を行う際には、本 API 関数の呼び出し以前に R_<Config_SCI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS R_<Config_SCI0>_SmartCard_Receive ( uint8_t * const rx_buf, uint16_t rx_num );

[引数]
引数

I/O

O
I

uint8_t * const rx_buf;
uint16_t rx_num;

説明
受信したデータを格納するバッファへのポインタ受信するデータの総数

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 rx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 443 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_SCI0>_Create_UserInit
スマートカードインタフェースに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_SCI0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_SCI0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 444 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_transmit_interrupt
送信バッファエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 445 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_receive_interrupt
受信バッファフル割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 446 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_receiveerror_interrupt
受信エラー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_SCI0>_receiveerror_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 447 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_transmitend
送信バッファエンプティ割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_SCI0>_transmit_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 448 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_receiveend
受信バッファフル割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_SCI0>_receive_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 449 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_SCI0>_callback_receiveerror
受信エラー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_SCI0>_receiveerror_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_SCI0>_callback_receiveerror ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 450 of 562

スマート・コンフィグレータ

4. API 関数

使用例
1Byte 送信後、1Byte 受信に切り替える
main.c#include "r_smc_entry.h"
extern volatile uint8_t g_sci0_tx_buf;
void main(void){/* Start the SCI0 channel */R_Config_SCI0_Start();/* Transmit SCI0 data */R_Config_SCI0_SmartCard_Send((uint8_t *)&g_sci0_tx_buf, 1U);
while (1U){
nop();}}

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 451 of 562

スマート・コンフィグレータ

4. API 関数

Config_SCI0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint8_t g_sci0_tx_buf;volatile uint8_t g_sci0_rx_buf;/* End user code. Do not edit comment generated here */void R_Config_SCI0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_sci0_tx_buf = 'A';/* End user code. Do not edit comment generated here */}static void r_Config_SCI0_callback_transmitend(void){/* Start user code for r_<onfig_SCI0_callback_transmitend. Do not edit comment generated
here *//* Stop the SCI0 channel */R_Config_SCI0_Stop();/* Initializes SCI0 */R_Config_SCI0_Create();/* Start the SCI0 channel */R_Config_SCI0_Start();/* Receive SCI0 data */R_Config_SCI0_SmartCard_Receive((uint8_t *)&g_sci0_rx_buf, 1U);/* End user code. Do not edit comment generated here */}static void r_Config_SCI0_callback_receiveend(void){/* Start user code for r_Config_SCI0_callback_receiveend. Do not edit comment generated
here *//* Stop the SCI0 channel */R_Config_SCI0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 452 of 562

スマート・コンフィグレータ

4.2.35

4. API 関数

SPI クロック同期式モード

以下に、コード生成ツールが SPI クロック同期式モード（RSPI/SCI/RSCI）用として出力する API 関数の一覧を示します。
表 4.36

SPI クロック同期式モード（RSPI/SCI/RSCI）用 API 関数
API 関数名

機能概要

R_<Config_RSPI0>_Start

SPI クロック同期式モード（RSPI/SCI/RSCI）を制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_RSPI0>_Stop

通信を終了します。

R_<Config_RSPI0>_Send【 RSPI 】送信を開始します。

R_<Config_RSPI0>_Send_Receive【 RSPI 】送受信を開始します。

R_<Config_RSPI0>_SPI_Master_Send【 SCI/RSCI 】マスタ送信を開始します。（簡易 SPI モード）

R_<Config_RSPI0>_SPI_Master_Send_Receive【 SCI/RSCI 】マスタ送受信を開始します。（簡易 SPI モード）

R_<Config_RSPI0>_SPI_Slave_Send【 SCI/RSCI 】スレーブ送信を開始します。（簡易 SPI モード）

R_<Config_RSPI0>_SPI_Slave_Send_Receive【 SCI/RSCI 】スレーブ送受信を開始します。（簡易 SPI モー
ド）

R_<Config_RSPI0>_Create_UserInit

SPI クロック同期式モード（RSPI/SCI/RSCI）に関するユーザ独
自の初期化処理を行います。

r_<Config_RSPI0>_receive_interrupt

受信バッファフル割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_transmit_interrupt

送信バッファエンプティ割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_error_interrupt【 RSPI 】エラー割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_idle_interrupt【 RSPI 】アイドル割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_transmitend_interrupt【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_receiveerror_interrupt【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_callback_receiveend

受信バッファフル割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_callback_transmitend

送信バッファエンプティ割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_callback_error【 RSPI 】アイドル割り込みの発生に伴う処理を行います。
【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。
【 RSPI 】エラー割り込みの発生に伴う処理を行います。

R_<Config_RSPI0>_Create

r_<Config_RSPI0>_callback_receiveerror

R20UT4360JJ0109 Rev.1.09
Oct.20.2024【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。

Page 453 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Create
SPI クロック同期式モード（RSPI/SCI/RSCI）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_RSPI0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 454 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Start
通信を開始します。

[指定形式]
void

R_<Config_RSPI0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 455 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_RSPI0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 456 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Send【 RSPI 】送信を開始します。
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数
tx_num で指定された回数だけ繰り返し行います。
備考 2.
送信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_RSPI0>_Send ( type * const tx_buf, uint16_t tx_num );

[引数]
I/O

引数

I

type* const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更されます。

I

送信するデータの総数

uint16_t tx_num;

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 457 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Send_Receive【 RSPI 】送受信を開始します。
備考 1.
本 API 関数では、送信処理として、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本 API 関数では、受信処理として、 1 バイト単位の受信を引数 tx_num で指定された
回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 3.
送受信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
R_<Config_RSPI0>_Send_Receive ( type * const tx_buf, uint16_t tx_num,
type * const rx_buf );

[引数]
I/O

引数

I

type * const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更され
ます。

I
O

uint16_t tx_num;
type * const rx_buf;

送受信するデータの総数
受信したデータを格納するバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更され
ます。

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 458 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_SPI_Master_Send【 SCI/RSCI 】マスタ送信を開始します。（簡易 SPI モード）
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位のマスタ送信を
引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
マスタ送信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_RSPI0>_SPI_Master_Send (type * const tx_buf, uint16_t tx_num );

[引数]
I/O

引数

I

type * const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更されます。

I

送信するデータの総数

uint16_t tx_num;

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 459 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_SPI_Master_Send_Receive【 SCI/RSCI 】マスタ送受信を開始します。
（簡易 SPI モード）
備考 1.
本 API 関数では、マスタ送信処理として、引数 tx_buf で指定されたバッファから 1 バ
イト単位のマスタ送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本 API 関数では、マスタ受信処理として、 1 バイト単位のマスタ受信を引数 rx_num で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 3.
送受信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
R_<Config_RSPI0>_SPI_Master_Send_Receive ( type * const tx_buf, uint16_t
tx_num, type_t * const rx_buf, uint16_t rx_num );

[引数]
I/O

引数

I

type * const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更され
ます。

I
O

uint16_t tx_num;
type * const rx_buf;

送信するデータの総数
受信したデータを格納するバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更されます。

I

受信するデータの総数

uint16_t rx_num;

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 460 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_SPI_Slave_Send【 SCI/RSCI 】スレーブ送信を開始します。
（簡易 SPI モード）
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位のスレーブ送信
を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
スレーブ送信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_RSPI0>_SPI_Slave_Send (type * const tx_buf, uint16_t tx_num );

[引数]
I/O

引数

I

type * const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更されます。

I

送信するデータの総数

uint16_t tx_num;

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 461 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_SPI_Slave_Send_Receive【 SCI/RSCI 】スレーブ送受信を開始します。（簡易 SPI モード）
備考 1.
本 API 関数では、スレーブ送信処理として、引数 tx_buf で指定されたバッファから 1
バイト単位のスレーブ送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本 API 関数では、スレーブ受信処理として、 1 バイト単位のスレーブ受信を引数
rx_num で指定された回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納
します。
備考 3.
送受信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
R_<Config_RSPI0>_SPI_Slave_Send_Receive ( type * const tx_buf,
uint16_t tx_num, type * const rx_buf, uint16_t rx_num );

[引数]
I/O

引数

I

type * const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更され
ます。

I
O

uint16_t tx_num;
type * const rx_buf;

送信するデータの総数
受信したデータを格納するバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更されます。

I

受信するデータの総数

uint16_t rx_num;

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 462 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Create_UserInit
SPI クロック同期式モード（RSPI/SCI/RSCI）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_RSPI0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_RSPI0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 463 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_receive_interrupt
受信バッファフル割り込みの発生に伴う処理を行います。
このハンドラ内で受信割込み要求禁止(SCI0.SCR.BIT.RIE=0 / RSCI10.SCR0.BIT.RIE=0) または受信バッファフル割込み要求禁止(RSPI0.SPCR.BIT.SPRIE = 0)を行っています。これが問題となる場合は、お客様の判断でソースコードの編集を行ってください。

[指定形式]
void

r_<Config_RSPI0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 464 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_transmit_interrupt
送信バッファエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 465 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_error_interrupt【 RSPI 】エラー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_error_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 466 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_idle_interrupt【 RSPI 】アイドル割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_idle_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 467 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_transmitend_interrupt【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_transmitend_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 468 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_receiveerror_interrupt【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_receiveerror_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 469 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_callback_receiveend
受信バッファフル割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_RSPI0>_receive_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RSPI0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 470 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_callback_transmitend
送信バッファエンプティ割り込みの発生に伴う処理を行います。
備考 1.
本 API 関数は、r_<Config_RSPI0>_transmit_interrupt のコールバック・ルーチンとして呼び出されます。
【 RSPI 】アイドル割り込みの発生に伴う処理を行います。
備考 2.
本 API 関数は、r_<Config_RSPI0>_idle_interrupt のコールバック・ルーチンとして呼び出されます。
【 SCI/RSCI 】送信終了割り込みの発生に伴う処理を行います。
備考 3.
本 API 関数は、r_<Config_RSPI0>_transmitend_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RSPI0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 471 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_callback_error【 RSPI 】エラー割り込みの発生に伴う処理を行います。
備考 1.
本 API 関数は、r_<Config_RSPI0>_error_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RSPI0>_callback_error ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 472 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_callback_receiveerror【 SCI/RSCI 】受信エラー割り込みの発生に伴う処理を行います。
備考 1.
本 API 関数は、r_<Config_RSPI0>_receiveerror_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RSPI0>_callback_receiveerror ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 473 of 562

スマート・コンフィグレータ

4. API 関数

使用例
送信と同じデータ数の受信が完了すると通信を停止する
main.c#include "r_smc_entry.h"
extern volatile uint32_t g_rspi0_tx_buf[4];extern volatile uint32_t g_rspi0_rx_buf[4];void main(void){/* Start the RSPI0 module operation */R_Config_RSPI0_Start();/* Send and receive RSPI0 data */R_Config_RSPI0_Send_Receive((uint32_t *)g_rspi0_tx_buf, 4U, (uint32_t *)g_rspi0_rx_buf);
while (1U){
nop();}}
Config_RSPI0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint32_t g_rspi0_tx_buf[4];volatile uint32_t g_rspi0_rx_buf[4];/* End user code. Do not edit comment generated here */void R_Config_RSPI0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_rspi0_tx_buf[0] = 0x000000FF;
g_rspi0_tx_buf[1] = 0x0000FF00;
g_rspi0_tx_buf[2] = 0x00FF0000;
g_rspi0_tx_buf[3] = 0xFF000000;/* End user code. Do not edit comment generated here */}static void r_Config_RSPI0_callback_receiveend(void){/* Start user code for r_Config_RSPI0_callback_receiveend. Do not edit comment generated
here *//* Stop the RSPI0 module operation */R_Config_RSPI0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 474 of 562

スマート・コンフィグレータ

4.2.36

4. API 関数

SPI 動作モード

以下に、コード生成ツールが SPI 動作モード用として出力する API 関数の一覧を示します。
表 4.37

SPI 動作モード用 API 関数
API 関数名

機能概要

R_<Config_RSPI0>_Start

SPI 動作モードを制御するうえで必要となる初期化処理を行います。
通信を開始します。

R_<Config_RSPI0>_Stop

通信を終了します。

R_<Config_RSPI0>_Send

送信を開始します。

R_<Config_RSPI0>_Send_Receive

送受信を開始します。

R_<Config_RSPI0>_Create_UserInit

SPI 動作モードに関するユーザ独自の初期化処理を行います。

r_<Config_RSPI0>_receive_interrupt

受信バッファフル割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_transmit_interrupt

送信バッファエンプティ割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_error_interrupt

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

r_<Config_RSPI0>_idle_interrupt

アイドル割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_callback_receiveend

受信バッファフル割り込みの発生に伴う処理を行います。

r_<Config_RSPI0>_callback_transmitend

送信バッファエンプティ／アイドル割り込みの発生に伴う処理を行います。
エラー割り込みの発生に伴う処理を行います。

R_<Config_RSPI0>_Create

r_<Config_RSPI0>_callback_error

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 475 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Create
SPI 動作モードを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_RSPI0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 476 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Start
通信を開始します。

[指定形式]
void

R_<Config_RSPI0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 477 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Stop
通信を終了します。

[指定形式]
void

R_<Config_RSPI0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 478 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Send
送信を開始します。
備考 1.
本 API 関数では、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数
tx_num で指定された回数だけ繰り返し行います。
備考 2.
送信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS

R_<Config_RSPI0>_Send ( type * const tx_buf, uint16_t tx_num );

[引数]
I/O

引数

I

type * const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更されます。

I

送信するデータの総数

uint16_t tx_num;

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 479 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Send_Receive
送受信を開始します。
備考 1.
本 API 関数では、送信処理として、引数 tx_buf で指定されたバッファから 1 バイト単位の送信を引数 tx_num で指定された回数だけ繰り返し行います。
備考 2.
本 API 関数では、受信処理として、 1 バイト単位の受信を引数 tx_num で指定された
回数だけ繰り返し行い、引数 rx_buf で指定されたバッファに格納します。
備考 3.
送受信を行う際には、本 API 関数の呼び出し以前に R_<Config_RSPI0>_Start を呼び出す必要があります。

[指定形式]
MD_STATUS
R_<Config_RSPI0>_Send_Receive ( type * const tx_buf, uint16_t tx_num,
type * const rx_buf );

[引数]
I/O

引数

I

type * const tx_buf;

説明
送信するデータを格納したバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更され
ます。

I
O

uint16_t tx_num;
type * const rx_buf;

送受信するデータの総数
受信したデータを格納するバッファへのポインタ。
「Type」はGUI で設定したバッファアクセス幅に合わせて、コード生成
時に「uint32_t」、「uint16_t」、もしくは「uint8_t」に変更され
ます。

[戻り値]
マクロ

MD_OK
MD_ARGERROR

説明
正常終了
引数 tx_num の指定が不正

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 480 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_RSPI0>_Create_UserInit
SPI 動作モードに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_RSPI0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_RSPI0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 481 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_receive_interrupt
受信バッファフル割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_receive_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 482 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_transmit_interrupt
送信バッファエンプティ割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_transmit_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 483 of 562

スマート・コンフィグレータ

4. API 関数

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

[指定形式]
void

r_<Config_RSPI0>_error_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 484 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_idle_interrupt
アイドル割り込みの発生に伴う処理を行います。

[指定形式]
void

r_<Config_RSPI0>_idle_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 485 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_callback_receiveend
受信バッファフル割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_RSPI0>_receive_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RSPI0>_callback_receiveend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 486 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_callback_transmitend
送信バッファエンプティ／アイドル割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_RSPI0>_transmit_interrupt および
r_<Config_RSPI0>_idle_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RSPI0>_callback_transmitend ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 487 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_RSPI0>_callback_error
エラー割り込みの発生に伴う処理を行います。
備考
本 API 関数は、r_<Config_RSPI0>_error_interrupt のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

r_<Config_RSPI0>_callback_error ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 488 of 562

スマート・コンフィグレータ

4. API 関数

使用例
送信と同じデータ数の受信が完了すると通信を停止する
main.c#include "r_smc_entry.h"
extern volatile uint32_t g_rspi0_tx_buf[4];extern volatile uint32_t g_rspi0_rx_buf[4];void main(void){/* Start the RSPI0 module operation */R_Config_RSPI0_Start();/* Send and receive RSPI0 data */R_Config_RSPI0_Send_Receive((uint32_t *)g_rspi0_tx_buf, 4U, (uint32_t *)g_rspi0_rx_buf);
while (1U){
nop();}}
Config_RSPI0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint32_t g_rspi0_tx_buf[4];volatile uint32_t g_rspi0_rx_buf[4];/* End user code. Do not edit comment generated here */void R_Config_RSPI0_Create_UserInit(void){/* Start user code for user init. Do not edit comment generated here */g_rspi0_tx_buf[0] = 0x000000FF;
g_rspi0_tx_buf[1] = 0x0000FF00;
g_rspi0_tx_buf[2] = 0x00FF0000;
g_rspi0_tx_buf[3] = 0xFF000000;/* End user code. Do not edit comment generated here */}static void r_Config_RSPI0_callback_receiveend(void){/* Start user code for r_Config_RSPI0_callback_receiveend. Do not edit comment generated
here *//* Stop the RSPI0 module operation */R_Config_RSPI0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 489 of 562

スマート・コンフィグレータ

4.2.37

4. API 関数

電圧検出回路以下に、コード生成ツールが電圧検出回路用として出力する API 関数の一覧を示します。
表 4.38電圧検出回路用 API 関数
API 関数名

機能概要

R_<Config_LVD1>_Start

電圧検出回路を制御するうえで必要となる初期化処理を行います。
電圧の監視を開始します。

R_<Config_LVD1>_Stop

電圧の監視を終了します。

R_<Config_LVD1>_Create_UserInit

電圧検出回路に関するユーザ独自の初期化処理を行います。

r_<Config_LVD1>_lvdn_interrupt

電圧監視割り込みの発生に伴う処理を行います。

R_<Config_LVD1>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 490 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LVD1>_Create
電圧検出回路を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_LVD1>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 491 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LVD1>_Start
電圧の監視を開始します。

[指定形式]
void

R_<Config_LVD1>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 492 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LVD1>_Stop
電圧の監視を終了します。

[指定形式]
void

R_<Config_LVD1>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 493 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LVD1>_Create_UserInit
電圧検出回路に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_LVD1>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_LVD1>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 494 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_LVD1>_lvdn_interrupt
電圧監視割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_LVD1>_lvdn_interrupt ( void );n は回路番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 495 of 562

スマート・コンフィグレータ

4. API 関数

使用例
電圧監視割り込み発生時にソフトウェアリセット
main.c#include "r_smc_entry.h"void main(void){/* Start the LVD1 operation */R_Config_LVD1_Start();while (1U){
nop();}}
Config_LVD1_user.c
void r_Config_LVD1_lvd1_interrupt(void){/* Start user code for r_Config_LVD1_lvd1_interrupt. Do not edit comment generated here *//* Software reset */SYSTEM.PRCR.WORD = 0xA502;
SYSTEM.SWRR = 0xA501;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 496 of 562

スマート・コンフィグレータ

4.2.384. API 関数

ウォッチドッグタイマ

以下に、コード生成ツールがウォッチドッグタイマ（WDT/IWDT）用として出力する API 関数の一覧を示します。
表 4.39ウォッチドッグタイマ用 API 関数
API 関数名

R_<Config_WDT>_Create
R_<Config_WDT>_Restart

機能概要
ウォッチドッグタイマ（WDT/IWDT）を制御するうえで必要となる初期化処理を行います。
ウォッチドッグタイマのカウンタをクリアしたのち、カウント処理を再開します。

R_<Config_WDT>_Create_UserInit

ウォッチドッグタイマ（WDT/IWDT）に関するユーザ独自の初期化処理を行います。

r_<Config_WDT>_wuni_interrupt

マスカブル割り込み / ノンマスカブル割り込み（WUNI）の発生に伴う処理を行います。

r_<Config_WDT>_iwuni_interrupt

マスカブル割り込み / ノンマスカブル割り込み（IWUNI）の発生に伴う処理を行います。

r_<Config_WDT>_nmi_interrupt

ノンマスカブル割り込みの発生に伴う処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 497 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_WDT>_Create
ウォッチドッグタイマ（WDT/IWDT）を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_WDT>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 498 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_WDT>_Restart
ウォッチドッグタイマのカウンタをクリアしたのち、カウント処理を再開します。

[指定形式]
void

R_<Config_WDT>_Restart ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 499 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_WDT>_Create_UserInit
ウォッチドッグタイマ（WDT/IWDT）に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_WDT>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_WDT>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 500 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_WDT>_wuni_interrupt
マスカブル割り込み / ノンマスカブル割り込み（WUNI）の発生に伴う処理を行います。
備考
本 API 関数は、ダウンカウンタがアンダフローまたはリフレッシュエラーが発生したとき、マスカブル割り込み / ノンマスカブル割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_WDT>_wuni_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 501 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_WDT>_iwuni_interrupt
マスカブル割り込み / ノンマスカブル割り込み（IWUNI）の発生に伴う処理を行います。
備考
本 API 関数は、ダウンカウンタがアンダフローまたはリフレッシュエラーが発生したとき、マスカブル割り込み / ノンマスカブル割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_WDT>_iwuni_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 502 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_WDT>_nmi_interrupt
ノンマスカブル割り込みの発生に伴う処理を行います。
備考
備考 本 API 関数は、ダウンカウンタがアンダフローまたはリフレッシュエラーが発生したとき、ノンマスカブル割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_WDT>_nmi_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 503 of 562

スマート・コンフィグレータ

4. API 関数

使用例
メインループ毎にリフレッシュし、カウンタがアンダフローした際にはソフトウェアリセット
main.c#include "r_smc_entry.h"void main(void){
while (1U){/* Restarts WDT module */R_Config_WDT_Restart();}}Config_WDT_user.c
void r_Config_WDT_wuni_interrupt(void){/* Start user code for r_Config_WDT_wuni_interrupt. Do not edit comment generated here *//* Software reset */SYSTEM.PRCR.WORD = 0xA502;
SYSTEM.SWRR = 0xA501;/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 504 of 562

スマート・コンフィグレータ

4.2.394. API 関数

連続スキャンモード DSAD

以下に、コード生成ツールが連続スキャンモード DSAD 用として出力する API 関数の一覧を示します。
表 4.40

連続スキャンモード DSAD 用 API 関数
API 関数名

機能概要

R_<Config_DSAD0>_Start

連続スキャンモード DSAD を制御するうえで必要となる初期化処理を行います。
A/D 変換を開始します。

R_<Config_DSAD0>_Stop

A/D 変換を終了します。

R_<Config_DSAD0>_Set_SoftwareTrigger

ソフトウエアトリガにより A/D 変換を開始します。

R_<Config_DSAD0>_Get_ValueResult

変換結果を獲得します。

R_<Config_DSAD0>_Set_Chm_DisconnectDetection

断線検出アシストの設定を行います。

R_<Config_DSAD0>_Create_UserInit
r_<Config_DSAD0>_adin_interrupt

連続スキャンモード DSAD に関するユーザ独自の初期化処理を行います。
A/D 変換終了割り込みの発生に伴う処理を行います。

r_<Config_DSAD0>_scanendn_interrupt

スキャン終了割り込みの発生に伴う処理を行います。

R_<Config_DSAD0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 505 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Create
連続スキャンモード DSAD を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_DSAD0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 506 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Start
A/D 変換のトリガ待ちを開始します。

[指定形式]
void

R_<Config_DSAD0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 507 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Stop
A/D 変換を終了します。

[指定形式]
void

R_<Config_DSAD0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 508 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Set_SoftwareTrigger
ソフトウエアトリガによる A/D 変換を開始します。

[指定形式]
void

R_<Config_DSAD0>_Set_SoftwareTrigger ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 509 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Get_ValueResult
変換結果を獲得します。

[指定形式]
void

R_<Config_DSAD0>_Get_ValueResult ( uint32_t * const buffer );

[引数]
引数

I/O
O

uint32_t * const buffer;

説明
獲得した変換結果を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 510 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Set_Chm_DisconnectDetection
断線検出アシストの設定を行います。

[指定形式]
void

R_<Config_DSAD0>_Set_Chm_DisconnectDetection( bool pos, bool neg );

[引数]
引数

I/O
I

bool pos;

説明＋側入力の断線検出アシスト設定
True : 有効
False : 無効Ibool neg;－側入力の断線検出アシスト設定
True : 有効
False : 無効

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 511 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Create_UserInit
連続スキャンモード DSAD に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_DSAD0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_DSAD0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 512 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DSAD0>_adin_interrupt
変換終了割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_DSAD0>_adin_interrupt ( void );n はユニット番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 513 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DSAD0>_scanendn_interrupt
スキャン完了割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_DSAD0>_scanendn_interrupt ( void );n はユニット番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 514 of 562

スマート・コンフィグレータ

4. API 関数

使用例
スキャン完了割り込み時に、AD 変換結果を取得する
main.c#include "r_smc_entry.h"void main(void){/* Start the DSAD0 converter */R_Config_DSAD0_Start();while (1U){
nop();}}
Config_DSAD0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint32_t g_dsad0_value;/* End user code. Do not edit comment generated here */void r_Config_DSAD0_scanend0_interrupt(void){/* Start user code for r_Config_DSAD0_scanend0_interrupt. Do not edit comment generated
here *//* Get result from the DSAD0 converter */R_Config_DSAD0_Get_ValueResult((uint32_t *)&g_dsad0_value);/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 515 of 562

スマート・コンフィグレータ

4.2.404. API 関数

シングルスキャンモード DSAD

以下に、コード生成ツールがシングルスキャンモード DSAD 用として出力する API 関数の一覧を示します。
表 4.41

シングルスキャンモード DSAD 用 API 関数
API 関数名

機能概要

R_<Config_DSAD0>_Start

シングルスキャンモード S12AD を制御するうえで必要となる初期化処理を行います。
A/D 変換を開始します。

R_<Config_DSAD0>_Stop

A/D 変換を終了します。

R_<Config_DSAD0>_Set_SoftwareTrigger

ソフトウエアトリガにより A/D 変換を開始します。

R_<Config_DSAD0>_Get_ValueResult

変換結果を獲得します。

R_<Config_DSAD0>_Set_Chm_DisconnectDetection

断線検出アシストの設定を行います。

R_<Config_DSAD0>_Create_UserInit
r_<Config_DSAD0>_adin_interrupt

シングルスキャンモード S12AD に関するユーザ独自の初期化処理を行います。
変換終了割り込みの発生に伴う処理を行います。

r_<Config_DSAD0>_scanendn_interrupt

スキャン終了割り込みの発生に伴う処理を行います。

R_<Config_DSAD0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 516 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Create
シングルスキャンモード DSAD を制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_DSAD0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 517 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Start
A/D 変換のトリガ待ちを開始します。

[指定形式]
void

R_<Config_DSAD0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 518 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Stop
A/D 変換を終了します。

[指定形式]
void

R_<Config_DSAD0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 519 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Set_SoftwareTrigger
ソフトウエアトリガによる A/D 変換を開始します。

[指定形式]
void

R_<Config_DSAD0>_Set_SoftwareTrigger ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 520 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Get_ValueResult
変換結果を獲得します。

[指定形式]
void

R_<Config_S12AD0>_Get_ValueResult ( uint32_t * const buffer );

[引数]
引数

I/O
O

uint32_t * const buffer;

説明
獲得した変換結果を格納する領域へのポインタ

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 521 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Set_Chm_DisconnectDetection
断線検出アシストの設定を行います。

[指定形式]
void

R_<Config_DSAD0>_Set_Chm_DisconnectDetection ( bool pos, bool neg );

[引数]
引数

I/O
I

bool pos;

説明＋側入力の断線検出アシスト設定
True : 有効
False : 無効Ibool neg;－側入力の断線検出アシスト設定
True : 有効
False : 無効

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 522 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSAD0>_Create_UserInit
シングルスキャンモード DSAD に関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_DSAD0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_DSAD0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 523 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DSAD0>_adin_interrupt
変換終了割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_DSAD0>_adin_interrupt ( void );n はユニット番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 524 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DSAD0>_scanendn_interrupt
スキャン完了割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_DSAD0>_scanendn_interruptB ( void );n はユニット番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 525 of 562

スマート・コンフィグレータ

4. API 関数

使用例
スキャン完了割り込みで AD 変換結果を取得する
main.c#include "r_smc_entry.h"void main(void){/* Start the DSAD0 converter */R_Config_DSAD0_Start();while (1U){
nop();}}
Config_DSAD0_user.c/* Start user code for global. Do not edit comment generated here */volatile uint32_t g_dsad0_value;/* End user code. Do not edit comment generated here */void r_Config_DSAD0_scanend0_interrupt(void){/* Start user code for r_Config_DSAD0_scanend0_interrupt. Do not edit comment generated
here *//* Get result from the DSAD0 converter */R_Config_DSAD0_Get_ValueResult((uint32_t *)&g_dsad0_value);/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 526 of 562

スマート・コンフィグレータ

4.2.41

4. API 関数

Δ-Σモジュールインタフェース

以下に、コード生成ツールがΔ-Σモジュールインタフェース用として出力する API 関数の一覧を示します。
表 4.42Δ-Σモジュールインタフェース用 API 関数
API 関数名

機能概要

R_<Config_DSMIF0>_Start

Δ-Σモジュールインタフェースを制御するうえで必要となる初期化処理を行います。
変換を開始します。

R_<Config_DSMIF0>_Stop

変換を終了します。

R_<Config_DSMIF0>_Create_UserInit

Δ-Σモジュールインタフェースに関するユーザ独自の初期化処理を行います。

r_<Config_DSMIF0>_ocdin_interrupt

過電流検出割り込みの発生に伴う処理を行います。

r_<Config_DSMIF0>_scdin_interrupt

短絡検出割り込みの発生に伴う処理を行います。

r_<Config_DSMIF0>_sumein_interrupt

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

R_<Config_DSMIF0>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 527 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSMIF0>_CreateΔ-Σモジュールインタフェースを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_DSMIF0>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 528 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSMIF0>_Start
変換を開始します。

[指定形式]
void

R_<Config_DSMIF0>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 529 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSMIF0>_Stop
変換を終了します。

[指定形式]
void

R_<Config_DSMIF0>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 530 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_DSMIF0>_Create_UserInit
Δ-Σモジュールインタフェースに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_DSMIF0>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_DSMIF0>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 531 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DSMIF0>_ocdin_interrupt
過電流検出割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_DSMIF0>_ocdin_interrupt ( void );n はユニット番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 532 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DSMIF0>_scdin_interrupt
短絡検出割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_DSMIF0>_scdin_interrupt ( void );n はユニット番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 533 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_DSMIF0>_sumein_interrupt
合計電流エラー検出割り込みの発生に伴う処理を行います。

[指定形式]
void
備考

r_<Config_DSMIF0>_sumein_interrupt ( void );n はユニット番号を意味します。

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 534 of 562

スマート・コンフィグレータ

4. API 関数

使用例
過電流検出時に、変換を終了する
main.c#include "r_smc_entry.h"void main(void){/* Start the DSMIF0 filltering */R_Config_DSMIF0_Start();while (1U){
nop();}}
Config_DSMIF_user.c/* Start user code for global. Do not edit comment generated here */volatile uint16_t g_s12ad0_ch000_value;/* End user code. Do not edit comment generated here */void r_Config_DSMIF0_ocdi0_interrupt(void){/* Start user code for r_Config_DSMIF0_ocdi0_interrupt. Do not edit comment generated here*//* Stop the DSMIF0 convert */R_Config_DSMIF0_Stop();/* End user code. Do not edit comment generated here */}R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 535 of 562

スマート・コンフィグレータ

4.2.42

4. API 関数

アナログフロントエンド

以下に、アナログフロントエンド用として出力する API 関数の一覧を示します。
表 4.43

アナログフロントエンド用 API 関数
API 関数名

R_<Config_AFE>_Create
R_<Config_AFE>_Create_UserInit

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

機能概要
アナログフロントエンドを制御するうえで必要となる初期化処理を行います。
アナログフロントエンドに関するユーザ独自の初期化処理を行います。

Page 536 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_AFE>_Create
アナログフロントエンドを制御するうえで必要となる初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_AFE>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 537 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_AFE>_Create_UserInit
アナログフロントエンドに関するユーザ独自の初期化処理を行います。
備考
本 API 関数は、R_<Config_AFE>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_AFE>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 538 of 562

スマート・コンフィグレータ

4.2.43

4. API 関数

モータ

以下に、モータ用として出力する API 関数の一覧を示します。
表 4.44

モータ用 API 関数
API 関数名

機能概要

R_<Config_MTU3_MTU4>_StartTimerCount

モータ制御で使用する MTU (相補 PWM モード)および S12AD (シングルスキャンモード)の初期化処理を行います。
タイマのカウントを開始します。

R_<Config_MTU3_MTU4>_StopTimerCount

タイマのカウントを停止します。

R_<Config_MTU3_MTU4>_StartTimerCtrl

タイマのパルス出力を開始します。

R_<Config_MTU3_MTU4>_StopTimerCtrl

タイマのパルス出力を停止します。

R_<Config_MTU3_MTU4>_UpdDuty

デューティレジスタのバッファを更新します。

R_<Config_MTU3_MTU4>_StartAD

A/D 変換器の動作を開始します。

R_<Config_MTU3_MTU4>_StopAD

A/D 変換器の動作を停止します。

R_<Config_MTU3_MTU4>_AdcGetConvVal

A/D 変換結果を取得します。

R_<Config_MTU3_MTU4>_Create_UserInit

モータ設定時のユーザ独自の初期化処理を行います。

R_<Config_MTU3_MTU4>_CrestInterrupt

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

r_<Config_MTU3_MTU4>_ad_interrupt

A/D 変換終了割り込みの発生に伴う処理を行います。

R_<Config_MTU3_MTU4>_Create

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 539 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_Create
モータ制御で使用する MTU (相補 PWM モード)および S12AD (シングルスキャンモード)の初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_MTU3_MTU4>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 540 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_StartTimerCount
タイマのカウントを開始します。

[指定形式]
void

R_<Config_MTU3_MTU4>_StartTimerCount ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 541 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_StopTimerCount
タイマのカウントを停止します。

[指定形式]
void

R_<Config_MTU3_MTU4>_StopTimerCount ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 542 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_StartTimerCtrl
タイマのパルス出力を開始します。

[指定形式]
void

R_<Config_MTU3_MTU4>_StartTimerCtrl ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 543 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_StopTimerCtrl
タイマのパルス出力を停止します。

[指定形式]
void

R_<Config_MTU3_MTU4>_StopTimerCtrl ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 544 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_UpdDuty
デューティレジスタのバッファを更新します。

[指定形式]
3 相ブラシレス DC モータ
void
duty_w);

R_<Config_MTU3_MTU4>_UpdDuty (uint16_t duty_u, uint16_t duty_v, uint16_t

2 相ステッピングモータ
void

R_<Config_MTU3_MTU4>_UpdDuty (uint16_t duty_a, uint16_t duty_b);[引数]3 相ブラシレス DC モータ
引数

I/O

説明

O

uint16_t duty_u

U phase duty register valueO

uint16_t duty_v

V phase duty register valueO

uint16_t duty_w

W phase duty register value

2 相ステッピングモータ
引数

I/O

説明

O

uint16_t duty_a

A phase duty register valueO

uint16_t duty_b

B phase duty register value

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 545 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_StartAD
A/D 変換器の動作を開始します。

[指定形式]
void

R_<Config_MTU3_MTU4>_StartAD ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 546 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_StopAD
A/D 変換器の動作を停止します。

[指定形式]
void

R_<Config_MTU3_MTU4>_StopAD ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 547 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_AdcGetConvVal
A/D 変換結果を取得します。

[指定形式]
3 相ブラシレス DC モータ
void

R_<Config_MTU3_MTU4>_AdcGetConvVal ( r_mtr_adc_tb *mtr_ad_data );2 相ステッピングモータ
void

R_<Config_MTU3_MTU4>_AdcGetConvVal ( r_mtr_adc_ts *mtr_ad_data );[引数]
3-Phase Brushless DC Motor
引数

I/O
O

r_mtr_adc_tb *mtr_ad_data

説明
変換結果を格納する領域へのポインタ

構造体定義:
typedef struct {uint16_tu2_iu_ad;uint16_t

u2_iv_ad;uint16_tu2_iw_ad;uint16_tu2_vdc_ad;

uint16_t

u2_vphase_u_ad;

uint16_t

u2_vphase_v_ad;

uint16_t

u2_vphase_w_ad;} r_mtr_adc_tb;

2 相ステッピングモータ
引数

I/O
O

r_mtr_adc_ts *mtr_ad_data

説明
変換結果を格納する領域へのポインタ

構造体定義:
typedef struct {uint16_tu2_ia_ad;uint16_tu2_ib_ad;uint16_tu2_vdc_ad;

uint16_t

u2_vphase_a_ad;

uint16_t

u2_vphase_b_ad;} r_mtr_adc_ts;

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 548 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_MTU3_MTU4>_Create_UserInit
モータ設定時のユーザ独自の初期化処理を行います。
備考
本関数は、R_<Config_MTU3_MTU4>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_MTU3_MTU4>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 549 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU3_MTU4>_CrestInterrupt
山割り込みの発生に伴う処理を行います。
備考
本関数は、タイマカウンタ(TCNT)の値とタイマジェネラルレジスタ(TGRA3 またはTGRA6）の値が一致した場合に発生するコンペアマッチ割り込みに対応した割り込み処理として呼び出されます。

[指定形式]
void

r_<Config_MTU3_MTU4>_CrestInterrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 550 of 562

スマート・コンフィグレータ

4. API 関数

r_<Config_MTU3_MTU4>_ad_interrupt
A/D 変換終了割り込みの発生に伴う処理を行います。
備考
GUI 上で選択された S12AD ユニットのうち、最小のユニット番号の 1 ユニットの割り込みが有効となります。

[指定形式]
void

r_<Config_MTU3_MTU4>_ad_interrupt ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 551 of 562

スマート・コンフィグレータ

4.2.444. API 関数

LCD コントローラ

以下に、コード生成ツールが LCD コントローラ用として出力する API 関数の一覧を示します。
表 4.45

LCD コントローラ用 API 関数
API 関数名

機能概要

R_<Config_LCD>_Create

LCD コントローラの初期化処理を行います。

R_<Config_LCD>_Start

LCD 表示を開始します。

R_<Config_LCD>_Stop

LCD 表示を終了します。

R_<Config_LCD>_Voltage_On

昇圧回路または容量分割回路を有効にします。

R_<Config_LCD>_Voltage_Off

昇圧回路または容量分割回路を無効にします。

R_<Config_LCD>_Create_UserInit

LCD コントローラ設定時のユーザ独自の初期化処理を行います。

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 552 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LCD>_Create
LCD コントローラの初期化処理を行います。
備考
本 API 関数は、main()関数を実行する前に、R_Systeminit から呼び出されます。

[指定形式]
void

R_<Config_LCD>_Create ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 553 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LCD>_Start
LCD 表示を開始します。

[指定形式]
void

R_<Config_LCD>_Start ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 554 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LCD>_Stop
LCD 表示を終了します。

[指定形式]
void

R_<Config_LCD>_Stop ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 555 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LCD>_Voltage_On
昇圧回路または容量分割回路を有効にします。

[指定形式]
void

R_<Config_LCD>_Voltage_On ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 556 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LCD>_Voltage_Off
昇圧回路または容量分割回路を無効にします。

[指定形式]
void

R_<Config_LCD>_Voltage_Off ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 557 of 562

スマート・コンフィグレータ

4. API 関数

R_<Config_LCD>_Create_UserInit
LCD コントローラ設定時のユーザ独自の初期化処理を行います。
備考
本関数は、R_<Config_LCD>_Create のコールバック・ルーチンとして呼び出されます。

[指定形式]
void

R_<Config_LCD>_Create_UserInit ( void );

[引数]
なし

[戻り値]
なし

R20UT4360JJ0109 Rev.1.09
Oct.20.2024

Page 558 of 562

改訂記録
Rev.

発行日

改訂内容
ページ

ポイント

1.00

2018.07.01

－

初版発行

1.01

2018.07.10

19

備考を追記

1.02

2019.11.05

19

初期化を追記483 -511 新コンポーネントを追加

1.03

1.04

2020.01.20

2020.07.20



連続スキャンモード DSAD



シングルスキャンモード DSAD

Δ-Σモジュールインタフェース

11,

出力ファイル一覧に API 関数を追加

13



ソフトウェアカウンタクリア

プログラマブルゲインアンプ動作条件設定

12,

出力ファイル一覧および I2C マスタモードの構成を変更

200 -



RIIC と SCI 簡易 I2C モードの API を分離

232

1.05
1.06

2020.10.20
2022.02.16

207

備考を修正

18,

API 関数を追加

502



527 -

新コンポーネントを追加

529



530 –

新コンポーネントを追加

542



137 -

U 相、V 相、W 相の Start API と Stop API を分割

断線検出アシスト設定
アナログフロントエンド
モータ

142
219

API 名とパラメータ概要を更新

248
299

新しい API を追加

300



455 –

送受信バッファパラメータのデータ型の記述を変更

MTU チャンネルのカウンタを同時に Start/Stop

460
476

受信バッファパラメータのデータ型の記述を変更

477
1.07

2022.08.01

122 -DOC コンポーネントを更新

125

3 つのパラメータで定義されている R_<Config_DOC>SetMode API を追加

“uint32_t” を値の type に追加

206

シンプル I2C モードの RSCI サポート情報を追加

375 -



SCI/SCIF 調歩同期式モードコンポーネントおよび SCI/SCIF クロック同期



SCI/SCIF 調歩同期式モードコンポーネントおよび SCI/SCIF クロック同期式モードコンポーネントの RSCI サポート情報を追加

418

式モードコンポーネントの r_<Config_SCI0>_receive_interrupt API の記述を更新
437

スマートカードインタフェースコンポーネントの RSCI サポート情報を追加

Rev.

発行日

改訂内容
ページ

1.07

2022.08.01

ポイント

452 -



簡易 SPI モードの RSCI サポート情報を追加

472



新しい API を追加（受信エラー割り込みの発生に伴う処理を行う）



SPI クロック同期式モードコンポーネントのr_<Config_SCI0>_receive_interrupt API の記述を更新

551 1.08

2023.10.20

新しいコンポーネントを追加

557



15,

新しい API を追加

334,



LCD コントローラ
アラーム割り込みの許可/禁止

354,
355
151

R_<config_DMAC0>_Set_SoftwareTrigger に備考を追加

173,

R_<config_GPT0>_Start と R_<Config_GPT0>_Stop に備考と追加

174
1.09

2024.10.20

20

無限ループ確認用の「WAIT_LOOP」の情報を追加

112,

R_<Config_DA>n_Start と R_<Config_DA>n_Sync_Start に備考を追加

115
172,

R_<Config_GPT0>_Start と R_<Config_GPT0>_Stop の備考を更新

173
308,
309

R_<Config_POE>_Start と R_<Config_POE>_Stop に備考を追加

スマート・コンフィグレータ ユーザーズマニュアル
RX APIリファレンス編
発行年月日

2024年10月20日

発行

ルネサス エレクトロニクス株式会社

Rev.1.09〒135-0061 東京都江東区豊洲3-2-24（豊洲フォレシア）スマート・コンフィグレータ

R20UT4360JJ0109