Advertisement

Quick Links

Table of contents

The ld100_tool utility......................................................................................................................................................1
Recent document changes..............................................................................................................................................1
System typical requirements...........................................................................................................................................2
Installation......................................................................................................................................................................2
Initial set up and connection with the Platform over LAN...............................................................................................3
Diagnostics...................................................................................................................................................................... 3
FRU, SDR, SEL.................................................................................................................................................................. 5
BMC terminal.................................................................................................................................................................. 5
IPMI over serial............................................................................................................................................................... 5
Serial Over LAN............................................................................................................................................................... 6
LAN session inactivity timeouts.......................................................................................................................................7
Keep connection checkbox options.................................................................................................................................7
LAN discovery.................................................................................................................................................................. 8
FRU flashing....................................................................................................................................................................9
LAN password options...................................................................................................................................................10
BMC firmware updating................................................................................................................................................11
Auxiliary ld100_tool controls........................................................................................................................................12
Multi-BMC support........................................................................................................................................................13
LD100 tool extensibility options....................................................................................................................................14
Running LD100 tool as a service....................................................................................................................................15
Glossary and abbreviations...........................................................................................................................................16
Literature...................................................................................................................................................................... 16

The ld100_tool utility

The ld100_tool utility controls IPMI-capable devices over an interface, and provides the external clients with the
capability to control each device. The primary purpose of the ld100_tool is to support the LD100 device programmed
to control the device connected sensors. If connected with another device (not the ld100, or ld100 programmed to
carry another function), the ld100_tool is capable to discover that device and provide respective support possible.
The device specific options are described in the respective documents [10, 11]. Below is general information on the
ld100_tool use.

Recent document changes

JSON/mosquitto
Fig.3 description (J20.2, J20.4 GPIO) fixed
Running ld100_tool as a service
1
LD100 tool
user's manual
SV250316.02UM
rev. 45
June 17, 2021

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the LD100 and is the answer not in the manual?

Questions and answers

Summary of Contents for Instrumentation Hub LD100

  • Page 1: Table Of Contents

    The ld100_tool utility controls IPMI-capable devices over an interface, and provides the external clients with the capability to control each device. The primary purpose of the ld100_tool is to support the LD100 device programmed to control the device connected sensors. If connected with another device (not the ld100, or ld100 programmed to carry another function), the ld100_tool is capable to discover that device and provide respective support possible.
  • Page 2: System Typical Requirements

    3. USB connection with the LD100 (recommended option) * * USB to UART converter drivers (FTDI) must be installed [5] The LD100 or other IPMI-capable device connected with the ld100_tool over an interface is called below a Platform. Installation 1) find in the distribution package ld100_tool.rar, unpack it in any directory;...
  • Page 3: Initial Set Up And Connection With The Platform Over Lan

    7. Log to file checkbox if checked enables ld100_tool events logging to a file. More detail on logging, and status reporting is provided in the application note [6]. *The “Reset” button (legacy name) is now renamed to “Connect”, not to be confused with ld100 hardware Reset button.
  • Page 4 18 user controllable GPIO lines. To refresh the screen, manual or automatic (periodic) polling should be used. The GPIO lines correspond to pins of the ld100 J18, J19, J20 connectors, six pins per connector. Pins J20.2, and J20.4 are connected to on-boards LEDs: LED_ERR, and LED_ACTIVITY respectively.
  • Page 5: Fru, Sdr, Sel

    If the device was successfully discovered, there are options to print FRU, SDR, or SEL contents. See Aux tab. Also available are options to clear SEL or set the SEL time (ld100 clock) equal to computer time. There is no battery on the ld100, therefore the SEL clock is volatile.
  • Page 6: Serial Over Lan

    The BMC UART0 is used for IPMI over Serial and for BMC terminal. If the BMC UART0 is mapped to UART0 then terminal becomes accessible to the client over LAN, and without the use of the PC COM-port. Because the LD100 device is Power over LAN capable then no USB connection is required for an access to BMC terminal.
  • Page 7: Lan Session Inactivity Timeouts

    LAN session inactivity timeouts Fig.7 Keep connection to prevent session from closing. If LAN session is open but no messages are received by the BMC, then after time-out time (about 60 seconds), the BMC closes this session automatically. To prevent the session from closing, the ld100_tool “Keep connection” checkbox (Fig.7) should be checked. This effectively maintains periodic polling of the remote BMC, with a period of several seconds, by sending a Get Device ID message to the remote BMC.
  • Page 8: Lan Discovery

    LAN discovery The ld100_tool optionally performs cyclic scan of a window of IP addresses, to find ld100 devices, using RMCP ping messages. The scan window size is settable from the “Keep connection” checkbox options menu, and centered around the IP address of the BMC0 (Fig 8.3, Fig 8.4).
  • Page 9: Fru Flashing

    FRU flashing The ld100_tool distribution comes with the FRU description sample file included: fru_sample.xml You may use it as a template for updating the FRU/SDR/SEL. FRU flashing is performed from the “Aux” tab: Fig.10 FRU flashing controls. 1. Select the xml-file 2.
  • Page 10: Lan Password Options

    LAN password options Fig.10a Password setting. You may preview the password or set the remote password by clicking the “password” label on the Connection tab. To make the remote password permanently changed, please use the [sys fru save] ipmi terminal command [7]. Note: the default factory set user name is “admin”, password is “000”...
  • Page 11: Bmc Firmware Updating

    BMC firmware updating The LD100 BMC firmware is factory flashed and never needs be changed during device life time (Factory firmware). For LD100 device upgrade, flashing of Update firmware option exists. Flashing of the Update firmware is performed using the ld100_tool utility the same way the FRU flashing is done. The difference is in the file selected: the Update firmware comes in an Intel HEX format (Fig.11).
  • Page 12: Auxiliary Ld100_Tool Controls

    ** The state of the “Save On Exit” checkbox is never saved: this checkbox is always checked at start-up. *** If the Connect button is pressed, then current ld100_tool settings are saved, then the LD100 device is discovered and at last saved settings are restored. To avoid the settings being saved (so that to restore last saved BMC settings,...
  • Page 13: Multi-Bmc Support

    Multi-BMC support The ld100_tool version 4.28 or higher supports several BMCs. On the Fig.13 shown are property tabs of two BMCs connected with the ld100_tool via respective interfaces. Each BMC could be independently configured, and all the settings are automatically saved/restored as described in the above paragraphs.
  • Page 14: Ld100 Tool Extensibility Options

    The utility supports several customized platform versions and may display the respective specific options [10, 11]. The ld100_tool supports interfacing to external (user’s) utilities through shared memory, to control each LD100 Platform the session is opened with [10]. Communication via shared memory is implemented with the LD100 device only.
  • Page 15: Running Ld100 Tool As A Service

    Running LD100 tool as a service. The ld100_tool could be run GUI-less, “minimized to tray” (Fig.15) to consume minimum processor resources. In this case all the ld100_tool configuration, including BMCs and sensors, will be restored to last saved values, at startup.
  • Page 16: Glossary And Abbreviations

    - Graphics User Interface (ex: fig.2); - Baseboard Management Controller [2]. ld100 - BMC of the ld100 module having appropriate firmware Factory firmware - the BMC firmware factory flashed to the device. Not user changeable and could be forcedly run for Update firmware flashing.

Table of Contents