1. lxMicCfg

1.1. Overview

Copyright (c) 2011-2013 Intel Corporation. All rights reserved.

Version_number=2.23.1.0001
Released:	 10/07/2013

Purpose
The purpose of this test module is to ensure that the correct Many Integrated Cores (MIC) card is installed in a system.

Runtime Environment
The Intel(R) Modular Test Architecture Test Executive for Linux template module.

License Agreement
All code is under the Intel(R) software License which can be found at http://legal.intel.com. A copy of this agreement must be 
included if code is released outside Intel.

Hardware Description
This module checks the configuration of the processor, memory, SMC, flash and various boot states. 




1.2. Version Info

 
Date		Version		Owner		Comments
11/29/2011	2.01.1.0001	SLK		First official release
12/29/2011	2.03.1.0001	SLK		Updates for 2.1.2001-3 MIC MPSS release
01/29/2012	2.04.0.0002	DKJ		Updates for KNC ES1 silicon and 2.1.2430-2 MIC MPSS release.
						Also, the name of the MicDieTemp parameter changed to MicProcessorTemp.
02/25/2012	2.05.1.0001	DKJ		Updates for MIC MPSS Alpha release. Also:
						* Removed MicMemorySize parameter
						* Added timeouts to MIC boot script execution
						* Converted error reports during AutoConfig to Advisory messages
03/21/2012	2.06.1.0001	DKJ		Adds tolerance parameters for fan, voltage, and frequency values. Also:
						* Returns actual fan values from MIC board
						* Fixes a bug with decode and display of SMC FW version information
03/28/2012	2.07.1.0001	DKJ		Adds support for KNC B0 silicon.  Fixes bugs related to:
						* Displaying Fan PWM & RPM values  as negative numbers
						* Disables Processor Temp check and SMC FW version check, because
						  KNC SW does not report these values reliably, which causes false test 
						  failures.
04/25/2012	2.08.1.0001	DKJ		Rebuild with MIC MPSS SW version po201-0, for KNC B0 ES2 Silicon
06/11/2012	2.09.1.0001	DKJ		Several small changes:
						* Board Type definitions updated to support DFF boards
						* Default values for tolerance parameters changed from 5 to 10
06/13/2012	2.10.1.0001	DKJ		Fix Mic_PBA_SKU values for board types:
						* 245W (DFF) Passive CS
						* 225W Passive CS
06/14/2012	2.11.1.0001	DKJ		Enable Processor Temp check, which was disabled in 2.07.1.0001
06/22/2012	2.12.1.0001	DKJ		Convert to MPSS SW stack version 3126-13, which uses new MIC Boot 
						commands:
						* Add Mic Reset subtest, to provide access to new: micctrl --reset command
						* Enable SMC FW version check
						* Force Processor Voltage to be reported as 0, due to bug in MPSS SW 
						  stack
07/31/2012	2.13.1.0001	DKJ		Update to MPSS SW stack version 3653-7 and fix bugs related to:
						* Possible integer overflow error when checking whether a parameter value 
						  is In Tolerance.
						* Reading Fan PWM value of 0
						* Reading MIC Memory Frequency and Voltage from MPSS SW APIs.
						* Removes parameters:
							MicFanEnabled,
							MicFanError,
							MicFanOverrideStatus.
						* Adds parameters:
							MicFanRPMSensor,
							MicFanPWMSensor,
							MicMemoryVoltage,
							MicMemoryVoltageTolerance,
							MicMemoryFrequency,
							MicMemoryFrequencyTolerance
						* Adds one retry to MIC uOS boot attempts

08/30/2012	2.14.1.0001	DKJ		Update to MPSS SW stack version 4346-6.
						* Removes MIC Fan checks
						* Removes parameters related to MIC Fan checks:
							MicFanRPMSensor,
							MicFanRPM,
							MicFanRPMTolerance,
							MicFanPWMSensor,
							MicFanPWM,
							MicFanPWMTolerance.
						* Changes parameter:
							MicMemorySpeed.
	
11/04/2012	2.15.1.0001	DKJ		Update to MPSS SW stack version 4346-16.
						* Adds logging of lxmicstart failure messages, see lxMicBoot version 
2.10.1.0001
	
01/18/2013	2.16.1.0001	DKJ		Update to MPSS SW stack version 5743-2, to support C0 KNC release

	
02/26/2013	2.17.1.0001	DKJ		Add support for 4 GigBit Memory parts				

03/14/2013	2.18.1.0001	SLK		Add support for turbo mode testing
05/01/2013	2.19.0.0001	DKJ		Rebuild to support MPSS 6720-12
06/22/2013	2.20.1.0001	DKJ		Added DCP3_enable functions
07/01/2013	2.21.1.0001	DKJ		Fix MIC DPC3 Mode Disable crash in Verbose mode.
10/07/2013	2.23.1.0001	DKJ		Update to MPSS 3.1 release, also:
						*	Add support for multiple MIC cards in a test host.
						*	Remove Memory Vendor Check
						*	Change CPU Stepping Parameter to allow more than one CPU Stepping
						*	Change Memory Revision to allow more than one Memory Revision
						*	Convert parameter checks related to CPU Stepping and Memory Vendor 
							to optional checks.
						*	Remove Board Temp Check and associated parameters

1.3. Installation

Files needed to run this module:
	
File			Description
lxMicCfg		Executable image.
lxMicCfg.snx	Configuration file.
lxMicCfg.txt	Text only help file.
lxMicCfg.chm	Smart help file.
lxmicstart		Script to boot MIC card (invoked through "uOS Boot" subtest). Provided by lxMicBoot
lxmicbooted		Script to check whether uOS is already booted on the MIC card. Provided by lxMicBoot
lxmicready		Script to reset MIC card to FW ready state. Provided by lxMicBoot

NOTE: This module is currently set to work with only one MIC card in a host system.

lxMicBoot:
This package depends on the lxMicBoot test package to provide the lxmicstart, lxmicbooted, and lxmicready scripts which are 
use to boot the MIC uOS.  The lxMicBoot version required to support this version of lxMicCfg, must be at least 2.14.1.0001

MPSS RPM: 
A supported version of the MPSS RPM must be installed on the host system. The following RPMs must be installed (replace 
version with the correct version);
<TO BE UPDATED for MPSS 3.1>

For Example:
<TO BE UPDATED for MPSS 3.1>

Please see project contact for copies of these RPMs and any updates on
supported RPM versions. 
RPMs may be installed on the host system with this command: 
rpm -ihv rpm_file_name.rpm

Host board: 	The host board must be supported by the MPSS RPM team. Please see project contact for a list of 
supported boards. This release was tested with Intel(r) Workstation Board W2600CR2.

Operating Systems:	The OS on the host board must be supported by the MPSS team. Currently, the supported OS are Red 
Hat Enterprise Linux 6.0 and Red Hat Desktop 6.0.

MIC card:	A supported MIC card must be plugged into a PCI-E slot on the supported host board. Please see project 
contact for a list of supported boards.






1.4. Sub-Tests


Test 0 	Auto-Configuration

Test 1 	uOS Boot
Test 2 	CPU Information
Test 3 	Flash Information
Test 4 	Boot Information
Test 5 	SMC Information
Test 6 	Memory Information
Test 8 	Mic Reset
Test 11	Mic Turbo Mode Check
Test 12	Mic Turbo Mode Enable
Test 13	Mic Turbo Mode Disable
Test 14	MIC DPC3 Mode Disable
Test 15	MIC DPC3 Mode Enable
Test 16	MIC DPC3 Mode Set



1.5. Test 0 - Auto-Configuration

Overview

This test checks the configuration, for all of the MIC PCIe add in cards in the test host. It records processor, memory, SMC, 
flash and various boot states, and saves the configuration to multiple parameters.

