Using RSC services

You have the option of using the already registered RSC services of the SDK via theServiceManager. TheServiceManager acts as the RSC API and is used to request services. 

Note: From firmware release 2022.0 LTS on, RSC services can also communicate via gRPC.

Application

RSC services are available for the following areas:

  • Axioline services: Read and write access to data and information from Axioline devices
  • PROFINET services: Read and write access to data and information from PROFINET devices
  • Device interface services: Access to information and properties of the Operating System and controller hardware 
  • GDS services: Read and write access to the data of the GDS

Implementation

  • Use the#include command in the header file to include the ServiceManager class and the desired service interface (e.g., IDeviceStatusService). 
    Header file exampleClick to see an header file example
    #pragma once
    #include "Arp/System/Core/Arp.h"
    #include "Arp/System/Acf/ComponentBase.hpp"
    #include "Arp/System/Acf/IApplication.hpp"
    #include "Arp/System/Acf/IControllerComponent.hpp"
    #include "Arp/System/Commons/Logging.h"
    #include "Arp/System/Rsc/ServiceManager.hpp"
    #include "Arp/System/Commons/Threading/WorkerThread.hpp"
    #include "Arp/Device/Interface/Services/IDeviceStatusService.hpp"
  • Initialize a pointer to the object matching the desired service by calling the GetService() method of theServiceManager.
  • Pass on the name of the corresponding interface as the template argument.
  • Place this call in theSubscribeServices() method of your component.
    Click to see an implementation exampleClick to see an implementation example
    class ExampleComponent : public .....
        {
       ...
       private: //services
     IDeviceStatusService::Ptr deviceStatusService;
      ...
       }
    
    #include....
        using namespace Arp::System::Rsc;
      using namespace Arp ...
       void ExampleComponent::SubscribeServices()
        {
       
      // Get service handle
      this->deviceStatusService = ServiceManager::GetService<IDeviceStatusService>();
    }
Note: The execution of RSC services can take some time (in particular Axioline and PROFINET services). For this reason, avoid direct calls from ESM tasks.

 

Tip: Phoenix Contact provides a free-of-charge online E-Learning class for programming C++ function extensions that use RSC services.

 

 


• Published/reviewed: 2024-10-30   ☀  Revision 074 •