4 * Copyright 2015 Google Inc.
5 * Copyright 2015 Linaro Ltd.
7 * Released under the GPLv2 only.
10 #include <linux/workqueue.h>
14 #define CPORT_FLAGS_E2EFC BIT(0)
15 #define CPORT_FLAGS_CSD_N BIT(1)
16 #define CPORT_FLAGS_CSV_N BIT(2)
20 struct work_struct work;
21 struct gb_connection *connection;
22 struct gb_svc_intf_hotplug_request data;
26 static ssize_t endo_id_show(struct device *dev,
27 struct device_attribute *attr, char *buf)
29 struct gb_svc *svc = to_gb_svc(dev);
31 return sprintf(buf, "0x%04x\n", svc->endo_id);
33 static DEVICE_ATTR_RO(endo_id);
35 static ssize_t ap_intf_id_show(struct device *dev,
36 struct device_attribute *attr, char *buf)
38 struct gb_svc *svc = to_gb_svc(dev);
40 return sprintf(buf, "%u\n", svc->ap_intf_id);
42 static DEVICE_ATTR_RO(ap_intf_id);
44 static struct attribute *svc_attrs[] = {
45 &dev_attr_endo_id.attr,
46 &dev_attr_ap_intf_id.attr,
49 ATTRIBUTE_GROUPS(svc);
51 static int gb_svc_intf_device_id(struct gb_svc *svc, u8 intf_id, u8 device_id)
53 struct gb_svc_intf_device_id_request request;
55 request.intf_id = intf_id;
56 request.device_id = device_id;
58 return gb_operation_sync(svc->connection, GB_SVC_TYPE_INTF_DEVICE_ID,
59 &request, sizeof(request), NULL, 0);
62 int gb_svc_intf_reset(struct gb_svc *svc, u8 intf_id)
64 struct gb_svc_intf_reset_request request;
66 request.intf_id = intf_id;
68 return gb_operation_sync(svc->connection, GB_SVC_TYPE_INTF_RESET,
69 &request, sizeof(request), NULL, 0);
71 EXPORT_SYMBOL_GPL(gb_svc_intf_reset);
73 int gb_svc_dme_peer_get(struct gb_svc *svc, u8 intf_id, u16 attr, u16 selector,
76 struct gb_svc_dme_peer_get_request request;
77 struct gb_svc_dme_peer_get_response response;
81 request.intf_id = intf_id;
82 request.attr = cpu_to_le16(attr);
83 request.selector = cpu_to_le16(selector);
85 ret = gb_operation_sync(svc->connection, GB_SVC_TYPE_DME_PEER_GET,
86 &request, sizeof(request),
87 &response, sizeof(response));
89 dev_err(&svc->dev, "failed to get DME attribute (%hhu %hx %hu): %d\n",
90 intf_id, attr, selector, ret);
94 result = le16_to_cpu(response.result_code);
96 dev_err(&svc->dev, "UniPro error while getting DME attribute (%hhu %hx %hu): %hu\n",
97 intf_id, attr, selector, result);
102 *value = le32_to_cpu(response.attr_value);
106 EXPORT_SYMBOL_GPL(gb_svc_dme_peer_get);
108 int gb_svc_dme_peer_set(struct gb_svc *svc, u8 intf_id, u16 attr, u16 selector,
111 struct gb_svc_dme_peer_set_request request;
112 struct gb_svc_dme_peer_set_response response;
116 request.intf_id = intf_id;
117 request.attr = cpu_to_le16(attr);
118 request.selector = cpu_to_le16(selector);
119 request.value = cpu_to_le32(value);
121 ret = gb_operation_sync(svc->connection, GB_SVC_TYPE_DME_PEER_SET,
122 &request, sizeof(request),
123 &response, sizeof(response));
125 dev_err(&svc->dev, "failed to set DME attribute (%hhu %hx %hu %u): %d\n",
126 intf_id, attr, selector, value, ret);
130 result = le16_to_cpu(response.result_code);
132 dev_err(&svc->dev, "UniPro error while setting DME attribute (%hhu %hx %hu %u): %hu\n",
133 intf_id, attr, selector, value, result);
139 EXPORT_SYMBOL_GPL(gb_svc_dme_peer_set);
142 * T_TstSrcIncrement is written by the module on ES2 as a stand-in for boot
143 * status attribute. AP needs to read and clear it, after reading a non-zero
146 * FIXME: This is module-hardware dependent and needs to be extended for every
147 * type of module we want to support.
149 static int gb_svc_read_and_clear_module_boot_status(struct gb_interface *intf)
151 struct gb_host_device *hd = intf->hd;
155 /* Read and clear boot status in T_TstSrcIncrement */
156 ret = gb_svc_dme_peer_get(hd->svc, intf->interface_id,
157 DME_ATTR_T_TST_SRC_INCREMENT,
158 DME_ATTR_SELECTOR_INDEX, &value);
164 * A nonzero boot status indicates the module has finished
168 dev_err(&intf->dev, "Module not ready yet\n");
173 * Check if the module needs to boot from unipro.
174 * For ES2: We need to check lowest 8 bits of 'value'.
175 * For ES3: We need to check highest 8 bits out of 32 of 'value'.
177 * FIXME: Add code to find if we are on ES2 or ES3 to have separate
180 if (value == DME_TSI_UNIPRO_BOOT_STARTED ||
181 value == DME_TSI_FALLBACK_UNIPRO_BOOT_STARTED)
182 intf->boot_over_unipro = true;
184 return gb_svc_dme_peer_set(hd->svc, intf->interface_id,
185 DME_ATTR_T_TST_SRC_INCREMENT,
186 DME_ATTR_SELECTOR_INDEX, 0);
189 int gb_svc_connection_create(struct gb_svc *svc,
190 u8 intf1_id, u16 cport1_id,
191 u8 intf2_id, u16 cport2_id,
192 bool boot_over_unipro)
194 struct gb_svc_conn_create_request request;
196 request.intf1_id = intf1_id;
197 request.cport1_id = cpu_to_le16(cport1_id);
198 request.intf2_id = intf2_id;
199 request.cport2_id = cpu_to_le16(cport2_id);
201 * XXX: fix connections paramaters to TC0 and all CPort flags
207 * We need to skip setting E2EFC and other flags to the connection
208 * create request, for all cports, on an interface that need to boot
209 * over unipro, i.e. interfaces required to download firmware.
211 if (boot_over_unipro)
212 request.flags = CPORT_FLAGS_CSV_N | CPORT_FLAGS_CSD_N;
214 request.flags = CPORT_FLAGS_CSV_N | CPORT_FLAGS_E2EFC;
216 return gb_operation_sync(svc->connection, GB_SVC_TYPE_CONN_CREATE,
217 &request, sizeof(request), NULL, 0);
219 EXPORT_SYMBOL_GPL(gb_svc_connection_create);
221 void gb_svc_connection_destroy(struct gb_svc *svc, u8 intf1_id, u16 cport1_id,
222 u8 intf2_id, u16 cport2_id)
224 struct gb_svc_conn_destroy_request request;
225 struct gb_connection *connection = svc->connection;
228 request.intf1_id = intf1_id;
229 request.cport1_id = cpu_to_le16(cport1_id);
230 request.intf2_id = intf2_id;
231 request.cport2_id = cpu_to_le16(cport2_id);
233 ret = gb_operation_sync(connection, GB_SVC_TYPE_CONN_DESTROY,
234 &request, sizeof(request), NULL, 0);
236 dev_err(&svc->dev, "failed to destroy connection (%hhu:%hu %hhu:%hu): %d\n",
237 intf1_id, cport1_id, intf2_id, cport2_id, ret);
240 EXPORT_SYMBOL_GPL(gb_svc_connection_destroy);
242 /* Creates bi-directional routes between the devices */
243 static int gb_svc_route_create(struct gb_svc *svc, u8 intf1_id, u8 dev1_id,
244 u8 intf2_id, u8 dev2_id)
246 struct gb_svc_route_create_request request;
248 request.intf1_id = intf1_id;
249 request.dev1_id = dev1_id;
250 request.intf2_id = intf2_id;
251 request.dev2_id = dev2_id;
253 return gb_operation_sync(svc->connection, GB_SVC_TYPE_ROUTE_CREATE,
254 &request, sizeof(request), NULL, 0);
257 /* Destroys bi-directional routes between the devices */
258 static void gb_svc_route_destroy(struct gb_svc *svc, u8 intf1_id, u8 intf2_id)
260 struct gb_svc_route_destroy_request request;
263 request.intf1_id = intf1_id;
264 request.intf2_id = intf2_id;
266 ret = gb_operation_sync(svc->connection, GB_SVC_TYPE_ROUTE_DESTROY,
267 &request, sizeof(request), NULL, 0);
269 dev_err(&svc->dev, "failed to destroy route (%hhu %hhu): %d\n",
270 intf1_id, intf2_id, ret);
274 static int gb_svc_version_request(struct gb_operation *op)
276 struct gb_connection *connection = op->connection;
277 struct gb_svc *svc = connection->private;
278 struct gb_protocol_version_request *request;
279 struct gb_protocol_version_response *response;
281 if (op->request->payload_size < sizeof(*request)) {
282 dev_err(&svc->dev, "short version request (%zu < %zu)\n",
283 op->request->payload_size,
288 request = op->request->payload;
290 if (request->major > GB_SVC_VERSION_MAJOR) {
291 dev_warn(&svc->dev, "unsupported major version (%hhu > %hhu)\n",
292 request->major, GB_SVC_VERSION_MAJOR);
296 connection->module_major = request->major;
297 connection->module_minor = request->minor;
299 if (!gb_operation_response_alloc(op, sizeof(*response), GFP_KERNEL))
302 response = op->response->payload;
303 response->major = connection->module_major;
304 response->minor = connection->module_minor;
309 static int gb_svc_hello(struct gb_operation *op)
311 struct gb_connection *connection = op->connection;
312 struct gb_svc *svc = connection->private;
313 struct gb_host_device *hd = connection->hd;
314 struct gb_svc_hello_request *hello_request;
318 * SVC sends information about the endo and interface-id on the hello
319 * request, use that to create an endo.
321 if (op->request->payload_size < sizeof(*hello_request)) {
322 dev_warn(&svc->dev, "short hello request (%zu < %zu)\n",
323 op->request->payload_size,
324 sizeof(*hello_request));
328 hello_request = op->request->payload;
329 svc->endo_id = le16_to_cpu(hello_request->endo_id);
330 svc->ap_intf_id = hello_request->interface_id;
332 ret = device_add(&svc->dev);
334 dev_err(&svc->dev, "failed to register svc device: %d\n", ret);
339 ret = greybus_endo_setup(hd, svc->endo_id, svc->ap_intf_id);
346 static void svc_intf_remove(struct gb_connection *connection,
347 struct gb_interface *intf)
349 struct gb_svc *svc = connection->private;
350 u8 intf_id = intf->interface_id;
353 device_id = intf->device_id;
354 gb_interface_remove(intf);
357 * Destroy the two-way route between the AP and the interface.
359 gb_svc_route_destroy(svc, svc->ap_intf_id, intf_id);
361 ida_simple_remove(&svc->device_id_map, device_id);
365 * 'struct svc_hotplug' should be freed by svc_process_hotplug() before it
366 * returns, irrespective of success or Failure in bringing up the module.
368 static void svc_process_hotplug(struct work_struct *work)
370 struct svc_hotplug *svc_hotplug = container_of(work, struct svc_hotplug,
372 struct gb_svc_intf_hotplug_request *hotplug = &svc_hotplug->data;
373 struct gb_connection *connection = svc_hotplug->connection;
374 struct gb_svc *svc = connection->private;
375 struct gb_host_device *hd = connection->hd;
376 struct gb_interface *intf;
377 u8 intf_id, device_id;
381 * Grab the information we need.
383 intf_id = hotplug->intf_id;
385 intf = gb_interface_find(hd, intf_id);
388 * We have received a hotplug request for an interface that
391 * This can happen in cases like:
392 * - bootrom loading the firmware image and booting into that,
393 * which only generates a hotplug event. i.e. no hot-unplug
395 * - Or the firmware on the module crashed and sent hotplug
396 * request again to the SVC, which got propagated to AP.
398 * Remove the interface and add it again, and let user know
399 * about this with a print message.
401 dev_info(&svc->dev, "removing interface %hhu to add it again\n",
403 svc_intf_remove(connection, intf);
406 intf = gb_interface_create(hd, intf_id);
408 dev_err(&svc->dev, "failed to create interface %hhu\n",
410 goto free_svc_hotplug;
413 ret = gb_svc_read_and_clear_module_boot_status(intf);
415 goto destroy_interface;
417 intf->unipro_mfg_id = le32_to_cpu(hotplug->data.unipro_mfg_id);
418 intf->unipro_prod_id = le32_to_cpu(hotplug->data.unipro_prod_id);
419 intf->vendor_id = le32_to_cpu(hotplug->data.ara_vend_id);
420 intf->product_id = le32_to_cpu(hotplug->data.ara_prod_id);
423 * Create a device id for the interface:
424 * - device id 0 (GB_DEVICE_ID_SVC) belongs to the SVC
425 * - device id 1 (GB_DEVICE_ID_AP) belongs to the AP
427 * XXX Do we need to allocate device ID for SVC or the AP here? And what
428 * XXX about an AP with multiple interface blocks?
430 device_id = ida_simple_get(&svc->device_id_map,
431 GB_DEVICE_ID_MODULES_START, 0, GFP_KERNEL);
434 dev_err(&svc->dev, "failed to allocate device id for interface %hhu: %d\n",
436 goto destroy_interface;
439 ret = gb_svc_intf_device_id(svc, intf_id, device_id);
441 dev_err(&svc->dev, "failed to set device id %hhu for interface %hhu: %d\n",
442 device_id, intf_id, ret);
447 * Create a two-way route between the AP and the new interface
449 ret = gb_svc_route_create(svc, svc->ap_intf_id, GB_DEVICE_ID_AP,
452 dev_err(&svc->dev, "failed to create route to interface %hhu (device id %hhu): %d\n",
453 intf_id, device_id, ret);
457 ret = gb_interface_init(intf, device_id);
459 dev_err(&svc->dev, "failed to initialize interface %hhu (device id %hhu): %d\n",
460 intf_id, device_id, ret);
464 goto free_svc_hotplug;
467 gb_svc_route_destroy(svc, svc->ap_intf_id, intf_id);
470 * XXX Should we tell SVC that this id doesn't belong to interface
474 ida_simple_remove(&svc->device_id_map, device_id);
476 gb_interface_remove(intf);
482 * Bringing up a module can be time consuming, as that may require lots of
483 * initialization on the module side. Over that, we may also need to download
484 * the firmware first and flash that on the module.
486 * In order to make other hotplug events to not wait for all this to finish,
487 * handle most of module hotplug stuff outside of the hotplug callback, with
488 * help of a workqueue.
490 static int gb_svc_intf_hotplug_recv(struct gb_operation *op)
492 struct gb_svc *svc = op->connection->private;
493 struct gb_message *request = op->request;
494 struct svc_hotplug *svc_hotplug;
496 if (request->payload_size < sizeof(svc_hotplug->data)) {
497 dev_warn(&svc->dev, "short hotplug request received (%zu < %zu)\n",
498 request->payload_size,
499 sizeof(svc_hotplug->data));
503 svc_hotplug = kmalloc(sizeof(*svc_hotplug), GFP_KERNEL);
507 svc_hotplug->connection = op->connection;
508 memcpy(&svc_hotplug->data, op->request->payload, sizeof(svc_hotplug->data));
510 INIT_WORK(&svc_hotplug->work, svc_process_hotplug);
511 queue_work(system_unbound_wq, &svc_hotplug->work);
516 static int gb_svc_intf_hot_unplug_recv(struct gb_operation *op)
518 struct gb_svc *svc = op->connection->private;
519 struct gb_message *request = op->request;
520 struct gb_svc_intf_hot_unplug_request *hot_unplug = request->payload;
521 struct gb_host_device *hd = op->connection->hd;
522 struct gb_interface *intf;
525 if (request->payload_size < sizeof(*hot_unplug)) {
526 dev_warn(&svc->dev, "short hot unplug request received (%zu < %zu)\n",
527 request->payload_size,
528 sizeof(*hot_unplug));
532 intf_id = hot_unplug->intf_id;
534 intf = gb_interface_find(hd, intf_id);
536 dev_warn(&svc->dev, "could not find hot-unplug interface %hhu\n",
541 svc_intf_remove(op->connection, intf);
546 static int gb_svc_intf_reset_recv(struct gb_operation *op)
548 struct gb_svc *svc = op->connection->private;
549 struct gb_message *request = op->request;
550 struct gb_svc_intf_reset_request *reset;
553 if (request->payload_size < sizeof(*reset)) {
554 dev_warn(&svc->dev, "short reset request received (%zu < %zu)\n",
555 request->payload_size, sizeof(*reset));
558 reset = request->payload;
560 intf_id = reset->intf_id;
562 /* FIXME Reset the interface here */
567 static int gb_svc_request_recv(u8 type, struct gb_operation *op)
569 struct gb_connection *connection = op->connection;
570 struct gb_svc *svc = connection->private;
574 * SVC requests need to follow a specific order (at least initially) and
575 * below code takes care of enforcing that. The expected order is:
578 * - Any other request, but the earlier two.
580 * Incoming requests are guaranteed to be serialized and so we don't
581 * need to protect 'state' for any races.
584 case GB_REQUEST_TYPE_PROTOCOL_VERSION:
585 if (svc->state != GB_SVC_STATE_RESET)
588 case GB_SVC_TYPE_SVC_HELLO:
589 if (svc->state != GB_SVC_STATE_PROTOCOL_VERSION)
593 if (svc->state != GB_SVC_STATE_SVC_HELLO)
599 dev_warn(&svc->dev, "unexpected request 0x%02x received (state %u)\n",
605 case GB_REQUEST_TYPE_PROTOCOL_VERSION:
606 ret = gb_svc_version_request(op);
608 svc->state = GB_SVC_STATE_PROTOCOL_VERSION;
610 case GB_SVC_TYPE_SVC_HELLO:
611 ret = gb_svc_hello(op);
613 svc->state = GB_SVC_STATE_SVC_HELLO;
615 case GB_SVC_TYPE_INTF_HOTPLUG:
616 return gb_svc_intf_hotplug_recv(op);
617 case GB_SVC_TYPE_INTF_HOT_UNPLUG:
618 return gb_svc_intf_hot_unplug_recv(op);
619 case GB_SVC_TYPE_INTF_RESET:
620 return gb_svc_intf_reset_recv(op);
622 dev_warn(&svc->dev, "unsupported request 0x%02x\n", type);
627 static void gb_svc_release(struct device *dev)
629 struct gb_svc *svc = to_gb_svc(dev);
631 ida_destroy(&svc->device_id_map);
635 struct device_type greybus_svc_type = {
636 .name = "greybus_svc",
637 .release = gb_svc_release,
640 static int gb_svc_connection_init(struct gb_connection *connection)
642 struct gb_host_device *hd = connection->hd;
645 svc = kzalloc(sizeof(*svc), GFP_KERNEL);
649 svc->dev.parent = &hd->dev;
650 svc->dev.bus = &greybus_bus_type;
651 svc->dev.type = &greybus_svc_type;
652 svc->dev.groups = svc_groups;
653 svc->dev.dma_mask = svc->dev.parent->dma_mask;
654 device_initialize(&svc->dev);
656 dev_set_name(&svc->dev, "%d-svc", hd->bus_id);
658 ida_init(&svc->device_id_map);
659 svc->state = GB_SVC_STATE_RESET;
660 svc->connection = connection;
661 connection->private = svc;
668 static void gb_svc_connection_exit(struct gb_connection *connection)
670 struct gb_svc *svc = connection->private;
672 if (device_is_registered(&svc->dev))
673 device_del(&svc->dev);
675 connection->hd->svc = NULL;
676 connection->private = NULL;
678 put_device(&svc->dev);
681 static struct gb_protocol svc_protocol = {
683 .id = GREYBUS_PROTOCOL_SVC,
684 .major = GB_SVC_VERSION_MAJOR,
685 .minor = GB_SVC_VERSION_MINOR,
686 .connection_init = gb_svc_connection_init,
687 .connection_exit = gb_svc_connection_exit,
688 .request_recv = gb_svc_request_recv,
689 .flags = GB_PROTOCOL_SKIP_CONTROL_CONNECTED |
690 GB_PROTOCOL_SKIP_CONTROL_DISCONNECTED |
691 GB_PROTOCOL_NO_BUNDLE |
692 GB_PROTOCOL_SKIP_VERSION,
694 gb_builtin_protocol_driver(svc_protocol);