I2C APIs

Functions
NVAPI_INTERFACE	NvAPI_I2CRead (NvPhysicalGpuHandle hPhysicalGpu, NV_I2C_INFO *pI2cInfo)
NVAPI_INTERFACE	NvAPI_I2CWrite (NvPhysicalGpuHandle hPhysicalGpu, NV_I2C_INFO *pI2cInfo)
#define	NVAPI_MAX_SIZEOF_I2C_DATA_BUFFER   4096
#define	NVAPI_MAX_SIZEOF_I2C_REG_ADDRESS   4
#define	NVAPI_DISPLAY_DEVICE_MASK_MAX   24
#define	NVAPI_I2C_SPEED_DEPRECATED   0xFFFF
#define	NV_I2C_INFO_VER3   MAKE_NVAPI_VERSION(NV_I2C_INFO_V3,3)
#define	NV_I2C_INFO_VER2   MAKE_NVAPI_VERSION(NV_I2C_INFO_V2,2)
#define	NV_I2C_INFO_VER1   MAKE_NVAPI_VERSION(NV_I2C_INFO_V1,1)
#define	NV_I2C_INFO_VER   NV_I2C_INFO_VER3
enum	NV_I2C_SPEED {   NVAPI_I2C_SPEED_DEFAULT , NVAPI_I2C_SPEED_3KHZ , NVAPI_I2C_SPEED_10KHZ , NVAPI_I2C_SPEED_33KHZ ,   NVAPI_I2C_SPEED_100KHZ , NVAPI_I2C_SPEED_200KHZ , NVAPI_I2C_SPEED_400KHZ }
typedef NV_I2C_INFO_V3	NV_I2C_INFO

Detailed Description

The I2C APIs are used to read or write data to DDC monitors using the I2C protocol.

Macro Definition Documentation

NV_I2C_INFO_VER

#define NV_I2C_INFO_VER   NV_I2C_INFO_VER3

NV_I2C_INFO_VER1

#define NV_I2C_INFO_VER1   MAKE_NVAPI_VERSION(NV_I2C_INFO_V1,1)

NV_I2C_INFO_VER2

#define NV_I2C_INFO_VER2   MAKE_NVAPI_VERSION(NV_I2C_INFO_V2,2)

NV_I2C_INFO_VER3

#define NV_I2C_INFO_VER3   MAKE_NVAPI_VERSION(NV_I2C_INFO_V3,3)

NVAPI_DISPLAY_DEVICE_MASK_MAX

#define NVAPI_DISPLAY_DEVICE_MASK_MAX   24

NVAPI_I2C_SPEED_DEPRECATED

#define NVAPI_I2C_SPEED_DEPRECATED   0xFFFF

NVAPI_MAX_SIZEOF_I2C_DATA_BUFFER

#define NVAPI_MAX_SIZEOF_I2C_DATA_BUFFER   4096

NVAPI_MAX_SIZEOF_I2C_REG_ADDRESS

#define NVAPI_MAX_SIZEOF_I2C_REG_ADDRESS   4

Typedef Documentation

NV_I2C_INFO

typedef NV_I2C_INFO_V3 NV_I2C_INFO

Enumeration Type Documentation

NV_I2C_SPEED

enum NV_I2C_SPEED

Enumerator
NVAPI_I2C_SPEED_DEFAULT	Set i2cSpeedKhz to I2C_SPEED_DEFAULT if default I2C speed is to be chosen, ie.use the current frequency setting.
NVAPI_I2C_SPEED_3KHZ
NVAPI_I2C_SPEED_10KHZ
NVAPI_I2C_SPEED_33KHZ
NVAPI_I2C_SPEED_100KHZ
NVAPI_I2C_SPEED_200KHZ
NVAPI_I2C_SPEED_400KHZ

Function Documentation

NvAPI_I2CRead()

NVAPI_INTERFACE NvAPI_I2CRead	(	NvPhysicalGpuHandle	hPhysicalGpu,
		NV_I2C_INFO *	pI2cInfo
	)

This function reads the data buffer from the I2C port. The I2C request must be for a DDC port: pI2cInfo->bIsDDCPort = 1.

A data buffer size larger than 16 bytes may be rejected if a register address is specified. In such a case, NVAPI_ARGUMENT_EXCEED_MAX_SIZE would be returned.

If a register address is specified (i.e. regAddrSize is positive), then the transaction will be performed in the combined format described in the I2C specification. The register address will be written, followed by reading into the data buffer.

SUPPORTED OS: Windows 10 and higher

Since

Release: 85

Parameters

[in]	hPhysicalGPU	GPU selection.
[out]	NV_I2C_INFO	*pI2cInfo The I2C data input structure

Return values

NVAPI_OK	Completed request
NVAPI_ERROR	Miscellaneous error occurred.
NVAPI_HANDLE_INVALIDATED	Handle passed has been invalidated (see user guide).
NVAPI_EXPECTED_PHYSICAL_GPU_HANDLE	Handle passed is not a physical GPU handle.
NVAPI_INCOMPATIBLE_STRUCT_VERSION	Structure version is not supported.
NVAPI_INVALID_ARGUMENT	- argument does not meet specified requirements
NVAPI_ARGUMENT_EXCEED_MAX_SIZE	- an argument exceeds the maximum

NvAPI_I2CWrite()

NVAPI_INTERFACE NvAPI_I2CWrite	(	NvPhysicalGpuHandle	hPhysicalGpu,
		NV_I2C_INFO *	pI2cInfo
	)

This function writes the data buffer to the I2C port.

           The I2C request must be for a DDC port: pI2cInfo->bIsDDCPort = 1.

           A data buffer size larger than 16 bytes may be rejected if a register address is specified.  In such a case,
           NVAPI_ARGUMENT_EXCEED_MAX_SIZE would be returned.

           If a register address is specified (i.e. regAddrSize is positive), then the register address will be written
           and the data buffer will immediately follow without a restart.

SUPPORTED OS: Windows 10 and higher

Since

Release: 85

Parameters

[in]	hPhysicalGPU	GPU selection.
[in]	pI2cInfo	The I2C data input structure

Return values

NVAPI_OK	Completed request
NVAPI_ERROR	Miscellaneous error occurred.
NVAPI_HANDLE_INVALIDATED	Handle passed has been invalidated (see user guide).
NVAPI_EXPECTED_PHYSICAL_GPU_HANDLE	Handle passed is not a physical GPU handle.
NVAPI_INCOMPATIBLE_STRUCT_VERSION	Structure version is not supported.
NVAPI_INVALID_ARGUMENT	Argument does not meet specified requirements
NVAPI_ARGUMENT_EXCEED_MAX_SIZE	Argument exceeds the maximum