Utility to quickly map servos on an adafruit I2C driver board, to proper names. Can produce a yaml output file, useful as input for other robotics applications.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

61 lines
1.2 KiB

7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
  1. # Mike's Servo Mapper
  2. A simple command line utility to map servos to
  3. Written and tested using the Adafruit I2C servo driver board: [PCA9685](https://www.adafruit.com/product/815)
  4. ## Requiremments
  5. ### Python Requirements
  6. Python's requirements are handled by pipenv, which you can install like so:
  7. ```bash
  8. sudo apt install pipenv
  9. ```
  10. or
  11. ```bash
  12. sudo dnf install pipenv
  13. ```
  14. Once installed, you can have pipenv install all python requirements like so:
  15. 1. cd to this repo's directory
  16. 2. Execute the command: ```pipenv install```
  17. ## Execution
  18. cd to this repo's directory and execute using:
  19. ```pipenv run python3 main.py```
  20. ## Command Line Arguments
  21. ### ***--name*** (Specify one or more mapping names)
  22. You can specify desired mapping names by adding the ***--name*** argument, as many times as you wish:
  23. ```bash
  24. $ pipenv run python3 main.py --name Leg --name Arm
  25. ```
  26. ### ***--config*** (Specify an input config file)
  27. You can specify a yaml configuration file to load with this argument, like so:
  28. ```bash
  29. $ pipenv run python3 main.py --config /path/to/config.yaml
  30. ```
  31. So far the config file is only good for storing desired names to be mapped. Here's an example:
  32. ```yaml
  33. names:
  34. - Manny
  35. - Moe
  36. - Jack
  37. ```