Duet Software Framework (DSF) is the bundle of software programs running on the Raspberry Pi that connects to and controls the Duet 3.
Duet 3 mainboards are supplied with an SD card loaded with the Raspberry Pi OS suitable for Raspberry Pi 3 or 4. For a standard setup, the SBC Setup for Duet 3 page gives an outline how to get setup initially, and what to do if there are issues.
Duet Software Framework utilises .NET 6 so an ARMv7 processor is required for operation. This means a Raspberry Pi 3 or newer is required. Support for the Raspberry Pi Zero 2W will be added as part of the upcoming 3.4 software release.
DuetPi (Raspberry Pi 3 or newer)
DuetPi is the official Debian image based on Raspberry Pi OS that is customised for the Duet 3. If you are not very familiar with the Raspberry Pi, it is strongly recommended to use this instead of the stock Raspbian image. See SBC Setup for Duet 3.
Stock Raspberry Pi OS and other SBCs
If you have the latest Raspbian image installed on your Raspberry Pi or if you are using another SBC, follow these instructions to get started with DSF.
It is a good idea to keep your system up-to-date to eliminate potential bugs and security issues. The following steps describe how this can be achieved.
Since DSF is provided as a standard Debian package feed, the update is quite trivial. To update it, run a standard system update on the attached SBC using a Linux console:
sudo apt update
sudo apt upgrade
This will automatically install the latest DSF components. You may achieve the same remotely using SSH.
This assumes that the unstable packages are a later version than the currently installed stable packages.
Change stable to unstable in /etc/apt/sources.list.d/duet3d.list:
sudo rm -f /etc/apt/sources.list.d/duet3d.list
sudo bash -c "echo 'deb https://pkg.duet3d.com/ unstable armv7' > /etc/apt/sources.list.d/duet3d-unstable.list"
Update your system:
sudo apt update
sudo apt upgrade
In a similar process to the above, this assumes that the stable packages are a later version than the currently installed unstable packages.
Change stable to unstable in /etc/apt/sources.list.d/duet3d.list:
sudo rm -f /etc/apt/sources.list.d/duet3d-unstable.list
sudo bash -c "echo 'deb https://pkg.duet3d.com/ stable armv7' > /etc/apt/sources.list.d/duet3d.list"
Update your system:
sudo apt update
sudo apt upgrade
To downgrade from an installed version to a earlier release requires a few extra steps to remove files newer than the release version. This example demonstates downgrading from an unstable release to a stable release, the process is similar for downgrading to an unstable release. Follow these steps:
Change back unstable to stable in /etc/apt/sources.list.d/duet3d.list:
sudo rm -f /etc/apt/sources.list.d/duet3d-unstable.list
sudo bash -c "echo 'deb https://pkg.duet3d.com/ stable armv7' > /etc/apt/sources.list.d/duet3d.list"
Refresh the package lists:
sudo apt update
Remove potentially left-over RRF packages
rm -f ./reprapfirmware*.deb
Download the latest stable RepRapFirmware package
apt download reprapfirmware/stable
Downgrade RepRapFirmware
sudo dpkg -i --force-depends ./reprapfirmware*.deb
Downgrade DSF:
sudo apt install -y --allow-downgrades duetsoftwareframework/stable duetcontrolserver/stable duetwebserver/stable duetpluginservice/stable duettools/stable duetruntime/stable duetwebcontrol/stable
The first SD card (0:/) is emulated by DCS and its default directory is /opt/dsf/sd. It may changed by editing the BaseDirectory value in /opt/dsf/conf/config.json.
Duet3D provides some sample plugins for DSF which are available on GitHub.
Other third-party plugins are available on the forum.
If you want to get involved in plugin development, check out the DSF and DWC plugin guides.
Please use the forum to report any issues: https://forum.duet3d.com/