# =============================================================================
# =============================================================================
# Pandaplacer Nozzle Station Setup Helper - V1.0
# 20241012 - by LeoYu
# This tool is used to set the automatic Tool Changer Locations of the nozzle tips in OpenPnP2.
# This tool applies to PP-3DP-CN_Nozzle_Station V2.0/V2.1 and Pandaplacer-A1.
# CN_Nozzle_Station_Assist_Plate-V2.0 is required for TCAM visual assist.
# Make sure you have completed the initial machine calibration before use.
#
# Usage:
# 1. Print and install the PP-3DP-CN_Nozzle_Station (V2.1/V2.0) into the default 
#    mounting positions on the front of the PP-A1 frame
#    (currently only supported with the default design mounting orientation).
# 2. Install the printed PP-3DP-CN_Nozzle_Station_Assist_Plate-V2.0 on the Station.
# 3. In OpenPnP. manually add the Nozzle Tip. the default rule name must be used:
#    For Left station: "CN040", "CN065", "CN140", "CN220", "CN400", "CN750";
#    For Right station: "CN040_R", "CN065_R", "CN140_R", "CN220_R", "CN400_R", "CN750_R";
#    Or you can change in this code.
# 4. Please use the tips in the default order from smallest to largest on each station.
# 5. In OpenPnP, manually control the machine to obtain the Frist Location of the 
#    tip corresponding to each station slot separately. Specifically, align the center 
#    of the TCAM camera to the crosshairs of the distal end, and click the Camera 
#    Capture button to obtain the corresponding coordinates, then click Apply. 
#    *SKIP CN075/CN075_R slot as TCAM cannot reach the corresponding position.
#    For each tip, just get the First Location. 
# 6. Attach any tip to any nozzle, manually control it so that the tip end is in contact
#    with the 2nd step surface of the Station, and record the Z value (Station Z Value).
# 7. Run this tool.
# 8. Select the OpenPnP2 machine.xml file. It is recommended to backup the source file 
#    first by clicking the "Backup" button.
#    Checking “Overwrite” will overwrite the source file.
# 9. Select the "Station Direction", by default it is "Left".
# 10.Enter the "Station Z Value" you got in step 6.
# 11.Adjust "Tip-Station Z offset" when needed, which relates to the amount of compression.
#    Other parameters remain default.
# 12.Click the "Convert" button and all the changes will be done automatically.
#  
# =============================================================================
# =============================================================================


License: CC BY-NC-SA 4.0

pandaplacer.com