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

🌐 Add LLM Translations #421

Merged
merged 79 commits into from
Jun 2, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
79 commits
Select commit Hold shift + click to select a range
2f06aff
💬Generate LLM translations
github-actions[bot] Jun 1, 2024
75cd184
💬Generate LLM translations
github-actions[bot] Jun 2, 2024
fd81ef1
Update README.de-DE.md
thias15 Jun 2, 2024
e8643b5
Update README.md
thias15 Jun 2, 2024
b6d2a1f
Update README.de-DE.md
thias15 Jun 2, 2024
e6c15df
Update README.de-DE.md
thias15 Jun 2, 2024
6e30ed7
Update README.md
thias15 Jun 2, 2024
215b23d
Update README.de-DE.md
thias15 Jun 2, 2024
631af64
Update README.md
thias15 Jun 2, 2024
45f6687
Update README.de-DE.md
thias15 Jun 2, 2024
9b7837e
Update README.md
thias15 Jun 2, 2024
550e46c
Update README.de-DE.md
thias15 Jun 2, 2024
816fca9
Update README.md
thias15 Jun 2, 2024
2fcf762
Update README.de-DE.md
thias15 Jun 2, 2024
3b4d48e
Update README.md
thias15 Jun 2, 2024
fe0524d
💬Generate LLM translations
github-actions[bot] Jun 2, 2024
8f0f298
Update README.md
thias15 Jun 2, 2024
9557f29
Update README.de-DE.md
thias15 Jun 2, 2024
923fcfb
Update README.md
thias15 Jun 2, 2024
f682a99
Update README.de-DE.md
thias15 Jun 2, 2024
cbac9a2
Update README.md
thias15 Jun 2, 2024
8445757
Update README.de-DE.md
thias15 Jun 2, 2024
0c093a3
Update README.md
thias15 Jun 2, 2024
6c9faf8
Update README.de-DE.md
thias15 Jun 2, 2024
495d27a
Update README.de-DE.md
thias15 Jun 2, 2024
11b35c6
Update README.md
thias15 Jun 2, 2024
69a2bb3
Update README.de-DE.md
thias15 Jun 2, 2024
c73505c
Update README.md
thias15 Jun 2, 2024
701b933
Update README.de-DE.md
thias15 Jun 2, 2024
d522f52
Update README.md
thias15 Jun 2, 2024
28ef674
💬Generate LLM translations
github-actions[bot] Jun 2, 2024
4d7f6ac
Update README.de-DE.md
thias15 Jun 2, 2024
9ecc3ef
Update README.md
thias15 Jun 2, 2024
e58ae69
Update README.md
thias15 Jun 2, 2024
08261c6
Update README.de-DE.md
thias15 Jun 2, 2024
8c62cd7
Update README.de-DE.md
thias15 Jun 2, 2024
e702992
Update README.md
thias15 Jun 2, 2024
63571f2
Update README.de-DE.md
thias15 Jun 2, 2024
a3acf2a
Update README.md
thias15 Jun 2, 2024
c0f6216
Update README.de-DE.md
thias15 Jun 2, 2024
f53f15f
Update README.md
thias15 Jun 2, 2024
8628d3a
Update README.md
thias15 Jun 2, 2024
f1e5ff1
Update README.de-DE.md
thias15 Jun 2, 2024
1bbd0ca
Update README.md
thias15 Jun 2, 2024
4892597
Update README.md
thias15 Jun 2, 2024
2be9cbf
Update README.de-DE.md
thias15 Jun 2, 2024
bd2e3e6
Update README.md
thias15 Jun 2, 2024
c8bd9a7
Update README.md
thias15 Jun 2, 2024
20e62ae
Update README.md
thias15 Jun 2, 2024
c79a6f0
Update README.de-DE.md
thias15 Jun 2, 2024
a3b6165
Update README.de-DE.md
thias15 Jun 2, 2024
6ca4697
Update README.md
thias15 Jun 2, 2024
299aeba
Update README.de-DE.md
thias15 Jun 2, 2024
e23371a
Update README.md
thias15 Jun 2, 2024
e9cb52a
Update README.de-DE.md
thias15 Jun 2, 2024
18bb588
Update README.de-DE.md
thias15 Jun 2, 2024
43c299f
Update README.md
thias15 Jun 2, 2024
32e1436
💬Generate LLM translations
github-actions[bot] Jun 2, 2024
830ada8
Update README.de-DE.md
thias15 Jun 2, 2024
e5b122e
Update README.md
thias15 Jun 2, 2024
5d18cbd
Update README.md
thias15 Jun 2, 2024
d4e9bf9
Update README.md
thias15 Jun 2, 2024
17d1ab6
Update README.de-DE.md
thias15 Jun 2, 2024
3b91bf1
Update README.md
thias15 Jun 2, 2024
13d8537
💬Generate LLM translations
github-actions[bot] Jun 2, 2024
0d61501
💬Generate LLM translations
github-actions[bot] Jun 2, 2024
5c0eeee
Update README.md
thias15 Jun 2, 2024
17b6609
Update README.md
thias15 Jun 2, 2024
dcf1e33
Update README.de-DE.md
thias15 Jun 2, 2024
cd0d59b
Update README.md
thias15 Jun 2, 2024
93aa6b3
Update README.de-DE.md
thias15 Jun 2, 2024
7d6e8bc
Update README.md
thias15 Jun 2, 2024
db66560
Update README.de-DE.md
thias15 Jun 2, 2024
06442e9
Update README.md
thias15 Jun 2, 2024
ca721e1
Update README.md
thias15 Jun 2, 2024
770e07d
Update README.de-DE.md
thias15 Jun 2, 2024
a4c1d5c
💬Generate LLM translations
github-actions[bot] Jun 2, 2024
ed530bc
Update README.de-DE.md
thias15 Jun 2, 2024
384100e
Update README.md
thias15 Jun 2, 2024
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
95 changes: 95 additions & 0 deletions README.de-DE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
<a href="https://www.openbot.org/" target="_blank">
<img align="center" alt="Banner" width="100%" src="docs/images/banner.jpg" />
</a>

