xref: /netbsd-src/share/man/man4/ibmcd.4 (revision 6cb10275d08f045e872662c371fe2f2724f2f6e6)
1*6cb10275Sriastradh.\"	$NetBSD: ibmcd.4,v 1.4 2014/03/18 18:20:39 riastradh Exp $
250b3b570Smbalmer.\"
350b3b570Smbalmer.\" Copyright (c) 2012 Marc Balmer <marc@msys.ch>
450b3b570Smbalmer.\" All rights reserved.
550b3b570Smbalmer.\"
650b3b570Smbalmer.\" Redistribution and use in source and binary forms, with or without
750b3b570Smbalmer.\" modification, are permitted provided that the following conditions
850b3b570Smbalmer.\" are met:
950b3b570Smbalmer.\" 1. Redistributions of source code must retain the above copyright
1050b3b570Smbalmer.\"    notice, this list of conditions and the following disclaimer.
1150b3b570Smbalmer.\" 2. Redistributions in binary form must reproduce the above copyright
1250b3b570Smbalmer.\"    notice, this list of conditions and the following disclaimer in the
1350b3b570Smbalmer.\"    documentation and/or other materials provided with the distribution.
1450b3b570Smbalmer.\"
1550b3b570Smbalmer.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
1650b3b570Smbalmer.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
1750b3b570Smbalmer.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
1850b3b570Smbalmer.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
1950b3b570Smbalmer.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
2050b3b570Smbalmer.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
2150b3b570Smbalmer.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
2250b3b570Smbalmer.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
2350b3b570Smbalmer.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
2450b3b570Smbalmer.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2550b3b570Smbalmer.\"
2650b3b570Smbalmer.Dd December 17, 2012
2750b3b570Smbalmer.Dt IBMCD 4
2850b3b570Smbalmer.Os
2950b3b570Smbalmer.Sh NAME
3050b3b570Smbalmer.Nm ibmcd
3150b3b570Smbalmer.Nd support for the IBM 4810 BSP cash drawer port
3250b3b570Smbalmer.Sh SYNOPSIS
3350b3b570Smbalmer.Cd "ibmcd* at at pci ? dev ? function ?"
3450b3b570Smbalmer.Cd "gpio* at ibmcd?"
3550b3b570Smbalmer.Sh DESCRIPTION
3650b3b570SmbalmerThe
3750b3b570Smbalmer.Nm
3850b3b570Smbalmerdriver controls the cash drawer port of the IBM 4810 BSP PCI device found
3950b3b570Smbalmerin IBM point of sale terminals (e.g. in the SurePOS 300 series) using the GPIO
4050b3b570Smbalmersubsystem.
4150b3b570Smbalmer.Pp
4250b3b570Smbalmer.Nm
4350b3b570Smbalmerprovides a GPIO device with three pins: pin 0 is used to control the cash drawer
4450b3b570Smbalmerwhile pin 1 can be used to read the current state of the sense input pin.
4550b3b570SmbalmerA logical 0 means the cash drawer is closed, a logical 1 means the cash drawer
4650b3b570Smbalmeris open.
4750b3b570Smbalmer.Pp
4850b3b570SmbalmerPin 2 reports if a cash drawer is connected.
4950b3b570SmbalmerA logical 0 means there is no cash drawer connected, a logical 1 means the cash drawer is connected.
5050b3b570Smbalmer.Pp
5150b3b570SmbalmerTo open the cash drawer, set pin 0 to logical 1.
5250b3b570SmbalmerThere is no need to reset pin 0 to logical 0 afterwards as the device generates
5350b3b570Smbalmera oneshot impulse.
5450b3b570Smbalmer.Sh SEE ALSO
5550b3b570Smbalmer.Xr gpio 4 ,
562c2dc060Swiz.Xr ptcd 4 ,
572c2dc060Swiz.Xr gpioctl 8
5850b3b570Smbalmer.Sh HISTORY
5950b3b570SmbalmerThe
6050b3b570Smbalmer.Nm
6150b3b570Smbalmerdriver first appeared in
6250b3b570Smbalmer.Nx 6.1 .
6350b3b570Smbalmer.Sh AUTHORS
6450b3b570Smbalmer.An -nosplit
6550b3b570SmbalmerThe
6650b3b570Smbalmer.Nm
6750b3b570Smbalmerdriver was written by
68a5684d07Swiz.An Marc Balmer Aq Mt marc@msys.ch .
69