پشت پیچ تنظیم رنگی چه میگذرد؟ تحلیل مدار و کد Qwiic Twist
مسیر یک کلیک را در برد متنباز SparkFun دنبال کنیم: کنتاکت و فیلتر RC، پایههای ATtiny84، نور RGB، باس I2C و دو مرز مهم در firmware.
فهرست مطالب
پیچ تنظیم دستگاه چطور میفهمد آن را به چپ چرخاندهایم یا راست؟ در پروژهٔ متنباز Qwiic Twist، دو کنتاکت مکانیکی حرکت را نشان میدهند، یک میکروکنترلر کوچک آن را میشمارد و میزبان نتیجه را با رابط I²C میخواند. همان برد، فشار دادن پیچ و روشنایی سهرنگ آن را هم مدیریت میکند. ارزش این طراحی، جمع کردن ورودی انسان و بازخورد نوری در یک رابط ساده است؛ با این شرط که محدودیت کنتاکت، تغذیه و نرمافزار را بشناسیم.
این تحلیل مربوط به پروژهٔ SparkFun Electronics، مخزن Qwiic_Twist، نسخهٔ ثابت f9bbde3 با تاریخ ثبت ۲۷ اوت ۲۰۲۱ است؛ شماتیک، PCB و firmware همین نسخه در ۳۰ اکتبر ۲۰۲۶ بررسی شدند. برد آمادهٔ مرتبط DEV-15083 است.
تصویر ساختهشده برای آموزش LCENJ؛ نمای توضیحی یک کنترل چرخشی عمومی، نه عکس برد Qwiic Twist یا نتیجهٔ آزمایش.
انتخاب برد Qwiic Twist
برد این تحلیل Qwiic Twist در SparkFun با کد DEV-15083 است. انکودر خام جایگزین مستقیم آن نیست؛ این برد میکروکنترلر، firmware و رابط I²C دارد.
مسئلهٔ طراحی: یک پیچ، چند وظیفه
برای انتخاب منو، تنظیم روشنایی یا تغییر یک مقدار، معمولاً به چرخش، کلیک و بازخورد نیاز داریم. اتصال مستقیم این مجموعه به میزبان، دو ورودی چرخش، ورودی کلید و سه خروجی نور میخواهد؛ میزبان باید تغییرهای سریع کنتاکت را هم دنبال کند. اینجا U4 این کار محلی را میگیرد و چند عدد و پرچم وضعیت را در اختیار میزبان میگذارد. در مقابل، یک قطعهٔ فعال، firmware و پروتکل قابل عیبیابی به سیستم اضافه میشود.
انکودر افزایشی، تغییر حرکت را میشمارد؛ عدد آن بهتنهایی زاویهٔ مطلق محور نیست. برای مفهوم مرجع و تفاوت شمارش با موقعیت، آموزش حسگر موقعیت و انکودر را ببینید. در این برد، ذخیره شدن تنظیمات در EEPROM را هم نباید با حفظ موقعیت محور پس از قطع برق یکی دانست؛ شمارش جاری در ساختار تنظیمات ذخیره نمیشود.
از کنتاکت تا شمارش: چرا دو شبکهٔ RC داریم؟
کنتاکت، اتصال فلزیای است که با چرخش باز و بسته میشود. دو خروجی A و B با ترتیب متفاوت تغییر میکنند و جهت را نشان میدهند. در شماتیک، مسیر A شامل R4 بالاکش ۱۰ کیلواهم به ۳٫۳ ولت، R5 سری ۱۰ کیلواهم و C3 با ظرفیت ۱۰ نانوفاراد به زمین در سمت ورودی میکروکنترلر است. مسیر B همین ساختار را با R7، R9 و C1 دارد. بالاکش، ورودیِ باز را در وضعیت مشخص نگه میدارد؛ خازن و مقاومتها تغییرهای بسیار کوتاه را نرمتر میکنند.
ثابت زمانی، مقیاسی برای سرعت شارژ خازن است: τ = R × C. با باز شدن کنتاکت، شارژ از مجموع دو مقاومت میگذرد: 20 kΩ × 10 nF = 200 µs. هنگام بسته شدن، تخلیه از مقاومت سری است: 10 kΩ × 10 nF = 100 µs. میکروثانیه یکمیلیونیم ثانیه است. پس «فیلتر ۱۰۰ میکروثانیهای» برای هر دو جهت تغییر، توصیف دقیقی نیست. این عددها محاسبهٔ مدار ایدهآلاند؛ زمان حذف پرش مکانیکی یا بیشترین سرعت مجاز چرخش را تضمین نمیکنند. آستانهٔ ورودی، تلرانس قطعات و شکل واقعی پرش باید اندازهگیری شوند.
در فایل interrupts.ino، firmware چهار وضعیت پیاپی A/B را بررسی میکند و فقط با الگوی کامل، شمارش را تغییر میدهد. این روش تغییر ناقص را کمتر به کلیک کامل تبدیل میکند؛ اثبات حذف همهٔ پرشها یا از دست نرفتن شمارش در هر سرعت نیست. ورودی کلید فشاری ساختار دیگری دارد: R1 ده کیلواهم آن را پایین نگه میدارد و فشردن کلید آن را به ۳٫۳ ولت میرساند. در handler کلید، تأخیر زمانی صریح برای debounce دیده نمیشود؛ رفتار کلیک را باید جدا از چرخش بررسی کرد.
پایهها و اتصال درست به میزبان
هر دو کانکتور چهارپایهٔ Qwiic روی یک باساند: پایهٔ ۱ زمین، ۲ تغذیهٔ ۳٫۳ ولت، ۳ دادهٔ SDA و ۴ ساعت SCL. رنگ کابل یا جهت ظاهری برد جای بررسی شمارهٔ پایه را نمیگیرد. پایههای فیزیکی U4 در پکیج SO14 از اتصالهای شماتیک استخراج شدهاند؛ این اعداد با شمارهٔ Arduino در کد یکسان نیستند.
| وظیفه | پایهٔ فیزیکی U4 | مسیر در مدار |
|---|---|---|
| تغذیه و زمین | 1 / 14 | ریل مستقیم ۳٫۳ ولت / GND |
| کانالهای A و B | 2 / 11 | پس از فیلترهای RC |
| SDA و SCL | 7 / 9 | باس مشترک دو کانکتور |
| نور قرمز، سبز، آبی | 5 / 6 / 8 | خروجیهای PWM و مقاومتهای R12 تا R14 |
| کلید، INT، آدرس | 10 / 13 / 3 | کلید فشاری / اعلان میزبان / جامپر ADR |
| ریست | 4 | بالاکش R8 و نقطهٔ برنامهریزی |
برای شروع، میزبان با منطق ۳٫۳ ولت و زمین مشترک انتخاب کنید. در این شماتیک رگولاتور، مبدل سطح منطقی، فیوز ورودی یا TVS دیده نمیشود؛ نباید از تحمل ولتاژ خود تراشه نتیجه گرفت که مجموعهٔ برد و کابل به باس ۵ ولت مناسب است. پایههای برنامهریزی نیز با بعضی سیگنالها مشترکاند؛ BLUE با MISO و خطوط I²C با MOSI/SCK ارتباط دارند. وصل ماندن میزبان هنگام برنامهریزی میتواند تداخل ایجاد کند. راهنمای پروژه دربارهٔ جامپر تغذیهٔ ۵ ولت پروگرامر هشدار دارد؛ در این بررسی هیچ پروگرامری وصل یا اجرا نشده است.
تغذیه و نور رنگی؛ مصرف را از روی ظاهر حدس نزنیم
ریل ۳٫۳ ولت مستقیم به U4 و آند مشترک LEDهای انکودر میرود. C2 با ظرفیت ۰٫۱ میکروفاراد برای بایپس تغذیه و R3 یک کیلواهم همراه LED قرمز D1 برای نمایش روشن بودن قرار دارد. در اتصال آند مشترک، پایین کشیدن کاتد نور را روشن میکند؛ به همین دلیل کد برای روشنایی درخواستی، مقدار معکوس 255 − brightness را به PWM میدهد. PWM روشن و خاموش کردن سریع است؛ عدد روشنایی، اندازهگیری جریان یا شدت نور کالیبرهشده نیست.
مقاومتهای سری سه رنگ R12، R13 و R14 در این نسخه هر کدام ۱۰ اهماند و R10 با علامت DNP مونتاژ نمیشود. مقدار کوچک مقاومت بهتنهایی جریان واقعی را معلوم نمیکند: افت LED، ولتاژ خروجی میکروکنترلر و duty cycle هم مؤثرند. دیتاشیت ATtiny84 در ۳ ولت، ولتاژ پایین خروجی را در بار ۵ میلیآمپر مشخص میکند؛ حد مطلق جریان، مقدار هدف طراحی نیست. برای ارزیابی همین برد، جریان هر رنگ و ولتاژ پایه را در روشنایی ثابت و سپس سهرنگ اندازه بگیرید. اطلاعات فعلی صفحهٔ محصول، آزمون مستقل این نسخه از PCB نیست.
باس I²C؛ مسئله فقط آدرس نیست
R2 و R6، پولآپهای ۲٫۲ کیلواهم SDA/SCL هستند و جامپر سهپد JP9 امکان قطع اتصال آنها را دارد. پولآپ، خط رهاشده را بالا میبرد؛ خروجیها برای صفر کردن آن جریان میکشند. با تقریب ولتاژ پایین صفر، یک مجموعه در ۳٫۳ ولت حدود 3.3 / 2200 = 1.5 mA میخواهد. چهار برد با پولآپ فعال، مقاومت مؤثر ۵۵۰ اهم و بار تقریبی ۶ میلیآمپر ایجاد میکنند. این فقط مثال محاسباتی است، نه تأیید اتصال چهار برد.
از طرف دیگر، مقاومت خیلی بزرگ لبهٔ بالارونده را کند میکند. طبق راهنمای NXP، tr ≈ 0.8473 × Rp × Cb است. با فرض ظرفیت کل باس ۱۰۰ پیکوفاراد و ۲٫۲ کیلواهم، زمان حدود ۱۸۶ نانوثانیه است؛ با فرض ۲۰۰ پیکوفاراد، حدود ۳۷۳ نانوثانیه میشود و از حد ۳۰۰ نانوثانیهٔ Fast-mode عبور میکند. ظرفیت این اتصال اندازهگیری نشده است. شروع با ۱۰۰ کیلوهرتز، کابل کوتاه و تعداد پولآپ کنترلشده، سپس اندازهگیری لبهها و ولتاژ صفر، مسیر بررسی معقولی است؛ سرعت کمتر هم درمان همهٔ خطاهای باس نیست.
آدرس پیشفرض نرمافزار 0x3F است؛ بسته شدن جامپر ADR آن را به 0x3E تحمیل میکند و آدرس نرمافزاری هم در محدودهٔ تعریفشده قابل تغییر است. بنابراین برای چند برد، هم آدرس و هم بار الکتریکی را بررسی کنید. خروجی INT از قبل بالاکش ۱۰ کیلواهم با جامپر قطع دارد؛ firmware با تغییر پایه میان خروجی صفر و ورودی آزاد، رفتار open-drain را پیاده میکند. افزودن دوبارهٔ همین قابلیت، پیشنهاد تازهای نیست.
PCB چه چیزی دربارهٔ طراحی میگوید؟
مرز برد تکی در فایل، ۳۰٫۴۸ در ۲۵٫۴ میلیمتر است و مس روی دو لایه قرار دارد. چهار قطعهٔ کتابخانهای STAND-OFF محلهای مکانیکی را مشخص میکنند؛ نبود hole در بخش plain به معنی نبود سوراخ مونتاژ نیست. فایل تولید، پنل ۱۴تایی و ضخامت ۱٫۶ میلیمتر با مس یک اونس را درخواست میکند؛ اندازهٔ پنل را نباید اندازهٔ همین برد تکی نوشت.
مسیرهای A/B روی لایهٔ بالا و بدون via هستند؛ کوتاه نگه داشتن حلقهٔ کنتاکت و خازن به خواندن تمیزتر کمک میکند، اما این مزیت باید با شکل موج واقعی سنجیده شود. باس و تغذیه میان دو کانکتور عبور میکنند و بعضی مسیرها به عرض ۰٫۱۵۲۴ میلیمتر هستند. زمین دو polygon و ۱۲ via دارد؛ رسم polygon اثبات اتصال کامل زمین پس از تولید یا مصونیت از نویز نیست. هنگام بازتولید برد، pour و DRC را در CAD اجرا و مسیر برگشت جریان LED، اتصال زمین C2 و کلیرنس پایههای انکودر را بررسی کنید.
بار مکانیکی پیچ باید به مونتاژ و بدنه منتقل شود، نه صرفاً به کابل Qwiic. جهت انکودر، پایهٔ مشترک RGB، قطب D1 و جهت SO14 پیش از لحیم بررسی شوند. گرمایش محسوس، دلیل اندازهگیری جریان و اتصال کوتاه است؛ از روی تصویر مسیرها نمیتوان دمای کاری یا ظرفیت تحمل بار را اعلام کرد.
firmware چگونه رفتار سختافزار را شکل میدهد؟
نقشهٔ رجیستر در کد شامل شناسهٔ 0x5C در آدرس صفر، وضعیت در ۱، شمارش علامتدار ۱۶بیتی در ۵ و ۶، اختلاف شمارش در ۷ و ۸ و روشنایی رنگها در ۱۳ تا ۱۵ است. اینها شمارهٔ رجیسترند، نه پایه. نسخهٔ firmware در ساختار همین منبع ۱٫۲ است. خواندن دو بایت شمارش، جابهجایی مثبت و منفی را گزارش میکند؛ برای بازهٔ طولانی، سرریز ۱۶بیتی را در منطق میزبان مدیریت کنید. از چند خواندن جداگانه، snapshot اتمی همهٔ مقادیر فرض نکنید.
پیشفرض اعلان چرخش ۲۵۰ میلیثانیه پس از آخرین حرکت است؛ اگر میخواهید نوار منو همزمان با چرخش حرکت کند، خواندن دورهای شمارش با انتظار صرف برای این اعلان یکی نیست. پاک کردن پرچمهای وضعیت در رها شدن INT نقش دارد. حلقهٔ اصلی از خواب Idle استفاده میکند، نه خاموشی کامل؛ تایمر لازم برای زمانسنجی حفظ میشود. برای مصرف نهایی باید LEDها، پولآپها و میزبان را هم حساب کرد.
تنظیمات در EEPROM نگه داشته میشوند و کد فقط تغییر مقدار را مینویسد؛ در هر دور حلقه نوشتن انجام نمیشود. با این حال تغییر مداوم رنگ از میزبان میتواند تعداد ذخیرهها را زیاد کند. دیتاشیت برای EEPROM دوام ۱۰۰هزار چرخه را مشخص میکند. راهاندازی دوباره، حفظ تنظیم رنگ و حفظ شمارش حرکت سه آزمون جدا هستند. وابستگیهای core و PinChangeInterrupt در دستور ساخت این نسخه pin نشدهاند؛ compilation قابل تکرار گزارش نمیکنیم. بررسی اینجا خواندن منبع و اجرای محاسبات و ردگیری شاخههای شرطی در Python است.
دو نقطهٔ مشخص برای اصلاح و آزمون
مرز چرخش: در interrupts.ino / updateEncoder، شاخهٔ ساعتگرد مقدار بزرگتر یا مساوی rotationLimit را صفر میکند، اما شاخهٔ پادساعتگرد پس از منفی شدن، خود rotationLimit را میگذارد. برای limit برابر ۲۴، ردگیری منبع نشان میدهد 23 → CW → 0 ولی 0 → CCW → 24. این نامتقارن بودن در همین کد قابل مشاهده است؛ خطای شمارش اندازهگیریشده روی برد نیست. اگر قرارداد مطلوب بازهٔ 0…23 باشد، پیشنهاد این است که شاخهٔ دوم مقدار limit−1 بگذارد و پارامترها نیز در بازهٔ معتبر شمارش علامتدار محدود شوند. هزینه، تغییر رفتار مرزی نسبت به نسخهٔ قبلی است؛ آزمون باید هر دو جهت، limit صفر، یک و ۲۴ و جابهجایی رفتوبرگشت از صفر را پوشش دهد.
مرز خواندن رجیستر: در receiveEvent، نخستین بایت بدون بررسی بازه به registerNumber میرود. نوشتن داده بررسی اندازه دارد، اما requestEvent نشانی registerPointer + registerNumber و طول sizeof(memoryMap) − registerNumber را بیبررسی استفاده میکند. offset بیرون از ساختار، اشارهگر بیرون از رجیسترهای مجاز میسازد. پیشنهاد، اعتبارسنجی offset پیش از خواندن و پاسخ محدود و تعریفشده برای offset نامعتبر است؛ قرار دادن صرفِ guard در مسیر نوشتن کافی نیست. رفتار خطا باید با میزبان سازگار شود و با درخواست از ابتدا، آخرین بایت معتبر و چند offset نامعتبر بررسی گردد. هیچ نشت داده یا خرابی روی دستگاه در این بررسی مشاهده یا ادعا نشده است.
راهاندازی و سنجش نتیجه
ابتدا بدون برق، اتصال زمین و تغذیه و جهت کانکتور را بررسی کنید. با منبع محدودشدهٔ مناسب و ۳٫۳ ولت، جریان حالت خاموشی RGB را ثبت کنید؛ سپس هر رنگ را جدا روشن کنید و تغییر جریان و ولتاژ ریل را ببینید. شناسایی آدرس و خواندن شناسهٔ 0x5C پیش از تفسیر عدد شمارش انجام شود. برای خطای ارتباط، اول تغذیه، سیمها، ADR و پولآپ را بررسی کنید؛ عوض کردن فرمول موقعیت آن را حل نمیکند.
بعد، ده کلیک آهسته به یک سمت و ده کلیک برگشت را با شمارش دریافتی مقایسه کنید. سرعت را مرحلهای بالا ببرید و اگر شمارش کم شد، A/B در سمت ورودی U4 و ترتیب وقفهها را بررسی کنید. کلید را مستقل با چند فشار و رهاسازی، و INT را با زمانبندی واقعی بخوانید. آزمون رنگها، قطعوصل برق و مرز چرخش را جدا ثبت کنید. عدد برابر در یک آزمایش کوتاه، تضمین کارکرد در همهٔ سرعتها و شرایط نویز نیست.
برای یک کنترل منو این معماری ساده و قابل فهم است؛ برای بازخورد دقیق محور موتوردار، نبود مرجع مطلق و احتمال خطای کنتاکت باید از ابتدا در نیازسنجی دیده شود. اگر هدف یادگیری فرایند ساخت است، راهنمای شماتیک، PCB و فایلهای تولید کمک میکند تفاوت مدار، طرح برد و خروجی ساخت روشن بماند.
منابع و حقوق بازاستفاده
منابع اصلی این تحلیل، شماتیک، PCB و firmware همان commit هستند. مشخصات تراشه از Atmel 8006K–AVR–10/10، بخش پایهها و مشخصات الکتریکی و رابطهٔ باس از NXP UM10204 نسخهٔ ۷، بخش ۷٫۱ گرفته شدهاند. صفحهٔ فعلی فروشنده برای تطابق محصول است؛ فایل یک revision دیگر جای منبع نسخهٔ بررسیشده ننشسته است.
سختافزار مخزن با CC BY-SA 4.0 منتشر شده و نمودارهای مشتق همین مجوز را دارند. License.md برای نرمافزار MIT ذکر میکند؛ سربرگ اصلی firmware عبارتهای public domain/Beerware هم دارد و این اعلانها در آرشیو اصلی همان نسخه حفظ شدهاند. دربارهٔ مجوز مستقل عکسهای مخزن فرضی نشده و از آنها کپی نکردهایم. جزئیات منبع و تغییر تصاویر و محاسبات و ردگیری شاخهها قابل دریافتاند.
پرسش و پاسخ مقاله
سوال فنی خود را مطرح کنید
پرسشها و پاسخها پس از بررسی مدیر منتشر میشوند. نویسنده، پیشنویس در انتظار بررسی را میبیند.
هنوز پرسش تاییدشدهای برای این مقاله ثبت نشده است.