NOTE: this is only compiled into products with PRODUCT_IOT=true.
Introduce BootActions that a developer can provide to manipulate IO
before the android framework comes up on boot.
We will look for a configuration file at /oem/app/etc/boot_action.conf and
expect it to tell us the name of a shared library. We will then fetch
this library from /oem/app/lib/${arch}/ and load it. We expect it to export
boot_action_init(), boot_action_shutdown(), and optionally
boot_action_start_part(int partNumber, int playNumber).
We will then call boot_action_init() during boot after PeripheralManager
is up and call boot_action_shutdown() when the android framework is up
and we are going to start loading APKs.
We will also call boot_action_start_part(*) when each part of the boot
animation is started, use this if you want to synchronize the boot
action and the boot animation.
Boot actions run in a restricted environment and in general can only
make calls to PeripheralManager.
Bug: 37992717
Test: Pushed to local imx7d to test boot actions, pushed to bullhead test that animation+sound still works.
Change-Id: I9e53a17567f8028ea84486d637e1d231ee1125e1
64 lines
2.0 KiB
C++
64 lines
2.0 KiB
C++
/*
|
|
* Copyright (C) 2017 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.
|
|
*/
|
|
|
|
#ifndef _BOOTANIMATION_BOOTACTION_H
|
|
#define _BOOTANIMATION_BOOTACTION_H
|
|
|
|
#include <string>
|
|
|
|
#include <utils/RefBase.h>
|
|
|
|
namespace android {
|
|
|
|
class BootAction : public RefBase {
|
|
public:
|
|
~BootAction();
|
|
// Parse the contents of the config file. We expect one line:
|
|
// LIBRARY_NAME=
|
|
//
|
|
// LIBRARY_NAME is the name of the shared library that contains the boot action.
|
|
bool init(const std::string& libraryPath, const std::string& config);
|
|
|
|
// The animation is going to start playing partNumber for the playCount'th
|
|
// time, update the action as needed.
|
|
// This is run in the same thread as the boot animation,
|
|
// you must not block here.
|
|
void startPart(int partNumber, int playCount);
|
|
|
|
// Shutdown the boot action, this will be called shortly before the
|
|
// process is shut down to allow time for cleanup.
|
|
void shutdown();
|
|
|
|
private:
|
|
typedef bool (*libInit)();
|
|
typedef void (*libStartPart)(int partNumber, int playNumber);
|
|
typedef void (*libShutdown)();
|
|
|
|
bool parseConfig(const std::string& config, std::string* path);
|
|
bool loadSymbol(const char* symbol, void** loaded);
|
|
const char* architectureDirectory();
|
|
|
|
void* mLibHandle = nullptr;
|
|
libInit mLibInit = nullptr;
|
|
libStartPart mLibStartPart = nullptr;
|
|
libShutdown mLibShutdown = nullptr;
|
|
};
|
|
|
|
} // namespace android
|
|
|
|
|
|
#endif // _BOOTANIMATION_BOOTACTION_H
|