Page 3 - Contents; Preface
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 U...
Page 4 - User Flash
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 t...
Page 5 - Figures
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
Page 7 - Tables
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 Environm...
Page 9 - Code Samples
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...
Page 11 - The; How This Book Is Organized; Chapter 1
xi Preface The Netra CP2500 Board Programming Guide is written for program developers and users who want to program the Netra ™ CP2500 board in order to design original equipment manufacturer (OEM) systems, supply additional capability to an existingcompatible system, or work in a laboratory environ...
Page 12 - Using UNIX Commands; su
xii Netra CP2500 Board Programming Guide • March 2007 Using UNIX Commands This document may not contain information on basic UNIX ® commands and procedures such as shutting down the system, booting the system, and configuringdevices. See one or more of the following for this information: ■ Solaris H...
Page 13 - Shell Prompts; Online documents are available at:
Preface xiii Shell Prompts Related Documentation Online documents are available at: http://www.sun.com/documentation Shell Prompt C shell machine-name % C shell superuser machine-name # Bourne shell and Korn shell $ Bourne shell and Korn shell superuser # Title Part Number Netra CP2500 Board Release...
Page 14 - Third-Party Web Sites; Netra CP2500 Board Programming Guide
xiv Netra CP2500 Board Programming Guide • March 2007 Documentation, Support, and Training Third-Party Web Sites Sun is not responsible for the availability of third-party web sites mentioned in thisdocument. Sun does not endorse and is not responsible or liable for any content,advertising, products...
Page 15 - Watchdog Timer; This chapter contains the following sections:; Overview; pats
1 C H A P T E R 1 Watchdog Timer The system management controller (SMC) on the Netra CP2500 implements awatchdog service that captures catastrophic faults in the Solaris OS running on theCPU board. The watchdog service reports such faults to the baseboard managementcontroller (BMC) by means of eithe...
Page 16 - Note –; picld
2 Netra CP2500 Board Programming Guide • March 2007 PICL Plug-In Module The watchdog subsystem is managed by a platform information and control library(PICL) plug-in module. This PICL plug-in module provides a set of PICL propertiesto the system, which enables a Solaris PICL client to specify the at...
Page 17 - PICL interfaces for the watchdog plug-in module include the nodes
Chapter 1 Watchdog Timer 3 PICL interfaces for the watchdog plug-in module include the nodes watchdog- controller and watchdog-timer . See TABLE 1-1 , TABLE 1-2 , and TABLE 1-3 for descriptions of the properties of these nodes. TABLE 1-1 Watchdog Plug-In Interfaces for Netra CP2500 Board Software PI...
Page 19 - Watchdog Node Management Code; contains an example of the code used for managing the watchdog
Chapter 1 Watchdog Timer 5 Watchdog Node Management Code CODE EXAMPLE 1-1 contains an example of the code used for managing the watchdog timer nodes. This code can be used to change watchdog timer action and timeoutvalues and also to arm and disarm the watchdog controller. :_class watchdog-timer :na...
Page 35 - OpenBoot PROM Interface; There is no user interface to the watchdog timer at the OpenBoot
Chapter 1 Watchdog Timer 21 OpenBoot PROM Interface There is no user interface to the watchdog timer at the OpenBoot ™ PROM level. When the Netra CP2500 board is in the host slot of a Netra CT 810 or 410 server, theOpenBoot PROM configures the watchdog timer automatically. The watchdog timeris armed...
Page 37 - Environmental Monitoring; This chapter includes the following sections:
23 C H A P T E R 2 Environmental Monitoring The Netra CP2500 board uses an intelligent fault detection environmentalmonitoring system that increases uptime and manageability of the board. Thesystem management controller (SMC) module on the Netra CP2500 supports thetemperature and voltage environment...
Page 41 - Post Shutdown Recovery
Chapter 2 Environmental Monitoring 27 Protection at the operating system level takes place when the PICL environmentalmonitoring program ( envmond ) is running. The environmental monitoring program is part of a UNIX daemon that runs automatically when the Solaris OS boots up. In a typical environmen...
Page 43 - is a block diagram of the environmental monitoring functions.
Chapter 2 Environmental Monitoring 29 FIGURE 2-2 Location of Environmental Monitoring Hardware on the Netra CP2500 Board – Top Side FIGURE 2-3 is a block diagram of the environmental monitoring functions.
Page 45 - Switching Power On and Off
Chapter 2 Environmental Monitoring 31 Switching Power On and Off The on-board voltage controller allows power to the CPU of the Netra CP2500 onlywhen the following conditions are met: ■ The VDD core-1.1-volt supply voltage is greater than 1.0 volts (within 10% ofnominal). ■ The 12-volt supply voltag...
Page 47 - If you have developed an application that uses the environmental; Warning Temperature Response at OpenBoot PROM; ok; Critical Temperature Response at OpenBoot PROM; prompt at a regular interval:
Chapter 2 Environmental Monitoring 33 Note – If you have developed an application that uses the environmental monitoring software to monitor the temperature sensors, you may want to adjustyour application’s settings accordingly. OpenBoot PROM EnvironmentalMonitoring This section describes the OpenBo...
Page 49 - libpicl
Chapter 2 Environmental Monitoring 35 The environmental monitoring parameter values in the application program applywhen the system is running at the Solaris level and do not necessarily have to be thesame as the default settings programmed by the SMC and used by the OpenBootPROM. The OpenBoot PROM ...
Page 50 - Using a Configuration File for Sensor Information; Sample entries in the; Solaris Driver Interface; The PICL
36 Netra CP2500 Board Programming Guide • March 2007 Using a Configuration File for Sensor Information On the Netra CP2500, you can enable or disable sensors, and configure sensorthreshold actions, such as shutdown and reboot, by editing the /etc/picl/config/envmond.conf file. Sample entries in the ...
Page 51 - Sample Application Program; This section presents a sample environmental monitoring (
Chapter 2 Environmental Monitoring 37 Sample Application Program This section presents a sample environmental monitoring ( envmond ) application that monitors the CPU diode temperature. CODE EXAMPLE 2-1 Sample envmond Application Program /* * sensor_readwrite.c * * compile: cc sensor_readwrite.c -lt...
Page 55 - prtpicl
Chapter 2 Environmental Monitoring 41 Reading the CPU Temperature andEnvironmental Limits You can access the CPU temperature sensor current readings and environmentalmonitoring settings from the Solaris prompt by typing the following commands.Sample output is listed after each command. prtpicl comma...
Page 56 - shows which Solaris commands correspond to the environmental
42 Netra CP2500 Board Programming Guide • March 2007 TABLE 2-5 shows which Solaris commands correspond to the environmental monitoring warning that runs when the CPU temperature exceeds the set limit. TABLE 2-5 Description of Values Displayed by Solaris Commands Environmental Monitoring Warning prtp...
Page 57 - “User Flash Usage and Implementation” on page 43; User Flash Usage and Implementation; Installation and Technical Reference Manual
43 C H A P T E R 3 User Flash This chapter describes the user flash driver for the onboard flash PROM and how touse it. The Netra CP2500 is equipped with user flash memory. This chapter includesthe following sections: ■ “User Flash Usage and Implementation” on page 43 ■ “User Flash Driver” on page 4...
Page 58 - User Flash Driver; uflash; OpenBoot PROM Device Tree and Properties
44 Netra CP2500 Board Programming Guide • March 2007 User Flash Driver The uflash is the device driver for the flash PROM device on the Netra CP2500. Access to the driver is carried out through open , read , write , pread , pwrite and ioctl system interfaces. On the Netra CP2500, one device is suppo...
Page 59 - User Flash Device Files; The user flash device file is; Application Programming Interface; read
Chapter 3 User Flash 45 User Flash Device Files The user flash device file is /dev/uflash0 . Interface (Header) File The user flash header file is located in the following path: /usr/ platform /SUNW,Netra-CP2500/include/sys/uflash_if.h Application Programming Interface Access to the user flash devic...
Page 60 - Structures to Use in IOCTL Arguments
46 Netra CP2500 Board Programming Guide • March 2007 The ioctl supported commands are listed below: Note that these ioctl commands are not supported: Structures to Use in IOCTL Arguments PROM Information Structure The PROM information structure holds device information returned by the driver inrespo...
Page 61 - User Flash User Interface Structure; erase; Errors; Example Programs; Read
Chapter 3 User Flash 47 User Flash User Interface Structure The user flash user interface structure holds user parameters to commands such as erase . Errors Example Programs Example programs are provided in this section for the following actions on userflash device: ■ Read CODE EXAMPLE 3-2 User Flas...
Page 62 - Read Example Program; contains the Read Action on the user flash device.
48 Netra CP2500 Board Programming Guide • March 2007 ■ Write ■ Block Erase Read Example Program CODE EXAMPLE 3-3 contains the Read Action on the user flash device. CODE EXAMPLE 3-3 Read Action on User Flash Device /* * uflash_read.c * An example that shows how to read user flash */ #include <sys/...
Page 63 - Write Example Program; contains the Write Action on the user flash device.
Chapter 3 User Flash 49 Write Example Program CODE EXAMPLE 3-4 contains the Write Action on the user flash device. printf("number of blocks = 0x%p", ufif0.info.blk_num); printf("block size = 0x%p" ufif0.info.blk_size); } static int uflash_uninit() { if (ufd0) close(ufd0); cleanup: if...
Page 65 - Block Erase Example Program; contains the Block Erase Action on the user flash device.
Chapter 3 User Flash 51 Block Erase Example Program CODE EXAMPLE 3-5 contains the Block Erase Action on the user flash device. } main() { int ret; module = argv[0]; ret = uflash_init(); if (!ret) uflash_write(); uflash_uninit(); } CODE EXAMPLE 3-5 Block Erase Action on User Flash Device /* * uflash_...
Page 73 - Index
59 Index B boot, Solaris OS, 21 C commands prtdiag , 41, 42 prtpicl , 4, 35, 41, 42 show-sensors , 34 critical-temperature parameter, 33 D device node, 44dip switch, 43documentation, related, xiii E environmental monitoring, 23 to 42 application block diagram, 24application program, 34functional blo...
