https://github.com/Truphone/LPAd_SM-DPPlus_Connector
Local Profile Assistant for Device (LPAd) - LPAd SM-DP+ Connector
https://github.com/Truphone/LPAd_SM-DPPlus_Connector
Last synced: 6 months ago
JSON representation
Local Profile Assistant for Device (LPAd) - LPAd SM-DP+ Connector
- Host: GitHub
- URL: https://github.com/Truphone/LPAd_SM-DPPlus_Connector
- Owner: Truphone
- License: apache-2.0
- Created: 2018-06-18T10:06:55.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-05-02T04:04:36.000Z (about 2 years ago)
- Last Synced: 2024-08-03T22:04:23.046Z (9 months ago)
- Language: Java
- Size: 215 KB
- Stars: 80
- Watchers: 12
- Forks: 51
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-telco - LPAd SM-DP+ Connector - Local Profile Assistant for Device (LPAd) - LPAd SM-DP+ Connector (SIMCards)
README
Local Profile Assistant for Device (LPAd) - LPAd SM-DP+ Connector
This project offers an implementation of the
[SGP22](https://www.gsma.com/newsroom/wp-content/uploads//SGP.22_v2.2.pdf) Local
Profile Assistant for Device (*LPAd*).
Allows communication with the *SM-DP+* and implements the needed logic of *ES9+
(LPA -- SMDP+) interface*. It is also implemented all the logic for *ES10x (LPA
-- eUICC)* interface. It is implemented in *Java*.
LPAd Truphone Projects
The current project is only one part of several other *Truphone*’s\* *projects
that implement* LPAd *totally. The following diagram gives an overview of
currently existing projects that relate to* Truphone*’s* LPAd \*implementation:
High level explanation of the several *Truphone*’s *LPAd* projects:
- **LPAd React-Native** - *UI* for List Profiles, Download a Profile and
Enable/Disable/Delete a Profile. It is implemented in *React-Native*.
- **LPAd React-Native/Android Bridge** - Allows *React-Native* sub-project
code to communicate with *LPAd Android* sub-project code. This
implementation is specific for *React-Native* and *Android*/*Java*.
- **LPAd Android** - Allows communication (through *Android TelephonyManager*)
with the installed *eUICC* on the *Device*. It is also the *Proxy* to *LPAd
RSP Connector* sub-project. Implemented in Android/*Java*
- **LPAd SM-DP+ Connector** - This project. Allows communication with the
*SM-DP+* and implements the needed logic of *ES9+ (LPA -- SMDP+) interface*.
It is also implemented all the logic for *ES10x (LPA -- eUICC)* interface.
It is implemented in *Java*.
LPAd SM-DP+ Connector High Level Architecture
The following diagram depicts the project high level architecture:
Usage
Maven coordinates to import this lib into your project:
* Gradle
```gradle
com.truphone.lpad:lpad-sm-dp-plus-connector:1.0.4
```
* Maven
```maven
com.truphone.lpad
lpad-sm-dp-plus-connector
1.0.4
```
To start using this lib in your code, you'll only need to write the following lines:
* Get EID
```java
// Your ApduChannelImpl implementation
ApduChannelImpl apduChannel = new ApduChannelImpl(getApplicationContext());
LocalProfileAssistantImpl localProfileAssistant = new LocalProfileAssistantImpl(apduChannel, "");
String eid = localProfileAssistant.getEID();
```
* Allocate Profile
```java
// Your ApduChannelImpl implementation
ApduChannelImpl apduChannel = new ApduChannelImpl(getApplicationContext());
LocalProfileAssistantImpl localProfileAssistant = new LocalProfileAssistantImpl(apduChannel, "");
String acToken = localProfileAssistant.allocateProfile("268");
```
APDU Channel Simulator
This component implements the APDU Channel interface which can be used to create E2E tests dynamically without depending on a specific APDU Channel implementation.
Usage
Maven coordinates to import this lib into your project:
* Gradle
```gradle
com.truphone.lpad:apdu-channel-simulator:1.0.4
```
* Maven
```maven
com.truphone.lpad
apdu-channel-simulator
1.0.4
```
The modo-operandis is first of all define the expectation result for the operation you want to invoke, and then perform the invocation.
Examples:
* TransmitAPDU
```java
// initialization
LpadApduChannelSimulator lpadApduChannelSimulator = new LpadApduChannelSimulator(new MapPersistence(new HashMap()));
// first you need to define the expectation
lpadApduChannelSimulator.setTransmitAPDUExpectation("APDU_SUCCESS", "asdsdasd23123easd");
// then invoke the 'TransmitAPDU' operation which will return the value defined on the expectation
assertEquals("asdsdasd23123easd", lpadApduChannelSimulator.transmitAPDU("APDU_SUCCESS"));
```