Parameter(s)

The following parameters are written, for each MIC in the test host, by this test:
MicCPUFamily
MicCPUModel
MicCPUStepping
MicCPUFrequency
MicCPUExtendedModel
MicCPUExtendedFamily
MicCPUType
MicCPUCores
MicFlashVersion
MicFlashBoot0Version
MicUsageMode
MicPostCode
Mic_uOS_Version
MicProcessorTemp
MicSMCFirmwareRevision
MicBoardType
Mic_PBA_SKU
MicMemoryDensity
MicMemoryType
MicMemorySpeed
MicMemoryRevision
MicChangeMode
MicDPC3Value

The following parameters are read by this test:
MicTurboDelayMs
MicTurboTolerance

Test Execution Time

This test takes approximately 2 seconds to execute per MIC card, once the MIC uOS is booted on all the MIC cards. Booting the 
MIC uOS's takes about 1 minute.

Dependencies/Limitations

The lxMicBoot package must be loaded, so the lxmicstart and lxmicbooted scripts will be available.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be at least one MIC card installed in the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.





1.6. Test 1 - uOS Boot

Overview

The "uOS Boot" test invokes the lxmicstart script, which connects to the MIC cards and boots the MIC uOS on them.  Note: 
This subtest will initiate uOS boot on ALL the MIC cards installed in the test host.

Parameter(s)

	None

Test Execution Time

Test time is dependent on the amount of time it takes the card to boot - somewhere between 15 seconds and a minute.

Dependencies/Limitations

The lxMicBoot package must be loaded, so the lxmicstart and lxmicbooted scripts will be available.

Either this subtest -OR- the "lxmicstart" script must be successfully invoked once (and only once) after system boot. 

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.7. Test 2 - CPU Information

Overview

The CPU Information test retrieves the current CPU configuration information from the MIC card, under test, and compares it 
against the expected CPU configuration information. If there is a difference between the two, the test will fail.

Parameter(s)

MicCPUFamily
MicCPUModel
MicCPUSteppings
MicCPUFrequency
MicCPUFrequencyTolerance
MicCPUExtendedModel
MicCPUExtendedFamily
MicCPUType
MicCPUCores
MicCPUVoltage
MicCPUVoltageTolerance

Test Execution Time

Test time is about 1 second

Dependencies/Limitations

The "lxmicstart" script must be successfully invoked once (and only once) after system boot. It may be invoked directly, but it is 
usually done through the "uOS Boot" subtest.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.8. Test 3 - Flash Information

Overview

The Flash Information test retrieves the current flash configuration on the MIC card and compares it against the parameters. If 
the values differ, the test will fail.

Parameter(s)

MicFlashVersion
MicFlashBoot0Version

Test Execution Time

Test time is about 1 second

Dependencies/Limitations

The "lxmicstart" script must be successfully invoked once (and only once) after system boot. It may be invoked directly, but it is 
usually done through the "uOS Boot" subtest.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.9. Test 4 - Boot Information

Overview

The Boot Information test retrieves the current MIC card mode, post code and MIC uOS version. It compares these against the 
expected values, and fails if they differ.

Parameter(s)
MicUsageMode
MicPostCode
Mic_uOS_Version

Test Execution Time

Test time is about 1 second

Dependencies/Limitations

The "lxmicstart" script must be successfully invoked once (and only once) after system boot. It may be invoked directly, but it is 
usually done through the "uOS Boot" subtest.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.10. Test 5 - SMC Information

Overview

The SMC information is read from the current MIC configuration, and compared with the expected values. If the values differ, 
the test fails.

Parameter(s)

MicProcessorTemp
MicProcessorTempTolerance
MicSMCFirmwareRevision
MicBoardType
Mic_PBA_SKU

Test Execution Time

Test time is about 1 second

Dependencies/Limitations

