class ADC -- التحويل من التماثلي إلى الرقمي¶

يغلّف الصنف ADC قناة مفردة لمحول من التماثلي إلى الرقمي تأخذ عينة من جهد على دبوس (أو إحدى القنوات التماثلية المدمجة في الشريحة) وتُرجِع قيمته المُجزّأة.

مثال على الاستخدام:

from machine import ADC, Pin

adc = ADC(Pin("P6"))      # ADC channel on header pin P6 (PA5)
val = adc.read_u16()      # raw reading scaled to 0..65535

البواني¶

class machine.ADC(id: int | str | Pin) → ADC¶

تُنشئ كائن ADC للمصدر التماثلي المُعرَّف بـ id. الصيغ المقبولة هي:

رقم قناة صحيح (0 -- 18 على STM32، وخاص بالمنفذ في غير ذلك)؛

كائن Pin، أو سلسلة دبوس لوحة مثل "P6" -- ويجب أن يكون الدبوس قادرًا على التعامل مع الإشارة التماثلية؛

أحد ثوابت القناة الداخلية (CORE_TEMP أو CORE_VREF أو CORE_VBAT أو VREF أو CORE_VDD) لقراءة المستشعرات الداخلية للمتحكم. على STM32 فقط.

الدوال¶

read_u16() → int¶: تأخذ عينة واحدة من القناة التماثلية وتُرجِع النتيجة كعدد صحيح غير مُوقَّع ذي 16 بتة (0 -- 65535). تُحاذى المحولات ذات الدقة الأقل إلى اليسار ضمن مدى الـ 16 بتة بحيث تُخفى الدقة الخام الخاصة بالمنفذ.

read_uv() → int¶: تأخذ عينة من القناة التماثلية وتُرجِع النتيجة بالميكروفولت. تُعايَر القراءة مقابل المرجع الداخلي حيثما تدعم العتاد ذلك. على منفذ mimxrt فقط.

الثوابت¶

الثوابت أدناه متوافرة فقط على منفذ STM32؛ مرِّرها كوسيط id لإنشاء ADC يقرأ أحد المستشعرات التماثلية المدمجة في الشريحة. ونتيجة read_u16() هي القراءة الخام ذات الـ 16 بتة للقناة؛ وللحصول على قيم مُعايَرة استخدم الدوال المساعِدة في pyb.ADCAll.

VREF: int¶: قناة مرجع الجهد الخارجي.

CORE_VREF: int¶: قناة مرجع الجهد الداخلي 1.21 فولت (اسمي) (VREFINT).

CORE_TEMP: int¶: قناة مستشعر حرارة الشريحة الداخلي.

CORE_VBAT: int¶: قناة جهد بطارية النسخ الاحتياطي (VBAT).

CORE_VDD: int¶: قناة خط تغذية المتحكم (VDDA).