Skip to content

Python wrapper for the Reprapfirmware 3 Duet REST API on Duet 3 & 2

License

Notifications You must be signed in to change notification settings

AndyEveritt/DuetWebAPI

Repository files navigation

DuetWebAPI

Python interface to Duet RepRap V3 firmware via Http REST API.

  • Works over IP network.
  • Does not support passwords on the printer.
  • Supported boards:
    • Duet 3 + SBC
    • Duet 3 standalone
    • Duet 2 standalone

Install

pip install duetwebapi

Alternatively:

pip install -e "git+https://github.com/AndyEveritt/DuetWebAPI.git@master#egg=duetwebapi"

Usage

  • See 'examples.py' for examples.
from duetwebapi import DuetWebAPI

printer = DuetWebAPI(f'http://{printer_hostname}')

REST API

The REST API allows for the following operations:

Method Description
connect(password: str = '') -> Dict Start a connection with Duet. DWC api only
disconnect() -> Dict End a connection with Duet. DWC api only
get_model(key: str = None, depth: int = 99, verbose: bool = True, null: bool = True, frequent: bool = False, obsolete: bool = False) -> Dict Get Duet object model. RRF3 only. Flags only supported in DWC api.
send_code(code: str) -> Dict Send G/M/T-code to Duet
get_file(filename: str, directory: str = 'gcodes', binary: bool = False) -> str Download file from Duet
upload_file(file: str | bytes | StringIO | TextIOWrapper | BytesIO, filename: str, directory: str = 'gcodes') -> Dict Upload file to Duet
get_fileinfo(filename: str = None, directory: str = 'gcodes') -> Dict Get file info
delete_file(filename: str, directory: str = 'gcodes') -> Dict Delete file on Duet
move_file(from_path: str, to_path: str, force: bool = False) -> Dict Move file on Duet, can be used to rename files
get_directory(directory: str) -> List[Dict] Get a list of all the files & directories in a directory
create_directory(directory: str) -> Dict Create a new directory

Wrapper

An additional wrapper is provided to make repetative tasks easier

Method Description
emergency_stop() -> None Send M112 > M999
start_print(filename: str) -> Dict start a print on duet
pause_print() -> Dict pause current print
stop_print(leave_heaters: bool) -> Dict stop current print, will pause first if not paused
get_coords() -> Dict return the current position of all the movement axes
get_layer() -> int return the current layer number of the print
get_num_extruders() -> int return the number of extruders currently configured
get_num_tools() -> int return the number of tools currently configured
get_status() -> str return the current Duet status
get_temperature() -> List[Dict] return a list of all the analog sensors and their value
get_current_tool() -> int return the current tool number
get_messagebox() -> Dict return the details of a message displayed via M291 if one exists
acknowledge_message(response: int) -> Dict send an acknowledgement to a message if one exists. Response options are 0 (continue), and 1 (cancel)

About

Python wrapper for the Reprapfirmware 3 Duet REST API on Duet 3 & 2

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published