Manage devices using gRPC API methods (ConfigurationService)

Axxon One 구성 설정은 ConfigurationService.proto 프로토 파일에 설명되어 있습니다.

사용되는 메서드는 2가지입니다.

  1. Changeconfig.
  2. ListConfig.

ChangeConfig 메서드

ChangeConfig 메서드는 시스템의 모든 객체를 생성, 편집 및 삭제할 수 있게 합니다.

이후, 모든 시스템 객체나 요소는 단위라고 불립니다.

입력 데이터

  1. added – 추가해야 할 단위 배열
  2. changed – 변경해야 할 단위 배열
  3. remove – 삭제해야 할 단위 배열

단위 구조

type 필드는 단위가 무엇인지를 결정합니다.

단위는 서브단위를 포함할 수 있습니다(units 필). 예를 들어, VideoChannel.0 단위는 하위 단위인  Streaming.0을 가질 수 있습니다.

각 단위는 uid 필드를 가집니다. 이는 단위 식별자로, 단위의 모든 "부모"들을 "/" 기호로 구분하여 구성됩니다. 예를 들어, Streaming.0 단위의 uid 필드는 다음과 같습니다: hosts/Node1/DeviceIpint.1/VideoChannel.0/Streaming.0.

여기서

추가적으로, 단위는 properties 필드에 설정을 여러 개 포함할 수 있습니다.

Output data

In response to the method, the following data will be received:

  1. failed – the units that could not be added.
  2. added – the uid of the successfully added unit.

ListConfig method

The method allows to get a list of units.

Input data

unit_uids is an array of the units' uids to be obtained.

Output data

  1. units is a list of successfully found units.
  2. unreachable_objects is a list of temporarily unavailable units.
  3. not_found_objects is a list of not found units.

The units field is of UnitDescriptor type.

Data parameters:

  1. uid is a unit identifier, which consists of all the "parents" of the unit, separated by the "/" symbol. For example, the uid field of the Streaming.0 unit will be as follows: hosts/Node1/DeviceIpint.1/VideoChannel.0/Streaming.0.
  2. display_id is a short id, which is usually unique in a parent scope. For example, for a DeviceIpint.1 unit, the field display_id == 1 (sometimes type can go together with it).
  3. type is a unit type. For example, for a DeviceIpint.1 unit, the field type == DeviceIpint.
  4. properties is a list of unit settings.
  5. units are included units that can have either a full description or a short one. In this case, the field stripped == true, and the only fields that are available from the description are: display_id, type, uid.
  6. factory are included units that can be created for a given unit. The available fields are:
    1. type – a type of subunit that can be created;
    2. properties – a list of subunit properties.