brother cnc:new doc && mazak cnc:new doc && mtconnect: DMG MORI Demo

directory.json

@@ -459,7 +459,13 @@
         },
         {
           "title": "MTConnect",
-          "path": "configuration/south-devices/mtconnect/mtconnect"
+          "path": "configuration/south-devices/mtconnect/mtconnect",
+          "children": [
+            {
+              "title": "接入 DMG MORI 设备",
+              "path": "configuration/south-devices/mtconnect/dmg-mori"
+            }
+          ]
         },
         {
           "title": "CODESYS V3",
@@ -483,6 +489,26 @@
           "title": "KND CNC",
           "path": "configuration/south-devices/knd/knd"
         },
+        {
+          "title": "Brother CNC",
+          "path": "configuration/south-devices/brother-cnc/brother-cnc",
+          "children": [
+            {
+              "title": "设备端配置",
+              "path": "configuration/south-devices/brother-cnc/brother-cnc-setup"
+            }
+          ]
+        },
+        {
+          "title": "Mazak CNC",
+          "path": "configuration/south-devices/mazak-udp/mazak-udp",
+          "children": [
+            {
+              "title": "设备端配置",
+              "path": "configuration/south-devices/mazak-udp/mazak-setup"
+            }
+          ]
+        },
         {
           "title": "NEURON HUB",
           "path": "configuration/south-devices/neuhub/neuhub",
@@ -1215,7 +1241,13 @@
         },
         {
           "title": "MTConnect",
-          "path": "configuration/south-devices/mtconnect/mtconnect"
+          "path": "configuration/south-devices/mtconnect/mtconnect",
+          "children": [
+            {
+              "title": "Connect to DMG MORI",
+              "path": "configuration/south-devices/mtconnect/dmg-mori"
+            }
+          ]
         },
         {
           "title": "CODESYS V3",
@@ -1239,6 +1271,26 @@
           "title": "KND CNC",
           "path": "configuration/south-devices/knd/knd"
         },
