ETSI TS 103 681-3 V1.1.1 (2020-03)

Reconfigurable Radio Systems (RRS); Radio Equipment (RE) information models and protocols for generalized software reconfiguration architecture; Part 3: generalized Unified Radio Application Interface (gURAI)

DTS/RRS-0224

General Information

• Status: Published
• Publication Date: 19-Mar-2020
• Technical Committee: RRS 2 - REA - Reconfigurable Radio Equipment Architecture
• Current Stage: 12 - Completion
• Due Date: 26-Mar-2020
• Completion Date: 20-Mar-2020

Standards Content (Sample)

ETSI TS 103 681-3 V1.1.1 (2020-03)






TECHNICAL SPECIFICATION
Reconfigurable Radio Systems (RRS);
Radio Equipment (RE) information models and protocols
for generalized software reconfiguration architecture;
Part 3: generalized Unified Radio Application Interface (gURAI)

---------------------- Page: 1 ----------------------
2 ETSI TS 103 681-3 V1.1.1 (2020-03)



Reference
DTS/RRS-0224
Keywords
interface, radio, SDR
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

Siret N° 348 623 562 00017 - NAF 742 C
Association à but non lucratif enregistrée à la
Sous-Préfecture de Grasse (06) N° 7803/88

Important notice
The present document can be downloaded from:
http://www.etsi.org/standards-search
The present document may be made available in electronic versions and/or in print. The content of any electronic and/or
print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any
existing or perceived difference in contents between such versions and/or in print, the prevailing version of an ETSI
deliverable is the one made publicly available in PDF format at www.etsi.org/deliver.
Users of the present document should be aware that the document may be subject to revision or change of status.
Information on the current status of this and other ETSI documents is available at
https://portal.etsi.org/TB/ETSIDeliverableStatus.aspx
If you find errors in the present document, please send your comment to one of the following services:
https://portal.etsi.org/People/CommiteeSupportStaff.aspx
Copyright Notification
No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying
and microfilm except as authorized by written permission of ETSI.
The content of the PDF version shall not be modified without the written authorization of ETSI.
The copyright and the foregoing restriction extend to reproduction in all media.

© ETSI 2020.
All rights reserved.

DECT™, PLUGTESTS™, UMTS™ and the ETSI logo are trademarks of ETSI registered for the benefit of its Members.

3GPP™ and LTE™ are trademarks of ETSI registered for the benefit of its Members and
of the 3GPP Organizational Partners.
oneM2M™ logo is a trademark of ETSI registered for the benefit of its Members and
of the oneM2M Partners.
®
GSM and the GSM logo are trademarks registered and owned by the GSM Association.
ETSI

---------------------- Page: 2 ----------------------
3 ETSI TS 103 681-3 V1.1.1 (2020-03)
Contents
Intellectual Property Rights . 4
Foreword . 4
Modal verbs terminology . 4
1 Scope . 5
2 References . 5
2.1 Normative references . 5
2.2 Informative references . 5
3 Definition of terms, symbols and abbreviations . 6
3.1 Terms . 6
3.2 Symbols . 7
3.3 Abbreviations . 7
4 Introduction . 8
5 System Identification . 9
5.1 Radio Computer Structure . 9
5.2 gURAI System Requirement Mapping. 11
6 Notational Tools . 11
6.1 Notational Tool for Information Model Classes . 11
6.2 Notational Tool for Interface Classes . 11
7 Information Model for Radio Computer . 12
7.1 Radio Computer . 12
7.2 Class Definitions for Information Model . 15
8 Interface Definition . 21
8.1 Interface Overview . 21
8.2 Radio Application Management Services . 22
8.2.1 Overview on Radio Application Management Services . 22
8.2.2 Messages for Radio Application Management Services . 23
8.3 User Data Flow Services . 23
8.3.1 Overview on User Data Flow Services . 23
8.3.2 Messages for User Data Flow Services . 24
8.4 Multiradio Control Services . 24
8.4.1 Overview on Multiradio Control Services . 24
8.4.2 Messages for Multiradio Control Services . 25
8.5 Class Definitions for Interface . 25
Annex A (informative): Abstract Data Definitions . 27
Annex B (informative): gURAI Qualification Methods for Validation . 31
History . 32

