Difference between revisions of "SW Service/API/SUSI4.0 USER MANUAL"

Revision as of 09:26, 9 June 2022

1 Introduction
2 SUSI Definition
3 SUSI API

SUSI – A Bridge to Simplify & Enhance H/W & Application Implementation Efficiency

When developers want to write an application that involves hardware access, they have to study the specifications to write the drivers. This is a time-consuming job and requires lots of expertise.

Advantech has done all the hard work for our customers with the release of a suite of Software APIs (Application Programming Interfaces), called Secured & Unified Smart Interface (SUSI).

SUSI provides not only the underlying drivers required but also a rich set of user-friendly, intelligent and integrated interfaces, which speeds development, enhances security and offers add-on value for Advantech platforms. SUSI plays the role of catalyst between developer and solution, and makes Advantech embedded platforms easier and simpler to adopt and operate with customer applications.

1.1 Functions

1.1.1 GPIO

General Purpose Input/Output is a flexible parallel interface that allows a variety of custom connections. It supports various Digital I/O devices – input devices like buttons, switches; output devices such as cash drawers, LED lights…etc. And, allows users to monitor the level of signal input or set the output status to switch on/off the device. Our APIs also provided Programmable GPIO and allows developers to dynamically set the GPIO input or output status.

1.1.2 SMBus [x86 only and RISC is unavailable]

SMBus is the System Management Bus defined by Intel Corporation in 1995. It is used in personal computers and servers for low-speed system management communications. Today, SMBus is used in all types of embedded systems. The SMBus APIs allows a developer to interface a platform to a downstream embedded system environment and transfer serial messages using the SMBus protocols, allowing multiple simultaneous device control.

1.1.3 I²C

I²C is a bi-directional two wire bus that was developed by Philips for use in their televisions in the 1980s. Today, I²C is used in all types of embedded systems. The I²C API allows a developer to interface a platform to a downstream embedded system environment and transfer serial messages using the I²C protocols, allowing multiple simultaneous device control.

1.1.4 Watchdog

A watchdog timer (WDT) is a device or electronic card that performs a specific operation after a certain period of time if something goes wrong with an electronic system and the system does not recover on its own.

A watchdog timer can be programmed to perform a warm boot (restarting the system) after a certain number of seconds during which a program or computer fails to respond following the most recent mouse click or keyboard action.

1.1.5 Hardware Monitor [x86 only and RISC is limited in some features]

The Hardware Monitor (HWM) APIs is a system health supervision API that inspects certain condition indexes, such as smart fan, fan speed, temperature, current, case open and voltage.

1.1.6 Backlight Control

The Backlight Control APIs allows a developer to interface platform to easily control brightness through PWM and backlight on/off.

1.1.7 Storage [x86 only and RISC is unavailable]

Storage is a non-volatile storage, the storage APIs allows a developer to access storage information, read/write data to storage and lock/unlock data area (same like write protection) by a key.

1.1.8 Thermal Protection [x86 only and RISC is unavailable]

Thermal Protection can select a thermal source to monitor. When source temperature reach the limit, SUSI can act protect function to protect system.

1.2 Benefits

Faster Time to Market

SUSI's unified API helps developers write applications to control the hardware without knowing the hardware specs of the chipsets and driver architecture.

Reduced Project Effort

When customers have their own devices connected to the onboard bus, they can either: study the data sheet and write the driver & API from scratch, or they can use SUSI to start the integration with a 50% head start. Developers can reference the sample program on the CD to see and learn more about the software development environment.

Enhances Hardware Platform Reliability

SUSI provides a trusted custom ready solution which combines chipset and library function support, controlling application development through SUSI enhances reliability and brings peace of mind.

Flexible Upgrade Possibilities

SUSI supports an easy upgrade solution for customers. Customers just need to install the new version SUSI that supports the new functions.

Backward compatibility

Support SUSI 3.0, iManager 2.0 and EAPI 1.0 interface. Customers don’t need to change any APIs in their applications.

1.3 Environment Requirements

1.3.1Operating Systems

Windows XP Embedded

Windows XP 32-bit

Windows 7 (x86 / x64)

WES7 (x86 / x64)

Windows 8 Desktop (x86 / x64)

Windows 10 (x86 / x64)

Windows CE 5 / 6 / 7

RISC Yocto 2.1

Linux (Project based, request from your local FAE)

Android (Project based, request from your local FAE)

QNX (Project based, request from your local FAE)

VxWorks (Project based, request from your local FAE)

Susi4.h file includes the API declaration, constants and flags that are required for programming.

2.1 Status Codes

All SUSI API functions immediately return a status code from a common list of possible errors. Any function may return any of the defined status codes. See the Appendix for more detailed information.

#define SUSI_STATUS_NOT_INITIALIZED					    0xFFFFFFFF

Description

The SUSI API library is not yet or unsuccessfully initialized. SusiLibInitialize needs to be called prior to the first access of any other SUSI API functions.

Actions

Call SusiLibInitialize.

#define SUSI_STATUS_INITIALIZED						    0xFFFFFFFE

Description

Library is initialized.

Actions

None.

#define SUSI_STATUS_ALLOC_ERROR						    0xFFFFFFFD

Description

Memory Allocation Error.

Actions

Free memory and try again.

#define SUSI_STATUS_DRIVER_TIMEOUT						0xFFFFFFFC

Description

Time out in driver. This is Normally caused by hardware/software semaphore timeout.

Actions

Retry.

#define SUSI_STATUS_INVALID_PARAMETER					0xFFFFFEFF

Description

One or more of the SUSI API functions call parameters are out of defined range.

Actions

Verify Function Parameters.

#define SUSI_STATUS_INVALID_BLOCK_ALIGNMENT			0xFFFFFEFE

Description

The Block Alignment is incorrect.

Actions

Use Inputs and Outputs to correctly select input and outputs.

#define SUSI_STATUS_INVALID_BLOCK_LENGTH				0xFFFFFEFD

Description

This means that the Block length is too long.

Actions

Use Alignment Capabilities information to correctly align write access.

#define SUSI_STATUS_INVALID_DIRECTION					0xFFFFFEFC

Description

The current Direction Argument attempts to set GPIOs to a unsupported direction. I.E. Setting GPI to Output.

Actions

Use Inputs and Outputs to correctly select input and outputs.

#define SUSI_STATUS_INVALID_BITMASK					0xFFFFFEFB

Description

The Bitmask Selects bits/GPIOs which are not supported for the current ID.

Actions

Use Inputs and Outputs to probe supported bits.

#define SUSI_STATUS_RUNNING							0xFFFFFEFA

Description

Watchdog timer already started.

Actions

Call SusiWDogStop before retrying.

#define SUSI_STATUS_UNSUPPORTED						0xFFFFFCFF

Description

This function or ID is not supported at the actual hardware environment.

Actions

None.

#define SUSI_STATUS_NOT_FOUND							0xFFFFFBFF

Description

Selected device was not found

Actions

None.

#define SUSI_STATUS_TIMEOUT							0xFFFFFBFE

Description

Device has no response.

Actions

None.

#define SUSI_STATUS_BUSY_COLLISION						0xFFFFFBFD

Description

The selected device or ID is busy or a data collision is detected.

Actions

Retry.

#define SUSI_STATUS_READ_ERROR							0xFFFFFAFF

Description

An error is detected during a read operation.

Actions

Retry.

#define SUSI_STATUS_WRITE_ERROR						0xFFFFFAFE

Description

An error is detected during a write operation.

Actions

Retry.

#define SUSI_STATUS_MORE_DATA							0xFFFFF9FF

Description

The amount of available data exceeds the buffer size. Storage buffer overflow was prevented. Read count was larger than the defined buffer length.

Actions

Either increase the buffer size or reduce the block length.

#define SUSI_STATUS_ERROR								0xFFFFF0FF

Description

Generic error message. No further error details are available.

Actions

None.

#define SUSI_STATUS_SUCCESS					0

Description

The operation is successful.

Actions

None.

2.2 ID

#define SUSI_ID_UNKNOWN					0xFFFFFFFF

Description

Undefined/Unknown ID

#define SUSI_ID_BOARD_MANUFACTURER_STR			0
#define SUSI_ID_BOARD_NAME_STR				1
#define SUSI_ID_BOARD_REVISION_STR			2
#define SUSI_ID_BOARD_SERIAL_STR			3
#define SUSI_ID_BOARD_BIOS_REVISION_STR			4
#define SUSI_ID_BOARD_HW_REVISION_STR			5
#define SUSI_ID_BOARD_PLATFORM_TYPE_STR			6
#define SUSI_ID_BOARD_EC_FW_STR				7

Description

Board information string ID, use in SusiBoardGetStringA.

#define SUSI_ID_GET_SPEC_VERSION&nbsp				0x00000000
#define SUSI_ID_BOARD_BOOT_COUNTER_VAL				0x00000001
#define SUSI_ID_BOARD_RUNNING_TIME_METER_VAL			0x00000002
#define SUSI_ID_BOARD_PNPID_VAL					0x00000003
#define SUSI_ID_BOARD_PLATFORM_REV_VAL				0x00000004
#define SUSI_ID_BOARD_DRIVER_VERSION_VAL			0x00010000
#define SUSI_ID_BOARD_LIB_VERSION_VAL				0x00010001
#define SUSI_ID_BOARD_FIRMWARE_VERSION_VAL			0x00010002

Description

Board information value ID, use in SusiBoardGetValue.

#define SUSI_ID_HWM_TEMP_CPU					0x00020000
#define SUSI_ID_HWM_TEMP_CHIPSET				0x00020001
#define SUSI_ID_HWM_TEMP_SYSTEM					0x00020002
#define SUSI_ID_HWM_TEMP_CPU2					0x00020003
#define SUSI_ID_HWM_TEMP_OEM0					0x00020004
#define SUSI_ID_HWM_TEMP_OEM1					0x00020005
#define SUSI_ID_HWM_TEMP_OEM2					0x00020006
#define SUSI_ID_HWM_TEMP_OEM3					0x00020007
#define SUSI_ID_HWM_TEMP_OEM4					0x00020008 
#define SUSI_ID_HWM_TEMP_OEM5					0x00020009

Description

Board temperature value ID, use in SusiBoardGetValue.

#define SUSI_ID_HWM_VOLTAGE_VCORE				0x00021000
#define SUSI_ID_HWM_VOLTAGE_VCORE2				0x00021001
#define SUSI_ID_HWM_VOLTAGE_2V5					0x00021002
#define SUSI_ID_HWM_VOLTAGE_3V3					0x00021003
#define SUSI_ID_HWM_VOLTAGE_5V					0x00021004
#define SUSI_ID_HWM_VOLTAGE_12V					0x00021005
#define SUSI_ID_HWM_VOLTAGE_5VSB				0x00021006
#define SUSI_ID_HWM_VOLTAGE_3VSB				0x00021007
#define SUSI_ID_HWM_VOLTAGE_VBAT				0x00021008
#define SUSI_ID_HWM_VOLTAGE_5NV					0x00021009
#define SUSI_ID_HWM_VOLTAGE_12NV				0x0002100A
#define SUSI_ID_HWM_VOLTAGE_VTT					0x0002100B
#define SUSI_ID_HWM_VOLTAGE_24V					0x0002100C
#define SUSI_ID_HWM_VOLTAGE_DC					0x0002100D
#define SUSI_ID_HWM_VOLTAGE_DCSTBY				0x0002100E
#define SUSI_ID_HWM_VOLTAGE_OEM3				0x0002100F
#define SUSI_ID_HWM_VOLTAGE_OEM0				0x00021010
#define SUSI_ID_HWM_VOLTAGE_OEM1				0x00021011
#define SUSI_ID_HWM_VOLTAGE_OEM2				0x00021012
#define SUSI_ID_HWM_VOLTAGE_OEM3				0x00021013
#define SUSI_ID_HWM_VOLTAGE_1V05				0x00021014
#define SUSI_ID_HWM_VOLTAGE_1V5					0x00021015
#define SUSI_ID_HWM_VOLTAGE_1V8					0x00021016

Description

Board voltage value ID, use in SusiBoardGetValue.

#define SUSI_ID_HWM_FAN_CPU					0x00022000
#define SUSI_ID_HWM_FAN_SYSTEM					0x00022001
#define SUSI_ID_HWM_FAN_CPU2					0x00022002
#define SUSI_ID_HWM_FAN_OEM0					0x00022003
#define SUSI_ID_HWM_FAN_OEM1					0x00022004
#define SUSI_ID_HWM_FAN_OEM2					0x00022005
#define SUSI_ID_HWM_FAN_OEM3					0x00022006
#define SUSI_ID_HWM_FAN_OEM4					0x00022007
#define SUSI_ID_HWM_FAN_OEM5					0x00022008
#define SUSI_ID_HWM_FAN_OEM6					0x00022009

Description

Board fan speed value ID, use in SusiBoardGetValue and Smart Fan Functions.

#define SUSI_ID_HWM_CURRENT_OEM0					0x00023000
#define SUSI_ID_HWM_CURRENT_OEM1					0x00023001
#define SUSI_ID_HWM_CURRENT_OEM2					0x00023002

Description

Board current value ID, use in SusiBoardGetValue.

#define SUSI_ID_SMBUS_SUPPORTED					0x00030000
#define SUSI_ID_I2C_SUPPORTED					0x00030100

Description

Board supported information value ID, use in SusiBoardGetValue.

#define SUSI_ID_SMBUS_EXTERNAL					0
#define SUSI_ID_SMBUS_OEM0					1
#define SUSI_ID_SMBUS_OEM1					2
#define SUSI_ID_SMBUS_OEM2					3
#define SUSI_ID_SMBUS_OEM3					4

Description

SMBus device ID, use in SMBus Functions.

#define SUSI_ID_I2C_EXTERNAL					0
#define SUSI_ID_I2C_OEM0					1
#define SUSI_ID_I2C_OEM1					2
#define SUSI_ID_I2C_OEM2					3

Description

I²C device ID, use in I2C Functions.

#define SUSI_ID_GPIO(GPIO_NUM)					(GPIO_NUM)
#define SUSI_ID_GPIO_BANK(BANK_NUM)					(0x00010000 + BANK_NUM)

Description

GPIO device ID, use in GPIO Functions.

#define SUSI_ID_BACKLIGHT_1					0
#define SUSI_ID_BACKLIGHT_2					1
#define SUSI_ID_BACKLIGHT_3					2

Description

Backlight device ID, use in Backlight Functions.

#define SUSI_ID_STORAGE_STD					0x00000000
#define SUSI_ID_STORAGE_OEM0					0x00000001
#define SUSI_ID_STORAGE_OEM1					0x00000002

Description

Storage device ID, use in Storage Functions.

#define SUSI_ID_THERMAL_PROTECT_1					0
#define SUSI_ID_THERMAL_PROTECT_2					1
#define SUSI_ID_THERMAL_PROTECT_3					2
#define SUSI_ID_THERMAL_PROTECT_4					3

Description

Thermal protection device ID, use in Thermal Protection Functions

#define SUSI_ID_WATCHDOG_1					0
#define SUSI_ID_WATCHDOG_2					1
#define SUSI_ID_WATCHDOG_3					2

Description

Watchdog device ID, use in Watchdog Functions.

2.3 Item ID

#define SUSI_ID_I2C_MAXIMUM_BLOCK_LENGTH			0x00000000

Description

Watchdog capabilities item ID, use in SusiI2CGetCaps.

#define SUSI_ID_GPIO_INPUT_SUPPORT				0x00000000
#define SUSI_ID_GPIO_OUTPUT_SUPPORT				0x00000001

Description

GPIO capabilities item ID, use in SusiGPIOGetCaps.

#define SUSI_ID_VGA_BRIGHTNESS_MAXIMUM				0x00010000
#define SUSI_ID_VGA_BRIGHTNESS_MINIMUM				0x00010001

Description

VGA capabilities item ID, use in SusiVgaGetCaps.

#define SUSI_ID_STORAGE_TOTAL_SIZE				0x00000000
#define SUSI_ID_STORAGE_BLOCK_SIZE				0x00000001
#define SUSI_ID_STORAGE_LOCK_STATUS				0x00010000
#define SUSI_ID_STORAGE_PSW_MAX_LEN				0x00010000

Description

Storage capabilities item ID, use in SusiStorageGetCaps.

#define SUSI_ID_WDT_SUPPORT_FLAGS				0x00000000
#define SUSI_ID_WDT_DELAY_MAXIMUM				0x00000001
#define SUSI_ID_WDT_DELAY_MINIMUM				0x00000002
#define SUSI_ID_WDT_EVENT_MAXIMUM				0x00000003
#define SUSI_ID_WDT_EVENT_MINIMUM				0x00000004
#define SUSI_ID_WDT_RESET_MAXIMUM				0x00000005
#define SUSI_ID_WDT_RESET_MINIMUM				0x00000006
#define SUSI_ID_WDT_UNIT_MINIMUM				0x0000000F
#define SUSI_ID_WDT_DELAY_TIME					0x00010001
#define SUSI_ID_WDT_EVENT_TIME					0x00010002
#define SUSI_ID_WDT_RESET_TIME					0x00010003
#define SUSI_ID_WDT_EVENT_TYPE					0x00010004

Description

Watchdog capabilities item ID, use in SusiWDogGetCaps.

#define SUSI_ID_FC_CONTROL_SUPPORT_FLAGS			0x00000000
#define SUSI_ID_FC_AUTO_SUPPORT_FLAGS				0x00000001

Description

Fan control capabilities item ID, use in SusiFanControlGetCaps.

#define SUSI_ID_TP_EVENT_SUPPORT_FLAGS				0x00000000
#define SUSI_ID_TP_EVENT_TRIGGER_MAXIMUM			0x00000001
#define SUSI_ID_TP_EVENT_TRIGGER_MINIMUM			0x00000002
#define SUSI_ID_TP_EVENT_CLEAR_MAXIMUM				0x00000003
#define SUSI_ID_TP_EVENT_CLEAR_MINIMUM				0x00000004

Description

Thermal protection capabilities item ID, use in SusiThermalProtectionGetCaps.

The SUSI APIs provide functions to control ADVANTECH platforms. SUSI API functions are based on a dynamic library. SUSI API can be implemented in various other programming languages.

3.1 Initialization Functions

3.1.1 SusiLibInitialize

uint32_t SUSI_API SusiLibInitialize(void)

Description:

General initialization of the SUSI API. Prior to calling any SUSI API functions, the library needs to be initialized by calling this function. The status code for all SUSI API function will be SUSI_STATUS_NOT_INITIALIZED unless this function is called.

Parameters:

None

Return Status Code:

Condition	Return Value
Library initialized	SUSI_STATUS_INITIALIZED
Fail	SUSI_STATUS_NOT_INITIALIZED
Success	SUSI_STATUS_SUCCESS

3.1.2 SusiLibUninitialize

uint32_t SUSI_API SusiLibUninitialize(void)

Description:

General function to uninitialize the SUSI API library that should be called before program exit.

Parameters:

None

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Success	SUSI_STATUS_SUCCESS

3.2 Information Functions

3.2.1 SusiBoardGetValue

uint32_t SUSI_API SusiBoardGetValue(uint32_t Id, uint32_t *pValue)

Description:

Getting information about the hardware platform in value format.

Parameters:

Id

Selects target value. See Table 1 to Table 5.

pValue

Pointer to a buffer that receives the value's data.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 1 Board information value ID

Id	Description	Unit
SUSI_ID_GET_SPEC_VERSION	API Specification Version
SUSI_ID_BOARD_BOOT_COUNTER_VAL	Boot Counter	boot
SUSI_ID_BOARD_RUNNING_TIME_METER_VAL	Running Time Meter	hour
SUSI_ID_BOARD_PNPID_VAL	Board Vendor PNPID
SUSI_ID_BOARD_PLATFORM_REV_VAL	Platform revision
SUSI_ID_BOARD_DRIVER_VERSION_VAL	Driver version
SUSI_ID_BOARD_LIB_VERSION_VAL	Library version
SUSI_ID_BOARD_FIRMWARE_VERSION_VAL	Firmware version

Table 2 Board voltage value ID

Id	Description	Unit
SUSI_ID_HWM_VOLTAGE_VCORE	CPU Core voltage	millivolt
SUSI_ID_HWM_VOLTAGE_VCORE2	Second CPU Core voltage	millivolt
SUSI_ID_HWM_VOLTAGE_2V5	2.5V	millivolt
SUSI_ID_HWM_VOLTAGE_3V3	3.3V	millivolt
SUSI_ID_HWM_VOLTAGE_5V	5V	millivolt
SUSI_ID_HWM_VOLTAGE_12V	12V	millivolt
SUSI_ID_HWM_VOLTAGE_5VSB	5V Standby	millivolt
SUSI_ID_HWM_VOLTAGE_3VSB	3V Standby	millivolt
SUSI_ID_HWM_VOLTAGE_VBAT	CMOS Battery voltage	millivolt
SUSI_ID_HWM_VOLTAGE_5NV	-5V	millivolt
SUSI_ID_HWM_VOLTAGE_12NV	-12V	millivolt
SUSI_ID_HWM_VOLTAGE_VTT	DIMM voltage	millivolt
SUSI_ID_HWM_VOLTAGE_24V	24V	millivolt
SUSI_ID_HWM_VOLTAGE_OEM0~3	Other voltages	millivolt

Table 3 Board temperature value ID

Id	Description	Unit
SUSI_ID_HWM_TEMP_CPU	CPU temperature	0.1 Kelvin
SUSI_ID_HWM_TEMP_CHIPSET	Chipset temperature	0.1 Kelvin
SUSI_ID_HWM_TEMP_SYSTEM	System temperature	0.1 Kelvin
SUSI_ID_HWM_TEMP_CPU2	CPU2 temperature	0.1 Kelvin
SUSI_ID_HWM_TEMP_OEM0~5	Other temperatures	0.1 Kelvin

Table 4 Board fan speed value ID

Id	Description	Unit
SUSI_ID_HWM_FAN_CPU	CPU fan speed	RPM
SUSI_ID_HWM_FAN_SYSTEM	System fan speed	RPM
SUSI_ID_HWM_FAN_CPU2	Second CPU fan speed	RPM
SUSI_ID_HWM_FAN_OEM0~6	Other fans	RPM

Table 5 Board support information value ID

Id

Description

SUSI_ID_SMBUS_SUPPORTED

Mask flags:

SUSI_SMBUS_EXTERNAL_SUPPORTED

SUSI_SMBUS_OEM0_SUPPORTED

SUSI_SMBUS_OEM1_SUPPORTED

SUSI_SMBUS_OEM2_SUPPORTED

SUSI_SMBUS_OEM3_SUPPORTED

SUSI_ID_I2C_SUPPORTED

Mask flags:

SUSI_ I2C_EXTERNAL_SUPPORTED

SUSI_ I2C_OEM0_SUPPORTED

SUSI_ I2C_OEM1_SUPPORTED

SUSI_ I2C_OEM2_SUPPORTED

3.2.2 SusiBoardGetStringA

uint32_t SUSI_API SusiBoardGetStringA(uint32_t Id, char *pBuffer, uint32_t *pBufLen)

Description:

Text information about the hardware platform.

Parameters:

Id

Selects target string. See Table 6.

pBuffer

Pointer to a buffer that receives the value's data.

pBufLen

Pointer to a variable that specifies the size, in bytes, of the buffer pointed to by the pBuffer parameter. When the function returns, this variable contains the size of the data copied to pBuffer including the terminating null character.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBufLen==NULL	SUSI _STATUS_INVALID_PARAMETER
pBufLen!=NULL&&*pBufLen&&pBuffer==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
strlength + 1 > *pBufLen	SUSI_STATUS_MORE_DATA
Success	SUSI_STATUS_SUCCESS

Table 6 Board information string ID

Id	Description
SUSI_ID_BOARD_MANUFACTURER_STR	Board Manufacturer Name
SUSI_ID_BOARD_NAME_STR	Board Name
SUSI_ID_BOARD_REVISION_STR	Board Revision
SUSI_ID_BOARD_SERIAL_STR	Board Serial Number
SUSI_ID_BOARD_BIOS_REVISION_STR	Board BIOS Revision
SUSI_ID_BOARD_HW_REVISION_STR	Hardware Revision
SUSI_ID_BOARD_PLATFORM_TYPE_STR	Platform type
SUSI_ID_BOARD_EC_FW_STR	EC FW

3.3 Backlight Functions

This function sub set facilitates backlight control for Integrated flat panel displays, typically LVDS.

Table 7 Backlight ID

Id	Description
SUSI_ID_BACKLIGHT_1	Backlight Local Flat Panel 1
SUSI_ID_BACKLIGHT_2	Backlight Local Flat Panel 2
SUSI_ID_BACKLIGHT_3	Backlight Local Flat Panel 3

Table 8 Backlight Enable Values

Name	Description
SUSI_BACKLIGHT_SET_ON	Signifies that the Backlight be Enabled
SUSI_BACKLIGHT_SET_OFF	Signifies that the Backlight be Disabled

3.3.1 SusiVgaGetCaps

uint32_t SUSI_API SusiVgaGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue);

Description:

Gets VGA capabilities.

Parameters:

Id

Selects target device. See Table 7.

ItemId

Selects target capability. See Table 9.

pValue

Pointer to a buffer that receives the target capability.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id or ItemId	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 9 VGA capabilities item Id

Item Id	Description
SUSI_ID_VGA_BRIGHTNESS_MAXIMUM	Maximum backlight value
SUSI_ID_VGA_BRIGHTNESS_MINIMUM	Minimum backlight value

3.3.2 SusiVgaGetBacklightEnable

uint32_t SUSI_API SusiVgaGetBacklightEnable(uint32_t Id, uint32_t *pEnable)

Description:

Gets current Backlight Enable state for specified Flat Panel.

Parameters:

Id

Selects target device. See Table 7.

pEnable

Pointer to a buffer that receives the current backlight enable state. See Table 8.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pEnable==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.3.3 SusiVgaSetBacklightEnable

uint32_t SUSI_API SusiVgaSetBacklightEnable(uint32_t Id, uint32_t Enable)

Description:

Enables or disable the backlight of the selected flat panel display

Parameters:

Id

Selects target device. See Table 7.

Enable

Backlight Enable options. See Table 8.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.3.4 SusiVgaGetBacklightBrightness

uint32_t SUSI_API SusiVgaGetBacklightBrightness(uint32_t Id, uint32_t *pBright)

Description:

Reads the current brightness of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

pBright

Pointer to a buffer that receives the current backlight brightness value.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBright==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.3.5 SusiVgaSetBacklightBrightness

uint32_t SUSI_API SusiVgaSetBacklightBrightness(uint32_t Id, uint32_t Bright)

Description:

Reads the current brightness of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

Bright

Backlight Brightness value.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Bright > MAX value \|\| Bright < MIN value	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.3.6 SusiVgaGetBacklightLevel

uint32_t SUSI_API SusiVgaGetBacklightLevel(uint32_t Id, uint32_t *pLevel)

Description:

Reads the current brightness level of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

pLevel

Pointer to a buffer that receives the current backlight brightness level. See Table 10.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pLevel==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 10 Brightness level range definition

Name	Description
SUSI_BACKLIGHT_LEVEL_MAXIMUM	Maximum backlight level is 9
SUSI_BACKLIGHT_LEVEL_MINIMUM	Minimum backlight level is 0

3.3.7 SusiVgaSetBacklightLevel

uint32_t SUSI_API SusiVgaSetBacklightLevel(uint32_t Id, uint32_t Level)

Description:

Sets the brightness level of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

Level

Backlight Brightness level. See Table 10.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Level>SUSI_BACKLIGHT_LEVEL_MAXIMUM	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.3.8 SusiVgaGetPolarity

uint32_t SUSI_API SusiVgaGetPolarity(uint32_t Id, uint32_t *pPolarity)

Description:

Reads the current backlight polarity of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

pPolarity

Pointer to a buffer that receives the current backlight polarity. See Table 11.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pPolarity==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 11 Brightness polarity definition

Name	Description
SUSI_BACKLIGHT_POLARITY_ON	Backlight signal polarity ON
SUSI_BACKLIGHT_ POLARITY_OFF	Backlight signal polarity OFF

3.3.9 SusiVgaSetPolarity

uint32_t SUSI_API SusiVgaSetPolarity(uint32_t Id, uint32_t Polarity)

Description:

Sets the polarity of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

Polarity

Polarity state. See Table 11.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.3.10 SusiVgaGetFrequency

uint32_t SUSI_API SusiVgaGetFrequency(uint32_t Id, uint32_t *pFrequency)

Description:

Reads the current backlight frequency of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

pFrequency

Pointer to a buffer that receives the current backlight frequency. (Unit: Hz)

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pFrequency==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.3.11SusiVgaSetFrequency

uint32_t SUSI_API SusiVgaSetFrequency(uint32_t Id, uint32_t Frequency)

Description:

Sets the frequency of the selected flat panel display.

Parameters:

Id

Selects target device. See Table 7.

Polarity

Frequency value. (Unit: Hz)

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.4 I2C Functions

I²C APIs support standard 7 and 10 bits slave address mode. I²C APIs also support word command, it needs encode before set to parameter, see Table 13

Table 12 I²C ID

Id	Description
SUSI_ID_I2C_EXTERNAL	Main I²C host device
SUSI_ID_I2C_OEM0~2	Other I²C host devices

Table 13 I²C command encode

Type	Description
Standard command	Byte command
Extend command	Word command \| 0x80000000 Ex. 0x8000FABC
No command	0x4000xxxx, ignore command parameter

3.4.1 SusiI2CGetCaps

uint32_t SUSI_API SusiI2CGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)

Description:

Gets I²C capabilities.

Parameters:

Id

Selects target device. See Table 12.

ItemId

Selects target capability. See Table '14'.

pValue

Pointer to a buffer that receives the target capability.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id or ItemId	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 14 I²C capabilities item Id

Item Id	Description
SUSI_ID_I2C_MAXIMUM_BLOCK_LENGTH	I²C maximum block length

3.4.2 SusiI2CWriteReadCombine

uint32_t SUSI_API SusiI2CWriteReadCombine(uint32_t Id, uint8_t Addr, uint8_t *pWBuffer, uint32_t WriteLen, uint8_t *pRBuffer, uint32_t ReadLen)

Description:

Universal function for read and write operations to the I²C bus.

Parameters:

Id

Selects target device. See Table '14'.

Addr

First byte of I²C device address. 7-bit address only

pWBuffer

Pointer to a buffer containing the data to be transferred. This parameter can be NULL if the data is not required.

WriteLen

Size in bytes of the information pointed to by the pWBuffer parameter. If pWBuffer is NULL this will be ignored.

pRBuffer

Pointer to a buffer that receives the read data. This parameter can be NULL if the data is not required.

ReadLen

Size in bytes of the buffer pointed to by the pRBuffer parameter. If pRBuffer is NULL this will be ignored.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
(WriteLen>1)&&(pWBuffer==NULL)	SUSI _STATUS_INVALID_PARAMETER
(RBufLen>1)&&(pRBuffer==NULL)	SUSI _STATUS_INVALID_PARAMETER
(WriteLen==0)&&(RBufLen==0)	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.4.3 SusiI2CReadTransfer

uint32_t SUSI_API SusiI2CReadTransfer(uint32_t Id, uint32_t Addr, uint32_t Cmd, uint8_t *pBuffer, uint32_t ReadLen)

Description:

Reads from a specific register in the selected I²C device. Reads from I²C device at the I²C address Addr the amount of ReadLen bytes to the buffer pBuffer while using the device specific command Cmd. Depending on the addressed I²C device Cmd can be a specific command or a byte offset.

Parameters:

Id

Selects target device. See Table '14'.

Addr

Encoded 7/10 Bit I²C Device Address.

Cmd

Encoded I²C Device Command / Index. See Table '13'.

pBuffer

Pointer to a buffer that receives the read data.

ReadLen

Size in bytes of the buffer pointed to by the pBuffer parameter.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL \|\| ReadLen==0	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.4.4 SusiI2CWriteTransfer

uint32_t SUSI_API SusiI2CWriteTransfer(uint32_t Id, uint32_t Addr, uint32_t Cmd, uint8_t *pBuffer, uint32_t ByteCnt)

Description:

Write to a specific register in the selected I²C device. Writes to an I²C device at the I²C address Addr the amount of ByteCnt bytes from the buffer *pBuffer while using the device specific command Cmd. Depending on the addressed I²C device Cmd can be a specific command or a byte offset

Parameters:

Id

Selects target device. See Table '14'.

Addr

Encoded 7/10 Bit I²C Device Address.

Cmd

Encoded I²C Device Command / Index. See Table '13'.

pBuffer

Pointer to a buffer that receives the write data.

ByteCnt

Size in bytes of the buffer pointed to by the pBuffer parameter.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL \|\| ByteCnt==0	SUSI _STATUS_INVALID_PARAMETER
ByteCnt > MaxLength	SUSI_STATUS_INVALID_BLOCK_LENGTH
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.4.5 SusiI2CProbeDevice

uint32_t SUSI_API SusiI2CProbeDevice(uint32_t Id, uint32_t Addr)

