4 * Copyright (c) 2004 Evgeniy Polyakov <johnpol@2ka.mipt.ru>
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.
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.
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
22 #include <linux/module.h>
23 #include <linux/kernel.h>
24 #include <linux/mod_devicetable.h>
25 #include <linux/usb.h>
27 #include "../w1_int.h"
30 /* COMMAND TYPE CODES */
31 #define CONTROL_CMD 0x00
35 /* CONTROL COMMAND CODES */
36 #define CTL_RESET_DEVICE 0x0000
37 #define CTL_START_EXE 0x0001
38 #define CTL_RESUME_EXE 0x0002
39 #define CTL_HALT_EXE_IDLE 0x0003
40 #define CTL_HALT_EXE_DONE 0x0004
41 #define CTL_FLUSH_COMM_CMDS 0x0007
42 #define CTL_FLUSH_RCV_BUFFER 0x0008
43 #define CTL_FLUSH_XMT_BUFFER 0x0009
44 #define CTL_GET_COMM_CMDS 0x000A
46 /* MODE COMMAND CODES */
47 #define MOD_PULSE_EN 0x0000
48 #define MOD_SPEED_CHANGE_EN 0x0001
49 #define MOD_1WIRE_SPEED 0x0002
50 #define MOD_STRONG_PU_DURATION 0x0003
51 #define MOD_PULLDOWN_SLEWRATE 0x0004
52 #define MOD_PROG_PULSE_DURATION 0x0005
53 #define MOD_WRITE1_LOWTIME 0x0006
54 #define MOD_DSOW0_TREC 0x0007
56 /* COMMUNICATION COMMAND CODES */
57 #define COMM_ERROR_ESCAPE 0x0601
58 #define COMM_SET_DURATION 0x0012
59 #define COMM_BIT_IO 0x0020
60 #define COMM_PULSE 0x0030
61 #define COMM_1_WIRE_RESET 0x0042
62 #define COMM_BYTE_IO 0x0052
63 #define COMM_MATCH_ACCESS 0x0064
64 #define COMM_BLOCK_IO 0x0074
65 #define COMM_READ_STRAIGHT 0x0080
66 #define COMM_DO_RELEASE 0x6092
67 #define COMM_SET_PATH 0x00A2
68 #define COMM_WRITE_SRAM_PAGE 0x00B2
69 #define COMM_WRITE_EPROM 0x00C4
70 #define COMM_READ_CRC_PROT_PAGE 0x00D4
71 #define COMM_READ_REDIRECT_PAGE_CRC 0x21E4
72 #define COMM_SEARCH_ACCESS 0x00F4
74 /* Communication command bits */
75 #define COMM_TYPE 0x0008
76 #define COMM_SE 0x0008
79 #define COMM_CH 0x0008
80 #define COMM_SM 0x0008
82 #define COMM_IM 0x0001
84 #define COMM_PS 0x4000
85 #define COMM_PST 0x4000
86 #define COMM_CIB 0x4000
87 #define COMM_RTS 0x4000
88 #define COMM_DT 0x2000
89 #define COMM_SPU 0x1000
91 #define COMM_NTP 0x0400
92 #define COMM_ICP 0x0200
93 #define COMM_RST 0x0100
95 #define PULSE_PROG 0x01
96 #define PULSE_SPUE 0x02
98 #define BRANCH_MAIN 0xCC
99 #define BRANCH_AUX 0x33
102 * Duration of the strong pull-up pulse in milliseconds.
104 #define PULLUP_PULSE_DURATION 750
107 #define ST_SPUA 0x01 /* Strong Pull-up is active */
108 #define ST_PRGA 0x02 /* 12V programming pulse is being generated */
109 #define ST_12VP 0x04 /* external 12V programming voltage is present */
110 #define ST_PMOD 0x08 /* DS2490 powered from USB and external sources */
111 #define ST_HALT 0x10 /* DS2490 is currently halted */
112 #define ST_IDLE 0x20 /* DS2490 is currently idle */
115 #define SPEED_NORMAL 0x00
116 #define SPEED_FLEXIBLE 0x01
117 #define SPEED_OVERDRIVE 0x02
122 #define EP_DATA_OUT 2
127 struct list_head ds_entry
;
129 struct usb_device
*udev
;
130 struct usb_interface
*intf
;
134 struct w1_bus_master master
;
150 u8 command_buffer_status
;
151 u8 data_out_buffer_status
;
152 u8 data_in_buffer_status
;
158 static struct usb_device_id ds_id_table
[] = {
159 { USB_DEVICE(0x04fa, 0x2490) },
162 MODULE_DEVICE_TABLE(usb
, ds_id_table
);
164 static int ds_probe(struct usb_interface
*, const struct usb_device_id
*);
165 static void ds_disconnect(struct usb_interface
*);
167 static inline void ds_dump_status(unsigned char *, unsigned char *, int);
168 static int ds_send_control(struct ds_device
*, u16
, u16
);
169 static int ds_send_control_cmd(struct ds_device
*, u16
, u16
);
171 static LIST_HEAD(ds_devices
);
172 static DEFINE_MUTEX(ds_mutex
);
174 static struct usb_driver ds_driver
= {
177 .disconnect
= ds_disconnect
,
178 .id_table
= ds_id_table
,
181 static int ds_send_control_cmd(struct ds_device
*dev
, u16 value
, u16 index
)
185 err
= usb_control_msg(dev
->udev
, usb_sndctrlpipe(dev
->udev
, dev
->ep
[EP_CONTROL
]),
186 CONTROL_CMD
, 0x40, value
, index
, NULL
, 0, 1000);
188 printk(KERN_ERR
"Failed to send command control message %x.%x: err=%d.\n",
196 static int ds_send_control_mode(struct ds_device
*dev
, u16 value
, u16 index
)
200 err
= usb_control_msg(dev
->udev
, usb_sndctrlpipe(dev
->udev
, dev
->ep
[EP_CONTROL
]),
201 MODE_CMD
, 0x40, value
, index
, NULL
, 0, 1000);
203 printk(KERN_ERR
"Failed to send mode control message %x.%x: err=%d.\n",
211 static int ds_send_control(struct ds_device
*dev
, u16 value
, u16 index
)
215 err
= usb_control_msg(dev
->udev
, usb_sndctrlpipe(dev
->udev
, dev
->ep
[EP_CONTROL
]),
216 COMM_CMD
, 0x40, value
, index
, NULL
, 0, 1000);
218 printk(KERN_ERR
"Failed to send control message %x.%x: err=%d.\n",
226 static inline void ds_dump_status(unsigned char *buf
, unsigned char *str
, int off
)
228 printk("%45s: %8x\n", str
, buf
[off
]);
231 static int ds_recv_status_nodump(struct ds_device
*dev
, struct ds_status
*st
,
232 unsigned char *buf
, int size
)
236 memset(st
, 0, sizeof(*st
));
239 err
= usb_bulk_msg(dev
->udev
, usb_rcvbulkpipe(dev
->udev
, dev
->ep
[EP_STATUS
]), buf
, size
, &count
, 100);
241 printk(KERN_ERR
"Failed to read 1-wire data from 0x%x: err=%d.\n", dev
->ep
[EP_STATUS
], err
);
245 if (count
>= sizeof(*st
))
246 memcpy(st
, buf
, sizeof(*st
));
251 static int ds_recv_status(struct ds_device
*dev
, struct ds_status
*st
)
253 unsigned char buf
[64];
254 int count
, err
= 0, i
;
256 memcpy(st
, buf
, sizeof(*st
));
258 count
= ds_recv_status_nodump(dev
, st
, buf
, sizeof(buf
));
262 printk("0x%x: count=%d, status: ", dev
->ep
[EP_STATUS
], count
);
263 for (i
=0; i
<count
; ++i
)
264 printk("%02x ", buf
[i
]);
268 ds_dump_status(buf
, "enable flag", 0);
269 ds_dump_status(buf
, "1-wire speed", 1);
270 ds_dump_status(buf
, "strong pullup duration", 2);
271 ds_dump_status(buf
, "programming pulse duration", 3);
272 ds_dump_status(buf
, "pulldown slew rate control", 4);
273 ds_dump_status(buf
, "write-1 low time", 5);
274 ds_dump_status(buf
, "data sample offset/write-0 recovery time", 6);
275 ds_dump_status(buf
, "reserved (test register)", 7);
276 ds_dump_status(buf
, "device status flags", 8);
277 ds_dump_status(buf
, "communication command byte 1", 9);
278 ds_dump_status(buf
, "communication command byte 2", 10);
279 ds_dump_status(buf
, "communication command buffer status", 11);
280 ds_dump_status(buf
, "1-wire data output buffer status", 12);
281 ds_dump_status(buf
, "1-wire data input buffer status", 13);
282 ds_dump_status(buf
, "reserved", 14);
283 ds_dump_status(buf
, "reserved", 15);
286 memcpy(st
, buf
, sizeof(*st
));
288 if (st
->status
& ST_EPOF
) {
289 printk(KERN_INFO
"Resetting device after ST_EPOF.\n");
290 err
= ds_send_control_cmd(dev
, CTL_RESET_DEVICE
, 0);
293 count
= ds_recv_status_nodump(dev
, st
, buf
, sizeof(buf
));
298 if (st
->status
& ST_IDLE
) {
299 printk(KERN_INFO
"Resetting pulse after ST_IDLE.\n");
300 err
= ds_start_pulse(dev
, PULLUP_PULSE_DURATION
);
309 static int ds_recv_data(struct ds_device
*dev
, unsigned char *buf
, int size
)
315 err
= usb_bulk_msg(dev
->udev
, usb_rcvbulkpipe(dev
->udev
, dev
->ep
[EP_DATA_IN
]),
316 buf
, size
, &count
, 1000);
318 printk(KERN_INFO
"Clearing ep0x%x.\n", dev
->ep
[EP_DATA_IN
]);
319 usb_clear_halt(dev
->udev
, usb_rcvbulkpipe(dev
->udev
, dev
->ep
[EP_DATA_IN
]));
320 ds_recv_status(dev
, &st
);
328 printk("%s: count=%d: ", __func__
, count
);
329 for (i
=0; i
<count
; ++i
)
330 printk("%02x ", buf
[i
]);
337 static int ds_send_data(struct ds_device
*dev
, unsigned char *buf
, int len
)
342 err
= usb_bulk_msg(dev
->udev
, usb_sndbulkpipe(dev
->udev
, dev
->ep
[EP_DATA_OUT
]), buf
, len
, &count
, 1000);
344 printk(KERN_ERR
"Failed to read 1-wire data from 0x02: err=%d.\n", err
);
353 int ds_stop_pulse(struct ds_device
*dev
, int limit
)
356 int count
= 0, err
= 0;
360 err
= ds_send_control(dev
, CTL_HALT_EXE_IDLE
, 0);
363 err
= ds_send_control(dev
, CTL_RESUME_EXE
, 0);
366 err
= ds_recv_status_nodump(dev
, &st
, buf
, sizeof(buf
));
370 if ((st
.status
& ST_SPUA
) == 0) {
371 err
= ds_send_control_mode(dev
, MOD_PULSE_EN
, 0);
375 } while(++count
< limit
);
380 int ds_detect(struct ds_device
*dev
, struct ds_status
*st
)
384 err
= ds_send_control_cmd(dev
, CTL_RESET_DEVICE
, 0);
388 err
= ds_send_control(dev
, COMM_SET_DURATION
| COMM_IM
, 0);
392 err
= ds_send_control(dev
, COMM_SET_DURATION
| COMM_IM
| COMM_TYPE
, 0x40);
396 err
= ds_send_control_mode(dev
, MOD_PULSE_EN
, PULSE_PROG
);
400 err
= ds_recv_status(dev
, st
);
407 static int ds_wait_status(struct ds_device
*dev
, struct ds_status
*st
)
413 err
= ds_recv_status_nodump(dev
, st
, buf
, sizeof(buf
));
417 printk("0x%x: count=%d, status: ", dev
->ep
[EP_STATUS
], err
);
418 for (i
=0; i
<err
; ++i
)
419 printk("%02x ", buf
[i
]);
423 } while(!(buf
[0x08] & 0x20) && !(err
< 0) && ++count
< 100);
426 if (((err
> 16) && (buf
[0x10] & 0x01)) || count
>= 100 || err
< 0) {
427 ds_recv_status(dev
, st
);
433 static int ds_reset(struct ds_device
*dev
, struct ds_status
*st
)
437 //err = ds_send_control(dev, COMM_1_WIRE_RESET | COMM_F | COMM_IM | COMM_SE, SPEED_FLEXIBLE);
438 err
= ds_send_control(dev
, 0x43, SPEED_NORMAL
);
442 ds_wait_status(dev
, st
);
444 if (st
->command_buffer_status
) {
445 printk(KERN_INFO
"Short circuit.\n");
454 static int ds_set_speed(struct ds_device
*dev
, int speed
)
458 if (speed
!= SPEED_NORMAL
&& speed
!= SPEED_FLEXIBLE
&& speed
!= SPEED_OVERDRIVE
)
461 if (speed
!= SPEED_OVERDRIVE
)
462 speed
= SPEED_FLEXIBLE
;
466 err
= ds_send_control_mode(dev
, MOD_1WIRE_SPEED
, speed
);
474 static int ds_start_pulse(struct ds_device
*dev
, int delay
)
477 u8 del
= 1 + (u8
)(delay
>> 4);
481 err
= ds_stop_pulse(dev
, 10);
485 err
= ds_send_control_mode(dev
, MOD_PULSE_EN
, PULSE_SPUE
);
489 err
= ds_send_control(dev
, COMM_SET_DURATION
| COMM_IM
, del
);
493 err
= ds_send_control(dev
, COMM_PULSE
| COMM_IM
| COMM_F
, 0);
499 ds_wait_status(dev
, &st
);
504 static int ds_touch_bit(struct ds_device
*dev
, u8 bit
, u8
*tbit
)
508 u16 value
= (COMM_BIT_IO
| COMM_IM
) | ((bit
) ? COMM_D
: 0);
511 err
= ds_send_control(dev
, value
, 0);
517 err
= ds_wait_status(dev
, &st
);
521 cmd
= st
.command0
| (st
.command1
<< 8);
522 } while (cmd
!= value
&& ++count
< 10);
524 if (err
< 0 || count
>= 10) {
525 printk(KERN_ERR
"Failed to obtain status.\n");
529 err
= ds_recv_data(dev
, tbit
, sizeof(*tbit
));
536 static int ds_write_bit(struct ds_device
*dev
, u8 bit
)
541 err
= ds_send_control(dev
, COMM_BIT_IO
| COMM_IM
| (bit
) ? COMM_D
: 0, 0);
545 ds_wait_status(dev
, &st
);
550 static int ds_write_byte(struct ds_device
*dev
, u8 byte
)
556 err
= ds_send_control(dev
, COMM_BYTE_IO
| COMM_IM
| COMM_SPU
, byte
);
560 err
= ds_wait_status(dev
, &st
);
564 err
= ds_recv_data(dev
, &rbyte
, sizeof(rbyte
));
568 ds_start_pulse(dev
, PULLUP_PULSE_DURATION
);
570 return !(byte
== rbyte
);
573 static int ds_read_byte(struct ds_device
*dev
, u8
*byte
)
578 err
= ds_send_control(dev
, COMM_BYTE_IO
| COMM_IM
, 0xff);
582 ds_wait_status(dev
, &st
);
584 err
= ds_recv_data(dev
, byte
, sizeof(*byte
));
591 static int ds_read_block(struct ds_device
*dev
, u8
*buf
, int len
)
599 memset(buf
, 0xFF, len
);
601 err
= ds_send_data(dev
, buf
, len
);
605 err
= ds_send_control(dev
, COMM_BLOCK_IO
| COMM_IM
| COMM_SPU
, len
);
609 ds_wait_status(dev
, &st
);
611 memset(buf
, 0x00, len
);
612 err
= ds_recv_data(dev
, buf
, len
);
617 static int ds_write_block(struct ds_device
*dev
, u8
*buf
, int len
)
622 err
= ds_send_data(dev
, buf
, len
);
626 ds_wait_status(dev
, &st
);
628 err
= ds_send_control(dev
, COMM_BLOCK_IO
| COMM_IM
| COMM_SPU
, len
);
632 ds_wait_status(dev
, &st
);
634 err
= ds_recv_data(dev
, buf
, len
);
638 ds_start_pulse(dev
, PULLUP_PULSE_DURATION
);
640 return !(err
== len
);
645 static int ds_search(struct ds_device
*dev
, u64 init
, u64
*buf
, u8 id_number
, int conditional_search
)
651 memset(buf
, 0, sizeof(buf
));
653 err
= ds_send_data(ds_dev
, (unsigned char *)&init
, 8);
657 ds_wait_status(ds_dev
, &st
);
659 value
= COMM_SEARCH_ACCESS
| COMM_IM
| COMM_SM
| COMM_F
| COMM_RTS
;
660 index
= (conditional_search
? 0xEC : 0xF0) | (id_number
<< 8);
661 err
= ds_send_control(ds_dev
, value
, index
);
665 ds_wait_status(ds_dev
, &st
);
667 err
= ds_recv_data(ds_dev
, (unsigned char *)buf
, 8*id_number
);
674 static int ds_match_access(struct ds_device
*dev
, u64 init
)
679 err
= ds_send_data(dev
, (unsigned char *)&init
, sizeof(init
));
683 ds_wait_status(dev
, &st
);
685 err
= ds_send_control(dev
, COMM_MATCH_ACCESS
| COMM_IM
| COMM_RST
, 0x0055);
689 ds_wait_status(dev
, &st
);
694 static int ds_set_path(struct ds_device
*dev
, u64 init
)
700 memcpy(buf
, &init
, 8);
701 buf
[8] = BRANCH_MAIN
;
703 err
= ds_send_data(dev
, buf
, sizeof(buf
));
707 ds_wait_status(dev
, &st
);
709 err
= ds_send_control(dev
, COMM_SET_PATH
| COMM_IM
| COMM_RST
, 0);
713 ds_wait_status(dev
, &st
);
720 static u8
ds9490r_touch_bit(void *data
, u8 bit
)
723 struct ds_device
*dev
= data
;
725 if (ds_touch_bit(dev
, bit
, &ret
))
731 static void ds9490r_write_bit(void *data
, u8 bit
)
733 struct ds_device
*dev
= data
;
735 ds_write_bit(dev
, bit
);
738 static void ds9490r_write_byte(void *data
, u8 byte
)
740 struct ds_device
*dev
= data
;
742 ds_write_byte(dev
, byte
);
745 static u8
ds9490r_read_bit(void *data
)
747 struct ds_device
*dev
= data
;
751 err
= ds_touch_bit(dev
, 1, &bit
);
758 static u8
ds9490r_read_byte(void *data
)
760 struct ds_device
*dev
= data
;
764 err
= ds_read_byte(dev
, &byte
);
771 static void ds9490r_write_block(void *data
, const u8
*buf
, int len
)
773 struct ds_device
*dev
= data
;
775 ds_write_block(dev
, (u8
*)buf
, len
);
778 static u8
ds9490r_read_block(void *data
, u8
*buf
, int len
)
780 struct ds_device
*dev
= data
;
783 err
= ds_read_block(dev
, buf
, len
);
790 static u8
ds9490r_reset(void *data
)
792 struct ds_device
*dev
= data
;
796 memset(&st
, 0, sizeof(st
));
798 err
= ds_reset(dev
, &st
);
805 static int ds_w1_init(struct ds_device
*dev
)
807 memset(&dev
->master
, 0, sizeof(struct w1_bus_master
));
809 dev
->master
.data
= dev
;
810 dev
->master
.touch_bit
= &ds9490r_touch_bit
;
811 dev
->master
.read_bit
= &ds9490r_read_bit
;
812 dev
->master
.write_bit
= &ds9490r_write_bit
;
813 dev
->master
.read_byte
= &ds9490r_read_byte
;
814 dev
->master
.write_byte
= &ds9490r_write_byte
;
815 dev
->master
.read_block
= &ds9490r_read_block
;
816 dev
->master
.write_block
= &ds9490r_write_block
;
817 dev
->master
.reset_bus
= &ds9490r_reset
;
819 return w1_add_master_device(&dev
->master
);
822 static void ds_w1_fini(struct ds_device
*dev
)
824 w1_remove_master_device(&dev
->master
);
827 static int ds_probe(struct usb_interface
*intf
,
828 const struct usb_device_id
*udev_id
)
830 struct usb_device
*udev
= interface_to_usbdev(intf
);
831 struct usb_endpoint_descriptor
*endpoint
;
832 struct usb_host_interface
*iface_desc
;
833 struct ds_device
*dev
;
836 dev
= kmalloc(sizeof(struct ds_device
), GFP_KERNEL
);
838 printk(KERN_INFO
"Failed to allocate new DS9490R structure.\n");
841 dev
->udev
= usb_get_dev(udev
);
846 memset(dev
->ep
, 0, sizeof(dev
->ep
));
848 usb_set_intfdata(intf
, dev
);
850 err
= usb_set_interface(dev
->udev
, intf
->altsetting
[0].desc
.bInterfaceNumber
, 3);
852 printk(KERN_ERR
"Failed to set alternative setting 3 for %d interface: err=%d.\n",
853 intf
->altsetting
[0].desc
.bInterfaceNumber
, err
);
857 err
= usb_reset_configuration(dev
->udev
);
859 printk(KERN_ERR
"Failed to reset configuration: err=%d.\n", err
);
863 iface_desc
= &intf
->altsetting
[0];
864 if (iface_desc
->desc
.bNumEndpoints
!= NUM_EP
-1) {
865 printk(KERN_INFO
"Num endpoints=%d. It is not DS9490R.\n", iface_desc
->desc
.bNumEndpoints
);
871 * This loop doesn'd show control 0 endpoint,
872 * so we will fill only 1-3 endpoints entry.
874 for (i
= 0; i
< iface_desc
->desc
.bNumEndpoints
; ++i
) {
875 endpoint
= &iface_desc
->endpoint
[i
].desc
;
877 dev
->ep
[i
+1] = endpoint
->bEndpointAddress
;
879 printk("%d: addr=%x, size=%d, dir=%s, type=%x\n",
880 i
, endpoint
->bEndpointAddress
, le16_to_cpu(endpoint
->wMaxPacketSize
),
881 (endpoint
->bEndpointAddress
& USB_DIR_IN
)?"IN":"OUT",
882 endpoint
->bmAttributes
& USB_ENDPOINT_XFERTYPE_MASK
);
886 err
= ds_w1_init(dev
);
890 mutex_lock(&ds_mutex
);
891 list_add_tail(&dev
->ds_entry
, &ds_devices
);
892 mutex_unlock(&ds_mutex
);
897 usb_set_intfdata(intf
, NULL
);
898 usb_put_dev(dev
->udev
);
904 static void ds_disconnect(struct usb_interface
*intf
)
906 struct ds_device
*dev
;
908 dev
= usb_get_intfdata(intf
);
912 mutex_lock(&ds_mutex
);
913 list_del(&dev
->ds_entry
);
914 mutex_unlock(&ds_mutex
);
918 usb_set_intfdata(intf
, NULL
);
920 usb_put_dev(dev
->udev
);
924 static int ds_init(void)
928 err
= usb_register(&ds_driver
);
930 printk(KERN_INFO
"Failed to register DS9490R USB device: err=%d.\n", err
);
937 static void ds_fini(void)
939 usb_deregister(&ds_driver
);
942 module_init(ds_init
);
943 module_exit(ds_fini
);
945 MODULE_LICENSE("GPL");
946 MODULE_AUTHOR("Evgeniy Polyakov <johnpol@2ka.mipt.ru>");
947 MODULE_DESCRIPTION("DS2490 USB <-> W1 bus master driver (DS9490*)");