io.quisque.enelxsdk

Class EnelXManager

java.lang.Object

io.quisque.enelxsdk.EnelXManager

public abstract class EnelXManager
extends java.lang.Object

Main entry point of the EnelX SDK. It exposes all features in its static methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	EnelXManager.IdentifyChargingPointCallback
static interface	EnelXManager.ScanCallback Interface for implementing a callback for scanning features.
static interface	EnelXManager.StartChargeCallback
static interface	EnelXManager.StopChargeCallback

Constructor Summary

Constructors

Constructor and Description
EnelXManager()

Method Summary

Modifier and Type	Method and Description
static java.lang.String[]	getMissingPermissions(android.content.Context context) Returns an array with all those permissions that are required by the EnelX SDK but not yet granted by the user.
static void	identifyChargingPoint(android.content.Context context, ChargingPoint chargingPoint, java.lang.String chargeCardUid, EnelXManager.IdentifyChargingPointCallback callback) Makes blink or buzz the given charging point, thus the user can identify it.
static boolean	isBluetoothEnabled(android.content.Context context) Checks whether bluetooth on device is currently enabled.
static boolean	isSupported(android.content.Context context) Checks whether the EnelX SDK is supported by the current device.
static void	startCharge(android.content.Context context, ChargingPoint chargingPoint, java.lang.String chargeCardUid, EnelXManager.StartChargeCallback callback) Connects the given charging point and ask it to start charging.
static void	startScan(android.content.Context context, ChargingPoint.Status[] statusFilter, EnelXManager.ScanCallback callback) Starts scanning for charging points in one of the given statuses (or in any status if no filter is given).
static void	stopCharge(android.content.Context context, ChargingPoint chargingPoint, java.lang.String chargeCardUid, EnelXManager.StopChargeCallback callback) Connects the given charging point and ask it to stop charging.
static void	stopScan(android.content.Context context, EnelXManager.ScanCallback callback) Stops a previously started scanning operation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EnelXManager

public EnelXManager()

Method Detail

isSupported

public static boolean isSupported(android.content.Context context)

Checks whether the EnelX SDK is supported by the current device.

Parameters:

context - The application context.

Returns:

true if the SDK is supported, false otherwise.

getMissingPermissions

public static java.lang.String[] getMissingPermissions(android.content.Context context)

Returns an array with all those permissions that are required by the EnelX SDK but not yet granted by the user.

Parameters:

context - The application context.

Returns:

An array with currently missing permissions, which is empty in case no permission is currently missing.

isBluetoothEnabled

public static boolean isBluetoothEnabled(android.content.Context context)

Checks whether bluetooth on device is currently enabled.

Parameters:

context - The application context.

Returns:

true if bluetooth on device is currently enabled, false otherwise.

startScan

public static void startScan(android.content.Context context,
                             ChargingPoint.Status[] statusFilter,
                             EnelXManager.ScanCallback callback)

Starts scanning for charging points in one of the given statuses (or in any status if no filter is given).

If all requirements are met, the scanning operation is started and the caller is notified through the EnelXManager.ScanCallback.onScanStarted() method. Since now on, the scan is running until it is stopped by calling stopScan(Context, ScanCallback) or until an error causes the scanning operation to be automatically stopped. In both cases, the caller is notified through the EnelXManager.ScanCallback.onScanStopped() method.

Charging points detected during the scan are notified to the caller through the ScanCallback#onChargingPoint(ChargingPoint, ScanCallback.Event) method.

If an error occurs, before or after the scan has been started, it is notified to the caller through the ScanCallback#onScanError(ScanCallback.Error, Exception) method.

Parameters:

context - The application context.

statusFilter - The charging point status filters. If null or empty, no filter is applied and charging points in any status are returned.

callback - A callback object for receiving scan related events.

stopScan

public static void stopScan(android.content.Context context,
                            EnelXManager.ScanCallback callback)

Stops a previously started scanning operation.

Parameters:

context - The application context.

callback - The same callback object passed previously to the startScan(Context, ChargingPoint.Status[], ScanCallback) method for starting the scan.

startCharge

public static void startCharge(android.content.Context context,
                               ChargingPoint chargingPoint,
                               java.lang.String chargeCardUid,
                               EnelXManager.StartChargeCallback callback)

Connects the given charging point and ask it to start charging.

Parameters:

context - The application context.

chargingPoint - The target charging point.

chargeCardUid - The Charge Card UID needed to authorize the charge.

callback - A callback object for notifying results.

stopCharge

public static void stopCharge(android.content.Context context,
                              ChargingPoint chargingPoint,
                              java.lang.String chargeCardUid,
                              EnelXManager.StopChargeCallback callback)

Connects the given charging point and ask it to stop charging.

Parameters:

context - The application context.

chargingPoint - The target charging point.

chargeCardUid - The Charge Card UID needed to authorize the stop charge command.

callback - A callback object for notifying results.

identifyChargingPoint

public static void identifyChargingPoint(android.content.Context context,
                                         ChargingPoint chargingPoint,
                                         java.lang.String chargeCardUid,
                                         EnelXManager.IdentifyChargingPointCallback callback)

Makes blink or buzz the given charging point, thus the user can identify it.

Parameters:

context - The application context.

chargingPoint - The target charging point.

chargeCardUid - The Charge Card UID for identifying the charging point.

callback - A callback object for being notified about the operation results.