I2C Software Development Kit for Windows

The I2C Software Development Kit for Windows Professional Edition includes our Dynamic Linked Libraries (DLL) for use in both 16-bit and 32-bit Windows^TM operating environments. When used with our iPort (#MIIC-201), iPort DLL/USB (#MIIC-201D/U), or Variable Clock (#MIIC-201-V) I2C Bus Host Adapter, this kit allows you to write custom 32-bit Windows based I2C applications in Visual C/C++, MFC, Delphi, Visual Basic, or most other Windows application development tool that supports calls to a DLL.

In addition to our DLLs, this kit contains our Programmer's Guide and application examples in several popular Windows programming languages that enable your PC to become an active I2C Master or Slave device, transmitting and receiving I2C messages between your PC and one or more I2C devices across an I2C Bus. Each I2C message can include from 1 to 64K bytes of 8-bit ASCII Text or Binary data.

DLL functions are used by your application program to submit a request for I2C Bus Master message transfers to occur, to respond to I2C Bus Slave transfers, and to get the status of a previous operation or transfer. These DLL functions can then generate an event once the iPort operation is complete.

DLL Functions include:

I2COpen() - Open a link to the iPort device.
I2CClose() - Close the iPort link.
I2CMasterTx() - Master Transmit an I2C message.
I2CMasterRxExt(*) - Master Receive an I2C message.
I2CMasterTxRx(*) - Master Transmit and Receive (for SMBus Smart Battery Devices).
I2CGetStatus() - Get current iPort link status.
I2CGetMasterRxMsg() - Get a Master Receive Message.
I2CGetSlaveRxMsg() - Get a Slave Receive Message.
I2CChangeSlaveAddress() - Change iPort's I2C Slave Address.
I2CChangeSlaveGCEnable() - Change iPort's General Call Enable.
I2CSlaveTx() - Slave Transmit an I2C message.

Complete descriptions and sample applications of these functions are provided in product documentation.

In order to communicate with another I2C device, the following steps must be taken:

1. Establish a link with the iPort with the I2COpen function.
2. Master transmit I2C messages with the I2CMasterTx function.
3. Master receive I2C messages with the I2CMasterRxExt and I2CGetMasterRxMsg functions.
4. Slave transmit I2C messages with the I2CSlaveTx function.
5. Slave receive I2C messages with the I2CGetSlaveRxMsg function.
6. Terminate the link with the iPort with the I2CClose function.

1. DLL Function Return Value

Each DLL function returns a value that can be used to detect if the operation was accepted or denied.

2. Application Window Message

If an Application specifies an Application Window Message Number during the I2COpen function call, iPort events will cause messages to be sent to the Application's Window Message processing function, with the message WPARAM parameter indicating the event.

3. Callback Functions

If an Application specifies a C Callback Function during the I2COpen function call, iPort events will cause callbacks to the specified function, with the function WPARAM parameter indicating the event.

4. Status Polling

The Master Status, Slave Status, and Link Status properties returned by the I2CGetStatus function can be periodically polled to read the latest iPort event.

Professional Edition (16-bit and 32-bit Windows)
System Requirements

32-bit Microsoft Windows (95, NT, ...)
MS 32-bit Visual C++, Borland 32-bit Delphi for Windows, or equivalent.
iPort (#MIIC-201), iPort DLL/USB (#MIIC-201D/U), or Variable Clock (#MIIC-201-V) Host Adapter.

TYPICAL APPLICATIONS

• Product Development, Software/Hardware Testing and Troubleshooting.
• Manufacturing: Testing and Debugging, EEPROM Programming, Quality Control.
• Field Service: Field diagnosis, Repair service and Verification, Product Updates.