Reachy 2021 and 2023 SDK API
Custom gRPC messages and services used by Reachy's SDK server.
Install Python SDK API
Via pip:
pip install reachy-sdk-api
From source:
git clone https://github.com/pollen-robotics/reachy-sdk-api.git
cd ~/reachy-sdk-api/
pip install -e python
Generate gRPC code
- For Python:
python -m grpc_tools.protoc -I./protos --python_out=./python/reachy_sdk_api --grpc_python_out=./python/reachy_sdk_api ./protos/*.proto
- For C#:
Open reachy_sdk.sln in Visual Studio
Click Build > Build Solution
Services
In joint.proto:
Service: JointService
- GetAllJointsId - Return the list of all Reachy's joints ids.
- GetJointsState - Return the requested properties for the given joints.
- SendJointsCommands - Set the requested joints to the requested positions.
- StreamJointsCommands - Set continuously the requested joints to the requested positions.
- StreamJointsState - Stream the requested properties for the given joints.
In arm_kinematics.proto:
Service: ArmKinematics
- ComputeArmFK - Carry out the forward kinematics computation for Reachy's arm.
- ComputeArmIK - Carry out the inverse kinematics computation for Reachy's arm.
In head_kinematics.proto:
Service: HeadKinematics
- ComputeHeadFK - Carry out the forward kinematics computation for Reachy's head.
- ComputeHeadIK - Carry out the inverse kinematics computation for Reachy's head.
In fullbody_cartesian_command.proto:
Service: FullBodyCartesianCommandService
- SendFullBodyCartesianCommands - Set the joints to the requested positions given targets in cartesian coordinate system, for both arms and head of Reachy.
- StreamFullBodyCartesianCommands - Set continuously the joints to the requested positions given targets in cartesian coordinate system, for both arms and head of Reachy.
In camera_reachy.proto:
Service: CameraService
- GetImage - Return the image of the requested Reachy's camera.
In zoom_command.proto:
Service: ZoomControllerService
- SendZoomCommand - Change Reachy's camera zoom into the requested position.
- SetZoomSpeed - Change Reachy's camera zoom speed into the requested value.
In trajectory.proto:
Service: TrajectoryService
- ComputeMinimumJerkTrajectory - Compute a trajectory with a minimum jerk interpolation between a starting and a goal position in a given time.
In sensor.proto:
Service: SensorService
- GetAllForceSensorsId - Return the list of all Reachy's sensors ids.
- GetSensorsState - Return the state of the requested sensors.
- StreamSensorStates - Stream the state of the requested sensors.
In mobile_platform_reachy.proto:
Service : MobilityService
- SendDirection - Send velocities commands to the mobile base for a predifined period of time.
- SendSetSpeed - Send velocities commands to the mobile base.
- SendGoTo - Send GoTo instruction to the mobile base.
- DistanceToGoal - Return delta x, delta y, delta theta and distance from the last goal position sent using SendGoTo.
- SetControlMode - Set the mobile base's control mode.
- GetControlMode - Get the mobile base's control mode.
- SetZuuuMode - Set the mobile base's drive mode.
- GetZuuuMode - Get the mobile base's drive mode.
- GetBatteryLevel - Get the mobile base's battery voltage.
- GetOdometry - Get the mobile base's odometry.
- ResetOdometry - Reset the mobile base's odometry.
- SetZuuuSafety - Disable / enable the mobile base's anti-collision safety provided by the Lidar.
Service : MobileBasePresenceService
- GetMobileBasePresence - Return if a mobile base is specified in Reachy config file. If yes, return the mobile base's version.
This API is part of the version 2021 software release of Reachy.
Visit pollen-robotics.com to learn more or join our Dicord community if you have any questions or want to share your ideas.
Metadata
Release files for reachy-sdk-api 0.7.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| reachy-sdk-api-0.7.3.tar.gz | 20.6 kB | Without provenance | Details for reachy-sdk-api-0.7.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| reachy_sdk_api-0.7.3-py3-none-any.whl | Python 3 | none | any | Details for reachy_sdk_api-0.7.3-py3-none-any.whl |
Total release size: 60.3 kB
Release files / reachy-sdk-api-0.7.3.tar.gz
| Download URL | reachy-sdk-api-0.7.3.tar.gz |
|---|---|
| Size | 20.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
86ccddcd69b885db463b6feba8086380bdce421df3d953aa96ac0b361f65de49
|
|
BLAKE2b-256 checksum How to use checksums |
dcdb5933dec3588585ee39fe9e0c33c59f411135f7d89832d24708d9d8d03150
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.5
|
Release files / reachy_sdk_api-0.7.3-py3-none-any.whl
| Download URL | reachy_sdk_api-0.7.3-py3-none-any.whl |
|---|---|
| Size | 39.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
63534051d7e6b16b9836586f860978d954d61c5593de938551a0a826b1684baa
|
|
BLAKE2b-256 checksum How to use checksums |
544377558ea650d7816890c74963c6f2d2bd4042d9aebed9d2f87a0c1b76ddec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.5
|
Security for reachy-sdk-api 0.7.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.