/* $NetBSD: onewirevar.h,v 1.7 2024/11/06 19:40:11 riastradh Exp $ */
/*      $OpenBSD: onewirevar.h,v 1.1 2006/03/04 16:27:03 grange Exp $   */

/*
* Copyright (c) 2006 Alexander Yurchenko <[email protected]>
*
* 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_ONEWIRE_ONEWIREVAR_H_
#define _DEV_ONEWIRE_ONEWIREVAR_H_

#include <sys/types.h>

/*
* 1-Wire bus interface.
*/

/* Bus master interface */
struct onewire_bus {
       void *  bus_cookie;

       int     (*bus_reset)(void *);
       int     (*bus_read_bit)(void *);
       void    (*bus_write_bit)(void *, int);
       int     (*bus_read_byte)(void *);
       void    (*bus_write_byte)(void *, int);
       int     (*bus_triplet)(void *, int);
};

/* Bus methods */
void            onewire_lock(void *);
void            onewire_unlock(void *);
int             onewire_reset(void *);
int             onewire_read_bit(void *);
void            onewire_write_bit(void *, int);
int             onewire_read_byte(void *);
void            onewire_write_byte(void *, int);
int             onewire_triplet(void *, int);
void            onewire_read_block(void *, void *, int);
void            onewire_write_block(void *, const void *, int);
void            onewire_matchrom(void *, uint64_t);

/* Bus attachment */
struct onewirebus_attach_args {
       struct onewire_bus *    oba_bus;
};

int     onewirebus_print(void *, const char *);

/* Device attachment */
struct onewire_attach_args {
       void *                  oa_onewire;
       uint64_t                oa_rom;
};

/* Family matching */
struct onewire_matchfam {
       int om_type;
};

/* Miscellaneous routines */
int             onewire_crc(const void *, int);
const char *    onewire_famname(int);
int             onewire_matchbyfam(struct onewire_attach_args *,
                   const struct onewire_matchfam *, int);

/* Bus bit-banging */
struct onewire_bbops {
       void    (*bb_rx)(void *);
       void    (*bb_tx)(void *);
       int     (*bb_get)(void *);
       void    (*bb_set)(void *, int);
};

int             onewire_bb_reset(const struct onewire_bbops *, void *);
int             onewire_bb_read_bit(const struct onewire_bbops *, void *);
void            onewire_bb_write_bit(const struct onewire_bbops *, void *, int);

#endif  /* !_DEV_ONEWIRE_ONEWIREVAR_H_ */