Create comprehensive wire crimping best practices document#3142
Open
jasondaming wants to merge 3 commits intowpilibsuite:mainfrom
Open
Create comprehensive wire crimping best practices document#3142jasondaming wants to merge 3 commits intowpilibsuite:mainfrom
jasondaming wants to merge 3 commits intowpilibsuite:mainfrom
Conversation
- Covers Anderson Powerpole crimping techniques - Documents required tools and quality ratcheting crimpers - Provides step-by-step instructions for 15, 30, and 45 amp contacts - Includes troubleshooting and quality control procedures - Adds practice tips and competition preparation guidance Fixes wpilibsuite#1263
The image was referenced but never created, causing build failures
sciencewhiz
reviewed
Nov 19, 2025
|
|
||
| - **Low electrical resistance** - Minimizes voltage drop and heat generation | ||
| - **Mechanical strength** - Prevents wires from pulling out under vibration | ||
| - **Reliability** - Eliminates intermittent connections that cause brownouts |
Collaborator
There was a problem hiding this comment.
intermittent connections don't cause brownouts, they cause short blackouts. Really this seems like it's subsumed by electrical resistance and the mechanical strength bullets, unless there other failure modes considered but not mentioned.
|
|
||
| Ratcheting crimpers provide consistent, high-quality crimps by ensuring proper compression force every time. They prevent under-crimping or over-crimping by not releasing until the crimp cycle is complete. | ||
|
|
||
| Recommended tools: |
|
|
||
| Poor crimps are a common source of mysterious electrical problems. A connection that works on the bench may fail under the vibration and stress of competition. | ||
|
|
||
| ## Required Tools |
Collaborator
There was a problem hiding this comment.
The organization seems wierd. I think a description of different types of connectors needs to come before you start talking about how to crimp them.
|
|
||
| Wire ferrules are crimped metal sleeves used on stranded wire ends for screw terminal connections (like motor controllers, PDH channels, etc.) | ||
|
|
||
| **Best Practices:** |
|
|
||
| Used for battery terminals and some ground connections. | ||
|
|
||
| **Best Practices:** |
|
|
||
| Many FRC components use JST, Molex, or Dupont-style connectors for signal wiring. | ||
|
|
||
| **Best Practices:** |
|
|
||
| ### General Guidelines | ||
|
|
||
| 1. **Use the right wire gauge** |
|
|
||
| 4. **Inspect every crimp** - Look for even compression, proper insulation support, no gaps | ||
|
|
||
| 5. **Test the connection** |
| 5. **Test the connection** | ||
| - Visual inspection: Crimp should be symmetrical with no gaps | ||
| - Pull test: Gently tug the wire - it should not pull out | ||
| - Resistance test: Use a multimeter to verify low resistance (<10 mΩ for power connections) |
Collaborator
There was a problem hiding this comment.
10 mΩ seems high for a single connection. I also question whether a normal multi-meter that teams have would measure that low. Isn't that 4 wire measurement territory?
|
|
||
| .. important:: Contacts that are not fully inserted can cause intermittent connections, brownouts, or complete disconnection. Always perform a pull test! | ||
|
|
||
| ### Common Powerpole Crimping Problems |
Collaborator
There was a problem hiding this comment.
Some of these feel like they need pictures. How would a student now that something is deformed?
- Remove redundant "Reliability" bullet point (covered by other bullets) - Add "Connector Types Used in FRC" section before tools/crimping instructions - Fix formatting for recommended tools list and other sections - Replace "brownouts" with "momentary disconnections" (accuracy fix) - Reorganize "Other Connector Types" to focus on crimping best practices 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Creates a new comprehensive document covering wire crimping best practices, with a focus on Anderson Powerpole connectors commonly used in FRC.
Changes
crimping-best-practices.rstwith detailed crimping guidanceKey Topics Covered
Fixes #1263