RI_SDK_sensor_VoltageSensor_Extend

Информация

RI_SDK - библиотека Robo Intellect Software Development Kit
sensor - название группы устройств датчиков
VoltageSensor - название устройства датчика тока, напряжения и мощности
Extend - название метода расширения компонента группы датчиков до датчика тока, напряжения и мощности

Сигнатура функции

Shared object

RI_SDK_sensor_VoltageSensor_Extend(sensor, descriptor, errorText):errorCode

Golang gRPC

RI_SDK_Sensor_VoltageSensor_Extend(sensor, descriptor) (errorText string, errorCode int64, err error)

Описание метода

Расширения компонента группы датчиков до датчика тока, напряжения и мощности.

Расширяет компонент группы датчиков с дескриптором sensor до компонента датчика тока, напряжения и мощности. Записывает новый дескриптор в descriptor

Параметры и возвращаемые значения

Параметр	Тип для Shared object	Тип для Golang gRPC	Описание
sensor	int (тип C)	int64	Компонент группы, который будет расширятся
descriptor	*int (тип C)	int64	Указатель на компонент датчика тока, напряжения и мощности, который получится в результате расширения
errorText	char[1000] (тип C)	string	Текст ошибки (передается как параметр, если происходит ошибка метод записывает в этот параметр текст ошибки)
errorCode	int (тип C)	int64	Код ошибки

Примеры

Пример №1 - Расширение компонента группы датчиков до датчика тока, напряжения и мощности

В данном примере осуществляется расширение компонента группы датчиков с дескриптором sensor до датчика тока, напряжения и мощности. В конце выводится значение дескриптора расширенного компонента.

Python

# Расширение компонента группы датчиков до датчика тока, напряжения и мощности
errCode = lib.RI_SDK_sensor_VoltageSensor_Extend(sensor, descriptor, errTextC)
if errCode != 0:
    print(errCode, errTextC.raw.decode())
    sys.exit(2)

    

C

      // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
      errCode = RI_SDK_sensor_VoltageSensor_Extend(sensorGroupDescriptor, &sensorDescriptor, errorText);
      if (errCode) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

C++

      // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
      errCode = RI_SDK_sensor_VoltageSensor_Extend(sensorGroupDescriptor, &sensorDescriptor, errorText);
      if (errCode) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

Golang

        // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
        errCode = C.sensor_VoltageSensor_Extend(sensorGroupDescriptor, &sensorDescriptor, &errorText[0])
        if errCode!=0 {
        fmt.Printf("errorCode:%d - errorText:%s\n", errCode, C.GoString(&errorText[0]))
        return
    }

Golang gRPC

      // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
      sensorDescriptor, errText, errCode, err := client.RoboSdkApi.RI_SDK_Sensor_VoltageSensor_Extend(sensorGroupDescriptor)
      if errText != "" || errCode != 0 || err != nil {
      fmt.Printf("errText: %s; errCode:%d; err: %s", errText, errCode, err)
      return
  }

PHP

        // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
        $errCode = $ffi->RI_SDK_sensor_VoltageSensor_Extend($sensorGroupDescriptor->cdata, FFI::addr($sensorDescriptor), $errorText);
        if ($errCode) {
        print("errorText:" . FFI::string($errorText) . " errCode: " . $errCode . " \n");
        return;
    }

Полный текст примера

Python

from ctypes.util import find_library
import platform
import sys
from ctypes import *

# Подключаем внешнюю библиотеку для работы с SDK
platform = platform.system()
if platform == "Windows":
    libName = "librisdk.dll"
if platform == "Linux":
    libName = "librisdk.so"

pathLib = find_library(libName)
lib = cdll.LoadLibrary(pathLib)


