Typica is a free program for professional coffee roasters. https://typica.us
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。

firsttime.html 17KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306
  1. <html>
  2. <head>
  3. <title>Typica - Data for Coffee Roasters</title>
  4. <link rel="stylesheet" type="text/css" href="../style.css">
  5. </head>
  6. <body>
  7. <div id="page">
  8. <div id="topmatter">
  9. <div id="topbanner">
  10. <img src="../logo96.png" height="96px" width="96px" alt="Typica logo" />
  11. <h1>Typica</h1>
  12. <h2>Data for Coffee Roasters</h2>
  13. </div>
  14. <div id="menu">
  15. <a class="tab" href="../index.html">Project Home</a>
  16. <a class="tab" href="../downloads.html" >Downloads</a>
  17. <a class="tab active" href="../documentation.html" >Documentation</a>
  18. <a class="tab" href="../screenshots.html" >Screenshots and Videos</a>
  19. <a class="tab" href="../involvement.html" >Get Involved</a>
  20. <a href="http://appliedcoffeetechnology.tumblr.com/tagged/Typica" class="tab">Blog</a>
  21. </div>
  22. </div>
  23. <div id="maintext">
  24. <ul>
  25. <li><a href="#database">Database Connection</a></li>
  26. <li><a href="#configfile">Open Configuration File</a></li>
  27. <li><a href="#hardware">Configuring Typica for your Hardware</a></li>
  28. </ul>
  29. <h1>Running Typica for the First Time</h1>
  30. <p>After downloading Typica and extracting the contents of the .zip (Microsoft Windows) or
  31. copying the contents of the .dmg (Mac OS X) to a more convenient location, you should have
  32. a folder that contains three other folders. The <tt>source</tt> folder contains all of
  33. the source code for Typica which you may use if you want to modify the software. This
  34. folder also contains a file called <tt>typica.pdf</tt> which has complete documentation
  35. of how Typica works (not how to use Typica). You do not need to read that to use Typica,
  36. but you may still find it interesting. The contents of this folder are not required to
  37. run Typica and may be deleted if you have no use for it. The <tt>configuration</tt> folder
  38. contains an example configuration for Typica to use. These files can be modified to perform
  39. extensive customization of Typica or to add or remove reports if you want to change how
  40. Typica works, however most do not have a need to modify any of these files. Typica requires
  41. that the contents of this directory exist for proper operation. The <tt>program</tt> folder
  42. contains the Typica executable and its library dependencies. On Mac OS X this is instead
  43. all collected in an .app bundle.</p>
  44. <p>Find either Typica.exe (Microsoft Windows) or Typica.app (Mac OS X) and double click
  45. to open the program.</p>
  46. <img src="images/explorer.png" />
  47. <a name="database" />
  48. <h2>Database Connection</h2>
  49. <img src="images/dbconnect.png" />
  50. <p>The first time you start Typica, you will be asked for the information needed to
  51. connect to a database. If you have not installed PostgreSQL, you can click Cancel to
  52. continue without connecting to a database. Note that doing so will result in Typica
  53. having a very limited feature set. If you have installed PostgreSQL on the same
  54. computer as Typica, the host name should be set to <tt>localhost</tt>. If PostgreSQL
  55. is running on a different computer you will need to specify the IP address of that
  56. computer.</p>
  57. <p>If you have set up a database for Typica to use, the name of that database
  58. should be set as the database name, otherwise the PostgreSQL installer creates a
  59. database named <tt>postgres</tt> which you can use.</p>
  60. <p>Similarly, if you have created a new database
  61. user role for Typica, the user name and password that you chose for this should be
  62. entered as the user name and password here. Otherwise, the PostgreSQL installer creates
  63. a user named <tt>postgres</tt> with the password that you chose during the installation
  64. process.</p>
  65. <p>Once all of this has been entered, click Connect.</p>
  66. <p>You only need to enter this information the first time you start Typica. It will
  67. not prompt for this information in the future unless Typica fails to connect to the
  68. database or unless you select a menu item that instructs Typica to forget the
  69. connection settings.</p>
  70. <h3>Troubleshooting: What if it Doesn't Work?</h3>
  71. <p>The problem is <em>not</em> with Typica. If you are running PostgreSQL on the same
  72. computer as you are running Typica, you have most likely typed something incorrectly.
  73. You can use the SQL Shell (psql) to verify that your login information is correct. If
  74. you can connect on port 5432, the same information used to connect with psql will also
  75. be usable with Typica. Another possibility is that PostgreSQL is not currently running.
  76. If you are running PostgreSQL on a different computer, make sure that the other computer
  77. is turned on, that PostgreSQL is running, and that it is configured to accept connections
  78. from the network.</p>
  79. <a name="configfile" />
  80. <h2>Open Configuration File</h2>
  81. <p>Every time you open Typica, you will be asked to open a configuration file. Typica
  82. comes with one example configuration file that meets most needs, however you can
  83. create your own if you have special requirements. This documentation assumes that you
  84. are using the provided example configuration.</p>
  85. <p>The first time you start Typica or when using a new version of Typica for the first
  86. time, you may find that this prompt shows files in the wrong directory. Typica will show
  87. files from the most recently used directory or if there isn't one, a platform dependent
  88. default.</p>
  89. <img src="images/config1.png" />
  90. <p>This is a normal Open File window which works the same as when you select the Open
  91. menu item in most programs. A number of controls are available to change to the correct
  92. directory. You want to be in the <tt>configuration</tt> folder described previously.</p>
  93. <img src="images/config2.png" />
  94. <p>Once you are in the correct directory, select <tt>config.xml</tt> and click Open.</p>
  95. <img src="images/config3.png" />
  96. </p>The next window you see should look like this:</p>
  97. <img src="images/nav.png" />
  98. <h3>Troubleshooting: It Opened Internet Explorer and is showing me gobbledygook.</h3>
  99. <p>If this happens, you were not selecting the configuration file from within Typica.
  100. Go back to Typica and try again. In particular, note the title bar of the window you
  101. are in. See the screenshots above where it says "Open Configuration File". If your
  102. window doesn't say that, you're not in Typica. You may think you are, but you're wrong.</p>
  103. <h3>Troubleshooting: I opened a file and nothing is happening.</h3>
  104. <p>Exit Typica and try again. You most likely selected the wrong file to open. Please
  105. go back to the description of which file is required, read the instructions, and follow
  106. them carefully.</p>
  107. <h3>Tip: Bypass the Configuration Prompt</h3>
  108. <p>Typica has a command line option available for specifying which configuration file
  109. should be used. To do this, use -c and the path to the configuration you want to open.
  110. This will prevent the configuration prompt from appearing. On Microsoft Windows, you
  111. can do this by creating a shortcut. In Windows Explorer, go to the directory containing
  112. Typica.exe. Right click and select "Create shortcut".</p>
  113. <img src="images/shortcut.png" />
  114. <p>Now right click the shortcut and select Properties.</p>
  115. <img src="images/properties.png" />
  116. <p>Find the field labeled Target. At the end of the line after the quotation mark, add
  117. a space and <tt>-c ../configuration/config.xml</tt> and click OK. The portion of the
  118. line that reads <tt>../configuration/config.xml</tt> is the path to your desired
  119. configuration file relative to the directory with the program. You can also use an
  120. absolute path to the file starting with <tt>C:\</tt> on Microsoft Windows or <tt>/</tt>
  121. on other platforms.</p>
  122. <h3>Tip: Pin the Shortcut for Convenient Access</h3>
  123. <p>The shortcut created in the previous tip can be moved anywhere for convenient
  124. access. You can right click that and find options to pin that to the task bar for
  125. convenient single click access. On Windows 7 you can also pin that to the start menu
  126. and on Windows 8 you can pin that to the start screen.</p>
  127. <a name="hardware" />
  128. <h2>Configuring Typica for your Hardware</h2>
  129. <h3>Hardware</h3>
  130. <p>Once you've started Typica and selected your configuration file, you should see
  131. the main navigation window. It looks like this:</p>
  132. <img src="images/nav.png" />
  133. <p>The first time you use Typica you will not have any coffee roasters configured
  134. for use. This also applies for people who have used older versions of Typica and are
  135. now upgrading to version 1.4 or later. To do this, click the Configure Roasters button.
  136. This will bring up a new window with two panels. In the lower left you will see a
  137. button labeled +. Click that to add your first coffee roaster.</p>
  138. <p>Now you will see an item in the left panel. You can double click on that to
  139. rename it if you want. Whatever you name this is what will appear in the list in
  140. the navigation window. Choose a name that you'll recognize as the particular machine
  141. you'll be using.</p>
  142. <p>When you click on the roaster in the left panel you will see some details in the
  143. right panel.</p>
  144. <img src="images/rconfig1.png" />
  145. <p>Next to "Machine ID for database" you should enter a number. This ID number will
  146. be used to identify this roaster in the database and it will be associated with every
  147. batch of coffee you roast. If you have used an older version of Typica, you can use
  148. the same number that you had specified previously to maintain continuity. If you are
  149. setting up Typica for the first time, just use 1 for your first roaster, 2 for your
  150. second, and so on.</p>
  151. <p>You will also see three buttons: "Add Device", "Add Annotation Control", and
  152. "Advanced Features". First we will want to use the Add Device button to specify the
  153. data acquisition hardware you will use to connect this coffee roaster to your
  154. computer.</p>
  155. <p>You should see up to three items in a menu when you click "Add Device". Select
  156. the one matching the hardware that you intend to use. You will find a new item on
  157. the left matching your selection.</p>
  158. <p>In the case of NI-DAQmx Base or NI-DAQmx, clicking the new item in the left panel
  159. will change the right panel to display a single button: "Add Device". Click this to
  160. see a list of supported hardware and click the item that matches the hardware you
  161. have. In the case of NI-DAQmx, you can select "NI USB 9211A" for any supported USB
  162. carrier containing a NI 9211 module. Whichever you choose, you will have a new item on
  163. the left.</p>
  164. <p>If you instead selected "Modbus RTU Device", you will want to connect the hardware
  165. to your computer before continuing. Once you click the new item in the left panel
  166. Typica will attempt to detect any serial port on your computer and if your RS-485 to
  167. USB serial adapter is not connected, it will not be shown. Click the item and you
  168. will see all of the details for configuring Typica to use your Modbus RTU device.</p>
  169. <img src="images/modbusconfig.png" />
  170. <p>The appropriate settings here depend on settings that must be configured on the
  171. Modbus RTU device and they depend on which device you have. You will require both
  172. the operator manual and the communications manual for your device to determine the
  173. correct settings for your hardware.</p>
  174. <p>If you selected NI DAQmx and then NI USB TC01, you will have an item on the
  175. left representing that device. Clicking this will show three settings.</p>
  176. <img src="images/tc01config.png" />
  177. <p>The Device ID is how the National Instruments software identifies the device. In
  178. the case of this hardware, this will be Dev<em>n</em> where <em>n</em> is some number.
  179. This will most likely be <tt>Dev1</tt> but you can verify this in National Instrument's
  180. Measurement & Automation Explorer. The Column Name indicates the name of the column
  181. where measurements from this device will be placed in the table view of your roasting
  182. data. A short, one word identifier is recommended for this. Note that certain advanced
  183. features will require knowing a column name. The Thermocouple Type should match the type
  184. of thermocouple you have in your roaster. If the wrong thermocouple type is specified,
  185. your measurements will not be correct. Finally, if you double click this item on the
  186. left, you can rename it. Whatever the item is named on the left is what will be displayed
  187. on the indicator showing the most recent measurement. This can be a longer descriptive
  188. name.</p>
  189. <p>In the case of NI 9211 based devices used either through NI DAQmx or NI DAQmx Base,
  190. clicking the new item on the left will show a Device ID field and an Add Channel button.
  191. If you are using NI DAQmx Base, this will be Dev<em>n</em> where <em>n</em> is a number
  192. starting with 1 for the first connected device. If you only have one device, this will
  193. be <tt>Dev1</tt>. If you are using NI DAQmx, some hardware will follow this convention
  194. and some will not. You should check for the appropriate device ID in Measurement &
  195. Automation Explorer. Ensure that you are looking at the item representing the device
  196. itself and not just the chassis the device is plugged into. Once the Device ID is
  197. specified, you can click Add Channel to add as many thermocouple channels as you have
  198. connected to this device. With this hardware it is recommended that you do not connect
  199. more than three thermocouples to a single device and these should be wired starting
  200. from TC0.</p>
  201. <p>For each channel, you can double click the item on the left to change the text that
  202. will appear in the indicator showing the most recent measurement. When you click on
  203. these you will see on the right settings for Column Name and Thermocouple Type. The
  204. Column Name will appear at the top of the table view in the column where measurements
  205. from this channel are placed. A short one word name is recommended. This name should
  206. be unique across all channels configured for a particular roaster. The thermocouple
  207. type must match the type of the thermocouple connected on that channel. If it does not,
  208. your measurements will not be correct.</p>
  209. <h3>Annotation Controls</h3>
  210. <p>If you click the item on the left representing your roaster, one of the available
  211. buttons is "Add Annotation Control". Clicking this will provide three options:
  212. "Annotation Button", "Counting Button", and "Numeric Entry". These controls can be
  213. used to add annotations to your roasting data as you roast. If you don't want to do
  214. this, you don't need to add any of these controls.</p>
  215. <p>An Annotation Button is used to make note of an event fixed at a particular moment
  216. in time. If your roaster has a control with a small number of states, you can have a
  217. different button for each state and when you activate that button it will place a
  218. note at the most recent measurement. Some use this to note airflow control changes,
  219. some prefer to note details such as the start of first crack. Clicking the item on the
  220. left representing your annotation button will show two settings on the right. The
  221. Button Text is the text that will appear on the button and the Annotation Text is the
  222. text that will appear in the log when the button is activated. You can have any number
  223. of these buttons, but it is recommended to keep the number small.</p>
  224. <p>A Counting Button is like an Annotation Button but you can have as part of the
  225. annotation text a number corresponding to the number of times the button has been
  226. clicked. This is useful when pulling several samples from a roast for roast profile
  227. development as you will have a unique identifier for each sample you pull which you
  228. can reference later when attempting to replicate your desired roast. It is recommended
  229. that you only have one Counting Button.</p>
  230. <img src="images/countconfig.png" />
  231. <p>Numeric Entry provides a way to provide notes with numeric data that cannot be
  232. logged automatically. Some roasters have fuel or air flow controls with a large number
  233. of numerically identified settings. Some people may want to occassionally note the
  234. reading from a manometer. This is the control to do that. Clicking the item representing
  235. a Numeric Entry on the left will show several options allowing you to specify how the
  236. field is identified on the screen, minimum and maximum values, and the number of places
  237. after the decimal point to allow. All of these must be set to some value. Optionally you
  238. can also specify prefix text and/or suffix text. The content of these fields will be
  239. included in the annotation before or after the entered number. This can be used to make
  240. clear which control adjustment is represented or the unit a measurement reading was
  241. taken in.</p>
  242. </div>
  243. </div>
  244. </body>
  245. </html>