drivers/usbd/base/usbd.c

   1 /*
   2  * Entry point for USBD service, that handles USB HCDs
   3  */
   4
   5 #include <ddekit/ddekit.h>              /* ddekit_init */
   6 #include <ddekit/thread.h>              /* DDEKit threading */
   7
   8 #include <libdde/usb_server.h>          /* DDEKit USB server */
   9
  10 #include <minix/devman.h>               /* Initializing 'devman' */
  11 #include <minix/sef.h>                  /* SEF handling */
  12
  13 #include <usb/usb_common.h>
  14 #include <usb/usbd_interface.h>
  15
  16
  17 /*===========================================================================*
  18  *    Local declarations                                                     *
  19  *===========================================================================*/
  20 static int usbd_sef_handler(int, sef_init_info_t *);
  21 static void usbd_signal_handler(int);
  22 static int usbd_start(void);
  23 static void usbd_init(void);
  24 static void usbd_server_thread(void *);
  25
  26 /* TODO: No headers for these... */
  27 extern void ddekit_minix_wait_exit(void);       /* dde.c */
  28 extern void ddekit_shutdown(void);              /* dde.c */
  29
  30
  31 /*===========================================================================*
  32  *    main                                                                   *
  33  *===========================================================================*/
  34 int
  35 main(int UNUSED(argc), char * UNUSED(argv[]))
  36 {
  37         int ret_val;
  38
  39         USB_MSG("Starting USBD");
  40         USB_DBG("Built: %s %s", __DATE__, __TIME__);
  41
  42         /* Basic SEF,DDE,... initialization */
  43         usbd_init();
  44
  45         /* Assume failure unless usbd_start exits gracefully */
  46         ret_val = EXIT_FAILURE;
  47
  48         /* USB host controllers initialization */
  49         if (EXIT_SUCCESS == usbd_init_hcd()) {
  50
  51                 /* Try initializing 'devman' */
  52                 if (EXIT_SUCCESS == devman_init()) {
  53
  54                         /* Run USB driver (actually DDEKit threads)
  55                          * until this call returns: */
  56                         ret_val = usbd_start();
  57
  58                 } else
  59                         USB_MSG("Initializing devman, failed");
  60
  61                 /* Clean whatever was initialized */
  62                 usbd_deinit_hcd();
  63
  64         } else
  65                 USB_MSG("Initializing HCDs, failed");
  66
  67         return ret_val;
  68 }
  69
  70
  71 /*===========================================================================*
  72  *    usbd_sef_handler                                                       *
  73  *===========================================================================*/
  74 static int
  75 usbd_sef_handler(int type, sef_init_info_t * UNUSED(info))
  76 {
  77         DEBUG_DUMP;
  78
  79         switch (type) {
  80                 case SEF_INIT_FRESH:
  81                         USB_MSG("Initializing");
  82                         return EXIT_SUCCESS;
  83
  84                 case SEF_INIT_LU:
  85                         USB_MSG("Updating, not implemented");
  86                         return EXIT_FAILURE;
  87
  88                 case SEF_INIT_RESTART:
  89                         USB_MSG("Restarting, not implemented");
  90                         return EXIT_FAILURE;
  91
  92                 default:
  93                         USB_MSG("illegal SEF type");
  94                         return EXIT_FAILURE;
  95         }
  96 }
  97
  98
  99 /*===========================================================================*
 100  *    usbd_signal_handler                                                    *
 101  *===========================================================================*/
 102 static void
 103 usbd_signal_handler(int UNUSED(signo))
 104 {
 105         DEBUG_DUMP;
 106
 107         USB_MSG("Signal received, exiting USBD...");
 108
 109         /* Try graceful DDEKit exit */
 110         ddekit_shutdown();
 111
 112         /* Unreachable, when ddekit_shutdown works correctly */
 113         USB_ASSERT(0, "Calling ddekit_shutdown failed!");
 114 }
 115
 116
 117 /*===========================================================================*
 118  *    usbd_start                                                             *
 119  *===========================================================================*/
 120 static int
 121 usbd_start(void)
 122 {
 123         ddekit_thread_t * usbd_th;
 124
 125         DEBUG_DUMP;
 126
 127         /* Driver's "main loop" is within DDEKit server thread */
 128         usbd_th = ddekit_thread_create(usbd_server_thread, NULL, "USBD");
 129
 130         /* After spawning, allow server thread to work */
 131         if (NULL != usbd_th) {
 132                 /* This will lock current thread until DDEKit exits */
 133                 ddekit_minix_wait_exit();
 134
 135                 /* Cleanup */
 136                 ddekit_thread_terminate(usbd_th);
 137
 138                 return EXIT_SUCCESS;
 139         } else
 140                 return EXIT_FAILURE;
 141 }
 142
 143
 144 /*===========================================================================*
 145  *    usbd_init                                                              *
 146  *===========================================================================*/
 147 static void
 148 usbd_init(void)
 149 {
 150         DEBUG_DUMP;
 151
 152         /* Set one handler for all messages */
 153         sef_setcb_init_fresh(usbd_sef_handler);
 154         sef_setcb_init_lu(usbd_sef_handler);
 155         sef_setcb_init_restart(usbd_sef_handler);
 156         sef_setcb_signal_handler(usbd_signal_handler);
 157
 158         /* Initialize DDEkit (involves sef_startup()) */
 159         ddekit_init();
 160 }
 161
 162
 163 /*===========================================================================*
 164  *    usbd_server_thread                                                     *
 165  *===========================================================================*/
 166 static void
 167 usbd_server_thread(void * UNUSED(unused))
 168 {
 169         DEBUG_DUMP;
 170
 171         ddekit_usb_server_init();
 172 }