a driver for DS2405 chip
[W1] a driver for DS2405 chip
This is a driver for DS2405 1-wire single-channel addressable switch / PIO. DS2405 can also work as single-channel binary remote sensor.
drivers/w1/w1_family.h +1 -0
@@ -28,6 +28,7 @@#define W1_FAMILY_DEFAULT 0#define W1_FAMILY_SMEM_01 0x01 +#define W1_FAMILY_DS2405 0x05#define W1_FAMILY_SMEM_81 0x81#define W1_THERM_DS18S20 0x10#define W1_THERM_DS1822 0x22
drivers/w1/w1_io.c +1 -0
@@ -210,6 +210,7 @@return retval; } } +EXPORT_SYMBOL_GPL (w1_triplet);/** * Reads 8 bits.
drivers/w1/slaves/w1_ds2405.c new file +251 -0
251 lines not on this page · raw message
drivers/w1/slaves/Makefile +1 -0
@@ -4,6 +4,7 @@ obj-$(CONFIG_W1_SLAVE_THERM) += w1_therm.o obj-$(CONFIG_W1_SLAVE_SMEM) += w1_smem.o +obj-$(CONFIG_W1_SLAVE_DS2405) += w1_ds2405.o obj-$(CONFIG_W1_SLAVE_DS2431) += w1_ds2431.o obj-$(CONFIG_W1_SLAVE_DS2433) += w1_ds2433.o obj-$(CONFIG_W1_SLAVE_DS2760) += w1_ds2760.o
drivers/w1/slaves/Kconfig +8 -0
@@ -16,6 +16,14 @@ Say Y here if you want to connect 1-wire simple 64bit memory rom(ds2401/ds2411/ds1990*) to your wire. +config W1_SLAVE_DS2405 + tristate "DS2405 Addressable Switch / PIO" + help + Say Y here if you want to build driver for 1-wire + single-channel addressable switch / PIO. + This device can also work as single-channel + binary remote sensor. + config W1_SLAVE_DS2431 tristate "1kb EEPROM family support (DS2431)" help
Quoted 4 lines · Maciej Szmigiero
[W1] a driver for DS2405 chip
This is a driver for DS2405 1-wire single-channel addressable switch / PIO. DS2405 can also work as single-channel binary remote sensor.
Perhaps handle this as a gpio chip? (be it a fairly limited one) To my mind it would make it more generally useful...
Quoted 311 lines
Signed-off-by Maciej Szmigiero <[email protected]>drivers/w1/w1_family.h +1
-0@@ -28,6 +28,7 @@#define W1_FAMILY_DEFAULT 0#define W1_FAMILY_SMEM_01 0x01 +#define W1_FAMILY_DS2405 0x05#define W1_FAMILY_SMEM_81 0x81#define W1_THERM_DS18S20 0x10#define W1_THERM_DS1822 0x22drivers/w1/w1_io.c +1
-0@@ -210,6 +210,7 @@return retval; } } +EXPORT_SYMBOL_GPL (w1_triplet);/** * Reads 8 bits. drivers/w1/slaves/w1_ds2405.c new file +251
-0@@ -0,0 +1,251 @@ +/* +* w1_ds2405.c +* +* Copyright (c) 2009 Maciej Szmigiero <[email protected]> +* Based on w1_therm.c copyright (c) 2004 Evgeniy Polyakov <[email protected]> +* +* +* This program is free software; you can redistribute it and/or modify +* it under the therms of the GNU General Public License as published by +* the Free Software Foundation; either version 2 of the License, or +* (at your option) any later version. +* +* This program is distributed in the hope that it will be useful, +* but WITHOUT ANY WARRANTY; without even the implied warranty of +* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +* GNU General Public License for more details. +* +* You should have received a copy of the GNU General Public License +* along with this program; if not, write to the Free Software +* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +*/ + +#include <linux/types.h> +#include <linux/kernel.h> +#include <linux/module.h> +#include <linux/moduleparam.h> +#include <linux/sched.h> +#include <linux/device.h> +#include <linux/types.h> +#include <linux/delay.h> + +#include "../w1.h" +#include "../w1_int.h" +#include "../w1_family.h" + +static int w1_ds2405_select (struct w1_slave *sl,int only_active) +{ +struct w1_master *dev = sl->master; +int ret; + +if (w1_reset_bus (dev) !=0 ) +return 0 ; + +/* We cannot use normal Match ROM command */ +/* since doing so would toggle PIO state */ +w1_write_8 (dev, only_active ?W1_ALARM_SEARCH :W1_SEARCH ); + +do { +u64 dev_addr =cpu_to_le64 (((u64 )sl->reg_num.crc<<(8 +48 )) + | ((u64 )sl->reg_num.id<<8 ) + | sl->reg_num.family); +u8 bit_ctr; + +for (bit_ctr =0 ; bit_ctr <64 ; bit_ctr++) { +int bit2send = !!(dev_addr &1LL <<bit_ctr); + ret =w1_triplet (dev, bit2send); + +if ((ret &3 ) ==3 )/* no devices found */ +return 0 ; + +if ((!!(ret &4 )) != bit2send) +/* wrong direction taken - no such device */ +return 0 ; + } + }while (0 ); + +return 1 ; +} + +static int w1_ds2405_read_pio (struct w1_slave *sl) +{ +if (w1_ds2405_select (sl,1 )) +return 0 ;/* "active" means PIO is low */ + +if (w1_ds2405_select (sl,0 )) +return 1 ; +else +return -ENODEV ; +} + +static ssize_t w1_ds2405_read_sensed_file (struct device *device, +struct device_attribute *attr,char *buf) +{ +struct w1_slave *sl =dev_to_w1_slave (device); +struct w1_master *dev = sl->master; + +int ret; +ssize_t f_retval; +u8 state; + + ret =mutex_lock_interruptible (&dev->mutex); +if (ret) +return ret; + +if (!w1_ds2405_select (sl,0 )) { + f_retval = -ENODEV ; + goto out_unlock; + } + + state =w1_read_8 (dev); + + f_retval =snprintf (buf,PAGE_SIZE ,"%u\n" , !!(state)); + +out_unlock: +w1_reset_bus (dev); +mutex_unlock (&dev->mutex); + +return f_retval; +} + +static ssize_t w1_ds2405_read_pio_file (struct device *device, +struct device_attribute *attr,char *buf) +{ +struct w1_slave *sl =dev_to_w1_slave (device); +struct w1_master *dev = sl->master; + +int ret; +ssize_t f_retval; + + ret =mutex_lock_interruptible (&dev->mutex); +if (ret) +return ret; + + ret =w1_ds2405_read_pio (sl); +if (ret <0 ) { + f_retval = ret; + goto out_unlock; + } + + f_retval =snprintf (buf,PAGE_SIZE ,"%d\n" , ret); + +out_unlock: +w1_reset_bus (dev); +mutex_unlock (&dev->mutex); + +return f_retval; +} + +static ssize_t w1_ds2405_write_pio_file (struct device *device, +struct device_attribute *attr, +const char *buf,size_t count) +{ +struct w1_slave *sl =dev_to_w1_slave (device); +struct w1_master *dev = sl->master; + +int ret, current_pio; +unsigned int val; +ssize_t f_retval; + +if (count <1 ) +return -EINVAL ; + +/* fill_write_buffer() in fs/sysfs/file.c */ +/* keeps the buffer null-terminated */ +if (sscanf (buf," %u%n" , &val, &ret) <1 ) +return -EINVAL ; + +if ((val !=0 ) && (val !=1 )) +return -EINVAL ; + + f_retval = ret; + + ret =mutex_lock_interruptible (&dev->mutex); +if (ret) +return ret; + + current_pio =w1_ds2405_read_pio (sl); +if (current_pio <0 ) { + f_retval = current_pio; + goto out_unlock; + } + +if (current_pio == val) + goto out_unlock; + +if (w1_reset_bus (dev) !=0 ) { + f_retval = -ENODEV ; + goto out_unlock; + } + +do { +u64 dev_addr =cpu_to_le64 (((u64 )sl->reg_num.crc<<(8 +48 )) + | ((u64 )sl->reg_num.id<<8 ) | sl->reg_num.family); + +w1_write_8 (dev,W1_MATCH_ROM ); +w1_write_block (dev, (u8 *)&dev_addr,8 ); + }while (0 ); + +out_unlock: +w1_reset_bus (dev); +mutex_unlock (&dev->mutex); + +return f_retval; +} + +static DEVICE_ATTR(sensed, S_IRUSR | S_IRGRP, w1_ds2405_read_sensed_file, NULL); +static DEVICE_ATTR(PIO, S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP, + w1_ds2405_read_pio_file, w1_ds2405_write_pio_file); + +static int w1_ds2405_add_slave (struct w1_slave *sl) +{ +int err; + + err =device_create_file (&sl->dev, &dev_attr_sensed); +if (err) +return err; + + err =device_create_file (&sl->dev, &dev_attr_PIO); +if (err) { +device_remove_file (&sl->dev, &dev_attr_sensed); +return err; + } + +return 0 ; +} + +static void w1_ds2405_remove_slave (struct w1_slave *sl) +{ +device_remove_file (&sl->dev, &dev_attr_sensed); +device_remove_file (&sl->dev, &dev_attr_PIO); +} + + +static struct w1_family_ops w1_ds2405_fops = { + .add_slave = w1_ds2405_add_slave, + .remove_slave = w1_ds2405_remove_slave, +}; + + +static struct w1_family w1_family_ds2405 = { + .fid =W1_FAMILY_DS2405 , + .fops = &w1_ds2405_fops, +}; + +static int __init w1_ds2405_init (void ) +{ +return w1_register_family (&w1_family_ds2405); +} + +static void __exit w1_ds2405_fini(void) +{ + +w1_unregister_family (&w1_family_ds2405); +} + +module_init (w1_ds2405_init); +module_exit (w1_ds2405_fini); + +MODULE_LICENSE ("GPL" ); +MODULE_AUTHOR ("Maciej Szmigiero <[email protected]>" ); +MODULE_DESCRIPTION ("Driver for 1-wire Dallas DS2405 PIO" );drivers/w1/slaves/Makefile +1
-0@@ -4,6 +4,7 @@ obj-$(CONFIG_W1_SLAVE_THERM) += w1_therm.o obj-$(CONFIG_W1_SLAVE_SMEM) += w1_smem.o +obj-$(CONFIG_W1_SLAVE_DS2405) += w1_ds2405.o obj-$(CONFIG_W1_SLAVE_DS2431) += w1_ds2431.o obj-$(CONFIG_W1_SLAVE_DS2433) += w1_ds2433.o obj-$(CONFIG_W1_SLAVE_DS2760) += w1_ds2760.odrivers/w1/slaves/Kconfig +8
-1@@ -16,6 +16,14 @@ Say Y here if you want to connect 1-wire simple 64bit memory rom(ds2401/ds2411/ds1990*) to your wire. +config W1_SLAVE_DS2405 + tristate "DS2405 Addressable Switch / PIO" + help + Say Y here if you want to build driver for 1-wire + single-channel addressable switch / PIO. + This device can also work as single-channel + binary remote sensor. + config W1_SLAVE_DS2431 tristate "1kb EEPROM family support (DS2431)" help --To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
W dniu 01.11.2010 13:35, Jonathan Cameron pisze:
Quoted 7 lines · Maciej Szmigiero
Quoted 4 lines
[W1] a driver for DS2405 chip
This is a driver for DS2405 1-wire single-channel addressable switch / PIO. DS2405 can also work as single-channel binary remote sensor.
Perhaps handle this as a gpio chip? (be it a fairly limited one) To my mind it would make it more generally useful...
I think the GPIO infrastructure is meant for on-system GPIOs, where 1-wire devices are mostly used for remote data acquisition.
That's probably why w1_therm (for 1-wire thermometers) is not integrated with HWMON subsystem.
Maciej Szmigiero
Quoted 11 lines · Maciej Szmigiero
W dniu 01.11.2010 13:35, Jonathan Cameron pisze:
Quoted 7 lines · Maciej Szmigiero
Quoted 4 lines
[W1] a driver for DS2405 chip
This is a driver for DS2405 1-wire single-channel addressable switch / PIO. DS2405 can also work as single-channel binary remote sensor.
Perhaps handle this as a gpio chip? (be it a fairly limited one) To my mind it would make it more generally useful...
I think the GPIO infrastructure is meant for on-system GPIOs, where 1-wire devices are mostly used for remote data acquisition.
Nope! The contents of drivers/gpio is split roughly 50/50 between on- and off-chip gpio expanders.
Quoted 1 line
That's probably why
w1_therm(for 1-wire thermometers) is not integrated with HWMON subsystem.
Don't know why this is but kinda sounds like it should be looked at more closely - conceptually 1-W is just another bus like, eg, SPI.
--Ben.
Quoted 7 lines
Maciej Szmigiero
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
W dniu 03.11.2010 11:54, Ben Nizette pisze:
Quoted 15 lines · Maciej Szmigiero
Quoted 5 lines
W dniu 01.11.2010 13:35, Jonathan Cameron pisze:
Quoted 3 lines · Maciej Szmigiero
Quoted 2 lines
[W1] a driver for DS2405 chip
Quoted 7 lines
Quoted 4 lines
Quoted 2 lines
This is a driver for DS2405 1-wire single-channel addressable switch / PIO. DS2405 can also work as single-channel binary remote sensor.
Perhaps handle this as a gpio chip? (be it a fairly limited one) To my mind it would make it more generally useful...
I think the GPIO infrastructure is meant for on-system GPIOs, where 1-wire devices are mostly used for remote data acquisition.
Quoted 7 lines
Nope! The contents of
drivers/gpiois split roughly 50/50 between on- and off-chip gpio expanders.Quoted 1 line
That's probably why
w1_therm(for 1-wire thermometers) is not integrated with HWMON subsystem.Don't know why this is but kinda sounds like it should be looked at more closely - conceptually 1-W is just another bus like, eg, SPI.
--Ben.
Looking at GPIO subsystem I think it's not a best solution for this device. One reason is that GPIOs are identified by integer which is either #defined by platform (as Documentation/gpio.txt says) or assigned randomly.
First approach obviously doesn't fit, as I'm yet to find anybody using ds2405 for anything platform-related. Second leads to problems in locating particular device (numbers will depend on order of detection/plugging). In contrast with that, 1W subsystem provides clear and unique identification for every device as it appears under its hardware address.
In addition to that the chip removal code (gpiochip_remove() function) does not sleep when removal fails due to chip being in use, returning EBUSY instead.
This leads to inefficient unplugging (like trying to remove chip in loop hoping that finally somebody releases it). Probably this loop will also have to check if device reappeared, so the driver doesn't try to register new instance of chip while there is still one in existence.
Note that Documentation/gpio.txt says "Removing a GPIO controller should be rare; use gpiochip_remove() when it is unavoidable". Characteristics of long W1 buses cause devices to disappear and reappear from time to time so it won't be a "rare" operation here.
And all this added complexity for what? - to replace two tiny attributes under device sysfs directory?
Maciej Szmigiero
Quoted 25 lines · Maciej Szmigiero
W dniu 03.11.2010 11:54, Ben Nizette pisze:
Quoted 15 lines · Maciej Szmigiero
Quoted 5 lines
W dniu 01.11.2010 13:35, Jonathan Cameron pisze:
Quoted 3 lines · Maciej Szmigiero
Quoted 2 lines
[W1] a driver for DS2405 chip
Quoted 7 lines
Quoted 4 lines
Quoted 2 lines
This is a driver for DS2405 1-wire single-channel addressable switch / PIO. DS2405 can also work as single-channel binary remote sensor.
Perhaps handle this as a gpio chip? (be it a fairly limited one) To my mind it would make it more generally useful...
I think the GPIO infrastructure is meant for on-system GPIOs, where 1-wire devices are mostly used for remote data acquisition.
Quoted 7 lines
Nope! The contents of
drivers/gpiois split roughly 50/50 between on- and off-chip gpio expanders.Quoted 1 line
That's probably why
w1_therm(for 1-wire thermometers) is not integrated with HWMON subsystem.Don't know why this is but kinda sounds like it should be looked at more closely - conceptually 1-W is just another bus like, eg, SPI.
--Ben.
Quoted 7 lines
Looking at GPIO subsystem I think it's not a best solution for this device. One reason is that GPIOs are identified by integer which is either #defined by platform (as
Documentation/gpio.txtsays) or assigned randomly.First approach obviously doesn't fit, as I'm yet to find anybody using ds2405 for anything platform-related. Second leads to problems in locating particular device (numbers will depend on order of detection/plugging). In contrast with that, 1W subsystem provides clear and unique identification for every device as it appears under its hardware address.
Yeah I've never completely loved the randomness of this however it's hard to think of a better generic way to do this. Note though that once a gpiochip is registered there are /sys/class/gpio/gpiochipN items that provide all the information required to work out what's going on.
Quoted 6 lines
In addition to that the chip removal code (
gpiochip_remove()function) does not sleep when removal fails due to chip being in use, returning EBUSY instead.
This leads to inefficient unplugging (like trying to remove chip in loop hoping that finally somebody releases it). Probably this loop will also have to check if device reappeared, so the driver doesn't try to register new instance of chip while there is still one in existence.
Good point. Sounds like it would be a good addition to gpiolib in general, would be useful for other hotpluggable busses too
Quoted 2 lines
Note that
Documentation/gpio.txtsays "Removing a GPIO controller should be rare; usegpiochip_remove()when it is unavoidable". Characteristics of long W1 buses cause devices to disappear and reappear from time to time so it won't be a "rare" operation here.
I don't know the history of that statement, sounds more like an implementation detail than a 'feature'. Maybe David has more detail?
Quoted 2 lines
And all this added complexity for what? - to replace two tiny attributes under device sysfs directory?
Well that and standardisation! However it does seem that while conceptually your device should present a gpio interface it's on the fringe of what gpiolib was designed to do. I'd understand if you don't feel like making gpiolib better support hotpluggable devices however it sounds like it'd be worth doing, not just for 1-W but also, eg, USB GPIO expanders.
--Ben.
Quoted 2 lines
Maciej Szmigiero
W dniu 04.11.2010 22:16, Ben Nizette pisze:
Quoted 31 lines · Maciej Szmigiero
Quoted 29 lines
W dniu 03.11.2010 11:54, Ben Nizette pisze:
Quoted 15 lines · Maciej Szmigiero
Quoted 5 lines
W dniu 01.11.2010 13:35, Jonathan Cameron pisze:
Quoted 3 lines · Maciej Szmigiero
Quoted 2 lines
[W1] a driver for DS2405 chip
Quoted 7 lines
Quoted 4 lines
Quoted 2 lines
This is a driver for DS2405 1-wire single-channel addressable switch / PIO. DS2405 can also work as single-channel binary remote sensor.
Perhaps handle this as a gpio chip? (be it a fairly limited one) To my mind it would make it more generally useful...
I think the GPIO infrastructure is meant for on-system GPIOs, where 1-wire devices are mostly used for remote data acquisition.
Quoted 7 lines
Nope! The contents of
drivers/gpiois split roughly 50/50 between on- and off-chip gpio expanders.Quoted 1 line
That's probably why
w1_therm(for 1-wire thermometers) is not integrated with HWMON subsystem.Don't know why this is but kinda sounds like it should be looked at more closely - conceptually 1-W is just another bus like, eg, SPI.
--Ben.Looking at GPIO subsystem I think it's not a best solution for this device. One reason is that GPIOs are identified by integer which is either #defined by platform (as
Documentation/gpio.txtsays) or assigned randomly.
Quoted 6 lines
Quoted 4 lines
First approach obviously doesn't fit, as I'm yet to find anybody using ds2405 for anything platform-related. Second leads to problems in locating particular device (numbers will depend on order of detection/plugging). In contrast with that, 1W subsystem provides clear and unique identification for every device as it appears under its hardware address.
Yeah I've never completely loved the randomness of this however it's hard to think of a better generic way to do this. Note though that once a gpiochip is registered there are
/sys/class/gpio/gpiochipNitems that provide all the information required to work out what's going on.
I see now that I can set dev field of gpio_chip structure in gpiochip_add() to some other device in order to have new GPIO chip created as that device child. If it works as it should then a symlink will be created under /sys/bus/w1/devices/05-xxxxxxxxx pointing to that new GPIO chip.
This would allow easy chip identification by accessing it from w1 directory instead of a gpio one.
Quoted 13 lines
Quoted 7 lines
In addition to that the chip removal code (
gpiochip_remove()function) does not sleep when removal fails due to chip being in use, returning EBUSY instead.
This leads to inefficient unplugging (like trying to remove chip in loop hoping that finally somebody releases it). Probably this loop will also have to check if device reappeared, so the driver doesn't try to register new instance of chip while there is still one in existence.Good point. Sounds like it would be a good addition to gpiolib in general, would be useful for other hotpluggable busses too
Quoted 2 lines
Note that
Documentation/gpio.txtsays "Removing a GPIO controller should be rare; usegpiochip_remove()when it is unavoidable". Characteristics of long W1 buses cause devices to disappear and reappear from time to time so it won't be a "rare" operation here.
Quoted 8 lines
I don't know the history of that statement, sounds more like an implementation detail than a 'feature'. Maybe David has more detail?
Quoted 2 lines
And all this added complexity for what? - to replace two tiny attributes under device sysfs directory?
Well that and standardisation! However it does seem that while conceptually your device should present a gpio interface it's on the fringe of what gpiolib was designed to do. I'd understand if you don't feel like making gpiolib better support hotpluggable devices however it sounds like it'd be worth doing, not just for 1-W but also, eg, USB GPIO expanders.
So in your opinion is it worth "bending" the GPIO subsystem to accommodate devices like this one? This doesn't seem very hard if that parent thing works, just one new function (gpiochip_remove_blocking() or similar).
Anyway, thanks for helping make the code better!
Quoted 1 line
--Ben.
Maciej Szmigiero
Quoted 11 lines · Maciej Szmigiero
W dniu 04.11.2010 22:16, Ben Nizette pisze:
Quoted 6 lines · Maciej Szmigiero
Well that and standardisation! However it does seem that while conceptually your device should present a gpio interface it's on the fringe of what gpiolib was designed to do. I'd understand if you don't feel like making gpiolib better support hotpluggable devices however it sounds like it'd be worth doing, not just for 1-W but also, eg, USB GPIO expanders.
So in your opinion is it worth "bending" the GPIO subsystem to accommodate devices like this one? This doesn't seem very hard if that parent thing works, just one new function (
gpiochip_remove_blocking()or similar).
s/bending/extending ;-)
I don't reckon it'll be long until someone starts trying to connect up other 1-W/USB/otherwise-hotpluggable expanders through gpiolib and if there are roadblocks they should be addressed.
David has the last word of course but I quite like the idea.
Quoted 1 line
Anyway, thanks for helping make the code better!
:-)
Quoted 4 lines
Quoted 2 lines
--Ben.Maciej Szmigiero