Difference between revisions of "BeagleBone Weather"

From eLinux.org
Jump to: navigation, search
(update for revision B)
(One intermediate revision by one other user not shown)
Line 4: Line 4:
  
  
 
+
'''Note: Revision B is now fully compatible with BeagleBone Black.'''
  
  
Line 22: Line 22:
  
 
==Revision Changes==
 
==Revision Changes==
===Revision A1===
+
===Revision B===
 +
* SHT21 has become obsolete and is replaced by Measurement Specialties' HPP828E031.
 +
* The Weather is now fully supported with BeagleBone Black using kernel release 3.8.13-bone45 or later. Following changes have been made to the BeagleBone Black' kernel:
 +
** Add support for Measurement Specialties chip
 +
** Remove the conflict pin between revision A and the BBB's eMMC (GPIO1_3)
 +
* Pin 6 of P1 connector is removed from the board to eliminate the eMMC signal integrity issue when using Weather Cape with BBB.
 +
 
 +
 
 +
===Revision A===
 
Initial release of BeagleBone Weather Cape
 
Initial release of BeagleBone Weather Cape
  
Line 29: Line 37:
  
 
==Software Support==
 
==Software Support==
* BeagleBone Weather Cape revision A is supported by Angstrom release 06-18-12 or later.
+
* BeagleBone Weather Cape revision A is supported in Angstrom release 06-18-12 or later when using with the original BeagleBone (White). To use this revision with BeagleBone Black, there is a work-around method [http://elinux.org/Beagleboard:Weather_Cape_Work-Around here].
 +
* BeagleBone Weather Cape revision B is supported in kernel release 3.8.13-bone45 or later. This version is fully compatible with BeagleBone Black.
  
  
* Major BeagleBone image releases can be downloaded [http://elinux.org/CircuitCo/BeagleBone#Image_Files here].
+
* BeagleBone software releases can be downloaded [http://elinux.org/Beagleboard:BeagleBoneBlack#Software_Resources here]
* Intermediate BeagleBone image releases can be downloaded [http://www.angstrom-distribution.org/demo/beaglebone/ here]
+
* Follow instructions [http://elinux.org/Beagleboard:Updating_The_Software here] to write an image file to your SD card on a Windows machine.
  
  
Please follow the instructions [http://elinux.org/CircuitCo/BeagleBone#Image_Files here] to write the image file to your SD card on a Windows machine.
+
==Getting Started==
 +
The Weather Cape should be automatically loaded when using with BeagleBone Black as follow. The eMMC is also loaded since its conflict with the Weather Cape has been removed for revision B.
 +
<code>
 +
  0: 54:P---L BeagleBone WEATHER CAPE,00B0,Beagleboardtoys,BB-BONE-WTHR-01
 +
  1: 55:PF---
 +
  2: 56:PF---
 +
  3: 57:PF---
 +
  4: ff:P-O-L Bone-LT-eMMC-2G,00A0,Texas Instrument,BB-BONE-EMMC-2G
 +
  5: ff:P-O-L Bone-Black-HDMI,00A0,Texas Instrument,BB-BONELT-HDMI
 +
</code>
  
==Getting Started==
 
Required setup:
 
* A BeagleBone Weather Cape
 
* A BeagleBone (with supporting software)
 
* A USB cable
 
* A computer
 
  
 +
To view all sensor inputs at once, use the command below:
 +
<code>
 +
  for sensor in /sys/bus/i2c/devices/i2c-1/*/*_input; do echo -n "$(basename $sensor): "; cat $sensor; done
 +
</code>
 +
You should see something like this
 +
<code>
 +
    lux1_input: 419
 +
    humidity1_input: 25257
 +
    temp1_input: 29273
 +
    pressure0_input: 99692
 +
    temp0_input: 291
 +
</code>
  
Following the instructions below to start using your BeagleBone Weather Cape:
+
The results are interpreted as 42 lux, 25% humidity, 29 degrees C and 997 millibar.
# Mount the BeagleBone Weather on top of BeagleBone.
 
# Make sure the micro SD card using with BeagleBone has latest Angstrom image.
 
# Power up the BeagleBone using a 5V DC power supply.
 
# Connect the BeagleBone to a computer via USB cable.
 
# Open a Terminal application (Teraterm, Hyperterminal, etc) and open a new connection with following settings:
 
#* Baud rate - 115200
 
#* Data – 8 bit
 
#* Parity – none,
 
#* Stop – 1 bit
 
#* Flow control – none.
 
#* You should see an Angstrom log in prompt on the terminal window. If not, press Enter to show the log in prompt
 
# Run the following command to display the outputs of all sensors:
 
#* for sensor in /sys/devices/platform/omap/omap_i2c.3/i2c-3/*/*_input ; do echo -n "$(basename $sensor): " ; cat $sensor ; done
 
# You should see something like this on the terminal window:
 
#* lux1_input: 27
 
#* humidity1_input: 38143
 
#* temp1_input: 26927
 
#* pressure0_input: 101264
 
#* temp0_input: 270
 
# The I2C outputs are interpreted as 27 lux, 38% humidity, 27 degrees C and 1013 millibar.
 
  
  
Line 76: Line 80:
 
===Electrical Specifications===
 
===Electrical Specifications===
 
{|class="wikitable"
 
{|class="wikitable"
|rowspan="4"|Sensor Data
+
|rowspan="3"|Sensors
|Temperature
+
|[https://github.com/CircuitCo/BeagleBone-Weather/blob/docs/HTU21D.pdf?raw=true HTU21D] (Humidity and Temperature)
 
|-
 
|-
|Barometric pressure
+
|[https://github.com/CircuitCo/BeagleBone-Weather/blob/docs/BMP085.pdf?raw=true BMP085] (Pressure and Temperature)
 
|-
 
|-
|Relative humidity
+
|[https://github.com/CircuitCo/BeagleBone-Weather/blob/docs/TSL2550.pdf?raw=true TSL2550] (Ambient Light)
|-
 
|Ambient light
 
 
|-
 
|-
 
|Data Interface
 
|Data Interface
Line 136: Line 138:
 
|-
 
|-
 
|Version
 
|Version
|00A0
+
|00B0
 
|-
 
|-
 
|Manufacturer
 
|Manufacturer
Line 145: Line 147:
 
|-
 
|-
 
|Pins Used
 
|Pins Used
|12
+
|11
 
|}
 
|}
  
Line 151: Line 153:
  
 
==Distributors==
 
==Distributors==
* [http://boardzoo.com/product_info.php?products_id=97 BoardZoo (USA)]
+
Please visit [http://beagleboardtoys.com/wheretobuy.html Where To Buy] for a list of distributors who carry BeagleBoardToys' capes.
* [http://www.digikey.com/scripts/dksearch/dksus.dll?vendor=0&keywords=BB-BONE-WTHR-01 Digikey (USA)]
 
* [http://uk.farnell.com/circuitco/bb-bone-wthr-01/board-beaglebone-weather-cape/dp/2144195?Ntt=BB-BONE-WTHR-01 Farnell (UK)]
 
* [http://www.mouser.com/ProductDetail/BeagleBoard-by-CircuitCo/BB-BONE-WTHR-01/?qs=sGAEpiMZZMv8qfsbmFratNqxdEf55xLH Mouser Electronics (USA)]
 
* [http://www.tigal.com/product/2923 Tigal (Austria)]
 
  
  
Line 171: Line 169:
  
 
==Documentations==
 
==Documentations==
 
+
===Hardware Files===
===System Reference Manual===
+
====BeagleBone Weather Revision B====
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/master/BeagleBone-Weather-RevA-srm.pdf?raw=true Latest]
+
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/Rev_B/BeagleBone-Weather-RevB-bom.xls?raw=true Bill of Materials]
 +
Remaining design files are same as revision A. To download all files at once please click [https://github.com/CircuitCo/BeagleBone-Weather/archive/Rev_B.zip here]
  
  
===Hardware Files===
 
 
====BeagleBone Weather Revision A====
 
====BeagleBone Weather Revision A====
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-bom.xls?raw=true Bill of Materials]
+
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/Rev_A/BeagleBone-Weather-RevA-srm.pdf?raw=true System Reference Manual]
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-manufacturing.zip?raw=true Manufacturing Files]
+
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/Rev_A/BeagleBone-Weather-RevA-bom.xls?raw=true Bill of Materials]
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-schematic.pdf?raw=true Schematic (PDF)]
+
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/Rev_A/BeagleBone-Weather-RevA-manufacturing.zip?raw=true Manufacturing Files]
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-schematic.dsn?raw=true Schematic (OrCAD)]
+
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/Rev_A/BeagleBone-Weather-RevA-schematic.pdf?raw=true Schematic (PDF)]
To download all files at once please click [https://github.com/CircuitCo/BeagleBone-Weather-RevA/zipball/master here]
+
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/Rev_A/BeagleBone-Weather-RevA-schematic.dsn?raw=true Schematic (OrCAD)]
 +
To download all files at once please click [https://github.com/CircuitCo/BeagleBone-Weather/archive/Rev_A.zip here]
  
  
  
To go back to the cape list, please click [http://elinux.org/BeagleBoardToys here]
+
To go back to the cape list, please click [http://elinux.org/Beagleboard:BeagleBone_Capes here]

Revision as of 12:33, 8 April 2014

Descriptions

BeagleBone Weather Cape

The BeagleBone Weather Cape provides weather data for the BeagleBone including temperature, barometric pressure, humidity, and ambient light. These weather input data can be accessed via I2C bus. The BeagleBone Weather Cape also features an LED to indicate that power is applied.


Note: Revision B is now fully compatible with BeagleBone Black.







FAQ

Please visit our Frequently Asked Questions (FAQ) page for additional help.

Revision Changes

Revision B

  • SHT21 has become obsolete and is replaced by Measurement Specialties' HPP828E031.
  • The Weather is now fully supported with BeagleBone Black using kernel release 3.8.13-bone45 or later. Following changes have been made to the BeagleBone Black' kernel:
    • Add support for Measurement Specialties chip
    • Remove the conflict pin between revision A and the BBB's eMMC (GPIO1_3)
  • Pin 6 of P1 connector is removed from the board to eliminate the eMMC signal integrity issue when using Weather Cape with BBB.


Revision A

Initial release of BeagleBone Weather Cape



Software Support

  • BeagleBone Weather Cape revision A is supported in Angstrom release 06-18-12 or later when using with the original BeagleBone (White). To use this revision with BeagleBone Black, there is a work-around method here.
  • BeagleBone Weather Cape revision B is supported in kernel release 3.8.13-bone45 or later. This version is fully compatible with BeagleBone Black.


  • BeagleBone software releases can be downloaded here
  • Follow instructions here to write an image file to your SD card on a Windows machine.


Getting Started

The Weather Cape should be automatically loaded when using with BeagleBone Black as follow. The eMMC is also loaded since its conflict with the Weather Cape has been removed for revision B.

  0: 54:P---L BeagleBone WEATHER CAPE,00B0,Beagleboardtoys,BB-BONE-WTHR-01
  1: 55:PF--- 
  2: 56:PF--- 
  3: 57:PF--- 
  4: ff:P-O-L Bone-LT-eMMC-2G,00A0,Texas Instrument,BB-BONE-EMMC-2G
  5: ff:P-O-L Bone-Black-HDMI,00A0,Texas Instrument,BB-BONELT-HDMI


To view all sensor inputs at once, use the command below:

  for sensor in /sys/bus/i2c/devices/i2c-1/*/*_input; do echo -n "$(basename $sensor): "; cat $sensor; done

You should see something like this

   lux1_input: 419
   humidity1_input: 25257
   temp1_input: 29273
   pressure0_input: 99692
   temp0_input: 291

The results are interpreted as 42 lux, 25% humidity, 29 degrees C and 997 millibar.



Specifications

Followings are some specifications of the BeagleBone Weather Cape:

Electrical Specifications

Sensors HTU21D (Humidity and Temperature)
BMP085 (Pressure and Temperature)
TSL2550 (Ambient Light)
Data Interface Two-wire
Power 3.3V via expansion header
Indicators Power LED
Connectors Two 46-position headers
One 10-position header


Mechanical Specifications

Size 2.15" x 3.40"
Layers 2
PCB Thickness .062"
RoHS Compliant Yes



Signal Usage

BeagleBone Weather Pin Usage

The BeagleBone Weather Cape uses 4 signals including:

  • VDD_3V3EXP
  • I2C2_SCL
  • I2C2_SDA
  • GND

EEPROM

EEPROM Suport Yes
Board Name BeagleBone Weather Cape
Version 00B0
Manufacturer BeagleBoardToys
Part Number BB-BONE-WTHR-01
Pins Used 11


Distributors

Please visit Where To Buy for a list of distributors who carry BeagleBoardToys' capes.



Product Images



Documentations

Hardware Files

BeagleBone Weather Revision B

Remaining design files are same as revision A. To download all files at once please click here


BeagleBone Weather Revision A

To download all files at once please click here


To go back to the cape list, please click here