Freenove / Freenove_4WD_Smart_Car_Kit_for_Raspberry_Pi

Apply to FNK0043
Other
133 stars 148 forks source link

Comprehensive Typographical Errors in Mecanum Wheels Kinematics Calculations Documentation #56

Open kim-liedtke opened 4 months ago

kim-liedtke commented 4 months ago

Dear Freenove Team,

I have been thoroughly enjoying building and programming the 4WD Smart Car Kit with my Raspberry Pi. While working through the kinematics calculations for the mecanum wheels, as detailed in the provided tutorial, I've encountered what appears to be a series of typographical errors that could potentially lead to confusion for others engaging with this material.

Specifically, these errors pertain to the velocity vector notations for the wheels, which are crucial for understanding the intended motion and control of the vehicle. The errors are consistent throughout the section on mecanum wheels kinematics (pages 17-24 in the tutorial), where wheel designations are mistakenly repeated or mislabeled, affecting the clarity of instructions on how the wheels should move to achieve specific directions.

The documentation states for example (it's also wrong in the other equations):

V(FR) = -V(X)
V(FL) = +V(X)
V(BL) = -V(X)
V(FR) = +V(X)

However, I believe there is a mistake with the wheel designations and possibly a repeat. For clarity and correctness, the intended notations for the wheel velocities to achieve lateral movement (e.g., moving to the right) should likely be:

V(FR) = -V(X)  // Front Right wheel moves backward
V(FL) = +V(X)  // Front Left wheel moves forward
V(BL) = -V(X)  // Back Left wheel moves backward
V(BR) = +V(X)  // Back Right wheel moves forward

This confusion could significantly impact the learning experience and the successful implementation of these concepts by users trying to follow along. I believe these might be simple typographical mistakes, but correcting them would greatly enhance the tutorial's accuracy and usability.

Could you please review and update the tutorial documentation to correct these discrepancies? Such corrections would ensure that all users can have a smooth and accurate learning experience when programming the car's movements.

Thank you for your attention to this matter and for providing such an engaging kit for Raspberry Pi enthusiasts.

Best regards,

Kim