# Указываем типы аргументов для функций библиотеки RI_SDK
lib.RI_SDK_InitSDK.argtypes = [c_int, c_char_p]
lib.RI_SDK_CreateGroupComponent.argtypes = [c_char_p, POINTER(c_int), c_char_p]
lib.RI_SDK_sensor_VoltageSensor_Extend.argtypes = [c_int, POINTER(c_int), c_char_p]

def main():
    errTextC = create_string_buffer(1000)  # Текст ошибки. C type: char*
    sensor = c_int()
    descriptor = c_int()

    # Инициализация библиотеки RI SDK с уровнем логирования 3
    errCode = lib.RI_SDK_InitSDK(3, errTextC)
    if errCode != 0:
        print(errCode, errTextC.raw.decode())
        sys.exit(2)

    # Создание компонента группы датчиков
    errCode = lib.RI_SDK_CreateGroupComponent("sensor".encode(), sensor, errTextC)
    if errCode != 0:
        print(errCode, errTextC.raw.decode())
        sys.exit(2)

    print("sensor: ", sensor.value)

    # Расширение компонента группы датчиков до датчика тока, напряжения и мощности
    errCode = lib.RI_SDK_sensor_VoltageSensor_Extend(sensor, descriptor, errTextC)
    if errCode != 0:
        print(errCode, errTextC.raw.decode())
        sys.exit(2)

    print("descriptor: ", descriptor.value)

    print("Success")

main()

C

      #include <stdlib.h>
      #include <stdio.h>
      #include <string.h>
      #include <dlfcn.h>

      int (*RI_SDK_InitSDK)(int logLevel, char* errorText);

      int (*RI_SDK_CreateGroupComponent)(char* group, int* descriptor, char* errorText);

      int (*RI_SDK_sensor_VoltageSensor_Extend)(int exec, int* descriptor, char* errorText);

      int initLibrary() {
      void *handle;
      char *LIB_RISDK = getenv("LIB_RISDK");
      handle = dlopen(strcat(LIB_RISDK, "librisdk.so"), RTLD_NOW);
      if (!handle) {
      /* fail to load the library */
      fprintf(stderr, "Error: %s\n", dlerror());
      return -1;
  }

      *(void **) (&RI_SDK_InitSDK) = dlsym(handle, "RI_SDK_InitSDK");
      *(void **) (&RI_SDK_CreateGroupComponent) = dlsym(handle, "RI_SDK_CreateGroupComponent");
      *(void **) (&RI_SDK_sensor_VoltageSensor_Extend) = dlsym(handle, "RI_SDK_sensor_VoltageSensor_Extend");
      return 0;
  }

      int main() {
      int initErr;
      initErr = initLibrary();
      if (initErr != 0) {
      printf("fail to load init library");
      return initErr;
  }

      char errorText[1000];
      int sensorGroupDescriptor;
      int sensorDescriptor;
      int errCode;
      // Инициализация библиотеки RI SDK
      errCode = RI_SDK_InitSDK(3, errorText);
      if (errCode != 0) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

      // Создание компонента группы датчиков
      errCode = RI_SDK_CreateGroupComponent("sensor", &sensorGroupDescriptor, errorText);
      if (errCode) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

      // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
      errCode = RI_SDK_sensor_VoltageSensor_Extend(sensorGroupDescriptor, &sensorDescriptor, errorText);
      if (errCode) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

      printf("sensorDescriptor: %d", sensorDescriptor);
      return 0;
  }

