Development/Running on Linux - Revision history

Tanderson at 19:36, 2 January 2020

2020-01-02T19:36:16Z

Tanderson at 19:32, 9 November 2017

2017-11-09T19:32:25Z

Tanderson at 19:58, 30 October 2017

2017-10-30T19:58:50Z

Tanderson: /* Installing Mono */

2016-12-29T23:57:35Z

‎Installing Mono

Tanderson at 20:21, 5 December 2016

2016-12-05T20:21:54Z

MatterHackers: MatterHackers moved page Running on Linux to Development/Running on Linux

2016-11-30T22:17:43Z

MatterHackers moved page Running on Linux to Development/Running on Linux

Tanderson at 18:50, 3 October 2016

2016-10-03T18:50:33Z

Tanderson at 23:53, 10 May 2016

2016-05-10T23:53:30Z

MatterHackers: Created page with "You can either download the official .deb package from [http://www.mattercontrol.com/#jumpMatterControlDownloads MatterControl.com] or Building MatterControl|build from sour..."

2015-12-07T21:03:23Z

Created page with "You can either download the official .deb package from [http://www.mattercontrol.com/#jumpMatterControlDownloads MatterControl.com] or Building MatterControl|build from sour..."

New page

You can either download the official .deb package from [http://www.mattercontrol.com/#jumpMatterControlDownloads MatterControl.com] or [[Building MatterControl|build from source]]. There are also user contributed packages for [https://aur.archlinux.org/packages/mattercontrol/ Arch] and [https://bugs.gentoo.org/show_bug.cgi?id=545340 Gentoo].

== Installing Mono ==

MatterControl requires Mono version 3.10 or above. If you are on an older version of Ubuntu or Fedora that does not have the latest Mono then you can add the official Xamarin repository to get up to date. The official MatterControl download currently comes with a shell script to do this automatically on Debian based distros.

$ sudo apt-get install curl
$ curl -s <nowiki>http://download.mono-project.com/repo/xamarin.gpg</nowiki> | sudo apt-key add -
$ echo "deb <nowiki>http://download.mono-project.com/repo/debian wheezy main</nowiki>" | sudo tee /etc/apt/sources.list.d/xamarin.list
$ sudo apt-get update
$ sudo apt-get -y install mono-complete

There are also instructions for other distributions on the [http://www.mono-project.com/download/#download-lin Mono website].

== Serial Port Permissions ==

In order for MatterControl to access the serial ports, you will need to give your user the appropriate permissions. On Debian or Fedora based distros, add yourself to the dialout group. On Arch, add yourself the the uucp and lock groups instead.

$ gpasswd -a $USER dialout

You will then need to logout and log back in for the changes to take effect.

== Assigning Serial Ports ==

On Linux, serial port assignments can change whenever a printer is connected or disconnected. MatterControl cannot tell which printer is connected to which serial port. You can setup a udev rule to permanently assign a unique port to your printer.

Do <code>ls /dev/tty*</code> before and after connecting your printer to find out which port it is assigned to. Printers will show up as either <code>/dev/ttyACM#</code> or <code>/dev/ttyUSB#</code>.

Use <code>udevadm</code> to get the serial number (UUID) of the USB device. This is a unique 20 digit hexadecimal value.

<code>$ udevadm info --attribute-walk -n /dev/ttyACM0 | grep "serial"</code>

Some printers will not report a serial number. In this case, you will have to use other attributes to identify it such as the vendor ID (idVendor) and the product ID (idProduct).

Create a file <code>/etc/udev/rules.d/97-3dprinters.rules</code>. Here is an example with rules for two printers.

SUBSYSTEM=="tty", ATTRS{serial}=="6403237383335190E0F1", GROUP="uucp", MODE="0660", SYMLINK+="tty-taz"
SUBSYSTEM=="tty", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="076b", GROUP="uucp", MODE="0660", SYMLINK+="tty-kosselpro"

Fill in either the serial number or vender and product IDs based on the information you obtained earlier. Make sure `GROUP` is set to the same group ownership as the rest of your serial ports. This is usually `dialout` on Debian or `uucp` on Arch. You can check by doing <code>ls -l /dev/ttyACM*</code>. Lastly, give your printer a unique name for the `SYMLINK`. This name must start with `tty` or it will not show up in the list in MatterControl.

The next time you connect the printer, a symlink will automatically be created that points to the correct serial device. You can now edit the printer in MatterControl and choose the new device.

== Adding Proprietary Plugins ==

If you are building from source, MatterControl will not come with certain proprietary components such as the Cloud Services or Print Notifications plugins. To get these, you will need to download the official release from [http://www.mattercontrol.com/#jumpMatterControlDownloads mattercontrol.com] and copy the following `.dll`, `.dll.config` and `.dll.mdb` files to your MatterControl directory.

CloudServices.dll
CloudServices.dll.config
CloudServices.dll.mdb
MatterControlAuth.dll
MatterControlAuth.dll.config
MatterControlAuth.dll.mdb
Mono.Nat.dll
Mono.Nat.dll.mdb
PictureCreator.dll
PictureCreator.dll.config
PictureCreator.dll.mdb
PrintNotifications.dll
PrintNotifications.dll.config
PrintNotifications.dll.mdb

== Using Other Slice Engines ==

MatterControl's built in slice engine is MatterSlice, which is a port of CuraEngine to C#. You can also choose other slicing engines. The official release comes with Slic3r, but when building from source or using unofficial packages you will have to install the other engines seperately and make symlinks in the MatterControl directory. For example on Arch, make a symlink in <code>/usr/lib/mattercontrol/Slic3r/bin</code> to the Slic3r executable.

# mkdir /usr/lib/mattercontrol/Slic3r
# mkdir /usr/lib/mattercontrol/Slic3r/bin
# ln -s /usr/bin/slic3r /usr/lib/mattercontrol/Slic3r/bin/slic3r

To use CuraEngine, do

# ln -s /usr/share/cura/CuraEngine /usr/lib/mattercontrol/CuraEngine.exe

Yes, it expects the `.exe` extension even on Linux.

[[Category:Linux]]
[[Category:Development]]
[[Category:Installation]]

← Older revision		Revision as of 19:36, 2 January 2020
Line 1:		Line 1:
		+	{{Migrated\|linux}}
		+
	You can either download the official .deb package from [http://www.mattercontrol.com/#jumpMatterControlDownloads MatterControl.com] or [[Building MatterControl\|build from source]]. There are also user contributed packages for [https://aur.archlinux.org/packages/mattercontrol/ Arch] and [https://bugs.gentoo.org/show_bug.cgi?id=545340 Gentoo].		You can either download the official .deb package from [http://www.mattercontrol.com/#jumpMatterControlDownloads MatterControl.com] or [[Building MatterControl\|build from source]]. There are also user contributed packages for [https://aur.archlinux.org/packages/mattercontrol/ Arch] and [https://bugs.gentoo.org/show_bug.cgi?id=545340 Gentoo].

@@ Line 3: / Line 3: @@
 == Installing Mono ==
-MatterControl requires Mono version 3.10 or above. MatterControl works best with Mono 4.4. As of this writing (12/29/16) There is a bug in Mono 4.6 that prevents the cloud services from establishing a full connection. The [[Cloud/Connection_Display | connection indicator]] will remain yellow. All other features are fully functional.
+MatterControl works best with Mono 4.4. Earlier versions are not supported. There is an issue with Mono 4.6 and later that prevents the cloud services from establishing a full connection. The [[Cloud/Connection_Display | connection indicator]] will remain yellow. All other features are fully functional.
-If you are on an older version of Ubuntu (before Xenial 16.04 LTS) or Fedora that does not have the latest Mono then you can add the official Xamarin repository to get up to date. The official MatterControl download currently comes with a shell script to do this automatically on Debian based distros.
+If you are on an older version of Ubuntu (before Xenial 16.04 LTS) or Debian that does not have the latest Mono then you can add the official Xamarin repository to get up to date. The official MatterControl download currently comes with a shell script to do this automatically on Debian based distros.
      $ sudo apt-get install curl

@@ Line 70: / Line 70: @@
 MatterControl's built in slice engine is MatterSlice, which is a port of CuraEngine to C#. You can also choose other slicing engines. The official release comes with Slic3r, but when building from source or using unofficial packages you will have to install the other engines separately and make symlinks in the MatterControl directory. For example on Arch, make a symlink in <code>/usr/lib/mattercontrol/Slic3r/bin</code> to the Slic3r executable.
-     # mkdir /usr/lib/MatterControl/Slic3r
+     # mkdir /usr/lib/mattercontrol/Slic3r
-     # mkdir /usr/lib/MatterControl/Slic3r/bin
+     # mkdir /usr/lib/mattercontrol/Slic3r/bin
-     # ln -s /usr/bin/slic3r /usr/lib/MatterControl/Slic3r/bin/slic3r
+     # ln -s /usr/bin/slic3r /usr/lib/mattercontrol/Slic3r/bin/slic3r
 To use CuraEngine, do
-     # ln -s /usr/share/cura/CuraEngine /usr/lib/MatterControl/CuraEngine.exe
+     # ln -s /usr/share/cura/CuraEngine /usr/lib/mattercontrol/CuraEngine.exe
 Yes, it expects the `.exe` extension even on Linux.

@@ Line 3: / Line 3: @@
 == Installing Mono ==
-MatterControl requires Mono version 3.10 or above. If you are on an older version of Ubuntu (before Xenial 16.04 LTS) or Fedora that does not have the latest Mono then you can add the official Xamarin repository to get up to date. The official MatterControl download currently comes with a shell script to do this automatically on Debian based distros.
+MatterControl requires Mono version 3.10 or above. MatterControl works best with Mono 4.4. As of this writing (12/29/16) There is a bug in Mono 4.6 that prevents the cloud services from establishing a full connection. The [[Cloud/Connection_Display | connection indicator]] will remain yellow. All other features are fully functional.
      $ sudo apt-get install curl
      $ curl -s <nowiki>http://download.mono-project.com/repo/xamarin.gpg</nowiki> | sudo apt-key add -
-     $ echo "deb <nowiki>http://download.mono-project.com/repo/debian wheezy main</nowiki>" | sudo tee /etc/apt/sources.list.d/xamarin.list
+     $ echo "deb <nowiki>http://download.mono-project.com/repo/debian wheezy/snapshots/4.4.2 main</nowiki>" | sudo tee /etc/apt/sources.list.d/xamarin.list
      $ sudo apt-get update
      $ sudo apt-get -y install mono-complete

@@ Line 77: / Line 77: @@
 Yes, it expects the `.exe` extension even on Linux.
 [[Category:Linux]]
 [[Category:Development]]
 [[Category:Installation]]

← Older revision	Revision as of 22:17, 30 November 2016
(No difference)

@@ Line 60: / Line 60: @@
      PrintNotifications.dll.config
      PrintNotifications.dll.mdb
 == Using Other Slice Engines ==