V-Core 4.0 - IDEX

Configuration

00. Prepare RatOs

1. Download the RatOS on the button below or from GitHub (look for the RatOS-*.img.xz file under the Assets dropdown).
2. Use a tool like SDcard Formatter to prepare the SD card before flashing.
3. Write the image to a 16GB or larger SD card using Balena Etcher.

Download RatOS

01. Network connectivity

  • Insert the flashed SD card into the Raspberry Pi and power on the machine.
  • Wait for the RatOS hotspot to appear on your control device (computer, tablet, or smartphone). This may take a few minutes, as the Raspberry Pi is flashing the new firmware.
    2.1. If the RatOS hotspot asks for a password, it is: "raspberry"
  • Connect to the hotspot and access the machine via a web browser at ratos.local.
  • On the dashboard, there will be an error, ignore it. It's only klipper complaining that there is no configuration.
  • Open the Configurator (1) from the left-side menu and click on Setup Wizard (2).
  • Select your Wi-Fi network (3), enter the password (4), and click "Submit" (5).
    6.1. If your Wi-Fi is not showing, click “Show Hidden Access Points” or simply reboot the machine.
  • Choose your printer hostname (6), then click "Save and Connect" (7).

Some browsers may not have localhost domains acces enabled, if you have trouble connecting to "ratos.local", ensure your browser allows connection to a localhost domain.

02. Updates

Warning!
Follow the steps carefully! Any mistake could damage the configuration and require re-flashing the Raspberry Pi.
  • The machine will reboot after the Wi-Fi setup.
  • Connect your control device (computer, tablet, or smartphone) to the same Wi-Fi network as your V-Core 4.
  • Enter the hostname (e.g., myvc4.local) in your web browser.
  • Navigate to 'Machine' (8) in the left-side menu.
  • Locate the update window and refresh it (9); options may take some time to appear.
  • Update RatOS packages by clicking the Update button (10) to prepare for third-party software changes. Wait for the machine to reboot, meaning the instalation was successful. Refresh the webpage (press F5)
  • Update the 'RatOS-Configurator' packages (11). Wait for the machine to reboot, meaning the instalation was successful. Refresh the webpage (press F5)
  • Click 'Update All Components' (12) at the bottom of the updater panel. Wait for the machine to reboot, meaning the instalation was successful. Refresh the webpage (press F5)

If any of the packages appear "invalid" just refresh the browser page, it may be loading.

03. initial configuration

This chapter covers the VAOC configuration and the initial steps for setting up and operating the IDEX machine. We are working on automating this process.

Note!
If you are upgrading from a hybrid machine, pre-configured, disable performance mode in the RatOS configurator.
  • Open the configurator (1) from the left-side menu.
  • Go to the Setup Wizard (2).
  • In the Printer Selection menu (3), choose the IDEX (4) variant that matches your machine's size.

Follow the rest of the configurator to choose and flash your controller and toolboard, as well as select the appropriate hardware. During the configurator process, the standard V-Core 4.0 components are pre-selected. Unless your machine is not a standard kit, you should not need to change any parameters.

04. Configure the Z Endstop & VAOC LED

Navigate to machine tab (1) and click on the printer.cfg (2) file and scroll to the bottom. This is where you should insert any custom modifications.

At this point, add the Z-endstop and VAOC LED configurations. We are working on automating this step in the near future, similar to the rest of the RatOS configurator.

  • Copy and paste the code lines below into the printer.cfg file. Be sure to place them at the end of the file, but before the SAVE_CONFIG section.
    Warning!
    Any modifications made below this line will be overwritten, which could result in an incorrect configuration.
    [z_offset_probe]
    pin: ^PG10                   # probe trigger pin
    z_offset: -7                 # probe height, used to limit the probe z-move
    y_offset: 0                  # probe y-offset, measured from the camera centre
    x_offset: 37.5               # probe x-offset, measured from the camera centre
    speed: 10                    # probe speed  
    samples: 3                   # number of samples  
    sample_retract_dist: 5
    lift_speed: 10.0
    samples_result: median
    samples_tolerance: 0.2
    samples_tolerance_retries: 5
    
    [neopixel vaoc_led]
    pin: PB0
    chain_count: 6
    color_order: GRB
    
    [heater_fan vaoc_fan]
    pin: PD13
    heater: heater_bed
    fan_speed: 1.0
    heater_temp: 50

    Copy

  • Click the "SAVE & RESTART" button on the top right of the window. The machine will then restart with the new parameters applied.

05. Configure the VAOC camera

  • Next, navigate to the Machine tab (1) and open the Crowsnest configuration file crowsnest.cfg (2) by clicking on the filename.

  • Inside the crowsnest.conf file (3) locathe the [crowsnest] and [cam1] sections (4).

  • Replace the [crowsnext] section and the [cam 1] section with the code below:

    [crowsnest]
    log_path: /home/pi/printer_data/logs/crowsnest.log
    log_level: verbose
    delete_log: false
    no_proxy: false
    
    [cam 1]
    mode: camera-streamer
    enable_rtsp: false
    rtsp_port: 8554
    port: 8080
    device: /dev/video0
    resolution: 1920x1080
    max_fps: 30   

    Copy

  • Click the "SAVE & RESTART" button on the top right of the window. The machine will then restart with the new parameters applied.

  • Open the VAOC tab on the left menu to check if there is image.

HELP. VAOC interface shows no image.