Difference between revisions of "BeagleBone Weather"

From eLinux.org
Jump to: navigation, search
(Created page with "==Descriptions== border|right|link=|300px|BeagleBone Weather Cape The BeagleBone Weather Cape provides weather data for the BeagleBone including t...")
 
m (Wmat moved page CircuitCo:BeagleBone Weather to BeagleBone Weather: Removing CircuitCo namespace)
 
(9 intermediate revisions by 3 users not shown)
Line 4: Line 4:
  
  
 
+
'''Note: Revision B is now fully compatible with BeagleBone Black.'''
  
  
Line 19: Line 19:
  
 
==FAQ==
 
==FAQ==
Please visit our [http://beagleboardtoys.com/wiki/index.php?title=FAQ#BeagleBone_Weather_Cape Frequently Asked Questions (FAQ)] page for additional help.
+
Please visit our [http://elinux.org/BeagleBoardToys/FAQ#BeagleBone_Weather_Cape 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===
==Revision Changes==
 
===Revision A1===
 
 
Initial release of BeagleBone Weather Cape
 
Initial release of BeagleBone Weather Cape
  
Line 32: 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://circuitco.com/support/index.php?title=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://circuitco.com/support/index.php?title=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>
  
  
 +
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>
  
 
+
The results are interpreted as 419 lux, 25% humidity, 29 degrees C and 997 millibar.
==Getting Started==
 
Required setup:
 
* A BeagleBone Weather Cape
 
* A BeagleBone (with supporting software)
 
* A USB cable
 
* A computer
 
 
 
 
 
Following the instructions below to start using your BeagleBone Weather Cape:
 
# 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 83: 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 127: Line 122:
  
 
==Signal Usage==
 
==Signal Usage==
[[File:Weather-pin-BBT.jpg|right|link=|BeagleBone Weather Pin Usage]]
+
[[File:Weather-pin.jpg|right|link=|BeagleBone Weather Pin Usage]]
 
The BeagleBone Weather Cape uses 4 signals including:
 
The BeagleBone Weather Cape uses 4 signals including:
 
* VDD_3V3EXP
 
* VDD_3V3EXP
Line 133: Line 128:
 
* I2C2_SDA
 
* I2C2_SDA
 
* GND
 
* GND
 
 
  
 
==EEPROM==
 
==EEPROM==
Line 145: Line 138:
 
|-
 
|-
 
|Version
 
|Version
|00A0
+
|00B0
 
|-
 
|-
 
|Manufacturer
 
|Manufacturer
Line 154: Line 147:
 
|-
 
|-
 
|Pins Used
 
|Pins Used
|12
+
|11
 
|}
 
|}
  
Line 160: Line 153:
  
 
==Distributors==
 
==Distributors==
* [http://boardzoo.com/product_info.php?products_id=97 BoardZoo (USA)]
+
* [http://boardzoo.com/index.php/bone-weather.html BoardZoo]
* [http://www.digikey.com/scripts/dksearch/dksus.dll?vendor=0&keywords=BB-BONE-WTHR-01 Digikey (USA)]
+
* Please visit [http://beagleboardtoys.com/wheretobuy.html Where To Buy] for a list of other distributors who carry BeagleBoardToys' capes.
* [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 180: Line 170:
  
 
==Documentations==
 
==Documentations==
 +
===Hardware Files===
 +
====BeagleBone Weather Revision B====
 +
* [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]
  
===System Reference Manual===
 
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/master/BeagleBone-Weather-RevA-srm.pdf?raw=true Latest]
 
  
 +
====BeagleBone Weather Revision A====
 +
* [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/blob/Rev_A/BeagleBone-Weather-RevA-manufacturing.zip?raw=true Manufacturing Files]
 +
* [https://github.com/CircuitCo/BeagleBone-Weather/blob/Rev_A/BeagleBone-Weather-RevA-schematic.pdf?raw=true Schematic (PDF)]
 +
* [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]
  
===Hardware Files===
+
 
====BeagleBone Weather Revision A====
+
 
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-bom.xls?raw=true Bill of Materials]
+
To go back to the cape list, please click [http://elinux.org/Beagleboard:BeagleBone_Capes here]
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-manufacturing.zip?raw=true Manufacturing Files]
 
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-schematic.pdf?raw=true Schematic (PDF)]
 
* [https://github.com/CircuitCo/BeagleBone-Weather-RevA/blob/master/BeagleBone-Weather-RevA-schematic.dsn?raw=true Schematic (OrCAD)]
 
To download all files at once please click [https://github.com/CircuitCo/BeagleBone-Weather-RevA/zipball/master here]
 

Latest revision as of 07:20, 1 August 2017

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 419 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

  • BoardZoo
  • Please visit Where To Buy for a list of other 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