Skip to content

Commit 8396f73

Browse files
Added sensors intro
1 parent 1f28bd5 commit 8396f73

File tree

2 files changed

+62
-21
lines changed

2 files changed

+62
-21
lines changed
311 KB
Loading

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

Lines changed: 62 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ To get started to play with Alvik you will need the following hardware and softw
104104

105105
- Alvik (x1)
106106
- USB-C® to USB-C® cable (x1)
107-
- Phillips Screwdriver (cross head) (x1)
107+
- Phillips® Screwdriver (cross head) (x1)
108108
- Computer (x1)
109109

110110
***Make sure the USB-C® cable you are using works with data lines, not only power lines***
@@ -190,70 +190,111 @@ Alvik has five different sensors, all connected to the STM32 and accessible thro
190190

191191
### Touch Buttons
192192

193-
TODO: Content for this section
193+
The Arduino Alvik robot is equipped with seven capacitive touch buttons. These buttons allow for interactive input and can be used to control various functions of the robot, such as movement, mode selection, and more.
194+
195+
**Available buttons are:**
196+
- Up
197+
- Down
198+
- Left
199+
- Right
200+
- Center
201+
- OK (represented by a "tick" Icon)
202+
- Cancel (represented by a "x")
203+
204+
Each button can be programmed to perform specific actions, providing more complex interface for user interaction.
194205

195206
### Distance Sensors
196207

197-
The Arduino Alvik robot is equipped with a ToF (Time of Flight) 8x8 Array sensor, specifically the LSM6DSOX, which can measure distances up to 350 cm. These distance sensors help the robot detect obstacles and measure the distance to objects in its environment.
208+
The Arduino Alvik robot is equipped with a ToF (Time of Flight) 8x8 Array sensor, specifically the VL53L7CX, which can measure distances up to 350 cm. These distance sensors help the robot detect obstacles and measure the distance to objects in its environment. The sensor is integrated into the front PCB of the robot.
198209

199-
TODO:Add image
200-
TODO: Content for this section
210+
**Key Features:**
211+
- Maximum distance: 350 cm
212+
- High precision and accuracy
213+
- Used for obstacle detection and distance measurement
214+
215+
TODO: Add image
201216

202217
### Line Follower Sensor
203218

204-
The Arduino Alvik robot is equipped with line follower sensors that help it detect and follow lines on the ground. This is useful for applications where the robot needs to navigate along predefined paths.
205-
TODO:Add images
219+
The Arduino Alvik robot is equipped with line follower sensors that help it detect and follow lines on the ground. This is useful for applications where the robot needs to navigate along predefined paths. The line follower array consists of three phototransistors and five infrared LEDs, mounted on the front PCB.
206220

221+
The infrared LEDs emit light towards the ground, and the phototransistors detect the reflected light. When the sensors pass over a line (typically a dark line on a light surface), the amount of reflected light changes. Dark lines reflect less infrared light compared to light surfaces, allowing the phototransistors to detect the presence of a line.
207222

208-
TODO: Content for this section and images
223+
**Key Features:**
224+
- Detects lines on the ground
225+
- Helps in navigating predefined paths
226+
- Consists of three phototransistors and five infrared LEDs
209227

210-
### Color Sensor
228+
**How it Works:**
229+
- **Infrared LEDs**: Emit infrared light towards the ground.
230+
- **Phototransistors**: Detect the reflected infrared light.
231+
- When over a dark line, the reflection is low, indicating the presence of a line.
232+
- When over a light surface, the reflection is high, indicating no line.
211233

212-
The color sensor on the Arduino Alvik robot is used to detect and identify colors on surfaces that the robot encounters. It provides both raw color readouts and labeled color information that can be used for various applications such as line following, object detection, and more.
234+
![Follow the line sensor principles](assets/ch07-blacktape-color.png)
213235

236+
By continuously reading the values from the phototransistors, the robot can determine its position relative to the line and adjust its movements to follow the path accurately.
214237

215238

216-
TODO: Content for this section
239+
TODO: Add images
217240

218-
### IMU
241+
### Color Sensor
219242

220-
The Arduino Alvik robot is equipped with an onboard IMU (Inertial Measurement Unit) that provides valuable information about the robot's motion and orientation. The IMU can measure acceleration, angular velocity, and orientation.
243+
The color sensor on the Arduino Alvik robot is used to detect and identify colors on surfaces that the robot encounters. It provides both raw color readouts and labeled color information that can be used for various applications such as line following, object detection, and more. The sensor used is the APDS 9660.
221244

222-
TODO add image of IMU
245+
**Key Features:**
246+
- Detects and identifies colors
247+
- Provides raw color readouts and labeled color information
248+
- Useful for line following, object detection, and other applications
223249

250+
### IMU
251+
252+
The Arduino Alvik robot is equipped with an onboard IMU (Inertial Measurement Unit) that provides valuable information about the robot's motion and orientation. The IMU can measure acceleration, angular velocity, and orientation. The sensor used is the LSM6DSOX.
253+
254+
**Key Features:**
255+
- Measures acceleration, angular velocity, and orientation
256+
- Provides roll, pitch, and yaw values
257+
- Useful for motion tracking and stabilization
224258

259+
TODO: Add image of IMU
225260

226261
## Actuators
227262

228263
### Motors and Encoders
229264

230-
Alvik has two high-precision geared motors and two RGB LEDs. The test programs are located in the same folder as the [sensor examples](#sensors).
265+
Alvik has two high-precision geared motors and two RGB LEDs. The motors are driven by the MAX22211 motor driver and include magnetic relative encoders for precise control.
231266

232267
| **Actuator name** | **Part name** | **Test program name** |
233268
|--------------------------|-------------------------|-----------------------|
234269
| Geared motors w/ encoder | GM12-N20VA-08255-150-EN | wheels_positions.py |
235270
| RGB LEDs | RGB LEDs | leds_settings.py |
236271

237-
TODO: Does this make sense to group together?
238-
272+
The RGB LEDs can be used for visual feedback and can be programmed to display various colors and patterns.
239273

240274
## What the Robot Includes
241275

242-
TODO: Content for this section
276+
The Arduino Alvik robot package includes the following items:
277+
- Alvik robot
278+
- USB-C to USB-C cable
279+
- Phillips screwdriver
280+
- 18650 Li-Ion battery
243281

244282
## Move Alvik! (extended)
245283

246284
### Basic Touch Programming
247285

248-
TODO: Content for this section
286+
Alvik’s touch buttons can be programmed to control various actions such as movement, changing modes, and interacting with the environment. This allows for creating intuitive control schemes for different applications.
249287

250288
### Following Objects
251289

252-
TODO: Content for this section
290+
Using the distance sensors, Alvik can follow objects by maintaining a certain distance from them. This is useful for applications like automated guided vehicles and interactive robotics.
253291

254292
### Line Follower
255293

256-
TODO: Content for this section
294+
With its line follower sensors, Alvik can navigate along predefined paths marked by lines on the ground. This is especially useful in educational settings and for demonstrating basic robotic navigation.
295+
296+
The goal is to present the sensors and actuators of the Alvik robot, highlighting their key features and uses without delving into programming specifics.
297+
257298

258299
## Alvik First Use
259300

0 commit comments

Comments
 (0)