Renesas M16C/62P Group Bedienungsanleitung

www.renesas.comReference ManualREC10B0002-0100 M16C/62P GroupRenesas Embedded Application Programming InterfaceReference ManualRev.1.00Revision Date:

Rev.1.00 2007.11.1 REC10B0002-0100 102.6 External Interrupt Driver The external interrupt driver sets external interrupts, controls external interr

Rev.1.00 2007.11.1 REC10B0002-0100 112.7 A/D Converter Driver The A/D converter driver sets the A/D converter, controls the A/D converter, clears s

Rev.1.00 2007.11.1 REC10B0002-0100 123. Standard Types This section describes the standard types defined in the library. For details about the set

Rev.1.00 2007.11.1 REC10B0002-0100 134. Library Reference 4.1 API List by Peripheral Facility The table below lists the Renesas Embedded APIs class

Rev.1.00 2007.11.1 REC10B0002-0100 1435 __CreatePulseWidthMeasurementMode Sets pulse width measurement mode 36 __EnablePulseWidthMeasurementMode

Rev.1.00 2007.11.1 REC10B0002-0100 154.2 Description of Each API This section describes each API and explains how to use them, showing a program ex

Rev.1.00 2007.11.1 REC10B0002-0100 164.2.1 Serial I/O __BasicOpenSerialDriver Synopsis <Open a serial port> Boolean __BasicOpenSerialDriv

