1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-EC7DE823-BFAC-47E5-B7CC-154B11FE5D77" xml:lang="en"><title>Obsolete

    13 NKern Interrupt Methods</title><shortdesc>This document specifies two obsolete interrupt handling methods

    14 and describes their replacement.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <section id="GUID-5AE312EB-D12B-4836-AAEA-9A54E179DE5C"><title>Description

    16 of the obsolete interrupt methods</title><p>The obsolete <codeph>NKern</codeph> interrupt

    17 methods are: </p><ul>

    18 <li><p><xref href="GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02.dita#GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02/GUID-CA1C36B7-02EE-31D5-B700-27DE4769ECCF"><apiname>NKern::DisableInterrupts()</apiname></xref> and</p></li>

    19 <li><p><xref href="GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02.dita#GUID-3A3C08F3-3D33-3D9E-80E7-7855C7B21E02/GUID-8C251C65-FDE7-3161-8D2B-61401FB6487F"><apiname>NKern::DisableAllInterrupts()</apiname></xref></p></li>

    20 </ul><p>These methods are used (with other methods in the <codeph>NKern</codeph> class)

    21 to protect shared data between an ISR (Interrupt Service Request) and a thread

    22 (or a DFC (Delayed Function Call )). </p><p>The steps involved in disabling/enabling

    23 an interrupt are:</p><ol>

    24 <li id="GUID-68D7CCE7-6855-4817-BC0C-D5B70E485450"><p>Disable the interrupts</p></li>

    25 <li id="GUID-81CB8BE3-8663-4CF6-A0CA-E2A43B0ADB74"><p>Process the data</p></li>

    26 <li id="GUID-8D5DBB24-4FB7-4E9B-8714-AFFBDE060346"><p>Re-enable the interrupts</p></li>

    27 </ol><note>The time spent processing the data must be as short as possible,

    28 otherwise performance problems could occur.</note> </section>

    29 <section id="GUID-E58BC240-4388-4BD8-A5CB-A79C3502AD07"><title>The reason

    30 why these methods are obsolete</title><p>These methods only affect the core

    31 that the thread is running on instead of all the cores on the system.</p></section>

    32 <section id="GUID-9F89D474-D2AB-4DE9-92F3-7B1A1677EDB7"><title>The replacement

    33 for these methods</title><p>These methods have been replaced by the following:</p><ul>

    34 <li><p><xref href="GUID-16AB388A-ED3E-4901-857D-834072437D25.dita">Spin Lock</xref> macros</p><p>These

    35 macros automatically carry out the required interrupt operations.</p></li>

    36 <li><p><xref href="GUID-1F280171-A3F3-4129-8DBE-3B1C4D629C68.dita">Atomic Operations</xref></p></li>

    37 </ul></section>

    38 <section id="GUID-B6EEC990-2DBF-4858-8B40-7D0BC489C6DE"><title>Areas that

    39 could be affected</title><p>These obsolete methods are used within drivers

    40 and the following points should be considered when removing them:</p><ul>

    41 <li><p>Could the same functionality be accomplished by disabling the interrupts

    42 in hardware?</p></li>

    43 <li><p>Are these methods required at all?</p><p>If memory is not accessible

    44 in ISR (Interrupt Service Request) routines, then use spin locks or atomic

    45 operations.</p></li>

    46 <li><p>Explore the use of DFC (Delayed Function Call) signalling.</p></li>

    47 </ul></section>

    48 </conbody><related-links>

    49 <link href="GUID-734588CA-5644-438A-9CC9-77ECBE0C1EEA.dita"><linktext>Obsolete

    50 Mechanisms</linktext></link>

    51 <link href="GUID-16AB388A-ED3E-4901-857D-834072437D25.dita"><linktext>Spin Locks</linktext>

    52 </link>

    53 <link href="GUID-1F280171-A3F3-4129-8DBE-3B1C4D629C68.dita"><linktext> Atomic Operations</linktext>

    54 </link>

    55 </related-links></concept>