| ipmi_sim_cmd(5) | IPMI LAN Simulator commands | ipmi_sim_cmd(5) |
The ipmi_sim emulation is set up using these commands. They can be read from a command file, run from the command line, or executed inside the simulator after it is started.
This may be a little confusing, but the network interfaces are configured by the ipmi_lan configuration file, and the various management controllers, sensors, etc. are specified using this file. Plus, this can be used to configure the simulator after it is up, set sensor values, inject events, and things of that nature.
Blank lines and lines starting with `#' are ignored. Long lines may be broken up by putting a '´ at the end of the line to be continued.
Define the given name as a variable with the given value. This variable may be used later by doing $name. This cannot be used in quotes, but quotes may be broken up and the variable put between them. For instance, if you say:
define MCNUM "40"
you can use it later as in
mc_add $MCNUM 1 no-device-sdrs 00 00 00 0xc9 0x009000 0x0002
or
sensor_add $MCNUM 0 21 12 0x6f poll 1000 file "/sys/dev/sens1-"$MCNUM"-1"
msg Dump messages.
raw Dump raw I/O
Entering nothing turns of debugging.
Note that some of these values control the capabilities of the MC. For instance, HasDeviceSDRs sets whether device SDR repository commands will work.
You may use has-device-sdrs or no-device-sdrs in the HasDeviceSDRs field.
Add a sensor to the given MC and LUN. The type of sensor is set by the event reading code.
If poll is specified, then the sensor will be polled for data. Only the file poll type is currently supported. The value is a number read from a file. It has the following options, all optional:
div=val will divide the read value by the given number. This is done after the multiply operation.
mult=val will multiply the read value by the given number. This is done after the subtraction.
sub=val will subtract the value by the given number. This is done after the mask.
mask=val will mask (bitwise and) the value by the given number.
base=value Specify the base of the value read from the file. By default this is zero, meaning "C" conventions are used.
initstate=value sets what the event state is initially set to. This is useful for discrete sensors with bits that should normally be set to "1", like a presence bit, to keep the program from issuing an event every time the program starts.
raw specifies that the data from the file is a raw value. Only length bytes are read from offset.
ascii specifies that the data from the file is in ASCII. This is the default. The offset value is used, but no the length.
length=val specifies the length of the data to read from the file. The maximum value is 4,and this is only used for raw data.
depends=<mc_addr>,<lun>,<sensor_number>,<bit> specifies a discrete sensor bit that must be set to 1 for the sensor to be active. Generally, you use the presence bit of a sensor to mark whether other sensors on the device are actually present. Each of the other sensors would have one of these pointing to the presence bit.
event-only specifies that the sensor will not be readable, it will only generate events (specified with a type 3 SDR).
The support value may also be none, readable, settable, or fixed instead of the numbers.
Set the threshold support for a sensor. It must be an analog sensor. The threshold-support value is the same as the threshold access support value in the sensor SDR. The threshold-enabled values is a string of ``0'' and ``1'' characters that enable the 6 corresponding thresholds; the rightmost value is value 0, the leftmost is value 5. Optionally, the threshold values may be specified as their byte values.
The threshold-support value may also be none, readable, settable, or fixed to make it a bit more readable. The thresholds are:
0 - lower non critical
1 - lower critical
2 - lower non recoverable
3 - upper non critical
4 - upper critical
5 - upper non recoverable
Set the event support of a sensor. The events-enable will enable global events on the sensor if non-zero, otherwise they are disabled. The scanning values set the scanning value for the sensor. The event-support value sets the event capabilities in the sensor, this is the same as the ``sensor event message control support'' value in the sensor SDR. The assert-support, deassert-support, assert-enabled, and deassert-enabled are all bitmasks (a string of ``0'' and ``1'' characters) that set their corresponding sensor bit's capability to generate events (support) and whether it will generate events now (enabled).
Note that all bitmasks have the rightmost digit as the zeroth bit, and the leftmost digit as the highest order bit. Note that you must specify 15 bits here, even if you don't use all of them.
Note that you may use enable or disable in the events-enable field, and you may use scanning or no-scanning in the scanning field.
For event-support, you may use per-state, entire-sensor, global or none instead of a number.
For a threshold sensor, the values are:
0
- lower non-critical going low
1
- lower non-critical going high
2
- lower critical going low
3
- lower critical going high
4
- lower non-recoverable going low
5
- lower non-recoverable going high
6
- upper non-critical going low
7
- upper non-critical going high
8
- upper critical going low
9
- upper critical going high
1
- upper non-recoverable going low
1
- upper non-recoverable going high
Note that the "lower going high" and "upper going low" values are not supported, since they are simply stupid.
These are for emulation of special ATCA capabilities.
Note that you should do this *before* creating any MCs (this should really be first) because the MCs are set up a little differently for ATCA mode. This causes the MCs to be able to handle PICMG commands properly, sets up 2 LEDs by default, and enables proper hot-swap handling, including the blue LED. By default the blue LED supports local control and the other LEDs do not and are red.
In ATCA mode, to drive the hot-swap state machine, you should use sensor_set_bit_clr_rest to set the hot-swap state.
/etc/ipmi/lan.conf
IPMI is unnecessarily complicated. Hords of capabilities are not yet implemented.
Corey Minyard <cminyard@mvista.com>
| 06/26/12 | OpenIPMI |