Description:

Probes I²C address to test I²C device present.

Parameters:

Id

Selects target device. See Table '14'.

Addr

Encoded 7/10 Bit I²C Device Address.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.4.6 SusiI2CGetFrequency

uint32_t SUSI_API SusiI2CGetFrequency(uint32_t Id, uint32_t *pFreq)

Description:

Get I²C clock frequency.

Parameters:

Id

Selects target device. See Table '14'.

pFreq

Pointer to a buffer that receives the I²C clock frequency value. (Unit: Hz)

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
pFreq == NULL	SUSI _STATUS_INVALID_PARAMETER
Success	SUSI_STATUS_SUCCESS

3.4.7 SusiI2CSetFrequency

uint32_t SUSI_API SusiI2CSetFrequency(uint32_t Id, uint32_t Freq)

Description:

Set I²C clock frequency.

Parameters:

Id

Selects target device. See Table '14'.

Freq

I²C clock frequency value. (Unit: Hz)

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.5 SMBus Functions

SMBus is the System Management Bus defined by Intel Corporation in 1995. It is used in personal computers and servers for low-speed system management communications.

Table 15 SMBus ID

Id	Description
SUSI_ID_ SMBUS _EXTERNAL	Main SMBus host device
SUSI_ID_SMBUS_OEM0~3	Other SMBus host devices

3.5.1 SusiSMBReadByte

uint32_t SUSI_API SusiSMBReadByte(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pData)

Description:

Read a byte of data from the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to read data from.

pData

Pointer to a variable in which the function reads the byte data.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pData==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.2 SusiSMBWriteByte

uint32_t SUSI_API SusiSMBWriteByte(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t Data)

Description:

Write a byte of data to the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to write data to.

Data

Specifies the byte data to be written.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.3 SusiSMBReadWord

uint32_t SUSI_API SusiSMBReadWord(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint16_t *pData)

Description:

Read a word of data from the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to read data from.

pData

Pointer to a variable in which the function reads the word data.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pData==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.4 SusiSMBWriteWord

uint32_t SUSI_API SusiSMBWriteWord(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint16_t Data)

Description:

Write a word of data to the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to write data to.

Data

Specifies the word data to be written.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.5 SusiSMBReceiveByte

uint32_t SUSI_API SusiSMBReceiveByte(uint32_t Id, uint8_t Addr, uint8_t *pData)

Description:

Receive a byte of data from the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

pData

Pointer to a variable in which the function receive the byte data.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.6 SusiSMBSendByte

uint32_t SUSI_API SusiSMBSendByte(uint32_t Id, uint8_t Addr, uint8_t Data)

Description:

Send a byte of data to the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Data

Specifies the word data to be sent.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.7 SusiSMBReadQuick

uint32_t SUSI_API SusiSMBReadQuick(uint32_t Id, uint8_t Addr)

Description:

Turn SMBus device function off (on) or disable (enable) a specific device mode.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Success	SUSI_STATUS_SUCCESS

3.5.8 SusiSMBWriteQuick

uint32_t SUSI_API SusiSMBWriteQuick(uint32_t Id, uint8_t Addr)

Description:

Turn SMBus device function off (on) or disable (enable) a specific device mode.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Success	SUSI_STATUS_SUCCESS

3.5.9 SusiSMBReadBlock

uint32_t SUSI_API SusiSMBReadBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t *pLength)

Description:

Read multi-data from the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to read data from.

pBuffer

Pointer to a byte array in which the function reads the block data.

pLength

Pointer to a byte in which specifies the number of bytes to be read and also return succeed bytes.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.10 SusiSMBWriteBlock

uint32_t SUSI_API SusiSMBWriteBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t Length)

Description:

Write multi-data from the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to write data to.

pBuffer

Pointer to a byte array in which the function writes the block data.

Length

Specifies the number of bytes to be write.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.11 SusiSMBI2CReadBlock

uint32_t SUSI_API SusiSMBI2CReadBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t *pLength)

Description:

Read multi-data using I²C block protocol from the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to read data from.

pBuffer

Pointer to a byte array in which the function reads the block data.

pLength

Pointer to a byte in which specifies the number of bytes to be read and also return succeed bytes.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.5.12 SusiSMBI2CWriteBlock

uint32_t SUSI_API SusiSMBI2CWriteBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t Length)

Description:

Write multi-data using I²C block protocol from the target slave device in the SMBus.

Parameters:

Id

Selects target device. See Table '15'.

Addr

Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.

Cmd

Specifies the offset or command of the device register to write data to.

pBuffer

Pointer to a byte array in which the function writes the block data.

Length

Specifies the number of bytes to be write.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device unsupported	SUSI _STATUS_UNSUPPORTED
Bus Busy SDA/SDC low	SUSI_STATUS_BUSY_COLLISION
Arbitration Error/Collision Error On Write 1 write cycle SDA Remains low	SUSI_STATUS_BUSY_COLLISION
Time-out due to clock stretching	SUSI_STATUS_TIMEOUT
Address Non-ACK	SUSI_STATUS_NOT_FOUND
Write Non-ACK	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.6 Watchdog Functions

After the watchdog timer has been start function it must be triggered within (Delay + Event Timeout) milliseconds as set with the start function, following the initial trigger every subsequent trigger must occur within (Event Timeout) milliseconds. Should trigger not be called within the relevant time limit a system reset will occur. The SUSI watchdog timer may support two stages. If the watchdog is not triggered within the event timeout, an NMI, IRQ, or hardware output will be generated. Then the reset timeout becomes active. If the watchdog timer is not triggered within the reset timeout a reset will be generated

Initial timing:

Timing after trigger:

Where:

Stage A

Watchdog is started.

Stage B

Initial Delay Period is exhausted.

Stage C/F

Event is triggered, NMI, IRQ, or PIN is Triggered. To Allow for possible Software Recovery.

Stage D/G

System is reset.

Stage E

Watchdog is Triggered.
Trigger / Stop must be called before Stage C/F to prevent event from being generated.
Trigger / Stop must be called before Stage D/G to prevent The system from being reset.

Table 16 Watchdog ID

Id	Description
SUSI_ID_WATCHDOG_1	First watchdog timer
SUSI_ID_WATCHDOG_2	Second watchdog timer
SUSI_ID_WATCHDOG_3	Third watchdog timer

3.6.1 SusiWDogGetCaps

uint32_t SUSI_API SusiWDogGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)

Description:

Gets watchdog capabilities.

Parameters:

Id

Selects target device. See Table 16.

ItemId

Selects target capability. See Table 17.

pValue

Pointer to a buffer that receives the target capability.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id or ItemId	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 17 Watchdog capabilities item Id

Item Id	Description
SUSI_ID_WDT_SUPPORT_FLAGS	Event support flags (Table 18)
SUSI_ID_WDT_DELAY_MAXIMUM	The maximum delay time value
SUSI_ID_WDT_DELAY_MINIMUM	The minimum delay time value
SUSI_ID_WDT_EVENT_MAXIMUM	The maximum event time value
SUSI_ID_WDT_EVENT_MINIMUM	The minimum event time value
SUSI_ID_WDT_RESET_MAXIMUM	The maximum reset time value
SUSI_ID_WDT_RESET_MINIMUM	The minimum reset time value
SUSI_ID_WDT_UNIT_MINIMUM	The minimum unit value
SUSI_ID_WDT_DELAY_TIME	Current delay time setting
SUSI_ID_WDT_EVENT_TIME	Current event time setting
SUSI_ID_WDT_RESET_TIME	Current reset time setting
SUSI_ID_WDT_EVENT_TYPE	Current event type (Table 19)

3.6.2 SusiWDogStart

uint32_t SUSI_API SusiWDogStart(uint32_t Id, uint32_t DelayTime, uint32_t EventTime, uint32_t ResetTime, uint32_t EventType)

Description:

Start the watchdog timer and set the parameters. To adjust the parameters, the watchdog must be stopped and then start again with the new values. If the hardware implementation of the watchdog timer does not allow a setting at the exact time selected, the SUSI API selects the next possible longer timing.

Parameters:

Id

Selects target device. See Table 16.

DelayTime

Initial delay for the watchdog timer in milliseconds.

EventTime

Watchdog timeout interval in milliseconds to trigger an event.

ResetTime

Watchdog timeout interval in milliseconds to trigger a reset.

EventType

To select one kind of event type. See Table 19.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Wrong time range	SUSI _STATUS_INVALID_PARAMETER
Success	SUSI_STATUS_SUCCESS

Table 18 Watchdog Support Flags

Flag Name	Description	Value
SUSI_WDT_FLAG_SUPPORT_IRQ	Support IRQ event	0x01
SUSI_WDT_FLAG_SUPPORT_SCI	Support SCI event	0x02
SUSI_WDT_FLAG_SUPPORT_PWRBTN	Support power button event	0x04

Table 19 Watchdog timer event type

Event Type	Description
SUSI_WDT_EVENT_TYPE_NONE	No event
SUSI_WDT_EVENT_TYPE_SCI	SCI event
SUSI_WDT_EVENT_TYPE_IRQ	IRQ event
SUSI_WDT_EVENT_TYPE_PWRBTN	Power button event

3.6.3 SusiWDogStop

uint32_t SUSI_API SusiWDogStop(uint32_t Id)

Description:

Stops the operation of the watchdog timer.

Parameters:

Id

Selects target device. See Table 16.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.6.4 SusiWDogTrigger

uint32_t SUSI_API SusiWDogTrigger(uint32_t Id)

Description:

Trigger the watchdog timer.

Parameters:

Id

Selects target device. See Table 16.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.6.5 SusiWDogSetCallBack

uint32_t SUSI_API SusiWDogSetCallBack(uint32_t Id, SUSI_WDT_INT_CALLBACK pfnCallback, void *Context)

Description:

The call back function pointer can be transmit from Application when IRQ triggered.

Parameters:

Id

Selects target device. See Table 16.

pfnCallback

Call back function pointer, SUSI_WDT_INT_CALLBACK is function pointer type, it can set NULL to clear. The type definition just like show below,

typedef void (*SUSI_WDT_INT_CALLBACK)(void*);

Context

Pointer to a user context structure for callback function.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.7 GPIO Functions

Programmable GPIO allows developers to dynamically set the GPIO input or output status

Table 20 GPIO ID

Id

Description

SUSI_ID_GPIO(X)

X is GPIO pin number, definition as below:

define SUSI_ID_GPIO(x) (0x0000 | x)

This ID control single pin only.

SUSI_ID_GPIO_BANK(Y)

Y is GPIO bank number, definition as below:

define SUSI_ID_GPIO_BANK(Y) (0x10000 | Y)

This ID control maximum 32 pins per bank.

3.7.1 SusiGPIOGetCaps

uint32_t SUSI_API SusiGPIOGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)

Description:

Reads the capabilities of the current GPIO implementation from the selected GPIO interface.

Parameters:

Id

Selects target device. See Table 20.

ItemId

Selects target capability. See Table 21.

pValue

Pointer to a buffer that receives the target capability. Each bit of the buffer value represents support situation of a GPIO, according to the order. 1 is supportive, and 0 is unsupportive.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 21 GPIO capabilities item Id

Item Id	Description
SUSI_ID_GPIO_INPUT_SUPPORT	Get GPIO input support state
SUSI_ID_GPIO_OUTPUT_SUPPORT	Get GPIO output support state

3.7.2 SusiGPIOGetDirection

uint32_t SUSI_API SusiGPIOGetDirection(uint32_t Id, uint32_t Bitmask, uint32_t *pDirection)

Description:

Gets the configuration for the selected GPIO ports.

Parameters:

Id

Selects target device. See Table 20.

Bitmask

Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.

pDirection

Pointer to a buffer that receives the direction of the selected GPIO ports.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pDirection==NULL	SUSI _STATUS_INVALID_PARAMETER
Bitmask==0 when bank mode	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.7.3 SusiGPIOSetDirection

uint32_t SUSI_API SusiGPIOSetDirection(uint32_t Id, uint32_t Bitmask, uint32_t Direction)

Description:

Sets the configuration for the selected GPIO ports.

Parameters:

Id

Selects target device. See Table 20.

Bitmask

Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.

Direction

Sets the direction of the selected GPIO ports.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Bitmask==0 when bank mode	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.7.4 SusiGPIOGetLevel

uint32_t SUSI_API SusiGPIOGetLevel(uint32_t Id, uint32_t Bitmask, uint32_t *pLevel)

Description:

Read level the from GPIO ports.

Parameters:

Id

Selects target device. See Table 20.

Bitmask

Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.

pLevel

Pointer to a buffer that receives the GPIO level.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pLevel==NULL	SUSI _STATUS_INVALID_PARAMETER
Bitmask==0 when bank mode	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.7.5 SusiGPIOSetLevel

uint32_t SUSI_API SusiGPIOSetLevel(uint32_t Id, uint32_t Bitmask, uint32_t Level)

Description:

Write level to GPIO ports. Depending on the hardware implementation writing multiple GPIO ports with the bit mask option does not guarantee a time synchronous change of the output levels.

Parameters:

Id

Selects target device. See Table 20.

Bitmask

Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.

Level

Input level of the selected GPIO port.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
Bitmask==0 when bank mode	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.8 Smart Fan Functions

The Smart Fan function call is used to set fan speed configuration. You can use this function to easily control the fan speed. It takes a pointer to an instance of structure SusiFanControl, which is defined as follows:

#define SUSI_FAN_AUTO_CTRL_OPMODE_PWM 0

#define SUSI_FAN_AUTO_CTRL_OPMODE_RPM 1

typedef struct _AutoFan {

 uint32_t TmlSource; // Thermal source

 uint32_t OpMode;

 uint32_t LowStopLimit; // Temperature (0.1 Kelvins)

 uint32_t LowLimit; // Temperature (0.1 Kelvins)

 uint32_t HighLimit; // Temperature (0.1 Kelvins)

 uint32_t MinPWM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_PWM

 uint32_t MaxPWM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_PWM

 uint32_t MinRPM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_RPM

 uint32_t MaxRPM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_RPM

} AutoFan , *PAutoFan ;



// Mode

#define SUSI_FAN_CTRL_MODE_OFF 0

#define SUSI_FAN_CTRL_MODE_FULL 1

#define SUSI_FAN_CTRL_MODE_MANUAL 2

#define SUSI_FAN_CTRL_MODE_AUTO 3

typedef struct _SusiFanControl {

 uint32_t Mode;

 uint32_t PWM; // Manual mode only (0 - 100%)

 AutoFan AutoControl; // Auto mode only

} SusiFanControl, *PSusiFanControl;

If Mode member of SusiFanControl is not Auto, AutoControl member will be ignored. In auto mode, parameter “TmlSource” is use SUSI_ID_HWM_TEMP_XXX (Table 3) to select which thermal type to reference. If TmlSource is not match any temperature ID means unknown or unsupported.

3.8.1 SusiFanControlGetCaps

uint32_t SUSI_API SusiFanControlGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)

Description:

Gets fan control capabilities.

Parameters:

Id

Smart fan ID is same as Fan Speed Value ID. See Table 4.

ItemId

Selects target capability. See Table 22. This parameter can also input temperature ID (Table 3) to get is it supports in SusiFanControl function.

pValue

Pointer to a buffer that receives the target capability.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id or ItemId	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 22 Fan control capabilities item Id

Item Id	Description
SUSI_ID_FC_CONTROL_SUPPORT_FLAGS	Control support flags (See Table 23)
SUSI_ID_FC_AUTO_SUPPORT_FLAGS	Auto support flags (See Table 24)

Table 23 Control Support Flags

Flag Name	Description	Value
SUSI_FC_FLAG_SUPPORT_OFF_MODE	Support off mode	0x01
SUSI_FC_FLAG_SUPPORT_FULL_MODE	Support full mode	0x02
SUSI_FC_FLAG_SUPPORT_MANUAL_MODE	Support manual mode	0x04
SUSI_FC_FLAG_SUPPORT_AUTO_MODE	Support auto mode More detail to get Auto Support Flags	0x08

Table 24 Auto Support Flags

Flag Name	Description	Value
SUSI_FC_FLAG_SUPPORT_AUTO_LOW_STOP	Auto mode support Low Stop	0x01
SUSI_FC_FLAG_SUPPORT_AUTO_LOW_LIMIT	Auto mode support Low Limit	0x02
SUSI_FC_FLAG_SUPPORT_AUTO_HIGH_LIMIT	Auto mode support High Limit	0x04
SUSI_FC_FLAG_SUPPORT_AUTO_PWM	Auto mode support PWM operation	0x0100
SUSI_FC_FLAG_SUPPORT_AUTO_RPM	Auto mode support RPM operation	0x0200

3.8.2 SusiFanControlGetConfig

uint32_t SUSI_API SusiFanControlGetConfig(uint32_t Id, SusiFanControl *pConfig)

Description:

Get information about smart fan function mode and configuration.

Parameters:

Id

Smart fan ID is same as Fan Speed Value ID. See Table 4.

pConfig

Pointer to the smart fan function configuration.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pConfig==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device not support smart mode	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.8.3 SusiFanControlSetConfig

uint32_t SUSI_API SusiFanControlSetConfig(uint32_t Id, SusiFanControl *pConfig)

Description:

Set smart fan function mode and configuration.

Parameters:

Id

Smart fan ID is same as Fan Speed Value ID. See Table 4.

pConfig

Pointer to the smart fan function configuration.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pConfig==NULL	SUSI _STATUS_INVALID_PARAMETER
Wrong configuration	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.9 Storage Functions

Access storage information and read / write data to the selected user data area. Developers can use this area to store their own data.

Table 25 Storage ID

Id	Description
SUSI_ID_STORAGE_STD	Standard storage device
SUSI_ID_STORAGE_OEM0~1	Other storage devices

3.9.1 SusiStorageGetCaps

uint32_t SUSI_API SusiStorageGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)

Description:

Reads the capabilities of the current storage implementation from the selected storage interface.

Parameters:

Id

Selects target device. See Table 25.

ItemId

Selects target capability. See Table 26.

pValue

Pointer to a buffer that receives the target capability.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device not support	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 26 Storage capabilities item Id

Item Id	Description
SUSI_ID_STORAGE_TOTAL_SIZE	Get storage total size in bytes
SUSI_ID_STORAGE_BLOCK_SIZE	Get storage block size in bytes
SUSI_ID_STORAGE_LOCK_STATUS	Get storage lock status. See Table 27.
SUSI_ID_STORAGE_PSW_MAX_LEN	Get maximum length in byte of storage lock key

Table 27 Storage Lock Status

Lock Status	Description
SUSI_STORAGE_STATUS_LOCK	Storage is lock
SUSI_STORAGE_STATUS_UNLOCK	Storage is unlock

3.9.2 SusiStorageAreaRead

uint32_t SUSI_API SusiStorageAreaRead(uint32_t Id, uint32_t Offset, uint8_t *pBuffer, uint32_t BufLen)

Description:

Reads data from the selected user data area.

Parameters:

Id

Selects target device. See Table 25.

Offset

Storage area start address offset in bytes.

pBuffer

Size in bytes of the buffer pointed to by the pBuffer parameter.

BufLen

Size in bytes of the information read to the buffer pointed to by the pBuffer parameter.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL \|\| BufLen==0	SUSI _STATUS_INVALID_PARAMETER
Offset+BufLen>TotalSize	SUSI_STATUS_INVALID_BLOCK_LENGTH
Unknown Id	SUSI _STATUS_UNSUPPORTED
Read error	SUSI_STATUS_READ_ERROR
Success	SUSI_STATUS_SUCCESS

3.9.3 SusiStorageAreaWrite

uint32_t SUSI_API SusiStorageAreaWrite(uint32_t Id, uint32_t Offset, uint8_t *pBuffer, uint32_t BufLen)

Description:

Writes data to the selected user data area.

Parameters:

Id

Selects target device. See Table 25.

Offset

Storage area start address offset in bytes.

pBuffer

Size in bytes of the buffer pointed to by the pBuffer parameter.

BufLen

Size in bytes of the information read to the buffer pointed to by the pBuffer parameter.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL \|\| BufLen==0	SUSI _STATUS_INVALID_PARAMETER
Offset+BufLen>TotalSize	SUSI_STATUS_INVALID_BLOCK_LENGTH
Unknown Id	SUSI _STATUS_UNSUPPORTED
Write error	SUSI_STATUS_WRITE_ERROR
Success	SUSI_STATUS_SUCCESS

3.9.4 SusiStorageAreaSetLock

uint32_t SUSI_API SusiStorageAreaSetLock(uint32_t Id, uint8_t *pBuffer, uint32_t BufLen)

Description:

Lock a storage area for write protect.

Parameters:

Id

Selects target device. See Table 25.

pBuffer

Lock of key buffer.

BufLen

Number of key buffer

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL \|\| BufLen==0	SUSI _STATUS_INVALID_PARAMETER
Lock error	SUSI_STATUS_WRITE_ERROR
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device not support	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.9.5 SusiStorageAreaSetUnlock

uint32_t SUSI_API SusiStorageAreaSetUnlock(uint32_t Id, uint8_t *pBuffer, uint32_t BufLen)

Description:

Unlock a storage area for write protect.

Parameters:

Id

Selects target device. See Table 25.

pBuffer

Unlock of key buffer.

BufLen

Number of key buffer

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pBuffer==NULL \|\| BufLen==0	SUSI _STATUS_INVALID_PARAMETER
Unlock error	SUSI_STATUS_WRITE_ERROR
Unknown Id	SUSI _STATUS_UNSUPPORTED
Device not support	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.10Thermal Protection Functions

The Thermal Protection function call is used to set hardware base thermal monitoring and notify. It takes a pointer to an instance of structure SusiThermalProtect, which is defined as follows:

typedef struct _SusiThermalProtect{

 uint32_t SourceId;

 uint32_t EventType;

 uint32_t SendEventTemperature;

 uint32_t ClearEventTemperature;

} SusiThermalProtect, *PSusiThermalProtect;

Where:

SourceId

Setting thermal source ID here. See Table 3.

EventType

This byte can set up a thermal protect event, see Table 28. NOT every platform supports all event type.

SendEevntTemperature

Unit is 0.1 Kelvins. When thermal source goes over this value, SUSI will send event according Event Type.

ClearEventTemperature

Unit is 0.1 Kelvins. When thermal source goes below this value and Event is sent, SUSI will clear event according Event Type

Table 28 Thermal Protection Event Type

Event Type Name	Description	Value
SUSI_THERMAL_EVENT_SHUTDOWN	Shutdown event	0x00
SUSI_THERMAL_EVENT_THROTTLE	Throttle event	0x01
SUSI_THERMAL_EVENT_POWEROFF	Power off event	0x02
SUSI_THERMAL_EVENT_NONE	No event	0xFF

Table 29 Thermal Protection ID

Id	Description
SUSI_ID_THERMAL_PROTECT_1	Thermal protection zone 1
SUSI_ID_THERMAL_PROTECT_2	Thermal protection zone 2
SUSI_ID_THERMAL_PROTECT_3	Thermal protection zone 3
SUSI_ID_THERMAL_PROTECT_4	Thermal protection zone 4

3.10.1 SusiThermalProtectionGetCaps

uint32_t SUSI_API SusiThermalProtectionGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)

Description:

Gets Thermal Protection capabilities.

Parameters:

Id

Selects target device. See Table 29.

ItemId

Selects target capability. See Table 30. This parameter can also input temperature ID (Table 3) to get is it supports in SusiThermalProtection function.

pValue

Pointer to a buffer that receives the target capability.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pValue==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id or ItemId	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

Table 30 Thermal Protection capabilities item Id

Item Id	Description
SUSI_ID_TP_EVENT_SUPPORT_FLAGS	Event support flags (See Table 31)
SUSI_ID_TP_EVENT_TRIGGER_MAXIMUM	The maximum temperature to trigger event
SUSI_ID_TP_EVENT_TRIGGER_MINIMUM	The minimum temperature to trigger event
SUSI_ID_TP_EVENT_CLEAR_MAXIMUM	The maximum temperature to clear event
SUSI_ID_TP_EVENT_CLEAR_MINIMUM	The minimum temperature to clear event

Table 31 Thermal Protection Support Flags

Flag Name	Description	Value
SUSI_THERMAL_FLAG_SUPPORT_SHUTDOWN	Support shutdown event	0x01
SUSI_THERMAL_FLAG_SUPPORT_THROTTLE	Support throttle event	0x02
SUSI_THERMAL_FLAG_SUPPORT_POWEROFF	Support power off event	0x04

3.10.2 SusiThermalProtectionSetConfig

uint32_t SUSI_API SusiThermalProtectionSetConfig(uint32_t Id, SusiThermalProtect *pConfig)

Description:

Set Thermal Protection configuration.

Parameters:

Id

Selects target device. See Table 29.

pConfig

A data package for thermal protection.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pConfig==NULL	SUSI _STATUS_INVALID_PARAMETER
Config invalid	SUSI _STATUS_INVALID_PARAMETER
Source Id or event type not support	SUSI _STATUS_UNSUPPORTED
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

3.10.3 SusiThermalProtectionGetConfig

uint32_t SUSI_API SusiThermalProtectionGetConfig(uint32_t Id, SusiThermalProtect *pConfig)

Description:

Get Thermal Protection configuration.

Parameters:

Id

Selects target device. See Table 29.

pConfig

A data package for thermal protection.

Return Status Code:

Condition	Return Value
Library uninitialized	SUSI_STATUS_NOT_INITIALIZED
pConfig==NULL	SUSI _STATUS_INVALID_PARAMETER
Unknown Id	SUSI _STATUS_UNSUPPORTED
Success	SUSI_STATUS_SUCCESS

