duet_vcore3/README.md

# Vcore3 500^3
## Purpose
Configure and document a [Vcore3 from RatRig](https://www.ratrig.com/3d-printing-cnc/3d-printer-kits/all-3d-printer-kits/v-core3configurable.html) with a Duet 3 6HC.
The purpose of this repo is not to have a 1 fit all solution but the solution that works for my use case, I've tryed to provide all the hardware components and their setup, this may not suit your case. If you have a suggestion please consider opening a pull request. 
In the other hand it may help you setup your printer in a fast way, use at your own risk.
Parts of the g code are not mine and were extracted from the ratrig config, duet github repos, and other sources (references on the links and external sources bellow).

Pay special attention to the stepper direction and stepper step/angle, these are not standard.

## HW Config
#####
- 1x [Duet 3 6HC](https://www.123-3d.nl/Duet3D-Duet-3-Mainboard-6HC-v1-0-origineel-Duet-3-MB6HC-v1-00-i4602.html)
##### Display
- 1x [Duet panel Due](https://www.123-3d.nl/Duet3D-PanelDue-met-7-v1-0-display-kabel-PanelDue-7i-v1-0-i3018-t14808.html)
##### SBC
- 1x [PI 4 2GB](https://www.123-3d.nl/RaspberryPi-Raspberry-Pi-4-model-B-2-GB-i4908-t16066.html)

##### Power supply
- 1x Mean well 400W 24v ([RSP-500-24](https://eu.mouser.com/ProductDetail/MEAN-WELL/RSP-500-24?qs=8uyp%2Fy7yFW5FrdkZCZycgg==))

##### Steppers
- 3x z [0.9 nema 17](https://www.123-3d.nl/123-3D-NEMA17-stappenmotor-0-9-graden-per-stap-48-mm-lang-4-2-kg-cm-SL42S248MA108-0524-i3420-t14804.html) 
- 1x x 0.9 nema 17
- 1x y 0.9 nema 17
- 1x extruder [0.9 nema 17 pancake](https://www.ratrig.com/nema-17-stepper-motor-slimline.html)

##### Carriage
- 1x [Eva 2.0](https://main.eva-3d.page/)

##### HotEnd
- 1x [E3D V6](https://www.123-3d.nl/E3D-v6-hotend-complete-kit-1-75-mm-24V-thermistor-cartridge-origineel-i2184-t13151.html)
- 1x [Bondtech BMG Extruder](https://www.123-3d.nl/Bondtech-BMG-Extruder-EXT-BMG-i3776-t15696.html)
##### Lighting
- 1x [SSR 40A DC-DC](https://www.la3d.ch/e-shop/relais-ssr-creality-3d-cr-10s-pro/))
- 2x [Led strips 24v 50cm](https://www.amazon.nl/gp/product/B07N1GDJV1/ref=ppx_yo_dt_b_asin_title_o03_s00?ie=UTF8&psc=1)

Note: The usage of the SSR allows more lighting to be added without worries for curruent usage on the board.
 
##### Fans
- 1x [STD ratrig layer fan 24v](https://www.ratrig.com/fan-50mm-blower-type-24v-dc.html)
- 1x [STD ratrig tool fan 24v](https://www.ratrig.com/3d-printing-cnc/3d-printer-kits/accessories/fan-40mm-brushless-24v-dc.html)

##### Bed calibration tool
- 1x [Bltouch 3.1](https://www.123-3d.nl/Antclabs-BLTouch-Auto-Bed-Leveling-Sensor-v3-1-BLTOUCH-i3640-t16885.html)

##### Endstops
- 2x [Ratrig std end stops](https://www.ratrig.com)

##### Bed heater
- 1x [C-Lin SSR](https://www.ratrig.com/hardware2/electronics/clin-ssr-40a-relay.html)
- 1x [Keenovo heating element](https://www.ratrig.com/hardware2/electronics/heater-bed-pad-keenovo-500-x-500mm-220v-1600w.html)

##### Filament sensor
1x [Duet 3d - laser sensor](https://www.123-3d.nl/Duet3D-Laser-Filament-Monitor-LaserFilamentMonitor-i3121-t14808.html)

### Software
#### Base intall
[Duet light](https://pkg.duet3d.com/DuetPi-lite.zip) - Config [link](https://duet3d.dozuki.com/Wiki/SBC_Setup_for_Duet_3)
#### Git config && software deployment
```
apt-get update && apt-get upgrade && apt-get install git
mv /opt/dsf/sd/sys /opt/dsf/sd/sys.ori
mv /opt/dsf/sd/macros /opt/dsf/sd/macros.ori
cd /opt ; git clone https://g.lgeex.com/3dprinting/duet_vcore3.git
chown -R dsf:dsf /opt/duet_vcore3
chmod -R g+s /opt/duet_vcore3 
setfacl -R -d -m u::rwx /opt/duet_vcore3
ln -s /opt/duet_vcore3 /opt/dsf/sd/sys
ln -s /opt/duet_vcore3/macros /opt/dsf/sd/macros
ls -s /opt/duet_vcore3 /root/ # yes I use root on the rasp.
```

### Duet 3 6HC - Pins

#### IO
Used IO pin headers
* io_0 - display
* io_1 - y endstop
* io_2 - x endstop
* io_7 - bltouch

#### Stepper motors
All steppers are 0.9º

* z left - driver2 - motion backwards (looking from the back of the printer)
* z rear - driver1 - motion backwards
* z right - driver1 - motion backwards
* top right motor - driver3 - Y - motion forwards (looking from the back of the printer)
* top left motor - driver4 - X  - motion forwards 
* extruder motor - driver5  - motion forwards

#### Outputs
##### Heating elements (24v)
Heating elements in use:
* out1 - SSR Bed
* out2 - Hotend
##### Fans (24v)
Fans in use:
* out4 - layer fan
* out7 - hotend fan
##### Lighting
* out8 - dc ssr operated leds

#### Temperature probes
Thermal probes in use:
* temp0 - Bed thermistor
* temp1 - Hotend thermistor

## TODO
- Setup filament sensor

- All macros are untested until stated otherwise, list of tested macros: 
- - Lighting (all)
- - Preheat (all)
- - PID tuning Bed && HotEnd

## Electronics backplate
I've also set a exectronics backplate (to be a cut of alluminium or polycarbonate up to 4mm), you may find it in [thingiverse.com](https://www.thingiverse.com/thing:4792093).

## Links and external sources
* [GCode library](https://duet3d.dozuki.com/Wiki/Gcode)
* [RatRig vcore3 docs](https://ratrig.dozuki.com/c/Rat_Rig_V-Core_3)
* [Duet Macros repo](https://github.com/Duet3D/GcodeMacros)
Update READM.md 2021-06-05 19:59:12 +00:00			`# Vcore3 500^3`
Update readme with intro section 2021-06-05 21:37:00 +00:00			`## Purpose`
			`Configure and document a [Vcore3 from RatRig](https://www.ratrig.com/3d-printing-cnc/3d-printer-kits/all-3d-printer-kits/v-core3configurable.html) with a Duet 3 6HC.`
			`The purpose of this repo is not to have a 1 fit all solution but the solution that works for my use case, I've tryed to provide all the hardware components and their setup, this may not suit your case. If you have a suggestion please consider opening a pull request.`
			`In the other hand it may help you setup your printer in a fast way, use at your own risk.`
Update readme, add info regarding backplate and hw links 2021-06-05 22:39:21 +00:00			`Parts of the g code are not mine and were extracted from the ratrig config, duet github repos, and other sources (references on the links and external sources bellow).`

			`Pay special attention to the stepper direction and stepper step/angle, these are not standard.`
Add README.md 2021-05-28 23:14:44 +00:00
			`## HW Config`
Update READM.md 2021-06-05 19:59:12 +00:00			`#####`
			`- 1x [Duet 3 6HC](https://www.123-3d.nl/Duet3D-Duet-3-Mainboard-6HC-v1-0-origineel-Duet-3-MB6HC-v1-00-i4602.html)`
			`##### Display`
			`- 1x [Duet panel Due](https://www.123-3d.nl/Duet3D-PanelDue-met-7-v1-0-display-kabel-PanelDue-7i-v1-0-i3018-t14808.html)`
			`##### SBC`
			`- 1x [PI 4 2GB](https://www.123-3d.nl/RaspberryPi-Raspberry-Pi-4-model-B-2-GB-i4908-t16066.html)`
Add README.md 2021-05-28 23:14:44 +00:00
Update READM.md 2021-06-05 19:59:12 +00:00			`##### Power supply`
Update readme, add info regarding backplate and hw links 2021-06-05 22:39:21 +00:00			`- 1x Mean well 400W 24v ([RSP-500-24](https://eu.mouser.com/ProductDetail/MEAN-WELL/RSP-500-24?qs=8uyp%2Fy7yFW5FrdkZCZycgg==))`
Update READM.md 2021-06-05 19:59:12 +00:00
			`##### Steppers`
			`- 3x z [0.9 nema 17](https://www.123-3d.nl/123-3D-NEMA17-stappenmotor-0-9-graden-per-stap-48-mm-lang-4-2-kg-cm-SL42S248MA108-0524-i3420-t14804.html)`
			`- 1x x 0.9 nema 17`
			`- 1x y 0.9 nema 17`
			`- 1x extruder [0.9 nema 17 pancake](https://www.ratrig.com/nema-17-stepper-motor-slimline.html)`

			`##### Carriage`
			`- 1x [Eva 2.0](https://main.eva-3d.page/)`

			`##### HotEnd`
			`- 1x [E3D V6](https://www.123-3d.nl/E3D-v6-hotend-complete-kit-1-75-mm-24V-thermistor-cartridge-origineel-i2184-t13151.html)`
			`- 1x [Bondtech BMG Extruder](https://www.123-3d.nl/Bondtech-BMG-Extruder-EXT-BMG-i3776-t15696.html)`
			`##### Lighting`
			`- 1x [SSR 40A DC-DC](https://www.la3d.ch/e-shop/relais-ssr-creality-3d-cr-10s-pro/))`
Update readme, add info regarding backplate and hw links 2021-06-05 22:39:21 +00:00			`- 2x [Led strips 24v 50cm](https://www.amazon.nl/gp/product/B07N1GDJV1/ref=ppx_yo_dt_b_asin_title_o03_s00?ie=UTF8&psc=1)`
Update READM.md 2021-06-05 19:59:12 +00:00
			`Note: The usage of the SSR allows more lighting to be added without worries for curruent usage on the board.`

			`##### Fans`
			`- 1x [STD ratrig layer fan 24v](https://www.ratrig.com/fan-50mm-blower-type-24v-dc.html)`
			`- 1x [STD ratrig tool fan 24v](https://www.ratrig.com/3d-printing-cnc/3d-printer-kits/accessories/fan-40mm-brushless-24v-dc.html)`

			`##### Bed calibration tool`
			`- 1x [Bltouch 3.1](https://www.123-3d.nl/Antclabs-BLTouch-Auto-Bed-Leveling-Sensor-v3-1-BLTOUCH-i3640-t16885.html)`

			`##### Endstops`
			`- 2x [Ratrig std end stops](https://www.ratrig.com)`

Update readme, add info regarding backplate and hw links 2021-06-05 22:39:21 +00:00			`##### Bed heater`
Update READM.md 2021-06-05 19:59:12 +00:00			`- 1x [C-Lin SSR](https://www.ratrig.com/hardware2/electronics/clin-ssr-40a-relay.html)`
			`- 1x [Keenovo heating element](https://www.ratrig.com/hardware2/electronics/heater-bed-pad-keenovo-500-x-500mm-220v-1600w.html)`

			`##### Filament sensor`
			`1x [Duet 3d - laser sensor](https://www.123-3d.nl/Duet3D-Laser-Filament-Monitor-LaserFilamentMonitor-i3121-t14808.html)`

			`### Software`
			`#### Base intall`
			`[Duet light](https://pkg.duet3d.com/DuetPi-lite.zip) - Config [link](https://duet3d.dozuki.com/Wiki/SBC_Setup_for_Duet_3)`
			`#### Git config && software deployment`
			```
			`apt-get update && apt-get upgrade && apt-get install git`
			`mv /opt/dsf/sd/sys /opt/dsf/sd/sys.ori`
			`mv /opt/dsf/sd/macros /opt/dsf/sd/macros.ori`
Instructions update after making the repo public 2021-06-06 19:06:15 +00:00			`cd /opt ; git clone https://g.lgeex.com/3dprinting/duet_vcore3.git`
Update READM.md 2021-06-05 19:59:12 +00:00			`chown -R dsf:dsf /opt/duet_vcore3`
			`chmod -R g+s /opt/duet_vcore3`
			`setfacl -R -d -m u::rwx /opt/duet_vcore3`
			`ln -s /opt/duet_vcore3 /opt/dsf/sd/sys`
			`ln -s /opt/duet_vcore3/macros /opt/dsf/sd/macros`
Instructions update after making the repo public 2021-06-06 19:06:15 +00:00			`ls -s /opt/duet_vcore3 /root/ # yes I use root on the rasp.`
Update READM.md 2021-06-05 19:59:12 +00:00			```

			`### Duet 3 6HC - Pins`
Add README.md 2021-05-28 23:14:44 +00:00
			`#### IO`
Add README.md 2021-05-28 23:24:18 +00:00			`Used IO pin headers`
			`* io_0 - display`
			`* io_1 - y endstop`
			`* io_2 - x endstop`
			`* io_7 - bltouch`
Add README.md 2021-05-28 23:14:44 +00:00
			`#### Stepper motors`
Add README.md 2021-05-28 23:24:18 +00:00			`All steppers are 0.9º`

Fix: Y Stepper motion, it was inverted 2021-06-06 15:00:52 +00:00			`* z left - driver2 - motion backwards (looking from the back of the printer)`
Add README.md 2021-05-28 23:24:18 +00:00			`* z rear - driver1 - motion backwards`
Fix: Y Stepper motion, it was inverted 2021-06-06 15:00:52 +00:00			`* z right - driver1 - motion backwards`
Fix: Stepper direction, endstop high position for y, homing settings 2021-06-06 17:58:36 +00:00			`* top right motor - driver3 - Y - motion forwards (looking from the back of the printer)`
			`* top left motor - driver4 - X - motion forwards`
Add README.md 2021-05-28 23:24:18 +00:00			`* extruder motor - driver5 - motion forwards`

			`#### Outputs`
			`##### Heating elements (24v)`
			`Heating elements in use:`
			`* out1 - SSR Bed`
			`* out2 - Hotend`
			`##### Fans (24v)`
			`Fans in use:`
			`* out4 - layer fan`
Add LED control and several other macros 2021-06-03 22:09:42 +00:00			`* out7 - hotend fan`
			`##### Lighting`
			`* out8 - dc ssr operated leds`
Add README.md 2021-05-28 23:14:44 +00:00
			`#### Temperature probes`
Add README.md 2021-05-28 23:24:18 +00:00			`Thermal probes in use:`
			`* temp0 - Bed thermistor`
			`* temp1 - Hotend thermistor`
Add useful links to README 2021-05-28 23:17:36 +00:00
Update READM.md 2021-06-05 19:59:12 +00:00			`## TODO`
			`- Setup filament sensor`

Update readme, add info regarding backplate and hw links 2021-06-05 22:39:21 +00:00			`- All macros are untested until stated otherwise, list of tested macros:`
Update README.md 2021-06-05 20:06:23 +00:00			`- - Lighting (all)`
			`- - Preheat (all)`
Change README, add new new macros to the tested list 2021-06-05 21:08:59 +00:00			`- - PID tuning Bed && HotEnd`
Update README.md 2021-06-05 20:06:23 +00:00
Update readme, add info regarding backplate and hw links 2021-06-05 22:39:21 +00:00			`## Electronics backplate`
			`I've also set a exectronics backplate (to be a cut of alluminium or polycarbonate up to 4mm), you may find it in [thingiverse.com](https://www.thingiverse.com/thing:4792093).`
Update README.md 2021-06-05 20:06:23 +00:00
Update readme with intro section 2021-06-05 21:37:00 +00:00			`## Links and external sources`
Add README.md 2021-05-28 23:20:11 +00:00			`* [GCode library](https://duet3d.dozuki.com/Wiki/Gcode)`
			`* [RatRig vcore3 docs](https://ratrig.dozuki.com/c/Rat_Rig_V-Core_3)`
Update README.md 2021-06-05 20:06:23 +00:00			`* [Duet Macros repo](https://github.com/Duet3D/GcodeMacros)`