Sun Microsystems Netra CP2500 Mode d'emploi

Sun Microsystems, Inc.
www.sun.com
Submit comments about this document at: http://www.sun.com/hwdocs/feedback
Netra™CP2500 Board
Programming Guide
For the Solaris™Operating System
Part No. 819-1749-11
March 2007, Revision A

Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology that is described in this document. In particular, and without
limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or
more additional patents or pending patent applications in the U.S. and in other countries.
This document and the product to which it pertains are distributed under licenses restricting their use, copying, distribution, and
decompilation. No part of the product or of this document may be reproduced in any form by any means without prior written authorization of
Sun and its licensors, if any.
Third-party software, including font technology, is copyrighted and licensed from Sun suppliers.
Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in
the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd.
Sun, Sun Microsystems, the Sun logo, AnswerBook2, docs.sun.com, Netra, OpenBoot, and Solaris are trademarks or registered trademarks of
Sun Microsystems, Inc. in the U.S. and in other countries.
All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and in other
countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc.
The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges
the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun
holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN
LOOK GUIs and otherwise comply with Sun’s written license agreements.
U.S. Government Rights—Commercial use. Government users are subject to the Sun Microsystems, Inc. standard license agreement and
applicable provisions of the FAR and its supplements.
DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.
Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, Californie 95054, Etats-Unis. Tous droits réservés.
Sun Microsystems, Inc. a les droits de propriété intellectuels relatants à la technologie qui est décrit dans ce document. En particulier, et sans la
limitation, ces droits de propriété intellectuels peuvent inclure un ou plus des brevets américains énumérés à http://www.sun.com/patents et
un ou les brevets plus supplémentaires ou les applications de brevet en attente dans les Etats-Unis et dans les autres pays.
Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la
décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans
l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y ena.
Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des
fournisseurs de Sun.
Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque
déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company, Ltd.
Sun, Sun Microsystems, le logo Sun, AnswerBook2, docs.sun.com, Netra, OpenBoot, et Solaris sont des marques de fabrique ou des marques
déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays.
Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc.
aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun
Microsystems, Inc.
L’interface d’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun
reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d’utilisation visuelle ou graphique
pour l’industrie de l’informatique. Sun détient une license non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence
couvrant également les licenciées de Sun qui mettent en place l’interface d ’utilisation graphique OPEN LOOK et qui en outre se conforment
aux licences écrites de Sun.
LA DOCUMENTATION EST FOURNIE "EN L’ÉTAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES
OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT
TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L’APTITUDE A UNE UTILISATION PARTICULIERE OU A
L’ABSENCE DE CONTREFAÇON.

iii
Contents
Preface xi
1. Watchdog Timer 1
Overview 1
PICL Plug-In Module 2
Watchdog Node Management Code 5
OpenBoot PROM Interface 21
2. Environmental Monitoring 23
Environmental Monitoring Component Compatibility 24
Typical Environmental Monitoring System Application 24
Typical Cycle From Power Up to Shutdown 26
Environmental Monitoring Protection at the OpenBoot PROM 26
Environmental Monitoring Protection at the Operating System Level 26
Post Shutdown Recovery 27
Hardware Environmental Monitoring Functions 28
Switching Power On and Off 31
Inlet, Exhaust, and CPU Temperature Monitoring 31
Adjusting the Environmental Monitoring Warning, Critical, and Shutdown
Parameter Settings on the Board 32
OpenBoot PROM Environmental Monitoring 33

iv Netra CP2500 Board Programming Guide • March 2007
Warning Temperature Response at OpenBoot PROM 33
Critical Temperature Response at OpenBoot PROM 33
Using the show-sensors Command at the OpenBoot PROM 34
Environmental Monitoring Application Programming 34
Reading Temperature Sensor States Using the PICL API 35
Using a Configuration File for Sensor Information 36
Solaris Driver Interface 36
Sample Application Program 37
Reading the CPU Temperature and Environmental Limits 41
3. User Flash 43
User Flash Usage and Implementation 43
User Flash Driver 44
OpenBoot PROM Device Tree and Properties 44
User Flash Device Files 45
Interface (Header) File 45
Application Programming Interface 45
Structures to Use in IOCTL Arguments 46
PROM Information Structure 46
User Flash User Interface Structure 47
Errors 47
Example Programs 47
Read Example Program 48
Write Example Program 49
Block Erase Example Program 51
Sample User Flash Application Program 53
Index 59

v
Figures
FIGURE 2-1 Typical Environmental Monitoring Application Block Diagram 25
FIGURE 2-2 Location of Environmental Monitoring Hardware on the Netra CP2500 Board – Top Side 29
FIGURE 2-3 Netra CP2500 Board Environmental Monitoring Functional Block Diagram 30

vi Netra CP2500 Board Programming Guide • March 2007

vii
Tables
TABLE 1-1 Watchdog Plug-In Interfaces for Netra CP2500 Board Software 3
TABLE 1-2 Properties Under watchdog-controller Node 3
TABLE 1-3 Properties Under watchdog-timer Node 4
TABLE 2-1 Compatible Environmental Monitoring Components 24
TABLE 2-2 Typical Netra CP2500 Board Hardware Environmental Monitoring Functions 28
TABLE 2-3 I2C Components 28
TABLE 2-4 PICL Temperature Sensor Class Node Properties 35
TABLE 2-5 Description of Values Displayed by Solaris Commands 42
TABLE 3-1 User Flash Node Properties 44
TABLE 3-2 System Calls 45

viii Netra CP2500 Board Programming Guide • March 2007

ix
Code Samples
CODE EXAMPLE 1-1 System Watchdog Node Management Code Example 5
CODE EXAMPLE 2-1 Sample envmond Application Program 37
CODE EXAMPLE 3-1 PROM Information Structure 46
CODE EXAMPLE 3-2 User Flash Interface Structure 47
CODE EXAMPLE 3-3 Read Action on User Flash Device 48
CODE EXAMPLE 3-4 Write Action on User Flash Device 49
CODE EXAMPLE 3-5 Block Erase Action on User Flash Device 51
CODE EXAMPLE 3-6 Sample User Flash Application Program 53

xNetra CP2500 Board Programming Guide • March 2007
Table des matières
Autres manuels Sun Microsystems Carte mère

Sun Microsystems
Sun Microsystems SPARCengine Ultra AXi Manuel

Sun Microsystems
Sun Microsystems SPARCengine Ultra AXi Manuel utilisateur

Sun Microsystems
Sun Microsystems SunSwift SPARCserver 1000 Manuel utilisateur

Sun Microsystems
Sun Microsystems SPARCcenter 2000 Manuel utilisateur

Sun Microsystems
Sun Microsystems F815D Series Manuel utilisateur
Manuels Carte mère populaires d'autres marques

Telit Wireless Solutions
Telit Wireless Solutions SL869-3DR Manuel utilisateur

Gigabyte
Gigabyte GA-9IVDT Manuel utilisateur

Texas Instruments
Texas Instruments ADS8372EVM Manuel utilisateur

Commell
Commell MS-C73 Manuel utilisateur

IBT Technologies
IBT Technologies MB860 Manuel utilisateur

Nvidia
Nvidia TEGRA DG-04927-001_V01 Manuel utilisateur











