PiWire+ User Manual February 2016

Transcription

1 February 0

2 Table of Contents Features Technical Specifications Installation Enclosure Board Overview -Wire Connector (K-K) IC Connector (K) IC Bus Slave Addresses Bus Speed Real-time Clock -Wire Controllers Software Real-time Clock -Wire Automation Software owfs ESD/Lightning Protection 0 Legal Information Disclaimer Trademarks 9 Contact Information Revision History Date Authors Description Peter S'heeren Initial release Peter S'heeren Renamed AbioWire+ to. Second release.

3 Features -Wire adapter with three -Wire controllers providing a total of seventeen -Wire channels. Connector for IC bus operating at V. Battery backed up real-time clock and calendar with integrated temperature compensated crystal oscillator and a. khz quartz crystal. Designed for use with Raspberry Pi model A+, model B+, and model. Incorporates EEPROM as defined by the HAT specification. Slot for camera cable is provided. Cutout for display cable is provided. Supported by -Wire Automation Software. Supported by the owfs software package. Applications include: Weather station. Home automation. Technical Specifications Dimensions mm x mm x mm (W x D x H) Weight g (without battery) RTC backup power 0 years

4 Installation First of all, place a CR0 battery in the battery holder on the backside of the. Note that when no battery is present, the will work correctly except the realtime clock won't keep the time when the system is powered down. A dedicated enclosure is available. The enclosure ensures the fits correctly on the computer. If you decide to provide your own enclosure, or no enclosure at all, then be sure to fix the in such a way its backside can't touch the computer. Enclosure A laser-cut acrylic enclosure specifically designed for the and Raspberry Pi combo is available. The enclosure comes with holes on top for connecting -Wire devices and IC devices to the dedicated pin headers. The enclosure is available in four different colors (black, white, brown, blue).

5 Board Overview Mark Label K IC connector K DS-00 -Wire controller C connector K-K DS-00 -Wire controller A connectors Description K9-K DS-00 -Wire controller B connectors K9 - B - GPIO female connector Slot for camera cable RTC backup power battery, V type CR0 Cutout for display cable

6 -Wire Connector (K-K) Mark Description V DQ This connector is typically used to connect a -Wire channel to a -Wire slave with a similar connector, or a breakout board. IC Connector (K) Mark Description V SDA SCL Connection to the IC bus on the. This IC bus operates at V.

7 IC Bus Slave Addresses The IC bus on the interconnects your Raspberry Pi computer with a set of IC slave devices. The slave addresses are: Address Slave Device 0000b PCF9A real-time clock 00000b -Wire controller A, DS-00, channels 0000b -Wire controller B, DS-00, channels 0000b -Wire controller C, DS-00, channel Bus Speed The supports a maximum bus speed of 00 khz. Real-time Clock The PCF9A is a real-time clock and calendar with an integrated temperature compensated crystal oscillator and a. khz quartz crystal. The PCF9A has a backup battery switch-over circuit, a programmable watchdog function, a timestamp function, and many other features. The board has a holder for a CR0 battery that functions as backup power for the PCF9A. -Wire Controllers The three -Wire controllers allow software to communicate with three -Wire slaves concurrently. The -Wire controllers provide a total of seventeen -Wire channels.

8 Software Real-time Clock You can install the abiocard package to take advantage of the real-time clock. It's available from the Axiris website. With the abiocardgui program, you can connect with the RTC on the and get and set the date and time. -Wire Automation Software The -Wire Automation Software supports the as well as a detection procedure for figuring out the interface to use on your Raspberry Pi. Client command Adapter Add can be used in various ways. adapter "" add bscdetect abiowire The command tells the server to detect how to interface with the. adapter "" add bsc abiowire The server uses direct I/O with BSC to interface with the. adapter "" add icdev "/dev/ic-" abiowire The server uses the ic-dev subsystem to interface with the. Note that the keywords abiowire is reused for since the is compatible with the original AbioWire. owfs The can be used with owfs, the -Wire File System. This software package is available from the following website: The owfs software includes programs that expose the -Wire hardware in a variety of ways to the system: owfs: Creates a file system in a specified mount directory. This program requires software package libfuse. owhttpd: Sets up a web server. owftpd: Sets up an FTP server. owserver: A server that allows multiple client programs to access the -Wire hardware. These programs support a uniform command line syntax for specifying which -Wire adapters to detect and to expose. For the, the --ic command line option is of importance. Suppose you want to set up a web server that listens to port 0. Suppose the is connected to BSC of the Raspberry Pi computer. Enter the following command as root in the bin directory of owfs:

9 #./owhttpd -p 0 -ic=/dev/ic-:0 -ic=/dev/ic-: -ic=/dev/ic-: The /dev/ic-<n>:<i> syntax denotes offset <n> from IC address 00000b on IC bus of <i>. The mentioned command line syntax thus tells owhttpd to look for -Wire controllers at addresses 00000b, 0000b and 0000b on the IC bus of BSC. The type of -Wire controller doesn't need to be specified; the owfs software will distinguish between a DS-00 chip and a DS-00 chip. Refer to the owfs documentation for more information. 9

10 ESD/Lightning Protection When you're planning to expose your -Wire network to the open air or an hostile environment, ESD and nearby lightning strikes may hit your -Wire network and destroy the and -Wire slaves in the process. We strongly advice to protect your if such problems are real. Here's an example circuit to protect a -Wire adapter. Note that for the correct functioning of the circuit, a reliable earth connection is required (computer chassis, mains earth connector, grounding pin, ). R -Wire Network N0 DQ N0 DQ R.KE0ACCT 0V 00W N0 -Wire Adapter PE You can opt to protect -Wire slaves as well. Here's an example circuit to protect a Wire slave from certain destructive discharges on the -Wire network: R -Wire Network DQ N00 DQ N00 V W -Wire Slave The diagrams presented here are example circuits. It's the end-user's responsibility to provide the required protection measures to prevent the from being destroyed by electrical discharges and similar phenomenons. 0

11 Legal Information Disclaimer Axiris products are not designed, authorized or warranted to be suitable for use in space, nautical, space, military, medical, life-critical or safety-critical devices or equipment. Axiris products are not designed, authorized or warranted to be suitable for use in applications where failure or malfunction of an Axiris product can result in personal injury, death, property damage or environmental damage. Axiris accepts no liability for inclusion or use of Axiris products in such applications and such inclusion or use is at the customer's own risk. Should the customer use Axiris products for such application, the customer shall indemnify and hold Axiris harmless against all claims and damages. Trademarks Maxim Integrated is a trademark of Maxim Integrated Products, Inc. -Wire and ibutton are registered trademarks of Maxim Integrated Products, Inc. Raspberry Pi is a trademark of the Raspberry Pi Foundation. All product names, brands, and trademarks mentioned in this document are the property of their respective owners. 9 Contact Information Official website: