DBTGattChar.cxx

Go to the documentation of this file.

/*
 * Author: Sven Gothel <sgothel@jausoft.com>
 * Copyright (c) 2020 Gothel Software e.K.
 * Copyright (c) 2020 ZAFENA AB
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
 
#include "jau_direct_bt_DBTGattChar.h"
 
#include <jau/debug.hpp>
 
#include "helper_base.hpp"
#include "helper_dbt.hpp"
 
#include "direct_bt/BTDevice.hpp"
#include "direct_bt/BTAdapter.hpp"
 
using namespace direct_bt;
using namespace jau;
 
jstring Java_jau_direct_1bt_DBTGattChar_toStringImpl(JNIEnv *env, jobject obj) {
    try {
        BTGattChar *nativePtr = getJavaUplinkObject<BTGattChar>(env, obj);
        JavaGlobalObj::check(nativePtr->getJavaObject(), E_FILE_LINE);
        return from_string_to_jstring(env, nativePtr->toString());
    } catch(...) {
        rethrow_and_raise_java_exception(env);
    }
    return nullptr;
}
 
void Java_jau_direct_1bt_DBTGattChar_deleteImpl(JNIEnv *env, jobject obj, jlong nativeInstance) {
    (void)obj;
    try {
        BTGattChar *characteristic = castInstance<BTGattChar>(nativeInstance);
        (void)characteristic;
        // No delete: Service instance owned by BTGattService -> BTDevice
    } catch(...) {
        rethrow_and_raise_java_exception(env);
    }
}
 
static const std::string _descriptorClazzCtorArgs("(JLjau/direct_bt/DBTGattChar;Ljava/lang/String;S[B)V");
 
jobject Java_jau_direct_1bt_DBTGattChar_getDescriptorsImpl(JNIEnv *env, jobject obj) {
    try {
        BTGattChar *characteristic = getJavaUplinkObject<BTGattChar>(env, obj);
        JavaGlobalObj::check(characteristic->getJavaObject(), E_FILE_LINE);
 
        jau::darray<BTGattDescRef> & descriptorList = characteristic->descriptorList;
 
        // BTGattDesc(final long nativeInstance, final BTGattChar characteristic,
        //                   final String type_uuid, final short handle, final byte[] value)
 
        // BTGattDesc(final long nativeInstance, final BTGattChar characteristic,
        //                   final String type_uuid, final short handle, final byte[] value)
 
        std::function<jobject(JNIEnv*, jclass, jmethodID, BTGattDesc *)> ctor_desc =
                [](JNIEnv *env_, jclass clazz, jmethodID clazz_ctor, BTGattDesc *descriptor)->jobject {
                    // prepare adapter ctor
                    std::shared_ptr<BTGattChar> _characteristic = descriptor->getGattCharChecked();
                    JavaGlobalObj::check(_characteristic->getJavaObject(), E_FILE_LINE);
                    jobject jcharacteristic = JavaGlobalObj::GetObject(_characteristic->getJavaObject());
 
                    const jstring juuid = from_string_to_jstring(env_,
                            directBTJNISettings.getUnifyUUID128Bit() ? descriptor->type->toUUID128String() :
                                                                       descriptor->type->toString());
                    java_exception_check_and_throw(env_, E_FILE_LINE);
 
                    const size_t value_size = descriptor->value.getSize();
                    jbyteArray jval = env_->NewByteArray((jsize)value_size);
                    env_->SetByteArrayRegion(jval, 0, (jsize)value_size, (const jbyte *)descriptor->value.get_ptr());
                    java_exception_check_and_throw(env_, E_FILE_LINE);
 
                    jobject jdesc = env_->NewObject(clazz, clazz_ctor, (jlong)descriptor, jcharacteristic,
                            juuid, (jshort)descriptor->handle, jval);
                    java_exception_check_and_throw(env_, E_FILE_LINE);
                    JNIGlobalRef::check(jdesc, E_FILE_LINE);
                    std::shared_ptr<JavaAnon> jDescRef = descriptor->getJavaObject(); // GlobalRef
                    JavaGlobalObj::check(jDescRef, E_FILE_LINE);
                    env_->DeleteLocalRef(juuid);
                    env_->DeleteLocalRef(jval);
                    env_->DeleteLocalRef(jdesc);
                    return JavaGlobalObj::GetObject(jDescRef);
                };
        return convert_vector_sharedptr_to_jarraylist<jau::darray<BTGattDescRef>, BTGattDesc>(
                env, descriptorList, _descriptorClazzCtorArgs.c_str(), ctor_desc);
    } catch(...) {
        rethrow_and_raise_java_exception(env);
    }
    return nullptr;
}
 
jbyteArray Java_jau_direct_1bt_DBTGattChar_readValueImpl(JNIEnv *env, jobject obj) {
    try {
        BTGattChar *characteristic = getJavaUplinkObject<BTGattChar>(env, obj);
        JavaGlobalObj::check(characteristic->getJavaObject(), E_FILE_LINE);
 
        POctets res(BTGattHandler::number(BTGattHandler::Defaults::MAX_ATT_MTU), 0);
        if( !characteristic->readValue(res) ) {
            ERR_PRINT("Characteristic readValue failed: %s", characteristic->toString().c_str());
            return env->NewByteArray((jsize)0);
        }
 
        const size_t value_size = res.getSize();
        jbyteArray jres = env->NewByteArray((jsize)value_size);
        env->SetByteArrayRegion(jres, 0, (jsize)value_size, (const jbyte *)res.get_ptr());
        java_exception_check_and_throw(env, E_FILE_LINE);
        return jres;
 
    } catch(...) {
        rethrow_and_raise_java_exception(env);
    }
    return nullptr;
}
 
jboolean Java_jau_direct_1bt_DBTGattChar_writeValueImpl(JNIEnv *env, jobject obj, jbyteArray jval, jboolean withResponse) {
    try {
        if( nullptr == jval ) {
            throw IllegalArgumentException("byte array null", E_FILE_LINE);
        }
        const int value_size = env->GetArrayLength(jval);
        if( 0 == value_size ) {
            return JNI_TRUE;
        }
        BTGattChar *characteristic = getJavaUplinkObject<BTGattChar>(env, obj);
        JavaGlobalObj::check(characteristic->getJavaObject(), E_FILE_LINE);
 
        JNICriticalArray<uint8_t, jbyteArray> criticalArray(env); // RAII - release
        uint8_t * value_ptr = criticalArray.get(jval, criticalArray.Mode::NO_UPDATE_AND_RELEASE);
        if( NULL == value_ptr ) {
            throw InternalError("GetPrimitiveArrayCritical(byte array) is null", E_FILE_LINE);
        }
        TROOctets value(value_ptr, value_size);
        bool res;
        if( withResponse ) {
            res = characteristic->writeValue(value);
        } else {
            res = characteristic->writeValueNoResp(value);
        }
        if( !res ) {
            ERR_PRINT("Characteristic writeValue(withResponse %d) failed: %s",
                    withResponse, characteristic->toString().c_str());
            return JNI_FALSE;
        }
        return JNI_TRUE;
    } catch(...) {
        rethrow_and_raise_java_exception(env);
    }
    return JNI_FALSE;
}
 
jboolean Java_jau_direct_1bt_DBTGattChar_configNotificationIndicationImpl(JNIEnv *env, jobject obj,
                        jboolean enableNotification, jboolean enableIndication, jbooleanArray jEnabledState) {
    try {
        BTGattChar *characteristic = getJavaUplinkObjectUnchecked<BTGattChar>(env, obj);
        if( nullptr == characteristic ) {
            if( !enableNotification && !enableIndication ) {
                // OK to have native characteristic being shutdown @ disable
                DBG_PRINT("Characteristic's native instance has been deleted");
                return false;
            }
            throw IllegalStateException("Characteristic's native instance deleted", E_FILE_LINE);
        }
        JavaGlobalObj::check(characteristic->getJavaObject(), E_FILE_LINE);
 
        if( nullptr == jEnabledState ) {
            throw IllegalArgumentException("boolean array null", E_FILE_LINE);
        }
        const int state_size = env->GetArrayLength(jEnabledState);
        if( 2 > state_size ) {
            throw IllegalArgumentException("boolean array smaller than 2, length "+std::to_string(state_size), E_FILE_LINE);
        }
        JNICriticalArray<jboolean, jbooleanArray> criticalArray(env); // RAII - release
        jboolean * state_ptr = criticalArray.get(jEnabledState, criticalArray.Mode::UPDATE_AND_RELEASE);
        if( NULL == state_ptr ) {
            throw InternalError("GetPrimitiveArrayCritical(boolean array) is null", E_FILE_LINE);
        }
 
        bool cccdEnableResult[2];
        bool res = characteristic->configNotificationIndication(enableNotification, enableIndication, cccdEnableResult);
        DBG_PRINT("BTGattChar::configNotificationIndication Config Notification(%d), Indication(%d): Result %d",
                cccdEnableResult[0], cccdEnableResult[1], res);
        state_ptr[0] = cccdEnableResult[0];
        state_ptr[1] = cccdEnableResult[1];
        return res;
    } catch(...) {
        rethrow_and_raise_java_exception(env);
    }
    return JNI_FALSE;
}