-
Notifications
You must be signed in to change notification settings - Fork 3
Wiring guide #53
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Wiring guide #53
Conversation
content/kit/wiring.md
Outdated
Ground should be Black, and nothing else should be black. This is in the interest of both safety and organisation. Being able to see where all your ground cables allows you to easily track cable runs and diagnose electronic issues. It also greatly reduces the chance of running an actual current down the ground, which will serious damage the kit! | ||
|
||
## Keep your solders clean | ||
Sometimes, you'll need to build your own circuits to extend out kit, which likely requires soldering. Keep an eye on your solders so they don't create a bridge between components. This will likely lead to the electronics not working correctly. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This will likely lead to the electronics not working correctly. You could add if you inadvertently bridge a VCC/GND connection it could lead to sad times for everyone involved.
content/kit/wiring.md
Outdated
Ensuring your robot is wired correctly is incredibly important. If wired incorrectly, your kit may not work correctly, or may be damaged. | ||
|
||
## Wire Colouring | ||
Ground should be Black, and nothing else should be black. This is in the interest of both safety and organisation. Being able to see where all your ground cables allows you to easily track cable runs and diagnose electronic issues. It also greatly reduces the chance of running an actual current down the ground, which will serious damage the kit! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Ground should be Black, and nothing else should be black. " could change to lowercase.
"...all your ground cables go allows you to easily track cable runs.."
"which will seriously damage the kit!"
content/kit/wiring.md
Outdated
Sometimes, you'll need to build your own circuits to extend out kit, which likely requires soldering. Keep an eye on your solders so they don't create a bridge between components. This will likely lead to the electronics not working correctly. | ||
|
||
## Use higher gauge wire | ||
If a component is likely to draw a lot of current, it's best to give it a thicker wire. The motor board is likely to draw the most current, and so should use a very thick wire (like what is in your kit). Using a wire that's too thin will lead to your motor board trying to draw too much current and stop working. Using thinner wire will be fine for small electronics, such as micro-switches. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Using a thin wire could lead to overheating -> Fire hazard?? (@kierdavis I'm not too sure how hot these things could get.. is this correct?)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If they tried to power the motor board over the thin solid-core wire, then yes there is. Although a part of me thinks that's a little closer to natural selection to worry about 😉
content/kit/wiring.md
Outdated
Ensuring your robot is wired correctly is incredibly important. If wired incorrectly, your kit may not work correctly, or may be damaged. | ||
|
||
## Wire Colouring | ||
Ground should be black, and nothing else should be black. This is in the interest of both safety and organisation. Being able to see where all your ground cables go allows you to easily track cable runs and diagnose electronic issues. It also greatly reduces the chance of running an actual current down the ground, which will seriously damage the kit! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Changing the last sentence to something like
It also greatly reduces the chance of misconnecting any power cables to ground, which would short-circuit the battery and seriously damage the kit!
would be more accurate.
(Note that if your ground connection is not carrying an "actual current", it is functionally equivalent to an open circuit and therefore might as well not exist :) )
content/kit/wiring.md
Outdated
Ground should be black, and nothing else should be black. This is in the interest of both safety and organisation. Being able to see where all your ground cables go allows you to easily track cable runs and diagnose electronic issues. It also greatly reduces the chance of running an actual current down the ground, which will seriously damage the kit! | ||
|
||
## Keep your solders clean | ||
Sometimes, you'll need to build your own circuits to extend out kit, which likely requires soldering. Keep an eye on your solders so they don't create a bridge between components. This will likely lead to the electronics not working correctly. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
First sentence: "extend out kit" -> "extend our kit" ?
I'd also recommend changing "solders" to "solder joints". Maybe its just because I'm really tired but wasn't sure exactly what you meant by "solders" until I'd read it a few times.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
They told me to
Update license
Add some useful tips for wiring up kit.