Rework README, Update connection-plan
Readme:
- new structure
- remove unnecessary content
- add current features
connection-plan:
- Fix / Change pin assignments, matches config now
- Extend wiring-plan (Armchair section, box-wireframes, connectors)
function-diagram:
- fix typos in joystick mapping
This commit is contained in:
jonny_jr9
parent
50ee4244d3
commit
1ee8e2cfbe
6
.gitignore
vendored
6
.gitignore
vendored
@ -10,9 +10,15 @@ dependencies.lock
|
|||||||
**/.cache
|
**/.cache
|
||||||
|
|
||||||
|
|
||||||
|
# VS-code
|
||||||
|
settings.json
|
||||||
|
|
||||||
|
|
||||||
# drawio
|
# drawio
|
||||||
*.dtmp
|
*.dtmp
|
||||||
*.bkp
|
*.bkp
|
||||||
|
# diagrams are mostly temporary (pdf files are tracked)
|
||||||
|
*.drawio
|
||||||
|
|
||||||
|
|
||||||
# React
|
# React
|
||||||
|
|||||||
170
README.md
170
README.md
@ -1,7 +1,57 @@
|
|||||||
|
# Overview
|
||||||
Firmware for a homemade automated electric armchair.
|
Firmware for a homemade automated electric armchair.
|
||||||
More details about this project:
|
Extensive details about this project can be found here:
|
||||||
V1: https://pfusch.zone/electric-armchair
|
- ~~V1: [Electric Armchair V1](https://pfusch.zone/electric-armchair)~~
|
||||||
V2: https://pfusch.zone/electric-armchair-v2
|
- V2: [Electric Armchair V2](https://pfusch.zone/electric-armchair-v2)
|
||||||
|
|
||||||
|
In the current version V2.2, only the esp-project in the [board_single/](board_single) folder plus the custom libraries in [common/](common) are used.
|
||||||
|
Note: The projects in the folders `board_control/` and `board_motorctl/` are no longer compatible and legacy from V2.1.
|
||||||
|
|
||||||
|
|
||||||
|
## Hardware Setup / Electrical
|
||||||
|
### PCB
|
||||||
|
The firmware in this repository is designed for an ESP32 microcontroller integrated into a custom PCB developed here: [Project Work 2020](https://pfusch.zone/project-work-2020)
|
||||||
|
|
||||||
|
### Connection Plan
|
||||||
|
A detailed diagram illustrating all components and wiring can be found in the file [connection-plan.drawio.pdf](connection-plan.drawio.pdf)
|
||||||
|
|
||||||
|
For more details refer to the documentation on the website.
|
||||||
|
|
||||||
|
|
||||||
|
## Current Features
|
||||||
|
- Control Modes:
|
||||||
|
- Joystick: Control via hardware joystick mounted on the right armrest
|
||||||
|
- HTTP: Control via virtual joystick on a web interface
|
||||||
|
- Massage: Armchair shaking depending on stick position
|
||||||
|
- Auto: Execute stored driving commands sequentially
|
||||||
|
- Electric Chair Adjustment: Leg and backrest control via joystick
|
||||||
|
- Advanced Motor Control: Configurable motor fading (acceleration, deceleration limit), current limit, braking; compatible with different hardware
|
||||||
|
- Wi-Fi:
|
||||||
|
- Hosts wireless network
|
||||||
|
- Webserver with webroot in SPIFFS
|
||||||
|
- HTTP API for controlling the chair
|
||||||
|
- UART Communication between 2 boards (V2.1)
|
||||||
|
- Speed Measurement: Measures speed and direction of each tire individually using custom encoders
|
||||||
|
- Current Measurement: Monitors current of each motor
|
||||||
|
- Battery Capacity: Measures battery voltage and calculates percentage according to discharge curve
|
||||||
|
- Fan Control: Cooling fan for motor driver activated only when needed
|
||||||
|
- Display:
|
||||||
|
- Various status screens showing battery status, speed, RPM, motor current, mode, power, duty cycle, stick data
|
||||||
|
- Menu for setting various options using encoder
|
||||||
|
- Buzzer: Provides acoustic feedback when switching modes or interacting with menu
|
||||||
|
|
||||||
|
## Planned Features
|
||||||
|
- More Sensors:
|
||||||
|
- Accelerometer
|
||||||
|
- Lidar sensor / collision detection
|
||||||
|
- GPS receiver
|
||||||
|
- Temperature sensors
|
||||||
|
- Anti-Slip Regulation
|
||||||
|
- Self-Driving Algorithm
|
||||||
|
- Lights
|
||||||
|
- Improved Web Interface
|
||||||
|
- App
|
||||||
|
- Camera
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@ -19,7 +69,7 @@ yay -S esp-idf #alternatively clone the esp-idf repository from github
|
|||||||
git clone git@github.com:Jonny999999/armchair_fw
|
git clone git@github.com:Jonny999999/armchair_fw
|
||||||
```
|
```
|
||||||
### Instal node packages
|
### Instal node packages
|
||||||
For the react app packages have to be installed with npm TODO: add this to cmake?
|
For the react app packages have to be installed using npm. TODO: add this to cmake?
|
||||||
```
|
```
|
||||||
cd react-app
|
cd react-app
|
||||||
npm install
|
npm install
|
||||||
@ -28,11 +78,12 @@ npm install
|
|||||||
|
|
||||||
|
|
||||||
# Building the Project
|
# Building the Project
|
||||||
## react-webapp
|
## React-webapp
|
||||||
For the webapp to work on the esp32 it has to be built.
|
When flashing to the ESP32, the files in the `react-app/build/` folder are written to a SPIFFS partition.
|
||||||
When flashing, the folder react-app/build is flashed to siffs (which is used as webroot) onto the esp32.
|
These files are then served via HTTP in the Wi-Fi network "armchair" created by the ESP32.
|
||||||
The following command builds the react webapp and creates this folder
|
In HTTP control mode, you can control the armchair using a joystick on the provided website.
|
||||||
TODO: add this to flash target with cmake?
|
|
||||||
|
Initially, or when changing the React code, you need to manually build the React app:
|
||||||
```bash
|
```bash
|
||||||
cd react-app
|
cd react-app
|
||||||
#compile
|
#compile
|
||||||
@ -42,7 +93,8 @@ rm build/static/js/main.8f9aec76.js.LICENSE.txt
|
|||||||
```
|
```
|
||||||
Note: Use `npm start` for starting the webapp locally for testing
|
Note: Use `npm start` for starting the webapp locally for testing
|
||||||
|
|
||||||
## esp project
|
|
||||||
|
## Firmware
|
||||||
### Set up environment
|
### Set up environment
|
||||||
```bash
|
```bash
|
||||||
source /opt/esp-idf/export.sh
|
source /opt/esp-idf/export.sh
|
||||||
@ -65,84 +117,52 @@ idf.py flash
|
|||||||
```
|
```
|
||||||
- once "connecting...' was successfully, BOOT button can be released
|
- once "connecting...' was successfully, BOOT button can be released
|
||||||
|
|
||||||
|
|
||||||
### Monitor
|
### Monitor
|
||||||
- connect FTDI programmer to board (VCC to VCC; TX to RX; RX to TX)
|
To view log output for debugging, follow the same steps as in the Upload section, but run:
|
||||||
- press REST and BOOT button
|
|
||||||
- release RESET button (keep pressing boot)
|
|
||||||
- run monitor command:
|
|
||||||
```bash
|
```bash
|
||||||
idf.py monitor
|
idf.py monitor
|
||||||
```
|
```
|
||||||
- once connected release BOOT button
|
|
||||||
- press RESET button once for restart
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
# Hardware setup
|
|
||||||
## pcb
|
|
||||||
Used pcb developed in this project: https://pfusch.zone/project-work-2020
|
|
||||||
|
|
||||||
## connection plan
|
|
||||||
A diagram which shows what components are connected to which terminals of the pcb exists here:
|
|
||||||
[connection-plan.drawio.pdf](connection-plan.drawio.pdf)
|
|
||||||
|
|
||||||
|
|
||||||
|
# Usage / User Interface
|
||||||
|
|
||||||
# Planned Features
|
## Encoder Functions
|
||||||
- More sensors:
|
|
||||||
- Accelerometer
|
|
||||||
- Lidar sensor
|
|
||||||
- GPS receiver
|
|
||||||
- Anti slip regulation
|
|
||||||
- Self driving algorithm
|
|
||||||
- Lights
|
|
||||||
- Improved webinterface
|
|
||||||
- App
|
|
||||||
|
|
||||||
|
**When not in MENU mode**, the button (encoder click) has the following functions:
|
||||||
|
|
||||||
|
| Count | Type | Action | Description |
|
||||||
|
|-------|---------------|----------------------|---------------------------------------------------------------------------------------------|
|
||||||
|
| 1x long | switch mode | **MENU** | Open menu to set various options, controlled via display and rotary encoder. |
|
||||||
|
| 1x | control | [MASSAGE] **freeze** input | When in massage mode: lock or unlock joystick input at current position. |
|
||||||
|
| 1x short, 1x long | switch mode | **ADJUST-CHAIR** | Switch to mode where the armchair leg and backrest are controlled via joystick. |
|
||||||
|
| 2x | toggle mode | **IDLE** <=> previous | Enable/disable chair armchair (e.g., enable after startup or switch to previous mode after timeout). |
|
||||||
|
| 3x | switch mode | **JOYSTICK** | Switch to JOYSTICK mode, to control armchair using joystick (default). |
|
||||||
|
| 4x | switch mode | **HTTP** | Switch to **remote control** via web-app `http://191.168.4.1` in wifi `armchair`. |
|
||||||
|
| 5x | | | |
|
||||||
|
| 6x | switch mode | **MASSAGE** | Switch to MASSAGE mode where armchair shakes differently, depending on joystick position. |
|
||||||
|
| 7x | | | |
|
||||||
|
| 8x | toggle option| **deceleration limit** | Disable/enable deceleration limit (default on) => more responsive. |
|
||||||
|
| 12x | toggle option| **alt stick mapping** | Toggle between default and alternative stick mapping (reverse direction swapped). |
|
||||||
|
|
||||||
# Todo
|
**When in MENU mode** (1x long press), the encoder controls the menu:
|
||||||
**Add switch functions**
|
|
||||||
- set loglevel
|
|
||||||
- define max-speed
|
|
||||||
|
|
||||||
|
| Encoder Event | Current Menu | Action |
|
||||||
|
|---------------|--------------|--------------------------------------------------------------|
|
||||||
|
| long press | main-menu | Exit MENU mode to previous control mode (e.g., JOYSTICK). |
|
||||||
|
| long press | value-select | Exit to main-menu without changing the value. |
|
||||||
|
| click | main-menu | Select currently highlighted menu item -> enter value-select screen. |
|
||||||
|
| click | value-select | Confirm value / run action. |
|
||||||
|
| rotate | main-menu | Scroll through menu items. |
|
||||||
|
| rotate | value-select | Change value. |
|
||||||
|
|
||||||
|
## HTTP Mode
|
||||||
|
Control the armchair via a virtual joystick on the web interface.
|
||||||
|
|
||||||
# Usage
|
**Usage:**
|
||||||
## Switch functions
|
- Switch to HTTP mode (4 button presses).
|
||||||
**Currently implemented**
|
- Connect to WiFi `armchar`, no password.
|
||||||
| Count | Type | Action | Description |
|
- Access http://192.168.4.1 (note: **http** NOT https, some browsers automatically add https!).
|
||||||
| --- | --- | --- | --- |
|
|
||||||
| 1x | configure | [JOYSTICK] **calibrate stick** | when in joystick mode: set joystick center to current joystick pos |
|
|
||||||
| 1x | control | [MASSAGE] **freeze** input | when in massage mode: lock or unlock joystick input at current position |
|
|
||||||
| 2x | toggle mode | **IDLE** <=> previous | enable/disable chair armchair e.g. enable after startup or timeout |
|
|
||||||
| 3x | switch mode | **JOYSTICK** | switch to default mode JOYSTICK |
|
|
||||||
| 4x | toggle mode | **HTTP** <=> JOYSTICK | switch to '**remote control** via web-app `http://191.168.4.1`' or back to JOYSTICK mode |
|
|
||||||
| 5x | | | |
|
|
||||||
| 6x | toggle mode | **MASSAGE** <=> JOYSTICK | switch to MASSAGE mode or back to JOYSTICK mode |
|
|
||||||
| 7x | | | |
|
|
||||||
| 8x | toggle option | **deceleration limit** | disable/enable deceleration limit (default on) => more responsive |
|
|
||||||
| | | | |
|
|
||||||
| 12x | toggle option | **alt stick mapping** | toggle between default and alternative stick mapping (reverse swapped) |
|
|
||||||
| >1s | system | **restart** | Restart the controller when pressing the button longer than 1 second |
|
|
||||||
| 1x short, 1x long | auto command | **eject** foot support | automatically go forward and reverse for certain time with no acceleration limits, so foot support ejects |
|
|
||||||
|
|
||||||
|
|
||||||
## HTTP mode
|
|
||||||
Control armchair via virtual joystick on a webinterface.
|
|
||||||
|
|
||||||
**Usage**
|
|
||||||
- Connect to wifi `armchar`, no password
|
|
||||||
- Access http://192.168.4.1 (note: **http** NOT https, some browsers automatically add https!)
|
|
||||||
|
|
||||||
**Current Features**
|
|
||||||
- Control direction and speed with joystick
|
|
||||||
|
|
||||||
**Todo**
|
|
||||||
- Set parameters
|
|
||||||
- max duty
|
|
||||||
- max current
|
|
||||||
- Control other modes e.g. massage
|
|
||||||
- Execute preset movement commands
|
|
||||||
- Change seating position
|
|
||||||
also see github issue
|
|
||||||
Binary file not shown.
Binary file not shown.
Loading…
x
Reference in New Issue
Block a user