Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 188552e8 authored by Brian Duddie's avatar Brian Duddie
Browse files

contexthub: Expose CHRE version information 

Add chrePlatformId and chreVersion fields to context hub metadata
returned by getHubs(). This information will be used to make
compatibility decisions at runtime. Also, add a brief description of
CHRE to the IContexthub documentation to help clarify the
relationship between the HAL and these concepts in the CHRE API.

Bug: 31402693
Test: compile test only, this only adds fields to HIDL structures
Change-Id: Iea2436ccc23b47c4cf06040bebe1c550fe58ccb7
parent 0ebed38d

contexthub/1.0/IContexthub.hal

+7 −0
Original line number Diff line number Diff line
@@ -18,6 +18,13 @@ package android.hardware.contexthub@1.0; 


import IContexthubCallback;



/*

 * The Context Hub HAL provides an interface to a separate low-power processing

 * domain that has direct access to contextual information, such as sensors.

 * Native applications that run within a context hub are known as nanoapps, and

 * they execute within the Context Hub Runtime Environment (CHRE), which is

 * standardized via the CHRE API, defined elsewhere.

 */

interface IContexthub {

    /*

     * Enumerate all available context hubs on the system.

contexthub/1.0/types.hal

+16 −0
Original line number Diff line number Diff line
@@ -108,6 +108,22 @@ struct ContextHub { 


    uint32_t maxSupportedMsgLen;// This is the maximum size of the message that can

                                // be sent to the hub in one chunk (in bytes)



    // Machine-readable CHRE platform ID, returned to nanoapps in the CHRE API

    // function call chreGetPlatformId(). The most significant 5 bytes of this

    // value identify the vendor, while the remaining bytes are set by the

    // vendor to uniquely identify each different CHRE implementation/hardware

    // that the vendor supplies. This field pairs with the patch version part of

    // chreVersion to fully specify the CHRE implementation version. See also

    // the CHRE API header file chre/version.h.

    uint64_t chrePlatformId;



    // CHRE implementation version, returned to nanoApps in the CHRE API

    // function call chreGetVersion(). This value consists of the implemented

    // CHRE API version (major version in most significant byte, followed by

    // minor version), and the platform-specific implementation patch version

    // in the lower two bytes. See also the CHRE API header file chre/version.h.

    uint32_t chreVersion;

};



struct ContextHubMsg {