Duet Software Framework resembles a collection of programs to control an attached Duet3D board from a Linux-based mini computer (SBC). Since it is using .NET, it requires an ARM processor that supports ARMv7 instructions processor is required (Raspberry Pi 2 or newer). In addition, Linux >= 4.8 is required because the relatively new gpiochip character device interface is used.
This application is the heart component of Duet Software Framework. It takes takes care of G/M/T-code processing, inter-process communication, file path mapping, and communication with RepRapFirmware as well as firmware updates. If you want to write your own plugins, this is the component that you need to connect to.
The following command-line arguments are available:
-u,--update: Update RepRapFirmware and exit. This works even if another instance is already started-l,--log-level: Set the minimum log level. Valid options are:trace,debug,info,warn,error,fatal,offDefault isinfo-c,--config: Override the path to the JSON configuration file. Defaults to/opt/dsf/conf/config.json-r,--no-reset-stop: Do not terminate this application when M999 has been processed-S,--socket-directory: Override the path where DCS creates UNIX sockets. Defaults to/var/run/dsf-s,--socket-file: Override the filename of DCS's UNIX socket. Defaults todcs.sock-b,--base-directory: Set the base directory of the virtual SD card directoy. This is used for RepRapFirmware compatibility. Defaults to/opt/dsf/sd-D,--no-spi: Do NOT connect over SPI. Not recommended, use at your own risk!-h,--help: Display all available command-line parameters
Note that all the command-line options are case-sensitive.
This application may return the following codes (derived from sysexits.h):
0: Successful termination64: Failed to initialize settings (usage error)69: Could not connect to Duet (service unavailable)70: Internal software error71: Failed to initialize environment (OS error)73: Failed to initialize IPC socket (Cannot create file)74: Could not open SPI or GPIO device (IO error)75: Auto-update disabled or other instance already running (temporary failure)78: Bad settings file (configuration error)
In order to connect to the firmware, a binary data protocol is used. DuetControlServer attaches to the Duet using an SPI connection (typically /dev/spidev0.0) in master mode.
In addition, a GPIO pin (typically pin 22 on the Raspberry Pi header via /dev/gpiochip0) is required which is toggled by RepRapFirmware whenever the firmware is ready to exchange data.
More technical documentation about this can be found here.
DuetControlServer provides a UNIX socket for inter-process commmunication. This socket usually resides in /var/run/dsf/dcs.sock .
For .NET, DSF provides the DuetAPIClient class library which is also used internally by the DSF core applications.
Technical information about the way the communication over the UNIX socket works can be found in the API description.
Like RepRapFirmware, DSF provides a central object model that replicates the entire machine state. This model data is synchronized with Duet Web Control as well and stored in its backend. For further information about the object model structure, check out the DSF code documentation.
Since RepRapFirmware relies on files from a SD card, DSF provides an emulation layer.
These files are stored inside a "virtual SD card" for RepRapFirmware in /opt/dsf/sd.
However, this path may be adjusted in the config.json file (in /opt/dsf/conf).
The configuration behind DCS is kept quite flexible in order to allow for simple changes.
By default those values are stored in /opt/dsf/conf/config.json but the config path may be overridden using a command-line parameter.
Check out the code documentation for an overview of the available settings.
This application provides Duet Web Control along with a RESTful API and possibly custom HTTP endpoints.
It is implemented using ASP.NET and uses Kestrel internally. The coniguration file defaults to /opt/dsf/conf/http.json.
The configuration file of DuetWebServer can be found in /opt/dsf/conf/http.json. In this file various settings can be tuned.
In the Logging section, the default minimum LogLevel can be changed to one of Trace, Debug, Information, Warning, Error, orCritical. It defaults to Information.
The Kestrel section specifies the default configuration of the underlying webserver. Further details about the available options can be found at Microsoft Docs.
Apart from these two sections, you can also customize the following settings:
SocketPath: Path to the UNIX socket provided by DCSStartErrorFile: Optional file containing the last start error from DCSKeepAliveInterval: Default keep-alive interval for WebSocket connections. This is useful if DWS is operating as a reverse proxySessionTimeout: Default timeout for inactive HTTP sessionsModelRetryDelay: If DuetControlServer is not running, this specifies the delay between reconnect attempts in millisecondsObjectModelUpdateTimeout: When a WebSocket is connected and waiting for object model changes, this specifies the timeout after which DWS stops waiting and polls the WebSocket againUseStaticFiles: Whether to provide web files from the virtualwwwdirectory. This is required for DWC if DWS is not running as a reverse proxyDefaultWebDirectory: Default web directory to fall back to if DCS could not be contacted (requiresUseStaticFilesto be set)MaxAge: Maximum cache time for static files (requiresUseStaticFilesto be true)WebSocketBufferSize: This defines the maximum buffer size per third-party WebSocket connection
It is possible to override these settings using command-line arguments, too.
If you wish to use another HTTP server than DuetWebServer, it is possible to set up DuetWebServer as a reverse proxy. Check out this page for Apache and this one for nginx.
DSF comes with a bunch of command-line tools. They may be invoked from a local terminal or from a remote connection via SSH.
All these tools are installed to /opt/dsf/bin so e.g. the CodeConsole utility can be invoked using /opt/dsf/bin/CodeConsole.
This tool can be used to run G/M/T-codes and to wait for a result.
The following command-line arguments are available:
-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.sock-c,--code: Execute the given code(s), wait for the result and exit-q,--quiet: Do not display when a connection has been established (only applicable if-cis not set)-h,--help: Display all available command-line parameters
This tool lets you track the lifecycle of a G/M/T-code that is processed by DSF. Once launched, these types of code interception can be observed:
pre: Code is being started but it has not been processed internally yetpost: Code has been executed internally but it has not been resolved. It is about to be sent to RepRapFirmware for further processingexecuted: Code has been executed and a result is about to be returned
The following command-line arguments are available:
-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.sock-q,--quiet: Do not display when a connection has been established (only applicable if-cis not set)-h,--help: Display all available command-line parameters
This tool can be used to stream codes in order to execute multiple G/M/T-codes without waiting for a response first. When a code has finished, the corresponding result is written to the console.
The following command-line arguments are available:
-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.sock-b,--buffer-size <size>: Maximum number of codes to execute simultaneously-q,--quiet: Do not display when a connection has been established (only applicable if-cis not set)-h,--help: Display all available command-line parameters
This tool lets you create a custom RESTful HTTP or WebSocket endpoint via /machine/{namespace}/{path}. If started without any command-line arguments, it will try to register a new HTTP GET endpoint at /machine/custom-http-endpoint/demo that is accessible from a web browser. It is possible to register different HTTP methods at the same endpoint path.
By default, this tool echoes the session ID, HTTP method, received HTTP headers, queries, and body (if set). If WebSocket mode is selected, the tool will wait for the a single connection, print text data received from the WebSocket to stdout and send input lines from stdin back to the WebSocket.
Binary data transfers are not supported in any mode. If you need to transfer binary data, upload to a file instead and call your custom endpoint when the transfer has finished.
-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.sock-m,--method: Set designated method for the HTTP endpoint. May be one ofGET,POST,PUT,PATCH,TRACE,DELETE,OPTIONS,WebSocket-n,--namespace: Set namespace to use (defaults to custom-http-endpoint)-p,--path: Set HTTP query path (defaults to demo)-e,--exec: Set binary file to execute when an HTTP query is received. Stdout and stderr are returned as the response body once the program terminates-u,--uri <uri>: Tell the web server to relay the incoming request to another server specified by the URI-a,--args: Set arguments for the executable file. Query values in%characters are replaced with query options (e.g.%myvalue%). Not applicable for WebSockets-q,--quiet: Do not display info text-h,--help: Display all available command-line parameters
This DSF plugin provides various M-code extensions to mimic standalone compatibility using various M-codes. It is intended to be used with DuetPi because it requires various services to be installed first.
See its dedicate README.md for further details.
-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.sock
Two instances of this service run as
- DSF user
- Root user
It is in charge of plugin installations, security profiles, and plugin lifecycles.
Hence this service starts and stops whenever DuetControlServer does (using the PartOf systemd binding).
Unlike DuetControlServer, which starts early in the boot process (sysinit target), this service is started as soon as the system reaches the multi-user target.
This is intended to reduce load on the system during start-up and to make sure potentially required resources are available when third-party plugins are started.
As soon as both plugin services (and the previously started plugins) have been started, dsf-config.g is executed by DuetControlServer.
Note that dsf-config.g does not run if not both services have been started unless plugin support has been disabled in /opt/dsf/conf/config.json.
-l,--log-level: Set the minimum log level. Valid options are:trace,debug,info,warn,error,fatal,offDefault isinfo-c,--config: Override the path to the JSON configuration file. Defaults to/opt/dsf/conf/config.json-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.sock-h,--help: Display all available command-line parameters
This tool lets you keep track of object model changes. Since it relies on a model subscription, it gives an idea how model updates are pushed from DuetWebServer to Duet Web Control.
-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.sock-f,--filter <filter>: UNIX socket to connect to-c,--confirm: Confirm every JSON receipt manually-q,--quiet: Do not display when a connection has been established-h,--help: Display all available command-line parameters
This tool is intended to manage third-party plugins directly on the SBC without a GUI.
-s,--socket: Specify the UNIX socket to connect to. Defaults to/var/run/dsf/dcs.socklist: List installed pluginslist-data: List plugin data of all installed pluginsinstall <pluginZIP>: Install a plugin ZIP filestart <plugin>: Start a pluginset-data <plugin>:<key>=<value>: Set plugin datastop <plugin>: Stop a pluginuninstall <plugin>: Uninstall a plugin-h,--help: Display all available command-line parameters
To ensure flawless operation of the most critical components, Duet Software Framework relies on unit tests via the NUnit framework. These unit tests can be found in the src/UnitTests directory.
- G-Code checksums and M998 are not supported
Before reporting any new issues, please check if it is already a known issue or if it has been already reported on the GitHub issues page. For general support questions, please check out the forums.
If the issue you encountered is easy to reproduce, please file a new issue in the GitHub issues page along with instructions on how to reproduce.
If the issue only happens sporadically, please launch DuetControlServer with the log level debug and provide the log including a short note when the error occurred.
To launch DuetControlServer with this log level on DuetPi, you may run the following commands from an SSH terminal:
sudo systemctl stop duetcontrolserver
sudo /opt/dsf/bin/DuetControlServer -l debug -r
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent