duet_vcore3/README.md

# Vcore3 500^3
## Intro
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 Vcore3 is a [core xy 3d printer](https://www.reprap.org/wiki/CoreXY) with a kinematic bed on 3 axis.
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.

## Git structure
### V1 branch 

* Tries to keep compatibility with the default RR HW
* Can be used as a default config

### Master

* It uses my personal config
* It supports or will support newer/better hw, pwm fans, camera, thermal camera, etc
* Better HW monitoring
* Better automation 

## 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)

Note: the stepper except the pancake one have the following specs:
``` 
Draaddikte: 	24 Awg 	Aantal draden: 	4
Nominale stroom: 	1,7 A 	Weerstand: 	1,8 Ω
Afmetingen: 	42,3 x 42,3 x 48 mm (LxBxH) 	As diameter: 	5 mm
Voltage: 	3,1 V 	Stap hoek: 	0,9 °
Houdkoppel: 	4.2 kg-cm 	As lengte: 	22 mm
Montagegat: 	M3 
```

##### 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 a second 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_3 - Duet filament sensor
* 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
- Add printing tracking camera 

- All macros are untested until stated otherwise (some are cloned from duet repos, others are mine), list of tested macros: 
- - Lighting (all)
- - Preheat (all)
- - PID tuning Bed && HotEnd
- - Preheat PLA / ASA / PETG
- - Musical Tunes
- - Diagnostics/Disallow unhomed moves
- - Diagnostics/E steps calibration

## 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)
* [RatRig Vcore video by TeachingTech](https://www.youtube.com/watch?v=XoTxFs3BGuk&t)
Update READM.md 2021-06-05 19:59:12 +00:00			`# Vcore3 500^3`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00			`## Intro`
			`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 Vcore3 is a [core xy 3d printer](https://www.reprap.org/wiki/CoreXY) with a kinematic bed on 3 axis.`
Update readme with intro section 2021-06-05 21:37:00 +00:00			`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
Update README with git section 2021-06-11 13:59:10 +00:00			`## Git structure`
			`### V1 branch`

			`* Tries to keep compatibility with the default RR HW`
			`* Can be used as a default config`

			`### Master`

			`* It uses my personal config`
			`* It supports or will support newer/better hw, pwm fans, camera, thermal camera, etc`
			`* Better HW monitoring`
			`* Better automation`

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)`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00
Update READM.md 2021-06-05 19:59:12 +00:00			`##### 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)`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00
Update READM.md 2021-06-05 19:59:12 +00:00			`##### 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)`

Update readme with stepper specs 2021-06-16 22:21:34 +00:00			`Note: the stepper except the pancake one have the following specs:`
			```
			`Draaddikte: 24 Awg Aantal draden: 4`
			`Nominale stroom: 1,7 A Weerstand: 1,8 Ω`
			`Afmetingen: 42,3 x 42,3 x 48 mm (LxBxH) As diameter: 5 mm`
			`Voltage: 3,1 V Stap hoek: 0,9 °`
			`Houdkoppel: 4.2 kg-cm As lengte: 22 mm`
			`Montagegat: M3`
			```

Update READM.md 2021-06-05 19:59:12 +00:00			`##### 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)`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00
Update READM.md 2021-06-05 19:59:12 +00:00			`##### Lighting`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00			`- 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)`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00			`Note: The usage of a second SSR allows more lighting to be added without worries for curruent usage on the board.`
Update READM.md 2021-06-05 19:59:12 +00:00
			`##### 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`
Add support to duet laser filament sensor 2021-06-15 23:09:18 +00:00			`* io_3 - Duet filament sensor`
Add README.md 2021-05-28 23:24:18 +00:00			`* 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`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00
Add README.md 2021-05-28 23:24:18 +00:00			`##### 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`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00
Add LED control and several other macros 2021-06-03 22:09:42 +00:00			`##### 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`
Add new entries to the tested macros list 2021-06-06 20:37:25 +00:00			`- Add printing tracking camera`
Update READM.md 2021-06-05 19:59:12 +00:00
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00			`- All macros are untested until stated otherwise (some are cloned from duet repos, others are mine), 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`
Add new entries to the tested macros list 2021-06-06 20:37:25 +00:00			`- - Preheat PLA / ASA / PETG`
			`- - Musical Tunes`
			`- - Diagnostics/Disallow unhomed moves`
Update E steps config after calibration, update readme 2021-06-08 16:59:23 +00:00			`- - Diagnostics/E steps calibration`
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)`
Improve homeall.g, aiming for a smoother homing 2021-06-08 22:07:21 +00:00			`* [RatRig Vcore video by TeachingTech](https://www.youtube.com/watch?v=XoTxFs3BGuk&t)`