Jupiter JI-300 User manual

JI-300
1
4/5/07
Model JI-300
I2C Host Adapter
User’s Manual
Version 1.5
Jupiter Instruments 1/27/2012 Edition

Jupiter Instruments_____________________________________________________________________________________
JI-300
2
9/9/07
TAB E OF CONTENTS
1. INTRODUCTION 4
1.1 Front Panel Description 5
1.2 Rear Panel Description 5
2. GETTING STARTED 6
2.1 Software Installation 6
2.2 Hardware Setup 6
2.3 Communications Check 6
2.4 I2C Tx/Rx Session 7
3. EEPROM PROGRAMMING UTI ITY 10
3.1 EEPROM Programming Session 10
4. MAIN WINDOW AND MENU DESCRIPTIONS 13
4.1 Main Window 13
4.2 Setup Menu 14
4.3 Add/Edit I2C Message Window - Read 15
4.4 Add/Edit I2C Message Window - Write 16
4.5 Add/Edit I2C Message Window - Instruction 16
4.6 EEPROM Programming Utility window 17
5. MESSAGE SCRIPTING 19
5.1 anguage Statements 19
5.2 Scripting Rules 21
5.3 Scripting Exercise 22
APPENDIX A 26
1.0 Specifications 26
APPENDIX B 28

Jupiter Instruments_____________________________________________________________________________________
JI-300
3
9/9/07
1.0 PC System Requirements 28
APPENDIX C 29
1. Installing USB Device Driver 29
a. Windows 7 29
b. Windows Vista 29
c. Windows XP 30
d. Windows 2000 33
2.0 Installing Application Software 36
APPENDIX D 37
1.0 General Information 37
1.1 Warranty 37
1.2 Thirty-Day Return Policy 37
1.3 Li itation of Liability 37
1.4 Contact Us 37

Jupiter Instruments_____________________________________________________________________________________
JI-300
4
9/9/07
1. INTRODUCTION
The JI-300 is a versatile, easy to use, PC hosted adapter used to drive I2C co unications
to/fro a target device. The desktop unit can be configured to interface a variety of I2C networks.
Bus para eters such as clock frequency, duty-cycle, setup and hold ti es, bus voltage, and pull-
up resistor values can be varied. JI-300’s diagnostic features including excessive clock-stretch,
bus-not-free, and bus contention onitoring, as well as status reporting at the conclusion of each
essage transaction si plifies I2C trouble-shooting. A Windows software application anages the
setup and control of the instru ent. Co unications and unit power is provided via a USB 2.0
connection.
Features
• Progra able SCL clock frequency fro 255Hz to 3.8Mhz (20nS steps).
• Variable bus voltage fro 1.50V to 5.25V (10 V steps).
• Supports Master and ulti-Master operation.
• Software selectable bus pull-up resistors (16 values including open)
• Low I2C bus capacitance (<40pF typ.)
• USB 2.0 host interface
• Switched target bus voltage available at connector
• Easy to use Graphical User Interface (GUI) software.
o I2C Message Controller
 Message execution status - Success / Failure with details
 Single-step execution
 Message looping
o EEPROM Progra ing Utility
 Progra ing file for ats include: Binary, Intel HEX, Motorola S-record
o Message Scripting
• Create custo software applications by way of either direct or
Virtual COM Port (VCP) drivers. Progra ing requires no in-depth
knowledge of USB!
• Includes everything needed to get started – I2C Adapter unit, I2C cable, USB cable,
and a CD-ROM containing application software and user’s anual.
Applications
• Fir ware debugging and hardware troubleshooting
• Production line testing
• Equip ent repair and diagnostics

Jupiter Instruments_____________________________________________________________________________________
JI-300
5
9/9/07
1.1 Front Panel Description
Power Activity
Input
I2C Bus Monotor Model JI-210
Ju piter Instruments
I2C Bus Adapter Ju piter Instruments
1 2 3
Model JI-300
1. Power – Power on LED
2. Activity – I2C bus activity/USB port open LED.
3. Input – I2C probe cable jack. 9-pin, Fe ale, D-Sub connector (AMP 745781-4)
Pin-outs: Pin 1 = SDA
Pin 5 = GND
Pin 6 = SCL
Pin 8 = Vbus
Pin 2, 3, 4, 7, 9 = No Connection
1.2 Rear Panel Description
USB
I2C Bus Monotor Model JI-210
Jupiter Instruments
1
1. USB – Type ‘B’ connector (Molex 67068-0000)

Jupiter Instruments_____________________________________________________________________________________
JI-300
6
9/9/07
2. GETTING STARTED
2.1 Software Installation
The JI-300 Host Adapter requires the installation of both a USB driver and application software.
The drivers ust be installed on the host PC’s hard-drive. The application software, however, can
be installed locally or executed directly fro CD-ROM. See appendix C for detailed instructions on
installing both the USB driver and JI-300 application software.
2.2 Hardware Setup
Note that USB drivers for the JI-300 ust be installed before the Hardware Setup will run
successfully.
1. Connect the I2C Host Adapter unit to the host PC using 6’ USB cable.
2. After a few seconds, confir that the JI-300 is powered by verifying that the front panel PWR
LED is on.
2.3 Co unications Check
1. Ensure that the I2C Host Adapter unit is connected to the host PC and power is on.
2. Launch the I2C Host Adapter application by clicking I2C Adapter JI-300.exe.
3. Verify that the I2C Host Adapter ain window is displayed as shown in figure 1.
Figure 1. I2C Host Adapter Main Window
If an error occurs and the window does not appear, begin by verifying that the . ET
Framework is installed. To do this, click Start on your windows desktop, select Control Panel,
and then double-click the Add or Remove Programs icon. When the window appears, scroll
through the list of applications and check for the. ET Framework. If not listed, go to
http://msdn2.microsoft.com/en-us/netframework/aa569263.aspx for instructions on
downloading and installing the latest . ET Framework.

Jupiter Instruments_____________________________________________________________________________________
JI-300
7
9/9/07
4. At the ain window, open a USB port by clicking the Open button in the USB Connection
group.
5. Ensure an open USB port by confir ing an open port status.
6. At the enu bar, open the About essage box by selecting Help, followed by About.
7. Verify that the version nu bers for the HW Version x and VHD Version x are valid (i.e. A,
D, 4, etc.) If a question ark (?) or non-alphanu eric character appears, an error has
occurred.
8. If no errors have occurred (or if errors have been resolved) the Co unications Check has
passed.
2.4 I2C Tx/Rx Session
For this exercise, a target slave device or I2C network with at least one slave device is needed.
Device power (or network) can be supplied by either the I2C target or JI-300 Adapter. The
following steps are for use with a M24C04 I2C target device. (See Figure 2)
1. Ensure that the I2C Host Adapter unit is connected and power is on. (Section 2.2 Hardware
Setup)
2. Ensure that the I2C Host Adapter application is running and the USB port is open. (Section 2.3
Co unications Check)
3. Connect the I2C probe cable to the D-sub connector on the I2C Host Adapter front panel.
4. Connect the four I2C bus probes (SDA, SCL, PWR, and GND) to the I2C target device. (See
Figure 2)
NC E2E1 VSS
SDAWCn SCL
MC24C04
VCC
0.1uF
C1
25V
SDA
SC
GND
PWR
I2C Probe Cable
Figure 2. Connections to M24C04 I2C target test device
5. At the ain window, click the Add Message button to begin adding I2C essages to the list.

Jupiter Instruments_____________________________________________________________________________________
JI-300
8
9/9/07
6. The Add I2C Message window is now displayed. (See Figure 3)
Figure 3. Add I2C Message Window
7. Add the following data to create a write essage:
1. Message Type: Write (Note: The Message Window will change fro a Read
to Write when the Write Message Type is selected)
2. Slave Address: A0h
3. Write Data (1): 00
4. Remove the Stop: Check Box
8. Click Add to add the essage to the essage list.
9. Next, add a read essage.
10. Add the following data to create a read essage:
1. Message Type: Read
2. Slave Address: A1h
3. Read Count: 16
4. Remove the Stop: un-Check Box
11. Click Add to add the essage to the essage list, followed by Exit.
12. Verify that two essages (a read and write) have been added to the Message List.
(See figure 4)
MSG # Addr N/S R/W Data ASCII Status
001 A0 * W 10
002 A1 R
XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
Figure 4. I2C Messages
13. At the Main Window enu bar, open the setup enu by selecting Setup, then Setup Menu.

