xref: /netbsd-src/sys/dev/onewire/onewirevar.h (revision d16b7486a53dcb8072b60ec6fcb4373a2d0c27b7)
1 /* $NetBSD: onewirevar.h,v 1.6 2019/11/30 23:04:12 ad Exp $ */
2 /*	$OpenBSD: onewirevar.h,v 1.1 2006/03/04 16:27:03 grange Exp $	*/
3 
4 /*
5  * Copyright (c) 2006 Alexander Yurchenko <grange@openbsd.org>
6  *
7  * Permission to use, copy, modify, and distribute this software for any
8  * purpose with or without fee is hereby granted, provided that the above
9  * copyright notice and this permission notice appear in all copies.
10  *
11  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18  */
19 
20 #ifndef _DEV_ONEWIRE_ONEWIREVAR_H_
21 #define _DEV_ONEWIRE_ONEWIREVAR_H_
22 
23 /*
24  * 1-Wire bus interface.
25  */
26 
27 /* Bus master interface */
28 struct onewire_bus {
29 	void *	bus_cookie;
30 
31 	int	(*bus_reset)(void *);
32 	int	(*bus_read_bit)(void *);
33 	void	(*bus_write_bit)(void *, int);
34 	int	(*bus_read_byte)(void *);
35 	void	(*bus_write_byte)(void *, int);
36 	int	(*bus_triplet)(void *, int);
37 };
38 
39 /* Bus methods */
40 void		onewire_lock(void *);
41 void		onewire_unlock(void *);
42 int		onewire_reset(void *);
43 int		onewire_read_bit(void *);
44 void		onewire_write_bit(void *, int);
45 int		onewire_read_byte(void *);
46 void		onewire_write_byte(void *, int);
47 int		onewire_triplet(void *, int);
48 void		onewire_read_block(void *, void *, int);
49 void		onewire_write_block(void *, const void *, int);
50 void		onewire_matchrom(void *, u_int64_t);
51 
52 /* Bus attachment */
53 struct onewirebus_attach_args {
54 	struct onewire_bus *	oba_bus;
55 };
56 
57 int	onewirebus_print(void *, const char *);
58 
59 /* Device attachment */
60 struct onewire_attach_args {
61 	void *			oa_onewire;
62 	u_int64_t		oa_rom;
63 };
64 
65 /* Family matching */
66 struct onewire_matchfam {
67 	int om_type;
68 };
69 
70 /* Miscellaneous routines */
71 int		onewire_crc(const void *, int);
72 const char *	onewire_famname(int);
73 int		onewire_matchbyfam(struct onewire_attach_args *,
74 		    const struct onewire_matchfam *, int);
75 
76 /* Bus bit-banging */
77 struct onewire_bbops {
78 	void	(*bb_rx)(void *);
79 	void	(*bb_tx)(void *);
80 	int	(*bb_get)(void *);
81 	void	(*bb_set)(void *, int);
82 };
83 
84 int		onewire_bb_reset(const struct onewire_bbops *, void *);
85 int		onewire_bb_read_bit(const struct onewire_bbops *, void *);
86 void		onewire_bb_write_bit(const struct onewire_bbops *, void *, int);
87 
88 #endif	/* !_DEV_ONEWIRE_ONEWIREVAR_H_ */
89