com.comthings.gollum.api.gollumandroidlib.utils

Class Utils

java.lang.Object

com.comthings.gollum.api.gollumandroidlib.utils.Utils

public class Utils
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Modifier and Type	Method and Description
static byte[]	arrayAddBytes(byte[] arr, byte... elements) This method will add elements to an array and return the resulting array
static double	calculateDistance(int txPower, double rssi) Estimates the distance between the mobile device and a BLE beacon based on the measured RSSI and a txPower calibration value that represents the expected RSSI for an iPhone 5 receiving the signal when it is 1 meter away.
static int	convertRssiDBmToPercent(int rssidBm) Convert a RSSI from dBm to percent.
static int	countSubstring(java.lang.String subStr, java.lang.String str) Count the number of non-overlapping occurrences of a substring inside a string.
static java.lang.String	getDeviceUniqueId(android.content.Context ctx) Get Android ID, a 64-bit number (as a hex string) that is randomly generated on the device's first boot and should remain constant for the lifetime of the device.
static java.lang.String	getPlatformSupportedAbis()
static long	getThreadId() Returns a reference to the currently executing thread object.
static java.lang.String	getThreadSignature() Returns a unique String identifying the current thread.
static byte[]	intToBytes(int i) Convert integer into 4 bytes array
static java.lang.Boolean	isBitSet(int data, int bitPos) Checks if a bit is set
static boolean	isDeviationNeeded(int modulation) Indicates if the modulation requires setting the deviation parameter.
static void	log(char logLevel, java.lang.String tag, java.lang.String text) Logging helper: put new logs into the UI console
static boolean	validateMacAddress(java.lang.String macAddress) Checks for MAC address correctness.

Methods inherited from class java.lang.Object

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

Constructor Detail

Utils

public Utils()

Method Detail

log

public static void log(char logLevel,
                       java.lang.String tag,
                       java.lang.String text)

Logging helper: put new logs into the UI console

Parameters:

logLevel - Priority of the log message: v,d,e,i,w,e,a

tag - Used to identify the source of a log message. It usually identifies the class or activity where the log call occurs.

text - The message you would like logged.

intToBytes

public static byte[] intToBytes(int i)

Convert integer into 4 bytes array

Parameters:

i - integer to convert

Returns:

Byte array of size 4 bytes

calculateDistance

public static double calculateDistance(int txPower,
                                       double rssi)

Estimates the distance between the mobile device and a BLE beacon based on the measured RSSI and a txPower calibration value that represents the expected RSSI for an iPhone 5 receiving the signal when it is 1 meter away. Cf. https://github.com/AltBeacon/android-beacon-library/blob/master/src/main/java/org/altbeacon/beacon/distance/CurveFittedDistanceCalculator.java

Parameters:

txPower - Reference rssi at 1m

rssi - Actual rssi at the current location

Returns:

Estimated distance in meters to the beacon based on a reference rssi at 1m and the known actual rssi at the current location

convertRssiDBmToPercent

public static int convertRssiDBmToPercent(int rssidBm)

Convert a RSSI from dBm to percent.

Parameters:

rssidBm - RSSI level to be converted.

Returns:

RSSI in percent.

isBitSet

public static java.lang.Boolean isBitSet(int data,
                                         int bitPos)

Checks if a bit is set

Parameters:

data - Data to check

bitPos - Index of bit to check

Returns:

True if bit is set, false else.

getDeviceUniqueId

public static java.lang.String getDeviceUniqueId(android.content.Context ctx)

Get Android ID, a 64-bit number (as a hex string) that is randomly generated on the device's first boot and should remain constant for the lifetime of the device. (The value may change if a factory reset is performed on the device.)

Parameters:

ctx - Current context

Returns:

Android ID

countSubstring

public static int countSubstring(java.lang.String subStr,
                                 java.lang.String str)

Count the number of non-overlapping occurrences of a substring inside a string. https://rosettacode.org/wiki/Count_occurrences_of_a_substring#Java

Parameters:

subStr - substring to be searched for

str - the string to search

Returns:

number of non-overlapping occurrences of subStr inside str

validateMacAddress

public static boolean validateMacAddress(java.lang.String macAddress)

Checks for MAC address correctness.

Parameters:

macAddress - A MAC address to check.

Returns:

true if the MAC address is valid

getThreadId

public static long getThreadId()

Returns a reference to the currently executing thread object.

Returns:

the currently executing thread.

getThreadSignature

public static java.lang.String getThreadSignature()

Returns a unique String identifying the current thread.

Returns:

A string containing thread name + thread ID + thread priority + thread group

arrayAddBytes

public static byte[] arrayAddBytes(byte[] arr,
                                   byte... elements)

This method will add elements to an array and return the resulting array

Parameters:

arr - Array of bytes where bytes elements need to be appended.

elements - Bytes to be appended.

Returns:

A new array of bytes where bytes elements have been appended.

isDeviationNeeded

public static boolean isDeviationNeeded(int modulation)

Indicates if the modulation requires setting the deviation parameter. Possible modulation values are <String, Integer>: "ASK/OOK": 48, "2-FSK": 0, "4-FSK: 64, "GFSK": 16, "MSK": 112

Parameters:

modulation - Modulation as an integer.

Returns:

true if the modulation requires setting the deviation parameter

getPlatformSupportedAbis

public static java.lang.String getPlatformSupportedAbis()

Returns:

An ordered list of ABIs supported by this device. The most preferred ABI is the first element in the list.