AMBOTS UI Guide
- 1 1- Overview
- 1.1 Part 1: UI Environment Setup
- 1.2 Part 2: UI Sections
- 1.2.1 Environment Selection
- 1.2.2 Navigation Bar
- 1.2.2.1 Upload Files
- 1.2.2.2 Hub Watcher
- 1.2.2.3 Gcode Sender
- 1.2.2.4 Slicer Settings
- 1.2.3 Printer List
- 1.2.3.1 Printer Assignment
- 1.2.3.2 Printer Settings
- 1.2.4 My Print Jobs List
- 1.2.5 Workspace
- 1.2.5.1 Upload Model
- 1.2.5.2 Export Model
- 1.2.5.3 Delete
- 1.2.5.4 Move
- 1.2.5.5 Rotate
- 1.2.5.6 Scale
- 1.2.5.7 Auto Scale
- 1.2.5.8 Auto Center
- 1.2.6 Model List
- 1.2.7 Model Transform Table
- 1.2.8 Console
- 1.2.9 Connection Status Icons
- 1.2.10 UI Section Resizing
- 2 2- Print Process
Notice: This document is being updated as we make changes to the UI, and as such, some images may show older versions of the UI. This should be because the UI element being explained has not been changed since that older version; however, if you notice something inconsistent between your UI and what is being explained in this guide, please let us know so we can rectify it.
1- Overview
Part 1: UI Environment Setup
When you first open the UI there is a reminder to make sure you are connected to the same network as the hub and printers to use the UI. Otherwise, you won’t be able to communicate with the system.
After clearing the reminder you will see the My Environments screen. This screen is where you can save different printer layouts.
To get started you need to make a layout.
1. Type your desired environment name in the input field.
If there are previously created environments, make sure to type a different name.
2. Press the plus icon button that is next to the input field or press ENTER.
Now, you’ll see your environment included in the list. You’ll also see three action buttons which are in charge of the following.
Environment Name
Rename
As its name states, it renames the environment selected. This functionality includes error checking for cases in which we provide the same environment name as other created environments or names with more than 25 characters.
Layout Settings
This button opens up another portal that allows users to configure their desired workspace layout. After configuring the layout the environment will be activated and ready to open.
Delete
This button deletes the environment selected.
Each button has a tooltip title description if you hover over them.
To continue, click on the layout settings button.
The layout settings opens the workspace layout screen.
This is where you configure your printer layout for the slicer.
The workspace layout has five elements.
Drop down for layout presets.
Number of printers in X direction (side by side)
Number of printers in Y direction (face to face). This has a maximum of two.
Confirm your settings.
Save to current environment and close workspace layout screen.
Once you have set up a layout, a new button appears alongside it in the list.
This button opens the environment.
Part 2: UI Sections
Once you have opened an environment, you will be taken to the main UI screen.
Environment Selection
The upper bar of the UI shows the current environment you have selected.
You can click the folder icon to be taken back to the Environment selection screen to select a different environment, change the settings of the current one, or make a new one.
Navigation Bar
To the right of the current environment, there are six icons.
Upload file
Hub Watcher
Gcode Sender
Slicer Settings
Printer Calibration
Updater
This section details the use of these buttons.
Upload Files
This button opens a panel to send the current build plate to the Hub for processing.
There are two checkboxes in this panel.
Auto send to Printers: If checked the hub will upload the processed gcode file to the selected printers automatically, there is no reason to uncheck this unless you are bugfixing the hub.
Enable Supports: Needs to be checked if you are printing a file with a slicer profile that has supports enabled. The hub processes files with supports slightly differently than without.
The Job Nick Name box allows you to name the print job to change how it shows up in the “My Print Jobs” list.
The Upload button at the bottom of the panel sends the build plate to the hub.
Hub Watcher
Opens up a panel with three general sections.
At the top of the panel you can see:
The UI IP is the IP address the UI is on.
The Hub IP is the IP address the hub is on.
To the right of the IP addresses is a box that you can input the IP address and ID of a hub if it does not auto-connect and connect to it manually.
Below the IP addresses the drop down lists all previously connected Hubs to allow you to switch between them.
The Reconnect button will try to reconnect to the hub selected in the drop down.
The ReSearch Hubs button will search the network for a Hub.
The Reboot Hub button sends a reboot command to the connected hub.
The Shutdown Hub button sends a shutdown command to the hub.
The Update Hub button sends an update command to the hub.
The reboot command should auto-reconnect to the UI.
The shutdown command will require you to press the power button on the Hub PC to start it.
To the middle of the panel there is a list of process names with an icon next to start and stop buttons. This is the list of process nodes on the hub and their status. If they are shut down a symbol will be next to it and if they are running a symbol will be next to them.
PreProcessor: Handles the processing of uploaded files.
Maincomm: Handles the coop logic for each print job. This node cannot be started manually as it is launched by the user hitting the “start print” button.
Interweaver: Takes the files from the Slicer Node and post-processes them into the final gcode files that will be sent to the printer.
Recovery: Handles the recovery of the hub in case of failure.
Slicer: Slices the files output from the PreProcessor.
Scanner: Scans the network for communications from the UI and connected printers.
Chuck Checker: Checks the output of the PreProcessor node for missing sections of the file.
Slicer Checker: Checks the output of the slicer node for missing sections of the file.
Interweaver Checker: Checks the output of the Interweaver node for missing sections of the file.
Printer Calibration: Handles the printer calibration functions.
At the bottom of the hub watcher panel are two buttons.
Start Hub Nodes: Sends a command to the hub to start all the nodes. (Note that the Maincomm will not start with this since it is only started with a print job.)
Kill Hub Nodes: Sends a command to the hub to kill all started hub nodes.
Gcode Sender
This panel allows you to select a connected printer to send individual gcode commands to it.
Slicer Settings
There are a set of buttons at the top of this panel.
Import slicer config to UI.
Note: To keep a compatible slicer configuration, please modify an exported slicer config instead of importing a completely new one.
Export slicer config from UI.
Save current config to UI.
Delete clears the config from the UI.
Get Config’s From HUB downloads the current configs on the Hub.
Send Config’s To HUB sends the config in the UI to the hub.
Note: The hub currently has just two save slots for slicer settings, one for printing with supports and one for without supports.
Printer Calibration
Gear Icon: Swaps card between Printer Calibration Card and Calibration Parameters Card.
Printer Calibration Card
Printer ID: ID number of printer being calibrated.
Point 1: Input the X | Y values of point 1 from the “XY calibration” tool in Duet UI here.
Point 2: Input the X | Y values of point 2 from the “XY calibration” tool in Duet UI here.
Point 3: Input the X | Y values of point 3 from the “XY calibration” tool in Duet UI here.
Point 4: Input the X | Y values of point 4 from the “XY calibration” tool in Duet UI here.
Calibration Parameters Card
Target Point 1: X | Y values of the target point on the bed for point 1.
Target Point 2: X | Y values of the target point on the bed for point 2.
Target Point 3: X | Y values of the target point on the bed for point 3.
Target Point 4: X | Y values of the target point on the bed for point 4.
Offset X: Offset all X values input in the Printer Calibration Card. (Useful for shifting the printer alignment to align printers with each other)
Offset Y: Offset all Y values input in the Printer Calibration Card. (Useful for shifting the printer alignment to align printers with each other)
Rotation Center X: X coordinate of the center of rotation for the Rotation Angle input below.
Rotation Center Y: Y coordinate of the center of rotation for the Rotation Angle input below.
Rotation Angle: degrees of rotation to apply to the points in the Printer Calibration Card about the rotation center point above (Useful to align printers to each other that are at an angle to each other)
End Effector: Selects the end effector the calibration is for. This changes where the calibration is applied, so select the tool you are calibrating to so the changes are applied correctly.
Lower Row of Buttons
Add Printer: Adds a printer calibration card to allow you to calibrate multiple printers at once.
Remove Printer: Removes a printer calibration card.
Calibrate: Submits calibration to the hub for processing and upload to printers.
Updater
Hub Updater
Trigger Hub Update: Checks if a new hub version is available and if so runs the hub update script. If an update is run, hub processes will be unavailable for a few minutes while the update is processed.
Printer Macro Update
Select Printers: Allows you to select which/how many of the connected printers will be updated.
Upload Macros & Update
Uploading custom macro files is an advanced feature that we are working to make more user friendly. Please do not experiment with this feature if you aren’t sure what you are doing.
Choose File: Allows you to upload a zip file of custom macro files to the printer.
Upload to Printers: Uploads custom macro files from above zip file to selected printers.
Update Printer Macros from Hub
Update Printers: Checks if the printers have an update and if so uses the hub to upload the needed files to the printers.
Printer List
The Printer List is a panel on the left of the UI that lists all the printers currently connected to the hub.
This panel allows you to see the status of each printer, what area of the environment they are assigned to, and gives you access to some basic functions for the individual printers.
Printer Assignment
This is a drop-down list that allows you to select which build area the printer is assigned to.
For a single printer print, this is just selecting which printer will print the model.
For a coop print, this is assigning the placement of the printers next to each other, and must reflect how the printers are physically set up.
Printer Settings
This is a page each printer has in the printer list and is accessed by clicking on the name of the printer.
This panel holds the following functions, listed top-down.
printer status
printer position
hotend temperature
bed temperature
setting hotend temp
setting bed temp
Home XY & Home all
My Print Jobs List
The My Print Jobs tab next to the my printers tab lists the currently uploaded print jobs.
Each print job has a card with information and controls.
Controls listed top to bottom, left to right:
Row 1:
Job name
Rename job : Lets you change the name of the job in the UI.
Delete job: Deletes job files from hub and UI.
Row 2:
Job status
Row 3:
groups of four numbers.
First two numbers in a group is the printer position.
Second two numbers in a group is the printer ID.
Example: 11 13 is the printer in position coordinate 1,1 and is occupied by bot 13.
Row 4:
Start: Starts new job / resumes paused job.
Pause: pauses running job.
Cancel: stops job, printers go back to idle.
Restart: Re-runs cancelled job from the beginning.
The print control buttons are green when you can click on them and grey when they are unavailable.
Workspace
The center section of the UI is the workspace.
To the left side of the workspace is a row of buttons. The functions of these buttons is detailed below.
The main area of the workspace is the 3D environment where you will set up print jobs.
Upload Model
Opens file browser to upload a STL model into the workspace.
Export Model
Exports the current workspace as an stl file.
Delete
Deletes the currently selected model.
Move
When a model is selected, this switches the model gizmo to move mode for dragging the model around with the mouse.
Rotate
When a model is selected, this switches the model gizmo to rotate mode for rotating the model with the mouse.
Scale
When a model is selected, this switches the model gizmo to scale mode for stretching the model in each axis.
Auto Scale
Scales the model to the largest size that fits on the bed.
This does not rotate the model, so it scales until one dimension of the bounding box is the maximum build volume in the current orientation of the model.
Auto Center
This button centers the model in the build volume in XY and places it on the bed in Z.
You may have to press autocenter twice for the model to be placed on the bed.
Model List
Lists the models loaded into the workspace.
Current model selected is highlighted in the model list and in the workspace.
You can select a different model by clicking on it’s name in the model list or by clicking on the model in the workspace.
The check boxes next to the model names allow you to hide them in the uploaded job without deleting them from the workspace.
Model Transform Table
This table allows you to see the position, rotation, scale, and size of the current model selected.
You can modify the model through this table as a more precise alternative to the model gizmos.
This bug may be fixed by the time you are reading this; however, there was a bug where deselecting all models and using the transform table would apply transformations to the workspace camera, offsetting/rotating the camera focal point from the build plate. If this happens and you are unable to revert it with the transform table, you can restart the UI to fix the camera.
Console
This shows the sequence of actions taken by the UI as well as responses from the hub and printers.
This is also where error messages will appear.
Connection Status Icons
There are two icons on the lower right of the UI.
The left icon is green when the UI is connected to the internet.
The right icon is green when the UI is connected to a hub.
UI Section Resizing
There are two ways to resize the panels in the UI.
Clicking the box in the corner puts the panel in full screen.
You can also click and drag the edges of the panels to resize them.
2- Print Process
Part 1: Loading a model
Click the “upload model” icon in the workspace.
Select the STL file for printing from your file browser.
Arrange the file how you want it to be printed using the model gizmos and/or the model transform table.
Make sure the model is on the bed by pressing the Autocenter button. If the model is not on the bed an error will be given.
Part 2: Assigning printers
Go to the printer in the “my printers” list that you want to print the model.
Click the location assign drop down and assign the printer to the build area.
Note: when doing a cooperative print the assignments for the printer locations must match the arrangement of the physical printers.