Skip to content

Commit 7ec1755

Browse files
Merge pull request #2084 from arduino/GJD_UMRev
changes on the battery section
2 parents a59558d + e4c4e76 commit 7ec1755

File tree

2 files changed

+19
-21
lines changed

2 files changed

+19
-21
lines changed
Loading

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

Lines changed: 19 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -95,22 +95,8 @@ At the back-right side of Alvik there is the main switch of the robot. When ON t
9595
### Battery
9696

9797
The battery is a rechargeable Li-ion 18650, it allows to run Alvik for 8+ hours non stop.
98-
The battery is located in the bottom part of Alvik, if you need to access it you'll need to remove one Phillip's screw and take out the plastic holder.
99-
100-
101-
![Accessing battery compartment](assets/battery_holder.jpg)
102-
103-
104-
**Changing the battery:**
105-
106-
1. **Detach the Existing Battery**: Carefully remove the old battery from its compartment.
107-
2. **Attach a New Battery**: Place the new battery into the holder, ensuring it is securely connected.
108-
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.
109-
4. **Connect the Nano ESP32 to the Computer**: Use a USB cable to connect the Nano ESP32 to your computer.
110-
111-
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.
11298

113-
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.
99+
When you connect your Alvik to the computer, the Nano ESP32 reports the status of the battery through the terminal of the Arduino Lab for MicroPython and with its RGB status LED. In order to see the state of the battery, you need to call the `Alvik.begin()` function in any program or directly at the command line area.
114100

115101
When the battery is charging the status LED will blink RED for one second.
116102

@@ -124,10 +110,22 @@ When fully charged it will stay GREEN.
124110

125111
***Don't confuse the RGB status LED with the power ON LED of the Nano ESP32, which is always green.***
126112

127-
## Alvik's Sensors
113+
### Replacing the battery
128114

115+
The battery is located in the bottom part of Alvik, if you need to access it you'll need to remove one Phillip's screw and take out the plastic holder.
129116

130117

118+
![Accessing battery compartment](assets/battery_holder.jpg)
119+
120+
1. **Detach the Existing Battery**: Carefully remove the old battery from its compartment.
121+
2. **Attach a New Battery**: Place the new battery into the holder, ensuring it is securely connected.
122+
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.
123+
4. **Connect the Nano ESP32 to the Computer**: Use a USB cable to connect the Nano ESP32 to your computer.
124+
125+
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.
126+
127+
## Alvik's Sensors
128+
131129
Alvik includes a set of different sensors listed below, all connected to the STM32 and accessible through the [APIs](https://docs.arduino.cc/tutorials/alvik/api-overview). For each sensor there is test example program that you can find in the _examples_ folder in [this repository](https://github.com/arduino/arduino-alvik-mpy/tree/main/examples) for micropython and in [this repository](https://github.com/arduino-libraries/Arduino_AlvikCarrier/tree/main/examples) for C++.
132130

133131

@@ -834,20 +832,20 @@ In this example, the robot uses its line follower sensor array to navigate along
834832
from arduino_alvik import ArduinoAlvik
835833
import time
836834
from time import sleep
837-
835+
838836
# Initialization
839837
alvik = ArduinoAlvik()
840838
alvik.begin()
841839
sleep(5) # Waiting for the robot to setup
842-
840+
843841
# Calibrate color sensor for white
844842
alvik.color_calibration('white')
845-
843+
846844
# Main logic
847845
detected_colors = set()
848-
846+
849847
print("Starting to move and detect colors...")
850-
848+
851849
try:
852850
while len(detected_colors) < 3:
853851
alvik.set_wheels_speed(20, 20)

0 commit comments

Comments
 (0)