Difference between revisions of "Send Debugging Information"

From MatterControl Manual
Jump to: navigation, search
(Mac)
 
(10 intermediate revisions by 2 users not shown)
Line 18: Line 18:
 
If you are encountering a crash error on Mac follow the steps described below to generate a report:
 
If you are encountering a crash error on Mac follow the steps described below to generate a report:
  
 +
#Close any open instances of MatterControl.
 
#Go to the 'Applications' folder.
 
#Go to the 'Applications' folder.
 
#Locate the MatterControl.app file.
 
#Locate the MatterControl.app file.
 
#Right-click and select "Show Package Contents".
 
#Right-click and select "Show Package Contents".
 
#Navigate to 'Contents' > 'MacOS'.
 
#Navigate to 'Contents' > 'MacOS'.
#Click the 'MatterControlMac' file (this will open a terminal window and start the application).
+
#Double click the 'MatterControlMac' file (this will open a terminal window and start the application).
 
#Copy the output.
 
#Copy the output.
 
#:If MatterControl crashes upon startup copy the message that appears in the terminal window immediately.
 
#:If MatterControl crashes upon startup copy the message that appears in the terminal window immediately.
Line 33: Line 34:
  
 
== Other Useful Files ==
 
== Other Useful Files ==
 +
 +
=== Model File ===
 +
 +
The STL or AMF file you are trying to print using MatterControl.
  
 
=== Slice Settings ===
 
=== Slice Settings ===
[[File:Options Menu.png|framed|right|<center>The '''Options...''' Menu</center>]]
+
[[File:Profile Menu.png|framed|right|<center>The '''Profile...''' Menu</center>]]
 
These are all of the settings that define how your object is to be printed. If you are having trouble getting good results, we may ask you to export all of your settings and send them to us so we can give you recommendations.
 
These are all of the settings that define how your object is to be printed. If you are having trouble getting good results, we may ask you to export all of your settings and send them to us so we can give you recommendations.
  
 
#Go to the [[Settings]] page.
 
#Go to the [[Settings]] page.
#On the right side, underneath the materials selection, there is a drop down menu that says 'Options...'. Open this menu.
+
#On the right side, underneath the MATERIALS preset selection, there is a drop down menu that says 'Profile...'. Open this menu.
 
#Select 'Export'
 
#Select 'Export'
 +
#Choose 'MatterControl'
 
#Save the file.
 
#Save the file.
  
Line 46: Line 52:
 
These are the instructions generated by the slicer, which will be sent to your printer. If your object is not being printed correctly, we may ask for this file.
 
These are the instructions generated by the slicer, which will be sent to your printer. If your object is not being printed correctly, we may ask for this file.
  
#Open your object in the [[3D View]].
+
#Open your object in [[3D VIEW]].
 
#Click the 'Export' button at the bottom and select 'Export as G-Code'.
 
#Click the 'Export' button at the bottom and select 'Export as G-Code'.
 
#Save the file.
 
#Save the file.
Line 53: Line 59:
 
[[File:G-Code Terminal.png|right|framed|<center>The '''G-Code Terminal''' window, shown here after establishing a connection to a Rostock MAX V2.</center>]]
 
[[File:G-Code Terminal.png|right|framed|<center>The '''G-Code Terminal''' window, shown here after establishing a connection to a Rostock MAX V2.</center>]]
 
This log details all the communications between MatterControl and your printer. It is helpful for diagnosing hardware/firmware errors and communications issues.
 
This log details all the communications between MatterControl and your printer. It is helpful for diagnosing hardware/firmware errors and communications issues.
 +
 +
It is important to note that reconnecting to the printer will clear the previous print's log, so make sure you export the file before you attempt to do so.
  
 
#Run a print as you normally would.
 
#Run a print as you normally would.
Line 58: Line 66:
 
#Click the 'Export' button at the bottom of the screen.
 
#Click the 'Export' button at the bottom of the screen.
 
#Save the print log.
 
#Save the print log.
 +
<br clear=all>
 +
== Build Number ==
  
== Other Information ==
+
=== MatterControl Desktop ===
 
+
=== Build Number ===
+
 
+
==== MatterControl Desktop ====
+
  
 
Navigate:
 