Jupiter Instruments_____________________________________________________________________________________
JI-300
9
9/9/07
14. The Setup enu is now displayed (See Figure 5)
Figure 5. Setup Menu
15. At the Bus Voltage group, select a 1K oh bus pull-up resistor by clicking the up/down buttons.
16. Click OK to save the selection and close the Setup Window.
17. At the ain window, turn-on the external bus voltage by clicking Enable in the External Bus
Voltage group.
18. Enable Message Looping by clicking Enable in the Message Looping group.
19. Now, begin an I2C session by clicking Reset Que, followed by clicking Run in the Operation
group.
20. Verify the following actions:
1. The essage “Success!” is in the status colu ns for both essages.
2. The text “Hello world!” is in the ASCII colu n of the read essage.
3. The asterisk cursor quickly oving back-and-forth between the two essages.
21. The I2C Tx/Rx exercise is now co plete.

Jupiter Instruments_____________________________________________________________________________________
JI-300
10
9/9/07
3. EEPROM PROGRAMMING UTI ITY
This fully integrated utility is designed for progra ing a variety of EEPROM and e ory devices
either in-circuit or standalone. All essential progra ing functions are provided including device
read, progra , and verify, as well as buffer edit, pre-fill, load, and save operations. EEPROM i age
data can be loaded fro a file, copied fro another device, or entered anually using HEX values
and/or ASCII characters. Data can be saved to disk via Intel HEX, Motorola S-Record, or raw Binary
file for ats.
Features:
• Devices: Over 100 devices including At el, Generic, Microchip,
NXP, ST Micro, and GP Block Reads
• Supported file for ats: Intel HEX, Motorola S-Record, and raw Binary.
• Progra ing voltage: 1.50V to 5.25V
• SCL clock rate: 254Hz to 4.0MHz with variable setup and hold ti es
3.1 EEPROM Progra ing Session
This exercise will fa iliarize the user with the funda ental progra ing features of the JI-300
EEPROM progra ing utility.
Before beginning this exercise, be sure that you are so ewhat fa iliar with the controls on the
EEPROM Progra ing Utility window (Section 4.5) and that you have previously run both the
“Co unications Check” and “I2C Tx/Rx Session” exercises in section 2.0.
For this exercise, a target slave device (included with the JI-300 kit) or I2C network with at least
one slave device will be needed. Device power (or network) can be supplied by either the I2C
target or JI-300 Adapter. The following steps are for use with the test M24C04 I2C target device.
1. Begin by executing all 21 steps in the I2C Tx/Rx Session in section 2.4. This will ensure a
working HW connection and valid HW settings.
2. Open the EEPROM Progra ing Utility window by clicking Utilities, followed by
EEPROM Programming at the ain window enu bar.
3. Verify that the EEPROM Progra ing Utility window is now displayed (See Figure 6)

Jupiter Instruments_____________________________________________________________________________________
JI-300
11
9/9/07
Figure 6. EEPROM Progra ing Utility window
4. Enter the anufacture and device type for the target EEPROM. For this exercise, text box
data is enter as follows:
• Manufacture: ST Micro
• Device: M24C04
These two text boxes are located at the lower left-hand side of the Progra ing Utility
window.
5. Enter EEPROM chip select data.
• CS2: 0
• CS1: 0
• CS0: N/A
6. Now, verify device settings by successfully reading the EEPROM. This is acco plished by
clicking the Read button in the Operation group. A read ti e for this device is approxi ately
5 seconds and a successfully operation will display “Done!” in the status text box.
7. Next, fill the Buffer with ASCII “space” characters by entering 20h in the Fill Value text
box and then clicking the Pre-Fill Buffer button.
8. Verify that the Buffer contains the HEX value 20h.
9. Type the word “Top” beginning at address 000h in the ASCII section of the Buffer.
10. Type the word “Botto ” beginning at address 1f0h in the ASCII section of the Buffer.
11. Progra the EEPROM by clicking the Program button.
12. A essage box will appear asking, “Are you sure you want to progra this device?” Click
yes. Progra ing begins.
13. After approxi ately 5 to 10 seconds progra ing will end and “Done Progra ing!” will
be displayed in status text box.

