You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+2-260Lines changed: 2 additions & 260 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -65,267 +65,9 @@ This can be accomplished by commenting out the following lines in your `printer.
65
65
66
66
Once the plugin is updated, please uncomment the lines in your `printer.cfg` file (if applicable).
67
67
68
-
## Configuration (Automated)
68
+
## Documentation
69
69
70
-
The `install-afc.sh` script will automatically install the majority of the plugin for you.
71
-
72
-
Prior to starting Klipper, please review the configuration located at `~/printer_data/config/AFC/AFC_Turtle_(n).cfg` and ensure all pins are correct for your specific hardware.
73
-
74
-
Additionally, review the following files for any changes that may be required:
75
-
76
-
1. `~/printer_data/config/AFC/AFC.cfg`
77
-
2. `~/printer_data/config/AFC/AFC_Macro_Vars.cfg`
78
-
3. `~/printer_data/config/AFC/AFC_Turtle_1.cfg`
79
-
80
-
Review information in [mandatory configuration changes](README.md#mandatory-configuration-changes-all) section
81
-
82
-
## Installation & Configuration (Manual)
83
-
84
-
To manually install and configure the plugin, you can use the following commands:
Next, please copy the appropriate `AFC_Hardware.cfg` template file from `~/AFC-Klipper-Add-On/templates` to `~/printer_data/config/AFC`
96
-
and modify the file to match your hardware configuration. Ensure you rename the file properly based on the selected board type to `AFC_Hardware.cfg`.
97
-
98
-
You should also copy the `AFC_Turtle_1.cfg` template file from `~/AFC-Klipper-Add-On/templates` to `~/printer_data/config/AFC` and modify this file to match your hardware configuration.
99
-
100
-
Finally, review and update the following files as needed for your configuration.
101
-
102
-
1. `~/printer_data/config/AFC/AFC.cfg`
103
-
2. `~/printer_data/config/AFC/AFC_Macro_Vars.cfg`
104
-
3. `~/printer_data/config/AFC/AFC_Hardware.cfg`
105
-
4. `~/printer_data/config/AFC/AFC_Turtle_1.cfg`
106
-
107
-
## Moonraker configuration
108
-
109
-
To enable the AFC plugin in Moonraker, you should add the following lines to your `moonraker.conf` file:
If this is your first time setting up a Box Turtle please follow the [initial startup guide](https://github.com/ArmoredTurtle/BoxTurtle/blob/main/Initial_Startup.md#install-the-afc-klipper-add-on)
124
-
## Mandatory Configuration Changes (All)
125
-
126
-
Prior to operation, the following checks / updates **MUST** be made to your system:
127
-
128
-
1. Update the following values in the `~/printer_data/config/AFC/AFC_Hardware-{board}.cfg` file:
129
-
*default name with AFC-lite will be AFC_Hardware-AFC.cfg*
130
-
131
-
- tool_stn: This value is the length from your toolhead sensor to nozzle, if`tool_end` is defined then distance is from this sensor
132
-
- tool_stn_unload: This value is the amount to unload from extruder when doing a filament change.
133
-
134
-
2. Update the following in the `~/printer_data/config/AFC/AFC_Turtle_{n}.cfg` file:
135
-
*for systems with a single unit, the file will show as `AFC_Turtle_1.cfg` addtional units with be 2, 3 etc.*
136
-
137
-
- afc_bowden_length: This value is the length from your hub to your toolhead sensor
138
-
139
-
3. Verify that `pin_tool_start` is set to the correct pin foryour toolhead sensor. If you are using an existing filament sensor as your toolhead sensor make sure you comment out any filament sensor sectionsin your `printer.cfg` file.
140
-
141
-
4. If you are using any of the built-in macros, the variables in the `~/printer_data/config/AFC/AFC_Macro_Vars.cfg` file
142
-
must also be modified to match your configuration for your system.
143
-
144
-
Required variables to verify and update if necessary for the following default macros
145
-
- tool_cut:
146
-
- variable_retract_length
147
-
- variable_cut_direction
148
-
- variable_pin_loc_xy
149
-
- variable_pin_park_dist
150
-
- variable_cut_move_dist
151
-
- park:
152
-
- variable_park_loc_xy
153
-
- poop:
154
-
- variable_purge_loc_xy
155
-
- kick:
156
-
- variable_kick_start_loc
157
-
- variable_kick_direction
158
-
- wipe
159
-
- variable_brush_loc
160
-
- variable_y_brush
161
-
- form_tip
162
-
Variables to update fortip forming arein`~/printer_data/config/AFC/AFC.cfg`
163
-
- cooling_tube_position
164
-
- cooling_tube_length
165
-
166
-
5. If you would like to use your own macro instead of the provided macros, make sure to update the command with your custom macro in`~/printer_data/config/AFC/AFC.cfg`
167
-
ex. If using custom park macro, change `park_cmd` from `AFC_PARK` to your macro name
168
-
169
-
**Failure to update these values can result in damage to your system**
170
-
171
-
## Optional Configuration Changes
172
-
173
-
If you use a Turtleneck v2, you can enable the buffer indicator LED by adding the following lines to your `AFC.cfg` file:
174
-
175
-
```cfg
176
-
led_buffer_advancing: 0,0,1,0
177
-
led_buffer_trailing: 0,1,0,0
178
-
led_buffer_disable: 0,0,0,0.25
179
-
```
180
-
181
-
If using a hub that is not located in the box turtle the following value needs to be updated for each stepper
182
-
183
-
- dist_hub: This value the the length between the lanes extruder and the hub, this does not have to be exact and is better to figure the length and then minus about 40mm
184
-
185
-
If using snappy hub cutter update the following values:
186
-
187
-
- cut: change to True
188
-
- cut_dist: update to the value that you would like to cut off the end, this may take some tuning to get right
189
-
190
-
### Buffer configuration - Manual
191
-
192
-
If you are using a buffer such as the Turtleneck, Turtleneck v2 or Annex Belay, and you installed the software manually, you may need to make a couple of additional changes.
193
-
194
-
You should add the following block to your `AFC_Turtle_1.cfg` file based on the type of buffer you are using.
195
-
196
-
**NOTE** The `pin` value should be set to the pin that the buffer is connected to on your board.
197
-
198
-
### Hub configuration - Manual
199
-
200
-
If direct loading to an extruder is desired the following lines need to be added to the [AFC_stepper <lane>] of choice.
201
-
202
-
```cfg
203
-
hub: direct
204
-
```
205
-
206
-
When using this will cause the spool to automatically load to the extruder. There should be no Hub in-between that lane and the extruder.
207
-
Using 'direct' will disable calabrations for that lane.
208
-
209
-
#### Turtleneck
210
-
211
-
```cfg
212
-
[AFC_buffer TN]
213
-
advance_pin: # set advance pin
214
-
trailing_pin: # set trailing pin
215
-
multiplier_high: 1.05 # default 1.05, factor to feed more filament
216
-
multiplier_low: 0.95 # default 0.95, factor to feed less filament
217
-
velocity: 100
218
-
```
219
-
220
-
Turtleneck v2
221
-
222
-
```cfg
223
-
[AFC_buffer TN2]
224
-
advance_pin: !turtleneck:ADVANCE
225
-
trailing_pin: !turtleneck:TRAILING
226
-
multiplier_high: 1.05 # default 1.05, factor to feed more filament
227
-
multiplier_low: 0.95 # default 0.95, factor to feed less filament
228
-
led_index: Buffer_Indicator:1
229
-
velocity: 100
230
-
231
-
[AFC_led Buffer_Indicator]
232
-
pin: turtleneck:RGB
233
-
chain_count: 1
234
-
color_order: GRBW
235
-
initial_RED: 0.0
236
-
initial_GREEN: 0.0
237
-
initial_BLUE: 0.0
238
-
initial_WHITE: 0.0
239
-
```
240
-
241
-
Finally, add `buffer: <buffer_name>` to either your `AFC_extruder`, `AFC_stepper`, or `AFC_<unit_type>` sections in`AFC_Turtle_(n).cfg` files. For example, if you are using the Turtleneck v2, you would add the following line:
242
-
243
-
Using this config, buffer will be used for every unit that uses this extruder
244
-
245
-
```cfg
246
-
[AFC_extruder extruder]
247
-
buffer: TN2
248
-
```
249
-
250
-
Using this config, buffer will be used for every lanes that uses this unit
251
-
252
-
```cfg
253
-
[AFC_BoxTurtle Turtle_1]
254
-
buffer: TN2
255
-
```
256
-
257
-
Using this config, buffer will be used forjust the lanes the buffers is assigned to, this will override anything setin extruder/unit sections
258
-
259
-
```cfg
260
-
[AFC_stepper lane1]
261
-
buffer: TN2
262
-
```
263
-
264
-
Additional information about the buffer configuration and operation can be found in the [AFC_buffer.md](./docs/AFC_buffer.md) file.
265
-
266
-
## Automatic Calibration
267
-
268
-
Call `AFC_CALIBRATION`in your gui of choice and follow the prompts to calibrate your AFC system.
269
-
_distances will be calibrated to have ~1 short move after the move distance_
270
-
**All values will be automatically updated in the proper config sections after calibration**
271
-
272
-
If using a hub different from the stock set up `hub_clear_move_dis` under AFC unit may need to be increased/decreased to match your setup, default `50mm`.
273
-
274
-
For additional information and the steps formanual calibration, can be foundin [Calibration.md](./docs/Calibration.md)
275
-
276
-
## Troubleshooting
277
-
278
-
A debug script is available to be run that can assist the Armored Turtle support team on their Discord channel. To run the script, simply use the following commands:
279
-
280
-
```bash
281
-
cd~/AFC-Klipper-Add-On/troubleshooting
282
-
./afc-debug.sh
283
-
```
284
-
285
-
This script will collect some basic information about your system to include Klipper logs, device information, CAN network information, and your AFC
286
-
configuration files. This information will be uploaded to termbin.com and the resulting link can be used to share this information with the Armored Turtle team.
287
-
288
-
Debug information about the respooler system can be found by visiting the following URL in your browser:
289
-
290
-
`{ip address}/printer/afc/status`
291
-
292
-
## LEDs not displaying correct color
293
-
294
-
If your leds are not displaying the correct color update the following value under your `AFC_led` section in`~/printer_data/config/AFC/AFC_Turtle_(n).cfg` file.
295
-
296
-
- color_order: change to match the color order for you leds. Different color orders are: RGB, RGBW, GRB, GRBW
297
-
298
-
## Filament pulling past extruder during unloads
299
-
300
-
During unloads if your filament retracts too much and goes past the lanes extruder then decrease your `afc_bowden_length` value in`~/printer_data/config/AFC/AFC.cfg` file
301
-
302
-
## Timer too close (TTC) error
303
-
304
-
If you keep getting TTC errors start by adding the following to `AFC/AFC.cfg` file under `[AFC]` section
305
-
306
-
- `trsync_update: True`
307
-
308
-
## Layer shift when using cut macro
309
-
310
-
If you notice a layer shift occurs while using the cut macro, setting a higher stepper current while cutting has shown to help with this.
311
-
Update and uncomment the following values in`AFC/AFC_Macr_Vars.cfg` file
312
-
313
-
- variable_cut_current_stepper_x - start with ~1.7-1.8A
314
-
- variable_cut_current_stepper_y - start with ~1.7-1.8A
315
-
- Only needed if cutting action is along the z - variable_cut_current_stepper_z
316
-
317
-
Make sure your stepper names are updated for variables: `variable_cut_current_stepper_x, variable_cut_current_stepper_y, variable_cut_current_stepper_z`
318
-
319
-
## Removing Plugin
320
-
321
-
To remove the plugin, you can use the following commands:
322
-
323
-
```bash
324
-
cd~/AFC-Klipper-Add-On
325
-
./install-afc.sh
326
-
```
327
-
328
-
Once the installation program starts, please selectthe option to remove the plugin.
70
+
Further documentation on the plugin, it's various commands and configuration references can be found [here](https://armoredturtle.xyz/docs/).
0 commit comments