DS12887-c

Description

The DS12887 device implements real time clock functionality and non-volatile storage (NVRAM). The device is often referred to as CMOS Clock. The DS12887 includes time-of-day alarm, both 12 and 24 hour time format, periodic interrupts and 114 bytes of general purpose RAM. Limitations: Alarm interrupt not implemented. Daylight Savings Time not implemented.

Interfaces Implemented

conf_object, log_object, io_memory

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for this class

get-date-time – get date and time
info – print information about the object
set-date-time – set date and time
status – print status of the object
trace-nvram – trace nvram updates

Attributes

irq_dev: Required attribute; read/write access; type: o
Device to send interrupts to, implementing the simple_interrupt.
irq_level: Required attribute; read/write access; type: i
Level at which interrupts are sent.
nvram: Optional attribute; read/write access; type: [i{128}]
The contents of the non-volatile storage, as a list of 128 bytes.
next_addr: Optional attribute; read/write access; type: i
Next NVRAM address to be accessed.
seconds_last: Optional attribute; read/write access; type: i
Current time-of-day, counted in seconds.
time_last: Optional attribute; read/write access; type: f
Simulated time in seconds at last update.
last_pie: Optional attribute; read/write access; type: f
Time of last PIE interrupt in simulator time.
interrupt_pin: Optional attribute; read/write access; type: i
Status of the interrupt pin.
period_in_us: Pseudo attribute; read-only access; type: [i{16}]
Time between periodic interrupts, in microseconds
time_regs_changed: Optional attribute; read/write access; type: b
Set to true if time register were modified while SET = 1.
year: Pseudo attribute; read/write access; type: i
Current year (full four-digit format).
month: Pseudo attribute; read/write access; type: i
Current month [1,12].
mday: Pseudo attribute; read/write access; type: i
Current day of the month [1,31].
hour: Pseudo attribute; read/write access; type: i
Current hour [0,23].
minute: Pseudo attribute; read/write access; type: i
Current minute [0,59].
second: Pseudo attribute; read/write access; type: i
Current second [0,59].

Provided By

DS12887-c