RTC Demos

# Real-Time Clock Sample Demo

## Location

`$TwlSDK/build/demos/rtc`

## Compilation

Move to the `$TwlSDK/build/demos/rtc` (or `$TwlSDK/build/demos.TWL/rtc`) directory, and enter

> `% make`

Compiling will begin, and the SRL executable file and the NEF or TEF files having binary information will be generated in `$TwlSDK/build/demos/rtc/(sample name)/bin/(platform)/(target)/`
`$TwlSDK/build/demos.TWL/rtc/(sample name)/bin/(platform/(target)/`.

For example:

> `$TwlSDK/build/demos/rtc/rtc-1/bin/ARM9-TS/Release/main.srl`

will be the executable file for the `rtc-1` demo.

## Execution

### For NITRO ROMs

If using the Ensata emulator:

- Execute NEF and SRL files with `ensata`

If using IS-NITRO-DEBUGGER:

- Load and execute an NLF file with IS-NITRO-DEBUGGER
- Execute an SRL file with IS-NITRO-DEBUGGER
- Execute an SRL file with IS-NITRO-DEBUGGER using the `loadrun.exe` tool from a command line

If using IS-TWL-DEBUGGER:

- Load and execute an NLF file with IS-TWL-DEBUGGER
- Execute an SRL file with IS-TWL-DEBUGGER
- Execute an SRL file with IS-TWL-DEBUGGER using the `loadrun.TWL.exe` tool from a command line

### For TWL/NITRO Hybrid ROMs

If using IS-NITRO-DEBUGGER:

- Execute an SRL file with IS-NITRO-DEBUGGER
- Execute an SRL file with IS-NITRO-DEBUGGER using the `loadrun.exe` tool from a command line

If using IS-TWL-DEBUGGER:

- Load and execute a TLF file with IS-TWL-DEBUGGER
- Execute an SRL file with IS-TWL-DEBUGGER
- Execute an SRL file with IS-TWL-DEBUGGER using the `loadrun.TWL.exe` tool from a command line

### For TWL Limited ROMs

If using IS-TWL-DEBUGGER:

- Load and execute a TLF file with IS-TWL-DEBUGGER
- Execute an SRL file with IS-TWL-DEBUGGER
- Execute an SRL file with IS-TWL-DEBUGGER using the `loadrun.TWL.exe` tool from a command line

## Description

Name | Directory | Operation
--- | --- | ---
`rtc-1` | `demos` | Tests the real-time clock operation features: -Read and change date and time -Read and change alarm setting values -Interrupt functions when alarms are generated
`convert-1` | `demos` | Tests the conversion function for date and time. It outputs the result to debug output.
`swclock-1` | `demos` | Tests the synchronization features of the software clock: -Software clock and RTC date/time comparison -Synchronization with RTC -Automatic synchronization when recovering from sleep mode

## Operation

The `rtc-1` demo does not work properly with `ensata`.

## See Also

RTC Function List

## Revision History

2008/07/11 Added the `swclock-1` demo.
2008/07/11 Changed the description corresponding to TWL.
2005/05/17 Added the `convert-1` demo.
2005/03/08 Standardized the Japanese term for "interrupt".
2005/03/02 Revised descriptions to reflect current support environment conditions.
2004/10/06 Changed description regarding the alarm interrupt feature of the `rtc-1` demo.
2004/09/16 Added description on the alarm interrupt feature of `rtc-1` demo.
2004/08/17 Standardized the notation of IS-NITRO-EMULATOR.
2004/07/10 Changed from `.bin` to `.srl`. 2004/06/18 Initial version.

CONFIDENTIAL