C++

      #include <stdlib.h>
      #include <stdio.h>
      #include <string.h>
      #include <dlfcn.h>

      int (*RI_SDK_InitSDK)(int logLevel, char *errorText);

      int (*RI_SDK_CreateGroupComponent)(char *group, int *descriptor, char *errorText);

      int (*RI_SDK_sensor_VoltageSensor_Extend)(int exec, int *descriptor, char *errorText);

      int initLibrary() {
      void *handle;
      char *LIB_RISDK = getenv("LIB_RISDK");
      handle = dlopen(strcat(LIB_RISDK, "librisdk.so"), RTLD_NOW);
      if (!handle) {
      /* fail to load the library */
      fprintf(stderr, "Error: %s\n", dlerror());
      return -1;
  }

      *(void **) (&RI_SDK_InitSDK) = dlsym(handle, "RI_SDK_InitSDK");
      *(void **) (&RI_SDK_CreateGroupComponent) = dlsym(handle, "RI_SDK_CreateGroupComponent");
      *(void **) (&RI_SDK_sensor_VoltageSensor_Extend) = dlsym(handle, "RI_SDK_sensor_VoltageSensor_Extend");
      return 0;
  }

      int main() {
      int initErr;
      initErr = initLibrary();
      if (initErr != 0) {
      printf("fail to load init library");
      return initErr;
  }

      char errorText[1000];
      int sensorGroupDescriptor;
      int sensorDescriptor;
      int errCode;
      // Инициализация библиотеки RI SDK
      errCode = RI_SDK_InitSDK(3, errorText);
      if (errCode != 0) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

      // Создание компонента группы датчиков
      char sensor[] = "sensor";
      errCode = RI_SDK_CreateGroupComponent(sensor, &sensorGroupDescriptor, errorText);
      if (errCode) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

      // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
      errCode = RI_SDK_sensor_VoltageSensor_Extend(sensorGroupDescriptor, &sensorDescriptor, errorText);
      if (errCode) {
      printf("errorText:%s\n", errorText);
      return errCode;
  }

      printf("sensorDescriptor: %d", sensorDescriptor);
      return 0;
  }

Golang

        package main

        /*
        #cgo LDFLAGS: -ldl
        #include <stdlib.h>
        #include <stdio.h>
        #include <string.h>
        #include <dlfcn.h>

        int (*RI_SDK_InitSDK)(int logLevel, char* errorText);

        int (*RI_SDK_CreateGroupComponent)(char* group, int* descriptor, char* errorText);

        int (*RI_SDK_sensor_VoltageSensor_Extend)(int exec, int* descriptor, char* errorText);

        int InitSDK(int logLevel, char* errorText){
        return RI_SDK_InitSDK(logLevel,errorText);
    }

        int CreateGroupComponent(char* group, int* descriptor, char* errorText){
        return RI_SDK_CreateGroupComponent(group,descriptor,errorText);
    }

        int sensor_VoltageSensor_Extend(int exec, int* descriptor, char* errorText){
        return RI_SDK_sensor_VoltageSensor_Extend(exec,descriptor,errorText);
    }

        int initLibrary() {
        void *handle;
        char *LIB_RISDK = getenv("LIB_RISDK");
        handle = dlopen(strcat(LIB_RISDK, "librisdk.so"), RTLD_NOW);
        if (!handle) {
        fprintf(stderr, "Error: %s\n", dlerror());
        return -1;
    }

        *(void **) (&RI_SDK_InitSDK) = dlsym(handle, "RI_SDK_InitSDK");
        *(void **) (&RI_SDK_CreateGroupComponent) = dlsym(handle, "RI_SDK_CreateGroupComponent");
        *(void **) (&RI_SDK_sensor_VoltageSensor_Extend) = dlsym(handle, "RI_SDK_sensor_VoltageSensor_Extend");
        return 0;
    }
        */
        import "C"
        import "fmt"

        func main() {
        var (
        initErr               C.int
        errorText             [1000]C.char
        sensorGroupDescriptor C.int
        sensorDescriptor      C.int
        errCode               C.int
        )

        initErr = C.initLibrary()
        if initErr != 0 {
        fmt.Println("fail to load init library")
        return
    }

        errCode = C.InitSDK(3, &errorText[0])
        if errCode != 0 {
        fmt.Printf("errorCode:%d - errorText:%s\n", errCode, C.GoString(&errorText[0]))
        return
    }

        // Создание компонента группы датчиков
        errCode = C.CreateGroupComponent(C.CString("sensor"), &sensorGroupDescriptor, &errorText[0])
        if errCode!=0 {
        fmt.Printf("errorCode:%d - errorText:%s\n", errCode, C.GoString(&errorText[0]))
        return
    }

        // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
        errCode = C.sensor_VoltageSensor_Extend(sensorGroupDescriptor, &sensorDescriptor, &errorText[0])
        if errCode!=0 {
        fmt.Printf("errorCode:%d - errorText:%s\n", errCode, C.GoString(&errorText[0]))
        return
    }

        fmt.Printf("sensorDescriptor: %d\n", sensorDescriptor)

        fmt.Println("Success")

    }

