Path: blob/main/documentation/content/ru/books/arch-handbook/pccard/_index.po
18099 views
# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # Vladlen Popolitov <[email protected]>, 2025, 2026. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" "POT-Creation-Date: 2025-05-01 19:56-0300\n" "PO-Revision-Date: 2026-03-05 04:45+0000\n" "Last-Translator: Vladlen Popolitov <[email protected]>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" "documentation/booksarch-handbookpccard_index/ru/>\n" "Language: ru\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " "n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" "X-Generator: Weblate 4.17\n" #. type: Title = #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:1 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:14 #, no-wrap msgid "PC Card" msgstr "PC Card" #. type: YAML Front Matter: title #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:1 #, no-wrap msgid "Chapter 16. PC Card" msgstr "Глава 16. PC Card" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:52 msgid "" "This chapter will talk about the FreeBSD mechanisms for writing a device " "driver for a PC Card or CardBus device. However, at present it just " "documents how to add a new device to an existing pccard driver." msgstr "" "Эта глава расскажет о механизмах FreeBSD для написания драйвера устройства " "для PC Card или CardBus устройства. Однако в настоящее время она лишь " "документирует, как добавить новое устройство к существующему драйверу pccard." #. type: Title == #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:54 #, no-wrap msgid "Adding a Device" msgstr "Добавление устройства" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:57 msgid "" "Device drivers know what devices they support. There is a table of supported " "devices in the kernel that drivers use to attach to a device." msgstr "" "Драйверы устройств знают, какие устройства они поддерживают. В ядре " "существует таблица поддерживаемых устройств, которую драйверы используют для " "подключения к устройству." #. type: Title === #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:59 #, no-wrap msgid "Overview" msgstr "Обзор" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:62 msgid "" "PC Cards are identified in one of two ways, both based on the _Card " "Information Structure_ (CIS) stored on the card. The first method is to use " "numeric manufacturer and product numbers. The second method is to use the " "human readable strings that are also contained in the CIS. The PC Card bus " "uses a centralized database and some macros to facilitate a design pattern " "to help the driver writer match devices to his driver." msgstr "" "PC Cards идентифицируются одним из двух способов, оба основаны на _Card " "Information Structure_ (CIS), хранящейся на карте. Первый метод — " "использование числовых идентификаторов производителя и продукта. Второй " "метод — использование удобочитаемых строк, также содержащихся в CIS. Шина PC " "Card использует централизованную базу данных и некоторые макросы для " "упрощения шаблона проектирования, помогающего автору драйвера сопоставлять " "устройства с его драйвером." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:64 msgid "" "Original equipment manufacturers (OEMs) often develop a reference design for " "a PC Card product, then sell this design to other companies to market. Those " "companies refine the design, market the product to their target audience or " "geographic area, and put their own name plate onto the card. The refinements " "to the physical card are typically very minor, if any changes are made at " "all. To strengthen their brand, these vendors place their company name in " "the human readable strings in the CIS space, but leave the manufacturer and " "product IDs unchanged." msgstr "" "Производители оригинального оборудования (OEM) часто разрабатывают эталонный " "дизайн для продуктов PC Card, а затем продают этот дизайн другим компаниям " "для продвижения на рынке. Эти компании дорабатывают дизайн, продвигают " "продукт для своей целевой аудитории или географического региона и размещают " "на карте свою собственную торговую марку. Доработки физической карты обычно " "очень незначительны, если они вообще вносятся. Чтобы усилить свой бренд, " "такие поставщики указывают название своей компании в читаемых человеком " "строках в пространстве CIS, но оставляют идентификаторы производителя и " "продукта без изменений." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:66 msgid "" "Due to this practice, FreeBSD drivers usually rely on numeric IDs for device " "identification. Using numeric IDs and a centralized database complicates " "adding IDs and support for cards to the system. One must carefully check to " "see who really made the card, especially when it appears that the vendor who " "made the card might already have a different manufacturer ID listed in the " "central database. Linksys, D-Link, and NetGear are a number of US " "manufacturers of LAN hardware that often sell the same design. These same " "designs can be sold in Japan under names such as Buffalo and Corega. Often, " "these devices will all have the same manufacturer and product IDs." msgstr "" "Из-за такой практики драйверы FreeBSD обычно полагаются на числовые " "идентификаторы для распознавания устройств. Использование числовых " "идентификаторов и централизованной базы данных усложняет добавление ID и " "поддержку карт в систему. Необходимо тщательно проверять, кто на самом деле " "произвел карту, особенно когда кажется, что у производителя карты уже может " "быть другой идентификатор производителя в центральной базе данных. Linksys, " "D-Link и NetGear — это несколько американских производителей сетевого " "оборудования, которые часто продают один и тот же дизайн. Эти же дизайны " "могут продаваться в Японии под такими названиями, как Buffalo и Corega. " "Часто все эти устройства будут иметь одинаковые идентификаторы производителя " "и продукта." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:68 msgid "" "The PC Card bus code keeps a central database of card information, but not " "which driver is associated with them, in [.filename]#/sys/dev/pccard/" "pccarddevs#. It also provides a set of macros that allow one to easily " "construct simple entries in the table the driver uses to claim devices." msgstr "" "Код шины PC Card хранит централизованную базу данных информации о картах, но " "не о том, какой драйвер с ними связан, в [.filename]#/sys/dev/pccard/" "pccarddevs#. Он также предоставляет набор макросов, которые позволяют легко " "создавать простые записи в таблице, используемой драйвером для заявки " "устройств." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:70 msgid "" "Finally, some really low end devices do not contain manufacturer " "identification at all. These devices must be detected by matching the human " "readable CIS strings. While it would be nice if we did not need this method " "as a fallback, it is necessary for some very low end CD-ROM players and " "Ethernet cards. This method should generally be avoided, but a number of " "devices are listed in this section because they were added prior to the " "recognition of the OEM nature of the PC Card business. When adding new " "devices, prefer using the numeric method." msgstr "" "Наконец, некоторые устройства очень низкого уровня вообще не содержат " "идентификации производителя. Эти устройства должны быть обнаружены путем " "сопоставления читаемых человеком строк CIS. Хотя было бы хорошо, если бы нам " "не нужен был этот метод в качестве запасного варианта, он необходим для " "некоторых очень дешевых CD-плееров и Ethernet-карт. Этот метод, как правило, " "следует избегать, но ряд устройств перечислен в этом разделе, потому что они " "были добавлены до осознания OEM-характера бизнеса PC Card. При добавлении " "новых устройств предпочтительнее использовать числовой метод." #. type: Title === #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:72 #, no-wrap msgid "Format of [.filename]#pccarddevs#" msgstr "Формат файла [.filename]#pccarddevs#" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:75 msgid "" "There are four sections in the [.filename]#pccarddevs# files. The first " "section lists the manufacturer numbers for vendors that use them. This " "section is sorted in numerical order. The next section has all of the " "products that are used by these vendors, along with their product ID numbers " "and a description string. The description string typically is not used " "(instead we set the device's description based on the human readable CIS, " "even if we match on the numeric version). These two sections are then " "repeated for devices that use the string matching method. Finally, C-style " "comments enclosed in `/*` and `*/` characters are allowed anywhere in the " "file." msgstr "" "В файле [.filename]#pccarddevs# есть четыре раздела. Первый раздел содержит " "номера производителей для вендоров, которые их используют. Этот раздел " "отсортирован в числовом порядке. Следующий раздел включает все продукты, " "используемые этими вендорами, вместе с их идентификаторами продуктов и " "строкой описания. Строка описания обычно не используется (вместо этого мы " "устанавливаем описание устройства на основе читаемого CIS, даже если " "совпадение найдено по числовому идентификатору). Затем эти два раздела " "повторяются для устройств, использующих метод строкового сопоставления. " "Наконец, C-подобные комментарии, заключенные между символами `/*` и `*/`, " "допускаются в любом месте файла." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:77 msgid "" "The first section of the file contains the vendor IDs. Please keep this list " "sorted in numeric order. Also, please coordinate changes to this file " "because we share it with NetBSD to help facilitate a common clearing house " "for this information. For example, here are the first few vendor IDs:" msgstr "" "Первая часть файла содержит идентификаторы производителей. Пожалуйста, " "сохраняйте этот список в числовом порядке. Также, пожалуйста, согласовывайте " "изменения в этом файле, так как мы делимся им с NetBSD для создания общего " "центра обработки этой информации. Например, вот первые несколько " "идентификаторов производителей:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:84 #, no-wrap msgid "" "vendor FUJITSU\t\t\t0x0004 Fujitsu Corporation\n" "vendor NETGEAR_2\t\t0x000b Netgear\n" "vendor PANASONIC\t\t0x0032\tMatsushita Electric Industrial Co.\n" "vendor SANDISK\t\t\t0x0045\tSandisk Corporation\n" msgstr "" "vendor FUJITSU\t\t\t0x0004 Fujitsu Corporation\n" "vendor NETGEAR_2\t\t0x000b Netgear\n" "vendor PANASONIC\t\t0x0032\tMatsushita Electric Industrial Co.\n" "vendor SANDISK\t\t\t0x0045\tSandisk Corporation\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:87 msgid "" "Chances are very good that the `NETGEAR_2` entry is really an OEM that " "NETGEAR purchased cards from and the author of support for those cards was " "unaware at the time that Netgear was using someone else's ID. These entries " "are fairly straightforward. The vendor keyword denotes the kind of line that " "this is, followed by the name of the vendor. This name will be repeated " "later in [.filename]#pccarddevs#, as well as used in the driver's match " "tables, so keep it short and a valid C identifier. A numeric ID in hex " "identifies the manufacturer. Do not add IDs of the form `0xffffffff` or " "`0xffff` because these are reserved IDs (the former is \"no ID set\" while " "the latter is sometimes seen in extremely poor quality cards to try to " "indicate \"none\"). Finally there is a string description of the company " "that makes the card. This string is not used in FreeBSD for anything but " "commentary purposes." msgstr "" "Вероятно, запись `NETGEAR_2` на самом деле относится к OEM-производителю, у " "которого NETGEAR приобретал карты, и автор поддержки этих карт не знал на " "тот момент, что Netgear использовал чужой идентификатор. Эти записи довольно " "просты. Ключевое слово `vendor` обозначает тип строки, за которым следует " "название производителя. Это название будет повторяться позже в [." "filename]#pccarddevs#, а также использоваться в таблицах соответствия " "драйверов, поэтому оно должно быть коротким и допустимым идентификатором в " "C. Числовой идентификатор в шестнадцатеричном формате указывает " "производителя. Не добавляйте идентификаторы вида `0xffffffff` или `0xffff`, " "так как они зарезервированы (первый означает \"идентификатор не установлен\"" ", а второй иногда встречается в крайне некачественных картах для указания " "\"отсутствует\"). Наконец, следует строковое описание компании, производящей " "карту. Эта строка в FreeBSD ни для чего не используется, кроме как в " "комментариях." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:89 msgid "" "The second section of the file contains the products. As shown in this " "example, the format is similar to the vendor lines:" msgstr "" "Вторая секция файла содержит продукты. Как показано в этом примере, формат " "аналогичен строкам поставщиков:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:94 #, no-wrap msgid "" "/* Allied Telesis K.K. */\n" "product ALLIEDTELESIS LA_PCM\t0x0002 Allied Telesis LA-PCM\n" msgstr "" "/* Allied Telesis K.K. */\n" "product ALLIEDTELESIS LA_PCM\t0x0002 Allied Telesis LA-PCM\n" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:97 #, no-wrap msgid "" "/* Archos */\n" "product\tARCHOS ARC_ATAPI\t0x0043 MiniCD\n" msgstr "" "/* Archos */\n" "product\tARCHOS ARC_ATAPI\t0x0043 MiniCD\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:100 msgid "" "The `product` keyword is followed by the vendor name, repeated from above. " "This is followed by the product name, which is used by the driver and should " "be a valid C identifier, but may also start with a number. As with the " "vendors, the hex product ID for this card follows the same convention for " "`0xffffffff` and `0xffff`. Finally, there is a string description of the " "device itself. This string typically is not used in FreeBSD, since FreeBSD's " "pccard bus driver will construct a string from the human readable CIS " "entries, but it can be used in the rare cases where this is somehow " "insufficient. The products are in alphabetical order by manufacturer, then " "numerical order by product ID. They have a C comment before each " "manufacturer's entries and there is a blank line between entries." msgstr "" "Ключевое слово `product` следует за именем производителя, повторяющимся " "сверху. После него идёт название продукта, которое используется драйвером и " "должно быть допустимым идентификатором в C, но также может начинаться с " "цифры. Как и в случае с производителями, шестнадцатеричный идентификатор " "продукта для этой карты следует тем же соглашениям для `0xffffffff` и " "`0xffff`. Наконец, идёт строковое описание самого устройства. Эта строка " "обычно не используется в FreeBSD, поскольку драйвер шины pccard в FreeBSD " "формирует строку из читаемых человеком записей CIS, но она может быть " "использована в редких случаях, когда этого недостаточно. Продукты " "перечислены в алфавитном порядке по производителю, затем в числовом порядке " "по идентификатору продукта. Перед записями каждого производителя есть " "комментарий в C, а между записями — пустая строка." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:102 msgid "" "The third section is like the previous vendor section, but with all of the " "manufacturer numeric IDs set to `-1`, meaning \"match anything found\" in " "the FreeBSD pccard bus code. Since these are C identifiers, their names must " "be unique. Otherwise the format is identical to the first section of the " "file." msgstr "" "Третий раздел аналогичен предыдущему разделу производителей, но все числовые " "идентификаторы производителей установлены в `-1`, что означает \"совпадение " "с любым найденным\" в коде шины pccard FreeBSD. Поскольку это идентификаторы " "C, их имена должны быть уникальными. В остальном формат идентичен первому " "разделу файла." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:104 msgid "" "The final section contains the entries for those cards that must be " "identified by string entries. This section's format is a little different " "from the generic section:" msgstr "" "Последний раздел содержит записи для тех карт, которые должны быть " "идентифицированы по строковым значениям. Формат этого раздела немного " "отличается от общего раздела:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:109 #, no-wrap msgid "" "product ADDTRON AWP100\t\t{ \"Addtron\", \"AWP-100&spWireless&spPCMCIA\", \"Version&sp01.02\", NULL }\n" "product ALLIEDTELESIS WR211PCM\t{ \"Allied&spTelesis&spK.K.\", \"WR211PCM\", NULL, NULL } Allied Telesis WR211PCM\n" msgstr "" "product ADDTRON AWP100\t\t{ \"Addtron\", \"AWP-100&spWireless&spPCMCIA\", " "\"Version&sp01.02\", NULL }\n" "product ALLIEDTELESIS WR211PCM\t{ \"Allied&spTelesis&spK.K.\", \"WR211PCM\", " "NULL, NULL } Allied Telesis WR211PCM\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:112 msgid "" "The familiar `product` keyword is followed by the vendor name and the card " "name, just as in the second section of the file. Here the format deviates " "from that used earlier. There is a {} grouping, followed by a number of " "strings. These strings correspond to the vendor, product, and extra " "information that is defined in a CIS_INFO tuple. These strings are filtered " "by the program that generates [.filename]#pccarddevs.h# to replace &sp with " "a real space. NULL strings mean that the corresponding part of the entry " "should be ignored. The example shown here contains a bad entry. It should " "not contain the version number unless that is critical for the operation of " "the card. Sometimes vendors will have many different versions of the card in " "the field that all work, in which case that information only makes it harder " "for someone with a similar card to use it with FreeBSD. Sometimes it is " "necessary when a vendor wishes to sell many different parts under the same " "brand due to market considerations (availability, price, and so forth). Then " "it can be critical to disambiguating the card in those rare cases where the " "vendor kept the same manufacturer/product pair. Regular expression matching " "is not available at this time." msgstr "" "Знакомое ключевое слово `product` сопровождается названием производителя и " "именем карты, как и во втором разделе файла. Здесь формат отличается от " "использованного ранее. Идёт группировка {}, за которой следует несколько " "строк. Эти строки соответствуют производителю, продукту и дополнительной " "информации, определённой в кортеже CIS_INFO. Эти строки фильтруются " "программой, которая генерирует [.filename]#pccarddevs.h#, чтобы заменить &sp " "на реальный пробел. Строки NULL означают, что соответствующую часть записи " "следует игнорировать. В приведённом здесь примере есть некорректная запись. " "Она не должна содержать номер версии, если только он не критичен для работы " "карты. Иногда у производителей может быть множество различных версий карты в " "обращении, которые все работают, и в таком случае эта информация только " "затрудняет использование аналогичной карты с FreeBSD. Иногда это необходимо, " "когда производитель хочет продавать множество различных компонентов под " "одним брендом из-за рыночных соображений (доступность, цена и т. д.). Тогда " "это может быть критично для различения карты в тех редких случаях, когда " "производитель сохранил ту же пару производитель/продукт. На данный момент " "использование регулярных выражений для сопоставления недоступно." #. type: Title === #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:114 #, no-wrap msgid "Sample Probe Routine" msgstr "Пример процедуры обнаружения" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:117 msgid "" "To understand how to add a device to the list of supported devices, one must " "understand the probe and/or match routines that many drivers have. It is " "complicated a little in FreeBSD 5.x because there is a compatibility layer " "for OLDCARD present as well. Since only the window-dressing is different, an " "idealized version will be presented here." msgstr "" "Чтобы понять, как добавить устройство в список поддерживаемых, необходимо " "разобраться в процедурах `probe` (обнаружение) и/или `match` (сопоставление)" ", которые есть во многих драйверах. В FreeBSD 5.x это немного сложнее из-за " "наличия слоя совместимости с OLDCARD. Поскольку различия лишь косметические, " "здесь будет представлена идеализированная версия." #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:127 #, no-wrap msgid "" "static const struct pccard_product wi_pccard_products[] = {\n" "\tPCMCIA_CARD(3COM, 3CRWE737A, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_PCM_S11, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_CF_S11G, 0),\n" "\tPCMCIA_CARD(TDK, LAK_CD011WL, 0),\n" "\t{ NULL }\n" "};\n" msgstr "" "static const struct pccard_product wi_pccard_products[] = {\n" "\tPCMCIA_CARD(3COM, 3CRWE737A, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_PCM_S11, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_CF_S11G, 0),\n" "\tPCMCIA_CARD(TDK, LAK_CD011WL, 0),\n" "\t{ NULL }\n" "};\n" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:133 #, no-wrap msgid "" "static int\n" "wi_pccard_probe(dev)\n" "\tdevice_t\tdev;\n" "{\n" "\tconst struct pccard_product *pp;\n" msgstr "" "static int\n" "wi_pccard_probe(dev)\n" "\tdevice_t\tdev;\n" "{\n" "\tconst struct pccard_product *pp;\n" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:142 #, no-wrap msgid "" "\tif ((pp = pccard_product_lookup(dev, wi_pccard_products,\n" "\t sizeof(wi_pccard_products[0]), NULL)) != NULL) {\n" "\t\tif (pp->pp_name != NULL)\n" "\t\t\tdevice_set_desc(dev, pp->pp_name);\n" "\t\treturn (0);\n" "\t}\n" "\treturn (ENXIO);\n" "}\n" msgstr "" "\tif ((pp = pccard_product_lookup(dev, wi_pccard_products,\n" "\t sizeof(wi_pccard_products[0]), NULL)) != NULL) {\n" "\t\tif (pp->pp_name != NULL)\n" "\t\t\tdevice_set_desc(dev, pp->pp_name);\n" "\t\treturn (0);\n" "\t}\n" "\treturn (ENXIO);\n" "}\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:145 msgid "" "Here we have a simple pccard probe routine that matches a few devices. As " "stated above, the name may vary (if it is not `foo_pccard_probe()` it will " "be `foo_pccard_match()`). The function `pccard_product_lookup()` is a " "generalized function that walks the table and returns a pointer to the first " "entry that it matches. Some drivers may use this mechanism to convey " "additional information about some cards to the rest of the driver, so there " "may be some variance in the table. The only requirement is that each row of " "the table must have a `struct pccard_product` as the first element." msgstr "" "Вот простая процедура проверки pccard, которая соответствует нескольким " "устройствам. Как упоминалось выше, название может отличаться (если это не " "`foo_pccard_probe()`, то это будет `foo_pccard_match()`). Функция " "`pccard_product_lookup()` является обобщенной функцией, которая проходит по " "таблице и возвращает указатель на первую запись, которой соответствует. " "Некоторые драйверы могут использовать этот механизм для передачи " "дополнительной информации о некоторых картах остальной части драйвера, " "поэтому в таблице могут быть вариации. Единственное требование — каждая " "строка таблицы должна содержать `struct pccard_product` в качестве первого " "элемента." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:147 msgid "" "Looking at the table `wi_pccard_products`, one notices that all the entries " "are of the form `PCMCIA_CARD(_foo_, _bar_, _baz_)`. The _foo_ part is the " "manufacturer ID from [.filename]#pccarddevs#. The _bar_ part is the product " "ID. _baz_ is the expected function number for this card. Many pccards can " "have multiple functions, and some way to disambiguate function 1 from " "function 0 is needed. You may see `PCMCIA_CARD_D`, which includes the device " "description from [.filename]#pccarddevs#. You may also see `PCMCIA_CARD2` " "and `PCMCIA_CARD2_D` which are used when you need to match both CIS strings " "and manufacturer numbers, in the \"use the default description\" and \"take " "the description from pccarddevs\" flavors." msgstr "" "Рассматривая таблицу `wi_pccard_products`, можно заметить, что все записи " "имеют вид `PCMCIA_CARD(_foo_, _bar_, _baz_)`. Часть _foo_ — это " "идентификатор производителя из [.filename]#pccarddevs#. Часть _bar_ — это " "идентификатор продукта. _baz_ — ожидаемый номер функции для этой карты. " "Многие pccard-устройства могут иметь несколько функций, поэтому требуется " "способ различать функцию 1 и функцию 0. Вы можете встретить `PCMCIA_CARD_D`, " "который включает описание устройства из [.filename]#pccarddevs#. Также могут " "встречаться `PCMCIA_CARD2` и `PCMCIA_CARD2_D`, которые используются, когда " "необходимо сопоставить как строки CIS, так и номера производителей, в " "вариантах «использовать описание по умолчанию» и «взять описание из " "pccarddevs»." #. type: Title === #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:149 #, no-wrap msgid "Putting it All Together" msgstr "Собираем все вместе" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:152 msgid "" "To add a new device, one must first obtain the identification information " "from the device. The easiest way to do this is to insert the device into a " "PC Card or CF slot and issue `devinfo -v`. Sample output:" msgstr "" "Для добавления нового устройства необходимо сначала получить " "идентификационную информацию от устройства. Проще всего это сделать, вставив " "устройство в слот PC Card или CF и выполнив команду `devinfo -v`. Пример " "вывода:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:159 #, no-wrap msgid "" " cbb1 pnpinfo vendor=0x104c device=0xac51 subvendor=0x1265 subdevice=0x0300 class=0x060700 at slot=10 function=1\n" " cardbus1\n" " pccard1\n" " unknown pnpinfo manufacturer=0x026f product=0x030c cisvendor=\"BUFFALO\" cisproduct=\"WLI2-CF-S11\" function_type=6 at function=0\n" msgstr "" " cbb1 pnpinfo vendor=0x104c device=0xac51 subvendor=0x1265 " "subdevice=0x0300 class=0x060700 at slot=10 function=1\n" " cardbus1\n" " pccard1\n" " unknown pnpinfo manufacturer=0x026f product=0x030c cisvendor=" "\"BUFFALO\" cisproduct=\"WLI2-CF-S11\" function_type=6 at function=0\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:162 msgid "" "`manufacturer` and `product` are the numeric IDs for this product, while " "`cisvendor` and `cisproduct` are the product description strings from the " "CIS." msgstr "" "`manufacturer` и `product` являются числовыми идентификаторами данного " "продукта, в то время как `cisvendor` и `cisproduct` представляют собой " "строки описания продукта из CIS." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:164 msgid "" "Since we first want to prefer the numeric option, first try to construct an " "entry based on that. The above card has been slightly fictionalized for the " "purpose of this example. The vendor is BUFFALO, which we see already has an " "entry:" msgstr "" "Поскольку мы сначала хотим предпочесть числовой вариант, попробуем сначала " "создать запись на его основе. Приведённая выше карта была слегка изменена " "для целей данного примера. Производитель — BUFFALO, у которого, как мы " "видим, уже есть запись:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:168 #, no-wrap msgid "vendor BUFFALO\t\t\t0x026f\tBUFFALO (Melco Corporation)\n" msgstr "vendor BUFFALO\t\t\t0x026f\tBUFFALO (Melco Corporation)\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:171 msgid "But there is no entry for this particular card. Instead we find:" msgstr "Но нет записи для этой конкретной карты. Вместо этого мы видим:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:179 #, no-wrap msgid "" "/* BUFFALO */\n" "product BUFFALO WLI_PCM_S11\t0x0305\tBUFFALO AirStation 11Mbps WLAN\n" "product BUFFALO LPC_CF_CLT\t0x0307\tBUFFALO LPC-CF-CLT\n" "product\tBUFFALO\tLPC3_CLT\t0x030a\tBUFFALO LPC3-CLT Ethernet Adapter\n" "product BUFFALO WLI_CF_S11G\t0x030b\tBUFFALO AirStation 11Mbps CF WLAN\n" msgstr "" "/* BUFFALO */\n" "product BUFFALO WLI_PCM_S11\t0x0305\tBUFFALO AirStation 11Mbps WLAN\n" "product BUFFALO LPC_CF_CLT\t0x0307\tBUFFALO LPC-CF-CLT\n" "product\tBUFFALO\tLPC3_CLT\t0x030a\tBUFFALO LPC3-CLT Ethernet Adapter\n" "product BUFFALO WLI_CF_S11G\t0x030b\tBUFFALO AirStation 11Mbps CF WLAN\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:182 msgid "" "To add the device, we can just add this entry to [.filename]#pccarddevs#:" msgstr "" "Чтобы добавить устройство, мы можем просто добавить эту запись в [." "filename]#pccarddevs#:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:186 #, no-wrap msgid "product BUFFALO WLI2_CF_S11G\t0x030c\tBUFFALO AirStation ultra 802.11b CF\n" msgstr "" "product BUFFALO WLI2_CF_S11G\t0x030c\tBUFFALO AirStation ultra 802.11b CF\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:189 msgid "" "Once these steps are complete, the card can be added to the driver. That is " "a simple operation of adding one line:" msgstr "" "После выполнения этих шагов карту можно добавить в драйвер. Это простая " "операция добавления одной строки:" #. type: delimited block . 4 #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:200 #, no-wrap msgid "" "static const struct pccard_product wi_pccard_products[] = {\n" "\tPCMCIA_CARD(3COM, 3CRWE737A, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_PCM_S11, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_CF_S11G, 0),\n" "+\tPCMCIA_CARD(BUFFALO, WLI_CF2_S11G, 0),\n" "\tPCMCIA_CARD(TDK, LAK_CD011WL, 0),\n" "\t{ NULL }\n" "};\n" msgstr "" "static const struct pccard_product wi_pccard_products[] = {\n" "\tPCMCIA_CARD(3COM, 3CRWE737A, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_PCM_S11, 0),\n" "\tPCMCIA_CARD(BUFFALO, WLI_CF_S11G, 0),\n" "+\tPCMCIA_CARD(BUFFALO, WLI_CF2_S11G, 0),\n" "\tPCMCIA_CARD(TDK, LAK_CD011WL, 0),\n" "\t{ NULL }\n" "};\n" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:203 msgid "" "Note that I have included a '`+`' in the line before the line that I added, " "but that is simply to highlight the line. Do not add it to the actual " "driver. Once you have added the line, you can recompile your kernel or " "module and test it. If the device is recognized and works, please submit a " "patch. If it does not work, please figure out what is needed to make it work " "and submit a patch. If the device is not recognized at all, you have done " "something wrong and should recheck each step." msgstr "" "Обратите внимание, что я добавил символ '`+`' перед строкой, которую " "добавил, но это только для выделения строки. Не добавляйте его в реальный " "драйвер. После добавления строки вы можете пересобрать ядро или модуль и " "протестировать его. Если устройство распознано и работает, отправьте патч. " "Если оно не работает, определите, что необходимо для его работы, и отправьте " "патч. Если устройство не распознаётся вообще, вы где-то ошиблись и следует " "перепроверить каждый шаг." #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:205 msgid "" "If you are a FreeBSD src committer, and everything appears to be working, " "then you can commit the changes to the tree. However, there are some minor " "tricky things to be considered. [.filename]#pccarddevs# must be committed to " "the tree first. Then [.filename]#pccarddevs.h# must be regenerated and " "committed as a second step, ensuring that the right $FreeBSD$ tag is in the " "latter file. Finally, commit the additions to the driver." msgstr "" "Если вы коммиттер исходного кода FreeBSD, и всё работает корректно, то " "можете закоммитить изменения в дерево. Однако есть несколько небольших " "нюансов, которые следует учесть. [.filename]#pccarddevs# должен быть " "закоммичен в дерево первым. Затем [.filename]#pccarddevs.h# необходимо " "перегенерировать и закоммитить вторым шагом, убедившись, что правильный тег " "$FreeBSD$ присутствует в последнем файле. В конце закоммитьте добавления в " "драйвер." #. type: Title === #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:207 #, no-wrap msgid "Submitting a New Device" msgstr "Отправка кода для нового устройства" #. type: Plain text #: documentation/content/en/books/arch-handbook/pccard/_index.adoc:209 msgid "" "Please do not send entries for new devices to the author directly. Instead, " "submit them as a PR and send the author the PR number for his records. This " "ensures that entries are not lost. When submitting a PR, it is unnecessary " "to include the [.filename]#pccardevs.h# diffs in the patch, since those will " "be regenerated. It is necessary to include a description of the device, as " "well as the patches to the client driver. If you do not know the name, use " "OEM99 as the name, and the author will adjust OEM99 accordingly after " "investigation. Committers should not commit OEM99, but instead find the " "highest OEM entry and commit one more than that." msgstr "" "Пожалуйста, не отправляйте записи о новых устройствах автору напрямую. " "Вместо этого оформите их как PR и сообщите автору номер PR для учёта. Это " "гарантирует, что записи не будут потеряны. При отправке PR нет необходимости " "включать в патч diff-файлы [.filename]#pccardevs.h#, так как они будут " "перегенерированы. Однако необходимо включить описание устройства, а также " "патчи для клиентского драйвера. Если название устройства неизвестно, " "используйте имя OEM99, и автор скорректирует OEM99 после изучения. " "Коммиттеры не должны коммитить OEM99, а вместо этого найти наибольший OEM-" "номер и закоммитить на единицу больше."