Fix typos in Readme.md

This commit is contained in:
2025-09-15 12:10:26 +00:00
parent 6e6355ae43
commit 4f670beed8

View File

@@ -78,7 +78,7 @@ This is meant to provide a minimal starting point for further development with t
| Resistors (10kΩ) | 3 or 4 | Pull-down resistors for buttons | | | Resistors (10kΩ) | 3 or 4 | Pull-down resistors for buttons | |
| Wires | Several | Thin wires for connections | | | Wires | Several | Thin wires for connections | |
| Enclosure | 1 | 3D-printed case | 3D printable STL files are in `hardware/case/` | | Enclosure | 1 | 3D-printed case | 3D printable STL files are in `hardware/case/` |
| 2x6mm screw | 8 | Small screws for seembling the case | Does not have to be exactly 6mm long | | 2x6mm screw | 8 | Small screws for assembling the case | Does not have to be exactly 6mm long |
| 2x2mm screw | 4 | Small screws for the front | Mostly for cosmetic purposes | | 2x2mm screw | 4 | Small screws for the front | Mostly for cosmetic purposes |
![layout](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/layout.jpg) ![layout](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/layout.jpg)
@@ -86,8 +86,11 @@ This is meant to provide a minimal starting point for further development with t
--- ---
## Assembly Instructions ## Assembly Instructions
---
1. **Body**
Push the ESP8266 microcontroller in the ledge on the bottom [the cube body](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/case/SmartCube_Body_3_button.stl), it should 'click in' with the USB-C port facing the hole.
1. Push the ESP8266 microcontroller in the ledge on the bottom [the cube body](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/case/SmartCube_Body_3_button.stl) it sould 'click in' with the USB-C port facing the hole.
Body with 3 or 4 button slots is available in the `hardware/case/` Body with 3 or 4 button slots is available in the `hardware/case/`
![Step3](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build3.jpg) ![Step3](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build3.jpg)
@@ -96,11 +99,15 @@ Body with 3 or 4 button slots is available in the `hardware/case/`
![Step2](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build2.jpg) ![Step2](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build2.jpg)
2. **Buttons**: You can glue in the buttons to the top slots at this step and solder the resistors to them. ---
2. **Buttons**
You can glue in the buttons to the top slots at this step and solder the resistors to them.
![Step4](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build4.jpg) ![Step4](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build4.jpg)
Solder all of the button outputs to the microcontroller: Solder all of the button outputs to the microcontroller:
Pin numbers for buttons and other stuff is defined in the [example config](https://git.kopic.hr/tomislav/SmartCubeV1/src/branch/main/src/example_config.h) and the schematic for the [D1 Mini is here](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/schematics/esp8266.png): Pin numbers for buttons and other stuff is defined in the [example config](https://git.kopic.hr/tomislav/SmartCubeV1/src/branch/main/src/example_config.h) and the schematic for the [D1 Mini is here](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/schematics/esp8266.png):
You don't have to follow my pin definition exactly but I find this the easiest way to assemble and fit everything in. 3 Button variant is the standard. If you are gonna go with the 4 button variant you will need to define this yourself. You don't have to follow my pin definition exactly but I find this the easiest way to assemble and fit everything in. 3 Button variant is the standard. If you are gonna go with the 4 button variant you will need to define this yourself.
@@ -112,13 +119,16 @@ You don't have to follow my pin definition exactly but I find this the easiest w
![Step5](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build5.jpg) ![Step5](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build5.jpg)
3. **OLED Display**: Crew in the 2x2mm screws and glue the SSD1306 to the [front part of the cube](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/case/SmartCube_Front.stl) solder the 4 wires to the OLED display, make sure you have some extra lenght, 4-5cm sould be more than enough ---
3. **OLED Display**
Screw in the 2x2mm screws and hot glue the SSD1306 to the [front part of the cube](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/case/SmartCube_Front.stl) solder the 4 wires to the OLED display, make sure you have some extra length, 4-5cm should be more than enough
![Step6](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build6.jpg) ![Step6](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build6.jpg)
![Step7](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build7.jpg) ![Step7](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build7.jpg)
The OLED display must to be connected via I2C on pins: The OLED display must be connected via I2C on pins:
- **SDA**: D2 (GPIO4) - **SDA**: D2 (GPIO4)
- **SCL**: D1 (GPIO5) - **SCL**: D1 (GPIO5)
- **GND**: GND - **GND**: GND
@@ -126,15 +136,24 @@ The OLED display must to be connected via I2C on pins:
![Step8](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build8.jpg) ![Step8](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build8.jpg)
4. **Buzzer**: Glue in the buzzer to the [back part of the cube](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/case/SmartCube_Back_Speaker_Side_Hole.stl) ---
4. **Buzzer**
Glue in the buzzer to the [back part of the cube](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/case/SmartCube_Back_Speaker_Side_Hole.stl) with superglue
As defined in the [example config](https://git.kopic.hr/tomislav/SmartCubeV1/src/branch/main/src/example_config.h) connect:
- the positive wire of the buzzer to the 3.3V
- the negative wire to PIN_BUZZER (D3) GPIO0
![Step9](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build9.jpg) ![Step9](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/build9.jpg)
---
5. **Power Supply Setup**: 5. **Power Supply Setup**:
- Battery is not required and you can skip this step if you want to but it is much cuter when it's portable. A single 700mAh 14250 lasts about 24 hours.
Battery is not required and you can skip this step if you want to but it is much cuter when it's portable. A single 700mAh 14250 lasts about 24 hours.
- Solder the 14250 battery to the TP4056 module input pins. - Solder the 14250 battery to the TP4056 module input pins.
- Wire the output of the TP4056 to the **3.3V pin** on the D1 Mini to power the device. - Wire the output of the TP4056 to the **3.3V pin** on the D1 Mini to power the device.
- Connect the **5V output pin** from the D1 Mini to the **input port** on the TP4056 module to allow charging trough the Data USB port on the ESP8266. - Connect the **5V output pin** from the D1 Mini to the **input port** on the TP4056 module to allow charging through the Data USB port on the ESP8266.
![batt1](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/batt1.jpg) ![batt1](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/batt1.jpg)
@@ -148,10 +167,11 @@ The OLED display must to be connected via I2C on pins:
- This is still a work in progress - This is still a work in progress
- Everything is pretty tightly packed in there and it's a mess. But it's not as hard to make as it looks. - Everything is pretty tightly packed in there and it's a mess. But it's not as hard to make as it looks.
![Packed](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/IMG_20241213_171725.jpg) ![Packed](https://git.kopic.hr/tomislav/SmartCubeV1/raw/branch/main/hardware/pictures/IMG_20241213_171725.jpg)
- Ensure all connections are secure. Hot glue is your friend. - Ensure all connections are secure and isolated. Hot glue is your friend.
- Test the circuit thoroughly before placing and glueing it in the enclosure. - Test the circuit thoroughly before placing and gluing it in the enclosure.
- Battery is the trickiest part to fit in, it's best to glue the charging module directly to it and put it in the case last - Battery is the trickiest part to fit in, it's best to glue the charging module directly to it and put it in the case last
For questions or additional details, feel free to reach out! I would love to hear some feedback. For questions or additional details, feel free to reach out! I would love to hear some feedback.