Skip to content

Commit

Permalink
Revision of proposal 0126-ATF-Additional-Transports
Browse files Browse the repository at this point in the history
  • Loading branch information
aderiabin committed Jul 9, 2021
1 parent 3662f9b commit 3bdef3d
Show file tree
Hide file tree
Showing 2 changed files with 17 additions and 24 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
41 changes: 17 additions & 24 deletions proposals/0126-atf-additional-transports.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# ATF support of additional transports (BT and USB)

* Proposal: [SDL-0126](0126-atf-additional-transports.md)
* Author: [Alexander Kutsan](https://github.com/LuxoftAKutsan)
* Status: **Accepted**
* Impacted Platforms: [Core]
* Author: [Alexander Kutsan](https://github.com/LuxoftAKutsan), [Oleksandr Deriabin](https://github.com/aderiabin)
* Status: **Awaiting review**
* Impacted Platforms: [ATF]

## Introduction

Expand Down Expand Up @@ -33,27 +33,20 @@ Main reasons :
## Proposed solution

Use real mobile device as a transport adapter.
Create Mobile application as a part of ATF infrastructure.
Mobile application may use [SDL android library](https://github.com/smartdevicelink/sdl_android)
for communicating with SDL and TCP connection for communication with ATF.

Mobile application (Mobile transport adapter) should provide to ATF side such RPCs:
- ConnectToSDL(transport)
- RemoveConnection(connection_id)
- GetListOfAvailableTransports()
- SendData(connection_id, data)

ATF should be able to connect to multiple Mobile transport adapters and provide ability to use any of them to test engineer.

ATF should provide such API to test engineer:
- ConnectToSDL(device, connection type)
- RemoveConnection(connection)
- SendRawData(connection)
- GetListOfAvailableDevices()
- GetDeviceInfo(device)

_СonnectToSDL_ should return connection object.
Connection object should provide ability to create sessions on it. Session interface should not be changed.
Create Android mobile application as a part of ATF infrastructure.
Mobile application should use HTTP connection with REST protocol for control communication with ATF using next API:
- GetDeviceInfo - Provides device's information
- ConnectToSDL - Connects to SDL and provides proxy TCP connection parameters
- DisconnectFromSDL - Disconnects from SDL
- GetSDLConnectionStatus - Provides status of connection to SDL
It should provide host and port of TCP server for raw binary data communication with ATF on establishing successful connection to SDL.
Mobile application should transfer data from ATF received by TCP server to SDL and vice versa.
Mobile application may use [SDL android library](https://github.com/smartdevicelink/sdl_android) for communicating with SDL.

ATF should be able to connect to multiple Mobile transport adapters and provide ability to use any of them to test engineer.

Test engineer should be able to to create sessions on provided by ATF mobile transport adapters.
Session interface should not be changed.

In the case where a mobile device is absent, ATF should be able to test SDL via TCP connection (as it does now).

Expand Down

0 comments on commit 3bdef3d

Please sign in to comment.