Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md #10

Merged
merged 2 commits into from
Jun 14, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,22 @@ This repository contains the source code for the Kachaka API server and Zenoh no
<!-- - Integration of Kachaka API with Open RMF using Zenoh -->
<!-- - Web-based demo for remote control and monitoring of Kachaka robots -->

## Usage of Scripts

This repository includes two main scripts for different use cases:

1. `rest_kachaka_api.py`

- Use this script when communicating with an Open-RMF server within the same network without NAT (Network Address Translation) traversal.
- This script uses fleet_adapter_kachaka as the fleet adapter.
- It leverages FastAPI to expose the required topics for the fleet adapter.

1. `connect_openrmf_by_zenoh.py`:

- Use this script when communicating with an Open-RMF server via Zenoh router, requiring NAT traversal.
- It uses a common adapter that sends and receives Zenoh topics as the fleet adapter.
Choose the appropriate script based on your network setup and communication requirements.

## Cloning the repository

```bash
Expand Down Expand Up @@ -99,6 +115,18 @@ To send commands to the robot via Zenoh, publish a JSON-formatted message to the
}
```

#### Configuration

- The script reads the configuration from `config.yaml` to map the method names received from Open-RMF to the corresponding Kachaka API method names. For example, if config.yaml contains:

```yaml
method_mapping:
dock: return_home
```

The script will map the dock method from Open-RMF to the return_home method of the Kachaka API.
Please make sure to provide the necessary configuration, including the method_mapping, in the config.yaml file before running the connect_openrmf_by_zenoh.py script.

## License

This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for more details.
Expand Down