/* * Copyright 2020 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.uwb; import android.annotation.NonNull; import android.annotation.Nullable; import android.annotation.SystemApi; import android.os.Parcel; import android.os.Parcelable; import java.util.Arrays; /** * A class representing a UWB address * * @hide */ @SystemApi public final class UwbAddress implements Parcelable { public static final int SHORT_ADDRESS_BYTE_LENGTH = 2; public static final int EXTENDED_ADDRESS_BYTE_LENGTH = 8; private final byte[] mAddressBytes; private UwbAddress(byte[] address) { mAddressBytes = address; } /** * Create a {@link UwbAddress} from a byte array. * *
If the provided array is {@link #SHORT_ADDRESS_BYTE_LENGTH} bytes, a short address is * created. If the provided array is {@link #EXTENDED_ADDRESS_BYTE_LENGTH} bytes, then an * extended address is created. * * @param address a byte array to convert to a {@link UwbAddress} * @return a {@link UwbAddress} created from the input byte array * @throws IllegalArgumentException when the length is not one of * {@link #SHORT_ADDRESS_BYTE_LENGTH} or {@link #EXTENDED_ADDRESS_BYTE_LENGTH} bytes */ @NonNull public static UwbAddress fromBytes(@NonNull byte[] address) { if (address.length != SHORT_ADDRESS_BYTE_LENGTH && address.length != EXTENDED_ADDRESS_BYTE_LENGTH) { throw new IllegalArgumentException("Invalid UwbAddress length " + address.length); } return new UwbAddress(address); } /** * Get the address as a byte array * * @return the byte representation of this {@link UwbAddress} */ @NonNull public byte[] toBytes() { return mAddressBytes; } /** * The length of the address in bytes *
Possible values are {@link #SHORT_ADDRESS_BYTE_LENGTH} and
* {@link #EXTENDED_ADDRESS_BYTE_LENGTH}.
*/
public int size() {
return mAddressBytes.length;
}
@NonNull
@Override
public String toString() {
StringBuilder builder = new StringBuilder("0x");
for (byte addressByte : mAddressBytes) {
builder.append(String.format("%02X", addressByte));
}
return builder.toString();
}
@Override
public boolean equals(@Nullable Object obj) {
if (obj instanceof UwbAddress) {
return Arrays.equals(mAddressBytes, ((UwbAddress) obj).toBytes());
}
return false;
}
@Override
public int hashCode() {
return Arrays.hashCode(mAddressBytes);
}
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(@NonNull Parcel dest, int flags) {
dest.writeInt(mAddressBytes.length);
dest.writeByteArray(mAddressBytes);
}
public static final @android.annotation.NonNull Creator