Skip to content

Commit eec8078

Browse files
committed
reshaping the 1st sections
1 parent 5ebaba7 commit eec8078

File tree

1 file changed

+7
-27
lines changed
  • content/hardware/08.edu/solution-and-kits/alvik/tutorials/user-manual

1 file changed

+7
-27
lines changed

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

Lines changed: 7 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -16,42 +16,22 @@ Powered by the Arduino® Nano ESP32, Alvik offers diverse learning paths through
1616

1717
In this tutorial, you will find useful information to get started, test, and maintain Alvik.
1818

19-
## Alvik Overview
19+
## What Is Alvik
20+
21+
Alvik is a robot with two controllers and a wide range of sensors and actuators. The main controller is the Arduino Nano ESP32 attached to the top of the robot while there is an STM32 controller integrated into the robot that takes care of the low-level commands such as reading the sensors and moving the motors. It has been designed for STEAM education, making it an ideal tool for learning programming, Robotics, IoT, Artificial Intelligence...
22+
23+
### Alvik Overview
2024

2125
![Alvik exploded view](assets/main-components.png)
2226

2327
***When the PCB is out of the chassis and the battery is in place there is the risk of short-circuiting the 18650 Li-Ion battery. If you remove the hardware from the chassis make sure you do it on a __non-conductive surface clean__ of materials or tools that can short-circuit the battery***
2428

2529
### Main Components
2630

27-
Alvik is a robot with two controllers and tons of useful sensors and actuators. The main controller is the Arduino Nano ESP32 attached at the top of the robot while there is an STM32 controller integrated into the robot that takes care of the low-level commands like reading the sensors and moving the motors.
28-
2931
![Alvik top components](assets/up-components.png)
3032

3133
![Alvik bottom components](assets/down-components.png)
3234

33-
## Move Your Robot!
34-
35-
To get started to play with Alvik you will need the following hardware and software:
36-
37-
### Hardware Requirements
38-
39-
- Alvik (x1)
40-
- USB-C® to USB-C® cable (x1)
41-
- Phillips® Screwdriver (cross head) (x1)
42-
- Computer (x1)
43-
44-
***Make sure the USB-C® cable you are using works with data lines, not only power lines***
45-
46-
### Software Requirements
47-
48-
- Operating Systems: Linux, macOS and Windows
49-
- [Arduino Lab for Micropython](https://labs.arduino.cc/en/labs/micropython)
50-
51-
## What Is Alvik
52-
53-
Arduino® Alvik is a robot with two controllers and numerous useful sensors and actuators. It is designed for STEAM education, making it an ideal tool for learning programming, Robotics, IoT, and Artificial Intelligence.
54-
5535
## The Brain
5636
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.
5737
### Nano ESP32
@@ -794,7 +774,7 @@ In this example, the robot uses its line follower sensor array to navigate along
794774
detected_colors = set()
795775

796776
print("Starting to move and detect colors...")
797-
777+
798778
try:
799779
while len(detected_colors) < 3:
800780
alvik.set_wheels_speed(20, 20)
@@ -866,7 +846,7 @@ The `get_imu` function from the [Alvik API](https://docs.arduino.cc/tutorials/al
866846
**Outputs:**
867847
**ax**: acceleration on x
868848
**ay**: acceleration on y
869-
**az**: acceleration on z
849+
**az**: acceleration on z
870850

871851
1. Retrieves 3-axial angular acceleration values
872852

0 commit comments

Comments
 (0)