ETSI

---------------------- Page: 3 ----------------------
4 ETSI TS 103 681-3 V1.1.1 (2020-03)
Intellectual Property Rights
Essential patents
IPRs essential or potentially essential to normative deliverables may have been declared to ETSI. The information
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web
server (https://ipr.etsi.org/).
Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web
server) which are, or may be, or may become, essential to the present document.
Trademarks
The present document may include trademarks and/or tradenames which are asserted and/or registered by their owners.
ETSI claims no ownership of these except for any which are indicated as being the property of ETSI, and conveys no
right to use or reproduce any trademark and/or tradename. Mention of those trademarks in the present document does
not constitute an endorsement by ETSI of products, services or organizations associated with those trademarks.
Foreword
This Technical Specification (TS) has been produced by ETSI Technical Committee Reconfigurable Radio Systems
(RRS).
The present document is part 3 of a multi-part deliverable covering the Radio Equipment (RE) information models and
protocols, as identified below:
Part 1: "generalized Multiradio Interface (gMURI)";
Part 2: "generalized Reconfigurable Radio Frequency Interface (gRRFI)";
Part 3: "generalized Unified Radio Application Interface (gURAI)";
Part 4: "generalized Radio Programming Interface (gRPI)".
Modal verbs terminology
In the present document "shall", "shall not", "should", "should not", "may", "need not", "will", "will not", "can" and
"cannot" are to be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of
provisions).
"must" and "must not" are NOT allowed in ETSI deliverables except when used in direct citation.
ETSI

---------------------- Page: 4 ----------------------
5 ETSI TS 103 681-3 V1.1.1 (2020-03)
1 Scope
The scope of the present document is to define an information model and protocol for unified radio application interface
for radio equipment reconfiguration. The work is based on the Use Cases defined in ETSI TR 103 585 [i.1], on the
system requirements defined in ETSI TS 103 641 [1] and on the radio reconfiguration related architecture for
reconfigurable RE defined in ETSI TS 103 648 [i.2].
The present document will be based on ETSI EN 303 146-3 [i.6] and provide a generalized interface definition for the
generalized Unified Radio Application Interface.
2 References
2.1 Normative references
References are either specific (identified by date of publication and/or edition number or version number) or
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the
referenced document (including any amendments) applies.
Referenced documents which are not found to be publicly available in the expected location might be found at
https://docbox.etsi.org/Reference/.
NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee
their long term validity.
[1] ETSI TS 103 641: "Reconfigurable Radio Systems (RRS); Radio Equipment (RE) reconfiguration
requirements".
2.2 Informative references
References are either specific (identified by date of publication and/or edition number or version number) or
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the
referenced document (including any amendments) applies.
NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee
their long term validity.
The following referenced documents are not necessary for the application of the present document but they assist the
user with regard to a particular subject area.
[i.1] ETSI TR 103 585: "Reconfigurable Radio Systems (RRS); Radio Equipment (RE) reconfiguration
use cases".
[i.2] ETSI TS 103 648: "Reconfigurable Radio Systems (RRS); Radio Equipment (RE) reconfiguration
architecture".
TM
[i.3] IEEE 1900.4 -2009: "IEEE Standard for Architectural Building Blocks Enabling Network-
Device Distributed Decision Making for Optimized Radio Resource Usage in Heterogeneous
Wireless Access Networks".
[i.4] Recommendation ITU-T X.680: "Information technology - Abstract Syntax Notation One
(ASN.1): Specification of basic notation".
[i.5] Directive 2014/53/EU of the European Parliament and of the Council of 16 April 2014 on the
harmonisation of the laws of the Member States relating to the making available on the market of
Radio Equipment and repealing Directive 1999/5/EC.
[i.6] ETSI EN 303 146-3: "Reconfigurable Radio Systems (RRS); Mobile Device (MD) information
models and protocols; Part 3: Unified Radio Application Interface (URAI)".
ETSI

