Fixed Grammatical Errors and updated documentation.
This commit is contained in:
committed by
Rune Harlyk
parent
b113a30942
commit
e0d3912d83
@@ -1,17 +1,17 @@
|
||||
# Components
|
||||
|
||||
Spot is comprised of a 3D printed body, some hardware and list of electronic components.
|
||||
Spot is comprised of a 3D-printed body, some hardware, and a list of electronic components.
|
||||
|
||||
## Hardware
|
||||
|
||||
Spot is 3D printed and is a combination of different Spot Micro designs, with some minor modification on top.
|
||||
The original design is developed by KDY0523.
|
||||
Spot is 3D-printed and is a combination of different Spot Micro designs, with some minor modifications.
|
||||
The original design was developed by KDY0523.
|
||||
|
||||
- [robjk reinforced shoulder remix](https://www.thingiverse.com/thing:4937631)
|
||||
- [Kooba SpotMicroESP32 remix](https://www.thingiverse.com/thing:4559827)
|
||||
- [KDY0532 original design](https://www.thingiverse.com/thing:3445283)
|
||||
|
||||
The 3D prints is assembled with some additional component:
|
||||
The 3D prints are assembled with some additional non-printable components:
|
||||
|
||||
- 84x M2x8 screws + M2 nuts
|
||||
- 92x M3x8 screws + M3 nuts
|
||||
@@ -20,7 +20,7 @@ The 3D prints is assembled with some additional component:
|
||||
|
||||
## Electronics
|
||||
|
||||
These are the electronics i used for mine and can easily be switched up to suit your Spot's needs.
|
||||
These are the electronics I used for mine, and they can easily be swapped to suit your Spot's needs.
|
||||
|
||||
| Component | Specification | Required | Recommendation |
|
||||
| ------------------------- | ----------------------------- | -------- | ------------------------------------------------------------------------------------------------------- |
|
||||
@@ -39,6 +39,6 @@ These are the electronics i used for mine and can easily be switched up to suit
|
||||
| 7.6-8.4V Battery | Battery | No | Im using 4x 18650 in 2s2p configuration, but other people have 2s LiPos. |
|
||||
| 4x Servo extension cables | Servo extension cables | Yes | You can either buy them or make them with a couple or headers and some cable. |
|
||||
|
||||
I recommend getting a ESP32-S3 with a camera, allowing for more computation and imaging capabilities.
|
||||
I recommend getting an ESP32-S3 with a camera, allowing for more computation and imaging capabilities.
|
||||
|
||||
It means a more responsive robot as its faster doing sensor fusion, calculating kinematic and gait planning, and networking.
|
||||
It means a more responsive robot as it's faster at doing sensor fusion, calculating kinematics and gait planning, and networking.
|
||||
|
||||
+5
-5
@@ -1,6 +1,6 @@
|
||||
# Assembly and calibration
|
||||
|
||||
There exist a number of great resources for the assembly of the spot micro. For this reason I refer to these, as the steps are the same for this version:
|
||||
There are a number of great resources for the assembly of the Spot Micro. For this reason, I refer to these, as the steps are the same for this version:
|
||||
|
||||
- [Michael Kubina SpotMicroESP32 assembly](https://github.com/michaelkubina/SpotMicroESP32/tree/master/assembly)
|
||||
- [Spot Micro AI assembly](https://spotmicroai.readthedocs.io/en/latest/assembly/)
|
||||
@@ -9,7 +9,7 @@ There exist a number of great resources for the assembly of the spot micro. For
|
||||
|
||||
Discussion about [Calibration](https://github.com/runeharlyk/SpotMicroESP32-Leika/discussions/118)
|
||||
|
||||
Assuming the servos are connected to the PCA9685 and is powered on:
|
||||
Assuming the servos are connected to the PCA9685 and are powered on:
|
||||
|
||||
### Calibrate in servo frame
|
||||
|
||||
@@ -38,13 +38,13 @@ You now have the values for the servos.
|
||||
|
||||
### Calibration in body frame
|
||||
|
||||
They now has to calibrated to the body frame. It assumed they have the center pwm pointing straight down.
|
||||
They now have to be calibrated to the body frame. It is assumed they have the center PWM pointing straight down.
|
||||
|
||||
1. Navigate to `/controller` and click on "Calibrate". This will set the servo to the center pwm value.
|
||||
2. Navigate to `peripherals/servo` - Here you can set the servo angle offset.
|
||||
|
||||
All the legs should be pointing down. If they are not you have to options. 1; Physically move the servos to the correct position by un screwing the servo horns. 2; Update the servo offset in the servo table.
|
||||
All the legs should be pointing down. If they are not, you have two options. 1. Physically move the servos to the correct position by unscrewing the servo horns. 2. Update the servo offset in the servo table.
|
||||
|
||||
## Circuit diagram
|
||||
|
||||

|
||||

|
||||
|
||||
+5
-5
@@ -1,6 +1,6 @@
|
||||
# Software
|
||||
|
||||
The robots firmware is built using platform io using the arduino framework over ESP-IDF.
|
||||
The robot's firmware is built using PlatformIO with the Arduino framework over ESP-IDF.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
@@ -8,7 +8,7 @@ To prepare the frontend code for the ESP32, a specific build chain is required.
|
||||
|
||||
### Required Software
|
||||
|
||||
Install the following software to ensure all functionalities:
|
||||
Install the following software to ensure all functionality:
|
||||
|
||||
- [VSCode](https://code.visualstudio.com/) - Preferred IDE for development
|
||||
- [Node.js](https://nodejs.org) - Needed for app building
|
||||
@@ -45,9 +45,9 @@ For additional boards, refer to the [official board list](https://docs.platformi
|
||||
|
||||
### Factory settings
|
||||
|
||||
Update the `esp32/factory_setting.ini` with new wifi settings, app name and other device information.
|
||||
Update the `esp32/factory_setting.ini` with new Wi-Fi settings, app name and other device information.
|
||||
|
||||
### Build & Upload Process
|
||||
|
||||
Update the `platformio.ini` file for your board, then navigate to the PlatformIO tab, select your environment, click `Upload Filesystem Image` and after uploading finish, click `Upload and Monitor`. The filesystem image only has to be uploaded the first time and will override config files on the microcontroller.
|
||||
When uploading new firmware the app is evaluated and if necessary will be rebuild.
|
||||
Update the `platformio.ini` file for your board, then navigate to the PlatformIO tab, select your environment, click `Upload Filesystem Image` and after uploading finishes, click `Upload and Monitor`. The filesystem image only needs to be uploaded the first time. It will override config files on the microcontroller.
|
||||
When uploading new firmware, the app is evaluated, and if necessary, will be rebuilt.
|
||||
|
||||
@@ -4,10 +4,10 @@
|
||||
|
||||
## Connecting to the network
|
||||
|
||||
If the wifi settings were configured using `esp32/factory_settings.ini` the robot will try to connect to the network.
|
||||
If the Wi-Fi settings were configured using `esp32/factory_settings.ini`, the robot will try to connect to the network.
|
||||
|
||||
If it fails to connect, it will host a AP with a captive portal where it's possible to configure wifi settings.
|
||||
If it fails to connect, it will host an AP with a captive portal where it's possible to configure Wi-Fi settings.
|
||||
|
||||
When the robot connect successfully the ip address will be printed to the serial monitor
|
||||
When the robot connects successfully, the IP address will be printed to the serial monitor.
|
||||
|
||||
<!-- ## Calibrating servos -->
|
||||
|
||||
+2
-2
@@ -1,10 +1,10 @@
|
||||
# Running the spot
|
||||
|
||||
> *Prerequsition*: You have successfully build, flashed and configured your robot.
|
||||
> *Prerequsition*: You have successfully built, flashed, and configured your robot.
|
||||
|
||||
Navigate to `/controller`
|
||||
|
||||

|
||||
|
||||
<!-- When the robot is in a safe position, click on rest.
|
||||
<!-- When the robot is in a safe position, click on Rest.
|
||||
This will activate the servos and put the robot in the rest position. -->
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
# Developing
|
||||
|
||||
> _Prerequsition_: You have successfully build, flashed and configured your robot.
|
||||
> _Prerequsition_: You have successfully built, flashed, and configured your robot.
|
||||
|
||||
## Setting up SvelteKit
|
||||
|
||||
### Proxy Configuration for Development
|
||||
|
||||
Configure the proxy settings in the `vite.config.ts` file to direct API calls to your ESP32 device. By default it used the factory MDNS address, but can be changed to the ip if preferred.
|
||||
Configure the proxy settings in the `vite.config.ts` file to direct API calls to your ESP32 device. By default, it uses the factory MDNS address, but it can be changed to the IP if preferred.
|
||||
|
||||
```ts
|
||||
server: {
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 110 KiB |
@@ -1,10 +1,10 @@
|
||||
# 🏁 Motion state controller
|
||||
|
||||
The motion controller is a finite state machine with state allowing for static and dynamic posing, 8-phase crawl and bezier bases trot gait, and choreographed animation.
|
||||
The motion controller is a finite state machine that allows for static and dynamic posing, 8-phase crawl, bezier-based trot gait, and choreographed animation.
|
||||
|
||||
## Controller Input Mapping
|
||||
|
||||
The controller input is interpret different between the modes. For the walking it it looks like this:
|
||||
The controller input is interpreted differently between the modes. For walking, it looks like this:
|
||||
|
||||
| Controller Input | Mapped to Gait Step | Range |
|
||||
| ---------------- | ------------------- | ------- |
|
||||
@@ -21,7 +21,7 @@ The controller input is interpret different between the modes. For the walking i
|
||||
|
||||
## Walking gait
|
||||
|
||||
General about walking gait
|
||||
General description of walking gait.
|
||||
|
||||
Time step
|
||||
|
||||
@@ -31,9 +31,9 @@ Stance and swing controller
|
||||
|
||||
## 8-phase crawl gait
|
||||
|
||||
The 8-phase crawl gait works by lifting one leg at a time while shifting its body weight away from the leg.
|
||||
The 8-phase crawl gait works by lifting one leg at a time while shifting the body weight away from that leg.
|
||||
|
||||
As the name implies, the gait consist of 8 discrete phases, which represents which feet should be contact the ground or be in swing.
|
||||
As the name implies, the gait consists of 8 discrete phases, which represent which feet should be in contact with the ground or in swing.
|
||||
|
||||
At each time step the phase time $t\in [0,1]$ is updated. When $t\geq 1$ the phase index is updated and phase time is reset.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user