# User Guides

A collection of product specific user guides are to be found here.

```{contents} Topics
:local:
:depth: 2
```

## Lens Replacement
This guide will explain how to proceed to change the receiver lens.
```{warning} 
The lens mounted on delivery has been focused and glued in production. By changing the lens the user takes responsibility for the focus.
```
1. Fully unscrew lens (counterclockwise).
2. Screw desired lens ~10 Turns (clockwise).
3. Start a grayscale video stream using the GUI.
4. Screw/unscrew until an object at ~30 cm is focused (sharp image).
   
## Illumination Selection
This guide will explain how to enable disable the epc670 ToF HAT+ 150° LED 1 and theepc670 ToF HAT+ 80° LED 2 :
```{table}
:caption: [RPi Header](hw_description.md#header-40-pin) GPIO numbering used
| GPIO12 | GPIO5 |     | LED 1 | LED2  |
| ------ | ----- | --- | ----- | ----- |
| 0      | 0     |     | **0** | **0** |
| 0      | 1     |     | **0** | **1** |
| 1      | 0     |     | **1** | **0** |
| 1      | 1     |     | **1** | **1** |
```

## Install Package Apt Repository
Requires:
- network data transfer tool (wget, curl)
- superuser access

1. Download and add ESPROS GPG keyring to your keyrings
```bash
sudo wget http://apt.espros.com/espros-archive-keyring.gpg -P /usr/share/keyrings/
```
2.  Add the apt source:
```bash
echo "Types: deb
URIs: http://apt.espros.com
Suites: trixie
Components: main
Signed-By: /usr/share/keyrings/espros-archive-keyring.gpg" | sudo tee /etc/apt/sources.list.d/espros.sources
```
3. Apt tool now sees ESPROS packages:
```bash
sudo apt update                 # Check for update and cache it
sudo apt upgrade                # Upgrade packages where update detected in cache
sudo apt install <package name> # Install specific package
```