Component Sourcing and Library Management Guide for https://github.com/UWARG/hardware primarily intended for new members of the WARG Electrical subteam as it doesn’t dive into advanced topics.
Currently a WIP
Github Repository & How to use it with Altium and Discord
Our github page for hardware for electrical can be found here https://github.com/UWARG/hardware if you do not have write access just @ a lead on discord and they can hook you up provided they are confident in your understanding or something idk.
If you don’t know how to use https://git-scm.com/downloads I highly recommend using https://desktop.github.com/ as it holds your hand and has the required features you will need. I will explain how to use github desktop briefly below, but I will not be explaining how to use Git. Git has more features (primarily for our application, the ability to revert commits, although there are many more) and is the industry standard so if you want to learn it yourself, go for it!
You will start by cloning our repository from “origin” or https://github.com/UWARG/hardware onto your local files. Then you can open up the project with Altium and manipulate it. Be sure to include a commit message following our scheme. Examples of commit messages can be found here https://github.com/UWARG/hardware/commits/master so just try to blend in . I
Be sure to pull from origin before beginning work in progress! and push to origin after committing, failure to do this will result things I’m not going to describe how to fix here, but just know they aren’t fun. Further, remember to hit the save button in Altium before committing to ensure all your changes are included in the commit you make. Check the origin github website to be sure your commit actually went through! Further, we have a system in which we use the #git channel in discord to say what files are busy. This is because the files for Altium are refered to as “binaries” and are therefore not mergable! So only one person can work on each file at once since there is no way to merge like there is when you are writing code. Same thing as commit messages, try to blend in, the git channel is filled with examples on how to do this. “Busy” means you are working on something, “Free” means you are done editing and have committed and pushed all your changes.
Be sure to only use components that are a part of our repositories libraries, mistakes can be make if you have your own repository. When creating new projects or files or anything really, always look at previous stuff and copy paste as much as you can. Sometimes the previous stuff is wrong, but if you don’t know copying previous stuff is fine, also, don’t be afraid to ask questions. Don’t waste your time doing something you’re not sure is correct when someone could answer the questions in a few seconds. Nobody is going to make fun of you, we all learned by questions.
Capacitors
Manufacturer = Murata
2-3x size
0603 preferably, 0805 as backup
capacitance is picky
+-10% tolerance is fine
X7R is preferable
cheap plz