Jupiter Instruments_____________________________________________________________________________________
JI-300
12
9/9/07
14. To verify that both Buffer and EEPROM data agree, click the Verify button. After
approxi ately 5 seconds, the operation will end and “Verification Successful!” will be
displayed in the Status text box.
15. To illustrate a verification error, fill the Buffer with ASCII “space” characters. As before,
enter 20h in the Fill Value text box and then click the Pre-Fill Buffer button.
16. Click the Verify button. When finished, verify that:
a. The status text box displays “Verification Error: 9 Byte(s)”
b. 9 address locations are arked red.
c. The red arked locations are where the “Top” and “Botto ” text was typed.
17. Correct the verification error by clicking the Read button. Re-verify by again clicking the
Verify button.
18. After approxi ately 5 seconds, verify that “Verification Successful!” is displayed in the
status text box and the text “Top” appears at the top of the Buffer and “Botto ” appears at
the botto of the Buffer.
19. Save Buffer data to file by clicking File at the enu bar, followed by Save Buffer,
followed by Intel HEX.
20. The Save File dialog box is now displayed. Type in an appropriate file na e such as
“HEXFile_Test1” and click Save.
21. Buffer data is now saved to file HEXFile_Test1.hex in an Intel HEX file for at.
22. Next, the Buffer will be loaded fro a file. First, however, the Buffer contents will be filled
with “X”s.
23. Enter 58h in the Fill Value text box and then click the Pre-Fill Buffer button.
24. Load Buffer data to file by clicking File at the enu bar, followed by oad Buffer,
followed by Intel HEX.
25. The Open File dialog box is now displayed. Type in the file na e entered in step 20
(“HEXFile_Test1”) and click Open. Buffer data is now reloaded.
26. Verify that “Top” appears at the top of the Buffer and “Botto ” appears at the botto of
the Buffer.
27. The EEPROM Progra ing exercise is now co plete.

Jupiter Instruments_____________________________________________________________________________________
JI-300
13
9/9/07
4. MAIN WINDOW AND MENU DESCRIPTIONS
4.1 Main Window
The I2C Host Adapter Main Window is shown in Figure 7.
1
2
3
4 5 6 7 8 9 10
11
Figure 7. I2C Host Adapter Main Window
1. Message ist – I2C essages are stored here. Messages are added via the Add Message
button. To Insert, Edit, or Delete an existing essage, double-click the essage nu ber.
2. Run/Stop – These buttons control the trans ission of I2C essages. The Run button
initiates a session where by I2C essages stored in the essage list are squelchy
executed. The session starts at the cursor position and ends either by the execution of the
lasted essage in the list or by clicking the Stop button.
3. Single Step – This button is used to trans it a single I2C essage.
4. Progress – Status of the current session is displayed here.
5. Reset Que – Clicking this button oves the cursor to the first essage in the essage list.
6. Message ist ooping – This group provides control and onitoring of the essage list
looping function. When Enabled, a session will cyclically execute all I2C essages stored in
the essage list when a session is started. A Clear Data & Status check box provides the
option of clearing both Data and Status colu ns at the beginning of each loop pass.
7. 200mS Message Delay – This function, when Enabled, inserts a s all delay (approx.
200 s) between each essage trans ission.
8. I2C Bus State – The present state of the SCL and SDA signals is displayed here.
9. External Bus Voltage – Control (On/Off) of the external bus voltage (Vbus) is perfor ed
here.

Jupiter Instruments_____________________________________________________________________________________
JI-300
14
9/9/07
10. USB Port – Open/Close USB port fro this area.
11. Message ist --
a. Add Message – Clicking this button will either add a Read or Write essage to the
Message List. Messages will be appended to the botto of the list.
b. Clear Data – Clicking this button will re ove all read data fro the Message List.
c. Clear Status – Clicking this button will re ove all status co ents fro the
Message List.
d. Clear Message ist – Clicking this button will re ove all essages fro the
Message List
4.2 Setup Menu
The Setup Menu provides a convenient eans of configuring and aintaining an I2C hardware
setup (See Figure 8.)
3
4
5
6
7
1
2
Figure 8. Setup Menu
1. SC Frequency – Two ethods are provided to configure the SCL Clock: Standard and
Advanced. When selecting Standard, Frequency and Duty cycle data is entered and the
tHIGH, tSU,DAT, and tHD,DAT values that co prise the SCL wavefor are auto atically
calculated and loaded. Note that tSU,DAT, and tHD,DA values are held nearly equal (+/- 1
bit). If a unique SCL wavefor is desired, the Advanced ode is selected. In this ode
tHIGH, tSU,DAT, and tHD,DAT data is entered directly. The resultant SCL frequency and
tLOW value is then calculated and displayed.
2. Bus Voltage and Pull-ups – The I2C Bus voltage and SDA/SCL pull-up resistor values are
entered here.
3. Multi-master Mode – JI-300 ulti- aster ode is enabled/disabled here.

Jupiter Instruments_____________________________________________________________________________________
JI-300
15
9/9/07
4. SC Stretch – During a Slave SCL stretch event, the behavior of the JI-300 can be
configured to:
a. Wait indefinitely on a SCL stretch event – Wait Forever selection
b. Stop if the selected SCL stretch value is exceeded.
5. SC /SDA Rise Time – The axi u expected rise-ti e value for either the SCL or SDA
signal is entered here. I2C physical layer para eters such as pull-up resistors, bus voltage,
and bus capacitance can affect rise-ti e. Two ethods are provided to configure the rise-
ti e:
a. No inal I2C syste – Auto Select selection
b. Specialized I2C syste – Rise-ti e value is entered
6. Bus not Free – The behavior of the JI-300 can be configured to either wait indefinitely for a
“bus free” condition or stop if a “bus free” condition is not available within a specified ti e.
7. Message Error – In the event of a bus error during an I2C trans ission session, the
behavior of the JI-300 can be configured to:
a. Stop all trans issions
b. Note the error and continue trans itting
4.3 Add/Edit I2C Message Window - Read
The Add/Edit I2C Message Window - Read is used to both edit and add new Read essages to the
Message List (Figure 9.)
Figure 9. Add/Edit I2C Message Menu - Read

Jupiter Instruments_____________________________________________________________________________________
JI-300
16
9/9/07
4.4 Add/Edit I2C Message Window - Write
The Add/Edit I2C Message Window - Write is used to both edit and add new Write essages to the
Message List (Figure 10.)
Figure 10. Add/Edit I2C Message Window - Write
4.5 Add/Edit I2C Message Window - Instruction
The Add/Edit I2C Message Window - Instruction is used to add essage execution instructions to
the Message List (Figure 11.)
Figure 11. Add/Edit I2C Message Window - Instruction

Jupiter Instruments_____________________________________________________________________________________
JI-300
17
9/9/07
4.6 EEPROM Progra ing Utility window
This fully integrated progra ing utility is located under the Utilities tab at the ain window enu
bar.
1
2
3 4 5 7 8 106 9
Figure 12. EEPROM Programming Utility window
1. Buffer – Me ory data either read fro , or waiting to be written to an EEPROM is displayed
here. The Buffer can be loaded (as well as saved) via several popular file for ats (Intel
HEX, Motorola S-Record, and raw Binary) and edited anually using HEX values and/or
ASCII characters.
2. Manufacture & Device – Select an EEPROM by anufacture and part nu ber or select a
generic e ory device.
3. Device Code – The device code for the target EEPROM is displayed here. The code is
selected auto atically for generic and co ercial devices. For general-purpose block
e ory, however, the code is selected anually.
4. Chip Selects – Select the state (0 or 1) of the target device chip selects (CS).
5. Read – Clicking this button reads the contents of the EEPROM into the Buffer.
6. Status – Status of the session is displayed here.
7. Program – Data fro the Buffer is written to the target EEPROM device when this button is
clicked. ote: The programmed device is not automaticall verified after programming.
Use the Verify function to ensure that the device was properly progra ed.
8. Pre-Fill Buffer – The HEX Fill Value is copied to all locations within the Buffer. The Fill
Value data range is fro 00h to ffh.

