Skip to content

Commit c835c4f

Browse files
Fixed feedback
Added images Rephrased content Added battery replacement
1 parent 6ee640c commit c835c4f

File tree

6 files changed

+17
-5
lines changed

6 files changed

+17
-5
lines changed
Loading
Loading

content/hardware/08.edu/solution-and-kits/alvik/tutorials/user-manual/user-manual.md

+17-5
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,9 @@ Arduino® Alvik is a robot with two controllers and numerous useful sensors and
5454

5555
## The Brain
5656
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+
![Alvik Brain](assets/alvik_brain.png)
58+
59+
5760
### Nano ESP32
5861

5962
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
6770
## The Body
6871
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.
6972

73+
![Alvik Body](assets/alvik_body.png)
74+
75+
7076
### Controller - STM32
7177

7278

@@ -77,7 +83,7 @@ You can learn more about the available functions for Alvik in the following [Alv
7783
***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.***
7884

7985
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+
![Alvik STM32](assets/alvik_STM.png)
8187

8288

8389

@@ -97,6 +103,16 @@ The battery is a rechargeable Li-ion 18650. It is located in the bottom part of
97103

98104
![Accessing battery compartment](assets/battery_holder.jpg)
99105

106+
107+
**Changing the battery:**
108+
109+
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+
100116
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.
101117

102118
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
16101626

16111627
![Hello World OLED](assets/hello.png)
16121628

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-
16171629
## Want More?
16181630

16191631
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

Comments
 (0)