Skip to main content

Script

El controlador puede ejecutar un programa propio, el script, para incorporar lógica específica de cada sitio: leer pulsadores y detectores, pedir saltos de fase, manejar el modo manual, cambiar de plan según una condición externa o informar estados a una plataforma.

El lenguaje es el mismo del RTU-X (nettraC): un lenguaje sencillo, con muchas similitudes con C. Su sintaxis, tipos de variables, operadores, multitarea y funciones generales están documentados en Script del RTU-X. Esta página describe solo lo propio del controlador de semáforos.

El editor de script​

El script se escribe en la sección Script de la interfaz de usuario. Los botones principales son:

  • Compilar: verifica el script y muestra los errores, sin cargarlo al equipo.
  • Compilar y aplicar: compila el script y lo carga en el equipo, que lo empieza a ejecutar.
  • Recuperar: trae el script que está cargado en el equipo.

Diferencias con el RTU-X​

El controlador no tiene parte del hardware del RTU-X, por lo que estas variables del sistema no existen y usarlas es un error de compilación:

  • entradas analógicas (ain);
  • conteo de pulsos (pulses);
  • batería de respaldo (battery_*);
  • LoRa (lora_*);
  • el calendario genérico del RTU-X (calendar_events_count, enable_calendars, calendar_update_period). El calendario del semáforo es propio de cada cruce y se configura en Calendario, no desde el script.

Las entradas y salidas digitales del controlador se manejan con las funciones habituales:

FunciónDescripción
get_input(n)Lee el estado de la entrada digital n (0 a 7).
get_output(n)Lee el estado de la salida digital n (0 a 3).
set_output(n, valor)Prende (1) o apaga (0) la salida digital n (0 a 3).

Si un evento de calendario forzó una entrada o una salida, get_input devuelve el valor forzado y set_output no tiene efecto sobre la salida forzada (ver Calendario).

Variables del motor​

El motor del semáforo usa variables del script para algunas funciones de la configuración:

UsoDónde se configuraComportamiento
Condición de una bifurcaciónCruces → BifurcacionesEl script la pone en 1 para pedir el salto; el motor la vuelve a 0 al aplicarlo.
Activación del modo manualCruces → GeneralMientras valga distinto de 0, el cruce está en modo manual.
Control del modo manualCruces → GeneralCada activación termina la fase en curso (en las fases que permiten modo manual).
Titilante manualCruces → GeneralMientras valga distinto de 0, el cruce está en titilante.
Variable de faseCruces → FasesCada activación extiende la fase; el motor la vuelve a 0.

Para que una variable aparezca en esas listas de la configuración, debe:

  • estar declarada con un calificador: telemetry, attribute, shared o static;
  • ser de tipo int o uint, y no un arreglo;
  • tener un nombre de hasta 17 caracteres.

La variable declarada en el script es la misma que lee el motor: alcanza con asignarla (peaton_pide = 1;). No hace falta ninguna función especial. Después de cargar un script con variables nuevas, recargue la configuración del semáforo para que aparezcan en las listas.

Funciones del controlador​

Además de las funciones generales del lenguaje, el script dispone de funciones para consultar el estado de los cruces. En todas, crossing es el número de cruce (0 a 3).

FunciónDevuelve
controller_get_crossing_count()La cantidad de cruces configurados en el equipo (0 a 4).
cross_get_mode(crossing)El modo del cruce: CROSS_MODE_MANUAL, CROSS_MODE_FAULT (seguridad), CROSS_MODE_CALENDAR, CROSS_MODE_INTERNAL, CROSS_MODE_EXTERNAL o CROSS_MODE_LOCAL.
cross_get_operation(crossing)El funcionamiento actual: CROSS_OPERATION_NORMAL, CROSS_OPERATION_FLASHING (titilante), CROSS_OPERATION_OFF (extinción), CROSS_OPERATION_BTL o CROSS_OPERATION_BTS.
cross_get_phase(crossing)El número de la fase activa.
cross_get_phase_duration(crossing)Los segundos transcurridos de la fase activa (0 durante las interfases).
cross_get_plan(crossing)El número del plan en curso.
cross_get_fault_count(crossing)La cantidad de fallas en curso del cruce.
cross_force_plan(crossing, plan)Pide un cambio de plan. Devuelve 1 si se aplicó y 0 si el cruce o el plan están fuera de rango.

Las funciones que devuelven un modo, un funcionamiento, una fase o un plan devuelven CROSS_NOT_CONFIGURED si el número de cruce está fuera de rango. Use siempre las constantes y no sus valores numéricos.

warning

cross_force_plan() no hace nada si el cruce no está en funcionamiento normal. Antes de llamarla, verifique que cross_get_operation() devuelva CROSS_OPERATION_NORMAL.

Lo que un script no puede hacer​

Por diseño, un script no puede forzar el modo o el funcionamiento de un cruce, ni provocar, ocultar o anular fallas. Las protecciones de seguridad del controlador (antagonismos, vaciamientos, mínimos de verde, modo de seguridad) quedan siempre fuera de su alcance. Un script solo puede leer el estado de los cruces, pedir cambios de plan y manejar las variables que la configuración le asigna.

Ejemplos​

Pulsador peatonal, modo manual y titilante​

Este script lee cuatro entradas y maneja las variables que usa la configuración del cruce:

  • Entrada 0: pulsador de peatón. Cada pulsación pide una bifurcación (por ejemplo, al terminar la fase 0, saltar a la fase 2 si peaton_pide).
  • Entrada 1: llave de modo manual (variable de activación).
  • Entrada 2: pulsador de avance manual (variable de control).
  • Entrada 3: llave de titilante (variable de titilante manual).
telemetry int peaton_pide;
telemetry int modo_manual;
telemetry int avance_manual;
telemetry int titilante_manual;

int pulsador_anterior;

peaton_pide = 0;
modo_manual = 0;
avance_manual = 0;
titilante_manual = 0;
pulsador_anterior = 0;

while (1)
{
task
{
// Pulsador de peatón: un pedido por pulsación (flanco de subida).
// El motor vuelve la variable a 0 cuando aplica la bifurcación.
if (get_input(0) != 0 && pulsador_anterior == 0)
peaton_pide = 1;
pulsador_anterior = get_input(0);

// Llaves y pulsador de operación manual: se copian tal cual.
modo_manual = get_input(1);
avance_manual = get_input(2);
titilante_manual = get_input(3);

delay(50);
}
}

Después de cargarlo, en Semáforo → Cruces se eligen estas variables por nombre: peaton_pide en la bifurcación, modo_manual y avance_manual en el modo manual con pulsador, y titilante_manual en el titilante manual.

Plan de emergencia pedido desde la plataforma​

Mientras la variable prefer_emergencia valga distinto de 0 (por ejemplo, escrita desde Telemetry+), el cruce 0 usa el plan 3. El cambio de plan solo se pide si el cruce está en funcionamiento normal.

const CRUCE = 0;
const PLAN_NORMAL = 0;
const PLAN_EMERGENCIA = 3;

shared int prefer_emergencia;

int funcionamiento;
int plan_deseado;

prefer_emergencia = 0;
plan_deseado = PLAN_NORMAL;

while (1)
{
task
{
funcionamiento = cross_get_operation(CRUCE);

if (funcionamiento == CROSS_OPERATION_NORMAL)
{
if (prefer_emergencia != 0)
plan_deseado = PLAN_EMERGENCIA;
else
plan_deseado = PLAN_NORMAL;

cross_force_plan(CRUCE, plan_deseado);
}

delay(1000);
}
}