The "lxmicstart" script must be successfully invoked once (and only once) after system boot. It may be invoked directly, but it is 
usually done through the "uOS Boot" subtest.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.11. Test 6 - Memory Information

Overview

The memory information is read from the current MIC configuration and compared with the expected values. If the values differ, 
the test fails.

Parameter(s)
MicMemoryDensity
MicMemoryType
MicMemorySpeed
MicMemorySpeedTolerance
MicMemoryRevision
MicChangeMode
MicMemoryVoltage
MicMemoryVoltageTolerance
MicMemoryFrequency
MicMemoryFrequencyTolerance

Test Execution Time

Test time is about 1 second

Dependencies/Limitations

The "lxmicstart" script must be successfully invoked once (and only once) after system boot. It may be invoked directly, but it is 
usually done through the "uOS Boot" subtest.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.12. Test 8 - Mic Reset

Overview

The "Mic Reset" test invokes the lxmicready script, which resets the MIC card, to put it in the firmware "ready" state.

Parameter(s)

None

Test Execution Time

Reset of the MIC card takes between 1 and 2 minutes.

Dependencies/Limitations

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.13. Test 11 - MIC Turbo Mode Check

Overview

The "MIC Turbo Mode Check" test first checks that turbo mode is supported. If it is, it saves the current turbo state, then 
disables turbo mode, waits the number of microseconds specified in the MicTurboDelayMs parameter and checks the 
frequency.  It then enables the turbo mode, again waits the number of microseconds specified in the MicTurboDelayMs 
parameter and checks the frequency. If the difference between the frequencies with turbo mode enabled and disabled is not at 
least the percentage specified in the MicTurboTolerance parameter, the test will fail.

Parameter(s)

MicTurboDelayMs
MicTurboTolerance

Test Execution Time

Test takes about a second to run, as well as double the number of microseconds listed in the MicTurboDelayMs parameter for 
each mode. For example, if MicTurboDelayMs is set to 3000 microseconds (3 seconds), the test will take about 7 seconds total.

Dependencies/Limitations

Turbo mode must be supported on the processor and software stack.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.14. Test 12 - MIC Turbo Mode Enable

Overview

The "Mic Turbo Mode Enable" test first checks to see if turbo mode is supported. If it isn't, the test returns an error message. 
Otherwise, turbo mode will be enabled.

Parameter(s)

  None

Test Execution Time

About one second

Dependencies/Limitations

Turbo mode must be supported on the processor and software stack.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.15. Test 13 - MIC Turbo Mode Disable

Overview

The "Mic Turbo Mode Disable" test first checks to see if turbo mode is supported. If it isn't, the test returns an error message. 
Otherwise, turbo mode will be disabled.

Parameter(s)

  None

Test Execution Time

About one second.

Dependencies/Limitations

Turbo mode must be supported on the processor and software stack.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.16. Test 14 - MIC DPC3 Mode Disable

Overview

Disables DPC3 Mode on MIC card.

Parameter(s)

  None

Test Execution Time

About one second.

Dependencies/Limitations

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.17. Test 15 - MIC DPC3 Mode Enable

Overview

Enables DPC3 Mode on MIC card.

Parameter(s)

  None

Test Execution Time

About one second.

Dependencies/Limitations

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.18. Test 16 - MIC DPC3 Mode Set

Overview

Sets DPC3 Mode on the MIC to the value saved in a parameter. During AutoConfigure, reads the DPC3 mode and save it in the 
paramater.

Parameter(s)

  MicDPC3Value

Test Execution Time

About one second.

Dependencies/Limitations

Turbo mode must be supported on the processor and software stack.

See "Installation" for additional information on each of the following:

The MPSS RPM must be installed on the host system.

There must be a MIC card added to the system.

The host board must be supported by the MPSS team.

The OS must be a supported version.




1.19. Parameters



