MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY, Integer32, TimeTicks,
Unsigned32
                                                    FROM SNMPv2-SMI
                                                      -- RFC 2578
TruthValue, StorageType, RowStatus
                                                    FROM SNMPv2-TC
                                                      -- RFC 2579
MODULE-COMPLIANCE, OBJECT-GROUP
                                                    FROM SNMPv2-CONF
                                                      -- RFC 2580
ITSDailyTimeStamp, ITSDateStamp, ITSDayOfWeek, ITSDayOfMonth, ITSInteger16, 
ITSMonth, ITSPositive8, ITSUnsigned16
                                                    FROM ISO26048-1-FieldDevice
fdGlobalMIB, fdGlobalConformance
                                                    FROM ISO26048-1-Global

This MIB defines a generalized clock that can be used within a field device to track time, including an optional local time with a time zone and daylight saving time (a.k.a., 'summer time') offsets. Copyright (C) International Organization for Standardization (ISO). This MIB module is part of ISO 26048-1; see ISO 26048-1 for full legal notices.

A node for managing the local clock parameters.

The number of milliseconds that have elapsed since 00:00:00.000 (midnight) Coordinated Universal Time (UTC). Exactly one second past midnight UTC would be represented as 1000.

The Gregorian calendar date represented as the OER-encoded structure of: SEQUENCE { year INTEGER (0..65535), month INTEGER (1..12), date INTEGER (1..31) } An attempt to SET this object to a value of a non-existent date (e.g., 29 February 2019), shall cause the the field device to respond with a 'wrongValue' error.

The resolution of the internal clock as reported by fdClockUtcTime. A clock with a resolution of 1 second would report a value of 1000; a clock with a resolution of 1 millisecond would report a value of 1.

The clock synchronization sources supported by the device. other - one or more sources not defined by this standard snmp - allows setting fdClockUtcTime via SNMP or other mechanism that may be subject to network delays network - network time protocol (NTP) or similar mechanism that includes logic to compensate for network delays to provide accuracies better than 100 ms radio - terrestrial radio-based time broadcast, such as WWV satellite - satellite-based signal such as provided by global navigation system satellites

The requested clock synchronization source. The value of this object may default to 'local' to indicate that the device does not automatically attempt to synchronize with any external source. The value of this object shall automatically transition to 'snmp' whenever fdClockUtcTime or fdClockUtcDate is successfully set via an 'snmp' interface. If a request is received to set the value to 'other', 'snmp', or 'local', the field device shall return a 'wrongValue' error. If the value of this object is 'network', 'radio', or 'satellite', the device shall attempt to synchronize to the requested source at least once every fdClockSyncCycle. If the field device fails to synchronize with the requested source, or fails to be set via 'snmp' when in the 'snmp' mode, for a period exceeding the fdClockSyncCycle duration, the device may attempt to synchronize with an alternate source. However, the field device shall continue to attempt to synchronize with the requested source at least once every fdClockSyncCycle. The device shall not synchronize with another source if synchronization with the requested source is successful.

The source used for the most recent clock synchronization. When operating as expected, this value should reflect the value of fdClockRequestedSource once the clock synchronizes. If the clock has not been able to successfully synchronize with the requested source within the last fdClockSyncCycle, this object shall reflect the current source; if the field device has not successfully synchronized with any external source, this object shall report a value of 'local'.

The status of the requested time source for the clock (fdClockRequestedSource). other: The status of the requested source is not represented by any of the other states. normal: The source is providing information as expected. dataError: The last update from the source contained an error in the supplied data. timeout: The source has failed to successfully provide an update within the fdClockSyncCycle plus the implementation defined grace period. pending: The field device has initiated a process to obtain an updated time or is otherwise expecting an update from the time source; while the field device has not yet successfully received an update the time since the last update is still within the fdClockSyncCycle plus any implementation-defined grace period. discontinuity: The source provided an update that resulted in a discontinuity in the time greater than fdClockDiscontinuityMaxAdjustment; when this occurs, the status will return to 'normal' after 10 seconds or when the status is read via SNMP, which ever comes first.

