seq_midi.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487
  1. /*
  2. * Generic MIDI synth driver for ALSA sequencer
  3. * Copyright (c) 1998 by Frank van de Pol <fvdpol@coil.demon.nl>
  4. * Jaroslav Kysela <perex@suse.cz>
  5. *
  6. * This program is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU General Public License as published by
  8. * the Free Software Foundation; either version 2 of the License, or
  9. * (at your option) any later version.
  10. *
  11. * This program is distributed in the hope that it will be useful,
  12. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14. * GNU General Public License for more details.
  15. *
  16. * You should have received a copy of the GNU General Public License
  17. * along with this program; if not, write to the Free Software
  18. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  19. *
  20. */
  21. /*
  22. Possible options for midisynth module:
  23. - automatic opening of midi ports on first received event or subscription
  24. (close will be performed when client leaves)
  25. */
  26. #include <sound/driver.h>
  27. #include <linux/init.h>
  28. #include <linux/slab.h>
  29. #include <linux/errno.h>
  30. #include <linux/string.h>
  31. #include <linux/moduleparam.h>
  32. #include <asm/semaphore.h>
  33. #include <sound/core.h>
  34. #include <sound/rawmidi.h>
  35. #include <sound/seq_kernel.h>
  36. #include <sound/seq_device.h>
  37. #include <sound/seq_midi_event.h>
  38. #include <sound/initval.h>
  39. MODULE_AUTHOR("Frank van de Pol <fvdpol@coil.demon.nl>, Jaroslav Kysela <perex@suse.cz>");
  40. MODULE_DESCRIPTION("Advanced Linux Sound Architecture sequencer MIDI synth.");
  41. MODULE_LICENSE("GPL");
  42. static int output_buffer_size = PAGE_SIZE;
  43. module_param(output_buffer_size, int, 0644);
  44. MODULE_PARM_DESC(output_buffer_size, "Output buffer size in bytes.");
  45. static int input_buffer_size = PAGE_SIZE;
  46. module_param(input_buffer_size, int, 0644);
  47. MODULE_PARM_DESC(input_buffer_size, "Input buffer size in bytes.");
  48. /* data for this midi synth driver */
  49. typedef struct {
  50. snd_card_t *card;
  51. int device;
  52. int subdevice;
  53. snd_rawmidi_file_t input_rfile;
  54. snd_rawmidi_file_t output_rfile;
  55. int seq_client;
  56. int seq_port;
  57. snd_midi_event_t *parser;
  58. } seq_midisynth_t;
  59. typedef struct {
  60. int seq_client;
  61. int num_ports;
  62. int ports_per_device[SNDRV_RAWMIDI_DEVICES];
  63. seq_midisynth_t *ports[SNDRV_RAWMIDI_DEVICES];
  64. } seq_midisynth_client_t;
  65. static seq_midisynth_client_t *synths[SNDRV_CARDS];
  66. static DECLARE_MUTEX(register_mutex);
  67. /* handle rawmidi input event (MIDI v1.0 stream) */
  68. static void snd_midi_input_event(snd_rawmidi_substream_t * substream)
  69. {
  70. snd_rawmidi_runtime_t *runtime;
  71. seq_midisynth_t *msynth;
  72. snd_seq_event_t ev;
  73. char buf[16], *pbuf;
  74. long res, count;
  75. if (substream == NULL)
  76. return;
  77. runtime = substream->runtime;
  78. msynth = (seq_midisynth_t *) runtime->private_data;
  79. if (msynth == NULL)
  80. return;
  81. memset(&ev, 0, sizeof(ev));
  82. while (runtime->avail > 0) {
  83. res = snd_rawmidi_kernel_read(substream, buf, sizeof(buf));
  84. if (res <= 0)
  85. continue;
  86. if (msynth->parser == NULL)
  87. continue;
  88. pbuf = buf;
  89. while (res > 0) {
  90. count = snd_midi_event_encode(msynth->parser, pbuf, res, &ev);
  91. if (count < 0)
  92. break;
  93. pbuf += count;
  94. res -= count;
  95. if (ev.type != SNDRV_SEQ_EVENT_NONE) {
  96. ev.source.port = msynth->seq_port;
  97. ev.dest.client = SNDRV_SEQ_ADDRESS_SUBSCRIBERS;
  98. snd_seq_kernel_client_dispatch(msynth->seq_client, &ev, 1, 0);
  99. /* clear event and reset header */
  100. memset(&ev, 0, sizeof(ev));
  101. }
  102. }
  103. }
  104. }
  105. static int dump_midi(snd_rawmidi_substream_t *substream, const char *buf, int count)
  106. {
  107. snd_rawmidi_runtime_t *runtime;
  108. int tmp;
  109. snd_assert(substream != NULL || buf != NULL, return -EINVAL);
  110. runtime = substream->runtime;
  111. if ((tmp = runtime->avail) < count) {
  112. snd_printd("warning, output event was lost (count = %i, available = %i)\n", count, tmp);
  113. return -ENOMEM;
  114. }
  115. if (snd_rawmidi_kernel_write(substream, buf, count) < count)
  116. return -EINVAL;
  117. return 0;
  118. }
  119. static int event_process_midi(snd_seq_event_t * ev, int direct,
  120. void *private_data, int atomic, int hop)
  121. {
  122. seq_midisynth_t *msynth = (seq_midisynth_t *) private_data;
  123. unsigned char msg[10]; /* buffer for constructing midi messages */
  124. snd_rawmidi_substream_t *substream;
  125. int len;
  126. snd_assert(msynth != NULL, return -EINVAL);
  127. substream = msynth->output_rfile.output;
  128. if (substream == NULL)
  129. return -ENODEV;
  130. if (ev->type == SNDRV_SEQ_EVENT_SYSEX) { /* special case, to save space */
  131. if ((ev->flags & SNDRV_SEQ_EVENT_LENGTH_MASK) != SNDRV_SEQ_EVENT_LENGTH_VARIABLE) {
  132. /* invalid event */
  133. snd_printd("seq_midi: invalid sysex event flags = 0x%x\n", ev->flags);
  134. return 0;
  135. }
  136. snd_seq_dump_var_event(ev, (snd_seq_dump_func_t)dump_midi, substream);
  137. snd_midi_event_reset_decode(msynth->parser);
  138. } else {
  139. if (msynth->parser == NULL)
  140. return -EIO;
  141. len = snd_midi_event_decode(msynth->parser, msg, sizeof(msg), ev);
  142. if (len < 0)
  143. return 0;
  144. if (dump_midi(substream, msg, len) < 0)
  145. snd_midi_event_reset_decode(msynth->parser);
  146. }
  147. return 0;
  148. }
  149. static int snd_seq_midisynth_new(seq_midisynth_t *msynth,
  150. snd_card_t *card,
  151. int device,
  152. int subdevice)
  153. {
  154. if (snd_midi_event_new(MAX_MIDI_EVENT_BUF, &msynth->parser) < 0)
  155. return -ENOMEM;
  156. msynth->card = card;
  157. msynth->device = device;
  158. msynth->subdevice = subdevice;
  159. return 0;
  160. }
  161. /* open associated midi device for input */
  162. static int midisynth_subscribe(void *private_data, snd_seq_port_subscribe_t *info)
  163. {
  164. int err;
  165. seq_midisynth_t *msynth = (seq_midisynth_t *)private_data;
  166. snd_rawmidi_runtime_t *runtime;
  167. snd_rawmidi_params_t params;
  168. /* open midi port */
  169. if ((err = snd_rawmidi_kernel_open(msynth->card->number, msynth->device, msynth->subdevice, SNDRV_RAWMIDI_LFLG_INPUT, &msynth->input_rfile)) < 0) {
  170. snd_printd("midi input open failed!!!\n");
  171. return err;
  172. }
  173. runtime = msynth->input_rfile.input->runtime;
  174. memset(&params, 0, sizeof(params));
  175. params.avail_min = 1;
  176. params.buffer_size = input_buffer_size;
  177. if ((err = snd_rawmidi_input_params(msynth->input_rfile.input, &params)) < 0) {
  178. snd_rawmidi_kernel_release(&msynth->input_rfile);
  179. return err;
  180. }
  181. snd_midi_event_reset_encode(msynth->parser);
  182. runtime->event = snd_midi_input_event;
  183. runtime->private_data = msynth;
  184. snd_rawmidi_kernel_read(msynth->input_rfile.input, NULL, 0);
  185. return 0;
  186. }
  187. /* close associated midi device for input */
  188. static int midisynth_unsubscribe(void *private_data, snd_seq_port_subscribe_t *info)
  189. {
  190. int err;
  191. seq_midisynth_t *msynth = (seq_midisynth_t *)private_data;
  192. snd_assert(msynth->input_rfile.input != NULL, return -EINVAL);
  193. err = snd_rawmidi_kernel_release(&msynth->input_rfile);
  194. return err;
  195. }
  196. /* open associated midi device for output */
  197. static int midisynth_use(void *private_data, snd_seq_port_subscribe_t *info)
  198. {
  199. int err;
  200. seq_midisynth_t *msynth = (seq_midisynth_t *)private_data;
  201. snd_rawmidi_params_t params;
  202. /* open midi port */
  203. if ((err = snd_rawmidi_kernel_open(msynth->card->number, msynth->device, msynth->subdevice, SNDRV_RAWMIDI_LFLG_OUTPUT, &msynth->output_rfile)) < 0) {
  204. snd_printd("midi output open failed!!!\n");
  205. return err;
  206. }
  207. memset(&params, 0, sizeof(params));
  208. params.avail_min = 1;
  209. params.buffer_size = output_buffer_size;
  210. if ((err = snd_rawmidi_output_params(msynth->output_rfile.output, &params)) < 0) {
  211. snd_rawmidi_kernel_release(&msynth->output_rfile);
  212. return err;
  213. }
  214. snd_midi_event_reset_decode(msynth->parser);
  215. return 0;
  216. }
  217. /* close associated midi device for output */
  218. static int midisynth_unuse(void *private_data, snd_seq_port_subscribe_t *info)
  219. {
  220. seq_midisynth_t *msynth = (seq_midisynth_t *)private_data;
  221. unsigned char buf = 0xff; /* MIDI reset */
  222. snd_assert(msynth->output_rfile.output != NULL, return -EINVAL);
  223. /* sending single MIDI reset message to shut the device up */
  224. snd_rawmidi_kernel_write(msynth->output_rfile.output, &buf, 1);
  225. snd_rawmidi_drain_output(msynth->output_rfile.output);
  226. return snd_rawmidi_kernel_release(&msynth->output_rfile);
  227. }
  228. /* delete given midi synth port */
  229. static void snd_seq_midisynth_delete(seq_midisynth_t *msynth)
  230. {
  231. if (msynth == NULL)
  232. return;
  233. if (msynth->seq_client > 0) {
  234. /* delete port */
  235. snd_seq_event_port_detach(msynth->seq_client, msynth->seq_port);
  236. }
  237. if (msynth->parser)
  238. snd_midi_event_free(msynth->parser);
  239. }
  240. /* set our client name */
  241. static int set_client_name(seq_midisynth_client_t *client, snd_card_t *card,
  242. snd_rawmidi_info_t *rmidi)
  243. {
  244. snd_seq_client_info_t cinfo;
  245. const char *name;
  246. memset(&cinfo, 0, sizeof(cinfo));
  247. cinfo.client = client->seq_client;
  248. cinfo.type = KERNEL_CLIENT;
  249. name = rmidi->name[0] ? (const char *)rmidi->name : "External MIDI";
  250. strlcpy(cinfo.name, name, sizeof(cinfo.name));
  251. return snd_seq_kernel_client_ctl(client->seq_client, SNDRV_SEQ_IOCTL_SET_CLIENT_INFO, &cinfo);
  252. }
  253. /* register new midi synth port */
  254. static int
  255. snd_seq_midisynth_register_port(snd_seq_device_t *dev)
  256. {
  257. seq_midisynth_client_t *client;
  258. seq_midisynth_t *msynth, *ms;
  259. snd_seq_port_info_t *port;
  260. snd_rawmidi_info_t *info;
  261. int newclient = 0;
  262. unsigned int p, ports;
  263. snd_seq_client_callback_t callbacks;
  264. snd_seq_port_callback_t pcallbacks;
  265. snd_card_t *card = dev->card;
  266. int device = dev->device;
  267. unsigned int input_count = 0, output_count = 0;
  268. snd_assert(card != NULL && device >= 0 && device < SNDRV_RAWMIDI_DEVICES, return -EINVAL);
  269. info = kmalloc(sizeof(*info), GFP_KERNEL);
  270. if (! info)
  271. return -ENOMEM;
  272. info->device = device;
  273. info->stream = SNDRV_RAWMIDI_STREAM_OUTPUT;
  274. info->subdevice = 0;
  275. if (snd_rawmidi_info_select(card, info) >= 0)
  276. output_count = info->subdevices_count;
  277. info->stream = SNDRV_RAWMIDI_STREAM_INPUT;
  278. if (snd_rawmidi_info_select(card, info) >= 0) {
  279. input_count = info->subdevices_count;
  280. }
  281. ports = output_count;
  282. if (ports < input_count)
  283. ports = input_count;
  284. if (ports == 0) {
  285. kfree(info);
  286. return -ENODEV;
  287. }
  288. if (ports > (256 / SNDRV_RAWMIDI_DEVICES))
  289. ports = 256 / SNDRV_RAWMIDI_DEVICES;
  290. down(&register_mutex);
  291. client = synths[card->number];
  292. if (client == NULL) {
  293. newclient = 1;
  294. client = kcalloc(1, sizeof(*client), GFP_KERNEL);
  295. if (client == NULL) {
  296. up(&register_mutex);
  297. kfree(info);
  298. return -ENOMEM;
  299. }
  300. memset(&callbacks, 0, sizeof(callbacks));
  301. callbacks.private_data = client;
  302. callbacks.allow_input = callbacks.allow_output = 1;
  303. client->seq_client = snd_seq_create_kernel_client(card, 0, &callbacks);
  304. if (client->seq_client < 0) {
  305. kfree(client);
  306. up(&register_mutex);
  307. kfree(info);
  308. return -ENOMEM;
  309. }
  310. set_client_name(client, card, info);
  311. } else if (device == 0)
  312. set_client_name(client, card, info); /* use the first device's name */
  313. msynth = kcalloc(ports, sizeof(seq_midisynth_t), GFP_KERNEL);
  314. port = kmalloc(sizeof(*port), GFP_KERNEL);
  315. if (msynth == NULL || port == NULL)
  316. goto __nomem;
  317. for (p = 0; p < ports; p++) {
  318. ms = &msynth[p];
  319. if (snd_seq_midisynth_new(ms, card, device, p) < 0)
  320. goto __nomem;
  321. /* declare port */
  322. memset(port, 0, sizeof(*port));
  323. port->addr.client = client->seq_client;
  324. port->addr.port = device * (256 / SNDRV_RAWMIDI_DEVICES) + p;
  325. port->flags = SNDRV_SEQ_PORT_FLG_GIVEN_PORT;
  326. memset(info, 0, sizeof(*info));
  327. info->device = device;
  328. if (p < output_count)
  329. info->stream = SNDRV_RAWMIDI_STREAM_OUTPUT;
  330. else
  331. info->stream = SNDRV_RAWMIDI_STREAM_INPUT;
  332. info->subdevice = p;
  333. if (snd_rawmidi_info_select(card, info) >= 0)
  334. strcpy(port->name, info->subname);
  335. if (! port->name[0]) {
  336. if (info->name[0]) {
  337. if (ports > 1)
  338. snprintf(port->name, sizeof(port->name), "%s-%d", info->name, p);
  339. else
  340. snprintf(port->name, sizeof(port->name), "%s", info->name);
  341. } else {
  342. /* last resort */
  343. if (ports > 1)
  344. sprintf(port->name, "MIDI %d-%d-%d", card->number, device, p);
  345. else
  346. sprintf(port->name, "MIDI %d-%d", card->number, device);
  347. }
  348. }
  349. if ((info->flags & SNDRV_RAWMIDI_INFO_OUTPUT) && p < output_count)
  350. port->capability |= SNDRV_SEQ_PORT_CAP_WRITE | SNDRV_SEQ_PORT_CAP_SYNC_WRITE | SNDRV_SEQ_PORT_CAP_SUBS_WRITE;
  351. if ((info->flags & SNDRV_RAWMIDI_INFO_INPUT) && p < input_count)
  352. port->capability |= SNDRV_SEQ_PORT_CAP_READ | SNDRV_SEQ_PORT_CAP_SYNC_READ | SNDRV_SEQ_PORT_CAP_SUBS_READ;
  353. if ((port->capability & (SNDRV_SEQ_PORT_CAP_WRITE|SNDRV_SEQ_PORT_CAP_READ)) == (SNDRV_SEQ_PORT_CAP_WRITE|SNDRV_SEQ_PORT_CAP_READ) &&
  354. info->flags & SNDRV_RAWMIDI_INFO_DUPLEX)
  355. port->capability |= SNDRV_SEQ_PORT_CAP_DUPLEX;
  356. port->type = SNDRV_SEQ_PORT_TYPE_MIDI_GENERIC;
  357. port->midi_channels = 16;
  358. memset(&pcallbacks, 0, sizeof(pcallbacks));
  359. pcallbacks.owner = THIS_MODULE;
  360. pcallbacks.private_data = ms;
  361. pcallbacks.subscribe = midisynth_subscribe;
  362. pcallbacks.unsubscribe = midisynth_unsubscribe;
  363. pcallbacks.use = midisynth_use;
  364. pcallbacks.unuse = midisynth_unuse;
  365. pcallbacks.event_input = event_process_midi;
  366. port->kernel = &pcallbacks;
  367. if (snd_seq_kernel_client_ctl(client->seq_client, SNDRV_SEQ_IOCTL_CREATE_PORT, port)<0)
  368. goto __nomem;
  369. ms->seq_client = client->seq_client;
  370. ms->seq_port = port->addr.port;
  371. }
  372. client->ports_per_device[device] = ports;
  373. client->ports[device] = msynth;
  374. client->num_ports++;
  375. if (newclient)
  376. synths[card->number] = client;
  377. up(&register_mutex);
  378. kfree(info);
  379. kfree(port);
  380. return 0; /* success */
  381. __nomem:
  382. if (msynth != NULL) {
  383. for (p = 0; p < ports; p++)
  384. snd_seq_midisynth_delete(&msynth[p]);
  385. kfree(msynth);
  386. }
  387. if (newclient) {
  388. snd_seq_delete_kernel_client(client->seq_client);
  389. kfree(client);
  390. }
  391. kfree(info);
  392. kfree(port);
  393. up(&register_mutex);
  394. return -ENOMEM;
  395. }
  396. /* release midi synth port */
  397. static int
  398. snd_seq_midisynth_unregister_port(snd_seq_device_t *dev)
  399. {
  400. seq_midisynth_client_t *client;
  401. seq_midisynth_t *msynth;
  402. snd_card_t *card = dev->card;
  403. int device = dev->device, p, ports;
  404. down(&register_mutex);
  405. client = synths[card->number];
  406. if (client == NULL || client->ports[device] == NULL) {
  407. up(&register_mutex);
  408. return -ENODEV;
  409. }
  410. ports = client->ports_per_device[device];
  411. client->ports_per_device[device] = 0;
  412. msynth = client->ports[device];
  413. client->ports[device] = NULL;
  414. snd_runtime_check(msynth != NULL || ports <= 0, goto __skip);
  415. for (p = 0; p < ports; p++)
  416. snd_seq_midisynth_delete(&msynth[p]);
  417. kfree(msynth);
  418. __skip:
  419. client->num_ports--;
  420. if (client->num_ports <= 0) {
  421. snd_seq_delete_kernel_client(client->seq_client);
  422. synths[card->number] = NULL;
  423. kfree(client);
  424. }
  425. up(&register_mutex);
  426. return 0;
  427. }
  428. static int __init alsa_seq_midi_init(void)
  429. {
  430. static snd_seq_dev_ops_t ops = {
  431. snd_seq_midisynth_register_port,
  432. snd_seq_midisynth_unregister_port,
  433. };
  434. memset(&synths, 0, sizeof(synths));
  435. snd_seq_autoload_lock();
  436. snd_seq_device_register_driver(SNDRV_SEQ_DEV_ID_MIDISYNTH, &ops, 0);
  437. snd_seq_autoload_unlock();
  438. return 0;
  439. }
  440. static void __exit alsa_seq_midi_exit(void)
  441. {
  442. snd_seq_device_unregister_driver(SNDRV_SEQ_DEV_ID_MIDISYNTH);
  443. }
  444. module_init(alsa_seq_midi_init)
  445. module_exit(alsa_seq_midi_exit)