এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

গাড়ী ওয়াচডগ

VHAL ডিবাগ করতে কার ওয়াচডগ ব্যবহার করুন। কার ওয়াচডগ অস্বাস্থ্যকর প্রক্রিয়াগুলির স্বাস্থ্য পর্যবেক্ষণ করে — এবং হত্যা করে —। গাড়ী ওয়াচডগ দ্বারা নিরীক্ষণ করার জন্য একটি প্রক্রিয়ার জন্য, প্রক্রিয়াটি গাড়ী ওয়াচডগের সাথে নিবন্ধিত হতে হবে। যখন গাড়ির ওয়াচডগ অস্বাস্থ্যকর প্রক্রিয়াগুলিকে মেরে ফেলে, তখন গাড়ির ওয়াচডগ অন্যান্য অ্যাপ্লিকেশন নট রেসপন্ডিং (ANR) ডাম্পের মতো data/anr এ প্রসেসের অবস্থা লেখে। এটি করার ফলে ডিবাগিং প্রক্রিয়ার সুবিধা হয়।

এই নিবন্ধটি বর্ণনা করে যে কীভাবে বিক্রেতা HAL এবং পরিষেবাগুলি গাড়ী ওয়াচডগের সাথে একটি প্রক্রিয়া নিবন্ধন করতে পারে৷

বিক্রেতা HAL

সাধারণত, বিক্রেতা HAL hwbinder এর জন্য একটি থ্রেড পুল ব্যবহার করে। যাইহোক, কার ওয়াচডগ ক্লায়েন্ট গাড়ি ওয়াচডগ ডেমনের সাথে binder মাধ্যমে যোগাযোগ করে, যা hwbinder থেকে আলাদা। অতএব, binder জন্য আরেকটি থ্রেড পুল ব্যবহার করা হচ্ছে।

মেকফাইলে গাড়ির ওয়াচডগ আইডিএল উল্লেখ করুন

shared_libs carwatchdog_aidl_interface-ndk_platform অন্তর্ভুক্ত করুন:

Android.bp :

cc_defaults {
    name: "vhal_v2_0_defaults",
    shared_libs: [
        "libbinder_ndk",
        "libhidlbase",
        "liblog",
        "libutils",
        "android.hardware.automotive.vehicle@2.0",
        "carwatchdog_aidl_interface-ndk_platform",
    ],
    cflags: [
        "-Wall",
        "-Wextra",
        "-Werror",
    ],
}

একটি SELinux নীতি যোগ করুন

system_server আপনার এইচএএল মারার অনুমতি দিন। আপনার যদি system_server.te না থাকে তবে একটি তৈরি করুন। প্রতিটি ডিভাইসে একটি SELinux নীতি যোগ করার জন্য দৃঢ়ভাবে সুপারিশ করা হয়।
বিক্রেতা HAL কে বাইন্ডার ব্যবহার করার অনুমতি দিন ( binder_use macro) এবং carwatchdog ক্লায়েন্ট ডোমেনে ( carwatchdog_client_domain macro) বিক্রেতা HAL যোগ করুন। systemserver.te এবং vehicle_default.te এর জন্য নিচের কোডটি দেখুন:
system_server.te
```
# Allow system_server to kill vehicle HAL
allow system_server hal_vehicle_server:process sigkill;
```
hal_vehicle_default.te
```
# Configuration for register VHAL to car watchdog
carwatchdog_client_domain(hal_vehicle_default)
binder_use(hal_vehicle_default)
```

BnCarWatchdogClient উত্তরাধিকারসূত্রে পেয়ে একটি ক্লায়েন্ট ক্লাস বাস্তবায়ন করুন

checkIfAlive এ, স্বাস্থ্য পরীক্ষা করুন। উদাহরণস্বরূপ, থ্রেড লুপ হ্যান্ডলারে পোস্ট করুন। সুস্থ থাকলে ICarWatchdog::tellClientAlive কল করুন। WatchogClient.h এবং WatchogClient.cpp জন্য নিচের কোডটি দেখুন:

WatchogClient.h

class WatchdogClient : public aidl::android::automotive::watchdog::BnCarWatchdogClient {
  public:
    explicit WatchdogClient(const ::android::sp<::android::Looper>& handlerLooper, VehicleHalManager* vhalManager);


    ndk::ScopedAStatus checkIfAlive(int32_t sessionId, aidl::android::automotive::watchdog::TimeoutLength timeout) override;
    ndk::ScopedAStatus prepareProcessTermination() override;
};

WatchogClient.cpp

ndk::ScopedAStatus WatchdogClient::checkIfAlive(int32_t sessionId, TimeoutLength /*timeout*/) {
    // Implement or call your health check logic here
    return ndk::ScopedAStatus::ok();
}

বাইন্ডার থ্রেড শুরু করুন এবং ক্লায়েন্ট নিবন্ধন করুন

