trcStateMachine.c 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. /*
  2. * Trace Recorder for Tracealyzer v4.9.2
  3. * Copyright 2023 Percepio AB
  4. * www.percepio.com
  5. *
  6. * SPDX-License-Identifier: Apache-2.0
  7. *
  8. * The implementation of state machines.
  9. */
  10. #include <trcRecorder.h>
  11. #if (TRC_USE_TRACEALYZER_RECORDER == 1) && (TRC_CFG_RECORDER_MODE == TRC_RECORDER_MODE_STREAMING)
  12. #define TRC_STATE_MACHINE_STATE_INDEX 0u
  13. #define TRC_STATE_MACHINE_INDEX 0u
  14. /*cstat !MISRAC2004-6.3 !MISRAC2012-Dir-4.6_a Suppress basic char type usage*/
  15. traceResult xTraceStateMachineCreate(const char *szName, TraceStateMachineHandle_t *pxStateMachineHandle)
  16. {
  17. TraceObjectHandle_t xObjectHandle;
  18. /* This should never fail */
  19. TRC_ASSERT(pxStateMachineHandle != (void*)0);
  20. /* We need to check this */
  21. if (xTraceObjectRegister(PSF_EVENT_STATEMACHINE_CREATE , (void*)0, szName, 0u, &xObjectHandle) == TRC_FAIL)
  22. {
  23. return TRC_FAIL;
  24. }
  25. /* This should never fail */
  26. TRC_ASSERT_ALWAYS_EVALUATE(xTraceEntrySetOptions((TraceEntryHandle_t)xObjectHandle, (uint32_t)TRC_ENTRY_OPTION_STATE_MACHINE) == TRC_SUCCESS);
  27. *pxStateMachineHandle = (TraceStateMachineHandle_t)xObjectHandle;
  28. return TRC_SUCCESS;
  29. }
  30. /*cstat !MISRAC2004-6.3 !MISRAC2012-Dir-4.6_a Suppress basic char type usage*/
  31. traceResult xTraceStateMachineStateCreate(TraceStateMachineHandle_t xStateMachineHandle, const char* szName, TraceStateMachineStateHandle_t* pxStateHandle)
  32. {
  33. TraceObjectHandle_t xObjectHandle;
  34. /* This should never fail */
  35. TRC_ASSERT(xStateMachineHandle != 0);
  36. /* This should never fail */
  37. TRC_ASSERT(pxStateHandle != (void*)0);
  38. /* We need to check this */
  39. if (xTraceObjectRegister(PSF_EVENT_STATEMACHINE_STATE_CREATE, (void*)0, szName, (TraceUnsignedBaseType_t)xStateMachineHandle, &xObjectHandle) == TRC_FAIL) /*cstat !MISRAC2004-11.3 !MISRAC2012-Rule-11.4 Suppress conversion from pointer to integer check*/
  40. {
  41. return TRC_FAIL;
  42. }
  43. /* This should never fail */
  44. TRC_ASSERT_ALWAYS_EVALUATE(xTraceEntrySetOptions((TraceEntryHandle_t)xObjectHandle, (uint32_t)TRC_ENTRY_OPTION_STATE_MACHINE_STATE) == TRC_SUCCESS);
  45. *pxStateHandle = (TraceStateMachineHandle_t)xObjectHandle;
  46. return TRC_SUCCESS;
  47. }
  48. traceResult xTraceStateMachineSetState(TraceStateMachineHandle_t xStateMachineHandle, TraceStateMachineStateHandle_t xStateHandle)
  49. {
  50. /* This should never fail */
  51. TRC_ASSERT(xStateMachineHandle != 0);
  52. /* This should never fail */
  53. TRC_ASSERT(xStateHandle != 0);
  54. /* Verify that this state machine state was meant to be used with this state machine */
  55. /* This should never fail */
  56. TRC_ASSERT(xStateMachineHandle == (TraceStateMachineHandle_t)xTraceEntryGetStateReturn((TraceEntryHandle_t)xStateHandle, TRC_STATE_MACHINE_INDEX));
  57. /* This should never fail */
  58. TRC_ASSERT_ALWAYS_EVALUATE(xTraceEntrySetState((TraceEntryHandle_t)xStateMachineHandle, TRC_STATE_MACHINE_STATE_INDEX, (TraceUnsignedBaseType_t)xStateHandle) == TRC_SUCCESS); /*cstat !MISRAC2004-11.3 !MISRAC2012-Rule-11.4 Suppress conversion from pointer to integer check*/
  59. (void)xTraceEventCreate2(PSF_EVENT_STATEMACHINE_STATECHANGE, (TraceUnsignedBaseType_t)xStateMachineHandle, (TraceUnsignedBaseType_t)xStateHandle); /*cstat !MISRAC2004-11.3 !MISRAC2012-Rule-11.4 Suppress conversion from pointer to integer check*/
  60. return TRC_SUCCESS;
  61. }
  62. #endif