Лица драйвера

Каждый драйвер устройства должен объявить одно или более лиц, определяющих типы устройств, которые он может поддерживать. Эти лица находятся в форме словарей XML, содержавшихся в информационном списке свойств (Info.plist файл) в водительском расширении ядра (KEXT) пакет.

Каждая запись в соответствующем словаре составлена из пары ключ/значение в который XML-тэги <key> и </key> включите ключ, и присваиваемое значение включается XML-тэгами, указывающими его тип данных.

В минимуме все лица драйвера содержат следующие два ключа:

• IOClass ключ объявляет имя класса, которого Набор I/O инстанцирует при зондировании. Например,

  <key>IOClass</key>

  <string>IOATAPIProtocolTransport</string>

  говорит Набору I/O инстанцировать IOATAPIProtocolTransport драйвер при зондировании устройства для этой индивидуальности.

• IOProviderClass ключ объявляет, что имя куска классифицирует индивидуальность драйвера присоединения к. Например,

  <key>IOProviderClass</key>

  <string>IOFireWireSBP2LUN</string>

  говорит Набору I/O, что эта индивидуальность драйвера присоединяет к IOFireWireSBP2LUN кусок.

  Класс провайдера определяет специфичные для семьи ключи соответствия, используемые на пассивном шаге соответствия, описанном в Соответствии Драйвера.

Большинство лиц драйвера также содержит IOProbeScore ключ, объявляющий начальный тестовый счет к индивидуальности. Например,

<key>IOProbeScore</key>

<integer>5000</integer>

объявляет основной тестовый счет 5 000, который может быть увеличен или уменьшен во время процесса соответствия, отразив водительскую пригодность для устройства.

Соответствие драйвера

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

Процесс соответствия драйвера состоит из трех фаз:

1. В фазе соответствия класса Набор I/O устраняет драйверы неправильного класса. Например, Набор I/O устраняет драйверы, убывающие от класса SCSI при поиске драйвера USB.

2. В пассивной фазе соответствия Набор I/O исследует индивидуальность драйвера для специфичных для семьи свойств. В семье Model архитектуры SCSI, чем больше соответствующих найденных свойств, тем выше водительский тестовый счет. Например, драйвер, соответствующий и на имени поставщика и на названии продукта, имеет более высокий тестовый счет, чем драйвер, соответствующий только на имени поставщика. Семейство систем хранения, с другой стороны, не влияет на водительский тестовый счет во время соответствия.

   Часто этот шаг достаточен, чтобы определить, подходит ли драйвер для устройства. Если нет никакого специфичного для семьи соответствия, однако, следующий шаг автоматически вызывается.

3. В активной фазе соответствия драйверу кандидата позволяют связаться с устройством и проверить, что это может управлять им. Набор I/O загружает драйверы, остающиеся после пассивной фазы соответствия и каждого водительского probe функция вызвана в отношении устройства, против которого она является соответствующей. probe метод может исследовать устройство всегда, это выбирает, пока это оставляет устройство в том же состоянии, в котором это было найдено.

   Например, поставщик может использовать определенные биты значения свойства для выражения присутствия определенного компонента устройства. Драйвер логической единицы для того устройства может реализовать a probe метод, исследующий те биты, чтобы определить, присутствует ли действительно компонент.

   В зависимости от результатов зонда драйвер увеличивает или уменьшает свой тестовый счет для указания его пригодности для управления устройством.

I/O Кит выбирает драйвер с самым высоким тестовым счетом и запускает его. Если драйвер запускается успешно, любые остающиеся кандидаты драйвера отбрасываются. Если это не успешно, драйвер со следующим самым высоким тестовым счетом запущен, и процесс продолжается, пока не найден успешный драйвер.

Запуск драйвера

При зондировании драйвер может выполнить подробное исследование устройства, включая, при необходимости, выделения памяти, но это должно оставить устройство в том же состоянии, в котором это нашло его. Если драйвер запускается успешно, он может снова использовать память, которую он выделил в probe метод, но если это неуспешно, это, несомненно, должно будет освободить память в free метод.

Когда драйвер запускается, он должен вызвать свой суперкласс start метод прежде, чем сделать что-либо еще. Если суперкласс start метод успешно выполняется, драйвер может тогда выполнить свои инициализации или выделения. Поскольку драйвер может не быть в состоянии выполнить инициализации или выделения безопасно после того, как он запускается, он должен выполнить такие задачи в start метод. Если драйвер неспособен выполнить свои задачи, он может уведомить Набор I/O, и драйвер со следующим самым высоким тестовым счетом запускается.

Драйвер FireWire SBP-2 служб протокола

Как описано в Конструкции Штабеля Драйвера Массового хранения, драйвер служб протокола для устройства массового хранения FireWire SBP-2 должен соответствовать на IOFireWireSBP2LUN кусок, опубликованный IOFireWireTarget объект в физическом взаимосвязанном уровне. IOFireWireSBP2LUN объект содержит следующие семь ключей:

• Command_Set

• Command_Set_Spec_ID

• Vendor_ID

• Command_Set_Revision

• IOUnit

• Firmware_Revision

• Device_Type

IOFireWireTarget возразите сканирует конфигурацию устройства ROM и заполняет значения для этих ключей. Если устройство не объявляет один или больше этих свойств в его конфигурации ROM, IOFireWireSPB2LUN публикует соответствующий ключ с нулевым значением.

Соответствовать на IOFireWireSBP2LUN, IOFireWireSerialBusProtocolTransport индивидуальность драйвера включает ключи, показанные в Перечисление 3-1.

Перечисление 3-1  словарь индивидуальности драйвера IOFireWireSerialBusProtocolTransport

<dict>

    <!-- CFBundleIdentifier denotes the name of the driver in

     -- reverse DNS notation. -->

    <key>CFBundleIdentifier</key>

    <string>com.apple.iokit.IOFireWireSerialBusProtocolTransport</string>

    <!-- Command_Set refers to the organization responsible

     -- for the definition of the command set. -->

    <key>Command_Set</key>

    <integer>66776</integer>

    <!-- Command_Set_Spec_ID specifies the commands

     -- understood by the device. -->

    <key>Command_Set_Spec_ID</key>

    <integer>24734</integer>

    <!-- The name of the class the I/O Kit instantiates

     -- when probing. -->

    <key>IOClass</key>

    <string>IOFireWireSerialBusProtocolTransport</string>

    <!-- The initial probe score for this personality. -->

    <key>IOProbeScore</key>

    <integer>4096</integer>

    <!-- The provider class is the name of the nub class this

     -- driver personality attaches to. -->

    <key>IOProviderClass</key>

    <string>IOFireWireSBP2LUN</string>

    <!-- The next two keys describe which

     -- bus the device is on and whether it is

     -- internal or external.-->

    <key>Physical Interconnect</key>

    <string>FireWire</string>

    <key>Physical Interconnect Location</key>

    <string>External</string>

</dict>

Подкласс IOFireWireSerialBusProtocolTransport драйвер может использовать больше семи ключей IOFireWireSBP2LUN возразите, чтобы более узко определить устройство, которым это подходит управлять. Это может также исследовать значения свойств в probe метод для дальнейшего определения его пригодности. Например, поставщик может использовать некоторые биты в значении свойства для объявления присутствия компонента устройства. Драйвер, который должен определить присутствие этого компонента, может исследовать те биты в probe метод. Перечисление 3-2 показывает, как это может быть сделано для подкласса IOFireWireSerialBusProtocolTransport драйвер.

  Пример перечисления 3-2 драйвер служб протокола FireWire зондирует метод

// This example probe method tests the Firmware_Revision value.

IOService *com_MySoftwareCompany_driver_MyFWProtocolLayerDriver::probe(

                IOService *provider, SInt32 *score )

{

    IOFireWireSBP2LUN *fwSBP2LUN = NULL;

    OSObject *firmwareObject;

    IOService *returnValue = 0;

    // Override probe method inherited from IOFireWireSBP2LUN.

    // Incorporate additional matching based on bits within

    // firmware revision data.

    // Allow superclass first chance at probe

    if ( !IOFireWireSerialBusProtocolTransport::probe( provider, score ) )

        goto ErrorExit;

    fwSBP2LUN = OSDynamicCast( IOFireWireSBP2LUN, provider );

    if ( fwSBP2LUN == NULL )

        goto ErrorExit;

    // Get key from registry that IOFireWireSBP2LUN published

    firmwareObject = provider->getProperty( "Firmware_Revision" );

    if ( firmwareObject )

    {

        OSNumber *firmwareNumberObject;

        UInt32 firmwareValue = 0;

        // Translate the Firmware_Revision property

        // into an OSNumber value for inspection.

        firmwareNumberObject = OSDynamicCast( OSNumber, firmwareObject );

        if ( firmwareNumberObject )

        {

            firmwareValue = firmwareNumberObject->unsigned32BitValue( );

        }

        // Check bits 8 through 23 of the Firmware_Revision value by

        // comparing them with the constants kMyConstant1 and

        // kMyConstant2.

        // These constants represent identification codes and

        // would be defined earlier in the driver's code.

        if ( ( ( ( firmwareValue >> 8 ) & 0x000FFF ) == kMyConstant1 )

        ||

         ( ( ( firmwareValue >> 8 ) & 0x000FFF ) == kMyConstant2 ) )

        {

            IOLog( "%s: Device component detected\n", getName( ) );

            returnValue = this;

        }

    }

ErrorExit:

    return returnValue;

}

Драйвер служб протокола класса массового хранения USB

Когда устройство класса массового хранения USB обнаружено, семья USB абстрагирует содержание дескриптора устройства в вызванный объект куска Набора I/O IOUSBDevice. Дескриптор устройства включает информацию, такую как класс и подкласс устройства, поставщик и номера продуктов и число конфигураций.

Поскольку устройства класса массового хранения USB определяются как составные устройства класса, AppleUSBComposite драйвер соответствует против IOUSBDevice объект куска и наборы первая конфигурация в устройстве. Это заставляет семью USB абстрагировать каждый интерфейсный дескриптор в конфигурации в IOUSBInterface объект куска. IOUSBMassStorageClass драйвер тогда соответствует на массовом хранении совместимые классом интерфейсные объекты куска.

Предоставленное Apple IOUSBMassStorageClass драйвер содержит шесть лиц, соответствующих шести подклассам массового хранения. Каждый подкласс представляет тип блока команды, устанавливает использование интерфейсов устройства. Если устройство совместимо со спецификацией класса массового хранения USB, ее интерфейсный дескриптор содержит ее подкласс и протокол в bInterfaceSubClass и bInterfaceProtocol поля, соответственно.

Код подкласса в bInterfaceSubClass поле относится к одному из подклассов, перечисленных в Таблице 3-1. Эти коды обозначают спецификации промышленного стандарта, описывающие блочные определения команды, используемые интерфейсами устройств класса массового хранения USB. Они не обращаются к определенным типам устройства, так как большинство устройств класса массового хранения USB может принять решение соответствовать любой блочной спецификации команды.

bInterfaceProtocol поле в интерфейсном дескрипторе обозначает транспортный протокол интерфейсное использование. IOUSBMassStorageClass драйвер поддерживает интерфейсные протоколы, показанные в Таблице 3-2.

Если устройство является совместимым классом массового хранения, один из IOUSBMassStorageClass водительские лица соответствуют на интерфейсном подклассе устройства. Перечисление 3-3 показывает первую индивидуальность в IOUSBMassStorageClass водительский словарь индивидуальности.

Перечисление 3-3  Один из IOUSBMassStorageClass водительские лица

<dict>

    <!-- CFBundleIdentifier denotes the name of the driver in

     -- reverse DNS notation. -->

    <key>CFBundleIdentifier</key>

    <string>com.apple.iokit.IOUSBMassStorageClass</string>

    <!-- IOUSBMassStorageClass is the name of the class the I/O Kit

     -- instantiates. -->

    <key>IOClass</key>

    <string>IOUSBMassStorageClass</string>

    <!-- IOUSBInterface is the name of the nub class this

     -- personality attaches to. -->

    <key>IOProviderClass</key>

    <string>IOUSBInterface</string>

    <!-- The next two keys describe which bus

     -- the device is on and whether it is internal

     -- or external.-->

    <key>Physical Interconnect</key>

    <string>USB</string>

    <key>Physical Interconnect Location</key>

    <string>External</string>

    <!-- The interface class this driver matches on.-->

    <key>bInterfaceClass</key>

    <integer>8</integer>

    <!-- Interface subclass 1 refers to the Reduced Block Commands

     -- subclass.-->

    <key>bInterfaceSubClass</key>

    <integer>1</integer>

<dict>

    <key>CFBundleIdentifier</key>

    <string>com.apple.iokit.IOUSBMassStorageClass</string>

    <!-- IOUSBMassStorageClass is the name of the class the

     -- I/O Kit instantiates when probing. -->

    <key>IOClass</key>

    <string>IOUSBMassStorageClass</string>

    <!-- IOUSBInterface is the name of the nub class

    < -- the driver attaches to. -->

    <key>IOProviderClass</key>

    <string>IOUSBInterface</string>

    <!-- The following two keys describe

     -- which bus the device is on and whether it

     -- is internal or external. -->

    <key>Physical Interconnect</key>

    <string>USB</string

    <key>Physical Interconnect Location</key>

    <string>External</string>

    <key>USB Mass Storage Characteristics</key>

    <dict>

        <!-- The bInterfaceProtocol value is Control/Bulk/Interrupt

         -- with command completion interrupt. -->

        <key>Preferred Protocol</key>

        <integer>1</integer>

        <!-- The bInterfaceSubclass value is SFF8070I. -->

        <key>Preferred Subclass</key>

        <integer>5</integer>

    </dict>

    <!-- The following four keys are used for interface

     -- matching. -->

    <key>bConfigurationValue</key>

    <integer>MyConfigurationValue</integer>

    <key>bInterfaceNumber</key>

    <integer>MyInterfaceNumber</integer>

    <key>idProduct</key>

    <integer>MyProductID</integer>

    <key>idVendor</key>

    <integer>MyVendorID</integer>

</dict>

Драйвер служб протокола ATAPI

Когда устройство массового хранения ATAPI обнаружено, контроллер шины ATAPI публикует кусок устройства ATA, который является конкретным подклассом IOATADevice. Семья ATA не определяет специфичного для семьи соответствия, таким образом, все соответствие активно. Это означает, что драйвер зондирует устройство, чтобы определить, подходит ли это управлять им.

В start метод во время активного соответствия, IOATAPIProtocolTransport драйвер сравнивает свойства в своей индивидуальности к свойствам устройства. В частности если тип устройства ATA устройства является ATAPI, загрузками драйвера для того устройства. Перечисление 3-5 показывает индивидуальность для IOATAPIProtocolTransport драйвер.

Перечисление 3-5  словарь индивидуальности драйвера IOATAPIProtocolTransport

<dict>

    <!-- CFBundleIdentifier denotes the name of the driver in

     -- reverse DNS notation. -->

    <key>CFBundleIdentifier</key>

    <string>com.apple.iokit.IOATAPIProtocolTransport</string>

    <!-- IOATAPIProtocolTransport is the class the I/O Kit

     -- instantiates when probing. -->

    <key>IOClass</key>

    <string>IOATAPIProtocolTransport</string>

    <!-- IOATADevice is the nub this driver attaches to. -->

    <key>IOProviderClass</key>

    <string>IOATADevice</string>

    <!-- The next two keys describe which bus the

     -- device is on and whether it is internal

     -- or external.-->

    <key>Physical Interconnect</key>

    <string>ATAPI</string>

    <key>Physical Interconnect Location</key>

    <string>Internal<string>

    <!-- The value of this key is compared to the ATA device type

     -- of the device. -->

    <key>ata device type</key>

    <string>atapi</string>

</dict>

Подкласс IOATAPIProtocolTransport драйвер должен включать те же ключи, показанные в Перечисление 3-5 в его словаре индивидуальности. Если необходимо решить ATAPI-специфичные проблемы, такие как устройство, которое должно сделать жесткую перезагрузку после определенного события, необходимо разработать подкласс IOATAPIProtocolTransport это переопределяет надлежащие методы. Чтобы гарантировать, что Ваш драйвер подкласса загружается, необходимо реализовать probe метод и увеличение тестовый счет после определения, что Ваш драйвер может, фактически, управлять устройством.

Для изменения режимов DMA или UDMA устройства, однако, можно использовать в своих интересах функцию в IOATAPIProtocolTransport драйвер, позволяющий подклассу переопределять режим отчеты устройства. Вы активируете эту опцию путем создания KEXT, состоящего из Info.plist файл, содержащий словарь, названный “Характеристики Массового хранения ATAPI” в дополнение к ключам, показанным в Перечислении 3-5. Этот словарь содержит имя модели устройства и значения режима DMA и UDMA, которые Вы выбираете. Имя модели устройства является строкой возвраты устройства, когда это реагирует на ATA Identify команда. Значения режима DMA и UDMA являются битовыми масками, определенными в ATA/ATAPI-5 спецификация (доступный в http://www.t13.org). Перечисление 3-6 показывает словарь индивидуальности в качестве примера, переопределяющий DMA и значения UDMA, возвращенные устройством.

Перечисление 3-6  словарь индивидуальности, переопределяющий значения UDMA и DMA

<dict>

    <key>ATAPI Mass Storage Characteristics</key>

    <dict>

        <key>DMA Mode</key>

        <integer>0</integer>

        <key>UDMA Mode</key>

        <integer>0</integer>

        <key>device model</key>

        <string>MyDeviceModel</string>

    </dict>

    <key>CFBundleIdentifier</key>

    <string>com.apple.iokit.IOATAPIProtocolTransport</string>

    <key>IOClass</key>

    <string>IOATAPIProtocolTransport</string>

    <key>IOProbeScore</key>

    <integer>5000</integer>

    <key>IOProviderClass</key>

    <string>IOATADevice</string>

    <key>Physical Interconnect</key>

    <string>ATAPI</string>

    <key>Physical Interconnect Location</key>

    <string>Internal</string>

    <key>ata device type</key>

    <string>atapi</string>

</dict>

В этом примере, когда это устройство обнаружено, Набор I/O позволяет весь KEXTs с парой ключ/значение

<key>ata device type</key>

<string>atapi</string>

зондировать устройство. Если индивидуальность KEXT содержит словарь Характеристик Массового хранения ATAPI, Набор I/O сравнивает значение device model строка с именем модели устройства, о котором сообщает устройство. Если они соответствуют, Набор I/O загружается IOATAPIProtocolTransport драйвер и применяет DMA и переопределения UDMA, объявленные в словаре Характеристик Массового хранения ATAPI.