MicCPUFamily
MicCPUModel
MicCPUStepping
MicCPUFrequency
MicCPUFrequencyTolerance
MicCPUExtendedModel
MicCPUExtendedFamily
MicCPUType
MicCPUCores
MicCPUVoltage
MicCPUVoltageTolerance
MicFlashVersion
MicFlashBoot0Version
MicUsageMode
MicPostCode
Mic_uOS_Version
MicProcessorTemp
MicProcessorTempTolerance
MicSMCFirmwareRevision
MicBoardType
Mic_PBA_SKU
MicMemoryDensity
MicMemoryType
MicMemorySpeed
MicMemorySpeedTolerance
MicMemoryRevision
MicMemoryVoltage
MicMemoryVoltageTolerance
MicMemoryFrequency
MicMemoryFrequencyTolerance
MicChangeMode
MicTurboDelayMs
MicTurboTolerance
MicDPC3Value






1.20. MicCPUFamily

Description

This parameter is the family of the CPU on the MIC card. If this parameter is not defined, the CPU Family check is disabled.

Default
	 
   None

Dependencies

Optional

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.21. MicCPUModel

Description

This parameter is the model of the processor on the MIC card. If this parameter is not defined, the CPU Family check is 
disabled.

Default
	 
   None

Dependencies

Optional

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.22. MicCPUSteppings

Description

This is an Array Parameter, which contains a list of acceptable CPU Steppings. If the MIC under test has a CPU which matches 
any of the steppings listed, the test will pass. During Auto-Configuration the Stepping at Index 0 is initialized to the stepping of 
the MIC under test.  Test users may add additional steppings manually.

Default
	 
Index
Stepping
0
A1


Dependencies

Required

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.23. MicCPUFrequency

Description

This parameter is the frequency of the processor on the MIC card.  

Default

	MicCPUFrequency = 0x927C0

Dependencies

None

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.24. MicCPUExtendedModel

Description

This parameter is the extended model of the processor on the MIC card.  If this parameter is not defined, the CPU Family check 
is disabled.

Default

	None

Dependencies

Optional

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.25. MicCPUExtendedFamily

Description

This parameter is the extended family of the processor on the MIC card. If this parameter is not defined, the CPU Family check 
is disabled.

Default

None

Dependencies

Optional

Used by

Auto-Configure
CPU Information

See Also

Parameters



1.26. MicCPUType

Description

This parameter contains the type of the processor on the MIC card.  If this parameter is not defined, the CPU Family check is 
disabled.

Default

	None

Dependencies

	Optional

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.27. MicCPUCores

Description

This parameter contains the number of cores of the CPU on the MIC card.

Default
	 
   MicCPUCores = 0x04

Dependencies

Required

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.28. MicCPUVoltage

Description

This parameter contains the voltage of the CPU on the MIC card.

Note: As of release date, the MPSS RPM is returning 0. In later MPSS RPM releases, this field will be populated.

Default
	 
   MicCPUVoltage = 0x0

Dependencies

Required

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.29. MicFlashVersion

Description

This parameter is the version of the primary flash on the MIC card.

Default
	 
   MicFlashVersion = 2.1.0.0204

Dependencies

Required

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.30. MicFlashBoot0Version

Description

This parameter indicates the version of FBoot0 in the MIC card. Starting with version 2.22 of lxMicCfg, this parameter value is 
Not Available.

Default
	 
   MicFlashBoot0Version = "Not Available"

Dependencies

Required

Used by

Auto-Configure
CPU Information

See Also

Parameters

1.31. MicUsageMode

Description

This parameter indicates the current usage mode of the MIC card. With release of MPSS 3.1 and lxMicCfg 2.22, the known 
usage modes are Normal, and Maintenance.
During normal testing this parameter should indicate that the system is in Normal mode.

Default
	 
   MicUsageMode = 0

	Valid values (not all values will work on all cards):
	0 = NORMAL
	1 = MAINTENANCE


Dependencies

Required

Used by

Auto-Configure
Boot Information

See Also

Parameters

1.32. MicPostCode

