Skip to Content
FASTCUBE Shopfloor AssistantValidating Your NC Code

Validating Your NC Code

Purpose

Validation is the final safety check before executing an NC program on the real machine.

In Shopfloor Assistant, validation is performed using a Virtual Controller that simulates the machining process using:

  • real machine limits
  • axis constraints
  • collision geometry

This ensures the NC program is:

  • safe
  • reachable
  • ready for execution

before running it on the physical machine.

Validation overview in Shopfloor Assistant

What the Validation Checks

The Validate Program operation performs several automated checks.

Collision Detection

Ensures the tool does not collide with:

  • the workpiece
  • fixtures
  • machine components

Reachability Analysis

Verifies that all points in the NC program are within the machine’s kinematic limits.

Syntax and Structure Validation

Detects issues such as:

  • invalid command formatting
  • missing parameter values
  • unsupported NC instructions

Before You Begin

Important

The NC program must be saved before running validation.

Validation always runs on the last saved version of the program.

Unsaved edits will not be included in the validation process.


Running the Validation

Step 1 — Open the Validation Window

Click Validate Program in the left-side panel.

Validate program button

This opens the Validation Setup Window.


Step 2 — Provide the Required Information

Fill in the required fields so the Virtual Controller can simulate the NC program correctly.

Validation setup window

Folder Location

Directory containing the project data (cenpkg file) used by the validation engine.

This field is filled automatically but can be changed.

Host Name

Hostname or IP address of the machine running the validation service.

This value can also be configured in:

  • the Installation window
  • the Launcher Settings

Fixture Configuration

If the NC program contains fixture data, Shopfloor Assistant automatically detects and loads it.


💡 Tip

The Validate Program button becomes active only after all required fields are completed.


Step 3 — Start the Validation

Press Validate Program to start the Virtual Controller simulation.

Starting validation

The system will execute the validation process and analyze the NC program.

Validation process running

During validation, the Shopfloor Assistant interface is temporarily disabled to prevent interaction while the simulation is running.


Validation Results

Once validation completes, the system displays a status notification.

Two possible outcomes may occur.


Validation Failed

Displayed when the Virtual Controller detects errors or cannot complete the simulation.

Validation failed indicator Validation error details

Error Exit Codes

CodeMeaning
0FastSuite E2 closed normally from the X button
1FastSuite E2 closed unexpectedly
2Unexpected errors (communication error or bad request)
3Shopfloor Assistant internal error
200License validation failed
4001Automatic program validation timeout
4002Automatic program validation generic error

Validation Completed Successfully

Displayed when the validation engine returns exit code 4000.

Validation success indicator Validation success message

This confirms the NC program passed all validation checks.


Notes for Operators

  • Always save the NC program before validation.
  • Only the saved program version is used by the Virtual Controller.
  • Verify Folder Location, Host Name, and Fixture Configuration before starting validation.
  • Avoid interacting with the interface while validation is running.
  • Run validation after major edits or transformations to ensure program safety.
  • If validation fails, review the error code and logs before executing the program on the machine.
Was this page helpful?