diff --git a/Home.md b/Home.md index d66c030..f805327 100644 --- a/Home.md +++ b/Home.md @@ -1,20 +1,20 @@ -# Добро пожаловать на вики-сайт по драйверу FacetimeHD для Linux! -Этот репозиторий содержит драйвер Linux для веб-камер Apple FacetimeHD PCIe. +# Welcome to the FacetimeHD linux driver wiki! +This repository contains a Linux driver for the Apple FacetimeHD PCIe webcams. -## Установка -Инструкции по установке на ваш дистрибутив см. в разделе [Установка](https://github.com/patjak/bcwc_pcie/wiki/Installation). +## Installation +See [Installation](https://github.com/patjak/bcwc_pcie/wiki/Installation) for how to install on your distro -## Вопросы и обсуждения -Для драйвера нет списка рассылки, но некоторые обсуждения проходят на #facetimehd на irc.freenode.net. +## Issues and discussion +There is no mailing list for the driver but some discussions take place at #facetimehd on irc.freenode.net -Присоединяйтесь и задавайте свои вопросы, а также помогайте, отвечая на вопросы других пользователей. Сообщения о проблемах можно отправлять здесь, на GitHub, но убедитесь, что ваша проблема ещё не решена и/или не описана в разделе «Известные проблемы» ниже. +Feel free to join and ask your questions, or help out by answering other people. Issues can be reported here on github but please make sure your issue is not already answered and/or not covered in the "Known issues" section below. -## Текущий статус -Драйвер теперь может транслировать потоковое видео. Доступ к нему осуществляется через API V4L2. Эта функция пока экспериментальная, поэтому ваши впечатления могут отличаться. +## Current Status +The driver is now able to stream video. It can be accessed through the V4L2 API. It is still experimental so your mileage may vary. -Обратите внимание, что для этого модуля требуется **ядро Linux 4.4 или более поздней версии** (в настоящее время неизвестно, с какими более ранними ядрами он будет работать). - -По данным Apple, следующие модели оснащены HD-камерой Facetime и должны быть совместимы с этим драйвером: +Note that this module requires **Linux kernel 4.4 or later** (it is currently unknown which earlier kernels it will work with). + +According to Apple the following models contain a Facetime HD camera and should be compatible with this driver: * iMac (21,5", since mid 2011) * iMac (27", since mid 2011) @@ -24,18 +24,18 @@ * MacBook Pro (13", since early 2011) * Thunderbolt display -Инструкции по установке и использованию драйвера см. в разделе [Начало работы] (Начало работы). +See [Getting Started](Get-Started) for instructions on driver installation and usage. -Подтверждено Хамишем Макинтайром-Бхатти для работы на MacBook Pro (13 дюймов, конец 2013 г.). +Confirmed to work on MacBook Pro (13", Late 2013) by Hamish McIntyre-Bhatty. -# Известные проблемы -* Приостановка/возобновление работы не работает должным образом. Приостановку необходимо выполнять при закрытом устройстве. (См.: [обходные пути](#обходные пути)) -* С этим драйвером совместима только прошивка версии 1.43. Более новые версии также могут работать, но настоятельно рекомендуется версия 1.43. -* Из-за ошибки в cpio 2.11 скрипт загрузки прошивки не работает. Требуется cpio 2.12 или более поздняя версия. (См.: https://bugzilla.redhat.com/show_bug.cgi?id=1318084) -* Драйвер сообщит об отсутствии файлов 1871_01XX.dat (или файлов с похожим названием). Эту ошибку можно игнорировать. Файлы .dat содержат настройки калибровки сенсора, которые улучшат качество изображения. Ошибка выглядит примерно так: -```Прямая загрузка прошивки для facetimehd/1871_01XX.dat завершилась ошибкой -2```. Игнорируйте её. -* Устройство /dev/video0 не отображается после загрузки модуля. Это может быть связано с тем, что модуль bdc_pci уже загружен. Перед загрузкой модуля facetimehd убедитесь, что вы выгрузили или добавили bdc_pci в чёрный список: ```modprobe -r bdc_pci```. -* После установки и компиляции модулей может потребоваться перезагрузка, как это было на MacBook Pro (13", конец 2013 г.). +# Known issues +* Suspend / resume doesn't work properly. Suspending must be done with the device closed. (See: [workarounds](#workarounds)) +* Only firmware version 1.43 is known to work with the driver. Newer versions might also work but 1.43 is highly recommended. +* Due to a bug in cpio 2.11 the firmware download script doesn't work. cpio 2.12 or later is required. (See: https://bugzilla.redhat.com/show_bug.cgi?id=1318084) +* The driver will complain about 1871_01XX.dat (or similarly named) files missing. This error can be ignored. The .dat files contains sensor calibration settings that will improve image quality. The error looks something like this: +```Direct firmware load for facetimehd/1871_01XX.dat failed with error -2```. Ignore it. +* No /dev/video0 device appears after loading the module. This can be because the bdc_pci module is already loaded. Make sure you unload or blacklist bdc_pci before loading the facetimehd module: ```modprobe -r bdc_pci```. +* A reboot may be required after installing and compiling the modules, as was the case on a MacBook Pro (13", Late 2013). -# Обходные пути -* Вы можете использовать [facetimehd-toggle](https://github.com/Chamal1120/facetimehd-toggle) для переключения веб-камеры только при необходимости. Таким образом, драйвер будет выгружен, когда камера не используется, и режим ожидания/возобновления будет работать корректно. +# Workarounds +* You can use [facetimehd-toggle](https://github.com/Chamal1120/facetimehd-toggle) to toggle webcam only when needed. This way the driver will be unloaded when not in use and suspend/resume will work properly.