Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/timhanewich/pyper
Python-based 3D-Printed Electric Rover
https://github.com/timhanewich/pyper
3d-printing micropython pico python rc rc-car rover
Last synced: about 1 month ago
JSON representation
Python-based 3D-Printed Electric Rover
- Host: GitHub
- URL: https://github.com/timhanewich/pyper
- Owner: TimHanewich
- License: other
- Created: 2023-12-04T02:25:59.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-09-16T15:07:20.000Z (3 months ago)
- Last Synced: 2024-09-17T18:14:33.312Z (3 months ago)
- Topics: 3d-printing, micropython, pico, python, rc, rc-car, rover
- Language: Python
- Homepage:
- Size: 166 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license.txt
Awesome Lists containing this project
README
# PYPER - **Py**thon-Based 3D-**P**rinted **E**lectric **R**over
**PYPER** is a **Py**thon-based, 3D-**P**rinted, **E**lectric **R**over.
I designed PYPER from scratch from the ground up - I used [Blender](https://www.blender.org/) for 3D-modeling of the chassis, steering mechanism, and drivetrain, printed [the parts](https://www.thingiverse.com/thing:6352166) on my [Creality Ender 3 3D Printer](https://www.creality.com/products/ender-3-3d-printer), designed the [electrical circuitry](wiring.drawio), and wrote [the code](./src/) that coordinates its driving mechanics.
The project is fully open source under the [**Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International** license](https://creativecommons.org/licenses/by-nc-sa/4.0/). The source code that runs on an onboard Raspberry Pi is available [here](./src/) and the 3D-printed parts (.stl files) can be found [on Thingiverse here](https://www.thingiverse.com/thing:6352166).
### PYPER Specifications
- **Weight**, fully assembled: 23g
- **Dimensions**: 173x213x76 mm (WxLxH)
- **Gear Ratio**: PYPER uses a **48:1** [TT motor](https://www.amazon.com/gp/product/B09N6NXP4H/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1) (*please note that, while the title of this product on Amazon states it is a 1:48 ratio, [it is actually a 48:1 (reduction) gear ratio](https://www.reddit.com/r/MechanicalEngineering/comments/19cmjpy/do_these_amazon_sellers_have_their_gear_ratios/)*) against a **4:5** 3D-printed compound gear system I developed. [This graphic](https://i.imgur.com/Yiz39RH.png) helped me calculate this ratio:
- Teeth on motor gear (gear attached to TT motor, receiving rotational input): **15**
- Teeth on mid-axle gear (intermediary between motor gear and final drive shaft): **24**
- Teeth on drive shaft gear: **12**
- Motor Gear to Mid-Axle Gear ratio (driven / driving) = **24/15** = **24:15**
- Mid-Axle Gear to Drive Shaft Gear ratio (driven / driving) = **12/24** = **12:24**
- Ratio of **PYPER's 3D-printed** combined gear system = **24/15** * **12/24** = **288/360** = **4/5** = **4:5**
- This can be interpretted as: *for every 4 turns the motor gear makes (powered by the motor), the final drive shaft will rotate 5 times*.
- Thus, PYPER's gear system actually *speeds up* the TT motor (gains speed, loses torque) a little bit.
- Altogether, combining the **48:1** ratio of the TT motor against the **4:5** ratio of PYPER's fixed 3D-printed gear system, PYPER has a **192:5** gear ratio.
- This means that pairing PYPER's 3D-printed gear system to the TT motor *speeds up* the TT motor slightly, gaining speed, but losing torque (going from gear ratio of **48.0** to **38.4**).
## Why I Designed PYPER
I built PYPER to demonstrate the essential components required to build a *basic* RC car: a steering mechanism and a mid-mounted motor delivering power to the rear wheels through a multi-gear drivetrain. While many other models you can find online are very impressive, they tend to be overly complex and advanced, posing challenges for beginners to mechanical engineering to understand.
In contrast, PYPER is intentionally designed to be straightforward, accessible, and approachable for *anybody*. So, for the sake of learning, I describe PYPER and its systems (steering, drivetrain, code, etc.) below in detail.
I hope you can learn from PYPER and uses these ideas in your own projects.
## How to Assemble PYPER
You can watch the video below to see PYPER being built from the 3D-printed parts below, from the ground up. Click the image below to watch!
[](https://youtu.be/q6Mk3VrJAHo)
## Parts List: What You Need to Build PYPER
PYPER is fully open source, everything you need to build one is available here. These are the parts used in PYPER, if you choose to build a PYPER yourself or repurpose these ideas in your own design:
|Part|Cost (USD)|
|-|-|
|~110g of [PLA filament](https://www.amazon.com/gp/product/B0BM73MC94/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&th=1) (20% infill used)|$1.76|
|1 [Raspberry Pi Pico W](https://www.raspberrypi.com/documentation/microcontrollers/raspberry-pi-pico.html)|$6|
|1 [SG90 Servo Motor](https://www.amazon.com/Smraza-Helicopter-Airplane-Control-Arduino/dp/B07L2SF3R4/ref=sr_1_5?crid=25A4PZW1IX6Z4&keywords=sg90%2Bservo&qid=1701686041&sprefix=sg90%2Bse%2Caps%2C111&sr=8-5&th=1)|$1.88|
|1 [TT Motor](https://www.amazon.com/gp/product/B09N6NXP4H/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)|$1.47|
|1 [1S Lithium Polymer Battery](https://www.amazon.com/gp/product/B07L9SHHFX/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)|$6.42|
|1 [MT3608 DC-DC Boost Converter](https://www.amazon.com/Converter-Adjustable-Voltage-Regulator-Compatible/dp/B089JYBF25/ref=sr_1_3?crid=FGQJZDRRPHZN&keywords=mt3608&qid=1701686153&sprefix=mt3608%2Caps%2C96&sr=8-3)|$0.90|
|8 [MR115-2RS (5x11x4mm) Bearings](https://www.amazon.com/gp/product/B07X6DK946/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)|$4.27|
|1 [L293D DC Brushed Motor Driver](https://www.amazon.com/gp/product/B077TY21T7/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&th=1)|$1.25|
|1 [Small Breadboard](https://www.amazon.com/gp/product/B07LFD4LT6/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&psc=1)|$1.71|
|22 [M2 and M3 Screws, Bolts, Washers (see below)](https://www.amazon.com/gp/product/B07FCDL2SY/ref=ppx_yo_dt_b_asin_title_o00_s00?ie=UTF8&th=1)|< $2.00|
|Misc Wires|< $1.00|
Part costs to build PYPER: **roughly $28.66**.
## PYPER's 3D-Printed Parts Explained
All of the 3D-printed parts needed to make PYPER are available [on Thingiverse](https://www.thingiverse.com/thing:6352166) for free. Each part and its role is described below:
|Image|Part|Function|Role|
|-|-|-|-|
||base.stl|chassis|The platform everything is built on top of|
||wheel_front.stl|chassis|The two front wheels to the rover. PYPER's design requires two of these.|
||wheel_rear.stl|chassis|The two rear wheels to the rover. PYPER's design requires two of these.|
||hubcap_front.stl|chassis|Hubcap for the front wheels. PYPER's design requires two of these.|
||hubcap_rear.stl|chassis|Hubcap for the rear wheels. PYPER's design requires two of these.|
||steering_upright_right.stl|steering|Mounting the front right wheel to this allows the wheel to "pivot" to accommodate a steering angle, controlled by the servo|
||steering_upright_left.stl|steering|Mounting the front left wheel to this allows the wheel to "pivot" to accommodate a steering angle, controlled by the servo|
||tie_rod.stl|steering|Ties the two steering uprights together, mechanically linking them together with the servo, allowing the servo to manipulate the uprights|
||tt_frame.stl|drivetrain|A frame that fits around the TT motor so it can be mounted to the chassis (base)|
||motor_gear.stl|drivetrain|Fits snuggly around the TT motor's axle, transferring its torque into the drivetrain. PYPER's design requires two of these.|
||mid_axle_gear.stl|drivetrain|Meshes against the **motor_gear.stl**, being driven by the motor gear. PYPER's design requires two of these.|
||mid_axle.stl|drivetrain|Serves to hold two mid axle gears in place along their axis, allowing them to spin freely. **I recommend printing this at 100% infill to make it stronger**. I have had issues with it snapping at 20% infill.|
||mid_axle_mount.stl|drivetrain|Holds the **mid_axle.stl** in place securely, allowing the mid axle gears to mesh with both the motor gears and drive axle gears. PYPER's design requires two of these.|
||drive_axle_gear.stl|drivetrain|Meshes against the two **mid_axle_gear.stl**, transfering torque to the final drive, turning the rear wheels. PYPER's design requires two of these.|
||drive_axle.stl|drivetrain|Final drive axle. Transfers torque from the two **drive_axle_gear.stl** to the rear wheels, moving the rover forward or backward|
||bearing_mount.stl|drivetrain|Holds the **drive_axle.stl** in place, meshing with the two **mid_axle_gear.stl**, and allowing it to spin freely while also supporting the weight of the chassis. PYPER's design requires two of these.|
### Visual Depictions of PYPERS Components
These visualizations can be found in [this PowerPoint deck](https://github.com/TimHanewich/PYPER/releases/download/1/visuals.pptx).
### Post-Printing
- You will need to insert a MR115-2RS (5x11x4mm) bearing into the following parts after printing. Each part is designed to accept the bearing with little friction, but you may need to use a mallet/hammer to bang the bearing in.
- `mid_axle_gear.stl`
- `bearing_mount.stl`
- `wheel_front.stl`
- After printing the gears, you may need to slightly sand down some of the teeth of each gear so they mesh well against one another.
## Screwing the 3D-Printed Parts Together
Metric screws are used in PYPER's design due to their wide availability, precision, and compatibility. The holes cut into the 3D-printed parts will fit are all intended for metric screws.
These are how many of each metric screw specification you'll need:
|Size (width*length)|Count|
|-|-|
|M3*30mm|4|
|M3*12mm|2|
|M3*8mm|4|
|M2*12mm|4|
|M2*8mm|6|
|M2*6mm|2|
These are the specific needs for these screws in PYPER's design:
- 2 M3*30mm for steering uprights
- 2 M3*12mm for steering uprights
- 2 M3*8mm for screwing front wheels in
- 4 M2*12mm for screwing in final drive bearing mounts
- 4 M2*8mm for screwing in mid axle mount
- 2 M3*30mm for screwing TT motor into TT frame
- 2 M3*8mm for screwing TT frame into base
- 2 M2*6mm for screwing in rear wheels
- 2 M2*8mm for screwing in SG90 servo to frame
## Wiring up the Electronics
PYPER uses:
- A **1S (1 cell) Lithium Polymer battery** (but this can be swapped with any battery < 5V that can provide enough current to power these electronics, which is minimal)
- A **MT3608** DC-DC converter to step up the 3.2-4.2 nominal volts of the 1 cell battery to a stable 5V
- An **L293D** brushed DC motor driver for controlling the application of electricity to the motor via the Raspberry Pi's GPIO pins
- A **1:48 gear ratio TT motor** to turn the rear wheels, moving it forward or backward
- An **SG90 servo** to actuate a steering angle
- A **Raspberry Pi Pico W** to serve as "the brain", driving PYPER around according to requests
The components should be wired together as depicted in this wiring diagram below:
The draw.io wiring diagram can be found [here](./wiring.drawio), if you'd prefer to pull up a higher-resolution version.
## Driving PYPER: Software
PYPER is drivable via an onboard Raspberry Pi Pico W which runs a web server on your local network and receives movement commands via HTTP requests. PYPER's software is written in **MicroPython** and is available in [the `src` folder here](./src/).
Before deploying this code to your own Raspberry Pi Pico W, you will need to configure a few variables in the [settings.py](./src/settings.py) module:
- `wifi_ssid`: The SSID (username) of your wifi network. The Raspberry Pi Pico will use this to connect to your wifi network and receive movement instructions via HTTP requests.
- `wifi_password`: The password to your wifi network. The Raspberry Pi Pico will use this to connect to your wifi network and receive movement instructions via HTTP requests.
- `gp_steering`: Set this to the GPIO pin (GP number, not pin number) that you are using to control the servo via the servo's signal wire. **If you used the same GP pin that I used in my code, this does not need to be changed**.
- `gp_safety`: Set this to the GPIO pin (GP number, not pin umber) that you have connected to the top-left pin of the L293D motor driver; this serves as the "safety" input (for the L293D to give any power to the motor, this must be set to a high state). **If you used the same GP pin that I used in my code, this does not need to be changed**.
- `gp_i1`: Set this to the GPIO pin (GP number, not pin number) that you are using to control one of the motor inputs (see wiring diagram). **If you used the same GP pin that I used in my code, this does not need to be changed**.
- `gp_i2`: Set this to the GPIO pin (GP number, not pin number) that you are using to control the other motor input (see wiring diagram). **If you used the same GP pin that I used in my code, this does not need to be changed**.
With the contents of the [src folder](./src/) loaded onto a Raspberry Pi Pico W (programs like **Thonny** or **rshell** can be used for this), once the Raspberry Pi Pico W is powered up, it will immediately begin to execute the code in the [main.py](./src/main.py) module. Once the onboard LED of the Raspberry Pi Pico W goes solid, this indicates it is ready to operate!
### Drive Mode
PYPER has two *operation modes*: **HTTP mode** and **UDP mode**. You can change which mode PYPER is in by changing the `operation_mode` variable in the [settings.py](./src/settings.py) module. `0` = HTTP mode, `1` = UDP mode.
Both operation modes are described in separate documention:
- [Driving PYPER in HTTP mode](./docs/http_mode.md)
- Driving PYPER in UDP mode *(coming soon!)*
## Clips from Development
I routinely took small clips during PYPER's development, demonstrating each part of the design. I'm listing them here for learning purposes, in case you want to study a specific piece:
- [Assembling 3D-printed steering system](https://www.youtube.com/shorts/D8oKYiKBxoA)
- [First demonstration of powered steering system](https://twitter.com/TimHanewich/status/1725139275988021744)
- [First prototype of TT motor mount](https://twitter.com/TimHanewich/status/1726737684020773365)
- [First drivetrain demonstration (no wheels)](https://twitter.com/TimHanewich/status/1729273808488468517)
- [Servo actuating steering angle](https://youtube.com/shorts/jCH9cWKqCqs)
- [Final steering upright design](https://twitter.com/TimHanewich/status/1730002026338066827)
- [Drive axle and mid axle attached to base](https://twitter.com/TimHanewich/status/1730595493309215170)
- [Complete drivetrain Closeup demonstration](https://youtube.com/shorts/8eYT_Qdbzhs)
## To include in project on Thingiverse:
- hardware
- ~~Total grams of filament used~~
- ~~Car weight~~
- ~~Car top speed @ 6v?~~
- ~~Cost estimate w/ parts and filament~~
- All individual parts and full assembled STL
- And how many of each part you will need to print to make the full thing
- Video putting it together?
- ~~Dimensions~~
- ~~Pictures of fully assembled~~
- Video of it working
- Explanation of each part. i.e. compare front + rear hub cap differences
- Why I made this: basic fundamentals of driving
- The type of steering system it uses
- Wiring diagram is supplied as draw.io (and add picture to readme)
- software
- how the code works
- rover control method (HTTP requests)