বাইন্ডার যোগাযোগের জন্য একটি থ্রেড পুল তৈরি করুন। যদি বিক্রেতা HAL তার নিজস্ব উদ্দেশ্যে hwbinder ব্যবহার করে, তাহলে আপনাকে অবশ্যই গাড়ির ওয়াচডগ বাইন্ডার যোগাযোগের জন্য আরেকটি থ্রেড পুল তৈরি করতে হবে)।
নাম দিয়ে ডেমন খুঁজুন এবং ICarWatchdog::registerClient কল করুন। গাড়ী ওয়াচডগ ডেমন ইন্টারফেসের নাম android.automotive.watchdog.ICarWatchdog/default ।

পরিষেবার প্রতিক্রিয়াশীলতার উপর ভিত্তি করে, গাড়ী ওয়াচডগ দ্বারা সমর্থিত নিম্নলিখিত তিনটি ধরণের টাইমআউটের মধ্যে একটি নির্বাচন করুন এবং তারপরে ICarWatchdog::registerClient কে কল করার সময় টাইমআউট পাস করুন:

গুরুতর (3s)
মাঝারি (5 সেকেন্ড)
স্বাভাবিক (10 সেকেন্ড)

VehicleService.cpp এবং WatchogClient.cpp জন্য নীচের কোডটি দেখুন:

VehicleService.cpp

int main(int /* argc */, char* /* argv */ []) {
    // Set up thread pool for hwbinder
    configureRpcThreadpool(4, false /* callerWillJoin */);

    ALOGI("Registering as service...");
    status_t status = service->registerAsService();

    if (status != OK) {
        ALOGE("Unable to register vehicle service (%d)", status);
        return 1;
    }

    // Setup a binder thread pool to be a car watchdog client.
    ABinderProcess_setThreadPoolMaxThreadCount(1);
    ABinderProcess_startThreadPool();
    sp<Looper> looper(Looper::prepare(0 /* opts */));
    std::shared_ptr<WatchdogClient> watchdogClient =
            ndk::SharedRefBase::make<WatchdogClient>(looper, service.get());
    // The current health check is done in the main thread, so it falls short of capturing the real
    // situation. Checking through HAL binder thread should be considered.
    if (!watchdogClient->initialize()) {
        ALOGE("Failed to initialize car watchdog client");
        return 1;
    }
    ALOGI("Ready");
    while (true) {
        looper->pollAll(-1 /* timeoutMillis */);
    }

    return 1;
}

WatchogClient.cpp

bool WatchdogClient::initialize() {
    ndk::SpAIBinder binder(AServiceManager_getService("android.automotive.watchdog.ICarWatchdog/default"));
    if (binder.get() == nullptr) {
        ALOGE("Failed to get carwatchdog daemon");
        return false;
    }
    std::shared_ptr<ICarWatchdog> server = ICarWatchdog::fromBinder(binder);
    if (server == nullptr) {
        ALOGE("Failed to connect to carwatchdog daemon");
        return false;
    }
    mWatchdogServer = server;

    binder = this->asBinder();
    if (binder.get() == nullptr) {
        ALOGE("Failed to get car watchdog client binder object");
        return false;
    }
    std::shared_ptr<ICarWatchdogClient> client = ICarWatchdogClient::fromBinder(binder);
    if (client == nullptr) {
        ALOGE("Failed to get ICarWatchdogClient from binder");
        return false;
    }
    mTestClient = client;
    mWatchdogServer->registerClient(client, TimeoutLength::TIMEOUT_NORMAL);
    ALOGI("Successfully registered the client to car watchdog server");
    return true;
}

ভেন্ডর সার্ভিসেস (নেটিভ)

গাড়ী ওয়াচডগ aidl makefile উল্লেখ করুন

shared_libs carwatchdog_aidl_interface-ndk_platform অন্তর্ভুক্ত করুন।

Android.bp

cc_binary {
    name: "sample_native_client",
    srcs: [
        "src/*.cpp"
    ],
    shared_libs: [
        "carwatchdog_aidl_interface-ndk_platform",
        "libbinder_ndk",
    ],
    vendor: true,
}

একটি SELinux নীতি যোগ করুন

একটি SELinux পলিসি যোগ করতে, ভেন্ডর সার্ভিস ডোমেনকে বাইন্ডার ( binder_use macro) ব্যবহার করার অনুমতি দিন এবং carwatchdog ক্লায়েন্ট ডোমেনে ( carwatchdog_client_domain ম্যাক্রো) ভেন্ডর সার্ভিস ডোমেন যোগ করুন। sample_client.te এবং file_contexts জন্য নিচের কোডটি দেখুন:
sample_client.te
```
type sample_client, domain;
type sample_client_exec, exec_type, file_type, vendor_file_type;

carwatchdog_client_domain(sample_client)

init_daemon_domain(sample_client)
binder_use(sample_client)
```
ফাইল_প্রসঙ্গ
```
/vendor/bin/sample_native_client  u:object_r:sample_client_exec:s0
```

