[agl-shell-activator] Decouple due to dependency on grpc - meta-agl

diff options

author	Jan-Simon Moeller <jsmoeller@linuxfoundation.org>	2023-02-17 23:08:04 +0100
committer	Jan-Simon Moeller <jsmoeller@linuxfoundation.org>	2023-02-27 11:02:42 +0000
commit	1cb8084a871a4cad7225f0c774536e72d4ed02b6 (patch)
tree	9af14ac3de1458d223da1cfb9459ba755596cdd1 /meta-agl-core/conf
parent	c431bbb2f0f5bf0c66d8473344db0aa26d834bfa (diff)

[agl-shell-activator] Decouple due to dependency on grpc

We also need to deal with DEPENDS and agl-shell-activator. The latter is a pure grpc implementation, thus move it to a dynamic layer. Bug-AGL: SPEC-4707 Change-Id: I308104b59333f69dfe416bd3721b11fb7e1b96c4 Signed-off-by: Jan-Simon Moeller <jsmoeller@linuxfoundation.org> Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/meta-agl/+/28513 Reviewed-by: Denys Dmytriyenko <denys@konsulko.com> Reviewed-by: Marius Vlad <marius.vlad@collabora.com> Tested-by: Jenkins Job builder account ci-image-build: Jenkins Job builder account ci-image-boot-test: Jenkins Job builder account

Diffstat (limited to 'meta-agl-core/conf')

0 files changed, 0 insertions, 0 deletions

