Project Structure

This guide explains the organization of the Moto32 repository and where to find specific files for your project.

Repository Overview

The Moto32 project is hosted on GitHub with all design files, documentation, and firmware organized for easy access:

motogadget-clone/
├── 3D File/
│   └── 3D_File.step
├── BOM and Pick N Place/
│   ├── BOM_Canarin_MUX.csv
│   └── PickAndPlace_PCB_Canarin_MUX.csv
├── EasyEDA Source Files/
│   └── [EasyEDA project files]
├── Schematics/
│   └── Schematic_Canarin_MUX.pdf
├── Gerber_Canarin_MUX_PCB.zip
├── How to Order.txt
├── LICENSE
├── PCB.png
├── PCB_BOTTOM.png
├── PCB_TOP.png
├── Photo-View_PCB.svg
├── README.md
└── scheme.png

Directory Structure

📂 3D File

Contains 3D models for mechanical design and enclosure development.

Files:

• 3D_File.step - Complete PCB 3D model in STEP format

Use Cases:

• Design custom enclosures
• Check component clearances
• Verify mounting hole positions
• Integration with motorcycle CAD models
• 3D printing mounting brackets

📂 BOM and Pick N Place

Manufacturing data for PCB assembly.

Files:

• BOM_Canarin_MUX.csv - Bill of Materials with part numbers
• PickAndPlace_PCB_Canarin_MUX.csv - Component placement coordinates

BOM Contents:

• Component designators (R1, C2, U1, etc.)
• Component values (10kΩ, 100nF, etc.)
• Package sizes (0402, 0603, SOT-23, etc.)
• Manufacturer part numbers
• Supplier (LCSC) part numbers
• Quantity required
• Unit prices

Pick & Place Contents:

• X/Y coordinates for each component
• Rotation angles
• Component layer (top/bottom)
• Reference designators

Use Cases:

• Order components from distributors
• Request assembly quotes from PCB manufacturers
• Configure automated pick-and-place machines
• Verify component inventory before assembly
• Cost estimation for production runs

📂 EasyEDA Source Files

Editable PCB design files in EasyEDA format.

Contents:

• Schematic source files
• PCB layout source files
• Component library files

Use Cases:

• Modify the PCB design
• Add new features or outputs
• Change component footprints
• Create custom variants
• Learn PCB design techniques

Editing Instructions:

1. Create free account at EasyEDA
2. Import the project files
3. Make your modifications
4. Export new Gerber files
5. Generate updated BOM and Pick & Place

📂 Schematics

Complete circuit diagrams in PDF format.

Files:

• Schematic_Canarin_MUX.pdf - Full schematic (all pages)
• scheme.png - Schematic preview image

Schematic Sections:

• Power supply (12V to 3.3V conversion)
• ESP32-S3 module connections
• USB-UART interface (CH340C)
• 8x MOSFET output stages
• Protection circuits (TVS, fuses)
• Input conditioning
• Programming interface

Use Cases:

• Understanding circuit operation
• Troubleshooting issues
• Planning modifications
• Educational reference
• Repair and maintenance

📦 Gerber Files

Manufacturing files for PCB fabrication.

File:

• Gerber_Canarin_MUX_PCB.zip - Complete Gerber package

Gerber Package Contents:

Gerber_Canarin_MUX_PCB.zip
├── Copper layers (.GTL, .GBL, .G2, .G3)
├── Soldermask layers (.GTS, .GBS)
├── Silkscreen layers (.GTO, .GBO)
├── Paste layers (.GTP, .GBP)
├── Board outline (.GKO)
├── Drill files (.TXT, .DRL)
└── NC Drill file

Use Cases:

• Order PCBs from any manufacturer
• Verify layer stackup
• Check trace widths and clearances
• Generate fabrication drawings
• Quality control and inspection

Ordering: Simply upload Gerber_Canarin_MUX_PCB.zip to PCBWay, JLCPCB, or any PCB manufacturer. Most will auto-detect specifications.

Image Assets

PCB Renders

Visual references for PCB appearance and component placement.

Files:

• PCB.png - Isometric PCB render
• PCB_TOP.png - Top view of assembled PCB
• PCB_BOTTOM.png - Bottom view of assembled PCB
• Photo-View_PCB.svg - Vector graphic PCB view

Use Cases:

• Assembly reference during soldering
• Documentation and presentations
• Website and social media sharing
• Verify component orientation
• Educational materials

Documentation Files

README.md

Main project documentation with overview, features, and quick start guide.

Sections:

• Project overview
• Key features
• Assembly instructions
• BOM table
• Roadmap
• Sponsorship information
• License details

How to Order.txt

Quick reference for ordering PCBs from PCBWay.

Contents:

• Direct link to PCBWay project
• Recommended PCB specifications
• Assembly service options
• Tips for first-time orders

LICENSE

MIT License file - defines usage rights and restrictions.

Key Points:

• Free to use, modify, and distribute
• Commercial use allowed
• Attribution required
• No warranty provided

Firmware (Future)

Planned Structure:

firmware/
├── examples/
│   ├── basic_io_test/
│   ├── bluetooth_config/
│   └── full_featured/
├── libraries/
│   ├── Moto32/
│   └── README.md
├── platformio.ini
└── README.md

Documentation Site Structure

This documentation site (Moto32 Docs) is organized as follows:

docs/
├── 1.getting-started/
│   ├── introduction.md
│   ├── installation.md
│   ├── project-structure.md
│   └── quick-start.md
├── 2.hardware/
│   ├── pcb-overview.md
│   ├── schematics.md
│   ├── bill-of-materials.md
│   ├── assembly.md
│   └── 3d-models.md
├── 3.firmware/
│   ├── getting-started.md
│   ├── configuration.md
│   ├── features.md
│   └── api-reference.md
├── 4.assembly/
│   ├── soldering-guide.md
│   ├── testing.md
│   └── motorcycle-installation.md
├── 5.usage/
│   ├── basic-operation.md
│   ├── advanced-features.md
│   └── maintenance.md
└── 6.support/
    ├── troubleshooting.md
    ├── faq.md
    └── community.md

File Formats Reference

Hardware Files

Source Files

Version Control

The project uses Git for version control:

# Clone the repository
git clone https://github.com/jaksatomovic/motogadget-clone.git

# Check for updates
git pull origin main

# View commit history
git log --oneline

# See what changed in latest version
git show HEAD

Branches:

• main - Stable releases
• develop - Active development (coming soon)
• feature/* - New features (coming soon)

Contributing

If you want to contribute to the project:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
5. Document your changes

See the Contributing Guide for details.

File Naming Conventions

The project follows these naming conventions:

Hardware Files:

• Gerber_Canarin_MUX_PCB.zip - Gerber package
• Schematic_Canarin_MUX.pdf - Schematic PDF
• BOM_Canarin_MUX.csv - Bill of materials
• PickAndPlace_PCB_Canarin_MUX.csv - Pick and place

Visual Assets:

• PCB.png - Main PCB render
• PCB_TOP.png - Top view
• PCB_BOTTOM.png - Bottom view
• scheme.png - Schematic preview

Finding What You Need

Quick Reference:

Next Steps