The status of the current time source for the clock (fdClockSource). other: The status of the requested source is not represented by any of the other states. normal: The source is providing information as expected. dataError: The last update from the source contained an error in the supplied data. timeout: The source has failed to successfully provide an update within the fdClockSyncCycle plus the implementation defined grace period. pending: The source has failed to successfully provide an update within the fdClockSyncCycle, but is still within the implementation defined grace period. discontinuity: The source provided an update that resulted in a discontinuity greater than fdClockDiscontinuityMaxAdjustment; when this occurs, the status will return to 'normal' after 10 seconds or until the status is read via SNMP, which ever comes first.

The amount of time between each synchronization with the time source. The device clock shall synchronize at least once every indicated cycle.

The UTC time at which the last synchronization to an external reference clock was made.

The UTC date on which the last synchronization to an external reference clock was made.

The mechanisms by which the fdClockUtcTime object is able to track the passage of time. other - a source not defined by this standard lineFrequency - tracking the AC power line frequency rtcSqareWave - tracking a real-time clock square wave crystal - using an internal time crystal external - the synchronizes with the fdClockSource at least once a minute

The requested mechanism to keep time within the fdClockUtcTime object between synchronization events. other - use a source not defined by this standard lineFrequency - track the AC power line frequency rtcSqareWave - track a real-time clock square wave crystal - use the internal time crystal external - synchronize with the fdClockSource at least once a minute

The mechanism currently being used to keep time within the fdClockUtcTime object between synchronization events. unknown - the source is unknown or cannot be determined; this is considered an error state other - a source not defined by this standard lineFrequency - tracking the AC power line frequency rtcSqareWave - tracking a real-time clock square wave crystal - using an internal time crystal external - synchronizes with the fdClockSource at least once a minute

The source of the time that caused the discontinuity. unknown - The source of the discontinuity is unknown other - The discontinuity and previous source were both 'other' snmp - The discontinuity and previous source were both 'snmp' network - The discontinuity and previous source were both 'network' radio - The discontinuity and previous source were both 'radio' satellite - The discontinuity and previous source were both 'satellite' local - The discontinuity and previous source were both 'local' changedOther - The discontinuity source was 'other', but the previous source was not 'other' changedSnmp - The discontinuity source was 'snmp', but the previous source was not 'snmp' changedNetwork - The discontinuity source was 'network', but the previous source was not 'network' changedRadio - The discontinuity source was 'radio', but the previous source was not 'radio' changedSatellite - The discontinuity source was 'satellite', but the previous source was not 'satellite' changedLocal - The discontinuity source was 'local', but the previous source was not 'local'

The number of milliseconds that the discontinuity advanced the clock. A negative value indicates that the new time moved the clock backwards. A value of 0x80 00 00 00 indicates an unknown state (e.g., the clock has not been set since the last reboot). The range accounts for any delta within 24+ days; deltas outside of the range of this object shall indicate 0x80 00 00 01 for excessive roll-backs and 0x7F FF FF FF for excessive advances of the clock.

The value of sysUpTime when the discontinuity value was implemented.

The minimum number of milliseconds that the clock must be adjusted by (forwards or backwards) in order for the field device to record a discontinuity. The field device shall not support values less than its fdClockResolution value.

A node for managing the local clock parameters.

The number of seconds between UTC time and the local standard time zone (not considering any daylight savings time adjustments). Positive values represent time zones in the eastern hemisphere; negative values represent time zones in the western hemisphere.

The local time of day measured in milliseconds from local midnight; the value shall reflect the sum of fdClockUtcTime + (fdClockLocalStandardTimeZone * 1000) + (fdClockLocalDstAdjustment * 1000).

The local Gregorian Date per the values of fdClockUtcTime, fdClockLocalStandardTimeZone, and fdClockLocalDstAdjustment.

The number of seconds of the current offset due to daylight savings time. The value of this object shall be sum of the fdClockLocalDstOffset values from all active rows of the fdClockLocalDstTable where fdClockLocalDstApplied is equal to 'true'; if no such rows exist, the value of this object shall be zero (0).

