/*	$NetBSD: sc16is7xxvar.h,v 1.2 2025/12/01 14:56:03 brad Exp $	*/

/*
 * Copyright (c) 2025 Brad Spencer <brad@anduin.eldar.org>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#ifndef _DEV_IC_SC16IS7XXVAR_H_
#define _DEV_IC_SC16IS7XXVAR_H_

#include <sys/bus.h>
#include <sys/kthread.h>
#include <sys/tty.h>

#include <sys/gpio.h>
#include <dev/gpio/gpiovar.h>

#include <dev/ic/comreg.h>
#include <dev/ic/comvar.h>	/* for com_regs */

#ifndef SC16IS7XX_DEFAULT_FREQUENCY
#define SC16IS7XX_DEFAULT_FREQUENCY 14745600
#endif

#ifndef SC16IS7XX_DEFAULT_POLL
#define SC16IS7XX_DEFAULT_POLL 50
#endif

#define SC16IS7XX_NPINS 8

#define SC16IS7XX_TYPE_STRINGLEN 40

struct sc16is7xx_sc;

struct sc16is7xx_accessfuncs {
	int (*read_reg)(struct sc16is7xx_sc *, uint8_t, int, uint8_t *,
	    size_t);
	int (*write_reg)(struct sc16is7xx_sc *, uint8_t, int, uint8_t *,
	    size_t);
	void (*copy_handles)(struct sc16is7xx_sc *, struct com_regs *);
	     uint8_t(*com_read_1)(struct com_regs *, u_int);
	void (*com_write_1)(struct com_regs *, u_int, uint8_t);
	void (*com_write_multi_1)(struct com_regs *, u_int, const uint8_t *, bus_size_t);
};

enum sc16is7xx_thread_state {
	SC16IS7XX_THREAD_GPIO,
	SC16IS7XX_THREAD_STOPPED,
	SC16IS7XX_THREAD_PAUSED,
	SC16IS7XX_THREAD_RUNNING,
	SC16IS7XX_THREAD_EXIT,
	SC16IS7XX_THREAD_STALLED
};

struct sc16is7xx_sc {
	device_t sc_dev;
	struct sysctllog *sc_sc16is7xx_log;

	int sc_num_channels;

	const struct sc16is7xx_accessfuncs *sc_funcs;
	const struct sc16is7xx_accessfuncs *sc_com_funcs;

	device_t sc_ttydevchannel[2];
	device_t sc_gpio_dev;
	struct gpio_chipset_tag sc_gpio_gc;
	gpio_pin_t sc_gpio_pins[SC16IS7XX_NPINS];

	int sc_frequency;

	kmutex_t sc_thread_mutex;
	kcondvar_t sc_threadvar;
	enum sc16is7xx_thread_state sc_thread_state;
	struct lwp *sc_thread;
	int sc_poll;
	int sc_de_count;

	int sc_phandle;
	struct workqueue *sc_wq;
	void *sc_ih;
	void *sc_sih;
};

extern const struct device_compatible_entry sc16is7xx_compat_data[];

struct sc16is7xx_tty_attach_args {
	int aa_channel;
};

void sc16is7xx_thread(void *);
void sc16is7xx_attach(struct sc16is7xx_sc *);
int sc16is7xx_detach(struct sc16is7xx_sc *, int);

#endif