Jupiter Instruments_____________________________________________________________________________________
JI-300
18
9/9/07
9. Stop – If, for any reason it is necessary to i ediately ter inate an operation, the Stop
button is used.
10. Verify – Verify co pares the content of the Buffer with that of an EEPROM device. Data
discrepancies are displayed as red- arked boxes in the Buffer. At the conclusion, operation
success or failure is displayed in the Status box.

Jupiter Instruments_____________________________________________________________________________________
JI-300
19
9/9/07
5. MESSAGE SCRIPTING
Scripting provides an alternate ethod of creating and editing I2C essages for use in the JI-300
application environ ent. Messages are constructed using a si ple text editor such as Windows
Notepad. The JI-300 scripting language includes both I2C co ands (Read & Write), and JI-300
instructions (Stop, Co ent, etc.) Script files are loaded into the JI-300 application and executed as
conventional I2C essages.
5.1 Language State ents
I2C Commands
1. I2C Write
Description: This co and is used to write data to a slave device. A axi u of 32 and
a ini u 0 bytes can be trans itted. The first two characters following the
write character (w) specifies the slave address. The re aining characters
c onstitu te the data payload. A carriage-return and line-feed ter inates the
state ent.
Syntax: waaaa...aa<CR><LF>
Address
& Direction: aa Upper 7-bits = slave address. LSB = direction (0 = write)
Range = even bytes fro 00h to FEh.
Data: aa...aa Write Data 32 bytes axi u .
Exa ple:
Co and Description
wa031abc34892<CR><LF> Write 31h, abh, c3h, 48h, and 92h to
slave address 50h.
w2c1235ab<CR><LF> Write 12h, 35h, and abh to slave address
16h.
2. I2C Write without a Stop
Description: This co and is identical to the “I2C Write“ co and, except that it does
not issue an I2C stop event .
Syntax: yaaaa...aa<CR><LF>
Address
& Direction: aa Upper 7-bits = slave address. LSB = direction (0 = write)
Range = even bytes fro 00h to FEh.
Data: aa...aa Write Data 32 bytes axi u .
Exa ple:
Co and Description
ya031abc34892<CR><LF> Write 31h, abh, c3h, 48h, and 92h to
slave address 50h.

Jupiter Instruments_____________________________________________________________________________________
JI-300
20
9/9/07
y2c1235ab<CR><LF> Write 12h, 35h, and abh to slave address
16h.
3. I2C Read
Description: This co and is used to read data fro a slave device. A axi u of 32
and a ini u 0 bytes can be read. The first two characters following the
read character (q) specifies the nu ber of bytes to read. The next two
characters specifies the slave address. A carriage-return and line-feed
ter inates the state ent.
Syntax: qaaaa<CR><LF>
Read Count: aa Range 00h to 20h.
Address
& Direction: aa Upper 7-bits = slave address. LSB = direction (1 = read)
Range = odd bytes fro 01h to FFh.
Exa ple:
Co and Description
q14a3<CR><LF> Read 20 bytes fro slave address 51h.
q0ab1<CR><LF> Read 10 bytes fro slave address 58h.
4. I2C Read without Stop
Description: This co and is identical to the “I2C Read“ co and, except that it does
not issue an I2C stop event .
Syntax: daaaa<CR><LF>
Read Count: aa Range 00h to 20h.
Address
& Direction: aa Upper 7-bits = slave address. LSB = direction (1 = read)
Range = odd bytes fro 01h to FFh.
Exa ple:
Co and Description
d14a3<CR><LF> Read 20 bytes fro slave address 51h.
d0ab1<CR><LF> Read 10 bytes fro slave address 58h.
JI-300 Instructions
1. Stop
Description: This instruction stops essage execution during an I2C session.
Syntax: *S<CR><LF>
Address: N/A
Data: N/A
Exa ple: