From ea448b829ef3c5eefcadcd50fdf74c873eeadd86 Mon Sep 17 00:00:00 2001 From: Android Partner Docs Date: Wed, 8 Aug 2018 13:50:33 -0700 Subject: Docs: Changes to source.android.com - 207940242 One more fix: add header for Television Requirements. by Gina Dimino - 207936055 Update health README link. by Android Partner Docs - 207929938 Errata run for Android 9 CDD. by Gina Dimino - 207897850 Fix typos in Develop and Configure index pages by Kenneth Lau - 207813977 Devsite localized content from translation request 958913. by Android Partner Docs - 207813949 Devsite localized content from translation request 953118. by Android Partner Docs - 207813941 Devsite localized content from translation request 961934. by Android Partner Docs - 207813934 Devsite localized content from translation request 552632. by Android Partner Docs - 207813463 Update line numbers in links by Kenneth Lau - 207796341 Fixing the URL for the CDD link in versions file. by Gina Dimino - 207779392 Fix incorrect link by Kenneth Lau - 207777680 Update build numbers for 2018/08 releases by Android Partner Docs - 207775888 Update links to AOSP by Kenneth Lau - 207769948 Update links to AOSP by Kenneth Lau - 207763826 Clarify system for HIDL passthrough loading. by Android Partner Docs - 207733156 Fixing malformed links in html for kernel patches, adding... by Heidi von Markham - 207650104 Remove link by Heidi von Markham - 207640627 Tags for Android P. by Android Partner Docs - 207626815 Making link absolute by Clay Murphy - 207611166 Add Background Restrictions into Release Notes. by Christina Nguyen - 207606267 Fixing unclosed tag, reformatting for clarity by Heidi von Markham - 207604244 Fix malformed link by Clay Murphy - 207598416 adding subscript by Heidi von Markham - 207595049 Fix link in section 3.5.1. by Gina Dimino - 207590813 Fix broken link due to file path change by Christina Nguyen - 207588930 Update Power nav to include changes to mgmt page (broken ... by Christina Nguyen - 207588102 Separate out the Power Management article into "Applicati... by Christina Nguyen - 207583000 Fix broken links in HAL interface section by Kenneth Lau - 207582699 Put index files in place as redirects are not taking hold by Clay Murphy - 207575443 P release notes: fix bad links, remove "P release" by Mark Hecomovich - 207574657 Fix link typo from release notes to Carrier ID page by Christina Nguyen - 207559561 Integrate SAC next branch into mainline for Android P/9 p... by Mark Hecomovich - 207559252 Publish links to July localized versions within Japanese ... by Clay Murphy - 207122872 Devsite localized content from translation request 958912. by Android Partner Docs - 207122854 Devsite localized content from translation request 961384. by Android Partner Docs - 207007888 Add blurb about the SystemUpdateSampler app on SAC so use... by Christina Nguyen - 206862073 Update Camera HAL testing page by Kenneth Lau - 206805870 Devsite localized content from translation request 960240. by Android Partner Docs - 206805861 Devsite localized content from translation request 954945. by Android Partner Docs PiperOrigin-RevId: 207940242 Change-Id: I3dee204c744e2e6062ac56810b88aefabf84636a --- en/devices/architecture/kernel/android-common.html | 30 +- en/devices/architecture/kernel/config.html | 93 +++--- .../architecture/kernel/modular-kernels.html | 110 +++--- en/devices/architecture/kernel/releases.html | 2 +- .../architecture/kernel/reqs-interfaces.html | 368 ++++++++++++++++----- 5 files changed, 410 insertions(+), 193 deletions(-) (limited to 'en/devices/architecture/kernel') diff --git a/en/devices/architecture/kernel/android-common.html b/en/devices/architecture/kernel/android-common.html index 13175576..7348f6f7 100644 --- a/en/devices/architecture/kernel/android-common.html +++ b/en/devices/architecture/kernel/android-common.html @@ -45,29 +45,29 @@ paranoid networking). (shown below).

Figure 1. List of Android common -kernels.

+kernels

Differences from LTS

-

When compared to LTS (4.4.40), the Android common kernel has 679 changes, -56172 insertions, and 3340 deletions (as of February 2017).

+

When compared to LTS (4.14.0), the Android common kernel has 355 changes, +32266 insertions, and 1546 deletions (as of February 2018).

Figure 2. Android-specific code over -time.

+time

The largest features include:

    -
  • 13.8% SoC (arch/arm64, arch/x86)
    • -
  • 9.2% USB (drivers/usb)
    • -
  • 8.2% Energy Aware Scheduling (kernel/sched)
    • -
  • 8.2% Atomic Display Framework (drivers/video/adf)
    • -
  • 8.0% networking (net/netfilter)
    • -
  • 6.2% sdcardfs (fs/sdcardfs)
    • -
  • 5.0% Verity (drivers/md)
    • -
  • 3.7% Input (drivers/input/misc)
    • -
  • 3.3% FIQ Debugger (drivers/staging/android/fiq_debugger)
    • -
  • 2.4% Cpufreq (drivers/cpufreq)
    • -
  • 2.2% Goldfish Emulator (drivers/platform/goldfish)
    • +
  • 19.8% Energy Aware Scheduling (kernel/sched)
    • +
  • 13.8% Networking (net/netfilter)
    • +
  • 13.5% Sdcardfs (fs/sdcardfs)
    • +
  • 9.4% USB (drivers/usb)
    • +
  • 7.2% SoC (arch/arm64, arch/x86)
    • +
  • 6.2% f2fs (fs/f2fs -- backports from upstream)
    • +
  • 6.1% Input (drivers/input/misc)
    • +
  • 5.4% FIQ Debugger (drivers/staging/android/fiq_debugger)
    • +
  • 3.6% Goldfish Emulator (drivers/platform/goldfish)
    • +
  • 3.4% Verity (drivers/md)
    • +
  • 11.6% Other

Requirements

diff --git a/en/devices/architecture/kernel/config.html b/en/devices/architecture/kernel/config.html index afc36f82..49ae7e1d 100644 --- a/en/devices/architecture/kernel/config.html +++ b/en/devices/architecture/kernel/config.html @@ -41,7 +41,7 @@ features and are optional for devices.

These configuration files are located in the -kernel/configs +kernel/configs repo. Use the set of configuration files that corresponds to the version of the kernel you are using.

@@ -87,45 +87,42 @@ and x86_64.

Ensure that CONFIG_SECCOMP_FILTER=y is enabled in the Kconfig (verified as of the Android 5.0 CTS), then cherry-pick the following changes -from the AOSP kernel/common:android-3.10 repository: 9499cd23f9d05ba159fac6d55dc35a7f49f9ce76..a9ba4285aa5722a3b4d84888e78ba8adc0046b28 +from the AOSP kernel/common:android-3.10 repository: +9499cd23f9d05ba159fac6d55dc35a7f49f9ce76..a9ba4285aa5722a3b4d84888e78ba8adc0046b28

@@ -134,56 +131,54 @@ ARM: add seccomp syscall by Kees Cook (verified as of the Android 5.0 CTS), then cherry-pick the following changes from the AOSP kernel/common:android-3.10 repository:

diff --git a/en/devices/architecture/kernel/modular-kernels.html b/en/devices/architecture/kernel/modular-kernels.html index fd1d8706..c314a956 100644 --- a/en/devices/architecture/kernel/modular-kernels.html +++ b/en/devices/architecture/kernel/modular-kernels.html @@ -4,6 +4,7 @@ + {% include "_versions.html" %} -

In Android 8.0, the device kernel splits into System-on-Chip (SoC), device, +

In Android 8.0, the device kernel split into System-on-Chip (SoC), device, and board-specific deliverables. This sets up the kernel and Android such that Original Device Manufacturers (ODMs) and Original Equipment Manufacturers (OEMs) can work in isolated board–specific trees for board–specific features, drivers, @@ -32,8 +33,8 @@ the form of kernel modules, etc.

  • Platform support for independent SoC and OEM/ODM kernel development. Android -O recommends all board–specific code to be built and shipped as kernel modules -in devices. As a result: +{{ androidPVersionNumber }} recommends all board–specific code to be built and +shipped as kernel modules in devices. As a result:
    • All platforms should support either Device Tree or @@ -55,7 +56,7 @@ framework.

    Loadable kernel modules

    -

    All SoC kernels should support loadable kernel modules. As a starting point, +

    All SoC kernels must support loadable kernel modules. As a starting point, the following kernel-config options (or their kernel-version equivalent) have been added to android-base.cfg @@ -67,8 +68,7 @@ CONFIG_MODULE_UNLOAD=y CONFIG_MODVERSIONS=y -

    All kernel modules are subject to module load/unload testing to ensure the -correctness of the driver/module.

    +

    Kernel modules should support unloading and reloading whenever possible.