---------------------- Page: 5 ----------------------
6 ETSI TS 103 681-3 V1.1.1 (2020-03)
[i.7] ETSI TS 103 681-1: "Reconfigurable Radio Systems (RRS); Radio Equipment (RE) information
models and protocols for generalized software reconfiguration architecture; Part 1: generalized
Multiradio Interface (gMURI)".
[i.8] ETSI TS 103 681-2: "Reconfigurable Radio Systems (RRS); Radio Equipment (RE) information
models and protocols for generalized software reconfiguration architecture; Part 3: generalized
Unified Radio Application Interface (gURAI)".
[i.9] ETSI TS 103 681-4: "Reconfigurable Radio Systems (RRS); adio Equipment (RE) information
models and protocols for generalized software reconfiguration architecture; Part 4: generalized
Radio Programming Interface (gRPI)".
3 Definition of terms, symbols and abbreviations
3.1 Terms
For the purposes of the present document, the following terms apply:
association: logical communication link to a Radio Access Network or a peer equipment
NOTE 1: Typically, some control signalling is necessary to maintain the association. No user data transfer may
occur with only an association present, but a data flow may be established into an association for this
purpose.
NOTE 2: Peer equipment is any communication counterpart of a reconfigurable Radio Equipment. It can be
reached by establishing a logical communication link (i.e. an association) between the reconfigurable
Radio Equipment and peer equipment.
channel: designated part of the information transfer capability having specified characteristics, provided at the user
network interface
NOTE: It is the over-the-air wireless propagation channel which is used to convey an information signal from
transmitter to receiver. This definition is specified in ETSI TS 103 648 [i.2].
Communication Services Layer (CSL): layer related to communication services supporting generic applications
NOTE: A communication services layer supports generic applications like Internet access. In the present
document, it consists of Administrator, Mobility Policy Manager (MPM), Networking stack and Monitor.
link: connection from one location to another through a given Radio Access Technology for the purpose of transmitting
and receiving digital information
Radio Application (RA): software which enforces the generation of the transmit RF signals or the decoding of the
receive RF signals
NOTE 1: The Software is executed on a particular radio platform or an RVM as part of the radio platform.
NOTE 2: RAs might have different forms of representation. They are represented as:
 source codes including Radio Library calls of Radio Library native implementation and Radio HAL
calls;
 IRs including Radio Library calls of Radio Library native implementation and radio HAL calls;
 Executable codes for a particular radio platform.
radio computer: part of Radio Equipment hardware working under ROS control and on which RAs are executed
NOTE: A Radio Computer typically includes programmable processors, hardware accelerators, peripherals,
software, etc. RF part is considered to be part of peripherals.
ETSI

