Skip to content

Commit

Permalink
Spelling and blank spaces corrections (#384)
Browse files Browse the repository at this point in the history
  • Loading branch information
MallocArray authored Aug 17, 2023
1 parent ec7e0b8 commit 113f398
Show file tree
Hide file tree
Showing 24 changed files with 105 additions and 107 deletions.
2 changes: 1 addition & 1 deletion about.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ In 2015, the very first set of 18 Voron printers were packaged in RCF's garage a

All it takes to receive a serial number after you have completed your build is to post a video of your printer printing on the Voron [Subreddit](https://www.reddit.com/r/voroncorexy/). Be sure to have your printer cleaned up with all cable management above the deck plate done. Wiring can be tricky, but do your best!

*Note: the serial submission process has become more automated now. In order to have the bot pick up your serial request video, be sure to use the "Serial Request" flair and add your full Discord name, including the unique 4 digit number (for example, #1234) after your username. Mods will review the requests periodically!*
*Note: the serial submission process has become more automated now. In order to have the bot pick up your serial request video, be sure to use the "Serial Request" flair and add your full Discord name, including the unique 4 digit number (for example, #1234) after your username. Mods will review the requests periodically!*


---
Expand Down
14 changes: 7 additions & 7 deletions build/electrical/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,13 +22,13 @@ When wiring your printer electronics, you will be working with line voltage wiri

* AC wiring should be properly dimensioned. Use at least 18 AWG (0.75 mm²) for mains AC wiring, even better would be 16 AWG (1.25 mm²)
* Buy a quality SSR (see the official sourcing guide), cheap clones may overheat and fail closed causing a heater thermal runaway. Add a 115-125°C thermal fuse to your bed heater as an additional safety measure
* Dont run your bed above 110°C, this reduces the lifespan of the adhesive holding it onto the build plate
* Don't run your bed above 110°C, this reduces the lifespan of the adhesive holding it onto the build plate
* If using an AC powered bed, be sure to ground the bed regardless of if the assembly manual specifies it or not.
* Grounding the frame is recommended.

## Connectors

The recommended MicroFit 3.0 connectors are specified for up to 5A and should be used for all connections to the stepper motors, hotend and limit switches The JST connectors are used for connections to the MCU board(s). JST connnectors are not available as mid-wire connectors so they must be mixed. Adding Molex connectors to all stepper motors is useful. Use a 3pin MLX connector (see the official sourcing guide) to allow your bed to be removable without disconnecting from the SSR directly. The thermistor can use a 2pin Microfit connector.
The recommended MicroFit 3.0 connectors are specified for up to 5A and should be used for all connections to the stepper motors, hotend and limit switches The JST connectors are used for connections to the MCU board(s). JST connectors are not available as mid-wire connectors so they must be mixed. Adding Molex connectors to all stepper motors is useful. Use a 3pin MLX connector (see the official sourcing guide) to allow your bed to be removable without disconnecting from the SSR directly. The thermistor can use a 2pin Microfit connector.

### Microfit Pins

Expand All @@ -42,11 +42,11 @@ For larger wires, such as heater cartridge wiring, heatshrink tubing is helpful.

## Cables

Silicone wiring has been specified because it has a high strand count which means it has higher fatigue life. Silicone insulation withstands heat and is more flexible which is good in high movement applications. It is less prone to snagging on other wires or the walls inside the cable chain. Check your cable loom before installing the chains.
Silicone wiring has been specified because it has a high strand count which means it has higher fatigue life. Silicone insulation withstands heat and is more flexible which is good in high movement applications. It is less prone to snagging on other wires or the walls inside the cable chain. Check your cable loom before installing the chains.

PTFE or Heluflon wires are a premium option as they have a thinner insulation and a lower friction coefficient, which increases bending capabilities and decreases wear. But these advantages are most useful in printers that use cable chains. For printers with an umbilical cord cabling setup (V0 Toolhead, Legacy), they might be overkill. Automation cable such as IGUS can be used, but the minimum bend radius of the cable needs to be verified as the typical bend radius for Voron cable chains is very small.

See the cable lengths and count section for specific counts. Do not downsize the hot end heater wires, they are oversized for safety reasons.
See the cable lengths and count section for specific counts. Do not downsize the hot end heater wires, they are oversized for safety reasons.

You may add additional wires to your cable chains as a replacement in case of wire breaks. However, these cables will be heated/cooled and moved around as much as your live cables and may be broken already when you need them! So may be better to keep extra wires as spares outside of the printer.

Expand All @@ -60,15 +60,15 @@ There is no standard either for the color of wire on stepper motors, nor for the
There are 3 basic options for identifying windings:
1) Check the documentation. Many motors come with a card which tells you what wire colors are on the same winding. If there's no card, the manufacturer's website may have something.
2) Use a multimeter: put your meter in "continuity" mode. Pick one wire, and then find any other wire that shows continuity with it. Those two wires are on the same winding. By process of elimination, it should be safe to assume the other two represent the other winding.
3) If you don't have a meter available, you can twist 2 wires together, and then try to spin the shaft of the motor. If the wires are on the same winding, it will become noticably harder to spin the shaft.
3) If you don't have a meter available, you can twist 2 wires together, and then try to spin the shaft of the motor. If the wires are on the same winding, it will become noticeably harder to spin the shaft.

