AMiRo-OS

$group("service") {

  /' Function type to be called when executing an RPC. '/

  $function("urt_servicefunc_t") {

    urt_servicefunc_t (arg : void*, ret : void*, timeout : urt_delay_t) : urt_status_t

  }

  /' Service structure type. '/

  $structure("urt_service_t") {

      'Pointer to the next service in a list.

    + {field} next : urt_service_t*

      'Identifier of the service.

    + {field} id : urt_serviceid_t

      'Mutex lock for exclusive access.'

    + {field} lock : urt_osMutex_t

      'Callback function to be executed by the service.

    + {field} callback : urt_servicefunc_t*

    .. URT_CFG_RPC_PROFLING == true ..

      'Sum of all durations.

    + {field} sumDurations : uint64_t

      'Number of executed calls.

    + {field} numCalls : uint64_t

      'Number of failed calls due to timeout.

    + {field} numTimeouts : uint64_t

    .. URT_CFG_RPC_PROFILING == true && URT_CFG_RPC_QOS_JITTERCHECKS == true ..

      'Minimum duration ever detected (to calculate jitter).

    + {field} minDuration : urt_delay_t

      'Maximum duration ever detected (to calculate jitter).

    + {field} maxDuration : urt_delay_t

    __

      'Initializes a urt_service_t object.

    + {method} urtServiceInit(service : urt_service_t*, id : urt_serviceid_t, callback : urt_servicefunc_t*) : urt_status_t

      'Executes an RPC with given arguments and return parameters as well as a timout, in case the RPC may delay execution significantly.

    + {method} urtServiceCall(service : urt_service_t*, arg : void*, ret : void*, timeout : urt_delay_t) : urt_status_t

  }

/' RPC core type. '/

$structure("urt_rpc_t") {

    'List of services ordered by their (initial) priority.

  - {field} {static} _services : urt_service_t*

    'Initializes the urt_core_t object.

  + {method} urtRpcInit (void) : urt_status_t

    'Retrieves a topic given an identifier.

  + {method} urtRpcRetrieveService (id : urt_serviceid_t) : urt_service_t*

urt_rpc_t "1" o-- "0..1" urt_service_t