Android 12'de bootconfig'i uygulama

Android 12'de bootconfig özelliği, Android 11 ve önceki sürümlerde kullanılan androidboot.* çekirdek cmdline seçeneklerinin yerini alır. Bootconfig özelliği, yapılandırma ayrıntılarını derleme ve önyükleyiciden Android 12'ye aktarmak için kullanılan bir mekanizmadır.

Bu özellik, Android kullanıcı alanı için yapılandırma parametrelerini çekirdek için olanlardan ayırmanın bir yolunu sunar. Uzun androidboot.* çekirdek parametrelerinin bootconfig dosyasına taşınması, çekirdek cmdline'da yer açar ve gelecekteki genişletmeler için kullanılabilir hale getirir.

Hem çekirdek hem de Android kullanıcı alanı bootconfig'yı desteklemelidir.

  • Bu desteğin sunulduğu ilk sürüm: Android 12
  • Bu desteğin eklendiği ilk çekirdek sürümü: 12-5.4.xx çekirdek

12-5.10.xx çekirdek sürümüyle piyasaya sürülen yeni cihazlar için bootconfig özelliğini uygulayın. Cihazları yükseltiyorsanız bu özelliği uygulamanız gerekmez.

Örnekler ve kaynak

Bu bölümdeki örnekleri ve kaynak kodunu incelerken bootconfig kodunun biçiminin, Android 11 ve önceki sürümlerde kullanılan çekirdek cmdline biçiminden yalnızca biraz farklı olduğunu unutmayın. Ancak kullanımınız açısından aşağıdaki fark önemlidir:

  • Parametreler boşluklarla değil, yeni satır kaçış sırasıyla \n ayrılmalıdır.

Bootloader örneği

Bootloader örneği için Cuttlefish U-boot referans bootloader uygulamasını inceleyin. Referanstaki iki onaylama aşağıda listelenmiştir. İlk yükseltme, önyükleme başlığı sürüm desteğini en yeni sürüme yükseltir. Örnekte, ilk commit, sürüm desteğini bir sonraki sürüme (v4) günceller (veya yükseltir). İkinci örnek iki işlem yapar: bootconfig işleme ekler ve parametrelerin çalışma zamanında nasıl ekleneceğini gösterir:

Örnek oluşturma

Tedarikçi önyükleme başlığı v4 ile vendor_boot.img oluşturmak için mkbootimg değişikliklerini gösteren bir derleme örneği için mkbootimg changes for bootconfig bölümüne bakın. Aşağıdaki işlemleri yapmak için Cuttlefish değişikliklerine bakın:

Uygulama

İş ortakları, önyükleyicilerine destek eklemeli ve derleme zamanı androidboot.* parametrelerini çekirdek komut satırından bootconfig dosyasına taşımalıdır. Bu değişikliği uygulamanın en iyi yolu bunu artımlı olarak yapmaktır. Artımlı bir süreci izleme hakkında bilgi için Artımlı uygulama ve doğrulama bölümüne bakın.

/proc/cmdline dosyasında androidboot.* parametrelerini arayan değişiklikleriniz varsa bunları bunun yerine /proc/bootconfig dosyasına yönlendirin. ro.boot.* Özellikleri, yeni bootconfig değerleriyle ayarlanır. Bu nedenle, bu özellikleri kullanan kodda değişiklik yapmanız gerekmez.

Derleme değişiklikleri

Öncelikle önyükleme başlığı sürümünüzü 4. sürüme yükseltin:

- BOARD_BOOT_HEADER_VERSION := 3

+ BOARD_BOOT_HEADER_VERSION := 4

bootconfig çekirdek cmdline parametresini ekleyin. Bu işlem, çekirdeğin bootconfig bölümünü aramasını sağlar:

BOARD_KERNEL_CMDLINE += bootconfig

bootconfig parametreleri, BOARD_BOOTCONFIG değişkenindeki parametrelerden oluşturulur. Bu işlem, kernel cmdline'ın BOARD\_KERNEL\_CMDLINE değişkeninden oluşturulmasına benzer.

Tüm androidboot.* parametreleri, aşağıdakine benzer şekilde olduğu gibi taşınabilir:

- BOARD_KERNEL_CMDLINE += androidboot..selinux=enforcing

+ BOARD_BOOTCONFIG += androidboot..selinux=enforcing

Bootloader değişiklikleri

Önyükleyici, çekirdeğe geçmeden önce initramfs'yı ayarlar. kernel boot configuration bootconfig bölümünü arar ve beklenen fragmanla birlikte initramfs,'ın en sonunda olmasını bekler.

Önyükleyici, vendor_boot.img düzen bilgilerini satıcı başlatma görüntüsü üstbilgisinden alır.

bootconfig bellek ayırma düzeninin diyagramı

Şekil 1. Android 12 bootconfig bellek ayırma

Önyükleyici, bellekte bootconfig bölümünü oluşturur. bootconfig bölümü, aşağıdakiler için bellek ayırmalarını içerir:

  • Parametreler
  • 4 B boyutu parameters size
  • 4 B boyutu parameters checksum
  • 12 B bootconfig sihirli dizesi (#BOOTCONFIG\n)

Parametreler iki kaynaktan gelir: Derleme sırasında bilinen parametreler ve derleme sırasında bilinmeyen parametreler. Bilinmeyen parametreler eklenmelidir.

Derleme süresinde bilinen parametreler, bootconfig bölümündeki vendor_boot resminin sonuna paketlenir. Bölümün boyutu, satıcı önyükleme üstbilgisi alanında vendor_bootconfig_size bayt olarak depolanır.

Derleme sırasında bilinmeyen parametreler yalnızca önyükleyicide çalışma zamanında bilinir. Bunlar, bootconfig fragmanı uygulanmadan önce bootconfig parametreleri bölümünün sonuna eklenmelidir.

Bootconfig fragmanı uygulandıktan sonra herhangi bir parametre eklemeniz gerekirse fragmanın üzerine yazın ve yeniden uygulayın.

Artımlı uygulama ve doğrulama

Bu bölümde verilen süreci izleyerek bootconfig özelliğini kademeli olarak uygulayın. bootconfig parametreleri eklenirken çekirdek cmdline parametrelerini değiştirmeyin.

bu özelliği kademeli olarak uygulamanızı önerir.

Doğrulama ile birlikte artımlı uygulama adımları şunlardır:

  1. Önyükleyiciyi oluşturun ve derleme değişikliklerini yapın, ardından aşağıdakileri uygulayın:
    1. Yeni bir bootconfig parametresi eklemek için BOARD_BOOTCONFIG değişkenini kullanın.
    2. Cihazın doğru şekilde önyüklenmeye devam edebilmesi için çekirdek cmdline parametrelerini olduğu gibi bırakın. Bu sayede hata ayıklama ve doğrulama çok daha kolay hale gelir.
  2. /proc/bootconfig içeriğini kontrol ederek çalışmanızı doğrulayın. Cihaz başlatıldıktan sonra yeni eklenen parametrenin göründüğünü doğrulayın.
  3. BOARD_BOOTCONFIG değişkenini ve önyükleyiciyi kullanarak androidboot.* parametrelerini çekirdek cmdline'dan bootconfig'e taşıyın.
  4. Parametrelerin her birinin /proc/bootconfig içinde bulunduğunu VE /proc/cmdline içinde olmadığını doğrulayın. Bunu doğrulayabiliyorsanız uygulamanız başarılı olmuştur.

OTA ile yükseltme ve düşürme işlemleriyle ilgili dikkat edilmesi gereken noktalar

Android'in farklı sürümleri veya farklı çekirdek sürümleri arasında OTA yükseltme ve düşürme işlemlerini yönetirken özel dikkat gösterilmelidir.

Android 12, bootconfig desteği sunan ilk sürümdür. Bu sürümden önceki bir sürüme düşürülüyorsa bootconfig yerine çekirdek cmdline parametreleri kullanılmalıdır.

12-5.4 ve sonraki çekirdek sürümlerinde bootconfig desteklenir. Bu sürümden önceki bir sürüme(11-5.4 dahil) düşürülüyorsa çekirdek cmdline parametreleri kullanılmalıdır.

Android 11 ve önceki sürümlerden Android 12 ve sonraki sürümlere yükseltme yapanlar, çekirdek cmdline parametrelerini kullanmaya devam edebilir. Aynı durum çekirdek sürümlerini yükseltmek için de geçerlidir.

Sorun giderme

Doğrulama adımını uyguladığınızda /proc/bootconfig içinde beklenen parametreleri görmüyorsanız logcat içindeki çekirdek günlüklerini kontrol edin. Çekirdek destekliyorsa bootconfig için her zaman bir günlük girişi bulunur.

Örnek günlük çıkışı

$ adb logcat | grep bootconfig
02-24 17:00:07.610     0     0 I Load bootconfig: 128 bytes 9 nodes

Hata günlüğü döndürülürse bootconfig yüklenirken bir sorun oluşmuştur. Farklı hata türlerini görmek için init/main.c dosyasını inceleyin.