<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html class="client-nojs" dir="ltr" lang="en">
<head>
<meta charset="UTF-8" />
<title>Modules/SoundCard - OpenSCADAWiki</title>
<meta content="MediaWiki 1.26.4" name="generator" />
<link href="https://www.gnu.org/copyleft/fdl.html" rel="copyright" />
<link href="../files/doc.css" rel="stylesheet" /></head>
<body><div class="floatright"><a href="../index.html"><img alt="OpenSCADA" src="../../en/files/index.png" /></a></div><div id="mw_header">
<div class="mw-indicators">
</div>
<h1 id="firstHeading" lang="en">Modules/SoundCard</h1>
</div><div class="mw-content-ltr" dir="ltr" id="mw-content-text" lang="en"><div class="mw-pt-languages" dir="ltr" lang="en"><div class="mw-pt-languages-list autonym"><span class="mw-pt-languages-ui mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete">English</span> • ‎<a class="mw-pt-progress mw-pt-progress--complete" href="../../ru/Modules/SoundCard.html" title="Модули/Ð—Ð²ÑƒÐºÐ¾Ð²Ð°Ñ ÐºÐ°Ñ€Ñ‚Ð° (87% translated)">mRussian</a> • ‎<a class="mw-pt-progress mw-pt-progress--complete" href="../../uk/Modules/SoundCard.html" title="Модулі/Звукова карта (100% translated)">УкраїнÑька</a></div></div>
<table class="wikitable">
<tr>
<th> Module </th>
<th> Name </th>
<th> Version </th>
<th> License </th>
<th> Source </th>
<th> Languages </th>
<th> Platforms </th>
<th> Type </th>
<th> Author </th>
<th> Description
</th></tr>
<tr>
<td> <a href="../Modules/SoundCard.html" title="Special:MyLanguage/Modules/SoundCard">SoundCard</a> </td>
<td> Sound card </td>
<td> 0.8 </td>
<td> GPL2 </td>
<td> daq_SoundCard.so </td>
<td> en,uk,ru,de </td>
<td> x86,x86_64,ARM
</td>
<td> DAQ </td>
<td> Roman Savochenko<br />Maxim Lysenko (2009) — the page translation </td>
<td> Provides an access to the sound card.
</td></tr></table>
<div class="toc" id="toc"><div id="toctitle"><h2>Contents</h2></div>
<ul>
<li class="toclevel-1 tocsection-1"><a href="#Controller_object_of_the_data"><span class="tocnumber">1</span> <span class="toctext">Controller object of the data</span></a></li>
<li class="toclevel-1 tocsection-2"><a href="#Parameters"><span class="tocnumber">2</span> <span class="toctext">Parameters</span></a></li>
</ul>
</div>
<p>This module is designed to provide data from the inputs of sound cards of the system. The module is based on the multi-platform library of work with sound PortAudio (<a class="external free" href="http://www.portaudio.com" rel="nofollow noreferrer noopener" target="_blank">http://www.portaudio.com</a>). The feature of this library is the unified API, which allows you to easily adapt this module to work on different platforms and even different audio subsystems on a single platform.
</p><p>Structure of the module reflections of the object "Controller" of the subsystem "Data acquisition" on a separate audio input device available in the system. The object "Parameter" of the subsystem "Data acquisition" reflects a separate channel available from the sound input device to the attribute "val". The most functional is to use the attribute "val" in conjunction with the archive, or at least with its buffer. In the case of the archiving enabling the data of the channel of audio input are placed in the buffer of the archive by the packages with the frequency of the data acquisition of the input device that allows you to perform further operations on that data. In addition, the last package value is installed as the current value of the attribute. In the case of archive absence operation of the last package value placing as the current value of the attribute is performed only.
</p><p>Also, the module implements the functions of the horizontal reservation, that is working in conjunction with the remote station of the same level.
</p>
<h2><span class="mw-headline" id="Controller_object_of_the_data"><span class="mw-headline-number">1</span> Controller object of the data</span></h2>
<p>To add an audio input device a controller object is created and configured in OpenSCADA. Example of the configuration tab of the controller object is shown in Figure 1.
</p>
<div class="center"><div class="thumb tnone"><div class="thumbinner" style="width:776px;"><a class="image" href="http://oscada.org/wiki/File:SoundCard_cntr.png"><img class="thumbimage" height="647" src="../files/SoundCard_cntr.png" width="774" /></a> <div class="thumbcaption">Fig.1. Configuration tab of a controller object.</div></div></div></div>
<p>From this tab you can set:
</p>
<ul><li> State of the controller object, as follows: status, "Enabled", "Running" and the storage name containing the configuration.</li>
<li> Identifier, name and description of the controller.</li>
<li> The state "Enabled" and "Running", in which the controller object must be translated at start up.</li>
<li> Card device from the list of available ones.</li>
<li> Frequency of values acquisition of cards in Hertz.</li>
<li> Type of values of acquisition from the list: "Real 32", "Integer 32" and "Integer 16".</li></ul>
<h2><span class="mw-headline" id="Parameters"><span class="mw-headline-number">2</span> Parameters</span></h2>
<p>The module provides only one the "Standard (std)" type of the parameters with the parameters table name "SoundCard_{CntrId}".
</p><p>To add a channel of input sound device a parameter of the controller object is created and configured in OpenSCADA. Example of the configuration tab of the parameter is shown in Figure 2.
</p>
<div class="center"><div class="thumb tnone"><div class="thumbinner" style="width:756px;"><a class="image" href="http://oscada.org/wiki/File:SoundCard_prm.png"><img class="thumbimage" height="543" src="../files/SoundCard_prm.png" width="754" /></a> <div class="thumbcaption">Fig.2. Configuration tab of a parameter.</div></div></div></div>
<p>From this tab you can set:
</p>
<ul><li> Type of the parameter and indicate the status "Enabled".</li>
<li> Id, name and description of the parameter.</li>
<li> State, in which the parameter must be translated at boot: "Enabled".</li>
<li> Channel of the audio input device from the list of available channels.</li></ul>
<p>Tab of attributes of the parameter has the form presented in Figure 3, the tab of the values of the attribute's archive "val" is presented in Figure 4.
</p>
<div class="center"><div class="thumb tnone"><div class="thumbinner" style="width:774px;"><a class="image" href="http://oscada.org/wiki/File:SoundCard_prm_a.png"><img class="thumbimage" height="519" src="../files/SoundCard_prm_a.png" width="772" /></a> <div class="thumbcaption">Fig.3. Tab of attributes of a parameter.</div></div></div></div>
<div class="center"><div class="thumb tnone"><div class="thumbinner" style="width:1009px;"><a class="image" href="http://oscada.org/wiki/File:SoundCard_arch_val.png"><img class="thumbimage" height="620" src="../files/SoundCard_arch_val.png" width="1007" /></a> <div class="thumbcaption">Fig.4. Tab of values of an archive of the attribute "val".</div></div></div></div>
</div><table style="border-top: dotted 2px #999999; margin-top: 20pt; color: gray;" width="100%"><tr><td style="text-align: left;" width="40%"><a href="http://oscada.org/wiki/Modules/SoundCard/en">Modules/SoundCard/en</a> - <a href="http://oscada.org/en/main/about-the-project/licenses/">GFDL</a></td><td style="text-align: center;">April 2025</td><td style="text-align: right;" width="40%">OpenSCADA 1+r3018</td></tr></table></body>
</html>