بخش های زیر نحوه کار با لایه انتزاعی سخت افزاری (HAL) برای اجرای رادیو پخش را شرح می دهد.
رادیو پخش رابط HAL
رادیو پخش HAL ساختارهای داده و رابطهایی را در سطح سختافزار برای اجرای رادیو پخش، مانند رادیو AM/FM و DAB فراهم میکند.
رابط های HIDL 2.0 و AIDL
رادیو پخش HAL از رابط های توضیح داده شده در بخش های زیر استفاده می کند.
IAnnouncementListener
IAnnouncementListener
رابط پاسخ به تماس برای شنونده اعلامیه است که می تواند در رادیو پخش HAL برای دریافت اطلاعیه ها ثبت شود. رابط دارای روش های زیر است:
IAnnouncementListener | ||
---|---|---|
توضیحات: هر زمان که لیست اعلام تغییر کرده باشد تماس گرفته می شود. | ||
HIDL 2.0 | oneway onListUpdated(vec<Announcement> announcements) | |
ایدل | oneway void onListUpdated(in Announcement[] announcements) |
ICloseHandle
ICloseHandle
یک دسته بسته عمومی برای حذف تماسی است که به رابط فعال نیاز ندارد.
ICloseHandle | ||
---|---|---|
توضیحات: دستگیره را ببندید. | ||
HIDL 2.0 | close() | |
ایدل | void close() |
ITunerCallback
ITunerCallback
رابط تماس برگشتی است که توسط رادیو پخش HAL برای ارسال به روز رسانی به سرویس سرویس گیرنده HAL فراخوانی می شود.
ITunerCallback | ||
---|---|---|
توضیحات: هنگامی که یک عملیات تنظیم (کوک کردن، جستجو (در AIDL) یا اسکن (در HIDL) و مرحله موفقیت آمیز) به طور ناهمزمان با شکست مواجه می شود توسط HAL فراخوانی می شود. | ||
HIDL 2.0 | oneway onCurrentProgramInfoChanged(ProgramInfo info) | |
ایدل | void onCurrentProgramInfoChanged(in ProgramInfo info) | |
توضیحات: هنگامی که تنظیم، جستجو (در AIDL) یا اسکن (در HIDL)، یا گام موفقیت آمیز باشد، تماس گرفته می شود. | ||
HIDL 2.0 | oneway onTuneFailed(Result result, ProgramSelector selector) | |
ایدل | void onTuneFailed(in Result result, in ProgramSelector selector) | |
توضیحات: هنگامی که تنظیم، جستجو (در AIDL) یا اسکن (در HIDL)، یا گام موفقیت آمیز باشد، تماس گرفته می شود. | ||
HIDL 2.0 | oneway onCurrentProgramInfoChanged(ProgramInfo info) | |
ایدل | void onCurrentProgramInfoChanged(in ProgramInfo info) | |
توضیحات: هنگامی که لیست برنامه به روز می شود، فراخوانی می شود. اندازه هر قطعه باید به 500 کیلو بایت محدود شود. | ||
HIDL 2.0 | oneway onProgramListUpdated(ProgramListChunk chunk) | |
ایدل | oneway onProgramListUpdated(ProgramListChunk chunk) | |
توضیحات: هنگامی که آنتن وصل یا قطع می شود تماس می گیرد. | ||
HIDL 2.0 | oneway onAntennaStateChange(bool connected) | |
ایدل | void onCurrentProgramInfoChanged(in ProgramInfo info) | |
توضیحات: زمانی فراخوانی می شود که مقادیر پارامترهای خاص فروشنده به صورت داخلی در HAL به روز شوند (بعد از فراخوانی setParameters توسط سرویس گیرنده HAL، فراخوانی نکنید). | ||
HIDL 2.0 | oneway onParametersUpdated(vec<VendorKeyValue> parameters) | |
ایدل | void onParametersUpdated(in VendorKeyValue[] parameters) | |
توضیحات: جدید در AIDL. هنگامی که پرچم پیکربندی به صورت داخلی در HAL به روز می شود، فراخوانی می شود (نباید پس از فراخوانی setConfigFlag توسط سرویس گیرنده HAL فراخوانی شود). | ||
HIDL 2.0 | قابل اجرا نیست. | |
ایدل | void onConfigFlagUpdated(in ConfigFlag flag, in boolean value) |
IBroadcast Radio
IBroadcastRadio
رابط اصلی برای پخش رادیویی HAL است. در HIDL 2.0 HAL، از رابط ITunerSession
به تیونر برای فراخوانی عملیات استفاده کنید. با این حال، حداکثر یک تیونر در یک زمان فعال است (به شرطی که هر نمونه پخش رادیویی HAL فقط یک تراشه تیونر داشته باشد). ITunerSession
از رابط های AIDL حذف شد و رابط های آن به IBroadcastRadio
منتقل شد.
IBroadcast Radio | ||
---|---|---|
توضیحات: توضیحات یک ماژول و قابلیت های آن را دریافت کنید. | ||
HIDL 2.0 | getProperties() generates (Properties properties) | |
ایدل | Properties getProperties() | |
توضیحات: پیکربندی فعلی یا ممکن منطقه AM/FM را واکشی می کند. | ||
HIDL 2.0 | getAmFmRegionConfig(bool full) generates (Result result, AmFmRegionConfig config) | |
ایدل | AmFmRegionConfig getAmFmRegionConfig(bool full) | |
توضیحات: پیکربندی فعلی منطقه DAB را واکشی می کند. | ||
HIDL 2.0 | getDabRegionConfig() generates (Result result, vec<DabTableEntry> config) | |
ایدل | DabTableEntry[] getDabRegionConfig() | |
توضیحات: یک تصویر از حافظه پنهان ماژول رادیویی دریافت می کند. در AIDL، به دلیل محدودیت سخت در بافر تراکنش بایندر، اندازه تصویر باید کمتر از 1 مگابایت باشد. | ||
HIDL 2.0 | getImage(uint32_t id) generates (vec<uint8_t> image) | |
ایدل | byte[] getImage(in int id) | |
توضیحات: شنونده اعلامیه را ثبت می کند. | ||
HIDL 2.0 | registerAnnouncementListener(vec<AnnouncementType> enabled,IAnnouncementListener listener) generates (Result result, ICloseHandle closeHandle) | |
ایدل | ICloseHandle registerAnnouncementListener(in IAnnouncementListener listener, in AnnouncementType[] enabled) | |
شرح:
| ||
HIDL 2.0 | openSession(ITunerCallback callback) ایجاد می کند (Result result, ITunerSession session) | |
ایدل | void setTunerCallback(in ITunerCallback callback) | |
شرح:
| ||
HIDL 2.0 | close() | |
ایدل | unsetTunerCallback() | |
توضیحات: روی یک برنامه مشخص تنظیم می شود. | ||
HIDL 2.0 | tune(ProgramSelector program) generates (Result result) | |
ایدل | void tune(in ProgramSelector program) | |
توضیحات: به دنبال برنامه معتبر بعدی روی آنتن است. برای جلوگیری از سردرگمی در AIDL، scan به seek تغییر نام داده می شود. | ||
HIDL 2.0 | scan(bool directionUp, bool skipSubChannel) generates (Result result) | |
ایدل | void seek(in boolean directionUp, in boolean skipSubChannel) | |
توضیحات: مراحل کانال مجاور که ممکن است هیچ برنامه ای آن را اشغال نکند. | ||
HIDL 2.0 | step(bool directionUp) generates (Result result) | |
ایدل | void step(in boolean directionUp) | |
توضیحات: عملیات لحن، اسکن (در HIDL) یا جستجو (در AIDL) یا مرحله در انتظار را لغو می کند. | ||
HIDL 2.0 | cancel() | |
ایدل | void cancel() | |
توضیحات: یک فیلتر را به لیست برنامه اعمال می کند و شروع به ارسال به روز رسانی لیست برنامه ها از طریق پاسخ به تماس onProgramListUpdated می کند. | ||
HIDL 2.0 | startProgramListUpdates(ProgramFilter filter) generates (Result result) | |
ایدل | void startProgramListUpdates(in ProgramFilter filter) | |
توضیحات: ارسال به روز رسانی لیست برنامه را متوقف می کند. | ||
HIDL 2.0 | stopProgramListUpdates() | |
ایدل | void stopProgramListUpdates() | |
توضیحات: تنظیمات فعلی یک پرچم پیکربندی معین را واکشی می کند. | ||
HIDL 2.0 | isConfigFlagSet(ConfigFlag flag) generates (Result result, bool value) | |
ایدل | boolean isConfigFlagSet(in ConfigFlag flag) | |
توضیحات: پرچم پیکربندی داده شده را تنظیم می کند. | ||
HIDL 2.0 | setConfigFlag(ConfigFlag flag, bool value) generates (Result result) | |
ایدل | void setConfigFlag(in ConfigFlag flag, boolean value) | |
توضیحات: مقادیر پارامتر خاص فروشنده را تنظیم می کند. | ||
HIDL 2.0 | setParameters(vec<VendorKeyValue> parameters) تولید می کند ، (vec<VendorKeyValue> results) | |
ایدل | VendorKeyValue[] setParameters(in VendorKeyValue[] parameters) | |
توضیحات: مقادیر پارامترهای خاص فروشنده را بازیابی می کند. | ||
HIDL 2.0 | getParameters(vec<string> keys) generates (vec<VendorKeyValue> parameters) | |
ایدل | VendorKeyValue[] getParameters(in String[] keys) |
توضیحات رابط
رفتار ناهمزمان
از آنجایی که هر عملیات تنظیم (مثلاً تنظیم، اسکن (در HIDL) یا جستجو (در AIDL) و مرحله) ممکن است زمانبر باشد و نخ نباید برای مدت طولانی مسدود شود، عملیات باید عملیات زمانبر را برنامهریزی کند. بعدا رخ دهد و به سرعت یک وضعیت یا نتیجه را بازگرداند. به طور جزئی، هر عملیات باید:
- تمام عملیات تنظیم در انتظار را لغو کنید.
- بررسی کنید که آیا عملیات بر اساس ورودی های روش و وضعیت تیونر قابل پردازش است یا خیر.
- کار تنظیم را برنامه ریزی کنید و سپس
Result
(در HIDL) یاstatus
(در AIDL) را بلافاصله برگردانید. اگرResult
یاstatus
OK
باشد، زمانی که کار تنظیم ناموفق بوده است (مثلاً به دلیل مهلت زمانی) یا تکمیل شده است، تنظیم کننده تماس برگشتی تنظیم کنندهtuneFailed
یاcurrentProgramInfoChanged
باید فراخوانی شود.
به طور مشابه، startProgramListUpdates
همچنین کار زمان بر به روز رسانی لیست برنامه را برنامه ریزی می کند تا بعداً انجام شود و به سرعت یک وضعیت یا نتیجه را بازگرداند. این روش ابتدا درخواستهای بهروزرسانی معلق را لغو میکند و سپس کار بهروزرسانی را زمانبندی میکند و به سرعت نتیجه را برمیگرداند.
شرایط مسابقه
به دلیل رفتار ناهمزمان عملیات تنظیم (به عنوان مثال، تنظیم، اسکن (در HIDL) یا جستجو (در AIDL)، و مرحله)، یک شرایط مسابقه بین لغو عملیات و عملیات تنظیم وجود دارد. اگر cancel
پس از اتمام HAL یک عملیات تنظیم و قبل از تکمیل تماس فراخوانی شود، می توان لغو را نادیده گرفت و پاسخ تماس باید تکمیل شود و توسط سرویس گیرنده HAL دریافت شود.
به طور مشابه، اگر stopProgramListUpdates
پس از تکمیل بهروزرسانی لیست برنامه توسط HAL و قبل از تکمیل فراخوانی onCurrentProgramInfoChanged
فراخوانی شود، stopProgramListUpdates
را میتوان نادیده گرفت و تماس مجدد باید کامل شود.
محدودیت اندازه داده
از آنجایی که محدودیت سختی در بافر تراکنش بایندر وجود دارد، محدودیت داده برای برخی از روشهای رابط که دادههایی با اندازه بالقوه بزرگ را ارسال میکنند، در AIDL HAL مشخص میشوند.
-
getImage
نیاز دارد که تصویر کمتر از 1 مگابایت برگردانده شود. -
onProgramListUpdate
نیاز دارد که هرchunk
کمتر از 500 کیلو بایت باشد. لیست های برنامه های بزرگتر باید توسط اجرای HAL به چند تکه تقسیم شده و از طریق تماس های متعدد ارسال شوند.
تغییرات در ساختار داده AIDL HAL
علاوه بر تغییرات در رابط ها، این تغییرات در ساختارهای داده تعریف شده در رادیو پخش AIDL HAL اعمال شده است که از AIDL بهره می برد.
- Enum
Constant
در AIDL حذف می شود و به عنوان const int درIBroadcastRadio
تعریف می شود. در همین حال،ANTENNA_DISCONNECTED_TIMEOUT_MS
بهANTENNA_STATE_CHANGE_TIMEOUT_MS
تغییر نام داد. یک Const int جدیدTUNER_TIMEOUT_MS
اضافه شده است. تمام عملیات تنظیم، جستجو و گام باید در این زمان تکمیل شود. - Enum
RDS
وDeemphasis
در AIDL حذف شده و درAmFmRegionConfig
به عنوان const int تعریف می شوند. به همین ترتیب، هر دوfmDeemphasis
وfmRds
درProgramInfo
بهعنوان int، یک نتیجه محاسباتی بیت پرچمهای مربوطه اعلام میشوند. در همین حال،D50
وD75
به ترتیب بهDEEMPHASIS_D50
وDEEMPHASIS_D75
تغییر نام دادند. - Enum
ProgramInfoFlags
در AIDL حذف می شوند و به عنوان const int درProgramInfo
با اضافه شدن پیشوندFLAG_
تعریف می شوند. به همین ترتیب،infoFlags
درProgramInfo
بهعنوان int، یک نتیجه محاسباتی بیت پرچمها اعلام میشود.TUNED
همچنین بهFLAG_TUNABLE
تغییر نام داده است تا تعریف آن را که می توان ایستگاه را تنظیم کرد بهتر توصیف کرد. - در
AmFmBandRange
،scanSpacing
بهseekSpacing
تغییر نام داده است، زیراscan
بهseek
در AIDL تغییر نام داده است. - از آنجایی که مفهوم اتحاد در AIDL معرفی شده است،
MetadataKey
وMetadata
تعریف شده در HIDL HAL دیگر استفاده نمی شوند. یکMetadata
اتحادیه AIDL در AIDL HAL تعریف شده است. هر مقدار enum قبلاً درMetadataKey
اکنون یک فیلد درMetadata
با نوع رشته یا int بسته به تعاریف آنها است.