===== Openbuilds Acro workflow =====

==== Prepare your drawing ====
  * Check the dimensions of your document in the vector drawing program (Inkscape or Illustrator)
    * **max width: 82cm** (820mm)
    * **max height: 125cm** (1250mm)
  * [[prepare_your_drawing:prepare_your_drawing|Prepare your drawing]] and export as SVG.
  * Optimize for plotter (Axidraw plotter extension tool, or do it manually by grouping sections of the drawing in layers)
  * In Inkscape: Object > Object to path. The path icon should be visible instead of a circle

==== Turn on the Pen Plotter ====


|< 100% 300px >|
^       ^        ^
|{{:openbuilds_acro:acro_controller_usb_02.jpg?300|}}| Connect the USB cable from the controller to the computer.|
|{{:openbuilds_acro:acro_power_02.jpg?300|}}|Plug in the power supply for the controller.|
|{{:openbuilds_acro:acro_controller_power_02.jpg?300|}}|Turn on the controller.|
|{{:openbuilds_acro:acro_openbuilds_logo_01.png|}}|On the computer, open the 'OpenBuilds CONTROL' application.|
|{{:openbuilds_acro:acro_serial_connection_01.png?300|}}|**Open the serial connection**: select a USB to serial port and click connect. Look at the serial console to see if the connection worked or not. You'll see connect Firmware Detected if the connection was successful. Try another one if it fails to connect. If the menu doesn't list any good ports, close any applications that might have a serial connection. If that didn't work, restart the Openbuilds controller application or restart the computer.|
|{{:openbuilds_acro:acro_unlock_alarm_01.png|}}|The unlock alarm flickers. Click on it do disable the safety lock.|
|{{:openbuilds_acro:acro_pen_up_01.png|}}|Click on 'Pen Up'|
|{{:openbuilds_acro:acro_home_all_01.png|}}|Click on 'Home All' (This will move the head to the left front corner to calibrate its origin point).|

The machine is now safe and ready to use.

==== Calibrate the servo ====


|< 100% 300px >|
^       ^        ^
|{{:openbuilds_acro:acro_calibrate_servo_02.png|}}|Open 'OpenBuilds CONTROL' and click 'Wizards & Tools'. Select 'Calibrate Servo Pen Up/Down'.|
|{{:openbuilds_acro:acro_pen_02.jpg|}}|Install the pen in the holder.|
|{{:openbuilds_acro:acro_calibrate_servo_up_01.png|}}|**Pen up**: drag the slider carefully. Try to have the tip of the pen hover just high enough over the paper. Write down the value and click continue.|
|{{:openbuilds_acro:acro_calibrate_servo_down_01.png|}}|**Pen down**: drag the slider carefully. The pen should rest on the page now. Look from the side and make sure the servo horn is not touching the pen holder anymore, but you'd also want it to stay close by as you want to minimize servo movements. Write down the value and click continue. Then click Save & Apply|



==== Place the paper and define work area ====

|< 100% 300px >|
^       ^        ^
|<wrap hi>image needed</wrap>|Place the paper on the bed of the pen plotter.|
|{{:openbuilds_acro:acro_tape.jpg|}}|<WRAP>
  * Use easily removable tape (like Tesa light-blue or Tesa yellow) to fix the page to the bed. 
    * <wrap lo>Only a few short sections of tape are necessary.</wrap> 
    * <wrap lo>Try to keep the page reasonably flat.</wrap> 
</WRAP>|
|{{:prepare_your_drawing:workspace_origin.png|}}|<WRAP>
  * With OpenBuilds CONTROL, move the pen to the **left bottom corner** of the page.
  * <wrap lo>Use the arrows on screen, or the ones on your keyboard</wrap>
</WRAP>|
|{{:openbuilds_acro:acro_setzero_02.png|}}|Click ''setzero''|

  * Click Pen Up.
  * Move the pen to the **top right** corner of the page.
  * Write down the values at 'X' <wrap lo>(Width of the page)</wrap> and 'Y' <wrap lo>(height of the page)</wrap>.
  * Open a new document in Inkscape and give:
    * For the width: use the value of 'X'.
    * For the height: use the value of 'Y'. 
  * Import the SVG drawing into this document and position it how you like.
  * Export this as an SVG file. <wrap lo>This will be the file you'll be plotting.</wrap>

==== Generate Gcode ====

|< 100% 300px >|
^       ^        ^
|{{:openbuilds_acro:acro_svg2gcode.png|}}|Go to [[https://sameer.github.io/svg2gcode|svg2gcode]]|
|{{:openbuilds_acro:acro_svg2gcode_settings_02.png|}}|<WRAP>
  * **Load the plotter settings**
    * Download this {{ :openbuilds_acro:2024-01-29-svg2gcode-settings.json.zip |settings-file}}
    * On the svg2gcode-website, click 'Settings', then 'Import/Export'. Select the file you just downloaded and click Save
</WRAP>|
|{{:openbuilds_acro:acro_svg2gcode_pendown_01.jpg|}}|<WRAP>
  * **Enter the new servo positions**:
  * Click 'Settings again'
  * At the '**Tool On** Sequence' (pen down) section, change the number behind the M3S value to the one you wrote down for **Pen Down**
    * * For example: M3S166
</WRAP>|
|{{:openbuilds_acro:acro_svg2gcode_penup_01.jpg|}}|<WRAP>
    * At the '**Tool Off** Sequence' (pen up) section, change the number behind the M3S value to the one you wrote down for **Pen UP**
     * For example: M3S180
    * Click Save
</WRAP>|
|{{:openbuilds_acro:acro_svg_file_01.png|}}|Select a vector file (SVG)|
|{{:openbuilds_acro:acro_generate_gcode_01.png|}}|Click 'Generate Gcode'. The website downloads the gcode file to your computer.|



==== Load the Gcode ====

|< 100% 300px >|
^      ^      ^
|{{:openbuilds_acro:acro_open_file_02.png|}}|In Openbuilds CONTROL, click 'Open Gcode'.|
|{{:openbuilds_acro:acro_gcode_file_01.png|}}|Select the Gcode file that was downloaded by the svg2gcode website.|
|<wrap hi>image needed</wrap>|Click on the Gcode editor-tab and scroll all the way down and remove the line containing 'M2'. This gcode command results in a glitch that puts the pen back on the paper after the whole plot has finished. It's better that the pen stays up after plotting. No need to save the gcode file. The changes are already active.|
|<wrap hi>image needed</wrap>|Click again on the '3D-view' tab and double check the dimensions on the X and Y axis. <wrap lo>Pan with CTRL pressed to pan the view around and use the scroll wheel to zoom.</wrap>|

==== Start the plot ====

|< 100% 300px >|
^    ^    ^
|<wrap hi>Image needed</wrap>|Make sure the pen is in the **UP**-position| 
|{{:openbuilds_acro:acro_run_pause_abort_02.png|}}|<WRAP>
  * Click 'Run Job' (or space bar) to start plotting.
  * Click 'Pause Job' (or space bar) to pause.
  * Click 'Abort' (or escape) to stop plotting.
</WRAP>|

<wrap lo>After the plot, close the Openbuilds Control software, turn off the driver and unplug the power.</wrap>