<h1 align="center"><a>Smartphones in Roboter verwandeln</a></h1>

<p align="center">
<img alt="GitHub build" src="https://img.shields.io/github/actions/workflow/status/isl-org/OpenBot/gradle.yml?branch=master"></a>
<img alt="GitHub issues" src="https://img.shields.io/github/issues/isl-org/OpenBot"></a>
<img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/isl-org/OpenBot"></a>
<img alt="GitHub forks" src="https://img.shields.io/github/forks/isl-org/OpenBot"></a>
<img alt="GitHub stars" src="https://img.shields.io/github/stars/isl-org/OpenBot"></a>
<img alt="Github downloads" src="https://img.shields.io/github/downloads/isl-org/OpenBot/total"></a>
<img alt="Github size" src="https://img.shields.io/github/repo-size/isl-org/OpenBot"></a>
<img alt="Github license" src="https://img.shields.io/github/license/isl-org/OpenBot"></a>
</p>

<p align="center">
<a href="README.md">English</a> |
<a href="README_CN.md">简体中文</a> |
<span>Deutsch</span>
</p>

OpenBot nutzt Smartphones als Gehirn für kostengünstige Roboter. Wir haben ein kleines Elektrofahrzeug entworfen, das etwa 50 Dollar kostet und als Roboterkörper dient. Unser Software-Stack für Android-Smartphones unterstützt fortgeschrittene Robotikanwendungen wie Personenerkennung und Echtzeit-Autonomes Fahren.

