cellular_module_urc_handler

Implement URC handler to handle URC event and call the corresponding callback function.

• CellularTokenTable_t::pCellularUrcHandlerTable : URC handler table of CellularAtParseTokenHandler_t
• CellularTokenTable_t::cellularPrefixToParserMapSize : The size of the URC handler table
  

Example URC handler table:

CellularAtParseTokenMap_t CellularUrcHandlerTable[] =
{
{ "CEREG",             Cellular_CommonUrcProcessCereg },
{ "CGREG",             Cellular_CommonUrcProcessCgreg },
{ "CREG",              Cellular_CommonUrcProcessCreg  },
{ "NORMAL POWER DOWN", _Cellular_ProcessPowerDown     },
}
uint32_t CellularUrcHandlerTableSize = 4;

There are two types of URC strings can be handled with this table:

• URC with prefix
  This type of URC string is of the following format:
  

  ‍<URC_leading_char><URC_prefix>":"<URC_payload>
  

  The logic to check the URC prefix can be referenced in Cellular_ATIsPrefixPresent
  Example of URC with prefix: "+CREG:2,0"
  In this example,
  URC_leading_char is "+"
  URC_prefix is "CREG"
  URC_payload is "2,0"
  The URC callback function, CellularAtParseTokenHandler_t, will be called with parameter pInputStr point to string URC_payload, "2,0" in this example.

  ‍The default prefix leading char can be referenced in this config CELLULAR_CHECK_IS_PREFIX_LEADING_CHAR.
  The default valid prefix string chars can be referenced in this config CELLULAR_CHECK_IS_PREFIX_CHAR.
  Reference Customization config for prefix string. for more information.

• URC without prefix
  This type of URC string is of fixed format.
  Example of URC without prefix : "NORMAL POWER DOWN"
  The URC callback function, CellularAtParseTokenHandler_t, will be called with parameter pInputStr point to URC string, "NORMAL POWER DOWN" in this example.