BnCarWatchdogClient উত্তরাধিকারসূত্রে পেয়ে একটি ক্লায়েন্ট ক্লাস বাস্তবায়ন করুন

checkIfAlive এ, স্বাস্থ্য পরীক্ষা করুন। একটি বিকল্প হল থ্রেড লুপ হ্যান্ডলারে পোস্ট করা। সুস্থ থাকলে ICarWatchdog::tellClientAlive কল করুন। SampleNativeClient.h এবং SampleNativeClient.cpp জন্য নীচের কোডটি দেখুন:

SampleNativeClient.h

class SampleNativeClient : public BnCarWatchdogClient {
public:
    ndk::ScopedAStatus checkIfAlive(int32_t sessionId, TimeoutLength
        timeout) override;
    ndk::ScopedAStatus prepareProcessTermination() override;
    void initialize();

private:
    void respondToDaemon();
private:
    ::android::sp<::android::Looper> mHandlerLooper;
    std::shared_ptr<ICarWatchdog> mWatchdogServer;
    std::shared_ptr<ICarWatchdogClient> mClient;
    int32_t mSessionId;
};

SampleNativeClient.cpp

ndk::ScopedAStatus WatchdogClient::checkIfAlive(int32_t sessionId, TimeoutLength timeout) {
    mHandlerLooper->removeMessages(mMessageHandler,
        WHAT_CHECK_ALIVE);
    mSessionId = sessionId;
    mHandlerLooper->sendMessage(mMessageHandler,
        Message(WHAT_CHECK_ALIVE));
    return ndk::ScopedAStatus::ok();
}
// WHAT_CHECK_ALIVE triggers respondToDaemon from thread handler
void WatchdogClient::respondToDaemon() {
  // your health checking method here
  ndk::ScopedAStatus status = mWatchdogServer->tellClientAlive(mClient,
        mSessionId);
}

একটি বাইন্ডার থ্রেড শুরু করুন এবং ক্লায়েন্ট নিবন্ধন করুন

গাড়ী ওয়াচডগ ডেমন ইন্টারফেসের নাম android.automotive.watchdog.ICarWatchdog/default ।

নাম দিয়ে ডেমন খুঁজুন এবং ICarWatchdog::registerClient কল করুন। main.cpp এবং SampleNativeClient.cpp জন্য নীচের কোডটি দেখুন:

main.cpp

int main(int argc, char** argv) {
    sp<Looper> looper(Looper::prepare(/*opts=*/0));

    ABinderProcess_setThreadPoolMaxThreadCount(1);
    ABinderProcess_startThreadPool();
    std::shared_ptr<SampleNativeClient> client =
        ndk::SharedRefBase::make<SampleNatvieClient>(looper);

    // The client is registered in initialize()
    client->initialize();
    ...
}

SampleNativeClient.cpp

void SampleNativeClient::initialize() {
    ndk::SpAIBinder binder(AServiceManager_getService(
        "android.automotive.watchdog.ICarWatchdog/default"));
    std::shared_ptr<ICarWatchdog> server =
        ICarWatchdog::fromBinder(binder);
    mWatchdogServer = server;
    ndk::SpAIBinder binder = this->asBinder();
    std::shared_ptr<ICarWatchdogClient> client =
        ICarWatchdogClient::fromBinder(binder)
    mClient = client;
    server->registerClient(client, TimeoutLength::TIMEOUT_NORMAL);
}

বিক্রেতা পরিষেবা (অ্যান্ড্রয়েড)

CarWatchdogClientCallback উত্তরাধিকারসূত্রে একটি ক্লায়েন্ট বাস্তবায়ন করুন

নিম্নরূপ নতুন ফাইল সম্পাদনা করুন:

private final CarWatchdogClientCallback mClientCallback = new CarWatchdogClientCallback() {
    @Override
    public boolean onCheckHealthStatus(int sessionId, int timeout) {
        // Your health check logic here
        // Returning true implies the client is healthy
        // If false is returned, the client should call
        // CarWatchdogManager.tellClientAlive after health check is
        // completed
    }

    @Override
    public void onPrepareProcessTermination() {}
};

ক্লায়েন্ট নিবন্ধন

CarWatchdogManager.registerClient() কল করুন :

private void startClient() {
    CarWatchdogManager manager =
        (CarWatchdogManager) car.getCarManager(
        Car.CAR_WATCHDOG_SERVICE);
    // Choose a proper executor according to your health check method
    ExecutorService executor = Executors.newFixedThreadPool(1);
    manager.registerClient(executor, mClientCallback,
        CarWatchdogManager.TIMEOUT_NORMAL);
}

ক্লায়েন্টকে নিবন্ধনমুক্ত করুন

পরিষেবা শেষ হলে CarWatchdogManager.unregisterClient() এ কল করুন:

private void finishClient() {
    CarWatchdogManager manager =
        (CarWatchdogManager) car.getCarManager(
        Car.CAR_WATCHDOG_SERVICE);
    manager.unregisterClient(mClientCallback);
}

গাড়ী ওয়াচডগ দ্বারা সমাপ্ত প্রক্রিয়া সনাক্ত করুন

কার ওয়াচডগ ডাম্প/কিল প্রসেস (বিক্রেতা এইচএএল, ভেন্ডার নেটিভ সার্ভিস, ভেন্ডার অ্যান্ড্রয়েড সার্ভিস) যেগুলি গাড়ি ওয়াচডগের কাছে নিবন্ধিত হয় যখন তারা আটকে থাকে এবং প্রতিক্রিয়াহীন থাকে। লগক্যাট চেক করে এই ধরনের ডাম্পিং সনাক্ত করা হয়। যখন একটি সমস্যাযুক্ত প্রক্রিয়া ডাম্প করা বা মেরে ফেলা হয় তখন গাড়ী ওয়াচডগ একটি লগ carwatchdog killed process_name (pid:process_id) আউটপুট করে। অতএব:

$ adb logcat -s CarServiceHelper | fgrep "carwatchdog killed"

প্রাসঙ্গিক লগ ক্যাপচার করা হয়. উদাহরণস্বরূপ, যদি KitchenSink অ্যাপ (একটি গাড়ির ওয়াচডগ ক্লায়েন্ট) আটকে যায়, নিচের মতো একটি লাইন লগে লেখা হয়:

05-01 09:50:19.683   578  5777 W CarServiceHelper: carwatchdog killed com.google.android.car.kitchensink (pid: 5574)

KitchenSink অ্যাপটি কেন বা কোথায় আটকে গেল তা নির্ধারণ করতে, /data/anr এ সঞ্চিত প্রসেস ডাম্প ব্যবহার করুন ঠিক যেমন আপনি অ্যাক্টিভিটি ANR কেস ব্যবহার করবেন।

$ adb root
$ adb shell grep -Hn "pid process_pid" /data/anr/*

নিম্নলিখিত নমুনা আউটপুট কিচেনসিঙ্ক অ্যাপের জন্য নির্দিষ্ট:

$ adb shell su root grep -Hn "pid 5574" /data/anr/*.
/data/anr/anr_2020-05-01-09-50-18-290:3:----- pid 5574 at 2020-05-01 09:50:18 -----
/data/anr/anr_2020-05-01-09-50-18-290:285:----- Waiting Channels: pid 5574 at 2020-05-01 09:50:18 -----

ডাম্প ফাইলটি খুঁজুন (উদাহরণস্বরূপ, উপরের উদাহরণে /data/anr/anr_2020-05-01-09-50-18-290 ) এবং আপনার বিশ্লেষণ শুরু করুন।

গাড়ী ওয়াচডগ

বিক্রেতা HAL

মেকফাইলে গাড়ির ওয়াচডগ আইডিএল উল্লেখ করুন

একটি SELinux নীতি যোগ করুন

system_server.te

hal_vehicle_default.te

BnCarWatchdogClient উত্তরাধিকারসূত্রে পেয়ে একটি ক্লায়েন্ট ক্লাস বাস্তবায়ন করুন

WatchogClient.h

WatchogClient.cpp

বাইন্ডার থ্রেড শুরু করুন এবং ক্লায়েন্ট নিবন্ধন করুন

VehicleService.cpp

WatchogClient.cpp

ভেন্ডর সার্ভিসেস (নেটিভ)

গাড়ী ওয়াচডগ aidl makefile উল্লেখ করুন

একটি SELinux নীতি যোগ করুন

sample_client.te

ফাইল_প্রসঙ্গ

BnCarWatchdogClient উত্তরাধিকারসূত্রে পেয়ে একটি ক্লায়েন্ট ক্লাস বাস্তবায়ন করুন

SampleNativeClient.h

SampleNativeClient.cpp

একটি বাইন্ডার থ্রেড শুরু করুন এবং ক্লায়েন্ট নিবন্ধন করুন

main.cpp

SampleNativeClient.cpp

বিক্রেতা পরিষেবা (অ্যান্ড্রয়েড)

CarWatchdogClientCallback উত্তরাধিকারসূত্রে একটি ক্লায়েন্ট বাস্তবায়ন করুন

ক্লায়েন্ট নিবন্ধন

ক্লায়েন্টকে নিবন্ধনমুক্ত করুন

গাড়ী ওয়াচডগ দ্বারা সমাপ্ত প্রক্রিয়া সনাক্ত করুন