From e0d3912d83aee1d07ae7ff2f4e50982a33d501c6 Mon Sep 17 00:00:00 2001 From: TitanDynamics Date: Thu, 20 Mar 2025 19:14:47 -0400 Subject: [PATCH] Fixed Grammatical Errors and updated documentation. --- app/README.md | 25 ++++++++----------------- docs/1_components.md | 14 +++++++------- docs/2_assembly.md | 10 +++++----- docs/3_software.md | 10 +++++----- docs/4_configuring.md | 6 +++--- docs/5_running.md | 4 ++-- docs/6_developing.md | 4 ++-- docs/media/circuitschematic.png | Bin 0 -> 112416 bytes docs/motion_system.md | 10 +++++----- esp32/platformio.ini | 3 ++- readme.md | 16 ++++++++-------- 11 files changed, 47 insertions(+), 55 deletions(-) create mode 100644 docs/media/circuitschematic.png diff --git a/app/README.md b/app/README.md index 5ce6766..fb673d7 100644 --- a/app/README.md +++ b/app/README.md @@ -8,30 +8,21 @@ If you're seeing this, you've probably already done this step. Congrats! ```bash # create a new project in the current directory -npm create svelte@latest - -# create a new project in my-app -npm create svelte@latest my-app +npx sv create ``` ## Developing -Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server: +Once you've created your project, follow these steps: -```bash -npm run dev +1: Delete package-lock.json +2: Check `git status`. If you see any changes other than package-lock.json or favicon.ico, run the command `git restore ./` (See below) +3: Run `npm install` or `pnpm install` or `yarn` to install the dependencies +4: Run `npm run build` to build the project -# or start the server and open the app in a new browser tab -npm run dev -- --open -``` +Running `git status` should show: -## Building - -To create a production version of your app: - -```bash -npm run build -``` +[![example.png](https://i.postimg.cc/yddM3hH3/example.png)](https://postimg.cc/7CFsp2bq) You can preview the production build with `npm run preview`. diff --git a/docs/1_components.md b/docs/1_components.md index 1cfe341..e8bf2f7 100644 --- a/docs/1_components.md +++ b/docs/1_components.md @@ -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. diff --git a/docs/2_assembly.md b/docs/2_assembly.md index 5871255..b4b9704 100644 --- a/docs/2_assembly.md +++ b/docs/2_assembly.md @@ -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 -![Electronics diagram](media/circuit.png "Title") +![Electronics diagram](media/circuitschematic.png "Title") diff --git a/docs/3_software.md b/docs/3_software.md index c541521..64c797e 100644 --- a/docs/3_software.md +++ b/docs/3_software.md @@ -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. diff --git a/docs/4_configuring.md b/docs/4_configuring.md index 6db031e..f753d57 100644 --- a/docs/4_configuring.md +++ b/docs/4_configuring.md @@ -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. diff --git a/docs/5_running.md b/docs/5_running.md index 0b114c4..0a13ec0 100644 --- a/docs/5_running.md +++ b/docs/5_running.md @@ -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` ![Controller](media/controller.png) - diff --git a/docs/6_developing.md b/docs/6_developing.md index 5abaf1e..a318a92 100644 --- a/docs/6_developing.md +++ b/docs/6_developing.md @@ -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: { diff --git a/docs/media/circuitschematic.png b/docs/media/circuitschematic.png new file mode 100644 index 0000000000000000000000000000000000000000..27e0d3f19220b3403905c9ecb8afb85e61c03727 GIT binary patch literal 112416 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]bb>8X4sJz2=}u$RaKD^u&fx#T`AY) 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 O-*R$yJhI@u4SxWt`E-~7 literal 0 HcmV?d00001 diff --git a/docs/motion_system.md b/docs/motion_system.md index 87c0d46..4220440 100644 --- a/docs/motion_system.md +++ b/docs/motion_system.md @@ -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. diff --git a/esp32/platformio.ini b/esp32/platformio.ini index f560a7d..9d9825d 100644 --- a/esp32/platformio.ini +++ b/esp32/platformio.ini @@ -16,10 +16,11 @@ extra_configs = features.ini build_settings.ini build_cache_dir = .pio/build_cache -default_envs = esp32-camera +default_envs = esp32-camera ; Change this to your default environment example: [env:{esp32-camera}] ; ================================================================ ; Project environments +; More Board information: https://registry.platformio.org/platforms/platformio/espressif32/boards [env:esp32-camera] board = esp32cam diff --git a/readme.md b/readme.md index 9a7f6a5..78e2d5c 100644 --- a/readme.md +++ b/readme.md @@ -6,7 +6,7 @@
Spot Micro - Leika ๐Ÿ• -
+

A small quadruped robot, inspired by Boston Dynamics Spot.

Explore the docs ยป @@ -25,7 +25,7 @@ ## ๐Ÿ“œ Overview Leika is a smaller quadruped robot for the Spot-Micro community. -Built on an ESP32 and powered by FreeRTOS, she can handle multiple tasks seamlessly - Like video and data streaming, solving kinematic and gait planning, controlling IO and much more. +Built on an ESP32 and powered by FreeRTOS, she can handle multiple tasks seamlesslyโ€”like video and data streaming, solving kinematic and gait planning, controlling I/O, and much more. By focusing on practicality and simplicity in both hardware and software, it offer an accessible platform for learning, experimentation, and modest real-world applications. ## ๐ŸŽฏ Features @@ -83,8 +83,8 @@ $$ --> ### ๐ŸŽฎ Controller -The controller is a svelte app, which get embedded in the firmware of the robot. -Which mean that new releases and OTA updates includes the latest controller. +The controller is a Svelte app, which get embedded in the firmware of the robot. +Which means that new releases and OTA updates include the latest controller. The controller includes full control over robot settings like network and calibration, and a visualization. @@ -113,11 +113,11 @@ The kinematic for the robot is from this [kinematics paper](https://www.research ## ๐Ÿ Motion state controller -The motion controller is a finite state machine with state allowing for static and dynamic posing, 8-phase crawl and bezier based trot gait, and choreographed animation. +The motion controller is a finite state machine with states allowing for static and dynamic posing, an 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. | Controller Input | Mapped to Gait Step | Range | | ---------------- | ------------------- | ------- | @@ -175,7 +175,7 @@ Rotation is calulated using the same curve ## ๐Ÿš€ Future -See the [project backlog](https://github.com/users/runeharlyk/projects/3) and [open issues](https://github.com/runeharlyk/SpotMicroESP32-Leika/issues) for full list of proposed and active features (and known issues). +See the [project backlog](https://github.com/users/runeharlyk/projects/3) and [open issues](https://github.com/runeharlyk/SpotMicroESP32-Leika/issues) for a full list of proposed and active features (and known issues). ## ๐Ÿ™Œ Credits @@ -191,7 +191,7 @@ This project takes great inspiration from the following resources: ## โ˜• Support -If you like the project and want to follow it evolving concidering โœจ-ing the project +If you like the project and want to follow its evolution, consider โœจ-ing the project Buy Me A Coffee

A small quadruped robot, inspired by boston dynamic Spot.