Eski HAL'ler

HAL, Android'in daha düşük seviyeli sürücü uygulamaları hakkında agnostik olmasını sağlayan donanım satıcılarının uygulaması için standart bir arayüz tanımlar. Bir HAL kullanmak, üst düzey sistemi etkilemeden veya değiştirmeden işlevselliği uygulamanıza olanak tanır. Bu sayfa, artık Android 8.0'dan itibaren desteklenmeyen eski mimariyi açıklamaktadır. Android 8.0 ve üstü için lütfen HAL Türlerine bakın.

Şekil 1. HAL bileşenleri

Ürününüzün sağladığı özel donanım için ilgili HAL'ı (ve sürücüyü) uygulamanız gerekir. HAL uygulamaları genellikle paylaşılan kitaplık modüllerinde ( .so dosyaları) yerleşiktir, ancak Android bir HAL uygulaması ile aygıt sürücüleri arasında standart bir etkileşimi zorunlu kılmadığından, durumunuza en uygun olanı yapabilirsiniz. Ancak, Android sisteminin donanımınızla doğru bir şekilde etkileşime girmesini sağlamak için, her donanıma özgü HAL arayüzünde tanımlanan sözleşmeye uymanız gerekir .

HAL'lerin öngörülebilir bir yapıya sahip olmasını garanti etmek için, her donanıma özgü HAL arabirimi, hardware/libhardware/include/hardware/hardware.h içinde tanımlanan özelliklere sahiptir. Bu arayüz, Android sisteminin HAL modüllerinizin doğru sürümlerini tutarlı bir şekilde yüklemesini sağlar. Bir HAL arayüzü iki bileşenden oluşur: modüller ve cihazlar.

HAL modülleri

Bir modül, paylaşılan bir kitaplık ( .so file ) olarak depolanan paketlenmiş HAL uygulamanızı temsil eder. hardware/libhardware/include/hardware/hardware.h başlık dosyası, bir modülü temsil eden ve modülün sürümü, adı ve yazarı gibi meta verileri içeren bir yapı ( hw_module_t ) tanımlar. Android, HAL modülünü doğru bir şekilde bulmak ve yüklemek için bu meta verileri kullanır.

Ek olarak, hw_module_t yapısı, modül için açık bir işleve yönelik bir gösterici içeren başka bir hw_module_methods_t , hw_module_methods_t bir gösterici içerir. Bu açık işlev, HAL'ın bir soyutlama olarak hizmet verdiği donanımla iletişimi başlatmak için kullanılır. Her donanıma özgü HAL, genellikle genel hw_module_t yapısını o belirli donanım parçası için ek bilgilerle genişletir. Örneğin, kamera camera_module_t , camera_module_t yapısı, diğer kameraya özel işlev işaretçileriyle birlikte bir hw_module_t yapısı içerir:

typedef struct camera_module {
    hw_module_t common;
    int (*get_number_of_cameras)(void);
    int (*get_camera_info)(int camera_id, struct camera_info *info);
} camera_module_t;

Bir HAL uyguladığınızda ve modül yapısını oluşturduğunuzda, onu HAL_MODULE_INFO_SYM adlandırmanız gerekir. Nexus 9 ses HAL'sinden örnek:

struct audio_module HAL_MODULE_INFO_SYM = {
    .common = {
        .tag = HARDWARE_MODULE_TAG,
        .module_api_version = AUDIO_MODULE_API_VERSION_0_1,
        .hal_api_version = HARDWARE_HAL_API_VERSION,
        .id = AUDIO_HARDWARE_MODULE_ID,
        .name = "NVIDIA Tegra Audio HAL",
        .author = "The Android Open Source Project",
        .methods = &hal_module_methods,
    },
};

HAL cihazları

Bir cihaz, ürününüzün donanımını özetler. Örneğin, bir ses modülü bir birincil ses cihazı, bir USB ses cihazı veya bir Bluetooth A2DP ses cihazı içerebilir.

Bir cihaz, hw_device_t yapısı ile temsil edilir. Bir modüle benzer şekilde, her cihaz türü, donanımın belirli özellikleri için işlev işaretçileri içeren genel hw_device_t ayrıntılı bir sürümünü tanımlar. Örneğin, audio_hw_device_t yapı türü, ses cihazı işlemlerine yönelik işlev işaretçileri içerir:

struct audio_hw_device {
    struct hw_device_t common;

    /**
     * used by audio flinger to enumerate what devices are supported by
     * each audio_hw_device implementation.
     *
     * Return value is a bitmask of 1 or more values of audio_devices_t
     */
    uint32_t (*get_supported_devices)(const struct audio_hw_device *dev);
  ...
};
typedef struct audio_hw_device audio_hw_device_t;

Bu standart özelliklere ek olarak, her donanıma özgü HAL arayüzü kendi özelliklerinden ve gereksinimlerinden daha fazlasını tanımlayabilir. Ayrıntılar için, HAL referans belgelerine ve her HAL için ayrı talimatlara bakın.

HAL modülleri oluşturma

HAL uygulamaları modüller ( .so ) dosyalarına yerleşiktir ve uygun olduğunda Android tarafından dinamik olarak bağlanır. HAL uygulamalarınızın her biri için Android.mk dosyaları oluşturarak ve kaynak dosyalarınızı işaret ederek modüllerinizi oluşturabilirsiniz. Genel olarak, paylaşılan kitaplıklarınızın düzgün bir şekilde bulunabilmesi ve yüklenebilmesi için belirli bir biçimde adlandırılması gerekir. Adlandırma şeması, modülden modüle biraz değişir, ancak şu genel kalıbı izler: <module_type>.<device_name> .