Description

This parameter is the post code of the MIC card. "FF" indicates success, "12" indicates that the card is not booted yet, and all 
other values indicate an error.

Default
	 
   MicPostCode = 0xFF

Dependencies

Required

Used by

Auto-Configure
Boot Information

See Also

Parameters

1.33. Mic_uOS_Version

Description

This parameter indicates the version of the uOS on the MIC card.

Default

	Mic_uOS_Version = 2.6.34-gc458744

Dependencies

Required

Used by

Auto-Configure
Boot Information

See Also

Parameters



1.34. MicProcessorTemp

Description

This parameter indicates the processor temperature on the MIC card.

Note: As of release date, the MPSS RPM is returning 0. In later MPSS RPM releases, this field will be populated.

Default

	MicProcessorTemp = 0

Dependencies

Required

Used by

Auto-Configure
SMC Information

See Also

Parameters

1.35. MicSMCFirmwareRevision

Description

This parameter indicates the firmware revision of the SMC on the MIC card. 

Default

	MicSMCFirmwareRevision = 3.8.13

Dependencies

Required

Used by

Auto-Configure
SMC Information

See Also

Parameters

1.36. MicBoardType

Description

This parameter lists the type of the MIC card.  

Default

	MicBoardType = MPI

	Common values:
	MPI
	CRB
	DFF
	Product

	If one of the common values above are not read, the board type will be returned as a hex value (ex: 0xD).

Dependencies

Required

Used by

Auto-Configure
SMC Information

See Also

Parameters

1.37. Mic_PBA_SKU

Description

This parameter lists the SKU of the MIC card.

Default

   Mic_PBA_SKU = "300W Active NCS"

	Common values:
	300W Active NCS
	300W Active CS
	245W (DFF) Active NCS
	225W Active NCS
	245W (DFF) Active CS
	225W Active CS
	300W Passive NCS
	300W Passive CS
	245W (DFF) Passive NCS
	225W Passive NCS
	245W (DFF) Passive CS
	225W Passive CS

	If one of the common values above are not read, the SKU will be returned as a hex value (ex: 0xD).

Dependencies

Required

Used by

Auto-Configure
SMC Information

See Also

Parameters

1.38. MicMemoryDensity

Description

This parameter is Density of the MIC memory.  In this context Density is the number of bits in each GDDR memory component 
on the MIC board. If this parameter is not defined, the Memory Density check is disabled.

Default

	MicMemoryDensity = 2 Gbits

	Currently supported values:
	512 Mbits
	1 Gits
	2 Gbits
	4 Gbits

	Values indicating unexpected return codes:
	Density: #
 Where # is an index number returned by the MIC MPSS API.

Dependencies

Optional

Used by

Auto-Configure
Memory Information

See Also

Parameters

1.39. MicMemoryType

Description

This parameter is the type of the memory on the MIC card. If this parameter is not defined the Memory Type Check is disabled.

Default

	MicMemoryType = GDDR5

	Currently supported values:
	GDDR3
	GDDR5
	GDDR6

	Values indicating unexpected return codes:
	Type not in SDK

Dependencies

Optional

Used by

Auto-Configure
Memory Information

See Also

Parameters

1.40. MicMemorySpeed

Description

This parameter is the speed of the memory on the MIC card in Kilo Transfers per second (KT/s). If this parameter is not defined 
the Memory Speed Check is disabled.

Default

	MicMemorySpeed = 0x4C4B40

Dependencies

Optional

Used by

Auto-Configure
Memory Information

See Also

Parameters

1.41. MicMemoryRevisions

Description

This is an Array Parameter, which contains a list of acceptable Memory Revisions. If the MIC under test has a Memory Revision  
which matches any of the listed values, the test will pass. During Auto-Configuration Index 0 is initialized to the revision of the 
Memory on the MIC under test.  Test users may add additional Memory Revisions manually.

Default


Index
Mem Revision List
0
2


