share/man/man4/man4.sparc64/eeprom.4

   1 .\"-
   2 .\" Copyright (c) 2004 Jason L. Wright (jason@thought.net)
   3 .\" Copyright (c) 2005 Marius Strobl <marius@FreeBSD.org>
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  17 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  18 .\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
  19 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  20 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  21 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  23 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  24 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .\"     from: OpenBSD: clock.4,v 1.3 2004/09/24 07:04:15 miod Exp
  28 .\" $FreeBSD$
  29 .\"
  30 .Dd June 18, 2005
  31 .Dt EEPROM 4 sparc64
  32 .Os
  33 .Sh NAME
  34 .Nm eeprom
  35 .Nd "non-volatile RAM / real time clock"
  36 .Sh SYNOPSIS
  37 .Cd "device genclock"
  38 .Cd "device mk48txx"
  39 .Cd "device eeprom"
  40 .Sh DESCRIPTION
  41 The
  42 .Nm
  43 driver is a front-end for the machine-independent
  44 .Tn Mostek
  45 MK48Txx driver.
  46 The
  47 .Tn Mostek
  48 MK48Txx driver provides access to the real time clock part of the chips it
  49 supports to
  50 .Fx
  51 by interfacing with the generic clock code.
  52 .Pp
  53 .Tn Mostek
  54 MK48Txx chips are found on the
  55 .Tn EBus ,
  56 .Tn FireHose
  57 and
  58 .Tn SBus
  59 busses of
  60 .Tn UltraSPARC
  61 systems.
  62 On systems where the hostid is stored in the NVRAM part of the Mostek MK48Txx
  63 chip the
  64 .Nm
  65 driver prints out the hostid on attach.
  66 .Sh DIAGNOSTICS
  67 The following driver specific error message may be reported:
  68 .Bl -diag
  69 .It "mk48txx_attach: battery low"
  70 The device signals that its battery is low and should be replaced.
  71 The
  72 .Nm
  73 driver refused to attach the device in this case as the time in the real time
  74 clock is probably invalid.
  75 This gives the generic clock code the chance to use another device as the
  76 system real time clock that otherwise would not have been chosen.
  77 .El
  78 .Sh SEE ALSO
  79 .Xr ebus 4 ,
  80 .Xr fhc 4 ,
  81 .Xr rtc 4 ,
  82 .Xr sbus 4
  83 .Sh HISTORY
  84 The
  85 .Nm
  86 driver first appeared in
  87 .Fx 5.0 .
  88 .Sh AUTHORS
  89 .An -nosplit
  90 The
  91 .Nm
  92 driver was written by
  93 .An "Thomas Moestl" Aq tmm@FreeBSD.org
  94 based on the
  95 .Nx
  96 sparc64 clock code written by
  97 .An "Paul Kranenburg" .