Navigate:
Line 70: Line 76:
 
#All the way at the bottom: 'Build 1.___________' i.e. Build 1.4.0.5376 -- the last four numbers are what's important
 
#All the way at the bottom: 'Build 1.___________' i.e. Build 1.4.0.5376 -- the last four numbers are what's important
  
==== MatterControl Touch ====
+
=== MatterControl Touch and T10 ===
  
 
Navigate:
 
Navigate:
Line 79: Line 85:
 
[[Category:Mac]]
 
[[Category:Mac]]
 
[[Category:Windows]]
 
[[Category:Windows]]
 +
[[Category:Linux]]
 
[[Category:MatterControl Touch]]
 
[[Category:MatterControl Touch]]

Latest revision as of 09:27, 13 September 2017

MatterControl occasionally has issues (*gasp*), but there is often information you can collect which might tell us more about what the problem is. Send the appropriate files to support@matterhackers.com, or upload them to a service like Pastebin and post them in our forum.

Crash Logs

These processes can be helpful for debugging crashes or issues with the MatterControl application itself.

Windows

The following steps could produce some error logs that might tell us more about what's going on:

  1. Right click on ‘My Computer’ and select ‘Manage.’
  2. In the menu on the left, navigate to ‘System Tools’ > ‘Event Viewer’ > ‘Windows Logs’.
  3. Click on ‘Application’ to show logs in the middle window pane, then click ‘Filter Current Log’ in the right window pane, then check ‘Error’ and hit ‘OK’.
  4. In the right window pane, choose ‘Save Filtered Log File As’. Give the file (should be in .evtx format) a descriptive name.
  5. Attach the .evtx file to an email to support@matterhackers.com. Describe the circumstances leading up to the crash.

Mac

If you are encountering a crash error on Mac follow the steps described below to generate a report:

  1. Close any open instances of MatterControl.
  2. Go to the 'Applications' folder.
  3. Locate the MatterControl.app file.
  4. Right-click and select "Show Package Contents".
  5. Navigate to 'Contents' > 'MacOS'.
  6. Double click the 'MatterControlMac' file (this will open a terminal window and start the application).
  7. Copy the output.
    If MatterControl crashes upon startup copy the message that appears in the terminal window immediately.
    If the crash is triggered by a specific event, recreate the event and then copy the message that appears.
  8. Send the error message to support@matterhackers.com along with a description of the steps that cause the issue.

Linux

Run MatterControl from a terminal. Copy all output and send it to support@matterhackers.com

Other Useful Files

Model File

The STL or AMF file you are trying to print using MatterControl.

Slice Settings

The Profile... Menu

These are all of the settings that define how your object is to be printed. If you are having trouble getting good results, we may ask you to export all of your settings and send them to us so we can give you recommendations.

  1. Go to the Settings page.
  2. On the right side, underneath the MATERIALS preset selection, there is a drop down menu that says 'Profile...'. Open this menu.
  3. Select 'Export'
  4. Choose 'MatterControl'
  5. Save the file.

G-Code File

These are the instructions generated by the slicer, which will be sent to your printer. If your object is not being printed correctly, we may ask for this file.

  1. Open your object in 3D VIEW.
  2. Click the 'Export' button at the bottom and select 'Export as G-Code'.
  3. Save the file.

Print Log / Terminal Log

The G-Code Terminal window, shown here after establishing a connection to a Rostock MAX V2.

This log details all the communications between MatterControl and your printer. It is helpful for diagnosing hardware/firmware errors and communications issues.

It is important to note that reconnecting to the printer will clear the previous print's log, so make sure you export the file before you attempt to do so.

  1. Run a print as you normally would.
  2. Once the problem occurs, open the G-Code terminal by going to Options > Show Terminal.
  3. Click the 'Export' button at the bottom of the screen.
  4. Save the print log.


Build Number

MatterControl Desktop

Navigate:

  1. HELP menu
  2. About MatterControl
  3. All the way at the bottom: 'Build 1.___________' i.e. Build 1.4.0.5376 -- the last four numbers are what's important

MatterControl Touch and T10

Navigate:

  1. ABOUT
  2. All the way at the bottom: 'Build 1.___________' i.e. Build 1.4.0.5376 -- the last four numbers are what's important