3  * Device probing and sysfs code.
11 #include <linux/device.h>
191 static const struct ieee1394_device_id *unit_match(struct device *dev,  in unit_match()
207 static bool is_fw_unit(const struct device *dev);
209 static int fw_unit_match(struct device *dev, const struct device_driver *drv)  in fw_unit_match()
215 static int fw_unit_probe(struct device *dev)  in fw_unit_probe()
223 static void fw_unit_remove(struct device *dev)  in fw_unit_remove()
242 static int fw_unit_uevent(const struct device *dev, struct kobj_uevent_env *env)  in fw_unit_uevent()
263 int fw_device_enable_phys_dma(struct fw_device *device)  in fw_device_enable_phys_dma()  argument
265 	int generation = device->generation;  in fw_device_enable_phys_dma()
267 	/* device->node_id, accessed below, must not be older than generation */  in fw_device_enable_phys_dma()
270 	return device->card->driver->enable_phys_dma(device->card,  in fw_device_enable_phys_dma()
271 						     device->node_id,  in fw_device_enable_phys_dma()
281 static ssize_t show_immediate(struct device *dev,  in show_immediate()
329 static ssize_t show_text_leaf(struct device *dev,  in show_text_leaf()
408 static void init_fw_attribute_group(struct device *dev,  in init_fw_attribute_group()
432 static ssize_t modalias_show(struct device *dev,  in modalias_show()
444 static ssize_t rom_index_show(struct device *dev,  in rom_index_show()
447 	struct fw_device *device = fw_device(dev->parent);  in rom_index_show()  local
450 	return sysfs_emit(buf, "%td\n", unit->directory - device->config_rom);  in rom_index_show()
459 static ssize_t config_rom_show(struct device *dev,  in config_rom_show()
462 	struct fw_device *device = fw_device(dev);  in config_rom_show()  local
467 	length = device->config_rom_length * 4;  in config_rom_show()
468 	memcpy(buf, device->config_rom, length);  in config_rom_show()
473 static ssize_t guid_show(struct device *dev,  in guid_show()
476 	struct fw_device *device = fw_device(dev);  in guid_show()  local
480 	return sysfs_emit(buf, "0x%08x%08x\n", device->config_rom[3], device->config_rom[4]);  in guid_show()
483 static ssize_t is_local_show(struct device *dev,  in is_local_show()
486 	struct fw_device *device = fw_device(dev);  in is_local_show()  local
488 	return sysfs_emit(buf, "%u\n", device->is_local);  in is_local_show()
513 static ssize_t units_show(struct device *dev,  in units_show()
516 	struct fw_device *device = fw_device(dev);  in units_show()  local
522 	fw_csr_iterator_init(&ci, &device->config_rom[ROOT_DIR_OFFSET]);  in units_show()
545 static int read_rom(struct fw_device *device,  in read_rom()  argument
551 	/* device->node_id, accessed below, must not be older than generation */  in read_rom()
555 		rcode = fw_run_transaction(device->card,  in read_rom()
556 				TCODE_READ_QUADLET_REQUEST, device->node_id,  in read_rom()
557 				generation, device->max_speed, offset, data, 4);  in read_rom()
578 static int read_config_rom(struct fw_device *device, int generation)  in read_config_rom()  argument
580 	struct fw_card *card = device->card;  in read_config_rom()
594 	device->max_speed = SCODE_100;  in read_config_rom()
598 		ret = read_rom(device, generation, i, &rom[i]);  in read_config_rom()
615 	device->max_speed = device->node->max_speed;  in read_config_rom()
626 	if ((rom[2] & 0x7) < device->max_speed ||  in read_config_rom()
627 	    device->max_speed == SCODE_BETA ||  in read_config_rom()
632 		if (device->max_speed == SCODE_BETA)  in read_config_rom()
633 			device->max_speed = card->link_speed;  in read_config_rom()
635 		while (device->max_speed > SCODE_100) {  in read_config_rom()
636 			if (read_rom(device, generation, 0, &dummy) ==  in read_config_rom()
639 			device->max_speed--;  in read_config_rom()
668 		ret = read_rom(device, generation, i, &rom[i]);  in read_config_rom()
692 			ret = read_rom(device, generation, i, &rom[i]);  in read_config_rom()
719 	old_rom = device->config_rom;  in read_config_rom()
727 		device->config_rom = new_rom;  in read_config_rom()
728 		device->config_rom_length = length;  in read_config_rom()
733 	device->max_rec	= rom[2] >> 12 & 0xf;  in read_config_rom()
734 	device->cmc	= rom[2] >> 30 & 1;  in read_config_rom()
735 	device->irmc	= rom[2] >> 31 & 1;  in read_config_rom()
742 static void fw_unit_release(struct device *dev)  in fw_unit_release()
755 static bool is_fw_unit(const struct device *dev)  in is_fw_unit()
760 static void create_units(struct fw_device *device)  in create_units()  argument
767 	fw_csr_iterator_init(&ci, &device->config_rom[ROOT_DIR_OFFSET]);  in create_units()
781 		unit->device.bus = &fw_bus_type;  in create_units()
782 		unit->device.type = &fw_unit_type;  in create_units()
783 		unit->device.parent = &device->device;  in create_units()
784 		dev_set_name(&unit->device, "%s.%d", dev_name(&device->device), i++);  in create_units()
789 		init_fw_attribute_group(&unit->device,  in create_units()
793 		fw_device_get(device);  in create_units()
794 		if (device_register(&unit->device) < 0) {  in create_units()
795 			put_device(&unit->device);  in create_units()
801 static int shutdown_unit(struct device *device, void *data)  in shutdown_unit()  argument
803 	device_unregister(device);  in shutdown_unit()
820 	struct fw_device *device;  in fw_device_get_by_devt()  local
822 	device = xa_load(&fw_device_xa, MINOR(devt));  in fw_device_get_by_devt()
823 	if (device)  in fw_device_get_by_devt()
824 		fw_device_get(device);  in fw_device_get_by_devt()
826 	return device;  in fw_device_get_by_devt()
832 static void fw_schedule_device_work(struct fw_device *device,  in fw_schedule_device_work()  argument
835 	queue_delayed_work(fw_workqueue, &device->work, delay);  in fw_schedule_device_work()
840  * rom.  It shouldn't be necessary to tweak these; if the device
856 	struct fw_device *device =  in fw_device_shutdown()  local
860 			  device->card->reset_jiffies + SHUTDOWN_DELAY)  in fw_device_shutdown()
861 	    && !list_empty(&device->card->link)) {  in fw_device_shutdown()
862 		fw_schedule_device_work(device, SHUTDOWN_DELAY);  in fw_device_shutdown()
866 	if (atomic_cmpxchg(&device->state,  in fw_device_shutdown()
871 	fw_device_cdev_remove(device);  in fw_device_shutdown()
872 	device_for_each_child(&device->device, NULL, shutdown_unit);  in fw_device_shutdown()
873 	device_unregister(&device->device);  in fw_device_shutdown()
875 	xa_erase(&fw_device_xa, MINOR(device->device.devt));  in fw_device_shutdown()
877 	fw_device_put(device);  in fw_device_shutdown()
880 static void fw_device_release(struct device *dev)  in fw_device_release()
882 	struct fw_device *device = fw_device(dev);  in fw_device_release()  local
883 	struct fw_card *card = device->card;  in fw_device_release()
891 		device->node->data = NULL;  in fw_device_release()
893 	fw_node_put(device->node);  in fw_device_release()
894 	kfree(device->config_rom);  in fw_device_release()
895 	kfree(device);  in fw_device_release()
903 static bool is_fw_device(const struct device *dev)  in is_fw_device()
908 static int update_unit(struct device *dev, void *data)  in update_unit()
924 	struct fw_device *device =  in fw_device_update()  local
927 	fw_device_cdev_update(device);  in fw_device_update()
928 	device_for_each_child(&device->device, NULL, update_unit);  in fw_device_update()
933 static void set_broadcast_channel(struct fw_device *device, int generation)  in set_broadcast_channel()  argument
935 	struct fw_card *card = device->card;  in set_broadcast_channel()
949 	if (!device->irmc || device->max_rec < 8)  in set_broadcast_channel()
956 	if (device->bc_implemented == BC_UNKNOWN) {  in set_broadcast_channel()
958 				device->node_id, generation, device->max_speed,  in set_broadcast_channel()
964 				device->bc_implemented = BC_IMPLEMENTED;  in set_broadcast_channel()
969 			device->bc_implemented = BC_UNIMPLEMENTED;  in set_broadcast_channel()
973 	if (device->bc_implemented == BC_IMPLEMENTED) {  in set_broadcast_channel()
977 				device->node_id, generation, device->max_speed,  in set_broadcast_channel()
983 int fw_device_set_broadcast_channel(struct device *dev, void *gen)  in fw_device_set_broadcast_channel()
991 static int compare_configuration_rom(struct device *dev, void *data)  in compare_configuration_rom()
1005 	struct fw_device *device =  in fw_device_init()  local
1007 	struct fw_card *card = device->card;  in fw_device_init()
1008 	struct device *found;  in fw_device_init()
1015 	 * device.  in fw_device_init()
1018 	ret = read_config_rom(device, device->generation);  in fw_device_init()
1020 		if (device->config_rom_retries < MAX_RETRIES &&  in fw_device_init()
1021 		    atomic_read(&device->state) == FW_DEVICE_INITIALIZING) {  in fw_device_init()
1022 			device->config_rom_retries++;  in fw_device_init()
1023 			fw_schedule_device_work(device, RETRY_DELAY);  in fw_device_init()
1025 			if (device->node->link_on)  in fw_device_init()
1027 					  device->node_id,  in fw_device_init()
1029 			if (device->node == card->root_node)  in fw_device_init()
1031 			fw_device_release(&device->device);  in fw_device_init()
1036 	// If a device was pending for deletion because its node went away but its bus info block  in fw_device_init()
1037 	// and root directory header matches that of a newly discovered device, revive the  in fw_device_init()
1042 		found = device_find_child(card->device, (void *)device->config_rom,  in fw_device_init()
1053 				struct fw_node *current_node = device->node;  in fw_device_init()
1056 				device->node = obsolete_node;  in fw_device_init()
1057 				device->node->data = device;  in fw_device_init()
1061 				reused->max_speed = device->max_speed;  in fw_device_init()
1066 				fw_notice(card, "rediscovered device %s\n",  in fw_device_init()
1077 			fw_device_release(&device->device);  in fw_device_init()
1085 	device_initialize(&device->device);  in fw_device_init()
1087 	fw_device_get(device);  in fw_device_init()
1089 	// The index of allocated entry is used for minor identifier of device node.  in fw_device_init()
1090 	ret = xa_alloc(&fw_device_xa, &minor, device, XA_LIMIT(0, MINORMASK), GFP_KERNEL);  in fw_device_init()
1094 	device->device.bus = &fw_bus_type;  in fw_device_init()
1095 	device->device.type = &fw_device_type;  in fw_device_init()
1096 	device->device.parent = card->device;  in fw_device_init()
1097 	device->device.devt = MKDEV(fw_cdev_major, minor);  in fw_device_init()
1098 	dev_set_name(&device->device, "fw%d", minor);  in fw_device_init()
1100 	BUILD_BUG_ON(ARRAY_SIZE(device->attribute_group.attrs) <  in fw_device_init()
1103 	init_fw_attribute_group(&device->device,  in fw_device_init()
1105 				&device->attribute_group);  in fw_device_init()
1107 	if (device_add(&device->device)) {  in fw_device_init()
1108 		fw_err(card, "failed to add device\n");  in fw_device_init()
1112 	create_units(device);  in fw_device_init()
1115 	 * Transition the device to running state.  If it got pulled  in fw_device_init()
1117 	 * have to shut down the device again here.  Normally, though,  in fw_device_init()
1123 	if (atomic_cmpxchg(&device->state,  in fw_device_init()
1126 		device->workfn = fw_device_shutdown;  in fw_device_init()
1127 		fw_schedule_device_work(device, SHUTDOWN_DELAY);  in fw_device_init()
1129 		fw_notice(card, "created device %s: GUID %08x%08x, S%d00\n",  in fw_device_init()
1130 			  dev_name(&device->device),  in fw_device_init()
1131 			  device->config_rom[3], device->config_rom[4],  in fw_device_init()
1132 			  1 << device->max_speed);  in fw_device_init()
1133 		device->config_rom_retries = 0;  in fw_device_init()
1135 		set_broadcast_channel(device, device->generation);  in fw_device_init()
1137 		add_device_randomness(&device->config_rom[3], 8);  in fw_device_init()
1146 	if (device->node == card->root_node)  in fw_device_init()
1154 	fw_device_put(device);		// fw_device_xa's reference.  in fw_device_init()
1156 	put_device(&device->device);	/* our reference */  in fw_device_init()
1160 static int reread_config_rom(struct fw_device *device, int generation,  in reread_config_rom()  argument
1167 		rcode = read_rom(device, generation, i, &q);  in reread_config_rom()
1175 		if (q != device->config_rom[i]) {  in reread_config_rom()
1187 	struct fw_device *device =  in fw_device_refresh()  local
1189 	struct fw_card *card = device->card;  in fw_device_refresh()
1190 	int ret, node_id = device->node_id;  in fw_device_refresh()
1193 	ret = reread_config_rom(device, device->generation, &changed);  in fw_device_refresh()
1198 		if (atomic_cmpxchg(&device->state,  in fw_device_refresh()
1204 		device->config_rom_retries = 0;  in fw_device_refresh()
1212 	device_for_each_child(&device->device, NULL, shutdown_unit);  in fw_device_refresh()
1214 	ret = read_config_rom(device, device->generation);  in fw_device_refresh()
1218 	fw_device_cdev_update(device);  in fw_device_refresh()
1219 	create_units(device);  in fw_device_refresh()
1222 	kobject_uevent(&device->device.kobj, KOBJ_CHANGE);  in fw_device_refresh()
1224 	if (atomic_cmpxchg(&device->state,  in fw_device_refresh()
1229 	fw_notice(card, "refreshed device %s\n", dev_name(&device->device));  in fw_device_refresh()
1230 	device->config_rom_retries = 0;  in fw_device_refresh()
1234 	if (device->config_rom_retries < MAX_RETRIES &&  in fw_device_refresh()
1235 	    atomic_read(&device->state) == FW_DEVICE_INITIALIZING) {  in fw_device_refresh()
1236 		device->config_rom_retries++;  in fw_device_refresh()
1237 		fw_schedule_device_work(device, RETRY_DELAY);  in fw_device_refresh()
1241 	fw_notice(card, "giving up on refresh of device %s: %s\n",  in fw_device_refresh()
1242 		  dev_name(&device->device), fw_rcode_string(ret));  in fw_device_refresh()
1244 	atomic_set(&device->state, FW_DEVICE_GONE);  in fw_device_refresh()
1245 	device->workfn = fw_device_shutdown;  in fw_device_refresh()
1246 	fw_schedule_device_work(device, SHUTDOWN_DELAY);  in fw_device_refresh()
1254 	struct fw_device *device = container_of(to_delayed_work(work),  in fw_device_workfn()  local
1256 	device->workfn(work);  in fw_device_workfn()
1261 	struct fw_device *device;  in fw_node_event()  local
1272 		device = kzalloc(sizeof(*device), GFP_ATOMIC);  in fw_node_event()
1273 		if (device == NULL)  in fw_node_event()
1277 		 * Do minimal initialization of the device here, the  in fw_node_event()
1282 		 * You can basically just check device->state and  in fw_node_event()
1286 		atomic_set(&device->state, FW_DEVICE_INITIALIZING);  in fw_node_event()
1287 		device->card = fw_card_get(card);  in fw_node_event()
1288 		device->node = fw_node_get(node);  in fw_node_event()
1289 		device->node_id = node->node_id;  in fw_node_event()
1290 		device->generation = card->generation;  in fw_node_event()
1291 		device->is_local = node == card->local_node;  in fw_node_event()
1292 		mutex_init(&device->client_list_mutex);  in fw_node_event()
1293 		INIT_LIST_HEAD(&device->client_list);  in fw_node_event()
1296 		 * Set the node data to point back to this device so  in fw_node_event()
1298 		 * and generation for the device.  in fw_node_event()
1300 		node->data = device;  in fw_node_event()
1308 		device->workfn = fw_device_init;  in fw_node_event()
1309 		INIT_DELAYED_WORK(&device->work, fw_device_workfn);  in fw_node_event()
1310 		fw_schedule_device_work(device, INITIAL_DELAY);  in fw_node_event()
1315 		device = node->data;  in fw_node_event()
1316 		if (device == NULL)  in fw_node_event()
1319 		device->node_id = node->node_id;  in fw_node_event()
1321 		device->generation = card->generation;  in fw_node_event()
1322 		if (atomic_cmpxchg(&device->state,  in fw_node_event()
1325 			device->workfn = fw_device_refresh;  in fw_node_event()
1326 			fw_schedule_device_work(device,  in fw_node_event()
1327 				device->is_local ? 0 : INITIAL_DELAY);  in fw_node_event()
1332 		device = node->data;  in fw_node_event()
1333 		if (device == NULL)  in fw_node_event()
1336 		device->node_id = node->node_id;  in fw_node_event()
1338 		device->generation = card->generation;  in fw_node_event()
1339 		if (atomic_read(&device->state) == FW_DEVICE_RUNNING) {  in fw_node_event()
1340 			device->workfn = fw_device_update;  in fw_node_event()
1341 			fw_schedule_device_work(device, 0);  in fw_node_event()
1351 		 * Destroy the device associated with the node.  There  in fw_node_event()
1352 		 * are two cases here: either the device is fully  in fw_node_event()
1356 		 * initialized we can reuse device->work to schedule a  in fw_node_event()
1359 		 * the device in shutdown state to have that code fail  in fw_node_event()
1360 		 * to create the device.  in fw_node_event()
1362 		device = node->data;  in fw_node_event()
1363 		if (atomic_xchg(&device->state,  in fw_node_event()
1365 			device->workfn = fw_device_shutdown;  in fw_node_event()
1366 			fw_schedule_device_work(device,  in fw_node_event()
1374 #include "device-attribute-test.c"