حساس لمس MPR121 على لوحة Arduino: بيانو باللمس
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
يحوّل MPR121 اثنتي عشرة قطعة من المعدن إلى أزرار لمس. وصّل كل قطب من أقطابه إلى رقاقة من ورق القصدير أو شريط نحاسي أو حتى قطعة فاكهة، وسيعرف Arduino أيّها يلمس إصبعك. يتواصل عبر I2C، لذا يكفي سلكان للإشارة لاثني عشر مفتاحًا.
الدائرة أعلاه عبارة عن Uno وMPR121 وpiezo على شكل بيانو لمس باثني عشر مفتاحًا: أوكتاف واحد من النغمات يبدأ من دو الوسطى. اضغط مطولًا على مفتاح فيعزف نغمة، واضغط اثنين معًا فيفوز الأدنى، واتركه فيتوقف. اضغط «تشغيل» ثم اضغط مطولًا على مفاتيح MPR121.
ما تحتاجه
- Arduino Uno
- لوحة MPR121 Breakout
- قطعة piezo سالبة
- اثنا عشر لوحة لمس: ورق قصدير أو شريط نحاسي أو سلك
- لوحة تجارب وأسلاك توصيل
التوصيل
| القطعة والطرف | يتصل بـ | ملاحظة |
|---|---|---|
| MPR121 VIN | 5 V | تعمل اللوحة الإضافية بجهد من 3 إلى 5 فولت |
| MPR121 GND | GND | |
| MPR121 SCL | SCL (A5) | |
| MPR121 SDA | SDA (A4) | العنوان 0x5A |
| MPR121 من الطرف 0 إلى الطرف 11 | لوحات اللمس | سلك واحد لكل مفتاح |
| Piezo | الطرف 8 | الساق الأخرى إلى GND |
كيف يعمل اللمس السعوي
كل قطب، مع اللوحة والسلك المثبت عليه، يمتلك سعة صغيرة: يحتفظ بشحنة قليلة، مثل مكثف صغير. جسمك موصّل كبير، لذا فإن إصبعك على اللوحة يزيد تلك السعة. يقيس MPR121 كل قطب مرات عديدة في الثانية ويلاحظ التغير.
تحتفظ الشريحة بقيمة أساسية لكل قطب، وهي قراءته دون أن يلمسه أحد. عندما تنخفض القراءة عن القيمة الأساسية بمقدار يتجاوز عتبة اللمس، يُعد المفتاح مضغوطًا؛ وعندما تعود إلى داخل عتبة الإفلات، يُترك المفتاح. تضبط مكتبة Adafruit هاتين العتبتين على 12 و6 نقطة لكل مفتاح. كل ذلك يحدث داخل الشريحة، بينما لا يقرأ Arduino سوى بايتين: اثنا عشر بتًا، واحد لكل مفتاح.
الكود
يعثر cap.begin(0x5A) على الشريحة ويشغلها. ثم كل 10 ms تستدعي الحلقة cap.touched()، التي تُرجع البتات الاثني عشر، القطب 0 في البت 0. يبحث الكود عن أدنى بت مُضبوط، وإذا تغيّر ذلك المفتاح، يشغّل نغمته عبر tone() أو يوقفها عبر noTone().
النغمات هي أنصاف الأوتار الاثنا عشر بدءًا من دو الوسطى، مقرّبة إلى الهيرتز: 262 Hz لـ C4 وصولًا إلى 494 Hz لـ B4. اضغط المفتاح 0 وستقول الشاشة التسلسلية "key 0: C4, 262 Hz". اضغط المفتاحين 4 و9 معًا وستسمع صوت المفتاح 4، "E4, 330 Hz". اترك كل شيء وستقول "quiet".
#include <Wire.h>
#include "Adafruit_MPR121.h"
const int PIEZO = 8;
const unsigned int NOTES[12] = {262, 277, 294, 311, 330, 349, 370, 392, 415, 440, 466, 494};
const char *NAMES[12] = {"C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"};
Adafruit_MPR121 cap = Adafruit_MPR121();
int playing = -1;
void setup() {
Serial.begin(115200);
if (!cap.begin(0x5A)) {
Serial.println("no MPR121: check SDA, SCL and power");
while (1) delay(10);
}
Serial.println("ready: touch a key");
}
void loop() {
uint16_t touched = cap.touched();
int key = -1;
for (int i = 0; i < 12; i++) {
if (touched & (1 << i)) {
key = i;
break;
}
}
if (key != playing) {
playing = key;
if (key < 0) {
noTone(PIEZO);
Serial.println("quiet");
} else {
tone(PIEZO, NOTES[key]);
Serial.print("key ");
Serial.print(key);
Serial.print(": ");
Serial.print(NAMES[key]);
Serial.print("4, ");
Serial.print(NOTES[key]);
Serial.println(" Hz");
}
}
delay(10);
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
التشغيل فقط عند حدوث تغيير
يتذكّر الكود أي مفتاح يشغّله، ولا يستدعي tone() إلا عند تغيّره. استدعاء tone() مجددًا كل 10 ms بالنغمة نفسها سيعيد تشغيل الموجة الصوتية في كل مرة، وستسمع طنينًا فوق النغمة. تذكّر الحالة والتفاعل مع التغيير هما الفكرة نفسها المستخدمة في اكتشاف حواف الأزرار.
يمكن لقطعة البيزو الواحدة تشغيل نغمة واحدة في كل مرة، ولهذا يفوز أدنى مفتاح. لتشغيل الأكوردات ستحتاج إلى عدة أطراف وكود أكبر قليلًا، أو إلى وحدة صوتية.
لوحات حقيقية، مشكلات حقيقية
أبقِ الأسلاك الممتدة من اللوحة إلى اللوحات اللمسية قصيرة ومتباعدة، لأن السلك الطويل يُعدّ جزءًا من القطب وقد يُطلق المفتاح عندما تقترب منه اليد. اللوحات بحجم طرف الإصبع أو أكبر قليلًا تعمل جيدًا.
تتعلّم الشريحة قيمها الأساسية عند بدء التشغيل. إذا لمست لوحة أثناء التشغيل فسيصبح ذلك اللمس هو قراءة «غير اللمس»، ولن يستجيب المفتاح حتى تُعاد ضبطه. أبقِ يديك بعيدة خلال الثانية الأولى.
تتجاهل المحاكاة السعة نفسها: المفتاح غير الملموس يقرأ 700 عدّة، والإصبع يُنقصها 40، والقيمة الأساسية لا تنحرف. في بناء حقيقي قد تحتاج إلى ضبط العتبات باستخدام cap.setThresholds(touch, release) بما يناسب لوحاتك.
أخطاء شائعة
تعذّر العثور على الشريحة. مع سحب SDA، يطبع الكود "no MPR121: check SDA, SCL and power" ثم يتوقف. افحص سلكي الناقل والتغذية.
قطعة أخرى على العنوان 0x5A. مقياس الحرارة بالأشعة تحت الحمراء MLX90614 يتوضّع هناك أيضًا. انقل MPR121 بتوصيل طرف ADDR: إلى 3.3 V للحصول على 0x5B، وإلى SDA للحصول على 0x5C، وإلى SCL للحصول على 0x5D، ثم مرّر العنوان الجديد إلى begin().
لمس لوحة أثناء التشغيل، فلا تُقرأ أبدًا كمُلموسة.
إعادة تشغيل tone() في كل دورة، ما يعطي طنينًا بدلًا من نغمة نقية.
لوحات متقاربة جدًا، فيلمس إصبع واحد مفتاحين. اترك فجوة بينها.
افتح هذه الدائرة في المحرر. Arduino Uno: بيانو لمس باستخدام MPR121، موصّلًا كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّله مرة أخرى.
افتح الدائرةالأسئلة
كم طرف إدخال لمس يملك MPR121؟
اثنا عشر طرفًا، مرقّمة من 0 إلى 11. يمكن لما يصل إلى أربع لوحات MPR121 مشاركة ناقل I2C واحد على العناوين من 0x5A إلى 0x5D، أي 48 مفتاحًا.
أي مكتبة أستخدم مع MPR121؟
مكتبة Adafruit MPR121 Library: استدعِ cap.begin(0x5A)، ثم cap.touched() للحصول على رقم من اثني عشر بتًا، بت واحد لكل قطب.
هل يستشعر MPR121 من خلال البلاستيك؟
نعم، من خلال طبقة رقيقة من البلاستيك أو الزجاج أو الورق فوق اللوحة، وإن كان التغيير أصغر. قد تحتاج إلى خفض عتبة اللمس.
هل MPR121 أفضل من TTP223؟
TTP223 هو مفتاح لمس واحد بمخرج رقمي واحد، بسيط ورخيص. أما MPR121 فيدير اثني عشر مفتاحًا على سلكين ويتيح لك ضبط العتبات. لأكثر من مفتاحين أو ثلاثة، يوفّر MPR121 توصيلات أقل.
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.