Skip to content

Conversation

@oEnzoRibas
Copy link
Member

@oEnzoRibas oEnzoRibas commented Aug 7, 2025

This pull request introduces comprehensive introductory documentation for several key hardware components and concepts relevant to robotics and electronics projects. The main focus is on providing clear, beginner-friendly overviews and practical guidance for components such as buttons, LEDs, motors, potentiometers, power systems, as well as foundational topics like CAD and 3D printing. Additionally, curated tutorial links are provided for hands-on learning.

Component Overviews and Technical Explanations:

  • Added detailed, beginner-friendly explanations for the following components:
    • Buttons and switches, including pull-up/pull-down resistors, debouncing, and wiring best practices (hardware_guide/Components/Buttons/overview.md)
    • LEDs, covering polarity, current-limiting resistors, and types of LEDs (hardware_guide/Components/LEDs/overview.md)
    • Motors, with types (DC, servo, stepper, brushless) and the necessity of motor drivers (hardware_guide/Components/Motors/overview.md)
    • Potentiometers, describing their function, wiring, and usage as voltage dividers and rheostats (hardware_guide/Components/Potentiometers/overview.md)
    • Power system essentials for robotic arms, including sources, regulators, and distribution (hardware_guide/Components/Power/overview.md)

Foundational Concepts:

  • Introduced a general overview of 3D printing technologies, materials, and workflow (hardware_guide/Archtecting/3D Printing/overview.md)
  • Added an introductory guide to Computer-Aided Design (CAD), its importance, and project file organization, with a focus on Fusion 360 (hardware_guide/Archtecting/CAD/overview.md)

Tutorial and Learning Resources:

  • Provided curated tutorial links for practical learning:
    • Buttons and switches (hardware_guide/Components/Buttons/tutorials.md)
    • LEDs (hardware_guide/Components/LEDs/tutorials.md)
    • Motors (hardware_guide/Components/Motors/tutorials.md)
    • Potentiometers (hardware_guide/Components/Potentiometers/tutorials.md)
    • CAD (Tinkercad Circuits) (hardware_guide/Archtecting/CAD/tutorials.md)

These changes significantly improve the accessibility and educational value of the hardware guide for new team members and beginners.

Introduced comprehensive documentation for Arduino Uno, ESP32 (including ESP32-CAM), and Raspberry Pi. Added introductory guides, programming instructions, basic code examples, and hardware overviews for each platform to support new users and streamline onboarding.
Added overview documentation for buttons, LEDs, motors, potentiometers, and resistors in the Components section. Introduced Raspberry Pi 4 Model B documentation, including basic Python GPIO examples, and added an overview for Raspberry Pi Zero 2 W. These additions expand the hardware guide with foundational reference material for common electronic components and Raspberry Pi boards.
Added new tutorial markdown files for various hardware components (Buttons, LEDs, Motors, Potentiometers, Resistors, Sensors) and microcontroller/computer boards (Arduino Uno, ESP32, Raspberry Pi 4, Raspberry Pi Zero 2 W). Included detailed example projects and code for Arduino, ESP32, and Raspberry Pi platforms. Removed old Raspberry Pi Zero 2 W overview and .keep files, replacing them with updated overview and tutorial content.
Renamed and relocated hardware guide documentation files from the '3D/hardware_guide' directory to 'hardware_guide' to simplify the directory structure and improve organization. No content changes were made to the files.
Renamed and reorganized various 3D model and documentation files from the root 3D directory into the Projects/3D directory structure for better organization and clarity.
Introduced overview and tutorial markdown files for 3D Printing, CAD, Power, Screens, Sensors, and Servos in the hardware guide. Expanded and updated tutorial links for Buttons, LEDs, Motors, Potentiometers, Resistors, and Sensors. Added a practice guide for servos with example Arduino code. These additions provide structured documentation and learning resources for hardware components in the project.
Removed redundant and outdated tutorial files for Arduino, ESP32, and Raspberry Pi boards. Consolidated and updated tutorial links in central 'tutorials/tutorials.md' files for Arduino and ESP32, and updated the ESP32-CAM pinout image. This improves organization and ensures up-to-date resources are provided.
Introduces a README file in the hardware_guide directory, providing an overview of electronic components, microcontrollers, computers, and architecting tools used in the Atom Project. This guide is intended to help newcomers understand the project's hardware ecosystem and navigate related documentation.
Added circuitDiagram.png to the media directory and updated the tutorials.md file to reference the local image instead of an external URL. This improves documentation reliability and ensures the diagram is available offline.
@github-actions
Copy link

github-actions bot commented Aug 7, 2025

Validation Failed!

The branch name and PR title must follow the ATOM-HW- pattern.

  • Ensure the branch name starts with ATOM-HW-.
  • Ensure the PR title contains ATOM-HW-.

Please adjust and try again. Thank you!

@oEnzoRibas oEnzoRibas changed the title Atom hw documentacao componentes refactor(ATOM-HW-1): Creates Hardware Guide section Aug 7, 2025
@oEnzoRibas oEnzoRibas self-assigned this Aug 7, 2025
@oEnzoRibas oEnzoRibas added the duplicate This issue or pull request already exists label Aug 7, 2025
@oEnzoRibas oEnzoRibas added documentation Improvements or additions to documentation help wanted Extra attention is needed labels Aug 7, 2025
Copy link

@pedrolucasvsr pedrolucasvsr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Todos os links funcionando, seria bom ordená-los em tópicos (no momento estão alinhados).

Nos arquivos abaixo há imagens que não foram carregadas:

  • hardware_guide/MicroControllers_Computers/Arduino/arduinoUno/basicExemples.md/tutorials.md
  • hardware_guide/MicroControllers_Computers/Arduino/arduinoUno/overview.md
  • hardware_guide/MicroControllers_Computers/ESP32/ESP32CAM/overview.md

@oEnzoRibas
Copy link
Member Author

oEnzoRibas commented Sep 2, 2025

Todos os links funcionando, seria bom ordená-los em tópicos (no momento estão alinhados).

Nos arquivos abaixo há imagens que não foram carregadas:

  • hardware_guide/MicroControllers_Computers/Arduino/arduinoUno/basicExemples.md/tutorials.md
  • hardware_guide/MicroControllers_Computers/Arduino/arduinoUno/overview.md
  • hardware_guide/MicroControllers_Computers/ESP32/ESP32CAM/overview.md

Bom dia, @pedrolucasvsr ! Você abriu o arquivo por onde?

O melhor é sempre clonar o repositorio para revisar. Mas mesmo no github web as imagens aparecem.

image image image

@oEnzoRibas oEnzoRibas merged commit a703a07 into main Sep 2, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation duplicate This issue or pull request already exists help wanted Extra attention is needed

Projects

None yet

4 participants