@@ Line 1: / Line 1: @@
-<h1><b>1 Introduction</b></h1>
+= '''1 Introduction''' =
-<p><b>SUSI &ndash; A Bridge to Simplify &amp; Enhance H/W &amp; Application Implementation Efficiency</b></p>
+'''SUSI – A Bridge to Simplify & Enhance H/W & Application Implementation Efficiency'''
-<p>When developers want to write an application that involves hardware access, they have to study the specifications to write the drivers. This is a time-consuming job and requires lots of expertise.</p>
+When developers want to write an application that involves hardware access, they have to study the specifications to write the drivers. This is a time-consuming job and requires lots of expertise.
-<p>Advantech has done all the hard work for our customers with the release of a suite of Software APIs (Application Programming Interfaces), called <b>Secured &amp; Unified Smart Interface</b> (SUSI).</p>
+Advantech has done all the hard work for our customers with the release of a suite of Software APIs (Application Programming Interfaces), called '''Secured & Unified Smart Interface''' (SUSI).
-<p>SUSI provides not only the underlying drivers required but also a rich set of user-friendly, intelligent and integrated interfaces, which speeds development, enhances security and offers add-on value for Advantech platforms. SUSI plays the role of catalyst between developer and solution, and makes Advantech embedded platforms easier and simpler to adopt and operate with customer applications.</p>
+SUSI provides not only the underlying drivers required but also a rich set of user-friendly, intelligent and integrated interfaces, which speeds development, enhances security and offers add-on value for Advantech platforms. SUSI plays the role of catalyst between developer and solution, and makes Advantech embedded platforms easier and simpler to adopt and operate with customer applications.
-<p>&nbsp;</p>
-<h2><b>1.1 Functions</b></h2>
-<h3><b>1.1.1 GPIO</b></h3>
+== '''1.1 Functions''' ==
-<p><img _fck_mw_filename="1.1.1 GPIO.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.1 GPIO.png" height="150" src="/wiki/images/b/ba/1.1.1_GPIO.png" style="vertical-align:middle;" title="1.1.1 GPIO.png" width="100" /></p>
+=== '''1.1.1 GPIO''' ===
-<p>General Purpose Input/Output is a flexible parallel interface that allows a variety of custom connections. It supports various Digital I/O devices &ndash; input devices like buttons, switches; output devices such as cash drawers, LED lights&hellip;etc. And, allows users to monitor the level of signal input or set the output status to switch on/off the device. Our APIs also provided Programmable GPIO and allows developers to dynamically set the GPIO input or output status.</p>
+[[File:1.1.1 GPIO.png|100x150px|1.1.1 GPIO.png]]
-<p>&nbsp;</p>
+General Purpose Input/Output is a flexible parallel interface that allows a variety of custom connections. It supports various Digital I/O devices – input devices like buttons, switches; output devices such as cash drawers, LED lights…etc. And, allows users to monitor the level of signal input or set the output status to switch on/off the device. Our APIs also provided Programmable GPIO and allows developers to dynamically set the GPIO input or output status.
-<h3><b>1.1.2 SMBus [x86 only and RISC is unavailable]</b></h3>
-<p><img _fck_mw_filename="1.1.2 SMBus.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.2 SMBus.png" height="150" src="/wiki/images/f/f6/1.1.2_SMBus.png" style="vertical-align:middle;" title="1.1.2 SMBus.png" width="100" /></p>
-<p>SMBus is the System Management Bus defined by Intel&reg; Corporation in 1995. It is used in personal computers and servers for low-speed system management communications. Today, SMBus is used in all types of embedded systems. The SMBus APIs allows a developer to interface a platform to a downstream embedded system environment and transfer serial messages using the SMBus protocols, allowing multiple simultaneous device control.</p>
+=== '''1.1.2 SMBus [x86 only and RISC is unavailable]''' ===
-<p>&nbsp;</p>
+[[File:1.1.2 SMBus.png|100x150px|1.1.2 SMBus.png]]
-<h3><b>1.1.3 I<sup>2</sup>C</b></h3>
+SMBus is the System Management Bus defined by Intel Corporation in 1995. It is used in personal computers and servers for low-speed system management communications. Today, SMBus is used in all types of embedded systems. The SMBus APIs allows a developer to interface a platform to a downstream embedded system environment and transfer serial messages using the SMBus protocols, allowing multiple simultaneous device control.
-<p><img _fck_mw_filename="1.1.3 i2c.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.3 i2c.png" height="150" src="/wiki/images/4/4d/1.1.3_i2c.png" style="vertical-align:middle;" title="1.1.3 i2c.png" width="100" /></p>
-<p>I<sup>2</sup>C is a bi-directional two wire bus that was developed by Philips for use in their televisions in the 1980s. Today, I<sup>2</sup>C is used in all types of embedded systems. The I<sup>2</sup>C API allows a developer to interface a platform to a downstream embedded system environment and transfer serial messages using the I<sup>2</sup>C protocols, allowing multiple simultaneous device control.</p>
-<p>&nbsp;</p>
+=== '''1.1.3 I<sup>2</sup>C''' ===
-<h3><b>1.1.4 Watchdog</b></h3>
+[[File:1.1.3 i2c.png|100x150px|1.1.3 i2c.png]]
-<p><img _fck_mw_filename="1.1.4 watchdog.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.4 watchdog.png" height="150" src="/wiki/images/d/d4/1.1.4_watchdog.png" style="vertical-align:middle;" title="1.1.4 watchdog.png" width="100" /></p>
+I<sup>2</sup>C is a bi-directional two wire bus that was developed by Philips for use in their televisions in the 1980s. Today, I<sup>2</sup>C is used in all types of embedded systems. The I<sup>2</sup>C API allows a developer to interface a platform to a downstream embedded system environment and transfer serial messages using the I<sup>2</sup>C protocols, allowing multiple simultaneous device control.
-<p>A watchdog timer (WDT) is a device or electronic card that performs a specific operation after a certain period of time if something goes wrong with an electronic system and the system does not recover on its own.</p>
-<p>A watchdog timer can be programmed to perform a warm boot (restarting the system) after a certain number of seconds during which a program or computer fails to respond following the most recent mouse click or keyboard action.</p>
-<p>&nbsp;</p>
+=== '''1.1.4 Watchdog''' ===
-<h3><b>1.1.5 Hardware Monitor&nbsp;[x86 only and RISC is limited in some features]</b></h3>
+[[File:1.1.4 watchdog.png|100x150px|1.1.4 watchdog.png]]
-<p><img _fck_mw_filename="1.1.5 HardwareMonitor 1.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.5 HardwareMonitor 1.png" height="150" src="/wiki/images/1/1f/1.1.5_HardwareMonitor_1.png" style="vertical-align:middle;" title="1.1.5 HardwareMonitor 1.png" width="100" /> &nbsp; <img _fck_mw_filename="1.1.5 HardwareMonitor 2.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.5 HardwareMonitor 2.png" height="150" src="/wiki/images/e/eb/1.1.5_HardwareMonitor_2.png" style="vertical-align:middle;" title="1.1.5 HardwareMonitor 2.png" width="100" /></p>
+A watchdog timer (WDT) is a device or electronic card that performs a specific operation after a certain period of time if something goes wrong with an electronic system and the system does not recover on its own.
-<p>The Hardware Monitor (HWM) APIs is a system health supervision API that inspects certain condition indexes, such as smart fan, fan speed, temperature, current, case open and voltage.</p>
+A watchdog timer can be programmed to perform a warm boot (restarting the system) after a certain number of seconds during which a program or computer fails to respond following the most recent mouse click or keyboard action.
-<p>&nbsp;</p>
-<h3><b>1.1.6 Backlight Control</b></h3>
-<p><img _fck_mw_filename="1.1.6 Backlight 1.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.6 Backlight 1.png" height="150" src="/wiki/images/a/a6/1.1.6_Backlight_1.png" style="vertical-align:middle;" title="1.1.6 Backlight 1.png" width="100" /> &nbsp; <img _fck_mw_filename="1.1.6 Backlight 2.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.6 Backlight 2.png" height="150" src="/wiki/images/5/56/1.1.6_Backlight_2.png" style="vertical-align:middle;" title="1.1.6 Backlight 2.png" width="100" /></p>
+=== '''1.1.5 Hardware Monitor&nbsp;[x86 only and RISC is limited in some features]''' ===
-<p>The Backlight Control APIs allows a developer to interface platform to easily control brightness through PWM and backlight on/off.</p>
+[[File:1.1.5 HardwareMonitor 1.png|100x150px|1.1.5 HardwareMonitor 1.png]] &nbsp; [[File:1.1.5 HardwareMonitor 2.png|100x150px|1.1.5 HardwareMonitor 2.png]]
-<p>&nbsp;</p>
+The Hardware Monitor (HWM) APIs is a system health supervision API that inspects certain condition indexes, such as smart fan, fan speed, temperature, current, case open and voltage.
-<h3><b>1.1.7 Storage&nbsp;[x86 only and RISC is unavailable]</b></h3>
-<p><img _fck_mw_filename="1.1.7 Storage.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.7 Storage.png" height="150" src="/wiki/images/8/83/1.1.7_Storage.png" style="vertical-align:middle;" title="1.1.7 Storage.png" width="100" /></p>
-<p>Storage is a non-volatile storage, the storage APIs allows a developer to access storage information, read/write data to storage and lock/unlock data area (same like write protection) by a key.</p>
+=== '''1.1.6 Backlight Control''' ===
-<p>&nbsp;</p>
+[[File:1.1.6 Backlight 1.png|100x150px|1.1.6 Backlight 1.png]] &nbsp; [[File:1.1.6 Backlight 2.png|100x150px|1.1.6 Backlight 2.png]]
-<h3><b>1.1.8 Thermal Protection&nbsp;[x86 only and RISC is unavailable]</b></h3>
+The Backlight Control APIs allows a developer to interface platform to easily control brightness through PWM and backlight on/off.
-<p><img _fck_mw_filename="1.1.8 Thermal 1.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.8 Thermal 1.png" height="150" src="/wiki/images/4/47/1.1.8_Thermal_1.png" style="vertical-align:middle;" title="1.1.8 Thermal 1.png" width="100" /> &nbsp; <img _fck_mw_filename="1.1.8 Thermal 2.png" _fck_mw_origimgheight="259" _fck_mw_origimgwidth="300" alt="1.1.8 Thermal 2.png" height="150" src="/wiki/images/2/21/1.1.8_Thermal_2.png" style="vertical-align:middle;" title="1.1.8 Thermal 2.png" width="100" /></p>
-<p>Thermal Protection can select a thermal source to monitor. When source temperature reach the limit, SUSI can act protect function to protect system.</p>
-<h2><b>1.2 Benefits</b></h2>
+=== '''1.1.7 Storage&nbsp;[x86 only and RISC is unavailable]''' ===
-<ul>
+[[File:1.1.7 Storage.png|100x150px|1.1.7 Storage.png]]
-	<li><b>Faster Time to Market</b></li>
-</ul>
-<dl>
+Storage is a non-volatile storage, the storage APIs allows a developer to access storage information, read/write data to storage and lock/unlock data area (same like write protection) by a key.
-	<dd>SUSI&#39;s unified API helps developers write applications to control the hardware without knowing the hardware specs of the chipsets and driver architecture.</dd>
-</dl>
-<p>&nbsp;</p>
-<ul>
-	<li><b>Reduced Project Effort</b></li>
-</ul>
-<dl>
+=== '''1.1.8 Thermal Protection&nbsp;[x86 only and RISC is unavailable]''' ===
-	<dd>When customers have their own devices connected to the onboard bus, they can either: study the data sheet and write the driver &amp; API from scratch, or they can use SUSI to start the integration with a 50% head start. Developers can reference the sample program on&nbsp;the CD to see and learn more about the software development environment.</dd>
-</dl>
-<p>&nbsp;</p>
+[[File:1.1.8 Thermal 1.png|100x150px|1.1.8 Thermal 1.png]] &nbsp; [[File:1.1.8 Thermal 2.png|100x150px|1.1.8 Thermal 2.png]]
-<ul>
+Thermal Protection can select a thermal source to monitor. When source temperature reach the limit, SUSI can act protect function to protect system.
-	<li><b>Enhances Hardware Platform Reliability</b></li>
-</ul>
-<dl>
+== '''1.2 Benefits''' ==
-	<dd>SUSI provides a trusted custom ready solution which combines chipset and library function support, controlling application development through SUSI enhances reliability and brings peace of mind.</dd>
-</dl>
-<p>&nbsp;</p>
+*'''Faster Time to Market'''
-<ul>
+:SUSI's unified API helps developers write applications to control the hardware without knowing the hardware specs of the chipsets and driver architecture.
-	<li><b>Flexible Upgrade Possibilities</b></li>
-</ul>
-<dl>
-	<dd>SUSI supports an easy upgrade solution for customers. Customers just need to install the new version SUSI that supports the new functions.</dd>
-</dl>
-<p>&nbsp;</p>
-<ul>
+*'''Reduced Project Effort'''
-	<li><b>Backward compatibility</b></li>
-</ul>
-<dl>
+:When customers have their own devices connected to the onboard bus, they can either: study the data sheet and write the driver & API from scratch, or they can use SUSI to start the integration with a 50% head start. Developers can reference the sample program on&nbsp;the CD to see and learn more about the software development environment.
-	<dd>Support SUSI 3.0, iManager 2.0 and EAPI 1.0 interface. Customers don&rsquo;t need to change any APIs in their applications.</dd>
-</dl>
-<h2><b>1.3 Environment Requirements</b></h2>
-<h3><b>1.3.1Operating Systems</b></h3>
-<dl>
+*'''Enhances Hardware Platform Reliability'''
-	<dd>
-	<dl>
-		<dd>Windows XP Embedded</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+:SUSI provides a trusted custom ready solution which combines chipset and library function support, controlling application development through SUSI enhances reliability and brings peace of mind.
-	<dd>
-	<dl>
-		<dd>Windows XP 32-bit</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Windows 7 (x86 / x64)</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>WES7 (x86 / x64)</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+*'''Flexible Upgrade Possibilities'''
-	<dd>
-	<dl>
-		<dd>Windows 8 Desktop (x86 / x64)</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+:SUSI supports an easy upgrade solution for customers. Customers just need to install the new version SUSI that supports the new functions.
-	<dd>
-	<dl>
-		<dd>Windows 10 (x86 / x64)</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Windows CE 5 / 6 / 7</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>RISC Yocto 2.1</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+*'''Backward compatibility'''
-	<dd>
-	<dl>
-		<dd>Linux (Project based, request from your local FAE)</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+:Support SUSI 3.0, iManager 2.0 and EAPI 1.0 interface. Customers don’t need to change any APIs in their applications.
-	<dd>
-	<dl>
-		<dd>Android (Project based, request from your local FAE)</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+== '''1.3 Environment Requirements''' ==
-	<dd>
-	<dl>
-		<dd>QNX (Project based, request from your local FAE)</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+=== '''1.3.1Operating Systems''' ===
-	<dd>
-	<dl>
-		<dd>VxWorks (Project based, request from your local FAE)</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+::Windows XP Embedded
-<h1><b>2 SUSI Definition</b></h1>
+::Windows XP 32-bit
-<p>Susi4.h file includes the API declaration, constants and flags that are required for programming.</p>
+::Windows 7 (x86 / x64)
-<h2><b>2.1 Status Codes</b></h2>
+::WES7 (x86 / x64)
-<p>All SUSI API functions immediately return a status code from a common list of possible errors. Any function may return any of the defined status codes. See the Appendix for more detailed information.</p>
+::Windows 8 Desktop (x86 / x64)
-<p>&nbsp;</p>
+::Windows 10 (x86 / x64)
-<pre class="_fck_mw_lspace">
+::Windows CE 5 / 6 / 7
-#define SUSI_STATUS_NOT_INITIALIZED					&nbsp;&nbsp; &nbsp;0xFFFFFFFF
-</pre>
-<dl>
+::RISC Yocto 2.1
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+::Linux (Project based, request from your local FAE)
-	<dd>
-	<dl>
-		<dd>The SUSI API library is not yet or unsuccessfully initialized. SusiLibInitialize needs to be called prior to the first access of any other SUSI API functions.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+::Android (Project based, request from your local FAE)
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+::QNX (Project based, request from your local FAE)
-	<dd>
-	<dl>
-		<dd>Call SusiLibInitialize.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+::VxWorks (Project based, request from your local FAE)
-<pre class="_fck_mw_lspace">
+&nbsp;
-#define SUSI_STATUS_INITIALIZED						&nbsp;&nbsp; &nbsp;0xFFFFFFFE
-</pre>
-<dl>
+= '''2 SUSI Definition''' =
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+Susi4.h file includes the API declaration, constants and flags that are required for programming.
-	<dd>
-	<dl>
-		<dd>Library is initialized.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+== '''2.1 Status Codes''' ==
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+All SUSI API functions immediately return a status code from a common list of possible errors. Any function may return any of the defined status codes. See the Appendix for more detailed information.
-	<dd>
-	<dl>
-		<dd>None.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+&nbsp;
-<pre class="_fck_mw_lspace">
+ #define SUSI_STATUS_NOT_INITIALIZED					&nbsp;&nbsp; &nbsp;0xFFFFFFFF
-#define SUSI_STATUS_ALLOC_ERROR						&nbsp;&nbsp; &nbsp;0xFFFFFFFD
-</pre>
-<dl>
+:'''Description'''
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+::The SUSI API library is not yet or unsuccessfully initialized. SusiLibInitialize needs to be called prior to the first access of any other SUSI API functions.
-	<dd>
-	<dl>
-		<dd>Memory Allocation Error.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+::Call SusiLibInitialize.
-	<dd>
-	<dl>
-		<dd>Free memory and try again.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<pre class="_fck_mw_lspace">
-#define SUSI_STATUS_DRIVER_TIMEOUT						0xFFFFFFFC
-</pre>
-<dl>
+ #define SUSI_STATUS_INITIALIZED						&nbsp;&nbsp; &nbsp;0xFFFFFFFE
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+:'''Description'''
-	<dd>
-	<dl>
-		<dd>Time out in driver. This is Normally caused by hardware/software semaphore timeout.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+::Library is initialized.
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd>
-	<dl>
-		<dd>Retry.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+::None.
-<pre class="_fck_mw_lspace">
-#define SUSI_STATUS_INVALID_PARAMETER					0xFFFFFEFF
-</pre>
-<dl>
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+ #define SUSI_STATUS_ALLOC_ERROR						&nbsp;&nbsp; &nbsp;0xFFFFFFFD
-	<dd>
-	<dl>
-		<dd>One or more of the SUSI API functions call parameters are out of defined range.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+:'''Description'''
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+::Memory Allocation Error.
-	<dd>
-	<dl>
-		<dd>Verify Function Parameters.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Actions'''
-<pre class="_fck_mw_lspace">
+::Free memory and try again.
-#define SUSI_STATUS_INVALID_BLOCK_ALIGNMENT			0xFFFFFEFE
-</pre>
-<dl>
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>The Block Alignment is incorrect.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+ #define SUSI_STATUS_DRIVER_TIMEOUT						0xFFFFFFFC
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+:'''Description'''
-	<dd>
-	<dl>
-		<dd>Use Inputs and Outputs to correctly select input and outputs.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+::Time out in driver. This is Normally caused by hardware/software semaphore timeout.
-<pre class="_fck_mw_lspace">
+:'''Actions'''
-#define SUSI_STATUS_INVALID_BLOCK_LENGTH				0xFFFFFEFD
-</pre>
-<dl>
+::Retry.
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>This means that the Block length is too long.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+ #define SUSI_STATUS_INVALID_PARAMETER					0xFFFFFEFF
-	<dd>
-	<dl>
-		<dd>Use Alignment Capabilities information to correctly align write access.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description'''
-<pre class="_fck_mw_lspace">
+::One or more of the SUSI API functions call parameters are out of defined range.
-#define SUSI_STATUS_INVALID_DIRECTION					0xFFFFFEFC
-</pre>
-<dl>
+:'''Actions'''
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+::Verify Function Parameters.
-	<dd>
-	<dl>
-		<dd>The current Direction Argument attempts to set GPIOs to a unsupported direction. I.E. Setting GPI to Output.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Use Inputs and Outputs to correctly select input and outputs.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ #define SUSI_STATUS_INVALID_BLOCK_ALIGNMENT			0xFFFFFEFE
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_STATUS_INVALID_BITMASK					0xFFFFFEFB
-</pre>
-<dl>
+::The Block Alignment is incorrect.
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd>
-	<dl>
-		<dd>The Bitmask Selects bits/GPIOs which are not supported for the current ID.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+::Use Inputs and Outputs to correctly select input and outputs.
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Use Inputs and Outputs to probe supported bits.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<pre class="_fck_mw_lspace">
+ #define SUSI_STATUS_INVALID_BLOCK_LENGTH				0xFFFFFEFD
-#define SUSI_STATUS_RUNNING							0xFFFFFEFA
-</pre>
-<dl>
+:'''Description'''
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+::This means that the Block length is too long.
-	<dd>
-	<dl>
-		<dd>Watchdog timer already started.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+::Use Alignment Capabilities information to correctly align write access.
-	<dd>
-	<dl>
-		<dd>Call SusiWDogStop before retrying.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<pre class="_fck_mw_lspace">
-#define SUSI_STATUS_UNSUPPORTED						0xFFFFFCFF
-</pre>
-<dl>
+ #define SUSI_STATUS_INVALID_DIRECTION					0xFFFFFEFC
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+:'''Description'''
-	<dd>
-	<dl>
-		<dd>This function or ID is not supported at the actual hardware environment.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+::The current Direction Argument attempts to set GPIOs to a unsupported direction. I.E. Setting GPI to Output.
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd>
-	<dl>
-		<dd>None.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+::Use Inputs and Outputs to correctly select input and outputs.
-#define SUSI_STATUS_NOT_FOUND							0xFFFFFBFF
-</pre>
-<dl>
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Selected device was not found</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+ #define SUSI_STATUS_INVALID_BITMASK					0xFFFFFEFB
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+:'''Description'''
-	<dd>
-	<dl>
-		<dd>None.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+::The Bitmask Selects bits/GPIOs which are not supported for the current ID.
-<pre class="_fck_mw_lspace">
+:'''Actions'''
-#define SUSI_STATUS_TIMEOUT							0xFFFFFBFE
-</pre>
-<dl>
+::Use Inputs and Outputs to probe supported bits.
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Device has no response.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+ #define SUSI_STATUS_RUNNING							0xFFFFFEFA
-	<dd>
-	<dl>
-		<dd>None.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description'''
-<pre class="_fck_mw_lspace">
+::Watchdog timer already started.
-#define SUSI_STATUS_BUSY_COLLISION						0xFFFFFBFD
-</pre>
-<dl>
+:'''Actions'''
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+::Call SusiWDogStop before retrying.
-	<dd>
-	<dl>
-		<dd>The selected device or ID is busy or a data collision is detected.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Retry.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ #define SUSI_STATUS_UNSUPPORTED						0xFFFFFCFF
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_STATUS_READ_ERROR							0xFFFFFAFF
-</pre>
-<dl>
+::This function or ID is not supported at the actual hardware environment.
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd>
-	<dl>
-		<dd>An error is detected during a read operation.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+::None.
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+ #define SUSI_STATUS_NOT_FOUND							0xFFFFFBFF
-	<dd>
-	<dl>
-		<dd>Retry.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description'''
-<pre class="_fck_mw_lspace">
+::Selected device was not found
-#define SUSI_STATUS_WRITE_ERROR						0xFFFFFAFE
-</pre>
-<dl>
+:'''Actions'''
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+::None.
-	<dd>
-	<dl>
-		<dd>An error is detected during a write operation.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Retry.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ #define SUSI_STATUS_TIMEOUT							0xFFFFFBFE
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_STATUS_MORE_DATA							0xFFFFF9FF
-</pre>
-<dl>
+::Device has no response.
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd>
-	<dl>
-		<dd>The amount of available data exceeds the buffer size. Storage buffer overflow was prevented. Read count was larger than the defined buffer length.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+::None.
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
-	<dd>
-	<dl>
-		<dd>Either increase the buffer size or reduce the block length.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<pre class="_fck_mw_lspace">
+ #define SUSI_STATUS_BUSY_COLLISION						0xFFFFFBFD
-#define SUSI_STATUS_ERROR								0xFFFFF0FF
-</pre>
-<dl>
+:'''Description'''
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+::The selected device or ID is busy or a data collision is detected.
-	<dd>
-	<dl>
-		<dd>Generic error message. No further error details are available.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+::Retry.
-	<dd>
-	<dl>
-		<dd>None.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<pre class="_fck_mw_lspace">
-#define SUSI_STATUS_SUCCESS					0
-</pre>
-<dl>
+ #define SUSI_STATUS_READ_ERROR							0xFFFFFAFF
-	<dd><b>Description</b></dd>
-</dl>
-<dl>
+:'''Description'''
-	<dd>
-	<dl>
-		<dd>The operation is successful.</dd>
-	</dl>
-	</dd>
-</dl>
-<dl>
+::An error is detected during a read operation.
-	<dd><b>Actions</b></dd>
-</dl>
-<dl>
+:'''Actions'''
-	<dd>
-	<dl>
-		<dd>None.</dd>
-	</dl>
-	</dd>
-</dl>
-<h2><b>2.2 ID</b></h2>
+::Retry.
-<pre class="_fck_mw_lspace">
-#define SUSI_ID_UNKNOWN					0xFFFFFFFF
-</pre>
-<dl>
-	<dd><b>Description</b>
-	<dl>
+ #define SUSI_STATUS_WRITE_ERROR						0xFFFFFAFE
-		<dd>Undefined/Unknown ID</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_BOARD_MANUFACTURER_STR			0
-#define SUSI_ID_BOARD_NAME_STR				1
-#define SUSI_ID_BOARD_REVISION_STR			2
-#define SUSI_ID_BOARD_SERIAL_STR			3
-#define SUSI_ID_BOARD_BIOS_REVISION_STR			4
-#define SUSI_ID_BOARD_HW_REVISION_STR			5
-#define SUSI_ID_BOARD_PLATFORM_TYPE_STR			6
-#define SUSI_ID_BOARD_EC_FW_STR				7
-</pre>
-<dl>
+::An error is detected during a write operation.
-	<dd><b>Description</b>
-	<dl>
+:'''Actions'''
-		<dd>Board information string ID, use in SusiBoardGetStringA.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+::Retry.
-#define SUSI_ID_GET_SPEC_VERSION&amp;nbsp				0x00000000
-#define SUSI_ID_BOARD_BOOT_COUNTER_VAL				0x00000001
-#define SUSI_ID_BOARD_RUNNING_TIME_METER_VAL			0x00000002
-#define SUSI_ID_BOARD_PNPID_VAL					0x00000003
-#define SUSI_ID_BOARD_PLATFORM_REV_VAL				0x00000004
-#define SUSI_ID_BOARD_DRIVER_VERSION_VAL			0x00010000
-#define SUSI_ID_BOARD_LIB_VERSION_VAL				0x00010001
-#define SUSI_ID_BOARD_FIRMWARE_VERSION_VAL			0x00010002
-</pre>
-<dl>
-	<dd><b>Description</b>
-	<dl>
-		<dd>Board information value ID, use in SusiBoardGetValue.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+ #define SUSI_STATUS_MORE_DATA							0xFFFFF9FF
-#define SUSI_ID_HWM_TEMP_CPU					0x00020000
-#define SUSI_ID_HWM_TEMP_CHIPSET				0x00020001
-#define SUSI_ID_HWM_TEMP_SYSTEM					0x00020002
-#define SUSI_ID_HWM_TEMP_CPU2					0x00020003
-#define SUSI_ID_HWM_TEMP_OEM0					0x00020004
-#define SUSI_ID_HWM_TEMP_OEM1					0x00020005
-#define SUSI_ID_HWM_TEMP_OEM2					0x00020006
-#define SUSI_ID_HWM_TEMP_OEM3					0x00020007
-#define SUSI_ID_HWM_TEMP_OEM4					0x00020008
-#define SUSI_ID_HWM_TEMP_OEM5					0x00020009
-</pre>
-<dl>
+:'''Description'''
-	<dd><b>Description</b>
-	<dl>
+::The amount of available data exceeds the buffer size. Storage buffer overflow was prevented. Read count was larger than the defined buffer length.
-		<dd>Board temperature value ID, use in SusiBoardGetValue.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Actions'''
-#define SUSI_ID_HWM_VOLTAGE_VCORE				0x00021000
-#define SUSI_ID_HWM_VOLTAGE_VCORE2				0x00021001
-#define SUSI_ID_HWM_VOLTAGE_2V5					0x00021002
-#define SUSI_ID_HWM_VOLTAGE_3V3					0x00021003
-#define SUSI_ID_HWM_VOLTAGE_5V					0x00021004
-#define SUSI_ID_HWM_VOLTAGE_12V					0x00021005
-#define SUSI_ID_HWM_VOLTAGE_5VSB				0x00021006
-#define SUSI_ID_HWM_VOLTAGE_3VSB				0x00021007
-#define SUSI_ID_HWM_VOLTAGE_VBAT				0x00021008
-#define SUSI_ID_HWM_VOLTAGE_5NV					0x00021009
-#define SUSI_ID_HWM_VOLTAGE_12NV				0x0002100A
-#define SUSI_ID_HWM_VOLTAGE_VTT					0x0002100B
-#define SUSI_ID_HWM_VOLTAGE_24V					0x0002100C
-#define SUSI_ID_HWM_VOLTAGE_DC					0x0002100D
-#define SUSI_ID_HWM_VOLTAGE_DCSTBY				0x0002100E
-#define SUSI_ID_HWM_VOLTAGE_OEM3				0x0002100F
-#define SUSI_ID_HWM_VOLTAGE_OEM0				0x00021010
-#define SUSI_ID_HWM_VOLTAGE_OEM1				0x00021011
-#define SUSI_ID_HWM_VOLTAGE_OEM2				0x00021012
-#define SUSI_ID_HWM_VOLTAGE_OEM3				0x00021013
-#define SUSI_ID_HWM_VOLTAGE_1V05				0x00021014
-#define SUSI_ID_HWM_VOLTAGE_1V5					0x00021015
-#define SUSI_ID_HWM_VOLTAGE_1V8					0x00021016
-</pre>
-<dl>
+::Either increase the buffer size or reduce the block length.
-	<dd><b>Description</b>
-	<dl>
-		<dd>Board voltage value ID, use in SusiBoardGetValue.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
-#define SUSI_ID_HWM_FAN_CPU					0x00022000
-#define SUSI_ID_HWM_FAN_SYSTEM					0x00022001
-#define SUSI_ID_HWM_FAN_CPU2					0x00022002
-#define SUSI_ID_HWM_FAN_OEM0					0x00022003
-#define SUSI_ID_HWM_FAN_OEM1					0x00022004
-#define SUSI_ID_HWM_FAN_OEM2					0x00022005
-#define SUSI_ID_HWM_FAN_OEM3					0x00022006
-#define SUSI_ID_HWM_FAN_OEM4					0x00022007
-#define SUSI_ID_HWM_FAN_OEM5					0x00022008
-#define SUSI_ID_HWM_FAN_OEM6					0x00022009
-</pre>
-<dl>
+ #define SUSI_STATUS_ERROR								0xFFFFF0FF
-	<dd><b>Description</b>
-	<dl>
+:'''Description'''
-		<dd>Board fan speed value ID, use in SusiBoardGetValue and Smart Fan Functions.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+::Generic error message. No further error details are available.
-#define SUSI_ID_HWM_CURRENT_OEM0				0x00023000
-#define SUSI_ID_HWM_CURRENT_OEM1				0x00023001
-#define SUSI_ID_HWM_CURRENT_OEM2				0x00023002
-</pre>
-<dl>
+:'''Actions'''
-	<dd><b>Description</b>
-	<dl>
+::None.
-		<dd>Board current value ID, use in SusiBoardGetValue.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
-#define SUSI_ID_SMBUS_SUPPORTED					0x00030000
-#define SUSI_ID_I2C_SUPPORTED					0x00030100
-</pre>
-<dl>
-	<dd><b>Description</b>
-	<dl>
+ #define SUSI_STATUS_SUCCESS					0
-		<dd>Board supported information value ID, use in SusiBoardGetValue.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_SMBUS_EXTERNAL					0
-#define SUSI_ID_SMBUS_OEM0					1
-#define SUSI_ID_SMBUS_OEM1					2
-#define SUSI_ID_SMBUS_OEM2					3
-#define SUSI_ID_SMBUS_OEM3					4
-</pre>
-<dl>
+::The operation is successful.
-	<dd><b>Description</b>
-	<dl>
+:'''Actions'''
-		<dd>SMBus device ID, use in SMBus Functions.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+::None.
-#define SUSI_ID_I2C_EXTERNAL					0
-#define SUSI_ID_I2C_OEM0					1
-#define SUSI_ID_I2C_OEM1					2
-#define SUSI_ID_I2C_OEM2					3
-</pre>
-<dl>
+== '''2.2 ID''' ==
-	<dd><b>Description</b>
-	<dl>
+ #define SUSI_ID_UNKNOWN					0xFFFFFFFF
-		<dd>I<sup>2</sup>C device ID, use in I2C Functions.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_GPIO(GPIO_NUM)					(GPIO_NUM)
+::Undefined/Unknown ID
-#define SUSI_ID_GPIO_BANK(BANK_NUM)				(0x00010000 + BANK_NUM)
-</pre>
-<dl>
+ #define SUSI_ID_BOARD_MANUFACTURER_STR			0
-	<dd><b>Description</b>
+ #define SUSI_ID_BOARD_NAME_STR				1
+ #define SUSI_ID_BOARD_REVISION_STR			2
+ #define SUSI_ID_BOARD_SERIAL_STR			3
+ #define SUSI_ID_BOARD_BIOS_REVISION_STR			4
+ #define SUSI_ID_BOARD_HW_REVISION_STR			5
+ #define SUSI_ID_BOARD_PLATFORM_TYPE_STR			6
+ #define SUSI_ID_BOARD_EC_FW_STR				7
-	<dl>
+:'''Description'''
-		<dd>GPIO device ID, use in GPIO Functions.</dd>
+::Board information string ID, use in SusiBoardGetStringA.
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+ #define SUSI_ID_GET_SPEC_VERSION&nbsp				0x00000000
-#define SUSI_ID_BACKLIGHT_1					0
+ #define SUSI_ID_BOARD_BOOT_COUNTER_VAL				0x00000001
-#define SUSI_ID_BACKLIGHT_2					1
+ #define SUSI_ID_BOARD_RUNNING_TIME_METER_VAL			0x00000002
-#define SUSI_ID_BACKLIGHT_3					2
+ #define SUSI_ID_BOARD_PNPID_VAL					0x00000003
-</pre>
+ #define SUSI_ID_BOARD_PLATFORM_REV_VAL				0x00000004
+ #define SUSI_ID_BOARD_DRIVER_VERSION_VAL			0x00010000
+ #define SUSI_ID_BOARD_LIB_VERSION_VAL				0x00010001
+ #define SUSI_ID_BOARD_FIRMWARE_VERSION_VAL			0x00010002
-<dl>
+:'''Description'''
-	<dd><b>Description</b>
+::Board information value ID, use in SusiBoardGetValue.
-	<dl>
+ #define SUSI_ID_HWM_TEMP_CPU					0x00020000
-		<dd>Backlight device ID, use in Backlight Functions.</dd>
+ #define SUSI_ID_HWM_TEMP_CHIPSET				0x00020001
-	</dl>
+ #define SUSI_ID_HWM_TEMP_SYSTEM					0x00020002
-	</dd>
+ #define SUSI_ID_HWM_TEMP_CPU2					0x00020003
-</dl>
+ #define SUSI_ID_HWM_TEMP_OEM0					0x00020004
+ #define SUSI_ID_HWM_TEMP_OEM1					0x00020005
+ #define SUSI_ID_HWM_TEMP_OEM2					0x00020006
+ #define SUSI_ID_HWM_TEMP_OEM3					0x00020007
+ #define SUSI_ID_HWM_TEMP_OEM4					0x00020008
+ #define SUSI_ID_HWM_TEMP_OEM5					0x00020009
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_STORAGE_STD					0x00000000
+::Board temperature value ID, use in SusiBoardGetValue.
-#define SUSI_ID_STORAGE_OEM0					0x00000001
-#define SUSI_ID_STORAGE_OEM1					0x00000002
-</pre>
-<dl>
+ #define SUSI_ID_HWM_VOLTAGE_VCORE				0x00021000
-	<dd><b>Description</b>
+ #define SUSI_ID_HWM_VOLTAGE_VCORE2				0x00021001
+ #define SUSI_ID_HWM_VOLTAGE_2V5					0x00021002
+ #define SUSI_ID_HWM_VOLTAGE_3V3					0x00021003
+ #define SUSI_ID_HWM_VOLTAGE_5V					0x00021004
+ #define SUSI_ID_HWM_VOLTAGE_12V					0x00021005
+ #define SUSI_ID_HWM_VOLTAGE_5VSB				0x00021006
+ #define SUSI_ID_HWM_VOLTAGE_3VSB				0x00021007
+ #define SUSI_ID_HWM_VOLTAGE_VBAT				0x00021008
+ #define SUSI_ID_HWM_VOLTAGE_5NV					0x00021009
+ #define SUSI_ID_HWM_VOLTAGE_12NV				0x0002100A
+ #define SUSI_ID_HWM_VOLTAGE_VTT					0x0002100B
+ #define SUSI_ID_HWM_VOLTAGE_24V					0x0002100C
+ #define SUSI_ID_HWM_VOLTAGE_DC					0x0002100D
+ #define SUSI_ID_HWM_VOLTAGE_DCSTBY				0x0002100E
+ #define SUSI_ID_HWM_VOLTAGE_OEM3				0x0002100F
+ #define SUSI_ID_HWM_VOLTAGE_OEM0				0x00021010
+ #define SUSI_ID_HWM_VOLTAGE_OEM1				0x00021011
+ #define SUSI_ID_HWM_VOLTAGE_OEM2				0x00021012
+ #define SUSI_ID_HWM_VOLTAGE_OEM3				0x00021013
+ #define SUSI_ID_HWM_VOLTAGE_1V05				0x00021014
+ #define SUSI_ID_HWM_VOLTAGE_1V5					0x00021015
+ #define SUSI_ID_HWM_VOLTAGE_1V8					0x00021016
-	<dl>
+:'''Description'''
-		<dd>Storage device ID, use in Storage Functions.</dd>
+::Board voltage value ID, use in SusiBoardGetValue.
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+ #define SUSI_ID_HWM_FAN_CPU					0x00022000
-#define SUSI_ID_THERMAL_PROTECT_1				0
+ #define SUSI_ID_HWM_FAN_SYSTEM					0x00022001
-#define SUSI_ID_THERMAL_PROTECT_2				1
+ #define SUSI_ID_HWM_FAN_CPU2					0x00022002
-#define SUSI_ID_THERMAL_PROTECT_3				2
+ #define SUSI_ID_HWM_FAN_OEM0					0x00022003
-#define SUSI_ID_THERMAL_PROTECT_4				3
+ #define SUSI_ID_HWM_FAN_OEM1					0x00022004
-</pre>
+ #define SUSI_ID_HWM_FAN_OEM2					0x00022005
+ #define SUSI_ID_HWM_FAN_OEM3					0x00022006
+ #define SUSI_ID_HWM_FAN_OEM4					0x00022007
+ #define SUSI_ID_HWM_FAN_OEM5					0x00022008
+ #define SUSI_ID_HWM_FAN_OEM6					0x00022009
-<dl>
+:'''Description'''
-	<dd><b>Description</b>
+::Board fan speed value ID, use in SusiBoardGetValue and Smart Fan Functions.
-	<dl>
+ #define SUSI_ID_HWM_CURRENT_OEM0					0x00023000
-		<dd>Thermal protection device ID, use in Thermal Protection Functions</dd>
+ #define SUSI_ID_HWM_CURRENT_OEM1					0x00023001
-	</dl>
+ #define SUSI_ID_HWM_CURRENT_OEM2					0x00023002
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_WATCHDOG_1					0
+::Board current value ID, use in SusiBoardGetValue.
-#define SUSI_ID_WATCHDOG_2					1
-#define SUSI_ID_WATCHDOG_3					2
-</pre>
-<dl>
+ #define SUSI_ID_SMBUS_SUPPORTED					0x00030000
-	<dd><b>Description</b>
+ #define SUSI_ID_I2C_SUPPORTED					0x00030100
-	<dl>
+:'''Description'''
-		<dd>Watchdog device ID, use in Watchdog Functions.</dd>
+::Board supported information value ID, use in SusiBoardGetValue.
-	</dl>
-	</dd>
-</dl>
-<h2><b>2.3 Item ID</b></h2>
+ #define SUSI_ID_SMBUS_EXTERNAL					0
+ #define SUSI_ID_SMBUS_OEM0					1
+ #define SUSI_ID_SMBUS_OEM1					2
+ #define SUSI_ID_SMBUS_OEM2					3
+ #define SUSI_ID_SMBUS_OEM3					4
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_I2C_MAXIMUM_BLOCK_LENGTH			0x00000000
+::SMBus device ID, use in SMBus Functions.
-</pre>
-<dl>
+ #define SUSI_ID_I2C_EXTERNAL					0
-	<dd><b>Description</b>
+ #define SUSI_ID_I2C_OEM0					1
+ #define SUSI_ID_I2C_OEM1					2
+ #define SUSI_ID_I2C_OEM2					3
-	<dl>
+:'''Description'''
-		<dd>Watchdog capabilities item ID, use in SusiI2CGetCaps.</dd>
+::I<sup>2</sup>C device ID, use in I2C Functions.
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+ #define SUSI_ID_GPIO(GPIO_NUM)					(GPIO_NUM)
-#define SUSI_ID_GPIO_INPUT_SUPPORT				0x00000000
+ #define SUSI_ID_GPIO_BANK(BANK_NUM)					(0x00010000 + BANK_NUM)
-#define SUSI_ID_GPIO_OUTPUT_SUPPORT				0x00000001
-</pre>
-<dl>
+:'''Description'''
-	<dd><b>Description</b>
+::GPIO device ID, use in GPIO Functions.
-	<dl>
+ #define SUSI_ID_BACKLIGHT_1					0
-		<dd>GPIO capabilities item ID, use in SusiGPIOGetCaps.</dd>
+ #define SUSI_ID_BACKLIGHT_2					1
-	</dl>
+ #define SUSI_ID_BACKLIGHT_3					2
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_VGA_BRIGHTNESS_MAXIMUM				0x00010000
+::Backlight device ID, use in Backlight Functions.
-#define SUSI_ID_VGA_BRIGHTNESS_MINIMUM				0x00010001
-</pre>
-<dl>
+ #define SUSI_ID_STORAGE_STD					0x00000000
-	<dd><b>Description</b>
+ #define SUSI_ID_STORAGE_OEM0					0x00000001
+ #define SUSI_ID_STORAGE_OEM1					0x00000002
-	<dl>
+:'''Description'''
-		<dd>VGA capabilities item ID, use in SusiVgaGetCaps.</dd>
+::Storage device ID, use in Storage Functions.
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+ #define SUSI_ID_THERMAL_PROTECT_1					0
-#define SUSI_ID_STORAGE_TOTAL_SIZE				0x00000000
+ #define SUSI_ID_THERMAL_PROTECT_2					1
-#define SUSI_ID_STORAGE_BLOCK_SIZE				0x00000001
+ #define SUSI_ID_THERMAL_PROTECT_3					2
-#define SUSI_ID_STORAGE_LOCK_STATUS				0x00010000
+ #define SUSI_ID_THERMAL_PROTECT_4					3
-#define SUSI_ID_STORAGE_PSW_MAX_LEN				0x00010000
-</pre>
-<dl>
+:'''Description'''
-	<dd><b>Description</b>
+::Thermal protection device ID, use in Thermal Protection Functions
-	<dl>
+ #define SUSI_ID_WATCHDOG_1					0
-		<dd>Storage capabilities item ID, use in SusiStorageGetCaps.</dd>
+ #define SUSI_ID_WATCHDOG_2					1
-	</dl>
+ #define SUSI_ID_WATCHDOG_3					2
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_WDT_SUPPORT_FLAGS				0x00000000
+::Watchdog device ID, use in Watchdog Functions.
-#define SUSI_ID_WDT_DELAY_MAXIMUM				0x00000001
-#define SUSI_ID_WDT_DELAY_MINIMUM				0x00000002
-#define SUSI_ID_WDT_EVENT_MAXIMUM				0x00000003
-#define SUSI_ID_WDT_EVENT_MINIMUM				0x00000004
-#define SUSI_ID_WDT_RESET_MAXIMUM				0x00000005
-#define SUSI_ID_WDT_RESET_MINIMUM				0x00000006
-#define SUSI_ID_WDT_UNIT_MINIMUM				0x0000000F
-#define SUSI_ID_WDT_DELAY_TIME					0x00010001
-#define SUSI_ID_WDT_EVENT_TIME					0x00010002
-#define SUSI_ID_WDT_RESET_TIME					0x00010003
-#define SUSI_ID_WDT_EVENT_TYPE					0x00010004
-</pre>
-<dl>
+== '''2.3 Item ID''' ==
-	<dd><b>Description</b>
-	<dl>
+ #define SUSI_ID_I2C_MAXIMUM_BLOCK_LENGTH			0x00000000
-		<dd>Watchdog capabilities item ID, use in SusiWDogGetCaps.</dd>
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+:'''Description'''
-#define SUSI_ID_FC_CONTROL_SUPPORT_FLAGS			0x00000000
+::Watchdog capabilities item ID, use in SusiI2CGetCaps.
-#define SUSI_ID_FC_AUTO_SUPPORT_FLAGS				0x00000001
-</pre>
-<dl>
+ #define SUSI_ID_GPIO_INPUT_SUPPORT				0x00000000
-	<dd><b>Description</b>
+ #define SUSI_ID_GPIO_OUTPUT_SUPPORT				0x00000001
-	<dl>
+:'''Description'''
-		<dd>Fan control capabilities item ID, use in SusiFanControlGetCaps.</dd>
+::GPIO capabilities item ID, use in SusiGPIOGetCaps.
-	</dl>
-	</dd>
-</dl>
-<pre class="_fck_mw_lspace">
+ #define SUSI_ID_VGA_BRIGHTNESS_MAXIMUM				0x00010000
-#define SUSI_ID_TP_EVENT_SUPPORT_FLAGS				0x00000000
+ #define SUSI_ID_VGA_BRIGHTNESS_MINIMUM				0x00010001
-#define SUSI_ID_TP_EVENT_TRIGGER_MAXIMUM			0x00000001
-#define SUSI_ID_TP_EVENT_TRIGGER_MINIMUM			0x00000002
-#define SUSI_ID_TP_EVENT_CLEAR_MAXIMUM				0x00000003
-#define SUSI_ID_TP_EVENT_CLEAR_MINIMUM				0x00000004
-</pre>
-<dl>
+:'''Description'''
-	<dd><b>Description</b>
+::VGA capabilities item ID, use in SusiVgaGetCaps.
-	<dl>
+ #define SUSI_ID_STORAGE_TOTAL_SIZE				0x00000000
-		<dd>Thermal protection capabilities item ID, use in SusiThermalProtectionGetCaps.</dd>
+ #define SUSI_ID_STORAGE_BLOCK_SIZE				0x00000001
-	</dl>
+ #define SUSI_ID_STORAGE_LOCK_STATUS				0x00010000
-	</dd>
+ #define SUSI_ID_STORAGE_PSW_MAX_LEN				0x00010000
-</dl>
-<h1><b>3 SUSI API</b></h1>
+:'''Description'''
+::Storage capabilities item ID, use in SusiStorageGetCaps.
-<p>The SUSI APIs provide functions to control ADVANTECH platforms. SUSI API functions are based on a dynamic library. SUSI API can be implemented in various other programming languages.</p>
+ #define SUSI_ID_WDT_SUPPORT_FLAGS				0x00000000
+ #define SUSI_ID_WDT_DELAY_MAXIMUM				0x00000001
+ #define SUSI_ID_WDT_DELAY_MINIMUM				0x00000002
+ #define SUSI_ID_WDT_EVENT_MAXIMUM				0x00000003
+ #define SUSI_ID_WDT_EVENT_MINIMUM				0x00000004
+ #define SUSI_ID_WDT_RESET_MAXIMUM				0x00000005
+ #define SUSI_ID_WDT_RESET_MINIMUM				0x00000006
+ #define SUSI_ID_WDT_UNIT_MINIMUM				0x0000000F
+ #define SUSI_ID_WDT_DELAY_TIME					0x00010001
+ #define SUSI_ID_WDT_EVENT_TIME					0x00010002
+ #define SUSI_ID_WDT_RESET_TIME					0x00010003
+ #define SUSI_ID_WDT_EVENT_TYPE					0x00010004
-<h2><b>3.1 Initialization Functions</b></h2>
+:'''Description'''
+::Watchdog capabilities item ID, use in SusiWDogGetCaps.
-<h3><b>3.1.1 SusiLibInitialize</b></h3>
+ #define SUSI_ID_FC_CONTROL_SUPPORT_FLAGS			0x00000000
+ #define SUSI_ID_FC_AUTO_SUPPORT_FLAGS				0x00000001
-<pre class="_fck_mw_lspace">
+:'''Description'''
-uint32_t SUSI_API SusiLibInitialize(void)
+::Fan control capabilities item ID, use in SusiFanControlGetCaps.
-</pre>
-<dl>
+ #define SUSI_ID_TP_EVENT_SUPPORT_FLAGS				0x00000000
-	<dd><b>Description:</b>
+ #define SUSI_ID_TP_EVENT_TRIGGER_MAXIMUM			0x00000001
+ #define SUSI_ID_TP_EVENT_TRIGGER_MINIMUM			0x00000002
+ #define SUSI_ID_TP_EVENT_CLEAR_MAXIMUM				0x00000003
+ #define SUSI_ID_TP_EVENT_CLEAR_MINIMUM				0x00000004
-	<dl>
+:'''Description'''
-		<dd>General initialization of the SUSI API. Prior to calling any SUSI API functions, the library needs to be initialized by calling this function. The status code for all SUSI API function will be SUSI_STATUS_NOT_INITIALIZED unless this function is called.</dd>
+::Thermal protection capabilities item ID, use in SusiThermalProtectionGetCaps.
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+= '''3 SUSI API''' =
-<p>&nbsp;</p>
+The SUSI APIs provide functions to control ADVANTECH platforms. SUSI API functions are based on a dynamic library. SUSI API can be implemented in various other programming languages.
-<dl>
+== '''3.1 Initialization Functions''' ==
-	<dd><b>Parameters:</b>
-	<dl>
+=== '''3.1.1 SusiLibInitialize''' ===
-		<dd>None</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiLibInitialize(void)
-<p>&nbsp;</p>
+:'''Description:'''
+::General initialization of the SUSI API. Prior to calling any SUSI API functions, the library needs to be initialized by calling this function. The status code for all SUSI API function will be SUSI_STATUS_NOT_INITIALIZED unless this function is called.
-<dl>
+:'''Parameters:'''
-	<dd><b>Return Status Code:</b></dd>
+::None
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Return Status Code:'''
-	<tbody>
-		<tr>
-			<td style="width:255px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:340px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Library initialized</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI_STATUS_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Fail</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Success</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:255px;" |
+'''Condition'''
-<h3><b>3.1.2 SusiLibUninitialize</b></h3>
+| style="width:340px;" |
+'''Return Value'''
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiLibUninitialize(void)
+| style="width:255px;" |
-</pre>
+Library initialized
-<dl>
+| style="width:340px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_INITIALIZED
-	<dl>
+|-
-		<dd>General function to uninitialize the SUSI API library that should be called before program exit.</dd>
+| style="width:255px;" |
-	</dl>
+Fail
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:340px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:255px;" |
+Success
-<dl>
+| style="width:340px;" |
-	<dd><b>Parameters:</b>
+SUSI_STATUS_SUCCESS
-	<dl>
+|}
-		<dd>None</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+=== '''3.1.2 SusiLibUninitialize''' ===
-<dl>
+ uint32_t SUSI_API SusiLibUninitialize(void)
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Description:'''
-	<tbody>
+::General function to uninitialize the SUSI API library that should be called before program exit.
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:340px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Success</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h2><b>3.2 Information Functions</b></h2>
+:'''Parameters:'''
+::None
-<h3><b>3.2.1 SusiBoardGetValue</b></h3>
+:'''Return Status Code:'''<br/>
-<pre class="_fck_mw_lspace">
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-uint32_t SUSI_API SusiBoardGetValue(uint32_t Id, uint32_t *pValue)
+|-
-</pre>
+| style="width:255px;" |
+'''Condition'''
-<dl>
+| style="width:340px;" |
-	<dd><b>Description:</b>
+'''Return Value'''
-	<dl>
+|-
-		<dd>Getting information about the hardware platform in value format.</dd>
+| style="width:255px;" |
-	</dl>
+Library uninitialized
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:340px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:255px;" |
+Success
-<dl>
+| style="width:340px;" |
-	<dd><b>Parameters:</b>
+SUSI_STATUS_SUCCESS
-	<dl>
+|}
-		<dd><b>Id</b>
-		<dl>
+== '''3.2 Information Functions''' ==
-			<dd>Selects target value. See Table 1 to Table 5.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+=== '''3.2.1 SusiBoardGetValue''' ===
-<dl>
+ uint32_t SUSI_API SusiBoardGetValue(uint32_t Id, uint32_t *pValue)
-	<dd>
-	<dl>
-		<dd><b>pValue</b>
-		<dl>
+:'''Description:'''
-			<dd>Pointer to a buffer that receives the value&#39;s data.</dd>
+::Getting information about the hardware platform in value format.
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target value. See Table 1 to Table 5.
+::'''pValue'''
+:::Pointer to a buffer that receives the value's data.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:255px;" |
+'''Condition'''
-<dl>
+| style="width:340px;" |
-	<dd><b>Return Status Code:</b></dd>
+'''Return Value'''
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:255px;" |
-		<tr>
+Library uninitialized
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:340px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:255px;">
-			<p>Success</p>
-			</td>
-			<td style="width:340px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:340px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<dl>
+|-
-	<dd><b>Table 1 Board information value ID</b></dd>
+| style="width:255px;" |
-</dl>
+pValue==NULL
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:340px;" |
-	<tbody>
+SUSI _STATUS_INVALID_PARAMETER
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:197px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:85px;">
-			<p><b>Unit</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_GET_SPEC_VERSION</p>
-			</td>
-			<td style="width:197px;">
-			<p>API Specification Version</p>
-			</td>
-			<td style="width:85px;">
-			<p>&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_BOARD_BOOT_COUNTER_VAL</p>
-			</td>
-			<td style="width:197px;">
-			<p>Boot Counter</p>
-			</td>
-			<td style="width:85px;">
-			<p>boot</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_BOARD_RUNNING_TIME_METER_VAL</p>
-			</td>
-			<td style="width:197px;">
-			<p>Running Time Meter</p>
-			</td>
-			<td style="width:85px;">
-			<p>hour</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_BOARD_PNPID_VAL</p>
-			</td>
-			<td style="width:197px;">
-			<p>Board Vendor PNPID</p>
-			</td>
-			<td style="width:85px;">
-			<p>&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_BOARD_PLATFORM_REV_VAL</p>
-			</td>
-			<td style="width:197px;">
-			<p>Platform revision</p>
-			</td>
-			<td style="width:85px;">
-			<p>&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_BOARD_DRIVER_VERSION_VAL</p>
-			</td>
-			<td style="width:197px;">
-			<p>Driver version</p>
-			</td>
-			<td style="width:85px;">
-			<p>&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_BOARD_LIB_VERSION_VAL</p>
-			</td>
-			<td style="width:197px;">
-			<p>Library version</p>
-			</td>
-			<td style="width:85px;">
-			<p>&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_BOARD_FIRMWARE_VERSION_VAL</p>
-			</td>
-			<td style="width:197px;">
-			<p>Firmware version</p>
-			</td>
-			<td style="width:85px;">
-			<p>&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:255px;" |
+Unknown Id
-<dl>
+| style="width:340px;" |
-	<dd><b>Table 2 Board voltage value ID</b></dd>
+SUSI _STATUS_UNSUPPORTED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:255px;" |
-		<tr>
+Device unsupported
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:197px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:85px;">
-			<p><b>Unit</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_VCORE</p>
-			</td>
-			<td style="width:197px;">
-			<p>CPU Core voltage</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_VCORE2&nbsp;</p>
-			</td>
-			<td style="width:197px;">
-			<p>Second CPU Core voltage</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_2V5</p>
-			</td>
-			<td style="width:197px;">
-			<p>2.5V</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_3V3</p>
-			</td>
-			<td style="width:197px;">
-			<p>3.3V</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_5V</p>
-			</td>
-			<td style="width:197px;">
-			<p>5V</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_12V</p>
-			</td>
-			<td style="width:197px;">
-			<p>12V</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_5VSB&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</p>
-			</td>
-			<td style="width:197px;">
-			<p>5V Standby</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_3VSB</p>
-			</td>
-			<td style="width:197px;">
-			<p>3V Standby</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_VBAT</p>
-			</td>
-			<td style="width:197px;">
-			<p>CMOS Battery voltage</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_5NV</p>
-			</td>
-			<td style="width:197px;">
-			<p>-5V</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_12NV</p>
-			</td>
-			<td style="width:197px;">
-			<p>-12V</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_VTT</p>
-			</td>
-			<td style="width:197px;">
-			<p>DIMM voltage</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_24V</p>
-			</td>
-			<td style="width:197px;">
-			<p>24V</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_VOLTAGE_OEM0~3</p>
-			</td>
-			<td style="width:197px;">
-			<p>Other voltages</p>
-			</td>
-			<td style="width:85px;">
-			<p>millivolt</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:340px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd><b>Table 3 Board temperature value ID</b></dd>
+| style="width:255px;" |
-</dl>
+Success
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:340px;" |
-	<tbody>
+SUSI_STATUS_SUCCESS
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:197px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:85px;">
-			<p><b>Unit</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_TEMP_CPU</p>
-			</td>
-			<td style="width:197px;">
-			<p>CPU temperature</p>
-			</td>
-			<td style="width:85px;">
-			<p>0.1 Kelvin</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_TEMP_CHIPSET</p>
-			</td>
-			<td style="width:197px;">
-			<p>Chipset temperature</p>
-			</td>
-			<td style="width:85px;">
-			<p>0.1 Kelvin</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_TEMP_SYSTEM</p>
-			</td>
-			<td style="width:197px;">
-			<p>System temperature</p>
-			</td>
-			<td style="width:85px;">
-			<p>0.1 Kelvin</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_TEMP_CPU2</p>
-			</td>
-			<td style="width:197px;">
-			<p>CPU2 temperature</p>
-			</td>
-			<td style="width:85px;">
-			<p>0.1 Kelvin</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_TEMP_OEM0~5</p>
-			</td>
-			<td style="width:197px;">
-			<p>Other temperatures</p>
-			</td>
-			<td style="width:85px;">
-			<p>0.1 Kelvin</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Table 4 Board fan speed value ID</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:197px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:85px;">
-			<p><b>Unit</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_FAN_CPU</p>
-			</td>
-			<td style="width:197px;">
-			<p>CPU fan speed</p>
-			</td>
-			<td style="width:85px;">
-			<p>RPM</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_FAN_SYSTEM</p>
-			</td>
-			<td style="width:197px;">
-			<p>System fan speed</p>
-			</td>
-			<td style="width:85px;">
-			<p>RPM</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_FAN_CPU2</p>
-			</td>
-			<td style="width:197px;">
-			<p>Second CPU fan speed</p>
-			</td>
-			<td style="width:85px;">
-			<p>RPM</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:317px;">
-			<p>SUSI_ID_HWM_FAN_OEM0~6</p>
-			</td>
-			<td style="width:197px;">
-			<p>Other fans</p>
-			</td>
-			<td style="width:85px;">
-			<p>RPM</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+:'''Table 1 Board information value ID'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Table 5 Board support information value ID</b></dd>
+|-
-</dl>
+| style="width:317px;" |
+'''Id'''
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:197px;" |
-	<tbody>
+'''Description'''
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:283px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_SMBUS_SUPPORTED</p>
-			</td>
-			<td style="width:283px;">
-			<p>Mask flags:</p>
-			<p>SUSI_SMBUS_EXTERNAL_SUPPORTED</p>
+| style="width:85px;" |
+'''Unit'''
-			<p>SUSI_SMBUS_OEM0_SUPPORTED</p>
+|-
+| style="width:317px;" |
+SUSI_ID_GET_SPEC_VERSION
-			<p>SUSI_SMBUS_OEM1_SUPPORTED</p>
+| style="width:197px;" |
+API Specification Version
-			<p>SUSI_SMBUS_OEM2_SUPPORTED</p>
+| style="width:85px;" |
+&nbsp;
-			<p>SUSI_SMBUS_OEM3_SUPPORTED</p>
+|-
-			</td>
+| style="width:317px;" |
-		</tr>
+SUSI_ID_BOARD_BOOT_COUNTER_VAL
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_I2C_SUPPORTED</p>
-			</td>
-			<td style="width:283px;">
-			<p>Mask flags:</p>
-			<p>SUSI_ I2C_EXTERNAL_SUPPORTED</p>
+| style="width:197px;" |
+Boot Counter
-			<p>SUSI_ I2C_OEM0_SUPPORTED</p>
+| style="width:85px;" |
+boot
-			<p>SUSI_ I2C_OEM1_SUPPORTED</p>
+|-
+| style="width:317px;" |
+SUSI_ID_BOARD_RUNNING_TIME_METER_VAL
-			<p>SUSI_ I2C_OEM2_SUPPORTED</p>
+| style="width:197px;" |
-			</td>
+Running Time Meter
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.2.2 SusiBoardGetStringA</b></h3>
+| style="width:85px;" |
+hour
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiBoardGetStringA(uint32_t Id, char *pBuffer, uint32_t *pBufLen)
+| style="width:317px;" |
-</pre>
+SUSI_ID_BOARD_PNPID_VAL
-<dl>
+| style="width:197px;" |
-	<dd><b>Description:</b>
+Board Vendor PNPID
-	<dl>
+| style="width:85px;" |
-		<dd>Text information about the hardware platform.</dd>
+&nbsp;
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_BOARD_PLATFORM_REV_VAL
-<p>&nbsp;</p>
+| style="width:197px;" |
+Platform revision
-<dl>
+| style="width:85px;" |
-	<dd><b>Parameters:</b>
+&nbsp;
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:317px;" |
+SUSI_ID_BOARD_DRIVER_VERSION_VAL
-		<dl>
+| style="width:197px;" |
-			<dd>Selects target string. See Table 6.</dd>
+Driver version
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:85px;" |
+&nbsp;
-<dl>
+|-
-	<dd>
+| style="width:317px;" |
-	<dl>
+SUSI_ID_BOARD_LIB_VERSION_VAL
-		<dd><b>pBuffer</b>
-		<dl>
+| style="width:197px;" |
-			<dd>Pointer to a buffer that receives the value&#39;s data.</dd>
+Library version
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:85px;" |
+&nbsp;
-<dl>
+|-
-	<dd>
+| style="width:317px;" |
-	<dl>
+SUSI_ID_BOARD_FIRMWARE_VERSION_VAL
-		<dd><b>pBufLen</b>
-		<dl>
+| style="width:197px;" |
-			<dd>Pointer to a variable that specifies the size, in bytes, of the buffer pointed to by the pBuffer parameter. When the function returns, this variable contains the size of the data copied to pBuffer including the terminating null character.</dd>
+Firmware version
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:85px;" |
+&nbsp;
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
-<dl>
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Table 2 Board voltage value ID'''
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBufLen==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBufLen!=NULL&amp;&amp;*pBufLen&amp;&amp;pBuffer==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>strlength + 1 &gt; *pBufLen</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_MORE_DATA</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:317px;" |
+'''Id'''
-<dl>
+| style="width:197px;" |
-	<dd><b>Table 6 Board information string ID</b></dd>
+'''Description'''
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:85px;" |
-	<tbody>
+'''Unit'''
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:283px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_MANUFACTURER_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>Board Manufacturer Name</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_NAME_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>Board Name</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_REVISION_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>Board Revision</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_SERIAL_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>Board Serial Number</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_BIOS_REVISION_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>Board BIOS Revision</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_HW_REVISION_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>Hardware Revision</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_PLATFORM_TYPE_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>Platform type</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BOARD_EC_FW_STR</p>
-			</td>
-			<td style="width:283px;">
-			<p>EC FW</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h2><b>3.3 Backlight Functions</b></h2>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_VCORE
-<p>This function sub set facilitates backlight control for Integrated flat panel displays, typically LVDS.</p>
+| style="width:197px;" |
+CPU Core voltage
-<dl>
+| style="width:85px;" |
-	<dd><b>Table 7 Backlight ID</b></dd>
+millivolt
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:317px;" |
-		<tr>
+SUSI_ID_HWM_VOLTAGE_VCORE2&nbsp;
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:283px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BACKLIGHT_1</p>
-			</td>
-			<td style="width:283px;">
-			<p>Backlight Local Flat Panel 1</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BACKLIGHT_2</p>
-			</td>
-			<td style="width:283px;">
-			<p>Backlight Local Flat Panel 2</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_BACKLIGHT_3</p>
-			</td>
-			<td style="width:283px;">
-			<p>Backlight Local Flat Panel 3</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+| style="width:197px;" |
-	<dd><b>Table 8 Backlight Enable Values</b></dd>
+Second CPU Core voltage
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:85px;" |
-	<tbody>
+millivolt
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p><b>Name</b></p>
-			</td>
-			<td style="width:283px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_BACKLIGHT_SET_ON</p>
-			</td>
-			<td style="width:283px;">
-			<p>Signifies that the Backlight be Enabled</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_BACKLIGHT_SET_OFF</p>
-			</td>
-			<td style="width:283px;">
-			<p>Signifies that the Backlight be Disabled</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.1 SusiVgaGetCaps</b></h3>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_2V5
-<pre class="_fck_mw_lspace">
+| style="width:197px;" |
-uint32_t SUSI_API SusiVgaGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue);
+.5V
-</pre>
-<dl>
+| style="width:85px;" |
-	<dd><b>Description:</b>
+millivolt
-	<dl>
+|-
-		<dd>Gets VGA capabilities.</dd>
+| style="width:317px;" |
-	</dl>
+SUSI_ID_HWM_VOLTAGE_3V3
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:197px;" |
+.3V
-<p>&nbsp;</p>
+| style="width:85px;" |
+millivolt
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_5V
-	<dl>
+| style="width:197px;" |
-		<dd><b>Id</b>
+V
-		<dl>
+| style="width:85px;" |
-			<dd>Selects target device. See Table 7.</dd>
+millivolt
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_12V
-<dl>
+| style="width:197px;" |
-	<dd>
+V
-	<dl>
-		<dd><b>ItemId</b>
-		<dl>
+| style="width:85px;" |
-			<dd>Selects target capability. See Table 9.</dd>
+millivolt
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_5VSB&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-<dl>
+| style="width:197px;" |
-	<dd>
+V Standby
-	<dl>
-		<dd><b>pValue</b>
-		<dl>
+| style="width:85px;" |
-			<dd>Pointer to a buffer that receives the target capability.</dd>
+millivolt
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_3VSB
-<p>&nbsp;</p>
+| style="width:197px;" |
+V Standby
-<p>&nbsp;</p>
+| style="width:85px;" |
+millivolt
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:317px;" |
-</dl>
+SUSI_ID_HWM_VOLTAGE_VBAT
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:197px;" |
-	<tbody>
+CMOS Battery voltage
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id or ItemId</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+| style="width:85px;" |
-	<dd><b>Table 9 VGA capabilities item Id</b></dd>
+millivolt
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:317px;" |
-		<tr>
+SUSI_ID_HWM_VOLTAGE_5NV
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Item Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_VGA_BRIGHTNESS_MAXIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>Maximum backlight value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_VGA_BRIGHTNESS_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>Minimum backlight value</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.2 SusiVgaGetBacklightEnable</b></h3>
+| style="width:197px;" |
+-5V
-<pre class="_fck_mw_lspace">
+| style="width:85px;" |
-uint32_t SUSI_API SusiVgaGetBacklightEnable(uint32_t Id, uint32_t *pEnable)
+millivolt
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_12NV
-	<dl>
+| style="width:197px;" |
-		<dd>Gets current Backlight Enable state for specified Flat Panel.</dd>
+-12V
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:85px;" |
+millivolt
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_VOLTAGE_VTT
-<dl>
+| style="width:197px;" |
-	<dd><b>Parameters:</b>
+DIMM voltage
-	<dl>
+| style="width:85px;" |
-		<dd><b>Id</b>
+millivolt
-		<dl>
+|-
-			<dd>Selects target device. See Table 7.</dd>
+| style="width:317px;" |
-		</dl>
+SUSI_ID_HWM_VOLTAGE_24V
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:197px;" |
+V
-<dl>
+| style="width:85px;" |
-	<dd>
+millivolt
-	<dl>
-		<dd><b>pEnable</b>
-		<dl>
+|-
-			<dd>Pointer to a buffer that receives the current backlight enable state. See Table 8.</dd>
+| style="width:317px;" |
-		</dl>
+SUSI_ID_HWM_VOLTAGE_OEM0~3
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:197px;" |
+Other voltages
-<p>&nbsp;</p>
+| style="width:85px;" |
+millivolt
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pEnable==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.3 SusiVgaSetBacklightEnable</b></h3>
+:'''Table 3 Board temperature value ID'''
-<pre class="_fck_mw_lspace">
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-uint32_t SUSI_API SusiVgaSetBacklightEnable(uint32_t Id, uint32_t Enable)
+|-
-</pre>
+| style="width:317px;" |
+'''Id'''
-<dl>
+| style="width:197px;" |
-	<dd><b>Description:</b>
+'''Description'''
-	<dl>
+| style="width:85px;" |
-		<dd>Enables or disable the backlight of the selected flat panel display</dd>
+'''Unit'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_TEMP_CPU
-<p>&nbsp;</p>
+| style="width:197px;" |
+CPU temperature
-<dl>
+| style="width:85px;" |
-	<dd><b>Parameters:</b>
+.1 Kelvin
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:317px;" |
+SUSI_ID_HWM_TEMP_CHIPSET
-		<dl>
+| style="width:197px;" |
-			<dd>Selects target device. See Table 7.</dd>
+Chipset temperature
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:85px;" |
+.1 Kelvin
-<dl>
+|-
-	<dd>
+| style="width:317px;" |
-	<dl>
+SUSI_ID_HWM_TEMP_SYSTEM
-		<dd><b>Enable</b>
-		<dl>
+| style="width:197px;" |
-			<dd>Backlight Enable options. See Table 8.</dd>
+System temperature
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:85px;" |
+.1 Kelvin
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_TEMP_CPU2
-<p>&nbsp;</p>
+| style="width:197px;" |
+CPU2 temperature
-<dl>
+| style="width:85px;" |
-	<dd><b>Return Status Code:</b></dd>
+.1 Kelvin
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:317px;" |
-		<tr>
+SUSI_ID_HWM_TEMP_OEM0~5
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.4 SusiVgaGetBacklightBrightness</b></h3>
+| style="width:197px;" |
+Other temperatures
-<pre class="_fck_mw_lspace">
+| style="width:85px;" |
-uint32_t SUSI_API SusiVgaGetBacklightBrightness(uint32_t Id, uint32_t *pBright)
+.1 Kelvin
-</pre>
-<dl>
+|}
-	<dd><b>Description:</b>
-	<dl>
-		<dd>Reads the current brightness of the selected flat panel display.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+:'''Table 4 Board fan speed value ID'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Parameters:</b>
+|-
+| style="width:317px;" |
+'''Id'''
-	<dl>
+| style="width:197px;" |
-		<dd><b>Id</b>
+'''Description'''
-		<dl>
+| style="width:85px;" |
-			<dd>Selects target device. See Table 7.</dd>
+'''Unit'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_FAN_CPU
-<dl>
+| style="width:197px;" |
-	<dd>
+CPU fan speed
-	<dl>
-		<dd><b>pBright</b>
-		<dl>
+| style="width:85px;" |
-			<dd>Pointer to a buffer that receives the current backlight brightness value.</dd>
+RPM
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:317px;" |
+SUSI_ID_HWM_FAN_SYSTEM
-<p>&nbsp;</p>
+| style="width:197px;" |
+System fan speed
-<p>&nbsp;</p>
+| style="width:85px;" |
+RPM
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:317px;" |
-</dl>
+SUSI_ID_HWM_FAN_CPU2
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:197px;" |
-	<tbody>
+Second CPU fan speed
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBright==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.5 SusiVgaSetBacklightBrightness</b></h3>
+| style="width:85px;" |
+RPM
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiVgaSetBacklightBrightness(uint32_t Id, uint32_t Bright)
+| style="width:317px;" |
-</pre>
+SUSI_ID_HWM_FAN_OEM0~6
-<dl>
+| style="width:197px;" |
-	<dd><b>Description:</b>
+Other fans
-	<dl>
+| style="width:85px;" |
-		<dd>Reads the current brightness of the selected flat panel display.</dd>
+RPM
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
-<dl>
-	<dd><b>Parameters:</b>
-	<dl>
+:'''Table 5 Board support information value ID'''
-		<dd><b>Id</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Selects target device. See Table 7.</dd>
+|-
-		</dl>
+| style="width:316px;" |
-		</dd>
+'''Id'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:283px;" |
+'''Description'''
-<dl>
+|-
-	<dd>
+| style="width:316px;" |
-	<dl>
+SUSI_ID_SMBUS_SUPPORTED
-		<dd><b>Bright</b>
-		<dl>
+| style="width:283px;" |
-			<dd>Backlight Brightness value.</dd>
+Mask flags:
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+SUSI_SMBUS_EXTERNAL_SUPPORTED
-<p>&nbsp;</p>
+SUSI_SMBUS_OEM0_SUPPORTED
-<p>&nbsp;</p>
+SUSI_SMBUS_OEM1_SUPPORTED
-<dl>
+SUSI_SMBUS_OEM2_SUPPORTED
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+SUSI_SMBUS_OEM3_SUPPORTED
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bright &gt; MAX value || Bright &lt; MIN value</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.6 SusiVgaGetBacklightLevel</b></h3>
+|-
+| style="width:316px;" |
+SUSI_ID_I2C_SUPPORTED
-<pre class="_fck_mw_lspace">
+| style="width:283px;" |
-uint32_t SUSI_API SusiVgaGetBacklightLevel(uint32_t Id, uint32_t *pLevel)
+Mask flags:
-</pre>
-<dl>
+SUSI_ I2C_EXTERNAL_SUPPORTED
-	<dd><b>Description:</b>
-	<dl>
+SUSI_ I2C_OEM0_SUPPORTED
-		<dd>Reads the current brightness level of the selected flat panel display.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+SUSI_ I2C_OEM1_SUPPORTED
-<p>&nbsp;</p>
+SUSI_ I2C_OEM2_SUPPORTED
-<dl>
+|}
-	<dd><b>Parameters:</b>
-	<dl>
+=== '''3.2.2 SusiBoardGetStringA''' ===
-		<dd><b>Id</b>
-		<dl>
+ uint32_t SUSI_API SusiBoardGetStringA(uint32_t Id, char *pBuffer, uint32_t *pBufLen)
-			<dd>Selects target device. See Table 7.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Text information about the hardware platform.
-<dl>
+:'''Parameters:'''
-	<dd>
+::'''Id'''
-	<dl>
+:::Selects target string. See Table 6.
-		<dd><b>pLevel</b>
+::'''pBuffer'''
+:::Pointer to a buffer that receives the value's data.
+::'''pBufLen'''
+:::Pointer to a variable that specifies the size, in bytes, of the buffer pointed to by the pBuffer parameter. When the function returns, this variable contains the size of the data copied to pBuffer including the terminating null character.
-		<dl>
+:'''Return Status Code:'''
-			<dd>Pointer to a buffer that receives the current backlight brightness level. See Table 10.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_NOT_INITIALIZED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+pBufLen==NULL
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pLevel==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+| style="width:313px;" |
-	<dd><b>Table 10 Brightness level range definition</b></dd>
+SUSI _STATUS_INVALID_PARAMETER
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+pBufLen!=NULL&&*pBufLen&&pBuffer==NULL
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Name</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_BACKLIGHT_LEVEL_MAXIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>Maximum backlight level is 9</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_BACKLIGHT_LEVEL_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>Minimum backlight level is 0</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.7 SusiVgaSetBacklightLevel</b></h3>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiVgaSetBacklightLevel(uint32_t Id, uint32_t Level)
+| style="width:293px;" |
-</pre>
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
+|-
-		<dd>Sets the brightness level of the selected flat panel display.</dd>
+| style="width:293px;" |
-	</dl>
+Device unsupported
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+strlength + 1 > *pBufLen
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+SUSI_STATUS_MORE_DATA
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Success
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See Table 7.</dd>
+SUSI_STATUS_SUCCESS
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd>
-	<dl>
-		<dd><b>Level</b>
-		<dl>
-			<dd>Backlight Brightness level. See Table 10.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Table 6 Board information string ID'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:316px;" |
+'''Id'''
-<p>&nbsp;</p>
+| style="width:283px;" |
+'''Description'''
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:316px;" |
-</dl>
+SUSI_ID_BOARD_MANUFACTURER_STR
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:283px;" |
-	<tbody>
+Board Manufacturer Name
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Level&gt;SUSI_BACKLIGHT_LEVEL_MAXIMUM</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.8 SusiVgaGetPolarity</b></h3>
+|-
+| style="width:316px;" |
+SUSI_ID_BOARD_NAME_STR
-<pre class="_fck_mw_lspace">
+| style="width:283px;" |
-uint32_t SUSI_API SusiVgaGetPolarity(uint32_t Id, uint32_t *pPolarity)
+Board Name
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:316px;" |
+SUSI_ID_BOARD_REVISION_STR
-	<dl>
+| style="width:283px;" |
-		<dd>Reads the current backlight polarity of the selected flat panel display.</dd>
+Board Revision
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:316px;" |
+SUSI_ID_BOARD_SERIAL_STR
-<p>&nbsp;</p>
+| style="width:283px;" |
+Board Serial Number
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:316px;" |
+SUSI_ID_BOARD_BIOS_REVISION_STR
-	<dl>
+| style="width:283px;" |
-		<dd><b>Id</b>
+Board BIOS Revision
-		<dl>
+|-
-			<dd>Selects target device. See Table 7.</dd>
+| style="width:316px;" |
-		</dl>
+SUSI_ID_BOARD_HW_REVISION_STR
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:283px;" |
+Hardware Revision
-<dl>
+|-
-	<dd>
+| style="width:316px;" |
-	<dl>
+SUSI_ID_BOARD_PLATFORM_TYPE_STR
-		<dd><b>pPolarity</b>
-		<dl>
+| style="width:283px;" |
-			<dd>Pointer to a buffer that receives the current backlight polarity. See Table 11.</dd>
+Platform type
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:316px;" |
+SUSI_ID_BOARD_EC_FW_STR
-<p>&nbsp;</p>
+| style="width:283px;" |
+EC FW
-<p>&nbsp;</p>
+|}
-<dl>
+== '''3.3 Backlight Functions''' ==
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+This function sub set facilitates backlight control for Integrated flat panel displays, typically LVDS.
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pPolarity==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+:'''Table 7 Backlight ID'''
-	<dd><b>Table 11 Brightness polarity definition</b></dd>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-</dl>
+|-
+| style="width:316px;" |
+'''Id'''
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:283px;" |
-	<tbody>
+'''Description'''
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Name</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_BACKLIGHT_POLARITY_ON</p>
-			</td>
-			<td style="width:302px;">
-			<p>Backlight signal polarity ON&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_BACKLIGHT_ POLARITY_OFF</p>
-			</td>
-			<td style="width:302px;">
-			<p>Backlight signal polarity OFF</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.3.9 SusiVga</b>SetPolarity</h3>
+|-
+| style="width:316px;" |
+SUSI_ID_BACKLIGHT_1
-<pre class="_fck_mw_lspace">
+| style="width:283px;" |
-uint32_t SUSI_API SusiVgaSetPolarity(uint32_t Id, uint32_t Polarity)
+Backlight Local Flat Panel 1
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:316px;" |
+SUSI_ID_BACKLIGHT_2
-	<dl>
+| style="width:283px;" |
-		<dd>Sets the polarity of the selected flat panel display.</dd>
+Backlight Local Flat Panel 2
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:316px;" |
+SUSI_ID_BACKLIGHT_3
-<p>&nbsp;</p>
+| style="width:283px;" |
+Backlight Local Flat Panel 3
-<dl>
+|}
-	<dd><b>Parameters:</b>
-	<dl>
+:'''Table 8 Backlight Enable Values'''
-		<dd><b>Id</b>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:316px;" |
+'''Name'''
-		<dl>
+| style="width:283px;" |
-			<dd>Selects target device. See <b>Table 7</b>.</dd>
+'''Description'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:316px;" |
+SUSI_BACKLIGHT_SET_ON
-<dl>
+| style="width:283px;" |
-	<dd>
+Signifies that the Backlight be Enabled
-	<dl>
-		<dd><b>Polarity</b>
-		<dl>
+|-
-			<dd>Polarity state. See <b>Table 11</b>.</dd>
+| style="width:316px;" |
-		</dl>
+SUSI_BACKLIGHT_SET_OFF
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:283px;" |
+Signifies that the Backlight be Disabled
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
+=== '''3.3.1 SusiVgaGetCaps''' ===
-<dl>
+ uint32_t SUSI_API SusiVgaGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue);
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Description:'''
-	<tbody>
+::Gets VGA capabilities.
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See Table 7.
+::'''ItemId'''
+:::Selects target capability. See Table 9.
+::'''pValue'''
+:::Pointer to a buffer that receives the target capability.
-<h3><b>3.3.10 SusiVgaGet</b>Frequency</h3>
+:'''Return Status Code:'''
-<pre class="_fck_mw_lspace">
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-uint32_t SUSI_API SusiVgaGetFrequency(uint32_t Id, uint32_t *pFrequency)
+|-
-</pre>
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+'''Return Value'''
-	<dl>
+|-
-		<dd>Reads the current backlight frequency of the selected flat panel display.</dd>
+| style="width:293px;" |
-	</dl>
+Library uninitialized
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pValue==NULL
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+SUSI _STATUS_INVALID_PARAMETER
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Unknown Id or ItemId
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table 7</b>.</dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_SUCCESS
-	<dl>
-		<dd><b>pFrequency</b>
-		<dl>
+|}
-			<dd>Pointer to a buffer that receives the current backlight frequency. (Unit: Hz)</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Table 9 VGA capabilities item Id'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Item Id'''
-<p>&nbsp;</p>
+| style="width:302px;" |
+'''Description'''
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:297px;" |
-</dl>
+SUSI_ID_VGA_BRIGHTNESS_MAXIMUM
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:302px;" |
-	<tbody>
+Maximum backlight value
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pFrequency==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_ID_VGA_BRIGHTNESS_MINIMUM
-<h3><b>3.3.11SusiVga</b>SetFrequency</h3>
+| style="width:302px;" |
+Minimum backlight value
-<pre class="_fck_mw_lspace">
+|}
-uint32_t SUSI_API SusiVgaSetFrequency(uint32_t Id, uint32_t Frequency)
-</pre>
-<dl>
+=== '''3.3.2 SusiVgaGetBacklightEnable''' ===
-	<dd><b>Description:</b>
-	<dl>
+ uint32_t SUSI_API SusiVgaGetBacklightEnable(uint32_t Id, uint32_t *pEnable)
-		<dd>Sets the frequency of the selected flat panel display.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Gets current Backlight Enable state for specified Flat Panel.
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See Table 7.
+::'''pEnable'''
+:::Pointer to a buffer that receives the current backlight enable state. See Table 8.
-<dl>
+:'''Return Status Code:'''
-	<dd><b>Parameters:</b>
-	<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-		<dd><b>Id</b>
+|-
+| style="width:293px;" |
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table 7</b>.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_NOT_INITIALIZED
-	<dl>
-		<dd><b>Polarity</b>
-		<dl>
+|-
-			<dd>Frequency value. (Unit: Hz)</dd>
+| style="width:293px;" |
-		</dl>
+pEnable==NULL
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:293px;" |
-</dl>
+Device unsupported
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI _STATUS_UNSUPPORTED
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h2><b>3.4 I2C Functions</b></h2>
+|-
+| style="width:293px;" |
+Success
-<p>I<sup>2</sup>C APIs support standard 7 and 10 bits slave address mode. I<sup>2</sup>C APIs also support word command, it needs encode before set to parameter, see Table 13</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd><b>Table </b>12 I<sup>2</sup>C ID</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+=== '''3.3.3 SusiVgaSetBacklightEnable''' ===
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_I2C_EXTERNAL</p>
-			</td>
-			<td style="width:302px;">
-			<p>Main I<sup>2</sup>C host device</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_I2C_OEM0~2</p>
-			</td>
-			<td style="width:302px;">
-			<p>Other I<sup>2</sup>C host devices</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiVgaSetBacklightEnable(uint32_t Id, uint32_t Enable)
-<dl>
+:'''Description:'''
-	<dd><b>Table </b>13 I<sup>2</sup>C command encode</dd>
+::Enables or disable the backlight of the selected flat panel display
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Parameters:'''
-	<tbody>
+::'''Id'''
-		<tr>
+:::Selects target device. See Table 7.
-			<td>&lt;tbody&gt;</td>
+::'''Enable'''
-		</tr>
+:::Backlight Enable options. See Table 8.
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Type</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>Standard command</p>
-			</td>
-			<td style="width:302px;">
-			<p>Byte command</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>Extend command</p>
-			</td>
-			<td style="width:302px;">
-			<p>Word command | 0x80000000</p>
-			<p>Ex. 0x8000FABC</p>
+:'''Return Status Code:'''
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>No command</p>
-			</td>
-			<td style="width:302px;">
-			<p>0x4000xxxx, ignore command parameter</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<h3><b>3.4.1 SusiI2CGetCap</b>s</h3>
+| style="width:313px;" |
+'''Return Value'''
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiI2CGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
+| style="width:293px;" |
-</pre>
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_NOT_INITIALIZED
-	<dl>
+|-
-		<dd>Gets I<sup>2</sup>C capabilities.</dd>
+| style="width:293px;" |
-	</dl>
+Unknown Id
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Device unsupported
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Success
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI_STATUS_SUCCESS
-		<dl>
+|}
-			<dd>Selects target device. See <b>Table 12</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+=== '''3.3.4 SusiVgaGetBacklightBrightness''' ===
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiVgaGetBacklightBrightness(uint32_t Id, uint32_t *pBright)
-<dl>
+:'''Description:'''
-	<dd>
+::Reads the current brightness of the selected flat panel display.
-	<dl>
-		<dd><b>ItemId</b>
-		<dl>
+:'''Parameters:'''
-			<dd>Selects target capability. See <b>Table 14</b>.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See Table 7.
-		</dd>
+::'''pBright'''
-	</dl>
+:::Pointer to a buffer that receives the current backlight brightness value.
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd>
+'''Return Value'''
-	<dl>
-		<dd><b>pValue</b>
-		<dl>
+|-
-			<dd>Pointer to a buffer that receives the target capability.</dd>
+| style="width:293px;" |
-		</dl>
+Library uninitialized
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pBright==NULL
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:293px;" |
-</dl>
+Device unsupported
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI _STATUS_UNSUPPORTED
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id or ItemId</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+|-
-	<dd><b>Table </b>14 I<sup>2</sup>C capabilities item Id</dd>
+| style="width:293px;" |
-</dl>
+Success
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_SUCCESS
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Item Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_I2C_MAXIMUM_BLOCK_LENGTH</p>
-			</td>
-			<td style="width:302px;">
-			<p>I<sup>2</sup>C maximum block length</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>&nbsp;</p>
-			</td>
-			<td style="width:302px;">
-			<p>&nbsp;</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|}
-<h3><b>3.4.2 SusiI2CWriteReadCombine</b></h3>
+=== '''3.3.5 SusiVgaSetBacklightBrightness''' ===
-<pre class="_fck_mw_lspace">
+ uint32_t SUSI_API SusiVgaSetBacklightBrightness(uint32_t Id, uint32_t Bright)
-uint32_t SUSI_API SusiI2CWriteReadCombine(uint32_t Id, uint8_t Addr, uint8_t *pWBuffer, uint32_t WriteLen, uint8_t *pRBuffer, uint32_t ReadLen)
-</pre>
-<dl>
+:'''Description:'''
-	<dd><b>Description:</b>
+::Reads the current brightness of the selected flat panel display.
-	<dl>
+:'''Parameters:'''
-		<dd>Universal function for read and write operations to the I<sup>2</sup>C bus.</dd>
+::'''Id'''
-	</dl>
+:::Selects target device. See Table 7.
-	</dd>
+::'''Bright'''
-</dl>
+:::Backlight Brightness value.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Library uninitialized
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI_STATUS_NOT_INITIALIZED
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 12</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Bright > MAX value &#124;&#124; Bright < MIN value
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+|-
-			<dd>First byte of I<sup>2</sup>C device address. 7-bit address only</dd>
+| style="width:293px;" |
-		</dl>
+Device unsupported
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_SUCCESS
-	<dl>
-		<dd><b>pWBuffer</b>
-		<dl>
+|}
-			<dd>Pointer to a buffer containing the data to be transferred. This parameter can be NULL if the data is not required.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+=== '''3.3.6 SusiVgaGetBacklightLevel''' ===
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiVgaGetBacklightLevel(uint32_t Id, uint32_t *pLevel)
-<dl>
+:'''Description:'''
-	<dd>
+::Reads the current brightness level of the selected flat panel display.
-	<dl>
-		<dd><b>WriteLen</b>
-		<dl>
+:'''Parameters:'''
-			<dd>Size in bytes of the information pointed to by the pWBuffer parameter. If pWBuffer is NULL this will be ignored.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See Table 7.
-		</dd>
+::'''pLevel'''
-	</dl>
+:::Pointer to a buffer that receives the current backlight brightness level. See Table 10.
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd>
+'''Return Value'''
-	<dl>
-		<dd><b>pRBuffer</b>
-		<dl>
+|-
-			<dd>Pointer to a buffer that receives the read data. This parameter can be NULL if the data is not required.</dd>
+| style="width:293px;" |
-		</dl>
+Library uninitialized
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pLevel==NULL
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>ReadLen</b>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
+|-
-		<dd>
+| style="width:293px;" |
-		<dl>
+Device unsupported
-			<dd>Size in bytes of the buffer pointed to by the pRBuffer parameter. If pRBuffer is NULL this will be ignored.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
+:'''Table 10 Brightness level range definition'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Name'''
-<dl>
+| style="width:302px;" |
-	<dd><b>Return Status Code:</b></dd>
+'''Description'''
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:297px;" |
-		<tr>
+SUSI_BACKLIGHT_LEVEL_MAXIMUM
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>(WriteLen&gt;1)&amp;&amp;(pWBuffer==NULL)</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>(RBufLen&gt;1)&amp;&amp;(pRBuffer==NULL)</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>(WriteLen==0)&amp;&amp;(RBufLen==0)</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:302px;" |
+Maximum backlight level is 9
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:297px;" |
-			<td style="width:313px;">
+SUSI_BACKLIGHT_LEVEL_MINIMUM
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:302px;" |
+Minimum backlight level is 0
-<h3><b>3.4.3 SusiI2CReadTransfer</b></h3>
+|}
-<pre class="_fck_mw_lspace">
+=== '''3.3.7 SusiVgaSetBacklightLevel''' ===
-uint32_t SUSI_API SusiI2CReadTransfer(uint32_t Id, uint32_t Addr, uint32_t Cmd, uint8_t *pBuffer, uint32_t ReadLen)
-</pre>
-<dl>
+ uint32_t SUSI_API SusiVgaSetBacklightLevel(uint32_t Id, uint32_t Level)
-	<dd><b>Description:</b></dd>
-</dl>
-<dl>
+:'''Description:'''
-	<dd>
+::Sets the brightness level of the selected flat panel display.
-	<dl>
-		<dd>Reads from a specific register in the selected I<sup>2</sup>C device. Reads from I<sup>2</sup>C device at the I<sup>2</sup>C address Addr the amount of ReadLen bytes to the buffer pBuffer while using the device specific command Cmd. Depending on the addressed I<sup>2</sup>C device Cmd can be a specific command or a byte offset.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See Table 7.
+::'''Level'''
+:::Backlight Brightness level. See Table 10.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+'''Return Value'''
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Library uninitialized
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table 12</b>.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Level>SUSI_BACKLIGHT_LEVEL_MAXIMUM
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Unknown Id
-		<dd><b>Addr</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Encoded 7/10 Bit I<sup>2</sup>C Device Address.</dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Device unsupported
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Success
-		<dd><b>Cmd</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Encoded I<sup>2</sup>C Device Command / Index. See <b>Table 13</b>.</dd>
+SUSI_STATUS_SUCCESS
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
+=== '''3.3.8 SusiVgaGetPolarity''' ===
-<dl>
+ uint32_t SUSI_API SusiVgaGetPolarity(uint32_t Id, uint32_t *pPolarity)
-	<dd>
-	<dl>
-		<dd><b>pBuffer</b>
-		<dl>
+:'''Description:'''
-			<dd>Pointer to a buffer that receives the read data.</dd>
+::Reads the current backlight polarity of the selected flat panel display.
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See Table 7.
+::'''pPolarity'''
+:::Pointer to a buffer that receives the current backlight polarity. See Table 11.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd>
+|-
-	<dl>
+| style="width:293px;" |
-		<dd><b>ReadLen</b>
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Size in bytes of the buffer pointed to by the pBuffer parameter.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pPolarity==NULL
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI _STATUS_UNSUPPORTED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Success
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL || ReadLen==0</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-			<p>SDA Remains low</p>
+|}
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+:'''Table 11 Brightness polarity definition'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Name'''
-<h3><b>3.4.4 SusiI2CWriteTransfer</b></h3>
+| style="width:302px;" |
+'''Description'''
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiI2CWriteTransfer(uint32_t Id, uint32_t Addr, uint32_t Cmd, uint8_t *pBuffer, uint32_t ByteCnt)
+| style="width:297px;" |
-</pre>
+SUSI_BACKLIGHT_POLARITY_ON
-<dl>
+| style="width:302px;" |
-	<dd><b>Description:</b>
+Backlight signal polarity ON&nbsp;
-	<dl>
+|-
-		<dd>Write to a specific register in the selected I<sup>2</sup>C device. Writes to an I<sup>2</sup>C device at the I<sup>2</sup>C address Addr the amount of ByteCnt bytes from the buffer *pBuffer while using the device specific command Cmd. Depending on the addressed I<sup>2</sup>C device Cmd can be a specific command or a byte offset</dd>
+| style="width:297px;" |
-	</dl>
+SUSI_BACKLIGHT_ POLARITY_OFF
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:302px;" |
+Backlight signal polarity OFF
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
+=== '''3.3.9 SusiVga'''SetPolarity ===
-<dl>
+ uint32_t SUSI_API SusiVgaSetPolarity(uint32_t Id, uint32_t Polarity)
-	<dd><b>Parameters:</b>
-	<dl>
+:'''Description:'''
-		<dd><b>Id</b>
+::Sets the polarity of the selected flat panel display.
-		<dl>
+:'''Parameters:'''
-			<dd>Selects target device. See <b>Table 12</b>.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See '''Table 7'''.
-		</dd>
+::'''Polarity'''
-	</dl>
+:::Polarity state. See '''Table 11'''.
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Library uninitialized
-		<dd><b>Addr</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Encoded 7/10 Bit I<sup>2</sup>C Device Address.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Success
-		<dd><b>Cmd</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Encoded I<sup>2</sup>C Device Command / Index. See <b>Table 13</b>.</dd>
+SUSI_STATUS_SUCCESS
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
-<dl>
+=== '''3.3.10 SusiVgaGet'''Frequency ===
-	<dd>
-	<dl>
-		<dd><b>pBuffer</b>
-		<dl>
+ uint32_t SUSI_API SusiVgaGetFrequency(uint32_t Id, uint32_t *pFrequency)
-			<dd>Pointer to a buffer that receives the write data.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Reads the current backlight frequency of the selected flat panel display.
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 7'''.
+::'''pFrequency'''
+:::Pointer to a buffer that receives the current backlight frequency. (Unit: Hz)
-<dl>
+:'''Return Status Code:'''
-	<dd>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dl>
+|-
-		<dd><b>ByteCnt</b>
+| style="width:293px;" |
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Size in bytes of the buffer pointed to by the pBuffer parameter.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pFrequency==NULL
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI _STATUS_UNSUPPORTED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Device unsupported
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL || ByteCnt==0</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>ByteCnt &gt; MaxLength</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_INVALID_BLOCK_LENGTH</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:293px;" |
-			<td style="width:313px;">
+Success
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<h3><b>3.4.5 SusiI2CProbeDevice</b></h3>
+|}
-<pre class="_fck_mw_lspace">
-uint32_t SUSI_API SusiI2CProbeDevice(uint32_t Id, uint32_t Addr)
-</pre>
-<dl>
-	<dd><b>Description:</b>
-	<dl>
+=== '''3.3.11SusiVga'''SetFrequency ===
-		<dd>Probes I<sup>2</sup>C address to test I<sup>2</sup>C device present.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiVgaSetFrequency(uint32_t Id, uint32_t Frequency)
-<p>&nbsp;</p>
+:'''Description:'''
+::Sets the frequency of the selected flat panel display.
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 7'''.
+::'''Polarity'''
+:::Frequency value. (Unit: Hz)
-<dl>
+:'''Return Status Code:'''
-	<dd><b>Parameters:</b>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+'''Return Value'''
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 12</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Library uninitialized
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+|-
-			<dd>Encoded 7/10 Bit I<sup>2</sup>C Device Address.</dd>
+| style="width:293px;" |
-		</dl>
+Device unsupported
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
+== '''3.4 I2C Functions''' ==
-<dl>
+I<sup>2</sup>C APIs support standard 7 and 10 bits slave address mode. I<sup>2</sup>C APIs also support word command, it needs encode before set to parameter, see Table 13
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Table '''12 I<sup>2</sup>C ID
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Id'''
-			<p>SDA Remains low</p>
+| style="width:302px;" |
-			</td>
+'''Description'''
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.4.6 SusiI2CGetFrequency</b></h3>
+|-
+| style="width:297px;" |
+SUSI_ID_I2C_EXTERNAL
-<pre class="_fck_mw_lspace">
+| style="width:302px;" |
-uint32_t SUSI_API SusiI2CGetFrequency(uint32_t Id, uint32_t *pFreq)
+Main I<sup>2</sup>C host device
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:297px;" |
+SUSI_ID_I2C_OEM0~2
-	<dl>
+| style="width:302px;" |
-		<dd>Get I<sup>2</sup>C clock frequency.</dd>
+Other I<sup>2</sup>C host devices
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+:'''Table '''13 I<sup>2</sup>C command encode
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Parameters:</b>
+|-
+| style="width:297px;" |
+'''Type'''
-	<dl>
+| style="width:302px;" |
-		<dd><b>Id</b>
+'''Description'''
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 12</b>.</dd>
+| style="width:297px;" |
-		</dl>
+Standard command
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:302px;" |
+Byte command
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+Extend command
-<dl>
+| style="width:302px;" |
-	<dd>
+Word command &#124; 0x80000000
-	<dl>
-		<dd><b>pFreq</b>
-		<dl>
+Ex. 0x8000FABC
-			<dd>Pointer to a buffer that receives the I<sup>2</sup>C clock frequency value. (Unit: Hz)</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+No command
-<p>&nbsp;</p>
+| style="width:302px;" |
+x4000xxxx, ignore command parameter
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
-<p>&nbsp;</p>
-<dl>
+=== '''3.4.1 SusiI2CGetCap'''s ===
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+ uint32_t SUSI_API SusiI2CGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pFreq == NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.4.7 SusiI2C</b>SetFrequency</h3>
+:'''Description:'''
+::Gets I<sup>2</sup>C capabilities.
-<pre class="_fck_mw_lspace">
+:'''Parameters:'''
-uint32_t SUSI_API SusiI2CSetFrequency(uint32_t Id, uint32_t Freq)
+::'''Id'''
-</pre>
+:::Selects target device. See '''Table 12'''.
+::'''ItemId'''
+:::Selects target capability. See '''Table ''''''14'''.
+::'''pValue'''
+:::Pointer to a buffer that receives the target capability.
-<dl>
+:'''Return Status Code:'''
-	<dd><b>Description:</b>
-	<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-		<dd>Set I<sup>2</sup>C clock frequency.</dd>
+|-
-	</dl>
+| style="width:293px;" |
-	</dd>
+'''Condition'''
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+pValue==NULL
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI _STATUS_INVALID_PARAMETER
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 12</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Unknown Id or ItemId
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_SUCCESS
-	<dl>
-		<dd><b>Freq</b>
-		<dl>
+|}
-			<dd>I<sup>2</sup>C clock frequency value. (Unit: Hz)</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Table '''14 I<sup>2</sup>C capabilities item Id
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Item Id'''
-<p>&nbsp;</p>
+| style="width:302px;" |
+'''Description'''
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_ID_I2C_MAXIMUM_BLOCK_LENGTH
-<p>&nbsp;</p>
+| style="width:302px;" |
+I<sup>2</sup>C maximum block length
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:297px;" |
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h2><b>3.5 SMBus Functions</b></h2>
+| style="width:302px;" |
-<p>SMBus is the System Management Bus defined by Intel&reg; Corporation in 1995. It is used in personal computers and servers for low-speed system management communications.</p>
-<dl>
+|}
-	<dd><b>Table </b>15 SMBus ID</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_ SMBUS _EXTERNAL</p>
-			</td>
-			<td style="width:302px;">
-			<p>Main SMBus host device</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_SMBUS_OEM0~3</p>
-			</td>
-			<td style="width:302px;">
-			<p>Other SMBus host devices</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
-<h3><b>3.5.1 SusiSMBReadByte</b></h3>
+=== '''3.4.2 SusiI2CWriteReadCombine''' ===
-<pre class="_fck_mw_lspace">
+ uint32_t SUSI_API SusiI2CWriteReadCombine(uint32_t Id, uint8_t Addr, uint8_t *pWBuffer, uint32_t WriteLen, uint8_t *pRBuffer, uint32_t ReadLen)
-uint32_t SUSI_API SusiSMBReadByte(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pData)
-</pre>
-<dl>
+:'''Description:'''
-	<dd><b>Description:</b>
+::Universal function for read and write operations to the I<sup>2</sup>C bus.
-	<dl>
+:'''Parameters:'''
-		<dd>Read a byte of data from the target slave device in the SMBus.</dd>
+::'''Id'''
-	</dl>
+:::Selects target device. See '''Table ''''''14'''.
-	</dd>
+::'''Addr'''
-</dl>
+:::First byte of I<sup>2</sup>C device address. 7-bit address only
+::'''pWBuffer'''
+:::Pointer to a buffer containing the data to be transferred. This parameter can be NULL if the data is not required.
+::'''WriteLen'''
+:::Size in bytes of the information pointed to by the pWBuffer parameter. If pWBuffer is NULL this will be ignored.
+::'''pRBuffer'''
+:::Pointer to a buffer that receives the read data. This parameter can be NULL if the data is not required.
+:'''ReadLen'''
+:::Size in bytes of the buffer pointed to by the pRBuffer parameter. If pRBuffer is NULL this will be ignored.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+'''Return Value'''
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Library uninitialized
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+(WriteLen>1)&&(pWBuffer==NULL)
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_INVALID_PARAMETER
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+|-
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+| style="width:293px;" |
-		</dl>
+(RBufLen>1)&&(pRBuffer==NULL)
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+(WriteLen==0)&&(RBufLen==0)
-		<dd><b>Cmd</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the offset or command of the device register to read data from.</dd>
+SUSI _STATUS_INVALID_PARAMETER
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
-		<dd><b>pData</b>
-		<dl>
+|-
-			<dd>Pointer to a variable in which the function reads the byte data.</dd>
+| style="width:293px;" |
-		</dl>
+Bus Busy SDA/SDC low
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<p>&nbsp;</p>
+On Write 1 write cycle
-<dl>
+SDA Remains low
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_BUSY_COLLISION
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pData==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+|-
+| style="width:293px;" |
+Time-out due to clock stretching
-			<p>SDA Remains low</p>
+| style="width:313px;" |
-			</td>
+SUSI_STATUS_TIMEOUT
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<h3><b>3.5.2 SusiSMB</b>WriteByte</h3>
+| style="width:313px;" |
+SUSI_STATUS_NOT_FOUND
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiSMBWriteByte(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t Data)
+| style="width:293px;" |
-</pre>
+Write Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_WRITE_ERROR
-	<dl>
+|-
-		<dd>Write a byte of data to the target slave device in the SMBus.</dd>
+| style="width:293px;" |
-	</dl>
+Success
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Parameters:</b>
-	<dl>
-		<dd><b>Id</b>
-		<dl>
+=== '''3.4.3 SusiI2CReadTransfer''' ===
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiI2CReadTransfer(uint32_t Id, uint32_t Addr, uint32_t Cmd, uint8_t *pBuffer, uint32_t ReadLen)
-<dl>
+:'''Description:'''
-	<dd>
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+::Reads from a specific register in the selected I<sup>2</sup>C device. Reads from I<sup>2</sup>C device at the I<sup>2</sup>C address Addr the amount of ReadLen bytes to the buffer pBuffer while using the device specific command Cmd. Depending on the addressed I<sup>2</sup>C device Cmd can be a specific command or a byte offset.
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table ''''''14'''.
+::'''Addr'''
+:::Encoded 7/10 Bit I<sup>2</sup>C Device Address.
+::'''Cmd'''
+:::Encoded I<sup>2</sup>C Device Command / Index. See '''Table ''''''13'''.
+::'''pBuffer'''
+:::Pointer to a buffer that receives the read data.
+::'''ReadLen'''
+:::Size in bytes of the buffer pointed to by the pBuffer parameter.
-<dl>
+:'''Return Status Code:'''
-	<dd>
-	<dl>
-		<dd><b>Cmd</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Specifies the offset or command of the device register to write data to.</dd>
+|-
-		</dl>
+| style="width:293px;" |
-		</dd>
+'''Condition'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Library uninitialized
-		<dd><b>Data</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the byte data to be written.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pBuffer==NULL &#124;&#124; ReadLen==0
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI _STATUS_UNSUPPORTED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Bus Busy SDA/SDC low
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:293px;" |
-			<td style="width:313px;">
+Arbitration Error/Collision Error
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+On Write 1 write cycle
-<h3><b>3.5.3 SusiSMBReadWord</b></h3>
+SDA Remains low
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiSMBReadWord(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint16_t *pData)
+SUSI_STATUS_BUSY_COLLISION
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Time-out due to clock stretching
-	<dl>
+| style="width:313px;" |
-		<dd>Read a word of data from the target slave device in the SMBus.</dd>
+SUSI_STATUS_TIMEOUT
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_FOUND
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Write Non-ACK
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI_STATUS_WRITE_ERROR
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
+| style="width:293px;" |
-		</dl>
+Success
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd>
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<dl>
+=== '''3.4.4 SusiI2CWriteTransfer''' ===
-	<dd>
-	<dl>
-		<dd><b>Cmd</b>
-		<dl>
+ uint32_t SUSI_API SusiI2CWriteTransfer(uint32_t Id, uint32_t Addr, uint32_t Cmd, uint8_t *pBuffer, uint32_t ByteCnt)
-			<dd>Specifies the offset or command of the device register to read data from.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Write to a specific register in the selected I<sup>2</sup>C device. Writes to an I<sup>2</sup>C device at the I<sup>2</sup>C address Addr the amount of ByteCnt bytes from the buffer *pBuffer while using the device specific command Cmd. Depending on the addressed I<sup>2</sup>C device Cmd can be a specific command or a byte offset
-<dl>
+:'''Parameters:'''
-	<dd>
+::'''Id'''
-	<dl>
+:::Selects target device. See '''Table ''''''14'''.
-		<dd><b>pData</b>
+::'''Addr'''
+:::Encoded 7/10 Bit I<sup>2</sup>C Device Address.
+::'''Cmd'''
+:::Encoded I<sup>2</sup>C Device Command / Index. See '''Table ''''''13'''.
+::'''pBuffer'''
+:::Pointer to a buffer that receives the write data.
+::'''ByteCnt'''
+:::Size in bytes of the buffer pointed to by the pBuffer parameter.
-		<dl>
+:'''Return Status Code:'''
-			<dd>Pointer to a variable in which the function reads the word data.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_NOT_INITIALIZED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+pBuffer==NULL &#124;&#124; ByteCnt==0
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pData==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:293px;" |
-			<td style="width:313px;">
+ByteCnt > MaxLength
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_INVALID_BLOCK_LENGTH
-<h3><b>3.5.4 SusiSMB</b>WriteWord</h3>
+|-
+| style="width:293px;" |
+Unknown Id
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiSMBWriteWord(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint16_t Data)
+SUSI _STATUS_UNSUPPORTED
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-	<dl>
+| style="width:313px;" |
-		<dd>Write a word of data to the target slave device in the SMBus.</dd>
+SUSI_STATUS_BUSY_COLLISION
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<p>&nbsp;</p>
+On Write 1 write cycle
-<dl>
+SDA Remains low
-	<dd><b>Parameters:</b>
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI_STATUS_BUSY_COLLISION
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
+| style="width:293px;" |
-		</dl>
+Time-out due to clock stretching
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Address Non-ACK
-		<dd><b>Addr</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+SUSI_STATUS_NOT_FOUND
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Write Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_WRITE_ERROR
-	<dl>
-		<dd><b>Cmd</b>
-		<dl>
+|-
-			<dd>Specifies the offset or command of the device register to write data to.</dd>
+| style="width:293px;" |
-		</dl>
+Success
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd>
-	<dl>
-		<dd><b>Data</b>
-		<dl>
-			<dd>Specifies the word data to be written.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+=== '''3.4.5 SusiI2CProbeDevice''' ===
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiI2CProbeDevice(uint32_t Id, uint32_t Addr)
-<dl>
+:'''Description:'''
-	<dd><b>Return Status Code:</b></dd>
+::Probes I<sup>2</sup>C address to test I<sup>2</sup>C device present.
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Parameters:'''
-	<tbody>
+::'''Id'''
-		<tr>
+:::Selects target device. See '''Table ''''''14'''.
-			<td>&lt;tbody&gt;</td>
+::'''Addr'''
-		</tr>
+:::Encoded 7/10 Bit I<sup>2</sup>C Device Address.
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+:'''Return Status Code:'''
-			<p>SDA Remains low</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			</td>
+|-
-			<td style="width:313px;">
+| style="width:293px;" |
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
+'''Condition'''
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<h3><b>3.5.5 SusiSMB</b>ReceiveByte</h3>
+|-
+| style="width:293px;" |
+Library uninitialized
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiSMBReceiveByte(uint32_t Id, uint8_t Addr, uint8_t *pData)
+SUSI_STATUS_NOT_INITIALIZED
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Unknown Id
-	<dl>
+| style="width:313px;" |
-		<dd>Receive a byte of data from the target slave device in the SMBus.</dd>
+SUSI _STATUS_UNSUPPORTED
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Arbitration Error/Collision Error
-	<dl>
+On Write 1 write cycle
-		<dd><b>Id</b>
-		<dl>
+SDA Remains low
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Time-out due to clock stretching
-		<dd><b>Addr</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+SUSI_STATUS_TIMEOUT
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_NOT_FOUND
-	<dl>
-		<dd><b>pData</b>
-		<dl>
+|-
-			<dd>Pointer to a variable in which the function receive the byte data.</dd>
+| style="width:293px;" |
-		</dl>
+Write Non-ACK
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_WRITE_ERROR
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+=== '''3.4.6 SusiI2CGetFrequency''' ===
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+ uint32_t SUSI_API SusiI2CGetFrequency(uint32_t Id, uint32_t *pFreq)
-			<p>SDA Remains low</p>
+:'''Description:'''
-			</td>
+::Get I<sup>2</sup>C clock frequency.
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table ''''''14'''.
+::'''pFreq'''
+:::Pointer to a buffer that receives the I<sup>2</sup>C clock frequency value. (Unit: Hz)
-<h3><b>3.5.6 SusiSMB</b>SendByte</h3>
+:'''Return Status Code:'''
-<pre class="_fck_mw_lspace">
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-uint32_t SUSI_API SusiSMBSendByte(uint32_t Id, uint8_t Addr, uint8_t Data)
+|-
-</pre>
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+'''Return Value'''
-	<dl>
+|-
-		<dd>Send a byte of data to the target slave device in the SMBus.</dd>
+| style="width:293px;" |
-	</dl>
+Library uninitialized
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Device unsupported
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i><b>.</b></dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pFreq == NULL
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_INVALID_PARAMETER
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+|-
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+| style="width:293px;" |
-		</dl>
+Success
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd>
-	<dl>
-		<dd><b>Data</b>
-		<dl>
+=== '''3.4.7 SusiI2C'''SetFrequency ===
-			<dd>Specifies the word data to be sent.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiI2CSetFrequency(uint32_t Id, uint32_t Freq)
-<p>&nbsp;</p>
+:'''Description:'''
+::Set I<sup>2</sup>C clock frequency.
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table ''''''14'''.
+::'''Freq'''
+:::I<sup>2</sup>C clock frequency value. (Unit: Hz)
-<dl>
+:'''Return Status Code:'''
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<tbody>
+|-
-		<tr>
+| style="width:293px;" |
-			<td>&lt;tbody&gt;</td>
+'''Condition'''
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+'''Return Value'''
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:293px;" |
-			<td style="width:313px;">
+Library uninitialized
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<h3><b>3.5.7 SusiSMBReadQuick</b></h3>
+|-
+| style="width:293px;" |
+Unknown Id
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiSMBReadQuick(uint32_t Id, uint8_t Addr)
+SUSI _STATUS_UNSUPPORTED
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Device unsupported
-	<dl>
+| style="width:313px;" |
-		<dd>Turn SMBus device function off (on) or disable (enable) a specific device mode.</dd>
+SUSI _STATUS_UNSUPPORTED
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd><b>Parameters:</b>
-	<dl>
+== '''3.5 SMBus Functions''' ==
-		<dd><b>Id</b>
-		<dl>
+SMBus is the System Management Bus defined by Intel Corporation in 1995. It is used in personal computers and servers for low-speed system management communications.
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Table '''15 SMBus ID
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Id'''
-<dl>
+| style="width:302px;" |
-	<dd>
+'''Description'''
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+|-
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+| style="width:297px;" |
-		</dl>
+SUSI_ID_ SMBUS _EXTERNAL
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:302px;" |
+Main SMBus host device
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_ID_SMBUS_OEM0~3
-<p>&nbsp;</p>
+| style="width:302px;" |
+Other SMBus host devices
-<dl>
+|}
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
-			<p>SDA Remains low</p>
+=== '''3.5.1 SusiSMBReadByte''' ===
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.5.8 SusiSMB</b>WriteQuick</h3>
+ uint32_t SUSI_API SusiSMBReadByte(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pData)
-<pre class="_fck_mw_lspace">
+:'''Description:'''
-uint32_t SUSI_API SusiSMBWriteQuick(uint32_t Id, uint8_t Addr)
+::Read a byte of data from the target slave device in the SMBus.
-</pre>
-<dl>
+:'''Parameters:'''
-	<dd><b>Description:</b>
+::'''Id'''
+:::Selects target device. See '''Table ''''''15'''.
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
+::'''Cmd'''
+:::Specifies the offset or command of the device register to read data from.
+::'''pData'''
+:::Pointer to a variable in which the function reads the byte data.
-	<dl>
+:'''Return Status Code:'''
-		<dd>Turn SMBus device function off (on) or disable (enable) a specific device mode.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Library uninitialized
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI_STATUS_NOT_INITIALIZED
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
+| style="width:293px;" |
-		</dl>
+pData==NULL
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Unknown Id
-		<dd><b>Addr</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<dl>
+On Write 1 write cycle
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+SDA Remains low
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:293px;" |
-			<td style="width:313px;">
+Time-out due to clock stretching
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<h3><b>3.5.9 SusiSMBReadBlock</b></h3>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiSMBReadBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t *pLength)
+SUSI_STATUS_NOT_FOUND
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Write Non-ACK
-	<dl>
+| style="width:313px;" |
-		<dd>Read multi-data from the target slave device in the SMBus.</dd>
+SUSI_STATUS_WRITE_ERROR
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd><b>Parameters:</b>
-	<dl>
-		<dd><b>Id</b>
-		<dl>
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+=== '''3.5.2 SusiSMB'''WriteByte ===
-<dl>
+ uint32_t SUSI_API SusiSMBWriteByte(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t Data)
-	<dd>
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+:'''Description:'''
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+::Write a byte of data to the target slave device in the SMBus.
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table ''''''15'''.
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
+::'''Cmd'''
+:::Specifies the offset or command of the device register to write data to.
+::'''Data'''
+:::Specifies the byte data to be written.
-<dl>
+:'''Return Status Code:'''
-	<dd>
-	<dl>
-		<dd><b>Cmd</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Specifies the offset or command of the device register to read data from.</dd>
+|-
-		</dl>
+| style="width:293px;" |
-		</dd>
+'''Condition'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Library uninitialized
-		<dd><b>pBuffer</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Pointer to a byte array in which the function reads the block data.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
-		<dd><b>pLength</b>
-		<dl>
+|-
-			<dd>Pointer to a byte in which specifies the number of bytes to be read and also return succeed bytes.</dd>
+| style="width:293px;" |
-		</dl>
+Bus Busy SDA/SDC low
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<p>&nbsp;</p>
+On Write 1 write cycle
-<dl>
+SDA Remains low
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_BUSY_COLLISION
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+|-
+| style="width:293px;" |
+Time-out due to clock stretching
-			<p>SDA Remains low</p>
+| style="width:313px;" |
-			</td>
+SUSI_STATUS_TIMEOUT
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<h3><b>3.5.10 SusiSMB</b>WriteBlock</h3>
+| style="width:313px;" |
+SUSI_STATUS_NOT_FOUND
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiSMBWriteBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t Length)
+| style="width:293px;" |
-</pre>
+Write Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_WRITE_ERROR
-	<dl>
+|-
-		<dd>Write multi-data from the target slave device in the SMBus.</dd>
+| style="width:293px;" |
-	</dl>
+Success
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Parameters:</b>
-	<dl>
-		<dd><b>Id</b>
-		<dl>
+=== '''3.5.3 SusiSMBReadWord''' ===
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiSMBReadWord(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint16_t *pData)
-<dl>
+:'''Description:'''
-	<dd>
+::Read a word of data from the target slave device in the SMBus.
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+:'''Parameters:'''
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See '''Table ''''''15'''.
-		</dd>
+::'''Addr'''
-	</dl>
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
-	</dd>
+::'''Cmd'''
-</dl>
+:::Specifies the offset or command of the device register to read data from.
+::'''pData'''
+:::Pointer to a variable in which the function reads the word data.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd>
+|-
-	<dl>
+| style="width:293px;" |
-		<dd><b>Cmd</b>
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the offset or command of the device register to write data to.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_NOT_INITIALIZED
-	<dl>
-		<dd><b>pBuffer</b>
-		<dl>
+|-
-			<dd>Pointer to a byte array in which the function writes the block data.</dd>
+| style="width:293px;" |
-		</dl>
+pData==NULL
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Unknown Id
-		<dd><b>Length</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the number of bytes to be write.</dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<dl>
+On Write 1 write cycle
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+SDA Remains low
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:293px;" |
-			<td style="width:313px;">
+Time-out due to clock stretching
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<h3><b>3.5.11 SusiSMB</b>I2CReadBlock</h3>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiSMBI2CReadBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t *pLength)
+SUSI_STATUS_NOT_FOUND
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Write Non-ACK
-	<dl>
+| style="width:313px;" |
-		<dd>Read multi-data using I<sup>2</sup>C block protocol from the target slave device in the SMBus.</dd>
+SUSI_STATUS_WRITE_ERROR
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd><b>Parameters:</b>
-	<dl>
-		<dd><b>Id</b>
-		<dl>
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+=== '''3.5.4 SusiSMB'''WriteWord ===
-<dl>
+ uint32_t SUSI_API SusiSMBWriteWord(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint16_t Data)
-	<dd>
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+:'''Description:'''
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+::Write a word of data to the target slave device in the SMBus.
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table ''''''15'''.
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
+::'''Cmd'''
+:::Specifies the offset or command of the device register to write data to.
+::'''Data'''
+:::Specifies the word data to be written.
-<dl>
+:'''Return Status Code:'''
-	<dd>
-	<dl>
-		<dd><b>Cmd</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Specifies the offset or command of the device register to read data from.</dd>
+|-
-		</dl>
+| style="width:293px;" |
-		</dd>
+'''Condition'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Library uninitialized
-		<dd><b>pBuffer</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Pointer to a byte array in which the function reads the block data.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
-		<dd><b>pLength</b>
-		<dl>
+|-
-			<dd>Pointer to a byte in which specifies the number of bytes to be read and also return succeed bytes.</dd>
+| style="width:293px;" |
-		</dl>
+Bus Busy SDA/SDC low
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<p>&nbsp;</p>
+On Write 1 write cycle
-<dl>
+SDA Remains low
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_BUSY_COLLISION
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+|-
+| style="width:293px;" |
+Time-out due to clock stretching
-			<p>SDA Remains low</p>
+| style="width:313px;" |
-			</td>
+SUSI_STATUS_TIMEOUT
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<h3><b>3.5.12 SusiSMB</b>I2CWriteBlock</h3>
+| style="width:313px;" |
+SUSI_STATUS_NOT_FOUND
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiSMBI2CWriteBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t Length)
+| style="width:293px;" |
-</pre>
+Write Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_WRITE_ERROR
-	<dl>
+|-
-		<dd>Write multi-data using I<sup>2</sup>C block protocol from the target slave device in the SMBus.</dd>
+| style="width:293px;" |
-	</dl>
+Success
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Parameters:</b>
-	<dl>
-		<dd><b>Id</b>
-		<dl>
+=== '''3.5.5 SusiSMB'''ReceiveByte ===
-			<dd>Selects target device. See <b>Table &#39;</b><i>15&#39;</i>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiSMBReceiveByte(uint32_t Id, uint8_t Addr, uint8_t *pData)
-<dl>
+:'''Description:'''
-	<dd>
+::Receive a byte of data from the target slave device in the SMBus.
-	<dl>
-		<dd><b>Addr</b>
-		<dl>
+:'''Parameters:'''
-			<dd>Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See '''Table ''''''15'''.
-		</dd>
+::'''Addr'''
-	</dl>
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
-	</dd>
+::'''pData'''
-</dl>
+:::Pointer to a variable in which the function receive the byte data.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd>
+|-
-	<dl>
+| style="width:293px;" |
-		<dd><b>Cmd</b>
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the offset or command of the device register to write data to.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_NOT_INITIALIZED
-	<dl>
-		<dd><b>pBuffer</b>
-		<dl>
+|-
-			<dd>Pointer to a byte array in which the function writes the block data.</dd>
+| style="width:293px;" |
-		</dl>
+pBuffer==NULL
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Unknown Id
-		<dd><b>Length</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Specifies the number of bytes to be write.</dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<dl>
+On Write 1 write cycle
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+SDA Remains low
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device unsupported</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bus Busy SDA/SDC low</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Arbitration Error/Collision Error</p>
-			<p>On Write 1 write cycle</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-			<p>SDA Remains low</p>
+|-
-			</td>
+| style="width:293px;" |
-			<td style="width:313px;">
+Time-out due to clock stretching
-			<p>SUSI_STATUS_BUSY_COLLISION</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Time-out due to clock stretching</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_TIMEOUT</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Address Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_FOUND</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write Non-ACK</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.6 Watchdog Functions</b></h3>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<p>After the watchdog timer has been start function it must be triggered within (Delay + Event Timeout) milliseconds as set with the start function, following the initial trigger every subsequent trigger must occur within (Event Timeout) milliseconds. Should trigger not be called within the relevant time limit a system reset will occur. The SUSI watchdog timer may support two stages. If the watchdog is not triggered within the event timeout, an NMI, IRQ, or hardware output will be generated. Then the reset timeout becomes active. If the watchdog timer is not triggered within the reset timeout a reset will be generated</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd><b>Initial timing:</b>
+SUSI_STATUS_NOT_FOUND
-	<dl>
+|-
-		<dd>&lt;img _fck_mw_filename=&quot;Initial timing.png&quot; _fck_mw_origimgheight=&quot;121&quot; _fck_mw_origimgwidth=&quot;652&quot; alt=&quot;RTENOTITLE&quot; src=&quot;/wiki/images/9/9e/Initial_timing.png&quot; style=&quot;vertical-align:middle;&quot; title=&quot;RTENOTITLE&quot; /&gt;</dd>
+| style="width:293px;" |
-	</dl>
+Write Non-ACK
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_WRITE_ERROR
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd><b>Timing after trigger:</b></dd>
+SUSI_STATUS_SUCCESS
-</dl>
-<dl>
+|}
-	<dd>
-	<dl>
-		<dd>&lt;img _fck_mw_filename=&quot;Timing after trigger.png&quot; _fck_mw_origimgheight=&quot;127&quot; _fck_mw_origimgwidth=&quot;584&quot; alt=&quot;RTENOTITLE&quot; src=&quot;/wiki/images/a/a4/Timing_after_trigger.png&quot; style=&quot;vertical-align:middle;&quot; title=&quot;RTENOTITLE&quot; /&gt;</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
-<dl>
+=== '''3.5.6 SusiSMB'''SendByte ===
-	<dd><b>Where:</b></dd>
-</dl>
-<dl>
+ uint32_t SUSI_API SusiSMBSendByte(uint32_t Id, uint8_t Addr, uint8_t Data)
-	<dd>
-	<dl>
-		<dd><b>Stage A</b>
-		<dl>
+:'''Description:'''
-			<dd>Watchdog is started.</dd>
+::Send a byte of data to the target slave device in the SMBus.
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table ''''''15''''''.'''
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
+::'''Data'''
+:::Specifies the word data to be sent.
-<dl>
+:'''Return Status Code:'''
-	<dd>
-	<dl>
-		<dd><b>Stage B</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Initial Delay Period is exhausted.</dd>
+|-
-		</dl>
+| style="width:293px;" |
-		</dd>
+'''Condition'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Library uninitialized
-		<dd><b>Stage C/F</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Event is triggered, NMI, IRQ, or PIN is Triggered. To Allow for possible Software Recovery.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
-		<dd><b>Stage D/G</b>
-		<dl>
+|-
-			<dd>System is reset.</dd>
+| style="width:293px;" |
-		</dl>
+Bus Busy SDA/SDC low
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Arbitration Error/Collision Error
-		<dd><b>Stage E</b></dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+On Write 1 write cycle
-<ul style="margin-left: 160px;">
+SDA Remains low
-	<li>Watchdog is Triggered.</li>
-	<li>Trigger / Stop must be called before Stage C/F to prevent event from being generated.</li>
-	<li>Trigger / Stop must be called before Stage D/G to prevent The system from being reset.</li>
-</ul>
-<dl>
+| style="width:313px;" |
-	<dd><b>Table 16 Watchdog ID</b></dd>
+SUSI_STATUS_BUSY_COLLISION
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Time-out due to clock stretching
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WATCHDOG_1</p>
-			</td>
-			<td style="width:302px;">
-			<p>First watchdog timer</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WATCHDOG_2</p>
-			</td>
-			<td style="width:302px;">
-			<p>Second watchdog timer</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WATCHDOG_3</p>
-			</td>
-			<td style="width:302px;">
-			<p>Third watchdog timer</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<h3><b>3.6.1 SusiWDogGetCaps</b></h3>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiWDogGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
+SUSI_STATUS_NOT_FOUND
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Write Non-ACK
-	<dl>
+| style="width:313px;" |
-		<dd>Gets watchdog capabilities.</dd>
+SUSI_STATUS_WRITE_ERROR
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+SUSI_STATUS_SUCCESS
-	<dl>
+|}
-		<dd><b>Id</b>
-		<dl>
-			<dd>Selects target device. See <b>Table 16</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<dl>
+=== '''3.5.7 SusiSMBReadQuick''' ===
-	<dd>
-	<dl>
-		<dd><b>ItemId</b>
-		<dl>
+ uint32_t SUSI_API SusiSMBReadQuick(uint32_t Id, uint8_t Addr)
-			<dd>Selects target capability. See <b>Table 17</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Turn SMBus device function off (on) or disable (enable) a specific device mode.
-<dl>
+:'''Parameters:'''
-	<dd>
+::'''Id'''
-	<dl>
+:::Selects target device. See '''Table ''''''15'''.
-		<dd><b>pValue</b>
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
-		<dl>
+:'''Return Status Code:'''
-			<dd>Pointer to a buffer that receives the target capability.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_NOT_INITIALIZED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Unknown Id
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id or ItemId</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+| style="width:313px;" |
-	<dd><b>Table </b>17 Watchdog capabilities item Id</dd>
+SUSI _STATUS_UNSUPPORTED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Bus Busy SDA/SDC low
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Item Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_SUPPORT_FLAGS</p>
-			</td>
-			<td style="width:302px;">
-			<p>Event support flags (<b>Table 18</b>)</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_DELAY_MAXIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The maximum delay time value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_DELAY_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The minimum delay time value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_EVENT_MAXIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The maximum event time value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_EVENT_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The minimum event time value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_RESET_MAXIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The maximum reset time value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_RESET_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The minimum reset time value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_UNIT_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The minimum unit value</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_DELAY_TIME</p>
-			</td>
-			<td style="width:302px;">
-			<p>Current delay time setting</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_EVENT_TIME</p>
-			</td>
-			<td style="width:302px;">
-			<p>Current event time setting</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_RESET_TIME</p>
-			</td>
-			<td style="width:302px;">
-			<p>Current reset time setting</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_WDT_EVENT_TYPE</p>
-			</td>
-			<td style="width:302px;">
-			<p>Current event type (<b>Table 19</b>)</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<h3><b>3.6.2 SusiWDogStart</b></h3>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<pre class="_fck_mw_lspace">
+On Write 1 write cycle
-uint32_t SUSI_API SusiWDogStart(uint32_t Id, uint32_t DelayTime, uint32_t EventTime, uint32_t ResetTime, uint32_t EventType)
-</pre>
-<dl>
+SDA Remains low
-	<dd><b>Description:</b>
-	<dl>
+| style="width:313px;" |
-		<dd>Start the watchdog timer and set the parameters. To adjust the parameters, the watchdog must be stopped and then start again with the new values. If the hardware implementation of the watchdog timer does not allow a setting at the exact time selected, the SUSI API selects the next possible longer timing.</dd>
+SUSI_STATUS_BUSY_COLLISION
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Time-out due to clock stretching
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Address Non-ACK
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI_STATUS_NOT_FOUND
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 16</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Success
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd>
-	<dl>
-		<dd><b>DelayTime</b>
-		<dl>
+=== '''3.5.8 SusiSMB'''WriteQuick ===
-			<dd>Initial delay for the watchdog timer in milliseconds.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiSMBWriteQuick(uint32_t Id, uint8_t Addr)
-<dl>
+:'''Description:'''
-	<dd>
+::Turn SMBus device function off (on) or disable (enable) a specific device mode.
-	<dl>
-		<dd><b>EventTime</b>
-		<dl>
+:'''Parameters:'''
-			<dd>Watchdog timeout interval in milliseconds to trigger an event.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See '''Table ''''''15'''.
-		</dd>
+::'''Addr'''
-	</dl>
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd>
+|-
-	<dl>
+| style="width:293px;" |
-		<dd><b>ResetTime</b>
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Watchdog timeout interval in milliseconds to trigger a reset.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_NOT_INITIALIZED
-	<dl>
-		<dd><b>EventType</b>
-		<dl>
+|-
-			<dd>To select one kind of event type. See <b>Table 19</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Unknown Id
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:293px;" |
-</dl>
+Arbitration Error/Collision Error
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+On Write 1 write cycle
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Wrong time range</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+SDA Remains low
-	<dd><b>Table </b>18 Watchdog Support Flags</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_BUSY_COLLISION
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Flag Name</b></p>
-			</td>
-			<td style="width:246px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:59px;">
-			<p><b>Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_WDT_FLAG_SUPPORT_IRQ</p>
-			</td>
-			<td style="width:246px;">
-			<p>Support IRQ event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x01</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_WDT_FLAG_SUPPORT_SCI</p>
-			</td>
-			<td style="width:246px;">
-			<p>Support SCI event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x02</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_WDT_FLAG_SUPPORT_PWRBTN</p>
-			</td>
-			<td style="width:246px;">
-			<p>Support power button event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x04</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+|-
-	<dd><b>Table </b>19 Watchdog timer event type</dd>
+| style="width:293px;" |
-</dl>
+Time-out due to clock stretching
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_TIMEOUT
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Event Type</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_WDT_EVENT_TYPE_NONE</p>
-			</td>
-			<td style="width:302px;">
-			<p>No event</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_WDT_EVENT_TYPE_SCI</p>
-			</td>
-			<td style="width:302px;">
-			<p>SCI event</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_WDT_EVENT_TYPE_IRQ</p>
-			</td>
-			<td style="width:302px;">
-			<p>IRQ event</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_WDT_EVENT_TYPE_PWRBTN</p>
-			</td>
-			<td style="width:302px;">
-			<p>Power button event</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<h3><b>3.6.3 SusiWDogStop</b></h3>
+| style="width:313px;" |
+SUSI_STATUS_NOT_FOUND
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiWDogStop(uint32_t Id)
+| style="width:293px;" |
-</pre>
+Success
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_SUCCESS
-	<dl>
+|}
-		<dd>Stops the operation of the watchdog timer.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<dl>
-	<dd><b>Parameters:</b>
-	<dl>
+=== '''3.5.9 SusiSMBReadBlock''' ===
-		<dd><b>Id</b>
-		<dl>
+ uint32_t SUSI_API SusiSMBReadBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t *pLength)
-			<dd>Selects target device. See <b>Table 16</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Read multi-data from the target slave device in the SMBus.
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table ''''''15'''.
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
+::'''Cmd'''
+:::Specifies the offset or command of the device register to read data from.
+::'''pBuffer'''
+:::Pointer to a byte array in which the function reads the block data.
+::'''pLength'''
+:::Pointer to a byte in which specifies the number of bytes to be read and also return succeed bytes.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Return Status Code:</b></dd>
+|-
-</dl>
+| style="width:293px;" |
+'''Condition'''
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+'''Return Value'''
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.6.4 SusiWDog</b>Trigger</h3>
+|-
+| style="width:293px;" |
+Library uninitialized
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiWDogTrigger(uint32_t Id)
+SUSI_STATUS_NOT_INITIALIZED
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+pBuffer==NULL
-	<dl>
+| style="width:313px;" |
-		<dd>Trigger the watchdog timer.</dd>
+SUSI _STATUS_INVALID_PARAMETER
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table 16</b>.</dd>
+SUSI_STATUS_BUSY_COLLISION
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<p>&nbsp;</p>
+On Write 1 write cycle
-<p>&nbsp;</p>
+SDA Remains low
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_BUSY_COLLISION
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Time-out due to clock stretching
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.6.5 SusiWDogSetCallBack</b></h3>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiWDogSetCallBack(uint32_t Id, SUSI_WDT_INT_CALLBACK pfnCallback, void *Context)
+| style="width:293px;" |
-</pre>
+Address Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_NOT_FOUND
-	<dl>
+|-
-		<dd>The call back function pointer can be transmit from Application when IRQ triggered.</dd>
+| style="width:293px;" |
-	</dl>
+Write Non-ACK
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_WRITE_ERROR
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+SUSI_STATUS_SUCCESS
-	<dl>
+|}
-		<dd><b>Id</b>
-		<dl>
-			<dd>Selects target device. See <b>Table 16</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<dl>
+=== '''3.5.10 SusiSMB'''WriteBlock ===
-	<dd>
-	<dl>
-		<dd><b>pfnCallback</b>
-		<dl>
+ uint32_t SUSI_API SusiSMBWriteBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t Length)
-			<dd>Call back function pointer, SUSI_WDT_INT_CALLBACK is function pointer type, it can set NULL to clear. The type definition just like show below,</dd>
-			<dd><i>typedef void (*SUSI_WDT_INT_CALLBACK)(void*);</i></dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Write multi-data from the target slave device in the SMBus.
-<dl>
+:'''Parameters:'''
-	<dd>
+::'''Id'''
-	<dl>
+:::Selects target device. See '''Table ''''''15'''.
-		<dd><b>Context</b>
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
+::'''Cmd'''
+:::Specifies the offset or command of the device register to write data to.
+::'''pBuffer'''
+:::Pointer to a byte array in which the function writes the block data.
+::'''Length'''
+:::Specifies the number of bytes to be write.
-		<dl>
+:'''Return Status Code:'''
-			<dd>Pointer to a user context structure for callback function.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_NOT_INITIALIZED
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+pBuffer==NULL
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<h2><b>3.7 GPIO Functions</b></h2>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>Programmable GPIO allows developers to dynamically set the GPIO input or output status</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-<dl>
+| style="width:313px;" |
-	<dd><b>Table </b>20 GPIO ID</dd>
+SUSI_STATUS_BUSY_COLLISION
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Arbitration Error/Collision Error
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:259px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:340px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:259px;">
-			<p>SUSI_ID_GPIO(X)</p>
-			</td>
-			<td style="width:340px;">
-			<p>X is GPIO pin number, definition as below:</p>
-			<ol>
+On Write 1 write cycle
-				<li>define SUSI_ID_GPIO(x) (0x0000 | x)</li>
-			</ol>
-			<p>This ID control single pin only.</p>
+SDA Remains low
-			</td>
-		</tr>
-		<tr>
-			<td style="width:259px;">
-			<p>SUSI_ID_GPIO_BANK(Y)</p>
-			</td>
-			<td style="width:340px;">
-			<p>Y is GPIO bank number, definition as below:</p>
-			<ol>
+| style="width:313px;" |
-				<li>define SUSI_ID_GPIO_BANK(Y) (0x10000 | Y)</li>
+SUSI_STATUS_BUSY_COLLISION
-			</ol>
-			<p>This ID control maximum 32 pins per bank.</p>
+|-
-			</td>
+| style="width:293px;" |
-		</tr>
+Time-out due to clock stretching
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<h3><b>3.7.1 SusiGPIOGetCaps</b></h3>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiGPIOGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
+SUSI_STATUS_NOT_FOUND
-</pre>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Write Non-ACK
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_WRITE_ERROR
-	<dl>
+|-
-		<dd>Reads the capabilities of the current GPIO implementation from the selected GPIO interface.</dd>
+| style="width:293px;" |
-	</dl>
+Success
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Parameters:</b>
-	<dl>
-		<dd><b>Id</b>
-		<dl>
+=== '''3.5.11 SusiSMB'''I2CReadBlock ===
-			<dd>Selects target device. See <b>Table 20</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiSMBI2CReadBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t *pLength)
-<dl>
+:'''Description:'''
-	<dd>
+::Read multi-data using I<sup>2</sup>C block protocol from the target slave device in the SMBus.
-	<dl>
-		<dd><b>ItemId</b>
-		<dl>
+:'''Parameters:'''
-			<dd>Selects target capability. See <b>Table 21</b>.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See '''Table ''''''15'''.
-		</dd>
+::'''Addr'''
-	</dl>
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
-	</dd>
+::'''Cmd'''
-</dl>
+:::Specifies the offset or command of the device register to read data from.
+::'''pBuffer'''
+:::Pointer to a byte array in which the function reads the block data.
+::'''pLength'''
+:::Pointer to a byte in which specifies the number of bytes to be read and also return succeed bytes.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd>
+|-
-	<dl>
+| style="width:293px;" |
-		<dd><b>pValue</b>
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Pointer to a buffer that receives the target capability. Each bit of the buffer value represents support situation of a GPIO, according to the order. 1 is supportive, and 0 is unsupportive.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pBuffer==NULL
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI _STATUS_INVALID_PARAMETER
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Unknown Id
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd><b>Table </b>21 GPIO capabilities item Id</dd>
+| style="width:293px;" |
-</dl>
+Device unsupported
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI _STATUS_UNSUPPORTED
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Item Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_GPIO_INPUT_SUPPORT</p>
-			</td>
-			<td style="width:302px;">
-			<p>Get GPIO input support state</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_GPIO_OUTPUT_SUPPORT</p>
-			</td>
-			<td style="width:302px;">
-			<p>Get GPIO output support state</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bus Busy SDA/SDC low
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<h3><b>3.7.2 SusiGPIOGetDirection</b></h3>
+|-
+| style="width:293px;" |
+Arbitration Error/Collision Error
-<pre class="_fck_mw_lspace">
+On Write 1 write cycle
-uint32_t SUSI_API SusiGPIOGetDirection(uint32_t Id, uint32_t Bitmask, uint32_t *pDirection)
-</pre>
-<dl>
+SDA Remains low
-	<dd><b>Description:</b>
-	<dl>
+| style="width:313px;" |
-		<dd>Gets the configuration for the selected GPIO ports.</dd>
+SUSI_STATUS_BUSY_COLLISION
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Time-out due to clock stretching
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Address Non-ACK
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI_STATUS_NOT_FOUND
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 20</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Write Non-ACK
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_WRITE_ERROR
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Success
-		<dd><b>Bitmask</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.</dd>
+SUSI_STATUS_SUCCESS
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd>
-	<dl>
-		<dd><b>pDirection</b>
-		<dl>
-			<dd>Pointer to a buffer that receives the direction of the selected GPIO ports.&nbsp;(0 means output and 1 means input)</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+=== '''3.5.12 SusiSMB'''I2CWriteBlock ===
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiSMBI2CWriteBlock(uint32_t Id, uint8_t Addr, uint8_t Cmd, uint8_t *pBuffer, uint32_t Length)
-<p>&nbsp;</p>
+:'''Description:'''
+::Write multi-data using I<sup>2</sup>C block protocol from the target slave device in the SMBus.
-<dl>
+:'''Parameters:'''
-	<dd><b>Return Status Code:</b></dd>
+::'''Id'''
-</dl>
+:::Selects target device. See '''Table ''''''15'''.
+::'''Addr'''
+:::Specifies the 8-bit device address, ranging from 0x00 to 0xFF. Whether to give a 1 (read) or 0 (write) to the LSB of slave address could be ignored.
+::'''Cmd'''
+:::Specifies the offset or command of the device register to write data to.
+::'''pBuffer'''
+:::Pointer to a byte array in which the function writes the block data.
+::'''Length'''
+:::Specifies the number of bytes to be write.
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Return Status Code:'''
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pDirection==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bitmask==0 when bank mode</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.7.3 SusiGPIOSetDirection</b></h3>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiGPIOSetDirection(uint32_t Id, uint32_t Bitmask, uint32_t Direction)
+'''Return Value'''
-</pre>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI_STATUS_NOT_INITIALIZED
-	<dl>
+|-
-		<dd>
+| style="width:293px;" |
-		<dl>
+pBuffer==NULL
-			<dd>Sets the configuration for the selected GPIO ports.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Device unsupported
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI _STATUS_UNSUPPORTED
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 20</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Bus Busy SDA/SDC low
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_BUSY_COLLISION
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Arbitration Error/Collision Error
-		<dd><b>Bitmask</b>
-		<dl>
+On Write 1 write cycle
-			<dd>Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+SDA Remains low
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_BUSY_COLLISION
-	<dl>
-		<dd><b>Direction</b>
-		<dl>
+|-
-			<dd>Sets the direction of the selected GPIO ports. (0 means output and 1 means input)</dd>
+| style="width:293px;" |
-		</dl>
+Time-out due to clock stretching
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_TIMEOUT
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Address Non-ACK
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_FOUND
-<dl>
+|-
-	<dd><b>Return Status Code:</b></dd>
+| style="width:293px;" |
-</dl>
+Write Non-ACK
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_WRITE_ERROR
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bitmask==0 when bank mode</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h3><b>3.7.4 SusiGPIOGetLevel</b></h3>
+|-
+| style="width:293px;" |
+Success
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiGPIOGetLevel(uint32_t Id, uint32_t Bitmask, uint32_t *pLevel)
+SUSI_STATUS_SUCCESS
-</pre>
-<dl>
+|}
-	<dd><b>Description:</b>
-	<dl>
+=== '''3.6 Watchdog Functions''' ===
-		<dd>Read level the from GPIO ports.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+After the watchdog timer has been start function it must be triggered within (Delay + Event Timeout) milliseconds as set with the start function, following the initial trigger every subsequent trigger must occur within (Event Timeout) milliseconds. Should trigger not be called within the relevant time limit a system reset will occur. The SUSI watchdog timer may support two stages. If the watchdog is not triggered within the event timeout, an NMI, IRQ, or hardware output will be generated. Then the reset timeout becomes active. If the watchdog timer is not triggered within the reset timeout a reset will be generated
-<p>&nbsp;</p>
+:'''Initial timing:'''
+::[[File:Initial timing.png|RTENOTITLE]]
-<dl>
+:'''Timing after trigger:'''
-	<dd><b>Parameters:</b>
-	<dl>
+::[[File:Timing after trigger.png|RTENOTITLE]]
-		<dd><b>Id</b>
-		<dl>
+:'''Where:'''
-			<dd>Selects target device. See <b>Table 20</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+::'''Stage A'''
+:::Watchdog is started.
+::'''Stage B'''
+:::Initial Delay Period is exhausted.
+::'''Stage C/F'''
+:::Event is triggered, NMI, IRQ, or PIN is Triggered. To Allow for possible Software Recovery.
+::'''Stage D/G'''
+:::System is reset.
+::'''Stage E'''
+<ul style="margin-left: 160px;">
+<li>Watchdog is Triggered.</li>
+<li>Trigger / Stop must be called before Stage C/F to prevent event from being generated.</li>
+<li>Trigger / Stop must be called before Stage D/G to prevent The system from being reset.</li>
+</ul>
-<dl>
+:'''Table 16 Watchdog ID'''
-	<dd>
-	<dl>
-		<dd><b>Bitmask</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.</dd>
+|-
-		</dl>
+| style="width:297px;" |
-		</dd>
+'''Id'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:302px;" |
+'''Description'''
-<dl>
+|-
-	<dd>
+| style="width:297px;" |
-	<dl>
+SUSI_ID_WATCHDOG_1
-		<dd><b>pLevel</b>
-		<dl>
+| style="width:302px;" |
-			<dd>Pointer to a buffer that receives the GPIO level.</dd>
+First watchdog timer
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_ID_WATCHDOG_2
-<p>&nbsp;</p>
+| style="width:302px;" |
+Second watchdog timer
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_ID_WATCHDOG_3
-<dl>
+| style="width:302px;" |
-	<dd><b>Return Status Code:</b></dd>
+Third watchdog timer
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|}
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pLevel==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bitmask==0 when bank mode</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
-<h3><b>3.7.5 SusiGPIOSetLevel</b></h3>
-<pre class="_fck_mw_lspace">
+=== '''3.6.1 SusiWDogGetCaps''' ===
-uint32_t SUSI_API SusiGPIOSetLevel(uint32_t Id, uint32_t Bitmask, uint32_t Level)
-</pre>
-<dl>
+ uint32_t SUSI_API SusiWDogGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
-	<dd><b>Description:</b>
-	<dl>
+:'''Description:'''
-		<dd>Write level to GPIO ports. Depending on the hardware implementation writing multiple GPIO ports with the bit mask option does not guarantee a time synchronous change of the output levels.</dd>
+::Gets watchdog capabilities.
-	</dl>
+:'''Parameters:'''
-	</dd>
+::'''Id'''
-</dl>
+:::Selects target device. See '''Table 16'''.
+::'''ItemId'''
+:::Selects target capability. See '''Table 17'''.
+::'''pValue'''
+:::Pointer to a buffer that receives the target capability.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+'''Return Value'''
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Library uninitialized
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table 20</b>.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pValue==NULL
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_INVALID_PARAMETER
-	<dl>
-		<dd><b>Bitmask</b>
-		<dl>
+|-
-			<dd>Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.</dd>
+| style="width:293px;" |
-		</dl>
+Unknown Id or ItemId
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Success
-		<dd><b>Level</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Input level of the selected GPIO port.</dd>
+SUSI_STATUS_SUCCESS
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
+:'''Table '''17 Watchdog capabilities item Id
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Item Id'''
-<dl>
+| style="width:302px;" |
-	<dd><b>Return Status Code:</b></dd>
+'''Description'''
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:297px;" |
-		<tr>
+SUSI_ID_WDT_SUPPORT_FLAGS
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Bitmask==0 when bank mode</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<h2><b>3.8 Smart Fan Functions</b></h2>
+| style="width:302px;" |
+Event support flags ('''Table 18''')
-<p>The Smart Fan function call is used to set fan speed configuration. You can use this function to easily control the fan speed. It takes a pointer to an instance of structure <i>SusiFanControl</i>, which is defined as follows:</p>
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_DELAY_MAXIMUM
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:302px;" |
-	<tbody>
+The maximum delay time value
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:598px;height:582px;">
-			<pre>
-#define SUSI_FAN_AUTO_CTRL_OPMODE_PWM 0
-#define SUSI_FAN_AUTO_CTRL_OPMODE_RPM 1
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_DELAY_MINIMUM
-typedef struct _AutoFan {
+| style="width:302px;" |
+The minimum delay time value
- uint32_t TmlSource; // Thermal source
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_EVENT_MAXIMUM
- uint32_t OpMode;
+| style="width:302px;" |
+The maximum event time value
- uint32_t LowStopLimit; // Temperature (0.1 Kelvins)
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_EVENT_MINIMUM
- uint32_t LowLimit; // Temperature (0.1 Kelvins)
+| style="width:302px;" |
+The minimum event time value
- uint32_t HighLimit; // Temperature (0.1 Kelvins)
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_RESET_MAXIMUM
- uint32_t MinPWM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_PWM
+| style="width:302px;" |
+The maximum reset time value
- uint32_t MaxPWM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_PWM
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_RESET_MINIMUM
- uint32_t MinRPM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_RPM
+| style="width:302px;" |
+The minimum reset time value
- uint32_t MaxRPM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_RPM
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_UNIT_MINIMUM
-} AutoFan , *PAutoFan&amp;amp;nbsp;;
+| style="width:302px;" |
+The minimum unit value
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_DELAY_TIME
+| style="width:302px;" |
+Current delay time setting
-// Mode
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_EVENT_TIME
-#define SUSI_FAN_CTRL_MODE_OFF 0
+| style="width:302px;" |
+Current event time setting
-#define SUSI_FAN_CTRL_MODE_FULL 1
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_RESET_TIME
-#define SUSI_FAN_CTRL_MODE_MANUAL 2
+| style="width:302px;" |
+Current reset time setting
-#define SUSI_FAN_CTRL_MODE_AUTO 3
+|-
+| style="width:297px;" |
+SUSI_ID_WDT_EVENT_TYPE
-typedef struct _SusiFanControl {
+| style="width:302px;" |
+Current event type ('''Table 19''')
- uint32_t Mode;
+|}
- uint32_t PWM; // Manual mode only (0 - 100%)
- AutoFan AutoControl; // Auto mode only
-} SusiFanControl, *PSusiFanControl;
+=== '''3.6.2 SusiWDogStart''' ===
-</pre>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>If Mode member of SusiFanControl is not Auto, AutoControl member will be ignored. In auto mode, parameter &ldquo;TmlSource&rdquo; is use <i>SUSI_ID_HWM_TEMP_XXX</i> (<b>Table 3</b>) to select which thermal type to reference. If TmlSource is not match any temperature ID means unknown or unsupported.</p>
+ uint32_t SUSI_API SusiWDogStart(uint32_t Id, uint32_t DelayTime, uint32_t EventTime, uint32_t ResetTime, uint32_t EventType)
-<p>&nbsp;</p>
+:'''Description:'''
+::Start the watchdog timer and set the parameters. To adjust the parameters, the watchdog must be stopped and then start again with the new values. If the hardware implementation of the watchdog timer does not allow a setting at the exact time selected, the SUSI API selects the next possible longer timing.
-<h3><b>3.8.1 SusiFanControlGetCaps</b></h3>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 16'''.
+::'''DelayTime'''
+:::Initial delay for the watchdog timer in milliseconds.
+::'''EventTime'''
+:::Watchdog timeout interval in milliseconds to trigger an event.
+::'''ResetTime'''
+:::Watchdog timeout interval in milliseconds to trigger a reset.
+::'''EventType'''
+:::To select one kind of event type. See '''Table 19'''.
-<pre class="_fck_mw_lspace">
+:'''Return Status Code:'''
-uint32_t SUSI_API SusiFanControlGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
-</pre>
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Description:</b>
+|-
+| style="width:293px;" |
+'''Condition'''
-	<dl>
+| style="width:313px;" |
-		<dd>Gets fan control capabilities.</dd>
+'''Return Value'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<dl>
+|-
-	<dd><b>Parameters:</b>
+| style="width:293px;" |
+Unknown Id
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+SUSI _STATUS_UNSUPPORTED
-		<dl>
+|-
-			<dd>Smart fan ID is same as Fan Speed Value ID. See <b>Table 4</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Wrong time range
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Success
-		<dd><b>ItemId</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target capability. See <b>Table 22</b>. This parameter can also input temperature ID (<b>Table 3</b>) to get is it supports in <i>SusiFanControl</i> function.</dd>
+SUSI_STATUS_SUCCESS
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<dl>
+:'''Table '''18 Watchdog Support Flags
-	<dd>
-	<dl>
-		<dd><b>pValue</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Pointer to a buffer that receives the target capability.</dd>
+|-
-		</dl>
+| style="width:297px;" |
-		</dd>
+'''Flag Name'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:246px;" |
+'''Description'''
-<p>&nbsp;</p>
+| style="width:59px;" |
+'''Value'''
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_WDT_FLAG_SUPPORT_IRQ
-<dl>
+| style="width:246px;" |
-	<dd><b>Return Status Code:</b></dd>
+Support IRQ event
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:59px;" |
-	<tbody>
+x01
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id or ItemId</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_WDT_FLAG_SUPPORT_SCI
-<dl>
+| style="width:246px;" |
-	<dd><b>Table </b>22 Fan control capabilities item Id</dd>
+Support SCI event
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:59px;" |
-	<tbody>
+x02
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Item Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_FC_CONTROL_SUPPORT_FLAGS</p>
-			</td>
-			<td style="width:302px;">
-			<p>Control support flags (See <b>Table 23</b>)</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_FC_AUTO_SUPPORT_FLAGS</p>
-			</td>
-			<td style="width:302px;">
-			<p>Auto support flags (See <b>Table 24</b>)</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_WDT_FLAG_SUPPORT_PWRBTN
-<dl>
+| style="width:246px;" |
-	<dd><b>Table </b>23 Control Support Flags</dd>
+Support power button event
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:59px;" |
-	<tbody>
+x04
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p><b>Flag Name</b></p>
-			</td>
-			<td style="width:276px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:59px;">
-			<p><b>Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_OFF_MODE</p>
-			</td>
-			<td style="width:276px;">
-			<p>Support off mode</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x01</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_FULL_MODE</p>
-			</td>
-			<td style="width:276px;">
-			<p>Support full mode</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x02</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_MANUAL_MODE</p>
-			</td>
-			<td style="width:276px;">
-			<p>Support manual mode</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x04</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_AUTO_MODE</p>
-			</td>
-			<td style="width:276px;">
-			<p>Support auto mode</p>
-			<p>More detail to get <i>Auto Support Flags</i></p>
+|}
-			</td>
-			<td style="width:59px;">
-			<p>0x08</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+:'''Table '''19 Watchdog timer event type
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Table </b>24 Auto Support Flags</dd>
+|-
-</dl>
+| style="width:297px;" |
+'''Event Type'''
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:302px;" |
-	<tbody>
+'''Description'''
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p><b>Flag Name</b></p>
-			</td>
-			<td style="width:276px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:59px;">
-			<p><b>Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_AUTO_LOW_STOP</p>
-			</td>
-			<td style="width:276px;">
-			<p>Auto mode support Low Stop</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x01</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_AUTO_LOW_LIMIT</p>
-			</td>
-			<td style="width:276px;">
-			<p>Auto mode support Low Limit</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x02</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_AUTO_HIGH_LIMIT</p>
-			</td>
-			<td style="width:276px;">
-			<p>Auto mode support High Limit</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x04</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_AUTO_PWM</p>
-			</td>
-			<td style="width:276px;">
-			<p>Auto mode support PWM operation</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x0100</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_FC_FLAG_SUPPORT_AUTO_RPM</p>
-			</td>
-			<td style="width:276px;">
-			<p>Auto mode support RPM operation</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x0200</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_WDT_EVENT_TYPE_NONE
-<h3><b>3.8.2 SusiFanControlGetConfig</b></h3>
+| style="width:302px;" |
+No event
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiFanControlGetConfig(uint32_t Id, SusiFanControl *pConfig)
+| style="width:297px;" |
-</pre>
+SUSI_WDT_EVENT_TYPE_SCI
-<dl>
+| style="width:302px;" |
-	<dd><b>Description:</b>
+SCI event
-	<dl>
+|-
-		<dd>Get information about smart fan function mode and configuration.</dd>
+| style="width:297px;" |
-	</dl>
+SUSI_WDT_EVENT_TYPE_IRQ
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:302px;" |
+IRQ event
-<p>&nbsp;</p>
+|-
+| style="width:297px;" |
+SUSI_WDT_EVENT_TYPE_PWRBTN
-<dl>
+| style="width:302px;" |
-	<dd><b>Parameters:</b>
+Power button event
-	<dl>
+|}
-		<dd><b>Id</b>
-		<dl>
-			<dd>Smart fan ID is same as Fan Speed Value ID. See <b>Table 4</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<dl>
+=== '''3.6.3 SusiWDogStop''' ===
-	<dd>
-	<dl>
-		<dd><b>pConfig</b>
-		<dl>
+ uint32_t SUSI_API SusiWDogStop(uint32_t Id)
-			<dd>Pointer to the smart fan function configuration.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Description:'''
+::Stops the operation of the watchdog timer.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 16'''.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+'''Return Value'''
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:293px;" |
-		<tr>
+Library uninitialized
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pConfig==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device not support smart mode</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<h3><b>3.8.3 SusiFanControlSetConfig</b></h3>
+|-
+| style="width:293px;" |
+Unknown Id
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiFanControlSetConfig(uint32_t Id, SusiFanControl *pConfig)
+SUSI _STATUS_UNSUPPORTED
-</pre>
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:293px;" |
+Success
-	<dl>
+| style="width:313px;" |
-		<dd>
+SUSI_STATUS_SUCCESS
-		<dl>
-			<dd>Set smart fan function mode and configuration.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<p>&nbsp;</p>
+=== '''3.6.4 SusiWDog'''Trigger ===
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiWDogTrigger(uint32_t Id)
-<dl>
+:'''Description:'''
-	<dd><b>Parameters:</b>
+::Trigger the watchdog timer.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 16'''.
-	<dl>
+:'''Return Status Code:'''
-		<dd><b>Id</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Smart fan ID is same as Fan Speed Value ID. See <b>Table 4</b>.</dd>
+|-
-		</dl>
+| style="width:293px;" |
-		</dd>
+'''Condition'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Library uninitialized
-		<dd><b>pConfig</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Pointer to the smart fan function configuration.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_SUCCESS
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|}
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pConfig==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Wrong configuration</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+=== '''3.6.5 SusiWDogSetCallBack''' ===
-<h2><b>3.9 Storage Functions</b></h2>
+ uint32_t SUSI_API SusiWDogSetCallBack(uint32_t Id, SUSI_WDT_INT_CALLBACK pfnCallback, void *Context)
-<p>Access storage information and read / write data to the selected user data area. Developers can use this area to store their own data.</p>
+:'''Description:'''
+::The call back function pointer can be transmit from Application when IRQ triggered.
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 16'''.
+::'''pfnCallback'''
+:::Call back function pointer, SUSI_WDT_INT_CALLBACK is function pointer type, it can set NULL to clear. The type definition just like show below,
+:::''typedef void (*SUSI_WDT_INT_CALLBACK)(void*);''
+::'''Context'''
+:::Pointer to a user context structure for callback function.
-<dl>
+:'''Return Status Code:'''
-	<dd><b>Table </b>25 Storage ID</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<tbody>
+|-
-		<tr>
+| style="width:293px;" |
-			<td>&lt;tbody&gt;</td>
+'''Condition'''
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:283px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_STORAGE_STD</p>
-			</td>
-			<td style="width:283px;">
-			<p>Standard storage device</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:316px;">
-			<p>SUSI_ID_STORAGE_OEM0~1</p>
-			</td>
-			<td style="width:283px;">
-			<p>Other storage devices</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<h3><b>3.9.1 SusiStorageGetCaps</b></h3>
+|-
+| style="width:293px;" |
+Library uninitialized
-<pre class="_fck_mw_lspace">
+| style="width:313px;" |
-uint32_t SUSI_API SusiStorageGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
+SUSI_STATUS_NOT_INITIALIZED
-</pre>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd><b>Description:</b>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
+|-
-		<dd>Reads the capabilities of the current storage implementation from the selected storage interface.</dd>
+| style="width:293px;" |
-	</dl>
+Success
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Parameters:</b>
-	<dl>
-		<dd><b>Id</b>
-		<dl>
+== '''3.7 GPIO Functions''' ==
-			<dd>Selects target device. See <b>Table 25</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+Programmable GPIO allows developers to dynamically set the GPIO input or output status
-<dl>
-	<dd>
-	<dl>
-		<dd><b>ItemId</b>
-		<dl>
-			<dd>Selects target capability. See <b>Table 26</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Table '''20 GPIO ID
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd>
+|-
-	<dl>
+| style="width:259px;" |
-		<dd><b>pValue</b>
+'''Id'''
-		<dl>
+| style="width:340px;" |
-			<dd>Pointer to a buffer that receives the target capability.</dd>
+'''Description'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:259px;" |
+SUSI_ID_GPIO(X)
-<p>&nbsp;</p>
+| style="width:340px;" |
+X is GPIO pin number, definition as below:
-<p>&nbsp;</p>
+#define SUSI_ID_GPIO(x) (0x0000 &#124; x)
-<dl>
+This ID control single pin only.
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:259px;" |
-		<tr>
+SUSI_ID_GPIO_BANK(Y)
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device not support</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:340px;" |
+Y is GPIO bank number, definition as below:
-<dl>
+#define SUSI_ID_GPIO_BANK(Y) (0x10000 &#124; Y)
-	<dd><b>Table </b>26 Storage capabilities item Id</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+This ID control maximum 32 pins per bank.
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Item Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_STORAGE_TOTAL_SIZE</p>
-			</td>
-			<td style="width:302px;">
-			<p>Get storage total size in bytes</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_STORAGE_BLOCK_SIZE</p>
-			</td>
-			<td style="width:302px;">
-			<p>Get storage block size in bytes</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_STORAGE_LOCK_STATUS</p>
-			</td>
-			<td style="width:302px;">
-			<p>Get storage lock status. See <b>Table 27</b>.</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_STORAGE_PSW_MAX_LEN</p>
-			</td>
-			<td style="width:302px;">
-			<p>Get maximum length in byte of storage lock key</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Table </b>27 Storage Lock Status</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Lock Status</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_STORAGE_STATUS_LOCK</p>
-			</td>
-			<td style="width:302px;">
-			<p>Storage is lock</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_STORAGE_STATUS_UNLOCK</p>
-			</td>
-			<td style="width:302px;">
-			<p>Storage is unlock</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+=== '''3.7.1 SusiGPIOGetCaps''' ===
-<h3><b>3.9.2 SusiStorageAreaRead</b></h3>
+ uint32_t SUSI_API SusiGPIOGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
-<pre class="_fck_mw_lspace">
-uint32_t SUSI_API SusiStorageAreaRead(uint32_t Id, uint32_t Offset, uint8_t *pBuffer, uint32_t BufLen)
-</pre>
-<dl>
-	<dd><b>Description:</b>
-	<dl>
+:'''Description:'''
-		<dd>Reads data from the selected user data area.</dd>
+::Reads the capabilities of the current GPIO implementation from the selected GPIO interface.
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 20'''.
+::'''ItemId'''
+:::Selects target capability. See '''Table 21'''.
+::'''pValue'''
+:::Pointer to a buffer that receives the target capability. Each bit of the buffer value represents support situation of a GPIO, according to the order. 1 is supportive, and 0 is unsupportive.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Parameters:</b>
+|-
+| style="width:293px;" |
+'''Condition'''
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+'''Return Value'''
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 25</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Library uninitialized
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+pValue==NULL
-		<dd><b>Offset</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Storage area start address offset in bytes.</dd>
+SUSI _STATUS_INVALID_PARAMETER
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_UNSUPPORTED
-	<dl>
-		<dd><b>pBuffer</b>
-		<dl>
+|-
-			<dd>Size in bytes of the buffer pointed to by the pBuffer parameter.</dd>
+| style="width:293px;" |
-		</dl>
+Success
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd>
-	<dl>
-		<dd><b>BufLen</b>
-		<dl>
-			<dd>Size in bytes of the information read to the buffer pointed to by the pBuffer parameter.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+:'''Table '''21 GPIO capabilities item Id
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Item Id'''
-<dl>
+| style="width:302px;" |
-	<dd><b>Return Status Code:</b></dd>
+'''Description'''
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|-
-	<tbody>
+| style="width:297px;" |
-		<tr>
+SUSI_ID_GPIO_INPUT_SUPPORT
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL || BufLen==0</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Offset+BufLen&gt;TotalSize</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_INVALID_BLOCK_LENGTH</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Read error</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_READ_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+| style="width:302px;" |
+Get GPIO input support state
-<h3><b>3.9.3 SusiStorageArea</b>Write</h3>
+|-
+| style="width:297px;" |
+SUSI_ID_GPIO_OUTPUT_SUPPORT
-<pre class="_fck_mw_lspace">
+| style="width:302px;" |
-uint32_t SUSI_API SusiStorageAreaWrite(uint32_t Id, uint32_t Offset, uint8_t *pBuffer, uint32_t BufLen)
+Get GPIO output support state
-</pre>
-<dl>
+|}
-	<dd><b>Description:</b>
-	<dl>
-		<dd>Writes data to the selected user data area.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+=== '''3.7.2 SusiGPIOGetDirection''' ===
-<dl>
+ uint32_t SUSI_API SusiGPIOGetDirection(uint32_t Id, uint32_t Bitmask, uint32_t *pDirection)
-	<dd><b>Parameters:</b>
-	<dl>
+:'''Description:'''
-		<dd><b>Id</b>
+::Gets the configuration for the selected GPIO ports.
-		<dl>
+:'''Parameters:'''
-			<dd>Selects target device. See <b>Table 25</b>.</dd>
+::'''Id'''
-		</dl>
+:::Selects target device. See '''Table 20'''.
-		</dd>
+::'''Bitmask'''
-	</dl>
+:::Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.
-	</dd>
+::'''pDirection'''
-</dl>
+:::Pointer to a buffer that receives the direction of the selected GPIO ports.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd>
+|-
-	<dl>
+| style="width:293px;" |
-		<dd><b>Offset</b>
+'''Condition'''
-		<dl>
+| style="width:313px;" |
-			<dd>Storage area start address offset in bytes.</dd>
+'''Return Value'''
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Library uninitialized
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_NOT_INITIALIZED
-	<dl>
-		<dd><b>pBuffer</b>
-		<dl>
+|-
-			<dd>Size in bytes of the buffer pointed to by the pBuffer parameter.</dd>
+| style="width:293px;" |
-		</dl>
+pDirection==NULL
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Bitmask==0 when bank mode
-		<dd><b>BufLen</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Size in bytes of the information read to the buffer pointed to by the pBuffer parameter.</dd>
+SUSI _STATUS_INVALID_PARAMETER
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_SUCCESS
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|}
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL || BufLen==0</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Offset+BufLen&gt;TotalSize</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_INVALID_BLOCK_LENGTH</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Write error</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
-<h3><b>3.9.4 SusiStorageArea</b>SetLock</h3>
-<pre class="_fck_mw_lspace">
+=== '''3.7.3 SusiGPIOSetDirection''' ===
-uint32_t SUSI_API SusiStorageAreaSetLock(uint32_t Id, uint8_t *pBuffer, uint32_t BufLen)
-</pre>
-<dl>
+ uint32_t SUSI_API SusiGPIOSetDirection(uint32_t Id, uint32_t Bitmask, uint32_t Direction)
-	<dd><b>Description:</b>
-	<dl>
-		<dd>Lock a storage area for write protect.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+:'''Description:'''
+:::Sets the configuration for the selected GPIO ports.
-<dl>
+:'''Parameters:'''
-	<dd><b>Parameters:</b>
+::'''Id'''
+:::Selects target device. See '''Table 20'''.
+::'''Bitmask'''
+:::Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.
+::'''Direction'''
+:::Sets the direction of the selected GPIO ports.
-	<dl>
+:'''Return Status Code:'''
-		<dd><b>Id</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Selects target device. See <b>Table 25</b>.</dd>
+|-
-		</dl>
+| style="width:293px;" |
-		</dd>
+'''Condition'''
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+'''Return Value'''
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Library uninitialized
-		<dd><b>pBuffer</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Lock of key buffer.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bitmask==0 when bank mode
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_INVALID_PARAMETER
-	<dl>
-		<dd><b>BufLen</b>
-		<dl>
+|-
-			<dd>Number of key buffer</dd>
+| style="width:293px;" |
-		</dl>
+Unknown Id
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<dl>
+|}
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL || BufLen==0</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Lock error</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device not support</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
-<h3><b>3.9.5 SusiStorageArea</b>SetUnlock</h3>
+=== '''3.7.4 SusiGPIOGetLevel''' ===
-<pre class="_fck_mw_lspace">
+ uint32_t SUSI_API SusiGPIOGetLevel(uint32_t Id, uint32_t Bitmask, uint32_t *pLevel)
-uint32_t SUSI_API SusiStorageAreaSetUnlock(uint32_t Id, uint8_t *pBuffer, uint32_t BufLen)
-</pre>
-<dl>
+:'''Description:'''
-	<dd><b>Description:</b>
+::Read level the from GPIO ports.
-	<dl>
+:'''Parameters:'''
-		<dd>Unlock a storage area for write protect.</dd>
+::'''Id'''
-	</dl>
+:::Selects target device. See '''Table 20'''.
-	</dd>
+::'''Bitmask'''
-</dl>
+:::Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.
+::'''pLevel'''
+:::Pointer to a buffer that receives the GPIO level.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<p>&nbsp;</p>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
-<dl>
+| style="width:313px;" |
-	<dd><b>Parameters:</b>
+'''Return Value'''
-	<dl>
+|-
-		<dd><b>Id</b>
+| style="width:293px;" |
+Library uninitialized
-		<dl>
+| style="width:313px;" |
-			<dd>Selects target device. See <b>Table 25</b>.</dd>
+SUSI_STATUS_NOT_INITIALIZED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pLevel==NULL
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI _STATUS_INVALID_PARAMETER
-	<dl>
-		<dd><b>pBuffer</b>
-		<dl>
+|-
-			<dd>Unlock of key buffer.</dd>
+| style="width:293px;" |
-		</dl>
+Bitmask==0 when bank mode
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+Unknown Id
-		<dd><b>BufLen</b>
-		<dl>
+| style="width:313px;" |
-			<dd>Number of key buffer</dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
-<p>&nbsp;</p>
+|}
-<dl>
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pBuffer==NULL || BufLen==0</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unlock error</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_WRITE_ERROR</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Device not support</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+=== '''3.7.5 SusiGPIOSetLevel''' ===
-<h2><b>3.10Thermal Protection Functions</b></h2>
+ uint32_t SUSI_API SusiGPIOSetLevel(uint32_t Id, uint32_t Bitmask, uint32_t Level)
-<p>The Thermal Protection function call is used to set hardware base thermal monitoring and notify. It takes a pointer to an instance of structure <i>SusiThermalProtect</i>, which is defined as follows:</p>
+:'''Description:'''
+::Write level to GPIO ports. Depending on the hardware implementation writing multiple GPIO ports with the bit mask option does not guarantee a time synchronous change of the output levels.
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Parameters:'''
-	<tbody>
+::'''Id'''
-		<tr>
+:::Selects target device. See '''Table 20'''.
-			<td>&lt;tbody&gt;</td>
+::'''Bitmask'''
-		</tr>
+:::Value for a bit mask. Only selected bits are changed, unselected bits remain unchanged. This parameter will be ignored when single pin mode.
-		<tr>
+::'''Level'''
-			<td style="width:592px;">
+:::Input level of the selected GPIO port.
-			<pre>
-typedef struct _SusiThermalProtect{
- uint32_t SourceId;
+:'''Return Status Code:'''
- uint32_t EventType;
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
- uint32_t SendEventTemperature;
+| style="width:313px;" |
+'''Return Value'''
- uint32_t ClearEventTemperature;
+|-
+| style="width:293px;" |
+Library uninitialized
-} SusiThermalProtect, *PSusiThermalProtect;
+| style="width:313px;" |
-</pre>
+SUSI_STATUS_NOT_INITIALIZED
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Bitmask==0 when bank mode
-<dl>
+| style="width:313px;" |
-	<dd><b>Where:</b>
+SUSI _STATUS_INVALID_PARAMETER
-	<dl>
+|-
-		<dd><b>SourceId</b>
+| style="width:293px;" |
+Unknown Id
-		<dl>
+| style="width:313px;" |
-			<dd>Setting thermal source ID here. See <b>Table 3</b>.</dd>
+SUSI _STATUS_UNSUPPORTED
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd>
+SUSI_STATUS_SUCCESS
-	<dl>
-		<dd><b>EventType</b>
-		<dl>
+|}
-			<dd>This byte can set up a thermal protect event, see <b>Table 28</b>. NOT every platform supports all event type.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+== '''3.8 Smart Fan Functions''' ==
-<dl>
+The Smart Fan function call is used to set fan speed configuration. You can use this function to easily control the fan speed. It takes a pointer to an instance of structure ''SusiFanControl'', which is defined as follows:
-	<dd>
-	<dl>
-		<dd><b>SendEevntTemperature</b>
-		<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-			<dd>Unit is 0.1 Kelvins. When thermal source goes over this value, SUSI will send event according Event Type.</dd>
+|-
-		</dl>
+| style="width:598px;height:582px;" | <pre>#define SUSI_FAN_AUTO_CTRL_OPMODE_PWM 0
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+#define SUSI_FAN_AUTO_CTRL_OPMODE_RPM 1
-<dl>
+typedef struct _AutoFan {
-	<dd>
-	<dl>
-		<dd><b>ClearEventTemperature</b>
-		<dl>
+ uint32_t TmlSource; // Thermal source
-			<dd>Unit is 0.1 Kelvins. When thermal source goes below this value and Event is sent, SUSI will clear event according Event Type</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t OpMode;
-<p>&nbsp;</p>
+ uint32_t LowStopLimit; // Temperature (0.1 Kelvins)
-<p>&nbsp;</p>
+ uint32_t LowLimit; // Temperature (0.1 Kelvins)
-<dl>
+ uint32_t HighLimit; // Temperature (0.1 Kelvins)
-	<dd><b>Table </b>28 Thermal Protection Event Type</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+ uint32_t MinPWM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_PWM
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p><b>Event Type Name</b></p>
-			</td>
-			<td style="width:276px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:59px;">
-			<p><b>Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_THERMAL_EVENT_SHUTDOWN</p>
-			</td>
-			<td style="width:276px;">
-			<p>Shutdown event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x00</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_THERMAL_EVENT_THROTTLE</p>
-			</td>
-			<td style="width:276px;">
-			<p>Throttle event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x01</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_THERMAL_EVENT_POWEROFF</p>
-			</td>
-			<td style="width:276px;">
-			<p>Power off event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x02</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_THERMAL_EVENT_NONE</p>
-			</td>
-			<td style="width:276px;">
-			<p>No event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0xFF</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+ uint32_t MaxPWM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_PWM
-<dl>
+ uint32_t MinRPM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_RPM
-	<dd><b>Table </b>29 Thermal Protection ID</dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+ uint32_t MaxRPM; // Enable when OpMode == FAN_AUTO_CTRL_OPMODE_RPM
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:268px;">
-			<p><b>Id</b></p>
-			</td>
-			<td style="width:331px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:268px;">
-			<p>SUSI_ID_THERMAL_PROTECT_1</p>
-			</td>
-			<td style="width:331px;">
-			<p>Thermal protection zone 1</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:268px;">
-			<p>SUSI_ID_THERMAL_PROTECT_2</p>
-			</td>
-			<td style="width:331px;">
-			<p>Thermal protection zone 2</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:268px;">
-			<p>SUSI_ID_THERMAL_PROTECT_3</p>
-			</td>
-			<td style="width:331px;">
-			<p>Thermal protection zone 3</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:268px;">
-			<p>SUSI_ID_THERMAL_PROTECT_4</p>
-			</td>
-			<td style="width:331px;">
-			<p>Thermal protection zone 4</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+} AutoFan , *PAutoFan&nbsp;;
-<h3><b>3.10.1 SusiThermalProtectionGetCaps</b></h3>
-<pre class="_fck_mw_lspace">
-uint32_t SUSI_API SusiThermalProtectionGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
-</pre>
-<dl>
+// Mode
-	<dd><b>Description:</b>
-	<dl>
+#define SUSI_FAN_CTRL_MODE_OFF 0
-		<dd>Gets Thermal Protection capabilities.</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+#define SUSI_FAN_CTRL_MODE_FULL 1
-<p>&nbsp;</p>
+#define SUSI_FAN_CTRL_MODE_MANUAL 2
-<dl>
+#define SUSI_FAN_CTRL_MODE_AUTO 3
-	<dd><b>Parameters:</b>
-	<dl>
+typedef struct _SusiFanControl {
-		<dd><b>Id</b>
-		<dl>
+ uint32_t Mode;
-			<dd>Selects target device. See <b>Table 29</b>.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+ uint32_t PWM; // Manual mode only (0 - 100%)
-<dl>
+ AutoFan AutoControl; // Auto mode only
-	<dd>
-	<dl>
-		<dd><b>ItemId</b>
-		<dl>
+} SusiFanControl, *PSusiFanControl;
-			<dd>Selects target capability. See <b>Table 30</b>. This parameter can also input temperature ID (<b>Table 3</b>) to get is it supports in <i>SusiThermalProtection</i> function.</dd>
+</pre>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|}
-<dl>
+If Mode member of SusiFanControl is not Auto, AutoControl member will be ignored. In auto mode, parameter “TmlSource” is use ''SUSI_ID_HWM_TEMP_XXX'' ('''Table 3''') to select which thermal type to reference. If TmlSource is not match any temperature ID means unknown or unsupported.
-	<dd>
-	<dl>
-		<dd><b>pValue</b>
-		<dl>
-			<dd>Pointer to a buffer that receives the target capability.</dd>
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
-<p>&nbsp;</p>
+=== '''3.8.1 SusiFanControlGetCaps''' ===
-<p>&nbsp;</p>
+ uint32_t SUSI_API SusiFanControlGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
-<dl>
+:'''Description:'''
-	<dd><b>Return Status Code:</b></dd>
+::Gets fan control capabilities.
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+:'''Parameters:'''
-	<tbody>
+::'''Id'''
-		<tr>
+:::Smart fan ID is same as Fan Speed Value ID. See '''Table 4'''.
-			<td>&lt;tbody&gt;</td>
+::'''ItemId'''
-		</tr>
+:::Selects target capability. See '''Table 22'''. This parameter can also input temperature ID ('''Table 3''') to get is it supports in ''SusiFanControl'' function.
-		<tr>
+::'''pValue'''
-			<td style="width:293px;">
+:::Pointer to a buffer that receives the target capability.
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pValue==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id or ItemId</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Table </b>30 Thermal Protection capabilities item Id</dd>
+|-
-</dl>
+| style="width:293px;" |
+'''Condition'''
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+'''Return Value'''
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p><b>Item Id</b></p>
-			</td>
-			<td style="width:302px;">
-			<p><b>Description</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_TP_EVENT_SUPPORT_FLAGS</p>
-			</td>
-			<td style="width:302px;">
-			<p>Event support flags (See <b>Table 31</b>)</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_TP_EVENT_TRIGGER_MAXIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The maximum temperature to trigger event</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_TP_EVENT_TRIGGER_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The minimum temperature to trigger event</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_TP_EVENT_CLEAR_MAXIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The maximum temperature to clear event</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:297px;">
-			<p>SUSI_ID_TP_EVENT_CLEAR_MINIMUM</p>
-			</td>
-			<td style="width:302px;">
-			<p>The minimum temperature to clear event</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<dl>
+|-
-	<dd><b>Table </b>31 Thermal Protection Support Flags</dd>
+| style="width:293px;" |
-</dl>
+Library uninitialized
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+| style="width:313px;" |
-	<tbody>
+SUSI_STATUS_NOT_INITIALIZED
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p><b>Flag Name</b></p>
-			</td>
-			<td style="width:276px;">
-			<p><b>Description</b></p>
-			</td>
-			<td style="width:59px;">
-			<p><b>Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_THERMAL_FLAG_SUPPORT_SHUTDOWN</p>
-			</td>
-			<td style="width:276px;">
-			<p>Support shutdown event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x01</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_THERMAL_FLAG_SUPPORT_THROTTLE</p>
-			</td>
-			<td style="width:276px;">
-			<p>Support throttle event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x02</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:267px;">
-			<p>SUSI_THERMAL_FLAG_SUPPORT_POWEROFF</p>
-			</td>
-			<td style="width:276px;">
-			<p>Support power off event</p>
-			</td>
-			<td style="width:59px;">
-			<p>0x04</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+pValue==NULL
-<h3><b>3.10.2 SusiThermalProtectionSetConfig</b></h3>
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
-<pre class="_fck_mw_lspace">
+|-
-uint32_t SUSI_API SusiThermalProtectionSetConfig(uint32_t Id, SusiThermalProtect *pConfig)
+| style="width:293px;" |
-</pre>
+Unknown Id or ItemId
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+:'''Table '''22 Fan control capabilities item Id
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Item Id'''
+| style="width:302px;" |
+'''Description'''
+|-
+| style="width:297px;" |
+SUSI_ID_FC_CONTROL_SUPPORT_FLAGS
+| style="width:302px;" |
+Control support flags (See '''Table 23''')
+|-
+| style="width:297px;" |
+SUSI_ID_FC_AUTO_SUPPORT_FLAGS
+| style="width:302px;" |
+Auto support flags (See '''Table 24''')
+|}
+:'''Table '''23 Control Support Flags
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:267px;" |
+'''Flag Name'''
+| style="width:276px;" |
+'''Description'''
+| style="width:59px;" |
+'''Value'''
-<dl>
+|-
-	<dd><b>Description:</b>
+| style="width:267px;" |
+SUSI_FC_FLAG_SUPPORT_OFF_MODE
-	<dl>
+| style="width:276px;" |
-		<dd>Set Thermal Protection configuration.</dd>
+Support off mode
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:59px;" |
+x01
-<p>&nbsp;</p>
+|-
+| style="width:267px;" |
+SUSI_FC_FLAG_SUPPORT_FULL_MODE
-<dl>
+| style="width:276px;" |
-	<dd><b>Parameters:</b>
+Support full mode
-	<dl>
+| style="width:59px;" |
-		<dd><b>Id</b>
+x02
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 29</b>.</dd>
+| style="width:267px;" |
-		</dl>
+SUSI_FC_FLAG_SUPPORT_MANUAL_MODE
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:276px;" |
+Support manual mode
-<dl>
+| style="width:59px;" |
-	<dd>
+x04
-	<dl>
-		<dd><b>pConfig</b>
-		<dl>
+|-
-			<dd>A data package for thermal protection.</dd>
+| style="width:267px;" |
-		</dl>
+SUSI_FC_FLAG_SUPPORT_AUTO_MODE
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:276px;" |
+Support auto mode
-<p>&nbsp;</p>
+More detail to get ''Auto Support Flags''
-<p>&nbsp;</p>
+| style="width:59px;" |
+x08
-<dl>
+|}
-	<dd><b>Return Status Code:</b></dd>
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pConfig==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Config invalid</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Source Id or event type not support</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
-<h3><b>3.10.3 SusiThermalProtection</b>GetConfig</h3>
+:'''Table '''24 Auto Support Flags
-<pre class="_fck_mw_lspace">
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-uint32_t SUSI_API SusiThermalProtectionGetConfig(uint32_t Id, SusiThermalProtect *pConfig)
+|-
+| style="width:267px;" |
+'''Flag Name'''
+| style="width:276px;" |
+'''Description'''
+| style="width:59px;" |
+'''Value'''
+|-
+| style="width:267px;" |
+SUSI_FC_FLAG_SUPPORT_AUTO_LOW_STOP
+| style="width:276px;" |
+Auto mode support Low Stop
+| style="width:59px;" |
+x01
+|-
+| style="width:267px;" |
+SUSI_FC_FLAG_SUPPORT_AUTO_LOW_LIMIT
+| style="width:276px;" |
+Auto mode support Low Limit
+| style="width:59px;" |
+x02
+|-
+| style="width:267px;" |
+SUSI_FC_FLAG_SUPPORT_AUTO_HIGH_LIMIT
+| style="width:276px;" |
+Auto mode support High Limit
+| style="width:59px;" |
+x04
+|-
+| style="width:267px;" |
+SUSI_FC_FLAG_SUPPORT_AUTO_PWM
+| style="width:276px;" |
+Auto mode support PWM operation
+| style="width:59px;" |
+x0100
+|-
+| style="width:267px;" |
+SUSI_FC_FLAG_SUPPORT_AUTO_RPM
+| style="width:276px;" |
+Auto mode support RPM operation
+| style="width:59px;" |
+x0200
+|}
+=== '''3.8.2 SusiFanControlGetConfig''' ===
+ uint32_t SUSI_API SusiFanControlGetConfig(uint32_t Id, SusiFanControl *pConfig)
+:'''Description:'''
+::Get information about smart fan function mode and configuration.
+:'''Parameters:'''
+::'''Id'''
+:::Smart fan ID is same as Fan Speed Value ID. See '''Table 4'''.
+::'''pConfig'''
+:::Pointer to the smart fan function configuration.
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pConfig==NULL
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Device not support smart mode
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+=== '''3.8.3 SusiFanControlSetConfig''' ===
+ uint32_t SUSI_API SusiFanControlSetConfig(uint32_t Id, SusiFanControl *pConfig)
+:'''Description:'''
+:::Set smart fan function mode and configuration.
+:'''Parameters:'''
+::'''Id'''
+:::Smart fan ID is same as Fan Speed Value ID. See '''Table 4'''.
+::'''pConfig'''
+:::Pointer to the smart fan function configuration.
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pConfig==NULL
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Wrong configuration
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+== '''3.9 Storage Functions''' ==
+Access storage information and read / write data to the selected user data area. Developers can use this area to store their own data.
+:'''Table '''25 Storage ID
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:316px;" |
+'''Id'''
+| style="width:283px;" |
+'''Description'''
+|-
+| style="width:316px;" |
+SUSI_ID_STORAGE_STD
+| style="width:283px;" |
+Standard storage device
+|-
+| style="width:316px;" |
+SUSI_ID_STORAGE_OEM0~1
+| style="width:283px;" |
+Other storage devices
+|}
+=== '''3.9.1 SusiStorageGetCaps''' ===
+ uint32_t SUSI_API SusiStorageGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
+:'''Description:'''
+::Reads the capabilities of the current storage implementation from the selected storage interface.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 25'''.
+::'''ItemId'''
+:::Selects target capability. See '''Table 26'''.
+::'''pValue'''
+:::Pointer to a buffer that receives the target capability.
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pValue==NULL
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Device not support
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+:'''Table '''26 Storage capabilities item Id
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Item Id'''
+| style="width:302px;" |
+'''Description'''
+|-
+| style="width:297px;" |
+SUSI_ID_STORAGE_TOTAL_SIZE
+| style="width:302px;" |
+Get storage total size in bytes
+|-
+| style="width:297px;" |
+SUSI_ID_STORAGE_BLOCK_SIZE
+| style="width:302px;" |
+Get storage block size in bytes
+|-
+| style="width:297px;" |
+SUSI_ID_STORAGE_LOCK_STATUS
+| style="width:302px;" |
+Get storage lock status. See '''Table 27'''.
+|-
+| style="width:297px;" |
+SUSI_ID_STORAGE_PSW_MAX_LEN
+| style="width:302px;" |
+Get maximum length in byte of storage lock key
+|}
+:'''Table '''27 Storage Lock Status
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Lock Status'''
+| style="width:302px;" |
+'''Description'''
+|-
+| style="width:297px;" |
+SUSI_STORAGE_STATUS_LOCK
+| style="width:302px;" |
+Storage is lock
+|-
+| style="width:297px;" |
+SUSI_STORAGE_STATUS_UNLOCK
+| style="width:302px;" |
+Storage is unlock
+|}
+=== '''3.9.2 SusiStorageAreaRead''' ===
+ uint32_t SUSI_API SusiStorageAreaRead(uint32_t Id, uint32_t Offset, uint8_t *pBuffer, uint32_t BufLen)
+:'''Description:'''
+::Reads data from the selected user data area.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 25'''.
+::'''Offset'''
+:::Storage area start address offset in bytes.
+::'''pBuffer'''
+:::Size in bytes of the buffer pointed to by the pBuffer parameter.
+::'''BufLen'''
+:::Size in bytes of the information read to the buffer pointed to by the pBuffer parameter.
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pBuffer==NULL &#124;&#124; BufLen==0
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Offset+BufLen>TotalSize
+| style="width:313px;" |
+SUSI_STATUS_INVALID_BLOCK_LENGTH
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Read error
+| style="width:313px;" |
+SUSI_STATUS_READ_ERROR
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+=== '''3.9.3 SusiStorageArea'''Write ===
+ uint32_t SUSI_API SusiStorageAreaWrite(uint32_t Id, uint32_t Offset, uint8_t *pBuffer, uint32_t BufLen)
+:'''Description:'''
+::Writes data to the selected user data area.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 25'''.
+::'''Offset'''
+:::Storage area start address offset in bytes.
+::'''pBuffer'''
+:::Size in bytes of the buffer pointed to by the pBuffer parameter.
+::'''BufLen'''
+:::Size in bytes of the information read to the buffer pointed to by the pBuffer parameter.
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pBuffer==NULL &#124;&#124; BufLen==0
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Offset+BufLen>TotalSize
+| style="width:313px;" |
+SUSI_STATUS_INVALID_BLOCK_LENGTH
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Write error
+| style="width:313px;" |
+SUSI_STATUS_WRITE_ERROR
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+=== '''3.9.4 SusiStorageArea'''SetLock ===
+ uint32_t SUSI_API SusiStorageAreaSetLock(uint32_t Id, uint8_t *pBuffer, uint32_t BufLen)
+:'''Description:'''
+::Lock a storage area for write protect.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 25'''.
+::'''pBuffer'''
+:::Lock of key buffer.
+::'''BufLen'''
+:::Number of key buffer
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pBuffer==NULL &#124;&#124; BufLen==0
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Lock error
+| style="width:313px;" |
+SUSI_STATUS_WRITE_ERROR
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Device not support
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+=== '''3.9.5 SusiStorageArea'''SetUnlock ===
+ uint32_t SUSI_API SusiStorageAreaSetUnlock(uint32_t Id, uint8_t *pBuffer, uint32_t BufLen)
+:'''Description:'''
+::Unlock a storage area for write protect.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 25'''.
+::'''pBuffer'''
+:::Unlock of key buffer.
+::'''BufLen'''
+:::Number of key buffer
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pBuffer==NULL &#124;&#124; BufLen==0
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Unlock error
+| style="width:313px;" |
+SUSI_STATUS_WRITE_ERROR
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Device not support
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+== '''3.10Thermal Protection Functions''' ==
+The Thermal Protection function call is used to set hardware base thermal monitoring and notify. It takes a pointer to an instance of structure ''SusiThermalProtect'', which is defined as follows:
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:592px;" | <pre>typedef struct _SusiThermalProtect{
+ uint32_t SourceId;
+ uint32_t EventType;
+ uint32_t SendEventTemperature;
+ uint32_t ClearEventTemperature;
+} SusiThermalProtect, *PSusiThermalProtect;
 </pre>
