05 Mar 16:17

tg73

6c94a44

RatOS-v2.1.0 Latest

Latest

RatOS 2.1.0 Release Notes

This release marks the completion of RatOS 2.1.0 🎉

There are a few minor changes since 2.1.0-RC4, as detailed below.

Note: Due to the significant changes introduced in RatOS 2.1.0-RC4, upgrading from earlier versions requires a fresh installation of RatOS by flashing a new image to your SD card. It is not possible to upgrade an existing RatOS 2.1.0-RC3 installation to 2.1.0 (final) in-place.

Upgrading from RatOS 2.1.0-RC4

Machines that have already been upgraded to RatOS 2.1.0-RC4 can be updated to 2.1.0 (final) by updating the RatOS Core: Configurator & Configuration and RatOS Core: Theme packages in the Mainsail update manager (see here for more information). It is not necessary to flash a new SD card image. The 2.1.0 (final) SD card image is functionally-equivalent to the 2.1.0-RC4 SD card image, but with updated packages.

Upgrading from RatOS 2.1.0-RC3 and earlier versions of RatOS

If you're upgrading an existing machine from an earlier version of RatOS, follow the instructions here:
https://os.ratrig.com/docs/upgrading_rc3

New Installations

For new installations without any previous configuration, follow the instructions here:
https://os.ratrig.com/docs/installation

Rat Rig Guides

If you're building a Rat Rig printer, follow the commissioning guide for your printer here:
https://docs.ratrig.com/

What's Changed since RatOS 2.1.0-RC4

fix(printers): add rendering of chamber lighting, chamber air filters and filament sensors to several older printer model templates by @tg73 in Rat-OS/RatOS-configurator#114
fix(boards): fix Manta M8P V2 SPI pin definitions by @3dprintpt in Rat-OS/RatOS-configurator#115
feat(boards): add new supported accessories to wiring diagrams by @3dprintpt in Rat-OS/RatOS-configurator#116
chore(ci): add .coderabbit.yaml file, enable reviews by default for -development suffixed base branches by @tg73 in Rat-OS/RatOS-configurator#120
fix(ci): fix generation of compare URL in deployment commit message by @tg73 in Rat-OS/RatOS-configurator#121
fix(cli): ensure ratos development correctly identifies deployment branch names by @tg73 in Rat-OS/RatOS-configurator#122
feat(macros): new commands to make temporary on-the-fly changes to heatsoak configuration easier by @tg73 in Rat-OS/RatOS-configurator#126
refactor(heatsoaking): make command output more user-friendly by @tg73 in Rat-OS/RatOS-configurator#127
fix(config-gen): ensure that variable_beacon_adaptive_heat_soak has a defined default for all printers with beacon by @tg73 in Rat-OS/RatOS-configurator#128
feat(heatsoaking): improve heatsoaking helper macros with enhanced defaults and validation by @tg73 in Rat-OS/RatOS-configurator#129
fix(heatsoaking): improve usability of helper macros when used as Mainsail macro buttons by @tg73 in Rat-OS/RatOS-configurator#130

Helper commands for on-the-fly changes to heatsoak settings

Helper commands have been added to make it easier to change heatsoak settings on-the-fly, see the documentation for details.

Full Changelog: Rat-OS/RatOS-configurator@source/v2.1.0-RC4...source/v2.1.0

Contributors

tg73 and 3dprintpt

Assets 4

02 Feb 01:29

tg73

v2.1.0-RC4

3c0cbd6

RatOS-v2.1.0-RC4 Pre-release

Pre-release

RatOS 2.1.0-RC4 Release Notes

Overview

This release represents the first update to RatOS 2.1.0 since RC3 was release around a year ago, and is focussed on improvements to the Beacon workflow and first layer consistency, plus support for V-Core 4.1 printers and hardware. This is a substantial release (over 500 commits) with many quality-of-life improvements and performance enhancements.

Note: Due to the significant changes in RatOS 2.1.0-RC4, RC4 requires a fresh installation of RatOS by flashing a new image to your SD card. It is not possible to upgrade an existing RatOS 2.1.0-RC3 installation to RC4 in-place.

Upgrading

If you're upgrading an existing machine from an earlier version of RatOS, follow the instructions here:
https://os.ratrig.com/docs/upgrading_rc3

New Installations

For new installations without any previous configuration, follow the instructions here:
https://os.ratrig.com/docs/installation

Rat Rig Guides

If you're building a Rat Rig printer, follow the commissioning guide for your printer here:
https://docs.ratrig.com/

Major New Features

New Printers

V-Core 4.1 and V-Core 3.2H are now fully supported by the configurator, along with the O2s toolboard.

Configurator Enhancements

The setup wizard and generated configuration now support some new kinds of selectable hardware:

Filament sensors
Chamber filter fans
Chamber lighting
Toolhead Alignment Systems

Support has been added for the Orbiter Smart Filament Sensor (also the non-smart), Rat Rig Rat Pack filter and Dayspring LED strips. For IDEX machines, VAOC is now a selectable component, and the required configuraiton is fully handled by the configurator - no more cut and paste into printer.cfg.

Beacon True Zero Correction