The maximum number of entries allowed within the fdClockDstTable.

A dynamic table where each entry defines the characteristics of a daylight savings time rule (e.g., when it begins, when it ends, and how much of an offset is created).

The definition of a daylight saving time event pair.

An index used to identify the row within the fdClockDstTable.

Indicates the month that is combined with fdClockLocalDstBeginDayOfMonth to determine the base date used to calculate the start of daylight savings time using other object values in this row. This is often the month in which daylight savings time begins, but may not be. For example, if the value of this object is December, beginDayOfMonth is 31, and beginOccurences is 'second'; daylight savings time will begin on the second week after 31 December, which would be in January of the following year.

If the value is 1-4, daylight savings time shall begin on the <named value of this object> <beginDayOfWeek> on or after <beginDayOfMonth><beginMonth>. If the value is 5-8, daylight savings time shall begin on the <named value of this object> <beginDayOfWeek> on or before <beginDayOfMonth> <beginMonth>. If the value is 9, daylight savings time shall begin on the <beginDayOfMonth> <beginMonth>. For example, if the value of this object is 2, the value of fdClockDstBeginDayOfWeek is 7, fdClockDstBeginDayOfMonth is 8 and fdClockDstBeginMonth is 3; daylight savings time would begin on the <second> <Sunday> on or after <8> <March>.

Identifies the day of week on which daylight savings time begins.

Identifies the day of the fdClockDstBeginMonth from which to calculate the start date of daylight savings. See fdClockDstBeginOccurrences for more details.

Indicates the nominal (local) time of day when the offset shall be applied in milliseconds past midnight. The nominal milliseconds past midnight may be different than actual milliseconds past midnight if the fdClockLocalTime was adjusted for any reason (e.g., another entry in this table).

The month that is combined with fdClockDstEndDayOfMonth to determine the base date used to calculate the end of daylight savings time using other object values in this row. This is often the month in which daylight savings time ends, but may not be. For example, if the value of this object is December, endDayOfMonth is 31, and endOccurences is 'second'; daylight savings time will end in January of the following year.

If the value is 1-4, daylight savings time shall end on the <named value of this object> <endDayOfWeek> on or after <endDayOfMonth> <endMonth>. If the value is 5-8, daylight savings time shall end on the <named value of this object> <endDayOfWeek> on or before <endDayOfMonth> <endMonth>. If the value is 9, daylight savings time shall end on the <endDayOfMonth> of <endMonth>.

Identifies the day of week on which daylight savings time ends.

The day of the month from which to calculate the end of daylight savings time per the rules defined in endOccurrences.

Indicates the time of day when the offset specified in this row shall be removed (if it is currently applied). For example, if the value of this object is 1800000 and offset is 3600000, the daylight savings time offset will be removed at the first instance of 00:30 on the identified end date. Removing the offset in this case would cause the local time to fall back to 23:30 on the previous day and then the clock would run normally.

The number of seconds to advance the local clock when this row of daylight savings time is in effect. The total adjustment made to the local clock shall be the sum of all rows where the daylight savings time is in effect.

Indicates whether the offset defined by the row is currently applied.

The type of memory in which this entry is stored.

The status of this conceptual row. The value of this object shall be 'notReady' whenever the offset for this row is set to zero (0). Setting this object to 'notInService' while the offset defined by this row is currently applied will immediately remove the offset (adjusting the local time). Setting this object to 'active' shall immediately cause the offset to be applied per the rules defined by this row of the table as if the row had been active the entire time. The other objects in this row may not be modified while the value of this object is 'active'. An attempt to set any other object in this row while this object is 'active' shall result in an inconsistentValue error.

A node containing conformance statements related to the fdClockMIB, as defined in ISO/TS 20684-7.

A node for compliance statements for the fdClockMIB.

A node for group definitions related to fdClockMIB.

An implementation that supports a local clock may support DST settings.

Management information that identifies the capabilities of the UTC Clock.

Management information used to configure the Local Clock.

Management information that describes the capabilities of the daylight saving time (a.k.a. summer time) feature of the Local Clock.