Dependencies

Required

Used by

Auto-Configure
Memory Information

See Also

Parameters

1.42. MicChangeMode

Description

This parameter is used by the "Change Mode" subtest. It indicates the mode to which the MIC card will be set. If the MIC card is 
already set to that mode, the test will return an error message, as invoking the same mode several times in a row may hang the 
MIC card.

Default

	MicChangeMode = 0

	Valid values (not all values will work on all cards):
	0 = NORMAL
	1 = MAINTENANCE
	2 = ZOMBIE
	3 = MEMORY DIAGNOSTICS
	4 = NORMAL RESTRICTED (used in memory testing)

Dependencies

Required

Used by

Auto-Configure
Change Mode

See Also

Parameters

1.43. MicCPUFrequencyTolerance

Description

This parameter is used by the CPU Information subtest. It indicates how much the actual CPU Frequency may differ from the 
value of the MicCPUFrequency parameter.  This parameter specifies a percentage of the parameter value, that the actual value 
may be different from the parameter value, and still be within tolerance.

Default

	MicCPUFrequencyTolerance = 10

	Valid values are 0 to 100  %


Dependencies

Optional

Used by
CPU Information

See Also

Parameters

1.44. MicCPUVoltageTolerance

Description

This parameter is used by the CPU Information subtest. It indicates how much the actual CPU Voltage may differ from the value 
of the  MicCPUVoltage parameter.  This parameter specifies a percentage of the parameter value, that the actual value may be 
different from the parameter value, and still be within tolerance.

Default

	MicCPUVoltageTolerance = 10

	Valid values are 0 to 100  %


Dependencies

Optional

Used by
CPU Information

See Also

Parameters

1.45. MicProcessorTempTolerance

Description

This parameter is used by theSMC Information subtest. It indicates how much the actual Processor Temperature may differ from 
the value of the  MicProcessorTemp parameter.  This parameter specifies a percentage of the parameter value, that the actual 
value may be different from the parameter value, and still be within tolerance.

Default

	MicProcessorTempTolerance = 10

	Valid values are 0 to 100  %


Dependencies

Optional

Used by
SMC Information

See Also

Parameters

1.46. MicMemorySpeedTolerance

Description

This parameter is used by the Memory Information subtest. It indicates how much the actual Memory Speed may differ from the 
value of the  MicMemorySpeed parameter.  This parameter specifies a percentage of the parameter value, that the actual value 
may be different from the parameter value, and still be within tolerance.

Default

	MicMemorySpeedTolerance = 10

	Valid values are 0 to 100  %


Dependencies

Optional

Used by
Memory Information

See Also

Parameters

1.47. MicMemoryVoltage

Description

This parameter is used by the Memory Information subtest. It indicates Memory Voltage in millivolts. If this parameter is not 
defined, the Memory Voltage Check is disabled.

Default

	MicMemorySpeedTolerance = 0xF4240


Dependencies

Optional

Used by
Memory Information

See Also

Parameters

1.48. MicMemoryVoltageTolerance

Description

This parameter is used by the Memory Information subtest. It indicates how much the actual Memory Voltage may differ from the 
value of the  MicMemoryVoltage parameter.  This parameter specifies a percentage of the parameter value, that the actual 
value may be different from the parameter value, and still be within tolerance.

Default

	MicMemoryVoltageTolerance = 10

	Valid values are 0 to 100  %


Dependencies

Optional

Used by
Memory Information

See Also

Parameters

1.49. MicMemoryFrequency

Description

This parameter is used by the Memory Information subtest. It indicates Memory Frequency on MIC card. If this parameter is not 
defined the Memory Frequency Check is disabled.

Default

	MicMemoryFrequency = 0x2625A0


Dependencies

Optional

Used by
Memory Information

See Also

Parameters

1.50. MicMemoryFrequencyTolerance

Description

