Skip to content

Releases: isl-org/OpenBot

v0.2.0

21 Jan 21:57
@thias15 thias15
v0.2.0
b65d132
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.0

The following summarizes the changes compared to the previous release v0.1.1.

Full Changelog: v0.1.1...v0.2.0

Android Apps

Robot

The app has the following known issues:

  • Incorrect mapping of common BT game controllers (e.g. Xbox, PS4, Nvidia Shield, etc.) may occur on Android versions before Pie (9.0), see this article for more info. On the bright side, Android 11 supports many more controllers, see this article for more infos.

Controller

  • New companion app that can be installed on another phone to control the OpenBot, thanks @izivkov for #137

You can download the apks from the resources below and install them on your phone directly. Note, that the app is signed only with a debug key. Alternatively, you can build the app yourself.

Documentation

  • Update Chinese docs, thanks @wangruoyao for #139
  • Add documentation for controller app, thanks @izivkov for #140
  • Add cool OpenBot projects, #145
  • Refactor documentation to separate robot and controller apps, #149

CAD Files

  • Fix STL files for glue body, #150

Policy

Contributors

sanyatuning, francisduvivier, and 3 other contributors
Assets 4
Loading

v0.1.1

07 Dec 22:46
@thias15 thias15
v0.1.1
7982539
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.1.1

The following summarizes the changes compared to the previous release v0.1.0.

Full Changelog: v0.1.0...v0.1.1

Documentation / CI

Firmware

  • Major refactoring to make code more readable and compact
  • Removed NewPing library due to many reported issues (e.g. interference on pin 8, pin 3 and 11 not usable as PWM, etc.)
  • Use PinChangeInterrupt to allow for interrupts on all pins by parsing port interrupts
  • Implemented interrupt based ultrasonic sensor readings
  • Implemented interrupt based speed sensor readings for all hardware configurations
  • All main features/sensors can enabled/disabled with flags so the firmware only contains the functionalities needed and is as fast and extensible as possible
  • Improved NO_PHONE_MODE
  • Added OLED support to display vehicle state on the robot, thanks @custom-build-robots for #92

Android App

  • Added switch to toggle front/back camera, thanks @vkuehn for #115
  • Fixed #78: person following will now work correctly in any orientation of the phone
  • Added upload service for automatic log upload to http server, thanks @sanyatuning for #121

The app has the following known issues:

  • Some users with very old smartphones have reported incorrect mapping of the game controller
  • Only BT controllers detected as gamepad work (e.g. Xbox, PS4, Nvidia Shield, etc.)

You can download the apk from the resources below and install it on your phone directly. Note, that the app is signed only with a debug key. Alternatively, you can build the app yourself. If you want to deploy your own model, this is currently necessary.

Policy

  • Added python http server to receive logs from app and visualize them in browser, thanks @sanyatuning for #121

Contributors

sanyatuning, francisduvivier, and 5 other contributors
Assets 3
Loading

v0.1.0

30 Sep 14:43
@thias15 thias15
v0.1.0
686b372
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.1.0

This is the first release. Several people were able to complete all parts of the project. The project is evolving and things may change a lot. The following summarizes current features and known issues for the different components.

Full Changelog: https://github.com/isl-org/OpenBot/commits/v0.1.0

3D-printed body

There are 3 different versions available, the regular body, the slim body and the glueable body. Depending on the build plate size of your 3D printer, at least one of those models should work. There are no known issues, but in the DIY version it is a bit challenging to fit all the wiring into the body.

Assembly

The repo includes instructions for a DIY build which is recommended for building a single robot to try out the project. In order to reduce the wiring and make assembly easier, a custom PCB is also available.

Custom PCB

There are two PCBs available, V1 and V2. Both versions of the PCB are supported by the Arduino firmware. However, there is no reason to order PCB V1 anymore, since PCB V2 has the same features and several (mostly minor) improvements:

  • Move the right speed sensor to pin D3 to enable interrupt functionality
  • Add Power LED for main battery
  • Update some components which are more commonly available
  • Update voltage divider to 20k/10k for better precision
  • Change motor connectors to upright version for easier access

Both PCBs have one known issue: When the ultrasonic sensor is used, the NewPing library causes an issue at pin 8. As a result, the right indicator light is very dim.

Firmware

The firmware has the following features:

  • support for three configurations: DIY, PCB_V1 and PCB_V2
  • receive control commands from Android application (USB serial)
  • produce low-level controls (PWM) for the vehicle
  • toggle left and right indicator signals
  • wheel odometry based on optical speed sensors
  • estimate battery voltage via voltage divider
  • estimate distance based on sonar sensor
  • send sensor readings to Android application (USB serial)

The firmware currently only supports the Arduino Nano microcontroller. However, porting it to other microcontrollers should be straight-forward. There are no known issues.

Android App

The app has the following features:

  • BT game controller interface for manual control of OpenBot
  • 3 different vehicle speeds (Slow - 50%, Normal - 75%, Fast - 100%)
  • Run neural network for person following
  • Run neural network for autonomous navigation
  • Data logger to collect datasets for training of autonomous driving policy

The app has the following known issues:

  • If the phone is mounted in the wrong orientation, the person following will drive in the opposite direction
  • On some phones (e.g. Asus Zenfone Max Pro (M2) ZB631KL) the front and rear camera are reversed (see issue #15)
  • Some users with very old smartphones have reported incorrect mapping of the game controller
  • Only BT controllers detected as gamepad work (e.g. Xbox, PS4, Nvidia Shield, etc.)

You can download the apk from the resources and install it on your phone directly. Note, that the app is signed only with a debug key. Alternatively, you can build the app yourself. If you want to deploy your own model, this is currently necessary.

The app was tested across 10 different smartphones from the past two years and works on all of them.

Jupyter Notebook

The notebook has the following features:

  • Data preprocessing and augmentation
  • Train neural networks for autonomous navigation (predefined models available)
  • Monitor training progress in tensorboard (live) and plot the evolution of several metrics (after training)
  • Visualize training data with labels and corresponding policy prediction
  • Convert the trained policy to a tflite model for deployment in the Android application

There are no known issues, but training a driving policy requires a lot of resources and may slow down or even freeze your machine. It is recommended to use a high-end laptop or workstation with large amount of RAM and dedicated GPU, especially when training with larger batch sizes. The documentation is currently also not very detailed.

What's Changed

Contributors

a-to-the-5, francisduvivier, and 6 other contributors
Assets 3
Loading