blob: 10a7a0767187c52d67a41c3fcffa7ecd38c80e63 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Evgeniy Polyakov77859252005-05-20 22:33:25 +04002 * w1_family.h
Linus Torvalds1da177e2005-04-16 15:20:36 -07003 *
Evgeniy Polyakova8018762011-08-25 15:59:06 -07004 * Copyright (c) 2004 Evgeniy Polyakov <zbr@ioremap.net>
Evgeniy Polyakov77859252005-05-20 22:33:25 +04005 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07006 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 */
21
22#ifndef __W1_FAMILY_H
23#define __W1_FAMILY_H
24
25#include <linux/types.h>
26#include <linux/device.h>
Arun Sharma600634972011-07-26 16:09:06 -070027#include <linux/atomic.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070028
29#define W1_FAMILY_DEFAULT 0
NeilBrown4b7e4f82014-11-19 14:04:20 +110030#define W1_FAMILY_BQ27000 0x01
Evgeniy Polyakov85e941c2005-05-02 14:26:42 +040031#define W1_FAMILY_SMEM_01 0x01
32#define W1_FAMILY_SMEM_81 0x81
Evgeniy Polyakov718a5382005-04-17 22:58:14 +040033#define W1_THERM_DS18S20 0x10
Markus Frankefbf7f7b2012-05-26 00:45:12 +020034#define W1_FAMILY_DS28E04 0x1C
Mika Laitio17fecb52011-01-12 17:01:06 -080035#define W1_COUNTER_DS2423 0x1D
Evgeniy Polyakov718a5382005-04-17 22:58:14 +040036#define W1_THERM_DS1822 0x22
Evgeniy Polyakova3d65f22005-08-11 17:27:50 +040037#define W1_EEPROM_DS2433 0x23
Evgeniy Polyakov718a5382005-04-17 22:58:14 +040038#define W1_THERM_DS18B20 0x28
Jean-François Dagenais89610272011-05-26 16:26:02 -070039#define W1_FAMILY_DS2408 0x29
Bernhard Weirichd8273672008-10-15 22:05:11 -070040#define W1_EEPROM_DS2431 0x2D
Anton Vorontsovd7ce6d12007-04-12 01:03:55 +040041#define W1_FAMILY_DS2760 0x30
Clifton Barnes275ac742011-05-26 16:26:04 -070042#define W1_FAMILY_DS2780 0x32
Mariusz Bialonczyk31b4ca32013-02-27 17:05:47 -080043#define W1_FAMILY_DS2413 0x3A
Scott Alfter948593082014-06-17 20:42:05 +000044#define W1_FAMILY_DS2406 0x12
Raphael Assenatf3261df2012-08-16 12:56:40 -040045#define W1_THERM_DS1825 0x3B
Renata Sayakhovafef37e92012-02-29 14:58:53 +010046#define W1_FAMILY_DS2781 0x3D
Christian Glindkampf7b13712011-07-26 16:08:55 -070047#define W1_THERM_DS28EA00 0x42
Linus Torvalds1da177e2005-04-16 15:20:36 -070048
49#define MAXNAMELEN 32
50
Evgeniy Polyakovd2a4ef62005-08-11 17:27:50 +040051struct w1_slave;
52
David Friesb3be1772014-01-15 22:29:25 -060053/**
54 * struct w1_family_ops - operations for a family type
55 * @add_slave: add_slave
56 * @remove_slave: remove_slave
57 * @groups: sysfs group
58 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070059struct w1_family_ops
60{
Evgeniy Polyakovd2a4ef62005-08-11 17:27:50 +040061 int (* add_slave)(struct w1_slave *);
62 void (* remove_slave)(struct w1_slave *);
Greg Kroah-Hartman36c27a62013-08-21 15:44:55 -070063 const struct attribute_group **groups;
Linus Torvalds1da177e2005-04-16 15:20:36 -070064};
65
David Friesb3be1772014-01-15 22:29:25 -060066/**
67 * struct w1_family - reference counted family structure.
68 * @family_entry: family linked list
69 * @fid: 8 bit family identifier
70 * @fops: operations for this family
71 * @refcnt: reference counter
72 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070073struct w1_family
74{
75 struct list_head family_entry;
76 u8 fid;
Evgeniy Polyakov77859252005-05-20 22:33:25 +040077
Linus Torvalds1da177e2005-04-16 15:20:36 -070078 struct w1_family_ops *fops;
Evgeniy Polyakov77859252005-05-20 22:33:25 +040079
Linus Torvalds1da177e2005-04-16 15:20:36 -070080 atomic_t refcnt;
Linus Torvalds1da177e2005-04-16 15:20:36 -070081};
82
83extern spinlock_t w1_flock;
84
Linus Torvalds1da177e2005-04-16 15:20:36 -070085void w1_family_put(struct w1_family *);
86void __w1_family_get(struct w1_family *);
Linus Torvalds1da177e2005-04-16 15:20:36 -070087struct w1_family * w1_family_registered(u8);
88void w1_unregister_family(struct w1_family *);
89int w1_register_family(struct w1_family *);
Linus Torvalds1da177e2005-04-16 15:20:36 -070090
Andrew F. Davis939fc832016-08-02 14:07:09 -070091/**
92 * module_w1_driver() - Helper macro for registering a 1-Wire families
93 * @__w1_family: w1_family struct
94 *
95 * Helper macro for 1-Wire families which do not do anything special in module
96 * init/exit. This eliminates a lot of boilerplate. Each module may only
97 * use this macro once, and calling it replaces module_init() and module_exit()
98 */
99#define module_w1_family(__w1_family) \
100 module_driver(__w1_family, w1_register_family, \
101 w1_unregister_family)
102
Linus Torvalds1da177e2005-04-16 15:20:36 -0700103#endif /* __W1_FAMILY_H */