Frequently Asked Questions
How technical do I need to be to use BUG?
At present, it is our strong recommendation that only Java programmers, or those familiar with developing Linux or Android applications purchase BUG. However BUG is a great place to get started learning embedded development! As our developer community builds useful gadgets with the initial units, we anticipate the entire system getting easier and easier for less technically inclined people to pick up and use BUG.
I already have Eclipse installed. Can I use it with Dragonfly (the BUG SDK)?
You can run Dragonfly (the BUG SDK) using Eclipse version 3.5 or greater.
- Update site URL: http://buglabs.net/sdk/production/current/updatesite/
- See also: Software:SDK Install Guide
Where is all the source code?
- Source code for Bug Labs reside at http://github.com/buglabs.
- Builds and Packages reside here: http://repository.buglabs.net/2.0/
- Source code for Eclipse, the tooling platform on which we build, is available from http://eclipse.org
- Instructions for installing Subclipse, the Eclipse Subversion Client, can be found here: http://subclipse.tigris.org/install.html
- Instructions for building our entire stack from source are here: Software:Openembedded_Build_System
What type of Web services are supported with BUG?
By default, BUG exposes information via RESTful Web services. That is, each resource or entity is accessed via a simple URL such as http://<mybug>/services/location. The HTTP operations GET, PUT, POST, and DELETE are used to manipulate Web service resources. BUG supports a simple service discovery mechanism via the base URL: <tt>http://<bugip>/services
When I create a BUG application I see Activator.java. What's that?
BUG utilizes a runtime environment and service model known as OSGi. This allows applications to be managed in a context of dynamic services. Additionally it enforces a component model and service access pattern that applications use to safely share hardware-based services.
The Activator class, to those who are familiar with java, is analogous to the Main-Class directive in a jar's manifest. It tells the OSGi framework which class to look for and find start() and stop() methods, each of which are the hooks into a bundle's lifecycle.
An introduction to OSGi can be found here.
What version of Java runs on BUG?
By default, the BUG uses an open source Java build called OpenJDK.
Where are the Javadocs?
Glad you asked. It's here: http://bugcommunity.com/development/javadoc/
Java is a registered trademark of Sun Microsystems.
I get an exception when I run a Bundle on BUG
If in the course of your development you come across erratic behavior, check /var/log/felix.log for exceptions. While the OSGi framework is robust, it is not robust enough to verify that your code is correct.
Where is your contact information?
How can I install new apps on my BUG?
There are two main types of applications for BUG: BUGapps and native applications. BUGapps are developed in the Dragonfly SDK and can be shared on BUGnet. Native applications are provided via a package repository and can be installed with command-line tools.
What is the difference? Native applications provide much of the core operating system functionality of the BUG. Additionally, many third-party open source projects are available only via native applications. BUGapps, in contrast are BUG-only applications that use our APIs for BUG modules. BUGapps are the easiest way to explore BUG hardware in Java and web services.
Where are BUGapps stored on my BUG?
The core BUG OSGi bundles are located at /usr/share/java/bundle/. User applications are located at /usr/share/java/apps. com.buglabs.bug.program OSGi bundle is responsible for loading and running bundles found in /usr/share/java/apps directory.
How can I change what programs run when my BUG boots?
The init scripts in /etc/rc.*/ define which programs run on the BUG. Looking in /etc/rc3.d/ and /etc/rc5.d will show most of the programs that start on the BUG.
What countries do you ship to?
BUG 1.3 is FCC, CE and RoHS compliant.
So far, our regulatory compliance is limited to countries in the CE consortium, namely the EU states, including:
- Czech Republic
- United Kingdom
However, this doesn’t include Iceland, Liechtenstein, Norway, or Switzerland :-(
Yes, we ship to:
- United States
No, we don't yet ship to: