Training courses

Kernel and Embedded Linux

Bootlin training courses

Embedded Linux, kernel,
Yocto Project, Buildroot, real-time,
graphics, boot time, debugging...

Bootlin logo

Elixir Cross Referencer

/* $NetBSD: ptcd.c,v 1.5 2021/08/07 16:19:12 thorpej Exp $ */

/*
 * Copyright (c) 2012 Marc Balmer <marc@msys.ch>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/*
 * Driver for the Protech PS3100 cash drawer port.
 */

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/device.h>
#include <sys/gpio.h>
#include <sys/kernel.h>
#include <sys/bus.h>

#include <dev/gpio/gpiovar.h>

#include <dev/isa/isareg.h>
#include <dev/isa/isavar.h>

/*
 * To assert the cash drawer pulse, 0x00 must be written to I/O register 0x48f
 * To stop the cash drawer pulse, 0x02 must be written to I/O register 0x48f
 * To read out the current cash drawer state (sense pin), read bit 7 of
 * I/O register 0x48d
 */

#define PTCD_READ_REG	0x48d

/* register offsets, counted from PTCD_READ_REG */
#define PTCD_READ	0x00
#define PTCD_WRITE	0x02

/* Read mask */
#define PTCD_SENSE	0x80

/* Write values */
#define PTCD_OPEN	0x00
#define PTCD_CLOSE	0x02

#define PTCD_NPINS	2
#define PIN_WRITE	0
#define	PIN_READ	1

#define PTCD_ADDR_SIZE	0x03

struct ptcd_softc {
	bus_space_tag_t sc_iot;
	bus_space_handle_t sc_ioh;

	/* GPIO interface */
	struct gpio_chipset_tag	sc_gpio_gc;
	gpio_pin_t		sc_gpio_pins[PTCD_NPINS];
};

int ptcd_match(device_t, struct cfdata *, void *);
void ptcd_attach(device_t, device_t, void *);

int	ptcd_gpio_pin_read(void *, int);
void	ptcd_gpio_pin_write(void *, int, int);
void	ptcd_gpio_pin_ctl(void *, int, int);

CFATTACH_DECL2_NEW(ptcd, sizeof(struct ptcd_softc), ptcd_match, ptcd_attach,
    NULL, NULL, NULL, NULL);

int
ptcd_match(device_t parent, struct cfdata *match, void *aux)
{
	struct isa_attach_args *ia = aux;

	if (ia->ia_nio < 1)
		return 0;

	if (ISA_DIRECT_CONFIG(ia))
		return 0;

	if (ia->ia_io[0].ir_addr != PTCD_READ_REG)
		return 0;

	ia->ia_io[0].ir_size = PTCD_ADDR_SIZE;
	ia->ia_niomem = 0;
	ia->ia_nirq = 0;
	ia->ia_ndrq = 0;

	return 1;
}

void
ptcd_attach(device_t parent, device_t self, void *aux)
{
	struct ptcd_softc *sc;
	struct isa_attach_args *ia = aux;
	struct gpiobus_attach_args gba;

	sc = device_private(self);

	sc->sc_iot = ia->ia_iot;
	if (bus_space_map(sc->sc_iot, ia->ia_io[0].ir_addr, PTCD_ADDR_SIZE, 0,
	    &sc->sc_ioh)) {
		aprint_error(": can't map i/o space\n");
		return;
	}

	aprint_normal(": Protech PS3100 cash drawer\n");

	/* Initialize pins array */
	sc->sc_gpio_pins[PIN_WRITE].pin_num = 0;
	sc->sc_gpio_pins[PIN_WRITE].pin_caps = GPIO_PIN_OUTPUT;
	sc->sc_gpio_pins[PIN_READ].pin_num = 1;
	sc->sc_gpio_pins[PIN_READ].pin_caps = GPIO_PIN_INPUT;

	/* Create controller tag */
	sc->sc_gpio_gc.gp_cookie = sc;
	sc->sc_gpio_gc.gp_pin_read = ptcd_gpio_pin_read;
	sc->sc_gpio_gc.gp_pin_write = ptcd_gpio_pin_write;
	sc->sc_gpio_gc.gp_pin_ctl = ptcd_gpio_pin_ctl;

	gba.gba_gc = &sc->sc_gpio_gc;
	gba.gba_pins = sc->sc_gpio_pins;
	gba.gba_npins = PTCD_NPINS;

	/* Attach GPIO framework */
	config_found(self, &gba, gpiobus_print, CFARGS_NONE);
}

int
ptcd_gpio_pin_read(void *arg, int pin)
{
	struct ptcd_softc *sc = arg;
	uint8_t data;

	if (pin != PIN_READ)
		return 0;

	data = bus_space_read_1(sc->sc_iot, sc->sc_ioh, PTCD_READ);
	return data & PTCD_SENSE ? 0 : 1;
}

void
ptcd_gpio_pin_write(void *arg, int pin, int value)
{
	struct ptcd_softc *sc = arg;

	if (pin != PIN_WRITE)
		return;

	bus_space_write_1(sc->sc_iot, sc->sc_ioh, PTCD_WRITE,
	    value ? PTCD_OPEN : PTCD_CLOSE);
}

void
ptcd_gpio_pin_ctl(void *arg, int pin, int flags)
{
	/* We ignore pin control requests since the pin functions are fixed. */
}