Rev.1.00 2007.11.1 REC10B0002-0100 17 __BasicCloseSerialDriver Synopsis <Close a serial port> Boolean __BasicCloseSerialDriver(unsigned lo

Rev.1.00 2007.11.1 REC10B0002-0100 18 __BasicSetSerialFormat Synopsis <Set serial communication> Boolean __BasicSetSerialFormat(unsigned l

Rev.1.00 2007.11.1 REC10B0002-0100 19 If the API is used in clock synchronous serial communication mode, do not set these values. (UART0, UART1, U

Rev.1.00 2007.11.1 REC10B0002-0100 2 Renesas Embedded Application Programming Interface Reference Manual <M16C/62P Group>

Rev.1.00 2007.11.1 REC10B0002-0100 20 If serial communication was successfully set, RAPI_TRUE is returned; if settings failed, RAPI_FALSE is return

Rev.1.00 2007.11.1 REC10B0002-0100 21 __BasicStartSerialReceiving Synopsis <Receive 1 data> Boolean __BasicStartSerialReceiving(unsigned l

Rev.1.00 2007.11.1 REC10B0002-0100 22 __BasicStartSerialSending Synopsis <Transmit 1 data> Boolean _BasicStartSerialSending(unsigned long

Rev.1.00 2007.11.1 REC10B0002-0100 23 __BasicReceivingStatusRead Synopsis <Read receive status> unsigned int __BasicReceivingStatusRead(un

Rev.1.00 2007.11.1 REC10B0002-0100 24 __BasicSendingStatusRead Synopsis <Read transmit status> Boolean __BasicSendingStatusRead(unsigned

Rev.1.00 2007.11.1 REC10B0002-0100 25 __BasicStopSerialReceiving Synopsis <Stop reception> Boolean Rapi_BasicStopSerialReceiving(unsigned

Rev.1.00 2007.11.1 REC10B0002-0100 26 __BasicStopSerialSending Synopsis <Stop transmission> Boolean __BasicStopSerialSending(unsigned long

Rev.1.00 2007.11.1 REC10B0002-0100 27 __OpenSerialDriver Synopsis <Open a serial port> Boolean __OpenSerialDriver(unsigned long data) da

Rev.1.00 2007.11.1 REC10B0002-0100 28 __CloseSerialDriver Synopsis <Close a serial port> Boolean __CloseSerialDriver(unsigned long data)

Rev.1.00 2007.11.1 REC10B0002-0100 29 __ConfigSerialDriverNotify Synopsis <Register a notification function> Boolean __ConfigSerialDriver

Rev.1.00 2007.11.1 REC10B0002-0100 3 Table of Contents Table of Contents ... 3 1. Intro

Rev.1.00 2007.11.1 REC10B0002-0100 30Return value If the serial port specification is incorrect, RAPI_FALSE is returned; otherwise, RAPI_TRUE is

Rev.1.00 2007.11.1 REC10B0002-0100 31 __SetSerialFormat Synopsis <Set serial communication> Boolean __SetSerialFormat(unsigned long data1

Rev.1.00 2007.11.1 REC10B0002-0100 32 __SetSerialInterrupt Synopsis <Set serial interrupts> Boolean __SetSerialInterrupt(unsigned long dat

Rev.1.00 2007.11.1 REC10B0002-0100 33 Functionality Serial I/O Reference Remark • If an undefined value is specified in the argument, oper

Rev.1.00 2007.11.1 REC10B0002-0100 34 __StartSerialReceiving Synopsis <Start reception> Boolean __StartSerialReceiving(unsigned long data,

Rev.1.00 2007.11.1 REC10B0002-0100 35 __StartSerialSending Synopsis <Start transmission> Boolean __StartSerialSending(unsigned long data,

Rev.1.00 2007.11.1 REC10B0002-0100 36 __StopSerialReceiving Synopsis <Stop reception> Boolean __StopSerialReceiving(unsigned long data)

Rev.1.00 2007.11.1 REC10B0002-0100 37 __StopSerialSending Synopsis <Stop transmission> Boolean __StopSerialSending(unsigned long data) d

Rev.1.00 2007.11.1 REC10B0002-0100 38 __PollingSerialReceiving Synopsis <Polling reception> Boolean __PollingSerialReceiving(unsigned long

Rev.1.00 2007.11.1 REC10B0002-0100 39 __PollingSerialSending Synopsis <Polling transmission> Boolean __PollingSerialSending(unsigned long

Rev.1.00 2007.11.1 REC10B0002-0100 4__DestroyTimer ... 43 __CreateEventCounter ...

Rev.1.00 2007.11.1 REC10B0002-0100 404.2.2 Timer __CreateTimer Synopsis <Set timer mode> Boolean __CreateTimer(unsigned long data1, unsign

Rev.1.00 2007.11.1 REC10B0002-0100 41 (Count source) Specify one from { RAPI_F1, RAPI_F2, RAPI_F8, RAPI_F32, RAPI_FC32 }. The default value is RA

Rev.1.00 2007.11.1 REC10B0002-0100 42 __EnableTimer Synopsis <Control operation of timer mode> Boolean __EnableTimer(unsigned long data)

Rev.1.00 2007.11.1 REC10B0002-0100 43 __DestroyTimer Synopsis <Discard settings of timer mode> Boolean __DestroyTimer(unsigned long data)

Rev.1.00 2007.11.1 REC10B0002-0100 44 __CreateEventCounter Synopsis <Set event counter mode> Boolean __CreateEventCounter(unsigned long da

Rev.1.00 2007.11.1 REC10B0002-0100 45 RAPI_UP_COUNT Selects up-count for the count operation. RAPI_DOWN_COUNT Selects down-count for the count

Rev.1.00 2007.11.1 REC10B0002-0100 46 [data4] Specify 0. Return value If the timer specification is incorrect, RAPI_FALSE is returned; otherw

Rev.1.00 2007.11.1 REC10B0002-0100 47 __EnableEventCounter Synopsis <Control operation of event counter mode> Boolean __EnableEventCounte

Rev.1.00 2007.11.1 REC10B0002-0100 48 __DestroyEventCounter Synopsis <Discard settings of event counter mode> Boolean __DestroyEventCounte

Rev.1.00 2007.11.1 REC10B0002-0100 49 __GetEventCounter Synopsis <Get event counter mode counter value> Boolean __GetEventCounter(unsigne

Rev.1.00 2007.11.1 REC10B0002-0100 51. Introduction The Renesas Embedded Application Programming Interface (API) is a unified API for the microcomp

Rev.1.00 2007.11.1 REC10B0002-0100 50 __CreatePulseWidthModulationMode Synopsis <Set pulse width modulation mode> Boolean __CreatePulseWid

Rev.1.00 2007.11.1 REC10B0002-0100 51 RAPI_FALLING Selects the falling edge of TAiIN pin input signal as active edge. • Specifiable definition

Rev.1.00 2007.11.1 REC10B0002-0100 52 void func( void ) { unsigned int p_tim[] = {0xAA, 0xBB, 0xCC}; /* Set up timer A3 as pulse width m

Rev.1.00 2007.11.1 REC10B0002-0100 53 __EnablePulseWidthModulationMode Synopsis <Control operation of pulse width modulation mode> Boolean

Rev.1.00 2007.11.1 REC10B0002-0100 54 __DestroyPulseWidthModulationMode Synopsis <Discard settings of pulse width modulation mode> Boolean

Rev.1.00 2007.11.1 REC10B0002-0100 55 __CreatePulsePeriodMeasurementMode Synopsis <Set pulse period measurement mode> Boolean __CreatePuls

Rev.1.00 2007.11.1 REC10B0002-0100 56 [data3] Specify 0. [data4] Specify 0. Return value If the timer specification is incorrect, R

Rev.1.00 2007.11.1 REC10B0002-0100 57 __EnablePulsePeriodMeasurementMode Synopsis <Control operation of pulse period measurement mode> Boo

Rev.1.00 2007.11.1 REC10B0002-0100 58 __DestroyPulsePeriodMeasurementMode Synopsis <Discard settings of pulse period measurement mode> Boo

Rev.1.00 2007.11.1 REC10B0002-0100 59 __GetPulsePeriodMeasurementMode Synopsis <Get measured value in pulse period measurement mode> Boole

Rev.1.00 2007.11.1 REC10B0002-0100 62. Driver 2.1 Overview The library described herein provides a peripheral facility control program (peripheral

Rev.1.00 2007.11.1 REC10B0002-0100 60 __CreatePulseWidthMeasurementMode Synopsis <Set pulse width measurement mode> Boolean __CreatePulseW

Rev.1.00 2007.11.1 REC10B0002-0100 61 [data4] Specify 0. Return value If the timer specification is incorrect, RAPI_FALSE is returned; othe

Rev.1.00 2007.11.1 REC10B0002-0100 62 __EnablePulseWidthMeasurementMode Synopsis <Control operation of pulse width measurement mode> Boole

Rev.1.00 2007.11.1 REC10B0002-0100 63 __DestroyPulseWidthMeasurementMode Synopsis <Discard settings of pulse width measurement mode> Bool

Rev.1.00 2007.11.1 REC10B0002-0100 64 __GetPulseWidthMeasurementMode Synopsis <Get measured value in pulse width measurement mode> Boolea

Rev.1.00 2007.11.1 REC10B0002-0100 65 __SetTimerRegister Synopsis <Set timer register> Boolean __SetTimerRegister(unsigned long data1, un

Rev.1.00 2007.11.1 REC10B0002-0100 66 If an undefined value is specified in the first argument, operation of the API cannot be guaranteed. • The

Rev.1.00 2007.11.1 REC10B0002-0100 67 __EnableTimerRegister Synopsis <Control operation of timer register> Boolean __EnableTimerRegister(u

Rev.1.00 2007.11.1 REC10B0002-0100 68 __ClearTimerRegister Synopsis <Clear timer register> Boolean __ClearTimerRegister(unsigned long data

Rev.1.00 2007.11.1 REC10B0002-0100 69 __GetTimerRegister Synopsis <Get timer register value> Boolean __GetTimerRegister(unsigned long data

Rev.1.00 2007.11.1 REC10B0002-0100 72.3 Serial Interface Driver The serial interface driver sets serial communication, clears settings, transmit/re

Rev.1.00 2007.11.1 REC10B0002-0100 70Reference __SetTimerRegister, __EnableTimerRegister, __ClearTimerRegister Remark • If an undefined value

Rev.1.00 2007.11.1 REC10B0002-0100 714.2.3 I/O Port __SetIOPort Synopsis <Set I/O port> Boolean __SetIOPort(unsigned long data1, unsigned

Rev.1.00 2007.11.1 REC10B0002-0100 72 RAPI_PORT_7_2 Port P72 RAPI_PORT_7_3 Port P73 RAPI_PORT_7_4 Port P74 RAPI_PORT_7_5 Port P75 RAPI_PORT_7_

Rev.1.00 2007.11.1 REC10B0002-0100 73Functionality I/O port Reference __ReadIOPort, __WriteIOPort, __SetIOPortRegister, __ReadIOPortRegister,

Rev.1.00 2007.11.1 REC10B0002-0100 74 __ReadIOPort Synopsis <Read from I/O port> Boolean __ReadIOPort(unsigned long data1, unsigned int *d

Rev.1.00 2007.11.1 REC10B0002-0100 75 RAPI_PORT_9_6 Port P96 RAPI_PORT_9_7 Port P97 RAPI_PORT_10_0 Port P100 RAPI_PORT_10_1 Port P101 RAPI_POR

Rev.1.00 2007.11.1 REC10B0002-0100 76 __WriteIOPort Synopsis <Write to I/O port> Boolean __WriteIOPort(unsigned long data1, unsigned int d

Rev.1.00 2007.11.1 REC10B0002-0100 77 RAPI_PORT_9_6 Port P96 RAPI_PORT_9_7 Port P97 RAPI_PORT_10_0 Port P100 RAPI_PORT_10_1 Port P101 RAPI_POR

Rev.1.00 2007.11.1 REC10B0002-0100 78 __SetIOPortRegister Synopsis <Set I/O port register> Boolean __SetIOPortRegister(unsigned long data1

Rev.1.00 2007.11.1 REC10B0002-0100 79 If an undefined value is specified in the first argument, operation of the API cannot be guaranteed. Progra

Rev.1.00 2007.11.1 REC10B0002-0100 82.4 Timer Driver The timer driver sets the timer, clears timer settings, controls timer operation, and acquires

Rev.1.00 2007.11.1 REC10B0002-0100 80 __ReadIOPortRegister Synopsis <Read from I/O port register> Boolean __ReadIOPortRegister(unsigned lo

Rev.1.00 2007.11.1 REC10B0002-0100 81 __WriteIOPortRegister Synopsis <Write to I/O port register> Boolean __WriteIOPortRegister(unsigned

Rev.1.00 2007.11.1 REC10B0002-0100 824.2.4 External interrupt __SetInterrupt Synopsis <Set external interrupt> Boolean __SetInterrupt(unsi

Rev.1.00 2007.11.1 REC10B0002-0100 83Return value If the external interrupt specification is incorrect, RAPI_FALSE is returned; otherwise, RAPI_T

Rev.1.00 2007.11.1 REC10B0002-0100 84 __EnableInterrupt Synopsis <Control external interrupt> Boolean __EnableInterrupt(unsigned long data

Rev.1.00 2007.11.1 REC10B0002-0100 85 __GetInterruptFlag Synopsis <Get the status of external interrupt flag> Boolean __GetInterruptFlag(u

Rev.1.00 2007.11.1 REC10B0002-0100 86 __ClearInterruptFlag Synopsis <Clear external interrupt flag> Boolean __ClearInterruptFlag(unsigned

Rev.1.00 2007.11.1 REC10B0002-0100 874.2.5 A/D converter __CreateADC Synopsis <Set A/D converter> Boolean __CreateADC(unsigned long data1,

Rev.1.00 2007.11.1 REC10B0002-0100 88 RAPI_AN27 Uses AN27 pin for the analog input pin. RAPI_P0_GROUP Uses port P0 group for the analog input p

Rev.1.00 2007.11.1 REC10B0002-0100 89 (Input pin) Specify one from { RAPI_AN0, RAPI_AN1, RAPI_AN2, RAPI_AN3, RAPI_AN4, RAPI_AN5, RAPI_AN6, RAPI_AN

Rev.1.00 2007.11.1 REC10B0002-0100 92.5 I/O Port Driver The I/O port driver sets the I/O port for input or output, writes data to the I/O port, and

Rev.1.00 2007.11.1 REC10B0002-0100 90 (Operating states set) Specify one from { RAPI_AD_ON, RAPI_AD_OFF }. The default value is RAPI_AD_OFF. (Co

Rev.1.00 2007.11.1 REC10B0002-0100 91Remark • If an undefined value is specified in the first argument, operation of the API cannot be guarantee

Rev.1.00 2007.11.1 REC10B0002-0100 92 __EnableADC Synopsis <Control operation of A/D converter> Boolean __EnableADC (unsigned long data1,

Rev.1.00 2007.11.1 REC10B0002-0100 93 RAPI_AN21 Uses AN21 pin for the analog input pin. Selectable only when one-shot mode or repeat mode is u

Rev.1.00 2007.11.1 REC10B0002-0100 94 Program example #include "rapi_ad_m16c_62p.h" void func( void ) { /* Disable A/D converter

Rev.1.00 2007.11.1 REC10B0002-0100 95 __DestroyADC Synopsis <Discard settings of A/D converter> Boolean __DestroyADC(void) Description

Rev.1.00 2007.11.1 REC10B0002-0100 96 __GetADC Synopsis <Get A/D converted value (register specified)> Boolean __GetADC(unsigned long data

Rev.1.00 2007.11.1 REC10B0002-0100 97 __GetADCAll Synopsis <Get A/D converted value (all registers)> Boolean __GetADCAll(unsigned int *dat

Rev.1.00 2007.11.1 REC10B0002-0100 98 M16C/62P Group Renesas Embedded Application Programming Interface Reference