### Symptoms of miswired motors

Traditionally, trying to move a stepper that's miswired, has either resulted in nothing happening, or a nasty buzzing sound. However, recent versions of klipper will generally detect the miswiring, and simply shutdown. If, during your motor checks, klipper immediately shuts down: check your logs. If there is a wiring issue with your stepper, it will report something like

```
TMC 'stepper_y' reports DRV_STATUS: 001900d0 s2vsa=1(LowSideShort_A!) ola=1(OpenLoad_A!) olb=1(OpenLoad_B!) CS_ACTUAL=25
Transition to shutdown state: TMC 'stepper_y' reports error: DRV_STATUS: 001900d0 s2vsa=1(LowSideShort_A!) ola=1(OpenLoad_A!)
Transition to shutdown state: TMC 'stepper_y' reports error: DRV_STATUS: 001900d0 s2vsa=1(LowSideShort_A!) ola=1(OpenLoad_A!)
```


Expand Down Expand Up @@ -114,7 +114,7 @@ If the purchased steppers do not match the color order in the documentation, the

### Inductive Probe Wiring (V1, Trident, V2, Switchwire)

The BOM spec PL-08N inductive probe (and the alterate Omron probe) that is used for Bed Mesh, Z Tilt Adjust (V1/Legacy) or Quad Gantry Leveling (V2) needs to be powered with 12-24V, not the typical 5V that is used for end stop switches. This is critical because if powered with 5V the sense distance is reduced enough to cause a nozzle crash.
The BOM spec PL-08N inductive probe (and the alternate Omron probe) that is used for Bed Mesh, Z Tilt Adjust (V1/Legacy) or Quad Gantry Leveling (V2) needs to be powered with 12-24V, not the typical 5V that is used for end stop switches. This is critical because if powered with 5V the sense distance is reduced enough to cause a nozzle crash.

If not closely following the BOM spec, ensure that the inductive probe purchased is a normally closed (NC) version rather than normally open (NO). The configuration cannot be changed as that is built specifically from the factory. A normally open (NO) probe may cause crashes if a wire breaks.

Expand Down
2 changes: 1 addition & 1 deletion build/slicer/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Some slicers (e.g. PrusaSlicer) do not recognize the Klipper `PRINT_START` macro

Both Cura and SuperSlicer (in current versions) have built-in profiles for V2 printers which can be setup using each software's normal processes. The V1 is similar enough to V2 that the profile can be re-used.

There is also a Voron Design profile available for PrusaSlicer / Superslicer.
There is also a Voron Design profile available for PrusaSlicer / SuperSlicer.

