#!/usr/bin/env python3 # Copyright (c) 2014 Kontron Europe GmbH # # This library is free software; you can redistribute it and/or # modify it under the terms of the GNU Lesser General Public # License as published by the Free Software Foundation; either # version 2.1 of the License, or (at your option) any later version. # # This library is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public # License along with this library; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA from __future__ import print_function import sys import getopt import json import logging import traceback import pprint from array import array from collections import namedtuple import pyipmi import pyipmi.interfaces from pyipmi.utils import py3_array_tobytes json_output = False Command = namedtuple('Command', 'name fn') CommandHelp = namedtuple('CommandHelp', 'name arguments help') def _print(s): print(s) def _get_command_function(name): for cmd in COMMANDS: if cmd.name == name: return cmd.fn return None def cmd_bmc_info(ipmi, args): device_id = ipmi.get_device_id() print(''' Device ID: %(device_id)s Device Revision: %(revision)s Firmware Revision: %(fw_revision)s IPMI Version: %(ipmi_version)s Manufacturer ID: %(manufacturer_id)d (0x%(manufacturer_id)04x) Product ID: %(product_id)d (0x%(product_id)04x) Device Available: %(available)d Provides SDRs: %(provides_sdrs)d Additional Device Support: '''[1:-1] % device_id.__dict__) functions = ( ('SENSOR', 'Sensor Device'), ('SDR_REPOSITORY', 'SDR Repository Device'), ('SEL', 'SEL Device'), ('FRU_INVENTORY', 'FRU Inventory Device'), ('IPMB_EVENT_RECEIVER', 'IPMB Event Receiver'), ('IPMB_EVENT_GENERATOR', 'IPMB Event Generator'), ('BRIDGE', 'Bridge'), ('CHASSIS', 'Chassis Device') ) for n, s in functions: if device_id.supports_function(n): print(' %s' % s) if device_id.aux is not None: print('Aux Firmware Rev Info: [{:s}]'.format( ' '.join('%02x' % d for d in device_id.aux))) def cmd_sel_clear(ipmi, args): ipmi.clear_sel() def cmd_sensor_rearm(ipmi, args): if len(args) < 1: return number = int(args[0], 0) ipmi.rearm_sensor_events(number) def sdr_show(ipmi, s): print("SDR record ID: 0x%04x" % s.id) print("SDR type: 0x%02x" % s.type) print("Device Id string: %s" % s.device_id_string) print("Entity: %s.%s" % (s.entity_id, s.entity_instance)) if s.type is pyipmi.sdr.SDR_TYPE_FULL_SENSOR_RECORD: (raw, states) = ipmi.get_sensor_reading(s.number, s.owner_lun) value = s.convert_sensor_raw_to_value(raw) if value is None: value = "na" t_unr = s.convert_sensor_raw_to_value(s.threshold['unr']) t_ucr = s.convert_sensor_raw_to_value(s.threshold['ucr']) t_unc = s.convert_sensor_raw_to_value(s.threshold['unc']) t_lnc = s.convert_sensor_raw_to_value(s.threshold['lnc']) t_lcr = s.convert_sensor_raw_to_value(s.threshold['lcr']) t_lnr = s.convert_sensor_raw_to_value(s.threshold['lnr']) print("Reading value: %s" % value) print("Reading state: 0x%x" % states) print("UNR: %s" % t_unr) print("UCR: %s" % t_ucr) print("UNC: %s" % t_unc) print("LNC: %s" % t_lnc) print("LCR: %s" % t_lcr) print("LNR: %s" % t_lnr) elif s.type is pyipmi.sdr.SDR_TYPE_COMPACT_SENSOR_RECORD: (raw, states) = ipmi.get_sensor_reading(s.number) print("Reading: %s" % raw) print("Reading state: 0x%x" % states) def cmd_sdr_show_raw(ipmi, args): if len(args) != 1: usage() return try: sdr = ipmi.get_device_sdr(int(args[0], 0)) print(' '.join(['0x%02x' % b for b in sdr.data])) except ValueError: print('') def cmd_sdr_show(ipmi, args): if len(args) != 1: usage() return try: s = ipmi.get_device_sdr(int(args[0], 0)) sdr_show(ipmi, s) except ValueError: print('') def cmd_sdr_show_all(ipmi, args): for s in ipmi.device_sdr_entries(): try: sdr_show(ipmi, s) except ValueError: print('') print("\n") def print_sdr_list_entry(record_id, number, id_string, value, states): if number: number = str(number) else: number = 'na' if states: states = hex(states) else: states = 'na' print("0x%04x | %3s | %-18s | %9s | %s" % (record_id, number, id_string, value, states)) def cmd_sdr_list(ipmi, args): iter_fct = None device_id = ipmi.get_device_id() if device_id.supports_function('sdr_repository'): iter_fct = ipmi.sdr_repository_entries elif device_id.supports_function('sensor'): iter_fct = ipmi.device_sdr_entries print("SDR-ID | | Device String |") print("=======|=====|====================|====================") for s in iter_fct(): try: number = None value = None states = None if s.type is pyipmi.sdr.SDR_TYPE_FULL_SENSOR_RECORD: (value, states) = ipmi.get_sensor_reading(s.number) number = s.number if value is not None: value = s.convert_sensor_raw_to_value(value) elif s.type is pyipmi.sdr.SDR_TYPE_COMPACT_SENSOR_RECORD: (value, states) = ipmi.get_sensor_reading(s.number) number = s.number id_string = getattr(s, 'device_id_string', None) print_sdr_list_entry(s.id, number, id_string, value, states) except pyipmi.errors.CompletionCodeError as e: if s.type in (pyipmi.sdr.SDR_TYPE_COMPACT_SENSOR_RECORD, pyipmi.sdr.SDR_TYPE_FULL_SENSOR_RECORD): print('0x{:04x} | {:3d} | {:18s} | ERR: CC=0x{:02x}'.format( s.id, s.number, s.device_id_string, e.cc)) def cmd_fru_print(ipmi, args): fru_id = 0 print_all = False if len(args) > 0: fru_id = int(args[0]) if len(args) > 1 and args[1] == 'all': print_all = True inv = ipmi.get_fru_inventory(fru_id) # Chassis Info Area area = inv.chassis_info_area if area: print(''' Chassis Info Area: Type: %(type)d Part Number: %(part_number)s Serial Number: %(serial_number)s '''[1:-1] % area.__dict__) if len(area.custom_chassis_info) != 0: print(' Custom Chassis Info Records:') for field in area.custom_chassis_info: print(' %s' % field) # Board Info Area area = inv.board_info_area if area: print(''' Board Info Area: Mfg. Date / Time: %(mfg_date)s Manufacturer: %(manufacturer)s Product Name: %(product_name)s Serial Number: %(serial_number)s Part Number: %(part_number)s FRU File ID: %(fru_file_id)s '''[1:-1] % area.__dict__) if len(area.custom_mfg_info) != 0: print(' Custom Board Info Records:') for field in area.custom_mfg_info: print(' %s' % field) # Product Info Area area = inv.product_info_area if area: print(''' Product Info Area: Manufacturer: %(manufacturer)s Name: %(name)s Part/Model Number: %(part_number)s Version: %(version)s Serial Number: %(serial_number)s Asset: %(asset_tag)s FRU File ID: %(fru_file_id)s '''[1:-1] % area.__dict__) if len(area.custom_mfg_info) != 0: print(' Custom Board Info Records:') for field in area.custom_mfg_info: print(' %s' % field) # Multirecords area = inv.multirecord_area if area: print('Multirecord Area:') if print_all: for record in area.records: print(' %s' % record) else: print(' Skipped. Use "print all"') def cmd_raw(ipmi, args): lun = 0 if len(args) > 1 and args[0] == 'lun': lun = int(args[1], 0) args = args[2:] if len(args) < 2: usage() return netfn = int(args[0], 0) raw_bytes = array('B', [int(d, 0) for d in args[1:]]) rsp = ipmi.raw_command(lun, netfn, py3_array_tobytes(raw_bytes)) print(' '.join('%02x' % d for d in array('B', rsp))) def cmd_hpm_capabilities(ipmi, args): cap = ipmi.get_target_upgrade_capabilities() for c in cap.components: properties = ipmi.get_component_properties(c) print("Component ID: %d" % c) for prop in properties: print(" %s" % prop) def cmd_hpm_check_file(ipmi, args): if len(args) < 1: return cap = ipmi.open_upgrade_image(args[0]) print(cap.header) for action in cap.actions: print(action) def cmd_hpm_install(ipmi, args): if len(args) < 2: print('missing argument') return ipmi.install_component_from_file(args[0], int(args[1])) def cmd_chassis_status(ipmi, args): status = ipmi.get_chassis_status() if json_output: status = { 'power_on': status.power_on, 'overload': status.overload, 'interlock': status.interlock, 'fault': status.fault, 'ctrl_fault': status.control_fault, 'restore_policy': status.restore_policy } print(json.dumps(status)) pass else: print(''' Power ON: %(power_on)s Overload: %(overload)s Interlock: %(interlock)s Fault: %(fault)s Ctrl Fault: %(control_fault)s Restore Policy: %(restore_policy)s '''[1:-1] % status.__dict__) for event in status.last_event: print(event) for state in status.chassis_state: print(state) def cmd_picmg_get_power(ipmi, args): pwr = ipmi.get_power_level(0, 0) print(pwr) def print_link_state(p, s): intf_str = pyipmi.picmg.LinkDescriptor().get_interface_string(p.interface) link_str = pyipmi.picmg.LinkDescriptor().get_link_type_string( p.type, p.extension, p.sig_class) print('CH=%02d INTF=%d FLAGS=0x%x TYPE=%d SIG=%d EXT=%d STATE=%d (%s/%s)' % (p.channel, p.interface, p.link_flags, p.type, p.sig_class, p.extension, s, intf_str, link_str)) def cmd_picmg_get_portstate_all(ipmi, args): for interface in range(3): for channel in range(16): try: (p, s) = ipmi.get_port_state(channel, interface) print_link_state(p, s) except pyipmi.errors.CompletionCodeError as e: if e.cc == 0xcc: continue def cmd_picmg_get_portstate(ipmi, args): if len(args) < 2: return channel = int(args[0]) interface = int(args[1]) (p, s) = ipmi.get_port_state(channel, interface) print_link_state(p, s) def cmd_picmg_getpower_channel_status(ipmi, args): ret = ipmi.get_power_channel_status(int(args[0])) pprint.pprint(vars(ret)) def cmd_picmg_frucontrol_cold_reset(ipmi, args): ipmi.fru_control_cold_reset(0) def cmd_picmg_send_pm_heartbeat(ipmi, args): ipmi.send_pm_heartbeat() def cmd_picmg_send_channel_power(ipmi, args): ipmi.send_channel_power(int(args[0])) def usage(toplevel=False): commands = [] maxlen = 0 if toplevel: argv = [] else: argv = sys.argv[1:] # (1) try to find help for commands on exactly one level above for cmd in COMMAND_HELP: subcommands = cmd.name.split(' ') if (len(subcommands) == len(argv) + 1 and subcommands[:len(argv)] == argv): commands.append(cmd) if cmd.arguments: maxlen = max(maxlen, len(cmd.name)+len(cmd.arguments)+1) else: maxlen = max(maxlen, len(cmd.name)) # (2) if nothing found, try to find help on any level above if maxlen == 0: for cmd in COMMAND_HELP: subcommands = cmd.name.split(' ') if (len(subcommands) > len(argv) + 1 and subcommands[:len(argv)] == argv): commands.append(cmd) if cmd.arguments: maxlen = max(maxlen, len(cmd.name)+len(cmd.arguments)+1) else: maxlen = max(maxlen, len(cmd.name)) # (3) find help on same level if maxlen == 0: for cmd in COMMAND_HELP: subcommands = cmd.name.split(' ') if (len(subcommands) == len(argv) and subcommands[:len(argv)] == argv): commands.append(cmd) if cmd.arguments: maxlen = max(maxlen, len(cmd.name)+len(cmd.arguments)+1) else: maxlen = max(maxlen, len(cmd.name)) # if still nothing found, print toplevel usage if maxlen == 0: usage(toplevel=True) return if len(argv) == 0: version() print('usage: ipmitool [options...] ') print(''' Options: -t Set target IPMB address -b Set target channel -r Set target routing (not supported atm) -h Show this help -v Be verbose -V Print version -I Set interface (available: rmcp, aardvark, ipmitool, ipmbdev) -H Set RMCP host -U Set RMCP user -L Set RMCP priviledge level -P Set RMCP password -o Set interface specific options (name=value, separated by commas, see below for available options). '''[1:]) print(''' Aardvark interface options: serial= Serial number of the device pullups= Enable/disable pullups power= Enable/disable target power fastmode= Enable/disable 400kHz I2C bitrate (Default 100kHz) Ipmitool interface options: interface_type Set the interface type to be used (lan, lanplus, serial, open) cipher Set the cipher to be used (0-255) Ipmbdev interface options: port= Specify path to Linux IPMB device (/dev/ipmb-0 by default) '''[1:]) print('Commands:') for cmd in commands: name = cmd.name if cmd.arguments: name = '%s %s' % (name, cmd.arguments) print(' %-*s %s' % (maxlen, name, cmd.help)) def version(): print('ipmitool v%s' % pyipmi.__version__) def parse_interface_options(interface_name, options): if options: options = options.split(',') interface_options = {} for option in options: (name, value) = option.split('=', 1) if interface_name == 'aardvark': if name == 'serial': interface_options['serial_number'] = value elif (name, value) == ('pullups', 'on'): interface_options['enable_i2c_pullups'] = True elif (name, value) == ('pullups', 'off'): interface_options['enable_i2c_pullups'] = False elif (name, value) == ('power', 'on'): interface_options['enable_target_power'] = True elif (name, value) == ('power', 'off'): interface_options['enable_target_power'] = False elif (name, value) == ('fastmode', 'on'): interface_options['enable_fastmode'] = True elif (name, value) == ('fastmode', 'off'): interface_options['enable_fastmode'] = False else: print('Warning: unknown option %s' % name) elif interface_name == 'ipmitool': if name == 'interface_type': interface_options['interface_type'] = value elif name == 'cipher': interface_options['cipher'] = value else: print('Warning: unknown option %s' % name) elif interface_name == 'ipmbdev': if name == 'port': interface_options['port'] = value return interface_options def main(): try: opts, args = getopt.getopt(sys.argv[1:], 't:hvVI:H:U:P:L:o:b:p:r:J') except getopt.GetoptError as err: print(str(err)) usage() sys.exit(2) verbose = False interface_name = 'aardvark' target_address = 0x20 target_routing = None rmcp_host = None rmcp_port = 623 rmcp_user = '' rmcp_password = '' rmcp_priv_level = None interface_options = list() for o, a in opts: if o == '-v': verbose = True elif o == '-h': usage() sys.exit() elif o == '-V': version() sys.exit() elif o == '-t': target_address = int(a, 0) elif o == '-b': target_routing = [(0x20, int(a), 0)] elif o == '-r': target_routing = a elif o == '-H': rmcp_host = a elif o == '-p': rmcp_port = int(a, 0) elif o == '-U': rmcp_user = a elif o == '-P': rmcp_password = a elif o == '-L': rmcp_priv_level = a elif o == '-I': interface_name = a elif o == '-o': interface_options = a elif o == '-J': global json_output json_output = True else: assert False, 'unhandled option' # fake sys.argv sys.argv = [sys.argv[0]] + args if len(args) == 0: usage() sys.exit(1) handler = logging.StreamHandler() if verbose: handler.setLevel(logging.DEBUG) else: handler.setLevel(logging.INFO) pyipmi.logger.add_log_handler(handler) pyipmi.logger.set_log_level(logging.DEBUG) for i in range(len(args)): cmd = _get_command_function(' '.join(args[0:i+1])) if cmd is not None: args = args[i+1:] break else: usage() sys.exit(1) interface_options = parse_interface_options(interface_name, interface_options) try: interface = pyipmi.interfaces.create_interface(interface_name, **interface_options) except RuntimeError as e: print(e) sys.exit(1) ipmi = pyipmi.create_connection(interface) ipmi.target = pyipmi.Target(target_address) if target_routing is not None: ipmi.target.set_routing(target_routing) if rmcp_host is not None: ipmi.session.set_session_type_rmcp(rmcp_host, rmcp_port) ipmi.session.set_auth_type_user(rmcp_user, rmcp_password) if rmcp_priv_level is not None: ipmi.session.set_priv_level(rmcp_priv_level) ipmi.session.establish() try: cmd(ipmi, args) except pyipmi.errors.CompletionCodeError as e: print('Command returned with completion code 0x%02x' % e.cc) if verbose: traceback.print_exc() sys.exit(1) except pyipmi.errors.IpmiTimeoutError: print('Command timed out') if verbose: traceback.print_exc() sys.exit(1) except KeyboardInterrupt: if verbose: traceback.print_exc() sys.exit(1) finally: if rmcp_host is not None: ipmi.session.close() COMMANDS = ( Command('bmc info', cmd_bmc_info), Command('bmc reset cold', lambda i, a: i.cold_reset()), Command('bmc reset warm', lambda i, a: i.warm_reset()), Command('sel list', lambda i, a: list(map(_print, i.sel_entries()))), Command('sel clear', cmd_sel_clear), Command('sensor rearm', cmd_sensor_rearm), Command('sdr list', cmd_sdr_list), Command('sdr raw', cmd_sdr_show_raw), Command('sdr show', cmd_sdr_show), Command('sdr showall', cmd_sdr_show_all), Command('fru print', cmd_fru_print), Command('picmg frucontrol cr', cmd_picmg_frucontrol_cold_reset), Command('picmg power get', cmd_picmg_get_power), Command('picmg portstate get', cmd_picmg_get_portstate), Command('picmg portstate getall', cmd_picmg_get_portstate_all), Command('picmg channel status', cmd_picmg_getpower_channel_status), Command('picmg send heartbeat', cmd_picmg_send_pm_heartbeat), Command('picmg channel power', cmd_picmg_send_channel_power), Command('raw', cmd_raw), Command('hpm capabilities', cmd_hpm_capabilities), Command('hpm check', cmd_hpm_check_file), Command('hpm install', cmd_hpm_install), Command('chassis status', cmd_chassis_status), Command('chassis power off', lambda i, a: i.chassis_control_power_down()), Command('chassis power on', lambda i, a: i.chassis_control_power_up()), Command('chassis power cycle', lambda i, a: i.chassis_control_power_cycle()), Command('chassis power reset', lambda i, a: i.chassis_control_hard_reset()), Command('chassis power diag', lambda i, a: i.chassis_control_power_diagnostic_interrupt()), Command('chassis power soft', lambda i, a: i.chassis_control_power_soft_shutdown()), ) COMMAND_HELP = ( CommandHelp('raw', None, 'Send a RAW IPMI request and print response'), CommandHelp('fru', None, 'Print built-in FRU and scan SDR for FRU locators'), CommandHelp('sensor', None, None), CommandHelp('sensor rearm', '', 'Rearm Sensor Events'), CommandHelp('sel', None, 'Print System Event Log (SEL)'), CommandHelp('sel list', None, 'List all SEL entries'), CommandHelp('sel clear', None, 'Clear SEL'), CommandHelp('sdr', None, 'Print Sensor Data Repository entries and readings'), CommandHelp('sdr list', None, 'List all SDRs'), CommandHelp('sdr raw', '', 'Show SDR raw data'), CommandHelp('sdr show', '', 'Show detail for one SDR'), CommandHelp('sdr showall', None, 'Show detail for all SDRs'), CommandHelp('bmc', None, 'Management Controller status and global enables'), CommandHelp('bmc info', None, 'BMC Device ID inforamtion'), CommandHelp('bmc reset', '', 'BMC reset control'), CommandHelp('picmg', None, 'PICMG commands'), CommandHelp('picmg frucontrol', '', 'Issue frucontrol'), CommandHelp('picmg power get', 'get PICMG power level', 'Request the power level'), CommandHelp('picmg portstate getall', '', 'Request all portstates for all interfaces'), CommandHelp('picmg portstate get', ' ', 'Request the portstate for an interface'), CommandHelp('hpm', None, 'HPM.1 commands'), CommandHelp('hpm capabilities', 'HPM.1 target upgrade capabilities', 'Request the target upgrade capabilities'), CommandHelp('hpm check', 'HPM.1 file check', 'Check the specified HPM.1 file'), CommandHelp('hpm install', ' ', 'Install the specified HPM.1 file to the controller'), CommandHelp('chassis', None, 'Get chassis status and set power state'), CommandHelp('chassis status', '', 'Get chassis status'), CommandHelp('chassis power', '', 'Set power state') ) if __name__ == '__main__': main()