= Virginia Tech Cognitive Radio Open Source System =

 == Overview == 

An effort is currently beginning at [http://wireless.vt.edu/ Wireless @ VT] to develop an open source Cognitive Radio architecture.  The objective of the design is to develop a modular system that provides portability and interoperability between components developed using different programming languages.  Not only will this allow for flexible development for the cognitive radio system, but will allow developers to focus entirely on the component of choice and to not have to worry about developing or modifying components that have no relevance to their specific focus of research.

The current open source system consists of 6 categories of components with a couple being optional :

 * [#CognitiveRadioShell Cognitive Radio Shell] (CRS)
 * [#CognitiveEngine Cognitive Engine] (CE)
 * [#PolicyEngine Policy Engine] (PE) **
 * [#ServiceManagementLayer  Service Management Layer] (MSL) **
 * [#SoftwareDefinedRadioPlatform Software-Defined Radio Host Platform]

** Optional – A basic cognitive radio system is functional without this component.

The VT-CROSS is a modular cognitive radio system framework that utilizes socket connections for the inter-component communication method.  Utilizing a socket connection for component communication allows the system components to be developed in a language independent manner.  Even though the Cognitive Radio Shell library and API will be implemented in C++, the external modules such as the Cognitive Engine, Service Management Layer, and Policy Engine can be implemented in any language that supports a TCP/IP socket interface.

A sample of languages with a full socket interface implementation:
 * C
 * C++
 * C#
 * Java
 * Perl
 * Python
 * Ruby
 * D

In addition to the feature of language independent development, the natural benefit of a TCP/IP socket interface is the ability to operate modules remotely.  The Cognitive Radio Shell is located local to the radio hardware, however, the Cognitive Engine or Policy Engine can be located remotely on hardware more appropriate for complex optimization or for distributed policy decision making.  Clearly, the remote operation depends upon the timing critical nature of the return of the optimization results.  In no way does the TCP/IP socket communication limit the Cognitive Radio System to only remote modules, in fact local socket connections require little overhead and provide for a flexible method of connecting these major Cognitive Radio System components.  

 == Core Components ==
The following sections introduce the components to the VT-CROSS framework.  The core components are the Cognitive Radio Shell and the Cognitive Engine.  A fully functional system can be operated with only these two components and a Software-Defined Radio Host Platform.  Optional components such as the Policy Engine and Service Management Layer provide added capabilities that can dramatically improve the functionality of the system.

The VT-CROSS project group has developed an [http://en.wikipedia.org/wiki/API Application Programming Interface] (API) and communication protocols for each of the components in the system.  For detailed information about the individual component APIs and communication protocols, refer to the corresponding component sections.

 === Cognitive Radio Shell ===
 Message passer / XML Parser / Interface to hardware

The CRS initially parses XML configuration file that specifies the operation of the Cognitive Radio system.  This XML configuration file is assumed to be located locally with the CRS.  An example of this XML file is shown below:

{{{
#!xml
<engine name="myengine">

    <!-- utilities : QoS metrics -->
    <utilities>
        <utility name="throughput" units="kbps" goal="max" target="125" />
        <utility name="spectral_efficiency" units="b/s/Hz" goal="max" />
        <utility name="log10_ber" units="none" goal="min" target="-3" />
        <!-- <utility name="latency" units="ms" goal="min" target=100 /> -->
    </utilities>

    <!-- radio parameters -->
    <parameters>
        <parameter name="mod_scheme" min="1" max="4" step="1">
            <!-- BPSK, QPSK, 8-PSK, 16-QAM -->
            <affect utility="throughput" relationship="improve" />
            <affect utility="spectral_efficiency" relationship="improve" />
            <affect utility="log10_ber" relationship="degrade" />
        </parameter>
        <parameter name="tx_power" units="dBm" min="-30.0" max="0.0" step="0.1">
            <affect utility="log10_ber" relationship="improve"/>
        </parameter>
    </parameters>

    <!-- link/channel observations -->
    <observables>
        <observable name="SNR">
            <affect utility="log10_ber" relationship="improve" />
        </observable>
    </observables>
</engine>


}}}

[wiki:Cross/CognitiveRadioAPI VTCROSS Cognitive Radio API and Communication Protocol Information][[BR]]

[wiki:Cross/CognitiveRadioAPI_CCP VTCROSS Component Communication Protocol Information][[BR]]

[wiki:Cross/CognitiveRadioAPI_Components VTCROSS Component API and Communication Protocol Information]

 === Cognitive Engine ===

[wiki:Cross/CognitiveEngineAPI VTCROSS Cognitive Engine API and Communication Protocol Information]

 === Policy Engine ===

[wiki:Cross/PolicyEngineAPI VTCROSS Policy Engine API and Communication Protocol Information]

Explain me.

 === Service Management Layer  ===

Using a Service Management Layer essentially turns the VT-CROSS system into a Service Oriented Architecture.  The SML is responsible for requesting optimization from the appropriate Cognitive Engines that provide the services that correspond to the current Active Mission.  This concept operates at a higher layer than the traditional system without an SML.  Traditionally the system optimizes to meet a single set of objectives.  With the SML, the system is on a "mission", and it make take several, fundamentally different, optimizations from Cognitive Engines to achieve the Mission goals.  Each service may be executed using feedback from a previous service.

As a simple example, we present an example SML configuration file.


{{{
#!xml
<mission name="DSACommunication" id="0">
    <services>
        <service name="SpectrumScan"></service>
        <service name="OptimizeParameters"></service>
    </services>
</mission>

<mission name="RelayNearestNeighbor" id="1">
    <services>
        <service name="DetectNodes"></service>
        <service name="OptimizeParameters"></service>
    </services>
</mission>

<mission name="JamAllEnemy" id="2">
    <services>
        <service name="ClassifyEnemySignals"></service>
            <if value="wifi">
                <service name="DetectWiFiChannels"></service>
                <service name="OptimizeJamWiFi"></service>
            <if value="bluetooth">
                <service name="DetectBluetoothDevices"></service>
                <service name="OptimizeJamBluetooth"></service>
    </services>
</mission>

<mission name="CovertJamEnemy" id="3">
    <services>
        <service name="ClassifyEnemySignals"></service>
            <if value="wifi">
                <service name="DetectWiFiChannels"></service>
                <service name="OptimizeJamWiFi"></service>
            <if value="bluetooth">
                <service name="DetectBluetoothDevices"></service>
                <service name="OptimizeJamBluetooth"></service>
       <service name="MonitorForReemergedSignals"></service>
    </services>
</mission>



}}}




[wiki:Cross/ServiceManagementLayerAPI VTCROSS Service Management Layer API and Communication Protocol Information]



 === Software Defined Radio Platform ===

USRP1/2 for now

----
 == Case-Based Reasoning Reference Implementation ==
A reference implementation of a cognitive engine model is currently under development.  The initial implementation will consist of a case-based reasoning (CBR) engine developed in C and using the SQLite database code base to implement the database functionality.  The CBR functionality will consist of retrieving cases that are relevant to the current operating environment and communication objectives and adapt the cases in order to provide a better set of transmission parameters for the current given environment.  After the case is adapted, the set of transmission parameters is sent back to the CRS where the parameter values are applied to the radio resources.  Feedback is gathered from the receiver that provides information about how well the transmission parameters have met the performance objective goals.  This feedback is sent to the CE to provide for better adaptation in the future.  In the CBR implementation, the cases are updated with this new information.  

[[Image(cross_basic.png)]]