* [Voron 2.4 - PrusaSlicer / SuperSlicer](https://github.com/VoronDesign/Voron-2/tree/Voron2.4/slicer_profiles/PrusaSlicer)

Expand Down
2 changes: 1 addition & 1 deletion build/software/flyf407zg_klipper.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ In the menu structure there are a number of items to be selected.
* Ensure that "Enable extra low-level configuration options" is selected
* Ensure that the micro-controller architecture is set to 'STMicroelectronics STM32'
* Ensure that the Processor model is set to "STM32F407"
* Ensure that the Bootloader offet is set to "32KiB bootloader"
* Ensure that the Bootloader offset is set to "32KiB bootloader"
* Ensure that Clock Reference is set to "8 MHz crystal"
* Ensure that "Use USB for communication (instead of serial)" is selected

Expand Down
28 changes: 14 additions & 14 deletions build/software/ssh.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,13 +26,13 @@ Pretty much every Single Board Computer has an hdmi port. However, on some mode
To connect to a Pi over the network, you need 3 pieces of information:

1. Your username on the pi. You may have set this during the flashing step. If not, it likely defaulted to `pi`
1. Your password: You should already know this: you set this during the flashing step.
1. Your password: You should already know this: you set this during the flashing step.

{: .note }
On old Raspberry pi systems, the default password was "raspberry". Modern installs wisely discourage this

{:style="counter-reset:none"}
1. A hostname or IP Address.
1. A hostname or IP Address.


Hopefully, mdns is working on your network, and you can simply use the ".local" address. If you set a hostname for your device via pi imager, the hostname will be `the_thing_you_set.local` if you didn't, your device will likely be `raspberrypi.local` or `mainsailos.local` If none of these options work, you may need to locate the pi by IP address. see [Finding a Device's IP Address](#finding-a-devices-ip-address )
Expand All @@ -42,30 +42,30 @@ Hopefully, mdns is working on your network, and you can simply use the ".local"
### putty
Putty is a windows ssh client with a long history. It is a free download [here](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html).

To connect with putty:
To connect with putty:
1. Open Putty
1. Enter your username and hostname in the "hostname" field, in the format `<user>@<host>`, for example `[email protected]`
1. Press the "Open" button
![](images/putty_connection_settings.png)
1. Since this is your first time connecting to this remote machine, you will find yourself facing security warning. It should be safe to just click accept.
![Putty Security Alert](images/putty_connection_security.png)
![Putty Security Alert](images/putty_connection_security.png)
1. You will then find yourself with a black window and a password prompt. Type your password, and press enter. It is normal for nothing to appear on the screen while you are typing the password. (Linux applications traditionally hide passwords *completely* rather than the more familiar dots or stars)
![Putty password entry](images/putty_password.png)

### mac command line

1. Open the Mac OS "terminal" app (Utilities->Terminal)
1. type a command in the format `ssh <user>@<host>`, substituting your username and hostname from your pi: for example `ssh [email protected]`, and press enter.
1. You will then be presented with a security warning regarding an unrecognised security key. It should be safe to simply accept this by typing "yes" and press enter.
1. You will then be presented with a security warning regarding an unrecognized security key. It should be safe to simply accept this by typing "yes" and press enter.
![OpenSSH security warning](images/openssh_security_warning.png)
1. You will then be prompted for your password. Type your password, and press enter. It is normal for nothing to appear on the screen while you are typing. (Linux applications traditionally hide passwords *completely* rather than the more familiar dots or stars)


### pc command line

1. Open the windows commandline: Press the windows key, type "cmd" and press enter
1. Open the windows command line: Press the windows key, type "cmd" and press enter
1. type a command in the format `ssh <user>@<host>`, substituting your username and hostname from your pi: for example `ssh [email protected]`, and press enter.
1. You will then be presented with a security warning regarding an unrecognised security key. It should be safe to simply accept this by typing "yes" and press enter.
1. You will then be presented with a security warning regarding an unrecognized security key. It should be safe to simply accept this by typing "yes" and press enter.
![OpenSSH security warning](images/openssh_security_warning.png)
1. You will then be prompted for your password. Type your password, and press enter. It is normal for nothing to appear on the screen while you are typing. (Linux applications traditionally hide passwords *completely* rather than the more familiar dots or stars)

Expand All @@ -85,7 +85,7 @@ Congratulations! If you've gotten here, you should have crossed the first major
* `ls <some_dir_name>` will list the files in the named directory, instead of the current one
* `ls -l` will include additional information, including file size, and ownership
* `ls -h` will convert numerical information to a more readable form. commonly combined with -l, to get file sizes in a more readable form
* arguments can be chained together. for example `ls -lh klippeer` will list off all the files in the "klipper" directory, and include the extended information, with the numbers in a readable format
* arguments can be chained together. for example `ls -lh klipper` will list off all the files in the "klipper" directory, and include the extended information, with the numbers in a readable format
* ls has many, many other options, but these couple should be enough to get started

![ls](images/linux_prompt_ls.png)
Expand All @@ -102,7 +102,7 @@ Congratulations! If you've gotten here, you should have crossed the first major
3. we land in "home". Note how the command prompt changes to tell us where we are.

### cp & mv
* `cp` ("copy") makes a duplicate of a file. `cp <original_name> <new_name>`
* `cp` ("copy") makes a duplicate of a file. `cp <original_name> <new_name>`
* `mv` ("move") moves a file to a new filename or a new directory `mv <original_file> <new_name>`
* in both cases, the second command could be either a new file name, OR a new directory name. for example, `cp 1.txt 2.txt` will make a duplicate file named `2.txt``, in the current working directory. whereas mv 1.txt klipper/ would create the new copy, *still called 1.txt*, in the directory "klipper".

Expand All @@ -118,7 +118,7 @@ Congratulations! If you've gotten here, you should have crossed the first major

### sudo

* sudo (superuser do) allows you to execute commands as the system administrator (known as "root") when necessary.
* sudo (superuser do) allows you to execute commands as the system administrator (known as "root") when necessary.
* sudo will sometimes ask for your password: note, this is the password of the normal account, *not* some other administrator password
* This tool is often needed to edit a file in `/etc` or `/boot` that normal users don't have access to. For example, several common processes require edits in the file `/boot/config.txt`. This file is only editable by root. so if you try to just open it normally with nano `nano /boot/config.txt`, you'll just get an error: file is unwritable. Instead, you can use sudo: `sudo nano /boot/config.txt`, and then you'll be able to edit normally.
![nope](images/nano-readonly.png)
Expand Down Expand Up @@ -161,7 +161,7 @@ graph LR;

### ~
* the `~` symbol is short hand for "the user's home directory". generally, this will be `/home/<username>`, so for example, `/home/pi`
* this is also the directory you first start out in when logging in.
* this is also the directory you first start out in when logging in.
* on most klipper installs, this will be the directory that contains most of the klipper stuff: klipper, mainsail, moonraker, etc.

{: .note }
Expand Down Expand Up @@ -210,14 +210,14 @@ If you know that it makes sense your pi's ID has changed, such as the pi being a
- download Angry IP scanner from [here](https://angryip.org/)
- install & run it
- Go to `Tools->Fetchers`. Select the "MAC Vendor"(1) fetcher, and press the left arrow(2) to activate it. press okay(3)

![fetchers](images/angryip_fetchers.png)
- Go to `Settings`, and change to the `Display`(1) tab. Set `Display in the results list` to `Alive hosts`(2). press okay (3)

![prefs](images/angryip_prefs.png)
- Press "Start"
- Once the scan finishes, look for a result with a MAC Vendor similar to "Raspberry Pi Trading"

![angryip](images/angryip_results.png)

### Static IPs
Expand Down
Loading

0 comments on commit 113f398

Please sign in to comment.