Communication Manager (ComM)
Manages communication states and channel modes across multiple network interfaces.
Funktionen — Übersicht
void ComM_Init (const ComM_ConfigType* ConfigPtr);Initializes the AUTOSAR Communication Manager and restarts the internal state machines.void ComM_DeInit (void);This API de - initializes the AUTOSAR Communication Manager.Std_ReturnType ComM_GetStatus (ComM_InitStatusType* Status);Returns the initialization status of the AUTOSAR Communication Manager.Std_ReturnType ComM_GetInhibitionStatus (NetworkHandleType Channel, ComM_InhibitionStatusType* Status);Returns the inhibition status of a Com M channel.Std_ReturnType ComM_RequestComMode (ComM_UserHandleType User, ComM_ModeType ComMode);Requesting of a Communication Mode by a user.Std_ReturnType ComM_GetMax ComM_GetMaxComMode (ComM_UserHandleType User, ComM_ModeType* ComMode); ⚠️Function t o query the maximum allowed Communication Mode of the corresponding user.Std_ReturnType ComM_GetRequestedComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Function to query the currently requested Communication Mode of the corresponding user.Std_ReturnType ComM_GetCurrentComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Function to query the current Communication Mode.Std_ReturnType ComM_GetCurrentPNCComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);The function returns the current Communication Mode of the corresponding PNC the affected user is assigned to.Std_ReturnType ComM_GetPncToChannelMapping (boolean* MappingTable, uint8* ChannelCnt, uint8* PncCnt);This function returns the current configuration of the ECUs PNC - to -Std_ReturnType ComM_UpdatePncToChannelMapping (const boolean* MappingTable, uint8 channelCnt, uint8 PncCnt);This function can be used to set entries within the the ECUs PNC - to - channel -Std_ReturnType ComM_ResetPncToChannelMapping (void);This function resets dynamic entries within the ECUs PNC - to - channel - mapping to default values Tags: atp.Std_ReturnType ComM_PnLearningRequest (void);Triggers the NM to return into NM Repe at Message State and send the Partial Network Learning Bit (in order for receiving...Std_ReturnType ComM_UpdatePncMembership (boolean Control, const uint8* ComM_PncMembership);This function is used by SWCs to update the PNC membership which is transmitted during PNC Learning.Std_ReturnType ComM_PreventWakeUp (NetworkHandleType Channel, boolean Status);Changes the inhibition status COMM_ NO_ WAKEUP for the corresponding channel.Std_ReturnType ComM_LimitChannelToNoComMode (NetworkHandleType Channel, boolean Status);Changes the inhibition status f or the channel for changing from COMM_ NO_ COMMUNICATION to a higher Communication Mode.Std_ReturnType ComM_LimitECUToNoComMode (boolean Status);Changes the inhibition status for the ECU (=all channels) for changing from COMM_ NO_ COMMUNICATION to a high er Communication...Std_ReturnType ComM_ReadInhibitCounter (uint16* CounterValue);This function returns the amount of rejected COMM_ FULL_ COMMUNICATION user requests.Std_ReturnType ComM_ResetInhibitCounter (void);This function resets the Inhibited COMM_ FULL_ COMMUNICATION request Counter.Std_ReturnType ComM_SetECUGroupClassification (ComM_InhibitionStatusType Status);Changes the ECU Group Classification status (see chapter 10.void ComM_GetVersionInfo (Std_VersionInfoType* Versioninfo);This function returns the published information (for details refer to table 10.void ComM_Nm_NetworkStartIndication (NetworkHandleType Channel);Indication that a NM - message has been received in the Bus Sleep Mode, what indicates that some nodes in the network have...void ComM_Nm_NetworkMode (NetworkHandleType Channel);Notification that the network management has entered Network Mode.void ComM_Nm_PrepareBusSleepMode (NetworkHandleType Channel);Notification that the network management has entered Prepare Bus - Sleep Mode.void ComM_Nm_BusSleepMode (NetworkHandleType Channel);Notification that the network management has entered Bus - Sleep Mode.void ComM_Nm_RestartIndication (NetworkHandleType Channel);If Nm If has started to shut down the coordinated busses, AND not all coordinated busses have indicated bus sleep state, AND...void ComM_Nm_RepeatMessageLeftIndication (NetworkHandleType Channel);Notification that the state of all has left Repeat Message.void ComM_Nm_PncLearningBitIndication (NetworkHandleType Channel);Service to indicate that an NM message with set PNC Learning Bit has been received.void ComM_Nm_ForwardSynchronizedPncShutdown (NetworkHandleType Channel);If an ECU in role of an intermediate PNC coordinator receives a PN shutdown message via a Nm, then Com M is immediately...void ComM_DCM_ActiveDiagnostic (NetworkHandleType Channel);Indication of active diagnostic by the DCM.void ComM_DCM_InactiveDiagnostic (NetworkHandleType Channel);Indication of inactive diagnostic by the DCM.void ComM_EcuM_WakeUpIndication (NetworkHandleType Channel);Notification of a wake up on the corresponding channel.void ComM_EcuM_PNCWakeUpIndication (PNCHandleType PNCid);Notification of a wake up on the corresponding partial network cluster.void ComM_CommunicationAllowed (NetworkHandleType Channel, boolean Allowed);Ecu M or Bsw M shall indicate to Com M when communication is allowed.void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode);Indication of the actual bus mode by the corresponding Bus State Manager.void ComM_BusSM_BusSleepMode (NetworkHandleType Channel);Notification of the corresponding Bus State Manager that the actual bus mode is Bus - Sleep.
Typen — Übersicht
enum ComM_InitStatusTypeInitialization status of Com M.enum ComM_PncModeTypeCurrent mode of a PNCenum ComM_StateTypeState and sub - state of Com M state machine Com M states vs.struct ComM_ConfigTypeThis type contains the implementation - specific post build configuration structure.enum ComM_ModeTypeCurrent mode of the Communication Manager (main state of the state machine).ComM_UserHandleTypeHandle to identify a user.ComM_UserHandleArrayTypenumber Of Requesters contains the number of valid user handle entries in the "handle Array" member.ComM_UserHandleSubArrayTypeThis element contains the user handles of the users which keep the channel requested (if any), starting in its first entries.ComM_PncMembershipTypeArray of uint8 with Elements that holds the current PNC Membership of the node.modeLimitation-ComMMode-
Funktionen & Typen — Detailansicht
função ComM_Init [SWS_ComM_00146] 📄 PDF
void ComM_Init (const ComM_ConfigType* ConfigPtr);
Initializes the AUTOSAR Communication Manager and restarts the internal state machines.
A função síncrona ComM_Init (ID de serviço 0x01) serve para a inicialização básica do AUTOSAR Communication Manager e reinicia suas máquinas de estados internas [SWS_ComM_00146]. Como parâmetro de entrada, ela recebe ConfigPtr, que é passado como um ponteiro para a estrutura de configuração post-build do tipo const ComM_ConfigType* [SWS_ComM_00146]. A função não fornece valor de retorno (tipo de retorno void) e é declarada através do arquivo de cabeçalho ComM.h [SWS_ComM_00146].
Em relação à simultaneidade, ComM_Init é definida como não reentrante (Non Reentrant) [SWS_ComM_00146]. Um chamador concreto não é especificado nos dados de especificação; presume-se que a chamada ocorra centralmente durante a fase de inicialização da ECU, no âmbito da inicialização do BSW. Pergunta Q-7121f73c12407087 (aberta)
No sistema global, ComM_Init possui uma função central de controle e pré-requisito para todo o módulo: enquanto o módulo ComM não tiver sido inicializado, todos os serviços de módulo e de API não devem iniciar sua operação regular e, em serviços com tipo de retorno padrão E_NOT_OK, devem retornar [SWS_ComM_00612]. Uma exceção a esse bloqueio aplica-se exclusivamente a ComM_Init propriamente dito, bem como às funções de consulta ComM_GetVersionInfo e ComM_GetStatus [SWS_ComM_00612].
Esta nota de uso foi gerada automaticamente a partir dos dados de especificação AUTOSAR.
Guia do implementador em breve (complexidade I1)
função ComM_DeInit [SWS_ComM_00147] 📄 PDF
void ComM_DeInit (void);
This API de - initializes the AUTOSAR Communication Manager.
usar
A função ComM_DeInit destina-se, conforme [SWS_ComM_00147], à desinicialização do AUTOSAR Communication Manager (ComM). O serviço foi projetado de forma síncrona, possui o ID de serviço 0x02 e é declarado por meio do arquivo de cabeçalho ComM.h. Conforme a assinatura void ComM_DeInit(void), a função não aceita parâmetros de entrada, saída ou passagem e não retorna nenhum valor ao chamador [SWS_ComM_00147].
Tratamento de erros
Como a assinatura da função retorna void, não ocorre nenhum retorno direto de códigos de erro ou de status por meio da chamada de interface [SWS_ComM_00147]. Reações de erro específicas, como a notificação do Development Error Tracer (DET) ou do Diagnostic Event Manager (DEM), não constam nos dados de especificação disponíveis e, portanto, não são indicadas.
Concorrência e contexto de sistema
A interface é especificada de acordo com [SWS_ComM_00147] como não reentrante (Non Reentrant). Disso decorre o requisito mandatório para a integração do sistema de suprimir completamente chamadas paralelas ou de interrupção a partir de múltiplas tarefas ou contextos. Como interpretação do fluxo do sistema, a chamada normalmente deve ocorrer no curso do desligamento ordenado da ECU por meio de um gerenciamento de estado superior (como o BSW Manager), assim que os canais de comunicação da BSW tiverem sido desativados. Pergunta Q-f3b68dc129993cb7 (aberta)
Esta nota de uso foi gerada automaticamente com base na especificação SWS_ComM_00147.
função ComM_GetStatus [SWS_ComM_00242] 📄 PDF
Std_ReturnType ComM_GetStatus (ComM_InitStatusType* Status);
Returns the initialization status of the AUTOSAR Communication Manager. After a call to Com M_ De Init() Com M should have status COMM_ UNINIT, and a new call to Com M_ Init needed to make sur e Com M restart internal state machines to defailt values.
função ComM_GetInhibitionStatus [SWS_ComM_00619] 📄 PDF
Std_ReturnType ComM_GetInhibitionStatus (NetworkHandleType Channel, ComM_InhibitionStatusType* Status);
Returns the inhibition status of a Com M channel.
função ComM_RequestComMode [SWS_ComM_00110] 📄 PDF
Std_ReturnType ComM_RequestComMode (ComM_UserHandleType User, ComM_ModeType ComMode);
Requesting of a Communication Mode by a user. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Note: The following modes are no vaild user requests, since they are used as internal modes: - COMM_ SIL ENT_ COMMUNICATION (this mode is used for synchronization at shutdown) - COMM_ FULL_ COMMUNICATION_ WITH_ WAKEUP_ REQUEST (this mode is used internally within the Com M channel statemachine to trigger the lower layers to request a wakeup on the network if the used hardware support such a feature. (e.g. Ethernet hardware which is compatible with OA TC10). The following modes are valid user requests: - COMM_ NO_ COMMUNICATION - COMM_ FULL_ COMMUNICATION. The communication request could also be released due to
Utilização e contexto de chamada
A função síncrona e reentrante ComM_RequestComMode ([SWS_ComM_00110]) serve para solicitar um modo de comunicação para um usuário definido (User). Ela está disponível através de ComM.h. Como parâmetros de passagem para ComMode, apenas os seguintes valores são permitidos como solicitação de usuário:
COMM_FULL_COMMUNICATION: solicitação de capacidade total de comunicação ([SWS_ComM_00110]).COMM_NO_COMMUNICATION: liberação ou encerramento da solicitação de comunicação ([SWS_ComM_00110]).
Os modos COMM_SILENT_COMMUNICATION (serve para a sincronização de shutdown) e COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (gatilho de wake-up interno para camadas inferiores, por exemplo, em hardware Ethernet com suporte a OA TC10) são estados internos e não devem ser solicitados por usuários ([SWS_ComM_00110]). Interpretação: a passagem desses modos internos provavelmente seria confirmada com E_NOT_OK. Pergunta Q-973ed1ce1845983e (aberta)
Valores de retorno e tratamento de erros
A função sinaliza o resultado por meio de valores de retorno definidos ([SWS_ComM_00110]):
E_OK: a transição para o modo de comunicação desejado foi concluída com sucesso.E_NOT_OK: A mudança de modo falhou.COMM_E_MODE_LIMITATION: o modo solicitado não pode ser concedido devido a uma inibição de comunicação ativa (Mode Inhibition). Solicitações de comunicação também podem ser liberadas novamente por meio de tais inibições.
Interação e máquina de estados
A presença ou ausência de solicitações ativas influencia a máquina de estados de canal do ComM. Se o canal estiver no subestado COMM_FULL_COM_NETWORK_REQUESTED com a configuração ComMNmVariant = SLAVE_ACTIVE e não houver nenhuma chamada ativa de ComM_RequestComMode(<user>, COMM_FULL_COMMUNICATION), a máquina de estados do ComM transita para o subestado COMM_FULL_COM_READY_SLEEP ([SWS_ComM_01017]).
Este texto foi gerado por um sistema de documentação baseado em IA com base na especificação AUTOSAR R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_GetMaxComMode [SWS_ComM_00085] 📄 PDF
Std_ReturnType ComM_GetMaxComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function t o query the maximum allowed Communication Mode of the corresponding user.
função ComM_GetRequestedComMode [SWS_ComM_00079] 📄 PDF
Std_ReturnType ComM_GetRequestedComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function to query the currently requested Communication Mode of the corresponding user. Availa ble via Com M.h
função ComM_GetCurrentComMode [SWS_ComM_00083] 📄 PDF
Std_ReturnType ComM_GetCurrentComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function to query the current Communication Mode. Com M shall use the corresponding interfaces of the Bus State Managers to get the current Communication Mode of the network. (Call to Bus State Manager API: XXXSM _ Get Current Com Mode(...))
função ComM_GetCurrentPNCComMode [SWS_ComM_91002] 📄 PDF
Std_ReturnType ComM_GetCurrentPNCComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
The function returns the current Communication Mode of the corresponding PNC the affected user is assigned to.
função ComM_GetPncToChannelMapping [SWS_ComM_91013] 📄 PDF
Std_ReturnType ComM_GetPncToChannelMapping (boolean* MappingTable, uint8* ChannelCnt, uint8* PncCnt);
This function returns the current configuration of the ECUs PNC - to -
função ComM_UpdatePncToChannelMapping [SWS_ComM_91015] 📄 PDF
Std_ReturnType ComM_UpdatePncToChannelMapping (const boolean* MappingTable, uint8 channelCnt, uint8 PncCnt);
This function can be used to set entries within the the ECUs PNC - to - channel -
A função síncrona ComM_UpdatePncToChannelMapping com o Service-ID 0x62 serve para a definição de entradas no mapeamento de PNC para canal da unidade de comando eletrónica ou do PNC-Gateway [SWS_ComM_91015]. A interface está disponível através do ficheiro de cabeçalho ComM.h e encontra-se assinalada com o estado Draft no Release R20-11 [SWS_ComM_91015].
Parâmetros
São passados três parâmetros de entrada à chamada da função [SWS_ComM_91015]:
MappingTable: Ponteiro para um array bidimensionalboolean(const boolean*) que contém o mapeamento de PNC para canal atual do PNC-Gateway, no qual a primeira dimensão cobre todos os canais relevantes e a segunda dimensão todos os PNCs relevantes [SWS_ComM_91015].channelCnt: Número de canais físicos que são passados naMappingTable[SWS_ComM_91015].PncCnt: Número de PNCs que são passados naMappingTable[SWS_ComM_91015].
Valores de retorno e tratamento de erros
A função retorna um valor de status do tipo Std_ReturnType [SWS_ComM_91015]:
E_OK: A entrada de mapeamento foi definida com sucesso [SWS_ComM_91015].E_NOT_OK: A definição da entrada de mapeamento falhou [SWS_ComM_91015].COMM_E_LEARNING_ACTIVE: A chamada não pode ser executada, pois a fase de aprendizagem de PNC está ativa [SWS_ComM_91015].
Simultaneidade e restrições
A interface está definida como não reentrante [SWS_ComM_91015]. As chamadas não devem, por conseguinte, ocorrer de forma concorrente. Uma atualização está também excluída enquanto o sistema de comunicação se encontrar na fase ativa de aprendizagem de PNC [SWS_ComM_91015].
Esta nota de uso foi gerada automaticamente com base na especificação AUTOSAR CP R20-11.
função ComM_ResetPncToChannelMapping [SWS_ComM_91017] 📄 PDF
Std_ReturnType ComM_ResetPncToChannelMapping (void);
This function resets dynamic entries within the ECUs PNC - to - channel - mapping to default values Tags: atp.Status=draft
A função síncrona e não reentrante ComM_ResetPncToChannelMapping serve para repor entradas dinâmicas do mapeamento de PNC para canal da unidade de comando eletrónica para os valores padrão configurados [SWS_ComM_91017]. Não recebe parâmetros de entrada e retorna um valor de estado do tipo Std_ReturnType [SWS_ComM_91017].
Comportamento e valores de retorno
O comportamento da função depende do estado da fase de aprendizagem de PNC, bem como da configuração dos canais:
- Se
ComMDynamicPncToChannelMappingEnabledestiver ativado para pelo menos um canal e a fase de aprendizagem de PNC não estiver ativa, a função repõe os mapeamentos para os valores padrão da configuração original (entradas estáticas) e retornaE_OK[SWS_ComM_01043]. - Se o sistema se encontrar numa fase ativa de aprendizagem de PNC e
ComMDynamicPncToChannelMappingEnabledouComMDynamicPncToChannelMappingSupportestiver definido comoTRUEpara pelo menos um canal, o reset é recusado e é retornadoCOMM_E_LEARNING_ACTIVE[SWS_ComM_01042], [SWS_ComM_01045]. - Se a reposição dos mapeamentos para os valores padrão falhar, a função retorna
E_NOT_OK[SWS_ComM_91017].
Restrições e condições de chamada
Como ComM_ResetPncToChannelMapping está especificada como não reentrante (Non Reentrant), não podem ocorrer chamadas simultâneas a partir de contextos concorrentes [SWS_ComM_91017]. Além disso, a interface encontra-se no estado Draft [SWS_ComM_91017].
Este texto foi gerado por uma IA e baseia-se exclusivamente nos dados de especificação do AUTOSAR R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_PnLearningRequest [SWS_ComM_91019] 📄 PDF
Std_ReturnType ComM_PnLearningRequest (void);
Triggers the NM to return into NM Repe at Message State and send the Partial Network Learning Bit (in order for receiving nodes to respond) together with the Repeat Message Request Bit (in order for receiving nodes to return into NM Repeat Message State). This function is used for the optional Dynamic PNC - to - channel - mapping feature. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Tags: atp.Status=draft
Utilização e semântica
A função assíncrona ComM_PnLearningRequest desencadeia o mapeamento dinâmico de PNC para canal opcional (Dynamic PNC-to-channel-mapping) [SWS_ComM_91019]. Faz com que o Network Management (NM) regresse ao estado NM Repeat Message State [SWS_ComM_91019]. Neste processo, são enviados o Partial Network Learning Bit, para que os nós recetores respondam, e o Repeat Message Request Bit, para que os nós recetores também mudem para o estado NM Repeat Message State [SWS_ComM_91019]. A chamada ocorre sem parâmetros de entrada através da interface em ComM.h com o Service-ID 0x64 [SWS_ComM_91019].
Valores de retorno e tratamento de erros
A função retorna um valor de status do tipo Std_ReturnType [SWS_ComM_91019]:
E_OK: O algoritmo de aprendizagem de PNC foi iniciado com sucesso [SWS_ComM_91019].E_NOT_OK: Não foi possível iniciar o algoritmo de aprendizagem de PNC [SWS_ComM_91019].COMM_E_LEARNING_ACTIVE: A chamada de função não pode ser executada, pois a fase de aprendizagem de PNC já está ativa [SWS_ComM_91019].
Simultaneidade e configuração
A função é especificada como não reentrante (Non Reentrant) e possui o estado draft [SWS_ComM_91019]. Está disponível exclusivamente quando o parâmetro de pré-configuração ComMDynamicPncToChannelMappingSupport estiver definido como TRUE [SWS_ComM_01044].
Esta nota de utilização baseia-se na especificação do AUTOSAR R20-11.
Guia do implementador em breve (complexidade I2)
função ComM_UpdatePncMembership [SWS_ComM_91021] 📄 PDF
Std_ReturnType ComM_UpdatePncMembership (boolean Control, const uint8* ComM_PncMembership);
This function is used by SWCs to update the PNC membership which is transmitted during PNC Learning. This function is used for the optional Dynamic PNC - to - channel - mapping feature. This function is used for the optional Dynamic PNC - to - channel - mapping feature. Tags: atp.Status=draft
A função síncrona e não reentrante ComM_UpdatePncMembership é utilizada por Software-Components (SWCs) para ajustar a pertença a PNC transmitida durante o PNC Learning para o mapeamento dinâmico de PNC para canal opcional [SWS_ComM_91021]. Só está disponível através do ficheiro de cabeçalho ComM.h se o parâmetro de configuração ComMDynamicPncToChannelMappingSupport estiver definido como TRUE [SWS_ComM_01047].
Através do parâmetro ComM_PncMembership é passado um array de bytes com o comprimento do vetor de PNC que contém a pertença a PNC atual do nó [SWS_ComM_91021]. Se a função estiver ativada em pelo menos um canal e a fase de aprendizagem de PNC estiver inativa, o parâmetro Control é avaliado [SWS_ComM_01049]:
-
Em caso de
Control = 0, a pertença a PNC atual é calculada através de uma operação lógica AND comComM_PncMembership, de modo a repor de forma direcionada os respetivos bits na máscara [SWS_ComM_01049]. -
Em caso de
Control = 1, é aplicada uma operação lógica OR para definir bits na máscara [SWS_ComM_01049].
Se a atualização tiver sido bem-sucedida, a função retorna E_OK [SWS_ComM_01049]. Se, por outro lado, o mapeamento dinâmico estiver configurado em pelo menos um canal e a fase de aprendizagem de PNC estiver ativa, a execução é recusada e o valor de erro específico COMM_E_LEARNING_ACTIVE é reportado [SWS_ComM_01048]. Se ocorrer outro erro durante o processo de atualização, é retornado E_NOT_OK [SWS_ComM_91021].
Esta nota de utilização foi gerada por uma IA e baseia-se exclusivamente nas diretrizes de especificação do AUTOSAR R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_PreventWakeUp [SWS_ComM_00156] 📄 PDF
Std_ReturnType ComM_PreventWakeUp (NetworkHandleType Channel, boolean Status);
Changes the inhibition status COMM_ NO_ WAKEUP for the corresponding channel.
Utilização e contexto de chamada
A função ComM_PreventWakeUp destina-se, conforme [SWS_ComM_00156], a alterar o status de inibição COMM_NO_WAKEUP para um determinado canal de comunicação. Ela é executada de forma síncrona e está disponível por meio do arquivo de cabeçalho ComM.h.
Na chamada, são passados dois parâmetros de entrada:
Channel: Identifica o canal em questão conforme o tipoNetworkHandleType([SWS_ComM_00156]).Status: Um valor booleano com o qual a inibição de despertar é ativada (TRUE) ou desativada (FALSE) ([SWS_ComM_00156]).
Valores de retorno e tratamento de erros
Como valor de retorno, a função fornece o status Std_ReturnType de acordo com [SWS_ComM_00156]:
E_OK: O status de despertar para o canal especificado foi atualizado com sucesso.E_NOT_OK: A alteração do status de despertar falhou, por exemplo, se a funcionalidade estiver desativada por meio da classificação de grupo de ECU (ComMEcuGroupClassification).
Simultaneidade e restrições
A interface é especificada como não reentrante (Non Reentrant) ([SWS_ComM_00156]). Os chamadores devem, portanto, assegurar que chamadas paralelas para a mesma instância sejam evitadas.
Esta nota foi gerada por uma IA com base na especificação AUTOSAR R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_LimitChannelToNoComMode [SWS_ComM_00163] 📄 PDF
Std_ReturnType ComM_LimitChannelToNoComMode (NetworkHandleType Channel, boolean Status);
Changes the inhibition status f or the channel for changing from COMM_ NO_ COMMUNICATION to a higher Communication Mode. (See also Com M_ Limit ECUTo No Com Mode, same functionality but for all channels)
A função síncrona ComM_LimitChannelToNoComMode com o ID de serviço 0x0b destina-se, no Communication Manager, a definir o status de inibição para um canal de comunicação individual [SWS_ComM_00163]. Ela impede ou permite a transição do canal do estado COMM_NO_COMMUNICATION para um modo de comunicação de nível superior [SWS_ComM_00163].
Parâmetros e contexto de chamada
A interface é declarada por meio do arquivo de cabeçalho ComM.h e não possui parâmetros de entrada/saída nem parâmetros puramente de saída [SWS_ComM_00163]. Na chamada, são passados dois parâmetros de entrada [SWS_ComM_00163]:
Channel: Endereça o respectivo canal por meio do identificador do tipoNetworkHandleType[SWS_ComM_00163].Status: Determina comobooleano estado de inibição desejado. A passagem deTRUEativa a limitação do canal aCOMM_NO_COMMUNICATION, enquantoFALSEdesativa novamente essa limitação [SWS_ComM_00163].
Valores de retorno e tratamento de erros
A função retorna um valor do tipo Std_ReturnType ao chamador [SWS_ComM_00163]:
E_OK: O status de inibição para o canal endereçado foi ajustado com sucesso [SWS_ComM_00163].E_NOT_OK: A alteração de status não pôde ser realizada, o que ocorre, por exemplo, quando a configuraçãoComMEcuGroupClassification(consulteECUC_ComM_00563) desativa a funcionalidade [SWS_ComM_00163].
Concorrência e relação com o sistema
Em relação ao comportamento de execução, a função é executada de forma síncrona (Synchronous) e não reentrante (Non Reentrant) [SWS_ComM_00163]. Para a mesma finalidade no nível do sistema global, existe a função relacionada ComM_LimitECUToNoComMode, que implementa a mesma limitação não apenas por canal, mas de maneira uniforme para todos os canais da ECU [SWS_ComM_00163].
Esta nota de utilização foi gerada automaticamente com base na especificação.
Guia do implementador em breve (complexidade I1)
função ComM_LimitECUToNoComMode [SWS_ComM_00124] 📄 PDF
Std_ReturnType ComM_LimitECUToNoComMode (boolean Status);
Changes the inhibition status for the ECU (=all channels) for changing from COMM_ NO_ COMMUNICATION to a high er Communication Mode. (See also Com M_ Limit Channel To No Com Mode, same functionality but for a specific channels)
usar
A função síncrona ComM_LimitECUToNoComMode (ID de serviço 0x0c) é definida em ComM.h e serve para alterar o status de inibição para toda a ECU [SWS_ComM_00124]. Ela impede ou permite a transição de COMM_NO_COMMUNICATION para um modo de comunicação superior para todos os canais de comunicação da ECU [SWS_ComM_00124]. O controle é realizado através do parâmetro formal Status:
TRUE: ativa a inibição da ECU para o modoCOMM_NO_COMMUNICATION[SWS_ComM_00124].FALSE: desativa novamente a inibição da ECU paraCOMM_NO_COMMUNICATION[SWS_ComM_00124].
Tratamento de erros e valores de retorno
A função retorna um código de status do tipo Std_ReturnType ao chamador [SWS_ComM_00124]:
E_OK: o status de inibição para a ECU foi aplicado com sucesso [SWS_ComM_00124].E_NOT_OK: a alteração do status de inibição falhou, por exemplo, quando o parâmetro de configuraçãoComMEcuGroupClassification(consulteECUC_ComM_00563) desativa a funcionalidade [SWS_ComM_00124].
Um chamador deve avaliar o valor de retorno para identificar se a inibição pôde ser ativada efetivamente ou se foi rejeitada pela configuração do módulo [SWS_ComM_00124].
Concorrência e interação
A interface é declarada como não reentrante (Non Reentrant); chamadas paralelas ou interruptivas são, portanto, inadmissíveis e devem ser evitadas pelo lado do chamador [SWS_ComM_00124]. Enquanto ComM_LimitChannelToNoComMode disponibiliza a mesma funcionalidade de controle de forma isolada para um único canal, ComM_LimitECUToNoComMode afeta sempre a totalidade de todos os canais da ECU [SWS_ComM_00124].
Esta nota de uso foi gerada automaticamente com base no AUTOSAR R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_ReadInhibitCounter [SWS_ComM_00224] 📄 PDF
Std_ReturnType ComM_ReadInhibitCounter (uint16* CounterValue);
This function returns the amount of rejected COMM_ FULL_ COMMUNICATION user requests.
Utilização e contexto de chamada
A função síncrona ComM_ReadInhibitCounter (ID de serviço 0x0d) destina-se a consultar a quantidade de solicitações de usuário rejeitadas para operação de comunicação plena (COMM_FULL_COMMUNICATION) [SWS_ComM_00224]. A declaração da função é fornecida por meio do arquivo de cabeçalho ComM.h [SWS_ComM_00224].
A função não possui parâmetros de entrada. Como único parâmetro de saída, atua o ponteiro CounterValue do tipo básico uint16*, por meio do qual o valor do contador para as solicitações rejeitadas é transmitido ao chamador [SWS_ComM_00224]. Se o valor do contador pôde ser determinado e gravado com sucesso, a função retorna E_OK; em caso de falha, ela retorna E_NOT_OK [SWS_ComM_00224].
Tratamento de erros
Códigos de erro específicos ou erros de desenvolvimento padronizados (DET) não são listados separadamente na descrição da interface. Presume-se que uma falha com o valor de retorno E_NOT_OK [SWS_ComM_00224] seja provavelmente decorrente de um parâmetro de ponteiro inválido (ponteiro nulo) ou de uma chamada antes da inicialização do módulo ComM (interpretação). Pergunta Q-5779d898381d9894 (aberta)
Simultaneidade e restrições
A interface é explicitamente especificada como não reentrante (Non Reentrant) [SWS_ComM_00224]. Os chamadores devem, portanto, assegurar no nível de sistema que não ocorram chamadas concorrentes ou de interrupção por meio de diferentes tarefas ou rotinas de serviço de interrupção, a fim de evitar inconsistências na leitura do contador.
Esta nota de uso foi gerada automaticamente e baseia-se nas especificações da versão AUTOSAR R20-11.
função ComM_ResetInhibitCounter [SWS_ComM_00108] 📄 PDF
Std_ReturnType ComM_ResetInhibitCounter (void);
This function resets the Inhibited COMM_ FULL_ COMMUNICATION request Counter.
Utilização e funcionamento
A interface síncrona ComM_ResetInhibitCounter serve para redefinir o contador interno de solicitações de comunicação plena rejeitadas ou impedidas (Inhibited COMM_FULL_COMMUNICATION request Counter) no Communication Manager [SWS_ComM_00108]. A chamada é disponibilizada através do cabeçalho ComM.h, possui a ID de serviço 0x0e e não requer parâmetros de passagem [SWS_ComM_00108]. Em caso de execução bem-sucedida, a função fornece o valor de retorno E_OK do tipo Std_ReturnType [SWS_ComM_00108].
Tratamento de erros e condições de contorno
Se ocorrer um erro ao resetar o contador, o serviço sinaliza isso por meio do valor de retorno E_NOT_OK [SWS_ComM_00108]. Erros de desenvolvimento concretos (DET) ou cenários de erro não estão listados no presente extrato da especificação; presumivelmente, a execução falha e fornece E_NOT_OK se o módulo ainda não tiver sido inicializado. Pergunta Q-31d1ba95e419fa8e (aberta)
simultaneidade
A função é declarada como não reentrante (Non Reentrant) [SWS_ComM_00108]. Os usuários devem, portanto, assegurar por meio de sincronização adequada que não ocorram chamadas paralelas a partir de múltiplas threads, tarefas ou rotinas de serviço de interrupção, para evitar inconsistências no contador.
Este texto foi gerado por uma IA com base na especificação AUTOSAR.
função ComM_SetECUGroupClassification [SWS_ComM_00552] 📄 PDF
Std_ReturnType ComM_SetECUGroupClassification (ComM_InhibitionStatusType Status);
Changes the ECU Group Classification status (see chapter 10.2.2)
função ComM_GetVersionInfo [SWS_ComM_00370] 📄 PDF
void ComM_GetVersionInfo (Std_VersionInfoType* Versioninfo);
This function returns the published information (for details refer to table 10.3)
função ComM_Nm_NetworkStartIndication [SWS_ComM_00383] 📄 PDF
void ComM_Nm_NetworkStartIndication (NetworkHandleType Channel);
Indication that a NM - message has been received in the Bus Sleep Mode, what indicates that some nodes in the network have already entered the Network Mode.
A função ComM_Nm_NetworkStartIndication serve como interface de notificação da gestão de rede para o Communication Manager. Em conformidade com [SWS_ComM_00383], indica que foi recebida uma mensagem NM durante o estado Bus Sleep Mode, o que sinaliza que determinados nós na rede já transitaram para o Network Mode.
- Chamada e parâmetros: A interface é declarada através do ficheiro de cabeçalho
ComM_Nm.he recebe como parâmetro de entrada o canal de comunicação afetadoChanneldo tipoNetworkHandleType[SWS_ComM_00383]. - Sincronia e retorno: A chamada não possui valor de retorno (
void) e segue uma semântica de execução assíncrona [SWS_ComM_00383]. - Concorrência: A função é provida com o Service-ID
0x15e especificada como reentrante (Reentrant) [SWS_ComM_00383].
Códigos de erro específicos, mensagens DET ou DEM, bem como reações de erro separadas não estão previstos para esta interface na especificação [SWS_ComM_00383]. Interpretação: É provável que a indicação se destine internamente a iniciar a transição do estado de repouso para a comunicação de rede ativa para o canal especificado. Pergunta Q-97a02db4ab6a3af8 (aberta)
Esta nota de uso baseia-se exclusivamente nos dados de especificação do release R20-11 do AUTOSAR.
Guia do implementador em breve (complexidade I1)
função ComM_Nm_NetworkMode [SWS_ComM_00390] 📄 PDF
void ComM_Nm_NetworkMode (NetworkHandleType Channel);
Notification that the network management has entered Network Mode.
A função ComM_Nm_NetworkMode atua no gerenciador de comunicação AUTOSAR (ComM) como um callback de notificação com o qual o gerenciamento de rede (Nm) sinaliza que o modo de rede (Network Mode) foi assumido com sucesso [SWS_ComM_00390].
Chamada e parâmetros
A interface está disponível através do arquivo de cabeçalho ComM_Nm.h e possui a ID de serviço 0x18 [SWS_ComM_00390]. Durante a chamada, o canal de comunicação afetado é passado através do único parâmetro de entrada Channel do tipo NetworkHandleType [SWS_ComM_00390]. A função não retorna nenhum valor de retorno (tipo de retorno void) e não possui parâmetros de saída [SWS_ComM_00390].
Simultaneidade e semântica
O comportamento de execução de ComM_Nm_NetworkMode é declarado como assíncrono (Asynchronous) [SWS_ComM_00390]. Em relação à concorrência, a função é especificada como reentrante (Reentrant), de modo que pode ser chamada de forma reentrante para eventos de canais paralelos [SWS_ComM_00390].
Tratamento de erros
Como a assinatura não prevê valor de retorno, nenhum código de erro é transmitido diretamente ao chamador [SWS_ComM_00390].
Este texto foi gerado por uma IA e serve para orientação técnica.
Guia do implementador em breve (complexidade I1)
função ComM_Nm_PrepareBusSleepMode [SWS_ComM_00391] 📄 PDF
void ComM_Nm_PrepareBusSleepMode (NetworkHandleType Channel);
Notification that the network management has entered Prepare Bus - Sleep Mode.
A função ComM_Nm_PrepareBusSleepMode serve como interface de notificação do Communication Manager (ComM). Ela informa ao ComM que o gerenciamento de rede para o canal de comunicação especificado mudou para o estado “Prepare Bus - Sleep Mode” [SWS_ComM_00391].
Uso e assinatura
A interface está disponível através do arquivo de cabeçalho ComM_Nm.h e possui a ID de serviço 0x19 [SWS_ComM_00391]. A execução ocorre de forma assíncrona [SWS_ComM_00391]. A assinatura da função compreende os seguintes parâmetros:
Channel(In,NetworkHandleType): identifica o canal de rede afetado cujo gerenciamento de rede assumiu o modo Prepare Bus-Sleep [SWS_ComM_00391].- Valor de retorno:
void; não são retornados valores de status ou de erro e não são mantidos parâmetros de entrada/saída [SWS_ComM_00391].
Simultaneidade e restrições
Em relação à concorrência, ComM_Nm_PrepareBusSleepMode é especificada como reentrante, porém com a restrição vinculativa de que isso não se aplica ao mesmo canal NM (Reentrant (but not for the same NM - Channel)) [SWS_ComM_00391]. Chamadas para diferentes canais podem, portanto, ocorrer em paralelo, enquanto chamadas simultâneas para o mesmo canal devem ser excluídas.
Contexto de chamada e tratamento de erros
Interpretação: O contexto de chamada deve residir no Network Management genérico ou específico de barramento, o qual reporta o atingimento desse estado ao ComM. Pergunta Q-41524322db480310 (aberta) Códigos de erro específicos, mensagens DET ou DEM não estão definidos para esta interface na especificação [SWS_ComM_00391].
Este texto foi gerado por uma IA com base na especificação AUTOSAR R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_Nm_BusSleepMode [SWS_ComM_00392] 📄 PDF
void ComM_Nm_BusSleepMode (NetworkHandleType Channel);
Notification that the network management has entered Bus - Sleep Mode. This callback function should perform a transition of the hardware and transceiver to bus - sleep mode.
usar
A função de callback ComM_Nm_BusSleepMode serve como notificação ao módulo ComM de que o gerenciamento de rede mudou para o modo Bus-Sleep [SWS_ComM_00392]. Por meio desta chamada, a função deve realizar a transição do hardware correspondente bem como do transceptor para o modo Bus-Sleep [SWS_ComM_00392].
Interface e parâmetros
A função é disponibilizada através do arquivo de cabeçalho ComM_Nm.h e possui a ID de serviço 0x1a [SWS_ComM_00392]. A chamada ocorre através da assinatura void ComM_Nm_BusSleepMode (NetworkHandleType Channel) com as seguintes propriedades de parâmetros [SWS_ComM_00392]:
Channel: parâmetro de entrada do tipoNetworkHandleTypeque identifica o canal de comunicação afetado [SWS_ComM_00392].- Nem parâmetros de entrada/saída nem parâmetros de saída estão previstos para esta função [SWS_ComM_00392].
- Nenhum valor de retorno está definido (
void) [SWS_ComM_00392].
Simultaneidade e restrições
Em relação ao comportamento de execução e a possíveis restrições, o requisito especifica as seguintes condições de contorno [SWS_ComM_00392]:
- Semântica assíncrona: a chamada é classificada como assíncrona (Asynchronous) [SWS_ComM_00392].
- Reentrância: a função é definida como reentrante (Reentrant) [SWS_ComM_00392].
Este texto foi gerado por uma IA com base na especificação AUTOSAR R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_Nm_RestartIndication [SWS_ComM_00792] 📄 PDF
void ComM_Nm_RestartIndication (NetworkHandleType Channel);
If Nm If has started to shut down the coordinated busses, AND not all coordinated busses have indicated bus sleep state, AND on at least on one of the coordinated busses NM is restarted, THEN the NM Interface shall call the callback function Com M_ Nm_ Res tart Indication with the nm Network Handle of the channels which have already indicated bus sleep state.
A função de callback ComM_Nm_RestartIndication com o Service ID 0x1b é chamada pela interface NM e é declarada através do ficheiro de cabeçalho ComM_Nm.h [SWS_ComM_00792]. Destina-se a informar o Communication Manager sobre o reinício da gestão de rede durante um processo de desativação em curso de barramentos coordenados [SWS_ComM_00792]. O único parâmetro de entrada Channel do tipo NetworkHandleType identifica o canal afetado; a operação não devolve qualquer valor de retorno [SWS_ComM_00792].
A interface está especificada como assíncrona e reentrante [SWS_ComM_00792]. A sua chamada pela interface NM ocorre quando três condições se verificam em simultâneo:
- A interface NM já iniciou a desativação dos barramentos coordenados [SWS_ComM_00792].
- Nem todos estes barramentos coordenados reportaram ainda o estado de Bus-Sleep [SWS_ComM_00792].
- A gestão de rede é reiniciada em pelo menos um dos barramentos coordenados [SWS_ComM_00792].
Não estão previstos no excerto da especificação códigos de erro específicos, reações a erros ou notificações ao módulo de teste de desenvolvimento ou de memória de erros (DET/DEM) [SWS_ComM_00792]. Interpretação: a função deverá estar prevista no ComM para voltar a alinhar o estado interno de canais já adormecidos com a coordenação de barramentos reativada. Pergunta (aberta)
Esta nota de uso foi gerada automaticamente com base na especificação.
Guia do implementador em breve (complexidade I1)
função ComM_Nm_RepeatMessageLeftIndication [SWS_ComM_91024] 📄 PDF
void ComM_Nm_RepeatMessageLeftIndication (NetworkHandleType Channel);
Notification that the state of all
usar
A função ComM_Nm_RepeatMessageLeftIndication serve como interface de notificação que sinaliza ao ComM que o estado de todos os módulos NM de barramento (<Bus Nm>) saiu do estado Repeat Message [SWS_ComM_91024]. No âmbito da funcionalidade opcional de mapeamento dinâmico de Partial Network Clusters para canais (Dynamic PNC-to-channel-mapping), esta chamada indica que a fase de aprendizagem termina [SWS_ComM_91024].
A interface é declarada através do ficheiro de cabeçalho ComM_Nm.h e não possui valor de retorno (void) [SWS_ComM_91024]. O canal de comunicação afetado é transmitido como parâmetro de entrada:
Channel(In,NetworkHandleType): Identificação do canal para o qual a saída do estado é notificada [SWS_ComM_91024].
Interação e efeito funcional
O comportamento da indicação controla a fase de aprendizagem de PNC: Desde que o parâmetro de configuração ComMDynamicPncToChannelMappingEnabled esteja definido como TRUE e ComM_Nm_RepeatMessageLeftIndication seja chamado, o ComM define a fase de aprendizagem de PNC (PNC Learning Phase) para o respetivo canal como inativa [SWS_ComM_01029] [SWS_ComM_01046].
Simultaneidade e restrições
A interface é especificada como reentrante e apresenta uma semântica de execução assíncrona [SWS_ComM_91024]. Na presente especificação, o elemento está adicionalmente assinalado com o estado de desenvolvimento draft [SWS_ComM_91024].
Este texto foi criado por uma IA com base na especificação AUTOSAR.
Guia do implementador em breve (complexidade I1)
função ComM_Nm_PncLearningBitIndication [SWS_ComM_91026] 📄 PDF
void ComM_Nm_PncLearningBitIndication (NetworkHandleType Channel);
Service to indicate that an NM message with set PNC Learning Bit has been received. Tags: atp.Status=draft
A função ComM_Nm_PncLearningBitIndication serve como interface de notificação para o módulo ComM, a fim de indicar a recepção de uma mensagem NM com o bit de aprendizagem de PNC definido [SWS_ComM_91026]. A interface possui o ID de serviço 0x69, é disponibilizada através do arquivo de cabeçalho ComM_Nm.h e está identificada na especificação com o status «draft» [SWS_ComM_91026].
Em relação à utilização e assinatura, aplicam-se as seguintes definições:
- Parâmetros: Como parâmetro de entrada é passado
Channeldo tipoNetworkHandleType, que identifica o canal de comunicação afetado [SWS_ComM_91026]. Não existem parâmetros de entrada/saída nem parâmetros de saída, e o tipo de retorno évoid[SWS_ComM_91026]. - Concorrência: A chamada está especificada como assíncrona e reentrante [SWS_ComM_91026]. De acordo com o identificador e o cabeçalho, a chamada deve ocorrer tipicamente através do módulo NM subjacente, assim que uma mensagem NM correspondente tiver sido recebida. Pergunta Q-31b0ce30b88c71b6 (aberta)
- Tratamento de erros: No escopo da especificação, não estão documentados para este serviço nem valores de retorno nem códigos de erro específicos ou mensagens para DET ou DEM.
Em interação com o mapeamento dinâmico de PNC, a função controla a ativação da fase de aprendizagem: se ComM_Nm_PncLearningBitIndication for chamada em um canal para o qual o parâmetro de configuração ComMDynamicPncToChannelMappingEnabled estiver definido como TRUE, ComM deve definir a fase de aprendizagem de PNC (PNC Learning Phase) como ativa para este canal [SWS_ComM_01026]. Segundo a especificação, ComM também aciona o mesmo estado de uma fase de aprendizagem ativa no canal em questão quando o próprio módulo chama Nm_PnLearningRequest [SWS_ComM_01026].
Esta nota de uso foi gerada por uma IA com base nos requisitos da especificação.
Guia do implementador em breve (complexidade I1)
função ComM_Nm_ForwardSynchronizedPncShutdown [SWS_ComM_91003] 📄 PDF
void ComM_Nm_ForwardSynchronizedPncShutdown (NetworkHandleType Channel);
If an ECU in role of an intermediate PNC coordinator receives a PN shutdown message via a
A função síncrona e reentrante ComM_Nm_ForwardSynchronizedPncShutdown (Service-ID 0x6b) é declarada através do cabeçalho ComM_Nm.h e serve para o encaminhamento coordenado de um shutdown de PNC sincronizado [SWS_ComM_91003].
Utilização e contexto de chamada: É chamada quando uma unidade de comando eletrónica, no papel de coordenador de PNC intermediário (intermediate PNC coordinator), recebe uma mensagem de shutdown de PN através de um NM específico do barramento [SWS_ComM_91003]. O canal de comunicação afetado (Channel do tipo NetworkHandleType) é passado como único parâmetro de entrada. Não está definido nenhum valor de retorno (void) [SWS_ComM_91003].
Interação e sequência: Após a indicação, o ComM liberta de imediato as máquinas de estados de PNC afetadas. Além disso, encaminha diretamente as informações de PN para os canais ComM afetados, bem como para os canais NM correspondentes [SWS_ComM_91003]. Isto assegura um shutdown de PNC amplamente síncrono através da topologia hierárquica de PN, desde o coordenador de nível superior (Top-Level-Koordinator) até aos nós de PNC subordinados [SWS_ComM_91003].
Tratamento de erros e condições de contorno: Dado que a interface não apresenta valor de retorno e não se encontram documentados códigos de erro específicos, é provável que o tratamento de erros ocorra internamente ou através do DET. Pergunta Q-618a8c1da055cdf5 (aberta) O elemento está classificado como Draft no Release R20-11 [SWS_ComM_91003].
Esta nota de uso foi gerada automaticamente com base na especificação do AUTOSAR Classic R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_DCM_ActiveDiagnostic [SWS_ComM_00873] 📄 PDF
void ComM_DCM_ActiveDiagnostic (NetworkHandleType Channel);
Indication of active diagnostic by the DCM.
Utilização e contexto de chamada
A interface síncrona ComM_DCM_ActiveDiagnostic destina-se ao Diagnostic Communication Manager (DCM) para notificar o Communication Manager (ComM) sobre atividades de diagnóstico ativas em um determinado canal de comunicação [SWS_ComM_00873]. A função é definida no arquivo de cabeçalho ComM_Dcm.h e identificada com o ID de serviço 0x1f [SWS_ComM_00873].
Como único parâmetro de chamada, atua o parâmetro de entrada Channel do tipo de dados NetworkHandleType, que identifica univocamente o canal em questão para a comunicação de diagnóstico pendente [SWS_ComM_00873]. A interface não possui valor de retorno (tipo de retorno void), e não existem parâmetros de entrada/saída nem de saída [SWS_ComM_00873].
Simultaneidade e restrições
Quanto à concorrência, o elemento de serviço é especificado como reentrante [SWS_ComM_00873]. Isso permite chamadas síncronas paralelas da função a partir de diferentes contextos de execução, por exemplo, quando o DCM precisa gerenciar ou atender a múltiplos canais de rede simultaneamente.
Tratamento de erros e interação
Para esta chamada, não estão definidos códigos de erro específicos ou notificações para o gerenciamento de erros de desenvolvimento (DET), bem como para o gerenciamento de memória de erros de diagnóstico (DEM) [SWS_ComM_00873]. A interação restringe-se à troca de sinais entre o DCM e o ComM; interpretação: a chamada presumivelmente deve ser usada no ComM para manter o respectivo canal no estado de comunicação ativo durante o período da atividade de diagnóstico [SWS_ComM_00873]. Pergunta Q-bfd91da2e435fbb6 (aberta)
Esta nota de uso foi gerada automaticamente com base na especificação do AUTOSAR Classic Release R20-11.
função ComM_DCM_InactiveDiagnostic [SWS_ComM_00874] 📄 PDF
void ComM_DCM_InactiveDiagnostic (NetworkHandleType Channel);
Indication of inactive diagnostic by the DCM.
usar
A função síncrona ComM_DCM_InactiveDiagnostic serve para o Diagnostic Communication Manager (DCM) indicar ao Communication Manager (ComM) que a comunicação de diagnóstico num determinado canal está inativa e já não é necessária [SWS_ComM_00874]. A declaração desta interface é disponibilizada através do ficheiro de cabeçalho ComM_Dcm.h com o Service ID 0x20 [SWS_ComM_00874].
Como parâmetro de entrada é passado Channel do tipo NetworkHandleType, que identifica o canal de comunicação em causa [SWS_ComM_00874]. A função não possui parâmetros de entrada/saída nem parâmetros de saída e não devolve qualquer valor (void) [SWS_ComM_00874].
Simultaneidade e tratamento de erros
A interface está especificada como reentrante [SWS_ComM_00874], pelo que são permitidas chamadas simultâneas – por exemplo, para diferentes canais de comunicação. Não estão definidos na carga útil códigos de erro específicos, mensagens de erro do DET ou eventos do DEM para esta função [SWS_ComM_00874]. O módulo ComM deverá utilizar internamente a notificação de inatividade para revogar pedidos de diagnóstico existentes para o canal e ajustar o estado do canal em conformidade. Pergunta Q-148d39d8c17e936c (aberta)
Este texto foi gerado por uma IA e resume a especificação com base no release AUTOSAR R20-11.
função ComM_EcuM_WakeUpIndication [SWS_ComM_00275] 📄 PDF
void ComM_EcuM_WakeUpIndication (NetworkHandleType Channel);
Notification of a wake up on the corresponding channel.
A função ComM_EcuM_WakeUpIndication serve para notificar o Communication Manager (ComM) sobre a ocorrência de um evento de wake-up no respectivo canal de comunicação afetado [SWS_ComM_00275]. A chamada deve ser realizada tipicamente pelo ECU State Manager (EcuM), assim que este tiver registrado um wake-up correspondente em um canal. Pergunta Q-5f8c43b9df10dc8e (aberta)
Utilização e contexto de chamada
A interface é definida de forma síncrona e possui a ID de serviço 0x2a [SWS_ComM_00275]. Através do parâmetro de entrada Channel do tipo NetworkHandleType, é passado o identificador do canal de comunicação no qual o wake-up foi detectado [SWS_ComM_00275]. A função não possui valor de retorno (void) e é declarada através do arquivo de cabeçalho ComM_EcuM.h [SWS_ComM_00275].
Simultaneidade e restrições
De acordo com a especificação, ComM_EcuM_WakeUpIndication é classificada como reentrante [SWS_ComM_00275]. Assim, a função pode ser chamada em paralelo para diferentes canais ou a partir de contextos concorrentes. Códigos de erro específicos, valores de retorno ou mensagens DET/DEM não estão indicados na definição do elemento [SWS_ComM_00275].
Este texto foi gerado por uma IA. Todas as informações provêm exclusivamente do payload de especificação da release R20-11 do AUTOSAR.
função ComM_EcuM_PNCWakeUpIndication [SWS_ComM_91001] 📄 PDF
void ComM_EcuM_PNCWakeUpIndication (PNCHandleType PNCid);
Notification of a wake up on the corresponding partial network cluster.
Utilização e contexto de chamada
A função síncrona ComM_EcuM_PNCWakeUpIndication destina-se à notificação do Communication Manager sobre um wake-up em um Partial Network Cluster (PNC) [SWS_ComM_91001]. Ela é declarada por meio do cabeçalho ComM_EcuM.h e espera como parâmetro de entrada PNCid a identificação do cluster afetado; não existem valores de retorno [SWS_ComM_91001]. Interpretação: a chamada ocorre tipicamente por meio do ECU State Manager (EcuM) na detecção de um evento de PNC correspondente. Pergunta Q-fee4a70f73cde8ea (aberta)
Concorrência e transições de estado
A interface é especificada como reentrante [SWS_ComM_91001]. Sua chamada causa mudanças de estado direcionadas dentro das máquinas de estados de PNC e de canal do ComM:
- Se o cluster referenciado estiver no estado principal de PNC
PNC_NO_COMMUNICATION, este será abandonado e ocorrerá uma transição para o subestado de PNCPNC_PREPARE_SLEEP[SWS_ComM_00964]. - Se a chamada ocorrer no subestado
COMM_NO_COM_NO_PENDING_REQUESTcom suporte a PNC ativado (ComMPncSupport=TRUE) e wake-up síncrono desativado (ComMSynchronousWakeUp=FALSE), o módulo transiciona para o subestadoCOMM_NO_COM_REQUEST_PENDINGaquelas máquinas de estados de canal do ComM que são referenciadas pelo PNC especificado [SWS_ComM_01014]. - Se, por outro lado,
ComMSynchronousWakeUp=TRUEestiver configurado comComMPncSupportativo, a chamada no subestadoCOMM_NO_COM_NO_PENDING_REQUESTcomuta, sem exceção, todas as máquinas de estados de canal do ComM para o subestadoCOMM_NO_COM_REQUEST_PENDING[SWS_ComM_01015].
Este texto foi gerado por uma IA com base na especificação AUTOSAR Classic R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_CommunicationAllowed [SWS_ComM_00871] 📄 PDF
void ComM_CommunicationAllowed (NetworkHandleType Channel, boolean Allowed);
Ecu M or Bsw M shall indicate to Com M when communication is allowed. If Ecu M/ Flex is used: Bsw M AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager
Por meio da função ComM_CommunicationAllowed ([SWS_ComM_00871]), é indicado ao módulo ComM, por meio do EcuM ou BswM, se a comunicação para um determinado canal está liberada.
Utilização e contexto de chamada
A interface é chamada pelo módulo EcuM ou BswM; caso seja utilizado o EcuM Flex, o BswM assume essa tarefa ([SWS_ComM_00871]). A função é declarada por meio do cabeçalho ComM_BswM.h e possui o ID de serviço 0x35 ([SWS_ComM_00871]).
A função não possui valor de retorno (void) e espera os seguintes parâmetros de passagem ([SWS_ComM_00871]):
Channel(tipoNetworkHandleType): Designa o canal de comunicação em questão ([SWS_ComM_00871]).Allowed(tipoboolean): Passa o status de liberação comTRUEpara comunicação permitida ouFALSEpara comunicação não permitida ([SWS_ComM_00871]).
Simultaneidade e restrições
De acordo com a especificação, a função opera de forma assíncrona (Asynchronous) e está classificada como não reentrante (Non Reentrant) ([SWS_ComM_00871]). Devido à não reentrância, presume-se que o chamador deva garantir que não ocorram chamadas paralelas ou de interrupção para a interface. Pergunta Q-e6688e3286d9ed60 (aberta)
Esta nota de uso foi gerada automaticamente com base na especificação SWS_ComM_00871.
função ComM_BusSM_ModeIndication [SWS_ComM_00675] 📄 PDF
void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode);
Indication of the actual bus mode by the corresponding Bus State Manager. Com M shall propagate the indicated state to the users with means of the RTE and Bsw M.
Uso e assinatura
A interface ComM_BusSM_ModeIndication serve para a indicação do modo de barramento real pelo Bus State Manager competente ao módulo ComM [SWS_ComM_00675]. A função C está disponível através do cabeçalho ComM.h e é gerida sob o Service ID 0x33 [SWS_ComM_00675]. A sua sintaxe é void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode) [SWS_ComM_00675].
A função recebe dois parâmetros de entrada:
Channel: o canal de comunicação afetado do tipoNetworkHandleType[SWS_ComM_00675].ComMode: o modo real do barramento do tipoComM_ModeType[SWS_ComM_00675].
A interface não possui valor de retorno (void) e não define parâmetros de entrada/saída nem parâmetros puramente de saída [SWS_ComM_00675].
Simultaneidade e sincronização
Para o comportamento em tempo de execução, está estabelecido que a chamada ocorre de forma assíncrona (Asynchronous) e que a função pode ser executada de forma reentrante (Reentrant) [SWS_ComM_00675].
Interação no sistema global
O módulo ComM encaminha o estado comunicado através desta chamada aos utilizadores [SWS_ComM_00675]. Esta propagação do estado do barramento processa-se através das interfaces da RTE e do BswM [SWS_ComM_00675].
Esta nota de uso foi gerada de forma automatizada com base na especificação do AUTOSAR Classic R20-11.
Guia do implementador em breve (complexidade I1)
função ComM_BusSM_BusSleepMode [SWS_ComM_91000] 📄 PDF
void ComM_BusSM_BusSleepMode (NetworkHandleType Channel);
Notification of the corresponding Bus State Manager that the actual bus mode is Bus - Sleep. Only applicable for Com M channels with Com MNm Variant set to SLAVE_ ACTIVE or SLAVE_ PASSIVE. E.g. LIN slaves (Com MNMVariant = SLAVE_ ACTIVE) or Ethernet channels with OA TC10 compliant Ethernet hardware which act as passive communication slave (Com MNMVariant = SLAVE_ PASSIVE and Eth Trcv Act As Slave Passive Enabled set to TRUE)
usar
A função de serviço síncrona ComM_BusSM_BusSleepMode serve ao Bus State Manager (BusSM) competente como notificação ao Communication Manager (ComM) de que o modo de barramento real de um canal de comunicação mudou para o estado Bus-Sleep [SWS_ComM_91000]. A identificação do canal afetado é efetuada através do parâmetro de entrada Channel do tipo NetworkHandleType [SWS_ComM_91000]. A função não declara parâmetros de saída nem um valor de retorno (void) [SWS_ComM_91000].
Validade dependente da configuração
A chamada não é universalmente permitida, estando explicitamente restrita a canais ComM cujo parâmetro ComMNmVariant esteja definido para SLAVE_ACTIVE ou SLAVE_PASSIVE [SWS_ComM_91000]. A especificação cita para tal dois cenários de utilização típicos:
- Escravos LIN com a configuração
ComMNmVariant = SLAVE_ACTIVE[SWS_ComM_91000]. - Canais Ethernet com hardware de acordo com OPEN Alliance TC10 que são operados como escravos de comunicação passivos, em que
ComMNmVariant = SLAVE_PASSIVEe o parâmetroEthTrcvActAsSlavePassiveEnabledestão fixados emTRUE[SWS_ComM_91000].
Simultaneidade e integração
A interface possui o Service ID 0x34, é declarada através do ficheiro de cabeçalho ComM.h e está classificada como reentrante [SWS_ComM_91000]. Não são indicados na definição da função códigos de erro específicos ou um comportamento particular em caso de erro [SWS_ComM_91000].
Esta nota de uso foi gerada automaticamente com base na especificação AUTOSAR CP R20-11.
Guia do implementador em breve (complexidade I1)
tipo ComM_InitStatusType [SWS_ComM_00668] 📄 PDF
Initialization status of Com M.
O tipo de enumeração ComM_InitStatusType serve para representar o estado de inicialização do módulo ComM (COM Manager) e está disponível através do ficheiro de cabeçalho ComM.h [SWS_ComM_00668].
O intervalo de valores compreende exatamente dois estados para distinguir a prontidão operacional [SWS_ComM_00668]:
COMM_UNINIT(codificado com o valor0x00ou0): indica que o COM Manager não está inicializado ou não pode ser utilizado. Este estado é obrigatoriamente o valor predefinido diretamente após um reset [SWS_ComM_00668].COMM_INIT(codificado com o valor0x01): indica que o COM Manager foi devidamente inicializado e está pronto para operação [SWS_ComM_00668].
No que diz respeito à sequência temporal e à utilização do módulo, este estado assinala a usabilidade fundamental do COM Manager [SWS_ComM_00668]. Interpretação: os chamadores ou as rotinas internas do módulo deverão avaliar este estado para garantir que nenhum pedido de comunicação é processado no estado COMM_UNINIT, uma vez que o COM Manager está explicitamente especificado como não utilizável neste estado [SWS_ComM_00668]. Pergunta Q-2c4da2e5c40a0f4b (aberta) O módulo só fica disponível para interações de nível superior após a transição bem-sucedida para COMM_INIT.
Este texto foi gerado por uma IA; apenas a especificação é vinculativa.
Guia do implementador em breve (complexidade I1)
tipo ComM_PncModeType [SWS_ComM_00673] 📄 PDF
Current mode of a PNC
O tipo de enumeração ComM_PncModeType define o estado de operação atual de um Partial Network Cluster (PNC) no Communication Manager [SWS_ComM_00673]. O tipo é disponibilizado através do ficheiro de cabeçalho ComM.h e compreende cinco estados discretos [SWS_ComM_00673]:
COMM_PNC_REQUESTED(0x00): o PNC é solicitado por um utilizador ComM local.COMM_PNC_READY_SLEEP(0x01): o PNC é solicitado por um utilizador ComM remoto.COMM_PNC_PREPARE_SLEEP(0x02): o PNC está ativo, mas sem monitorização de prazos (Deadline Monitoring).COMM_PNC_NO_COMMUNICATION(0x03): não ocorre comunicação para o PNC.COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST(0x04): pedido local de PNC com solicitação adicional de despertar de hardware ao BswM.
Na interação com o BswM, o modo COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST serve para sinalizar que um pedido ativo deve desencadear adicionalmente o despertar do hardware de comunicação [SWS_ComM_00673]. Isto pressupõe que a funcionalidade é suportada e configurada, por exemplo, no comutamento de portas de switches Ethernet de acordo com OA TC10 [SWS_ComM_00673]. Como restrição, deve ter-se em conta que este modo está assinalado com o estado draft no release R20-11 [SWS_ComM_00673].
Dado que se trata de uma definição de tipo pura, não existem para ComM_PncModeType rotinas próprias de tratamento de erros nem requisitos de reentrância.
Interpretação: uma vez que o tipo está declarado em ComM.h e o BswM é endereçado como destinatário das informações de modo, o tipo de dados deverá ser utilizado de forma transmodular como parâmetro de interface para notificações de estado do PNC. Pergunta Q-88ad945ffcf90e9e (aberta)
Este texto foi gerado por uma IA com base na especificação AUTOSAR CP R20-11.
Guia do implementador em breve (complexidade I1)
tipo ComM_StateType [SWS_ComM_00674] 📄 PDF
State and sub - state of Com M state machine Com M states vs. Communication Modes: COMM_ NO_ COM* : Communication Mode='No Communication' COMM_ FULL_ COM*: Communication Mode='Full Communication' COMM_ SILENT_ COM: Communicatio Mode='Silent Communication'
Uso e definição
O tipo ComM_StateType representa os estados e subestados da máquina de estados interna do Communication Manager (ComM) na AUTOSAR Classic Platform [SWS_ComM_00674]. Ele é definido como um tipo independente com base no tipo padrão uint8 e é disponibilizado por meio do arquivo de cabeçalho ComM.h para componentes de software e módulos BSW [SWS_ComM_00674].
Faixa de valores e subestados
A faixa de valores abrange cinco valores fixos, que mapeiam a fase exata da máquina de estados de comunicação [SWS_ComM_00674]:
COMM_NO_COM_NO_PENDING_REQUEST(valor 0): Identifica o estado dentro de No Communication quando atualmente não há solicitação de comunicação [SWS_ComM_00674].COMM_NO_COM_REQUEST_PENDING(valor 1): Identifica o estado dentro de No Communication enquanto uma solicitação de comunicação está pendente [SWS_ComM_00674].COMM_FULL_COM_NETWORK_REQUESTED(valor 2): Identifica o estado dentro de Full Communication no qual a rede está ativamente solicitada [SWS_ComM_00674].COMM_FULL_COM_READY_SLEEP(valor 3): Identifica o estado dentro de Full Communication no qual não existem mais solicitações ativas e a rede está pronta para entrar em modo de suspensão [SWS_ComM_00674].COMM_SILENT_COM(valor 4): Corresponde ao modo de comunicação Silent Communication [SWS_ComM_00674].
Mapeamento para os modos de comunicação
Os valores de ComM_StateType estão em relação direta com os modos de comunicação de nível superior (Communication Modes) do ComM [SWS_ComM_00674]. Todos os estados com o prefixo COMM_NO_COM* estão atribuídos ao modo No Communication, enquanto os estados com o prefixo COMM_FULL_COM* correspondem ao modo Full Communication [SWS_ComM_00674]. O valor COMM_SILENT_COM mapeia o modo de comunicação homônimo Silent Communication [SWS_ComM_00674].
Esta nota de uso foi gerada automaticamente com base na especificação R20-11.
Guia do implementador em breve (complexidade I1)
tipo ComM_ConfigType [SWS_ComM_00162] 📄 PDF
This type contains the implementation - specific post build configuration structure.
tipo ComM_ModeType [SWS_ComM_00672] 📄 PDF
Current mode of the Communication Manager (main state of the state machine).
O tipo de dados ComM_ModeType mapeia o modo de comunicação atual e, com isso, o estado primário da máquina de estados do canal ComM no Communication Manager [SWS_ComM_00672]. É derivado do tipo base uint8 e é disponibilizado através do cabeçalho Rte_ComM_Type.h para utilização por componentes de software e outros módulos BSW [SWS_ComM_00672].
O intervalo de valores compreende quatro modos de operação discretos, que definem a capacidade de comunicação do respetivo canal [SWS_ComM_00672]:
COMM_NO_COMMUNICATION(0): o canal configurado encontra-se no estado de repouso e não possui capacidade de transmissão nem de receção [SWS_ComM_00672].COMM_SILENT_COMMUNICATION(1): o canal está limitado à capacidade de receção passiva; o envio de mensagens está impedido [SWS_ComM_00672].COMM_FULL_COMMUNICATION(2): o canal encontra-se em operação de comunicação total com capacidade ativa de transmissão e receção [SWS_ComM_00672].COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST(3): o canal dispõe de capacidade de transmissão e receção para a camada inferior, por exemplo, para hardware Ethernet em conformidade com OPEN Alliance TC10 [SWS_ComM_00672].
Na utilização aplicam-se restrições funcionais essenciais: o modo COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST está assinalado com a tag atp.Status=draft e destina-se expressamente ao uso puramente interno dentro da máquina de estados do canal ComM [SWS_ComM_00672]. Utilizadores externos ou componentes de software sobrejacentes presumivelmente não devem, por isso, solicitar este estado como modo de destino nem esperá-lo diretamente através de interfaces. Pergunta Q-e5f4abe0d6543c82 (aberta) Não estão definidos para este tipo códigos de erro específicos, verificações em tempo de execução ou notificações ao DET ou DEM [SWS_ComM_00672].
Esta nota de utilização foi gerada automaticamente e baseia-se nas especificações do AUTOSAR Classic R20-11.
Guia do implementador em breve (complexidade I1)
tipo ComM_UserHandleType [SWS_ComM_00670] 📄 PDF
Handle to identify a user. For each user, a unique value must be defined at system generation time. Maximum number of users is 255. Legal user IDs are in the range 0 .. 254; user ID 255 is reserved and shall have the symbolic representation COMM_ NOT_ USED _ USER_ ID.
tipo ComM_UserHandleArrayType [SWS_ComM_00906] 📄 PDF
number Of Requesters contains the number of valid user handle entries in the "handle Array" member. If no user keeps the channel requested, this is zero {LOWER - LIMIT=0, UPPER - LIMIT= MAX_ CHANNEL_ REQUESTER }
tipo ComM_UserHandleSubArrayType [SWS_ComM_01005] 📄 PDF
This element contains the user handles of the users which keep the channel requested (if any), starting in its first entries. The size of the array MAX_ CHANNE L_ REQUESTERS is the maximum of the number of users requesting a channel.
tipo ComM_PncMembershipType [SWS_ComM_91103] 📄 PDF
Array of uint8 with
tipo modeLimitation [SWS_ComM_01009] 📄 PDF
-
O elemento de especificação modeLimitation está definido de acordo com [SWS_ComM_01009] como porta fornecida (Provided Port) do gestor de comunicações (ComM) para a interface ComM_ECUModeLimitation. Interpretação: através desta interface de porta, o módulo ComM deverá disponibilizar a componentes de software de nível superior ou ao BswM mecanismos para a limitação orientada dos modos de comunicação ativos ao nível da ECU, de modo a salvaguardar, por exemplo, o consumo de corrente ou os modos de operação. Pergunta Q-337c6b40bd72cf76 (aberta)
A disponibilização desta porta no sistema está sujeita a uma condição de variância explícita: de acordo com [SWS_ComM_01009], o elemento só está presente no sistema se a opção de configuração {ecuc(ComM/ComMGeneral.ComMModeLimitationEnabled)} == true estiver definida. Presumivelmente, a desativação deste parâmetro faz com que a porta seja omitida durante a geração de código. Pergunta (aberta) Os componentes de aplicação e de software básico só devem, portanto, ligar arquiteturalmente esta interface se a opção estiver ativada.
No que diz respeito a operações de interface concretas, parâmetros, reentrância bem como mensagens de erro ao DET ou DEM, [SWS_ComM_01009] não contém determinações específicas. Os integradores devem, por isso, assegurar sobretudo que a configuração necessária no contentor ComMGeneral está ativada antes de os componentes serem ligados à porta modeLimitation.
Este texto foi gerado por uma IA com base na especificação SWS_ComM_01009.
Guia do implementador em breve (complexidade I1)
tipo ComMMode [SWS_ComM_01012] 📄 PDF
-
O tipo ComMMode está especificado no módulo ComM como Mode Declaration Group [SWS_ComM_01012]. O elemento está atribuído à categoria ALPHABETIC_ORDER e define os modos de comunicação fundamentais do módulo [SWS_ComM_01012].
O grupo compreende três estados vinculativos [SWS_ComM_01012]:
COMM_NO_COMMUNICATION: serve como modo inicial do grupo [SWS_ComM_01012].COMM_SILENT_COMMUNICATION: representa um modo de comunicação passivo [SWS_ComM_01012].COMM_FULL_COMMUNICATION: identifica a operação de comunicação sem restrições [SWS_ComM_01012].
Como modo inicial está definido COMM_NO_COMMUNICATION, pelo que o sistema arranca por padrão sem comunicação ativa [SWS_ComM_01012]. Não está definido nenhum valor específico para transições (\"On transition value\") [SWS_ComM_01012]; Interpretação: isto significa presumivelmente que as mudanças de estado são executadas diretamente sem estados intermédios definidos. Pergunta Q-f0e73d26f85073b4 (aberta) Interpretação: os modos deverão representar o estado de comunicação de canais ou de utilizadores de comunicação no módulo. Pergunta Q-ef5fa29f6af152c7 (aberta) Interpretação: a categoria ALPHABETIC_ORDER deverá prescrever sobretudo a enumeração e representação padronizadas para as interfaces da RTE. Pergunta Q-12af3dde3a4cc95e (aberta)
Este texto foi criado por uma IA com base em SWS_ComM_01012.
Guia do implementador em breve (complexidade I1)
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_ComM- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_ComM@rel:R20-11#8e9e2acf- Content hash
8e9e2acf- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_COMManager.pdf#nameddest=SWS_ComM_00146
gemini-3.8-flash-low· 2026-10-13 · Original em alemão