---------------------- Page: 6 ----------------------
7 ETSI TS 103 681-3 V1.1.1 (2020-03)
Radio Control Framework (RCF): control framework which, as a part of the OS, extends OS capabilities in terms of
radio resource management
NOTE: RCF is a control framework which consists of Configuration Manager (CM), Radio Connection Manager
(RCM), Flow Controller (FC) and Multiradio Controller (MRC). The Resource Manager (RM) is
typically part of OS.
Radio Equipment (RE): "an electrical or electronic product, which intentionally emits and/or receives radio waves for
the purpose of radio communication and/or radiodetermination, or an electrical or electronic product which must be
completed with an accessory, such as antenna, so as to intentionally emit and/or receive radio waves for the purpose of
radio communication and/or radiodetermination".
NOTE: The definition above is as defined in the Radio Equipment Directive, Article 2(1)(1) [i.5].
reconfigurable Radio Equipment: Radio Equipment with radio communication capabilities providing support for
radio reconfiguration
NOTE: Reconfigurable Radio Equipment includes Smartphones, Feature phones, Tablets, Laptops, Connected
Vehicle communication platform, Network platform, IoT device, etc.
Unified Radio Application (URA): Radio Application which complies with the reconfigurable RE framework defined
in the present document
3.2 Symbols
Void.
3.3 Abbreviations
For the purposes of the present document, the following abbreviations apply:
ASN.1 Abstract Syntax Notation One
BLER BLock Error Rate
CM Configuration Manager
CSL Communication Services Layer
FC Flow Controller
gMURI generalized Multiradio Interface
gRPI generalized Radio Programming Interface
gRRFI generalized Reconfigurable Radio Frequency Interface
gURAI generalized Unified Radio Application Interface
ID IDentification
IR Intermediate Representation
ITU-T International Telecommunication Union Telecommunication Standardization Sector
MPM Mobility Policy Manager
MRC MultiRadio Controller
OS Operating System
RA Radio Application
RAN Radio Access Network
RAP Radio Application Package
RAT Radio Access Technology
RCF Radio Control Framework
RCID Radio Computer IDentification
RCM Radio Connection Manager
RE Radio Equipment
RF Radio Frequency
RM Resource Manager
ROS Radio Operating System
RX Receiver
SINR Signal to Interference plus Noise Ratio
TX Transmitter
UML Unified Modelling Language
ETSI

---------------------- Page: 7 ----------------------
8 ETSI TS 103 681-3 V1.1.1 (2020-03)
URA Unified Radio Applications
4 Introduction
A reconfigurable RE is capable of running multiple radios simultaneously, changing the set of radios by loading new
Radio Application Packages (RAP) and setting their parameters. All Radio Applications (RAs) are called Unified Radio
Applications (URAs) when they exhibit a common behaviour from the reconfigurable RE's point of view in ETSI
TS 103 648 [i.2]. In order to run multiple URAs, the reconfigurable RE will include Communication Services Layer
(CSL), Radio Control Frameworks (RCFs), Radio Platforms and 4 sets of interfaces for their interconnection.

Figure 4.1: Four sets of interfaces for Reconfigurable RE
Figure 4.1 illustrates the Reconfigurable RE architecture with the 4 sets of interfaces, i.e.:
• gMURI for interfacing CSL and RCF (in ETSI TS 103 681-1 [i.7]);
• gRRFI for interfacing URA and RF Transceiver (in ETSI TS 103 681-2 [i.8]);
• gURAI for interfacing URA and RCF which is the scope of the present document;
• gRPI for allowing an independent and uniform production of RAs (in ETSI TS 103 681-4 [i.9]).
The present document defines gURAI.
ETSI

---------------------- Page: 8 ----------------------
9 ETSI TS 103 681-3 V1.1.1 (2020-03)
<< in t erf a ce >>
IgM U R I
<< in t e rf a ce >>
IgRRF I
RadioComputer
<< in t erf a ce >>
IgU R AI
<< in t erf a ce >>
IgR PI

Figure 4.2: UML class diagram for Radio Computer interfaces
Figure 4.2 illustrates UML class diagram for Radio Computer interfaces. The reconfigurable RE may be seen as a set of
multiple Radio Computers where individual URAs are engineered as software entities in ETSI TS 103 648 [i.2].
The present document is organized as follows:
• clause 5 describes the system identification;
• clause 6 describes the notational tool for defining both information model classes and interface classes;
• clause 7 describes the information model for radio computer; and
• clause 8 describes the interface definition.
While UML is used for defining the information model and protocol related to gURAI, other modelling languages could
be used as well.
5 System Identification
5.1 Radio Computer Structure
Figure 5.1 illustrates how RCF and URA interact with each other using gURAI.
ETSI

---------------------- Page: 9 ----------------------
10 ETSI TS 103 681-3 V1.1.1 (2020-03)