This parameter is used by the Memory Information subtest. It indicates how much the actual Memory Frequency may differ from 
the value of the  MicMemoryFrequency parameter.  This parameter specifies a percentage of the parameter value, that the 
actual value may be different from the parameter value, and still be within tolerance.

Default

	MicMemoryFrequencyTolerance = 10

	Valid values are 0 to 100  %


Dependencies

Optional

Used by
Memory Information

See Also

Parameters

1.51. MicTurboTolerance

Description

This parameter is used by the Memory Information subtest. It indicates how much the actual Memory Frequency may differ from 
the value of the  MicMemoryFrequency parameter.  This parameter specifies a percentage of the parameter value, that the 
actual value may be different from the parameter value, and still be within tolerance.

Default

	MicMemoryFrequencyTolerance = 10

	Value must be >= 0.


Dependencies

Required

Used by 

MicTurboModeCheck
Auto-Configure

See Also

Parameters

1.52. MicTurboDelayMs

Description

This parameter is used by the Memory Information subtest. It indicates how much the actual Memory Frequency may differ from 
the value of the  MicMemoryFrequency parameter.  This parameter specifies a percentage of the parameter value, that the 
actual value may be different from the parameter value, and still be within tolerance.

Default

	MicMemoryFrequencyTolerance = 3000

	Value must be >= 0.

Dependencies

Required

Used by

MicTurboModeCheck
Auto-Configure

See Also

Parameters

1.53. MicDPC3Value

Description

This parameter is used to store the default value for the MIC's DPC3_enabled Mode.

Default

	1

	Value must be either 1 or 0

Dependencies

Required

Used by

Mic DPC3 Mode Set

See Also

Parameters

1.54. Error Codes


ERROR codes formatted as 0xMMMTTEEE 

MMM - Module number  
TT      - Test number 
EEE   - Error code number, as below:

Error Code   	Message
5240X001 	Invalid Test Number: test_number
5240X002	Error Setting parameter: parameter
5240X003 	Internal Error: error code 
5240X004	Unable to retrieve parameter: parameter
5240X005 	Invalid value for parameter: parameter: <failure description>
5240X006	Error on <MIC name> calling function: <function name>: <error description>
5240X007	uOS Boot failed on <MIC name>
5240X008 	MIC parameter Error. Expected string value, Actual string value.
5240X009	MIC parameter Error. Expected numeric value, Actual numeric value.
5240X00A	Request to change mode to value returned error.
5240X00B	Expected parameter_name parameter to be between X and Y. Received value Z.
5240X00C	Requested to set mode to X when mode is already set to X.
5240X00D	Error accessing file <file name>, error <error description>
5240X010	Mic Reset failed <MIC name>
5240X011	Turbo Mode is not supported on <MIC name>
5240X012	Turbo Mode Enable Failed on <MIC name>
5240X013	Turbo Mode Disable Failed on <MIC name>
5240X014	CPU frequency must differ at least X percent when turbo mode is enabled: (0xY) compared to non-turbo state 
(0xZ)
5240X015	DPC3 <operation: enable, disable, set> on <MIC name> Failed: failure description
5240X016	MIC device <MIC name> not available <MPSS function>:  <MPSS failure description>
5240X017	MIC parameter value <actual value> not in list of acceptable values

Debug Hints for Overall Causes of lxMicCfg Failures:
See "Installation" section.

1.55. Glossary


Term		Definition

Host Board	The baseboard into which the MIC card is plugged via a PCI-e slot. 

MIC		Many Integrated Cores - an add-in card with processors and memory, to offload compute intensive processing

SMC		System Management Controller - similar to the BMC on the host board, it controls temperatures and other 
		intelligent board management.

uOS		micro-OS - an embedded OS on the MIC card, which runs separately from the OS on the host board.

Usage mode	The mode which the MIC card is booted in. There are multiple modes, including Normal (for regular usage), 
		Maintenance (to perform card maintenance), etc.

UUT		Unit Under Test - the MIC card which is being tested.

