Skip to content

Commit 28fd2a5

Browse files
authored
chore: update readme with photos (#43)
* readme * add images * read * reade * update readme
1 parent a3a3643 commit 28fd2a5

11 files changed

+16
-13
lines changed

README.md

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ MAC of Robots (Maker Fair Rome 2024):
3535
- Davide robot: `74:4d:bd:a2:27:08`
3636
- Alessia robot:`dc:da:0c:22:eb:94`
3737

38-
NOTE: the PATCH steps `2` and `3` are no more necessary when the [Arduino_AlvikCarrier](https://github.com/arduino-libraries/Arduino_AlvikCarrier) and the [Arduino-Alvik-mpy](https://github.com/arduino/arduino-alvik-mpy) are merged to master
38+
NOTE: the PATCH steps `2` and `3` are no more necessary when the [Arduino_AlvikCarrier](https://github.com/arduino-libraries/Arduino_AlvikCarrier) and the [Arduino-Alvik-mpy](https://github.com/arduino/arduino-alvik-mpy) are merged.
3939

4040
#### Color calibration mode
4141
The robot exposes a `color calibration mode` that can be activated by pressing the `ok` button.
@@ -47,9 +47,7 @@ Steps to calibrate the robot
4747
1. Switch on the robot
4848
2. Press the `ok` button to enter into the `calibration mode`. The mode has the following light codes
4949
- WHITE leds countdown: indicate that the robot must be put on WHITE color. At the end of the countdown, the robot calibrates the WHITE color.
50-
- GREEN leds for 2 seconds: white calibration terminated
5150
- BLUE leds countdown: indicate that the robot must be put on BLACK color. At the end of the countdown, the robot calibrates the BLACK color
52-
- GREEN leds for 2 seconds: black calibration terminated.
5351
- the robot automatically reset itself.
5452

5553
### Configure the controller
@@ -58,13 +56,18 @@ Steps to calibrate the robot
5856
- Download the [Micropython Installer](https://labs.arduino.cc/en/labs/micropython-installer)
5957
- Open the installer and clik `Install Micropython` button
6058
4. `make controller-install` to install libraries into the controller
61-
5. `make controller-upload robot-mac=<PUT_THE_ALVIK_MAC_HERE>` to upload the code and setting the MAC address obtained with the `make robot-get-mac` (robot Step 5).
59+
5. `make controller-upload robot-mac=<PUT_THE_ALVIK_MAC_HERE>` to upload the code and setting the MAC address obtained with the `make robot-get-mac` (Step 7 of Configure the Alvik robot).
6260
Example: `make controller-upload robot-mac=74:4d:bd:a0:49:e8`
6361

6462
## Techninal info
6563

6664
### Remote controller
67-
The remove controller is based on `Arduino Nano ESP32` and two `Modulino`.
65+
The remove controller is based on `Arduino Nano ESP32` and two `Modulino` (Pixels and Knob).
66+
67+
<p align="center">
68+
<img src="img/controller-exploded.jpeg" width="60%">
69+
</p>
70+
6871
The remote control consists of the a 3D printed base [STL-file](cad/remote-control/remote-control.stl) and the following components:
6972
| | Description | Amount / € |
7073
|---|---|:-:|
@@ -74,19 +77,24 @@ The remote control consists of the a 3D printed base [STL-file](cad/remote-contr
7477
| 2 | QWICC cables | Arduino |
7578
| 1 | [SparkFun Qwiic Shield for Arduino Nano](https://www.sparkfun.com/products/16789) | 2,48 € |
7679
| 8 | [M3 x 8 mm cutting screw](https://www.schraubenking.at/3-x-8mm-Flachrundkopfschraube-TX-fuer-Thermoplaste-P007210) | 1,20 € |
77-
| 1 | Small USB battery pack | ? |
80+
| 1 | [Small USB battery pack](https://www.amazon.it/alimentazione-rossetto-Portable-caricabatterie-cellulari/dp/B0BHZ6RY6C) | 10€ |
7881
| 1 | 3D printed body | |
7982

83+
84+
### Alvik robot
85+
86+
8087
<p align="center">
81-
<img src="cad/remote-control/remote-control.jpg" width="60%">
88+
<img src="img/robot-exploded.jpg" width="80%">
8289
</p>
8390

84-
### Alvik robot
91+
8592
The robot is an Alvik requires the following components:
8693
| | Description | Amount / € |
8794
|---|---|:-:|
8895
| 1 | [Arduino Alvik](https://www.arduino.cc/education/arduino-alvik/) | 158,60 € (Arduino) |
8996
| 1 | Modulino Pixel | Arduino |
97+
| 1 | QWICC cables | Arduino |
9098
| 2 | Servo motor (180 degree) | ~8€ |
9199
| 2 | Lift arm scoop mount [CAD](cad/robot/lift-arm-scoop.stl) | @aentinger |
92100
| 2 | Lift arm servo mount [CAD](cad/robot/lift-arm-servo.stl) | @aentinger |
@@ -98,8 +106,3 @@ The robot is an Alvik requires the following components:
98106
| 2 | Googly eyes | @aentinger |
99107
| 1 | Bumper sticker | @aentinger |
100108
| n | M3 metric and cutting screws | @aentinger |
101-
102-
103-
<p align="center">
104-
<img src="img/robot.jpg" width="60%">
105-
</p>
-1.16 MB
Binary file not shown.

img/controller-bottom.jpeg

186 KB
Loading

img/controller-exploded.jpeg

294 KB
Loading

img/controller-left.jpeg

212 KB
Loading

img/controller-top.jpeg

131 KB
Loading

img/robot-back.jpeg

274 KB
Loading

img/robot-exploded.jpg

145 KB
Loading

img/robot-front.jpeg

131 KB
Loading

img/robot-right.jpeg

178 KB
Loading

0 commit comments

Comments
 (0)