Figure 5.1: Interconnection between RCF and URA using gURAI for Reconfigurable RE
As shown in figure 5.1, gURAI supports 3 kinds of services:
• Radio Application Management Services
- These services are used by Radio Connection Manager (RCM) which is included in the RCF, to control
URA functions such as reporting of discovered Peer Equipment's, creating/terminating association with
Peer Equipment, starting/stopping communication with Peer Equipment, etc.
• User Data Flow Services
- These services are used by Flow Controller (FC) which is included in the RCF, to transmit user data to
URA, or used by URA to transmit received user data to FC. These services also include management of
data flow, which is provided by FC.
• Multiradio Control Services
- These services are used by Multiradio Controller (MRC) which is included in RCF, to manage spectral
resource usage.
- The RCF and URA are defined in ETSI TS 103 648 [i.2].
ETSI

---------------------- Page: 10 ----------------------
11 ETSI TS 103 681-3 V1.1.1 (2020-03)
5.2 gURAI System Requirement Mapping
The Radio Computer components above described shall support the gURAI system requirements shown in table 5.1 and
described in clause 6 of ETSI TS 103 641 [1].
Table 5.1: Mapping of Radio Computer Components to
the system requirements described in ETSI TS 103 641 [1]
Entity/Component/Unit System Requirements [1] Comments
Flow Controller R-FUNC-RAT-05 The requirement is described in clause 6.1.5 of [1]
R-FUNC-RA-04 The requirement is described in clause 6.2.4 of [1]
Multiradio Controller R-FUNC-RAT-01 The requirement is described in clause 6.1.1 of [1]
R-FUNC-RAT-02 The requirement is described in clause 6.1.2 of [1]
R-FUNC-RAT-03 The requirement is described in clause 6.1.3 of [1]
R-FUNC-RAT-06 The requirement is described in clause 6.1.6 of [1]
R-FUNC-RER-03 The requirement is described in clause 6.4.3 of [1]
Radio Connection Manager R-FUNC-RAT-04 The requirement is described in clause 6.1.4 of [1]
R-FUNC-RAT-05 The requirement is described in clause 6.1.5 of [1]
R-FUNC-RAT-06 The requirement is described in clause 6.1.6 of [1]
R-FUNC-RA-03 The requirement is described in clause 6.2.3 of [1]
R-FUNC-RER-03 The requirement is described in clause 6.4.3 of [1]

6 Notational Tools
6.1 Notational Tool for Information Model Classes
TM
In the present document, information model classes are used as defined in annex B.1 of IEEE 1900.4 -2009 [i.3].
6.2 Notational Tool for Interface Classes
Table 6.1 shows a template for defining interface classes for gURAI. Each interface class for gURAI will be defined in
clause 8.5 in accordance with the template shown in table 6.1.
Table 6.1: Template for defining Interface Classes
Class[(abstract class)]

OPERATIONS
Return type: Value type:




The template fields in table 6.1 are described below:
• is the name of the Class as it appears in the corresponding model. Additional information is also
included in case the class in question has been specified as an abstract one.
• OPERATIONS field describes the operations that have been defined in the class. More specifically:
- identifies the name of an operation, as it is included in the class definition.
- identifies the type of return value at the corresponding operation. Details related to the
ASN.1 module are specified in annex B.
- identifies the access levels for member functions: public, private, protected.
ETSI

---------------------- Page: 11 ----------------------
12 ETSI TS 103 681-3 V1.1.1 (2020-03)
7 Information Model for Radio Computer
7.1 Radio Computer
Figure 7.1 shows the UML class diagram for Radio Computer classes related to gURAI which are required to support
Software Reconfiguration. The diagram includes classes which are directly and indirectly related to gURAI.
RCMeasurements
-listOfActiveMeasurements:
<>
ActiveMeasurementsList
IgUR AI
1
R CC onf i gur at io n R adioCompute r
1
-RCID: NameType
Radio OS
1
0,1 1
0.* -rOSID: NameType
RCCapabi liti es
-rOSVersion: Version
Link
0.* -listOfSupportedOptions: RCOptions
-listOfSupportedRadioInterfaces:
RadioInterfaces
-listOfSupportedChannels: ChannelIDs
-hardwareProfile: HardwareInfo 0.*
R adioApp
-softwa0.re.*Profile: SoftwareInfo
0.*
1
0.*
L ink Pr o f ile
Ch anne l
-linkID: NameType
-cellID: NameType
-associatedChannelID:
R a dio Ap pProf i le
OptiaonlObjectName
-linkDirection : Direction
-RadioAppID: NameType
1
0,1 Ch anne lPr ofil e
-CarrierFrequecy: Frequency
-RAVersion: Version
-nominalRFPower:
-direction: Direction
-channelID: NameType
1
AnaloguePower
-listOfSupportedOptions:
-channelFrequecyRange:
-samplingRate: SamplingRate RAOptions
FrequencyRange
-bandwidth: Bandwidth
-listOfAssociatedLinks: Links
1
-radioInterface:
RadioInterface
-cellID: NameType
L ink M e asur e m ent s
R adioAppCapabilitie s
-receiveBLER: RxBLER
1
-listOfSupportedApplication
-trasmitPower: TxPower
1
1 Measurements:
-receiveSINR: RxSINR
Ch anne lM e asur em en t s
ApplicationMeasurementsIds
-transmittedBits: TxBits
-listOfChannelMeasurements:
1
ChannelMeasurementsList
-appliedMeasurementConfiguration:
R FC onf igurat i on
Config uratio nMesurements
R adioAppConfigurat ion
1
Antenn a
1.*
0,1
R adioAppMeasure me nt s
1
-listOfActiveApplication
TxP at h RxPath
1 Measurements:
Antenn aProfi le
-txStartTime: TxStartTime
-rxStartTime: RxStartTime ApplicationMeasurements
-txStopTime: TxStopTime 1
-rxStopTime: RxStopTime
-antennaID:
1
NameType

Figure 7.1: UML class diagram for Radio Computer classes related to gURAI
ETSI

---------------------- Page: 12 ----------------------
13 ETSI TS 103 681-3 V1.1.1 (2020-03)
The Radio Computer classes related to gURAI are defined as follows:
• RadioComputer
- This class contains all URA(s) related information about resources and interactions related to hardware
and software of a reconfigurable RE, for example, computational/spectral resource usage, collection of
context information, channel measurement results, etc.
• RadioOS
- This class describes an installed Radio OS. Each instance of a RadioComputer class can relate to zero or
one instance of RadioOS class (0,1). Each instance of RadioOS class is associated with zero or several
instances of RadioApp class (0.*).
• RadioApp
- This class describes one currently active Radio Application. Each instance of a RadioComputer class can
relate to zero or several instances of RadioApp class (0.*). Each instance of RadioApp class is
associated with one instance of Radio OS class. Each instance of RadioApp class is associated with zero,
one or many instances of Link class.
• RadioAppProfile
- This class contains general information about the Radio Application, for example, Radio Application ID,
current version of Radio Application, direction (downlink or uplink), links used to deliver this Radio
Application, etc. Each instance of a RadioApp class can have only one instance of RadioAppProfile class
as a member.
• RadioAppCapabilities
- This class contains information about measurements supported by this Radio Application, for example,
delay, loss, and bandwidth measurements. Each instance of a RadioApp class can have only one instance
of RadioAppCapabilities class as a member.
• RadioAppMeasurements
- This class contains measurements performed by this Radio Application, for example, delay, loss, and
bandwidth measurements. Each instance of a RadioApp class can have only one instance of
RadioAppMeasurements class as a member. Multiple measurements are contained within the instance of
the class.
• RCMeasurements
- This class contains current measurements (instantaneous measurement data and related metadata) related
to Reconfigurable RE such as battery capacity, user mobility, RE location determination, and connection
history information. Each instance of RadioComputer class shall have only one instance of
RCMeasurements class as a member.
• RCCapabilities
- This class contains information about Radio Computer capabilities including hardware, software,
transmission and measurement capabilities such as
...