RatOS 2.1.0-RC4 extends the beacon contact BEACON_AUTO_CALIBRATE command with a true zero correction feature. This feature is also known as multipoint probing or multipoint true zero.

Following an extensive investigation, we found that while contact measurements at the same location are very repeatable, measuring neigbouring points (on a 1mm grid) can yield a result that in some cases differs by up to 100 microns (0.1mm). When used for true zero, this close proximity positional variablilty of contact readings is enough to have a significant impact on first layer consistency: a small difference in build sheet position or toolhead homing can lead to an effectively arbitrary true zero difference that is approaching 50% of a 0.2mm first layer.

Based on analysis of thousands of test data points, we determined that by applying a particular statistical method to six additional single-dive probes of randomly-positioned points in close proximity to the nominal true zero position, we could determine a correction value that significantly reduces the range of variability, with no negative impact for inherently low-variability build sheets. Also of note was the observation that the variabilty has some correlation to surface roughness, with textured surfaces generally showing more variability than smooth surfaces. Further, we saw the greatest variation on brand new textured PEI build sheets, and that variability appears to reduce over time as the sheet gets more use.

Beacon Scan/Contact Compensation

While this feature was present in RatOS 2.1.0-RC3, it has been completely redesigned in RC4.

As an infrequent calibration step, a compensation mesh is created. This mesh compensates for the positional variance in the difference between a beacon proximity reading and a nozzle contact reading a the same point. The compensation mesh is then applied to a beacon rapid scan performed just before the print starts. The variance compensated across the build sheet is typically around 80-120 microns (0.08 - 0.12 mm), although it can be significantly higher depending on factors such as gantry twist or uneven coating of the PEI build sheet.

The new approach, so called "co-temporal meshing", creates compensation meshes using a custom probing sequence that takes contact and proximity readings concurrently, while minimising the toolhead travel path. The time between performing the contact and proximity reading for a given location is kept to within a few seconds. This ensures that thermal changes that occur while while the mesh is being created do not influence the final result. Statistical methods refined from extensive research and development target the specific characteristics of the beacon probe to reduce noise and increase confidence and accuracy. The methods used allow a higher-resolution grid to be probed, but with only one contact dive per location instead of the usual three, increasing resolution significantly with only a modest increase in scanning time.

So-called "faulty regions" are supported, which allows the use of beds featuring discrete strong magnets.

Beacon Probe Cleaning Routine

Before taking a beacon true zero reading just before printing starts, the nozzle is cleaned using a sequence of contact probes with additional stamping moves. This replaces the wipe-before-true-zero in RC3, which in extensive testing was found to be ineffective. The aim of the new routine is to displace filament residue away from under the tip of the nozzle, increasing the reliability of the subequent true zero contact measurement. Note that this cleaning routine is not intended as a replacement for proper nozzle hygiene or a full off-bed nozzle wiping solution. Instead, it's a final line of defence to reduce the variability caused by last-minute ooze just before critical probing.

Beacon Adaptive Heat Soak

Adaptive heatsoaking uses beacon proximity measurements to dynamically assess the printer's dimensional stability and determine when it is appropriate to start printing. The soak duration is controlled by the duration of the first layer of the print, and the user's choice of "quality". Quality expresses the trade-off between soak time and first/early layer accuracy - much like slicer profiles trade speed against quality. The algorithm automatically adapts to different gantry constructions and sizes, bed temperatures and starting from cold or warm.

Assets 6

28 Jul 19:00

github-actions

v2.1.0-RC2

f57054c

RatOS-v2.1.0-RC2 Pre-release

Pre-release

Documentation is being finalized, 2.1.0 will be released as release candidates (pre-releases) until it's done.

Update all packages after connecting RatOS to your wifi network. Follow the installation instructions, and pay close attention to the update process.

Changes from RC1

Tons of bugfixes for boards, drivers non-standard sense resistors and general functionality
Realtime Analysis Tool now does input shaper calibration, belt tension peak detection and mechanical health estimation on macro recordings. It also shows you g-code response output while running macro's. Performance have been significantly improved, video memory requirements are significantly lower and should allow longer macro recordings on lower end graphics hardware.
Full one macro beacon contact auto calibration including scan compensation using BEACON_RATOS_CALIBRATE
More boards added.
Improved diff dialog and file change handling in wizard.

If you like the project and want to see it continue, consider becoming a Github sponsor, any amount counts!

Expanding the configurator - Klipper configuration generator.

RatOS now simplifies the klipper configuration process by automatically generating and updating the RatOS.cfg file based on your selections in the configurator. This file becomes the sole inclusion in printer.cfg, eliminating the need for managing multiple includes or modifying lines of code. RatOS intelligently recognizes your hardware and adjusts the configuration and macros accordingly.

Should you make any changes to your hardware, RatOS will simply update RatOS.cfg and display the changes for your review. This ensures that your have more confidence in tinkering, and can try out new things quickly without worrying about configuration.

Features

