Создайте новый проект

Откройте приложение XCode и создайте новый названный проект драйвера Набора I/O MyFWProtocolServicesDriver. Укажите каталог для нового проекта или примите значение по умолчанию.

При создании нового проекта драйвера Набора I/O XCode предоставляет несколько файлов, включая два пустых исходных файла —MyFWProtocolServicesDriver.h и MyFWProtocolServicesDriver.cpp. Перед добавлением любого кода к этим файлам, однако, необходимо отредактировать водительский информационный список свойств.

Отредактируйте свой водительский список свойств

Каждый драйвер имеет информационный список свойств (Info.plist файл), который содержит информацию о драйвере и в чем это нуждается, включая его лица. Как описано в Лицах Драйвера и Соответствии Процесса, водительская индивидуальность содержит соответствующую информацию использование Набора I/O для определения надлежащего драйвера для устройства. Для проверки драйвер загружается для устройства, Вы добавляете несколько свойств к его словарю индивидуальности, идентифицирующих устройство или тип устройства, которое это поддерживает.

В XCode, водительском Info.plist файл перечислен в представлении Groups & Files в проекте. Можно отредактировать файл списка свойств как простой текст XML в редакторе XCode окно, или можно выбрать различное приложение (такое как Редактор Списка свойств) для использования. Для получения дополнительной информации о том, как выбрать другого редактора, посмотрите Привет Набор I/O: Создание Драйвера С XCode.

IOKitPersonalities словарь в водительском Info.plist файл может содержать словари разносторонне развитой личности, один для каждого устройства или типа устройства Ваши поддержки драйвера. Демонстрационный драйвер в этой главе реализует только один словарь индивидуальности, но можно создать дополнительные словари, если драйвер может поддерживать больше чем один тип устройства или тип устройства.

Пример кода использует следующие десять ключей свойства:

• CFBundleIdentifier

• Command_Set

• Command_Spec_ID

• Device_Type

• IOClass

• IOProbeScore

• IOProviderClass

• Physical Interconnect

• Physical Interconnect Location

• Vendor_ID

Используя Вашу выбранную среду редактирования, создайте новый дочерний элемент IOKitPersonalities словарь. Сделайте имя этого нового дочернего элемента MyFWProtocolServicesDriver и набор его класс Словаря.

Создайте десять новых дочерних элементов MyFWProtocolServicesDriver словарь, один для каждого из этих десяти свойств Вы будете добавлять. Таблица 6-1 показывает свойства, вместе с их классами и значениями. Для тестирования примера кода с устройством замените значения такой как MyCommandSetNumber с фактическими значениями для Вашего устройства.

Драйвер объявляет свои зависимости от других загружаемых расширений ядра и компонентов в ядре в OSBundleLibraries словарь. Каждая зависимость имеет строковое значение, объявляющее самую раннюю версию зависимости, с которой драйвер совместим.

Демонстрационный драйвер зависит от загружаемых расширений от IOSCSIArchitectureModel семья и IOFireWire семья. Добавить эти зависимости к OSBundleLibraries словарь, Вы создаете новый дочерний элемент для каждой зависимости. Таблица 6-2 показывает зависимости, которые Вы добавляете для демонстрационного драйвера.

Поскольку драйвер дисковода для компакт-дисков должен быть в состоянии смонтировать корень на локальном томе, Вы добавляете OSBundleRequired свойство к верхнему уровню Info.plist файл. Другими словами, новое OSBundleRequired свойство является одноуровневым элементом IOKitPersonalities и OSBundleLibraries словари, не дочерний элемент. Отредактируйте новый элемент для соответствия следующего:

OSBundleRequired    String      Local-Root

Отредактируйте заголовочный файл

Заголовочный файл обеспечивает доступ к внешним объявлениям и поддерживающий определения типа, необходимые функциям и объектам в файле C++. Заголовок для демонстрационного драйвера прост, потому что это включает только объявления метода и никакие объявления константы или объявления переменной. Отредактируйте MyFWProtocolServicesDriver.h файл для соответствия кода в Перечислении 6-1.

Перечисление 6-1  заголовочный файл MyFWProtocolServicesDriver

#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_ */

Отредактируйте файл C++

Файл C++ обеспечивает код для переопределения выбранных методов. Демонстрационный водительский файл C++ содержит все элементы, требуемые для разделенного на подклассы драйвера даже при том, что он не выполняет ничто более существенное, чем сообщения, отправленные в системный файл журнала, /var/log/system.log.

Отредактируйте MyFWProtocolServicesDriver.cpp файл для соответствия кода в Перечислении 6-2.

Перечисление 6-2  файл C++ MyFWProtocolServicesDriver

// 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 );

}