platform_hardware_interfaces/broadcastradio/aidl/default/BroadcastRadio.cpp
Weilin Xu 7991996514 Implement HD signal acquisition state in radio HAL
Implemented HD signal acquisition status change using program info flag
in the reference broadcast radio HAL.

Bug: 309694368
Test: seek/tune to an HD radio station in radio KS app
Change-Id: Ibde570429d4c21b2f894f8658de1b37001541f3a
2023-11-29 21:26:27 -08:00

1026 lines
40 KiB
C++

/*
* Copyright (C) 2022 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.
*/
#include "BroadcastRadio.h"
#include <broadcastradio-utils-aidl/Utils.h>
#include <broadcastradio-utils-aidl/UtilsV2.h>
#include "resources.h"
#include <aidl/android/hardware/broadcastradio/IdentifierType.h>
#include <aidl/android/hardware/broadcastradio/Result.h>
#include <android-base/logging.h>
#include <android-base/strings.h>
#include <private/android_filesystem_config.h>
namespace aidl::android::hardware::broadcastradio {
using ::aidl::android::hardware::broadcastradio::utils::resultToInt;
using ::aidl::android::hardware::broadcastradio::utils::tunesTo;
using ::android::base::EqualsIgnoreCase;
using ::ndk::ScopedAStatus;
using ::std::literals::chrono_literals::operator""ms;
using ::std::literals::chrono_literals::operator""s;
using ::std::lock_guard;
using ::std::mutex;
using ::std::string;
using ::std::vector;
namespace {
inline constexpr std::chrono::milliseconds kSeekDelayTimeMs = 200ms;
inline constexpr std::chrono::milliseconds kStepDelayTimeMs = 100ms;
inline constexpr std::chrono::milliseconds kTuneDelayTimeMs = 150ms;
inline constexpr std::chrono::seconds kListDelayTimeS = 1s;
// clang-format off
const AmFmBandRange kFmFullBandRange = {65000, 108000, 10, 0};
const AmFmBandRange kAmFullBandRange = {150, 30000, 1, 0};
const AmFmRegionConfig kDefaultAmFmConfig = {
{
{87500, 108000, 100, 100}, // FM
{153, 282, 3, 9}, // AM LW
{531, 1620, 9, 9}, // AM MW
{1600, 30000, 1, 5}, // AM SW
},
AmFmRegionConfig::DEEMPHASIS_D50,
AmFmRegionConfig::RDS};
// clang-format on
Properties initProperties(const VirtualRadio& virtualRadio) {
Properties prop = {};
prop.maker = "Android";
prop.product = virtualRadio.getName();
prop.supportedIdentifierTypes = vector<IdentifierType>({
IdentifierType::AMFM_FREQUENCY_KHZ,
IdentifierType::RDS_PI,
IdentifierType::HD_STATION_ID_EXT,
IdentifierType::DAB_SID_EXT,
});
prop.vendorInfo = vector<VendorKeyValue>({
{"com.android.sample", "sample"},
});
return prop;
}
bool isDigitalProgramAllowed(const ProgramSelector& sel, bool forceAnalogFm, bool forceAnalogAm) {
if (sel.primaryId.type != IdentifierType::HD_STATION_ID_EXT) {
return true;
}
int32_t freq = static_cast<int32_t>(utils::getAmFmFrequency(sel));
bool isFm = freq >= kFmFullBandRange.lowerBound && freq <= kFmFullBandRange.upperBound;
return isFm ? !forceAnalogFm : !forceAnalogAm;
}
/**
* Checks whether a program selector is in the current band.
*
* <p>For an AM/FM program, this method checks whether it is in the current AM/FM band. For a
* program selector is also an HD program, it is also checked whether HD radio is enabled in the
* current AM/FM band. For a non-AM/FM program, the method will returns {@code true} directly.
* @param sel Program selector to be checked
* @param currentAmFmBandRange the current AM/FM band
* @param forceAnalogFm whether FM band is forced to be analog
* @param forceAnalogAm whether AM band is forced to be analog
* @return whether the program selector is in the current band if it is an AM/FM (including HD)
* selector, {@code true} otherwise
*/
bool isProgramInBand(const ProgramSelector& sel,
const std::optional<AmFmBandRange>& currentAmFmBandRange, bool forceAnalogFm,
bool forceAnalogAm) {
if (!utils::hasAmFmFrequency(sel)) {
return true;
}
if (!currentAmFmBandRange.has_value()) {
return false;
}
int32_t freq = static_cast<int32_t>(utils::getAmFmFrequency(sel));
if (freq < currentAmFmBandRange->lowerBound || freq > currentAmFmBandRange->upperBound) {
return false;
}
return isDigitalProgramAllowed(sel, forceAnalogFm, forceAnalogAm);
}
// Makes ProgramInfo that does not point to any particular program
ProgramInfo makeSampleProgramInfo(const ProgramSelector& selector) {
ProgramInfo info = {};
info.selector = selector;
switch (info.selector.primaryId.type) {
case IdentifierType::AMFM_FREQUENCY_KHZ:
info.logicallyTunedTo = utils::makeIdentifier(
IdentifierType::AMFM_FREQUENCY_KHZ,
utils::getId(selector, IdentifierType::AMFM_FREQUENCY_KHZ));
info.physicallyTunedTo = info.logicallyTunedTo;
break;
case IdentifierType::HD_STATION_ID_EXT:
info.logicallyTunedTo = utils::makeIdentifier(IdentifierType::AMFM_FREQUENCY_KHZ,
utils::getAmFmFrequency(info.selector));
info.physicallyTunedTo = info.logicallyTunedTo;
break;
case IdentifierType::DAB_SID_EXT:
info.logicallyTunedTo = info.selector.primaryId;
info.physicallyTunedTo = utils::makeIdentifier(
IdentifierType::DAB_FREQUENCY_KHZ,
utils::getId(selector, IdentifierType::DAB_FREQUENCY_KHZ));
break;
default:
info.logicallyTunedTo = info.selector.primaryId;
info.physicallyTunedTo = info.logicallyTunedTo;
break;
}
return info;
}
static bool checkDumpCallerHasWritePermissions(int fd) {
uid_t uid = AIBinder_getCallingUid();
if (uid == AID_ROOT || uid == AID_SHELL || uid == AID_SYSTEM) {
return true;
}
dprintf(fd, "BroadcastRadio HAL dump must be root, shell or system\n");
return false;
}
} // namespace
BroadcastRadio::BroadcastRadio(const VirtualRadio& virtualRadio)
: mVirtualRadio(virtualRadio),
mAmFmConfig(kDefaultAmFmConfig),
mProperties(initProperties(virtualRadio)) {
const auto& ranges = kDefaultAmFmConfig.ranges;
if (ranges.size() > 0) {
ProgramSelector sel = utils::makeSelectorAmfm(ranges[0].lowerBound);
VirtualProgram virtualProgram = {};
if (mVirtualRadio.getProgram(sel, &virtualProgram)) {
mCurrentProgram = virtualProgram.selector;
} else {
mCurrentProgram = sel;
}
adjustAmFmRangeLocked();
}
}
BroadcastRadio::~BroadcastRadio() {
mTuningThread.reset();
mProgramListThread.reset();
}
ScopedAStatus BroadcastRadio::getAmFmRegionConfig(bool full, AmFmRegionConfig* returnConfigs) {
if (full) {
*returnConfigs = {};
returnConfigs->ranges = vector<AmFmBandRange>({
kFmFullBandRange,
kAmFullBandRange,
});
returnConfigs->fmDeemphasis =
AmFmRegionConfig::DEEMPHASIS_D50 | AmFmRegionConfig::DEEMPHASIS_D75;
returnConfigs->fmRds = AmFmRegionConfig::RDS | AmFmRegionConfig::RBDS;
return ScopedAStatus::ok();
}
lock_guard<mutex> lk(mMutex);
*returnConfigs = mAmFmConfig;
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::getDabRegionConfig(vector<DabTableEntry>* returnConfigs) {
*returnConfigs = {
{"5A", 174928}, {"7D", 194064}, {"8A", 195936}, {"8B", 197648}, {"9A", 202928},
{"9B", 204640}, {"9C", 206352}, {"10B", 211648}, {"10C", 213360}, {"10D", 215072},
{"11A", 216928}, {"11B", 218640}, {"11C", 220352}, {"11D", 222064}, {"12A", 223936},
{"12B", 225648}, {"12C", 227360}, {"12D", 229072},
};
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::getImage(int32_t id, vector<uint8_t>* returnImage) {
LOG(DEBUG) << __func__ << ": fetching image " << std::hex << id;
if (id == resources::kDemoPngId) {
*returnImage = vector<uint8_t>(resources::kDemoPng, std::end(resources::kDemoPng));
return ScopedAStatus::ok();
}
LOG(WARNING) << __func__ << ": image of id " << std::hex << id << " doesn't exist";
*returnImage = {};
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::getProperties(Properties* returnProperties) {
lock_guard<mutex> lk(mMutex);
*returnProperties = mProperties;
return ScopedAStatus::ok();
}
ProgramInfo BroadcastRadio::tuneInternalLocked(const ProgramSelector& sel) {
LOG(DEBUG) << __func__ << ": tune (internal) to " << sel.toString();
VirtualProgram virtualProgram = {};
ProgramInfo programInfo;
bool isProgramAllowed =
isDigitalProgramAllowed(sel, isConfigFlagSetLocked(ConfigFlag::FORCE_ANALOG_FM),
isConfigFlagSetLocked(ConfigFlag::FORCE_ANALOG_AM));
if (isProgramAllowed && mVirtualRadio.getProgram(sel, &virtualProgram)) {
mCurrentProgram = virtualProgram.selector;
programInfo = virtualProgram;
} else {
if (!isProgramAllowed) {
mCurrentProgram = utils::makeSelectorAmfm(utils::getAmFmFrequency(sel));
} else {
mCurrentProgram = sel;
}
programInfo = makeSampleProgramInfo(sel);
}
programInfo.infoFlags |= ProgramInfo::FLAG_SIGNAL_ACQUISITION;
if (programInfo.selector.primaryId.type != IdentifierType::HD_STATION_ID_EXT) {
mIsTuneCompleted = true;
}
if (adjustAmFmRangeLocked()) {
startProgramListUpdatesLocked({});
}
return programInfo;
}
ScopedAStatus BroadcastRadio::setTunerCallback(const std::shared_ptr<ITunerCallback>& callback) {
LOG(DEBUG) << __func__ << ": setTunerCallback";
if (callback == nullptr) {
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::INVALID_ARGUMENTS), "cannot set tuner callback to null");
}
lock_guard<mutex> lk(mMutex);
mCallback = callback;
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::unsetTunerCallback() {
LOG(DEBUG) << __func__ << ": unsetTunerCallback";
lock_guard<mutex> lk(mMutex);
mCallback = nullptr;
return ScopedAStatus::ok();
}
void BroadcastRadio::handleProgramInfoUpdateRadioCallback(
ProgramInfo programInfo, const std::shared_ptr<ITunerCallback>& callback) {
callback->onCurrentProgramInfoChanged(programInfo);
if (programInfo.selector.primaryId.type != IdentifierType::HD_STATION_ID_EXT) {
return;
}
ProgramSelector sel = programInfo.selector;
auto cancelTask = [sel, callback]() { callback->onTuneFailed(Result::CANCELED, sel); };
programInfo.infoFlags |= ProgramInfo::FLAG_HD_SIS_ACQUISITION;
auto sisAcquiredTask = [this, callback, programInfo, cancelTask]() {
callback->onCurrentProgramInfoChanged(programInfo);
auto audioAcquiredTask = [this, callback, programInfo]() {
ProgramInfo hdProgramInfoWithAudio = programInfo;
hdProgramInfoWithAudio.infoFlags |= ProgramInfo::FLAG_HD_AUDIO_ACQUISITION;
callback->onCurrentProgramInfoChanged(hdProgramInfoWithAudio);
lock_guard<mutex> lk(mMutex);
mIsTuneCompleted = true;
};
lock_guard<mutex> lk(mMutex);
mTuningThread->schedule(audioAcquiredTask, cancelTask, kTuneDelayTimeMs);
};
lock_guard<mutex> lk(mMutex);
mTuningThread->schedule(sisAcquiredTask, cancelTask, kTuneDelayTimeMs);
}
ScopedAStatus BroadcastRadio::tune(const ProgramSelector& program) {
LOG(DEBUG) << __func__ << ": tune to " << program.toString() << "...";
lock_guard<mutex> lk(mMutex);
if (mCallback == nullptr) {
LOG(ERROR) << __func__ << ": callback is not registered.";
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::INVALID_STATE), "callback is not registered");
}
if (!utils::isSupported(mProperties, program)) {
LOG(WARNING) << __func__ << ": selector not supported: " << program.toString();
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::NOT_SUPPORTED), "selector is not supported");
}
if (!utils::isValidV2(program)) {
LOG(ERROR) << __func__ << ": selector is not valid: " << program.toString();
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::INVALID_ARGUMENTS), "selector is not valid");
}
cancelLocked();
mIsTuneCompleted = false;
std::shared_ptr<ITunerCallback> callback = mCallback;
auto task = [this, program, callback]() {
ProgramInfo programInfo = {};
{
lock_guard<mutex> lk(mMutex);
programInfo = tuneInternalLocked(program);
}
handleProgramInfoUpdateRadioCallback(programInfo, callback);
};
auto cancelTask = [program, callback]() { callback->onTuneFailed(Result::CANCELED, program); };
mTuningThread->schedule(task, cancelTask, kTuneDelayTimeMs);
return ScopedAStatus::ok();
}
bool BroadcastRadio::findNextLocked(const ProgramSelector& current, bool directionUp,
bool skipSubChannel, VirtualProgram* nextProgram) const {
if (mProgramList.empty()) {
return false;
}
// The list is not sorted here since it has already stored in VirtualRadio.
bool hasAmFmFrequency = utils::hasAmFmFrequency(current);
uint32_t currentFreq = hasAmFmFrequency ? utils::getAmFmFrequency(current) : 0;
auto found =
std::lower_bound(mProgramList.begin(), mProgramList.end(), VirtualProgram({current}));
if (directionUp) {
if (found < mProgramList.end() - 1) {
// When seeking up, tuner will jump to the first selector which is main program service
// greater than and of the same band as the current program selector in the program
// list (if not exist, jump to the first selector in the same band) for skipping
// sub-channels case or AM/FM without HD radio enabled case. Otherwise, the tuner will
// jump to the first selector which is greater than and of the same band as the current
// program selector.
if (utils::tunesTo(current, found->selector)) found++;
if (skipSubChannel && hasAmFmFrequency) {
auto firstFound = found;
while (utils::getAmFmFrequency(found->selector) == currentFreq) {
if (found < mProgramList.end() - 1) {
found++;
} else {
found = mProgramList.begin();
}
if (found == firstFound) {
// Only one main channel exists in the program list, the tuner cannot skip
// sub-channel to the next program selector.
return false;
}
}
}
} else {
// If the selector of current program is no less than all selectors of the same band or
// not found in the program list, seeking up should wrap the tuner to the first program
// selector of the same band in the program list.
found = mProgramList.begin();
}
} else {
if (found > mProgramList.begin() && found != mProgramList.end()) {
// When seeking down, tuner will jump to the first selector which is main program
// service less than and of the same band as the current program selector in the
// program list (if not exist, jump to the last main program service selector of the
// same band) for skipping sub-channels case or AM/FM without HD radio enabled case.
// Otherwise, the tuner will jump to the first selector less than and of the same band
// as the current program selector.
found--;
if (hasAmFmFrequency && utils::hasAmFmFrequency(found->selector)) {
uint32_t nextFreq = utils::getAmFmFrequency(found->selector);
if (nextFreq != currentFreq) {
jumpToFirstSubChannelLocked(found);
} else if (skipSubChannel) {
jumpToFirstSubChannelLocked(found);
auto firstFound = found;
if (found > mProgramList.begin()) {
found--;
} else {
found = mProgramList.end() - 1;
}
jumpToFirstSubChannelLocked(found);
if (found == firstFound) {
// Only one main channel exists in the program list, the tuner cannot skip
// sub-channel to the next program selector.
return false;
}
}
}
} else {
// If the selector of current program is no greater than all selectors of the same band
// or not found in the program list, seeking down should wrap the tuner to the last
// selector of the same band in the program list. If the last program selector in the
// program list is sub-channel and skipping sub-channels is needed, the tuner will jump
// to the last main program service of the same band in the program list.
found = mProgramList.end() - 1;
jumpToFirstSubChannelLocked(found);
}
}
*nextProgram = *found;
return true;
}
void BroadcastRadio::jumpToFirstSubChannelLocked(vector<VirtualProgram>::const_iterator& it) const {
if (!utils::hasAmFmFrequency(it->selector) || it == mProgramList.begin()) {
return;
}
uint32_t currentFrequency = utils::getAmFmFrequency(it->selector);
it--;
while (it != mProgramList.begin() && utils::hasAmFmFrequency(it->selector) &&
utils::getAmFmFrequency(it->selector) == currentFrequency) {
it--;
}
it++;
}
ScopedAStatus BroadcastRadio::seek(bool directionUp, bool skipSubChannel) {
LOG(DEBUG) << __func__ << ": seek " << (directionUp ? "up" : "down") << " with skipSubChannel? "
<< (skipSubChannel ? "yes" : "no") << "...";
lock_guard<mutex> lk(mMutex);
if (mCallback == nullptr) {
LOG(ERROR) << __func__ << ": callback is not registered.";
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::INVALID_STATE), "callback is not registered");
}
cancelLocked();
auto filterCb = [this](const VirtualProgram& program) {
return isProgramInBand(program.selector, mCurrentAmFmBandRange,
isConfigFlagSetLocked(ConfigFlag::FORCE_ANALOG_FM),
isConfigFlagSetLocked(ConfigFlag::FORCE_ANALOG_AM));
};
const auto& list = mVirtualRadio.getProgramList();
mProgramList.clear();
std::copy_if(list.begin(), list.end(), std::back_inserter(mProgramList), filterCb);
std::shared_ptr<ITunerCallback> callback = mCallback;
auto cancelTask = [callback]() { callback->onTuneFailed(Result::CANCELED, {}); };
VirtualProgram nextProgram = {};
bool foundNext = findNextLocked(mCurrentProgram, directionUp, skipSubChannel, &nextProgram);
mIsTuneCompleted = false;
if (!foundNext) {
auto task = [callback]() {
LOG(DEBUG) << "seek: program list is empty, seek couldn't stop";
callback->onTuneFailed(Result::TIMEOUT, {});
};
mTuningThread->schedule(task, cancelTask, kSeekDelayTimeMs);
return ScopedAStatus::ok();
}
auto task = [this, nextProgram, callback]() {
ProgramInfo programInfo = {};
{
lock_guard<mutex> lk(mMutex);
programInfo = tuneInternalLocked(nextProgram.selector);
}
handleProgramInfoUpdateRadioCallback(programInfo, callback);
};
mTuningThread->schedule(task, cancelTask, kSeekDelayTimeMs);
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::step(bool directionUp) {
LOG(DEBUG) << __func__ << ": step " << (directionUp ? "up" : "down") << "...";
lock_guard<mutex> lk(mMutex);
if (mCallback == nullptr) {
LOG(ERROR) << __func__ << ": callback is not registered.";
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::INVALID_STATE), "callback is not registered");
}
cancelLocked();
int64_t stepTo;
if (utils::hasId(mCurrentProgram, IdentifierType::AMFM_FREQUENCY_KHZ)) {
stepTo = utils::getId(mCurrentProgram, IdentifierType::AMFM_FREQUENCY_KHZ);
} else if (mCurrentProgram.primaryId.type == IdentifierType::HD_STATION_ID_EXT) {
stepTo = utils::getHdFrequency(mCurrentProgram);
} else {
LOG(WARNING) << __func__ << ": can't step in anything else than AM/FM";
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::NOT_SUPPORTED), "cannot step in anything else than AM/FM");
}
if (!mCurrentAmFmBandRange.has_value()) {
LOG(ERROR) << __func__ << ": can't find current band";
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::INTERNAL_ERROR), "can't find current band");
}
if (directionUp) {
stepTo += mCurrentAmFmBandRange->spacing;
} else {
stepTo -= mCurrentAmFmBandRange->spacing;
}
if (stepTo > mCurrentAmFmBandRange->upperBound) {
stepTo = mCurrentAmFmBandRange->lowerBound;
}
if (stepTo < mCurrentAmFmBandRange->lowerBound) {
stepTo = mCurrentAmFmBandRange->upperBound;
}
mIsTuneCompleted = false;
std::shared_ptr<ITunerCallback> callback = mCallback;
auto task = [this, stepTo, callback]() {
ProgramInfo programInfo;
{
lock_guard<mutex> lk(mMutex);
programInfo = tuneInternalLocked(utils::makeSelectorAmfm(stepTo));
}
handleProgramInfoUpdateRadioCallback(programInfo, callback);
};
auto cancelTask = [callback]() { callback->onTuneFailed(Result::CANCELED, {}); };
mTuningThread->schedule(task, cancelTask, kStepDelayTimeMs);
return ScopedAStatus::ok();
}
void BroadcastRadio::cancelLocked() {
LOG(DEBUG) << __func__ << ": cancelling current tuning operations...";
mTuningThread->cancelAll();
if (mCurrentProgram.primaryId.type != IdentifierType::INVALID) {
mIsTuneCompleted = true;
}
}
ScopedAStatus BroadcastRadio::cancel() {
LOG(DEBUG) << __func__ << ": cancel pending tune, seek and step...";
lock_guard<mutex> lk(mMutex);
cancelLocked();
return ScopedAStatus::ok();
}
void BroadcastRadio::startProgramListUpdatesLocked(const ProgramFilter& filter) {
auto filterCb = [&filter, this](const VirtualProgram& program) {
return utils::satisfies(filter, program.selector) &&
isProgramInBand(program.selector, mCurrentAmFmBandRange,
isConfigFlagSetLocked(ConfigFlag::FORCE_ANALOG_FM),
isConfigFlagSetLocked(ConfigFlag::FORCE_ANALOG_AM));
};
cancelProgramListUpdateLocked();
const auto& list = mVirtualRadio.getProgramList();
vector<VirtualProgram> filteredList;
std::copy_if(list.begin(), list.end(), std::back_inserter(filteredList), filterCb);
auto task = [this, filteredList]() {
std::shared_ptr<ITunerCallback> callback;
{
lock_guard<mutex> lk(mMutex);
if (mCallback == nullptr) {
LOG(WARNING) << "Callback is null when updating program List";
return;
}
callback = mCallback;
}
ProgramListChunk chunk = {};
chunk.purge = true;
chunk.complete = true;
chunk.modified = vector<ProgramInfo>(filteredList.begin(), filteredList.end());
callback->onProgramListUpdated(chunk);
};
mProgramListThread->schedule(task, kListDelayTimeS);
}
ScopedAStatus BroadcastRadio::startProgramListUpdates(const ProgramFilter& filter) {
LOG(DEBUG) << __func__ << ": requested program list updates, filter = " << filter.toString()
<< "...";
lock_guard<mutex> lk(mMutex);
startProgramListUpdatesLocked(filter);
return ScopedAStatus::ok();
}
void BroadcastRadio::cancelProgramListUpdateLocked() {
LOG(DEBUG) << __func__ << ": cancelling current program list update operations...";
mProgramListThread->cancelAll();
}
ScopedAStatus BroadcastRadio::stopProgramListUpdates() {
LOG(DEBUG) << __func__ << ": requested program list updates to stop...";
lock_guard<mutex> lk(mMutex);
cancelProgramListUpdateLocked();
return ScopedAStatus::ok();
}
bool BroadcastRadio::isConfigFlagSetLocked(ConfigFlag flag) const {
int flagBit = static_cast<int>(flag);
return ((mConfigFlagValues >> flagBit) & 1) == 1;
}
ScopedAStatus BroadcastRadio::isConfigFlagSet(ConfigFlag flag, bool* returnIsSet) {
LOG(DEBUG) << __func__ << ": flag = " << toString(flag);
if (flag == ConfigFlag::FORCE_ANALOG) {
flag = ConfigFlag::FORCE_ANALOG_FM;
}
lock_guard<mutex> lk(mMutex);
*returnIsSet = isConfigFlagSetLocked(flag);
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::setConfigFlag(ConfigFlag flag, bool value) {
LOG(DEBUG) << __func__ << ": flag = " << toString(flag) << ", value = " << value;
if (flag == ConfigFlag::FORCE_ANALOG) {
flag = ConfigFlag::FORCE_ANALOG_FM;
}
int flagBitMask = 1 << (static_cast<int>(flag));
lock_guard<mutex> lk(mMutex);
if (value) {
mConfigFlagValues |= flagBitMask;
} else {
mConfigFlagValues &= ~flagBitMask;
}
if (flag == ConfigFlag::FORCE_ANALOG_AM || flag == ConfigFlag::FORCE_ANALOG_FM) {
startProgramListUpdatesLocked({});
}
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::setParameters(
[[maybe_unused]] const vector<VendorKeyValue>& parameters,
vector<VendorKeyValue>* returnParameters) {
// TODO(b/243682330) Support vendor parameter functionality
*returnParameters = {};
return ScopedAStatus::ok();
}
ScopedAStatus BroadcastRadio::getParameters([[maybe_unused]] const vector<string>& keys,
vector<VendorKeyValue>* returnParameters) {
// TODO(b/243682330) Support vendor parameter functionality
*returnParameters = {};
return ScopedAStatus::ok();
}
bool BroadcastRadio::adjustAmFmRangeLocked() {
bool hasBandBefore = mCurrentAmFmBandRange.has_value();
if (!utils::hasAmFmFrequency(mCurrentProgram)) {
LOG(WARNING) << __func__ << ": current program does not has AMFM_FREQUENCY_KHZ identifier";
mCurrentAmFmBandRange.reset();
return hasBandBefore;
}
int32_t freq = static_cast<int32_t>(utils::getAmFmFrequency(mCurrentProgram));
for (const auto& range : mAmFmConfig.ranges) {
if (range.lowerBound <= freq && range.upperBound >= freq) {
bool isBandChanged = hasBandBefore ? *mCurrentAmFmBandRange != range : true;
mCurrentAmFmBandRange = range;
return isBandChanged;
}
}
mCurrentAmFmBandRange.reset();
return !hasBandBefore;
}
ScopedAStatus BroadcastRadio::registerAnnouncementListener(
[[maybe_unused]] const std::shared_ptr<IAnnouncementListener>& listener,
const vector<AnnouncementType>& enabled, std::shared_ptr<ICloseHandle>* returnCloseHandle) {
LOG(DEBUG) << __func__ << ": registering announcement listener for "
<< utils::vectorToString(enabled);
// TODO(b/243683842) Support announcement listener
*returnCloseHandle = nullptr;
LOG(INFO) << __func__ << ": registering announcementListener is not supported";
return ScopedAStatus::fromServiceSpecificErrorWithMessage(
resultToInt(Result::NOT_SUPPORTED),
"registering announcementListener is not supported");
}
binder_status_t BroadcastRadio::dump(int fd, const char** args, uint32_t numArgs) {
if (numArgs == 0) {
return dumpsys(fd);
}
string option = string(args[0]);
if (EqualsIgnoreCase(option, "--help")) {
return cmdHelp(fd);
} else if (EqualsIgnoreCase(option, "--tune")) {
return cmdTune(fd, args, numArgs);
} else if (EqualsIgnoreCase(option, "--seek")) {
return cmdSeek(fd, args, numArgs);
} else if (EqualsIgnoreCase(option, "--step")) {
return cmdStep(fd, args, numArgs);
} else if (EqualsIgnoreCase(option, "--cancel")) {
return cmdCancel(fd, numArgs);
} else if (EqualsIgnoreCase(option, "--startProgramListUpdates")) {
return cmdStartProgramListUpdates(fd, args, numArgs);
} else if (EqualsIgnoreCase(option, "--stopProgramListUpdates")) {
return cmdStopProgramListUpdates(fd, numArgs);
}
dprintf(fd, "Invalid option: %s\n", option.c_str());
return STATUS_BAD_VALUE;
}
binder_status_t BroadcastRadio::dumpsys(int fd) {
if (!checkDumpCallerHasWritePermissions(fd)) {
return STATUS_PERMISSION_DENIED;
}
lock_guard<mutex> lk(mMutex);
dprintf(fd, "AmFmRegionConfig: %s\n", mAmFmConfig.toString().c_str());
dprintf(fd, "Properties: %s \n", mProperties.toString().c_str());
if (mIsTuneCompleted) {
dprintf(fd, "Tune completed\n");
} else {
dprintf(fd, "Tune not completed\n");
}
if (mCallback == nullptr) {
dprintf(fd, "No ITunerCallback registered\n");
} else {
dprintf(fd, "ITunerCallback registered\n");
}
dprintf(fd, "CurrentProgram: %s \n", mCurrentProgram.toString().c_str());
return STATUS_OK;
}
binder_status_t BroadcastRadio::cmdHelp(int fd) const {
dprintf(fd, "Usage: \n\n");
dprintf(fd, "[no args]: dumps focus listener / gain callback registered status\n");
dprintf(fd, "--help: shows this help\n");
dprintf(fd,
"--tune amfm <FREQUENCY>: tunes amfm radio to frequency (in Hz) specified: "
"frequency (int) \n"
"--tune dab <SID> <ENSEMBLE>: tunes dab radio to sid and ensemble specified: "
"sidExt (int), ensemble (int) \n");
dprintf(fd,
"--seek [up|down] <SKIP_SUB_CHANNEL>: seek with direction (up or down) and "
"option whether skipping sub channel: "
"skipSubChannel (string, should be either \"true\" or \"false\")\n");
dprintf(fd, "--step [up|down]: step in direction (up or down) specified\n");
dprintf(fd, "--cancel: cancel current pending tune, step, and seek\n");
dprintf(fd,
"--startProgramListUpdates <IDENTIFIER_TYPES> <IDENTIFIERS> <INCLUDE_CATEGORIES> "
"<EXCLUDE_MODIFICATIONS>: start update program list with the filter specified: "
"identifier types (string, in format <TYPE>,<TYPE>,...,<TYPE> or \"null\" (if empty), "
"where TYPE is int), "
"program identifiers (string, in format "
"<TYPE>:<VALUE>,<TYPE>:<VALUE>,...,<TYPE>:<VALUE> or \"null\" (if empty), "
"where TYPE is int and VALUE is long), "
"includeCategories (string, should be either \"true\" or \"false\"), "
"excludeModifications (string, should be either \"true\" or \"false\")\n");
dprintf(fd, "--stopProgramListUpdates: stop current pending program list updates\n");
dprintf(fd,
"Note on <TYPE> for --startProgramList command: it is int for identifier type. "
"Please see broadcastradio/aidl/android/hardware/broadcastradio/IdentifierType.aidl "
"for its definition.\n");
dprintf(fd,
"Note on <VALUE> for --startProgramList command: it is long type for identifier value. "
"Please see broadcastradio/aidl/android/hardware/broadcastradio/IdentifierType.aidl "
"for its value.\n");
return STATUS_OK;
}
binder_status_t BroadcastRadio::cmdTune(int fd, const char** args, uint32_t numArgs) {
if (!checkDumpCallerHasWritePermissions(fd)) {
return STATUS_PERMISSION_DENIED;
}
if (numArgs != 3 && numArgs != 4) {
dprintf(fd,
"Invalid number of arguments: please provide --tune amfm <FREQUENCY> "
"or --tune dab <SID> <ENSEMBLE>\n");
return STATUS_BAD_VALUE;
}
bool isDab = false;
if (EqualsIgnoreCase(string(args[1]), "dab")) {
isDab = true;
} else if (!EqualsIgnoreCase(string(args[1]), "amfm")) {
dprintf(fd, "Unknown radio type provided with tune: %s\n", args[1]);
return STATUS_BAD_VALUE;
}
ProgramSelector sel = {};
if (isDab) {
if (numArgs != 5 && numArgs != 3) {
dprintf(fd,
"Invalid number of arguments: please provide "
"--tune dab <SID> <ENSEMBLE> <FREQUENCY> or "
"--tune dab <SID>\n");
return STATUS_BAD_VALUE;
}
int sid;
if (!utils::parseArgInt(string(args[2]), &sid)) {
dprintf(fd, "Non-integer sid provided with tune: %s\n", args[2]);
return STATUS_BAD_VALUE;
}
if (numArgs == 3) {
sel = utils::makeSelectorDab(sid);
} else {
int ensemble;
if (!utils::parseArgInt(string(args[3]), &ensemble)) {
dprintf(fd, "Non-integer ensemble provided with tune: %s\n", args[3]);
return STATUS_BAD_VALUE;
}
int freq;
if (!utils::parseArgInt(string(args[4]), &freq)) {
dprintf(fd, "Non-integer frequency provided with tune: %s\n", args[4]);
return STATUS_BAD_VALUE;
}
sel = utils::makeSelectorDab(sid, ensemble, freq);
}
} else {
if (numArgs != 3) {
dprintf(fd, "Invalid number of arguments: please provide --tune amfm <FREQUENCY>\n");
return STATUS_BAD_VALUE;
}
int freq;
if (!utils::parseArgInt(string(args[2]), &freq)) {
dprintf(fd, "Non-integer frequency provided with tune: %s\n", args[2]);
return STATUS_BAD_VALUE;
}
sel = utils::makeSelectorAmfm(freq);
}
auto tuneResult = tune(sel);
if (!tuneResult.isOk()) {
dprintf(fd, "Unable to tune %s radio to %s\n", args[1], sel.toString().c_str());
return STATUS_BAD_VALUE;
}
dprintf(fd, "Tune %s radio to %s \n", args[1], sel.toString().c_str());
return STATUS_OK;
}
binder_status_t BroadcastRadio::cmdSeek(int fd, const char** args, uint32_t numArgs) {
if (!checkDumpCallerHasWritePermissions(fd)) {
return STATUS_PERMISSION_DENIED;
}
if (numArgs != 3) {
dprintf(fd,
"Invalid number of arguments: please provide --seek <DIRECTION> "
"<SKIP_SUB_CHANNEL>\n");
return STATUS_BAD_VALUE;
}
string seekDirectionIn = string(args[1]);
bool seekDirectionUp;
if (!utils::parseArgDirection(seekDirectionIn, &seekDirectionUp)) {
dprintf(fd, "Invalid direction (\"up\" or \"down\") provided with seek: %s\n",
seekDirectionIn.c_str());
return STATUS_BAD_VALUE;
}
string skipSubChannelIn = string(args[2]);
bool skipSubChannel;
if (!utils::parseArgBool(skipSubChannelIn, &skipSubChannel)) {
dprintf(fd, "Invalid skipSubChannel (\"true\" or \"false\") provided with seek: %s\n",
skipSubChannelIn.c_str());
return STATUS_BAD_VALUE;
}
auto seekResult = seek(seekDirectionUp, skipSubChannel);
if (!seekResult.isOk()) {
dprintf(fd, "Unable to seek in %s direction\n", seekDirectionIn.c_str());
return STATUS_BAD_VALUE;
}
dprintf(fd, "Seek in %s direction\n", seekDirectionIn.c_str());
return STATUS_OK;
}
binder_status_t BroadcastRadio::cmdStep(int fd, const char** args, uint32_t numArgs) {
if (!checkDumpCallerHasWritePermissions(fd)) {
return STATUS_PERMISSION_DENIED;
}
if (numArgs != 2) {
dprintf(fd, "Invalid number of arguments: please provide --step <DIRECTION>\n");
return STATUS_BAD_VALUE;
}
string stepDirectionIn = string(args[1]);
bool stepDirectionUp;
if (!utils::parseArgDirection(stepDirectionIn, &stepDirectionUp)) {
dprintf(fd, "Invalid direction (\"up\" or \"down\") provided with step: %s\n",
stepDirectionIn.c_str());
return STATUS_BAD_VALUE;
}
auto stepResult = step(stepDirectionUp);
if (!stepResult.isOk()) {
dprintf(fd, "Unable to step in %s direction\n", stepDirectionIn.c_str());
return STATUS_BAD_VALUE;
}
dprintf(fd, "Step in %s direction\n", stepDirectionIn.c_str());
return STATUS_OK;
}
binder_status_t BroadcastRadio::cmdCancel(int fd, uint32_t numArgs) {
if (!checkDumpCallerHasWritePermissions(fd)) {
return STATUS_PERMISSION_DENIED;
}
if (numArgs != 1) {
dprintf(fd,
"Invalid number of arguments: please provide --cancel "
"only and no more arguments\n");
return STATUS_BAD_VALUE;
}
auto cancelResult = cancel();
if (!cancelResult.isOk()) {
dprintf(fd, "Unable to cancel pending tune, seek, and step\n");
return STATUS_BAD_VALUE;
}
dprintf(fd, "Canceled pending tune, seek, and step\n");
return STATUS_OK;
}
binder_status_t BroadcastRadio::cmdStartProgramListUpdates(int fd, const char** args,
uint32_t numArgs) {
if (!checkDumpCallerHasWritePermissions(fd)) {
return STATUS_PERMISSION_DENIED;
}
if (numArgs != 5) {
dprintf(fd,
"Invalid number of arguments: please provide --startProgramListUpdates "
"<IDENTIFIER_TYPES> <IDENTIFIERS> <INCLUDE_CATEGORIES> "
"<EXCLUDE_MODIFICATIONS>\n");
return STATUS_BAD_VALUE;
}
string filterTypesStr = string(args[1]);
std::vector<IdentifierType> filterTypeList;
if (!EqualsIgnoreCase(filterTypesStr, "null") &&
!utils::parseArgIdentifierTypeArray(filterTypesStr, &filterTypeList)) {
dprintf(fd,
"Invalid identifier types provided with startProgramListUpdates: %s, "
"should be: <TYPE>,<TYPE>,...,<TYPE>\n",
filterTypesStr.c_str());
return STATUS_BAD_VALUE;
}
string filtersStr = string(args[2]);
std::vector<ProgramIdentifier> filterList;
if (!EqualsIgnoreCase(filtersStr, "null") &&
!utils::parseProgramIdentifierList(filtersStr, &filterList)) {
dprintf(fd,
"Invalid program identifiers provided with startProgramListUpdates: %s, "
"should be: <TYPE>:<VALUE>,<TYPE>:<VALUE>,...,<TYPE>:<VALUE>\n",
filtersStr.c_str());
return STATUS_BAD_VALUE;
}
string includeCategoriesStr = string(args[3]);
bool includeCategories;
if (!utils::parseArgBool(includeCategoriesStr, &includeCategories)) {
dprintf(fd,
"Invalid includeCategories (\"true\" or \"false\") "
"provided with startProgramListUpdates : %s\n",
includeCategoriesStr.c_str());
return STATUS_BAD_VALUE;
}
string excludeModificationsStr = string(args[4]);
bool excludeModifications;
if (!utils::parseArgBool(excludeModificationsStr, &excludeModifications)) {
dprintf(fd,
"Invalid excludeModifications(\"true\" or \"false\") "
"provided with startProgramListUpdates : %s\n",
excludeModificationsStr.c_str());
return STATUS_BAD_VALUE;
}
ProgramFilter filter = {filterTypeList, filterList, includeCategories, excludeModifications};
auto updateResult = startProgramListUpdates(filter);
if (!updateResult.isOk()) {
dprintf(fd, "Unable to start program list update for filter %s \n",
filter.toString().c_str());
return STATUS_BAD_VALUE;
}
dprintf(fd, "Start program list update for filter %s\n", filter.toString().c_str());
return STATUS_OK;
}
binder_status_t BroadcastRadio::cmdStopProgramListUpdates(int fd, uint32_t numArgs) {
if (!checkDumpCallerHasWritePermissions(fd)) {
return STATUS_PERMISSION_DENIED;
}
if (numArgs != 1) {
dprintf(fd,
"Invalid number of arguments: please provide --stopProgramListUpdates "
"only and no more arguments\n");
return STATUS_BAD_VALUE;
}
auto stopResult = stopProgramListUpdates();
if (!stopResult.isOk()) {
dprintf(fd, "Unable to stop pending program list update\n");
return STATUS_BAD_VALUE;
}
dprintf(fd, "Stop pending program list update\n");
return STATUS_OK;
}
} // namespace aidl::android::hardware::broadcastradio