update_sensor

Para crear, modificar o eliminar sensores, utilice el método unit/update_sensor.

svc=unit/update_sensor&params={
    "itemId": <long>,
    "id": <long>,
    "callMode": <text>,
    "unlink": <uint>,
    "n": <text>,
    "t": <text>,
    "d": <text>,
    "m": <text>,
    "p": <text>,
    "f": <uint>,
    "c": <text>,
    "vt": <uint>,
    "vs": <long>,
    "tbl": [
        {
            "x": <double>,
            "a": <double>,
            "b": <double>
        }
    ]
}

La solicitud debe contener los siguientes parámetros:

Para crear o actualizar un sensor, también se requieren los siguientes parámetros:

Para más información sobre los tipos de sensores, consulte Tipos de sensores.

Los siguientes parámetros se utilizan para configurar un sensor:

"{
  \"act\": <bool>,
  \"appear_in_popup\": <bool>,
  \"battery_capacity\": <double>,
  \"ci\": <object>,
  \"calc_fuel\": <uint>,
  \"engine_efficiency\": <array>,
  \"engine_sensors\": <array>,
  \"filter\": <long>,
  \"fuel_params\": <object>,
  \"mu\": <uint>,
  \"pos\": <uint>,
  \"show_time\": <bool>,
  \"unbound_code\": <text>,
  \"validate_driver_unbound\": <bool>,
  \"do_not_show\": <bool>,
  \"timeout\": <uint>,
  \"uct\": <bool>,
  \"lower_bound\": <double>,
  \"upper_bound\": <double>,
  \"overflow_limit\": <double>,
  \"text_params\": <uint>,
  \"show_as_percentage\": <uint>
}"

El parámetro c se envía como una cadena que contiene un objeto JSON. Encierre el objeto entre comillas dobles y escape las comillas dobles en sus claves y valores ("). Consulte los ejemplos de configuración a continuación.

Configure los flags del sensor en el parámetro de nivel superior f. No configure c.flags directamente.

En el parámetro ci, cada clave es el límite inferior de un intervalo, y cada valor describe cómo se muestra el valor del sensor en este intervalo:

"c":"{\"ci\":{\"0\":{\"t\":\"Off\",\"c\":16711680},\"50\":{\"t\":\"On\"}}}"

Para configurar un intervalo sin límite inferior, utilice la clave "-Infinity".

Ejemplo de pasar fuel_params de un sensor de nivel de combustible:

"c":"{\"fuel_params\":{\"flags\":1728,\"ignoreStayTimeout\":20,\"minFillingVolume\":21,\"minTheftTimeout\":0,\"minTheftVolume\":15,\"filterQuality\":0,\"fillingsJoinInterval\":300,\"theftsJoinInterval\":300,\"extraFillingTimeout\":0}}"

Ejemplo de pasar fuel_params de un sensor de consumo de combustible impulsivo:

"c":"{\"fuel_params\":{\"maxImpulses\":10,\"skipZero\":0}}"

Ejemplo de pasar fuel_params de un sensor de nivel de batería:

"c":"{\"fuel_params\":{\"flags\":16387,\"filterQuality\":0,\"minFillingVolume\":10,\"fillingsJoinInterval\":300}}"

Para un sensor de nivel de batería, el sistema utiliza la configuración que se indica a continuación. Si no pasa el objeto fuel_params en absoluto, el sistema utiliza la configuración de combustible de la unidad. Si pasa el objeto sin algunas de las claves, el sistema utiliza los valores de la tabla.

El sistema utiliza esta configuración solo cuando el cálculo de datos por el sensor está habilitado en calc_fuel. Esta configuración corresponde a la opción Calcular datos según el sensor. Los valores calculados son devueltos por los detectores battery_level, charge y ev. Para más detalles, consulte la sección Tipos de detectores de eventos.

La clave show_as_percentage afecta solo a la visualización. Siempre especifique battery_capacity y la configuración de detección de carga en kWh.

Ejemplo de una cadena c para un sensor de nivel de batería, donde se configuran a la vez la detección de carga y la visualización en porcentaje:

"c":"{\"fuel_params\":{\"flags\":16387,\"filterQuality\":0,\"minFillingVolume\":10,\"fillingsJoinInterval\":300},\"show_as_percentage\":1,\"battery_capacity\":64.5,\"calc_fuel\":2,\"act\":1,\"mu\":0,\"appear_in_popup\":true}"

Pase show_as_percentage y battery_capacity dentro de la cadena c, junto a fuel_params, y mantenga el parámetro m del sensor configurado como kWh.

El tipo de filtrado se configura en flags: utilice 0x02 para habilitar el filtrado y agregue 0x4000 para el filtrado de mediana adaptativo. Si configura el flag 0x2000, el sistema utiliza solo los flags de filtrado y el valor filterQuality del sensor.

Para los sensores de nivel de batería, el flag 0x2000 funciona de manera opuesta a su descripción en la página unit/get_fuel_settings: no aplica la configuración de combustible predeterminada de la unidad.

El sistema siempre agrega el modo de cálculo por tiempo (0x10) para sensores de nivel de batería. No puede deshabilitarlo a través de este método.

Para sensores de nivel de batería, el sistema reinicia las claves ignoreStayTimeout, minTheftVolume y extraFillingTimeout a 0, incluso si especifica otros valores. Las claves minTheftTimeout y theftsJoinInterval no tienen efecto porque la detección de descarga no está disponible para estos sensores.

Si la solicitud para crear o actualizar un sensor se completa con éxito, se devuelve una respuesta en el siguiente formato:

[
  <long>,  /* ID del sensor */
  {
    "id": <long>,       /* ID del sensor */
    "n": "<text>",      /* Nombre */
    "t": "<text>",      /* Tipo */
    "d": "<text>",      /* Descripción */
    "m": "<text>",      /* Unidad de medida */
    "p": "<text>",      /* Parámetro */
    "f": <uint>,        /* Flags del sensor */
    "c": <text>,        /* Configuración, enviada y devuelta como una cadena JSON */
    "vt": <int>,        /* Tipo de validación */
    "vs": <long>,       /* ID del sensor de validación */
    "tbl": [            /* Tabla de cálculo */
      {
        "x": <double>,
        "a": <double>,
        "b": <double>
      }
    ]
  }
]

Si la solicitud para eliminar un sensor se completa con éxito, se devuelve una respuesta en el siguiente formato:

[
  <long>,   /* ID del sensor */
  null
]

Si la solicitud falla, se devuelve un código de error.