-<dl>
+|}
-	<dd><b>Description:</b>
+:'''Where:'''
+::'''SourceId'''
+:::Setting thermal source ID here. See '''Table 3'''.
+::'''EventType'''
+:::This byte can set up a thermal protect event, see '''Table 28'''. NOT every platform supports all event type.
+::'''SendEevntTemperature'''
+:::Unit is 0.1 Kelvins. When thermal source goes over this value, SUSI will send event according Event Type.
+::'''ClearEventTemperature'''
+:::Unit is 0.1 Kelvins. When thermal source goes below this value and Event is sent, SUSI will clear event according Event Type
+:'''Table '''28 Thermal Protection Event Type
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:267px;" |
+'''Event Type Name'''
+| style="width:276px;" |
+'''Description'''
+| style="width:59px;" |
+'''Value'''
+|-
+| style="width:267px;" |
+SUSI_THERMAL_EVENT_SHUTDOWN
+| style="width:276px;" |
+Shutdown event
+| style="width:59px;" |
+x00
+|-
+| style="width:267px;" |
+SUSI_THERMAL_EVENT_THROTTLE
+| style="width:276px;" |
+Throttle event
+| style="width:59px;" |
+x01
+|-
+| style="width:267px;" |
+SUSI_THERMAL_EVENT_POWEROFF
+| style="width:276px;" |
+Power off event
+| style="width:59px;" |
+x02
+|-
+| style="width:267px;" |
+SUSI_THERMAL_EVENT_NONE
+| style="width:276px;" |
+No event
+| style="width:59px;" |
+xFF
+|}
+:'''Table '''29 Thermal Protection ID
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:268px;" |
+'''Id'''
+| style="width:331px;" |
+'''Description'''
+|-
+| style="width:268px;" |
+SUSI_ID_THERMAL_PROTECT_1
+| style="width:331px;" |
+Thermal protection zone 1
+|-
+| style="width:268px;" |
+SUSI_ID_THERMAL_PROTECT_2
+| style="width:331px;" |
+Thermal protection zone 2
+|-
+| style="width:268px;" |
+SUSI_ID_THERMAL_PROTECT_3
+| style="width:331px;" |
+Thermal protection zone 3
+|-
+| style="width:268px;" |
+SUSI_ID_THERMAL_PROTECT_4
+| style="width:331px;" |
+Thermal protection zone 4
+|}
+=== '''3.10.1 SusiThermalProtectionGetCaps''' ===
+ uint32_t SUSI_API SusiThermalProtectionGetCaps(uint32_t Id, uint32_t ItemId, uint32_t *pValue)
+:'''Description:'''
+::Gets Thermal Protection capabilities.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 29'''.
+::'''ItemId'''
+:::Selects target capability. See '''Table 30'''. This parameter can also input temperature ID ('''Table 3''') to get is it supports in ''SusiThermalProtection'' function.
+::'''pValue'''
+:::Pointer to a buffer that receives the target capability.
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pValue==NULL
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Unknown Id or ItemId
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+:'''Table '''30 Thermal Protection capabilities item Id
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:297px;" |
+'''Item Id'''
+| style="width:302px;" |
+'''Description'''
+|-
+| style="width:297px;" |
+SUSI_ID_TP_EVENT_SUPPORT_FLAGS
+| style="width:302px;" |
+Event support flags (See '''Table 31''')
+|-
+| style="width:297px;" |
+SUSI_ID_TP_EVENT_TRIGGER_MAXIMUM
+| style="width:302px;" |
+The maximum temperature to trigger event
+|-
+| style="width:297px;" |
+SUSI_ID_TP_EVENT_TRIGGER_MINIMUM
+| style="width:302px;" |
+The minimum temperature to trigger event
+|-
+| style="width:297px;" |
+SUSI_ID_TP_EVENT_CLEAR_MAXIMUM
+| style="width:302px;" |
+The maximum temperature to clear event
+|-
+| style="width:297px;" |
+SUSI_ID_TP_EVENT_CLEAR_MINIMUM
+| style="width:302px;" |
+The minimum temperature to clear event
+|}
+:'''Table '''31 Thermal Protection Support Flags
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:267px;" |
+'''Flag Name'''
+| style="width:276px;" |
+'''Description'''
+| style="width:59px;" |
+'''Value'''
+|-
+| style="width:267px;" |
+SUSI_THERMAL_FLAG_SUPPORT_SHUTDOWN
+| style="width:276px;" |
+Support shutdown event
+| style="width:59px;" |
+x01
+|-
+| style="width:267px;" |
+SUSI_THERMAL_FLAG_SUPPORT_THROTTLE
+| style="width:276px;" |
+Support throttle event
+| style="width:59px;" |
+x02
+|-
+| style="width:267px;" |
+SUSI_THERMAL_FLAG_SUPPORT_POWEROFF
+| style="width:276px;" |
+Support power off event
+| style="width:59px;" |
+x04
+|}
+=== '''3.10.2 SusiThermalProtectionSetConfig''' ===
+ uint32_t SUSI_API SusiThermalProtectionSetConfig(uint32_t Id, SusiThermalProtect *pConfig)
+:'''Description:'''
+::Set Thermal Protection configuration.
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 29'''.
+::'''pConfig'''
+:::A data package for thermal protection.
+:'''Return Status Code:'''
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
+|-
+| style="width:293px;" |
+'''Condition'''
+| style="width:313px;" |
+'''Return Value'''
+|-
+| style="width:293px;" |
+Library uninitialized
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
+|-
+| style="width:293px;" |
+pConfig==NULL
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Config invalid
+| style="width:313px;" |
+SUSI _STATUS_INVALID_PARAMETER
+|-
+| style="width:293px;" |
+Source Id or event type not support
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Unknown Id
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
+|-
+| style="width:293px;" |
+Success
+| style="width:313px;" |
+SUSI_STATUS_SUCCESS
+|}
+=== '''3.10.3 SusiThermalProtection'''GetConfig ===
+ uint32_t SUSI_API SusiThermalProtectionGetConfig(uint32_t Id, SusiThermalProtect *pConfig)
-	<dl>
+:'''Description:'''
-		<dd>Get Thermal Protection configuration.</dd>
+::Get Thermal Protection configuration.
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+:'''Parameters:'''
+::'''Id'''
+:::Selects target device. See '''Table 29'''.
+::'''pConfig'''
+:::A data package for thermal protection.
-<p>&nbsp;</p>
+:'''Return Status Code:'''
-<dl>
+{| border="1" cellspacing="0" cellpadding="0" style="margin:1em auto 1em auto;"
-	<dd><b>Parameters:</b>
+|-
+| style="width:293px;" |
+'''Condition'''
-	<dl>
+| style="width:313px;" |
-		<dd><b>Id</b>
+'''Return Value'''
-		<dl>
+|-
-			<dd>Selects target device. See <b>Table 29</b>.</dd>
+| style="width:293px;" |
-		</dl>
+Library uninitialized
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI_STATUS_NOT_INITIALIZED
-<dl>
+|-
-	<dd>
+| style="width:293px;" |
-	<dl>
+pConfig==NULL
-		<dd><b>pConfig</b>
-		<dl>
+| style="width:313px;" |
-			<dd>A data package for thermal protection.</dd>
+SUSI _STATUS_INVALID_PARAMETER
-		</dl>
-		</dd>
-	</dl>
-	</dd>
-</dl>
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Unknown Id
-<p>&nbsp;</p>
+| style="width:313px;" |
+SUSI _STATUS_UNSUPPORTED
-<p>&nbsp;</p>
+|-
+| style="width:293px;" |
+Success
-<dl>
+| style="width:313px;" |
-	<dd><b>Return Status Code:</b></dd>
+SUSI_STATUS_SUCCESS
-</dl>
-<table border="1" cellpadding="0" cellspacing="0" style="margin:1em auto 1em auto;">
+|}
-	<tbody>
-		<tr>
-			<td>&lt;tbody&gt;</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p><b>Condition</b></p>
-			</td>
-			<td style="width:313px;">
-			<p><b>Return Value</b></p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Library uninitialized</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_NOT_INITIALIZED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>pConfig==NULL</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_INVALID_PARAMETER</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Unknown Id</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI _STATUS_UNSUPPORTED</p>
-			</td>
-		</tr>
-		<tr>
-			<td style="width:293px;">
-			<p>Success</p>
-			</td>
-			<td style="width:313px;">
-			<p>SUSI_STATUS_SUCCESS</p>
-			</td>
-		</tr>
-		<tr>
-			<td>&lt;/tbody&gt;</td>
-		</tr>
-	</tbody>
-</table>
-<p>&nbsp;</p>
+<headertabs></headertabs>

