visus
/
teensy-audio
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1030 Commits
2 Branches
Tree: 9faffc2d0d
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '9faffc2d0d'
${ noResults }
teensy-audio/gui/index.html

5576 lines
254KB
Raw Blame History 

  1. <!DOCTYPE html>

  2. <!-- vim: set ts=4: -->

  3. <html>

  4. <meta charset="utf-8">

  5. <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=0"/>

  6. <meta name="apple-mobile-web-app-capable" content="yes">

  7. <meta name="mobile-web-app-capable" content="yes">

  8. 

  9. <!--

  10.   Modified from original Node-Red source, for audio system visualization

  11. 

  12.   Copyright 2013 IBM Corp.

  13. 

  14.   Licensed under the Apache License, Version 2.0 (the "License");

  15.   you may not use this file except in compliance with the License.

  16.   You may obtain a copy of the License at

  17. 

  18.   http://www.apache.org/licenses/LICENSE-2.0

  19. 

  20.   Unless required by applicable law or agreed to in writing, software

  21.   distributed under the License is distributed on an "AS IS" BASIS,

  22.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  23.   See the License for the specific language governing permissions and

  24.   limitations under the License.

  25. -->

  26. <head>

  27. <title>Audio System Design Tool for Teensy Audio Library</title>

  28. <link href="bootstrap/css/bootstrap.min.css" rel="stylesheet" media="screen">

  29. <link href="jquery/css/smoothness/jquery-ui-1.10.3.custom.min.css" rel="stylesheet" media="screen">

  30. <link rel="stylesheet" type="text/css" href="orion/built-editor.css"/>

  31. <link rel="stylesheet" type="text/css" href="font-awesome/css/font-awesome.min.css"/>

  32. <link rel="stylesheet" href="style.css">

  33. <style>

  34. table.doc {border-spacing:3px; border-collapse:separate; font-size: 80%}

  35. tr.top {background-color:#C0C0C0}

  36. tr.odd {background-color:#F0F0F0}

  37. tr.even {background-color:#E0E0E0}

  38. p.func {padding-bottom:0; margin:0px}

  39. p.desc {padding-left:2em; margin:0px; padding-top:0.2em; padding-bottom:0.8em; font-size:0.75em}

  40. p.exam {padding-left:2em; text-indent:-1.2em; margin:0px; padding-top:0; padding-bottom:0.5em; font-size:0.75em; font-weight:bold}

  41. pre.desc {padding-left:3em; margin:0px; padding-top:0em; padding-bottom:0.8em; font-size:0.75em;

  42. 	background-color:#FFFFFF; border:0px; line-height:100%;

  43. }

  44. span.indent {padding-left:2em}

  45. span.literal {color: #006699}

  46. span.comment {color: #777755}

  47. span.keyword {color: #cc6600}

  48. span.function {color: #996600}

  49. span.mainfunction {color: #993300; font-weight: bolder}

  50. </style>

  51. </head>

  52. <body spellcheck="false">

  53. <div class="navbar navbar-inverse navbar-fixed-top">

  54. 	<div class="navbar-inner">

  55. 		<div class="container-fluid">

  56. 			<span class="brand">Audio System Design Tool for <a href="http://www.pjrc.com/teensy/td_libs_Audio.html" target="_blank">Teensy Audio Library</a></span>

  57. 			<div class="btn-group pull-right">

  58. 				<a class="btn dropdown-toggle" data-toggle="dropdown" href="#"><i class="icon-align-justify"></i> <span class="caret"></span></a>

  59. 				<ul class="dropdown-menu">

  60. 					<li><a id="btn-sidebar" tabindex="-1" href="#"><i class="icon-ok pull-right"></i><i class="icon-list-alt"></i> Sidebar</a></li>

  61. 					<li class="divider"></li>

  62. 					<!-- <li><a id="btn-node-status" tabindex="-1" href="#"><i class="icon-ok pull-right"></i><i class="icon-info-sign"></i> Node Status</a></li>

  63. 					<li class="divider"></li>

  64. -->

  65. 					<!--

  66. <li class="dropdown-submenu pull-left"><a tabindex="-1" href="#"><i class="icon-edit"></i> Import from...</a>

  67. 						<ul class="dropdown-menu">

  68. 							<li><a id="btn-import" tabindex="-1" href="#"><i class="icon-edit"></i> Clipboard...</a></li>

  69. 							<li id="flow-menu-parent" class="dropdown-submenu pull-left">

  70. 								<a tabindex="-1" href="#"><i class="icon-book"></i> Library</a>

  71. 								<ul class="dropdown-menu"></ul>

  72. 							</li>

  73. 						</ul>

  74. 					</li>

  75. 					<li id="li-menu-export" class="dropdown-submenu disabled pull-left"><a tabindex="-1" href="#"><i class="icon-share"></i> Export to...</a>

  76. 						<ul class="dropdown-menu">

  77. 							<li id="li-menu-export-clipboard" class="disabled"><a id="btn-export-clipboard" tabindex="-1" href="#"><i class="icon-share"></i> Clipboard...</a></li>

  78. 							<li id="li-menu-export-library" class="disabled"><a id="btn-export-library" tabindex="-1" href="#"><i class="icon-book"></i> Library...</a></li>

  79. 						</ul>

  80. 					</li>

  81. 					<li class="divider"></li>

  82. -->

  83. 					<!--

  84.  <li><a id="btn-config-nodes" tabindex="-1" href="#"><i class="icon-th-list"></i> Configuration nodes...</a></li>

  85. 					<li class="divider"></li>

  86. -->

  87. 					<!--

  88. <li class="dropdown-submenu pull-left"><a tabindex="-1" href="#"><i class="icon-th-large"></i> Workspaces</a>

  89. 						<ul id="workspace-menu-list" class="dropdown-menu">

  90. 							<li><a id="btn-workspace-add" tabindex="-1" href="#"><i class="icon-plus"></i> Add</a></li>

  91. 							<li><a id="btn-workspace-edit" tabindex="-1" href="#"><i class="icon-edit"></i> Rename</a></li>

  92. 							<li><a id="btn-workspace-delete" tabindex="-1" href="#"><i class="icon-minus"></i> Delete</a></li>

  93. 							<li class="divider"></li>

  94. 						</ul>

  95. 					</li>

  96. 					<li class="divider"></li>-->

  97. 					<li><a id="btn-keyboard-shortcuts" tabindex="-1" href="#"><i class="icon-question-sign"></i> Keyboard Shortcuts</a></li>

  98. 					<li><a id="btn-help" tabindex="-1" href="http://node-red.github.io/docs" target="_blank"><i class="icon-question-sign"></i> Help...</a></li>

  99. 				</ul>

  100. 			</div>

  101. 			<div class="btn-group pull-left">

  102. 				<a id="btn-deploy" class="btn action-deploy disabled" href="#"><i id="btn-icn-deploy" class="icon-upload"></i>Export</a>

  103. 				<a id="btn-import" class="btn action-import disabled" href="#"><i id="btn-icn-download" class="icon-download"></i>Import</a>

  104. 			</div>

  105. 		</div>

  106. 	</div>

  107. </div>

  108. <div id="main-container" class="sidebar-closed">

  109. 	<div id="palette">

  110. 		<img src="img/spin.svg" class="palette-spinner"/>

  111. 		<div id="palette-container" class="palette-scroll">

  112. 		</div>

  113. 		<div id="palette-search">

  114. 			<i class="icon-search"></i><input id="palette-search-input" type="text" placeholder="filter"><a href="#" id="palette-search-clear"><i class="icon-remove"></i></a></input>

  115. 		</div>

  116. 	</div><!-- /palette -->

  117. 

  118. 	<div id="workspace">

  119. 		<ul id="workspace-tabs"></ul>

  120. 		<!--<div id="workspace-add-tab"><a id="btn-workspace-add-tab" href="#"><i class="icon-plus"></i></a></div>-->

  121. 		<div id="chart"></div>

  122. 		<div id="workspace-toolbar">

  123. 			<div class="btn-group">

  124. 				<a class="btn btn-small" href="#"><i class="icon-zoom-out"></i></a>

  125. 				<a class="btn btn-small" href="#"><i class="icon-th"></i></a>

  126. 				<a class="btn btn-small" href="#"><i class="icon-zoom-in"></i></a>

  127. 			</div>

  128. 		</div>

  129. 	</div>

  130. 

  131. 	<div id="chart-zoom-controls">

  132. 		<div class="btn-group">

  133. 			<a class="btn btn-mini" id="btn-zoom-out" href="#"><i class="icon-zoom-out"></i></a>

  134. 			<a class="btn btn-mini" id="btn-zoom-zero" href="#"><i class="icon-th"></i></a>

  135. 			<a class="btn btn-mini" id="btn-zoom-in" href="#"><i class="icon-zoom-in"></i></a>

  136. 		</div>

  137. 	</div>

  138. 

  139. 	<div id="sidebar">

  140. 		<ul id="sidebar-tabs"></ul>

  141. 		<div id="sidebar-content"></div>

  142. 	</div>

  143. 

  144. 	<div id="sidebar-separator"></div>

  145. 

  146. </div>

  147. 

  148. <div id="notifications"></div>

  149. <div id="dropTarget"><div>Drop the flow here</div></div>

  150. 

  151. <div id="dialog" class="hide"><form id="dialog-form" class="form-horizontal"></form></div>

  152. <div id="node-config-dialog" class="hide"><form id="dialog-config-form" class="form-horizontal"></form><div class="form-tips" id="node-config-dialog-user-count"></div></div>

  153. 

  154. <div id="node-dialog-confirm-deploy" class="hide">

  155. 	<form class="form-horizontal">

  156. 		<div id="node-dialog-confirm-deploy-config" style="text-align: center; padding-top: 30px;">

  157. 			Some of the nodes are not properly configured. Are you sure you want to deploy?

  158. 		</div>

  159. 		<div id="node-dialog-confirm-deploy-unknown" style="text-align: center; padding-top: 10px;">

  160. 			The workspace contains some unknown node types:

  161. 			<ul style="width: 300px; margin: auto; text-align: left;" id="node-dialog-confirm-deploy-unknown-list"></ul>

  162. 			Are you sure you want to deploy?

  163. 		</div>

  164. 	</form>

  165. </div>

  166. 

  167. <div id="node-dialog-error-deploy" class="hide">

  168. 	<form class="form-horizontal">

  169. 		<div id="node-dialog-error-deploy-noio" style="text-align: center; padding-top: 10px;">

  170. 			<p>The workspace contains no input/output nodes!</p>

  171. 			<p>You need an input or an output to export the data!</p>

  172. 			<p>Without such a input/output function the exported

  173. 			code will not run properly!</p>

  174. 		</div>

  175. 	</form>

  176. </div>

  177. 

  178. <div id="node-help" class="modal hide fade" tabindex="-1" role="dialog" aria-labelledby="node-help-label" aria-hidden="true">

  179.   <div class="modal-header">

  180. 	<h5 id="node-help-label">Keyboard Shortcuts <span style="float: right;"><a href="http://node-red.github.io/docs" target="_blank">Open help in new window &raquo;</a></span></h5>

  181.   </div>

  182.   <div class="modal-body">

  183. 	<table>

  184. 		<tr>

  185. 		  <td><span class="help-key">?</span></td><td>Help</td>

  186. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">a</span></td><td>Select all nodes</td>

  187. 		</tr>

  188. 		<tr>

  189. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">Space</span></td><td>Toggle sidebar</td>

  190. 		  <td><span class="help-key">Shift</span> <span class="help-key">Click</span></td><td>Select all connected nodes</td>

  191. 		</tr>

  192. 		<tr>

  193. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">z</span></td><td>Undo</td>

  194. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">Click</span></td><td>Add/remove node from selection</td>

  195. 		</tr>

  196. 		<tr>

  197. 		  <td></td><td></td>

  198. 		  <td><span class="help-key">Delete</span></td><td>Delete selected nodes or link</td>

  199. 		</tr>

  200. 		<tr>

  201. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">x</span></td><td>Cut selected nodes</td>

  202. 		  <td></td><td></td>

  203. 		</tr>

  204. 		<tr>

  205. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">c</span></td><td>Copy selected nodes</td>

  206. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">v</span></td><td>Paste nodes</td>

  207. 		</tr>

  208. 		<tr>

  209. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">i</span></td><td>Import nodes</td>

  210. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">e</span></td><td>Export selected nodes</td>

  211. 		</tr>

  212. 		<tr>

  213. 		  <td colspan="2"></td>

  214. 		</tr>

  215. 		<tr>

  216. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">+</span></td><td>Zoom in</td>

  217. 		  <td><span class="help-key">Ctrl</span> <span class="help-key">-</span></td><td>Zoom out</td>

  218. 		</tr>

  219. 	</table>

  220.   </div>

  221.   <div class="modal-footer">

  222. 	<button class="btn" data-dismiss="modal" aria-hidden="true">Close</button>

  223.   </div>

  224. </div>

  225. 

  226. <div id="node-dialog-library-save-confirm" class="hide">

  227. 	<form class="form-horizontal">

  228. 		<div style="text-align: center; padding-top: 30px;">

  229. 		 A <span id="node-dialog-library-save-type"></span> called <span id="node-dialog-library-save-name"></span> already exists. Overwrite?

  230. 		</div>

  231. 	</form>

  232. </div>

  233. 

  234. <div id="node-dialog-library-save" class="hide">

  235. 	<form class="form-horizontal">

  236. 		<div class="form-row">

  237. 			<label for="node-dialog-library-save-folder"><i class="icon-folder-open"></i> Folder</label>

  238. 			<input type="text" id="node-dialog-library-save-folder" placeholder="Folder">

  239. 		</div>

  240. 		<div class="form-row">

  241. 			<label for="node-dialog-library-save-filename"><i class="icon-file"></i> Filename</label>

  242. 			<input type="text" id="node-dialog-library-save-filename" placeholder="Filename">

  243. 		</div>

  244. 	</form>

  245. </div>

  246. 

  247. <div id="node-dialog-library-lookup" class="hide">

  248. 	<form class="form-horizontal">

  249. 		<div class="form-row">

  250. 			<ul id="node-dialog-library-breadcrumbs" class="breadcrumb">

  251. 				<li class="active"><a href="#">Library</a></li>

  252. 			</ul>

  253. 		</div>

  254. 		<div class="form-row">

  255. 			<div style="vertical-align: top; display: inline-block; height: 100%; width: 30%; padding-right: 20px;">

  256. 				<div id="node-select-library" style="border: 1px solid #999; width: 100%; height: 100%; overflow:scroll;"><ul></ul></div>

  257. 			</div>

  258. 			<div style="vertical-align: top; display: inline-block;width: 65%; height: 100%;">

  259. 				<div style="height: 100%; width: 95%;" class="node-text-editor" id="node-select-library-text" ></div>

  260. 			</div>

  261. 		</div>

  262. 	</form>

  263. </div>

  264. <div id="node-dialog-rename-workspace" class="hide">

  265. 	<form class="form-horizontal">

  266. 		<div class="form-row">

  267. 			<label for="node-input-workspace-name" ><i class="icon-tag"></i> Name:</label>

  268. 			<input type="text" id="node-input-workspace-name">

  269. 		</div>

  270. 	</form>

  271. </div>

  272. <div id="node-dialog-delete-workspace" class="hide">

  273. 	<form class="form-horizontal">

  274. 		<div style="text-align: center; padding-top: 30px;">

  275. 		 Are you sure you want to delete '<span id="node-dialog-delete-workspace-name"></span>'?

  276. 		</div>

  277. 	</form>

  278. </div>

  279. 

  280. <script type="text/x-red" data-template-name="export-clipboard-dialog">

  281. 	<div class="form-row">

  282. 		<label for="node-input-export" style="display: block; width:100%;"><i class="icon-share"></i> Source Code:</label>

  283. 		<textarea readonly style="font-family: monospace; font-size: 12px; background:rgb(226, 229, 255); padding-left: 0.5em;" class="input-block-level" id="node-input-export" rows="12"></textarea>

  284. 	</div>

  285. 	<div class="form-tips">

  286. 		Select the text above and copy to the clipboard with Ctrl-A Ctrl-C.

  287. 	</div>

  288. </script>

  289. <script type="text/x-red" data-template-name="export-library-dialog">

  290. 	<div class="form-row">

  291. 		<label for="node-input-filename" ><i class="icon-tag"></i> Filename:</label>

  292. 		<input type="text" id="node-input-filename" placeholder="Filename">

  293. 	</div>

  294. </script>

  295. <script type="text/x-red" data-template-name="import-dialog">

  296. 	<div class="form-row">

  297. 		<label for="node-input-import"><i class="icon-share"></i>Nodes:</label>

  298. 		<textarea style="font-family: monospace; font-size: 12px; background:rgb(226, 229, 255); padding-left: 0.5em;" class="input-block-level" id="node-input-import" rows="5" placeholder="Paste nodes here, or lookup in the library. When importing Arduino code, the whole flow will be replaced."></textarea>

  299. 	</div>

  300. 	<div class="form-tips">

  301. 		<label for="node-input-arduino" style="font-size: 13px; padding: 2px 0px 0px 4px;">

  302. 			<input style="margin-bottom: 4px; margin-right: 4px;" type="checkbox" id="node-input-arduino" checked="checked" class="input-block-level" />

  303. 				&nbsp;Import copied code from the Arduino IDE

  304. 		</label>

  305. 	</div>

  306. </script>

  307. 

  308. <script src="jquery/js/jquery-1.9.1.js"></script>

  309. <script src="bootstrap/js/bootstrap.min.js"></script>

  310. <script src="jquery/js/jquery-ui-1.10.3.custom.min.js"></script>

  311. <script src="jquery/js/jquery.ui.touch-punch.min.js"></script>

  312. <script src="orion/built-editor.min.js"></script>

  313. <script src="red/d3/d3.v3.min.js"></script>

  314. <script src="red/main.js"></script>

  315. <script src="red/ui/state.js"></script>

  316. <script src="red/nodes.js"></script>

  317. <script src="red/storage.js"></script>

  318. <script src="red/history.js"></script>

  319. <script src="red/ui/keyboard.js"></script>

  320. <script src="red/ui/tabs.js"></script>

  321. <script src="red/ui/view.js"></script>

  322. <script src="red/ui/sidebar.js"></script>

  323. <script src="red/ui/palette.js"></script>

  324. <script src="red/ui/tab-info.js"></script>

  325. <script src="red/ui/tab-config.js"></script>

  326. <script src="red/ui/editor.js"></script>

  327. <script src="red/ui/library.js"></script>

  328. <script src="red/ui/notifications.js"></script>

  329. <script src="red/ui/touch/radialMenu.js"></script>

  330. 

  331. <!--

  332.  TODO: generate some or all of this automatically from the C++ source

  333. -->

  334. 

  335. <!--

  336.  TODO: add a field for maximum instance count

  337. -->

  338. <!--

  339.  TODO: add a field for exclusive to other objects (not allowed if they're used)

  340. -->

  341. <!--

  342.  TODO: add "parameters" fields, to replace the form html stuff

  343. -->

  344. 

  345. <script  type="text/x-red" data-container-name="InputOutputCompatibilityMetadata">

  346. 	{"requirements":[

  347. 		{"type":"AudioInputI2S",         "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  348. 		{"type":"AudioInputI2S",         "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  349. 		{"type":"AudioInputI2S",         "resource":"IN1 Pin",       "shareable":false},

  350. 		{"type":"AudioInputI2SQuad",     "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  351. 		{"type":"AudioInputI2SQuad",     "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  352. 		{"type":"AudioInputI2SQuad",     "resource":"IN1 Pin",       "shareable":false},

  353. 		{"type":"AudioInputI2SQuad",     "resource":"OUT1D Pin",     "shareable":false},

  354. 		{"type":"AudioInputI2SHex",      "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  355. 		{"type":"AudioInputI2SHex",      "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  356. 		{"type":"AudioInputI2SHex",      "resource":"IN1 Pin",       "shareable":false},

  357. 		{"type":"AudioInputI2SHex",      "resource":"OUT1D Pin",     "shareable":false},

  358. 		{"type":"AudioInputI2SHex",      "resource":"OUT1C Pin",     "shareable":false},

  359. 		{"type":"AudioInputI2SOct",      "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  360. 		{"type":"AudioInputI2SOct",      "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  361. 		{"type":"AudioInputI2SOct",      "resource":"IN1 Pin",       "shareable":false},

  362. 		{"type":"AudioInputI2SOct",      "resource":"OUT1D Pin",     "shareable":false},

  363. 		{"type":"AudioInputI2SOct",      "resource":"OUT1C Pin",     "shareable":false},

  364. 		{"type":"AudioInputI2SOct",      "resource":"OUT1B Pin",     "shareable":false},

  365. 		{"type":"AudioInputI2Sslave",    "resource":"I2S Device",    "shareable":true,  "setting":"I2S Slave"},

  366. 		{"type":"AudioInputI2Sslave",    "resource":"Sample Rate",   "shareable":true,  "setting":"LRCLK1 Control"},

  367. 		{"type":"AudioInputI2Sslave",    "resource":"IN1 Pin",       "shareable":false},

  368. 		{"type":"AudioInputI2S2",        "resource":"I2S2 Device",   "shareable":true,  "setting":"I2S Master"},

  369. 		{"type":"AudioInputI2S2",        "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  370. 		{"type":"AudioInputI2S2",        "resource":"IN2 Pin",       "shareable":false},

  371. 		{"type":"AudioInputSPDIF3",      "resource":"SPDIF Device",  "shareable":true,  "setting":"SPDIF Protocol"},

  372. 		{"type":"AudioInputSPDIF3",      "resource":"Sample Rate",   "shareable":true,  "setting":"SPDIF Control"},

  373. 		{"type":"AudioInputSPDIF3",      "resource":"SPDIFIN Pin",   "shareable":false},

  374. 		{"type":"AsyncAudioInputSPDIF3", "resource":"SPDIF Device",  "shareable":true,  "setting":"SPDIF Protocol"},

  375. 		{"type":"AsyncAudioInputSPDIF3", "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  376. 		{"type":"AsyncAudioInputSPDIF3", "resource":"SPDIFIN Pin",   "shareable":false},

  377. 		{"type":"AudioInputAnalog",      "resource":"ADC1",          "shareable":false},

  378. 		{"type":"AudioInputAnalog",      "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  379. 		{"type":"AudioInputAnalogStereo","resource":"ADC1",          "shareable":false},

  380. 		{"type":"AudioInputAnalogStereo","resource":"ADC2",          "shareable":false},

  381. 		{"type":"AudioInputAnalogStereo","resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  382. 		{"type":"AudioInputPDM",         "resource":"I2S Device",    "shareable":true,  "setting":"PDM Protocol"},

  383. 		{"type":"AudioInputPDM",         "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  384. 		{"type":"AudioInputPDM",         "resource":"IN1 Pin",       "shareable":false},

  385. 		{"type":"AudioInputTDM",         "resource":"I2S Device",    "shareable":true,  "setting":"TDM Protocol"},

  386. 		{"type":"AudioInputTDM",         "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  387. 		{"type":"AudioInputTDM",         "resource":"IN1 Pin",       "shareable":false},

  388. 		{"type":"AudioInputTDM2",        "resource":"I2S2 Device",   "shareable":true,  "setting":"TDM Protocol"},

  389. 		{"type":"AudioInputTDM2",        "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  390. 		{"type":"AudioInputTDM2",        "resource":"IN2 Pin",       "shareable":false},

  391. 		{"type":"AudioInputUSB",         "resource":"USB Rx Endpoint","shareable":false},

  392. 		{"type":"AudioOutputI2S",        "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  393. 		{"type":"AudioOutputI2S",        "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  394. 		{"type":"AudioOutputI2S",        "resource":"OUT1A Pin",     "shareable":false},

  395. 		{"type":"AudioOutputI2SQuad",    "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  396. 		{"type":"AudioOutputI2SQuad",    "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  397. 		{"type":"AudioOutputI2SQuad",    "resource":"OUT1A Pin",     "shareable":false},

  398. 		{"type":"AudioOutputI2SQuad",    "resource":"OUT1B Pin",     "shareable":false},

  399. 		{"type":"AudioOutputI2SHex",     "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  400. 		{"type":"AudioOutputI2SHex",     "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  401. 		{"type":"AudioOutputI2SHex",     "resource":"OUT1A Pin",     "shareable":false},

  402. 		{"type":"AudioOutputI2SHex",     "resource":"OUT1B Pin",     "shareable":false},

  403. 		{"type":"AudioOutputI2SHex",     "resource":"OUT1C Pin",     "shareable":false},

  404. 		{"type":"AudioOutputI2SOct",     "resource":"I2S Device",    "shareable":true,  "setting":"I2S Master"},

  405. 		{"type":"AudioOutputI2SOct",     "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  406. 		{"type":"AudioOutputI2SOct",     "resource":"OUT1A Pin",     "shareable":false},

  407. 		{"type":"AudioOutputI2SOct",     "resource":"OUT1B Pin",     "shareable":false},

  408. 		{"type":"AudioOutputI2SOct",     "resource":"OUT1C Pin",     "shareable":false},

  409. 		{"type":"AudioOutputI2SOct",     "resource":"OUT1D Pin",     "shareable":false},

  410. 		{"type":"AudioOutputI2Sslave",   "resource":"I2S Device",    "shareable":true,  "setting":"I2S Slave"},

  411. 		{"type":"AudioOutputI2Sslave",   "resource":"Sample Rate",   "shareable":true,  "setting":"LRCLK1 Control"},

  412. 		{"type":"AudioOutputI2Sslave",   "resource":"OUT1A Pin",     "shareable":false},

  413. 		{"type":"AudioOutputI2S2",       "resource":"I2S2 Device",   "shareable":true,  "setting":"I2S Master"},

  414. 		{"type":"AudioOutputI2S2",       "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  415. 		{"type":"AudioOutputI2S2",       "resource":"OUT2 Pin",      "shareable":false},

  416. 		{"type":"AudioOutputSPDIF",      "resource":"I2S Device",    "shareable":true,  "setting":"SPDIF Protocol"},

  417. 		{"type":"AudioOutputSPDIF",      "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  418. 		{"type":"AudioOutputSPDIF",      "resource":"OUT1A Pin",     "shareable":false},

  419. 		{"type":"AudioOutputSPDIF2",     "resource":"I2S2 Device",   "shareable":true,  "setting":"SPDIF Protocol"},

  420. 		{"type":"AudioOutputSPDIF2",     "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  421. 		{"type":"AudioOutputSPDIF2",     "resource":"OUT2 Pin",      "shareable":false},

  422. 		{"type":"AudioOutputSPDIF3",     "resource":"SPDIF Device",  "shareable":true,  "setting":"SPDIF Protocol"},

  423. 		{"type":"AudioOutputSPDIF3",     "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  424. 		{"type":"AudioOutputSPDIF3",     "resource":"SPDIFOUT Pin",  "shareable":false},

  425. 		{"type":"AudioOutputPT8211",     "resource":"I2S Device",    "shareable":true,  "setting":"PT8211 Protocol"},

  426. 		{"type":"AudioOutputPT8211",     "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  427. 		{"type":"AudioOutputPT8211",     "resource":"OUT1A Pin",     "shareable":false},

  428. 		{"type":"AudioOutputPT8211_2",   "resource":"I2S2 Device",   "shareable":true,  "setting":"PT8211 Protocol"},

  429. 		{"type":"AudioOutputPT8211_2",   "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  430. 		{"type":"AudioOutputPT8211_2",   "resource":"OUT2 Pin",      "shareable":false},

  431. 		{"type":"AudioOutputAnalog",     "resource":"DAC1",          "shareable":false},

  432. 		{"type":"AudioOutputAnalog",     "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  433. 		{"type":"AudioOutputAnalogStereo","resource":"DAC1",         "shareable":false},

  434. 		{"type":"AudioOutputAnalogStereo","resource":"DAC2",         "shareable":false},

  435. 		{"type":"AudioOutputAnalogStereo","resource":"Sample Rate",  "shareable":true,  "setting":"Teensy Control"},

  436. 		{"type":"AudioOutputPWM",        "resource":"PWM",           "shareable":false},

  437. 		{"type":"AudioOutputPWM",        "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  438. 		{"type":"AudioOutputMQS",        "resource":"MSQ Device",    "shareable":false},

  439. 		{"type":"AudioOutputMQS",        "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  440. 		{"type":"AudioOutputTDM",        "resource":"I2S Device",    "shareable":true,  "setting":"TDM Protocol"},

  441. 		{"type":"AudioOutputTDM",        "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  442. 		{"type":"AudioOutputTDM",        "resource":"OUT1A Pin",     "shareable":false},

  443. 		{"type":"AudioOutputTDM2",       "resource":"I2S2 Device",   "shareable":true,  "setting":"TDM Protocol"},

  444. 		{"type":"AudioOutputTDM2",       "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  445. 		{"type":"AudioOutputTDM2",       "resource":"OUT2 Pin",      "shareable":false},

  446. 		{"type":"AudioOutputADAT",       "resource":"I2S Device",    "shareable":true,  "setting":"ADAT Protocol"},

  447. 		{"type":"AudioOutputADAT",       "resource":"Sample Rate",   "shareable":true,  "setting":"Teensy Control"},

  448. 		{"type":"AudioOutputADAT",       "resource":"OUT1A Pin",     "shareable":false},

  449. 		{"type":"AudioOutputUSB",        "resource":"USB Tx Endpoint","shareable":false}

  450. 	]}

  451. </script>

  452. 

  453. 

  454. <script  type="text/x-red" data-container-name="NodeDefinitions">

  455. 	{"nodes":[

  456. 		{"type":"AudioInputI2S","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s","inputs":0,"outputs":2,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  457. 		{"type":"AudioInputI2SQuad","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s_quad","inputs":0,"outputs":4,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  458. 		{"type":"AudioInputI2SHex","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s_hex","inputs":0,"outputs":6,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  459. 		{"type":"AudioInputI2SOct","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s_oct","inputs":0,"outputs":8,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  460. 		{"type":"AudioInputI2Sslave","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2sslave","inputs":0,"outputs":2,"category":"input-function","color":"#F7D8F0","icon":"arrow-in.png"}},

  461. 		{"type":"AudioInputI2S2","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s2","inputs":0,"outputs":2,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  462. 		{"type":"AudioInputSPDIF3","data":{"defaults":{"name":{"value":"new"}},"shortName":"spdif3","inputs":0,"outputs":2,"category":"input-function","color":"#F7D8F0","icon":"arrow-in.png"}},

  463. 		{"type":"AsyncAudioInputSPDIF3","data":{"defaults":{"name":{"value":"new"}},"shortName":"spdif_async","inputs":0,"outputs":2,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  464. 		{"type":"AudioInputAnalog","data":{"defaults":{"name":{"value":"new"}},"shortName":"adc","inputs":0,"outputs":1,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  465. 		{"type":"AudioInputAnalogStereo","data":{"defaults":{"name":{"value":"new"}},"shortName":"adcs","inputs":0,"outputs":2,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  466. 		{"type":"AudioInputPDM","data":{"defaults":{"name":{"value":"new"}},"shortName":"pdm","inputs":0,"outputs":1,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  467. 		{"type":"AudioInputTDM","data":{"defaults":{"name":{"value":"new"}},"shortName":"tdm","inputs":0,"outputs":16,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  468. 		{"type":"AudioInputTDM2","data":{"defaults":{"name":{"value":"new"}},"shortName":"tdm2","inputs":0,"outputs":16,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  469. 		{"type":"AudioInputUSB","data":{"defaults":{"name":{"value":"new"}},"shortName":"usb","inputs":0,"outputs":2,"category":"input-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  470. 

  471. 		{"type":"AudioOutputI2S","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  472. 		{"type":"AudioOutputI2SQuad","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s_quad","inputs":4,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  473. 		{"type":"AudioOutputI2SHex","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s_hex","inputs":6,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  474. 		{"type":"AudioOutputI2SOct","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s_oct","inputs":8,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  475. 		{"type":"AudioOutputI2Sslave","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2sslave","inputs":2,"outputs":0,"category":"output-function","color":"#F7D8F0","icon":"arrow-in.png"}},

  476. 		{"type":"AudioOutputI2S2","data":{"defaults":{"name":{"value":"new"}},"shortName":"i2s2","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  477. 		{"type":"AudioOutputSPDIF","data":{"defaults":{"name":{"value":"new"}},"shortName":"spdif","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  478. 		{"type":"AudioOutputSPDIF2","data":{"defaults":{"name":{"value":"new"}},"shortName":"spdif2","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  479. 		{"type":"AudioOutputSPDIF3","data":{"defaults":{"name":{"value":"new"}},"shortName":"spdif3","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  480. 		{"type":"AudioOutputPT8211","data":{"defaults":{"name":{"value":"new"}},"shortName":"pt8211","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  481. 		{"type":"AudioOutputPT8211_2","data":{"defaults":{"name":{"value":"new"}},"shortName":"pt8211_2","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  482. 		{"type":"AudioOutputAnalog","data":{"defaults":{"name":{"value":"new"}},"shortName":"dac","inputs":1,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  483. 		{"type":"AudioOutputAnalogStereo","data":{"defaults":{"name":{"value":"new"}},"shortName":"dacs","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  484. 		{"type":"AudioOutputPWM","data":{"defaults":{"name":{"value":"new"}},"shortName":"pwm","inputs":1,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  485. 		{"type":"AudioOutputMQS","data":{"defaults":{"name":{"value":"new"}},"shortName":"mqs","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  486. 		{"type":"AudioOutputTDM","data":{"defaults":{"name":{"value":"new"}},"shortName":"tdm","inputs":16,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  487. 		{"type":"AudioOutputTDM2","data":{"defaults":{"name":{"value":"new"}},"shortName":"tdm2","inputs":16,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  488. 		{"type":"AudioOutputADAT","data":{"defaults":{"name":{"value":"new"}},"shortName":"adat","inputs":8,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  489. 		{"type":"AudioOutputUSB","data":{"defaults":{"name":{"value":"new"}},"shortName":"usb","inputs":2,"outputs":0,"category":"output-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  490. 

  491. 		{"type":"AudioAmplifier","data":{"defaults":{"name":{"value":"new"}},"shortName":"amp","inputs":1,"outputs":1,"category":"mixer-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  492. 		{"type":"AudioMixer4","data":{"defaults":{"name":{"value":"new"}},"shortName":"mixer","inputs":4,"outputs":1,"category":"mixer-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  493. 		{"type":"AudioPlayMemory","data":{"defaults":{"name":{"value":"new"}},"shortName":"playMem","inputs":0,"outputs":1,"category":"play-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  494. 		{"type":"AudioPlaySdWav","data":{"defaults":{"name":{"value":"new"}},"shortName":"playSdWav","inputs":0,"outputs":2,"category":"play-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  495. 		{"type":"AudioPlaySdRaw","data":{"defaults":{"name":{"value":"new"}},"shortName":"playSdRaw","inputs":0,"outputs":1,"category":"play-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  496. 		{"type":"AudioPlaySerialflashRaw","data":{"defaults":{"name":{"value":"new"}},"shortName":"playFlashRaw","inputs":0,"outputs":1,"category":"play-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  497. 		{"type":"AudioPlayQueue","data":{"defaults":{"name":{"value":"new"}},"shortName":"queue","inputs":0,"outputs":1,"category":"play-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  498. 		{"type":"AudioRecordQueue","data":{"defaults":{"name":{"value":"new"}},"shortName":"queue","inputs":1,"outputs":0,"category":"record-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  499. 		{"type":"AudioSynthWavetable","data":{"defaults":{"name":{"value":"new"}},"shortName":"wavetable","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  500. 		{"type":"AudioSynthSimpleDrum","data":{"defaults":{"name":{"value":"new"}},"shortName":"drum","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  501. 		{"type":"AudioSynthKarplusStrong","data":{"defaults":{"name":{"value":"new"}},"shortName":"string","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  502. 		{"type":"AudioSynthWaveformSine","data":{"defaults":{"name":{"value":"new"}},"shortName":"sine","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  503. 		{"type":"AudioSynthWaveformSineHires","data":{"defaults":{"name":{"value":"new"}},"shortName":"sine_hires","inputs":0,"outputs":2,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  504. 		{"type":"AudioSynthWaveformSineModulated","data":{"defaults":{"name":{"value":"new"}},"shortName":"sine_fm","inputs":1,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  505. 		{"type":"AudioSynthWaveform","data":{"defaults":{"name":{"value":"new"}},"shortName":"waveform","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  506. 		{"type":"AudioSynthWaveformModulated","data":{"defaults":{"name":{"value":"new"}},"shortName":"waveformMod","inputs":2,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  507. 		{"type":"AudioSynthWaveformPWM","data":{"defaults":{"name":{"value":"new"}},"shortName":"pwm","inputs":1,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  508. 		{"type":"AudioSynthToneSweep","data":{"defaults":{"name":{"value":"new"}},"shortName":"tonesweep","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  509. 		{"type":"AudioSynthWaveformDc","data":{"defaults":{"name":{"value":"new"}},"shortName":"dc","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  510. 		{"type":"AudioSynthNoiseWhite","data":{"defaults":{"name":{"value":"new"}},"shortName":"noise","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  511. 		{"type":"AudioSynthNoisePink","data":{"defaults":{"name":{"value":"new"}},"shortName":"pink","inputs":0,"outputs":1,"category":"synth-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  512. 		{"type":"AudioEffectFade","data":{"defaults":{"name":{"value":"new"}},"shortName":"fade","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  513. 		{"type":"AudioEffectChorus","data":{"defaults":{"name":{"value":"new"}},"shortName":"chorus","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  514. 		{"type":"AudioEffectFlange","data":{"defaults":{"name":{"value":"new"}},"shortName":"flange","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  515. 		{"type":"AudioEffectReverb","data":{"defaults":{"name":{"value":"new"}},"shortName":"reverb","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  516. 		{"type":"AudioEffectFreeverb","data":{"defaults":{"name":{"value":"new"}},"shortName":"freeverb","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  517. 		{"type":"AudioEffectFreeverbStereo","data":{"defaults":{"name":{"value":"new"}},"shortName":"freeverbs","inputs":1,"outputs":2,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  518. 		{"type":"AudioEffectEnvelope","data":{"defaults":{"name":{"value":"new"}},"shortName":"envelope","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  519. 		{"type":"AudioEffectMultiply","data":{"defaults":{"name":{"value":"new"}},"shortName":"multiply","inputs":2,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  520. 		{"type":"AudioEffectRectifier","data":{"defaults":{"name":{"value":"new"}},"shortName":"rectify","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  521. 		{"type":"AudioEffectDelay","data":{"defaults":{"name":{"value":"new"}},"shortName":"delay","inputs":1,"outputs":8,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  522. 		{"type":"AudioEffectDelayExternal","data":{"defaults":{"name":{"value":"new"}},"shortName":"delayExt","inputs":1,"outputs":8,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  523. 		{"type":"AudioEffectBitcrusher","data":{"shortName":"bitcrusher","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  524. 		{"type":"AudioEffectMidSide","data":{"shortName":"midside","inputs":2,"outputs":2,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  525. 		{"type":"AudioEffectWaveshaper","data":{"shortName":"waveshape","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  526. 		{"type":"AudioEffectGranular","data":{"shortName":"granular","inputs":1,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  527. 		{"type":"AudioEffectDigitalCombine","data":{"shortName":"combine","inputs":2,"outputs":1,"category":"effect-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  528. 		{"type":"AudioFilterBiquad","data":{"defaults":{"name":{"value":"new"}},"shortName":"biquad","inputs":1,"outputs":1,"category":"filter-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  529. 		{"type":"AudioFilterFIR","data":{"defaults":{"name":{"value":"new"}},"shortName":"fir","inputs":1,"outputs":1,"category":"filter-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  530. 		{"type":"AudioFilterStateVariable","data":{"defaults":{"name":{"value":"new"}},"shortName":"filter","inputs":2,"outputs":3,"category":"filter-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  531. 		{"type":"AudioFilterLadder","data":{"defaults":{"name":{"value":"new"}},"shortName":"ladder","inputs":3,"outputs":1,"category":"filter-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  532. 		{"type":"AudioAnalyzePeak","data":{"defaults":{"name":{"value":"new"}},"shortName":"peak","inputs":1,"outputs":0,"category":"analyze-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  533. 		{"type":"AudioAnalyzeRMS","data":{"defaults":{"name":{"value":"new"}},"shortName":"rms","inputs":1,"outputs":0,"category":"analyze-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  534. 		{"type":"AudioAnalyzeFFT256","data":{"defaults":{"name":{"value":"new"}},"shortName":"fft256","inputs":1,"outputs":0,"category":"analyze-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  535. 		{"type":"AudioAnalyzeFFT1024","data":{"defaults":{"name":{"value":"new"}},"shortName":"fft1024","inputs":1,"outputs":0,"category":"analyze-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  536. 		{"type":"AudioAnalyzeToneDetect","data":{"defaults":{"name":{"value":"new"}},"shortName":"tone","inputs":1,"outputs":0,"category":"analyze-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  537. 		{"type":"AudioAnalyzeNoteFrequency","data":{"defaults":{"name":{"value":"new"}},"shortName":"notefreq","inputs":1,"outputs":0,"category":"analyze-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  538. 		{"type":"AudioAnalyzePrint","data":{"defaults":{"name":{"value":"new"}},"shortName":"print","inputs":1,"outputs":0,"category":"analyze-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  539. 		{"type":"AudioControlSGTL5000","data":{"defaults":{"name":{"value":"new"}},"shortName":"sgtl5000","inputs":0,"outputs":0,"category":"control-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  540. 		{"type":"AudioControlAK4558","data":{"defaults":{"name":{"value":"new"}},"shortName":"ak4558","inputs":0,"outputs":0,"category":"control-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  541. 		{"type":"AudioControlCS4272","data":{"defaults":{"name":{"value":"new"}},"shortName":"cs4272","inputs":0,"outputs":0,"category":"control-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  542. 		{"type":"AudioControlWM8731","data":{"defaults":{"name":{"value":"new"}},"shortName":"wm8731","inputs":0,"outputs":0,"category":"control-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  543. 		{"type":"AudioControlWM8731master","data":{"defaults":{"name":{"value":"new"}},"shortName":"wm8731m","inputs":0,"outputs":0,"category":"control-function","color":"#E6E0F8","icon":"arrow-in.png"}},

  544. 		{"type":"AudioControlCS42448","data":{"defaults":{"name":{"value":"new"}},"shortName":"cs42448","inputs":0,"outputs":0,"category":"control-function","color":"#E6E0F8","icon":"arrow-in.png"}}

  545. 	]}

  546. </script>

  547. 

  548. <script type="text/x-red" data-help-name="AudioInputI2S">

  549. 	<h3>Summary</h3>

  550. 	<div class=tooltipinfo>

  551. 	<p>Receive 16 bit stereo audio from the

  552. 	<a href="http://www.pjrc.com/store/teensy3_audio.html" target="_blank">audio shield</a>

  553. 		or another I2S device, using I2S master mode.</p>

  554. 	<p align=center><img src="img/audioshield_inputs.jpg"></p>

  555. 	</div>

  556. 	<h3>Boards Supported</h3>

  557. 	<ul>

  558. 	<li>Teensy 3.2

  559. 	<li>Teensy 3.5

  560. 	<li>Teensy 3.6

  561. 	<li>Teensy 4.0

  562. 	<li>Teensy 4.1

  563. 	</ul>

  564. 	<h3>Audio Connections</h3>

  565. 	<table class=doc align=center cellpadding=3>

  566. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  567. 		<tr class=odd><td align=center>Out 0</td><td>Left Channel</td></tr>

  568. 		<tr class=odd><td align=center>Out 1</td><td>Right Channel</td></tr>

  569. 	</table>

  570. 	<h3>Functions</h3>

  571. 	<p>This object has no functions to call from the Arduino sketch.  It

  572. 		simply streams data from the I2S hardware to its 2 output ports.</p>

  573. 	<h3>Hardware</h3>

  574. 	<p align=center><img src="img/audioshield_backside.jpg"></p>

  575. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  576. 		all 3 clock signals and controls all data timing.</p>

  577. 	<table class=doc align=center cellpadding=3>

  578. 		<tr class=top><th>T3.x<br>Pin</th><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  579. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  580. 		<tr class=odd><td align=center>11</td><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  581. 		<tr class=odd><td align=center>13</td><td align=center>8</td><td>RX</td><td>Input</td></tr>

  582. 		<tr class=odd><td align=center>23</td><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  583. 	</table>

  584. 	<p>Audio from

  585. 		master mode I2S may be used in the same project as ADC, DAC and

  586. 		PWM signals, because all remain in sync to Teensy's timing</p>

  587. 	<p>Compatible CODEC Chips:

  588. 		<ul>

  589. 		<li><a href="https://www.pjrc.com/store/teensy3_audio.html">STGL5000</a>

  590. 		<li><a href="https://forum.pjrc.com/threads/42665-New-Audio-Board!-TI-TLV320AIC3206">TLV320AIC3206</a>

  591. 		<li><a href="https://forum.pjrc.com/threads/32276-HiFi-Audio-CODEC-Module-AK4558-evaluation-board-in-a-square-inch-PCB">AK4558</a>

  592. 		<li>WM8731

  593. 		</ul>

  594. 	</p>

  595. 	<p>Compatible ADC Chips:

  596. 		<ul>

  597. 		</ul>

  598. 	</p>

  599. 	<p>Compatible Microphones:

  600. 		<ul>

  601. 		<li><a href="https://forum.pjrc.com/threads/47010-I2S-Microphone-(SPH0645LM4H-B)?p=157101&viewfull=1#post157101">SPH0645LM4H-B</a>

  602. 		<li><a href="https://forum.pjrc.com/threads/50534-Why-MEMS-i2s-microphone-ICS-43432-with-teensy-audio-library-not-working?p=173279&viewfull=1#post173279">ICS43432</a>

  603. 		<li><a href="https://forum.pjrc.com/threads/49065-ICS43434-I2S-Digital-Microphone-and-Teensy-3-2">ICS43434</a>

  604. 		</ul>

  605. 	</p>

  606. 	<h3>Examples</h3>

  607. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughStereo

  608. 	</p>

  609. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Recorder

  610. 	</p>

  611. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; PeakMeterStereo

  612. 	</p>

  613. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; FFT

  614. 	</p>

  615. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; SpectrumAnalyzerBasic

  616. 	</p>

  617. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Chorus

  618. 	</p>

  619. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Flange

  620. 	</p>

  621. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Filter

  622. 	</p>

  623. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Filter_FIR

  624. 	</p>

  625. 	<h3>Notes</h3>

  626. 	<p>Normally, this object is used with the Audio Shield, which

  627. 		is controlled separately by the "sgtl5000" object.</p>

  628. 	<p>Only one I2S input and one I2S output object may be used.  Master

  629. 		and slave modes may not be mixed (both must be of the same type).

  630. 	</p>

  631. 	<p>I2S master objects can be used together with non-I2S input and output

  632. 		objects, for simultaneous audio streaming on different hardware.</p>

  633. </script>

  634. <script type="text/x-red" data-template-name="AudioInputI2S">

  635. 	<div class="form-row">

  636. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  637. 		<input type="text" id="node-input-name" placeholder="Name">

  638. 	</div>

  639. </script>

  640. 

  641. <script type="text/x-red" data-help-name="AudioInputI2SQuad">

  642. 	<h3>Summary</h3>

  643. 	<div class=tooltipinfo>

  644. 	<p>Receive 16 bit quad (4) channel audio from two

  645. 	<a href="http://www.pjrc.com/store/teensy3_audio.html" target="_blank">audio shields</a>

  646. 		or another I2S devices, using I2S master mode.</p>

  647. 	<p align=center><img src="img/audioshield_quad_in.jpg"></p>

  648. 	</div>

  649. 	<h3>Boards Supported</h3>

  650. 	<ul>

  651. 	<li>Teensy 3.2

  652. 	<li>Teensy 3.5

  653. 	<li>Teensy 3.6

  654. 	<li>Teensy 4.0

  655. 	<li>Teensy 4.1

  656. 	</ul>

  657. 	<h3>Audio Connections</h3>

  658. 	<table class=doc align=center cellpadding=3>

  659. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  660. 		<tr class=odd><td align=center>Out 0</td><td>Channel #1</td></tr>

  661. 		<tr class=odd><td align=center>Out 1</td><td>Channel #2</td></tr>

  662. 		<tr class=odd><td align=center>Out 2</td><td>Channel #3</td></tr>

  663. 		<tr class=odd><td align=center>Out 3</td><td>Channel #4</td></tr>

  664. 	</table>

  665. 	<h3>Functions</h3>

  666. 	<p>This object has no functions to call from the Arduino sketch.  It

  667. 		simply streams data from the I2S hardware to its 4 output ports.</p>

  668. 	<h3>Hardware</h3>

  669. 	<p>See this Sparkfun blog for <a href="https://www.sparkfun.com/news/2055" target="_blank">how

  670. 		to connect two audio adaptors for 4 channel audio</a>.</p>

  671. 	<p>For Teensy 4 and Rev D audio shields, see

  672. 		<a href="https://forum.pjrc.com/threads/61123?p=242054&viewfull=1#post242054">this forum thread</a>.</p>

  673. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  674. 		all 3 clock signals and controls all data timing.</p>

  675. 	<table class=doc align=center cellpadding=3>

  676. 		<tr class=top><th>Teensy<br>3.2<br>Pin</th><th>Teensy<br>3.5/3.6<br>Pin</th><th>Teensy<br>4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  677. 		<tr class=odd><td align=center>9</td><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  678. 		<tr class=odd><td align=center>11</td><td align=center>11</td><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  679. 		<tr class=odd><td align=center>13</td><td align=center>13</td><td align=center>8</td><td>RX</td><td>Input</td></tr>

  680. 		<tr class=odd><td align=center>30</td><td align=center>38</td><td align=center>6</td><td>RX</td><td>Input</td></tr>

  681. 		<tr class=odd><td align=center>23</td><td align=center>23</td><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  682. 	</table>

  683. 	<p>Audio from

  684. 		master mode I2S may be used in the same project as ADC, DAC and

  685. 		PWM signals, because all remain in sync to Teensy's timing</p>

  686. 	<h3>Examples</h3>

  687. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughQuad

  688. 	</p>

  689. 	<h3>Notes</h3>

  690. 	<p>On Teensy 3.x, the BCLK/LRCLK ratio is 32, which is not compatible with

  691. 		most MEMS microphones.  Teensy 4.x uses BCLK/LRCLK ratio, which can

  692. 		be used with I2S MEMS microphones.</p>

  693. 	<p>Normally, this object is used with two Audio Shield, which

  694. 		are controlled separately by a pair "sgtl5000" object.</p>

  695. </script>

  696. <script type="text/x-red" data-template-name="AudioInputI2SQuad">

  697. 	<div class="form-row">

  698. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  699. 		<input type="text" id="node-input-name" placeholder="Name">

  700. 	</div>

  701. </script>

  702. 

  703. <script type="text/x-red" data-help-name="AudioInputI2SHex">

  704. 	<h3>Summary</h3>

  705. 	<div class=tooltipinfo>

  706. 	<p>Receive 6 channel audio from three I2S devices, using I2S master mode.</p>

  707. 	</div>

  708. 	<h3>Boards Supported</h3>

  709. 	<ul>

  710. 	<li>Teensy 4.0

  711. 	<li>Teensy 4.1

  712. 	</ul>

  713. 	<h3>Audio Connections</h3>

  714. 	<table class=doc align=center cellpadding=3>

  715. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  716. 		<tr class=odd><td align=center>Out 0</td><td>Channel #1</td></tr>

  717. 		<tr class=odd><td align=center>Out 1</td><td>Channel #2</td></tr>

  718. 		<tr class=odd><td align=center>Out 2</td><td>Channel #3</td></tr>

  719. 		<tr class=odd><td align=center>Out 3</td><td>Channel #4</td></tr>

  720. 		<tr class=odd><td align=center>Out 4</td><td>Channel #5</td></tr>

  721. 		<tr class=odd><td align=center>Out 5</td><td>Channel #6</td></tr>

  722. 	</table>

  723. 	<h3>Functions</h3>

  724. 	<p>This object has no functions to call from the Arduino sketch.  It

  725. 		simply streams data from the I2S hardware to its 6 output ports.</p>

  726. 	<h3>Hardware</h3>

  727. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  728. 		all 3 clock signals and controls all data timing.</p>

  729. 	<table class=doc align=center cellpadding=3>

  730. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  731. 		<tr class=odd><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  732. 		<tr class=odd><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  733. 		<tr class=odd><td align=center>8</td><td>RX (ch 1+2)</td><td>Input</td></tr>

  734. 		<tr class=odd><td align=center>6</td><td>RX (ch 3+4)</td><td>Input</td></tr>

  735. 		<tr class=odd><td align=center>9</td><td>RX (ch 5+6)</td><td>Input</td></tr>

  736. 		<tr class=odd><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  737. 	</table>

  738. 	<h3>Examples</h3>

  739. 	<!--<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughQuad

  740. 	</p>-->

  741. 	<h3>Notes</h3>

  742. 	<p>Teensy 4.0 &amp; 4.1's I2S port has a total of 5 data pins

  743. 		which may each transmit or receive stereo digital audio.  This

  744. 		6 channel input may be used together with the I2S stereo or

  745. 		quad channel I2S output, but may not be combined with others

  746. 		which use the same physical pins.</p>

  747. </script>

  748. <script type="text/x-red" data-template-name="AudioInputI2SHex">

  749. 	<div class="form-row">

  750. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  751. 		<input type="text" id="node-input-name" placeholder="Name">

  752. 	</div>

  753. </script>

  754. 

  755. <script type="text/x-red" data-help-name="AudioInputI2SOct">

  756. 	<h3>Summary</h3>

  757. 	<div class=tooltipinfo>

  758. 	<p>Receive 8 channel audio from three I2S devices, using I2S master mode.</p>

  759. 	</div>

  760. 	<h3>Boards Supported</h3>

  761. 	<ul>

  762. 	<li>Teensy 4.0

  763. 	<li>Teensy 4.1

  764. 	</ul>

  765. 	<h3>Audio Connections</h3>

  766. 	<table class=doc align=center cellpadding=3>

  767. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  768. 		<tr class=odd><td align=center>Out 0</td><td>Channel #1</td></tr>

  769. 		<tr class=odd><td align=center>Out 1</td><td>Channel #2</td></tr>

  770. 		<tr class=odd><td align=center>Out 2</td><td>Channel #3</td></tr>

  771. 		<tr class=odd><td align=center>Out 3</td><td>Channel #4</td></tr>

  772. 		<tr class=odd><td align=center>Out 4</td><td>Channel #5</td></tr>

  773. 		<tr class=odd><td align=center>Out 5</td><td>Channel #6</td></tr>

  774. 		<tr class=odd><td align=center>Out 6</td><td>Channel #7</td></tr>

  775. 		<tr class=odd><td align=center>Out 7</td><td>Channel #8</td></tr>

  776. 	</table>

  777. 	<h3>Functions</h3>

  778. 	<p>This object has no functions to call from the Arduino sketch.  It

  779. 		simply streams data from the I2S hardware to its 8 output ports.</p>

  780. 	<h3>Hardware</h3>

  781. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  782. 		all 3 clock signals and controls all data timing.</p>

  783. 	<table class=doc align=center cellpadding=3>

  784. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  785. 		<tr class=odd><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  786. 		<tr class=odd><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  787. 		<tr class=odd><td align=center>8</td><td>RX (ch 1+2)</td><td>Input</td></tr>

  788. 		<tr class=odd><td align=center>6</td><td>RX (ch 3+4)</td><td>Input</td></tr>

  789. 		<tr class=odd><td align=center>9</td><td>RX (ch 5+6)</td><td>Input</td></tr>

  790. 		<tr class=odd><td align=center>32</td><td>RX (ch 7+8)</td><td>Input</td></tr>

  791. 		<tr class=odd><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  792. 	</table>

  793. 	<h3>Examples</h3>

  794. 	<!--<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughQuad

  795. 	</p>-->

  796. 	<h3>Notes</h3>

  797. 	<p>Teensy 4.0 &amp; 4.1's I2S port has a total of 5 data pins

  798. 		which may each transmit or receive stereo digital audio.  This

  799. 		8 channel input may be used together with the I2S stereo

  800. 		output, but may not be combined with others

  801. 		which use the same physical pins.</p>

  802. </script>

  803. <script type="text/x-red" data-template-name="AudioInputI2SOct">

  804. 	<div class="form-row">

  805. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  806. 		<input type="text" id="node-input-name" placeholder="Name">

  807. 	</div>

  808. </script>

  809. 

  810. <script type="text/x-red" data-help-name="AudioInputI2S2">

  811. 	<h3>Summary</h3>

  812. 	<div class=tooltipinfo>

  813. 	<p>Receive 16 bit stereo audio from an I2S device using the 2nd I2S port on Teensy 4.x.</p>

  814. 	</div>

  815. 	<h3>Boards Supported</h3>

  816. 	<ul>

  817. 	<li>Teensy 4.0

  818. 	<li>Teensy 4.1

  819. 	</ul>

  820. 	<h3>Audio Connections</h3>

  821. 	<table class=doc align=center cellpadding=3>

  822. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  823. 		<tr class=odd><td align=center>Out 0</td><td>Left Channel</td></tr>

  824. 		<tr class=odd><td align=center>Out 1</td><td>Right Channel</td></tr>

  825. 	</table>

  826. 	<h3>Functions</h3>

  827. 	<p>This object has no functions to call from the Arduino sketch.  It

  828. 		simply streams data from the I2S hardware to its 2 output ports.</p>

  829. 	<h3>Hardware</h3>

  830. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  831. 		all 3 clock signals and controls all data timing.</p>

  832. 	<table class=doc align=center cellpadding=3>

  833. 		<tr class=top><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  834. 		<tr class=odd><td align=center>4</td><td>BCLK</td><td>Output</td></tr>

  835. 		<tr class=odd><td align=center>33</td><td>MCLK</td><td>Output</td></tr>

  836. 		<tr class=odd><td align=center>5</td><td>RX</td><td>Input</td></tr>

  837. 		<tr class=odd><td align=center>3</td><td>LRCLK</td><td>Output</td></tr>

  838. 	</table>

  839. 	</p>

  840. 	<h3>Examples</h3>

  841. 	<h3>Notes</h3>

  842. </script>

  843. <script type="text/x-red" data-template-name="AudioInputI2S2">

  844. 	<div class="form-row">

  845. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  846. 		<input type="text" id="node-input-name" placeholder="Name">

  847. 	</div>

  848. </script>

  849. 

  850. 

  851. <script type="text/x-red" data-help-name="AudioInputSPDIF3">

  852. 	<h3>Summary</h3>

  853. 	<div class=tooltipinfo>

  854. 	<p>Receive S/PDIF digital audio, at the rate of the external digital audio source.</p>

  855. 	<p><span style="color:red">This input is incompatible with most other inputs and outputs</span>

  856. 		which run at a speed controlled by Teensy's internal sample rate.</p>

  857. 	</div>

  858. 	<h3>Boards Supported</h3>

  859. 	<ul>

  860. 	<li>Teensy 4.0

  861. 	<li>Teensy 4.1

  862. 	</ul>

  863. 	<h3>Audio Connections</h3>

  864. 	<table class=doc align=center cellpadding=3>

  865. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  866. 		<tr class=odd><td align=center>Out 0</td><td>Left Channel</td></tr>

  867. 		<tr class=odd><td align=center>Out 1</td><td>Right Channel</td></tr>

  868. 	</table>

  869. 	<h3>Functions</h3>

  870. 	<p class=func><span class=keyword>pllLocked</span>();</p>

  871. 	<p class=desc>Returns true if the S/PDIF phase locked loop is tracking

  872. 		the sample rate of incoming digital audio data.

  873. 	</p>

  874. 	<p class=func><span class=keyword>sampleRate</span>();</p>

  875. 	<p class=desc>Returns the sample rate of incoming data, if the PLL has locked,

  876. 		or returns 0 if the audio sample rate is unknown.

  877. 	</p>

  878. 	<h3>Hardware</h3>

  879. 	<p>

  880. 	<table class=doc align=center cellpadding=3>

  881. 		<tr class=top><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  882. 		<tr class=odd><td align=center>15</td><td>S/PDIF Data</td><td>Output</td></tr>

  883. 	</table>

  884. 	</p>

  885. 	<h3>Examples</h3>

  886. 	<!--<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughAsyncSpdif

  887. 	</p>-->

  888. 	<h3>Notes</h3>

  889. 	<p>This input tries to force the entire audio library to run at the

  890. 		sample rate of the incoming data.  It usually can not be combined

  891. 		with most other inputs and outputs which run at specific speeds.</p>

  892. </script>

  893. <script type="text/x-red" data-template-name="AudioInputSPDIF3">

  894. 	<div class="form-row">

  895. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  896. 		<input type="text" id="node-input-name" placeholder="Name">

  897. 	</div>

  898. </script>

  899. 

  900. <script type="text/x-red" data-help-name="AsyncAudioInputSPDIF3">

  901. 	<h3>Summary</h3>

  902. 	<div class=tooltipinfo>

  903. 	<p>Receive S/PDIF digital audio and resample to Teensy's audio sample rate.</p>

  904. 	<p>Asynchronous resampling contributed by <a href="https://github.com/alex6679">Alex Walch</a>.</p>

  905. 	</div>

  906. 	<h3>Boards Supported</h3>

  907. 	<ul>

  908. 	<li>Teensy 4.0

  909. 	<li>Teensy 4.1

  910. 	</ul>

  911. 	<h3>Audio Connections</h3>

  912. 	<table class=doc align=center cellpadding=3>

  913. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  914. 		<tr class=odd><td align=center>Out 0</td><td>Left Channel</td></tr>

  915. 		<tr class=odd><td align=center>Out 1</td><td>Right Channel</td></tr>

  916. 	</table>

  917. 	<h3>Functions</h3>

  918. 	<p class=func><span class=keyword>getBufferedTime</span>();</p>

  919. 	<p class=desc>Returns the buffered time in seconds. The buffered time is the duration of the incoming samples which are not resampled yet. The step width of the resampling algorithm is constantly slightly adjusted to keep the buffered time closely to the target latency. The difference between the target latency and the buffered time is typically smaller than 1 microsecond.

  920. 	</p>

  921. 	<!--<p class=func><span class=keyword>getInputFrequency</span>();</p>

  922. 	<p class=desc>TODO: documentation needed here

  923. 	</p>-->

  924. 	<p class=func><span class=keyword>isLocked</span>();</p>

  925. 	<p class=desc>Returns true if the S/PDIF phase locked loop is tracking

  926. 		the sample rate of incoming digital audio data.

  927. 	</p>

  928. 	<p class=func><span class=keyword>getInputFrequency</span>();</p>

  929. 	<p class=desc>Returns the sample rate of incoming data, if the PLL has locked, or returns 0 if the audio sample rate is unknown.

  930. 	</p>

  931. 	<p class=func><span class=keyword>getTargetLantency</span>();</p>

  932. 	<p class=desc>Returns the target latency in seconds. The latency is the time from the moment a sample is received by the Teensy SPDIF hardware receiver until it is transmitted by the asrc intput. The audio samples arrive at the asrc input in chunks of 32 samples per channel. The target latency consists of these 32 samples + some buffer that is needed to compensate for timing variations.

  933. 	</p>

  934. 	<p class=func><span class=keyword>getAttenuation</span>();</p>

  935. 	<p class=desc>

  936. Returns the actual achieved attenuation of the anti-aliasing filter. If the input sampling rate is smaller or equal to 44.1kHz, no low pass filtering is needed and zero is returned.

  937. 	</p>

  938. 	<p class=func><span class=keyword>getHalfFilterLength</span>();</p>

  939. 	<p class=desc>Returns the half length of the resampling filter. Its complete length is 2*(the returned value)+1.

  940. 	</p>

  941. 	<h3>Hardware</h3>

  942. 	<p>

  943. 	<table class=doc align=center cellpadding=3>

  944. 		<tr class=top><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  945. 		<tr class=odd><td align=center>15</td><td>S/PDIF Data</td><td>Output</td></tr>

  946. 	</table>

  947. 	</p>

  948. 	<h3>Examples</h3>

  949. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughAsyncSpdif

  950. 	</p>

  951. 	<h3>Notes</h3>

  952. 	<p>AsyncAudioInputSPDIF3 is not able to clock the audio pipline (never has the 'update_responsibility'). At least 1 other input or output must be used to cause the entire Audio library to update.

  953. 	</p>

  954. 

  955. 	<p>AsyncAudioInputSPDIF3 can optionally take parameters to alter its resampling behavior.

  956. 	</p>

  957. 	<p><span class=keyword>AsyncAudioInputSPDIF3</span>  spdif_async1(<i>dither</i>, <i>noiseshaping</i>, <i>attenuation</i>, <i>minHalfFilterLength</i>, <i>maxHalfFilterLength</i>);

  958. 	</p>

  959. 	<p class=desc><i>dither</i>: triangular shaped dither is added at the transition from 32bit float to 16bit integer if true (default: true)

  960. 	</p>

  961. 	<p class=desc><i>noiseshaping</i>: noise shaping is applied at the aforementioned transition if true (default: true)

  962. 	</p>

  963. 	<p class=desc><i>attenuation</i>: target attenuation of the anti-aliasing filter (default: 100dB). The attenuation is not reached if a filter longer than 161 is needed.

  964. 	</p>

  965. 	<p class=desc><i>minHalfFilterLength</i>: half of the guaranteed resampling filter (internally restricted to 80, default: 20). The filter might be longer if needed to achieve the requested attenuation.

  966. 	</p>

  967. 	<p class=desc><i>maxHalfFilterLength</i>: Restricts the maximum length of the resampling filter. The maximum half filter length is 80. This parameter can be used to further restrict the length in order to limit the processor usage.

  968. 	</p>

  969. 	<p>The windowed (Kaiser window) sinc-function is used as resample filter (i.e. to interpolate the incoming signal). The longer the filter, the better the quality of the resampled signal. However, a longer filter has a higher group delay and increases the processor usage. The sinc- filter also serves as anti-aliasing filter if the input sample rate is larger than 44.1kHz. The filter length is automatically increased at high input sample rates to reach the specified attenuation. However its half length is restricted to 80. 32bit floating point arithmetic is used at the resampling stage and the resampled signal is transformed to 16 bit integers afterwards. Here it is possible to apply triangular shaped dither and noise shaping to increase the perceived signal-to-noise-ratio.</p>

  970. </script>

  971. <script type="text/x-red" data-template-name="AsyncAudioInputSPDIF3">

  972. 	<div class="form-row">

  973. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  974. 		<input type="text" id="node-input-name" placeholder="Name">

  975. 	</div>

  976. </script>

  977. 

  978. <script type="text/x-red" data-help-name="AudioInputAnalog">

  979. 	<h3>Summary</h3>

  980. 	<div class=tooltipinfo>

  981. 	<p>Receive audio using the built-in analog to digital converter.</p>

  982. 	</div>

  983. 	<h3>Boards Supported</h3>

  984. 	<ul>

  985. 	<li>Teensy 3.2

  986. 	<li>Teensy 3.5

  987. 	<li>Teensy 3.6

  988. 	<li>Teensy 4.0 - experimental

  989. 	<li>Teensy 4.1 - experimental

  990. 	</ul>

  991. 	<h3>Audio Connections</h3>

  992. 	<table class=doc align=center cellpadding=3>

  993. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  994. 		<tr class=odd><td align=center>Out 0</td><td>Audio Channel</td></tr>

  995. 	</table>

  996. 	<h3>Functions</h3>

  997. 	<p>This object has no functions to call from the Arduino sketch.  It

  998. 		simply streams data from the ADC to its output port.</p>

  999. 	<h3>Hardware</h3>

  1000. 	<p>Pin A2 is used for audio input.  This circuitry is recommended.</p>

  1001. 	<p align=center><img src="img/adccircuit.png"></p>

  1002. 	<p>Signal range is 0 to 1.2V</p>

  1003. 	<p>With a <a href="https://forum.pjrc.com/threads/40468-Help-with-Basic-Audio-Lib-results?p=126317&viewfull=1#post126317">small modification</a> Adafruit's <a href="https://www.adafruit.com/products/1063">MAX4466 microphone</a> can be used</p>

  1004. 	<p align=center><a href="https://forum.pjrc.com/threads/40468-Help-with-Basic-Audio-Lib-results?p=126317&viewfull=1#post126317"><img src="img/adccircuitmic.jpg" border=0></a></p>

  1005. 	<p>Control Voltage (CV) from +5V to -5V can be adapted with a

  1006. 		<a href="https://www.dorkbotpdx.org/blog/paul/control_voltage_cv_to_analog_input_pin">simple circuit</a>

  1007. 		or better <a href="https://forum.pjrc.com/threads/28423?p=71257&viewfull=1#post71257">opamp-based circuity</a>

  1008. 		to Teensy's 0-1.2V analog input range.</p>

  1009. 	<h3>Examples</h3>

  1010. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughMono

  1011. 	</p>

  1012. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; PeakMeterMono

  1013. 	</p>

  1014. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; DialTone_7segment

  1015. 	</p>

  1016. 	<p class=exam>File &gt; Examples &gt; OctoWS2811 &gt; SpectrumAnalyzer

  1017. 	</p>

  1018. 	<h3>Notes</h3>

  1019. 	<p><b>analogRead() must not be used</b>, because AudioInputAnalog is regularly

  1020. 		accessing the ADC hardware.  If both access the hardware at the same

  1021. 		moment, analogRead() can end up waiting forever, which effectively

  1022. 		crashes your program.

  1023. 	</p>

  1024. 	<p>A different pin may be used, but adding it as an parameter

  1025. 		to the AudioInputAnalog object definition.

  1026. 	</p>

  1027. 	<p>For example, to use pin A3:

  1028. 	</p>

  1029. 	<p class=desc><span class=keyword>AudioInputAnalog</span>  adc1(<span class=literal>A3</span>);

  1030. 	</p>

  1031. 

  1032. 	<p>Noise due to high source impedance, which allows rapidly switching digital signals

  1033. 		to capacitively couple... avoiding higher analog impedance is the solution.</p>

  1034. 	<p>Power Supply rejection issue with simple DC bias (bigger capacitor may be needed if 3.3V has low frequency noise)</p>

  1035. 	<p>Algorithm for automatic DC bias tracking</p>

  1036. 	<p>TODO: actual noise measurements with different input circuitry

  1037. 		(it's not as quiet as the audio shield)</p>

  1038. </script>

  1039. <script type="text/x-red" data-template-name="AudioInputAnalog">

  1040. 	<div class="form-row">

  1041. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1042. 		<input type="text" id="node-input-name" placeholder="Name">

  1043. 	</div>

  1044. </script>

  1045. 

  1046. <script type="text/x-red" data-help-name="AudioInputAnalogStereo">

  1047. 	<h3>Summary</h3>

  1048. 	<div class=tooltipinfo>

  1049. 	<p>Receive stereo audio using the built-in analog to digital converters.</p>

  1050. 	</div>

  1051. 	<h3>Boards Supported</h3>

  1052. 	<ul>

  1053. 	<li>Teensy 3.2

  1054. 	<li>Teensy 3.5

  1055. 	<li>Teensy 3.6

  1056. 	</ul>

  1057. 	<h3>Audio Connections</h3>

  1058. 	<table class=doc align=center cellpadding=3>

  1059. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1060. 		<tr class=odd><td align=center>Out 0</td><td>Audio Channel (Left)</td></tr>

  1061. 		<tr class=odd><td align=center>Out 1</td><td>Audio Channel (Right)</td></tr>

  1062. 	</table>

  1063. 	<h3>Functions</h3>

  1064. 	<p>This object has no functions to call from the Arduino sketch.  It

  1065. 		simply streams data from both ADCs to its output ports.</p>

  1066. 	<h3>Hardware</h3>

  1067. 	<p>By default, pins A2 & A3 are used for audio input.  This circuitry is recommended.</p>

  1068. 	<p align=center><img src="img/adccircuit2.png"></p>

  1069. 	<p>Signal range is 0 to 1.2V</p>

  1070. 	<p>Control Voltage (CV) from +5V to -5V can be adapted with a

  1071. 		<a href="https://www.dorkbotpdx.org/blog/paul/control_voltage_cv_to_analog_input_pin">simple circuit</a>

  1072. 		or better <a href="https://forum.pjrc.com/threads/28423?p=71257&viewfull=1#post71257">opamp-based circuity</a>

  1073. 		to Teensy's 0-1.2V analog input range.</p>

  1074. 	<h3>Examples</h3>

  1075. 	<!--

  1076. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughMono

  1077. 	</p>

  1078. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; PeakMeterMono

  1079. 	</p>

  1080. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; DialTone_7segment

  1081. 	</p>

  1082. 	<p class=exam>File &gt; Examples &gt; OctoWS2811 &gt; SpectrumAnalyzer

  1083. 	</p>

  1084. 	-->

  1085. 	<h3>Notes</h3>

  1086. 	<p><b>analogRead() must not be used</b>, because AudioInputAnalogStereo is regularly

  1087. 		accessing the ADC hardware.  If both access the hardware at the same

  1088. 		moment, analogRead() can end up waiting forever, which effectively

  1089. 		crashes your program.

  1090. 	</p>

  1091. 	<p>A different pin may be used, but adding it as an parameter

  1092. 		to the AudioInputAnalog object definition.

  1093. 	</p>

  1094. 	<p>For example:

  1095. 	</p>

  1096. 	<p class=desc><span class=keyword>AudioInputAnalogStereo</span>  adc1(<span class=literal>A3</span>, <span class=literal>A2</span>);

  1097. 	</p>

  1098. 	<p>TODO: add info here about which pins work for input 0 and 1.

  1099. 	</p>

  1100. 	<p>Noise due to high source impedance, which allows rapidly switching digital signals

  1101. 		to capacitively couple... avoiding higher analog impedance is the solution.</p>

  1102. 	<p>Power Supply rejection issue with simple DC bias (bigger capacitor may be needed if 3.3V has low frequency noise)</p>

  1103. 	<p>Algorithm for automatic DC bias tracking</p>

  1104. 	<p>TODO: actual noise measurements with different input circuitry

  1105. 		(it's not as quiet as the audio shield)</p>

  1106. </script>

  1107. <script type="text/x-red" data-template-name="AudioInputAnalogStereo">

  1108. 	<div class="form-row">

  1109. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1110. 		<input type="text" id="node-input-name" placeholder="Name">

  1111. 	</div>

  1112. </script>

  1113. 

  1114. <script type="text/x-red" data-help-name="AudioInputI2Sslave">

  1115. 	<h3>Summary</h3>

  1116. 	<div class=tooltipinfo>

  1117. 	<p>Receive 16 bit stereo audio from an I2S device using I2S slave mode

  1118. 		(where the ADC or codec chip, not Teensy, controls audio timing).</p>

  1119. 	<p><span style="color:red">This input is incompatible with most other inputs and outputs</span>

  1120. 		which run at a speed controlled by Teensy's internal sample rate.</p>

  1121. 	</div>

  1122. 	<h3>Boards Supported</h3>

  1123. 	<ul>

  1124. 	<li>Teensy 3.2

  1125. 	<li>Teensy 3.5

  1126. 	<li>Teensy 3.6

  1127. 	<li>Teensy 4.0

  1128. 	<li>Teensy 4.1

  1129. 	</ul>

  1130. 	<h3>Audio Connections</h3>

  1131. 	<table class=doc align=center cellpadding=3>

  1132. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1133. 		<tr class=odd><td align=center>Out 0</td><td>Left Channel</td></tr>

  1134. 		<tr class=odd><td align=center>Out 1</td><td>Right Channel</td></tr>

  1135. 	</table>

  1136. 	<h3>Functions</h3>

  1137. 	<p>This object has no functions to call from the Arduino sketch.  It

  1138. 		simply streams data from the I2S hardware to its 2 output ports.</p>

  1139. 	<h3>Hardware</h3>

  1140. 	<p>The I2S signals are used in "slave" mode, where the I2S device controls

  1141. 		data timing.</p>

  1142. 	<table class=doc align=center cellpadding=3>

  1143. 		<tr class=top><th>Teensy<br>3.x Pin</th><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1144. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Input</td></tr>

  1145. 		<tr class=odd><td align=center>13</td><td align=center>8</td><td>RX</td><td>Input</td></tr>

  1146. 		<tr class=odd><td align=center>23</td><td align=center>20</td><td>LRCLK</td><td>Input</td></tr>

  1147. 	</table>

  1148. 	<!--

  1149. <h3>Examples</h3>

  1150. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  1151. 	</p>

  1152. -->

  1153. 	<h3>Notes</h3>

  1154. 	<p>Slave mode I2S <b>should not used in the same project as ADC, DAC and

  1155. 		PWM</b> signals.  Differences in timing between the I2S device and

  1156. 		Teensy's clock can cause occasional audio glitches when I2S slave mode

  1157. 		is used together with other input or output objects based on Teensy's

  1158. 		timing.</p>

  1159. 	<p>Only one I2S input and one I2S output object may be used.  Master

  1160. 		and slave modes may not be mixed (both must be of the same type).

  1161. 	</p>

  1162. </script>

  1163. <script type="text/x-red" data-template-name="AudioInputI2Sslave">

  1164. 	<div class="form-row">

  1165. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1166. 		<input type="text" id="node-input-name" placeholder="Name">

  1167. 	</div>

  1168. </script>

  1169. 

  1170. <script type="text/x-red" data-help-name="AudioInputTDM">

  1171. 	<h3>Summary</h3>

  1172. 	<div class=tooltipinfo>

  1173. 	<p>Receive a 256 bit Time Division Multiplexed frame containing

  1174. 		many audio channels.</p>

  1175. 	<p align=center><img src="img/tdm.jpg"></p>

  1176. 	</div>

  1177. 	<h3>Boards Supported</h3>

  1178. 	<ul>

  1179. 	<li>Teensy 3.2

  1180. 	<li>Teensy 3.5

  1181. 	<li>Teensy 3.6

  1182. 	<li>Teensy 4.0

  1183. 	<li>Teensy 4.1

  1184. 	</ul>

  1185. 	<h3>Audio Connections</h3>

  1186. 	<table class=doc align=center cellpadding=3>

  1187. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1188. 		<tr class=odd><td align=center>Out 0</td><td>Bits 0 to 15</td></tr>

  1189. 		<tr class=odd><td align=center>Out 1</td><td>Bits 16 to 31</td></tr>

  1190. 		<tr class=odd><td align=center>Out 2</td><td>Bits 32 to 47</td></tr>

  1191. 		<tr class=odd><td align=center>Out 3</td><td>Bits 48 to 63</td></tr>

  1192. 		<tr class=odd><td align=center>Out 4</td><td>Bits 64 to 79</td></tr>

  1193. 		<tr class=odd><td align=center>Out 5</td><td>Bits 80 to 95</td></tr>

  1194. 		<tr class=odd><td align=center>Out 6</td><td>Bits 96 to 111</td></tr>

  1195. 		<tr class=odd><td align=center>Out 7</td><td>Bits 112 to 127</td></tr>

  1196. 		<tr class=odd><td align=center>Out 8</td><td>Bits 128 to 143</td></tr>

  1197. 		<tr class=odd><td align=center>Out 9</td><td>Bits 144 to 159</td></tr>

  1198. 		<tr class=odd><td align=center>Out 10</td><td>Bits 160 to 175</td></tr>

  1199. 		<tr class=odd><td align=center>Out 11</td><td>Bits 176 to 191</td></tr>

  1200. 		<tr class=odd><td align=center>Out 12</td><td>Bits 192 to 207</td></tr>

  1201. 		<tr class=odd><td align=center>Out 13</td><td>Bits 208 to 223</td></tr>

  1202. 		<tr class=odd><td align=center>Out 14</td><td>Bits 224 to 239</td></tr>

  1203. 		<tr class=odd><td align=center>Out 15</td><td>Bits 240 to 255</td></tr>

  1204. 	</table>

  1205. 	<h3>Functions</h3>

  1206. 	<p>This object has no functions to call from the Arduino sketch.  It

  1207. 		simply streams data from the TDM hardware to its 16 output ports.</p>

  1208. 	<h3>Hardware</h3>

  1209. 	<p>TDM has been tested with this <a href="https://oshpark.com/shared_projects/2Yj6rFaW">

  1210. 		CS42448 Circuit Board</a>.  It may also work with

  1211. 		<a href="https://forum.pjrc.com/threads/42894">Invensense ICS-52000 microphones</a>.

  1212. 		</p>

  1213. 	<table class=doc align=center cellpadding=3>

  1214. 		<tr class=top><th>T3.x<br>Pin</th><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  1215. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Output, 11.3 MHz</td></tr>

  1216. 		<tr class=odd><td align=center>11</td><td align=center>23</td><td>MCLK</td><td>Output, 22.6 MHz</td></tr>

  1217. 		<tr class=odd><td align=center>13</td><td align=center>8</td><td>RX</td><td>Input, 11.3 Mbit/sec</td></tr>

  1218. 		<tr class=odd><td align=center>23</td><td align=center>21</td><td>FS</td><td>Output</td></tr>

  1219. 	</table>

  1220. 	<p>Audio from

  1221. 		master mode TDM may be used in the same project as ADC, DAC and

  1222. 		PWM signals, because all remain in sync to Teensy's timing</p>

  1223. 	<!--<h3>Examples</h3>-->

  1224. 	<h3>Notes</h3>

  1225. 	<p>Only one TDM input and one TDM output object may be used.  The

  1226. 		I2S hardware is used by TDM, so TDM objects may not be used

  1227. 		together with I2S, SPDIF or PT8211.</p>

  1228. 	<p>When used with TDM devices which transmit 32 bit audio, the

  1229. 		even numbered channels will contain the useful upper 16

  1230. 		bits of audio data.</p>

  1231. 	<p>AudioMemory should be at least 16.  Even if most channels are

  1232. 		unused, this TDM object will need to allocate 16 blocks of

  1233. 		memory.</p>

  1234. </script>

  1235. <script type="text/x-red" data-template-name="AudioInputTDM">

  1236. 	<div class="form-row">

  1237. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1238. 		<input type="text" id="node-input-name" placeholder="Name">

  1239. 	</div>

  1240. </script>

  1241. 

  1242. <script type="text/x-red" data-help-name="AudioInputTDM2">

  1243. 	<h3>Summary</h3>

  1244. 	<div class=tooltipinfo>

  1245. 	<p>Receive a 256 bit Time Division Multiplexed frame containing

  1246. 		many audio channels, using the I2S2 port.</p>

  1247. 	</div>

  1248. 	<h3>Boards Supported</h3>

  1249. 	<ul>

  1250. 	<li>Teensy 4.0

  1251. 	<li>Teensy 4.1

  1252. 	</ul>

  1253. 	<h3>Audio Connections</h3>

  1254. 	<table class=doc align=center cellpadding=3>

  1255. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1256. 		<tr class=odd><td align=center>Out 0</td><td>Bits 0 to 15</td></tr>

  1257. 		<tr class=odd><td align=center>Out 1</td><td>Bits 16 to 31</td></tr>

  1258. 		<tr class=odd><td align=center>Out 2</td><td>Bits 32 to 47</td></tr>

  1259. 		<tr class=odd><td align=center>Out 3</td><td>Bits 48 to 63</td></tr>

  1260. 		<tr class=odd><td align=center>Out 4</td><td>Bits 64 to 79</td></tr>

  1261. 		<tr class=odd><td align=center>Out 5</td><td>Bits 80 to 95</td></tr>

  1262. 		<tr class=odd><td align=center>Out 6</td><td>Bits 96 to 111</td></tr>

  1263. 		<tr class=odd><td align=center>Out 7</td><td>Bits 112 to 127</td></tr>

  1264. 		<tr class=odd><td align=center>Out 8</td><td>Bits 128 to 143</td></tr>

  1265. 		<tr class=odd><td align=center>Out 9</td><td>Bits 144 to 159</td></tr>

  1266. 		<tr class=odd><td align=center>Out 10</td><td>Bits 160 to 175</td></tr>

  1267. 		<tr class=odd><td align=center>Out 11</td><td>Bits 176 to 191</td></tr>

  1268. 		<tr class=odd><td align=center>Out 12</td><td>Bits 192 to 207</td></tr>

  1269. 		<tr class=odd><td align=center>Out 13</td><td>Bits 208 to 223</td></tr>

  1270. 		<tr class=odd><td align=center>Out 14</td><td>Bits 224 to 239</td></tr>

  1271. 		<tr class=odd><td align=center>Out 15</td><td>Bits 240 to 255</td></tr>

  1272. 	</table>

  1273. 	<h3>Functions</h3>

  1274. 	<p>This object has no functions to call from the Arduino sketch.  It

  1275. 		simply streams data from the TDM hardware to its 16 output ports.</p>

  1276. 	<h3>Hardware</h3>

  1277. 	<table class=doc align=center cellpadding=3>

  1278. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1279. 		<tr class=odd><td align=center>4</td><td>BCLK</td><td>Output, 11.3 MHz</td></tr>

  1280. 		<tr class=odd><td align=center>33</td><td>MCLK</td><td>Output, 22.6 MHz</td></tr>

  1281. 		<tr class=odd><td align=center>5</td><td>RX</td><td>Input, 11.3 Mbit/sec</td></tr>

  1282. 		<tr class=odd><td align=center>3</td><td>FS</td><td>Output</td></tr>

  1283. 	</table>

  1284. 	<!--<h3>Examples</h3>-->

  1285. 	<h3>Notes</h3>

  1286. 	<p>When used with TDM devices which transmit 32 bit audio, the

  1287. 		even numbered channels will contain the useful upper 16

  1288. 		bits of audio data.</p>

  1289. 	<p>AudioMemory should be at least 16.  Even if most channels are

  1290. 		unused, this TDM object will need to allocate 16 blocks of

  1291. 		memory.</p>

  1292. </script>

  1293. <script type="text/x-red" data-template-name="AudioInputTDM2">

  1294. 	<div class="form-row">

  1295. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1296. 		<input type="text" id="node-input-name" placeholder="Name">

  1297. 	</div>

  1298. </script>

  1299. 

  1300. <script type="text/x-red" data-help-name="AudioInputPDM">

  1301. 	<h3>Summary</h3>

  1302. 	<div class=tooltipinfo>

  1303. 	<p>Receive (and filter) a Pulse Density Modulated bitstream.

  1304. 		</p>

  1305. 	<p align=center><img src="img/pdmmic.jpg"><br><small>PDM MEMS Mic</small></p>

  1306. 	</div>

  1307. 	<h3>Boards Supported</h3>

  1308. 	<ul>

  1309. 	<li>Teensy 3.2

  1310. 	<li>Teensy 3.5

  1311. 	<li>Teensy 3.6

  1312. 	<!--<li>Teensy 4.0

  1313. 	<li>Teensy 4.1-->

  1314. 	</ul>

  1315. 	<h3>Audio Connections</h3>

  1316. 	<table class=doc align=center cellpadding=3>

  1317. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1318. 		<tr class=odd><td align=center>Out 0</td><td>Filtered Audio Output</td></tr>

  1319. 	</table>

  1320. 	<h3>Functions</h3>

  1321. 	<p>This object has no functions to call from the Arduino sketch.  It

  1322. 		simply streams data from the PDM data, filters out the high frequency

  1323. 		noise and gives you the audio signal.</p>

  1324. 	<h3>Hardware</h3>

  1325. 	<p>PDM has been tested with this <a href="https://www.adafruit.com/product/3492">

  1326. 		Adafruit MP34DT01-M Microphone Board</a>.

  1327. 		</p>

  1328. 	<table class=doc align=center cellpadding=3>

  1329. 		<tr class=top><th>Pin</th><th>Signal</th><th>Direction</th></tr>

  1330. 		<tr class=odd><td align=center>9</td><td>CLK</td><td>Output, 2.8235 MHz</td></tr>

  1331. 		<tr class=odd><td align=center>13</td><td>DATA</td><td>Input, Data on rising edge</td></tr>

  1332. 	</table>

  1333. 	<p>Data is input on the rising edge.  The SEL pin on MP34DT01-M should be

  1334. 		connected LOW for proper data capture.</p>

  1335. 	<!--<h3>Examples</h3>-->

  1336. 	<h3>Notes</h3>

  1337. 	<p>Filtering consumes approximately 39% of the CPU when running at

  1338. 		96 MHz.  The code currently consumes this time inside a high

  1339. 		priority interrupt, blocking other libraries.  Perhaps future

  1340. 		versions will perform filtering at lower priority.

  1341. 		</p>

  1342. 	<p>The filter used is a 512 tap FIR with approx &plusmn;1.1 dB gain

  1343. 		flatness to 10 kHz.  While far from audiophile grade, this should

  1344. 		perform far better than the rapid rolloff of Cascaded Integrator

  1345. 		Comb (CIC) or simple moving average filters commonly used on

  1346. 		other microcontrollers.  The filter also consumes 2104 bytes of

  1347. 		RAM for buffering and 32K of Flash for a lookup table to optimized

  1348. 		the filter computation.

  1349. 		</p>

  1350. </script>

  1351. <script type="text/x-red" data-template-name="AudioInputPDM">

  1352. 	<div class="form-row">

  1353. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1354. 		<input type="text" id="node-input-name" placeholder="Name">

  1355. 	</div>

  1356. </script>

  1357. 

  1358. <script type="text/x-red" data-help-name="AudioInputUSB">

  1359. 	<h3>Summary</h3>

  1360. 	<div class=tooltipinfo>

  1361. 	<p>Receive stereo audio from a PC or Mac.  Teensy appears as a USB

  1362. 		sound device.</p>

  1363. 	<p align=center><img src="img/usbtype_audio_in.png"></p>

  1364. 	</div>

  1365. 	<h3>Boards Supported</h3>

  1366. 	<ul>

  1367. 	<li>Teensy 3.2

  1368. 	<li>Teensy 3.5

  1369. 	<li>Teensy 3.6

  1370. 	<li>Teensy 4.0

  1371. 	<li>Teensy 4.1

  1372. 	</ul>

  1373. 	<h3>Audio Connections</h3>

  1374. 	<table class=doc align=center cellpadding=3>

  1375. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1376. 		<tr class=odd><td align=center>Out 0</td><td>Left Channel</td></tr>

  1377. 		<tr class=odd><td align=center>Out 1</td><td>Right Channel</td></tr>

  1378. 	</table>

  1379. 	<h3>Functions</h3>

  1380. 	<p class=func><span class=keyword>volume</span>();</p>

  1381. 	<p class=desc>Returns the volume setting requested by the USB host.

  1382. 		Range is 0 to 1.0.  To make the PC's volume control work, this

  1383. 		setting should be read periodically and used to control the

  1384. 		system processing the signal.

  1385. 	</p>

  1386. 	<!--

  1387. 	<h3>Hardware</h3>

  1388. 	-->

  1389. 	<h3>Examples</h3>

  1390. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughUSB</p>

  1391. 	</p>

  1392. 	<h3>Notes</h3>

  1393. 	<p>Arduino's <b>Tools &gt; USB Type</b> menu must be set to <b>Audio</b>.

  1394. 		</p>

  1395. 	<p align=center><img src="img/usbtype_audio.png"></p>

  1396. 	<p>USB input &amp; output does not cause the Teensy Audio Library to

  1397. 		update.  At least one non-USB input or output object must be

  1398. 		present for the entire library to update properly.</p>

  1399. </script>

  1400. <script type="text/x-red" data-template-name="AudioInputUSB">

  1401. 	<div class="form-row">

  1402. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1403. 		<input type="text" id="node-input-name" placeholder="Name">

  1404. 	</div>

  1405. </script>

  1406. 

  1407. <script type="text/x-red" data-help-name="AudioOutputI2S">

  1408. 	<h3>Summary</h3>

  1409. 	<div class=tooltipinfo>

  1410. 	<p>Transmit 16 bit stereo audio to the

  1411. 	<a href="http://www.pjrc.com/store/teensy3_audio.html" target="_blank">audio shield</a>

  1412. 		or another I2S device, using I2S master mode.</p>

  1413. 	<p align=center><img src="img/audioshield_outputs.jpg"></p>

  1414. 	</div>

  1415. 	<h3>Boards Supported</h3>

  1416. 	<ul>

  1417. 	<li>Teensy 3.2

  1418. 	<li>Teensy 3.5

  1419. 	<li>Teensy 3.6

  1420. 	<li>Teensy 4.0

  1421. 	<li>Teensy 4.1

  1422. 	</ul>

  1423. 	<h3>Audio Connections</h3>

  1424. 	<table class=doc align=center cellpadding=3>

  1425. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1426. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  1427. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  1428. 	</table>

  1429. 	<h3>Functions</h3>

  1430. 	<p>This object has no functions to call from the Arduino sketch.  It

  1431. 		simply streams data from its 2 input ports to the I2S hardware.</p>

  1432. 	<h3>Hardware</h3>

  1433. 	<p align=center><img src="img/audioshield_backside.jpg"></p>

  1434. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  1435. 		all 3 clock signals and controls all data timing.</p>

  1436. 	<table class=doc align=center cellpadding=3>

  1437. 		<tr class=top><th>T3.x<br>Pin</th><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  1438. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  1439. 		<tr class=odd><td align=center>11</td><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  1440. 		<tr class=odd><td align=center>22</td><td align=center>7</td><td>TX</td><td>Output</td></tr>

  1441. 		<tr class=odd><td align=center>23</td><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  1442. 	</table>

  1443. 	<p>Audio from

  1444. 		master mode I2S may be used in the same project as ADC, DAC and

  1445. 		PWM signals, because all remain in sync to Teensy's timing</p>

  1446. 	<p>Compatible CODEC Chips:

  1447. 		<ul>

  1448. 		<li><a href="https://www.pjrc.com/store/teensy3_audio.html">STGL5000</a>

  1449. 		<li><a href="https://forum.pjrc.com/threads/42665-New-Audio-Board!-TI-TLV320AIC3206">TLV320AIC3206</a>

  1450. 		<li><a href="https://forum.pjrc.com/threads/32276-HiFi-Audio-CODEC-Module-AK4558-evaluation-board-in-a-square-inch-PCB">AK4558</a>

  1451. 		</ul>

  1452. 	</p>

  1453. 	<p>Compatible DAC Chips:

  1454. 		<ul>

  1455. 		<li><a href="https://forum.pjrc.com/threads/53069-Teensy-with-PCM5102a-Module-via-I2S?p=183106&viewfull=1#post183106">PCM5102A</a>

  1456. 		<li><a href="https://forum.pjrc.com/threads/53069-Teensy-with-PCM5102a-Module-via-I2S?p=183176&viewfull=1#post183176">PCM1808</a>

  1457. 		<li><a href="https://forum.pjrc.com/threads/53069-Teensy-with-PCM5102a-Module-via-I2S?p=188244&viewfull=1#post188244">PCM5242</a>

  1458. 		<li><a href="https://forum.pjrc.com/threads/55137-I2S-output-with-CS4344?p=197919&viewfull=1#post197919">CS4344</a>

  1459. 		</ul>

  1460. 	</p>

  1461. 	<h3>Examples</h3>

  1462. 	<p>Nearly all the examples use this object.  Here are some of the highlights:</p>

  1463. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughStereo

  1464. 	</p>

  1465. 	<p class=exam>File &gt; Examples &gt; Audio &gt; SamplePlayer

  1466. 	</p>

  1467. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Recorder

  1468. 	</p>

  1469. 	<p class=exam>File &gt; Examples &gt; Audio &gt; WavFilePlayer

  1470. 	</p>

  1471. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Chorus

  1472. 	</p>

  1473. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; PlaySynthMusic

  1474. 	</p>

  1475. 	<h3>Notes</h3>

  1476. 	<p>Normally, this object is used with the Audio Shield, which

  1477. 		is controlled separately by the "sgtl5000" object.</p>

  1478. 	<p>Only one I2S input and one I2S output object may be used.  Master

  1479. 		and slave modes may not be mixed (both must be of the same type).

  1480. 	</p>

  1481. </script>

  1482. <script type="text/x-red" data-template-name="AudioOutputI2S">

  1483. 	<div class="form-row">

  1484. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1485. 		<input type="text" id="node-input-name" placeholder="Name">

  1486. 	</div>

  1487. </script>

  1488. 

  1489. <script type="text/x-red" data-help-name="AudioOutputI2SQuad">

  1490. 	<h3>Summary</h3>

  1491. 	<div class=tooltipinfo>

  1492. 	<p>Transmit quad (4) channel 16 bit audio, using I2S master mode.</p>

  1493. 	<p align=center><img src="img/audioshield_quad_out.jpg"></p>

  1494. 	</div>

  1495. 	<h3>Boards Supported</h3>

  1496. 	<ul>

  1497. 	<li>Teensy 3.2

  1498. 	<li>Teensy 3.5

  1499. 	<li>Teensy 3.6

  1500. 	<li>Teensy 4.0

  1501. 	<li>Teensy 4.1

  1502. 	</ul>

  1503. 	<h3>Audio Connections</h3>

  1504. 	<table class=doc align=center cellpadding=3>

  1505. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1506. 		<tr class=odd><td align=center>In 0</td><td>Channel #1</td></tr>

  1507. 		<tr class=odd><td align=center>In 1</td><td>Channel #2</td></tr>

  1508. 		<tr class=odd><td align=center>In 2</td><td>Channel #3</td></tr>

  1509. 		<tr class=odd><td align=center>In 3</td><td>Channel #4</td></tr>

  1510. 	</table>

  1511. 	<h3>Functions</h3>

  1512. 	<p>This object has no functions to call from the Arduino sketch.  It

  1513. 		simply streams data from its 4 input ports to the I2S hardware.</p>

  1514. 	<h3>Hardware</h3>

  1515. 	<p>See this Sparkfun blog for <a href="https://www.sparkfun.com/news/2055" target="_blank">how

  1516. 		to connect two audio adaptors for 4 channel audio</a>.  More

  1517. 		<a href="https://forum.pjrc.com/threads/29373-Bit-bang-multiple-I2S-inputs-simultaneously?p=79606#post79606" target="_blank">details</a> are also available.</p>

  1518. 	<p>For Teensy 4 and Rev D audio shields, see

  1519. 		<a href="https://forum.pjrc.com/threads/61123?p=242054&viewfull=1#post242054">this forum thread</a>.</p>

  1520. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  1521. 		all 3 clock signals and controls all data timing.</p>

  1522. 	<table class=doc align=center cellpadding=3>

  1523. 		<tr class=top><th>T3.x<br>Pin</th><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  1524. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  1525. 		<tr class=odd><td align=center>11</td><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  1526. 		<tr class=odd><td align=center>22</td><td align=center>7</td><td>TX (ch 1+2)</td><td>Output</td></tr>

  1527. 		<tr class=odd><td align=center>15</td><td align=center>32</td><td>TX (ch 3+4)</td><td>Output</td></tr>

  1528. 		<tr class=odd><td align=center>23</td><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  1529. 	</table>

  1530. 	<p>Audio from

  1531. 		master mode I2S may be used in the same project as ADC, DAC and

  1532. 		PWM signals, because all remain in sync to Teensy's timing</p>

  1533. 	<h3>Examples</h3>

  1534. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughQuad

  1535. 	</p>

  1536. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; SGTL5000 &gt; QuadChannelOutput

  1537. 	</p>

  1538. 	<h3>Notes</h3>

  1539. 	<p>Normally, this object is used with two Audio Shields, which

  1540. 		are controlled separately by a pair of "sgtl5000" objects.</p>

  1541. </script>

  1542. <script type="text/x-red" data-template-name="AudioOutputI2SQuad">

  1543. 	<div class="form-row">

  1544. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1545. 		<input type="text" id="node-input-name" placeholder="Name">

  1546. 	</div>

  1547. </script>

  1548. 

  1549. <script type="text/x-red" data-help-name="AudioOutputI2SHex">

  1550. 	<h3>Summary</h3>

  1551. 	<div class=tooltipinfo>

  1552. 	<p>Transmit 6 channel 16 bit audio, using I2S master mode.</p>

  1553. 	</div>

  1554. 	<h3>Boards Supported</h3>

  1555. 	<ul>

  1556. 	<li>Teensy 4.0

  1557. 	<li>Teensy 4.1

  1558. 	</ul>

  1559. 	<h3>Audio Connections</h3>

  1560. 	<table class=doc align=center cellpadding=3>

  1561. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1562. 		<tr class=odd><td align=center>In 0</td><td>Channel #1</td></tr>

  1563. 		<tr class=odd><td align=center>In 1</td><td>Channel #2</td></tr>

  1564. 		<tr class=odd><td align=center>In 2</td><td>Channel #3</td></tr>

  1565. 		<tr class=odd><td align=center>In 3</td><td>Channel #4</td></tr>

  1566. 		<tr class=odd><td align=center>In 4</td><td>Channel #5</td></tr>

  1567. 		<tr class=odd><td align=center>In 5</td><td>Channel #6</td></tr>

  1568. 	</table>

  1569. 	<h3>Functions</h3>

  1570. 	<p>This object has no functions to call from the Arduino sketch.  It

  1571. 		simply streams data from its 6 input ports to the I2S hardware.</p>

  1572. 	<h3>Hardware</h3>

  1573. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  1574. 		all 3 clock signals and controls all data timing.</p>

  1575. 	<table class=doc align=center cellpadding=3>

  1576. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1577. 		<tr class=odd><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  1578. 		<tr class=odd><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  1579. 		<tr class=odd><td align=center>7</td><td>TX (ch 1+2)</td><td>Output</td></tr>

  1580. 		<tr class=odd><td align=center>32</td><td>TX (ch 3+4)</td><td>Output</td></tr>

  1581. 		<tr class=odd><td align=center>9</td><td>TX (ch 5+6)</td><td>Output</td></tr>

  1582. 		<tr class=odd><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  1583. 	</table>

  1584. 	<h3>Examples</h3>

  1585. 	<h3>Notes</h3>

  1586. 	<p>Teensy 4.0 &amp; 4.1's I2S port has a total of 5 data pins

  1587. 		which may each transmit or receive stereo digital audio.  This

  1588. 		6 channel output may be used together with the I2S stereo or

  1589. 		quad channel I2S input, but may not be combined with others

  1590. 		which use the same physical pins.</p>

  1591. </script>

  1592. <script type="text/x-red" data-template-name="AudioOutputI2SHex">

  1593. 	<div class="form-row">

  1594. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1595. 		<input type="text" id="node-input-name" placeholder="Name">

  1596. 	</div>

  1597. </script>

  1598. 

  1599. <script type="text/x-red" data-help-name="AudioOutputI2SOct">

  1600. 	<h3>Summary</h3>

  1601. 	<div class=tooltipinfo>

  1602. 	<p>Transmit 8 channel 16 bit audio, using I2S master mode.</p>

  1603. 	</div>

  1604. 	<h3>Boards Supported</h3>

  1605. 	<ul>

  1606. 	<li>Teensy 4.0

  1607. 	<li>Teensy 4.1

  1608. 	</ul>

  1609. 	<h3>Audio Connections</h3>

  1610. 	<table class=doc align=center cellpadding=3>

  1611. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1612. 		<tr class=odd><td align=center>In 0</td><td>Channel #1</td></tr>

  1613. 		<tr class=odd><td align=center>In 1</td><td>Channel #2</td></tr>

  1614. 		<tr class=odd><td align=center>In 2</td><td>Channel #3</td></tr>

  1615. 		<tr class=odd><td align=center>In 3</td><td>Channel #4</td></tr>

  1616. 		<tr class=odd><td align=center>In 4</td><td>Channel #5</td></tr>

  1617. 		<tr class=odd><td align=center>In 5</td><td>Channel #6</td></tr>

  1618. 		<tr class=odd><td align=center>In 6</td><td>Channel #7</td></tr>

  1619. 		<tr class=odd><td align=center>In 7</td><td>Channel #8</td></tr>

  1620. 	</table>

  1621. 	<h3>Functions</h3>

  1622. 	<p>This object has no functions to call from the Arduino sketch.  It

  1623. 		simply streams data from its 8 input ports to the I2S hardware.</p>

  1624. 	<h3>Hardware</h3>

  1625. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  1626. 		all 3 clock signals and controls all data timing.</p>

  1627. 	<table class=doc align=center cellpadding=3>

  1628. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1629. 		<tr class=odd><td align=center>21</td><td>BCLK</td><td>Output</td></tr>

  1630. 		<tr class=odd><td align=center>23</td><td>MCLK</td><td>Output</td></tr>

  1631. 		<tr class=odd><td align=center>7</td><td>TX (ch 1+2)</td><td>Output</td></tr>

  1632. 		<tr class=odd><td align=center>32</td><td>TX (ch 3+4)</td><td>Output</td></tr>

  1633. 		<tr class=odd><td align=center>9</td><td>TX (ch 5+6)</td><td>Output</td></tr>

  1634. 		<tr class=odd><td align=center>6</td><td>TX (ch 7+8)</td><td>Output</td></tr>

  1635. 		<tr class=odd><td align=center>20</td><td>LRCLK</td><td>Output</td></tr>

  1636. 	</table>

  1637. 	<h3>Examples</h3>

  1638. 	<h3>Notes</h3>

  1639. 	<p>Teensy 4.0 &amp; 4.1's I2S port has a total of 5 data pins

  1640. 		which may each transmit or receive stereo digital audio.  This

  1641. 		8 channel output may be used together with the I2S stereo

  1642. 		input, but may not be combined with others

  1643. 		which use the same physical pins.</p>

  1644. </script>

  1645. <script type="text/x-red" data-template-name="AudioOutputI2SOct">

  1646. 	<div class="form-row">

  1647. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1648. 		<input type="text" id="node-input-name" placeholder="Name">

  1649. 	</div>

  1650. </script>

  1651. 

  1652. 

  1653. <script type="text/x-red" data-help-name="AudioOutputI2S2">

  1654. 	<h3>Summary</h3>

  1655. 	<div class=tooltipinfo>

  1656. 	<p>Transmit 16 bit stereo audio to an I2S device, using I2S master mode, on the I2S2 port.</p>

  1657. 	</div>

  1658. 	<h3>Boards Supported</h3>

  1659. 	<ul>

  1660. 	<li>Teensy 4.0

  1661. 	<li>Teensy 4.1

  1662. 	</ul>

  1663. 	<h3>Audio Connections</h3>

  1664. 	<table class=doc align=center cellpadding=3>

  1665. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1666. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  1667. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  1668. 	</table>

  1669. 	<h3>Functions</h3>

  1670. 	<p>This object has no functions to call from the Arduino sketch.  It

  1671. 		simply streams data from its 2 input ports to the I2S hardware.</p>

  1672. 	<h3>Hardware</h3>

  1673. 	<p>The I2S signals are used in "master" mode, where Teensy creates

  1674. 		all 3 clock signals and controls all data timing.</p>

  1675. 	<table class=doc align=center cellpadding=3>

  1676. 		<tr class=top><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  1677. 		<tr class=odd><td align=center>4</td><td>BCLK</td><td>Output</td></tr>

  1678. 		<tr class=odd><td align=center>33</td><td>MCLK</td><td>Output</td></tr>

  1679. 		<tr class=odd><td align=center>2</td><td>TX</td><td>Output</td></tr>

  1680. 		<tr class=odd><td align=center>3</td><td>LRCLK</td><td>Output</td></tr>

  1681. 	</table>

  1682. 	<h3>Examples</h3>

  1683. 	<h3>Notes</h3>

  1684. </script>

  1685. <script type="text/x-red" data-template-name="AudioOutputI2S2">

  1686. 	<div class="form-row">

  1687. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1688. 		<input type="text" id="node-input-name" placeholder="Name">

  1689. 	</div>

  1690. </script>

  1691. 

  1692. <script type="text/x-red" data-help-name="AudioOutputSPDIF">

  1693. 	<h3>Summary</h3>

  1694. 	<div class=tooltipinfo>

  1695. 	<p>Transmit 16 bit stereo audio as Digital S/PDIF by use of the I2S port.</p>

  1696. 	<p align=center><img src="img/spdif_proto.jpg"></p>

  1697. 	</div>

  1698. 	<h3>Boards Supported</h3>

  1699. 	<ul>

  1700. 	<li>Teensy 3.2

  1701. 	<li>Teensy 3.5

  1702. 	<li>Teensy 3.6

  1703. 	<li>Teensy 4.0

  1704. 	<li>Teensy 4.1

  1705. 	</ul>

  1706. 	<h3>Audio Connections</h3>

  1707. 	<table class=doc align=center cellpadding=3>

  1708. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1709. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  1710. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  1711. 	</table>

  1712. 	<h3>Functions</h3>

  1713. 	<p>This object has no functions to call from the Arduino sketch.  It

  1714. 		simply streams data from its 2 input ports S/PDIF encoded digital

  1715. 		audio on pin 22 (Teensy 3.x) or pin 7 (Teensy 4.x).</p>

  1716. 	<h3>Hardware</h3>

  1717. 	<p>The S/PDIF output signal can be used to drive an optical TOSLINK

  1718. 		cable, or a standard (usually orange) RCA jack.</p>

  1719. 	<table class=doc align=center cellpadding=3>

  1720. 		<tr class=top><th>Teensy<br>3.x Pin</th><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1721. 		<tr class=odd><td align=center>22</td><td align=center>7</td><td>S/PDIF</td><td>Output</td></tr>

  1722. 	</table>

  1723. 	<p>For optical TOSLINK output, this

  1724. 		<a href="https://www.oshpark.com/shared_projects/KcDBKHta" target="_blank">OSH Park board</a>

  1725. 		can be used with the inexpensive Everlight PLT133/T6A connector, available

  1726. 		at Digikey, 1080-1434-ND.

  1727. 		</p>

  1728. 	<h3>Examples</h3>

  1729. 	<p>The AudioOutputSPDIF object can be used in place of the AudioOutputI2S object,

  1730. 	<p>used in nearly all the examples.  The WavFilePlayer shows how to substitute

  1731. 		output objects for different hardware types.

  1732. 	</p>

  1733. 	<p class=exam>File &gt; Examples &gt; Audio &gt; WavFilePlayer

  1734. 	</p>

  1735. 	<h3>Credits</h3>

  1736. 	<p><a href="https://github.com/FrankBoesing" target="_blank">Frank Boesing</a>

  1737. 		developed the AudioOutputSPDIF code.  The original

  1738. 		<a href="https://forum.pjrc.com/threads/28639-S-pdif" target="_blank">forum disussion</a>

  1739. 		included valuable input and code from "kpc".

  1740. 	<h3>Notes</h3>

  1741. 	<p>S/PDIF output uses the I2S hardware.  This object can not be used

  1742. 		together with any of the I2S objects, because it requires the I2S

  1743. 		hardware with different internal settings.</p>

  1744. 	</p>

  1745. </script>

  1746. <script type="text/x-red" data-template-name="AudioOutputSPDIF">

  1747. 	<div class="form-row">

  1748. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1749. 		<input type="text" id="node-input-name" placeholder="Name">

  1750. 	</div>

  1751. </script>

  1752. 

  1753. <script type="text/x-red" data-help-name="AudioOutputSPDIF2">

  1754. 	<h3>Summary</h3>

  1755. 	<div class=tooltipinfo>

  1756. 	<p>Transmit 16 bit stereo audio as Digital S/PDIF by use of the I2S2 port.</p>

  1757. 	</div>

  1758. 	<h3>Boards Supported</h3>

  1759. 	<ul>

  1760. 	<li>Teensy 4.0

  1761. 	<li>Teensy 4.1

  1762. 	</ul>

  1763. 	<h3>Audio Connections</h3>

  1764. 	<table class=doc align=center cellpadding=3>

  1765. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1766. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  1767. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  1768. 	</table>

  1769. 	<h3>Functions</h3>

  1770. 	<p>This object has no functions to call from the Arduino sketch.  It

  1771. 		simply streams data from its 2 input ports S/PDIF encoded digital

  1772. 		audio on pin 2 (Teensy 4.x).</p>

  1773. 	<h3>Hardware</h3>

  1774. 	<p>The S/PDIF output signal can be used to drive an optical TOSLINK

  1775. 		cable, or a standard (usually orange) RCA jack.</p>

  1776. 	<table class=doc align=center cellpadding=3>

  1777. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1778. 		<tr class=odd><td align=center>2</td><td>S/PDIF</td><td>Output</td></tr>

  1779. 	</table>

  1780. 	<h3>Examples</h3>

  1781. 	<p>The AudioOutputSPDIF object can be used in place of the AudioOutputI2S object,

  1782. 	<p>used in nearly all the examples.  The WavFilePlayer shows how to substitute

  1783. 		output objects for different hardware types.

  1784. 	</p>

  1785. 	<p class=exam>File &gt; Examples &gt; Audio &gt; WavFilePlayer

  1786. 	</p>

  1787. 	<h3>Credits</h3>

  1788. 	<p><a href="https://github.com/FrankBoesing" target="_blank">Frank Boesing</a>

  1789. 		developed the AudioOutputSPDIF code.  The original

  1790. 		<a href="https://forum.pjrc.com/threads/28639-S-pdif" target="_blank">forum disussion</a>

  1791. 		included valuable input and code from "kpc".

  1792. 	<h3>Notes</h3>

  1793. 	<p>S/PDIF output uses the I2S2 hardware.  This object can not be used

  1794. 		together with any of the I2S2 objects, because it requires the I2S2

  1795. 		hardware with different internal settings.</p>

  1796. 	</p>

  1797. </script>

  1798. <script type="text/x-red" data-template-name="AudioOutputSPDIF2">

  1799. 	<div class="form-row">

  1800. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1801. 		<input type="text" id="node-input-name" placeholder="Name">

  1802. 	</div>

  1803. </script>

  1804. 

  1805. <script type="text/x-red" data-help-name="AudioOutputSPDIF3">

  1806. 	<h3>Summary</h3>

  1807. 	<div class=tooltipinfo>

  1808. 	<p>Transmit 16 bit stereo audio as Digital S/PDIF by use of the native S/PDIF port.</p>

  1809. 	</div>

  1810. 	<h3>Boards Supported</h3>

  1811. 	<ul>

  1812. 	<li>Teensy 4.0

  1813. 	<li>Teensy 4.1

  1814. 	</ul>

  1815. 	<h3>Audio Connections</h3>

  1816. 	<table class=doc align=center cellpadding=3>

  1817. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1818. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  1819. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  1820. 	</table>

  1821. 	<h3>Functions</h3>

  1822. 	<p>This object has no functions to call from the Arduino sketch.  It

  1823. 		simply streams data from its 2 input ports S/PDIF encoded digital

  1824. 		audio on pin 14 (Teensy 4.x).</p>

  1825. 	<h3>Hardware</h3>

  1826. 	<p>The S/PDIF output signal can be used to drive an optical TOSLINK

  1827. 		cable, or a standard (usually orange) RCA jack.</p>

  1828. 	<table class=doc align=center cellpadding=3>

  1829. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1830. 		<tr class=odd><td align=center>14</td><td>S/PDIF</td><td>Output</td></tr>

  1831. 	</table>

  1832. 	<h3>Examples</h3>

  1833. 	<p>The AudioOutputSPDIF object can be used in place of the AudioOutputI2S object,

  1834. 	<p>used in nearly all the examples.  The WavFilePlayer shows how to substitute

  1835. 		output objects for different hardware types.

  1836. 	</p>

  1837. 	<p class=exam>File &gt; Examples &gt; Audio &gt; WavFilePlayer

  1838. 	</p>

  1839. 	<h3>Credits</h3>

  1840. 	<p><a href="https://github.com/FrankBoesing" target="_blank">Frank Boesing</a>

  1841. 		developed the AudioOutputSPDIF3 code.

  1842. 	<h3>Notes</h3>

  1843. 	<p>Native S/PDIF hardware is used, which is more efficient that use of I2S ports.</p>

  1844. 	</p>

  1845. </script>

  1846. <script type="text/x-red" data-template-name="AudioOutputSPDIF3">

  1847. 	<div class="form-row">

  1848. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1849. 		<input type="text" id="node-input-name" placeholder="Name">

  1850. 	</div>

  1851. </script>

  1852. 

  1853. <script type="text/x-red" data-help-name="AudioOutputPT8211">

  1854. 	<h3>Summary</h3>

  1855. 	<div class=tooltipinfo>

  1856. 	<p>Transmit 16 bit stereo audio to a low-cost PT8211 DAC chip.  4X oversampling

  1857. 		and filtering are automatically used to improve output quality.</p>

  1858. 	<p align=center><img src="img/pt8211.jpg"></p>

  1859. 	</div>

  1860. 	<h3>Boards Supported</h3>

  1861. 	<ul>

  1862. 	<li>Teensy 3.2

  1863. 	<li>Teensy 3.5

  1864. 	<li>Teensy 3.6

  1865. 	<li>Teensy 4.0

  1866. 	<li>Teensy 4.1

  1867. 	</ul>

  1868. 	<h3>Audio Connections</h3>

  1869. 	<table class=doc align=center cellpadding=3>

  1870. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1871. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  1872. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  1873. 	</table>

  1874. 	<h3>Functions</h3>

  1875. 	<p>This object has no functions to call from the Arduino sketch.  It

  1876. 		simply streams data from its 2 input ports to a PT8211 chip.  4X

  1877. 		oversampling and filtering is automatically used to improve quality.</p>

  1878. 	<h3>Hardware</h3>

  1879. 	<table class=doc align=center cellpadding=3>

  1880. 		<tr class=top><th>Teensy<br>3.x Pin</th><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1881. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCK</td><td>Output</td></tr>

  1882. 		<tr class=odd><td align=center>22</td><td align=center>7</td><td>DIN</td><td>Output</td></tr>

  1883. 		<tr class=odd><td align=center>23</td><td align=center>20</td><td>FS</td><td>Output</td></tr>

  1884. 	</table>

  1885. 	<p>More information can be found in the PT8211 datasheet.

  1886. 		</p>

  1887. 	<h3>Examples</h3>

  1888. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PT8211Sine

  1889. 	</p>

  1890. 	<h3>Credits</h3>

  1891. 	<p>Frank Boesing and Benjamin developed this PT8211 object.  Details can be

  1892. 		found on this

  1893. 		<a href="https://forum.pjrc.com/threads/29284-Dual-channel-16bit-dac-PT8211/page3" target="_blank">forum disussion</a>.

  1894. 	<h3>Notes</h3>

  1895. 	<p>

  1896. 	</p>

  1897. </script>

  1898. <script type="text/x-red" data-template-name="AudioOutputPT8211">

  1899. 	<div class="form-row">

  1900. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1901. 		<input type="text" id="node-input-name" placeholder="Name">

  1902. 	</div>

  1903. </script>

  1904. 

  1905. <script type="text/x-red" data-help-name="AudioOutputPT8211_2">

  1906. 	<h3>Summary</h3>

  1907. 	<div class=tooltipinfo>

  1908. 	<p>Transmit 16 bit stereo audio to a low-cost PT8211 DAC chip, using the I2S2 port.  4X oversampling

  1909. 		and filtering are automatically used to improve output quality.</p>

  1910. 	</div>

  1911. 	<h3>Boards Supported</h3>

  1912. 	<ul>

  1913. 	<li>Teensy 4.0

  1914. 	<li>Teensy 4.1

  1915. 	</ul>

  1916. 	<h3>Audio Connections</h3>

  1917. 	<table class=doc align=center cellpadding=3>

  1918. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1919. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  1920. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  1921. 	</table>

  1922. 	<h3>Functions</h3>

  1923. 	<p>This object has no functions to call from the Arduino sketch.  It

  1924. 		simply streams data from its 2 input ports to a PT8211 chip.  4X

  1925. 		oversampling and filtering is automatically used to improve quality.</p>

  1926. 	<h3>Hardware</h3>

  1927. 	<table class=doc align=center cellpadding=3>

  1928. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  1929. 		<tr class=odd><td align=center>4</td><td>BCK</td><td>Output</td></tr>

  1930. 		<tr class=odd><td align=center>2</td><td>DIN</td><td>Output</td></tr>

  1931. 		<tr class=odd><td align=center>3</td><td>FS</td><td>Output</td></tr>

  1932. 	</table>

  1933. 	<p>More information can be found in the PT8211 datasheet.

  1934. 		</p>

  1935. 	<h3>Examples</h3>

  1936. 	<h3>Credits</h3>

  1937. 	<p>Frank Boesing and Benjamin developed this PT8211 object.  Details can be

  1938. 		found on this

  1939. 		<a href="https://forum.pjrc.com/threads/29284-Dual-channel-16bit-dac-PT8211/page3" target="_blank">forum disussion</a>.

  1940. 	<h3>Notes</h3>

  1941. 	<p>

  1942. 	</p>

  1943. </script>

  1944. <script type="text/x-red" data-template-name="AudioOutputPT8211_2">

  1945. 	<div class="form-row">

  1946. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  1947. 		<input type="text" id="node-input-name" placeholder="Name">

  1948. 	</div>

  1949. </script>

  1950. 

  1951. <script type="text/x-red" data-help-name="AudioOutputAnalog">

  1952. 	<h3>Summary</h3>

  1953. 	<div class=tooltipinfo>

  1954. 	<p>Transmit 12 bit audio using Teensy's built-in digital to analog converter.</p>

  1955. 	<p align=center><img src="img/dac_speaker.jpg"><br>

  1956. 	<small><a href="http://www.pjrc.com/store/prop_shield.html" target="_blank_">Prop Shield with 4&ohm; Speaker</a></small></p>

  1957. 	</div>

  1958. 	<h3>Boards Supported</h3>

  1959. 	<ul>

  1960. 	<li>Teensy 3.2

  1961. 	<li>Teensy 3.5

  1962. 	<li>Teensy 3.6

  1963. 	</ul>

  1964. 	<h3>Audio Connections</h3>

  1965. 	<table class=doc align=center cellpadding=3>

  1966. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  1967. 		<tr class=odd><td align=center>In 0</td><td>Audio Channel</td></tr>

  1968. 	</table>

  1969. 	<h3>Functions</h3>

  1970. 	<p class=func><span class=keyword>analogReference</span>(ref);</p>

  1971. 	<p class=desc>Configure output voltage range:<br>

  1972. 	<span class=literal>INTERNAL</span> selects 1.2 volt peak-to-peak output.<br>

  1973. 	<span class=literal>EXTERNAL</span> selects 3.3 volt peak-to-peak output.

  1974. 	</p>

  1975. 	<h3>Hardware</h3>

  1976. 	<p align=center><img src="img/dacpin.jpg"></p>

  1977. 	<p>Signal range default is 0 to 1.2V</p>

  1978. 	<p>The output voltage has DC level.  Some applications require a DC-blocking capacitor.  If unsure, a 10&micro;F is usually a safe value to use.  If an aluminum or tantalum capacitor is used, the positive terminal should connect to Teensy's DAC pin.</p>

  1979. 	<p>The DAC pin is used with the

  1980. 	<a href="http://www.pjrc.com/store/prop_shield.html" target="_blank_">Prop Shield</a>

  1981. 	to drive speakers.</p>

  1982. 	<h3>Examples</h3>

  1983. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughMono

  1984. 	</p>

  1985. 	<p class=exam>File &gt; Examples &gt; Audio &gt; SamplePlayer

  1986. 	</p>

  1987. 	<p class=exam><a href="https://github.com/PaulStoffregen/TouchGuitar" target="_blank">TouchGuitar</a>

  1988. 	</p>

  1989. 	<p class=exam><a href="https://community.arm.com/groups/embedded/blog/2014/05/23/led-video-panel-at-maker-faire-2014" target="_blank">LED Video Board</a>

  1990. 	</p>

  1991. 	<p class=exam>File &gt; Examples &gt; OctoWS2811 &gt; VideoSDcard

  1992. 	</p>

  1993. 	<p class=exam>File &gt; Examples &gt; SerialFlash &gt; MP3Player

  1994. 	</p>

  1995. 	<h3>Notes</h3>

  1996. 	<p>The output rate is 44.1 kHz (no oversampling).  Ultrasonic noise present if

  1997. 		not filtered.  This may not

  1998. 		be an issue for many uses, but care should be used if amplified and driven

  1999. 		to high power tweeters.</p>

  2000. 	<p>When using 3.3V output, the power supply is used for the analog reference.  Noise

  2001. 		present on the 3.3V power can couple to the DAC output signal.

  2002. 	</p>

  2003. </script>

  2004. <script type="text/x-red" data-template-name="AudioOutputAnalog">

  2005. 	<div class="form-row">

  2006. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2007. 		<input type="text" id="node-input-name" placeholder="Name">

  2008. 	</div>

  2009. </script>

  2010. 

  2011. <script type="text/x-red" data-help-name="AudioOutputAnalogStereo">

  2012. 	<h3>Summary</h3>

  2013. 	<div class=tooltipinfo>

  2014. 	<p>Transmit 12 bit stereo audio using Teensy 3.5 or 3.6 built-in digital to analog converters.</p>

  2015. 	<!--<p align=center><img src="img/dac_speaker.jpg"><br>

  2016. 	<small><a href="http://www.pjrc.com/store/prop_shield.html" target="_blank_">Prop Shield with 4&ohm; Speaker</a></small></p>-->

  2017. 	</div>

  2018. 	<h3>Boards Supported</h3>

  2019. 	<ul>

  2020. 	<li>Teensy 3.5

  2021. 	<li>Teensy 3.6

  2022. 	</ul>

  2023. 	<h3>Audio Connections</h3>

  2024. 	<table class=doc align=center cellpadding=3>

  2025. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2026. 		<tr class=odd><td align=center>In 0</td><td>Audio Channel (Left)</td></tr>

  2027. 		<tr class=odd><td align=center>In 1</td><td>Audio Channel (Right)</td></tr>

  2028. 	</table>

  2029. 	<h3>Functions</h3>

  2030. 	<p class=func><span class=keyword>analogReference</span>(ref);</p>

  2031. 	<p class=desc>Configure output voltage range:<br>

  2032. 	<span class=literal>INTERNAL</span> selects 1.2 volt peak-to-peak output.<br>

  2033. 	<span class=literal>EXTERNAL</span> selects 3.3 volt peak-to-peak output.

  2034. 	</p>

  2035. 	<h3>Hardware</h3>

  2036. 	<p align=center><img src="img/dacpins.png"></p>

  2037. 	<p>Signal range default is 0 to 1.2V</p>

  2038. 	<p>The output voltage has DC level.  Some applications require a DC-blocking capacitor.  If unsure, a 10&micro;F is usually a safe value to use.  If an aluminum or tantalum capacitor is used, the positive terminal should connect to Teensy's DAC pin.</p>

  2039. 	<p>The DAC pin is used with the

  2040. 	<a href="http://www.pjrc.com/store/prop_shield.html" target="_blank_">Prop Shield</a>

  2041. 	to drive speakers.</p>

  2042. 	<h3>Examples</h3>

  2043. 	<!--<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughMono

  2044. 	</p>

  2045. 	<p class=exam>File &gt; Examples &gt; SerialFlash &gt; MP3Player

  2046. 	</p>-->

  2047. 	<h3>Notes</h3>

  2048. 	<p>The output rate is 44.1 kHz (no oversampling).  Ultrasonic noise present if

  2049. 		not filtered.  This may not

  2050. 		be an issue for many uses, but care should be used if amplified and driven

  2051. 		to high power tweeters.</p>

  2052. 	<p>When using 3.3V output, the power supply is used for the analog reference.  Noise

  2053. 		present on the 3.3V power can couple to the DAC output signal.

  2054. 	</p>

  2055. </script>

  2056. <script type="text/x-red" data-template-name="AudioOutputAnalogStereo">

  2057. 	<div class="form-row">

  2058. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2059. 		<input type="text" id="node-input-name" placeholder="Name">

  2060. 	</div>

  2061. </script>

  2062. 

  2063. <script type="text/x-red" data-help-name="AudioOutputPWM">

  2064. 	<h3>Summary</h3>

  2065. 	<div class=tooltipinfo>

  2066. 	<p>Transmit audio using Teensy 3's PWM pins.  Two pins are

  2067. 		used for coarse and fine pulses, to be combined by scaled

  2068. 		resistors.</p>

  2069. 	</div>

  2070. 	<h3>Boards Supported</h3>

  2071. 	<ul>

  2072. 	<li>Teensy 3.2

  2073. 	<li>Teensy 3.5

  2074. 	<li>Teensy 3.6

  2075. 	<!--<li>Teensy 4.0

  2076. 	<li>Teensy 4.1-->

  2077. 	</ul>

  2078. 	<h3>Audio Connections</h3>

  2079. 	<table class=doc align=center cellpadding=3>

  2080. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2081. 		<tr class=odd><td align=center>In 0</td><td>Audio Channel</td></tr>

  2082. 	</table>

  2083. 	<h3>Functions</h3>

  2084. 	<p>This object has no functions to call from the Arduino sketch.  It

  2085. 		simply streams data from the its input port to the PWM pins.</p>

  2086. 	<h3>Hardware</h3>

  2087. 	<p>The following circuit is recommended.</p>

  2088. 	<p align=center><img src="img/pwmdualcircuit.jpg"></p>

  2089. 	<p>Signal range is approx 1.55 Vp-p.</p>

  2090. 	<p>These resistor values assume approx 20 ohms output impedance

  2091. 		on the digital pins.  The 127K resistor may be adjusted or

  2092. 		trimmed for variation in output drive and tolerance on the

  2093. 		475 ohm resistor.</p>

  2094. 	<p>A plastic film (Polypropylene, Polyethylene, Polyester, etc) or

  2095. 		C0G/NPO ceramic capacitor should be used for filtering.  Low

  2096. 		quality ceramic (X7R, Y5V, Z5U, etc) can cause signal distortion.</p>

  2097. 	<h3>Examples</h3>

  2098. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughMono

  2099. 	</p>

  2100. 	<h3>Notes</h3>

  2101. 	<p>This object only works properly when Tools &gt; CPU_Speed is set to

  2102. 		48 or 96 MHz.  Other speeds aren't supported and will likely fail

  2103. 		in strange ways.</p>

  2104. 	<p>The PWM carrier frequency is 88.2 kHz.  The suggested circuit

  2105. 		will only slightly filter the carrier.  Extra filtering will be

  2106. 		required for a clean signal without the ultrasonic PWM carrier.

  2107. 		</p>

  2108. 	<p>Analog signals created by filtering PWM waveforms use the digital

  2109. 		power supply as their reference voltage.  Any noise on the digital

  2110. 		power line can directly couple to the output signal.  The built-in DAC or

  2111. 		<a href="http://www.pjrc.com/store/teensy3_audio.html" target="_blank">audio shield</a>

  2112. 		should be used when higher quality signals are needed.</p>

  2113. </script>

  2114. <script type="text/x-red" data-template-name="AudioOutputPWM">

  2115. 	<div class="form-row">

  2116. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2117. 		<input type="text" id="node-input-name" placeholder="Name">

  2118. 	</div>

  2119. </script>

  2120. 

  2121. <script type="text/x-red" data-help-name="AudioOutputMQS">

  2122. 	<h3>Summary</h3>

  2123. 	<div class=tooltipinfo>

  2124. 	<p>Transmit 16 bit stereo audio using Medium Quality Sound pulses, usually better than PWM,

  2125. 		but not as good as a proper DAC or the audio shield.</p>

  2126. 	</div>

  2127. 	<h3>Boards Supported</h3>

  2128. 	<ul>

  2129. 	<li>Teensy 4.0

  2130. 	<li>Teensy 4.1

  2131. 	</ul>

  2132. 	<h3>Audio Connections</h3>

  2133. 	<table class=doc align=center cellpadding=3>

  2134. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2135. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  2136. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  2137. 	</table>

  2138. 	<h3>Functions</h3>

  2139. 	<p>This object has no functions to call from the Arduino sketch.  It

  2140. 		simply streams data from its 2 input ports to generate output pulses.</p>

  2141. 	<h3>Hardware</h3>

  2142. 	<table class=doc align=center cellpadding=3>

  2143. 		<tr class=top><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  2144. 		<tr class=odd><td align=center>12</td><td>Left</td><td>Output</td></tr>

  2145. 		<tr class=odd><td align=center>10</td><td>Right</td><td>Output</td></tr>

  2146. 	</table>

  2147. 	<h3>Examples</h3>

  2148. 	<h3>Notes</h3>

  2149. 	<p>TODO: can this really be used together with other inputs and outputs?</p>

  2150. </script>

  2151. <script type="text/x-red" data-template-name="AudioOutputMQS">

  2152. 	<div class="form-row">

  2153. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2154. 		<input type="text" id="node-input-name" placeholder="Name">

  2155. 	</div>

  2156. </script>

  2157. 

  2158. <script type="text/x-red" data-help-name="AudioOutputI2Sslave">

  2159. 	<h3>Summary</h3>

  2160. 	<div class=tooltipinfo>

  2161. 	<p>Transmit 16 bit stereo audio to an I2S device using I2S slave mode

  2162. 		(where the DAC or codec chip, not Teensy, controls audio timing).</p>

  2163. 	<p><span style="color:red">This input is incompatible with most other inputs and outputs</span>

  2164. 		which run at a speed controlled by Teensy's internal sample rate.</p>

  2165. 	</div>

  2166. 	<h3>Boards Supported</h3>

  2167. 	<ul>

  2168. 	<li>Teensy 3.2

  2169. 	<li>Teensy 3.5

  2170. 	<li>Teensy 3.6

  2171. 	<li>Teensy 4.0

  2172. 	<li>Teensy 4.1

  2173. 	</ul>

  2174. 	<h3>Audio Connections</h3>

  2175. 	<table class=doc align=center cellpadding=3>

  2176. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2177. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  2178. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  2179. 	</table>

  2180. 	<h3>Functions</h3>

  2181. 	<p>This object has no functions to call from the Arduino sketch.  It

  2182. 		simply streams data from its 2 input ports to the I2S hardware.</p>

  2183. 	<h3>Hardware</h3>

  2184. 	<p>The I2S signals are used in "slave" mode, where the I2S device controls

  2185. 		data timing.</p>

  2186. 	<table class=doc align=center cellpadding=3>

  2187. 		<tr class=top><th>Teensy<br>3.x Pin</th><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  2188. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Input</td></tr>

  2189. 		<tr class=odd><td align=center>22</td><td align=center>7</td><td>TX</td><td>Output</td></tr>

  2190. 		<tr class=odd><td align=center>23</td><td align=center>20</td><td>LRCLK</td><td>Input</td></tr>

  2191. 	</table>

  2192. 	<h3>Examples</h3>

  2193. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; WM8731MikroSine

  2194. 	</p>

  2195. 	<h3>Notes</h3>

  2196. 	<p>Slave mode I2S <b>should not used in the same project as ADC, DAC and

  2197. 		PWM</b> signals.  Differences in timing between the I2S device and

  2198. 		Teensy's clock can cause occasional audio glitches when I2S slave mode

  2199. 		is used together with other input or output objects based on Teensy's

  2200. 		timing.</p>

  2201. 	<p>Only one I2S input and one I2S output object may be used.  Master

  2202. 		and slave modes may not be mixed (both must be of the same type).

  2203. 	</p>

  2204. </script>

  2205. <script type="text/x-red" data-template-name="AudioOutputI2Sslave">

  2206. 	<div class="form-row">

  2207. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2208. 		<input type="text" id="node-input-name" placeholder="Name">

  2209. 	</div>

  2210. </script>

  2211. 

  2212. <script type="text/x-red" data-help-name="AudioOutputTDM">

  2213. 	<h3>Summary</h3>

  2214. 	<div class=tooltipinfo>

  2215. 	<p>Transmit a 256 bit Time Division Multiplexed frame containing

  2216. 		many audio channels.</p>

  2217. 	<p align=center><img src="img/tdm.jpg"></p>

  2218. 	</div>

  2219. 	<h3>Boards Supported</h3>

  2220. 	<ul>

  2221. 	<li>Teensy 3.2

  2222. 	<li>Teensy 3.5

  2223. 	<li>Teensy 3.6

  2224. 	<li>Teensy 4.0

  2225. 	<li>Teensy 4.1

  2226. 	</ul>

  2227. 	<h3>Audio Connections</h3>

  2228. 	<table class=doc align=center cellpadding=3>

  2229. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2230. 		<tr class=odd><td align=center>In 0</td><td>Bits 0 to 15</td></tr>

  2231. 		<tr class=odd><td align=center>In 1</td><td>Bits 16 to 31</td></tr>

  2232. 		<tr class=odd><td align=center>In 2</td><td>Bits 32 to 47</td></tr>

  2233. 		<tr class=odd><td align=center>In 3</td><td>Bits 48 to 63</td></tr>

  2234. 		<tr class=odd><td align=center>In 4</td><td>Bits 64 to 79</td></tr>

  2235. 		<tr class=odd><td align=center>In 5</td><td>Bits 80 to 95</td></tr>

  2236. 		<tr class=odd><td align=center>In 6</td><td>Bits 96 to 111</td></tr>

  2237. 		<tr class=odd><td align=center>In 7</td><td>Bits 112 to 127</td></tr>

  2238. 		<tr class=odd><td align=center>In 8</td><td>Bits 128 to 143</td></tr>

  2239. 		<tr class=odd><td align=center>In 9</td><td>Bits 144 to 159</td></tr>

  2240. 		<tr class=odd><td align=center>In 10</td><td>Bits 160 to 175</td></tr>

  2241. 		<tr class=odd><td align=center>In 11</td><td>Bits 176 to 191</td></tr>

  2242. 		<tr class=odd><td align=center>In 12</td><td>Bits 192 to 207</td></tr>

  2243. 		<tr class=odd><td align=center>In 13</td><td>Bits 208 to 223</td></tr>

  2244. 		<tr class=odd><td align=center>In 14</td><td>Bits 224 to 239</td></tr>

  2245. 		<tr class=odd><td align=center>In 15</td><td>Bits 240 to 255</td></tr>

  2246. 	</table>

  2247. 	<h3>Functions</h3>

  2248. 	<p>This object has no functions to call from the Arduino sketch.  It

  2249. 		simply streams data from its 16 input ports to the TDM hardware.</p>

  2250. 	<h3>Hardware</h3>

  2251. 	<p>TDM has been tested with this <a href="https://oshpark.com/shared_projects/2Yj6rFaW">

  2252. 		CS42448 Circuit Board</a>.

  2253. 		</p>

  2254. 	<table class=doc align=center cellpadding=3>

  2255. 		<tr class=top><th>T3.x<br>Pin</th><th>T4.x<br>Pin</th><th>Signal</th><th>Direction</th></tr>

  2256. 		<tr class=odd><td align=center>9</td><td align=center>21</td><td>BCLK</td><td>Output, 11.3 MHz</td></tr>

  2257. 		<tr class=odd><td align=center>11</td><td align=center>23</td><td>MCLK</td><td>Output, 22.6 MHz</td></tr>

  2258. 		<tr class=odd><td align=center>22</td><td align=center>7</td><td>TX</td><td>Output, 11.3 Mbit/sec</td></tr>

  2259. 		<tr class=odd><td align=center>23</td><td align=center>20</td><td>WS</td><td>Output</td></tr>

  2260. 	</table>

  2261. 	<p>Audio from

  2262. 		master mode TDM may be used in the same project as ADC, DAC and

  2263. 		PWM signals, because all remain in sync to Teensy's timing</p>

  2264. 	<h3>Examples</h3>

  2265. 	<p><a href="https://www.youtube.com/watch?v=LOnEv4EDYsk">Video Demo</a> (YouTube)

  2266. 	<h3>Notes</h3>

  2267. 	<p>Only one TDM input and one TDM output object may be used.  The

  2268. 		I2S hardware is used by TDM, so TDM objects may not be used

  2269. 		together with I2S, SPDIF or PT8211.</p>

  2270. 	<p>When used with TDM devices which receive 32 bit audio, the

  2271. 		even numbered channels are used for the top 16 bits.</p>

  2272. </script>

  2273. <script type="text/x-red" data-template-name="AudioOutputTDM">

  2274. 	<div class="form-row">

  2275. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2276. 		<input type="text" id="node-input-name" placeholder="Name">

  2277. 	</div>

  2278. </script>

  2279. 

  2280. <script type="text/x-red" data-help-name="AudioOutputTDM2">

  2281. 	<h3>Summary</h3>

  2282. 	<div class=tooltipinfo>

  2283. 	<p>Transmit a 256 bit Time Division Multiplexed frame containing

  2284. 		many audio channels, using the I2S2 port.</p>

  2285. 	</div>

  2286. 	<h3>Boards Supported</h3>

  2287. 	<ul>

  2288. 	<li>Teensy 4.0

  2289. 	<li>Teensy 4.1

  2290. 	</ul>

  2291. 	<h3>Audio Connections</h3>

  2292. 	<table class=doc align=center cellpadding=3>

  2293. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2294. 		<tr class=odd><td align=center>In 0</td><td>Bits 0 to 15</td></tr>

  2295. 		<tr class=odd><td align=center>In 1</td><td>Bits 16 to 31</td></tr>

  2296. 		<tr class=odd><td align=center>In 2</td><td>Bits 32 to 47</td></tr>

  2297. 		<tr class=odd><td align=center>In 3</td><td>Bits 48 to 63</td></tr>

  2298. 		<tr class=odd><td align=center>In 4</td><td>Bits 64 to 79</td></tr>

  2299. 		<tr class=odd><td align=center>In 5</td><td>Bits 80 to 95</td></tr>

  2300. 		<tr class=odd><td align=center>In 6</td><td>Bits 96 to 111</td></tr>

  2301. 		<tr class=odd><td align=center>In 7</td><td>Bits 112 to 127</td></tr>

  2302. 		<tr class=odd><td align=center>In 8</td><td>Bits 128 to 143</td></tr>

  2303. 		<tr class=odd><td align=center>In 9</td><td>Bits 144 to 159</td></tr>

  2304. 		<tr class=odd><td align=center>In 10</td><td>Bits 160 to 175</td></tr>

  2305. 		<tr class=odd><td align=center>In 11</td><td>Bits 176 to 191</td></tr>

  2306. 		<tr class=odd><td align=center>In 12</td><td>Bits 192 to 207</td></tr>

  2307. 		<tr class=odd><td align=center>In 13</td><td>Bits 208 to 223</td></tr>

  2308. 		<tr class=odd><td align=center>In 14</td><td>Bits 224 to 239</td></tr>

  2309. 		<tr class=odd><td align=center>In 15</td><td>Bits 240 to 255</td></tr>

  2310. 	</table>

  2311. 	<h3>Functions</h3>

  2312. 	<p>This object has no functions to call from the Arduino sketch.  It

  2313. 		simply streams data from its 16 input ports to the TDM hardware.</p>

  2314. 	<h3>Hardware</h3>

  2315. 	<table class=doc align=center cellpadding=3>

  2316. 		<tr class=top><th>Teensy<br>4.x Pin</th><th>Signal</th><th>Direction</th></tr>

  2317. 		<tr class=odd><td align=center>4</td><td>BCLK</td><td>Output, 11.3 MHz</td></tr>

  2318. 		<tr class=odd><td align=center>33</td><td>MCLK</td><td>Output, 22.6 MHz</td></tr>

  2319. 		<tr class=odd><td align=center>2</td><td>TX</td><td>Output, 11.3 Mbit/sec</td></tr>

  2320. 		<tr class=odd><td align=center>3</td><td>WS</td><td>Output</td></tr>

  2321. 	</table>

  2322. 	<!--<h3>Examples</h3>-->

  2323. 	<h3>Notes</h3>

  2324. 	<p>When used with TDM devices which receive 32 bit audio, the

  2325. 		even numbered channels are used for the top 16 bits.</p>

  2326. </script>

  2327. <script type="text/x-red" data-template-name="AudioOutputTDM2">

  2328. 	<div class="form-row">

  2329. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2330. 		<input type="text" id="node-input-name" placeholder="Name">

  2331. 	</div>

  2332. </script>

  2333. 

  2334. <script type="text/x-red" data-help-name="AudioOutputADAT">

  2335. 	<h3>Summary</h3>

  2336. 	<div class=tooltipinfo>

  2337. 	<p>Transmit ADAT TOSLINK Optical Output</p>

  2338. 	<p align=center><img src="img/adat.jpg"></p>

  2339. 	</div>

  2340. 	<h3>Boards Supported</h3>

  2341. 	<ul>

  2342. 	<li>Teensy 3.2

  2343. 	<li>Teensy 3.5

  2344. 	<li>Teensy 3.6

  2345. 	<!--<li>Teensy 4.0

  2346. 	<li>Teensy 4.1-->

  2347. 	</ul>

  2348. 	<p>ADAT output for Teensy 4.0 is discussed on

  2349. 	<a href="https://forum.pjrc.com/threads/60914?p=239824&viewfull=1#post239824">this forum thread</a>.</p>

  2350. 	<h3>Audio Connections</h3>

  2351. 	<table class=doc align=center cellpadding=3>

  2352. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2353. 		<tr class=odd><td align=center>In 0</td><td>Channel 1</td></tr>

  2354. 		<tr class=odd><td align=center>In 1</td><td>Channel 2</td></tr>

  2355. 		<tr class=odd><td align=center>In 2</td><td>Channel 3</td></tr>

  2356. 		<tr class=odd><td align=center>In 3</td><td>Channel 4</td></tr>

  2357. 		<tr class=odd><td align=center>In 4</td><td>Channel 5</td></tr>

  2358. 		<tr class=odd><td align=center>In 5</td><td>Channel 6</td></tr>

  2359. 		<tr class=odd><td align=center>In 6</td><td>Channel 7</td></tr>

  2360. 		<tr class=odd><td align=center>In 7</td><td>Channel 8</td></tr>

  2361. 	</table>

  2362. 	<h3>Functions</h3>

  2363. 	<p>This object has no functions to call from the Arduino sketch.  It

  2364. 		simply streams data from its 8 input ports to the TOSLINK output.</p>

  2365. 	<h3>Hardware</h3>

  2366. 	<table class=doc align=center cellpadding=3>

  2367. 		<tr class=top><th>Pin</th><th>Signal</th><th>Direction</th></tr>

  2368. 		<tr class=odd><td align=center>22</td><td>TX</td><td>TOSLINK Signal</td></tr>

  2369. 	</table>

  2370. 	<p>For optical TOSLINK output, this

  2371. 		<a href="https://www.oshpark.com/shared_projects/KcDBKHta" target="_blank">OSH Park board</a>

  2372. 		can be used with the inexpensive Everlight PLT133/T6A connector, available

  2373. 		at Digikey, 1080-1434-ND.

  2374. 		</p>

  2375. 	<h3>Examples</h3>

  2376. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; ADAT_DrumSamplePlayer

  2377. 	</p>

  2378. 	<h3>Notes</h3>

  2379. 	<p>ADAT output was contributed by Ernstjan Freriks.  See <a href="https://forum.pjrc.com/threads/28639-S-pdif?p=159530&viewfull=1#post159530">this forum thread</a> for details.</p>

  2380. 	<p>A <a href="https://www.youtube.com/watch?v=e5ov3q02zxo">Youtube video</a>

  2381. 		also demonstrates how it works.</p>

  2382. </script>

  2383. <script type="text/x-red" data-template-name="AudioOutputADAT">

  2384. 	<div class="form-row">

  2385. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2386. 		<input type="text" id="node-input-name" placeholder="Name">

  2387. 	</div>

  2388. </script>

  2389. 

  2390. <script type="text/x-red" data-help-name="AudioOutputUSB">

  2391. 	<h3>Summary</h3>

  2392. 	<div class=tooltipinfo>

  2393. 	<p>Send stereo audio to a PC or Mac.  Teensy appears as a USB

  2394. 		sound device.</p>

  2395. 	<p align=center><img src="img/usbtype_audio_out.png"></p>

  2396. 	</div>

  2397. 	<h3>Boards Supported</h3>

  2398. 	<ul>

  2399. 	<li>Teensy 3.2

  2400. 	<li>Teensy 3.5

  2401. 	<li>Teensy 3.6

  2402. 	<li>Teensy 4.0

  2403. 	<li>Teensy 4.1

  2404. 	</ul>

  2405. 	<h3>Audio Connections</h3>

  2406. 	<table class=doc align=center cellpadding=3>

  2407. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2408. 		<tr class=odd><td align=center>In 0</td><td>Left Channel</td></tr>

  2409. 		<tr class=odd><td align=center>In 1</td><td>Right Channel</td></tr>

  2410. 	</table>

  2411. 	<h3>Functions</h3>

  2412. 	<p>This object has no functions to call from the Arduino sketch.  It

  2413. 		simply streams from it's 2 input ports to the USB.</p>

  2414. 	<!--

  2415. 	<h3>Hardware</h3>

  2416. 	-->

  2417. 	<h3>Examples</h3>

  2418. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; WavFilePlayerUSB</p>

  2419. 	</p>

  2420. 	<h3>Notes</h3>

  2421. 	<p>Arduino's <b>Tools &gt; USB Type</b> menu must be set to <b>Audio</b>.

  2422. 		</p>

  2423. 	<p align=center><img src="img/usbtype_audio.png"></p>

  2424. 	<p>USB input &amp; output does not cause the Teensy Audio Library to

  2425. 		update.  At least one non-USB input or output object must be

  2426. 		present for the entire library to update properly.</p>

  2427. 	<p>A known problem exists with USB audio from Macintosh computers.

  2428. 		An imperfect <a href="https://forum.pjrc.com/threads/34855-Distorted-audio-when-using-USB-input-on-Teensy-3-1?p=110392&viewfull=1#post110392">workaround

  2429. 		can be enabled by editing usb_audio.cpp</a>.

  2430. 		Find and uncomment "#define MACOSX_ADAPTIVE_LIMIT".</p>

  2431. </script>

  2432. <script type="text/x-red" data-template-name="AudioOutputUSB">

  2433. 	<div class="form-row">

  2434. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2435. 		<input type="text" id="node-input-name" placeholder="Name">

  2436. 	</div>

  2437. </script>

  2438. 

  2439. <script type="text/x-red" data-help-name="AudioAmplifier">

  2440. 	<h3>Summary</h3>

  2441. 	<div class=tooltipinfo>

  2442. 	<p>Amplify or attenuate a signal, or switch it on/off.

  2443. 		</p>

  2444. 	<p align=center><img src="img/ampschematics.png"></p>

  2445. 	</div>

  2446. 	<h3>Audio Connections</h3>

  2447. 	<table class=doc align=center cellpadding=3>

  2448. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2449. 		<tr class=odd><td align=center>In 0</td><td>Input signal</td></tr>

  2450. 		<tr class=odd><td align=center>Out 0</td><td>Amplified/Attn. Output</td></tr>

  2451. 	</table>

  2452. 	<h3>Functions</h3>

  2453. 	<p class=func><span class=keyword>gain</span>(level);</p>

  2454. 	<p class=desc>Adjust the amplification or attenuation.

  2455. 		"level" may be any floating point number from 0 to 32767.0.

  2456. 		1.0 passes the signal through directly.  Level of 0 shuts the channel

  2457. 		off completely.  Between 0 to 1.0 attenuates the signal, and above

  2458. 		1.0 amplifies it.  Negative numbers may also be used, to invert the

  2459. 		signal.

  2460. 	</p>

  2461. 	<!--<h3>Examples</h3>

  2462. 	<p class=exam>File &gt; Examples &gt; Audio &gt; SamplePlayer

  2463. 	</p>-->

  2464. 	<h3>Notes</h3>

  2465. 	<p>Gain of 0 and 1.0 are handled efficiently as special cases.  Zero

  2466. 		discards data without processing.  1.0 passes data directly, with

  2467. 		minimal overhead</p>

  2468. 	<p>Signal clipping can occur when any channel has gain greater than 1.0</p>

  2469. </script>

  2470. <script type="text/x-red" data-template-name="AudioAmplifier">

  2471. 	<div class="form-row">

  2472. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2473. 		<input type="text" id="node-input-name" placeholder="Name">

  2474. 	</div>

  2475. </script>

  2476. 

  2477. <script type="text/x-red" data-help-name="AudioMixer4">

  2478. 	<h3>Summary</h3>

  2479. 	<div class=tooltipinfo>

  2480. 	<p>Combine up to 4 audio signals together, each with adjustable gain.

  2481. 		All channels support signal attenuation or amplification.</p>

  2482. 	</div>

  2483. 	<h3>Audio Connections</h3>

  2484. 	<table class=doc align=center cellpadding=3>

  2485. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2486. 		<tr class=odd><td align=center>In 0</td><td>Input signal #1</td></tr>

  2487. 		<tr class=odd><td align=center>In 1</td><td>Input signal #2</td></tr>

  2488. 		<tr class=odd><td align=center>In 2</td><td>Input signal #3</td></tr>

  2489. 		<tr class=odd><td align=center>In 3</td><td>Input signal #4</td></tr>

  2490. 		<tr class=odd><td align=center>Out 0</td><td>Sum of all inputs</td></tr>

  2491. 	</table>

  2492. 	<h3>Functions</h3>

  2493. 	<p class=func><span class=keyword>gain</span>(channel, level);</p>

  2494. 	<p class=desc>Adjust the amplification or attenuation.  "channel" must

  2495. 		be 0 to 3.  "level" may be any floating point number from 0 to 32767.0.

  2496. 		1.0 passes the signal through directly.  Level of 0 shuts the channel

  2497. 		off completely.  Between 0 to 1.0 attenuates the signal, and above

  2498. 		1.0 amplifies it.  Negative numbers may also be used, to invert the

  2499. 		signal.  All 4 channels have separate gain settings.

  2500. 	</p>

  2501. 	<h3>Examples</h3>

  2502. 	<p class=exam>File &gt; Examples &gt; Audio &gt; SamplePlayer

  2503. 	</p>

  2504. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; PlaySynthMusic

  2505. 	</p>

  2506. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; SpectrumAnalyzerBasic

  2507. 	</p>

  2508. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; DialTone_Serial

  2509. 	</p>

  2510. 	<p class=exam>File &gt; Examples &gt; Audio &gt; MemoryAndCpuUsage

  2511. 	</p>

  2512. 	<h3>Notes</h3>

  2513. 	<p>Signal clipping can occur when any channel has gain greater than 1.0,

  2514. 		or when multiple signals add together to greater than 1.0.</p>

  2515. 	<p>More than 4 channels may be combined by connecting multiple mixers

  2516. 		in tandem.  For example, a 16 channel mixer may be built using 5

  2517. 		mixers, where the fifth mixer combines the outputs of the first 4.

  2518. 	</p>

  2519. </script>

  2520. <script type="text/x-red" data-template-name="AudioMixer4">

  2521. 	<div class="form-row">

  2522. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2523. 		<input type="text" id="node-input-name" placeholder="Name">

  2524. 	</div>

  2525. </script>

  2526. 

  2527. <script type="text/x-red" data-help-name="AudioPlayMemory">

  2528. 	<h3>Summary</h3>

  2529. 	<div class=tooltipinfo>

  2530. 	<p>Play a short sound clip, stored directly in memory.

  2531. 		Data files are created with the

  2532. 		<a href="https://github.com/PaulStoffregen/Audio/tree/master/extras/wav2sketch" target="_blank">wav2sketch program</a>,

  2533. 		and copied to the sketch folder to become part of your sketch.</p>

  2534. 	</div>

  2535. 	<h3>Audio Connections</h3>

  2536. 	<table class=doc align=center cellpadding=3>

  2537. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2538. 		<tr class=odd><td align=center>Out 0</td><td>Sound Output</td></tr>

  2539. 	</table>

  2540. 	<h3>Functions</h3>

  2541. 	<p class=func><span class=keyword>play</span>(data);</p>

  2542. 	<p class=desc>Begin playing a sound clip.  If already playing, the

  2543. 		currently playing clip is stopped and this new data begins

  2544. 		playing from the beginning.

  2545. 	</p>

  2546. 	<p class=func><span class=keyword>stop</span>();</p>

  2547. 	<p class=desc>Stop playing.  If not playing, this function has no effect.

  2548. 	</p>

  2549. 	<p class=func><span class=keyword>isPlaying</span>();</p>

  2550. 	<p class=desc>Return true (non-zero) if playing, or false (zero)

  2551. 		when not playing.

  2552. 	</p>

  2553. 	<p class=func><span class=keyword>positionMillis</span>();</p>

  2554. 	<p class=desc>While playing, return the current time offset, in

  2555. 		milliseconds.  When not playing, the return from this function

  2556. 		is undefined.

  2557. 	</p>

  2558. 	<p class=func><span class=keyword>lengthMillis</span>();</p>

  2559. 	<p class=desc>Return the total length of the current sound clip,

  2560. 		in milliseconds.  When not playing, the return from this function

  2561. 		is undefined.

  2562. 	</p>

  2563. 	<h3>Examples</h3>

  2564. 	<p class=exam>File &gt; Examples &gt; Audio &gt; SamplePlayer

  2565. 	</p>

  2566. 	<h3>Notes</h3>

  2567. 	<p><a href="https://forum.pjrc.com/threads/42401-Instructions-or-tutorials-for-using-wav2sketch?p=135069&viewfull=1#post135069">Step by step instructions for wav2sketch</a>

  2568. 		running in Terminal on Macintosh.</p>

  2569. 	<p><a href="https://www.pjrc.com/teensy/td_libs_AudioPlayMemory.html">Old documentation about wav2sketch</a>

  2570. 		is still available, including details about the data format.</p>

  2571. 	<p>TODO: supported sample rates: 11.025, 22.05, 44.1</p>

  2572. 	<p>TODO: ulaw vs uncompressed encoding</p>

  2573. 	<p>Polyphonic playback can be built by creating multiple

  2574. 		objects, with their output combined by mixers.</p>

  2575. </script>

  2576. <script type="text/x-red" data-template-name="AudioPlayMemory">

  2577. 	<div class="form-row">

  2578. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2579. 		<input type="text" id="node-input-name" placeholder="Name">

  2580. 	</div>

  2581. </script>

  2582. 

  2583. <script type="text/x-red" data-help-name="AudioPlaySdWav">

  2584. 	<h3>Summary</h3>

  2585. 	<div class=tooltipinfo>

  2586. 	<p>Play a WAV file, stored on a SD card.</p>

  2587. 	</div>

  2588. 	<h3>Audio Connections</h3>

  2589. 	<table class=doc align=center cellpadding=3>

  2590. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2591. 		<tr class=odd><td align=center>Out 0</td><td>Left Channel Output</td></tr>

  2592. 		<tr class=odd><td align=center>Out 1</td><td>Right Channel Output</td></tr>

  2593. 	</table>

  2594. 	<h3>Functions</h3>

  2595. 	<p class=func><span class=keyword>play</span>(filename);</p>

  2596. 	<p class=desc>Begin playing a WAV file.  If a file is already playing,

  2597. 		it is stopped and this file starts playing from the beginning.

  2598. 	</p>

  2599. 	<p class=func><span class=keyword>stop</span>();</p>

  2600. 	<p class=desc>Stop playing.  If not playing, this function has no effect.

  2601. 	</p>

  2602. 	<p class=func><span class=keyword>isPlaying</span>();</p>

  2603. 	<p class=desc>Return true (non-zero) if playing, or false (zero)

  2604. 		when not playing.  See the note below about delayed start.

  2605. 	</p>

  2606. 	<p class=func><span class=keyword>positionMillis</span>();</p>

  2607. 	<p class=desc>While playing, return the current time offset, in

  2608. 		milliseconds.  When not playing, the return from this function

  2609. 		is undefined.

  2610. 	</p>

  2611. 	<p class=func><span class=keyword>lengthMillis</span>();</p>

  2612. 	<p class=desc>Return the total length of the current sound clip,

  2613. 		in milliseconds.  When not playing, the return from this function

  2614. 		is undefined.

  2615. 	</p>

  2616. 	<h3>Examples</h3>

  2617. 	<p class=exam>File &gt; Examples &gt; Audio &gt; WavFilePlayer

  2618. 	</p>

  2619. 	<h3>Notes</h3>

  2620. 	<p>Only 16 bit PCM, 44100 Hz WAV files are supported.  When mono

  2621. 		files are played, both output ports transmit a copy of the

  2622. 		single sound.  Of course, stereo WAV files play with the left

  2623. 		channel on port 0 and the right channel on port 1.

  2624. 	</p>

  2625. 	<p>A brief delay after calling play() will usually occur before

  2626. 		isPlaying() returns true and positionMillis() returns valid

  2627. 		time offset.  WAV files have a header at the beginning of the

  2628. 		file, which the audio library must read and parse before

  2629. 		playing can begin.

  2630. 	</p>

  2631. 	<p>While playing, the audio library accesses the SD card automatically.

  2632. 		If card access is required, you must

  2633. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">use AudioNoInterrupts()</a>

  2634. 		to prevent the library from accessing the SD card while you use it.

  2635. 		Disabling the audio library interrupt for too long may cause audible

  2636. 		dropouts or glitches.

  2637. 	</p>

  2638. 	<p>An experimental SD library optimization exists, which can remove these

  2639. 		SD library restrictions.  It also allows reliable playback of more

  2640. 		files at the same time.  To enable this special code, find and edit

  2641. 		the SD_t3.h file within your Arduino folder.  See the comments within

  2642. 		that file for details.

  2643. 	</p>

  2644. 

  2645. </script>

  2646. <script type="text/x-red" data-template-name="AudioPlaySdWav">

  2647. 	<div class="form-row">

  2648. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2649. 		<input type="text" id="node-input-name" placeholder="Name">

  2650. 	</div>

  2651. </script>

  2652. 

  2653. <script type="text/x-red" data-help-name="AudioPlaySdRaw">

  2654. 	<h3>Summary</h3>

  2655. 	<div class=tooltipinfo>

  2656. 	<p>Play a RAW data file, stored on a SD card.  RAW format is simpler

  2657. 		than WAV and begins playing immediately, without parsing WAV file

  2658. 		header info.</p>

  2659. 	</div>

  2660. 	<h3>Audio Connections</h3>

  2661. 	<table class=doc align=center cellpadding=3>

  2662. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2663. 		<tr class=odd><td align=center>Out 0</td><td>Sound Output</td></tr>

  2664. 	</table>

  2665. 	<h3>Functions</h3>

  2666. 	<p class=func><span class=keyword>play</span>(filename);</p>

  2667. 	<p class=desc>Begin playing a RAW data file.  If a file is already playing,

  2668. 		it is stopped and this file starts playing from the beginning.

  2669. 	</p>

  2670. 	<p class=func><span class=keyword>stop</span>();</p>

  2671. 	<p class=desc>Stop playing.  If not playing, this function has no effect.

  2672. 	</p>

  2673. 	<p class=func><span class=keyword>isPlaying</span>();</p>

  2674. 	<p class=desc>Return true (non-zero) if playing, or false (zero)

  2675. 		when not playing.

  2676. 	</p>

  2677. 	<p class=func><span class=keyword>positionMillis</span>();</p>

  2678. 	<p class=desc>While playing, return the current time offset, in

  2679. 		milliseconds.  When not playing, the return from this function

  2680. 		is undefined.

  2681. 	</p>

  2682. 	<p class=func><span class=keyword>lengthMillis</span>();</p>

  2683. 	<p class=desc>Return the total length of the current sound clip,

  2684. 		in milliseconds.  When not playing, the return from this function

  2685. 		is undefined.

  2686. 	</p>

  2687. 	<h3>Examples</h3>

  2688. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Recorder

  2689. 	</p>

  2690. 	<h3>Notes</h3>

  2691. 	<p>The data file must be RAW 16 bit signed integers in LSB-first format.

  2692. 	</p>

  2693. 	<p>While playing, the audio library accesses the SD card automatically.

  2694. 		If card access is required, you must

  2695. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a>

  2696. 		to prevent the library from accessing the SD card while you use it.

  2697. 		Disabling the audio library interrupt for too long may cause audible

  2698. 		dropouts or glitches.

  2699. 	</p>

  2700. </script>

  2701. <script type="text/x-red" data-template-name="AudioPlaySdRaw">

  2702. 	<div class="form-row">

  2703. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2704. 		<input type="text" id="node-input-name" placeholder="Name">

  2705. 	</div>

  2706. </script>

  2707. 

  2708. <script type="text/x-red" data-help-name="AudioPlaySerialflashRaw">

  2709. 	<h3>Summary</h3>

  2710. 	<div class=tooltipinfo>

  2711. 	<p>Play a RAW data file, stored on a Serial Flash chip.  These chips

  2712. 		are far more efficient than SD cards, allowing many files to be

  2713. 		played simultaneously by copies of this object.

  2714. 		</p>

  2715. 	<p align=center><img src="img/w25q128fv.jpg"><br><small>W25Q128FV Serial Flash</small></p>

  2716. 	</div>

  2717. 	<h3>Audio Connections</h3>

  2718. 	<table class=doc align=center cellpadding=3>

  2719. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2720. 		<tr class=odd><td align=center>Out 0</td><td>Sound Output</td></tr>

  2721. 	</table>

  2722. 	<h3>Functions</h3>

  2723. 	<p class=func><span class=keyword>play</span>(filename);</p>

  2724. 	<p class=desc>Begin playing a RAW data file.  If a file is already playing,

  2725. 		it is stopped and this file starts playing from the beginning.

  2726. 	</p>

  2727. 	<p class=func><span class=keyword>stop</span>();</p>

  2728. 	<p class=desc>Stop playing.  If not playing, this function has no effect.

  2729. 	</p>

  2730. 	<p class=func><span class=keyword>isPlaying</span>();</p>

  2731. 	<p class=desc>Return true (non-zero) if playing, or false (zero)

  2732. 		when not playing.

  2733. 	</p>

  2734. 	<p class=func><span class=keyword>positionMillis</span>();</p>

  2735. 	<p class=desc>While playing, return the current time offset, in

  2736. 		milliseconds.  When not playing, the return from this function

  2737. 		is undefined.

  2738. 	</p>

  2739. 	<p class=func><span class=keyword>lengthMillis</span>();</p>

  2740. 	<p class=desc>Return the total length of the current sound clip,

  2741. 		in milliseconds.  When not playing, the return from this function

  2742. 		is undefined.

  2743. 	</p>

  2744. 	<h3>Examples</h3>

  2745. 	<!--

  2746. <p class=exam>File &gt; Examples &gt; Audio &gt; Recorder

  2747. -->

  2748. 	<p class=exam>TODO: play example needed....

  2749. 	</p>

  2750. 	<p class=exam>File &gt; Examples &gt; SerialFlash &gt; CopyFromSD

  2751. 	</p>

  2752. 	<h3>Notes</h3>

  2753. 	<p>The data file must be RAW 16 bit signed integers in LSB-first format.

  2754. 	</p>

  2755. 	<p>The <a href="https://github.com/PaulStoffregen/SerialFlash" target="_blank">SerialFlash library</a>

  2756. 		is used to access the flash chip.  You can also use SerialFlash's functions

  2757. 		to access the stored files, or add data to the flash chip.

  2758. 	</p>

  2759. 	<p>File names are case sensitive with SerialFlash.  If your sound does

  2760. 		not play, use <b>File &gt; Examples &gt; SerialFlash &gt; ListFiles</b> to

  2761. 		check the exact file names stored in the flash memory chip.

  2762. </script>

  2763. <script type="text/x-red" data-template-name="AudioPlaySerialflashRaw">

  2764. 	<div class="form-row">

  2765. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2766. 		<input type="text" id="node-input-name" placeholder="Name">

  2767. 	</div>

  2768. </script>

  2769. 

  2770. <script type="text/x-red" data-help-name="AudioPlayQueue">

  2771. 	<h3>Summary</h3>

  2772. 	<div class=tooltipinfo>

  2773. 	<p>Play audio data provided by the Arduino sketch.  This object provides

  2774. 		functions to allow the sketch code to push data into the audio system.</p>

  2775. 	</div>

  2776. 	<h3>Audio Connections</h3>

  2777. 	<table class=doc align=center cellpadding=3>

  2778. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2779. 		<tr class=odd><td align=center>Out 0</td><td>Sound Output</td></tr>

  2780. 	</table>

  2781. 	<h3>Functions</h3>

  2782. 	<p class=func><span class=keyword>play</span>(int16);</p>

  2783. 	<p class=desc>not yet implemented

  2784. 	</p>

  2785. 	<p class=func><span class=keyword>play</span>(int16[], length);</p>

  2786. 	<p class=desc>not yet implemented

  2787. 	</p>

  2788. 	<p class=func><span class=keyword>getBuffer</span>();</p>

  2789. 	<p class=desc>Returns a pointer to an array of 128 int16.  This buffer

  2790. 		is within the audio library memory pool, providing the most efficient

  2791. 		way to input data to the audio system.  The buffer is likely to be

  2792. 		populated by previously used data, so the entire 128 words should be

  2793. 		written before calling playBuffer().  Only a single buffer should be

  2794. 		requested at a time.  This function may return NULL if no memory is

  2795. 		available.

  2796. 	</p>

  2797. 	<p class=func><span class=keyword>playBuffer</span>();</p>

  2798. 	<p class=desc>Transmit the buffer previously obtained from getBuffer().

  2799. 	</p>

  2800. 	<h3>Examples</h3>

  2801. 		<p><a href="http://community.arm.com/groups/embedded/blog/2014/05/23/led-video-panel-at-maker-faire-2014" target="_blank">4320 LED Video+Sound Project</a>

  2802. 		</p>

  2803. 	<!--

  2804. <p class=exam>File &gt; Examples &gt; Audio &gt;

  2805. 	</p>

  2806. -->

  2807. 	<h3>Notes</h3>

  2808. 	<p>TODO: many caveats....</p>

  2809. 	<p>

  2810. 	</p>

  2811. </script>

  2812. <script type="text/x-red" data-template-name="AudioPlayQueue">

  2813. 	<div class="form-row">

  2814. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2815. 		<input type="text" id="node-input-name" placeholder="Name">

  2816. 	</div>

  2817. </script>

  2818. 

  2819. <script type="text/x-red" data-help-name="AudioRecordQueue">

  2820. 	<h3>Summary</h3>

  2821. 	<div class=tooltipinfo>

  2822. 	<p>Record audio data by sending to the Arduino sketch.  This object allows

  2823. 		sketch code to receive audio packets.</p>

  2824. 	</div>

  2825. 	<h3>Audio Connections</h3>

  2826. 	<table class=doc align=center cellpadding=3>

  2827. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2828. 		<tr class=odd><td align=center>In 0</td><td>Sound To Access</td></tr>

  2829. 	</table>

  2830. 	<h3>Functions</h3>

  2831. 	<p class=func><span class=keyword>begin</span>();</p>

  2832. 	<p class=desc>Begin capturing incoming audio to the queue.  After calling

  2833. 		begin, readBuffer() and freeBuffer(), or clear() must be used frequently

  2834. 		to prevent the queue from filling up.

  2835. 	</p>

  2836. 	<p class=func><span class=keyword>available</span>();</p>

  2837. 	<p class=desc>Returns the number of audio packets available to read.

  2838. 	</p>

  2839. 	<p class=func><span class=keyword>readBuffer</span>();</p>

  2840. 	<p class=desc>Read a single audio packet.  A pointer to a 128 sample

  2841. 		array of 16 bit integers is returned.  NULL is returned if no packets

  2842. 		are available.

  2843. 	</p>

  2844. 	<p class=func><span class=keyword>freeBuffer</span>();</p>

  2845. 	<p class=desc>Release the memory from the previously read packet returned

  2846. 		from readBuffer().  Only a single packet at a time may be read, and

  2847. 		each packet must be freed with this function, to return the memory to

  2848. 		the audio library.

  2849. 	</p>

  2850. 	<p class=func><span class=keyword>clear</span>();</p>

  2851. 	<p class=desc>Discard all audio held in the queue.

  2852. 	</p>

  2853. 	<p class=func><span class=keyword>end</span>();</p>

  2854. 	<p class=desc>Stop capturing incoming audio into the queue.  Data already

  2855. 		captured remains in the queue and may be read with readBuffer().

  2856. 	</p>

  2857. 	<h3>Examples</h3>

  2858. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Recorder

  2859. 	</p>

  2860. 	<h3>Notes</h3>

  2861. 	<p>

  2862. 		Up to 52 packets may be queued by this object, which allows approximately

  2863. 		150 ms of audio to be held in the queue, to allow time for the Arduino

  2864. 		sketch to write data to media or do other high-latency tasks.

  2865. 

  2866. The actual packets are taken

  2867. 		from the pool created by AudioMemory().

  2868. 	</p>

  2869. </script>

  2870. <script type="text/x-red" data-template-name="AudioRecordQueue">

  2871. 	<div class="form-row">

  2872. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2873. 		<input type="text" id="node-input-name" placeholder="Name">

  2874. 	</div>

  2875. </script>

  2876. 

  2877. 

  2878. <script type="text/x-red" data-help-name="AudioSynthWavetable">

  2879. 	<h3>Summary</h3>

  2880. 	<div class=tooltipinfo>

  2881. 	<p>Synthesize musical instruments using wavetable samples.

  2882. 		Sample data is extracted from SoundFont2 files.

  2883. 		</p>

  2884. 	<p align=center><a href="https://www.youtube.com/watch?v=5laaNHLhS98">YouTube Video Demo</a><br>

  2885. 		<a href="https://www.youtube.com/watch?v=5laaNHLhS98"><img border=0 src="img/wavetablevideo.jpg"></a>

  2886. 		</p>

  2887. 	<p><small>

  2888. 		Portland State University capstone project by

  2889. 		Ryan Mellmer, Nicholas Craig, Joshua Bucklin, Aida Keifer,

  2890. 		Jonathan Jensen, Yu Tang, &amp; Connor Delaplane.

  2891. 	</small></p>

  2892. 	</div>

  2893. 	<h3>Audio Connections</h3>

  2894. 	<table class=doc align=center cellpadding=3>

  2895. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2896. 		<tr class=odd><td align=center>Out 0</td><td>Output</td></tr>

  2897. 	</table>

  2898. 	<h3>Functions</h3>

  2899. 	<p class=func><span class=keyword>setInstrument</span>(instrument);</p>

  2900. 	<p class=desc>blah blah

  2901. 	</p>

  2902. 	<p class=func><span class=keyword>amplitude</span>(volume);</p>

  2903. 	<p class=desc>blah blah

  2904. 	</p>

  2905. 	<p class=func><span class=keyword>setFrequency</span>(freq);</p>

  2906. 	<p class=desc>blah blah

  2907. 	</p>

  2908. 	<p class=func><span class=keyword>playFrequency</span>(freq, amplitude);</p>

  2909. 	<p class=desc>blah blah

  2910. 	</p>

  2911. 	<p class=func><span class=keyword>stop</span>();</p>

  2912. 	<p class=desc>blah blah

  2913. 	</p>

  2914. 	<p class=func><span class=keyword>isPlaying</span>();</p>

  2915. 	<p class=desc>blah blah

  2916. 	</p>

  2917. 	<p class=func><span class=keyword>getEnvState</span>();</p>

  2918. 	<p class=desc>blah blah

  2919. 	</p>

  2920. 	<h3>Examples</h3>

  2921. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; Wavetable &gt; MidiSynth

  2922. 	</p>

  2923. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; Wavetable &gt; MidiSynthKeyboard

  2924. 	</p>

  2925. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; Wavetable &gt; MidiSynthLarge

  2926. 	</p>

  2927. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; Wavetable &gt; SimpleWavetable

  2928. 	</p>

  2929. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; Wavetable &gt; Zelda

  2930. 	</p>

  2931. 	<h3>Notes</h3>

  2932. 	<p></p>

  2933. </script>

  2934. <script type="text/x-red" data-template-name="AudioSynthWavetable">

  2935. 	<div class="form-row">

  2936. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2937. 		<input type="text" id="node-input-name" placeholder="Name">

  2938. 	</div>

  2939. </script>

  2940. 

  2941. 

  2942. <script type="text/x-red" data-help-name="AudioSynthSimpleDrum">

  2943. 	<h3>Summary</h3>

  2944. 	<div class=tooltipinfo>

  2945. 	<p>Generate a synthesised drum sound.  Also useful for laser pistol and bursting

  2946. 		bubble sound effects.</p>

  2947. 	</div>

  2948. 	<h3>Audio Connections</h3>

  2949. 	<table class=doc align=center cellpadding=3>

  2950. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2951. 		<tr class=odd><td align=center>Out 0</td><td>Drum Tone Output</td></tr>

  2952. 	</table>

  2953. 	<h3>Functions</h3>

  2954. 	<p class=func><span class=keyword>noteOn</span>();</p>

  2955. 	<p class=desc>Trigger the drum.

  2956. 	</p>

  2957. 	<p class=func><span class=keyword>frequency</span>(frequency);</p>

  2958. 	<p class=desc>Set the base frequency of the drum.

  2959. 	</p>

  2960. 	<p class=func><span class=keyword>length</span>(milliseconds);</p>

  2961. 	<p class=desc>Set the duration of the envelope, in milliseconds.

  2962. 	</p>

  2963. 	<p class=func><span class=keyword>secondMix</span>(level);</p>

  2964. 	<p class=desc>Emulates a two-headed tom, by adding a second sine wave that is

  2965. 	harmonized a perfect fifth above

  2966. 	the base frequency.  Using this involves a slight CPU penalty.

  2967. 	</p>

  2968. 	<p class=func><span class=keyword>pitchMod</span>(depth);</p>

  2969. 	<p class=desc>Set the depth of envelope of the pitch, by a maximum of two octaves.

  2970. 	Default is 0.5, with no modulation.  Values above 0.5 cause the pitch to sweep

  2971. 	downwards, values lower than 0.5 cause the pitch to sweep upwards.

  2972. 	</p>

  2973. 	<h3>Examples</h3>

  2974. 	<p class=exam>File &gt; Examples &gt; Synthesis &gt; SimpleDrum

  2975. 	</p>

  2976. 	<h3>Notes</h3>

  2977. 	<p></p>

  2978. </script>

  2979. <script type="text/x-red" data-template-name="AudioSynthSimpleDrum">

  2980. 	<div class="form-row">

  2981. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  2982. 		<input type="text" id="node-input-name" placeholder="Name">

  2983. 	</div>

  2984. </script>

  2985. 

  2986. <script type="text/x-red" data-help-name="AudioSynthKarplusStrong">

  2987. 	<h3>Summary</h3>

  2988. 	<div class=tooltipinfo>

  2989. 	<p>Synthesize a plucked string sound, such as a guitar string.

  2990. 		</p>

  2991. 	<p align=center><img src="img/touchguitar.jpg"></p>

  2992. 	</div>

  2993. 	<h3>Audio Connections</h3>

  2994. 	<table class=doc align=center cellpadding=3>

  2995. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  2996. 		<tr class=odd><td align=center>Out 0</td><td>Sound Output</td></tr>

  2997. 	</table>

  2998. 	<h3>Functions</h3>

  2999. 	<p class=func><span class=keyword>noteOn</span>(frequency, velocity);</p>

  3000. 	<p class=desc>Begin a new string note.  Velocity can be from 0 to 1.0,

  3001. 		indicating how hard the string is plucked.

  3002. 	</p>

  3003. 	<p class=func><span class=keyword>noteOff</span>(velocity);</p>

  3004. 	<p class=desc>Stop the sound output.

  3005. 	</p>

  3006. 	<h3>Examples</h3>

  3007. 	<p class=exam>File &gt; Examples &gt; Synthesis &gt; Guitar

  3008. 	</p>

  3009. 	<p class=exam><a href="https://github.com/PaulStoffregen/TouchGuitar" target="_blank">TouchGuitar</a>

  3010. 	</p>

  3011. 	<h3>Notes</h3>

  3012. 	<p></p>

  3013. </script>

  3014. <script type="text/x-red" data-template-name="AudioSynthKarplusStrong">

  3015. 	<div class="form-row">

  3016. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3017. 		<input type="text" id="node-input-name" placeholder="Name">

  3018. 	</div>

  3019. </script>

  3020. 

  3021. <script type="text/x-red" data-help-name="AudioSynthWaveformSine">

  3022. 	<h3>Summary</h3>

  3023. 	<div class=tooltipinfo>

  3024. 	<p>Create a sine wave signal</p>

  3025. 	</div>

  3026. 	<h3>Audio Connections</h3>

  3027. 	<table class=doc align=center cellpadding=3>

  3028. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3029. 		<tr class=odd><td align=center>Out 0</td><td>Sine Wave Output</td></tr>

  3030. 	</table>

  3031. 	<h3>Functions</h3>

  3032. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3033. 	<p class=desc>Set the amplitude, from 0 to 1.0.

  3034. 	</p>

  3035. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  3036. 	<p class=desc>Set the frequency, from 0 to 22000.  Very low values may

  3037. 		be used to create a LFO (Low Frequency Oscillator) for objects

  3038. 		with modulation signal inputs.

  3039. 	</p>

  3040. 	<p class=func><span class=keyword>phase</span>(angle);</p>

  3041. 	<p class=desc>

  3042. 		Cause the generated waveform to jump to a specific point within

  3043. 		its cycle.  Angle is from 0 to 360 degrees.  When multiple objects

  3044. 		are configured,

  3045. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a>

  3046. 		should be used to guarantee all new settings take effect together.

  3047. 	</p>

  3048. 	<h3>Examples</h3>

  3049. 	<p class=exam>File &gt; Examples &gt; Audio &gt; MemoryAndCpuUsage

  3050. 	</p>

  3051. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; DialTone_Serial

  3052. 	</p>

  3053. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; FFT

  3054. 	</p>

  3055. 	<h3>Notes</h3>

  3056. 	<p></p>

  3057. </script>

  3058. <script type="text/x-red" data-template-name="AudioSynthWaveformSine">

  3059. 	<div class="form-row">

  3060. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3061. 		<input type="text" id="node-input-name" placeholder="Name">

  3062. 	</div>

  3063. </script>

  3064. 

  3065. <script type="text/x-red" data-help-name="AudioSynthWaveformSineHires">

  3066. 	<h3>Summary</h3>

  3067. 	<div class=tooltipinfo>

  3068. 	<p>Create a highly precise, low distortion sine wave signal.

  3069. 		Mainly useful for codec &amp; analog circuitry testing.</p>

  3070. 	</div>

  3071. 	<h3>Audio Connections</h3>

  3072. 	<table class=doc align=center cellpadding=3>

  3073. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3074. 		<tr class=odd><td align=center>Out 0</td><td>Sine Wave, upper bits</td></tr>

  3075. 		<tr class=odd><td align=center>Out 1</td><td>Sine Wave, lower bits</td></tr>

  3076. 	</table>

  3077. 	<h3>Functions</h3>

  3078. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3079. 	<p class=desc>Set the amplitude, from 0 to 1.0.

  3080. 	</p>

  3081. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  3082. 	<p class=desc>Set the frequency, from 0 to 22000.  Very low values may

  3083. 		be used to create a LFO (Low Frequency Oscillator) for objects

  3084. 		with modulation signal inputs.

  3085. 	</p>

  3086. 	<p class=func><span class=keyword>phase</span>(angle);</p>

  3087. 	<p class=desc>

  3088. 		Cause the generated waveform to jump to a specific point within

  3089. 		its cycle.  Angle is from 0 to 360 degrees.  When multiple objects

  3090. 		are configured,

  3091. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a>

  3092. 		should be used to guarantee all new settings take effect together.

  3093. 	</p>

  3094. 	<h3>Notes</h3>

  3095. 	<p>An 11th order Taylor series approximation is used to generate

  3096. 		a very accurate sine wave.  At least the upper 25 bits are believe

  3097. 		to be perfect.  This is mainly intended for testing 24 bit codec chips!</p>

  3098. </script>

  3099. <script type="text/x-red" data-template-name="AudioSynthWaveformSineHires">

  3100. 	<div class="form-row">

  3101. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3102. 		<input type="text" id="node-input-name" placeholder="Name">

  3103. 	</div>

  3104. </script>

  3105. 

  3106. <script type="text/x-red" data-help-name="AudioSynthWaveformSineModulated">

  3107. 	<h3>Summary</h3>

  3108. 	<div class=tooltipinfo>

  3109. 	<p>Create a modulated sine wave, using any audio signal to continuously

  3110. 		modulate the sine wave frequency.</p>

  3111. 	</div>

  3112. 	<h3>Audio Connections</h3>

  3113. 	<table class=doc align=center cellpadding=3>

  3114. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3115. 		<tr class=odd><td align=center>In 0</td><td>Modulation Signal</td></tr>

  3116. 		<tr class=odd><td align=center>Out 0</td><td>Sine Wave Output</td></tr>

  3117. 	</table>

  3118. 	<h3>Functions</h3>

  3119. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3120. 	<p class=desc>Set the amplitude, from 0 to 1.0.

  3121. 	</p>

  3122. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  3123. 	<p class=desc>Set the center frequency, from 0 to 11000.  The output will

  3124. 		be this center frequency when the input modulation signal is zero.

  3125. 		Modulation input 1.0 causes the frequency to double, and input -1.0

  3126. 		causes zero Hz (DC) output.  For less modulation, attenuate the input

  3127. 		signal (perhaps with a mixer object) before it arrives here.

  3128. 	</p>

  3129. 	<p class=func><span class=keyword>phase</span>(angle);</p>

  3130. 	<p class=desc>

  3131. 		Cause the generated waveform to jump to a specific point within

  3132. 		its cycle.  Angle is from 0 to 360 degrees.  When multiple objects

  3133. 		are configured,

  3134. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a>

  3135. 		should be used to guarantee all new settings take effect together.

  3136. 	</p>

  3137. 	<!--

  3138. <h3>Examples</h3>

  3139. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  3140. 	</p>

  3141. -->

  3142. 	<h3>Notes</h3>

  3143. 	<p></p>

  3144. </script>

  3145. <script type="text/x-red" data-template-name="AudioSynthWaveformSineModulated">

  3146. 	<div class="form-row">

  3147. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3148. 		<input type="text" id="node-input-name" placeholder="Name">

  3149. 	</div>

  3150. </script>

  3151. 

  3152. <script type="text/x-red" data-help-name="AudioSynthWaveform">

  3153. 	<h3>Summary</h3>

  3154. 	<div class=tooltipinfo>

  3155. 	<p>Create a waveform: sine, sawtooth, square, triangle, pulse, random S&H or arbitrary.</p>

  3156. 	<p align=center><img src="img/waveforms.png"></p>

  3157. 	</div>

  3158. 	<h3>Audio Connections</h3>

  3159. 	<table class=doc align=center cellpadding=3>

  3160. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3161. 		<tr class=odd><td align=center>Out 0</td><td>Waveform Output</td></tr>

  3162. 	</table>

  3163. 	<h3>Functions</h3>

  3164. 	<p class=func><span class=keyword>begin</span>(waveform);</p>

  3165. 	<p class=desc>Configure the waveform type to create.

  3166. 	</p>

  3167. 	<p class=func><span class=keyword>begin</span>(level, frequency, waveform);</p>

  3168. 	<p class=desc>Output a waveform, and set the amplitude and frequency.

  3169. 	</p>

  3170. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  3171. 	<p class=desc>Change the frequency.

  3172. 	</p>

  3173. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3174. 	<p class=desc>Change the amplitude.  Set to 0 to turn the signal off.

  3175. 	</p>

  3176. 	<p class=func><span class=keyword>offset</span>(level);</p>

  3177. 	<p class=desc>Add a DC offset, from -1.0 to +1.0.  Useful for generating

  3178. 		waveforms to use as control or modulation signals.

  3179. 	</p>

  3180. 	<p class=func><span class=keyword>phase</span>(angle);</p>

  3181. 	<p class=desc>

  3182. 		Cause the generated waveform to jump to a specific point within

  3183. 		its cycle.  Angle is from 0 to 360 degrees.  When multiple objects

  3184. 		are configured,

  3185. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a>

  3186. 		should be used to guarantee all new settings take effect together.

  3187. 	</p>

  3188. 	<p class=func><span class=keyword>pulseWidth</span>(amount);</p>

  3189. 	<p class=desc>Change the width (duty cycle) of the pulse.</p>

  3190. 	<p class=func><span class=keyword>arbitraryWaveform</span>(array, maxFreq);</p>

  3191. 	<p class=desc>

  3192. 		Configure the waveform to be used with WAVEFORM_ARBITRARY.  Array

  3193. 		must be an array of 256 samples.  Currently, the data is used

  3194. 		without any filtering, which can cause aliasing with frequencies

  3195. 		above 172 Hz.  For higher frequency output, you must bandwidth

  3196. 		limit your waveform data.  Someday, "maxFreq" will be used to

  3197. 		do this automatically.

  3198. 	</p>

  3199. 	<h3>Examples</h3>

  3200. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; Waveforms

  3201. 	</p>

  3202. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; PlaySynthMusic

  3203. 	</p>

  3204. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; pulseWidth

  3205. 	</p>

  3206. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; WM8731MikroSine

  3207. 	</p>

  3208. 	<h3>Notes</h3>

  3209. 	<p>Supported Waveforms:<br>

  3210. 		<ul>

  3211. 		<li><span class=literal>WAVEFORM_SINE</span></li>

  3212. 		<li><span class=literal>WAVEFORM_SAWTOOTH</span></li>

  3213. 		<li><span class=literal>WAVEFORM_BANDLIMIT_SAWTOOTH</span></li>

  3214. 		<li><span class=literal>WAVEFORM_SAWTOOTH_REVERSE</span></li>

  3215. 		<li><span class=literal>WAVEFORM_BANDLIMIT_SAWTOOTH_REVERSE</span></li>

  3216. 		<li><span class=literal>WAVEFORM_SQUARE</span></li>

  3217. 		<li><span class=literal>WAVEFORM_BANDLIMIT_SQUARE</span></li>

  3218. 		<li><span class=literal>WAVEFORM_TRIANGLE</span></li>

  3219. 		<li><span class=literal>WAVEFORM_TRIANGLE_VARIABLE</span></li>

  3220. 		<li><span class=literal>WAVEFORM_ARBITRARY</span></li>

  3221. 		<li><span class=literal>WAVEFORM_PULSE</span></li>

  3222. 		<li><span class=literal>WAVEFORM_BANDLIMIT_PULSE</span></li>

  3223. 		<li><span class=literal>WAVEFORM_SAMPLE_HOLD</span></li>

  3224. 		</ul>

  3225. 	</p>

  3226. </script>

  3227. <script type="text/x-red" data-template-name="AudioSynthWaveform">

  3228. 	<div class="form-row">

  3229. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3230. 		<input type="text" id="node-input-name" placeholder="Name">

  3231. 	</div>

  3232. </script>

  3233. 

  3234. <script type="text/x-red" data-help-name="AudioSynthWaveformModulated">

  3235. 	<h3>Summary</h3>

  3236. 	<div class=tooltipinfo>

  3237. 	<p>Create a waveform <b>with modulation</b>: sine, sawtooth, square, triangle, pulse, random S&H or arbitrary.</p>

  3238. 	<p align=center><img src="img/waveformsmod.png"></p>

  3239. 	</div>

  3240. 	<h3>Audio Connections</h3>

  3241. 	<table class=doc align=center cellpadding=3>

  3242. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3243. 		<tr class=odd><td align=center>In 0</td><td>Frequency or Phase</td></tr>

  3244. 		<tr class=odd><td align=center>In 1</td><td>Shape (Pulse &amp; Var Triangle)</td></tr>

  3245. 		<tr class=odd><td align=center>Out 0</td><td>Waveform Output</td></tr>

  3246. 	</table>

  3247. 	<h3>Functions</h3>

  3248. 	<p class=func><span class=keyword>begin</span>(waveform);</p>

  3249. 	<p class=desc>Configure the waveform type to create.

  3250. 	</p>

  3251. 	<p class=func><span class=keyword>begin</span>(level, frequency, waveform);</p>

  3252. 	<p class=desc>Output a waveform, and set the amplitude and base frequency.

  3253. 	</p>

  3254. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  3255. 	<p class=desc>Change the base (unmodulated) frequency.

  3256. 	</p>

  3257. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3258. 	<p class=desc>Change the amplitude.  Set to 0 to turn the signal off.

  3259. 	</p>

  3260. 	<p class=func><span class=keyword>offset</span>(level);</p>

  3261. 	<p class=desc>Add a DC offset, from -1.0 to +1.0.  Useful for generating

  3262. 		waveforms to use as control or modulation signals.

  3263. 	</p>

  3264. 	<p class=func><span class=keyword>frequencyModulation</span>(octaves);</p>

  3265. 	<p class=desc>

  3266. 		Configure for frequency modulation mode (the default) where the

  3267. 		input signal will adjust the frequency by a specific number of

  3268. 		octaves (the default is 8 octaves).  If the -1.0 to +1.0 signal

  3269. 		represents a &plusmn;10 volt range and you wish to have control

  3270. 		at 1 volt/octave, then configure for 10 octaves range.  The

  3271. 		maximum modulation sensitivity is 12 octaves.

  3272. 	</p>

  3273. 	<p class=func><span class=keyword>phaseModulation</span>(degrees);</p>

  3274. 	<p class=desc>

  3275. 		Configure for phase modulation mode where the input signal will

  3276. 		adjust the waveform phase angle a specific number of degrees.

  3277. 		180.0 allows a full scale &plusmn;1.0 signal to span 1 full

  3278. 		cycle of the waveform.  Maximum modulation sensitivity is 9000

  3279. 		degrees (&plusmn;25 cycles).

  3280. 	</p>

  3281. 	<p class=func><span class=keyword>arbitraryWaveform</span>(array, maxFreq);</p>

  3282. 	<p class=desc>

  3283. 		Configure the waveform to be used with WAVEFORM_ARBITRARY.  Array

  3284. 		must be an array of 256 samples.  Currently, the data is used

  3285. 		without any filtering, which can cause aliasing with frequencies

  3286. 		above 172 Hz.  For higher frequency output, you must bandwidth

  3287. 		limit your waveform data.  Someday, "maxFreq" will be used to

  3288. 		do this automatically.

  3289. 	</p>

  3290. 	<h3>Examples</h3>

  3291. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; WaveformsModulated

  3292. 	</p>

  3293. 	<h3>Notes</h3>

  3294. 	<p>Supported Waveforms:<br>

  3295. 		<ul>

  3296. 		<li><span class=literal>WAVEFORM_SINE</span></li>

  3297. 		<li><span class=literal>WAVEFORM_SAWTOOTH</span></li>

  3298. 		<li><span class=literal>WAVEFORM_SAWTOOTH_REVERSE</span></li>

  3299. 		<li><span class=literal>WAVEFORM_SQUARE</span></li>

  3300. 		<li><span class=literal>WAVEFORM_TRIANGLE</span></li>

  3301. 		<li><span class=literal>WAVEFORM_TRIANGLE_VARIABLE</span></li>

  3302. 		<li><span class=literal>WAVEFORM_ARBITRARY</span></li>

  3303. 		<li><span class=literal>WAVEFORM_PULSE</span></li>

  3304. 		<li><span class=literal>WAVEFORM_SAMPLE_HOLD</span></li>

  3305. 		</ul>

  3306. 	</p>

  3307. 	<p>The Sample &amp; Hold waveform does not support phase modulation.

  3308. 		Attempting to modulate its phase may give random or

  3309. 		inconsistent results.  Use only frequency modulation

  3310. 		to vary the Sample &amp; Hold waveform speed

  3311. 	</p>

  3312. </script>

  3313. <script type="text/x-red" data-template-name="AudioSynthWaveformModulated">

  3314. 	<div class="form-row">

  3315. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3316. 		<input type="text" id="node-input-name" placeholder="Name">

  3317. 	</div>

  3318. </script>

  3319. 

  3320. <script type="text/x-red" data-help-name="AudioSynthWaveformPWM">

  3321. 	<h3>Summary</h3>

  3322. 	<div class=tooltipinfo>

  3323. 	<p>Create a Pulse Width Modulated waveform, with an audio signal

  3324. 		controlling the pulse width duty cycle.</p>

  3325. 	<p align=center><img src="img/pwm.png"></p>

  3326. 	</div>

  3327. 	<h3>Audio Connections</h3>

  3328. 	<table class=doc align=center cellpadding=3>

  3329. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3330. 		<tr class=odd><td align=center>In 0</td><td>Control Signal Output</td></tr>

  3331. 		<tr class=odd><td align=center>Out 0</td><td>Waveform Output</td></tr>

  3332. 	</table>

  3333. 	<p>The duty cycle is 50% when the control waveform is zero.

  3334. 		As the control input causes a linear changes in PWM duty

  3335. 		cycle, from nearly 0 to 100% over -1.0 to +1.0 range.

  3336. 		See the notes below for minimum and maximum limitations.

  3337. 	</p>

  3338. 	<h3>Functions</h3>

  3339. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  3340. 	<p class=desc>Change the frequency.

  3341. 	</p>

  3342. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3343. 	<p class=desc>Change the amplitude.  Set to 0 to turn the signal off.

  3344. 	</p>

  3345. 	<h3>Examples</h3>

  3346. 	<p class=exam>TODO, examples needed

  3347. 	</p>

  3348. 	<h3>Notes</h3>

  3349. 	<p>The maximum duty cycle is 65536 samples high followed by

  3350. 		one sample low (99.9985%) and the minimum duty cycle is

  3351. 		1 sample high followed by 65536 samples low (0.00153%).

  3352. 	</p>

  3353. </script>

  3354. <script type="text/x-red" data-template-name="AudioSynthWaveformPWM">

  3355. 	<div class="form-row">

  3356. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3357. 		<input type="text" id="node-input-name" placeholder="Name">

  3358. 	</div>

  3359. </script>

  3360. 

  3361. <script type="text/x-red" data-help-name="AudioSynthToneSweep">

  3362. 	<h3>Summary</h3>

  3363. 	<div class=tooltipinfo>

  3364. 	<p>Create a continuously varying (in frequency) sine wave</p>

  3365. 	</div>

  3366. 	<h3>Audio Connections</h3>

  3367. 	<table class=doc align=center cellpadding=3>

  3368. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3369. 		<tr class=odd><td align=center>Out 0</td><td>Continuously varying tone</td></tr>

  3370. 	</table>

  3371. 	<h3>Functions</h3>

  3372. 	<p class=func><span class=keyword>play</span>(level, lowFreq, highFreq, time);</p>

  3373. 	<p class=desc>Start generating frequency sweep output.  The time is specified

  3374. 		in seconds.  Level is 0 to 1.0.

  3375. 	</p>

  3376. 	<p class=func><span class=keyword>isPlaying</span>();</p>

  3377. 	<p class=desc>Returns true (non-zero) while the output is active.

  3378. 	</p>

  3379. 	<p class=func><span class=keyword>read</span>();</p>

  3380. 	<p class=desc>Returns the current frequency, or zero if the output is not active.

  3381. 	</p>

  3382. 	<h3>Examples</h3>

  3383. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; ToneSweep

  3384. 	</p>

  3385. 	<h3>Notes</h3>

  3386. 	<p>Uses excessive CPU time.</p>

  3387. 	<p>The frequency actually changes in discrete steps every 128 samples (2.9 ms).</p>

  3388. </script>

  3389. <script type="text/x-red" data-template-name="AudioSynthToneSweep">

  3390. 	<div class="form-row">

  3391. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3392. 		<input type="text" id="node-input-name" placeholder="Name">

  3393. 	</div>

  3394. </script>

  3395. 

  3396. <script type="text/x-red" data-help-name="AudioSynthWaveformDc">

  3397. 	<h3>Summary</h3>

  3398. 	<div class=tooltipinfo>

  3399. 	<p>Create constant (DC) signal, useful for control of objects that take

  3400. 		a modulation or control input signal.  This constant level can be

  3401. 		used to modify other waveforms using mixer or multiplier objects</p>

  3402. 	</div>

  3403. 	<h3>Audio Connections</h3>

  3404. 	<table class=doc align=center cellpadding=3>

  3405. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3406. 		<tr class=odd><td align=center>Out 0</td><td>Output constant DC level</td></tr>

  3407. 	</table>

  3408. 	<h3>Functions</h3>

  3409. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3410. 	<p class=desc>Set the output.  Level is -1.0 to 1.0.  The output is

  3411. 		changed immediately.

  3412. 	</p>

  3413. 	<p class=func><span class=keyword>amplitude</span>(level, milliseconds);</p>

  3414. 	<p class=desc>Set the output.  Level is -1.0 to 1.0.  The output is

  3415. 		gradually changed over a "milliseconds" time period.  Any time may

  3416. 		be specified, but periods longer than 1 second may be automatically

  3417. 		shortened for small level changes, due to numerical precision limits.

  3418. 	</p>

  3419. 	<p class=func><span class=keyword>read</span>();</p>

  3420. 	<p class=desc>Read the current level.  Returns -1.0 to 1.0.  This can be

  3421. 		useful for monitoring the amplitude after configuring a slow change.

  3422. 	</p>

  3423. 	<!--

  3424. <h3>Examples</h3>

  3425. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  3426. 	</p>

  3427. -->

  3428. 	<h3>Notes</h3>

  3429. 	<p>Of course, the term "DC", for Direct Current, doesn't properly apply

  3430. 		to a pure digital stream of numerical values.  But the term is widely

  3431. 		understood in audio applications, so hopefully it's not too confusing?</p>

  3432. </script>

  3433. <script type="text/x-red" data-template-name="AudioSynthWaveformDc">

  3434. 	<div class="form-row">

  3435. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3436. 		<input type="text" id="node-input-name" placeholder="Name">

  3437. 	</div>

  3438. </script>

  3439. 

  3440. <script type="text/x-red" data-help-name="AudioSynthNoiseWhite">

  3441. 	<h3>Summary</h3>

  3442. 	<div class=tooltipinfo>

  3443. 	<p>Create white noise.

  3444. 		</p>

  3445. 	<p align=center><img src="img/whitenoise.png"></p>

  3446. 	</div>

  3447. 	<h3>Audio Connections</h3>

  3448. 	<table class=doc align=center cellpadding=3>

  3449. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3450. 		<tr class=odd><td align=center>Out 0</td><td>White Noise</td></tr>

  3451. 	</table>

  3452. 	<h3>Functions</h3>

  3453. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3454. 	<p class=desc>Set the output peak level, from 0 (off) to 1.0.

  3455. 		The default is off.  Noise is generated only after setting

  3456. 		to a non-zero level.

  3457. 	</p>

  3458. 	<h3>Examples</h3>

  3459. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  3460. 	</p>

  3461. 	<h3>Notes</h3>

  3462. 	<p>Setting the amplitude to zero causes this object to stop using

  3463. 		CPU time to generate random numbers.

  3464. 	</p>

  3465. </script>

  3466. <script type="text/x-red" data-template-name="AudioSynthNoiseWhite">

  3467. 	<div class="form-row">

  3468. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3469. 		<input type="text" id="node-input-name" placeholder="Name">

  3470. 	</div>

  3471. </script>

  3472. 

  3473. <script type="text/x-red" data-help-name="AudioSynthNoisePink">

  3474. 	<h3>Summary</h3>

  3475. 	<div class=tooltipinfo>

  3476. 	<p>Create pink noise, using Stefan Stenzel's "New Shade Of Pink" algorithm.

  3477. 		</p>

  3478. 	<!--

  3479. <p align=center><img src="img/whitenoise.png"></p>

  3480. -->

  3481. 	</div>

  3482. 	<h3>Audio Connections</h3>

  3483. 	<table class=doc align=center cellpadding=3>

  3484. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3485. 		<tr class=odd><td align=center>Out 0</td><td>Pink Noise</td></tr>

  3486. 	</table>

  3487. 	<h3>Functions</h3>

  3488. 	<p class=func><span class=keyword>amplitude</span>(level);</p>

  3489. 	<p class=desc>Set the output peak level, from 0 (off) to 1.0.

  3490. 		The default is off.  Noise is generated only after setting

  3491. 		to a non-zero level.

  3492. 	</p>

  3493. 	<h3>Examples</h3>

  3494. 	<p class=exam>File &gt; Examples &gt; Audio &gt; MemoryAndCpuUsage

  3495. 	</p>

  3496. 	<h3>Notes</h3>

  3497. 	<p>Setting the amplitude to zero causes this object to stop using

  3498. 		CPU time.  CPU usage is approx 3% on Teensy 3.1.

  3499. 	</p>

  3500. 	<p>Stefan Stenzel's

  3501. 		<a href="http://stenzel.waldorfmusic.de/post/pink/" target="_blank">New Shade Of Pink</a>

  3502. 		algorithm.  Stefan's terms of use are "Use for any purpose. If used

  3503. 		in a commercial product, you should give me one."

  3504. 	</p>

  3505. </script>

  3506. <script type="text/x-red" data-template-name="AudioSynthNoisePink">

  3507. 	<div class="form-row">

  3508. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3509. 		<input type="text" id="node-input-name" placeholder="Name">

  3510. 	</div>

  3511. </script>

  3512. 

  3513. <script type="text/x-red" data-help-name="AudioEffectFade">

  3514. 	<h3>Summary</h3>

  3515. 	<div class=tooltipinfo>

  3516. 	<p>Gradually increase or decrease audio level.</p>

  3517. 	</div>

  3518. 	<h3>Audio Connections</h3>

  3519. 	<table class=doc align=center cellpadding=3>

  3520. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3521. 		<tr class=odd><td align=center>In 0</td><td>Signal Input</td></tr>

  3522. 		<tr class=odd><td align=center>Out 0</td><td>Signal Output</td></tr>

  3523. 	</table>

  3524. 	<h3>Functions</h3>

  3525. 	<p class=func><span class=keyword>fadeIn</span>(milliseconds);</p>

  3526. 	<p class=desc>Begin increasing the audio level, to reach 1.0 (input passed

  3527. 		directly to the output) after "milliseconds" time.

  3528. 	</p>

  3529. 	<p class=func><span class=keyword>fadeOut</span>(milliseconds);</p>

  3530. 	<p class=desc>Begin decreasing the audio level, to reach 0 (no output)

  3531. 		after "milliseconds" time.

  3532. 	</p>

  3533. 	<!--

  3534. <h3>Examples</h3>

  3535. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  3536. 	</p>

  3537. -->

  3538. 	<h3>Notes</h3>

  3539. 	<p>Cross fading can be built with 2 fade objects fed into a mixer.

  3540. 		When one fade object is off (fully faded out) and the other on

  3541. 		(fully faded in), if both are started at the same moment for the

  3542. 		same time duration, their signal gains always add to 1.0.  This

  3543. 		allows 2 fade objects to work together for a smooth transition

  3544. 		between a pair of signals.

  3545. 	</p>

  3546. 	<p><a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a>

  3547. 		should be used when changing

  3548. 		settings on multiple objects, so all changes always take effect

  3549. 		at the same moment.

  3550. 	</p>

  3551. </script>

  3552. <script type="text/x-red" data-template-name="AudioEffectFade">

  3553. 	<div class="form-row">

  3554. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3555. 		<input type="text" id="node-input-name" placeholder="Name">

  3556. 	</div>

  3557. </script>

  3558. 

  3559. <script type="text/x-red" data-help-name="AudioEffectChorus">

  3560. <h3>Summary</h3>

  3561. 	<div class=tooltipinfo>

  3562. 	<p>The chorus effect simulates the richness of several nearly-identical

  3563. 	sound sources (like the way a choir sounds different to a single singer).

  3564. 	It does this by sampling from a delay line, so each voice is actually

  3565. 	the same but at a slightly different point in time. This is a type of

  3566. 	comb filtering.</p>

  3567. 	</div>

  3568. 	<p>Chorus combines one or more samples ranging from the most recent

  3569. 	sample back to about 50ms ago. The additional samples are evenly spread

  3570. 	through the supplied delay line, and there is no modulation.</p>

  3571. 	<p>If the number of voices is specified as 2, then the

  3572. 	effect combines the current sample and the oldest sample (the last one

  3573. 	in the delay line). If the number of voices is 3 then the effect combines

  3574. 	the most recent sample, the oldest sample and the sample in the middle of

  3575. 	the delay line.</p>

  3576. 	<p>For two voices the effect can be represented as:<br/>

  3577. 	result = (sample(0) + sample(dt))/2<br/>

  3578. 	where sample(0) represents the current sample and sample(dt)

  3579. 	is the sample in the delay line from dt milliseconds ago.</p>

  3580. 	<h3>Audio Connections</h3>

  3581. 	<table class=doc align=center cellpadding=3>

  3582. 		<tr class="top"><th>Port</th><th>Purpose</th></tr>

  3583. 		<tr class="odd"><td align="center">In 0</td><td>Signal Input</td></tr>

  3584. 		<tr class="odd"><td align="center">Out 0</td><td>Chorused Output</td></tr>

  3585. 	</table>

  3586. 	<h3>Functions</h3>

  3587. 	<p class=func><span class=keyword>begin</span>(delayBuffer, length, n_chorus);</p>

  3588. 	<p class=desc>Create a chorus by specifying the address of the delayline, the

  3589. 	total number of samples in the delay line (often done as an integer multiple of

  3590. 	AUDIO_BLOCK_SAMPLES) and the number of voices in the chorus <em>including</em>

  3591. 	the original voice (so, 2 and up to get a chorus effect, although you can

  3592. 	specify 1 if you want).

  3593. 	</p>

  3594. 	<p class=func><span class=keyword>voices</span>(n_chorus);</p>

  3595. 	<p class=desc>Alters the number of voices in a running chorus (previously started with begin).

  3596. 	</p>

  3597. 	<h3>Examples</h3>

  3598. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Chorus

  3599. 	</p>

  3600. 	<h3>Notes</h3>

  3601. 	<p>The longer the length of the chorus, the more memory blocks are used.</p>

  3602. </script>

  3603. <script type="text/x-red" data-template-name="AudioEffectChorus">

  3604. 	<div class="form-row">

  3605. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3606. 		<input type="text" id="node-input-name" placeholder="Name">

  3607. 	</div>

  3608. </script>

  3609. 

  3610. <script type="text/x-red" data-help-name="AudioEffectFlange">

  3611. <h3>Summary</h3>

  3612. 	<div class=tooltipinfo>

  3613. 	<p>Originally, flanging was produced by playing the same signal on two synchronized

  3614. 	reel-to-reel tape recorders and making one of the reels slow down and speed up by

  3615. 	pressing on the flange of the reel (hence the name). This is a type of

  3616. 	comb filtering, and produces a harmonically-related series of peaks and notches

  3617. 	in the audio spectrum.</p>

  3618. 	</div>

  3619. 	<p>This flanger uses a delay line, combining the original voice with only one sample from the delay

  3620. 	line, but the position of that sample varies sinusoidally.</p>

  3621. 	<p>The effect can be represented as:<br>

  3622. 	result = sample(0) + sample(dt + depth*sin(2*PI*Fe))</p>

  3623. 	<p>The value of the sine function is always a number from -1 to +1 and

  3624. 	so the result of depth*(sin(Fe)) is always a number from -depth to +depth.

  3625. 	Thus, the delayed sample will be selected from the range (dt-depth) to

  3626. 	(dt+depth). This selection will vary at whatever rate is specified as the

  3627. 	frequency of the effect, Fe. Typically a low frequency (a few Hertz) is used.

  3628. 	<h3>Audio Connections</h3>

  3629. 	<table class=doc align=center cellpadding=3>

  3630. 		<tr class="top"><th>Port</th><th>Purpose</th></tr>

  3631. 		<tr class="odd"><td align="center">In 0</td><td>Signal Input</td></tr>

  3632. 		<tr class="odd"><td align="center">Out 0</td><td>Flanged Output</td></tr>

  3633. 	</table>

  3634. 	<h3>Functions</h3>

  3635. 	<p class=func><span class=keyword>begin</span>(delayBuffer, length, offset, depth, delayRate);</p>

  3636. 	<p class=desc>Create a flanger by specifying the address of the delayline, the

  3637. 	total number of samples in the delay line (often done as an integer multiple of

  3638. 	AUDIO_BLOCK_SAMPLES), the offset (how far back the flanged sample is from the original voice),

  3639. 	the modulation depth (larger values give a greater variation) and the modulation

  3640. 	frequency, in Hertz.

  3641. 	</p>

  3642. 	<p class=func><span class=keyword>voices</span>(offset, depth, delayRate);</p>

  3643. 	<p class=desc>Alters the parameters in a running flanger (previously started with begin).

  3644. 	</p>

  3645. 

  3646. 	<h3>Examples</h3>

  3647. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Flange

  3648. 	</p>

  3649. 	<h3>Notes</h3>

  3650. 	<p>The longer the length of the delay buffer, the more memory blocks are used.</p>

  3651. 	<p>Try these settings:<br>

  3652. #define FLANGE_DELAY_LENGTH (2*AUDIO_BLOCK_SAMPLES)<br>

  3653. and<br>

  3654. int s_idx = 2*FLANGE_DELAY_LENGTH/4;<br>

  3655. int s_depth = FLANGE_DELAY_LENGTH/4;<br>

  3656. double s_freq = 3;</p>

  3657. <p>The flange effect can also produce a chorus-like effect if a longer

  3658. delay line is used with a slower modulation rate, for example try:<br>

  3659. #define FLANGE_DELAY_LENGTH (12*AUDIO_BLOCK_SAMPLES)<br>

  3660. and<br>

  3661. int s_idx = 3*FLANGE_DELAY_LENGTH/4;<br>

  3662. int s_depth = FLANGE_DELAY_LENGTH/8;<br>

  3663. double s_freq = .0625;</p>

  3664. </script>

  3665. <script type="text/x-red" data-template-name="AudioEffectFlange">

  3666. 	<div class="form-row">

  3667. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3668. 		<input type="text" id="node-input-name" placeholder="Name">

  3669. 	</div>

  3670. </script>

  3671. 

  3672. <script type="text/x-red" data-help-name="AudioEffectReverb">

  3673. <h3>Summary</h3>

  3674. 	<div class=tooltipinfo>

  3675. 	<p>Reverb with adjustable reverberation time.  Contributed by Joao Rossi FIlho.

  3676. 	</p>

  3677. 	</div>

  3678. 	<h3>Audio Connections</h3>

  3679. 	<table class=doc align=center cellpadding=3>

  3680. 		<tr class="top"><th>Port</th><th>Purpose</th></tr>

  3681. 		<tr class="odd"><td align="center">In 0</td><td>Input</td></tr>

  3682. 		<tr class="odd"><td align="center">Out 0</td><td>Output</td></tr>

  3683. 	</table>

  3684. 	<h3>Functions</h3>

  3685. 	<p class=func><span class=keyword>reverbTime</span>(seconds);</p>

  3686. 	<p class=desc>Sets the amount of reverberation time.

  3687. 	</p>

  3688. 

  3689. 	<h3>Examples</h3>

  3690. 	<p><a href="https://twitter.com/joaorossifilho/status/779737126841753601">Video Demo</a>

  3691. 	</p>

  3692. 	<!--<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Flange

  3693. 	</p>-->

  3694. 	<h3>Notes</h3>

  3695. 	<p>This effect may have distortion problems with the input signal is more than 0.5.</p>

  3696. </script>

  3697. <script type="text/x-red" data-template-name="AudioEffectReverb">

  3698. 	<div class="form-row">

  3699. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3700. 		<input type="text" id="node-input-name" placeholder="Name">

  3701. 	</div>

  3702. </script>

  3703. 

  3704. <script type="text/x-red" data-help-name="AudioEffectFreeverb">

  3705. <h3>Summary</h3>

  3706. 	<div class=tooltipinfo>

  3707. 	<p>High quality Reverb effect, based on Freeverb by Jezar at Dreampoint.

  3708. 	</p>

  3709. 	</div>

  3710. 	<h3>Audio Connections</h3>

  3711. 	<table class=doc align=center cellpadding=3>

  3712. 		<tr class="top"><th>Port</th><th>Purpose</th></tr>

  3713. 		<tr class="odd"><td align="center">In 0</td><td>Input</td></tr>

  3714. 		<tr class="odd"><td align="center">Out 0</td><td>Output</td></tr>

  3715. 	</table>

  3716. 	<h3>Functions</h3>

  3717. 	<p class=func><span class=keyword>roomsize</span>(amount);</p>

  3718. 	<p class=desc>Sets the amount of reverberant echo or apparent room

  3719. 		size, from 0 (smallest) to 1.0 (largest);

  3720. 	</p>

  3721. 	<p class=func><span class=keyword>damping</span>(amount);</p>

  3722. 	<p class=desc>Sets the damping factor, from 0 to 1.0.  More damping

  3723. 		causes higher frequency echo to decay, creating a softer sound,

  3724. 		similar to a large room filled with people or materials which

  3725. 		absorb some sound as it travels between reflecting surfaces.

  3726. 		Lower damping simulates a harsher reverberant field.

  3727. 	</p>

  3728. 

  3729. 	<h3>Examples</h3>

  3730. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Freeverb

  3731. 		</p>

  3732. 	<h3>Notes</h3>

  3733. 	<p>Freeverb mono consumes about 21% of the CPU time on Teensy 3.2 and

  3734. 		requires about 22K of RAM.</p>

  3735. </script>

  3736. <script type="text/x-red" data-template-name="AudioEffectFreeverb">

  3737. 	<div class="form-row">

  3738. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3739. 		<input type="text" id="node-input-name" placeholder="Name">

  3740. 	</div>

  3741. </script>

  3742. 

  3743. <script type="text/x-red" data-help-name="AudioEffectFreeverbStereo">

  3744. <h3>Summary</h3>

  3745. 	<div class=tooltipinfo>

  3746. 	<p>High quality stereo Reverb effect, based on Freeverb by Jezar at Dreampoint.

  3747. 	</p>

  3748. 	<p>Teensy 3.5 or 3.6 required to run stereo version.</p>

  3749. 	</div>

  3750. 	<h3>Audio Connections</h3>

  3751. 	<table class=doc align=center cellpadding=3>

  3752. 		<tr class="top"><th>Port</th><th>Purpose</th></tr>

  3753. 		<tr class="odd"><td align="center">In 0</td><td>Input</td></tr>

  3754. 		<tr class="odd"><td align="center">Out 0</td><td>Left Output</td></tr>

  3755. 		<tr class="odd"><td align="center">Out 1</td><td>Right Output</td></tr>

  3756. 	</table>

  3757. 	<h3>Functions</h3>

  3758. 	<p class=func><span class=keyword>roomsize</span>(amount);</p>

  3759. 	<p class=desc>Sets the amount of reverberant echo or apparent room

  3760. 		size, from 0 (smallest) to 1.0 (largest);

  3761. 	</p>

  3762. 	<p class=func><span class=keyword>damping</span>(amount);</p>

  3763. 	<p class=desc>Sets the damping factor, from 0 to 1.0.  More damping

  3764. 		causes higher frequency echo to decay, creating a softer sound,

  3765. 		similar to a large room filled with people or materials which

  3766. 		absorb some sound as it travels between reflecting surfaces.

  3767. 		Lower damping simulates a harsher reverberant field.

  3768. 	</p>

  3769. 

  3770. 	<h3>Examples</h3>

  3771. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Freeverb_Stereo

  3772. 		</p>

  3773. 	<h3>Notes</h3>

  3774. 	<p>Freeverb mono consumes about 18% of the CPU time on Teensy 3.6 and

  3775. 		requires about 45K of RAM.</p>

  3776. 	<p>Teensy 3.2 does not have enough RAM to

  3777. 		run this effect while playing WAV file and implementing USB Serial.</p>

  3778. </script>

  3779. <script type="text/x-red" data-template-name="AudioEffectFreeverbStereo">

  3780. 	<div class="form-row">

  3781. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3782. 		<input type="text" id="node-input-name" placeholder="Name">

  3783. 	</div>

  3784. </script>

  3785. 

  3786. <script type="text/x-red" data-help-name="AudioEffectEnvelope">

  3787. 	<h3>Summary</h3>

  3788. 	<div class=tooltipinfo>

  3789. 	<p>Modify a signal with a DAHDSR (Delay Attack Hold Decay Sustain

  3790. 		Release) envelope.

  3791. 	</p>

  3792. 	<p align=center><img src="img/dahdsr.png"></p>

  3793. 	</div>

  3794. 	<h3>Audio Connections</h3>

  3795. 	<table class=doc align=center cellpadding=3>

  3796. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3797. 		<tr class=odd><td align=center>In 0</td><td>Signal Input</td></tr>

  3798. 		<tr class=odd><td align=center>Out 0</td><td>Signal with Envelope Applied</td></tr>

  3799. 	</table>

  3800. 	<h3>Functions</h3>

  3801. 	<p class=func><span class=keyword>noteOn</span>();</p>

  3802. 	<p class=desc>Begin the delay to attack, or the attack phase is

  3803. 		delay is zero.

  3804. 	</p>

  3805. 	<p class=func><span class=keyword>noteOff</span>();</p>

  3806. 	<p class=desc>Begin the release phase.

  3807. 	</p>

  3808. 	<p class=func><span class=keyword>delay</span>(milliseconds);</p>

  3809. 	<p class=desc>Set the delay from noteOn to the attach phase.  The

  3810. 		default is zero, for no delay.

  3811. 	</p>

  3812. 	<p class=func><span class=keyword>attack</span>(milliseconds);</p>

  3813. 	<p class=desc>Set the attack time.  The default is 10.5 milliseconds.

  3814. 		The maximum is 11880 milliseconds.

  3815. 	</p>

  3816. 	<p class=func><span class=keyword>hold</span>(milliseconds);</p>

  3817. 	<p class=desc>Set the hold time.  The default is 2.5 milliseconds.

  3818. 		The maximum is 11880 milliseconds.

  3819. 	</p>

  3820. 	<p class=func><span class=keyword>decay</span>(milliseconds);</p>

  3821. 	<p class=desc>Set the decay time.  The default is 35 milliseconds.

  3822. 		The maximum is 11880 milliseconds.

  3823. 	</p>

  3824. 	<p class=func><span class=keyword>sustain</span>(level);</p>

  3825. 	<p class=desc>Set the sustain level.  The range is 0 to 1.0.  The

  3826. 		gain will be maintained at this level after the decay phase,

  3827. 		until noteOff() is called.  The sustain phase may last any

  3828. 		length of time, controlled by when release() is called.

  3829. 	</p>

  3830. 	<p class=func><span class=keyword>release</span>(milliseconds);</p>

  3831. 	<p class=desc>Set the release time.  The default is 300 millisecond.

  3832. 		The maximum is 11880 milliseconds.

  3833. 	</p>

  3834. 	<p class=func><span class=keyword>releaseNoteOn</span>(milliseconds);</p>

  3835. 	<p class=desc>Set a quick release time to be used when a new note is

  3836. 		started while the envelop is in any state passing the signal.

  3837. 		This will add latency before your new attack phase begins, so

  3838. 		short times are recommended.  Zero may be used to completely

  3839. 		disable this feature (never extra latency).  Longer times help

  3840. 		reduce clicks or pops.  The default is 5 millisecond.

  3841. 	</p>

  3842. 	<p class=func><span class=keyword>isActive</span>();</p>

  3843. 	<p class=desc>Returns true when the envelope is currently in any of

  3844. 		its 6 phases.

  3845. 	</p>

  3846. 	<p class=func><span class=keyword>isSustain</span>();</p>

  3847. 	<p class=desc>Returns true when the envelope is currently in the

  3848. 		sustain phase.

  3849. 	</p>

  3850. 	<h3>Examples</h3>

  3851. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; PlaySynthMusic

  3852. 	</p>

  3853. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; pulseWidth

  3854. 	</p>

  3855. 	<p class=exam>File &gt; Examples &gt; Audio &gt; MemoryAndCpuUsage

  3856. 	</p>

  3857. 	<h3>Notes</h3>

  3858. 	<p>To achieve the more common ADSR shape, simply

  3859.         set delay and hold to zero.</p>

  3860. </script>

  3861. <script type="text/x-red" data-template-name="AudioEffectEnvelope">

  3862. 	<div class="form-row">

  3863. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3864. 		<input type="text" id="node-input-name" placeholder="Name">

  3865. 	</div>

  3866. </script>

  3867. 

  3868. <script type="text/x-red" data-help-name="AudioEffectMultiply">

  3869. 	<h3>Summary</h3>

  3870. 	<div class=tooltipinfo>

  3871. 	<p>Multiply two signals together, useful for amplitude modulation

  3872. 		or "voltage controlled amplification".

  3873. 	</p>

  3874. 	<p align=center><img src="img/multiply.png"><br><small>56 Hz and 1 kHz sine waves multiplied.</small></p>

  3875. 	</div>

  3876. 	<h3>Audio Connections</h3>

  3877. 	<table class=doc align=center cellpadding=3>

  3878. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3879. 		<tr class=odd><td align=center>In 0</td><td>Signal Input</td></tr>

  3880. 		<tr class=odd><td align=center>In 1</td><td>Signal Input</td></tr>

  3881. 		<tr class=odd><td align=center>Out 0</td><td>Signal with Envelope Applied</td></tr>

  3882. 	</table>

  3883. 	<h3>Functions</h3>

  3884. 	<p>There are no functions to call from the Arduino sketch.

  3885. 		This object simply multiplies the 2 signals to create

  3886. 		a continuous output

  3887. 	</p>

  3888. 	<!--

  3889. <h3>Examples</h3>

  3890. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  3891. 	</p>

  3892. -->

  3893. 	<h3>Notes</h3>

  3894. 	<p>

  3895.     </p>

  3896. </script>

  3897. <script type="text/x-red" data-template-name="AudioEffectMultiply">

  3898. 	<div class="form-row">

  3899. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3900. 		<input type="text" id="node-input-name" placeholder="Name">

  3901. 	</div>

  3902. </script>

  3903. 

  3904. <script type="text/x-red" data-help-name="AudioEffectRectifier">

  3905. 	<h3>Summary</h3>

  3906. 	<div class=tooltipinfo>

  3907. 	<p>Invert the negative portion of a signal, similar to a full wave rectifier circuit.

  3908. 	</p>

  3909. 	</div>

  3910. 	<h3>Audio Connections</h3>

  3911. 	<table class=doc align=center cellpadding=3>

  3912. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3913. 		<tr class=odd><td align=center>In 0</td><td>Signal Input</td></tr>

  3914. 		<tr class=odd><td align=center>Out 0</td><td>Rectifed (positive only) Signal</td></tr>

  3915. 	</table>

  3916. 	<h3>Functions</h3>

  3917. 	<p>There are no functions to call from the Arduino sketch.

  3918. 		This object simply passes the positive portion of the

  3919. 		signal and inverts the signal when the input is negative.

  3920. 	</p>

  3921. <h3>Examples</h3>

  3922. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Vocoder19Band

  3923. 	</p>

  3924. 	<h3>Notes</h3>

  3925. 	<p>To create a half wave rectifier effect, use the waveshape effect.  See

  3926. 		<a href="https://forum.pjrc.com/threads/62091?p=255367&viewfull=1#post255367">this forum message</a> for a half-wave rectifier example.

  3927. 	</p>

  3928.     </p>

  3929. </script>

  3930. <script type="text/x-red" data-template-name="AudioEffectRectifier">

  3931. 	<div class="form-row">

  3932. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3933. 		<input type="text" id="node-input-name" placeholder="Name">

  3934. 	</div>

  3935. </script>

  3936. 

  3937. <script type="text/x-red" data-help-name="AudioEffectDelay">

  3938. 	<h3>Summary</h3>

  3939. 	<div class=tooltipinfo>

  3940. 	<p>Delay a signal.  Up to 8 separate delay taps can be used.</p>

  3941. 	<p align=center><img src="img/delay.png"><br><small>1 kHz burst, delayed 5.2 ms.</small></p>

  3942. 	</div>

  3943. 	<h3>Audio Connections</h3>

  3944. 	<table class=doc align=center cellpadding=3>

  3945. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  3946. 		<tr class=odd><td align=center>In 0</td><td>Signal Input</td></tr>

  3947. 		<tr class=odd><td align=center>Out 0</td><td>Delay Tap #1</td></tr>

  3948. 		<tr class=odd><td align=center>Out 1</td><td>Delay Tap #2</td></tr>

  3949. 		<tr class=odd><td align=center>Out 2</td><td>Delay Tap #3</td></tr>

  3950. 		<tr class=odd><td align=center>Out 3</td><td>Delay Tap #4</td></tr>

  3951. 		<tr class=odd><td align=center>Out 4</td><td>Delay Tap #5</td></tr>

  3952. 		<tr class=odd><td align=center>Out 5</td><td>Delay Tap #6</td></tr>

  3953. 		<tr class=odd><td align=center>Out 6</td><td>Delay Tap #7</td></tr>

  3954. 		<tr class=odd><td align=center>Out 7</td><td>Delay Tap #8</td></tr>

  3955. 	</table>

  3956. 	<h3>Functions</h3>

  3957. 	<p class=func><span class=keyword>delay</span>(channel, milliseconds);</p>

  3958. 	<p class=desc>Set output channel (0 to 7) to delay the signals by

  3959. 		milliseconds.  See the table below for the maximum delay.  The actual delay

  3960. 		is rounded to the nearest sample.  Each channel can be configured for

  3961. 		any delay.  There is no requirement to configure the "taps" in increasing

  3962. 		delay order.

  3963. 	</p>

  3964. 	<p class=func><span class=keyword>disable</span>(channel);</p>

  3965. 	<p class=desc>Disable a channel.  The output of this channel becomes

  3966. 		silent.  If this channel is the longest delay, memory usage is

  3967. 		automatically reduced to accomodate only the remaining channels used.

  3968. 	</p>

  3969. 	<h3>Examples</h3>

  3970. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Delay

  3971. 	</p>

  3972. 	<h3>Notes</h3>

  3973. 	<p>Memory for the delayed signal is take from the memory pool allocated by

  3974. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioConnection.html" target="_blank">AudioMemory()</a>.

  3975. 		Each block allows about 2.9 milliseconds of delay, so AudioMemory

  3976. 		should be increased to allow for the longest delay tap.

  3977. 	</p>

  3978. 	<p>Each board has a maximum possible delay.

  3979. 	</p>

  3980. 	<table class=doc align=center cellpadding=3>

  3981. 		<tr class=top><th>Board</th><th>Maximum</th></tr>

  3982. 		<tr class=odd><td>Teensy 3.0</td><td align=center>139.26 ms</td></tr>

  3983. 		<tr class=odd><td>Teensy 3.1</td><td align=center>449.39 ms</td></tr>

  3984. 		<tr class=odd><td>Teensy 3.2</td><td align=center>449.39 ms</td></tr>

  3985. 		<tr class=odd><td>Teensy 3.5</td><td align=center>1671.19 ms</td></tr>

  3986. 		<tr class=odd><td>Teensy 3.6</td><td align=center>2413.94 ms</td></tr>

  3987. 	</table>

  3988. </script>

  3989. <script type="text/x-red" data-template-name="AudioEffectDelay">

  3990. 	<div class="form-row">

  3991. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  3992. 		<input type="text" id="node-input-name" placeholder="Name">

  3993. 	</div>

  3994. </script>

  3995. 

  3996. <script type="text/x-red" data-help-name="AudioEffectDelayExternal">

  3997. 	<h3>Summary</h3>

  3998. 	<div class=tooltipinfo>

  3999. 	<p>Delay a signal, using external memory for longer delay times!  Up to 8 separate delay taps can be used.</p>

  4000. 	<p align=center><img src="img/delay.png"><br><small>1 kHz burst, delayed 5.2 ms.</small></p>

  4001. 	</div>

  4002. 	<h3>Audio Connections</h3>

  4003. 	<table class=doc align=center cellpadding=3>

  4004. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4005. 		<tr class=odd><td align=center>In 0</td><td>Signal Input</td></tr>

  4006. 		<tr class=odd><td align=center>Out 0</td><td>Delay Tap #1</td></tr>

  4007. 		<tr class=odd><td align=center>Out 1</td><td>Delay Tap #2</td></tr>

  4008. 		<tr class=odd><td align=center>Out 2</td><td>Delay Tap #3</td></tr>

  4009. 		<tr class=odd><td align=center>Out 3</td><td>Delay Tap #4</td></tr>

  4010. 		<tr class=odd><td align=center>Out 4</td><td>Delay Tap #5</td></tr>

  4011. 		<tr class=odd><td align=center>Out 5</td><td>Delay Tap #6</td></tr>

  4012. 		<tr class=odd><td align=center>Out 6</td><td>Delay Tap #7</td></tr>

  4013. 		<tr class=odd><td align=center>Out 7</td><td>Delay Tap #8</td></tr>

  4014. 	</table>

  4015. 	<h3>Functions</h3>

  4016. 	<p class=func><span class=keyword>delay</span>(channel, milliseconds);</p>

  4017. 	<p class=desc>Set output channel (0 to 7) to delay the signals by

  4018. 		milliseconds.  The maximum delay is approx 1.5 seconds for each 23LC1024 chip.

  4019. 		The actual delay

  4020. 		is rounded to the nearest sample.  Each channel can be configured for

  4021. 		any delay.  There is no requirement to configure the "taps" in increasing

  4022. 		delay order.

  4023. 	</p>

  4024. 	<p class=func><span class=keyword>disable</span>(channel);</p>

  4025. 	<p class=desc>Disable a channel.  The output of this channel becomes

  4026. 		silent.  If this channel is the longest delay, memory usage is

  4027. 		automatically reduced to accomodate only the remaining channels used.

  4028. 	</p>

  4029. 	<h3>Hardware</h3>

  4030. 	<p>By default, or when <span class=literal>AUDIO_MEMORY_23LC1024</span> is used (see below),

  4031. 		 a single 23LC1024 RAM chip is used, with these pins:

  4032.     <table class=doc align=center cellpadding=3>

  4033.         <tr class=top><th>Pin</th><th>Signal</th></tr>

  4034.         <tr class=odd><td align=center>6</td><td>CS</td></tr>

  4035.         <tr class=odd><td align=center>7</td><td>MOSI</td></tr>

  4036.         <tr class=odd><td align=center>12</td><td>MISO</td></tr>

  4037.         <tr class=odd><td align=center>14</td><td>SCK</td></tr>

  4038.     </table>

  4039. 	</p>

  4040. 	<p>When <span class=literal>AUDIO_MEMORY_CY15B104</span> is used, a single

  4041. 		CY15B104 FRAM chip is used, with these pins:

  4042.     <table class=doc align=center cellpadding=3>

  4043.         <tr class=top><th>Pin</th><th>Signal</th></tr>

  4044.         <tr class=odd><td align=center>6</td><td>CS</td></tr>

  4045.         <tr class=odd><td align=center>7</td><td>SI</td></tr>

  4046.         <tr class=odd><td align=center>12</td><td>SO</td></tr>

  4047.         <tr class=odd><td align=center>14</td><td>SCK</td></tr>

  4048.     </table>

  4049. 	</p>

  4050. 	<p>When <span class=literal>AUDIO_MEMORY_MEMORYBOARD</span> is used, up to six

  4051. 		23LC1024 chips are used.

  4052. 	</p>

  4053. 	<p align=center><img src="img/memoryboard.jpg"><br><small><a href="https://oshpark.com/shared_projects/KZt5PaU7" target="_blank">Memoryboard 4</a></small></p>

  4054. 	<p>

  4055.     <table class=doc align=center cellpadding=3>

  4056.         <tr class=top><th>Pin</th><th>Signal</th></tr>

  4057.         <tr class=odd><td align=center>2</td><td>CS0 (encoded)</td></tr>

  4058.         <tr class=odd><td align=center>3</td><td>CS1 (encoded)</td></tr>

  4059.         <tr class=odd><td align=center>4</td><td>CS2 (encoded)</td></tr>

  4060.         <tr class=odd><td align=center>7</td><td>MOSI</td></tr>

  4061.         <tr class=odd><td align=center>12</td><td>MISO</td></tr>

  4062.         <tr class=odd><td align=center>14</td><td>SCK</td></tr>

  4063.     </table>

  4064. 	</p>

  4065. 	<p>

  4066. 	If fewer than 6 chips are soldered, the optional parameter for maximum delay

  4067. 	must be used.  See below for details.  Each chip provides 1485 ms of delay

  4068. 	memory, so the total of all objects using AUDIO_MEMORY_MEMORYBOARD must not

  4069. 	exceed the amount of memory physically present.

  4070. 	</p>

  4071. 	<h3>Examples</h3>

  4072. 	<p>

  4073. 	<a href="https://www.youtube.com/watch?v=d80d1HWy5_s" target="_blank">Demo Video</a> (YouTube)

  4074. 	</p>

  4075. 	<!--

  4076.  <p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Delay

  4077. 	</p>

  4078. -->

  4079. 	<p>

  4080. 	<a href="https://forum.pjrc.com/threads/29276-Limits-of-delay-effect-in-audio-library?p=79436&viewfull=1#post79436" target="_blank">Forum Conversaton</a> (with sample code)

  4081. 	</p>

  4082. 	<h3>Notes</h3>

  4083. 	<p>External RAM allows for longer delays without consuming

  4084. 		limited internal RAM.  However, SPI communication is required,

  4085. 		which consumes much more CPU time.  The

  4086. 		<a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html">AudioProcessorUsageMax</a>

  4087. 		function may be used to monitor how much CPU time is consumed.

  4088. 	</p>

  4089. 	<p>You may specify the type of hardware to be used by editing the code.  AUDIO_MEMORY_23LC1024

  4090. 		specifies a single 23LC1024 chip.  AUDIO_MEMORY_MEMORYBOARD allows using up to 6 of these

  4091. 		chips.

  4092. 	</p>

  4093. 	<p class=desc><span class=keyword>AudioEffectDelayExternal</span>  delayExt1(<span class=literal>AUDIO_MEMORY_23LC1024</span>);

  4094. 	</p>

  4095. 	<p>You may also create more than one delay using the same hardware, where the memory is partitioned

  4096. 		by specifying a maximum delay in milliseconds.  This can be useful if you wish to delay both

  4097. 		channels of a stereo signal.

  4098. 

  4099. 	<p class=desc><span class=keyword>AudioEffectDelayExternal</span>  delayExt1(<span class=literal>AUDIO_MEMORY_23LC1024</span>, 700);<br><span class=keyword>AudioEffectDelayExternal</span>  delayExt2(<span class=literal>AUDIO_MEMORY_23LC1024</span>, 700);

  4100. 	</p>

  4101. 	<p>When using CY15B104, you

  4102. 		<a href="https://forum.pjrc.com/threads/45872-Memory-Chip-for-Audio-Adaptor-Board?p=151839&viewfull=1#post151839">may need to add a capacitor between 3.3V & GND</a>

  4103. 		to make the chip work.

  4104. 	</p>

  4105. </script>

  4106. <script type="text/x-red" data-template-name="AudioEffectDelayExternal">

  4107. 	<div class="form-row">

  4108. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4109. 		<input type="text" id="node-input-name" placeholder="Name">

  4110. 	</div>

  4111. </script>

  4112. 

  4113. <script type="text/x-red" data-help-name="AudioEffectBitcrusher">

  4114.     <h3>Summary</h3>

  4115. 	<div class=tooltipinfo>

  4116.     <p>Reduce the samplerate and/or bitdepth of a source signal, resulting in

  4117. 		a distorted sound.</p>

  4118. 	</div>

  4119.     <h3>Audio Connections</h3>

  4120.     <table class=doc align=center cellpadding=3>

  4121.         <tr class=top><th>Port</th><th>Purpose</th></tr>

  4122.         <tr class=odd><td align=center>In 0</td><td>Signal Input</td></tr>

  4123.         <tr class=odd><td align=center>Out 0</td><td>Signal Output</td></tr>

  4124.     </table>

  4125.     <h3>Functions</h3>

  4126.     <p class=func><span class=keyword>bits</span>(xcrushBits);</p>

  4127.     <p class=desc>xcrushBits sets the bitdepth, from 1 to 16. A Value of 16

  4128.     does not crush the bitdepth, and is effectively a passthru for this part

  4129.     of the function.</p>

  4130. 

  4131.     <p class=func><span class=keyword>sampleRate</span>(xsampleRate);</p>

  4132. 

  4133.     <p class=desc>xsampleRate sets the frequency, from 1 to 44100Hz, however it

  4134.     works in integer steps so you will only really get a handful of results from

  4135.     the many samplerates you can pass. 44100 is passthru.</p>

  4136. 

  4137.     <p class=desc>set xbitDepth to 16 and xsampleRate to 44100 to pass audio

  4138.     	through without any Bitcrush effect.</p>

  4139.     <h3>Examples</h3>

  4140.     <p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Bitcrusher

  4141.     </p>

  4142.     <h3>Notes</h3>

  4143.     <p>Needs a lot of improvement. Options for anti-aliasing would be nice in

  4144.     the future, but for now, it's rough, it's dirty and it sounds a bit like

  4145.     Nine Inch Nails.

  4146.     </p>

  4147.     <p><a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a>

  4148.         should be used when changing

  4149.         settings on multiple objects, so all changes always take effect

  4150.         at the same moment.

  4151.     </p>

  4152. </script>

  4153. <script type="text/x-red" data-template-name="AudioEffectBitcrusher">

  4154.     <div class="form-row">

  4155.         <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4156.         <input type="text" id="node-input-name" placeholder="Name">

  4157.     </div>

  4158. </script>

  4159. 

  4160. <script type="text/x-red" data-help-name="AudioEffectMidSide">

  4161. 	<h3>Summary</h3>

  4162. 	<div class=tooltipinfo>

  4163. 	<p>Convert stereo signals to/from Mid-Side format.

  4164. 		Mid-Side encoding can be used to increase stereo width, make the lower

  4165. 		frequencies mono (to please your sub), or as the basis of audio compression.</p>

  4166. 	</div>

  4167. 	<h3>Audio Connections</h3>

  4168. 	<table class=doc align=center cellpadding=3>

  4169. 		<tr class=top><th>Port</th><th>While<br>Encoding</th><th>While<br>Decoding</th></tr>

  4170. 		<tr class=odd><td align=center>In 0</td><td>Left Input</td><td>Mid Output</td></tr>

  4171. 		<tr class=odd><td align=center>In 1</td><td>Right Input</td><td>Side Output</td></tr>

  4172. 		<tr class=odd><td align=center>Out 0</td><td>Mid Input</td><td>Left Output</td></tr>

  4173. 		<tr class=odd><td align=center>Out 1</td><td>Side Input</td><td>Right Output</td></tr>

  4174. 	</table>

  4175. 	<h3>Functions</h3>

  4176. 	<p class=func><span class=keyword>encode</span>();</p>

  4177. 	<p class=desc>Configure this object to encode from stereo to Mid-Side format.</p>

  4178. 	<p class=func><span class=keyword>decode</span>();</p>

  4179. 	<p class=desc>Configure this object to decode from Mid-Side format back to stereo signals.</p>

  4180. 

  4181. 	<h3>Examples</h3>

  4182. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Mid_Side</p>

  4183. 	<h3>Notes</h3>

  4184. 	<p>Many interesting stereo effects can be achieved by manipulating Mid-Side signals.</p>

  4185. 	<p>Normally a pair of these objects are used, one to encode, then additional

  4186. 		gain/attenuation or effects applied to the Mid-Side signals, and finally

  4187. 		decoding back to stereo signals</p>

  4188. 	<p>To prevent saturation, halving is done in the encoding, that is:</p>

  4189. 	<p>Mid = (left+right)/2</p>

  4190. 	<p>Side = (left-right)/2</p>

  4191. 	<p>And to decode:</p>

  4192. 	<p>Left = Mid+Side</p>

  4193. 	<p>Right = Mid-Side</p>

  4194. </script>

  4195. <script type="text/x-red" data-template-name="AudioEffectMidSide">

  4196.     <div class="form-row">

  4197.         <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4198.         <input type="text" id="node-input-name" placeholder="Name">

  4199.     </div>

  4200. </script>

  4201. 

  4202. <script type="text/x-red" data-help-name="AudioEffectWaveshaper">

  4203. 	<h3>Summary</h3>

  4204. 	<div class=tooltipinfo>

  4205. 	<p>Modify the waveform shape of a signal.</p>

  4206. 	<p align=center><img src="img/waveshaper.png"></p>

  4207. 	<p>Useful for overdrive, distortion, fuzz,

  4208. 		clipping, expo converters, phase inversion, waveform modification &amp; adjustments.

  4209. 	</p>

  4210. 	</div>

  4211. 	<h3>Audio Connections</h3>

  4212. 	<table class=doc align=center cellpadding=3>

  4213. 		<tr class=top><th>Port</th><th>Signal</th></tr>

  4214. 		<tr class=odd><td align=center>In 0</td><td>Original Input Signal</td></tr>

  4215. 		<tr class=odd><td align=center>Out 0</td><td>Shaped Output</td></tr>

  4216. 	</table>

  4217. 	<h3>Functions</h3>

  4218. 	<p class=func><span class=keyword>shape</span>(array, length);</p>

  4219. 	<p class=desc>Configure the waveform shape.  Array is a list of float

  4220. 		numbers, given in order.  The first number maps to input -1.0.  The

  4221. 		last maps to input +1.0.  The numbers represent the desired output

  4222. 		level at each of these input levels.  Length must be 2, 3, 5, 9, 17,

  4223. 		33, 65, 129, 257, 513, 1025, 2049, 4097, 8193, 16385, or 32769.

  4224. 		</p>

  4225. 

  4226. 	<h3>Examples</h3>

  4227. 	<p class=exam>TODO: example needed</p>

  4228. 	<!--<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Mid_Side</p>-->

  4229. 	<h3>Notes</h3>

  4230. 	<p><a href="https://github.com/dxinteractive/TeensyAudioWaveshaper">More information</a>

  4231. 		</p>

  4232. </script>

  4233. <script type="text/x-red" data-template-name="AudioEffectWaveshaper">

  4234.     <div class="form-row">

  4235.         <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4236.         <input type="text" id="node-input-name" placeholder="Name">

  4237.     </div>

  4238. </script>

  4239. 

  4240. <script type="text/x-red" data-help-name="AudioEffectGranular">

  4241. 	<h3>Summary</h3>

  4242. 	<div class=tooltipinfo>

  4243. 	<p>Classic granular effect that uses a variable speed buffer to shift the pitch

  4244. 		and freeze incoming audio.

  4245. 		Contributed by Bleep Labs.

  4246. 	</p>

  4247. 	</div>

  4248. 	<h3>Audio Connections</h3>

  4249. 	<table class=doc align=center cellpadding=3>

  4250. 		<tr class=top><th>Port</th><th>Signal</th></tr>

  4251. 		<tr class=odd><td align=center>In 0</td><td>Input Signal</td></tr>

  4252. 		<tr class=odd><td align=center>Out 0</td><td>Granular Output</td></tr>

  4253. 	</table>

  4254. 	<h3>Functions</h3>

  4255. 	<p class=func><span class=keyword>begin</span>(array, length);</p>

  4256. 	<p class=desc>Initialize the granular processing with an array of 16 bit

  4257. 		integers used to store the sound grains.  Until memory is allocated

  4258. 		with this function, no audio appears at the output.

  4259. 		</p>

  4260. 	<p class=func><span class=keyword>setSpeed</span>(ratio);</p>

  4261. 	<p class=desc>Configure the relative speed grains will be played.  1.0

  4262. 		plays the grains without any change.  Less than 1.0 slows the sound,

  4263. 		and greater than 1.0 speeds up.  The allowed range is 0.125 to 8.0,

  4264. 		for &plusmn;3 octaves shift.

  4265. 		</p>

  4266. 	<p class=func><span class=keyword>beginFreeze</span>(grainLength);</p>

  4267. 	<p class=desc>Freeze the sound by sampling one grain, then repeated playing

  4268. 		it.  The grainLength is specified in milliseconds, up to the size allowed

  4269. 		by the array from begin().

  4270. 		</p>

  4271. 	<p class=func><span class=keyword>beginPitchShift</span>(grainLength);</p>

  4272. 	<p class=desc>Pitch shift by continuously sampling grains and playing them

  4273. 		at altered speed.  The grainLength is specified in milliseconds, up to

  4274. 		one third of the memory from begin();

  4275. 		</p>

  4276. 	<p class=func><span class=keyword>stop</span>();</p>

  4277. 	<p class=desc>Stop granual processing.  The input signal is passed to the

  4278. 		output without any changes.

  4279. 		</p>

  4280. 	<h3>Examples</h3>

  4281. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Granular</p>

  4282. 	<!--<h3>Notes</h3>

  4283. 	<p> </p>-->

  4284. </script>

  4285. <script type="text/x-red" data-template-name="AudioEffectGranular">

  4286.     <div class="form-row">

  4287.         <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4288.         <input type="text" id="node-input-name" placeholder="Name">

  4289.     </div>

  4290. </script>

  4291. 

  4292. <script type="text/x-red" data-help-name="AudioEffectDigitalCombine">

  4293. 	<h3>Summary</h3>

  4294. 	<div class=tooltipinfo>

  4295. 	<p>Combine signals with digital logic functions, with results from

  4296. 		interesting new waveforms to aggressive digital distortion.

  4297. 		Contributed by Bleep Labs.

  4298. 	</p>

  4299. 	</div>

  4300. 	<h3>Audio Connections</h3>

  4301. 	<table class=doc align=center cellpadding=3>

  4302. 		<tr class=top><th>Port</th><th>Signal</th></tr>

  4303. 		<tr class=odd><td align=center>In 0</td><td>Input Signal #1</td></tr>

  4304. 		<tr class=odd><td align=center>In 1</td><td>Input Signal #2</td></tr>

  4305. 		<tr class=odd><td align=center>Out 0</td><td>Combined Output</td></tr>

  4306. 	</table>

  4307. 	<h3>Functions</h3>

  4308. 	<p class=func><span class=keyword>setCombineMode</span>(mode);</p>

  4309. 	<p class=desc>Configure which digital combine operation is performed.

  4310. 	</p>

  4311. 	<p class=desc>Supported modes:<br>

  4312. 		<span class=keyword>AudioEffectDigitalCombine</span><b>::OR</b><br>

  4313. 		<span class=keyword>AudioEffectDigitalCombine</span><b>::XOR</b><br>

  4314. 		<span class=keyword>AudioEffectDigitalCombine</span><b>::AND</b><br>

  4315. 		<span class=keyword>AudioEffectDigitalCombine</span><b>::MODULO</b><br>

  4316. 	</p>

  4317. 	<h3>Examples</h3>

  4318. 	<!--<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Combine</p>-->

  4319. 	<!--<h3>Notes</h3>

  4320. 	<p> </p>-->

  4321. </script>

  4322. <script type="text/x-red" data-template-name="AudioEffectDigitalCombine">

  4323.     <div class="form-row">

  4324.         <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4325.         <input type="text" id="node-input-name" placeholder="Name">

  4326.     </div>

  4327. </script>

  4328. 

  4329. <script type="text/x-red" data-help-name="AudioFilterBiquad">

  4330. 	<h3>Summary</h3>

  4331. 	<div class=tooltipinfo>

  4332. 	<p>Biquadratic cascaded filter, useful for all sorts of filtering.

  4333. 		Up to 4 stages may be cascaded.

  4334. 	</p>

  4335. 	<p align=center><img src="img/biquad.png"></p>

  4336. 	</div>

  4337. 	<h3>Audio Connections</h3>

  4338. 	<table class=doc align=center cellpadding=3>

  4339. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4340. 		<tr class=odd><td align=center>In 0</td><td>Signal to be filtered</td></tr>

  4341. 		<tr class=odd><td align=center>Out 0</td><td>Filtered Signal Output</td></tr>

  4342. 	</table>

  4343. 	<h3>Functions</h3>

  4344. 	<p class=func><span class=keyword>setLowpass</span>(stage, frequency, Q);</p>

  4345. 	<p class=desc>Configure one stage of the filter (0 to 3) with low pass

  4346. 		response, with the specified corner frequency and Q shape.  If Q is

  4347. 		higher that 0.7071, be careful of filter gain (see below).

  4348. 	</p>

  4349. 	<p class=func><span class=keyword>setHighpass</span>(stage, frequency, Q);</p>

  4350. 	<p class=desc>Configure one stage of the filter (0 to 3) with high pass

  4351. 		response, with the specified corner frequency and Q shape.  If Q is

  4352. 		higher that 0.7071, be careful of filter gain (see below).

  4353. 	</p>

  4354. 	<p class=func><span class=keyword>setBandpass</span>(stage, frequency, Q);</p>

  4355. 	<p class=desc>Configure one stage of the filter (0 to 3) with band pass

  4356. 		response.  The filter has unity gain at the specified frequency.  Q

  4357. 		controls the width of frequencies allowed to pass.

  4358. 	</p>

  4359. 	<p class=func><span class=keyword>setNotch</span>(stage, frequency, Q);</p>

  4360. 	<p class=desc>Configure one stage of the filter (0 to 3) with band reject (notch)

  4361. 		response.  Q controls the width of rejected frequencies.

  4362. 	</p>

  4363. 	<p class=func><span class=keyword>setLowShelf</span>(stage, frequency, gain, slope);</p>

  4364. 	<p class=desc>Configure one stage of the filter (0 to 3) with low shelf response.

  4365. 		A low shelf filter attenuates or amplifies signals below the specified frequency.

  4366. 		Frequency controls the slope midpoint, gain is in dB and can be both

  4367. 		positive or negative. The slope parameter controls steepness of gain transition.

  4368. 		A slope of 1 yields maximum steepness without overshoot,

  4369. 		lower values yield a less steep slope. See the picture below for a visualization

  4370. 		of the slope parameter's effect.

  4371. 		Be careful with positive gains and slopes higher than 1 as they introduce gain

  4372. 		(see warning below).

  4373. 	</p>

  4374. 	</p>

  4375. 	<p class=func><span class=keyword>setHighShelf</span>(stage, frequency, gain, slope);</p>

  4376. 	<p class=desc>Configure one stage of the filter (0 to 3) with high shelf response.

  4377. 		A high shelf filter attenuates or amplifies signals above the specified frequency.

  4378. 		Frequency controls the slope midpoint, gain is in dB and can be both

  4379. 		positive or negative. The slope parameter controls steepness of gain transition.

  4380. 		A slope of 1 yields maximum steepness without overshoot,

  4381. 		lower values yield a less steep slope. See the picture below for a visualization

  4382. 		of the slope parameter's effect.

  4383. 		Be careful with positive gains and slopes higher than 1 as they introduce gain

  4384. 		(see warning below).

  4385. 	</p>

  4386. 	<p align=center><img src="img/shelf_filter.png"></p>

  4387. 	<p class=func><span class=keyword>setCoefficients</span>(stage, array[5]);</p>

  4388. 	<p class=desc>Configure one stage of the filter (0 to 3) with an arbitrary

  4389. 		filter response.  The array of coefficients is in order: B0, B1, B2, A1, A2.

  4390. 		Each coefficient must be less than 2.0 and greater than -2.0.  The array

  4391. 		should be type double.  Alternately, it may be type int, where 1.0 is

  4392. 		represented with 1073741824 (2<sup>30</sup>).

  4393. 	</p>

  4394. 	<h3>Examples</h3>

  4395. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Filter

  4396. 	</p>

  4397. 	<h3>Notes</h3>

  4398. 	<p>Filters can with gain must have their input signals attenuated, so the

  4399. 		signal does not exceed 1.0.

  4400. 	</p>

  4401. 	<p>This object implements up to 4 cascaded stages.  Unconfigured stages will

  4402. 		not pass any signal.

  4403. 	</p>

  4404. 	<p>Biquad filters with low corner frequency (under about 400 Hz) can run into

  4405. 		trouble with limited numerical precision, causing the filter to perform

  4406. 		poorly.  For very low corner frequency, the State Variable (Chamberlin)

  4407. 		filter should be used.

  4408. 	</p>

  4409. </script>

  4410. <script type="text/x-red" data-template-name="AudioFilterBiquad">

  4411. 	<div class="form-row">

  4412. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4413. 		<input type="text" id="node-input-name" placeholder="Name">

  4414. 	</div>

  4415. </script>

  4416. 

  4417. <script type="text/x-red" data-help-name="AudioFilterFIR">

  4418. 	<h3>Summary</h3>

  4419. 	<div class=tooltipinfo>

  4420. 	<p>Finite impulse response filter, useful for all sorts of filtering.

  4421. 	</p>

  4422. 	<p align=center><img src="img/fir_filter.png"></p>

  4423. 	</div>

  4424. 	<h3>Audio Connections</h3>

  4425. 	<table class=doc align=center cellpadding=3>

  4426. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4427. 		<tr class=odd><td align=center>In 0</td><td>Signal to be filtered</td></tr>

  4428. 		<tr class=odd><td align=center>Out 0</td><td>Filtered Signal Output</td></tr>

  4429. 	</table>

  4430. 	<h3>Functions</h3>

  4431. 	<p class=func><span class=keyword>begin</span>(array, length);</p>

  4432. 	<p class=desc>Initialize the filter.  The array must be 16 bit integers (the

  4433. 		filter's impulse response), and

  4434. 		length indicates the number of points in the array.  Array may also be

  4435. 		FIR_PASSTHRU (length = 0), to directly pass the input to output without

  4436. 		filtering.

  4437. 	</p>

  4438. 	<p class=func><span class=keyword>end</span>();</p>

  4439. 	<p class=desc>Turn the filter off.

  4440. 	</p>

  4441. 	<h3>Examples</h3>

  4442. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Filter_FIR

  4443. 	</p>

  4444. 	<h3>Known Issues</h3>

  4445. 	<p>Your filter's impulse response array must have an even length.  If you have

  4446. 		add odd number of taps, you must add an extra zero to increase the length

  4447. 		to an even number.

  4448. 	</p>

  4449. 	<p>The minimum number of taps is 4.  If you use less, add extra zeros to increase

  4450. 		the length to 4.

  4451. 	</p>

  4452. 	<p>The impulse response must be given in reverse order.  Many filters have

  4453. 		symetrical impluse response, making this a non-issue.  If your filter has

  4454. 		a non-symetrical response, make sure the data is in reverse time order.

  4455. 	</p>

  4456. 	<h3>Notes</h3>

  4457. 	<p>FIR filters requires more CPU time than Biquad (IIR), but they can

  4458. 		implement filters with better phase response.

  4459. 	</p>

  4460. 	<p>A 100 point filter requires 9% CPU time on Teensy 3.1.  The maximum

  4461. 		supported filter length is 200 points.

  4462. 	</p>

  4463. 	<p>The free

  4464. 		<a href="http://t-filter.engineerjs.com/" target="_blank"> TFilter Design Tool</a>

  4465. 		can be used to create the impulse response array.  Be sure to set the sampling

  4466. 		frequency to 44117 HZ (it defaults to only 2000 Hz) and the output type to "int" (16 bit).

  4467. 	</p>

  4468. 	<p>

  4469. 		If you use TFilter Design's "C/C++ array" option, it's output has "int" definition, which

  4470. 		is 32 bits on Teensy 3.1.  Edit "int" to "short" for an array of 16 bit numbers,

  4471. 		and add "const" to avoid consuming extra RAM.

  4472. 	</p>

  4473. </script>

  4474. <script type="text/x-red" data-template-name="AudioFilterFIR">

  4475. 	<div class="form-row">

  4476. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4477. 		<input type="text" id="node-input-name" placeholder="Name">

  4478. 	</div>

  4479. </script>

  4480. 

  4481. <script type="text/x-red" data-help-name="AudioFilterStateVariable">

  4482. 	<h3>Summary</h3>

  4483. 	<div class=tooltipinfo>

  4484. 	<p>A State Variable (Chamberlin) Filter with 12 dB/octave roll-off,

  4485. 		adjustable resonance, and optional signal control of corner

  4486. 		frequency.</p>

  4487. 	</div>

  4488. 	<h3>Audio Connections</h3>

  4489. 	<table class=doc align=center cellpadding=3>

  4490. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4491. 		<tr class=odd><td align=center>In 0</td><td>Signal to Filter</td></tr>

  4492. 		<tr class=odd><td align=center>In 1</td><td>Frequency Control</td></tr>

  4493. 		<tr class=odd><td align=center>Out 0</td><td>Low Pass Output</td></tr>

  4494. 		<tr class=odd><td align=center>Out 1</td><td>Band Pass Output</td></tr>

  4495. 		<tr class=odd><td align=center>Out 2</td><td>High Pass Output</td></tr>

  4496. 	</table>

  4497. 	<h3>Functions</h3>

  4498. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  4499. 	<p class=desc>Set the filter's corner frequency.  When a signal is

  4500. 		connected to the control input, the filter will implement this

  4501. 		frequency when the signal is zero.

  4502. 	</p>

  4503. 	<p class=func><span class=keyword>resonance</span>(Q);</p>

  4504. 	<p class=desc>Set the filter's resonance.  Q ranges from 0.7 to 5.0.

  4505. 		Resonance greater than 0.707 will amplify the signal near the

  4506. 		corner frequency.  You must attenuate the signal before input

  4507. 		to this filter, to prevent clipping.

  4508. 	</p>

  4509. 	<p class=func><span class=keyword>octaveControl</span>(octaves);</p>

  4510. 	<p class=desc>Set how much (in octaves) the control signal can alter

  4511. 		the filter's corner frequency.  Range is 0 to 7 octaves.  For

  4512. 		example, when set to 2.5, a full scale positive signal (1.0) will

  4513. 		shift the filter frequency up 2.5 octaves, and a full scale negative

  4514. 		signal will shift it down 2.5 octaves.

  4515. 	</p>

  4516. 	<!--

  4517. <h3>Examples</h3>

  4518. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  4519. 	</p>

  4520. -->

  4521. 	<h3>Notes</h3>

  4522. 	<p>

  4523. 		When controlled by a signal, the equation for the filter

  4524. 		frequency is:

  4525. 	</p>

  4526. 	<p>

  4527. 		<img src="img/filter_formula.png">

  4528. 	</p>

  4529. 	<p>When operating with signal control of corner frequency, this

  4530. 		object uses approximately 4% of the CPU time on Teensy 3.1.

  4531. 	</p>

  4532. </script>

  4533. <script type="text/x-red" data-template-name="AudioFilterStateVariable">

  4534. 	<div class="form-row">

  4535. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4536. 		<input type="text" id="node-input-name" placeholder="Name">

  4537. 	</div>

  4538. </script>

  4539. 

  4540. 

  4541. <script type="text/x-red" data-help-name="AudioFilterLadder">

  4542. 	<h3>Summary</h3>

  4543. 	<div class=tooltipinfo>

  4544. 	<p>A low pass filter with resonant feedback, meant to approximate the

  4545. 		classic "Moog sound".  Both cut-off frequency and resonance level

  4546. 		can optionally be controlled by input audio signals.

  4547. 		</p>

  4548. 	<p align=center><img src="img/ladder.png"></p>

  4549. 	</div>

  4550. 	<h3>Audio Connections</h3>

  4551. 	<table class=doc align=center cellpadding=3>

  4552. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4553. 		<tr class=odd><td align=center>In 0</td><td>Signal to Filter</td></tr>

  4554. 		<tr class=odd><td align=center>In 1</td><td>Frequency Control</td></tr>

  4555. 		<tr class=odd><td align=center>In 2</td><td>Resonance Control</td></tr>

  4556. 		<tr class=odd><td align=center>Out 0</td><td>Low Pass Output</td></tr>

  4557. 	</table>

  4558. 	<h3>Functions</h3>

  4559. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  4560. 	<p class=desc>Set the filter's corner frequency.  When a signal is

  4561. 		connected to the frequency control input, this setting is

  4562. 		the corner frequency the filter will implement

  4563. 		when the signal is zero.

  4564. 	</p>

  4565. 	<p class=func><span class=keyword>octaveControl</span>(octaves);</p>

  4566. 	<p class=desc>Set how much (in octaves) the control signal can alter

  4567. 		the filter's corner frequency.  Range is 0 to 7 octaves.  For

  4568. 		example, when set to 2.5, a full scale positive signal (1.0) will

  4569. 		shift the filter frequency up 2.5 octaves, and a full scale negative

  4570. 		signal will shift it down 2.5 octaves.

  4571. 	</p>

  4572. 	<p class=func><span class=keyword>resonance</span>(level);</p>

  4573. 	<p class=desc>Set the filter's feedback level for resonance.  The

  4574. 		usable range is 0 to 1.07, where values over 1.0 can cause

  4575. 		the filter to self oscillate.  When an audio signal is present

  4576. 		at the resonance control input, it overrides this setting.

  4577. 		Only positive signal values are used.  A full scale 1.0 signal

  4578. 		creates resonance setting 1.07 (self oscillation).

  4579. 		Any negative signal input is treated as zero.

  4580. 	</p>

  4581. <h3>Examples</h3>

  4582. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Synthesis &gt; LadderFilter

  4583. 	</p>

  4584. 	<h3>Notes</h3>

  4585. 	<p>

  4586. 		When controlled by a signal, the equation for the filter

  4587. 		frequency is:

  4588. 	</p>

  4589. 	<p>

  4590. 		<img src="img/filter_formula.png">

  4591. 	</p>

  4592. 	<p>This filter uses floating point math.  It is recommended for use

  4593. 		on Teensy 4.0 or higher.

  4594. 	</p>

  4595. </script>

  4596. <script type="text/x-red" data-template-name="AudioFilterLadder">

  4597. 	<div class="form-row">

  4598. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4599. 		<input type="text" id="node-input-name" placeholder="Name">

  4600. 	</div>

  4601. </script>

  4602. 

  4603. <script type="text/x-red" data-help-name="AudioAnalyzePeak">

  4604. 	<h3>Summary</h3>

  4605. 	<div class=tooltipinfo>

  4606. 	<p>Track the signal peak amplitude.  Very useful for simple

  4607. 		audio level response projects, and general troubleshooting.</p>

  4608. 	</div>

  4609. 	<h3>Audio Connections</h3>

  4610. 	<table class=doc align=center cellpadding=3>

  4611. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4612. 		<tr class=odd><td align=center>In 0</td><td>Signal to analyze</td></tr>

  4613. 	</table>

  4614. 	<h3>Functions</h3>

  4615. 	<p class=func><span class=keyword>available</span>();</p>

  4616. 	<p class=desc>Returns true each time new peak data is available.

  4617. 	</p>

  4618. 	<p class=func><span class=keyword>read</span>();</p>

  4619. 	<p class=desc>Read the highest peak amplitude value since the last read.

  4620. 		Return is from 0.0 to 1.0.

  4621. 	</p>

  4622. 	<p class=func><span class=keyword>readPeakToPeak</span>();</p>

  4623. 	<p class=desc>Read the highest peak-to-peak amplitude since the last read.

  4624. 		Return is from 0.0 to 2.0.

  4625. 	</p>

  4626. 	<h3>Examples</h3>

  4627. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; PeakMeterMono

  4628. 	</p>

  4629. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; PeakMeterStereo

  4630. 	</p>

  4631. 	<h3>Notes</h3>

  4632. 	<p></p>

  4633. </script>

  4634. <script type="text/x-red" data-template-name="AudioAnalyzePeak">

  4635. 	<div class="form-row">

  4636. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4637. 		<input type="text" id="node-input-name" placeholder="Name">

  4638. 	</div>

  4639. </script>

  4640. 

  4641. <script type="text/x-red" data-help-name="AudioAnalyzeRMS">

  4642. 	<h3>Summary</h3>

  4643. 	<div class=tooltipinfo>

  4644. 	<p>Track the signal RMS amplitude.  Useful for

  4645. 		audio level response projects, and general troubleshooting.</p>

  4646. 	</div>

  4647. 	<h3>Audio Connections</h3>

  4648. 	<table class=doc align=center cellpadding=3>

  4649. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4650. 		<tr class=odd><td align=center>In 0</td><td>Signal to analyze</td></tr>

  4651. 	</table>

  4652. 	<h3>Functions</h3>

  4653. 	<p class=func><span class=keyword>available</span>();</p>

  4654. 	<p class=desc>Returns true if new RMS data is available.

  4655. 	</p>

  4656. 	<p class=func><span class=keyword>read</span>();</p>

  4657. 	<p class=desc>Read the new RMS value.

  4658. 		Return is from 0.0 to 1.0.

  4659. 	</p>

  4660. 	<h3>Examples</h3>

  4661. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; PeakAndRMSMeterStereo</p>

  4662. 	</p>

  4663. 	<h3>Notes</h3>

  4664. 	<p></p>

  4665. </script>

  4666. <script type="text/x-red" data-template-name="AudioAnalyzeRMS">

  4667. 	<div class="form-row">

  4668. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4669. 		<input type="text" id="node-input-name" placeholder="Name">

  4670. 	</div>

  4671. </script>

  4672. 

  4673. <script type="text/x-red" data-help-name="AudioAnalyzeFFT256">

  4674. 	<h3>Summary</h3>

  4675. 	<div class=tooltipinfo>

  4676. 	<p>Compute a 256 point Fast Fourier Transform (FFT) frequency analysis,

  4677. 		with real value (magnitude) output.  The frequency resolution is

  4678. 		172 Hz, useful for simple audio visualization.</p>

  4679. 	</div>

  4680. 	<h3>Audio Connections</h3>

  4681. 	<table class=doc align=center cellpadding=3>

  4682. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4683. 		<tr class=odd><td align=center>In 0</td><td>Signal to convert to frequency bins</td></tr>

  4684. 	</table>

  4685. 	<h3>Functions</h3>

  4686. 	<p class=func><span class=keyword>available</span>();</p>

  4687. 	<p class=desc>Returns true each time the FFT analysis produces new output data.

  4688. 	</p>

  4689. 	<p class=func><span class=keyword>read</span>(binNumber);</p>

  4690. 	<p class=desc>Read a single frequency bin, from 0 to 127.  The result is scaled

  4691. 		so 1.0 represents a full scale sine wave.

  4692. 	</p>

  4693. 	<p class=func><span class=keyword>read</span>(firstBin, lastBin);</p>

  4694. 	<p class=desc>Read several frequency bins, returning their sum.  The higher

  4695. 		audio octaves are represented by many bins, which are typically read

  4696. 		as a group for audio visualization.

  4697. 	</p>

  4698. 	<p class=func><span class=keyword>averageTogether</span>(number);</p>

  4699. 	<p class=desc>New data is produced very radidly, approximately 344 times

  4700. 		per second.  Multiple outputs can be averaged together, so available()

  4701. 		returns true at a slower rate.

  4702. 	</p>

  4703. 	<p class=func><span class=keyword>windowFunction</span>(window);</p>

  4704. 	<p class=desc>Set the window function to be used.  AudioWindowHanning256

  4705. 		is the default.  Windowing may be disabled by NULL, but windowing

  4706. 		should be used for all non-periodic (music) signals, and all periodic

  4707. 		signals that are not exact integer division of the sample rate.

  4708. 	</p>

  4709. 

  4710. 	<h3>Examples</h3>

  4711. 	<p class=exam>File &gt; Examples &gt; Audio &gt; MemoryAndCpuUsage

  4712. 	</p>

  4713. 	<h3>Notes</h3>

  4714. 	<p>The raw 16 bit output data bins may be access with myFFT.output[num], where

  4715. 		num is 0 to 127.</p>

  4716. 	<p>TODO: caveats about spectral leakage vs frequency precision for arbitrary signals</p>

  4717. 	<p>Window Types:

  4718. 		<ul>

  4719. 		<li><span class=literal>AudioWindowHanning256</span> (default)</li>

  4720. 		<li><span class=literal>AudioWindowBartlett256</span></li>

  4721. 		<li><span class=literal>AudioWindowBlackman256</span></li>

  4722. 		<li><span class=literal>AudioWindowFlattop256</span></li>

  4723. 		<li><span class=literal>AudioWindowBlackmanHarris256</span></li>

  4724. 		<li><span class=literal>AudioWindowNuttall256</span></li>

  4725. 		<li><span class=literal>AudioWindowBlackmanNuttall256</span></li>

  4726. 		<li><span class=literal>AudioWindowWelch256</span></li>

  4727. 		<li><span class=literal>AudioWindowHamming256</span></li>

  4728. 		<li><span class=literal>AudioWindowCosine256</span></li>

  4729. 		<li><span class=literal>AudioWindowTukey256</span></li>

  4730. 		</ul>

  4731. 	</p>

  4732. </script>

  4733. <script type="text/x-red" data-template-name="AudioAnalyzeFFT256">

  4734. 	<div class="form-row">

  4735. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4736. 		<input type="text" id="node-input-name" placeholder="Name">

  4737. 	</div>

  4738. </script>

  4739. 

  4740. <script type="text/x-red" data-help-name="AudioAnalyzeFFT1024">

  4741. 	<h3>Summary</h3>

  4742. 	<div class=tooltipinfo>

  4743. 	<p>Compute a 1024 point Fast Fourier Transform (FFT) frequency analysis,

  4744. 		with real value (magnitude) output.  The frequency resolution is

  4745. 		43 Hz, useful detailed for audio visualization.</p>

  4746. 	</div>

  4747. 	<h3>Audio Connections</h3>

  4748. 	<table class=doc align=center cellpadding=3>

  4749. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4750. 		<tr class=odd><td align=center>In 0</td><td>Signal to convert to frequency bins</td></tr>

  4751. 	</table>

  4752. 	<h3>Functions</h3>

  4753. 	<p class=func><span class=keyword>available</span>();</p>

  4754. 	<p class=desc>Returns true each time the FFT analysis produces new output data.

  4755. 	</p>

  4756. 	<p class=func><span class=keyword>read</span>(binNumber);</p>

  4757. 	<p class=desc>Read a single frequency bin, from 0 to 511.  The result is scaled

  4758. 		so 1.0 represents a full scale sine wave.

  4759. 	</p>

  4760. 	<p class=func><span class=keyword>read</span>(firstBin, lastBin);</p>

  4761. 	<p class=desc>Read several frequency bins, returning their sum.  The higher

  4762. 		audio octaves are represented by many bins, which are typically read

  4763. 		as a group for audio visualization.

  4764. 	</p>

  4765. 	<p class=func><span class=keyword>averageTogether</span>(number);</p>

  4766. 	<p class=desc>This function does nothing.  The 1024 point FFT always

  4767. 		updates at approximately 86 times per second.

  4768. 	</p>

  4769. 	<p class=func><span class=keyword>windowFunction</span>(window);</p>

  4770. 	<p class=desc>Set the window function to be used.  AudioWindowHanning1024

  4771. 		is the default.  Windowing may be disabled by NULL, but windowing

  4772. 		should be used for all non-periodic (music) signals, and all periodic

  4773. 		signals that are not exact integer division of the sample rate.

  4774. 	</p>

  4775. 	<h3>Examples</h3>

  4776. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; FFT

  4777. 	</p>

  4778. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; SpectrumAnalyzerBasic

  4779. 	</p>

  4780. 	<h3>Notes</h3>

  4781. 	<p>The raw 16 bit output data bins may be access with myFFT.output[num], where

  4782. 		num is 0 to 511.</p>

  4783. 	<p>TODO: caveats about spectral leakage vs frequency precision for arbitrary signals</p>

  4784. 	<p>Window Types:

  4785. 		<ul>

  4786. 		<li><span class=literal>AudioWindowHanning1024</span> (default)</li>

  4787. 		<li><span class=literal>AudioWindowBartlett1024</span></li>

  4788. 		<li><span class=literal>AudioWindowBlackman1024</span></li>

  4789. 		<li><span class=literal>AudioWindowFlattop1024</span></li>

  4790. 		<li><span class=literal>AudioWindowBlackmanHarris1024</span></li>

  4791. 		<li><span class=literal>AudioWindowNuttall1024</span></li>

  4792. 		<li><span class=literal>AudioWindowBlackmanNuttall1024</span></li>

  4793. 		<li><span class=literal>AudioWindowWelch1024</span></li>

  4794. 		<li><span class=literal>AudioWindowHamming1024</span></li>

  4795. 		<li><span class=literal>AudioWindowCosine1024</span></li>

  4796. 		<li><span class=literal>AudioWindowTukey1024</span></li>

  4797. 		</ul>

  4798. 	</p>

  4799. 	<p>1024 point FFT has a peak CPU usage of approx 52% on Teensy 3.1.

  4800. 		Average usage is much lower.  Future versions might distribute the

  4801. 		load more evenly over time....

  4802. 	</p>

  4803. </script>

  4804. <script type="text/x-red" data-template-name="AudioAnalyzeFFT1024">

  4805. 	<div class="form-row">

  4806. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4807. 		<input type="text" id="node-input-name" placeholder="Name">

  4808. 	</div>

  4809. </script>

  4810. 

  4811. <script type="text/x-red" data-help-name="AudioAnalyzeToneDetect">

  4812. 	<h3>Summary</h3>

  4813. 	<div class=tooltipinfo>

  4814. 	<p>Detect the level of a single tone.</p>

  4815. 	<p>Uses the

  4816. 	<a href="https://en.wikipedia.org/wiki/Goertzel_algorithm" target="_blank">Goertzel algorithm</a>

  4817. 	.</p>

  4818. 	</div>

  4819. 	<h3>Audio Connections</h3>

  4820. 	<table class=doc align=center cellpadding=3>

  4821. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4822. 		<tr class=odd><td align=center>In 0</td><td>Signal to analyze</td></tr>

  4823. 	</table>

  4824. 	<h3>Functions</h3>

  4825. 	<p class=func><span class=keyword>frequency</span>(freq);</p>

  4826. 	<p class=desc>Set the frequency to detect.  The default detection time

  4827. 		will be 10 cycles of this frequency.

  4828. 	</p>

  4829. 	<p class=func><span class=keyword>frequency</span>(freq, cycles);</p>

  4830. 	<p class=desc>Set the frequency to detect, and the number of cycles.

  4831. 		Longer detection time (more cycles) will give higher precision,

  4832. 		but of course slower response.

  4833. 	</p>

  4834. 	<p class=func><span class=keyword>available</span>();</p>

  4835. 	<p class=desc>Returns true (non-zero) each time a detection interval

  4836. 		(number of cycles) completed and a new level is detected.

  4837. 	</p>

  4838. 	<p class=func><span class=keyword>read</span>();</p>

  4839. 	<p class=desc>Read the detected signal level.  Range is 0 to 1.0.

  4840. 	</p>

  4841. 	<p class=func><span class=keyword>threshold</span>(level);</p>

  4842. 	<p class=desc>Set a detection threshold, where the bool test operation

  4843. 		will return true if at or above this level, or false when below.

  4844. 	</p>

  4845. 	<p class=func>(bool)</p>

  4846. 	<p class=desc>By testing the object as a boolean value, you can respond

  4847. 		to detection of a tone.

  4848. 	</p>

  4849. 	<h3>Examples</h3>

  4850. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; DialTone_Serial

  4851. 	</p>

  4852. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; DialTone_7segment

  4853. 	</p>

  4854. 	<h3>Notes</h3>

  4855. 	<p>Low frequency detection has trouble with numerical precision.

  4856. 		Works really well for all 8 DTMF frequencies, but fails for

  4857. 		detecting "sub audible tones" used in some control applications.</p>

  4858. 	<p>The (bool) test continues to return true until the next detection

  4859. 		interval (the configured number of cycles).  This behavior may

  4860. 		change in future versions, for a single true each time the signal

  4861. 		is detected, and then false for the remainder of that interval.</p>

  4862. </script>

  4863. <script type="text/x-red" data-template-name="AudioAnalyzeToneDetect">

  4864. 	<div class="form-row">

  4865. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4866. 		<input type="text" id="node-input-name" placeholder="Name">

  4867. 	</div>

  4868. </script>

  4869. 

  4870. <script type="text/x-red" data-help-name="AudioAnalyzeNoteFrequency">

  4871. 	<h3>Summary</h3>

  4872. 	<div class=tooltipinfo>

  4873. 	<p>Detect with fairly good accuracy the fundamental frequency f<sub>o</sub>

  4874. 		of musical notes, such as electric guitar and bass.</p>

  4875. 	</div>

  4876.     <p>Written By Collin Duffy</p>

  4877. 	<h3>Audio Connections</h3>

  4878. 	<table class=doc align=center cellpadding=3>

  4879. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4880. 		<tr class=odd><td align=center>In 0</td><td>Signal to analyze</td></tr>

  4881. 	</table>

  4882. 	<h3>Functions</h3>

  4883. 	<p class=func><span class=keyword>begin</span>(threshold);</p>

  4884. 	<p class=desc>Initialize and start detecting frequencies,

  4885. 		with an initial threshold (the amount of allowed uncertainty).

  4886. 	</p>

  4887. 	<p class=func><span class=keyword>available</span>();</p>

  4888. 	<p class=desc>Returns true (non-zero) when a valid

  4889. 		frequency is detected.

  4890. 	</p>

  4891. 	<p class=func><span class=keyword>read</span>();</p>

  4892. 	<p class=desc>Read the detected frequency.

  4893. 	</p>

  4894. 	<p class=func><span class=keyword>probability</span>();</p>

  4895. 	<p class=desc>Return the level of certainty, betweeo 0 to 1.0.

  4896. 	</p>

  4897. 	<p class=func><span class=keyword>threshold</span>(level);</p>

  4898. 	<p class=desc>Set the detection threshold, the amount of allowed uncertainty.

  4899. 	</p>

  4900. 	<h3>Examples</h3>

  4901. 	<p class=exam>File &gt; Examples &gt; Audio &gt; Analysis &gt; NoteFrequency

  4902. 	</p>

  4903. 	<h3>Notes</h3>

  4904. 	<p>The <a href="http://recherche.ircam.fr/equipes/pcm/cheveign/pss/2002_JASA_YIN.pdf">YIN algorithm</a> (PDF)

  4905. 		is used to detect frequencies, with many optimizations for

  4906. 		frequencies between 29-400Hz.  This algorithm can be somewhat

  4907. 		memory and processor hungry but will allow you to detect with

  4908. 		fairly good accuracy the fundamental frequencies from

  4909. 		electric guitars and basses.</p>

  4910. 	<p>Within the code, AUDIO_GUITARTUNER_BLOCKS

  4911. 		may be edited to control low frequency range.  The default

  4912. 		(24) allows measurement down to 29.14 Hz, or B(flat)0.</p>

  4913. 	<p>TODO: The usable upper range of this object is not well known.

  4914. 		Duff says "it should be good up to 1000Hz", but may have trouble

  4915. 		at 4 kHz.  Please <a href="https://forum.pjrc.com/threads/32252-Different-Range-FFT-Algorithm/page2">post feedback here</a>, ideally with audio clips for the NoteFrequency example.</p>

  4916. 	<p>This object was contributed by Collin Duffy from his

  4917. 		<a href="https://github.com/duff2013/AudioTuner">AudioTuner project</a>.

  4918. 		Additional details and documentation may be found there.</p>

  4919. </script>

  4920. <script type="text/x-red" data-template-name="AudioAnalyzeNoteFrequency">

  4921. 	<div class="form-row">

  4922. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4923. 		<input type="text" id="node-input-name" placeholder="Name">

  4924. 	</div>

  4925. </script>

  4926. 

  4927. <script type="text/x-red" data-help-name="AudioAnalyzePrint">

  4928. 	<h3>Summary</h3>

  4929. 	<div class=tooltipinfo>

  4930. 	<p>Print raw audio data to the Arduino Serial Monitor.  This

  4931. 		object creates massive output quickly, and should not normally be used.</p>

  4932. 	</div>

  4933. 	<h3>Audio Connections</h3>

  4934. 	<table class=doc align=center cellpadding=3>

  4935. 		<tr class=top><th>Port</th><th>Purpose</th></tr>

  4936. 		<tr class=odd><td align=center>In 0</td><td>Signal to print</td></tr>

  4937. 	</table>

  4938. 	<h3>Functions</h3>

  4939. 	<p class=func><span class=keyword>name</span>(string);</p>

  4940. 	<p class=desc>blah blah blah blah

  4941. 	</p>

  4942. 	<p class=func><span class=keyword>trigger</span>();</p>

  4943. 	<p class=desc>blah blah blah blah

  4944. 	</p>

  4945. 	<p class=func><span class=keyword>trigger</span>(level, edge);</p>

  4946. 	<p class=desc>blah blah blah blah

  4947. 	</p>

  4948. 	<p class=func><span class=keyword>delay</span>(samples);</p>

  4949. 	<p class=desc>blah blah blah blah

  4950. 	</p>

  4951. 	<p class=func><span class=keyword>length</span>(samples);</p>

  4952. 	<p class=desc>blah blah blah blah

  4953. 	</p>

  4954. 	<!--

  4955. <h3>Examples</h3>

  4956. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  4957. 	</p>

  4958. -->

  4959. 	<h3>Notes</h3>

  4960. 	<p>This object doesn't work very well and probably should not be used.</p>

  4961. </script>

  4962. <script type="text/x-red" data-template-name="AudioAnalyzePrint">

  4963. 	<div class="form-row">

  4964. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  4965. 		<input type="text" id="node-input-name" placeholder="Name">

  4966. 	</div>

  4967. </script>

  4968. 

  4969. <script type="text/x-red" data-help-name="AudioControlSGTL5000">

  4970. 	<h3>Summary</h3>

  4971. 	<div class=tooltipinfo>

  4972. 	<p>Control the SGTL5000 chip on the

  4973. 		<a href="http://www.pjrc.com/store/teensy3_audio.html" target="_blank">audio shield</a>.

  4974. 		SGTL5000 is always used in slave mode, where Teensy controls

  4975. 		all I2S timing.

  4976. 	</p>

  4977. 	<p align=center><img src="img/sgtl5000closeup.jpg"></p>

  4978. 	</div>

  4979. 	<h3>Audio Connections</h3>

  4980. 	<p>This object has no audio inputs or outputs.  Separate i2s objects

  4981. 		are used to send and receive audio data.  I2S master mode objects

  4982. 		must be used, because this object configures the SGTL5000 in slave

  4983. 		mode, where it depends on Teensy to provide all I2S clocks.

  4984. 		This object controls

  4985. 		how the SGTL5000 will use those I2S audio streams.</p>

  4986. 

  4987. 	<h3>Functions</h3>

  4988. 	<p>These are the most commonly used SGTL5000 functions.</p>

  4989. 	<p class=func><span class=keyword>enable</span>();</p>

  4990. 	<p class=desc>Start the SGTL5000.  This function should be called first.

  4991. 	</p>

  4992. 	<p class=func><span class=keyword>volume</span>(level);</p>

  4993. 	<p class=desc>Set the headphone volume level.  Range is 0 to 1.0, but

  4994. 		0.8 corresponds to the maximum undistorted output for a full scale

  4995. 		signal.  Usually 0.5 is a comfortable listening level.  The line

  4996. 		level outputs are <em>not</em> changed by this function.

  4997. 	</p>

  4998. 	<p class=func><span class=keyword>inputSelect</span>(input);</p>

  4999. 	<p class=desc>Select which input to use: AUDIO_INPUT_LINEIN or AUDIO_INPUT_MIC.

  5000. 	</p>

  5001. 	<p class=func><span class=keyword>micGain</span>(dB);</p>

  5002. 	<p class=desc>When using the microphone input, set the amplifier gain.

  5003. 		The input number is in decibels, from 0 to 63.

  5004. 	</p>

  5005. 

  5006. 	<h3>Signal Levels</h3>

  5007. 

  5008. 	<p>The default signal levels should be used for most applications,

  5009. 		but these functions allow you to customize the analog signals.</p>

  5010. 

  5011. 	<p class=func><span class=keyword>muteHeadphone</span>();</p>

  5012. 	<p class=desc>Silence the headphone output.

  5013. 	</p>

  5014. 	<p class=func><span class=keyword>unmuteHeadphone</span>();</p>

  5015. 	<p class=desc>Turn the headphone output on.

  5016. 	</p>

  5017. 	<p class=func><span class=keyword>muteLineout</span>();</p>

  5018. 	<p class=desc>Silence the line level outputs.

  5019. 	</p>

  5020. 	<p class=func><span class=keyword>unmuteLineout</span>();</p>

  5021. 	<p class=desc>Turn the line level outputs on.

  5022. 	</p>

  5023. 	<p class=func><span class=keyword>lineInLevel</span>(both);</p>

  5024. 	<p class=desc style="padding-bottom:0.2em;">Adjust the sensitivity of the line-level inputs.

  5025. 		Fifteen settings are possible:

  5026. 	</p>

  5027. <pre class="desc">

  5028.  0: 3.12 Volts p-p

  5029.  1: 2.63 Volts p-p

  5030.  2: 2.22 Volts p-p

  5031.  3: 1.87 Volts p-p

  5032.  4: 1.58 Volts p-p

  5033.  5: 1.33 Volts p-p  (default)

  5034.  6: 1.11 Volts p-p

  5035.  7: 0.94 Volts p-p

  5036.  8: 0.79 Volts p-p

  5037.  9: 0.67 Volts p-p

  5038. 10: 0.56 Volts p-p

  5039. 11: 0.48 Volts p-p

  5040. 12: 0.40 Volts p-p

  5041. 13: 0.34 Volts p-p

  5042. 14: 0.29 Volts p-p

  5043. 15: 0.24 Volts p-p

  5044. </pre>

  5045. 	<p class=func><span class=keyword>lineInLevel</span>(right, left);</p>

  5046. 	<p class=desc>Adjust the sensitivity of the line-level inputs, with different

  5047. 		settings for left and right.  The same 15 settings are available.

  5048. 	</p>

  5049. 	<p class=func><span class=keyword>lineOutLevel</span>(both);</p>

  5050. 	<p class=desc style="padding-bottom:0.2em;">Adjust the line level output

  5051. 		voltage range.  The following settings are possible:

  5052. 	</p>

  5053. <pre class="desc">

  5054. 13: 3.16 Volts p-p

  5055. 14: 2.98 Volts p-p

  5056. 15: 2.83 Volts p-p

  5057. 16: 2.67 Volts p-p

  5058. 17: 2.53 Volts p-p

  5059. 18: 2.39 Volts p-p

  5060. 19: 2.26 Volts p-p

  5061. 20: 2.14 Volts p-p

  5062. 21: 2.02 Volts p-p

  5063. 22: 1.91 Volts p-p

  5064. 23: 1.80 Volts p-p

  5065. 24: 1.71 Volts p-p

  5066. 25: 1.62 Volts p-p

  5067. 26: 1.53 Volts p-p

  5068. 27: 1.44 Volts p-p

  5069. 28: 1.37 Volts p-p

  5070. 29: 1.29 Volts p-p  (default)

  5071. 30: 1.22 Volts p-p

  5072. 31: 1.16 Volts p-p

  5073. </pre>

  5074. 	<p class=func><span class=keyword>lineOutLevel</span>(left, right);</p>

  5075. 	<p class=desc>Adjust the line level outout voltage range, with separate

  5076. 		settings for left and right.  The same settings (13 to 31) are available.

  5077. 	</p>

  5078. 

  5079. 

  5080. 	<h3>Signal Conditioning</h3>

  5081. 

  5082. 	<p>Usually these digital signal conditioning features should be left at their

  5083. 		default settings.

  5084. 	</p>

  5085. 

  5086. 	<p class=func><span class=keyword>adcHighPassFilterFreeze</span>();</p>

  5087. 	<p class=desc>By default, the analog input (either line-level inputs or mic)

  5088. 		is high-pass filtered, to remove any DC component.  This function

  5089. 		freezes the filter, so the current DC component is still substracted, but

  5090. 		the filter stops tracking any DC or low frequency changes.

  5091. 	</p>

  5092. 	<p class=func><span class=keyword>adcHighPassFilterDisable</span>();</p>

  5093. 	<p class=desc>Completely disable the analog input filter.  DC and sub-audible

  5094. 		low frequencies are allowed to enter the digital signal.  This

  5095. 		<a href="http://openaudio.blogspot.com/2017/03/teensy-audio-board-self-noise.html">may

  5096. 		reduce noise</a> in some cases.

  5097. 	</p>

  5098. 	<p class=func><span class=keyword>adcHighPassFilterEnable</span>();</p>

  5099. 	<p class=desc>Turn the DC-blocking filter back on, if disabled, or

  5100. 		allows it to resume tracking DC and low frequency changes, if

  5101. 		previously frozen. This is the default setting.

  5102. 	</p>

  5103. 	<p class=func><span class=keyword>dacVolume</span>(both);</p>

  5104. 	<p class=desc>Normally output volume should be used with volume(), which

  5105. 		changes the analog gain in the headphone amplifier.  This function

  5106. 		on the other hand controls digital attenuation before conversion to analog, which

  5107. 		reduces resolution, but allows another fine control of output

  5108. 		signal level.  The ranges is 0 to 1.0, with the default (no digital attenuation)

  5109. 		at 1.0.

  5110. 	</p>

  5111. 	<p  class=desc>dacVolume uses zero-crossing detect to avoid clicks, and graceful

  5112. 		ramping is handled by the chip so that a new volume may be set directly in

  5113. 		a single call.

  5114. 	</p>

  5115. 	<p class=func><span class=keyword>dacVolume</span>(left, right);</p>

  5116. 	<p class=desc>Adjust the digital output volume separately on left and

  5117. 		right channels.

  5118. 	</p>

  5119. 	<p class=func><span class=keyword>dacVolumeRamp</span>();</p>

  5120. 	<p class=desc>Enable graceful volume ramping.  The dacVolume adjusts gradually using

  5121. 		an exponential curve.  Pops or loud clicks are avoided when making large

  5122. 		changes in volume level.

  5123. 	</p>

  5124. 	<p class=func><span class=keyword>dacVolumeRampLinear</span>();</p>

  5125. 	<p class=desc>Enable faster volume ramping.  A slight click may be heard during a

  5126. 		large volume change.

  5127. 	</p>

  5128. 	<p class=func><span class=keyword>dacVolumeRampDisable</span>();</p>

  5129. 	<p class=desc>Do not use any gradual ramping.  The zero cross feature still helps

  5130. 		for small changes, but large volume changes may produce a pop or click.

  5131. 	</p>

  5132. 

  5133. 	<h3>Audio Processor</h3>

  5134. 

  5135. 	<p>The optional digital audio processor is capable of implementing

  5136. 		one or more of: automatic volume control, surround sound control,

  5137. 		bass enhancement, and tonal adjustments (either a

  5138. 		simple tone control, or a parametric equalizer, or a graphic equalizer),

  5139. 		in that order.

  5140. 	</p>

  5141. 	<p>These signal processing features are implemented in the SGTL5000 chip,

  5142. 		so they do not consume CPU time on Teensy. However, the order of

  5143. 		these processes is fixed in the hardware.

  5144. 	</p>

  5145. 	<p>It is good practice to mute the outputs before enabling or disabling

  5146. 	the Audio Processor, to avoid clicks or thumps.

  5147. 	</p>

  5148. 

  5149. 	<p class=func><span class=keyword>audioPreProcessorEnable</span>();</p>

  5150. 	<p class=desc>Enable the audio processor to pre-process the input

  5151. 		(from either line-level inputs or microphone) before it's sent

  5152. 		to Teensy by I2S.

  5153. 	</p>

  5154. 	<p class=func><span class=keyword>audioPostProcessorEnable</span>();</p>

  5155. 	<p class=desc>Enable the audio processor to post-process Teensy's

  5156. 		I2S output before it's turned into analog signals for the

  5157. 		headphones and/or line level outputs.

  5158. 	</p>

  5159. 	<p class=func><span class=keyword>audioProcessorDisable</span>();</p>

  5160. 	<p class=desc>Disable the audio processor.

  5161. 	</p>

  5162. 	<p class=func><span class=keyword>autoVolumeControl</span>(maxGain, response, hardLimit, threshold, attack, decay);</p>

  5163. 	<p class=desc>Configures the auto volume control, which is implemented as a compressor/expander

  5164. 	or hard limiter. 	<em>maxGain</em> is the maximum gain that can be applied for expanding, and

  5165. 	can take one of three values: 0 (0dB), 1 (6.0dB) and 2 (12dB). Values greater than 2 are treated

  5166. 	as 2. <em>response</em> controls the integration time for the compressor and can take

  5167. 	four values: 0 (0ms), 1 (25ms), 2 (50ms) or 3 (100ms). Larger values average the volume

  5168. 	over a longer time, allowing short-term peaks through.

  5169. 	</p>

  5170. 	<p class=desc>If <em>hardLimit</em> is 0, a 'soft

  5171. 	knee' compressor is used to progressively compress louder values which are near to or above the

  5172. 	threashold (the louder they are, the greater the compression). If it is 1, a hard compressor

  5173. 	is used (all values above the threashold are the same loudness). The <em>threashold</em> is specified

  5174. 	as a float in the range 0dBFS to -96dBFS, where -18dBFS is a typical value.

  5175. 	<em>attack</em> is a float controlling the rate of decrease in gain when the signal is over

  5176. 	threashold, in dB/s. <em>decay</em> controls how fast gain is restored once the level

  5177. 	drops below threashold, again in dB/s. It is typically set to a longer value than attack.

  5178. 	</p>

  5179. 	<p class=func><span class=keyword>autoVolumeEnable</span>();</p>

  5180. 	<p class=desc>Enables auto volume control, using the previously specified settings.

  5181. 	</p>

  5182. 	<p class=func><span class=keyword>autoVolumeDisable</span>();</p>

  5183. 	<p class=desc>Disables auto volume control.

  5184. 	</p>

  5185. 

  5186. 	<p class=func><span class=keyword>surroundSoundEnable</span>();</p>

  5187. 	<p class=desc>Enable virtual surround processing, to give a broader and

  5188. 	deeper stereo image (even with mono input).

  5189. 	</p>

  5190. 	<p class=func><span class=keyword>surroundSoundDisable</span>();</p>

  5191. 	<p class=desc>Disable virtual surround processing. Before disabling, ramp up

  5192. 	the width to maximum to avoid pops.

  5193. 	</p>

  5194. 	<p class=func><span class=keyword>surroundSound</span>(width);</p>

  5195. 	<p class=desc>Configures virtual surround width from 0 (mono) to 7 (widest).

  5196. 	</p>

  5197. 	<p class=func><span class=keyword>surroundSound</span>(width, select);</p>

  5198. 	<p class=desc>Configures virtual surround width from 0 (mono) to 7 (widest).

  5199. 	<em>select</em> may be set to 1 (disable), 2 (mono input) or 3 (stereo input).

  5200. 	</p>

  5201. 

  5202. 	<p class=func><span class=keyword>enhanceBassEnable</span>();</p>

  5203. 	<p class=desc>Enable bass enhancement. A mono, low-pass filtered copy of

  5204. 	the original stereo signal has bass levels boosted and is then mixed back into

  5205. 	the stereo signal, which is then optionally high pass filtered (to remove

  5206. 	inaudible subsonic frequencies).

  5207. 	</p>

  5208. 	<p class=func><span class=keyword>enhanceBassDisable</span>();</p>

  5209. 	<p class=desc>Disable bass enhancement. Before disabling, ramp down the bass

  5210. 	enhancement level to zero.

  5211. 	</p>

  5212. 	<p class=func><span class=keyword>enhanceBass</span>(lr_lev, bass_lev);</p>

  5213. 	<p class=desc>Configures the bass enhancement by setting the levels of the

  5214. 	original stereo signal and the bass-enhanced mono level which will be mixed together.

  5215. 	There is no high-pass filter.

  5216. 	</p>

  5217. 	<p  class=desc>When changing bass level, call this function repeatedly to ramp up or down the bass in

  5218. 	steps of 0.5dB, to avoid pops.

  5219. 	</p>

  5220. 	<p class=func><span class=keyword>enhanceBass</span>(lr_lev, bass_lev, hpf_bypass, cutoff);</p>

  5221. 	<p class=desc>Configures the bass enhancement by setting the levels of the

  5222. 	original stereo signal and the bass-enhanced mono level which will be mixed together.

  5223. 	The high-pass filter may be enabled (0) or bypassed (1). The cutoff frequency is specified

  5224. 	as follows:

  5225. 	</p>

  5226. 	<pre class="desc">

  5227. value  frequency

  5228.  0      80Hz

  5229.  1     100Hz

  5230.  2     125Hz

  5231.  3     150Hz

  5232.  4     175Hz

  5233.  5     200Hz

  5234.  6     225Hz

  5235. </pre>

  5236. 	<p  class=desc>When changing bass level, call this function repeatedly to ramp up or down the bass in

  5237. 	steps of 0.5dB, to avoid pops.

  5238. 	</p>

  5239. 

  5240. 	<p class=func><span class=keyword>eqSelect</span>(n);</p>

  5241. 	<p class=desc>Selects the type of frequency control, where <em>n</em> is

  5242. 	one of</p>

  5243. 	<p class=desc><b>FLAT_FREQUENCY (0)</b><br>

  5244.     Equalizers and tone controls disabled, flat frequency response.</p>

  5245.     <p class=desc><b>PARAMETRIC_EQUALIZER (1)</b><br>

  5246.     Enables the 7-band parametric equalizer, thus disabling the

  5247. 	tone controls and graphic equalizer.</p>

  5248.     <p class=desc><b>TONE_CONTROLS (2)</b><br>

  5249.     Enables bass and treble tone controls, disabling the parametric

  5250. 	equalization and graphic equalizer.</p>

  5251.     <p class=desc><b>GRAPHIC_EQUALIZER (3)</b><br>

  5252.     Enables the five-band graphic equalizer, disabling the parametric

  5253. 	equalization and tone controls.</p>

  5254. 

  5255. 

  5256. 	<p class=func><span class=keyword>eqBands</span>(bass, treble);</p>

  5257. 	<p class=desc>Configures bass and treble tone controls, which are

  5258. 	implemented as one second order low pass filter (bass) in parallel with

  5259. 	one second order high pass filter (treble).

  5260. 	</p>

  5261. 	<p class=desc>When changing bass or treble level, call this function repeatedly to ramp

  5262. 	up or down the level in steps of 0.04 (=0.5dB) or so, to avoid pops.

  5263. 	</p>

  5264. 	<p class=func><span class=keyword>eqBands</span>(bass, mid_bass, midrange, mid_treble, treble);</p>

  5265. 	<p class=desc>Configures the graphic equalizer. It is implemented by five parallel,

  5266. 	second order biquad filters with fixed frequencies of 115Hz, 330Hz, 990Hz, 3kHz,

  5267. 	and 9.9kHz. Each band has a range of adjustment from 1.00 (+12dB) to -1.00 (-11.75dB).

  5268. 	</p>

  5269. 	<p class=func><span class=keyword>eqBand</span>(bandNum, n);</p>

  5270. 	<p class=desc>Configures the gain or cut on one band in the graphic equalizer.

  5271. 	<em>bandnum</em> can range from 1 to 5; <em>n</em> is a float in the range 1.00 to -1.00.

  5272. 	</p>

  5273. 	<p  class=desc>When changing a band, call this function repeatedly to ramp up the gain in steps of 0.5dB,

  5274. 	to avoid pops.

  5275. 	</p>

  5276. 

  5277. 	<p class=func><span class=keyword>eqFilter</span>(filterNum, filterParameters);</p>

  5278. 	<p class=desc>Configurs the parametric equalizer. The number of filters (1 to 7)

  5279. 	is specified along with  a pointer to an array of filter coefficients.

  5280. 	The parametric equalizer is implemented using 7 cascaded, second order bi-quad

  5281. 	filters whose frequencies, gain, and Q may be freely configured, but each filter

  5282. 	can only be specified as a set of filter coefficients.

  5283. 	</p>

  5284. 	<p class=func><span class=keyword>eqFilterCount</span>(n);</p>

  5285. 	<p class=desc>Enables zero or more of the already enabled parametric filters.

  5286. 	</p>

  5287. 

  5288. 	<h3>Examples</h3>

  5289. 	<p>Nearly all of the library's examples use this object.  These

  5290. 		examples demonstrate its special features.

  5291. 	</p>

  5292. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; PassThroughStereo

  5293. 	</p>

  5294. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; SGTL5000 &gt; dap_bass_enhance

  5295. 	</p>

  5296. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; SGTL5000 &gt; dap_avc_agc

  5297. 	</p>

  5298. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; SGTL5000 &gt; balanceDAC

  5299. 	</p>

  5300. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; SGTL5000 &gt; balanceHP

  5301. 	</p>

  5302. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; SGTL5000 &gt; CalcBiquadToneControlDAP

  5303. 	</p>

  5304. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; SGTL5000 &gt; VolumeRamp

  5305. 	</p>

  5306. 	<h3>Notes</h3>

  5307. 	<p>TODO: add example with rock/classical/speech presets, where rock uses bass boost

  5308. 	and surround enhancement while speech uses bandpass filtering and auto volume control

  5309. 	compression.

  5310. 	</p>

  5311. 	<p>TODO: add example with two analogRead pots for bass and treble to demonstrate ramping.

  5312. 	</p>

  5313. </script>

  5314. <script type="text/x-red" data-template-name="AudioControlSGTL5000">

  5315. 	<div class="form-row">

  5316. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  5317. 		<input type="text" id="node-input-name" placeholder="Name">

  5318. 	</div>

  5319. </script>

  5320. 

  5321. <script type="text/x-red" data-help-name="AudioControlWM8731">

  5322. 	<h3>Summary</h3>

  5323. 	<div class=tooltipinfo>

  5324. 	<p>Control a WM8731 chip in slave mode, where it receives all clocks from Teensy</p>

  5325. 	</div>

  5326. 	<h3>Audio Connections</h3>

  5327. 	<p>This object has no audio inputs or outputs.  Separate i2s objects

  5328. 		are used to send and receive audio data.  I2S master mode objects

  5329. 		must be used, since this control object configures the WM8731 into

  5330. 		slave mode.

  5331. 	</p>

  5332. 	<h3>Functions</h3>

  5333. 	<p class=func><span class=keyword>enable</span>();</p>

  5334. 	<p class=desc>Turn on the WS8731.

  5335. 	</p>

  5336. 	<p class=func><span class=keyword>disable</span>();</p>

  5337. 	<p class=desc>not implemented

  5338. 	</p>

  5339. 	<p class=func><span class=keyword>volume</span>(level);</p>

  5340. 	<p class=desc>Set the headphone volume level. Range is 0 to 1.0.

  5341. 	</p>

  5342. 	<p class=func><span class=keyword>inputLevel</span>(level);</p>

  5343. 	<p class=desc>Adjust the line level input gain.  Range is 0 to 1.0.

  5344. 	</p>

  5345. 	<p class=func><span class=keyword>inputSelect</span>(input);</p>

  5346. 	<p class=desc>Select which input to use: AUDIO_INPUT_LINEIN or AUDIO_INPUT_MIC.

  5347. 	</p>

  5348. 	<!--

  5349. <h3>Examples</h3>

  5350. 	<p class=exam>File &gt; Examples &gt; Audio &gt;

  5351. 	</p>

  5352. -->

  5353. 	<h3>Notes</h3>

  5354. 	<p></p>

  5355. </script>

  5356. <script type="text/x-red" data-template-name="AudioControlWM8731">

  5357. 	<div class="form-row">

  5358. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  5359. 		<input type="text" id="node-input-name" placeholder="Name">

  5360. 	</div>

  5361. </script>

  5362. 

  5363. <script type="text/x-red" data-help-name="AudioControlWM8731master">

  5364. 	<h3>Summary</h3>

  5365. 	<div class=tooltipinfo>

  5366. 	<p>Control a WM8731 chip in master mode, where it controls all I2S timing.</p>

  5367. 	</div>

  5368. 	<h3>Audio Connections</h3>

  5369. 	<p>This object has no audio inputs or outputs.  Separate i2s objects

  5370. 		are used to send and receive audio data.  I2S slave mode objects

  5371. 		must be used, since this control object configures the WM8731 into

  5372. 		master mode.

  5373. 	</p>

  5374. 	<h3>Functions</h3>

  5375. 	<p class=func><span class=keyword>enable</span>();</p>

  5376. 	<p class=desc>Turn on the WS8731, in I2S Master mode.  I2S slave mode

  5377. 		communication must be used by Teensy.

  5378. 	</p>

  5379. 	<p class=func><span class=keyword>disable</span>();</p>

  5380. 	<p class=desc>not implemented

  5381. 	</p>

  5382. 	<p class=func><span class=keyword>volume</span>(level);</p>

  5383. 	<p class=desc>Set the headphone volume level. Range is 0 to 1.0.

  5384. 	</p>

  5385. 	<p class=func><span class=keyword>inputLevel</span>(level);</p>

  5386. 	<p class=desc>Adjust the line level input gain.  Range is 0 to 1.0.

  5387. 	</p>

  5388. 	<p class=func><span class=keyword>inputSelect</span>(input);</p>

  5389. 	<p class=desc>Select which input to use: AUDIO_INPUT_LINEIN or AUDIO_INPUT_MIC.

  5390. 	</p>

  5391. 	<h3>Examples</h3>

  5392. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; WM8731MikroSine

  5393. 	</p>

  5394. 	<h3>Notes</h3>

  5395. 	<p>The WM8731 will implement a sample rate of its crystal frequency divided by 256.

  5396. 		To get the 44.1 kHz sample rate the Teensy Audio Library expects, an

  5397. 		11.2896 MHz crystal should be used.

  5398. 	</p>

  5399. </script>

  5400. <script type="text/x-red" data-template-name="AudioControlWM8731master">

  5401. 	<div class="form-row">

  5402. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  5403. 		<input type="text" id="node-input-name" placeholder="Name">

  5404. 	</div>

  5405. </script>

  5406. 

  5407. <script type="text/x-red" data-help-name="AudioControlAK4558">

  5408. 	<h3>Summary</h3>

  5409. 	<div class=tooltipinfo>

  5410. 	<p>Control the AK4558 chip on the <a href="https://hackaday.io/project/8567-hifi-audio-codec-module" target="_blank">HiFi Audio CODEC Module</a>

  5411. 	in slave mode, where the Teensy controls all I2S timing.</p>

  5412. 	</div>

  5413. 	<h3>Audio Connections</h3>

  5414. 	<p>This object has no audio inputs or outputs.  Separate I2S objects

  5415. 		are used to send and receive audio data.

  5416. 	</p>

  5417. 	<h3>Functions</h3>

  5418. 	<p class=func><span class=keyword>enable</span>();</p>

  5419. 	<p class=desc>Enables the CODEC to work with 44.1 KHz - 16 bit data. This function does not enable the ADC/DAC modules.

  5420. 	</p>

  5421. 	<p class=func><span class=keyword>enableIn</span>();</p>

  5422. 	<p class=desc>Enables the ADC module.

  5423. 	</p>

  5424. 	<p class=func><span class=keyword>enableOut</span>();</p>

  5425. 	<p class=desc>Enables the DAC module.

  5426. 	</p>

  5427. 	<p class=func><span class=keyword>disable</span>();</p>

  5428. 	<p class=desc>Disables the ADC and the DAC modules.

  5429. 	</p>

  5430. 	<p class=func><span class=keyword>disableIn</span>();</p>

  5431. 	<p class=desc>Disable the ADC module.

  5432. 	</p>

  5433. 	<p class=func><span class=keyword>disableOut</span>();</p>

  5434. 	<p class=desc>Disable the DAC module.

  5435. 	</p>

  5436. 	<p class=func><span class=keyword>volume</span>(level);</p>

  5437. 	<p class=desc>Accepts a float in range 0.0-1.0 and sets the line output volume accordingly.

  5438. 	</p>

  5439. 	<p class=func><span class=keyword>volumeLeft</span>(level);</p>

  5440. 	<p class=desc>Accepts a float in range 0.0-1.0 and sets the left line output volume accordingly.

  5441. 	</p>

  5442. 	<p class=func><span class=keyword>volumeRight</span>(level);</p>

  5443. 	<p class=desc>Accepts a float in range 0.0-1.0 and sets the right line output volume accordingly.

  5444. 	</p>

  5445. 	<p class=func><span class=keyword>inputLevel</span>(level);</p>

  5446. 	<p class=desc>NOT SUPPORTED BY THE AK4558

  5447. 	</p>

  5448. 	<p class=func><span class=keyword>inputSelect</span>(input);</p>

  5449. 	<p class=desc>not implemented yet

  5450. 	</p>

  5451. 	<h3>Examples</h3>

  5452. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; AK4558 &gt; PassthroughTest

  5453. 	</p>

  5454. 	<p class=exam>File &gt; Examples &gt; Audio &gt; HardwareTesting &gt; AK4558 &gt; SineOutTest

  5455. 	</p>

  5456. 	<h3>Notes</h3>

  5457. 	<p>TODO: Implement inputSelect() function to enable mono left, mono right, stereo operation.</p>

  5458. 	<p>TODO: Implement ADC and DAC filters control.</p>

  5459. 	<p>TODO: Implement DAC level attenuator attack rate modifier.</p>

  5460. </script>

  5461. <script type="text/x-red" data-template-name="AudioControlAK4558">

  5462. 	<div class="form-row">

  5463. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  5464. 		<input type="text" id="node-input-name" placeholder="Name">

  5465. 	</div>

  5466. </script>

  5467. 

  5468. <script type="text/x-red" data-help-name="AudioControlCS4272">

  5469. 	<h3>Summary</h3>

  5470. 	<div class=tooltipinfo>

  5471. 	<p>Control the CS4272 chip on the <a href="https://hackaday.io/project/5912-teensy-super-audio-board" target="_blank">Super Audio Board</a>.

  5472. 	</p>

  5473. 	<p>TODO: does this control object put the CS4272 into I2S master or slave mode</p>

  5474. 	</div>

  5475. 	<h3>Audio Connections</h3>

  5476. 	<p>This object has no audio inputs or outputs.  Separate I2S objects

  5477. 		are used to send and receive audio data.

  5478. 	</p>

  5479. 	<h3>Functions</h3>

  5480. 	<p class=func><span class=keyword>enable</span>();</p>

  5481. 	<p class=desc>Enables the CODEC to work with 44.1 KHz - 16 bit data. This function does not enable the ADC/DAC modules.

  5482. 	</p>

  5483. 	<p class=func><span class=keyword>volume</span>(vol);</p>

  5484. 	<p class=desc>Set the volume level. Range is 0 to 1.0.

  5485. 	</p>

  5486. 	<p class=func><span class=keyword>volume</span>(left, right);</p>

  5487. 	<p class=desc>Set the volume level. Range is 0 to 1.0.

  5488. 	</p>

  5489. 	<p class=func><span class=keyword>dacVolume</span>(vol);</p>

  5490. 	<p class=desc>Set the volume level. Range is 0 to 1.0.  TODO: what's the

  5491. 		distinction between volume() and dacVolume()?

  5492. 	</p>

  5493. 	<p class=func><span class=keyword>dacVolume</span>(left, right);</p>

  5494. 	<p class=desc>Set the volume level. Range is 0 to 1.0.

  5495. 	</p>

  5496. 

  5497. 	<p class=func><span class=keyword>muteOutput</span>();</p>

  5498. 	<p class=desc>TODO: description

  5499. 	</p>

  5500. 	<p class=func><span class=keyword>unmuteOutput</span>();</p>

  5501. 	<p class=desc>TODO: description

  5502. 	</p>

  5503. 	<p class=func><span class=keyword>muteInput</span>();</p>

  5504. 	<p class=desc>TODO: description

  5505. 	</p>

  5506. 	<p class=func><span class=keyword>unmuteInput</span>();</p>

  5507. 	<p class=desc>TODO: description

  5508. 	</p>

  5509. 	<p class=func><span class=keyword>enableDither</span>();</p>

  5510. 	<p class=desc>TODO: description

  5511. 	</p>

  5512. 	<p class=func><span class=keyword>disableDither</span>();</p>

  5513. 	<p class=desc>TODO: description

  5514. 	</p>

  5515. 

  5516. 	<h3>Hardware</h3>

  5517. 	<p>Pin 2 must be connected to the CS4272 reset.  SDA &amp; SCL are used for all control.

  5518. 	</p>

  5519. 

  5520. 	<h3>Notes</h3>

  5521. </script>

  5522. <script type="text/x-red" data-template-name="AudioControlCS4272">

  5523. 	<div class="form-row">

  5524. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  5525. 		<input type="text" id="node-input-name" placeholder="Name">

  5526. 	</div>

  5527. </script>

  5528. 

  5529. <script type="text/x-red" data-help-name="AudioControlCS42448">

  5530. 	<h3>Summary</h3>

  5531. 	<div class=tooltipinfo>

  5532. 	<p>Control the CS42448 chip in TDM mode, for 6 inputs and 8 outputs.

  5533. 	</p>

  5534. 	<p align=center><img src="img/cs42448.jpg"></p>

  5535. 	</div>

  5536. 	</div>

  5537. 	<h3>Audio Connections</h3>

  5538. 	<p>This object has no audio inputs or outputs.  Separate TDM objects

  5539. 		are used to send and receive audio data.

  5540. 	</p>

  5541. 	<h3>Functions</h3>

  5542. 	<p class=func><span class=keyword>enable</span>();</p>

  5543. 	<p class=desc>Enables the CS42448 to work in TDM mode.

  5544. 	</p>

  5545. 	<p class=func><span class=keyword>volume</span>(level);</p>

  5546. 	<p class=desc>Set the volume level for all output channels. Range is 0 to 1.0.

  5547. 	</p>

  5548. 	<p class=func><span class=keyword>volume</span>(channel, level);</p>

  5549. 	<p class=desc>Set the volume level for a single output. Channel is 1 to 8.  Range is 0 to 1.0.

  5550. 	</p>

  5551. 	<p class=func><span class=keyword>inputLevel</span>(level);</p>

  5552. 	<p class=desc>Set the input gain level for all input channels. Range is 0 to 15.85.

  5553. 	</p>

  5554. 	<p class=func><span class=keyword>inputLevel</span>(channel, level);</p>

  5555. 	<p class=desc>Set the input gain level for a single input. Channel is 1 to 6. Range is 0 to 15.85.

  5556. 	</p>

  5557. 	<h3>Hardware</h3>

  5558. 	<p>Tested with this <a href="https://oshpark.com/shared_projects/2Yj6rFaW">

  5559. 		CS42448 Circuit Board</a>.

  5560. 	</p>

  5561. 	<p align=center><img src="img/tdm.jpg"></p>

  5562. 	</div>

  5563. 	<h3>Notes</h3>

  5564. </script>

  5565. <script type="text/x-red" data-template-name="AudioControlCS42448">

  5566. 	<div class="form-row">

  5567. 		<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>

  5568. 		<input type="text" id="node-input-name" placeholder="Name">

  5569. 	</div>

  5570. </script>

  5571. 

  5572. 

  5573. 

  5574. </body>

  5575. </html>