এমবেডেড সিস্টেম ডিবাগিং — JTAG/SWD ও লজিক অ্যানালাইজার

১ · এমবেডেড ডিবাগিং কেন ভিন্ন

একটি সাধারণ ডেস্কটপ/ওয়েব অ্যাপ্লিকেশন ডিবাগ করার সময় প্রায় সবসময় একটি কনসোল থাকে যেখানে print/লগ স্টেটমেন্ট দিয়ে দ্রুত অবস্থা দেখা যায়, এবং প্রোগ্রামটি নিজের PC-তেই চলে বলে একটি সফটওয়্যার ডিবাগার সহজেই তার মেমরি/থ্রেড নিয়ন্ত্রণ করতে পারে। এমবেডেড ফার্মওয়্যারে এই দুটোই সহজ নয় — অনেক বেয়ার-মেটাল সিস্টেমে কোনো কনসোল/অপারেটিং সিস্টেমই থাকে না (একটি UART থাকলে তবেই একটি সরলীকৃত "প্রিন্ট" সম্ভব, নাহলে নয়), আর প্রোগ্রামটি চলছে একটি সম্পূর্ণ ভিন্ন, বাহ্যিক চিপে (L12-এর ক্রস-কম্পাইলেশন মনে করুন) — তাই ডেভেলপারের PC থেকে সরাসরি সেই চিপের ভেতরের অবস্থা দেখার জন্য একটি বিশেষ হার্ডওয়্যার-লেভেল সংযোগ দরকার হয়।

২ · JTAG ও SWD — হার্ডওয়্যার ডিবাগ ইন্টারফেস

JTAG (Joint Test Action Group) মূলত একটি চিপ-টেস্টিং স্ট্যান্ডার্ড হিসেবে শুরু হলেও, আজ এটি ব্যাপকভাবে ডিবাগিং-এর জন্যও ব্যবহৃত হয় — একটি একাধিক-তার (সাধারণত ৪-৫ পিন) সিরিয়াল ইন্টারফেস যা একটি ডিবাগ প্রোব (হোস্ট PC ও চিপের মাঝে একটি ছোট হার্ডওয়্যার অ্যাডাপ্টার) দিয়ে চিপের একটি বিশেষ "ডিবাগ পোর্ট"-এ সংযুক্ত হয়। এই সংযোগের মাধ্যমে ডেভেলপার সরাসরি ব্রেকপয়েন্ট বসাতে পারেন (নির্দিষ্ট ইনস্ট্রাকশনে প্রোগ্রাম থামিয়ে দেওয়া), সিঙ্গল-স্টেপ চালাতে পারেন (একটি একটি করে ইনস্ট্রাকশন এক্সিকিউট করা), এবং যেকোনো মুহূর্তে চিপের রেজিস্টার ও মেমরির বর্তমান অবস্থা লাইভ পড়তে পারেন — এমনকি প্রোগ্রামের নিজের কোডে কোনো ডিবাগ-স্পেসিফিক লাইন না লিখেই।

SWD (Serial Wire Debug) হলো ARM-এর নিজস্ব, সরলীকৃত ২-তারের বিকল্প — একই কাজ করে (ব্রেকপয়েন্ট, সিঙ্গল-স্টেপ, রেজিস্টার/মেমরি অ্যাক্সেস) কিন্তু কম পিন ব্যবহার করে, যা ছোট, পিন-সীমিত মাইক্রোকন্ট্রোলার প্যাকেজের জন্য সুবিধাজনক — আজকাল বেশিরভাগ ARM Cortex-M-ভিত্তিক বোর্ডে (L04-এর পরিচিত পরিবার) SWD-ই প্রধান ডিবাগ ইন্টারফেস হিসেবে ব্যবহৃত হয়।

৩ · লজিক অ্যানালাইজার ও অসিলোস্কোপ

JTAG/SWD প্রোগ্রামের যুক্তিগত অবস্থা (রেজিস্টার, মেমরি, ইনস্ট্রাকশন) দেখায় — কিন্তু কখনো কখনো সমস্যা থাকে ইলেকট্রিক্যাল স্তরে, যেমন একটি GPIO পিনের প্রকৃত টাইমিং প্রত্যাশিত মতো হচ্ছে কিনা, বা একটি UART লাইনে (M6-এ বিস্তারিত আসবে) সঠিক বিট-প্যাটার্ন পাঠানো হচ্ছে কিনা। এখানেই একটি লজিক অ্যানালাইজার (একাধিক ডিজিটাল পিনের HIGH/LOW অবস্থা সময়ের সাথে রেকর্ড করে) বা অসিলোস্কোপ (একটি পিনের প্রকৃত অ্যানালগ ভোল্টেজ ওয়েভফর্ম দেখায়, ডিজিটাল সিগন্যালের রাইজ/ফল টাইম বা নয়েজ ধরার জন্য উপযোগী) কাজে আসে — এরা কোডের ভেতরে কোনো "রেজিস্টার" ধারণা ছাড়াই সরাসরি তারে কী ভোল্টেজ যাচ্ছে তা দেখায়।