Difference between revisions of "SW Service/API/SUSI4.0 USER MANUAL"

Revision as of 09:26, 9 June 2022

1.1 Functions

1.1.1 GPIO

1.1.2 SMBus [x86 only and RISC is unavailable]

1.1.3 I2C

1.1.4 Watchdog

1.1.5 Hardware Monitor [x86 only and RISC is limited in some features]

1.1.6 Backlight Control

1.1.7 Storage [x86 only and RISC is unavailable]

1.1.8 Thermal Protection [x86 only and RISC is unavailable]

1.2 Benefits

1.3 Environment Requirements

1.3.1Operating Systems

2.1 Status Codes

2.2 ID

2.3 Item ID

3.1 Initialization Functions

3.1.1 SusiLibInitialize

3.1.2 SusiLibUninitialize

3.2 Information Functions

3.2.1 SusiBoardGetValue

3.2.2 SusiBoardGetStringA

3.3 Backlight Functions

3.3.1 SusiVgaGetCaps

3.3.2 SusiVgaGetBacklightEnable

3.3.3 SusiVgaSetBacklightEnable

3.3.4 SusiVgaGetBacklightBrightness

3.3.5 SusiVgaSetBacklightBrightness

3.3.6 SusiVgaGetBacklightLevel

3.3.7 SusiVgaSetBacklightLevel

