w1.h 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275
  1. /*
  2. * w1.h
  3. *
  4. * Copyright (c) 2004 Evgeniy Polyakov <zbr@ioremap.net>
  5. *
  6. *
  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. #ifndef __W1_H
  22. #define __W1_H
  23. struct w1_reg_num
  24. {
  25. #if defined(__LITTLE_ENDIAN_BITFIELD)
  26. __u64 family:8,
  27. id:48,
  28. crc:8;
  29. #elif defined(__BIG_ENDIAN_BITFIELD)
  30. __u64 crc:8,
  31. id:48,
  32. family:8;
  33. #else
  34. #error "Please fix <asm/byteorder.h>"
  35. #endif
  36. };
  37. #ifdef __KERNEL__
  38. #include <linux/completion.h>
  39. #include <linux/device.h>
  40. #include <linux/mutex.h>
  41. #include "w1_family.h"
  42. #define W1_MAXNAMELEN 32
  43. #define W1_SEARCH 0xF0
  44. #define W1_ALARM_SEARCH 0xEC
  45. #define W1_CONVERT_TEMP 0x44
  46. #define W1_SKIP_ROM 0xCC
  47. #define W1_READ_SCRATCHPAD 0xBE
  48. #define W1_READ_ROM 0x33
  49. #define W1_READ_PSUPPLY 0xB4
  50. #define W1_MATCH_ROM 0x55
  51. #define W1_RESUME_CMD 0xA5
  52. #ifdef CONFIG_W1_CF
  53. #define W1_OVSKIP_ROM 0x3C
  54. #endif
  55. #define W1_SLAVE_ACTIVE 0
  56. struct w1_slave
  57. {
  58. struct module *owner;
  59. unsigned char name[W1_MAXNAMELEN];
  60. struct list_head w1_slave_entry;
  61. struct w1_reg_num reg_num;
  62. atomic_t refcnt;
  63. u8 rom[9];
  64. u32 flags;
  65. int ttl;
  66. u32 id_min;
  67. u32 id_max;
  68. u32 id_default;
  69. u32 color_min;
  70. u32 color_max;
  71. u32 color_default;
  72. struct w1_master *master;
  73. struct w1_family *family;
  74. void *family_data;
  75. struct device dev;
  76. struct completion released;
  77. };
  78. typedef void (*w1_slave_found_callback)(struct w1_master *, u64);
  79. /**
  80. * Note: read_bit and write_bit are very low level functions and should only
  81. * be used with hardware that doesn't really support 1-wire operations,
  82. * like a parallel/serial port.
  83. * Either define read_bit and write_bit OR define, at minimum, touch_bit and
  84. * reset_bus.
  85. */
  86. struct w1_bus_master
  87. {
  88. /** the first parameter in all the functions below */
  89. void *data;
  90. /**
  91. * Sample the line level
  92. * @return the level read (0 or 1)
  93. */
  94. u8 (*read_bit)(void *);
  95. /** Sets the line level */
  96. void (*write_bit)(void *, u8);
  97. /**
  98. * touch_bit is the lowest-level function for devices that really
  99. * support the 1-wire protocol.
  100. * touch_bit(0) = write-0 cycle
  101. * touch_bit(1) = write-1 / read cycle
  102. * @return the bit read (0 or 1)
  103. */
  104. u8 (*touch_bit)(void *, u8);
  105. /**
  106. * Reads a bytes. Same as 8 touch_bit(1) calls.
  107. * @return the byte read
  108. */
  109. u8 (*read_byte)(void *);
  110. /**
  111. * Writes a byte. Same as 8 touch_bit(x) calls.
  112. */
  113. void (*write_byte)(void *, u8);
  114. /**
  115. * Same as a series of read_byte() calls
  116. * @return the number of bytes read
  117. */
  118. u8 (*read_block)(void *, u8 *, int);
  119. /** Same as a series of write_byte() calls */
  120. void (*write_block)(void *, const u8 *, int);
  121. /**
  122. * Combines two reads and a smart write for ROM searches
  123. * @return bit0=Id bit1=comp_id bit2=dir_taken
  124. */
  125. u8 (*triplet)(void *, u8);
  126. /**
  127. * long write-0 with a read for the presence pulse detection
  128. * @return -1=Error, 0=Device present, 1=No device present
  129. */
  130. u8 (*reset_bus)(void *);
  131. /**
  132. * Put out a strong pull-up pulse of the specified duration.
  133. * @return -1=Error, 0=completed
  134. */
  135. u8 (*set_pullup)(void *, int);
  136. /** Really nice hardware can handles the different types of ROM search
  137. * w1_master* is passed to the slave found callback.
  138. */
  139. void (*search)(void *, struct w1_master *,
  140. u8, w1_slave_found_callback);
  141. /* add for sending uevent */
  142. struct input_dev *input;
  143. };
  144. struct w1_master
  145. {
  146. struct list_head w1_master_entry;
  147. struct module *owner;
  148. unsigned char name[W1_MAXNAMELEN];
  149. struct list_head slist;
  150. int max_slave_count, slave_count;
  151. unsigned long attempts;
  152. int slave_ttl;
  153. int initialized;
  154. u32 id;
  155. int search_count;
  156. atomic_t refcnt;
  157. void *priv;
  158. int priv_size;
  159. /** 5V strong pullup enabled flag, 1 enabled, zero disabled. */
  160. int enable_pullup;
  161. /** 5V strong pullup duration in milliseconds, zero disabled. */
  162. int pullup_duration;
  163. struct task_struct *thread;
  164. struct mutex mutex;
  165. struct device_driver *driver;
  166. struct device dev;
  167. struct w1_bus_master *bus_master;
  168. u32 seq;
  169. #ifdef CONFIG_W1_WORKQUEUE
  170. struct work_struct work;
  171. struct delayed_work w1_dwork;
  172. #endif
  173. };
  174. int w1_create_master_attributes(struct w1_master *);
  175. void w1_destroy_master_attributes(struct w1_master *master);
  176. void w1_search(struct w1_master *dev, u8 search_type, w1_slave_found_callback cb);
  177. void w1_search_devices(struct w1_master *dev, u8 search_type, w1_slave_found_callback cb);
  178. struct w1_slave *w1_search_slave(struct w1_reg_num *id);
  179. void w1_slave_found(struct w1_master *dev, u64 rn);
  180. void w1_search_process_cb(struct w1_master *dev, u8 search_type,
  181. w1_slave_found_callback cb);
  182. struct w1_master *w1_search_master_id(u32 id);
  183. /* Disconnect and reconnect devices in the given family. Used for finding
  184. * unclaimed devices after a family has been registered or releasing devices
  185. * after a family has been unregistered. Set attach to 1 when a new family
  186. * has just been registered, to 0 when it has been unregistered.
  187. */
  188. void w1_reconnect_slaves(struct w1_family *f, int attach);
  189. void w1_slave_detach(struct w1_slave *sl);
  190. u8 w1_triplet(struct w1_master *dev, int bdir);
  191. void w1_write_8(struct w1_master *, u8);
  192. u8 w1_read_8(struct w1_master *);
  193. int w1_reset_bus(struct w1_master *);
  194. u8 w1_calc_crc8(u8 *, int);
  195. void w1_write_block(struct w1_master *, const u8 *, int);
  196. void w1_touch_block(struct w1_master *, u8 *, int);
  197. u8 w1_read_block(struct w1_master *, u8 *, int);
  198. int w1_reset_select_slave(struct w1_slave *sl);
  199. #ifdef CONFIG_W1_CF
  200. int w1_reset_overdrive_select_slave(struct w1_slave *sl);
  201. #endif
  202. int w1_reset_resume_command(struct w1_master *);
  203. void w1_next_pullup(struct w1_master *, int);
  204. static inline struct w1_slave* dev_to_w1_slave(struct device *dev)
  205. {
  206. return container_of(dev, struct w1_slave, dev);
  207. }
  208. static inline struct w1_slave* kobj_to_w1_slave(struct kobject *kobj)
  209. {
  210. return dev_to_w1_slave(container_of(kobj, struct device, kobj));
  211. }
  212. static inline struct w1_master* dev_to_w1_master(struct device *dev)
  213. {
  214. return container_of(dev, struct w1_master, dev);
  215. }
  216. extern struct device_driver w1_master_driver;
  217. extern struct device w1_master_device;
  218. extern int w1_max_slave_count;
  219. extern int w1_max_slave_ttl;
  220. extern struct list_head w1_masters;
  221. extern struct mutex w1_mlock;
  222. extern int w1_process(void *);
  223. #ifdef CONFIG_W1_WORKQUEUE
  224. extern void w1_work(struct work_struct *work);
  225. extern struct w1_master *w1_gdev;
  226. #endif
  227. #endif /* __KERNEL__ */
  228. #endif /* __W1_H */