## Erste Schritte mit OpenBot
- Baue deinen eigenen [Roboterkörper](body/README.md)
- Flashe die [Arduino-Firmware](firmware/README.md)
- Installiere die [Android-Apps](android/README.md)
- Steuere den Roboter über einen [Controller](controller/README.md)
- Trainiere deine eigene [Fahrstrategie](policy/README.md)

## Quellcode erhalten

- Du kannst das Repository als [Zip-Datei](https://github.com/intel-isl/OpenBot/archive/master.zip) herunterladen und in einen Ordner deiner Wahl extrahieren.
- Du kannst das OpenBot-Repository von GitHub mit folgendem Befehl klonen:
```bash
git clone https://github.com/intel-isl/OpenBot.git
```
- Du kannst das OpenBot-Repository forken und dann deine lokale Kopie klonen. Dies wird empfohlen, insbesondere wenn du [beitragen](CONTRIBUTING.md) möchtest.

## Videos

<a href="https://www.youtube.com/watch?v=RbzPXywJifA" >
<img align="center" width="300" alt="youtube video" src="https://img.youtube.com/vi/RbzPXywJifA/hqdefault.jpg" />
</a>

<a href="https://www.youtube.com/watch?v=qc8hFLyWDOM" >
<img align="center" width="300" alt="youtube video" src="https://img.youtube.com/vi/qc8hFLyWDOM/hqdefault.jpg" />
</a>

## Coole Projekte mit OpenBot

Es gibt bereits viele coole Projekte, die OpenBot nutzen. Unten ist eine kleine Auswahl. Klicke auf die Bilder, um zu den jeweiligen Projekten weitergeleitet zu werden.

<p float="left">
<a href="https://www.thingiverse.com/thing:4670884" target="_blank">
<img alt="Tank OpenBot" width="24%" src="docs/images/openbot_tank.jpg" />
</a>
<a href="https://diyrobocars.com/2020/12/14/an-improved-version-of-the-intel-openbot" target="_blank">
<img alt="2WD OpenBot" width="24%" src="docs/images/openbot_2wd.jpg" />
</a>
<a href="https://custom-build-robots.com/raspberry-pi-robot-cars/openbot-your-smartphone-controls-a-robot-car-introduction/13860?lang=en" target="_blank">
<img alt="Cardboard OpenBot" width="24%" src="docs/images/chassis_cardboard_1.jpg" />
</a>
<a href="https://www.youtube.com/watch?v=PEj8jWapGt4" target="_blank">
<img alt="Baby Yoda OpenBot" width="24%" src="docs/images/openbot_yoda.jpg" />
</a>
</p>

## Kontakt

- Trete unserem [Slack](https://join.slack.com/t/openbot-community/shared_invite/zt-jl8ygxqt-WNRNi9yzh7Lu60qui6Nh6w) Kanal bei, um dich mit der OpenBot-Community zu verbinden.
- Kontaktiere uns per [E-Mail](mailto:[email protected])

## Beitrag leisten

Bitte lies die [Beitragsrichtlinien](CONTRIBUTING.md). Wenn du nicht sicher bist, wo du anfangen sollst, wirf einen Blick auf die [offenen Issues](https://github.com/intel-isl/OpenBot/issues).

## Zitieren

Bitte zitiere unser [Paper](https://arxiv.org/abs/2008.10631), wenn du OpenBot verwendest.

```bib
@inproceedings{mueller2021openbot,
title = {OpenBot: Turning Smartphones into Robots},
author = {M{\"u}ller, Matthias und Koltun, Vladlen},
booktitle = {Proceedings of the International Conference on Robotics and Automation (ICRA)},
year = {2021},
}
```

<a href="https://www.openbot.org//" target="_blank">
<img align="center" alt="Footer" width="100%" src="docs/images/footer.gif" />
</a>
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@

<p align="center">
<span>English</span> |
<a href="README_CN.md">简体中文</a>
<a href="README_CN.md">简体中文</a> |
<a href="README.de-DE.md">Deutsch</a>
</p>

OpenBot leverages smartphones as brains for low-cost robots. We have designed a small electric vehicle that costs about $50 and serves as a robot body. Our software stack for Android smartphones supports advanced robotics workloads such as person following and real-time autonomous navigation.
Expand Down
66 changes: 66 additions & 0 deletions android/README.de-DE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Android Apps

<p align="center">
<a href="README.md">English</a> |
<a href="README_CN.md">简体中文</a> |
<span>Deutsch</span>
</p>

## Funktionen

Klicken Sie auf die untenstehenden Links, um mehr über die Funktionen der Apps zu erfahren.

- [Robot App](robot/README.md)
- [Controller App](controller/README.md)

## Installation der Apps

Der einfachste Weg, eine der Apps zu erhalten, ist, sie direkt auf das Telefon herunterzuladen, indem Sie den entsprechenden QR-Code verwenden. Wenn Sie den Browser auf Ihrem Telefon verwenden, können Sie auch einfach auf den QR-Code klicken. Sie können dann die APK auf Ihrem Telefon öffnen und [installieren](https://www.lifewire.com/install-apk-on-android-4177185). Beachten Sie, dass die APK nur mit einem Debug-Schlüssel signiert ist.

<table style="width:100%;border:none;text-align:center">
<tr>
<td> <a href="https://app.openbot.org/robot" target="_blank">
<img alt="🤖 App" width="50%" src="../docs/images/robot_app_qr_code.png" />
</a>
</td>
<td>
<a href="https://app.openbot.org/controller" target="_blank">
<img alt="🎮 App" width="50%" src="../docs/images/controller_app_qr_code.png" />
</a>
</td>
</tr>
<tr>
<td>🤖 App</td>
<td>🎮 App</td>
</tr>
</table>

Alternativ können Sie die APKs aus den Assets einer beliebigen [Veröffentlichung](https://github.com/intel-isl/OpenBot/releases) herunterladen. Wenn Sie die neueste App aus dem Master-Branch möchten, können Sie sie auch aus den Build-Artefakten [hier](https://github.com/intel-isl/OpenBot/actions?query=workflow%3A%22Java+CI+with+Gradle%22) herunterladen. Beachten Sie, dass sie möglicherweise nicht stabil ist. Wenn Sie später Änderungen an der App vornehmen möchten, folgen Sie den untenstehenden Schritten, um die App zu kompilieren und auf Ihrem Telefon zu installieren.

## Apps bauen

### Voraussetzungen

- [Android Studio Electric Eel | 2022.1.1 oder später](https://developer.android.com/studio/index.html) zum Bauen und Installieren der APKs.
- Android-Gerät und Android-Entwicklungsumgebung mit mindestens API 21.
- Derzeit verwenden wir API 33 als Compile-SDK und API 32 als Target-SDK. Es sollte automatisch installiert werden, aber falls nicht, können Sie das SDK manuell installieren. Gehen Sie zu Android Studio -> Einstellungen -> Erscheinungsbild & Verhalten -> Systemeinstellungen -> Android SDK. Stellen Sie sicher, dass API 33 aktiviert ist, und klicken Sie auf Anwenden.

![Android SDK](../docs/images/android_studio_sdk.jpg)

### Build-Prozess

1. Öffnen Sie Android Studio und wählen Sie *Ein bestehendes Android Studio-Projekt öffnen*.
2. Wählen Sie das Verzeichnis OpenBot/android und klicken Sie auf OK.
3. Wenn Sie die [OpenBot-App](app/README.md) installieren möchten, stellen Sie sicher, dass die *app*-Konfiguration ausgewählt ist. Wenn Sie die [Controller-App](controller/README.md) installieren möchten, wählen Sie die *controller*-Konfiguration. Bestätigen Sie den Gradle-Sync, falls erforderlich. Um einen Gradle-Sync manuell durchzuführen, klicken Sie auf das Gradle-Symbol.
![Gradle Sync](../docs/images/android_studio_bar_gradle.jpg)
4. Verbinden Sie Ihr Android-Gerät und stellen Sie sicher, dass USB-Debugging in den [Entwickleroptionen](https://developer.android.com/studio/debug/dev-options) aktiviert ist. Abhängig von Ihrer Entwicklungsumgebung könnten [weitere Schritte](https://developer.android.com/studio/run/device) erforderlich sein. Sie sollten Ihr Gerät jetzt in der Navigationsleiste oben sehen.
![Phone](../docs/images/android_studio_bar_phone.jpg)
5. Klicken Sie auf die Schaltfläche Ausführen (der grüne Pfeil) oder wählen Sie Ausführen > 'android' ausführen aus dem oberen Menü. Möglicherweise müssen Sie das Projekt mit Build > Projekt neu erstellen neu erstellen.
![Run](../docs/images/android_studio_bar_run.jpg)
6. Wenn Sie gefragt werden, ob Sie Instant Run verwenden möchten, klicken Sie auf *Ohne Instant Run fortfahren*.

### Fehlerbehebung

#### Versionen

Wenn Sie eine Nachricht wie `Das Projekt verwendet eine inkompatible Version (AGP 7.4.0) des Android Gradle-Plugins. Die neueste unterstützte Version ist AGP 7.3.0` erhalten, müssen Sie Android Studio aktualisieren oder Ihr Gradle-Plugin downgraden. Sie können mehr über die Versionskompatibilität zwischen Android Studio und dem Gradle-Plugin [hier](https://developer.android.com/studio/releases/gradle-plugin#android_gradle_plugin_and_android_studio_compatibility) lesen.
3 changes: 2 additions & 1 deletion android/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@

<p align="center">
<span>English</span> |
<a href="README_CN.md">简体中文</a>
<a href="README_CN.md">简体中文</a> |
<a href="README.de-DE.md">Deutsch</a>
</p>

## Features
Expand Down
80 changes: 80 additions & 0 deletions android/controller/README.de-DE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
# Controller App

<p align="center">
<a href="README.md">English</a> |
<a href="README.zh-CN.md">简体中文</a> |
<span>Deutsch</span>
</p>

Diese Android-App dient als `Fernsteuerung` für das [OpenBot](https://www.openbot.org) Fahrzeug. Im Grunde erfüllt sie eine ähnliche Funktion wie ein PS3/4- oder Xbox-Controller, läuft jedoch auf einem anderen Android-Gerät.

## Verbindung

Wenn die Controller-App gestartet wird, versucht sie sofort, eine Verbindung zum Roboter herzustellen. Wir sehen den folgenden Bildschirm:

<p float="left">
<img src="../../docs/images/controller_pre_connect.png" width="50%" />
</p>

Um den Controller mit dem Roboter zu verbinden, stellen Sie die Steuerungseinstellung der Roboter-App auf den **Phone**-Modus.

<p float="left">
<img src="../../docs/images/app_controller_settings_1.png" width="25%" />
<img src="../../docs/images/app_controller_settings_2.png" width="25%" />
</p>

Sie können auch vom `FreeRoamFragment` aus eine Verbindung zum Controller herstellen, indem Sie das Telefon als Controller auswählen:

<p float="left">
<img src="../../docs/images/free-roam-fragment-selection.png" width="50%" />
</p>

Nach ein paar Sekunden hören Sie einen Piepton, und der Controller wechselt seinen Bildschirm zu:

<p float="left">
<img src="../../docs/images/controller_command_buttons.png" width="50%" />
</p>

Hier können Sie auswählen, ob Sie den Roboter durch Neigen des Telefons oder durch die Verwendung der Bildschirmsteuerung fahren möchten.

***Hinweis:*** Dies sollte ausreichen, um eine Verbindung herzustellen, aber wenn die Verbindung nach 30 Sekunden nicht hergestellt werden kann, schalten Sie die `Control`-Einstellung in der Roboter-App auf `Gamepad` und dann wieder auf `Phone`, um die Verbindung erneut zu initiieren. Wenn das fehlschlägt, beenden Sie die Controller-App und starten Sie sie erneut. Schalten Sie den Steuerungsmodus erneut in der Roboter-App um.

## Bedienung

### Bildschirmsteuerung
Dieser Modus ermöglicht es dem Benutzer, das Roboterauto über zwei Schieberegler im `Dual Drive`-Modus zu steuern. Sie können nach links/rechts lenken, indem Sie den Schieberegler auf jeder Seite nach oben und unten bewegen. Die Räder auf jeder Seite drehen sich vorwärts/rückwärts, wenn Sie den Daumen über/unter die Mitte des Schiebereglers bewegen.

<p float="left">
<img src="../../docs/images/controller_main_screen.png" width="50%" />
</p>

Sie können auch die Blinker links/rechts setzen
<img src="../../docs/images/keyboard_arrow_left-24px.svg" height="24"/>
<img src="../../docs/images/keyboard_arrow_right-24px.svg" height="24"/>
indem Sie auf die Pfeile oben links auf dem Bildschirm klicken und den roten Knopf dazwischen, um abzubrechen.

### Neigen zum Fahren
Der Controller kann auch seinen Beschleunigungssensor verwenden, um den Roboter zu steuern. Wenn Sie diese Option auswählen, wechselt der Controller in einen Vollbildmodus (Zen-Modus), in dem nur das Video und die `Bremse` und `Gaspedal` angezeigt werden. Um diesen Modus zu verlassen, doppeltippen Sie auf den Bildschirm.

Hier ist ein Bild des `Neigemodus`-Bildschirms:

<p float="left">
<img src="../../docs/images/tilt-mode-controller.jpg" width="50%" />
</p>

Verwenden Sie die `Gaspedal`- und `Bremse`-Tasten, um vorwärts/rückwärts zu fahren.

- Durch Drücken des `Gaspedals` beschleunigt der Roboter innerhalb von 2 Sekunden auf volle Geschwindigkeit. Wenn Sie die Taste loslassen, verlangsamt der Roboter bis zum Stillstand (Stoppgeschwindigkeit auf 0% der Höchstgeschwindigkeit eingestellt, kann angepasst werden).
- Durch Drücken der `Bremse`-Taste stoppt der Roboter sofort. Wenn wir die Bremse eine weitere Sekunde halten, beginnt der Roboter rückwärts zu fahren, bis er innerhalb einer Sekunde die maximale Rückwärtsgeschwindigkeit erreicht. Wenn wir die Bremse loslassen, kommt der Roboter zum Stillstand.
- Wir lenken den Roboter, indem wir den Controller nach links oder rechts neigen.

## Zukünftige Entwicklung

Einige der Funktionen, die wir hinzufügen möchten, sind:

- Hinzufügen von Informationen auf dem Controller für weitere Roboter-Sensoren, wie z.B. Batteriestand und Geschwindigkeit.
- Video-Stream von der Kamera des Roboters zum Controller
- Verwendung des Gyroskopsensors des Controllers zur Steuerung des Roboters
- Senden von Crash- und Stoßereignissen vom Roboter zum Controller für ein realistischeres Erlebnis

Hier ist eine [Technische Übersicht](../../docs/technical/OpenBotController.pdf) der Controller-App.
6 changes: 6 additions & 0 deletions android/controller/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Controller App

<p align="center">
<sapn>English</span> |
<a href="README.zh-CN.md">简体中文</a> |
<a href="README.de-DE.md">Deutsch</a>
</p>

This Android app serves as a `remote controller` for the [OpenBot](https://www.openbot.org) vehicle. Basically it performs similar function as PS3/4 or Xbox remote controller, but running on another Android device.

## Connection
Expand Down
Loading
Loading