You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/hardware/08.edu/solution-and-kits/alvik/tutorials/user-manual/user-manual.md
+17-5
Original file line number
Diff line number
Diff line change
@@ -54,6 +54,9 @@ Arduino® Alvik is a robot with two controllers and numerous useful sensors and
54
54
55
55
## The Brain
56
56
The brain of the Alvik robot is the Nano ESP32, which is the central component we program to run the logic and make decisions. It is extremely important because it processes all the high-level commands and controls the overall operation of the robot. However, instead of directly moving the motors or reading sensors, it communicates with the STM32 (the body) to execute these actions. The Nano ESP32 gives orders to the STM32 to move, read sensors, or report status, allowing the robot to make informed (or better yet, as informed as we program it) decisions and run tasks and routines using this information.
57
+

58
+
59
+
57
60
### Nano ESP32
58
61
59
62
The [Nano ESP32](https://store.arduino.cc/products/nano-esp32) is the board used to control Alvik. It has a fast processor, large flash memory, and a Wi-Fi® enabled chip packed into a tiny circuit board.
@@ -67,6 +70,9 @@ Please note that when using MicroPython the pin number reflects the GPIO on the
67
70
## The Body
68
71
Using the same analogy, the body of the Alvik robot includes everything else from the sensors and motors to the connectors supporting external modules and, of course, the STM32, which acts like the nervous system of the robot. Just as the human nervous system transmits signals between the brain and various parts of the body, the STM32 transmits commands and collects data from the robot's components. When the Nano ESP32, acting as the brain, sends commands, the STM32 executes these low-level operations, such as moving the motors, flashing the LEDs, or interacting with external devices. The STM32 is essential for carrying out the detailed actions based on the high-level instructions from the Nano ESP32, ensuring that the robot's movements and functions are performed accurately.
69
72
73
+

74
+
75
+
70
76
### Controller - STM32
71
77
72
78
@@ -77,7 +83,7 @@ You can learn more about the available functions for Alvik in the following [Alv
77
83
***Although Alvik's "out of the box" experience is designed in micropython, there are C++ APIs that allow you to program Avlik in the Arduino IDE, these APIs are 1 to 1 compatible with the micropython APIs, which means that the API overview will be interesting for both micropython and C++ programs.***
78
84
79
85
The latest firmware of the STM32 can be found at [this link](https://github.com/arduino-libraries/Arduino_AlvikCarrier/releases), and [here](#how-to-upload-firmware) is the guide to flash it.
80
-
86
+

81
87
82
88
83
89
@@ -97,6 +103,16 @@ The battery is a rechargeable Li-ion 18650. It is located in the bottom part of
1.**Detach the Existing Battery**: Carefully remove the old battery from its compartment.
110
+
2.**Attach a New Battery**: Place the new battery into the holder, ensuring it is securely connected.
111
+
3.**Plug in the Nano ESP32**: If you are using a different controller or have used the robot in another manner, reconnect the Nano ESP32.
112
+
4.**Connect the Nano ESP32 to the Computer**: Use a USB cable to connect the Nano ESP32 to your computer.
113
+
114
+
These steps are crucial for resetting the Battery Management System (BMS) after a battery replacement. If these steps are not followed, the BMS will remain "off," and the robot will not turn on.
115
+
100
116
The Nano ESP32 can report the status of the battery through the terminal of the Arduino Lab for MicroPython and with its RGB status LED. To do that you need to call the `Alvik.begin()` function in any program or directly at the command line area.
101
117
102
118
When the battery is charging the status LED will blink RED for one second.
@@ -1610,10 +1626,6 @@ Now you can open the Arduino Lab for MicroPython, connect Alvik and open the exa
1610
1626
1611
1627

1612
1628
1613
-
7. Test `bender.py`
1614
-
1615
-
Open the example called `bender.py`, launch it and see on your display the image of Bender's robot.
1616
-
1617
1629
## Want More?
1618
1630
1619
1631
If you're looking to get the most out of your Alvik robot, we have a comprehensive course available for you. Visit [Explore Robotics with MicroPython](https://courses.arduino.cc/explore-robotics-micropython/) for guided projects and lessons designed to help you master your Alvik. This course provides step-by-step instructions and detailed explanations to enhance your robotics and programming skills. Whether you're a beginner or an experienced maker, our course will take your Alvik experience to the next level.
0 commit comments