VIRTUTECH CONFIDENTIAL    Previous - Up - Next

DS17485

Provided by
DS17485
Class Hierarchy
conf-objectlog-objectDS17485
Interfaces Implemented
log_object, event_poster, io_memory
Description
The DS17485 device implements real time clock functionality and non-volatile storage (NVRAM). The device is often referred to as CMOS Clock. The DS17485 include time-of-day alarm, both 12 and 24 hour time format, periodic interrupts and 114 bytes + 4 kbytes of general purpose RAM. Limitations: Alarm interrupt not implemented. Daylight Savings Time not implemented.

Attributes

Attributes inherited from class conf-object
attributes, classname, component, iface, name, object_id, queue
Attributes inherited from class log-object
access_count, log_buffer, log_buffer_last, log_buffer_size, log_group_mask, log_groups, log_level, log_type_mask
Attribute List
extended_ram
Optional attribute; read/write access; type: Data.

The contents of the (4 * 1024) bytes of extended RAM.

hour
Pseudo attribute; read/write access; type: Integer.

Current hour [0,23].

interrupt_pin
Optional attribute; read/write access; type: Integer.

Status of the interrupt pin.

irq_dev
Required attribute; read/write access; type: Object.

Device to send interrupts to, implementing the simple-interrupt.

irq_level
Required attribute; read/write access; type: Integer.

Level at which interrupts are sent.

last_pie
Optional attribute; read/write access; type: Float.

Time of last PIE interrupt in simulator time.

mday
Pseudo attribute; read/write access; type: Integer.

Current day of the month [1,31].

minute
Pseudo attribute; read/write access; type: Integer.

Current minute [0,59].

month
Pseudo attribute; read/write access; type: Integer.

Current month [1,12].

next_addr
Optional attribute; read/write access; type: Integer.

Next NVRAM address to be accessed.

nvram
Optional attribute; read/write access; type: [i{128}]; integer indexed; indexed type: Integer; persistent attribute.

The contents of the non-volatile storage, as a list of 128 bytes.

nvram_bank1
Optional attribute; read/write access; type: [i{64}]; integer indexed; indexed type: unknown type; persistent attribute.

The contents of the non-volatile storage in bank1, as a list of 64 bytes.

period_in_us
Pseudo attribute; read-only access; type: [i{16}].

Time between periodic interrupts, in microseconds

second
Pseudo attribute; read/write access; type: Integer.

Current second [0,59].

seconds_last
Optional attribute; read/write access; type: Integer; persistent attribute.

Current time-of-day, counted in seconds.

time_last
Optional attribute; read/write access; type: Float.

Simulated time in seconds at last update.

time_regs_changed
Optional attribute; read/write access; type: Integer.

Set to 1 if time register were modified while SET = 1.

year
Pseudo attribute; read/write access; type: Integer.

Current year (full four-digit format).

Command List

Commands defined by interface log_object
log, log-group, log-level, log-size, log-type
Commands
cmos-base-memdeprecated — set base memory size
cmos-boot-devdeprecated — set boot drive
cmos-centurydeprecated — set date century
cmos-extended-memdeprecated — set extended memory size
cmos-floppydeprecated — set floppy parameters
cmos-hddeprecated — set fixed disk parameters
cmos-infodeprecated — print information about the CMOS area
cmos-initdeprecated — initialize some CMOS values
get-date-timeget date and time
infoprint information about the device
set-date-timeset date and time
statusprint status of the device
trace-nvramtrace nvram updates

Command Descriptions

<DS17485>.cmos-base-mem — deprecated
Synopsis
<DS17485>.cmos-base-mem kilobytes
Description
This command is deprecated, use <x86-system>.cmos-base-mem instead.

<DS17485>.cmos-boot-dev — deprecated
Synopsis
<DS17485>.cmos-boot-dev "drive"
Description
This command is deprecated, use <x86-system>.cmos-boot-dev instead.

<DS17485>.cmos-century — deprecated
Synopsis
<DS17485>.cmos-century century
Description
This command is deprecated, use <DS17485>.set-date-time instead.

<DS17485>.cmos-extended-mem — deprecated
Synopsis
<DS17485>.cmos-extended-mem megabytes
Description
This command is deprecated, use <x86-system>.cmos-extended-mem instead.

<DS17485>.cmos-floppy — deprecated
Synopsis
<DS17485>.cmos-floppy "drive" "type"
Description
This command is deprecated, use <x86-system>.cmos-floppy instead.

<DS17485>.cmos-hd — deprecated
Synopsis
<DS17485>.cmos-hd "drive" cylinders heads sectors_per_track
Description
This command is deprecated, use <x86-system>.cmos-hd instead.

<DS17485>.cmos-info — deprecated
Synopsis
<DS17485>.cmos-info
Description
This command is deprecated, use <x86-system>.cmos-info instead.

<DS17485>.cmos-init — deprecated
Synopsis
<DS17485>.cmos-init
Description
This command is deprecated, use <x86-system>.cmos-init instead.

<DS17485>.get-date-time
Synopsis
<DS17485>.get-date-time
Description
Return the date and time of the real-time clock.
<DS17485>.info
Synopsis
<DS17485>.info
Description
Print detailed information about the configuration of the device.
<DS17485>.set-date-time
Synopsis
<DS17485>.set-date-time year month mday hour minute second [-binary] [-bcd]
Description
Set the date and time of the real-time clock. Both month and mday start counting at one, the other at zero. Year should be in the full four-digit format. The cmos-init command must be issued before this command, unless the simulation was started from a checkpoint. The -binary and -bcd flags can be used to specify the format of the register values. Default is to use BCD, but some systems use a binary format without checking the binary/BCD status bit in register B.
<DS17485>.status
Synopsis
<DS17485>.status
Description
Print detailed information about the current status of the device.
<DS17485>.trace-nvram
Synopsis
<DS17485>.trace-nvram
Description
Trace all nvram updates.

VIRTUTECH CONFIDENTIAL    Previous - Up - Next