Point and click klipper config generation
The wizard will now ask you about your hardware configuration
- Select from 12 printers and 32 control boards
- Configure toolhead hardware (up to 2 toolheads per printer)
- Support for multiple instances of 12 supported toolboards.
- Printer configuration
- Motor / driver configuration
  - Reconfigurable motor slot allocations, you decide which slot is used for which axis.
  - Supports 24V, 36V, 48V, 56V, and 60V setups
  - Supports a variety of 2130, 2209, 2240, 2160 and 5160 drivers.
  - Supports a variety of stepper motors, including a "generic" stepper using klipper defaults.
  - Current adjustment
  - Automatically applied tuning presets for known configurations.
RatOS.cfg does not use pin aliases, the pins match the board's pinout diagram.

Expanding the configurator - beyond the wizard

RatOS 2.1 has evolved into a comprehensive application that interfaces with Klipper and Moonraker. It is set to expand its capabilities with various tools aimed at enhancing interactive analysis and calibration. The initial offerings will include VAOC (Visually Assisted Offset Calibration) and RAT (Realtime Analysis Tool), promising to elevate the user experience further.

Realtime Analysis Tool (RAT)

Power spectral density graphs, live, real-time, in your browser!

Create your own macros for analysing different aspects of your printer.
Hunt down sources of mechanical issues using the Oscillator by monitoring the realtime PSD while touching different parts of your motion system.
Works on phones, use it like a Star Trek Tricorder.
Supplies two new g-code commands, OSCILLATE and GENERATE_RESONANCES.

IDEX Support

Helge Keck's outstanding contributions to RatOS 2.1 have made all RatOS macros fully IDEX compatible, offering numerous advantages compared to other implementations.

Toolshift

RatOS features an integrated gcode postprocessor compatible with PrusaSlicer, OrcaSlicer, and SuperSlicer. It leverages the rapid toolshift macros for synchronous toolhead swapping and advancing to the subsequent print position in just two swift actions. This results in almost instantaneous tool changes, drastically cutting down on the time typically required for purge towers, and may even render them unnecessary. Additionally, Toolshift is customizable to execute a hotend purge during a tool change if the upcoming toolhead has been inactive past a predefined duration.

Intelligent priming / purging
Single toolhead + spool join mode
Multi color mode
Copy/Mirror mode
Experimental auto centering of print on the build plate for copy and mirror mode
Toolhead remapping
IDEX aware SET_PRESSURE_ADVANCE with toolhead syncing capabilities
Automatic toolhead deactivation after last use in print.
Fan synchronization
Optional automatic toolhead standby
Retraction control
Fully automated z-offset calibration before printing
Live speed and acceleration control while printing

Visually Assisted Offset Calibration (VAOC)

RatOS features a Visually Assisted Offset Calibration interface, complete with z offset probe support, making toolhead offset calibration a breeze, blazing fast and extremely precise.

Single Toolhead Hybrid CoreXY support

RatOS is equipped with specialized Hybrid CoreXY kinematics, which include the capability to operate two additional Cartesian motors on the Y-axis. This feature significantly enhances performance scaling in CoreXY configurations. By carefully tensioning the belts, users can achieve more than a twofold increase in the recommended shaper accelerations for the Y-axis.

Macros: new built-in features

Beacon contact auto calibration
Automatic hotend/nozzle thermal expansion calibration (Beacon Contact or Z offset probe)
Primeblob is now significantly faster, takes less space and adapts to nozzle size.
Sensorless homing supported for all driver types.
Toolhead temperature offsets.
LED Status effects
Filament sensor support (on-toolhead, off-toolhead or both)
* Up to 3 sensor in series: on-toolhead switch sensor, on-toolhead motion sensor, off-toolhead bowden switch sensor
* Insert, runout and clog detection
- Automatic loading / unloading with on-toolhead sensor
- Automatic print resume on insert
- Optional purge before unload or after load
- Sanity checks before print starts, checks for filament presence
- Filament grabbing on insert even if the hotend is cold
- Filament status color in Mainsail
Hotend type and nozzle aware tip forming when unloading
New calibratron macros, PID tuning and pa tower.
Tons of user adjustable macro variables for customization and further tuning.
Many small usability improvements and sanity checks.

Adaptive Meshing and Priming

Adaptive meshing and priming is now officially out of beta and enabled by default. Beacon adaptive priming and full IDEX support has been added.

New boards

BTT Kraken
BTT Manta M8P V2.0
BTT Manta M5P
BTT EBB SB2240 STM32
BTT EBB SB2240 RP2040
BTT EBB SB2209 STM32
BTT EBB SB2209 RP2040
BTT SKR v1.4
BTT SKR v1.4 Turbo
Fysetc Spider v2.2
LDO Leviathan v1.2

Minor changes and improvements

Primeline has been removed.
Use ENABLE_DEBUG to log additional information, download all debug information by using the debug zip link in the RatOS Configurator.
User hooks are now supplied with the full params of the calling macro
ratos CLI tool for utility functions, advanced usage and third party integrations. Use it to regenerate configuration, flash connected boards, tail logs, register / unregister / symlink klippy and moonraker extensions and more.

Backwards compatibility

RatOS 2.0 configurations will still work in 2.1 (As for RC2 this is unknown.. will need testing)
Generating a new configuration will require that you reflash your toolboard via the configurator.