Create a New Project

Open the Xcode application and create a new I/O Kit driver project named MyFWProtocolServicesDriver. Specify a directory for the new project or accept the default.

When you create a new I/O Kit driver project, Xcode supplies several files, including two empty source files—MyFWProtocolServicesDriver.h and MyFWProtocolServicesDriver.cpp. Before you add any code to these files, however, you should edit your driver’s information property list.

Edit Your Driver’s Property List

Every driver has an information property list (Info.plist file) that contains information about the driver and what it needs, including its personalities. As described in Driver Personalities and the Matching Process, a driver’s personality contains the matching information the I/O Kit uses to determine the appropriate driver for a device. To make sure your driver loads for your device, you add several properties to its personality dictionary that identify the device or type of device it supports.

In Xcode, a driver’s Info.plist file is listed in the Groups & Files view in the project. You can edit the property list file as plain XML text in the Xcode editor window or you can choose a different application (such as Property List Editor) to use. For more information on how to select another editor, see Hello I/O Kit: Creating a Driver With Xcode.

The IOKitPersonalities dictionary in the driver’s Info.plist file can contain multiple personality dictionaries, one for each device or type of device your driver supports. The sample driver in this chapter implements only one personality dictionary but you can create additional dictionaries if your driver can support more than one device or device type.

The sample code uses the following ten property keys:

• CFBundleIdentifier

• Command_Set

• Command_Spec_ID

• Device_Type

• IOClass

• IOProbeScore

• IOProviderClass

• Physical Interconnect

• Physical Interconnect Location

• Vendor_ID

Using your chosen editing environment, create a new child of the IOKitPersonalities dictionary. Make the name of this new child MyFWProtocolServicesDriver and set its class to Dictionary.

Create ten new children of the MyFWProtocolServicesDriver dictionary, one for each of the ten properties you’ll be adding. Table 6-1 shows the properties, along with their classes and values. To test the sample code with your device, replace values such as MyCommandSetNumber with actual values for your device.

A driver declares its dependencies on other loadable kernel extensions and in-kernel components in the OSBundleLibraries dictionary. Each dependency has a string value that declares the earliest version of the dependency the driver is compatible with.

The sample driver depends on loadable extensions from the IOSCSIArchitectureModel family and the IOFireWire family. To add these dependencies to the OSBundleLibraries dictionary, you create a new child for each dependency. Table 6-2 shows the dependencies you add for the sample driver.

Because the driver of a CD-ROM drive must be able to mount root on a local volume, you add the OSBundleRequired property to the top level of its Info.plist file. In other words, the new OSBundleRequired property is a sibling of the IOKitPersonalities and OSBundleLibraries dictionaries, not a child. Edit the new element to match the following:

OSBundleRequired    String      Local-Root

Edit the Header File

The header file provides access to external declarations and supporting type definitions needed by the functions and objects in the C++ file. The header for the sample driver is simple because it includes only method declarations and no constant or variable declarations. Edit the MyFWProtocolServicesDriver.h file to match the code in Listing 6-1.

Listing 6-1  The MyFWProtocolServicesDriver header file

#ifndef _MyFWProtocolServicesDriver_H_

#define _MyFWProtocolServicesDriver_H_

// Because the sample driver is a subclass of the Apple-provided

// FireWire Serial Bus Protocol driver, it must include that driver's

// header file.

#include <IOKit/sbp2/IOFireWireSerialBusProtocolTransport.h>

// Here, the sample driver declares its inheritance and the method

// it overrides.

class com_MySoftwareCompany_driver_MyFWProtocolServicesDriver : public

                            IOFireWireSerialBusProtocolTransport

{

    OSDeclareDefaultStructors (

            com_MySoftwareCompany_driver_MyFWProtocolServicesDriver )

public:

    virtual bool init ( OSDictionary * propTable );

    virtual bool start ( IOService * provider );

    virtual void stop ( IOService * provider );

};

#endif /* _MyFWProtocolServicesDriver_H_ */

Edit the C++ File

The C++ file provides the code to override the chosen methods. The sample driver’s C++ file contains all the elements required for a subclassed driver even though it accomplishes nothing more substantial than messages sent to the system log file, /var/log/system.log.

Edit the MyFWProtocolServicesDriver.cpp file to match the code in Listing 6-2.

Listing 6-2  The MyFWProtocolServicesDriver C++ file

// Include the header file you created.

#include "MyFWProtocolServicesDriver.h"

// This definition allows you to use the more convenient "super" in

// place of "IOFireWireSerialBusProtocolTransport", where appropriate.

#define super IOFireWireSerialBusProtocolTransport

// This macro must appear before you define any of your class's methods.

// Note that you must use the literal name of the superclass here, not

// "super" as defined above.

OSDefineMetaClassAndStructors (

            com_MySoftwareCompany_driver_MyFWProtocolServicesDriver,

            IOFireWireSerialBusProtocolTransport );

// Define the methods to override.

bool

com_MySoftwareCompany_driver_MyFWProtocolServicesDriver::init (

                                            OSDictionary * propTable )

{

    bool returnValue;

    IOLog ( "MyFWProtocolServicesDriver overriding init\n" );

// You can add code that initializes your device here.

// Call super's init method to make sure all other initialization is done.

    returnValue = super::init ( propTable );

    return returnValue;

}

bool com_MySoftwareCompany_iokit_MyFWProtocolServicesDriver:: start (

                                            IOService * provider )

{

    bool returnValue = false;

    IOLog ( "MyFWProtocolServicesDriver overriding start\n" );

// You can add code for your driver's start functions here.

// Call super's start method to make sure all other start functions are

// fulfilled.

    returnValue = super::start ( provider );

    return returnValue;

}

void com_MySoftwareCompany_iokit_MyFWProtocolServicesDriver::stop (

                                            IOService * provider )

{

    IOLog ( "MyFWProcolLayerDriver overriding stop\n" );

// You can add code for your driver's stop functions here.

// Call super's stop method to ensure all other necessary clean-up is done.

    super::stop ( provider );

}