Brother Troubleshooting
Cannot Connect to Machine
Problem: Connection test fails or machine shows as disconnected.
Possible Causes:
- Incorrect IP address
- Network connectivity issue
- Machine control not configured correctly
- Firewall blocking connection
Solutions:
-
Verify IP Address:
- Check IP address on machine control matches configuration
- Ensure no typos in MachineMetrics configuration
-
Test Network Connectivity:
- Ping the machine via Diagnostics → Manual Ping in Edge Management, or from another computer on the network:
ping 192.168.42.200 - Verify successful ping responses
- Check network cable connection
- Ping the machine via Diagnostics → Manual Ping in Edge Management, or from another computer on the network:
-
Verify Machine Configuration:
- Confirm "Display slave command alarm" is set to 0
- Confirm "Restrict Ethernet access" is set to 0 (firmware 12+)
- Verify IP address is configured correctly
-
Check Firewall:
- Ensure network allows HTTP (port 80) and FTP (port 21) traffic
- Coordinate with IT team if needed
-
Restart Control:
- Power cycle the machine control (if safe to do so)
- Wait for control to fully boot before testing
FTP Authentication Failed
Problem: Connection test fails with FTP authentication error.
Possible Causes:
- The client credential fields were filled in instead of the server fields
- Incorrect FTP username or password
- FTP server not configured on machine
- Using HTTP mode but provided FTP credentials
Solutions:
-
Check Server vs Client Fields (most common cause):
- The control's Ethernet/FTP page has two credential pairs. MachineMetrics connects to the control, so only the server pair applies
- Confirm Server user name and Password as server are set
- Confirm User name as client and Password as client are blank — these are for the control connecting out to someone else's FTP server and are not used by MachineMetrics
- See Configure FTP Server Credentials
-
Verify Credentials Match Exactly:
- The
usernameandpasswordin the adapter script must match the control character for character — they are case-sensitive - Re-enter both carefully, watching for trailing spaces
- Keep values short and alphanumeric (e.g.
BRO1); the control's input fields are limited - Save changes and restart control
- The
-
Check Connection Mode:
- If using HTTP mode, remove FTP credentials from configuration
- If using Mixed/FTP mode, ensure credentials are provided
No Data Appearing
Problem: Machine shows as connected but no data items populate.
Possible Causes:
- Machine in wrong mode (not AUTO/REMOTE)
- Firmware version too old
- Collection mode misconfigured
- Missing or incorrect
cnc-version(D00 controls) - Machine not running a program
Solutions:
-
Check Machine Mode:
- Ensure machine is in AUTO or REMOTE mode
- Some data only appears during program execution
-
Verify Firmware Version:
- Check machine firmware version
- On C00, upgrade to 12.026 or higher if possible
-
Check
cnc-version(D00):- On a D00 control, the configuration must include
collection-mode: ftpandcnc-version: d00 - See D00 Control Not Reporting below
- On a D00 control, the configuration must include
-
Run Test Program:
- Load and run a program on the machine
- Watch for data updates in MachineMetrics
-
Request Adapter Logs:
- Edge device logs are not viewable in the app
- Contact MachineMetrics Support to have them pulled and checked
D00 Control Not Reporting
Recommended: For D00 controls, use OPC-UA instead of the Brother Adapter. See D Series.
Problem: A D00 machine on the Brother Adapter shows as connected but data is missing, or adapter logs show "file not found" (FTP 550) errors.
Cause:
D00 controls store their status files in different FTP locations and formats than C00 controls. If the adapter runs against a D00 control without cnc-version: d00, it looks for the C00 file layout and fails: typical symptoms are FTP 550 (file unavailable) errors in the adapter logs, or program header lookups against nonsensical paths (e.g. a path ending in O000000000.NC).
Solution:
- Edit the machine's data collection method
- Ensure the adapter script contains both keys:
collection-mode: ftp
cnc-version: d00 - Save and test connection
- If FTP 550 errors persist for individual files with
cnc-version: d00set, the machine stores those files in non-default locations: set the corresponding*-pathparameter(s) explicitly (see the parameter table in Configure the Brother Data Collection Method)
D00 part count note: the production counter used for part_count on D00 controls is a best-effort source. Verify it against the machine after setup; if it does not track your process, use one of the workpiece counters (custom_part_count_1 … custom_part_count_4) via data mapping instead.
Adapter Blocked by Another FTP Client
Problem: Data collection stops (values go UNAVAILABLE) while another FTP client — e.g. an operator or DNC application transferring programs — is connected to the machine. Adapter logs may show FTP 503 "Bad sequence of commands" errors.
Cause:
The Brother FTP server supports at most 4 simultaneous connections and has a single shared data channel. Another FTP client transferring files in ACTIVE mode can hold that channel and block the connector.
Solutions:
- The connector detects this condition, logs a prominent warning, and automatically resets its own connection to recover — no action is needed for occasional occurrences
- If it recurs frequently, the fix is on the other FTP client: configure it to use PASSIVE mode, and/or avoid concurrent FTP transfers against the machine
- Alternatively, on C00 controls, switch the connector to HTTP mode so it does not use FTP at all (this gives up program headers and the FTP-only data items)
Part Count Not Incrementing
Problem: Part count stays at zero or doesn't increment.
Possible Causes:
- Part counter not configured on machine
- Program doesn't trigger part count
- Data mapping not configured
- Old C00 firmware page format (HTTP/Mixed mode)
Solutions:
-
Check Machine Part Counter:
- Verify machine has built-in part counter
- Run program and check if counter increments on machine
-
Verify Data Mapping:
- Go to Machine Settings → Data Mapping
- Confirm
part_countis mapped as PART_COUNT data type - Alternatively, map one of the workpiece counters (
custom_part_count_1…custom_part_count_4)
-
Check Data Rules:
- Go to Machine Settings → Data Rules
- Verify correct part count source is selected
-
Check Firmware (HTTP/Mixed mode):
- On C00 controls with firmware older than 12.026,
part_countmay not be available over HTTP; use FTP mode or a workpiece counter
- On C00 controls with firmware older than 12.026,
-
Review Program:
Program Headers Not Available (HTTP Mode)
Problem: Program header information is missing.
Cause:
- HTTP Mode does not support program headers
Solution:
Switch to Mixed Mode or FTP Mode to enable program headers:
- Edit machine's data collection method
- Change adapter script, using the Server user name and Password as server set on the
control:
version: 2
collection-mode: mixed
username: BRO1
password: BRO1 - Save and test connection