Field Evaluation¶
The picoScan100 evaluates detection zones on the device. Field evaluation checks whether scan points enter a configured polygon and reports a FREE or INFRINGED result. The result can drive a digital output, be read through REST or CoLa, or be delivered through WebSocket events. Teach-in evaluation uses the same group and output mechanism but learns its contour from the live scan instead of using a manually defined polygon.
Perpendicular distance evaluation reports the signed perpendicular distance between an entering object and a reference line. Use it when the application needs a measured distance rather than a binary field state.
Configure an evaluation¶
An evaluation slot (Eval001 through Eval048) holds its mode, minimum object size, and timing parameters. Configure the evaluation slot before setting its contour; SetFieldEvaluationContour returns an error if the slot does not exist. Use SetFieldEvaluationContour to write the polygon and GetFieldEvaluationContour to verify it. Map the evaluation to a group through EvaluationGroupMapping, and use PortConfiguration when its INFRINGED signal must control a digital output. Call WriteEeprom after configuration changes to store them permanently.
| API resource | Purpose |
|---|---|
Eval001-Eval048 |
Stores the parameters for an evaluation slot. |
EvaluationGroupMapping |
Assigns evaluations to a group and selects the activation mode. |
SetFieldEvaluationContour |
Writes the polygon for an evaluation slot. |
GetFieldEvaluationContour |
Reads the polygon from an evaluation slot. |
PortConfiguration |
Connects an evaluation result to a digital output. |
Activate and monitor a group¶
A group can be active continuously (ALWAYS), controlled by inputs (INPUTS), or controlled by a telegram (TELEGRAM). ActivateEvaluationGroup only affects groups configured with TELEGRAM; it cannot switch an ALWAYS group. Read FieldEvaluationGroupState to determine whether a group is not configured, active, or inactive. Read FieldEvaluationResult to retrieve the current evaluation result, including FREE, INFRINGED, and transitional states.
A typical workflow creates the evaluation and its polygon, assigns it to a group, connects an output if required, and persists the configuration. At runtime, the application reads the group state and evaluation result, updates the geometry or detection parameters when necessary, and activates or deactivates telegram-controlled groups. To delete an evaluation, restore the original group and output mapping, clear the evaluation slot, persist the change, and confirm that the group returns to NOT_CONFIGURED.
For full endpoint payloads and CoLa telegram examples, consult the operating instructions for the installed firmware.