1 files changed, 57 insertions, 0 deletions
diff --git a/os/hal/dox/usb.dox b/os/hal/dox/usb.dox
index e9c6687ce..e0916f26a 100644
--- a/os/hal/dox/usb.dox
+++ b/os/hal/dox/usb.dox
@@ -31,7 +31,64 @@
  * shown in the following diagram has to be considered an error and shall
  * be captured by an assertion (if enabled).
  * @if LATEX_PDF
+ * @dot
+  digraph example {
+    size="5, 7";
+    rankdir="LR";
+    node [shape=circle, fontname=Helvetica, fontsize=8, fixedsize="true",
+          width="0.9", height="0.9"];
+    edge [fontname=Helvetica, fontsize=8];
+
+    stop  [label="USB_STOP\nLow Power"];
+    uninit [label="USB_UNINIT", style="bold"];
+    ready [label="USB_READY\nClock Enabled"];
+    selected [label="\nUSB_SELECTED\naddress\nassigned"];
+    configured [label="\nUSB_ACTIVE\nconfiguration\nselected"];
+
+    uninit -> stop [label=" usbInit()", constraint=false];
+    stop -> stop [label="\nusbStop()"];
+    stop -> ready [label="\nusbStart()"];
+    ready -> stop [label="\nusbStop()"];
+    ready -> ready [label="\n\nusbStart()"];
+    ready -> ready [label="\nSUSPEND/WAKEUP\n>event_cb<"];
+    ready -> selected [label="\nSET_ADDRESS\n>event_cb<"];
+    selected -> ready [label="\nUSB RESET\n>event_cb<"];
+    selected -> selected [label="\nSUSPEND/WAKEUP\n>event_cb<\n\nValid EP0 Message\n>requests_hook_cb<\n\nGET DESCRIPTOR\n>get_descriptor_cb<"];
+    selected -> configured [label="\nSET_CONF(n)\n>event_cb<"];
+    configured -> selected [label="\nSET_CONF(0)\n>event_cb<"];
+    configured -> configured [label="\nSUSPEND/WAKEUP\n>event_cb<\n\nValid EP0 Message\n>requests_hook_cb<\n\nGET DESCRIPTOR\n>get_descriptor_cb<\n\nEndpoints Activity\n >in_cb< or >out_cb<"];
+    configured -> ready [label="\nUSB RESET\n>event_cb<"];
+  }
+ * @enddot
  * @else
+ * @dot
+  digraph example {
+    rankdir="LR";
+    node [shape=circle, fontname=Helvetica, fontsize=8, fixedsize="true",
+          width="0.9", height="0.9"];
+    edge [fontname=Helvetica, fontsize=8];
+
+    stop  [label="USB_STOP\nLow Power"];
+    uninit [label="USB_UNINIT", style="bold"];
+    ready [label="USB_READY\nClock Enabled"];
+    selected [label="\nUSB_SELECTED\naddress\nassigned"];
+    configured [label="\nUSB_ACTIVE\nconfiguration\nselected"];
+
+    uninit -> stop [label=" usbInit()", constraint=false];
+    stop -> stop [label="\nusbStop()"];
+    stop -> ready [label="\nusbStart()"];
+    ready -> stop [label="\nusbStop()"];
+    ready -> ready [label="\n\nusbStart()"];
+    ready -> ready [label="\nSUSPEND/WAKEUP\n>event_cb<"];
+    ready -> selected [label="\nSET_ADDRESS\n>event_cb<"];
+    selected -> ready [label="\nUSB RESET\n>event_cb<"];
+    selected -> selected [label="\nSUSPEND/WAKEUP\n>event_cb<\n\nValid EP0 Message\n>requests_hook_cb<\n\nGET DESCRIPTOR\n>get_descriptor_cb<"];
+    selected -> configured [label="\nSET_CONF(n)\n>event_cb<"];
+    configured -> selected [label="\nSET_CONF(0)\n>event_cb<"];
+    configured -> configured [label="\nSUSPEND/WAKEUP\n>event_cb<\n\nValid EP0 Message\n>requests_hook_cb<\n\nGET DESCRIPTOR\n>get_descriptor_cb<\n\nEndpoints Activity\n >in_cb< or >out_cb<"];
+    configured -> ready [label="\nUSB RESET\n>event_cb<"];
+  }
+ * @enddot
  * @endif
  *
  * @section usb_2 USB Operations