৪ · সত্যিকারের সিমুলেশন — ব্রেকপয়েন্ট হিট ও রেজিস্টার ডাম্প

নিচের কোড সেলে L05-এর ধাঁচের একটি ছোট রেজিস্টার-ফাইল সিমুলেশন ব্যবহার করে দেখানো হয়েছে — একটি সরলীকৃত "প্রোগ্রাম" ধাপে ধাপে চলে, এবং একটি নির্দিষ্ট ইনস্ট্রাকশনে (যেন একটি JTAG/SWD ব্রেকপয়েন্ট হিট হলো) থেমে গিয়ে সেই মুহূর্তের রেজিস্টার অবস্থা ডাম্প করে দেখানো হয় — ঠিক যেমন একটি বাস্তব ডিবাগার JTAG/SWD দিয়ে চিপ থামিয়ে রেজিস্টার উইন্ডো দেখায়।

class RegisterFile:
    """একটি ছোট মাইক্রোকন্ট্রোলারের CPU রেজিস্টার-ফাইলের সরলীকৃত সিমুলেশন (L05-এর ধাঁচে)।"""
    def __init__(self):
        self.regs = {f"R{i}": 0 for i in range(8)}
        self.regs["SP"] = 0x20010000   # স্ট্যাক পয়েন্টার -- SRAM-এর উপরের দিকে শুরু (L06/L12-এর মেমরি ম্যাপের ধাঁচে)
        self.regs["PC"] = 0            # প্রোগ্রাম কাউন্টার

    def dump(self, label):
        print(f"--- {label} ---")
        for name in ["R0", "R1", "R2", "R3", "R4", "R5", "R6", "R7", "SP", "PC"]:
            print(f"  {name:3s} = 0x{self.regs[name]:08X}")

# একটি সরলীকৃত "প্রোগ্রাম" -- প্রতিটি এন্ট্রি একটি (রেজিস্টার, নতুন মান) পরিবর্তন প্রতিনিধিত্ব করে
program = [
    ("R0", 5),
    ("R1", 10),
    ("R2", 15),   # <- এই ইনস্ট্রাকশনের ঠিক পরে একটি ব্রেকপয়েন্ট বসানো হয়েছে
    ("R0", 20),
    ("R3", 99),
]

BREAKPOINT_INDEX = 2   # ডিবাগারে ইনস্ট্রাকশন #2 ("R2 = 15") এক্সিকিউট হওয়ার পরে থামার জন্য সেট করা

rf = RegisterFile()
print("প্রোগ্রাম রান শুরু (হোস্ট PC থেকে JTAG/SWD-এর মাধ্যমে চিপ নিয়ন্ত্রণ করা হচ্ছে)...")
for i, (reg, value) in enumerate(program):
    rf.regs[reg] = value
    rf.regs["PC"] += 4   # প্রতিটি ইনস্ট্রাকশন ৪ বাইট ধরে PC এগিয়ে যায় (সরলীকৃত)
    if i == BREAKPOINT_INDEX:
        print(f"\n>>> ব্রেকপয়েন্ট হিট! ইনস্ট্রাকশন #{i} ('{reg} = {value}') চালানোর পরে থামলো <<<")
        rf.dump("ব্রেকপয়েন্টে রেজিস্টার ডাম্প (ডিবাগার এই মুহূর্তে যা দেখাবে)")
        break
else:
    print("ব্রেকপয়েন্ট কখনো হিট হয়নি")

print()
print("(ব্রেকপয়েন্ট রিলিজ করলে বাকি ইনস্ট্রাকশনগুলো চলতে থাকবে...)")
for reg, value in program[BREAKPOINT_INDEX + 1:]:
    rf.regs[reg] = value
    rf.regs["PC"] += 4
rf.dump("প্রোগ্রাম শেষে চূড়ান্ত রেজিস্টার অবস্থা")