+        {
+          "title": "Brother CNC",
+          "path": "configuration/south-devices/brother-cnc/brother-cnc",
+          "children": [
+            {
+              "title": "Device-Side Configuration",
+              "path": "configuration/south-devices/brother-cnc/brother-cnc-setup"
+            }
+          ]
+        },
+        {
+          "title": "Mazak CNC",
+          "path": "configuration/south-devices/mazak-udp/mazak-udp",
+          "children": [
+            {
+              "title": "Device-Side Configuration",
+              "path": "configuration/south-devices/mazak-udp/mazak-setup"
+            }
+          ]
+        },
         {
           "title": "NEURON HUB",
           "path": "configuration/south-devices/neuhub/neuhub",

en_US/configuration/south-devices/brother-cnc/brother-cnc-setup.md

@@ -0,0 +1,95 @@
+# Brother CNC Device-Side Configuration
+
+This guide describes how to configure the Brother CNC machine's communication and network parameters so that the Neuron Brother CNC plugin can connect and collect data via TCP/IP.
+
+## Prerequisites
+
+Before starting, ensure the following:
+
+- The Brother CNC control panel is accessible.
+- You have the necessary permissions to modify machine communication parameters.
+- The machine is connected to a network with an Ethernet cable.
+- You have a static IP address, subnet mask, and gateway ready for the machine.
+
+## Configuring Network and Communication Parameters
+
+### Step 1: Enter the Communication Parameter Page
+
+1. Press the **Database** button on the control panel.
+2. Press **F6** to select **Communication Parameters**.
+
+### Step 2: Configure Remote Access
+
+On the communication parameter page, configure the following:
+
+| Parameter | Setting | Description |
+| ----------------------- | -------- | ------------------------------------------------ |
+| **Data Rewrite (Slave)** | Yes | Allow external devices to read data from the CNC. |
+| **Remote Operation** | Valid | Enable remote access to the machine. |
+
+### Step 3: Configure Network Settings
+
+Set the machine's network parameters:
+
+| Parameter | Value |
+| -------------- | ---------------------------------------- |
+| **IP Address** | Enter the desired static IP address. |
+| **Gateway** | Enter the network gateway address. |
+| **Subnet Mask** | Enter the subnet mask (e.g., 255.255.255.0). |
+
+::: tip
+The IP address must be in the same subnet as the Neuron host machine, and the default communication port is **10000**.
+:::
+
+### Step 4: Enable Ethernet Access
+
+Change the **Restrict Ethernet Access** parameter from **Yes** to **No** to allow external TCP/IP connections.
+
+### Step 5: Save the Settings
+
+1. After modifying all parameters, press **Complete Mode** (完成模式).
+2. Then press **Exit Edit** (退出编辑) to save the configuration.
+
+## Verifying Network Connectivity
+
+After completing the configuration:
+
+1. Record the IP address configured on the Brother CNC.
+2. From the Neuron host machine, ping the Brother CNC IP address to verify basic network connectivity:
+   ```shell
+   ping <BROTHER_CNC_IP_ADDRESS>
+   ```
+3. Verify that TCP port **10000** is reachable from the Neuron host.
+
+Once the connection is verified, configure the Neuron Brother CNC plugin on the Neuron side. See [Brother CNC](./brother-cnc.md) for details.
+
+## Troubleshooting
+
+### Cannot Connect to Brother CNC
+
+**Possible causes:**
+- Incorrect IP address configured in Neuron.
+- Restrict Ethernet Access is still set to Yes.
+- Data Rewrite is set to No.
+- Remote Operation is set to Invalid.
+- Firewall blocking TCP port 10000.
+- The machine and Neuron host are not on the same network segment.
+
+**Solutions:**
+1. Verify the IP address configured on the Brother CNC.
+2. Confirm the network parameters in Step 3 and Step 4 above are correctly set.
+3. Check that Restrict Ethernet Access is set to No.
+4. Ensure Data Rewrite is set to Yes and Remote Operation is Valid.
+5. Confirm that TCP port 10000 is not blocked by a firewall.
+6. Ping the Brother CNC IP address from the Neuron host to verify network connectivity.
+
+### Settings Not Saved After Restart
+
+**Possible causes:**
+- The parameter save procedure was not completed correctly.
+
+**Solutions:**
+1. Re-enter the Communication Parameter page.
+2. Verify that all settings are still in place.
+3. Make sure to press **Complete Mode** followed by **Exit Edit** after making changes.
+4. Restart the machine if necessary and re-check the settings.

en_US/configuration/south-devices/brother-cnc/brother-cnc.md

@@ -0,0 +1,138 @@
+# Brother CNC
+
+The Brother CNC plugin is used to access Brother CNC machining centers via the Brother NC protocol. It collects machine operating data such as axis coordinates, spindle, tool, alarms, workpiece count, program number, PLC devices, and tool offset data. The plugin supports connecting to the device over either a serial (Serial) or Ethernet link.
+
+::: tip
+The Brother CNC plugin is read-only. It only supports data collection (read) and does not support control (write).
+:::
+
+## Add Device
+
+Go to **Configuration -> South Devices**, then click **Add Device** to add the driver. Configure the following settings in the popup dialog box.
+
+- Name: The name of this device node.
+- Plugin: Select the **Brother CNC** plugin.
+
+## Device Configuration
+
+After clicking **Create**, you will be redirected to the **Device Configuration** page, where you set up the parameters required for Neuron to establish a connection with the device. You can also click the device configuration icon on the southbound device card to enter the **Device Configuration** interface.
+
+| Parameter | Description |
+| ------------------ | ----------------------------------------------------------- |
+| **Physical Link** | Select Serial or Ethernet as the communication medium. Default is Ethernet. |
+| **Connection Timeout (ms)** | Time to wait for the device to respond to a request, ranging from 1000 to 30000. Default is 3000. |
+| **Serial Device** | In serial mode, the path of the serial device, e.g. /dev/ttyS0 on Linux. |
+| **Baud Rate** | Serial connection parameter. Options: 115200/57600/38400/19200/9600/4800. Default is 9600. |
+| **Data Bits** | Serial connection parameter. Options: 7/8. Default is 8. |
+| **Stop Bits** | Serial connection parameter. Options: 1/2. Default is 1. |
+| **Parity** | Serial connection parameter. Options: none/odd/even. Default is none. |
+| **CNC IP Address** | In Ethernet mode, the IPv4 address of the target CNC device. |
+| **CNC Port** | In Ethernet mode, the port of the target CNC device, ranging from 1 to 65535. Default is 10000. |
+
+## Configure Data Groups and Tags
+
+After the plugin is added and configured, the next step is to establish communication between your device and Neuron by adding groups and tags to the southbound driver.
+
+Once device configuration is completed, navigate to the **South Devices** page. Click on the device card or device row to access the **Group List** page. Here, you can create a new group by clicking **Create**, then specifying the group name and data collection interval.
+
+After successfully creating a group, click on its name to proceed to the **Tag List** page. This page allows you to add device tags for data collection. You'll need to provide information such as the tag address, attributes, and data type.
+
+For information on general configuration items, see [Connect to Southbound Devices](../south-devices.md). The subsequent section will concentrate on configurations specific to the driver.
+
+::: tip
+The Brother CNC plugin only supports the **read-only** tag attribute. During collection, the plugin batches requests for tags of the same data area (PDSP, ALARM, PLCD, etc.). Grouping tags of the same area together is recommended to improve collection efficiency.
+:::
+
+### Data Types
+
+* INT16
+* UINT16
+* INT32
+* UINT32
+* INT64
+* UINT64
+* FLOAT
+* DOUBLE
+* BIT
+* BOOL
+* STRING
+
+### Address Format
+
+The Brother CNC plugin organizes tag addresses by data area. The address format and supported data types vary between areas.
+
+#### PDSP (Machine Operating Data)
+
+| Address | Data Type | Attribute | Description |
+| ----------------------- | --------------------------------------------------- | --------- | --------------- |
+| PDSP.MACHINE_X | INT16/UINT16/INT32/UINT32/INT64/UINT64/FLOAT/DOUBLE | Read | Machine X-axis coordinate |
+| PDSP.MACHINE_Y | INT16/UINT16/INT32/UINT32/INT64/UINT64/FLOAT/DOUBLE | Read | Machine Y-axis coordinate |
+| PDSP.MACHINE_Z | INT16/UINT16/INT32/UINT32/INT64/UINT64/FLOAT/DOUBLE | Read | Machine Z-axis coordinate |
+| PDSP.FEED_SPEED | INT16/UINT16/INT32/UINT32/INT64/UINT64/FLOAT/DOUBLE | Read | Feed speed |
+| PDSP.SPINDLE_SPEED | INT16/UINT16/INT32/UINT32/INT64/UINT64/FLOAT/DOUBLE | Read | Spindle speed |
+| PDSP.TOOL_NO | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Current tool number |
+| PDSP.NEXT_TOOL_NO | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Next tool number |
+| PDSP.RAPID_OVERRIDE | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Rapid traverse override |
+| PDSP.FEED_OVERRIDE | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Feed override |
+| PDSP.SPINDLE_OVERRIDE | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Spindle override |
+
+#### ALARM (Alarm Data)
+
+| Address | Data Type | Attribute | Description |
+| ----------- | -------------------------------- | --------- | ----------------------------------------- |
+| ALARM.\<N\> | INT32/UINT32/INT64/UINT64 | Read | Alarm data, where N is the column index (0-based) |
+
+#### WKCNTR (Workpiece Count Data)
+
+| Address | Data Type | Attribute | Description |
+| ------------ | -------------------------------------- | --------- | --------------- |
+| WKCNTR.COUNT | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Workpiece count |
+
+#### PRDC2 (Production Time Data)
+
+| Address | Data Type | Attribute | Description |
+| ----------------- | -------------------------------------- | --------- | ------------ |
+| PRDC2.CYCLE_TIME | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Cycle time |
+| PRDC2.CUTTING_TIME | INT16/UINT16/INT32/UINT32/INT64/UINT64 | Read | Cutting time |
+
+#### PRGN (Program Number Data)
+
+| Address | Data Type | Attribute | Description |
+| ------------ | ---------------------- | --------- | -------------------- |
+| PRGN.CURRENT | INT32/UINT16/STRING | Read | Current program number |
+| PRGN.MAIN | INT32/UINT16/STRING | Read | Main program number |
+| PRGN.BLOCK | INT32/UINT16/STRING | Read | Current block number |
+
+#### PLCD (PLC Devices)
+
+| Address | Data Type | Attribute | Description |
+| ------------- | --------------------------------------------- | --------- | -------------------------------- |
+| PLCD.D.\<N\> | INT16/UINT16/INT32/UINT32/FLOAT/DOUBLE | Read | D data register, N is the register address |
+| PLCD.M.\<N\> | BIT/BOOL | Read | M relay, N is the register address |
+
+#### TOLSD (Tool Offset Data)
+
+| Address | Data Type | Attribute | Description |
+| ------------------------- | -------------------------------------------------------- | --------- | -------------------------------------------------- |
+| TOLSD.\<DB\>.\<ID\>.\<N\> | INT16/UINT16/INT32/UINT32/INT64/UINT64/FLOAT/DOUBLE | Read | Tool offset data, DB ranges 1-10, ID ranges 1-99, N is the column index |
+
+### Address Examples
+
+| Address | Data Type | Description |
+| ----------------- | --------- | -------------------------------------- |
+| PDSP.MACHINE_X | FLOAT | Machine X-axis coordinate |
+| PDSP.SPINDLE_SPEED | INT32 | Spindle speed |
+| PDSP.TOOL_NO | INT16 | Current tool number |
+| PDSP.FEED_OVERRIDE | INT32 | Feed override |
+| ALARM.1 | INT32 | Alarm data column 1 |
+| WKCNTR.COUNT | INT32 | Workpiece count |
+| PRDC2.CYCLE_TIME | INT32 | Cycle time |
+| PRGN.CURRENT | INT32 | Current program number |
+| PRGN.MAIN | STRING | Main program number |
+| PLCD.D.100 | INT16 | D register at address 100 |
+| PLCD.M.2048 | BIT | M relay at address 2048 |
+| TOLSD.1.1.2 | FLOAT | DB 1, tool ID 1, column index 2 |
+
+## Data Monitoring
+
+After configuring the tags, you can click **Monitoring** -> **Data Monitoring** to view device information. For more details, see [Data Monitoring](../../../admin/monitoring.md).