|author||Heng-Ruey Hsu <firstname.lastname@example.org>||Mon Jan 07 06:57:12 2019|
|committer||chrome-bot <email@example.com>||Tue Jan 08 16:26:28 2019|
usb_v1: Add power line frequency setting We also need to set power line frequency in HAL v1. BUG=b:121302062 TEST=manually set timezone and check power line frequency setting CQ-DEPEND=CL:1397443 Change-Id: Ic207d21cd9401f3928da862a57ecf5ac78249e2e Reviewed-on: https://chromium-review.googlesource.com/1396061 Commit-Ready: Heng-ruey Hsu <firstname.lastname@example.org> Tested-by: Heng-ruey Hsu <email@example.com> Reviewed-by: Shik Chen <firstname.lastname@example.org>
The repository hosts the core Chrome OS platform camera components, including:
The camera service provider on Chrome OS is a standalone process that can be divided into two part:
Currently we have two major camera clients on Chrome OS: Chrome browser and Android container. All the clients connect to the camera HAL adapter through the Camera Module Mojo IPC interface and the Camera Device Mojo IPC interface to access camera functions. The Mojo IPC interface is very similar to the Android camera HAL v3 APIs.
Usually the platform-specific camera HAL is accompanied with a proprietary camera 3A (auto focus, auto exposure, and auto white-balance) library that provides the algorithms to control the camera subsystem for capturing high quality images. We isolate the camera 3A library in a separated sandboxed process for security consideration. The camera HAL accesses the camera 3A library through the Camera Algorithm Mojo IPC interface.
The camera HAL needs to generate JPEG images when processing still shot requests. On Chrome OS the JPEG codec service, if supported on the platform, is provided by the GPU process in Chrome browser. We provide libraries to handle JPEG encoding and decoding: On platform that supports hardware-accelerated JPEG encoder/decoder, the JPEG libraries connect to the Chrome GPU process through Mojo IPC channels to encode/decode JPEG images; othewise the JPEG encoding/decoding is done through software.
The Chrome OS camera HAL are essentially the following shared libraries, plus and dependencies required by them:
camera_hal.sothat provides the camera HAL interface. This is very similar to a regular Android camera HAL. (Required)
libcam_algo.sothat provides the camera algorithm interface for the isolated camera 3A library. (Required if the camera HAL requires 3A library to work).
We provide the following packages that are required to build the camera HAL:
A package that installs all the necessary Android headers files required by the camera HAL.
Provides functions to access the isolated camera 3A library if the camera HAL requires it to work.
A replacement for Android gralloc. The library provides APIs to import and map buffer handles received in capture requests.
A port of the Android
A port of the Android
Provides functions to access camera V4L2 devices.
A port of the Android
In addition to the required packages, we also have some useful packages that can handle some general functions for the camera HAL:
Provides utility functions to fill in the EXIF headers of a JPEG image.
Provides utility functions to encode JPEG image.
Provides utility functions to get the local timezone.
To add a new camera HAL for a new platform, one needs to upload the source code of the camera HAL to the camera HAL directory.
After the camera HAL source code is uploaded, one needs to add corresponding packages to build and install the camera HAL and the required libraries. On Chrome OS, packages are managed by ebuild files. The following ebuild files are required for a new camera HAL:
A ebuild file for the newly added camera HAL. The ebuild file is used to build and install the platform specific camera HAL and the camera algorithm (
libcam_algo.so) shared libraries into the board sysroot. To integrate the camera HAL into the OS image, a
virtual/cros-camera-hal ebuild that includes the newly added camera HAL as
RDEPEND is required in the baseboard or board overlay.
For board-specific camera HAL config files, we have the
virtual/cros-camera-hal-configs ebuild. One can add a new ebuild to install the board-specific camera HAL config files, and list the new ebuild as
RDEPEND of the virtual ebuild.