Intel NetStructure MPCBL0001 - Manual (Page 77)

Technical Product Specification 77
Order #273817
Intel NetStructure
®
MPCBL0001 High Performance Single Board Computer
Contents
There is an Intel-specific command to read back the buffer data in chunks of 16 bytes. This
command requires a 16 bit offset into the buffer from which to read. System software can invoke
this command several times in order to read the entire buffer. A buffer offset of 0 refers to the start
of the oldest data in the buffer and not necessarily the physical start of the buffer.
The most significant bit of the first data byte should be set if it is desired to clear the serial buffer
after reading the data. The second and third data bytes are the 16 bit offset into the buffer (LSB
first) in which to read the data.
The response data starts with a reserved byte with a value of 0 and a second byte that indicates the
number of bytes of data following (length). If no bytes are available at the given offset, the length
byte will be 0. The number of bytes returned will be the maximum that can be read at the given
offset up to a maximum of 16 (10h).
3.16.1.4 Examples
Here are some examples of using these commands from the CMM’s command line.
1. Set the Serial Port Baud Rate to 115200 and Flow Control to none on blade13:
cmmset –l blade13 –d ipmicommand –v “0x0c 0x10 0x00 0x07 0x00 0x0A”
2. Enable buffering with no filtering and clear the buffer on blade13:
cmmset –l blade13 –d ipmicommand –v “0x30 0x32 0xB2”
3. Get characters from offset 0x260 in the buffer on blade13:
cmmset –l blade13 –d ipmicommand –v “0x30 0x30 0x00 0x60 0x02”
4. Clear the serial buffer with no other changes on blade13:
cmmset –l blade13 –d ipmicommand –v “0x30 0x32 0x80”
Here is a sample standalone bash script for the CMM to read the contents of the serial buffer into a
file on the CMM. The blade number is passed on the command line. Note that this script is very
slow to upload the data but gives an example of the procedure.
#!/bin/bash
#-------------------------------------------------------------------
# Print Usage syntax and exit
#-------------------------------------------------------------------
Table 42. Get Serial Buffer Command: Net Function=30h, Command=30h
Byte Data Field
Request Data 1
[7] – 1b = Clear buffer after reading
[6:0] - Reserved
2 Character offset into buffer (LSB)
3 Character offset into buffer (MSB)
Response Data 1
Completion code
2
[7:5] - Reserved
[4:0] - 00h = No characters at the given offset
01h-10h = Number of characters returned in this response
4-n Buffer characters