{"id":162,"date":"2007-01-22T08:24:00","date_gmt":"2007-01-22T16:24:00","guid":{"rendered":"http:\/\/www.mccambridge.org\/blog\/2007\/01\/howto-mythtv-snes-joystick-control\/"},"modified":"2022-09-11T00:40:44","modified_gmt":"2022-09-11T00:40:44","slug":"howto-mythtv-snes-joystick-control","status":"publish","type":"post","link":"http:\/\/www.mccambridge.org\/blog\/2007\/01\/howto-mythtv-snes-joystick-control\/","title":{"rendered":"Howto: Mythtv SNES Joystick Control"},"content":{"rendered":"<p><strong>Update:<\/strong> Why oh why can&#8217;t Blogger preview my post in the *actual* stylesheet of my blog?  I seem to remember WordPress doing this&#8230; if so, I must switch.  ASAP.<\/p>\n<p>I&#8217;m back down in Madison, and in the midst of unpacking all my junk after moving down here from home.  One thing that Nate &#038; I set up right away is my HTPC, an <a href=\"http:\/\/www.ubuntu.com\">Ubuntu<\/a>-based <a href=\"http:\/\/www.mythtv.org\">MythTV<\/a> box.  Unfortunately, I noticed over winter break that my homemade serial-port IR receiver has given up the ghost, so I can no longer control MythTV from my universal remote.  I&#8217;ve ordered the parts for a <a href=\"http:\/\/usbirboy.sourceforge.net\">USB IR receiver<\/a>, but as I mentioned earlier, my soldering iron has <em>also<\/em> given up the ghost&#8230;<\/p>\n<p>So, what to do in the interim?  Well, there is a keyboard attached to the Myth box, but it doesn&#8217;t reach the couch.  Enter the SNES controller and MythTV joystick control.  Here&#8217;s how I got it to work:<\/p>\n<h3>Goal<\/h3>\n<ul>\n<li>Control MythTV from an SNES controller (or any other gamepad)<\/li>\n<\/ul>\n<h3>Required Software \/ Hardware<\/h3>\n<ul>\n<li>MythTV (I believe any version since 0.17 will work)<\/li>\n<li>SNES controller connected via parallel port adapter and the gamecon driver (see Documentation\/input\/joystick-parport.txt in the Linux source tree)<\/li>\n<li><code>jstest<\/code> <em>(Optional, available on Ubuntu in the &#8220;joystick&#8221; package)<\/em><\/li>\n<\/ul>\n<h3>Determining joystick layout<\/h3>\n<p>The first step in writing a MythTV joystick configuration is to determine the exact layout of your joystick, as Linux sees it.  Specifically, we need to know what axes (and axis values) and buttons correspond to the controls on the joystick.<\/p>\n<p>If you&#8217;re using an SNES controller with the <code>gamecon<\/code> driver, I&#8217;ve done the legwork, and you can <a href=\"#joystickmenurc\">skip to the next section<\/a> below, using my example configuration.  (Obviously you should test it and make sure it works.)<\/p>\n<p>To determine the layout of your own joystick, you can use the optional <code>jstest<\/code> program mentioned above.  You can install it on Ubuntu from the <code>joystick<\/code> package (you will need the universe repository enabled):<\/p>\n<p><code>$ sudo apt-get install joystick<\/code><\/p>\n<p>Run <code>jstest<\/code> and record the axis numbers and values, as well as button numbers, that correspond to all the controls you wish to use on your joystick.  <code>jstest<\/code> requires a parameter of the joystick device to open.  For example, I run <code>jstest<\/code> like this for my first SNES controller:<\/p>\n<p><code>$ jstest \/dev\/input\/js0<\/code><\/p>\n<p><code>jstest<\/code> produces output for my SNES controller like this:<\/p>\n<p><code>Driver version is 2.1.0.<\/p>\n<p>Joystick (SNES pad) has 2 axes (X, Y)<\/p>\n<p>and 8 buttons (BtnX, BtnY, BtnTL, BtnTR, BtnTR2, BtnSelect, BtnThumbL, BtnThumbR).<\/p>\n<p>Testing ... (interrupt to exit)<\/p>\n<p>Axes:  0:     0  1:     0 Buttons:  0:off  1:off  2:off  3:off  4:off  5:off  6:off  7:off<\/code><\/p>\n<p>This tells me that the joystick as seen by Linux has two axes and 7 buttons.  Pressing them in sequence changes the output, such as this output when I hold the directional pad to the left and press the &#8220;A&#8221; button:<\/p>\n<p><code>Testing ... (interrupt to exit)<\/p>\n<p>Axes:  0:-32767  1:     0 Buttons:  0:on   1:off  2:off  3:off  4:off  5:off  6:off  7:off<\/code><\/p>\n<p>This tells you that the D-pad &#8220;left&#8221; direction corresponds to value -32767 on Axis 0, and that the &#8220;A&#8221; button corresponds to button 0.<\/p>\n<p>Compiling a full list for your joystick would give you a mapping like this one for the SNES controllers &#038; gamecon driver:<\/p>\n<table cellpadding=0 cellspacing=0 border=0 width=320>\n<tr>\n<th align=left>SNES Button<\/th>\n<th align=left>Linux joystick mapping<\/th>\n<\/tr>\n<tr>\n<td>D-Pad Up<\/td>\n<td>Axis 1: -32767<\/td>\n<\/tr>\n<tr>\n<td>D-Pad Right<\/td>\n<td>Axis 0: 32767<\/td>\n<\/tr>\n<tr>\n<td>D-Pad Down<\/td>\n<td>Axis 1: 32767<\/td>\n<\/tr>\n<tr>\n<td>D-Pad Left<\/td>\n<td>Axis 0: -32767<\/td>\n<\/tr>\n<tr>\n<td>A<\/td>\n<td>Button 0<\/td>\n<\/tr>\n<tr>\n<td>B<\/td>\n<td>Button 1<\/td>\n<\/tr>\n<tr>\n<td>X<\/td>\n<td>Button 2<\/td>\n<\/tr>\n<tr>\n<td>Y<\/td>\n<td>Button 3<\/td>\n<\/tr>\n<tr>\n<td>L<\/td>\n<td>Button 4<\/td>\n<\/tr>\n<tr>\n<td>R<\/td>\n<td>Button 5<\/td>\n<\/tr>\n<tr>\n<td>Select<\/td>\n<td>Button 6<\/td>\n<\/tr>\n<tr>\n<td>Start<\/td>\n<td>Button 7<\/td>\n<\/tr>\n<\/table>\n<p><a name=\"joystickmenurc\"><\/a><\/p>\n<h3>Writing the MythTV <code>Joystickmenurc<\/code>Configuration File<\/h3>\n<p>Now that you have the logical layout of your joystick in hand, it&#8217;s time to configure MythTV itself.  This is done by means of the <code>joystickmenurc<\/code> configuration file, located at <code>~\/.mythtv\/joystickmenurc<\/code> for the user that mythfrontend is launched under.  This file will instruct MythTV as to which joystick device it should open, and then provides a mapping from the joystick layout to the keyboard strokes for MythTV.<\/p>\n<h4><code>joystickmenurc<\/code> Format<\/h4>\n<p>As described in the <a href=\"http:\/\/www.mythtv.org\/wiki\/index.php\/Joystick_Control#Formatting\">formatting section<\/a> of the Joystick Control page on the MythTV Wiki, the format for the <code>joystickmenurc<\/code> is as follows:<\/p>\n<dl>\n<dt><code>devicename &lt;devname&gt;<\/code><\/dt>\n<dd>Specify the name of the joystick device to use, (e.g. \/dev\/input\/js0)<\/dd>\n<dt><code>button &lt;num&gt; &lt;keystring&gt;<\/code>\n<\/dt>\n<dd>Send <code>keystring<\/code> when button <code>num<\/code> is released\n<\/dd>\n<dt><code>chord &lt;cnum&gt; &lt;bnum&gt; &lt;keystring&gt;<\/code>\n<\/dt>\n<dd>If button <code>cnum<\/code> is down, and button <code>bnum<\/code> is released, send <code>keystring<\/code>\n<\/dd>\n<dt><code>axis &lt;num&gt; &lt;from&gt; &lt;to&gt; &lt;keystring&gt;<\/code>\n<\/dt>\n<dd>If axis <code>num<\/code> goes into the range of <code>from<\/code>&#8211;<code>to<\/code> send <code>keystring<\/code>\n<\/dd>\n<\/dl>\n<h4>Example <code>joystickmenurc<\/code> for SNES controller<\/h4>\n<p>I think the formatting is best explained by an example.  Below is the actual <code>~\/.mythtv\/joystickmenurc<\/code> file I use on my system, with commenting explaining exactly what is intended and how it works.  If you use an SNES controller attached via the <code>gamecon<\/code> driver to <code>\/dev\/input\/js0<\/code>, this configuration should work for you as-is.  Simply drop it in your <code>~\/.mythtv<\/code> directory and relaunch <code>mythfrontend<\/code>.  For everyone else, feel free to use this as a template, or see the <a href=\"http:\/\/www.mythtv.org\/wiki\/index.php\/Joystick_Control\">Joystick Control<\/a> page on the MythTV Wiki for an example of an Xbox configuration file.<\/p>\n<blockquote>\n<pre># ~\/.mythtv\/joystickmenurc\n# Joystick menu config file\n#\n# Created 1\/21\/2007 by Colin McCambridge\n# based on instructions at http:\/\/www.mythtv.org\/wiki\/index.php\/Joystick_Control\n#\n# This joystick menu configuration controls MythTV with an SNES\n# gamepad connected via parallel port and the gamecon driver.\n#\n# Controls:\n#  SNES Pad            Keypresses       Joystick Device\n#  --------            ----------       ---------------\n#  UP\/DOWN axis        Up, Down         Axis 1: U -32767 D 32767\n#  LEFT\/RIGHT axis     Left, Right      Axis 0: L -32767 R 32767\n#  B                   Enter            Button 1\n#  Y                   Esc              Button 3\n#  A                   P  (Play\/Pause)  Button 0\n#  X                   S  (Guide)       Button 2\n#  Start               M  (Menu)        Button 7\n#  Select              I  (Info)        Button 6\n#  Left Top            Page Up (REW)    Button 4\n#  Right Top           Page Down (FF)   Button 5\n#\n\n###########################################################\n#\n#    SNES Gamepad Device\n#\n###########################################################\n\ndevicename \/dev\/input\/js0\n\n###########################################################\n#\n#    D-Pad\n#\n###########################################################\n\n#Up\n        axis    1       -32767  -1      Up\n#Down\n        axis    1       1       32767   Down\n#Left\n        axis    0       -32767  -1      Left\n#Right\n        axis    0       1       32767   Right\n\n###########################################################\n#\n#    Buttons\n#\n###########################################################\n\n#A ==> Play\/Pause\n        button  0       P\n#B ==> Enter\n        button  1       Enter\n#X ==> Guide (S)\n        button  2       S\n#Y ==> Exit (Esc)\n        button  3       Escape\n\n#Start ==> Menu (M)\n        button  7       M\n#Select ==> Info (I)\n        button  6       I\n\n#Left Top ==> Rewind (PgUp)\n        button  4       PgUp\n#Right Top ==> F.Fwd (PgDown)\n        button  5       PgDown\n<\/pre>\n<\/blockquote>\n<h3>Final Notes<\/h3>\n<p>For making your own <code>joystickmenurc<\/code> file, you may find the <a href=\"http:\/\/www.mythtv.org\/wiki\/index.php\/Keybindings\">MythTV Default Keybindings<\/a>, or the more abbreviated <a href=\"http:\/\/www.mythtv.org\/wiki\/index.php\/User_Manual:Daily_Use#Conventions_and_notes\">Remote Control Buttons<\/a> list handy references as to the control operations you can define.<\/p>\n<p>For an exact list of valid key names to use (e.g. &#8220;Escape&#8221;) refer to the Qt documentation for the <a href=\"http:\/\/doc.trolltech.com\/4.1\/qt.html#Key-enum\"><code>Qt.Key enum<\/code><\/a>.  This document lists key names in the form: &#8220;<code>Qt::Key_Escape<\/code>&#8220;, use only the name following the underscore.<\/p>\n<p><strong>Note:<\/strong> there is an undocumented discrepancy regarding the keys Page Up and Page Down.  While the <code>Qt.Key<\/code> enum lists them as <code>PageUp<\/code> and <code>PageDown<\/code>, they can actually only be specified as either <code>\"PgUp\"<\/code> and <code>\"PgDown\"<\/code>, or <code>\"Page Up\"<\/code> and <code>\"Page Down\"<\/code> respectively.  See messages 3 and 4 of <a href=\"http:\/\/lists.trolltech.com\/qt-interest\/2006-12\/thread00648-0.html\">this email thread<\/a> for reference, or view the relevant Qt source file (especially the <code>keyname[]<\/code> array at line 89, and method <code>decodeString<\/code> at line 388): <a href=\"http:\/\/koders.com\/cpp\/fid31DA25D551C46221E29EC8ECF6CCD751F0276681.aspx\"><code>qkeysequence.cpp<\/code><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Update: Why oh why can&#8217;t Blogger preview my post in the *actual* stylesheet of my blog? I seem to remember WordPress doing this&#8230; if so, I must switch. ASAP. I&#8217;m back down in Madison, and in the midst of unpacking all my junk after moving down here from home. One thing that Nate &#038; I [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[7,12,21,24],"tags":[],"_links":{"self":[{"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/posts\/162"}],"collection":[{"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/comments?post=162"}],"version-history":[{"count":1,"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/posts\/162\/revisions"}],"predecessor-version":[{"id":1733,"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/posts\/162\/revisions\/1733"}],"wp:attachment":[{"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/media?parent=162"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/categories?post=162"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.mccambridge.org\/blog\/wp-json\/wp\/v2\/tags?post=162"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}