Golang gRPC

      package main

      import (
      "fmt"
      "github.com/rbs-ri/go-risdk"
      )

      func main() {
      //Открываем соединение для работы с API SDK по RPC
      client := risdk.GetClientRPC()
      //Закрываем соединение с RPC
      defer client.Client.Kill()

      // Создание компонента группы датчиков
      sensorGroupDescriptor, errText, errCode, err := client.RoboSdkApi.RI_SDK_CreateGroupComponent("sensor")
      if errText != "" || errCode != 0 || err != nil {
      fmt.Printf("errText: %s; errCode:%d; err: %s", errText, errCode, err)
      return
  }

      // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
      sensorDescriptor, errText, errCode, err := client.RoboSdkApi.RI_SDK_Sensor_VoltageSensor_Extend(sensorGroupDescriptor)
      if errText != "" || errCode != 0 || err != nil {
      fmt.Printf("errText: %s; errCode:%d; err: %s", errText, errCode, err)
      return
  }

      fmt.Println("sensorDescriptor: ", sensorDescriptor)
      return
  }

PHP

        <?php
        // Подключаем внешнюю библиотеку для работы с SDK
        $LIB_RISDK_ENV = "LIB_RISDK";
        if (empty(getenv($LIB_RISDK_ENV))) {
        print("Не указана переменная среды LIB_RISDK - выполнение программы невозможно");
        return;
    }

        $libname = '';
        if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
        $libname = '\librisdk.dll';
    } else {
        $libname = "librisdk.so";
    }

        $ffi = FFI::cdef("int RI_SDK_InitSDK(int level,char* errText);
        int RI_SDK_CreateGroupComponent(char* group, int* descriptor, char* errorTextC);
        int RI_SDK_sensor_VoltageSensor_Extend(int exec, int* descriptorC, char* errorTextC);"
        , getenv($LIB_RISDK_ENV) . $libname);

        $errorText = $ffi->new('char[1000]', 0); // Выделяем память на строку с ошибкой. Передается как входной параметр,при возникновении ошибки в эту переменную будет записан текст ошибки
        $sensorGroupDescriptor = $ffi->new('int', 0);
        $sensorDescriptor = $ffi->new('int', 0);
        $logLevel = 3; // уровень логирования

        // Инициализируем SDK
        $errCode = $ffi->RI_SDK_InitSDK($logLevel, $errorText);
        if ($errCode) {
        print("errorText:" . FFI::string($errorText) . " errCode: " . $errCode . " \n");
        return;
    }

        // Создание компонента группы датчиков
        $errCode = $ffi->RI_SDK_CreateGroupComponent("sensor", FFI::addr($sensorGroupDescriptor), $errorText);
        if ($errCode) {
        print("errorText:" . FFI::string($errorText) . " errCode: " . $errCode . " \n");
        return;
    }

        // Расширение компонента группы датчиков до датчика тока, напряжения и мощности
        $errCode = $ffi->RI_SDK_sensor_VoltageSensor_Extend($sensorGroupDescriptor->cdata, FFI::addr($sensorDescriptor), $errorText);
        if ($errCode) {
        print("errorText:" . FFI::string($errorText) . " errCode: " . $errCode . " \n");
        return;
    }