controller

`controller` is a built-in global object for reading basic controller state and sending basic controller commands.

It is used directly by name. Do not call `controller()`.

Controller commands affect the connected machine controller. Use them only in scripts where that behavior is intentional.

`controller` is a predefined global object. It is not created with a constructor.

print(controller.name);

Properties are read-only snapshots of current controller state.

Example:

print('controller: ', controller.name);
print('serial: ', controller.serial);
print('version: ', controller.version);
print('connected: ', controller.is_connected);
print('e-stop: ', controller.e_stop);

`clone()` is not supported for `controller`.

Sends a reset command to the controller.

The returned result indicates whether the host accepted and sent the command successfully.

result = controller.reset();
print(result);

Requests controller E-stop.

This command activates E-stop. It is not a replacement for physical safety wiring or operator safety procedures.

result = controller.e_stop();
print(result);

`controller` is a protected built-in global name. The name itself cannot be overwritten.

controller = 1;     // error

Use `controller` methods to request controller actions.

if (controller.is_connected)
{
    print('Connected to ', controller.name, ', serial ', controller.serial);
 
    if (controller.e_stop)
    {
        print('Controller is in E-stop');
    }
}
else
{
    print('Controller is not connected');
}

Previous: settings

Next: session