B. Editing the INFRARED.INF File

Windows 95 Setup gets directives from INFRARED.INF for

• Installing a particular device (or devices) from a particular manufacturer.
• Copying files from your installation diskette to the appropriate directories on the Windows 95 computer hard disk.
• Displaying information about the device being installed and the manufacturer of that device in the Setup UI during the installation process.
• Adding keys and values to the Windows 95 registry that describe the IrFramer for your device.

The INFRARED.INF file that is shipped in the DDK has instructions for doing these things for all the IR devices supported by the DDK. The manufacturers and infrared device models supported by the INFRARED.INF file supplied with the DDK are reflected in the [Strings] section of the INF file:

 [Strings]
String1="(Standard infrared devices)"
String2="Extended Systems"
String3="Adaptec"
String4="Texas Instruments"
String5="ACTiSYS"
String6="Built-in Infrared port on laptop or desktop"
  .
  .
  .
String9="JetEye PC Infrared PC Interface (ESI-9680)"
String10="AIRport APA-9320 External Infrared Adapter"
String11="TI TravelMate 5000 Laptop"
String12="ACT-IR200L Infrared Wireless Interface"
String13="ACT-IR220L Infrared Wireless Interface"
String14="Parallax"
String15="LiteLink PRA9500A"
String16="AMP"
String17="PHASIR"
String18="Adaptec AIRport 1000"
 

If you are a completely different manufacturer (for example, you are working for the Redeye Corporation on the REDEYE-88 IR adapter product), you will have to add information about your company and product in the INFRARED.INF file on the installation diskette for your product. Use the INFEDIT.EXE tool in the Windows 95 DDK to edit the INF file. Use the parts of the INFRARED.INF file that install the ACT_IR200L device as examples and add a similar set of information for your dongle.

For developers who are not familiar with using the INFEDIT.EXE tool, a detailed set of instructions follows for using Infedit to add an example IR device, the REDEYE-88, to INFRARED.INF.

The INFEDIT.EXE user interface shows the different parts of INFRARED.INF as folders (containers) on the left side of the screen. When you open a folder by double-clicking on it, the contents of the folder appear on the right side of the screen. The contents of a folder are one or more named items, each with a value (which may be null).

Adding a New Manufacturer

1. Right-click on the Manufacturer folder and select the New Manufacturer option from the popup menu.
2. When a folder labeled New Manufacturer appears, double-click on it to see its contents.
3. Double-click on the item Company Name and (for this example) enter "Redeye Corporation" (without the quotes) in the Edit String dialog box.

Adding a New Device

1. Right-click on the Manufacturer\Redeye Corporation folder and select the New Device option from the popup menu.
2. When a subfolder labeled <Device Description> is displayed under the Redeye Corporation folder, double-click on it to edit its contents.
3. Double-click on Device Description and enter the value "Redeye-88 Infrared Adapter" (or whatever the advertised name of your device is).
4. Double-click on Install Section and enter "Redeye_Install" (or any other self-documenting Install section name).
5. Double-click on Hardware ID and enter "Infrared\Redeye."

Adding a Copy Files Section for the New Device

You need to add a section to INFRARED.INF that copies both the generic serial IrFramer, IRLAPFRM.VXD, and the device-dependent VxD you created from the installation diskette to the \%WINDOWS%\SYSTEM subdirectory on the Windows 95 computer hard disk.

1. Right-click on the Copy Files folder and select the New Copy Files Section option from the pop-up menu.
2. When a subfolder labeled NewFileSection is displayed in the following the Copy Files folder, double-click on it to edit the contents.
3. Double-click on Section Name and enter the value "Redeye_Framer." You do not have to change the Destination Directory value since the default destination directory for INFRARED.INF is the \%WINDOWS%\SYSTEM directory.
4. Right-click on the subfolder that is now labeled Redeye_Framer and select the Add Filename option from the popup menu.
5. Double-click on the item label File Name and in the Destination Name field of the edit dialog enter the filename of the generic serial IrFramer, IRLAPFRM.VXD.
6. Right-click again on the subfolder labeled Redeye_Framer and select the Add Filename option.
7. Double click on the item label File Name and in the Destination Name field of the edit dialog enter the filename the VxD you created in earlier steps of this Road Map. In this example, that is RED88.VXD.

Adding an Add Registry Section for the New Device

You need to add a section for INFRARED.INF that writes the named of the generic serial IrFramer VxD, the name of your device-specific VxD, and the name that identifies your device to the Registry. You can use the contents of the existing ACTiSYS-IR200L_AddReg folder in INFRARED.INF as a model. To add such a folder for your device:

1. Right-click on the Add Registry Sections folder and select the New Add Registry Section option from the pop-up menu.
2. When a subfolder labeled <Section Name> is displayed in the following the Add Registry Sections folder, double-click on it so you can edit the contents.
3. Double-click on Section Name and enter the value "Redeye_AddReg."
4. Right-click on the folder that is now labeled Redeye_AddReg and select the Add Section Value option from the popup menu.
5. When a new subfolder labeled Item0 is displayed under the Redeye_AddReg folder, double-click on it to edit its contents to add a registry entry for the generic serial IrFramer.
6. Double-click on the RegistryRoot item label and enter the value "HKLM" (without the quotes).
7. Double-click on the Subkey item label and enter the value "\Enum\Infrared\Framer" (without the quotes).
8. Double-click on the Value Name item label and enter the value "Driver" (without the quotes).
9. Double-click on the Value item label and enter the value "IRLAPFRM.VXD" (without the quotes).

Repeat steps 4 through 9, except this time the new subfolder will be labeled Item1. Set the RegistryRoot and Subkey items to the same values as for Item0. Set the Value Name item value to "DongleType" and the Value to "RED88."

Repeat steps 4 through 9 again, except this time the new subfolder will be labeled Item2. Set the RegistryRoot and Subkey items to the same values as for Item0 and Item1. Set the Value Name item value to "SpeedDriver" and the Value to the name of the VxD you created (in this example, RED88.VXD).

Adding an Install Section for Your Device

An INF file Install section names all the other sections in the INF file that Windows 95 Setup is to run to do a complete installation of your device. You can use the existing folder ACTiSYS-IR200L_Install as a model for your new Install folder.

Your Install section has to name two Copy Files sections and two Add Registry sections. One Copy Files section copies the two Framer files (you created this section in an earlier step and in this example named the section Redeye_Framer). The other Copy Files section copies all the IR Communications for Windows 95 component files except the two Framer files off the Installation diskette; that section already exists in INFRARED.INF and is named Driver_Copy.

Your Install section also has to name the Add Registry section you just created, which in this example is named Redeye_AddReg, and the Add Registry section that registers all the other IR Communications for Windows 95 components (this folder already exists in INFRARED.INF and is named IRCOMMON_AddReg.

To add the Install section for your device do the following in the INFEDIT.EXE interface:

1. Right-click on the folder labeled Install Sections and select the New Install Section option from the popup.
2. When a new subfolder labeled NewInstallSection is displayed under the Install Sections folder, click on it to edit its contents.
3. Double-click on the item labeled Copy File Sections. A dialog box displays the names of all the Copy Files sections in INFRARED.INF. Select Driver_Copy and add it to the list on the right of the dialog box. The select Redeye_Framer and add it to the list on the right. Then click OK.
4. Double-click on the item labeled AddReg. A dialog box lists the names of all the sections in INFRARED.INF that add items to the Registry. Select IRCOMMON_AddReg and add it to the list on the right. Then select Redeye_AddReg and add it to the list of names on the right and click OK.