diff --git a/site/docs/maintain/porting.uk.md b/site/docs/maintain/porting.uk.md new file mode 100644 index 0000000..0b9f5ad --- /dev/null +++ b/site/docs/maintain/porting.uk.md @@ -0,0 +1,141 @@ +--- +title: Керівництво перенесення +... + +Це керівнитво передбачається для тих, хто має дуже низький рівень знань про прошивку +загалом та coreboot окремо. +Більшість плат в coreboot може бути доволі легко перенесена в libreboot. +Ви не потребуєте ніяких знань окремої мови програмування або +технології загалом для перенесення плати. +Якщо ви бажаєте зробити більш суттєві внески до системи побудови, +будь ласка прочитайте [головну сторінку обслуговування.](/docs/maintain/index.html) + +Ви точно будете потребувати обладнання для прошивки, якщо ви бажаєте проходити +це керівництво. Дивіться [керівництво прошивки](/docs/install/spi.html) для +винайдення того, що вам буде потрібно. + +Coreboot це прошивка для заміни для чіпів прошивки на друкованих +платах (PCB) машини під питанням. +Libreboot є *дистрибутивом* Coreboot. +Ви можливо звикли посилатись до вашої машини як *машина, пристрій, ноутбук* +або його ім'я (наприклад: thinkpad t420). +Тому що наша ціль чіпи на PCB, ми посилаємося до всіх вище термінів синонімічно +як `плата.` +Залишок цієї статті буде посилатись до плати, яку ви бажаєте перенести до +libreboot як `плата.` + +Якщо `плата` не підтримується в coreboot, тоді ви маєте почати там спочатку. +Розробники Libreboot зазвичайно не будуть переносити нові плати в coreboot за запитом. +Якщо ви не впевнені про те, чи ваша плата в coreboot, перевірте [таблицю апаратного забезпечення coreboot.](https://coreboot.org/status/board-status.html) + +Якщо ви визначили, що `плата` підтримується coreboot, але не +підтримується libreboot, тоді проходьте залишок цього керівництво для спроби +перенести її самостійно. Як ви досі не можете перенести плату, або щось в цьому +керівництві не зрозуміло, тоді зв'яжіться з розробниками libreboot. +Найкращий шлях вийти на зв'язок через [irc libreboot.](/contact.uk.html#кімната-irc) + +Клонування lbmk +============ + +Перед тим, як ви спробуєте зробити будь-яку роботу, вам потрібно буде клонувати проект lbmk (libreboot make). +Щоб зробити це, ви будете потребувати git, встановлений на вашій машині. Ви можете потім клонувати +проект. + + git clone https://codeberg.org/libreboot/lbmk + +Якщо ви хочете більше інформації про побудову lbmk, дивіться [інструкції побудови.](/docs/build/index.uk.html) + +Конфігурація Coreboot +=============== + +Корисні навантаження Coreboot (GRUB, Seabios, і так далі) будуються окремо. +Ви таким чином тільки потребуєте фокусуватись на конфігурації(ях) coreboot для `плати.` +Всі з цих конфігурацій зберігаються під resources/coreboot/`плата` + +Найпростіший шлях почати нову конфігурацію для даної плати це копіювати існуючу +конфігурацію і зробити потрібні модифікації. +Наприклад, якщо хтось хотів би перенести t420s, тоді конфігурація t420 була би відмінною +початковою точкою. + + cp -r resources/coreboot/t420_12mb/ resources/coreboot/t420s_12mb + +Ви можете потім легко модифікувати існуючі конфігурації coreboot для вашої плати через lbmk. + + ./modify coreboot configs t420s_12mb + +Цей сценарій надать інтерфейс curses, через який ви можете легко модифікувати +потрібні змінні та налаштування. +Найбліьш важлива річ - це змінити `Материнську плату (Mainboard).` +Ви мусити переконатись, що визначення материнської плати в цій конфігурації відповідає `платі.` +Наприклад, ви би хотіли змінити lenovo/t420 на lenovo/t420s. +Вибір `exit` в інтерфейсі curses виведе вам пропозицію зберегти ваші +зміни, переконайтесь, щоб відповідь так (yes). +Зробіть примітку, що ви загалом мусите пройти через цей процес двічі, оскільки існує +конфігурація corebootfb та txtmode для кожної плати (сценарій впорається з цим для вас). + +Тепер ви можете побудувати та випробувати rom для `плати.` +Як тільки ви завершили це, ви можете спробувати прошивку отриманого rom на вашу плату в якості випробування. + + ./build boot roms t420s_12mb + +Якщо ви пробуєте прошити цей rom і це провалюється, тоді існує дві можливих причини: + +1) Розмір CBFS або розмір ROM неправильний +2) Блоби є несумісними + +Рішення до цих проблем ідуть в наступних розділах. + +Неправильний розмір CBFS та/або розмір ROM +========================== + +Різні плати мають різні налаштування чіпів флеш-пам'яті. +Загалом, ви маєте один або два флеш-пам'яті з сумарним розміром в 4-16Мбайт. +На щастя, flashrom дасть вам знати розмір флеш-чіпа, який ви прошиваєте. +Наприклад: коли прошиваєте X230, ви побачите, що один чіп 8192, та інший 4096. +Сумарний розмір rom тоді має бути встановлено на 12Мбайт. + +Розмір CBFS залежить безпосередньо від розміру флеш-чіпа, який обрано. +Переконайтесь, що ваш розмір CBFS не більше, ніж максимум для вашої плати. +Розміри CBFS зазначено в hex значеннях, ось таблиця, яка показує правильні максимуми +для різноманітних розмірів rom. + +| Розмір ROM | Розмір CBFS | +|:----------:|:-----------:| +| 8Мбайт | 0x7E0000 | +| 12Мбайт | 0xBE0000 | +| 16Мбайт | 0xFE0000 | + +Отримання блобів +=============== + +Найпростіший шлях побачити те, чи ваша конфігурація coreboot є дійсною - це +витягнути потрібні бінарні блоби з резервної копії rom вашого постачальника. +Вам буде потрібно уніфікований rom для налаштувань з подвійнь з подвійним чіпом; дивіться [керівництво ivybridge haswell](/docs/install/ivy_has_common.uk.html) +для інструкцій про створення уніфікованого образу rom. + +Витягнення блобів з образа rom постачальника автоматизовано в lbmk. +Просто виконайте `./blobutil extract [плата] [/path/to/backup.bin]` +Наприклад: + + ./blobutil extract t420s_12mb t420s_backup.bin + +Ви можете потім модифікувати ваші конфігурації coreboot знову та встановити шлях для +intel firmware descriptor, intel management engine, та прошивки gigabit ethernet. + +Отримання допомоги +============ + +Коли ви спробували все вищенаведене, ви могли би знайти, що ця плата досі не +працює. +Якщо це той випадок, тоді вам варто зв'язатися з розробниками libreboot для більшої допомоги. +Ви можете ping `shmalebx9` та/або `leah` на irc або відкрити проблемне питання на git. +В обох випадках, переконайтеся, що включено деталізований опис всього, що ви +спробували, і що точно сталося, коли ви спробували прошити rom. +Якщо ваша плата не підтримується в libreboot, тоді ви можете передбачати, що наші +розробники не мають її. +Тоді від вас будуть очікувати випробувати образи, створені розробниками libreboot +на вашій власній машині. + +До того часу, ви можете завжди прошити зовнішньо резервну копію rom вашого +постачальника, щоб тримати вашу машину в працюючому стані, поки розробка проходить +над вашою платою. diff --git a/site/news/e6400.uk.md b/site/news/e6400.uk.md index 7bbef8c..d0fdc30 100644 --- a/site/news/e6400.uk.md +++ b/site/news/e6400.uk.md @@ -23,7 +23,7 @@ E6400 та [сторінці інформації про апаратне заб не потрібна, та [мікрокод може бути видалено, якщо ви бажаєте](gm45microcode.md) (вам варто досі залишати мікрокод там, як за замовчуванням, але деякі люди видаляють його, з допомогою вибора, який ми даємо їм - дивіться: -[Політика Зменшення Більнарних Блобів](policy.uk.md)). +[Політика Зменшення Бінарних Блобів](policy.uk.md)). *Але почекайте.* Є більше. Набагато більше *цього*, так ось. diff --git a/site/news/hp8200sff.uk.md b/site/news/hp8200sff.uk.md index 3ec09ee..bf1153e 100644 --- a/site/news/hp8200sff.uk.md +++ b/site/news/hp8200sff.uk.md @@ -36,8 +36,8 @@ Coreboot має підтримку для тієї плати. Для *тієї* Якщо мій сценарій завантаження EC працює для Ріку, та працездатність підтримки 2560p підтверджується, коли Ріку випробує її, тоді обидва з них буде злито в гілку master Libreboot. Прошивка EC не на окремій інтегральній мікросхемі, для цієї -машини; натомість, вона має буде керована протягом процесу побудови coreboot, для -вставки в головну завантажувальний флеш-пам'ять. Це насправді *краще*, з подібних +машини; натомість, вона має буде керованою протягом процесу побудови coreboot, для +вставки в головну завантажувальну флеш-пам'ять. Це насправді *краще*, з подібних причин, як пояснено в [політиці зменшення блобів](policy.uk.md) Libreboot, тому що це робить прошивку EC легшою для заміни на вільний код (заснований на зворотній розробці, мабуть). @@ -58,9 +58,9 @@ Libreboot в певний момент буде підтримувати *всі Libreboot має наступну документацію в наявності: * [керівництво обслуговування lbmk](../docs/maintain/) (документація системи побудови) -* [керівництво перенесення](../docs/maintain/porting.md) (в основному Intel-центричне, на +* [керівництво перенесення](../docs/maintain/porting.uk.md) (в основному Intel-центричне, на момент написання цієї публікації) -Робота Ріку надихнуло читання їх. Самі керівництва також потребують +Роботу Ріку надихнуло читання їх. Самі керівництва також потребують постійного обслуговування та покращення, відповідного до змін в Libreboot.