You are viewing outdated content for BUG. If you have a BUG Y.T. edition or 2.0 series device, please visit our updated wiki: http://wiki.buglabs.net

From BUG Wiki

The GPS Module

BUGlocate is a GPS receiver for BUG, great for tracking or mapping. The module includes both an internal passive antenna and a connector for an external active antenna.

Contents 1 Product Specifications 2 Hardware Documentation 3 Software Documentation 3.1 Drivers 3.2 OSGi Services 3.3 Web Services

Product Specifications

• SiRF chipset based implementation
• Support for active (external) and passive (internal) antenna configurations capable of tracking signals as low as -159 dBm (with active antenna)
• Selectable NMEA-0183/SiRF: latitude, longitude, elevation, velocity, heading, time, tracking status
• Receiver sensitivity:
  • Cold start: -144 dBm
  • Hot start: -155 dBm
  • Navigation: -157 dBm
  • Tracking: -159 dBm
• Satellite tracking capability: 20 simultaneous satellites
• Typical acquisition performance @ -140dBm:
  • Hot start 500 – ms
  • Warm start – 32s
  • Cold start – 34s
• Active antenna port: 50 Ohm, Snap In MCX jack,
• Active antenna available power: 3 – 3.3 Vdc, 50mA. Short circuit protected
• Environmental: RoHS compliant, -40 to +85°C, 95% Relative humidity
• Altitude: -300 to 18,000 meters
• Velocity: up to 500 M/s
• Acceleration: Up to 5 G

Hardware Documentation

• BUGlocate Design Spec. (pdf)
• BUGlocate layout - top (pdf)
• BUGlocate layout - bottom (pdf)
• BUGlocate schematic (pdf)
• BUGlocate schematic & signal assignments (pdf)
• BUGlocate BOM (zip)
• BUGlocate board file (zip)
• BUGlocate wired antenna spec & assembly (zip)
• BUGlocate assembly files (zip)
• BUGlocate mechanical files (zip)
• BUGlocate gerber files (zip)

Software Documentation

Drivers

All BUG drivers can be found in the BUGlabs SVN.

The BUGlocate drivers handle the basic operation of the module. IOCTL commands can be used to:

• Start and reset the module
• Control LED operation
• Read the IOX register
• Select the active (external) or passive (internal) antenna for receiving positioning information

OSGi Services

Method documentation for all OSGi services (from BUG and from other users) is available in the javadocs. The services listed below can be found in the com.buglabs.bug.module.gps.pub package in the latest revision of the BUG javadocs. Each service is an interface with its own methods.

• IGPSModuleControl – basic module controls & interaction with base (extends IModuleControl and IModuleLEDController)
• INMEARawFeed – Service for detecting raw GPS data
• INMEASentenceProvider – Service for accessing NMEA data from GPS devices
• INMEASentenceSubscriber – Service for receiving NMEA sentence events
• IPositionProvider – Service for describing location services
• IPositionSubscriber – Service for receiving changes in position

Web Services

When a BUGlocate module is attached, the BUGlocate web service becomes available, providing GPS information (latitude, longitude, etc.). Example:

<Location>
 <Latitude>0.7110355017341432 rad</Latitude>
 <Longitude>-1.291375513091195 rad</Longitude>
 <Altitude>0.0 m</Altitude>
 <LatitudeDegrees>40.739333333333335</LatitudeDegrees>
 <LongitudeDegrees>-73.99036666666666</LongitudeDegrees>
</Location>