![]() |
base_controller package from android_base_controller repobase_controller |
|
Package Summary
Tags | No category tags. |
Version | 0.1.4 |
License | Apache 2.0 |
Build type | CATKIN |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/creativa77/base_controller.git |
VCS Type | git |
VCS Version | master |
Last Updated | 2014-04-10 |
Dev Status | UNMAINTAINED |
CI status | No Continuous Integration |
Released | UNRELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Package Description
Additional Links
Maintainers
- Lucas Chiesa
Authors
base_controller
This base controller for ROS on Android allows the user to drive the Kobuki or Create bases from an Android device directly connected to the desired base via USB.
Building
To build this package you can just use gradlew
from the command line, or
you can put the package inside a catkin workspace and built it with
catkin_make
.
Requirements
In order to use this code to drive a Create or a Kobuki base, an Android device with USB On The Go (OTG) is needed. A usb-otg cable is also needed.
We tested this code in:
- Nexus 7
- Nexus 7 2013
- Galaxy S4 Google Edition
Usage
These code fragments show how to use this package to create a Kobuki driver in an ROS Activity. For the Create base you should simple replace Kobuki with Create.
Import the USB library:
import com.hoho.android.usbserial.driver.UsbSerialDriver;
import com.hoho.android.usbserial.driver.UsbSerialProber;
Import the ROS nodes and the base drivers:
import com.github.c77.base_controller.BaseControllerNode;
import com.github.c77.base_controller.BaseStatusPublisher;
import com.github.c77.base_driver.kobuki.KobukiBaseDevice;
You can instantiate the nodes when creating the Main ROS Activity:
public MainActivity() {
super("MainActivity", "MainActivity");
baseControllerNode = new BaseControllerNode("/cmd_vel");
baseStatusPublisher = new BaseStatusPublisher();
}
In the init method of the Node, we use the USB library to find the device and create the base driver. After creating the base driver, we can set the device to the two nodes.
// Get UsbManager from Android.
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
// Find the first available driver.
UsbSerialDriver driver = UsbSerialProber.findFirstDevice(manager);
// Create the low level base device.
KobukiBaseDevice kobukiBaseDevice = new KobukiBaseDevice(driver);
baseControllerNode.setBaseDevice(kobukiBaseDevice);
baseStatusPublisher.setBaseDevice(kobukiBaseDevice);
After this point use the nodeMainExecutor to launch the nodes.
Wiki Tutorials
Source Tutorials
Package Dependencies
Deps | Name | |
---|---|---|
1 | android_core | |
1 | rosjava_build_tools | |
0 | usb_serial_for_android | |
1 | catkin |
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged base_controller at answers.ros.org
![]() |
base_controller package from android_base_controller repobase_controller |
|
Package Summary
Tags | No category tags. |
Version | 0.2.0 |
License | Apache 2.0 |
Build type | CATKIN |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/creativa77/base_controller.git |
VCS Type | git |
VCS Version | kinetic |
Last Updated | 2017-03-01 |
Dev Status | UNMAINTAINED |
CI status | No Continuous Integration |
Released | UNRELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (0)
Good First Issues (0) Pull Requests to Review (0) |
Package Description
Additional Links
Maintainers
- Lucas Chiesa
Authors
base_controller
This base controller for ROS on Android allows the user to drive the Kobuki or Create bases from an Android device directly connected to the desired base via USB.
Building
To build this package you can just use gradlew
from the command line, or
you can put the package inside a catkin workspace and build it with
catkin_make
.
Requirements
In order to use this code to drive a Create or a Kobuki base, an Android device with USB On The Go (OTG) is needed. A usb-otg cable is also needed.
We tested this code in:
- Nexus 7
- Nexus 7 2013
- Galaxy S4 Google Edition
Usage
These code fragments show how to use this package to create a Kobuki driver in a ROS Activity. For the Create base you should simply replace Kobuki with Create.
First, import the USB library. You can use the available Maven Artifact if you don't want to build it from source.
To do so, add the following dependency in your module's build.gradle
:
dependencies {
...
compile 'com.hoho.android:usb-serial-for-android:[0.2, 0.3)'
...
}
Then, import the new objects in your Java source file:
import com.hoho.android.usbserial.driver.UsbSerialDriver;
import com.hoho.android.usbserial.driver.UsbSerialPort;
import com.hoho.android.usbserial.driver.UsbSerialProber;
Import the ROS nodes and the base drivers:
import com.ekumen.base_controller.BaseControllerNode;
import com.ekumen.base_controller.BaseStatusPublisher;
import com.ekumen.base_driver.kobuki.KobukiBaseDevice;
In the init
method of your RosActivity
, use the USB library to find a driver, get a port and a connection.
Then, use them to create the Base Devices required to instantiate the nodes:
// Get UsbManager from Android.
UsbManager manager = (UsbManager) getSystemService(Context.USB_SERVICE);
// Get a driver list
List<UsbSerialDriver> driverList = UsbSerialProber.getDefaultProber().findAllDrivers(usbManager);
// Continue only if we have a single driver in the list
if (driverList.isEmpty()) {
throw new Exception("No drivers found for the supplied USB device: " + device);
}
// Use first available driver to get Port and Connection
UsbSerialDriver driver = driverList.get(0);
UsbDeviceConnection connection = manager.openDevice(driver.getDevice());
UsbSerialPort port = driver.getPorts().get(0);
// Create the low level base device using the created Port and Connection
BaseDevice kobukiBaseDevice = new KobukiBaseDevice(port, connection);
// Create the nodes using the Base Device
BaseControllerNode baseControllerNode = new BaseControllerNode(kobukiBaseDevice, "/cmd_vel");
BaseStatusPublisher baseStatusPublisher = new BaseStatusPublisher(kobukiBaseDevice);
After this point, use the nodeMainExecutor
to launch the nodes in the standard Rosjava way.
Maven Artifact
You can use base_controller in your project using the available Maven Artifact instead of building it from source.
To do so, add the following dependency to your modules's build.gradle
:
dependencies {
...
compile 'com.ekumen.base_controller:base_controller_lib:[0.2, 0.3)'
...
}
Note: to do this, the rosjava_mvn_repo should be available in your listed repositories.
The easiest way to ensure it is using the kinetic standard top-level build.gradle
in your project (you can use base_controller's build.gradle as an example).
Changelog for package base_controller
0.2.0 (2017-02-22)
- Using the latest version of UsbSerialLibrary from public repository.
- Refactored com.github.c77 package name to com.ekumen.
- Corrected package name in manifest.
- Updated rosjava dependency to [0.3, 0.4)
- Dev: Higher odom publish frequency & tf child frame renamed
- Odom publish rate changed to 100 Hz using ROS functions. base_link changed to base_footprint (odometry should be published against a frame at ground level)
- Feature: safe stop
- Added safe stop in case cmd_vel are lost for a period of time (1s).
- Upgrade: new buildscripts and Kinetic dependencies
- Update rosjava bootsrap required version to current version
- Depend on catkinized hoho USB library.
- Update the usb library to work with the laser. Added a TODO note to remind us of changing the Laser link tf broadcasting.
- General clean-up and commenting, particularly of Husky base
- Simplify base nodes by requiring BaseDevice in the constructor
- Kobuki odometry fix
- Properly handle odometry count overflow. Kobuki odometry works currently now.
- Be a little bit more strict and Java-ish with driver for BaseDevice
- Publish odometry in odom
- Change the odometry topic to /odom Adds odometry publishing to Husky base controller
- Added tf publisher.
- Working Husky package parser
- Modified accel value which should have two bytes of length.
- Added HuskyBaseDevice initial implementation
- Update deps to use the new android_10 name.
- Add a short documentation to README file.
- Initial code release for the Base Controller
- Initial commit
- Contributors: Chad Rockey, Juan Ignacio Ubeira, Julian Cerruti, Lucas Chiesa, Sebastian Garcia Marra, tulku
Wiki Tutorials
Source Tutorials
Package Dependencies
Deps | Name | |
---|---|---|
1 | android_core | |
1 | rosjava_build_tools | |
0 | usb_serial_for_android_catkin | |
1 | catkin |