diff --git a/Ploopy-Trackball-Mini-Kit-Assembly.md b/Ploopy-Trackball-Mini-Kit-Assembly.md new file mode 100644 index 0000000..2cbfabf --- /dev/null +++ b/Ploopy-Trackball-Mini-Kit-Assembly.md @@ -0,0 +1,279 @@ +# BEFORE YOU DO ANYTHING, READ THIS FIRST. + +**Do not flash new firmware until you've verified that the electronics are all working.** + +That means, finish building the trackball, plug it in, use the stock firmware for about five minutes. Verify the buttons are all clicking. Verify that the cursor is moving. Verify that the scroll wheel works. Unplug the trackball, hold the "forward" button (the button immediately to the right of the ball), plug it in, let go of the "forward" button, and verify that the trackball is in "bootloader" mode (the cursor won't be moving). + +Once you've verified that it all works, you're good to go flashing new firmware. + +## A few notes for those who have previously built a [Ploopy Classic Trackball](https://github.com/ploopyco/trackball/wiki/Ploopy-Trackball-Kit-Assembly) + +If you haven't previously assembled a Ploopy Classic Trackball, feel free to skip this section and go straight to **Main Instructions**. + +The Ploopy Mini Trackball is an improvement of the Ploopy Classic Trackball in many ways: + +- It does not require soldering or a soldering iron +- Plastic parts don't have to be violently bent in order to fit together +- Only one type of screw + +We think you'll be pleasantly surprised with how much easier the Ploopy Mini is to assemble than the Ploopy Classic. + +Let's dive in. + +## Main Instructions + +**TODO photo of all parts in the kit** + +In this section, you'll go over how to build a Trackball Mini from the official Ploopy Trackball Mini kit. + +Note that some of these pictures were taken at different times, so they may show a bit of inconsistency in between steps. + +## Step X: Get the necessary tools + +**TODO photo of all tools** + +- 2.5mm Allen key or screwdriver (comes with your kit) +- #1 Phillips head screwdriver (or similar size) + +## Step X: Remove support material from 3D-printed parts + +The following 3D-printed parts have support material on them: + + - Top + - Primary buttons + - Scroll wheel holder holder + +"Support material" is more hollow than the structural plastic. You'll have to remove it before you continue with the assembly. + +Most of the time, it can be removed using nothing but your fingers. If you find a bit of support material is sticking, use a pair of pliers or tweezers to scrape it off. Be careful not to damage the parts as you remove the support material, *especially on the scroll wheel holder holder*. + +**TODO create video removing support material** +[Here's a video on removing support material.](**TODO**) + +## Step X: Prepare secondary button adapters + +**TODO photo of Base, Secondary Button Adapters x2, 3x12 Steel Dowel Pin** + +Prepare the following components: + +- Base +- 2x Secondary button adapter +- 2x 3mm x 12mm metal dowels + +*Note:* your kit comes with two kinds of metal dowels. One type is 12mm in length; the other type is 18mm in length. You want the 12mm length metal dowels, so look for the shorter ones. The longer ones aren't going to fit. + +## Step X: Thread metal dowels through secondary button adapters + +**TODO photo of metal dowels through secondary button adapters** + +This might require a bit of force, and maybe even a hammer. + +## Step X: Press the secondary button adapters into the base + +**TODO photo of secondary button adapters in base** + +The secondary button adapters will "click" into place in the base. A bit of force is required here. + +## Step X: Prepare scroll wheel +![](https://lh3.googleusercontent.com/vsReZmIpMEvYFu-wzbbU0zo4A8LSE1Y5t8_SNpRt5v1R7Z6_xyLQxpWyj3wgesnzHy7QnmTKtQqEaJ4gPGRzXwMOYP7z09Hk_E6Le4Im-dquCRFyTV8Y2LxoS2-IEZo8x-uXc1jp_HsGwIwIQx12UzxNO24a6OYAkgLCqfLTXCZhNg5SKcwgmSfj0BJ_cIQ5RqH8r27gHB0aYzml4noK_WDW9xVVdyylGR-0bXXLnyRf9IvJ1UzluJqJ5osKWlyukpwNb5HuPmkTUwr5doWH6RzzQfSgIpCrGn72NzOAZh8oFweeQbOuBFEUdvp7MmX6cbT4bkTizSX6Jy_9E-pj5ZdE4pBkQWQ_Fj1UP67Bd8rAoTJwQ3VjcLA6S8YTqpcrE30SDRNhebkcm5prl6RItYKKe9gm63DL9GbWoTRtSjmxTLf9E1RLFDS6V5rx6iYPKQVVnjkihok9r96Hy74BGgtmhUA8_76dJJMh46CXhRjbJVGLrApvoKTXl23AzCmfG0nQ4Pix3XaEdtien1zu_uZoDDzirmgDuGDef_r1MHcbPtuL-i3L61NqtEMcRX8Zo24uLtoclvD3k1PyobrRnqGpnaRvAA3zM34Obhd7tP-LocM94Ut3Bc8IPgdKquAGyuQpKlfoi1KVjfiFVTPyUatHjyPmG93-qZzJGqPZF3EplhEmAfIwik5n5imYwJn_BOuJTI2mAbN4ryW6V42STuPef06GppRbkNglFWrJT2Z01AU=w1454-h969-no) + +Prepare the following components: + +- Scroll wheel +- Silicone ring +- 2x 3mm x 18mm metal dowels + +*Note:* your kit comes with two kinds of metal dowels. One type is 12mm in length; the other type is 18mm in length. You want the 18mm length metal dowels, so look for the longer ones. If you're following this guide in order, only the long ones will be left over. + +## Step X: Insert dowels into scroll wheel +![](https://lh3.googleusercontent.com/5EwI-F1MXSFo3l0OZtish4yHCMQTsYw6ilrF88hUlbgarZiQzROBkEH4uISmkKLQni1kas5bkRtpjD0WF0OZBwlyzBoo2zwVDMvU_DmMtHcnBNYoz0mMLLwgqu9vRg87MXKDqYbN_5hJGrXNDEwDOA4IIDcEJ7FUOogq4PNLXcKZ9hGeN4xjQFsKu8RvCBBxIcFbAYRrTVs-M2PUR5QsVo1cDrrNSwM3mziZ_DlB65D7TlTpfLNbbVUDLBQn9_pHztRe-9717Li3xc016Z3eY5mkYXMojsJes9ch2bcPgWQDuvEAXYBj_YukTJRGVfQ69U4daNSXKDmKO-CnqGspzxl6gCdQRVTppmJVQw5mP-dpW9_S9NN0r3_phggbcqi1otlJ82cTDGA3bHf2qvxh4NVqVJkEa05S7iDW4fHwtql8E05O29_TePBoMV2Xg7N2bX6j6ul6dVpqI23qmz4AIyRMBKhSHJSNUEcfCrx03pZvE5_-05m2ci86JRMAwS2zN5DxSNL6BHJq9O1JI2xHxZ20MtOBzYnN27y5PQe4_6a4d0OTRmZdCGL-9CpkoCw1iQhdiBEtIwagre4L_07V3WB7SUmvV9wq8SujnA5AEJQ2TeLW4qcUpUrU-TzAb2NvxoxK40nmoTIz_qlXzqVjvu2Hisa-zYAcXbXlcfzUadQ7rNhov4j2ajcnzXPdYODJeK-0TtsFWqvfshk2P4Bxy-bGwwWvcYVUEH3OngDpUNikSCU=w1454-h969-no) + +- You will likely require a hammer to push the pin into the scroll wheel. If you don't need one, consider yourself lucky. +- The pin on the flat side of the scroll wheel will stick out 10.4mm when the pin is fully inserted. +- The pin on the other side of the scroll wheel will stuck out 13.6mm when the pin is fully inserted. + +## Step X: Thread silicone ring onto scroll wheel +![](https://lh3.googleusercontent.com/TF1RWtjWWxu4aAqEoVFbjNDBwDcoDwINdf4YaKAE36ttCOhKzwoELo0A0fS3qhWAtHWZJ7jamgt3U-c8oHxCQVFUn9MCYXnpyoH2UWGsRVfmh-x9wWD-BSrmS_jeaRzwXstj7oMi6C0Cot9Jc5_fcT56P8GbeYNxBs2YJ4qFoGO9ENadi6MGCx93VF8cIjBoyeyamla9edj-t9sB2KDR8_IecOEPmvvgLC1j8BQY7vCMutMtffckA6lH0c2hRv8lJBFLl5ALY6QESzcrbP5YCWb1naM4nm9oEJCt2oW60EouksKNg0n0xhSOZdI0dCzr7wBg_xuC0QjZXceODUPxa-GHU8GHA4xOA_GpIa-qVS7BKcwWa-JJ1jIucSeHnyrxBZtILxNjnsdwVROjwWsPJM3xGk9K1__ALcTq-eOoV7f7XTKeNmHBkOfAwW6Ctvd_N1EZrCE8FXuunM4tJShthU-7yr4oGCFRWAbzjrelyv0LCnKEic8daq47eioAGfJjYrKJZAXWB5mTBv8TspniGyqj_SQO1E2y2IG3p8gmT577UzYldinbiF2yJfB1aRlX_fBZP1O1TMxLbyOQ-X9yD7l7NRCkORA1cRV_N1oEXh5xBZbmAY5vTzO9dr1jfpT2WacgWsaM7Tr-7Q1emlGCptjloYPTIsmbJq2k81EouHc9rlBPLZb4A4V3xC5Q1BNlsm_Mko1Rh9CUoQ17uUL_fEP2WIrmjUbko7qB8kyX64wa6g4=w1454-h969-no) + +Silicone is quite strong and doesn't rip easily. + +## Step X: Prepare the scroll wheel holder + +**TODO photo of components listed below** + +Prepare the following components: + +- Printed circuit board +- Scroll wheel +- Scroll wheel holder +- Scroll wheel holder holder + +## Step X: Insert scroll wheel holder into scroll wheel holder holder +![](https://lh3.googleusercontent.com/M7ce85IRvDeEgu_EFp5pA8PVVzrOhleTF_KBSOJOPOTjwy-QJqUhxAvdDMwK_KU_kyLdnIuVD4OJoqB7A45KqI7vvcoRcw26hN-8CCmKxpctaUw-B5W3cAhhObcHQBRLSWFdytpKES5Us09VbCUCMB0t6xiidr9Oy-x2V8iscs11HZPOipW2DjP84z5tWYgXWE99wjYrr1_19CNG0rxNJqhdcoRgQvHj6oZQsrXu5JbCoxWUEZvTEBk8qz4AirPTZfSguPW6vu_3R7K3nRt_1AhKOVORWXQ_lgH3W6YhnkIs7BG6GNLUuPJgcfZbwBMWpmXE9xc-dJv2OcwqxuKosMq4UYL1ItXnUeAJuK9J41ONKPqXaTz679_cATLiUFzEabCdhR4hFrynEjZ4K6lCxe_ubZDx5e8cU0sJ8jRvi50UNHiTedx4dtgTJvu-lSmNj55kurvgO3-qd1ks2_zgn3tl5wpO8PujnDeqXHwxVbIwjOuiDBnd-lJlK7wy-gZxF0R_edou9UTSyDAuHd5X2EKgvM4ykg6OnViciXwC5U-DGMhJVDjNpPizQFPiyCaIIwcIGu0kfImlB_S6j4Hf_gfEI868Z4nTdNQUk8A4iP077ukhsbH-ZVKIvix0_XtxXkMT_Y4TPC-rrLUi18zFXbo6IpCrHw7ybMBnLKp1ZcnEl8ghJYLsB4SAqEC5hQOWdsstNxAq2ROqFC3hGETfJ834knElvPgTueHTHw1UGyRwM2c=w1454-h969-no) + +- Stop laughing at the names already. +- More importantly, the insertion step should be done **very gently**. These parts are quite delicate. Take your time and don't bend things unnecessarily. + +## Step X: Insert scroll wheel into scroll wheel holder + +**TODO photo of scroll wheel in scroll wheel holder assembly** + +After the scroll wheel is inserted, gently give the scroll wheel a spin. It should spin freely with no resistance. If there is resistance, take a screwdriver and hollow out a bit of material from the scroll wheel holder until there is no resistance. Be careful, though: if the fit is too lose, the scroll wheel will jostle during regular use. + +## Step X: Prepare printed circuit board + +**TODO photo of PCB and completed scroll wheel assembly** + +Prepare the following components: + +- Printed circuit board +- Completed scroll wheel assembly + +## Step X: Insert scroll wheel holder holder into printed circuit board + +**TODO photo of scroll wheel and scroll wheel assembly inserted into PCB** + +- **Ensure that the plastic part is oriented correctly** +- The plastic part requires a bit of force to get into the PCB; be careful not to damage the electronics assembly +- Press the plastic part on its edges, NOT the middle, as you may break the part if you depress the middle too hard +- *Note*: Once you've finished building the trackball, if the wheel is spinning poorly or sticking in some places, then it's probably because the scroll wheel holder holder isn't flush against the PCB. All kits come with a spare scroll wheel holder holder, so try replacing it and see if that fixes the issue. + +## Step X: Prepare base + +**TODO photo of completed printed circuit board and completed base** + +Prepare the following components: + +- Printed circuit board +- Base +- 2x screw + +# STOP! + +The next step is inserting the printed circuit board into the base. This is a very difficult step. It is easy to screw up. **Make sure that you read the instructions for the next step FULL AND COMPLETELY before doing anything.** + +## Step X: Insert printed circuit board into base + +**TODO photo of PCB bent and inserted into base, without screws applied yet** + +**TODO make video of PCB insertion step** + +- Watch the video for guidance on how to insert the PCB. +- Yes, you'll be bending the PCB in a pretty crazy angle. The PCB has been specially designed to allow this. +- **Go. Slowly.** + +## Step X: Screw printed circuit board into base with one screw + +**TODO photo of screw inserted into base that's flat** + +## Step X: Screw printed circuit board into base with other screw + +**TODO photo of screw inserted into base that's vertical** + +**Whew! Hard part is done. Time to relax.** + +## Step X: Prepare primary and secondary buttons + +**TODO photo of all listed components** + +Prepare the following components: + +- Base +- Primary buttons +- Secondary buttons +- Scroll wheel grabber +- 2x screw + +## Step X: Screw secondary buttons into base + +**TODO photo of secondary buttons screwed into base** + +## Step X: Screw primary buttons into base + +**TODO photo of primary buttons screwed into base** + +## Step X: Press scroll wheel grabber onto printed circuit board + +**TODO photo of scroll wheel grabber attached to PCB** + +- Make sure that the scroll wheel is threaded into the scroll wheel grabber +- The scroll wheel should not be interfering with the primary buttons in any way; if you spin the scroll wheel and feel resistance, try gently moving the scroll wheel grabber until there is no more resistance + +## Step X: Prepare top for final assembly + +**TODO photo of all components listed below** + +Prepare the following components: + +- Base +- Top +- 4x screw +- 4x friction pads + +## Step X: Place top onto base + +**TODO photo of top placed onto base** + +The top should slide onto the base without any force required at all. You might have to push it down **a little tiny bit**, but if you have to bend things hard, something is wrong. Go back a few steps and see if anything is missing or misaligned. + +## Step X: Screw top into base + +**TODO photo of screws applied to base** + +## Step X: Apply friction pads to base + +**TODO friction pads applied to base** + +## Step X: Prepare bearing press jig +![](https://lh3.googleusercontent.com/pw/ACtC-3fcHifwU-lceEx1MLBdimwCm6YiIihikVyH3o47rS98Kh0aqGivpEWOL1eh6f2ibLkXw1d3fMRY59Sdsr3q6CPVXu1lPp6L0VYicMQjhEkzmbeZhL7hxrkcK6QJq7s_bKvyd2hAVz7fV529o8yORZbG=s969-no?authuser=0) + +Prepare the following components: + +- Bearing press jig +- 3x roller bearing +- 3x roller bearing dowel + +The bearing press comes in official Ploopy kits only. + +## Step X: Insert roller bearing and roller bearing dowel into bearing press jig +![](https://lh3.googleusercontent.com/pw/ACtC-3fRT6fulgpn47hSmfqh7kCG2iNbNzv_x9CD6Zf1nxVRncDQu5ytk1cDuZFMIYnj_wwY0HwsVe3UukCv6-x9x2GiOXHWvwtCeBj57Src-WgTk7csrvDrtiUCFy6ahzs6LfD9mK1mJ34lM7AamE3TEte2=s969-no?authuser=0) + +## Step X: Press the bearing press jig together +![](https://lh3.googleusercontent.com/pw/ACtC-3d8_AnAnkjIbIy7z6Q8JS7EZJ8dG0vs0KRHT8hP5Rz-Dxz9qb992tmbLi10SfHgHt7-vNjDeKbpwyhoTiD8J3Tb9qNSTWhlCfKPTFQv-HdQ2HCkcNNwnsLWk5u_mlPgqrjlei9TVceGlfCAmZrfqRcK=s969-no?authuser=0) + +This may require a surprising amount of force. Try your best not to bend the roller bearing dowel, but if you do, there should be spares with your kit parts. + +## Step X: Remove bearing from bearing press jig and repeat +![](https://lh3.googleusercontent.com/tDT3xaB105S_s87Qs_729WFTWj3YVGqZBMyM6iDCvnXjb93gdMC2k8QVjuNm4xRo3OSPbs94wE8G5tSKz1lqxZZ5-lh6UbCnuZe-MK3Kw9_pmYj7oO-aeVz_lP5aVHtzvQfxXNqiQHqFckddRPZ7VWgzCURwY6DpRRASEitkvFmKcn7hbTt7kUHNXZXzxy1Q85U6vun5VZ54P84xDU0AASsqPj1Sfo1P1E83_K9xhSASliFd4qUPL03XtejmRMNGbASAVO8zUBVn6qWFMMgayJRpsnYq225TEktqEpgv4raeZYyNVhL2YepfmQtKoReyFExeRNz5oGlZ_1_iae8KhKnmK5ZHMyTMw_sNZxUyghzEZFbSMm4WZmmP96-XFdSv8IPMjv1CdUFhDpP6b1d8i_jpPMLMG0aFzMoRkyX_rh_DVdpG-CoM8lZlMsRwT2vy5H_Mrju9At7a2Vn-8OcLs9hELAUmqgOrlJqwhCLgJIHXSz_XuLG6RlBsJFUvVIGreR_8YOS84lU0DatIqockhYvJ9leT-xbO6w4AAdo6da0DMW818BTXIWRd3CkjlZjSsOjymYaTJSu6U-doglnrrqr51DS-OgIfZyq91sJucVUwqT3Ow5oQNEz3bMi55IMBPmDCaZGBjtPXv2GHKi1JS3S3DLBxBqjAz4_rcqw8JLPRsrGSZZjimy4oNaNOUklme6bmEeaBL7sQ3AkBsnBNFKKWD2uyHxDNFZuQxT66FmiCf3M=w1454-h969-no) + +At the end, all of your bearings should look like this. + +## Step X: Insert roller bearings into top +![](https://lh3.googleusercontent.com/XnP0djOr1WwefBp4rDly1YdNyW2AQhd-coKtscZKv4xwLYQmJh_O-Yihrh0kl4qVAVJzwqvUfclbO-AARVt4Oj-sKAitXEjXrTa9eQkSTTAPYWJnLc7gkS8j-tN1GtmaKbSNINXwkJ6ZZMrajByS7vWSRSjNuC8hHUd_JKAmnY9irJVoUA94iEWYrB4KBVxBaU0esIEXEof3rUggpv_uvVDYDBlDYpmaFRC0tnzvHJRxh-NW0WDAP2H9yjmCHNOmo04t-DF5EK2o4DYGlYeZ-amr1TsrGEmFdWtrc61bnUenfm0Ulv03gWHOZauP4YzcY2UQReYbF-dNYhlvbFwStHIYuEG4NqCsLKivuc42vBo89eCMaUe34BptrLVSyakLd0pp4gIjZql1-fCpfeGk4Gql2eRTs9QVwKzJsBwZdpzvZLcKFdvOpXAkSpD-GL50yMmYE74fzZa5wMb_8JUfeaLCtKLGSdMXIuDj7CgYarGZHs0hIhD-ACPOcFSUXrhXLrK4qHVwiHV3OXJ99RrEamD6_zqgOKKweBi3jInbRoLBHl9HRzRL9QureF2lYC0jbQuoM6jrkkHSKEcjGtVyIJyOfErP4hwQwMo2PbWC-OmimmXa6t3s9LkQxW-vgFXw4GfPPEDDSHsh99zX4VRnrvDOXaqatlAfMJVqVTLfOBUb8dkteuhFbpbdQH0xvRvradtn3gbNgk3ScUEUsCPk_RUCHkUBFVKLJzOjqXzPIXoa03s=w1454-h969-no) + +- Ensure that the bearings are pressed all the way into the case. If the bearings aren't seated all the way, there's a good chance that the ball will become badly scratched. +- Needle nose pliers or some similar tool can be used to ensure that the bearing is fully seated. + +## Step X: Insert the ball + +**TODO photo of ball in top** + +Depending on slight size variations, you might need to push the ball in with some force, but it shouldn't require a large amount of force. + +## Step X: Verify that the Ploopy Mini Trackball is working correctly + +Plug the trackball into your computer. The buttons should be clicking, and if you move the ball, it should move the cursor. + +If the buttons are stuck, take the top off and adjust the primary and secondary buttons by rotating them slightly in their bases and trying again. + +## Step X: Spin the ball to break in the bearings + +The bearings are a bit scratchy when they're new. To prevent them from jumping around during initial use, spin the ball with some Latin dance vigour for about three minutes. That should be enough to break them in. + +The bearings will take about a week to become fully broken-in. + +## Step X: All done! + +Congrats, you finished building the Ploopy Mini Trackball! + +It's done! Love it, use it, but don't you dare abuse it! \ No newline at end of file