3.3.8 SusiVgaGetPolarity

3.3.9 SusiVgaSetPolarity

3.3.10 SusiVgaGetFrequency

3.3.11SusiVgaSetFrequency

3.4 I2C Functions

3.4.1 SusiI2CGetCaps

3.4.2 SusiI2CWriteReadCombine

3.4.3 SusiI2CReadTransfer

3.4.4 SusiI2CWriteTransfer

3.4.5 SusiI2CProbeDevice

3.4.6 SusiI2CGetFrequency

3.4.7 SusiI2CSetFrequency

3.5 SMBus Functions

3.5.1 SusiSMBReadByte

3.5.2 SusiSMBWriteByte

3.5.3 SusiSMBReadWord

3.5.4 SusiSMBWriteWord

3.5.5 SusiSMBReceiveByte

3.5.6 SusiSMBSendByte

3.5.7 SusiSMBReadQuick

3.5.8 SusiSMBWriteQuick

3.5.9 SusiSMBReadBlock

3.5.10 SusiSMBWriteBlock

3.5.11 SusiSMBI2CReadBlock

3.5.12 SusiSMBI2CWriteBlock

3.6 Watchdog Functions

3.6.1 SusiWDogGetCaps

3.6.2 SusiWDogStart

3.6.3 SusiWDogStop

3.6.4 SusiWDogTrigger

3.6.5 SusiWDogSetCallBack

3.7 GPIO Functions

3.7.1 SusiGPIOGetCaps

3.7.2 SusiGPIOGetDirection

3.7.3 SusiGPIOSetDirection

3.7.4 SusiGPIOGetLevel

3.7.5 SusiGPIOSetLevel

3.8 Smart Fan Functions

3.8.1 SusiFanControlGetCaps

3.8.2 SusiFanControlGetConfig

3.8.3 SusiFanControlSetConfig

3.9 Storage Functions

3.9.1 SusiStorageGetCaps

3.9.2 SusiStorageAreaRead

3.9.3 SusiStorageAreaWrite

3.9.4 SusiStorageAreaSetLock

3.9.5 SusiStorageAreaSetUnlock

3.10Thermal Protection Functions

3.10.1 SusiThermalProtectionGetCaps

1.1.3 I²C