/*------------------------------------------------------------------------------------------------*/ /* UNICENS V2.1.0-3491 */ /* Copyright (c) 2017 Microchip Technology Germany II GmbH & Co. KG. */ /* */ /* This program is free software: you can redistribute it and/or modify */ /* it under the terms of the GNU General Public License as published by */ /* the Free Software Foundation, either version 2 of the License, or */ /* (at your option) any later version. */ /* */ /* This program is distributed in the hope that it will be useful, */ /* but WITHOUT ANY WARRANTY; without even the implied warranty of */ /* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the */ /* GNU General Public License for more details. */ /* */ /* You should have received a copy of the GNU General Public License */ /* along with this program. If not, see <http://www.gnu.org/licenses/>. */ /* */ /* You may also obtain this software under a propriety license from Microchip. */ /* Please contact Microchip for further information. */ /*------------------------------------------------------------------------------------------------*/ /*! * \file * \brief Declaration of the low-level driver interface * * \addtogroup G_UCS_LLD * @{ * \details UNICENS provides a certain set of functions which are only dedicated to the low-level driver. * The low-level driver \em API is a set of functions which shall be used by the low-level driver. * The low-level driver \em callbacks is a set of function that shall be implemented by the low-level driver. * The low-level driver \em callbacks shall be assigned to the UNICENS initialization structure. * During initialization UNICENS invokes the callback \ref Ucs_Lld_Callbacks_t "start_fptr" and * passes the low-level driver \em API as pointer to \ref Ucs_Lld_Api_t. *  * @} */ #ifndef UCS_LLD_PB_H #define UCS_LLD_PB_H /*------------------------------------------------------------------------------------------------*/ /* Includes */ /*------------------------------------------------------------------------------------------------*/ #include "ucs_types_cfg.h" #include "ucs_memory_pb.h" #ifdef __cplusplus extern "C" { #endif /*! * \addtogroup G_UCS_LLD_TYPES * @{ */ /*------------------------------------------------------------------------------------------------*/ /* Structures */ /*------------------------------------------------------------------------------------------------*/ /*! \brief Tx message object providing the raw port message byte stream */ typedef struct Ucs_Lld_TxMsg_ { struct Ucs_Lld_TxMsg_ *custom_next_msg_ptr;/*!< \brief Shall be used by the LLD implementation to queue messages for * asynchronous transmission * \details UNICENS will set this value to \c NULL since only * single messages are forwarded to the LLD. Within the transmit function * it is recommended that the LLD queues the message for asynchronous * transmission. Despite a driver's transmit function might signal busy for * a short term the UNICENS library might forward multiple messages for * transmission. If a driver works asynchronously (interrupt driven) it * can easily use this pointer build a queue of waiting messages. * Nonetheless, it is important that \ref Ucs_Lld_Api_t::tx_release_fptr * "tx_release_fptr" is invoked for every message separately. The Interface * between the UNICENS library and the LLD does only support single messages. */ Ucs_Mem_Buffer_t *memory_ptr; /*!< \brief Points to the data buffer */ } Ucs_Lld_TxMsg_t; /*! \brief Rx message object pointing to the raw port message byte stream. */ typedef struct Ucs_Lld_RxMsg_ { uint8_t* data_ptr; /*!< \brief Points to a UNICENS allocated memory chunk. */ uint16_t data_size; /*!< \brief Size of the memory chunk in bytes. Valid values: 6..72. */ } Ucs_Lld_RxMsg_t; /*! * @} * \addtogroup G_UCS_LLD_API * @{ */ /*------------------------------------------------------------------------------------------------*/ /* Low-level driver API */ /*------------------------------------------------------------------------------------------------*/ /*! \brief Allocates an Rx message object * \param inst_ptr Reference to an internal UNICENS handler * \param buffer_size The size in bytes of the received Rx message. * Valid values: 6..72. * \return The Rx message object or \c NULL if no message object is available. In the latter * case the low-level driver can wait until Ucs_Lld_RxMsgAvailableCb_t() is invoked. * The low-level driver is allowed to pre-allocate Rx messages with the maximum size * of 72 bytes. After writing received data into Ucs_Lld_RxMsg_t::data_ptr the * low-level driver must set Ucs_Lld_RxMsg_t::data_size to the actual message size. * \warning * The function will also return \c NULL if the requested \c buffer_size exceeds the valid range. * In such a case the UNICENS cannot guarantee that Ucs_Lld_RxMsgAvailableCb_t() is * called as expected. Received messages exceeding the valid range must be discarded by the LLD. */ typedef Ucs_Lld_RxMsg_t* (*Ucs_Lld_RxAllocateCb_t)(void *inst_ptr, uint16_t buffer_size); /*! \brief Frees an unused Rx message object * \param inst_ptr Reference to internal UNICENS handler * \param msg_ptr Reference to the unused Rx message object */ typedef void (*Ucs_Lld_RxFreeUnusedCb_t)(void *inst_ptr, Ucs_Lld_RxMsg_t *msg_ptr); /*! \brief Pass an Rx message to UNICENS * \param inst_ptr Reference to internal UNICENS handler * \param msg_ptr Reference to the Rx message object containing the received * message. */ typedef void (*Ucs_Lld_RxReceiveCb_t)(void *inst_ptr, Ucs_Lld_RxMsg_t *msg_ptr); /*! \brief Notifies that the LLD no longer needs to access the Tx message object * \param inst_ptr Reference to internal UNICENS handler * \param msg_ptr Reference to the Tx message object which is no longer accessed * by the low-level driver */ typedef void (*Ucs_Lld_TxReleaseCb_t)(void *inst_ptr, Ucs_Lld_TxMsg_t *msg_ptr); /*! \brief Initialization required for one communication channel (control or packet) */ typedef struct Ucs_Lld_Api_ { Ucs_Lld_RxAllocateCb_t rx_allocate_fptr; /*!< \brief Allocates an Rx message object */ Ucs_Lld_RxFreeUnusedCb_t rx_free_unused_fptr; /*!< \brief Frees an unused Rx message object */ Ucs_Lld_RxReceiveCb_t rx_receive_fptr; /*!< \brief Pass an Rx message to the UNICENS library */ Ucs_Lld_TxReleaseCb_t tx_release_fptr; /*!< \brief Notifies that the LLD no longer needs to access the Tx message object */ } Ucs_Lld_Api_t; /*! * @} * \addtogroup G_UCS_LLD * @{ */ /*------------------------------------------------------------------------------------------------*/ /* LLD interface functions */ /*------------------------------------------------------------------------------------------------*/ /*! \brief Notifies the LLD to start transmitting and receiving messages * \param api_ptr Reference to UNICENS LLD interface * \param inst_ptr Reference to internal UNICENS handler * \param lld_user_ptr User defined pointer which is provided in \ref Ucs_Lld_Callbacks_t structure. */ typedef void (*Ucs_Lld_StartCb_t)(Ucs_Lld_Api_t* api_ptr, void *inst_ptr, void *lld_user_ptr); /*! \brief Notifies the LLD to stop/abort transmitting and receiving messages * \details As soon as this function is called the low-level driver is not allowed * to call any UNICENS API function. * \param lld_user_ptr User defined pointer which is provided in \ref Ucs_Lld_Callbacks_t structure. */ typedef void (*Ucs_Lld_StopCb_t)(void *lld_user_ptr); /*! \brief Notifies the LLD to reset the INIC * \details If this function is called the low-level driver is responsible to * perform an INIC hardware reset. * \param lld_user_ptr User defined pointer which is provided in \ref Ucs_Lld_Callbacks_t structure. */ typedef void (*Ucs_Lld_ResetInicCb_t)(void *lld_user_ptr); /*! \brief Callback function which is invoked as soon as port message objects are available again. * \details By implementing this callback function the low-level driver can avoid polling for * Rx message objects. The low-level driver should wait for the function call as soon * as Ucs_Lld_RxAllocateCb_t() returns NULL. Only then it shall call those functions again. * \param lld_user_ptr User defined pointer which is provided in \ref Ucs_Lld_Callbacks_t structure. */ typedef void (*Ucs_Lld_RxMsgAvailableCb_t)(void *lld_user_ptr); /*! \brief Callback function which is invoked to transmit a single message to the INIC * \param msg_ptr Reference to a single Tx message. * \param lld_user_ptr User defined pointer which is provided in \ref Ucs_Lld_Callbacks_t structure. */ typedef void (*Ucs_Lld_TxTransmitCb_t)(Ucs_Lld_TxMsg_t *msg_ptr, void *lld_user_ptr); /*! * @} * \addtogroup G_UCS_LLD_TYPES * @{ */ /*! \brief Set of functions implemented by the low-level driver */ typedef struct Ucs_Lld_Callbacks_ { void *lld_user_ptr; /*!< \brief Optional pointer that is passed when invoking a callback function which is assigned in Ucs_Lld_Callbacks_t. */ Ucs_Lld_StartCb_t start_fptr; /*!< \brief Callback function to initialize the low-level driver and * start the transmission and reception of messages */ Ucs_Lld_StopCb_t stop_fptr; /*!< \brief Callback function to stop/abort the transmission and reception of messages */ Ucs_Lld_RxMsgAvailableCb_t rx_available_fptr; /*!< \brief Callback function which is invoked as soon as Rx message objects are available again */ Ucs_Lld_TxTransmitCb_t tx_transmit_fptr; /*!< \brief Callback function to transmit one or multiple messages to the INIC */ } Ucs_Lld_Callbacks_t; /*! @} */ #ifdef __cplusplus } /* extern "C" */ #endif #endif /* #ifndef UCS_LLD_PB_H */ /*------------------------------------------------------------------------------------------------*/ /* End of file */ /*------------------------------------------------------------------------------------------------*/


context:
space:
mode: