Skip to content

Enable Access to SINUMERIK

Installation and configuration on SINUMERIK controller

For detailed information how to prepare the SINUMERIK controller for gathering data via SINUMERIK EDGE, please refere to the SinumerikEdgeHFDataCommisioning manual delivered with the ncu_linux package matching the version of the corresponding SinumerikAdapter.


Installation and configuration on SINUMERIK EDGE

After onboarding a new SINUMERIK EDGE you will need to install and configure the applications SinumerikAdapter and AdapterFramework. These applications will enable the access to a SINUMERIK NCU.

Installation of AdapterFramework application

The AdapterFramework is a system component of SINUMERIK EDGE that enables communication between applications and datasources. A datasource is a logical object which can be a real hardware device – like a SINUMERIK NCU – or an internal dataset of an application.

Select the application "adapterframework" with the released version related to the firmware version installed on your SINUMERIK EDGE to install it on your connected SINUMERIK EDGE device.
Please refer to chapter Application Management for detailed information how to install an application on your SINUMERIK EDGE device.

Any additional configuration over MindSphere backend is not neccessary for this application.

Installation of SinumerikAdapter application

The SINUMERIK Adapter is an application used to connect the SINUMERIK EDGE to a SINUMERIK machine and provide data and service connectivity to SINUMERIK EDGE applications.

Select the application "sinumerikadapter" with the released version related to the firmware version installed on your SINUMERIK EDGE to install it on your connected SINUMERIK EDGE device.
Please refer to chapter Application Management for detailed information how to install an application on your SINUMERIK EDGE device.

For detailed description how to configure SinumerikAdapter please refere to the chapter below.

Dependencies

To use the SINUMERIK Adapter, the system application "adapterframework" must be installed as well.

Remarks & Version Restrictions

  • Precondition: The SINUMERIK Adapter requires a installed SINUMERIK HMI-OA license (6FC5800-0AP60-0YB0) on the connected machine.

  • Restriction: Currently SinumerikAdapter only supports the connection to a single NCU. Multi-NCU scenarios are not supported.

Configuration of SinumerikAdapter application

Connection settings

NCU IP address

The SINUMERIK Adapter ships with an IP address of 192.168.214.1. This allows it to communicate with the default machine network of a SINUMERIK NCU.

To change this configuration, the datasource configuration of the SinumerikAdapter IndApp needs to be edited. Use the configuration backend in the MindSphere for this modification.

Relevant part of SinumerikAdapter configuration

"datasourceConfig": {
    "providedDatasource": [
        {
            ...
            "meta": {
                "ipAddress": "192.168.214.1",
                "controlType": "840Dsl",
                "serialNumber": ""
            },
            ...
        },
        ...
    ]
}

CONTROL TYPE

The SINUMERIK Adapter supports the two control types: "SINUMERIK 840D sl" and "SINUMERIK ONE". The default configuration of the SINUMERIK Adapter fits to the manufacturer settings of a "SINUMERIK 840D sl". The default controlType is "840Dsl". For communication with a SINUMERIK ONE the controlType in the configuration needs to be changed to "ONE".

The SINUMERIK Adapter supportes the listed control types:

  • "840Dsl"
  • "ONE"

If the configured controlType does not match to one of those, the SINUMERIK Adapter will not start.

Attention: The SINUMERIK Adapter does not validate the configured controlType against the connected device. As such, connection issues may occur if the configured controlType differs from the connected machine.

Relevant part of SinumerikAdapter configuration

"datasourceConfig": {
    "providedDatasource": [
        {
            ...
            "meta": {
                "ipAddress": "192.168.214.1",
                "controlType": "ONE",
                "serialNumber": ""
            },
            ...
        },
        ...
    ]
}

Serial number

The SINUMERIK Adapter needs to be configured with the correct serial number of the connected NCU.
If the configured serial number does not match with the connected NCU, the SINUMERIK Adapter will report a license error and block all access to the machine.

To configure the serial number, the providedDatasource configuration of the SinumerikAdapter IndApp needs to be edited. Use the configuration backend in the MindSphere to do so.

You can find the serial number of your machine by using the HMI

(Setup -> Mach. Data -> General MD -> 18030[0] $MN_HW_SERIAL_NUMBER)

or under this BTSS address:

/NC/_N_NC_TEA_ACX/$MN_HW_SERIAL_NUMBER

image

Attention: Do not change any other section of the SINUMERIK Adapter's datasourceConfig other than the datasourceId and meta.

Provided Services

parameter-service/v1

The SINUMERIK Adapter enables access to a SINUMERIK NCU by implementing a parameter-service/v1 provider. General information about configuration and usage of the parameter-service are documented in the service documentation.

Attention: You dont need to change the parameter-service/v1 section of the SINUMERIK Adapter. The service will be configured automatically. Only configure connected applications.

For a reading operation, "accessType" 'r' must be added in order to configure the service correctly. You dont have to specify datapoints for reading access.

Firewall permissions

The SINUMERIK Adapter activates a firewall that protects parameters from being written without permission. For modifying partameter access, an application must require access, using accessType "w" and specify a list of required parameters. Those parameters will be used to fill the SINUMERIK Adapters whitelist. All write requests will be denied unless they are whitelisted.

example:

"datasourceConfig": { 
    "requiredDatasource":[{
        "datasourceId": "SINUMERIK_NCU1", 
        "type" : "SINUMERIK", 
        "services": { 
            "parameter-service/v1":{ 
                "access": [{ 
                    "accessType": "w", 
                    "datapoints": [{ 
                        "address":"some whitelisted parameter" 
                    }] 
                }] 
            }
        } 
    }] 
}

subscription-service/v1

The SINUMERIK Adapter publishes data from a SINUMERIK NCU by implementing a subscription-service/v1 provider. Please navigate to the datasource configuration chapter in the service documentation for information on how to receive data from the SINUMERIK Adapter.

Attention: You dont need to change the subscription-service/v1 section of the SINUMERIK Adapter. The service will be configured automatically. Only configure connected applications.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the The Siemens Inner Source License - 1.1.