diff options
Diffstat (limited to 'ucs2-lib/src/ucs_factory.c')
| -rw-r--r-- | ucs2-lib/src/ucs_factory.c | 830 |
1 files changed, 830 insertions, 0 deletions
diff --git a/ucs2-lib/src/ucs_factory.c b/ucs2-lib/src/ucs_factory.c new file mode 100644 index 0000000..978e6d9 --- /dev/null +++ b/ucs2-lib/src/ucs_factory.c @@ -0,0 +1,830 @@ +/*------------------------------------------------------------------------------------------------*/ +/* 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 Implementation of the MNS Factory. + * + * \cond UCS_INTERNAL_DOC + * \addtogroup G_FAC + * @{ + */ + +/*------------------------------------------------------------------------------------------------*/ +/* Includes */ +/*------------------------------------------------------------------------------------------------*/ +#include "ucs_factory.h" +#include "ucs_xrm_pv.h" + +/*------------------------------------------------------------------------------------------------*/ +/* Internal macros */ +/*------------------------------------------------------------------------------------------------*/ +#define IS_VALID_ADDR(addr) ((UCS_ADDR_LOCAL_DEV == (addr)) || ((0x0FU < (addr)) && (0x300U > (addr))) || ((0x04FFU < (addr)) && (0x0FF0U > (addr)))) /* parasoft-suppress MISRA2004-19_7 "common definition of type cast improves code" */ + +/*------------------------------------------------------------------------------------------------*/ +/* Internal prototypes */ +/*------------------------------------------------------------------------------------------------*/ +static void Fac_ConstructFbi (CFactory * self, CInic * fbi, uint16_t address); +static CInic * Fac_SearchFbi(CFactory * self, uint16_t address); +static void Fac_ConstructNsm (CFactory * self, CNodeScriptManagement * nsm, uint16_t address); +static CRemoteSyncManagement * Fac_SearchRsm(CFactory * self, uint16_t address); +static CExtendedResourceManager * Fac_SearchXrm(CFactory * self, uint16_t address); +static CGpio * Fac_SearchGpio(CFactory * self, uint16_t address); +static CI2c* Fac_SearchI2c(CFactory * self, uint16_t address); +static CNodeScriptManagement * Fac_SearchNsm(CFactory * self, uint16_t address); +static CInic * Fac_GetUninitializedFbi (CFactory * self); +static CNodeScriptManagement * Fac_GetUninitializedNsm (CFactory * self); +static CRemoteSyncManagement * Fac_GetUninitializedRsm (CFactory * self); +static CExtendedResourceManager * Fac_GetUninitializedXrm (CFactory * self); +static CGpio * Fac_GetUninitializedGpio (CFactory * self); +static CI2c * Fac_GetUninitializedI2c (CFactory * self); +static bool Fac_IsFbiUninitialized(CInic * fbi); +static bool Fac_IsRsmUninitialized(CRemoteSyncManagement * rsm); +static bool Fac_IsXrmUninitialized(CExtendedResourceManager * xrm); +static bool Fac_IsGpioUninitialized(CGpio * gpio); +static bool Fac_IsI2cUninitialized(CI2c * i2c); +static bool Fac_IsNsmUninitialized(CNodeScriptManagement * nsm); + +/*------------------------------------------------------------------------------------------------*/ +/* Implementation of class CFactory */ +/*------------------------------------------------------------------------------------------------*/ +/*! \brief Constructor of the MNS Factory class. + * \param self Instance pointer + * \param init_ptr init data_ptr + */ +void Fac_Ctor(CFactory * self, Fac_InitData_t * init_ptr) +{ + uint8_t i; + Rsm_InitData_t rsm_init_data; + + MISC_MEM_SET(self, 0, sizeof(CFactory)); + + /* set base and net instances */ + self->base_ptr = init_ptr->base_ptr; + self->net_ptr = init_ptr->net_ptr; + self->xrmp_ptr = init_ptr->xrmp_ptr; + self->icm_transceiver = init_ptr->icm_transceiver; + self->rcm_transceiver = init_ptr->rcm_transceiver; + + rsm_init_data.base_ptr = self->base_ptr; + rsm_init_data.net_ptr = self->net_ptr; + + for (i = 0U; i<FAC_NUM_DEVICES; i++) + { + rsm_init_data.inic_ptr = &self->fbi_list[i]; + Rsm_Ctor(&self->rsm_list[i], &rsm_init_data); + } +} + +/*------------------------------------------------------------------------------------------------*/ +/* Service */ +/*------------------------------------------------------------------------------------------------*/ +/*! \brief Returns the XRM instance associated with the given address. + * \param self Instance pointer + * \param address Address of the device associated with the instance + * \param res_debugging_fptr The resources debugging callback function + * \param check_unmute_fptr The check unmute callback function + * \return a reference to a XRM instance or \c NULL if no appropriate instance has been found. + */ +CExtendedResourceManager * Fac_GetXrm(CFactory * self, uint16_t address, Ucs_Xrm_ResourceDebugCb_t res_debugging_fptr, Ucs_Xrm_CheckUnmuteCb_t check_unmute_fptr) +{ + CRemoteSyncManagement * rsm_inst = NULL; + CExtendedResourceManager * xrm_inst = NULL; + + if (IS_VALID_ADDR(address)) + { + xrm_inst = Fac_SearchXrm(self, address); + if (xrm_inst == NULL) + { + rsm_inst = Fac_GetRsm(self, address); + if (rsm_inst != NULL) + { + Xrm_InitData_t xrm_init_data; + xrm_inst = Fac_GetUninitializedXrm(self); + if (xrm_inst != NULL) + { + xrm_init_data.base_ptr = self->base_ptr; + xrm_init_data.net_ptr = self->net_ptr; + xrm_init_data.rsm_ptr = rsm_inst; + xrm_init_data.inic_ptr = rsm_inst->inic_ptr; + xrm_init_data.xrmp_ptr = self->xrmp_ptr; + xrm_init_data.check_unmute_fptr = check_unmute_fptr; + xrm_init_data.res_debugging_fptr = res_debugging_fptr; + Xrm_Ctor(xrm_inst, &xrm_init_data); + } + } + } + Xrm_SetResourceDebugCbFn(xrm_inst, res_debugging_fptr); + } + + return xrm_inst; +} + +/*! \brief Returns the XRM instance associated with the given address. + * \param self Instance pointer + * \param address Address of the device associated with the instance + * \param check_unmute_fptr The check unmute callback function + * \return a reference to a XRM instance or \c NULL if no appropriate instance has been found. + */ +CExtendedResourceManager * Fac_GetXrmLegacy(CFactory * self, uint16_t address, Ucs_Xrm_CheckUnmuteCb_t check_unmute_fptr) +{ + return Fac_GetXrm(self, address, NULL, check_unmute_fptr); +} + + +/*! \brief Returns the XRM instance associated with the resource list. + * \note <b>This function should only be used in case of Ucs_Xrm_Destroy() since it's certain in that case that the XRM instance for the given job list already exists!</b> + * \param self Instance pointer + * \param resource_object_list Reference to the job list + * \return a reference to a XRM instance or \c NULL if no appropriate instance has been found. + */ +CExtendedResourceManager * Fac_GetXrmByJobList(CFactory * self, UCS_XRM_CONST Ucs_Xrm_ResObject_t *resource_object_list[]) +{ + uint8_t i; + CExtendedResourceManager * ret_xrm = NULL; + + for(i=0U; i<FAC_NUM_DEVICES; i++) + { + if (Xrm_IsInMyJobList(&self->xrm_list[i], resource_object_list)) + { + ret_xrm = &self->xrm_list[i]; + break; + } + } + + return ret_xrm; +} + +/*! \brief Returns the FBlock INIC instance associated with the given address. + * \param self Instance pointer + * \param address Address of the device associated with the instance + * \return a reference to a FBI instance or \c NULL if no suitable instance has been found. + */ +CInic * Fac_GetInic(CFactory * self, uint16_t address) +{ + CInic * fbi_inst = NULL; + + if (IS_VALID_ADDR(address)) + { + fbi_inst = Fac_SearchFbi(self, address); + if (fbi_inst == NULL) + { + fbi_inst = Fac_GetUninitializedFbi(self); + if (fbi_inst != NULL) + { + Fac_ConstructFbi(self, fbi_inst, address); + } + } + } + + return fbi_inst; +} + +/*! \brief Returns the CNodeScriptManagement instance associated with the given address. + * \param self Instance pointer + * \param address Address of the device associated with the instance + * \return a reference to a FBI instance or \c NULL if no suitable instance has been found. + */ +CNodeScriptManagement * Fac_GetNsm(CFactory * self, uint16_t address) +{ + CNodeScriptManagement * nsm_inst = NULL; + + if (IS_VALID_ADDR(address)) + { + nsm_inst = Fac_SearchNsm(self, address); + if (nsm_inst == NULL) + { + nsm_inst = Fac_GetUninitializedNsm(self); + if (nsm_inst != NULL) + { + Fac_ConstructNsm(self, nsm_inst, address); + } + } + } + + return nsm_inst; +} + +/*! \brief Returns the RSM instance associated with the given address. + * \param self Instance pointer + * \param address Address of the device associated with the instance + * \return a reference to a RSM instance or \c NULL if no suitable instance has been found. + */ +CRemoteSyncManagement * Fac_GetRsm(CFactory * self, uint16_t address) +{ + CRemoteSyncManagement * rsm_inst = NULL; + + if (IS_VALID_ADDR(address)) + { + rsm_inst = Fac_SearchRsm(self, address); + if (rsm_inst == NULL) + { + rsm_inst = Fac_GetUninitializedRsm(self); + if (rsm_inst != NULL) + { + Fac_ConstructFbi(self, rsm_inst->inic_ptr, address); + } + } + } + + return rsm_inst; +} + +/*! \brief Returns the GPIO instance associated with the given address. + * \param self Instance pointer + * \param address Address of the device associated with the instance + * \param trigger_event_status_fptr User GPIO trigger event status callback function pointer. + * \return a reference to a GPIO instance or \c NULL if no suitable instance has been found. + */ +CGpio * Fac_GetGpio(CFactory * self, uint16_t address, Ucs_Gpio_TriggerEventResultCb_t trigger_event_status_fptr) +{ + CGpio * gpio_inst = NULL; + CNodeScriptManagement * nsm_inst = NULL; + + if (IS_VALID_ADDR(address)) + { + gpio_inst = Fac_SearchGpio(self, address); + if (NULL == gpio_inst) + { + nsm_inst = Fac_GetNsm(self, address); + if (NULL != nsm_inst) + { + Gpio_InitData_t gpio_init_data; + gpio_inst = Fac_GetUninitializedGpio(self); + if (NULL != gpio_inst) + { + gpio_init_data.nsm_ptr = nsm_inst; + gpio_init_data.inic_ptr = nsm_inst->rsm_ptr->inic_ptr; + gpio_init_data.trigger_event_status_fptr = trigger_event_status_fptr; + Gpio_Ctor(gpio_inst, &gpio_init_data); + } + } + } + } + + return gpio_inst; +} + +/*! \brief Returns the I2C instance associated with the given address. + * \param self Instance pointer + * \param address Address of the device associated with the instance + * \param i2c_interrupt_report_fptr User GPIO trigger event status callback function pointer. + * \return a reference to an I2C instance or \c NULL if no suitable instance has been found. + */ +CI2c * Fac_GetI2c(CFactory * self, uint16_t address, Ucs_I2c_IntEventReportCb_t i2c_interrupt_report_fptr) +{ + CI2c * i2c_inst = NULL; + CNodeScriptManagement * nsm_inst = NULL; + + if (IS_VALID_ADDR(address)) + { + i2c_inst = Fac_SearchI2c (self, address); + if (NULL == i2c_inst) + { + nsm_inst = Fac_GetNsm(self, address); + if (nsm_inst != NULL) + { + I2c_InitData_t i2c_init_data; + i2c_inst = Fac_GetUninitializedI2c(self); + if (NULL != i2c_inst) + { + i2c_init_data.nsm_ptr = nsm_inst; + i2c_init_data.inic_ptr = nsm_inst->rsm_ptr->inic_ptr; + i2c_init_data.i2c_interrupt_report_fptr = i2c_interrupt_report_fptr; + I2c_Ctor(i2c_inst, &i2c_init_data); + } + } + } + } + + return i2c_inst; +} + +/*! \brief Searches for the INIC instance associated with the given address and returns It if found. + * \param self Instance pointer + * \param address Address of the device associated with this instance + * \return a reference to the found instance otherwise \c NULL. + */ +CInic * Fac_FindInic(CFactory * self, uint16_t address) +{ + return Fac_SearchFbi (self, address); +} + +/*! \brief Searches for the NSM instance associated with the given address and returns It if found. + * \param self Instance pointer + * \param address Address of the device associated with this instance + * \return a reference to the found instance otherwise \c NULL. + */ +CNodeScriptManagement * Fac_FindNsm(CFactory * self, uint16_t address) +{ + return Fac_SearchNsm (self, address); +} + +/*! \brief Searches for the RSM instance associated with the given address and returns It if found. + * \param self Instance pointer + * \param address Address of the device associated with this instance + * \return a reference to the found instance otherwise \c NULL. + */ +CRemoteSyncManagement * Fac_FindRsm(CFactory * self, uint16_t address) +{ + return Fac_SearchRsm (self, address); +} + +/*! \brief Calls the given function for each instance of inst_type type. If the func_ptr + * returns true the loop is stopped. + * \param self Reference to a Factory Instance + * \param inst_type The instance type to be looked for + * \param func_ptr Reference of the callback function which is called for each node + * \param user_data_ptr Reference of optional user data pass to the func_ptr + */ +void Fac_Foreach(CFactory * self, Fac_Inst_t inst_type, Fac_ForeachFunc_t func_ptr, void *user_data_ptr) +{ + uint8_t j; + void * curr_inst = NULL; + bool exit_loop = false; + + for(j=0U; j<FAC_NUM_DEVICES; j++) + { + switch(inst_type) + { + case FAC_INST_INIC: + curr_inst = &self->fbi_list[j]; + if (Fac_IsFbiUninitialized((CInic *)curr_inst)) + { + curr_inst = NULL; + } + break; + + case FAC_INST_RSM: + curr_inst = &self->rsm_list[j]; + if (Fac_IsRsmUninitialized((CRemoteSyncManagement *)curr_inst)) + { + curr_inst = NULL; + } + break; + + case FAC_INST_XRM: + curr_inst = &self->xrm_list[j]; + if (Fac_IsXrmUninitialized((CExtendedResourceManager *)curr_inst)) + { + curr_inst = NULL; + } + break; + + case FAC_INST_GPIO: + curr_inst = &self->gpio_list[j]; + if (Fac_IsGpioUninitialized((CGpio *)curr_inst)) + { + curr_inst = NULL; + } + break; + + case FAC_INST_I2C: + curr_inst = &self->i2c_list[j]; + if (Fac_IsI2cUninitialized((CI2c *)curr_inst)) + { + curr_inst = NULL; + } + break; + + default: + break; + } + + if (curr_inst != NULL) + { + if (func_ptr(inst_type, curr_inst, user_data_ptr) != false) + { + exit_loop = true; + } + } + else + { + exit_loop = true; + } + + if (exit_loop) + { + break; + } + } +} + +/*------------------------------------------------------------------------------------------------*/ +/* Private Methods */ +/*------------------------------------------------------------------------------------------------*/ +/*! \brief Search for the FBI instance associated with the given address and return It. + * \param self Instance pointer + * \param address Address to be looked for + * \return a reference to the found FBI or \c NULL if no suitable instance has been found. + */ +static CInic * Fac_SearchFbi(CFactory * self, uint16_t address) +{ + CInic * found_fbi = NULL; + uint8_t i; + uint16_t tmp_addr = address; + + if ((tmp_addr != UCS_ADDR_LOCAL_DEV) && (Net_IsOwnAddress(self->net_ptr, tmp_addr) == NET_IS_OWN_ADDR_NODE)) + { + tmp_addr = UCS_ADDR_LOCAL_DEV; + } + + for (i = 0U; (i<FAC_NUM_DEVICES) && (!Fac_IsFbiUninitialized(&self->fbi_list[i])); i++) + { + if (tmp_addr == Inic_GetTargetAddress(&self->fbi_list[i])) + { + found_fbi = &self->fbi_list[i]; + break; + } + } + + return found_fbi; +} + +/*! \brief Search for the NSM instance associated with the given address and return It. + * \param self Instance pointer + * \param address Address to be looked for + * \return a reference to the found NSM or \c NULL if no suitable instance has been found. + */ +static CNodeScriptManagement * Fac_SearchNsm(CFactory * self, uint16_t address) +{ + CNodeScriptManagement * found_nsm = NULL; + uint8_t i; + uint16_t tmp_addr = address; + + if ((tmp_addr != UCS_ADDR_LOCAL_DEV) && (Net_IsOwnAddress(self->net_ptr, tmp_addr) == NET_IS_OWN_ADDR_NODE)) + { + tmp_addr = UCS_ADDR_LOCAL_DEV; + } + + for (i = 0U; (i<FAC_NUM_DEVICES) && (!Fac_IsNsmUninitialized(&self->nsm_list[i])); i++) + { + if (tmp_addr == self->nsm_list[i].target_address) + { + found_nsm = &self->nsm_list[i]; + break; + } + } + + return found_nsm; +} + +/*! \brief Search for the RSM instance associated with the given address. + * \param self Instance pointer + * \param address Address to be looked for + * \return a reference to the found RSM or \c NULL if no suitable instance has been found. + */ +static CRemoteSyncManagement * Fac_SearchRsm(CFactory * self, uint16_t address) +{ + CRemoteSyncManagement * found_rsm = NULL; + uint8_t i; + uint16_t tmp_addr = address; + + if ((tmp_addr != UCS_ADDR_LOCAL_DEV) && (Net_IsOwnAddress(self->net_ptr, tmp_addr) == NET_IS_OWN_ADDR_NODE)) + { + tmp_addr = UCS_ADDR_LOCAL_DEV; + } + + for (i = 0U; (i<FAC_NUM_DEVICES) && (!Fac_IsFbiUninitialized(self->rsm_list[i].inic_ptr)); i++) + { + if (tmp_addr == Inic_GetTargetAddress(self->rsm_list[i].inic_ptr)) + { + found_rsm = &self->rsm_list[i]; + break; + } + } + + return found_rsm; +} + +/*! \brief Search for the XRM instance associated with the given address. + * \param self Instance pointer + * \param address Address to be looked for + * \return a reference to the found XRM or \c NULL if no suitable instance has been found. + */ +static CExtendedResourceManager * Fac_SearchXrm(CFactory * self, uint16_t address) +{ + CExtendedResourceManager * found_xrm = NULL; + uint8_t i; + uint16_t tmp_addr = address; + + if ((tmp_addr != UCS_ADDR_LOCAL_DEV) && (Net_IsOwnAddress(self->net_ptr, tmp_addr) == NET_IS_OWN_ADDR_NODE)) + { + tmp_addr = UCS_ADDR_LOCAL_DEV; + } + + for (i = 0U; (i<FAC_NUM_DEVICES) && (!Fac_IsXrmUninitialized(&self->xrm_list[i])); i++) + { + if (tmp_addr == Inic_GetTargetAddress(self->xrm_list[i].rsm_ptr->inic_ptr)) + { + found_xrm = &self->xrm_list[i]; + break; + } + } + + return found_xrm; +} + +/*! \brief Search for the Gpio instance associated with the given address. + * \param self Instance pointer + * \param address Address to be looked for + * \return a reference to the found GPIO or \c NULL if no suitable instance has been found. + */ +static CGpio * Fac_SearchGpio(CFactory * self, uint16_t address) +{ + CGpio * found_gpio = NULL; + uint8_t i; + uint16_t tmp_addr = address; + + if ((tmp_addr != UCS_ADDR_LOCAL_DEV) && (Net_IsOwnAddress(self->net_ptr, tmp_addr) == NET_IS_OWN_ADDR_NODE)) + { + tmp_addr = UCS_ADDR_LOCAL_DEV; + } + + for (i = 0U; (i<FAC_NUM_DEVICES) && (!Fac_IsGpioUninitialized(&self->gpio_list[i])); i++) + { + if (tmp_addr == Inic_GetTargetAddress(self->gpio_list[i].nsm_ptr->rsm_ptr->inic_ptr)) + { + found_gpio = &self->gpio_list[i]; + break; + } + } + + return found_gpio; +} + +/*! \brief Search for the I2c instance associated with the given address. + * \param self Instance pointer + * \param address Address to be looked for + * \return a reference to the found GPIO or \c NULL if no suitable instance has been found. + */ +static CI2c * Fac_SearchI2c(CFactory * self, uint16_t address) +{ + CI2c * found_i2c = NULL; + uint8_t i; + uint16_t tmp_addr = address; + + if ((tmp_addr != UCS_ADDR_LOCAL_DEV) && (Net_IsOwnAddress(self->net_ptr, tmp_addr) == NET_IS_OWN_ADDR_NODE)) + { + tmp_addr = UCS_ADDR_LOCAL_DEV; + } + + for (i = 0U; (i<FAC_NUM_DEVICES) && (!Fac_IsI2cUninitialized(&self->i2c_list[i])); i++) + { + if (tmp_addr == Inic_GetTargetAddress(self->i2c_list[i].nsm_ptr->rsm_ptr->inic_ptr)) + { + found_i2c = &self->i2c_list[i]; + break; + } + } + + return found_i2c; +} + +/*! \brief Returns the next free uninitialized XRM instance + * \param self Instance pointer + * \return a reference to the next free uninitialized XRM instance if found, otherwise \c NULL. + */ +static CExtendedResourceManager * Fac_GetUninitializedXrm (CFactory * self) +{ + CExtendedResourceManager * tmp_xrm = NULL; + uint8_t i; + + for (i = 0U; i<FAC_NUM_DEVICES; i++) + { + if (self->xrm_list[i].rsm_ptr == NULL) + { + tmp_xrm = &self->xrm_list[i]; + break; + } + } + + return tmp_xrm; +} + +/*! \brief Returns the next free uninitialized FBI instance + * \param self Instance pointer + * \return a reference to the next free uninitialized FBI instance if found, otherwise \c NULL. + */ +static CInic * Fac_GetUninitializedFbi (CFactory * self) +{ + CInic * tmp_inic = NULL; + uint8_t i; + + for (i = 0U; i<FAC_NUM_DEVICES; i++) + { + if (self->fbi_list[i].base_ptr == NULL) + { + tmp_inic = &self->fbi_list[i]; + break; + } + } + + return tmp_inic; +} + +/*! \brief Returns the next free uninitialized NSM instance + * \param self Instance pointer + * \return a reference to the next free uninitialized NSM instance if found, otherwise \c NULL. + */ +static CNodeScriptManagement * Fac_GetUninitializedNsm (CFactory * self) +{ + CNodeScriptManagement * tmp_nsm = NULL; + uint8_t i; + + for (i = 0U; i<FAC_NUM_DEVICES; i++) + { + if (self->nsm_list[i].base_ptr == NULL) + { + tmp_nsm = &self->nsm_list[i]; + break; + } + } + + return tmp_nsm; +} + +/*! \brief Returns the next free uninitialized RSM instance + * \param self Instance pointer + * \return a reference to the next free uninitialized RSM instance if found, otherwise \c NULL. + */ +static CRemoteSyncManagement * Fac_GetUninitializedRsm (CFactory * self) +{ + CRemoteSyncManagement * tmp_rsm = NULL; + uint8_t i; + + for (i = 0U; i<FAC_NUM_DEVICES; i++) + { + if (Inic_GetTargetAddress(self->rsm_list[i].inic_ptr) == 0x0U) + { + tmp_rsm = &self->rsm_list[i]; + break; + } + } + + return tmp_rsm; +} + +/*! \brief Returns the next free uninitialized GPIO instance + * \param self Instance pointer + * \return a reference to the next free uninitialized GPIO instance if found, otherwise \c NULL. + */ +static CGpio * Fac_GetUninitializedGpio (CFactory * self) +{ + CGpio * tmp_gpio = NULL; + uint8_t i; + + for (i = 0U; i<FAC_NUM_DEVICES; i++) + { + if (NULL == self->gpio_list[i].nsm_ptr) + { + tmp_gpio = &self->gpio_list[i]; + break; + } + } + + return tmp_gpio; +} + +/*! \brief Returns the next free uninitialized I2C instance + * \param self Instance pointer + * \return a reference to the next free uninitialized I2C instance if found, otherwise \c NULL. + */ +static CI2c * Fac_GetUninitializedI2c (CFactory * self) +{ + CI2c * tmp_i2c = NULL; + uint8_t i; + + for (i = 0U; i<FAC_NUM_DEVICES; i++) + { + if (NULL == self->i2c_list[i].nsm_ptr) + { + tmp_i2c = &self->i2c_list[i]; + break; + } + } + + return tmp_i2c; +} + +/*! \brief Constructs the given FBI instance + * \param self the MNS factory Instance pointer + * \param fbi the INIC Instance pointer + * \param address the device address of this FBlock INIC + */ +static void Fac_ConstructFbi (CFactory * self, CInic * fbi, uint16_t address) +{ + Inic_InitData_t inic_init_data; + + if (address == UCS_ADDR_LOCAL_DEV) + { + inic_init_data.xcvr_ptr = self->icm_transceiver; + } + else + { + inic_init_data.xcvr_ptr = self->rcm_transceiver; + } + + inic_init_data.base_ptr = self->base_ptr; + inic_init_data.tgt_addr = address; + + Inic_Ctor(fbi, &inic_init_data); +} + +/*! \brief Constructs the given NSM instance + * \param self the MNS factory Instance pointer + * \param nsm the NSM Instance pointer + * \param address the device address + */ +static void Fac_ConstructNsm (CFactory * self, CNodeScriptManagement * nsm, uint16_t address) +{ + Nsm_InitData_t nsm_init_data; + + nsm_init_data.base_ptr = self->base_ptr; + nsm_init_data.rcm_ptr = self->rcm_transceiver; + nsm_init_data.rsm_ptr = Fac_GetRsm(self, address); + + Nsm_Ctor(nsm, &nsm_init_data); +} + +/*! \brief Checks whether the given FBlock INIC instance is uninitialized + * \param fbi the INIC Instance pointer + * \return \c true if the given Fbi instance is not initialized, otherwise \c False. + */ +static bool Fac_IsFbiUninitialized(CInic * fbi) +{ + return (fbi->base_ptr == NULL) ; +} + +/*! \brief Checks whether the given NSM instance is uninitialized + * \param nsm the NSM Instance pointer + * \return \c true if the given NSM instance is not initialized, otherwise \c False. + */ +static bool Fac_IsNsmUninitialized(CNodeScriptManagement * nsm) +{ + return (nsm->base_ptr == NULL) ; +} + +/*! \brief Checks whether the given RSM instance is uninitialized + * \param rsm Reference to the RSM instance pointer + * \return \c true if the given Fbi instance is not initialized, otherwise \c False. + */ +static bool Fac_IsRsmUninitialized(CRemoteSyncManagement * rsm) +{ + return Fac_IsFbiUninitialized(rsm->inic_ptr); +} + +/*! \brief Checks whether the given XRM instance is uninitialized + * \param xrm the XRM Instance pointer + * \return \c true if the given XRM instance is not initialized, otherwise \c False. + */ +static bool Fac_IsXrmUninitialized(CExtendedResourceManager * xrm) +{ + return (xrm->rsm_ptr == NULL) ; +} + +/*! \brief Checks whether the given GPIO instance is uninitialized + * \param gpio the GPIO Instance pointer + * \return \c true if the given GPIO instance is not initialized, otherwise \c False. + */ +static bool Fac_IsGpioUninitialized(CGpio * gpio) +{ + return (NULL == gpio->nsm_ptr); +} + +/*! \brief Checks whether the given I2C instance is uninitialized + * \param i2c the I2C Instance pointer + * \return \c true if the given I2C instance is not initialized, otherwise \c False. + */ +static bool Fac_IsI2cUninitialized(CI2c * i2c) +{ + return (NULL == i2c->nsm_ptr); +} + +/*! + * @} + * \endcond + */ + +/*------------------------------------------------------------------------------------------------*/ +/* End of file */ +/*------------------------------------------------------------------------------------------------*/ + |