[processor-sdk/performance-audio-sr.git] / psdk_cust / ipc_3_43_00_00_eng / docs / cdoc / ti / sdo / ipc / notifyDrivers / NotifyDriverShm.html
1 <html>
2 <head>
3 <title>module ti.sdo.ipc.notifyDrivers.NotifyDriverShm</title>
4 <meta name="description" content="A shared memory driver for the Notify Module">
5 <link rel="stylesheet" type="text/css" href="../../../../xdoc.css" />
6 </head>
7 <body><div id="xdocWrapper"><div id="xdocContent">
8 <table class="xdocHdr"><tr>
9 <td class="xdocHdrTitle"><span class="xdoc-kw1">module</span> <span class="xdoc-id">ti.sdo.ipc.notifyDrivers.</span><span class="xdoc-id">NotifyDriverShm</span></td>
10 <td class="xdocHdrArrow">
11 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverCirc.html" title="module NotifyDriverCirc"><img class="xdocHdrArrow" src="../../../../Arrow_left.png"/></a></td>
12 <td class="xdocHdrArrow">
13 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/package.html" title="package ti.sdo.ipc.notifyDrivers"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
14 <td class="xdocHdrArrow">
15 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifySetupNull.html" title="module NotifySetupNull"><img class="xdocHdrArrow" src="../../../../Arrow_right.png"/></a></td>
16 </table>
17 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html">index URL</a></div>
18 <p class="xdocHdrSummary">A shared memory driver for the Notify Module</p>
19 <ul class="xdocToc">
20 <li class="xdocToc"><a class="xdocToc" href="#targ-synop">C synopsis</a></li>
21 <li class="xdocToc2"><a class="xdocToc" href="#xdocElems">Individual elements</a></li>
22 <li class="xdocToc"><a class="xdocToc" href="#meta-synop">Configuration settings</a></li>
23 <li class="xdocToc2"><a class="xdocToc" href="#xdocMetaElems">Individual elements</a></li>
24 </ul>
25 <div class="xdocBrief">
26 This is a <a class="xdoc-link" href="../../../../ti/sdo/ipc/Notify.html" title="ti.sdo.ipc.Notify">ti.sdo.ipc.Notify</a> driver that utilizes shared memory
27 and inter-processor hardware interrupts for notification between cores.
28 This driver supports caching and currently expects a cache line size of 128
29 Bytes. Event priorities are supported and correspond to event numbers used
30 to register the events.
31 [ <a class="xdocBrief" href="#xdoc-desc">more</a> ... ]
32 </div>
33 <span id='targ-synop'></span>
34 <table class="xdocLabel"><tr>
35 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2">C</span></tt> synopsis</td>
36 <td class="xdocLabelCenter">target-domain</td>
37 <td class="xdocLabelRight">sourced in <a class="xdocLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm-src.html"><span class="xdocLabelFile">ti/sdo/ipc/notifyDrivers/NotifyDriverShm.xdc</span></a></td>
38 </tr></table>
39 <div class="xdocSynT">
40 <div class="xdocSynCode">
41 <tt></tt><span class="xdoc-kw3">#include</span> <span class="xdoc-id"><ti/sdo/ipc/notifyDrivers/NotifyDriverShm.h></span>
42 </div>
43 <table cellspacing="0" cellpadding="0" border="0">
44 <tr><td colspan='2'><div class='xdocSynTblHdr'>Functions</div></td></tr>
46 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Void</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#per-instance_config_parameters"><span class="xdoc-id">NotifyDriverShm_Params_init</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Initialize this config-params structure with supplier-specified defaults before instance creation</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> *params);</div></td></tr>
47 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">SizeT</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#shared.Mem.Req"><span class="xdoc-id">NotifyDriverShm_sharedMemReq</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Amount of shared memory required for creation of each instance</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> *<span class="xdoc-id">params</span>);</div></td></tr>
48 <tr><td colspan="2"><div class="xdocSynFxnCat">Functions common to all INotifyDriver modules</div></td></tr>
50 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Void</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#disable"><span class="xdoc-id">NotifyDriverShm_disable</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Disable a NotifyDriver instance</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);</div></td></tr>
51 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Void</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#disable.Event"><span class="xdoc-id">NotifyDriverShm_disableEvent</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Disable an event</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);</div></td></tr>
52 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Void</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#enable"><span class="xdoc-id">NotifyDriverShm_enable</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Enable a NotifyDriver instance</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);</div></td></tr>
53 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Void</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#enable.Event"><span class="xdoc-id">NotifyDriverShm_enableEvent</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Enable an event</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);</div></td></tr>
54 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Void</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#register.Event"><span class="xdoc-id">NotifyDriverShm_registerEvent</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Register a callback to an event</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);</div></td></tr>
55 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Int</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#send.Event"><span class="xdoc-id">NotifyDriverShm_sendEvent</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Send a signal to an event</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">payload</span>, <span class="xdoc-kw2">Bool</span> <span class="xdoc-id">waitClear</span>);</div></td></tr>
56 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw2">Void</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#unregister.Event"><span class="xdoc-id">NotifyDriverShm_unregisterEvent</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Remove an event listener from an event</span></span></a>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);</div></td></tr>
57 <tr><td class="xdocSynFxnCat" colspan="2"><div class="xdocSynFxnCat">Functions common to all target instances</div></td></tr>
59 <tr>
60 <td></td>
61 <td>
62 <div class="xdocSynTblPack">
63 <a class="xdocSynGo" href="#per-instance_object_types"><span class="xdoc-id">NotifyDriverShm_handle</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Convert this instance structure pointer into an instance handle</span></span></a>,
64 <a class="xdocSynGo" href="#per-instance_convertors"><span class="xdoc-id">NotifyDriverShm_Handle_downCast</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// conditionally move one level down the inheritance hierarchy; NULL upon failure</span></span></a>,
65 <a class="xdocSynGo" href="#per-instance_built-ins"><span class="xdoc-id">NotifyDriverShm_Handle_label</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The label associated with this instance object</span></span></a>,
66 <a class="xdocSynGo" href="#per-instance_built-ins"><span class="xdoc-id">NotifyDriverShm_Handle_name</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The name of this instance object</span></span></a>,
67 <a class="xdocSynGo" href="#per-instance_convertors"><span class="xdoc-id">NotifyDriverShm_Handle_upCast</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// unconditionally move one level up the inheritance hierarchy</span></span></a>,
68 <a class="xdocSynGo" href="#per-instance_built-ins"><span class="xdoc-id">NotifyDriverShm_Object_count</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The number of statically-created instance objects</span></span></a>,
69 <a class="xdocSynGo" href="#per-instance_built-ins"><span class="xdoc-id">NotifyDriverShm_Object_first</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The handle of the first dynamically-created instance object, or NULL</span></span></a>,
70 <a class="xdocSynGo" href="#per-instance_built-ins"><span class="xdoc-id">NotifyDriverShm_Object_get</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The handle of the i-th statically-created instance object (array == NULL)</span></span></a>,
71 <a class="xdocSynGo" href="#per-instance_built-ins"><span class="xdoc-id">NotifyDriverShm_Object_heap</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The heap used to allocate dynamically-created instance objects</span></span></a>,
72 <a class="xdocSynGo" href="#per-instance_built-ins"><span class="xdoc-id">NotifyDriverShm_Object_next</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The handle of the next dynamically-created instance object, or NULL</span></span></a>,
73 <a class="xdocSynGo" href="#per-instance_object_types"><span class="xdoc-id">NotifyDriverShm_struct</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Convert this instance handle into an instance structure pointer</span></span></a>
74 </div>
75 </td>
76 </tr>
77 <tr><td class="xdocSynFxnCat" colspan="2"><div class="xdocSynFxnCat">Functions common to all target modules</div></td></tr>
79 <tr>
80 <td></td>
81 <td>
82 <div class="xdocSynTblPack">
83 <a class="xdocSynGo" href="#module-wide_built-ins"><span class="xdoc-id">NotifyDriverShm_Module_getMask</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Returns the diagnostics mask for this module</span></span></a>,
84 <a class="xdocSynGo" href="#module-wide_built-ins"><span class="xdoc-id">NotifyDriverShm_Module_hasMask</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Test whether this module has a diagnostics mask</span></span></a>,
85 <a class="xdocSynGo" href="#module-wide_built-ins"><span class="xdoc-id">NotifyDriverShm_Module_heap</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The heap from which this module allocates memory</span></span></a>,
86 <a class="xdocSynGo" href="#module-wide_built-ins"><span class="xdoc-id">NotifyDriverShm_Module_id</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Get this module's unique id</span></span></a>,
87 <a class="xdocSynGo" href="#module-wide_built-ins"><span class="xdoc-id">NotifyDriverShm_Module_setMask</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Set the diagnostics mask for this module</span></span></a>,
88 <a class="xdocSynGo" href="#module-wide_built-ins"><span class="xdoc-id">NotifyDriverShm_Module_startupDone</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Test if this module has completed startup</span></span></a>
89 </div>
90 </td>
91 </tr>
92 <tr><td colspan='2'><div class='xdocSynTblHdr'>Typedefs</div></td></tr>
94 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw1">typedef</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Object">NotifyDriverShm_Object</a> *</div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#per-instance_object_types"><span class="xdoc-id">NotifyDriverShm_Handle</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Client reference to an instance object</span></span></a>;</div></td></tr>
95 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw1">typedef</span> <span class="xdoc-kw1">struct</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#per-instance_object_types"><span class="xdoc-id">NotifyDriverShm_Object</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Opaque internal representation of an instance object</span></span></a> <span class="xdoc-id">NotifyDriverShm_Object</span>;</div></td></tr>
96 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw1">typedef</span> <span class="xdoc-kw1">struct</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#per-instance_config_parameters"><span class="xdoc-id">NotifyDriverShm_Params</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Instance config-params structure</span></span></a> ...</div></td></tr>
97 <tr valign="top"><td class="xdocSynDecl" nowrap><div class="xdocSynTblType"><tt></tt><span class="xdoc-kw1">typedef</span> <span class="xdoc-kw1">struct</span> </div></td><td class="xdocSynDecl"><div class="xdocSynTblDecl"><a class="xdocSynGo" href="#per-instance_object_types"><span class="xdoc-id">NotifyDriverShm_Struct</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Opaque client structure large enough to hold an instance object</span></span></a> <span class="xdoc-id">NotifyDriverShm_Struct</span>;</div></td></tr>
98 </table>
99 <div class="xdocSynSpacer"> </div>
100 </div>
101 <span id="xdoc-desc"></span>
102 <span id="xdoc-sect-1"></span>
103 <div class="xdocSect">DETAILS</div>
104 <div class="xdocText">This is a <a class="xdoc-link" href="../../../../ti/sdo/ipc/Notify.html" title="ti.sdo.ipc.Notify">ti.sdo.ipc.Notify</a> driver that utilizes shared memory
105 and inter-processor hardware interrupts for notification between cores.
106 This driver supports caching and currently expects a cache line size of 128
107 Bytes. Event priorities are supported and correspond to event numbers used
108 to register the events.</div>
109 <div class="xdocText">This driver is designed to work with a variety of devices, each with
110 distinct interrupt mechanisms. Therefore, this module needs to be plugged
111 with an appropriate module that implements the <a class="xdoc-link" href="IInterrupt.html" title="IInterrupt">IInterrupt</a> interface
112 for a given device.</div>
113 <div class="xdocText">The driver utilizes shared memory in the manner indicated by the following
114 diagram.</div>
115 <div class="xdocText"><PRE class="Example">
116 NOTE: Processors '0' and '1' correspond to the processors with lower and
117 higher MultiProc ids, respectively
119 sharedAddr -> --------------------------- bytes
120 | recvInitStatus (0) | 4 -\
121 | sendInitStatus (0) | 4 |= sizeof(ProcCtrl)
122 | eventRegMask (0) | 4 |
123 | eventEnableMask (0) | 4 -/
124 | [PADDING] (if needed) |
125 |-------------------------|
126 | recvInitStatus (1) | 4
127 | sendInitStatus (1) | 4
128 | eventRegMask (1) | 4
129 | eventEnableMask (1) | 4
130 | [PADDING] (if needed) |
131 |-------------------------|
132 | eventEntry_0 (0) | 12 -> sizeof(EventEntry)
133 | [PADDING] (if needed) |
134 |-------------------------|
135 | eventEntry_1 (0) | 12
136 | [PADDING] (if needed) |
137 |-------------------------|
138 ... ...
139 |-------------------------|
140 | eventEntry_N (0) | 12
141 | [PADDING] (if needed) |
142 |-------------------------|
143 | eventEntry_0 (1) | 12
144 | [PADDING] (if needed) |
145 |-------------------------|
146 | eventEntry_1 (1) | 12
147 | [PADDING] (if needed) |
148 |-------------------------|
149 ... ...
150 |-------------------------|
151 | eventEntry_N (1) | 12
152 | [PADDING] (if needed) |
153 |-------------------------|
156 Legend:
157 (0), (1) : Memory that belongs to the proc with lower and higher
158 MultiProc.id, respectively
159 |----| : Cache line boundary
160 N : Notify_numEvents - 1
162 </PRE></div>
163 <div id="xdocSep">
164 </div>
165 <div id="xdocElems">
166 <div class="xdocSynSpacer"> </div>
167 <a class="xdocAnchor" id="shared.Mem.Req"></a>
168 <table class="xdocHdr"><tr>
169 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">sharedMemReq</span>() <small><span class="xdocSynSum">// module-wide</span></small></td>
170 <td class="xdocHdrArrow">
171 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
172 </table>
173 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#shared.Mem.Req">index URL</a></div>
174 <p class="xdocHdrSummaryDcl">Amount of shared memory required for creation of each instance</p>
175 <span id='targ-synop'></span>
176 <table class="xdocLabel"><tr>
177 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
178 <td class="xdocLabelRight">target-domain</td>
179 </tr></table>
180 <div class="xdocSynTdcl">
181 <div class="xdocSynCode">
182 <tt></tt><tt></tt><span class="xdoc-kw2">SizeT</span> <span class="xdoc-id">NotifyDriverShm_sharedMemReq</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> *<span class="xdoc-id">params</span>);
183 </div>
184 </div>
185 <div class="xdocSynSpacer"> </div>
186 <span id="xdoc-sect-1"></span>
187 <div class="xdocSect">ARGUMENTS</div>
188 <div class="xdocChild"><span class="xdocChildId">params</span>
189 <span class="xdocChildSum">— Pointer to parameters that will be used in the
190 create</span>
191 </div>
192 <span id="xdoc-sect-2"></span>
193 <div class="xdocSect">RETURNS</div>
194 <div class="xdocText">Number of MAUs in shared memory needed to create
195 the instance.</div>
196 <a class="xdocAnchor" id="module-wide_built-ins"></a>
197 <table class="xdocHdr"><tr>
198 <td class="xdocHdrTitle"><span class="xdocSynSum">Module-Wide Built-Ins</span></td>
199 <td class="xdocHdrArrow">
200 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
201 </table>
202 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#module-wide_built-ins">index URL</a></div>
203 <p class="xdocHdrSummary"></p>
204 <span id='targ-synop'></span>
205 <table class="xdocLabel"><tr>
206 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
207 <td class="xdocLabelRight">target-domain</td>
208 </tr></table>
209 <div class="xdocSynTdcl">
210 <div class="xdocSynCode">
211 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../xdc/runtime/Types.html#.Module.Id" title="xdc.runtime.Types.ModuleId">Types_ModuleId</a> <span class="xdoc-id">NotifyDriverShm_Module_id</span>();
212 </div>
213 <div class='xdocSynSum'><tt></tt><tt></tt>// Get this module's unique id</div>
214 <div class="xdocSynSpacer"> </div>
215 <div class="xdocSynCode">
216 <tt></tt><tt></tt><span class="xdoc-kw2">Bool</span> <span class="xdoc-id">NotifyDriverShm_Module_startupDone</span>();
217 </div>
218 <div class='xdocSynSum'><tt></tt><tt></tt>// Test if this module has completed startup</div>
219 <div class="xdocSynSpacer"> </div>
220 <div class="xdocSynCode">
221 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../xdc/runtime/IHeap.html#per-instance_object_types" title="xdc.runtime.IHeap.Handle">IHeap_Handle</a> <span class="xdoc-id">NotifyDriverShm_Module_heap</span>();
222 </div>
223 <div class='xdocSynSum'><tt></tt><tt></tt>// The heap from which this module allocates memory</div>
224 <div class="xdocSynSpacer"> </div>
225 <div class="xdocSynCode">
226 <tt></tt><tt></tt><span class="xdoc-kw2">Bool</span> <span class="xdoc-id">NotifyDriverShm_Module_hasMask</span>();
227 </div>
228 <div class='xdocSynSum'><tt></tt><tt></tt>// Test whether this module has a diagnostics mask</div>
229 <div class="xdocSynSpacer"> </div>
230 <div class="xdocSynCode">
231 <tt></tt><tt></tt><span class="xdoc-kw2">Bits16</span> <span class="xdoc-id">NotifyDriverShm_Module_getMask</span>();
232 </div>
233 <div class='xdocSynSum'><tt></tt><tt></tt>// Returns the diagnostics mask for this module</div>
234 <div class="xdocSynSpacer"> </div>
235 <div class="xdocSynCode">
236 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_Module_setMask</span>(<span class="xdoc-kw2">Bits16</span> <span class="xdoc-id">mask</span>);
237 </div>
238 <div class='xdocSynSum'><tt></tt><tt></tt>// Set the diagnostics mask for this module</div>
239 </div>
240 <a class="xdocAnchor" id="per-instance_object_types"></a>
241 <table class="xdocHdr"><tr>
242 <td class="xdocHdrTitle"><span class="xdocSynSum">Instance Object Types</span></td>
243 <td class="xdocHdrArrow">
244 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
245 </table>
246 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types">index URL</a></div>
247 <p class="xdocHdrSummary"></p>
248 <span id='targ-synop'></span>
249 <table class="xdocLabel"><tr>
250 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
251 <td class="xdocLabelRight">target-domain</td>
252 </tr></table>
253 <div class="xdocSynTdcl">
254 <div class="xdocSynCode">
255 <tt></tt><tt></tt><span class="xdoc-kw1">typedef</span> <span class="xdoc-kw1">struct</span> <span class="xdoc-id">NotifyDriverShm_Object</span> <span class="xdoc-id">NotifyDriverShm_Object</span>;
256 </div>
257 <div class='xdocSynSum'><tt></tt><tt></tt>// Opaque internal representation of an instance object</div>
258 <div class="xdocSynSpacer"> </div>
259 <div class="xdocSynCode">
260 <tt></tt><tt></tt><span class="xdoc-kw1">typedef</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Object">NotifyDriverShm_Object</a> *<span class="xdoc-id">NotifyDriverShm_Handle</span>;
261 </div>
262 <div class='xdocSynSum'><tt></tt><tt></tt>// Client reference to an instance object</div>
263 <div class="xdocSynSpacer"> </div>
264 <div class="xdocSynCode">
265 <tt></tt><tt></tt><span class="xdoc-kw1">typedef</span> <span class="xdoc-kw1">struct</span> <span class="xdoc-id">NotifyDriverShm_Struct</span> <span class="xdoc-id">NotifyDriverShm_Struct</span>;
266 </div>
267 <div class='xdocSynSum'><tt></tt><tt></tt>// Opaque client structure large enough to hold an instance object</div>
268 <div class="xdocSynSpacer"> </div>
269 <div class="xdocSynCode">
270 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> <span class="xdoc-id">NotifyDriverShm_handle</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Struct">NotifyDriverShm_Struct</a> *structP);
271 </div>
272 <div class='xdocSynSum'><tt></tt><tt></tt>// Convert this instance structure pointer into an instance handle</div>
273 <div class="xdocSynSpacer"> </div>
274 <div class="xdocSynCode">
275 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Struct">NotifyDriverShm_Struct</a> *<span class="xdoc-id">NotifyDriverShm_struct</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);
276 </div>
277 <div class='xdocSynSum'><tt></tt><tt></tt>// Convert this instance handle into an instance structure pointer</div>
278 </div>
279 <a class="xdocAnchor" id="per-instance_config_parameters"></a>
280 <table class="xdocHdr"><tr>
281 <td class="xdocHdrTitle"><span class="xdocSynSum">Instance Config Parameters</span></td>
282 <td class="xdocHdrArrow">
283 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
284 </table>
285 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters">index URL</a></div>
286 <p class="xdocHdrSummary"></p>
287 <span id='targ-synop'></span>
288 <table class="xdocLabel"><tr>
289 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
290 <td class="xdocLabelRight">target-domain</td>
291 </tr></table>
292 <div class="xdocSynTdcl">
293 <div class="xdocSynCode">
294 <tt></tt><tt></tt><span class="xdoc-kw1">typedef</span> <span class="xdoc-kw1">struct</span> <span class="xdoc-id">NotifyDriverShm_Params</span> {
295 </div>
296 <div class='xdocSynSum'><tt></tt><tt></tt>// Instance config-params structure</div>
297 <div class="xdocSynCode">
298 <tt></tt><tt> </tt><a class="xdoc-link" href="../../../../xdc/runtime/IInstance.html#per-instance_config_parameters" title="xdc.runtime.IInstance.Params">IInstance_Params</a> *instance;
299 </div>
300 <div class='xdocSynSum'><tt></tt><tt> </tt>// Common per-instance configs</div>
301 <div class="xdocSynCode">
302 <tt></tt><tt> </tt><span class="xdoc-kw2">Bool</span> <span class="xdoc-id">cacheEnabled</span>;
303 </div>
304 <div class='xdocSynSum'><tt></tt><tt> </tt>// Whether cache operations will be performed</div>
305 <div class="xdocSynCode">
306 <tt></tt><tt> </tt><span class="xdoc-kw2">SizeT</span> <span class="xdoc-id">cacheLineSize</span>;
307 </div>
308 <div class='xdocSynSum'><tt></tt><tt> </tt>// The cache line size of the shared memory</div>
309 <div class="xdocSynCode">
310 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt</span> <span class="xdoc-id">intVectorId</span>;
311 </div>
312 <div class='xdocSynSum'><tt></tt><tt> </tt>// Interrupt vector ID to be used by the driver</div>
313 <div class="xdocSynCode">
314 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt</span> <span class="xdoc-id">localIntId</span>;
315 </div>
316 <div class='xdocSynSum'><tt></tt><tt> </tt>// Local interrupt ID for interrupt line</div>
317 <div class="xdocSynCode">
318 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt</span> <span class="xdoc-id">remoteIntId</span>;
319 </div>
320 <div class='xdocSynSum'><tt></tt><tt> </tt>// Remote interrupt ID for interrupt line</div>
321 <div class="xdocSynCode">
322 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt16</span> <span class="xdoc-id">remoteProcId</span>;
323 </div>
324 <div class='xdocSynSum'><tt></tt><tt> </tt>// The MultiProc ID corresponding to the remote processor</div>
325 <div class="xdocSynCode">
326 <tt></tt><tt> </tt><span class="xdoc-kw2">Ptr</span> <span class="xdoc-id">sharedAddr</span>;
327 </div>
328 <div class='xdocSynSum'><tt></tt><tt> </tt>// Address in shared memory where this instance will be placed</div>
329 <div class="xdocSynCode">
330 <tt></tt><tt></tt>} <span class="xdoc-id">NotifyDriverShm_Params</span>;
331 </div>
332 <div class="xdocSynSpacer"> </div>
333 <div class="xdocSynCode">
334 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_Params_init</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> *params);
335 </div>
336 <div class='xdocSynSum'><tt></tt><tt></tt>// Initialize this config-params structure with supplier-specified defaults before instance creation</div>
337 </div>
338 <div class="xdocSynSpacer"> </div>
339 <a class="xdocAnchor" id="cache.Enabled"></a>
340 <table class="xdocHdr"><tr>
341 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm_Params.</span><span class="xdoc-id">cacheEnabled</span> <small><span class="xdocSynSum">// instance</span></small></td>
342 <td class="xdocHdrArrow">
343 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
344 </table>
345 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#cache.Enabled">index URL</a></div>
346 <p class="xdocHdrSummaryDcl">Whether cache operations will be performed</p>
347 <span id='targ-synop'></span>
348 <table class="xdocLabel"><tr>
349 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
350 <td class="xdocLabelRight">target-domain</td>
351 </tr></table>
352 <div class="xdocSynTdcl">
353 <div class="xdocSynCode">
354 <tt></tt><tt></tt><span class="xdoc-kw1">struct</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> {
355 </div>
356 <div class="xdocSynCode">
357 <tt></tt><tt> </tt><b> ...</b>
358 </div>
359 <div class="xdocSynCode">
360 <tt></tt><tt> </tt><span class="xdoc-kw2">Bool</span> <span class="xdoc-id">cacheEnabled</span>;
361 </div>
362 </div>
363 <div class="xdocSynSpacer"> </div>
364 <span id="xdoc-sect-1"></span>
365 <div class="xdocSect">DETAILS</div>
366 <div class="xdocText">If it is known that no cache operations are needed for this instance
367 set this flag to FALSE. If <a class="xdoc-link" href="NotifyDriverShm.html#shared.Addr" title="sharedAddr">sharedAddr</a> lies within a shared
368 region and the cache enabled setting for the region is FALSE,
369 then the value specified here will be overriden to FALSE.</div>
370 <div class="xdocSynSpacer"> </div>
371 <a class="xdocAnchor" id="cache.Line.Size"></a>
372 <table class="xdocHdr"><tr>
373 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm_Params.</span><span class="xdoc-id">cacheLineSize</span> <small><span class="xdocSynSum">// instance</span></small></td>
374 <td class="xdocHdrArrow">
375 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
376 </table>
377 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#cache.Line.Size">index URL</a></div>
378 <p class="xdocHdrSummaryDcl">The cache line size of the shared memory</p>
379 <span id='targ-synop'></span>
380 <table class="xdocLabel"><tr>
381 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
382 <td class="xdocLabelRight">target-domain</td>
383 </tr></table>
384 <div class="xdocSynTdcl">
385 <div class="xdocSynCode">
386 <tt></tt><tt></tt><span class="xdoc-kw1">struct</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> {
387 </div>
388 <div class="xdocSynCode">
389 <tt></tt><tt> </tt><b> ...</b>
390 </div>
391 <div class="xdocSynCode">
392 <tt></tt><tt> </tt><span class="xdoc-kw2">SizeT</span> <span class="xdoc-id">cacheLineSize</span>;
393 </div>
394 </div>
395 <div class="xdocSynSpacer"> </div>
396 <span id="xdoc-sect-1"></span>
397 <div class="xdocSect">DETAILS</div>
398 <div class="xdocText">This value should be configured</div>
399 <div class="xdocSynSpacer"> </div>
400 <a class="xdocAnchor" id="int.Vector.Id"></a>
401 <table class="xdocHdr"><tr>
402 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm_Params.</span><span class="xdoc-id">intVectorId</span> <small><span class="xdocSynSum">// instance</span></small></td>
403 <td class="xdocHdrArrow">
404 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
405 </table>
406 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#int.Vector.Id">index URL</a></div>
407 <p class="xdocHdrSummaryDcl">Interrupt vector ID to be used by the driver</p>
408 <span id='targ-synop'></span>
409 <table class="xdocLabel"><tr>
410 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
411 <td class="xdocLabelRight">target-domain</td>
412 </tr></table>
413 <div class="xdocSynTdcl">
414 <div class="xdocSynCode">
415 <tt></tt><tt></tt><span class="xdoc-kw1">struct</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> {
416 </div>
417 <div class="xdocSynCode">
418 <tt></tt><tt> </tt><b> ...</b>
419 </div>
420 <div class="xdocSynCode">
421 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt</span> <span class="xdoc-id">intVectorId</span>;
422 </div>
423 </div>
424 <div class="xdocSynSpacer"> </div>
425 <span id="xdoc-sect-1"></span>
426 <div class="xdocSect">DETAILS</div>
427 <div class="xdocText">This parameter is only used by C64x+ targets</div>
428 <div class="xdocSynSpacer"> </div>
429 <a class="xdocAnchor" id="local.Int.Id"></a>
430 <table class="xdocHdr"><tr>
431 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm_Params.</span><span class="xdoc-id">localIntId</span> <small><span class="xdocSynSum">// instance</span></small></td>
432 <td class="xdocHdrArrow">
433 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
434 </table>
435 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#local.Int.Id">index URL</a></div>
436 <p class="xdocHdrSummaryDcl">Local interrupt ID for interrupt line</p>
437 <span id='targ-synop'></span>
438 <table class="xdocLabel"><tr>
439 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
440 <td class="xdocLabelRight">target-domain</td>
441 </tr></table>
442 <div class="xdocSynTdcl">
443 <div class="xdocSynCode">
444 <tt></tt><tt></tt><span class="xdoc-kw1">struct</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> {
445 </div>
446 <div class="xdocSynCode">
447 <tt></tt><tt> </tt><b> ...</b>
448 </div>
449 <div class="xdocSynCode">
450 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt</span> <span class="xdoc-id">localIntId</span>;
451 </div>
452 </div>
453 <div class="xdocSynSpacer"> </div>
454 <span id="xdoc-sect-1"></span>
455 <div class="xdocSect">DETAILS</div>
456 <div class="xdocText">For devices that support multiple inter-processor interrupt lines, this
457 configuration parameter allows selecting a specific line to use for
458 receiving an interrupt. The value specified here corresponds to the
459 incoming interrupt line on the local processor.</div>
460 <div class="xdocText">If this configuration is not set, a default interrupt id is
461 typically chosen.</div>
462 <div class="xdocSynSpacer"> </div>
463 <a class="xdocAnchor" id="remote.Int.Id"></a>
464 <table class="xdocHdr"><tr>
465 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm_Params.</span><span class="xdoc-id">remoteIntId</span> <small><span class="xdocSynSum">// instance</span></small></td>
466 <td class="xdocHdrArrow">
467 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
468 </table>
469 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#remote.Int.Id">index URL</a></div>
470 <p class="xdocHdrSummaryDcl">Remote interrupt ID for interrupt line</p>
471 <span id='targ-synop'></span>
472 <table class="xdocLabel"><tr>
473 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
474 <td class="xdocLabelRight">target-domain</td>
475 </tr></table>
476 <div class="xdocSynTdcl">
477 <div class="xdocSynCode">
478 <tt></tt><tt></tt><span class="xdoc-kw1">struct</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> {
479 </div>
480 <div class="xdocSynCode">
481 <tt></tt><tt> </tt><b> ...</b>
482 </div>
483 <div class="xdocSynCode">
484 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt</span> <span class="xdoc-id">remoteIntId</span>;
485 </div>
486 </div>
487 <div class="xdocSynSpacer"> </div>
488 <span id="xdoc-sect-1"></span>
489 <div class="xdocSect">DETAILS</div>
490 <div class="xdocText">For devices that support multiple inter-processor interrupt lines, this
491 configuration parameter allows selecting a specific line to use for
492 receiving an interrupt. The value specified here corresponds to the
493 incoming interrupt line on the remote processor.</div>
494 <div class="xdocText">If this configuration is not set, a default interrupt id is
495 typically chosen.</div>
496 <div class="xdocSynSpacer"> </div>
497 <a class="xdocAnchor" id="remote.Proc.Id"></a>
498 <table class="xdocHdr"><tr>
499 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm_Params.</span><span class="xdoc-id">remoteProcId</span> <small><span class="xdocSynSum">// instance</span></small></td>
500 <td class="xdocHdrArrow">
501 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
502 </table>
503 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#remote.Proc.Id">index URL</a></div>
504 <p class="xdocHdrSummaryDcl">The MultiProc ID corresponding to the remote processor</p>
505 <span id='targ-synop'></span>
506 <table class="xdocLabel"><tr>
507 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
508 <td class="xdocLabelRight">target-domain</td>
509 </tr></table>
510 <div class="xdocSynTdcl">
511 <div class="xdocSynCode">
512 <tt></tt><tt></tt><span class="xdoc-kw1">struct</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> {
513 </div>
514 <div class="xdocSynCode">
515 <tt></tt><tt> </tt><b> ...</b>
516 </div>
517 <div class="xdocSynCode">
518 <tt></tt><tt> </tt><span class="xdoc-kw2">UInt16</span> <span class="xdoc-id">remoteProcId</span>;
519 </div>
520 </div>
521 <div class="xdocSynSpacer"> </div>
522 <span id="xdoc-sect-1"></span>
523 <div class="xdocSect">DETAILS</div>
524 <div class="xdocText">This parameter must be set for every device. The
525 <a class="xdoc-link" href="../../../../ti/sdo/utils/MultiProc.html#get.Id" title="ti.sdo.utils.MultiProc.getId">ti.sdo.utils.MultiProc.getId</a> call can be used to obtain
526 a MultiProc id given the remote processor's name.</div>
527 <div class="xdocSynSpacer"> </div>
528 <a class="xdocAnchor" id="shared.Addr"></a>
529 <table class="xdocHdr"><tr>
530 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm_Params.</span><span class="xdoc-id">sharedAddr</span> <small><span class="xdocSynSum">// instance</span></small></td>
531 <td class="xdocHdrArrow">
532 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
533 </table>
534 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#shared.Addr">index URL</a></div>
535 <p class="xdocHdrSummaryDcl">Address in shared memory where this instance will be placed</p>
536 <span id='targ-synop'></span>
537 <table class="xdocLabel"><tr>
538 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
539 <td class="xdocLabelRight">target-domain</td>
540 </tr></table>
541 <div class="xdocSynTdcl">
542 <div class="xdocSynCode">
543 <tt></tt><tt></tt><span class="xdoc-kw1">struct</span> <a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Params">NotifyDriverShm_Params</a> {
544 </div>
545 <div class="xdocSynCode">
546 <tt></tt><tt> </tt><b> ...</b>
547 </div>
548 <div class="xdocSynCode">
549 <tt></tt><tt> </tt><span class="xdoc-kw2">Ptr</span> <span class="xdoc-id">sharedAddr</span>;
550 </div>
551 </div>
552 <div class="xdocSynSpacer"> </div>
553 <span id="xdoc-sect-1"></span>
554 <div class="xdocSect">DETAILS</div>
555 <div class="xdocText">Use <a class="xdoc-link" href="NotifyDriverShm.html#shared.Mem.Req" title="sharedMemReq">sharedMemReq</a> to determine the amount of shared memory
556 required.</div>
557 <div class="xdocSynSpacer"> </div>
558 <a class="xdocAnchor" id="disable"></a>
559 <table class="xdocHdr"><tr>
560 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">disable</span>() <small><span class="xdocSynSum">// instance</span></small></td>
561 <td class="xdocHdrArrow">
562 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
563 </table>
564 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#disable">index URL</a></div>
565 <p class="xdocHdrSummaryDcl">Disable a NotifyDriver instance</p>
566 <span id='targ-synop'></span>
567 <table class="xdocLabel"><tr>
568 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
569 <td class="xdocLabelRight">target-domain</td>
570 </tr></table>
571 <div class="xdocSynTdcl">
572 <div class="xdocSynCode">
573 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_disable</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);
574 </div>
575 </div>
576 <div class="xdocSynSpacer"> </div>
577 <span id="xdoc-sect-1"></span>
578 <div class="xdocSect">ARGUMENTS</div>
579 <div class="xdocChild"><span class="xdocChildId">handle</span>
580 <span class="xdocChildSum">— handle of a previously-created <tt>NotifyDriverShm</tt> instance object</span>
581 </div>
582 <span id="xdoc-sect-2"></span>
583 <div class="xdocSect">DETAILS</div>
584 <div class="xdocText">Disables the ability of a Notify driver to receive events for a given
585 processor. This interface function is called by the Notify_disable
586 function. Refer to its documentation for more details.</div>
587 <div class="xdocSynSpacer"> </div>
588 <a class="xdocAnchor" id="disable.Event"></a>
589 <table class="xdocHdr"><tr>
590 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">disableEvent</span>() <small><span class="xdocSynSum">// instance</span></small></td>
591 <td class="xdocHdrArrow">
592 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
593 </table>
594 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#disable.Event">index URL</a></div>
595 <p class="xdocHdrSummaryDcl">Disable an event</p>
596 <span id='targ-synop'></span>
597 <table class="xdocLabel"><tr>
598 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
599 <td class="xdocLabelRight">target-domain</td>
600 </tr></table>
601 <div class="xdocSynTdcl">
602 <div class="xdocSynCode">
603 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_disableEvent</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);
604 </div>
605 </div>
606 <div class="xdocSynSpacer"> </div>
607 <span id="xdoc-sect-1"></span>
608 <div class="xdocSect">ARGUMENTS</div>
609 <div class="xdocChild"><span class="xdocChildId">handle</span>
610 <span class="xdocChildSum">— handle of a previously-created <tt>NotifyDriverShm</tt> instance object</span>
611 </div>
612 <div class="xdocChild"><span class="xdocChildId">eventId</span>
613 <span class="xdocChildSum">— Number of event to disable</span>
614 </div>
615 <span id="xdoc-sect-2"></span>
616 <div class="xdocSect">DETAILS</div>
617 <div class="xdocText">This interface function is called by the Notify_disableEvent function.
618 Refer to its documentation for more details.</div>
619 <div class="xdocText">The Notify module does validation of the eventId. The Notify module
620 enters calls this function within the Notify module gate.</div>
621 <div class="xdocSynSpacer"> </div>
622 <a class="xdocAnchor" id="enable"></a>
623 <table class="xdocHdr"><tr>
624 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">enable</span>() <small><span class="xdocSynSum">// instance</span></small></td>
625 <td class="xdocHdrArrow">
626 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
627 </table>
628 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#enable">index URL</a></div>
629 <p class="xdocHdrSummaryDcl">Enable a NotifyDriver instance</p>
630 <span id='targ-synop'></span>
631 <table class="xdocLabel"><tr>
632 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
633 <td class="xdocLabelRight">target-domain</td>
634 </tr></table>
635 <div class="xdocSynTdcl">
636 <div class="xdocSynCode">
637 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_enable</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);
638 </div>
639 </div>
640 <div class="xdocSynSpacer"> </div>
641 <span id="xdoc-sect-1"></span>
642 <div class="xdocSect">ARGUMENTS</div>
643 <div class="xdocChild"><span class="xdocChildId">handle</span>
644 <span class="xdocChildSum">— handle of a previously-created <tt>NotifyDriverShm</tt> instance object</span>
645 </div>
646 <span id="xdoc-sect-2"></span>
647 <div class="xdocSect">DETAILS</div>
648 <div class="xdocText">Enables the ability of a Notify driver to receive events for a given
649 processor. This interface function is called by the Notify_restore
650 function. Refer to its documentation for more details.</div>
651 <div class="xdocSynSpacer"> </div>
652 <a class="xdocAnchor" id="enable.Event"></a>
653 <table class="xdocHdr"><tr>
654 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">enableEvent</span>() <small><span class="xdocSynSum">// instance</span></small></td>
655 <td class="xdocHdrArrow">
656 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
657 </table>
658 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#enable.Event">index URL</a></div>
659 <p class="xdocHdrSummaryDcl">Enable an event</p>
660 <span id='targ-synop'></span>
661 <table class="xdocLabel"><tr>
662 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
663 <td class="xdocLabelRight">target-domain</td>
664 </tr></table>
665 <div class="xdocSynTdcl">
666 <div class="xdocSynCode">
667 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_enableEvent</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);
668 </div>
669 </div>
670 <div class="xdocSynSpacer"> </div>
671 <span id="xdoc-sect-1"></span>
672 <div class="xdocSect">ARGUMENTS</div>
673 <div class="xdocChild"><span class="xdocChildId">handle</span>
674 <span class="xdocChildSum">— handle of a previously-created <tt>NotifyDriverShm</tt> instance object</span>
675 </div>
676 <div class="xdocChild"><span class="xdocChildId">eventId</span>
677 <span class="xdocChildSum">— Number of event to enable</span>
678 </div>
679 <span id="xdoc-sect-2"></span>
680 <div class="xdocSect">DETAILS</div>
681 <div class="xdocText">This interface function is called by the Notify_disableEvent function.
682 Refer to its documentation for more details.</div>
683 <div class="xdocText">The Notify module does validation of the eventId. The Notify module
684 enters calls this function within the Notify module gate.</div>
685 <div class="xdocSynSpacer"> </div>
686 <a class="xdocAnchor" id="register.Event"></a>
687 <table class="xdocHdr"><tr>
688 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">registerEvent</span>() <small><span class="xdocSynSum">// instance</span></small></td>
689 <td class="xdocHdrArrow">
690 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
691 </table>
692 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#register.Event">index URL</a></div>
693 <p class="xdocHdrSummaryDcl">Register a callback to an event</p>
694 <span id='targ-synop'></span>
695 <table class="xdocLabel"><tr>
696 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
697 <td class="xdocLabelRight">target-domain</td>
698 </tr></table>
699 <div class="xdocSynTdcl">
700 <div class="xdocSynCode">
701 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_registerEvent</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);
702 </div>
703 </div>
704 <div class="xdocSynSpacer"> </div>
705 <span id="xdoc-sect-1"></span>
706 <div class="xdocSect">ARGUMENTS</div>
707 <div class="xdocChild"><span class="xdocChildId">handle</span>
708 <span class="xdocChildSum">— handle of a previously-created <tt>NotifyDriverShm</tt> instance object</span>
709 </div>
710 <div class="xdocChild"><span class="xdocChildId">eventId</span>
711 <span class="xdocChildSum">— Number of event that is being registered</span>
712 </div>
713 <span id="xdoc-sect-2"></span>
714 <div class="xdocSect">DETAILS</div>
715 <div class="xdocText">This driver function is called by the Notify_registerEvent function
716 within the Notify module gate. Refer to its documentation for more
717 details.</div>
718 <div class="xdocSynSpacer"> </div>
719 <a class="xdocAnchor" id="send.Event"></a>
720 <table class="xdocHdr"><tr>
721 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">sendEvent</span>() <small><span class="xdocSynSum">// instance</span></small></td>
722 <td class="xdocHdrArrow">
723 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
724 </table>
725 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#send.Event">index URL</a></div>
726 <p class="xdocHdrSummaryDcl">Send a signal to an event</p>
727 <span id='targ-synop'></span>
728 <table class="xdocLabel"><tr>
729 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
730 <td class="xdocLabelRight">target-domain</td>
731 </tr></table>
732 <div class="xdocSynTdcl">
733 <div class="xdocSynCode">
734 <tt></tt><tt></tt><span class="xdoc-kw2">Int</span> <span class="xdoc-id">NotifyDriverShm_sendEvent</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">payload</span>, <span class="xdoc-kw2">Bool</span> <span class="xdoc-id">waitClear</span>);
735 </div>
736 </div>
737 <div class="xdocSynSpacer"> </div>
738 <span id="xdoc-sect-1"></span>
739 <div class="xdocSect">ARGUMENTS</div>
740 <div class="xdocChild"><span class="xdocChildId">handle</span>
741 <span class="xdocChildSum">— handle of a previously-created <tt>NotifyDriverShm</tt> instance object</span>
742 </div>
743 <div class="xdocChild"><span class="xdocChildId">eventId</span>
744 <span class="xdocChildSum">— Number of event to signal</span>
745 </div>
746 <div class="xdocChild"><span class="xdocChildId">payload</span>
747 <span class="xdocChildSum">— Payload (optional) to pass to callback function</span>
748 </div>
749 <div class="xdocChild"><span class="xdocChildId">waitClear</span>
750 <span class="xdocChildSum">— If TRUE, have the NotifyDriver wait for
751 acknowledgement back from the destination
752 processor.</span>
753 </div>
754 <span id="xdoc-sect-2"></span>
755 <div class="xdocSect">RETURNS</div>
756 <div class="xdocText">Notify status</div>
757 <span id="xdoc-sect-3"></span>
758 <div class="xdocSect">DETAILS</div>
759 <div class="xdocText">This interface function is called by the Notify_sendEvent function.
760 Notify_sendEvent does not provide any context protection for
761 INotifyDriver_sendEvent, so appropriate measures must be taken within
762 the driver itself.</div>
763 <div class="xdocSynSpacer"> </div>
764 <a class="xdocAnchor" id="unregister.Event"></a>
765 <table class="xdocHdr"><tr>
766 <td class="xdocHdrTitle"><span class="xdoc-id">NotifyDriverShm_</span><span class="xdoc-id">unregisterEvent</span>() <small><span class="xdocSynSum">// instance</span></small></td>
767 <td class="xdocHdrArrow">
768 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
769 </table>
770 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#unregister.Event">index URL</a></div>
771 <p class="xdocHdrSummaryDcl">Remove an event listener from an event</p>
772 <span id='targ-synop'></span>
773 <table class="xdocLabel"><tr>
774 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
775 <td class="xdocLabelRight">target-domain</td>
776 </tr></table>
777 <div class="xdocSynTdcl">
778 <div class="xdocSynCode">
779 <tt></tt><tt></tt><span class="xdoc-kw2">Void</span> <span class="xdoc-id">NotifyDriverShm_unregisterEvent</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <span class="xdoc-kw2">UInt32</span> <span class="xdoc-id">eventId</span>);
780 </div>
781 </div>
782 <div class="xdocSynSpacer"> </div>
783 <span id="xdoc-sect-1"></span>
784 <div class="xdocSect">ARGUMENTS</div>
785 <div class="xdocChild"><span class="xdocChildId">handle</span>
786 <span class="xdocChildSum">— handle of a previously-created <tt>NotifyDriverShm</tt> instance object</span>
787 </div>
788 <div class="xdocChild"><span class="xdocChildId">eventId</span>
789 <span class="xdocChildSum">— Number of event that is being unregistered</span>
790 </div>
791 <span id="xdoc-sect-2"></span>
792 <div class="xdocSect">DETAILS</div>
793 <div class="xdocText">This driver function is called by the Notify_unregisterEvent function
794 within the Notify module gate. Refer to it for more details.</div>
795 <a class="xdocAnchor" id="per-instance_convertors"></a>
796 <table class="xdocHdr"><tr>
797 <td class="xdocHdrTitle"><span class="xdocSynSum">Instance Convertors</span></td>
798 <td class="xdocHdrArrow">
799 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
800 </table>
801 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_convertors">index URL</a></div>
802 <p class="xdocHdrSummary"></p>
803 <span id='targ-synop'></span>
804 <table class="xdocLabel"><tr>
805 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
806 <td class="xdocLabelRight">target-domain</td>
807 </tr></table>
808 <div class="xdocSynTdcl">
809 <div class="xdocSynCode">
810 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../ti/sdo/ipc/interfaces/INotifyDriver.html#per-instance_object_types" title="ti.sdo.ipc.interfaces.INotifyDriver.Handle">INotifyDriver_Handle</a> <span class="xdoc-id">NotifyDriverShm_Handle_upCast</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);
811 </div>
812 <div class='xdocSynSum'><tt></tt><tt></tt>// unconditionally move one level up the inheritance hierarchy</div>
813 <div class="xdocSynSpacer"> </div>
814 <div class="xdocSynCode">
815 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> <span class="xdoc-id">NotifyDriverShm_Handle_downCast</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/interfaces/INotifyDriver.html#per-instance_object_types" title="ti.sdo.ipc.interfaces.INotifyDriver.Handle">INotifyDriver_Handle</a> handle);
816 </div>
817 <div class='xdocSynSum'><tt></tt><tt></tt>// conditionally move one level down the inheritance hierarchy; NULL upon failure</div>
818 </div>
819 <a class="xdocAnchor" id="per-instance_built-ins"></a>
820 <table class="xdocHdr"><tr>
821 <td class="xdocHdrTitle"><span class="xdocSynSum">Instance Built-Ins</span></td>
822 <td class="xdocHdrArrow">
823 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
824 </table>
825 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_built-ins">index URL</a></div>
826 <p class="xdocHdrSummary"></p>
827 <span id='targ-synop'></span>
828 <table class="xdocLabel"><tr>
829 <td class="xdocLabelLeft"><tt><span class="xdoc-id-targ2dcl">C</span></tt> synopsis</td>
830 <td class="xdocLabelRight">target-domain</td>
831 </tr></table>
832 <div class="xdocSynTdcl">
833 <div class="xdocSynCode">
834 <tt></tt><tt></tt><span class="xdoc-kw2">Int</span> <span class="xdoc-id">NotifyDriverShm_Object_count</span>();
835 </div>
836 <div class='xdocSynSum'><tt></tt><tt></tt>// The number of statically-created instance objects</div>
837 <div class="xdocSynSpacer"> </div>
838 <div class="xdocSynCode">
839 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> <span class="xdoc-id">NotifyDriverShm_Object_get</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Object">NotifyDriverShm_Object</a> *array, <span class="xdoc-kw2">Int</span> i);
840 </div>
841 <div class='xdocSynSum'><tt></tt><tt></tt>// The handle of the i-th statically-created instance object (array == NULL)</div>
842 <div class="xdocSynSpacer"> </div>
843 <div class="xdocSynCode">
844 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> <span class="xdoc-id">NotifyDriverShm_Object_first</span>();
845 </div>
846 <div class='xdocSynSum'><tt></tt><tt></tt>// The handle of the first dynamically-created instance object, or NULL</div>
847 <div class="xdocSynSpacer"> </div>
848 <div class="xdocSynCode">
849 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> <span class="xdoc-id">NotifyDriverShm_Object_next</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);
850 </div>
851 <div class='xdocSynSum'><tt></tt><tt></tt>// The handle of the next dynamically-created instance object, or NULL</div>
852 <div class="xdocSynSpacer"> </div>
853 <div class="xdocSynCode">
854 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../xdc/runtime/IHeap.html#per-instance_object_types" title="xdc.runtime.IHeap.Handle">IHeap_Handle</a> <span class="xdoc-id">NotifyDriverShm_Object_heap</span>();
855 </div>
856 <div class='xdocSynSum'><tt></tt><tt></tt>// The heap used to allocate dynamically-created instance objects</div>
857 <div class="xdocSynSpacer"> </div>
858 <div class="xdocSynCode">
859 <tt></tt><tt></tt><a class="xdoc-link" href="../../../../xdc/runtime/Types.html#.Label" title="xdc.runtime.Types.Label">Types_Label</a> *<span class="xdoc-id">NotifyDriverShm_Handle_label</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle, <a class="xdoc-link" href="../../../../xdc/runtime/Types.html#.Label" title="xdc.runtime.Types.Label">Types_Label</a> *buf);
860 </div>
861 <div class='xdocSynSum'><tt></tt><tt></tt>// The label associated with this instance object</div>
862 <div class="xdocSynSpacer"> </div>
863 <div class="xdocSynCode">
864 <tt></tt><tt></tt><span class="xdoc-kw2">String</span> <span class="xdoc-id">NotifyDriverShm_Handle_name</span>(<a class="xdoc-link" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_object_types" title="ti.sdo.ipc.notifyDrivers.NotifyDriverShm.Handle">NotifyDriverShm_Handle</a> handle);
865 </div>
866 <div class='xdocSynSum'><tt></tt><tt></tt>// The name of this instance object</div>
867 </div>
868 </div>
869 <div class="xdocSynSpacer"> </div>
870 <span id='meta-synop'></span>
871 <table class="xdocLabel"><tr>
872 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2"></span></tt>Configuration settings</td>
873 <td class="xdocLabelRight">sourced in <a class="xdocLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm-src.html"><span class="xdocLabelFile">ti/sdo/ipc/notifyDrivers/NotifyDriverShm.xdc</span></a></td>
874 </tr></table>
875 <div class="xdocSynM">
876 <div class="xdocSynCode">
877 <tt></tt><span class="xdoc-kw1">var</span> NotifyDriverShm = <span class="xdoc-kw3">xdc.useModule</span>(<span class="xdoc-id">'ti.sdo.ipc.notifyDrivers.NotifyDriverShm'</span>);
878 </div>
879 <div class='xdocSynHdr'>module-wide config parameters</div>
881 <div class="xdocSynCode">
882 <tt> </tt><tt></tt><a class="xdocSynGo" href="#common$">NotifyDriverShm.<span class="xdoc-id">common$</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Common module configuration parameters</span></span></a> = <i><a class="xdoc-link" href="../../../../xdc/runtime/Types.html#.Common$" title="xdc.runtime.Types.Common$">Types.Common$</a></i> <span class="xdoc-kw2">undefined</span>;
883 </div>
884 <div class="xdocSynCode">
885 <tt> </tt><tt></tt><a class="xdocSynGo" href="#rov.View.Info">NotifyDriverShm.<span class="xdoc-id">rovViewInfo</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// </span></span></a> = <i><a class="xdoc-link" href="../../../../xdc/rov/ViewInfo.html#.Instance" title="xdc.rov.ViewInfo.Instance">ViewInfo.Instance</a></i> <a class="xdoc-link" href="../../../../xdc/rov/ViewInfo.html#per-instance_creation" title="xdc.rov.ViewInfo.create">ViewInfo.create</a>;
886 </div>
887 <div class='xdocSynHdr'>per-instance config parameters</div>
889 <div class="xdocSynCode">
890 <tt> </tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<a class="xdocSynGo" href="#metaper-instance_config_parameters"><span class="xdoc-id">Params</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Instance config-params object</span></span></a>;
891 </div>
892 <div class="xdocSynCode">
893 <tt> </tt><tt> </tt>params.<a class="xdocSynGo" href="#metacache.Enabled"><span class="xdoc-id">cacheEnabled</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Whether cache operations will be performed</span></span></a> = <i><span class="xdoc-kw2">Bool</span></i> <span class="xdoc-kw2">true</span>;
894 </div>
895 <div class="xdocSynCode">
896 <tt> </tt><tt> </tt>params.<a class="xdocSynGo" href="#metacache.Line.Size"><span class="xdoc-id">cacheLineSize</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The cache line size of the shared memory</span></span></a> = <i><span class="xdoc-kw2">SizeT</span></i> 128;
897 </div>
898 <div class="xdocSynCode">
899 <tt> </tt><tt> </tt>params.<a class="xdocSynGo" href="#metaint.Vector.Id"><span class="xdoc-id">intVectorId</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Interrupt vector ID to be used by the driver</span></span></a> = <i><span class="xdoc-kw2">UInt</span></i> ~1u;
900 </div>
901 <div class="xdocSynCode">
902 <tt> </tt><tt> </tt>params.<a class="xdocSynGo" href="#metalocal.Int.Id"><span class="xdoc-id">localIntId</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Local interrupt ID for interrupt line</span></span></a> = <i><span class="xdoc-kw2">UInt</span></i> -1u;
903 </div>
904 <div class="xdocSynCode">
905 <tt> </tt><tt> </tt>params.<a class="xdocSynGo" href="#metaremote.Int.Id"><span class="xdoc-id">remoteIntId</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Remote interrupt ID for interrupt line</span></span></a> = <i><span class="xdoc-kw2">UInt</span></i> -1u;
906 </div>
907 <div class="xdocSynCode">
908 <tt> </tt><tt> </tt>params.<a class="xdocSynGo" href="#metaremote.Proc.Id"><span class="xdoc-id">remoteProcId</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// The MultiProc ID corresponding to the remote processor</span></span></a> = <i><span class="xdoc-kw2">UInt16</span></i> <a class="xdoc-link" href="../../../../ti/sdo/utils/MultiProc.html#.I.N.V.A.L.I.D.I.D" title="ti.sdo.utils.MultiProc.INVALIDID">MultiProc.INVALIDID</a>;
909 </div>
910 <div class="xdocSynCode">
911 <tt> </tt><tt> </tt>params.<a class="xdocSynGo" href="#metashared.Addr"><span class="xdoc-id">sharedAddr</span><span class="xdocSynHoverShadow"><span class="xdocSynHover">// Address in shared memory where this instance will be placed</span></span></a> = <i><span class="xdoc-kw2">Ptr</span></i> <span class="xdoc-kw2">null</span>;
912 </div>
913 <div class="xdocSynSpacer"> </div>
914 </div>
915 <div id="xdocSep">
916 </div>
917 <div id="xdocMetaElems">
918 <div class="xdocSynSpacer"> </div>
919 <a class="xdocAnchor" id="common$"></a>
920 <table class="xdocHdr"><tr>
921 <td class="xdocHdrTitle"><span class="xdoc-kw1">metaonly </span><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.</span><span class="xdoc-id">common$</span> <small><span class="xdocSynSum">// module-wide</span></small></td>
922 <td class="xdocHdrArrow">
923 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
924 </table>
925 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#common$">index URL</a></div>
926 <p class="xdocHdrSummaryDcl">Common module configuration parameters</p>
927 <span id='meta-synop'></span>
928 <table class="xdocLabel"><tr>
929 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
930 <td class="xdocLabelRight"></td>
931 </tr></table>
932 <div class="xdocSynMdcl">
933 <div class="xdocSynCode">
934 <tt></tt><tt></tt>NotifyDriverShm.<span class="xdoc-id">common$</span> = <i><a class="xdoc-link" href="../../../../xdc/runtime/Types.html#.Common$" title="xdc.runtime.Types.Common$">Types.Common$</a></i> <span class="xdoc-kw2">undefined</span>;
935 </div>
936 </div>
937 <div class="xdocSynSpacer"> </div>
938 <span id="xdoc-sect-1"></span>
939 <div class="xdocSect">DETAILS</div>
940 <div class="xdocText">All modules have this configuration parameter. Its name
941 contains the '$' character to ensure it does not conflict with
942 configuration parameters declared by the module. This allows
943 new configuration parameters to be added in the future without
944 any chance of breaking existing modules.</div>
945 <div class="xdocSynSpacer"> </div>
946 <a class="xdocAnchor" id="rov.View.Info"></a>
947 <table class="xdocHdr"><tr>
948 <td class="xdocHdrTitle"><span class="xdoc-kw1">metaonly </span><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.</span><span class="xdoc-id">rovViewInfo</span> <small><span class="xdocSynSum">// module-wide</span></small></td>
949 <td class="xdocHdrArrow">
950 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
951 </table>
952 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#rov.View.Info">index URL</a></div>
953 <span id='meta-synop'></span>
954 <table class="xdocLabel"><tr>
955 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
956 <td class="xdocLabelRight"></td>
957 </tr></table>
958 <div class="xdocSynMdcl">
959 <div class="xdocSynCode">
960 <tt></tt><tt></tt>NotifyDriverShm.<span class="xdoc-id">rovViewInfo</span> = <i><a class="xdoc-link" href="../../../../xdc/rov/ViewInfo.html#.Instance" title="xdc.rov.ViewInfo.Instance">ViewInfo.Instance</a></i> <a class="xdoc-link" href="../../../../xdc/rov/ViewInfo.html#per-instance_creation" title="xdc.rov.ViewInfo.create">ViewInfo.create</a>;
961 </div>
962 </div>
963 <div class="xdocSynSpacer"> </div>
964 <a class="xdocAnchor" id="metaper-instance_config_parameters"></a>
965 <table class="xdocHdr"><tr>
966 <td class="xdocHdrTitle"><span class="xdocSynSum">Instance Config Parameters</span></td>
967 <td class="xdocHdrArrow">
968 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
969 </table>
970 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#per-instance_config_parameters">index URL</a></div>
971 <p class="xdocHdrSummary"></p>
972 <span id='meta-synop'></span>
973 <table class="xdocLabel"><tr>
974 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
975 <td class="xdocLabelRight"></td>
976 </tr></table>
977 <div class="xdocSynMdcl">
978 <div class="xdocSynCode">
979 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
980 </div>
981 <div class='xdocSynSum'><tt></tt><tt></tt>// Instance config-params object</div>
982 <div class="xdocSynCode">
983 <tt></tt><tt> </tt>params.<span class="xdoc-id">cacheEnabled</span> = <i><span class="xdoc-kw2">Bool</span></i> <span class="xdoc-kw2">true</span>;
984 </div>
985 <div class='xdocSynSum'><tt></tt><tt> </tt>// Whether cache operations will be performed</div>
986 <div class="xdocSynCode">
987 <tt></tt><tt> </tt>params.<span class="xdoc-id">cacheLineSize</span> = <i><span class="xdoc-kw2">SizeT</span></i> 128;
988 </div>
989 <div class='xdocSynSum'><tt></tt><tt> </tt>// The cache line size of the shared memory</div>
990 <div class="xdocSynCode">
991 <tt></tt><tt> </tt>params.<span class="xdoc-id">intVectorId</span> = <i><span class="xdoc-kw2">UInt</span></i> ~1u;
992 </div>
993 <div class='xdocSynSum'><tt></tt><tt> </tt>// Interrupt vector ID to be used by the driver</div>
994 <div class="xdocSynCode">
995 <tt></tt><tt> </tt>params.<span class="xdoc-id">localIntId</span> = <i><span class="xdoc-kw2">UInt</span></i> -1u;
996 </div>
997 <div class='xdocSynSum'><tt></tt><tt> </tt>// Local interrupt ID for interrupt line</div>
998 <div class="xdocSynCode">
999 <tt></tt><tt> </tt>params.<span class="xdoc-id">remoteIntId</span> = <i><span class="xdoc-kw2">UInt</span></i> -1u;
1000 </div>
1001 <div class='xdocSynSum'><tt></tt><tt> </tt>// Remote interrupt ID for interrupt line</div>
1002 <div class="xdocSynCode">
1003 <tt></tt><tt> </tt>params.<span class="xdoc-id">remoteProcId</span> = <i><span class="xdoc-kw2">UInt16</span></i> <a class="xdoc-link" href="../../../../ti/sdo/utils/MultiProc.html#.I.N.V.A.L.I.D.I.D" title="ti.sdo.utils.MultiProc.INVALIDID">MultiProc.INVALIDID</a>;
1004 </div>
1005 <div class='xdocSynSum'><tt></tt><tt> </tt>// The MultiProc ID corresponding to the remote processor</div>
1006 <div class="xdocSynCode">
1007 <tt></tt><tt> </tt>params.<span class="xdoc-id">sharedAddr</span> = <i><span class="xdoc-kw2">Ptr</span></i> <span class="xdoc-kw2">null</span>;
1008 </div>
1009 <div class='xdocSynSum'><tt></tt><tt> </tt>// Address in shared memory where this instance will be placed</div>
1010 </div>
1011 <div class="xdocSynSpacer"> </div>
1012 <a class="xdocAnchor" id="metacache.Enabled"></a>
1013 <table class="xdocHdr"><tr>
1014 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.Params.</span><span class="xdoc-id">cacheEnabled</span> <small><span class="xdocSynSum">// instance</span></small></td>
1015 <td class="xdocHdrArrow">
1016 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
1017 </table>
1018 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#cache.Enabled">index URL</a></div>
1019 <p class="xdocHdrSummaryDcl">Whether cache operations will be performed</p>
1020 <span id='meta-synop'></span>
1021 <table class="xdocLabel"><tr>
1022 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
1023 <td class="xdocLabelRight"></td>
1024 </tr></table>
1025 <div class="xdocSynMdcl">
1026 <div class="xdocSynCode">
1027 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
1028 </div>
1029 <div class="xdocSynCode">
1030 <tt></tt><tt></tt><b> ...</b>
1031 </div>
1032 <div class="xdocSynCode">
1033 <tt></tt><tt></tt>params.<span class="xdoc-id">cacheEnabled</span> = <i><span class="xdoc-kw2">Bool</span></i> <span class="xdoc-kw2">true</span>;
1034 </div>
1035 </div>
1036 <div class="xdocSynSpacer"> </div>
1037 <span id="xdoc-sect-1"></span>
1038 <div class="xdocSect">DETAILS</div>
1039 <div class="xdocText">If it is known that no cache operations are needed for this instance
1040 set this flag to FALSE. If <a class="xdoc-link" href="NotifyDriverShm.html#shared.Addr" title="sharedAddr">sharedAddr</a> lies within a shared
1041 region and the cache enabled setting for the region is FALSE,
1042 then the value specified here will be overriden to FALSE.</div>
1043 <div class="xdocSect">C SYNOPSIS</div>
1044 <div class="xdocText"><a class="xdoc-link" href="#cache.Enabled" title="NotifyDriverShm_Params.cacheEnabled">NotifyDriverShm_Params.cacheEnabled</a></div>
1045 <div class="xdocSynSpacer"> </div>
1046 <a class="xdocAnchor" id="metacache.Line.Size"></a>
1047 <table class="xdocHdr"><tr>
1048 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.Params.</span><span class="xdoc-id">cacheLineSize</span> <small><span class="xdocSynSum">// instance</span></small></td>
1049 <td class="xdocHdrArrow">
1050 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
1051 </table>
1052 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#cache.Line.Size">index URL</a></div>
1053 <p class="xdocHdrSummaryDcl">The cache line size of the shared memory</p>
1054 <span id='meta-synop'></span>
1055 <table class="xdocLabel"><tr>
1056 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
1057 <td class="xdocLabelRight"></td>
1058 </tr></table>
1059 <div class="xdocSynMdcl">
1060 <div class="xdocSynCode">
1061 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
1062 </div>
1063 <div class="xdocSynCode">
1064 <tt></tt><tt></tt><b> ...</b>
1065 </div>
1066 <div class="xdocSynCode">
1067 <tt></tt><tt></tt>params.<span class="xdoc-id">cacheLineSize</span> = <i><span class="xdoc-kw2">SizeT</span></i> 128;
1068 </div>
1069 </div>
1070 <div class="xdocSynSpacer"> </div>
1071 <span id="xdoc-sect-1"></span>
1072 <div class="xdocSect">DETAILS</div>
1073 <div class="xdocText">This value should be configured</div>
1074 <div class="xdocSect">C SYNOPSIS</div>
1075 <div class="xdocText"><a class="xdoc-link" href="#cache.Line.Size" title="NotifyDriverShm_Params.cacheLineSize">NotifyDriverShm_Params.cacheLineSize</a></div>
1076 <div class="xdocSynSpacer"> </div>
1077 <a class="xdocAnchor" id="metaint.Vector.Id"></a>
1078 <table class="xdocHdr"><tr>
1079 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.Params.</span><span class="xdoc-id">intVectorId</span> <small><span class="xdocSynSum">// instance</span></small></td>
1080 <td class="xdocHdrArrow">
1081 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
1082 </table>
1083 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#int.Vector.Id">index URL</a></div>
1084 <p class="xdocHdrSummaryDcl">Interrupt vector ID to be used by the driver</p>
1085 <span id='meta-synop'></span>
1086 <table class="xdocLabel"><tr>
1087 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
1088 <td class="xdocLabelRight"></td>
1089 </tr></table>
1090 <div class="xdocSynMdcl">
1091 <div class="xdocSynCode">
1092 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
1093 </div>
1094 <div class="xdocSynCode">
1095 <tt></tt><tt></tt><b> ...</b>
1096 </div>
1097 <div class="xdocSynCode">
1098 <tt></tt><tt></tt>params.<span class="xdoc-id">intVectorId</span> = <i><span class="xdoc-kw2">UInt</span></i> ~1u;
1099 </div>
1100 </div>
1101 <div class="xdocSynSpacer"> </div>
1102 <span id="xdoc-sect-1"></span>
1103 <div class="xdocSect">DETAILS</div>
1104 <div class="xdocText">This parameter is only used by C64x+ targets</div>
1105 <div class="xdocSect">C SYNOPSIS</div>
1106 <div class="xdocText"><a class="xdoc-link" href="#int.Vector.Id" title="NotifyDriverShm_Params.intVectorId">NotifyDriverShm_Params.intVectorId</a></div>
1107 <div class="xdocSynSpacer"> </div>
1108 <a class="xdocAnchor" id="metalocal.Int.Id"></a>
1109 <table class="xdocHdr"><tr>
1110 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.Params.</span><span class="xdoc-id">localIntId</span> <small><span class="xdocSynSum">// instance</span></small></td>
1111 <td class="xdocHdrArrow">
1112 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
1113 </table>
1114 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#local.Int.Id">index URL</a></div>
1115 <p class="xdocHdrSummaryDcl">Local interrupt ID for interrupt line</p>
1116 <span id='meta-synop'></span>
1117 <table class="xdocLabel"><tr>
1118 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
1119 <td class="xdocLabelRight"></td>
1120 </tr></table>
1121 <div class="xdocSynMdcl">
1122 <div class="xdocSynCode">
1123 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
1124 </div>
1125 <div class="xdocSynCode">
1126 <tt></tt><tt></tt><b> ...</b>
1127 </div>
1128 <div class="xdocSynCode">
1129 <tt></tt><tt></tt>params.<span class="xdoc-id">localIntId</span> = <i><span class="xdoc-kw2">UInt</span></i> -1u;
1130 </div>
1131 </div>
1132 <div class="xdocSynSpacer"> </div>
1133 <span id="xdoc-sect-1"></span>
1134 <div class="xdocSect">DETAILS</div>
1135 <div class="xdocText">For devices that support multiple inter-processor interrupt lines, this
1136 configuration parameter allows selecting a specific line to use for
1137 receiving an interrupt. The value specified here corresponds to the
1138 incoming interrupt line on the local processor.</div>
1139 <div class="xdocText">If this configuration is not set, a default interrupt id is
1140 typically chosen.</div>
1141 <div class="xdocSect">C SYNOPSIS</div>
1142 <div class="xdocText"><a class="xdoc-link" href="#local.Int.Id" title="NotifyDriverShm_Params.localIntId">NotifyDriverShm_Params.localIntId</a></div>
1143 <div class="xdocSynSpacer"> </div>
1144 <a class="xdocAnchor" id="metaremote.Int.Id"></a>
1145 <table class="xdocHdr"><tr>
1146 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.Params.</span><span class="xdoc-id">remoteIntId</span> <small><span class="xdocSynSum">// instance</span></small></td>
1147 <td class="xdocHdrArrow">
1148 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
1149 </table>
1150 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#remote.Int.Id">index URL</a></div>
1151 <p class="xdocHdrSummaryDcl">Remote interrupt ID for interrupt line</p>
1152 <span id='meta-synop'></span>
1153 <table class="xdocLabel"><tr>
1154 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
1155 <td class="xdocLabelRight"></td>
1156 </tr></table>
1157 <div class="xdocSynMdcl">
1158 <div class="xdocSynCode">
1159 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
1160 </div>
1161 <div class="xdocSynCode">
1162 <tt></tt><tt></tt><b> ...</b>
1163 </div>
1164 <div class="xdocSynCode">
1165 <tt></tt><tt></tt>params.<span class="xdoc-id">remoteIntId</span> = <i><span class="xdoc-kw2">UInt</span></i> -1u;
1166 </div>
1167 </div>
1168 <div class="xdocSynSpacer"> </div>
1169 <span id="xdoc-sect-1"></span>
1170 <div class="xdocSect">DETAILS</div>
1171 <div class="xdocText">For devices that support multiple inter-processor interrupt lines, this
1172 configuration parameter allows selecting a specific line to use for
1173 receiving an interrupt. The value specified here corresponds to the
1174 incoming interrupt line on the remote processor.</div>
1175 <div class="xdocText">If this configuration is not set, a default interrupt id is
1176 typically chosen.</div>
1177 <div class="xdocSect">C SYNOPSIS</div>
1178 <div class="xdocText"><a class="xdoc-link" href="#remote.Int.Id" title="NotifyDriverShm_Params.remoteIntId">NotifyDriverShm_Params.remoteIntId</a></div>
1179 <div class="xdocSynSpacer"> </div>
1180 <a class="xdocAnchor" id="metaremote.Proc.Id"></a>
1181 <table class="xdocHdr"><tr>
1182 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.Params.</span><span class="xdoc-id">remoteProcId</span> <small><span class="xdocSynSum">// instance</span></small></td>
1183 <td class="xdocHdrArrow">
1184 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
1185 </table>
1186 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#remote.Proc.Id">index URL</a></div>
1187 <p class="xdocHdrSummaryDcl">The MultiProc ID corresponding to the remote processor</p>
1188 <span id='meta-synop'></span>
1189 <table class="xdocLabel"><tr>
1190 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
1191 <td class="xdocLabelRight"></td>
1192 </tr></table>
1193 <div class="xdocSynMdcl">
1194 <div class="xdocSynCode">
1195 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
1196 </div>
1197 <div class="xdocSynCode">
1198 <tt></tt><tt></tt><b> ...</b>
1199 </div>
1200 <div class="xdocSynCode">
1201 <tt></tt><tt></tt>params.<span class="xdoc-id">remoteProcId</span> = <i><span class="xdoc-kw2">UInt16</span></i> <a class="xdoc-link" href="../../../../ti/sdo/utils/MultiProc.html#.I.N.V.A.L.I.D.I.D" title="ti.sdo.utils.MultiProc.INVALIDID">MultiProc.INVALIDID</a>;
1202 </div>
1203 </div>
1204 <div class="xdocSynSpacer"> </div>
1205 <span id="xdoc-sect-1"></span>
1206 <div class="xdocSect">DETAILS</div>
1207 <div class="xdocText">This parameter must be set for every device. The
1208 <a class="xdoc-link" href="../../../../ti/sdo/utils/MultiProc.html#get.Id" title="ti.sdo.utils.MultiProc.getId">ti.sdo.utils.MultiProc.getId</a> call can be used to obtain
1209 a MultiProc id given the remote processor's name.</div>
1210 <div class="xdocSect">C SYNOPSIS</div>
1211 <div class="xdocText"><a class="xdoc-link" href="#remote.Proc.Id" title="NotifyDriverShm_Params.remoteProcId">NotifyDriverShm_Params.remoteProcId</a></div>
1212 <div class="xdocSynSpacer"> </div>
1213 <a class="xdocAnchor" id="metashared.Addr"></a>
1214 <table class="xdocHdr"><tr>
1215 <td class="xdocHdrTitle"><span class="xdoc-kw1">config</span> <span class="xdoc-id">NotifyDriverShm.Params.</span><span class="xdoc-id">sharedAddr</span> <small><span class="xdocSynSum">// instance</span></small></td>
1216 <td class="xdocHdrArrow">
1217 <a class="xdocHdrLink" href="../../../../ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html" title="module NotifyDriverShm"><img class="xdocHdrArrow" src="../../../../Arrow_up.png"/></a></td>
1218 </table>
1219 <div class=xdocHdrIndex><a class=xdocHdrIndex title="right-click to capture" href="../../../../index.html#ti/sdo/ipc/notifyDrivers/NotifyDriverShm.html#shared.Addr">index URL</a></div>
1220 <p class="xdocHdrSummaryDcl">Address in shared memory where this instance will be placed</p>
1221 <span id='meta-synop'></span>
1222 <table class="xdocLabel"><tr>
1223 <td class="xdocLabelLeft"><tt><span class="xdoc-id-meta2dcl"></span></tt>Configuration settings</td>
1224 <td class="xdocLabelRight"></td>
1225 </tr></table>
1226 <div class="xdocSynMdcl">
1227 <div class="xdocSynCode">
1228 <tt></tt><tt></tt><span class="xdoc-kw1">var</span> params = <span class="xdoc-kw1">new</span> NotifyDriverShm.<span class="xdoc-id">Params</span>;
1229 </div>
1230 <div class="xdocSynCode">
1231 <tt></tt><tt></tt><b> ...</b>
1232 </div>
1233 <div class="xdocSynCode">
1234 <tt></tt><tt></tt>params.<span class="xdoc-id">sharedAddr</span> = <i><span class="xdoc-kw2">Ptr</span></i> <span class="xdoc-kw2">null</span>;
1235 </div>
1236 </div>
1237 <div class="xdocSynSpacer"> </div>
1238 <span id="xdoc-sect-1"></span>
1239 <div class="xdocSect">DETAILS</div>
1240 <div class="xdocText">Use <a class="xdoc-link" href="NotifyDriverShm.html#shared.Mem.Req" title="sharedMemReq">sharedMemReq</a> to determine the amount of shared memory
1241 required.</div>
1242 <div class="xdocSect">C SYNOPSIS</div>
1243 <div class="xdocText"><a class="xdoc-link" href="#shared.Addr" title="NotifyDriverShm_Params.sharedAddr">NotifyDriverShm_Params.sharedAddr</a></div>
1244 </div>
1245 <div id="xdocDate">generated on Mon, 23 May 2016 14:31:21 GMT</div>
1246 </div></div></body>
1247 </html>