সরাসরি পর্বে যান
পর্ব ৮০ · ৮৫-এর মধ্যে · মডিউল ১৩

ক্যাপস্টোন — বাজারঘরের smart scale আর cold-storage monitor, firmware থেকে cloud

Capstone — the Bazarghar Smart Scale and Cold-Storage Monitor, from Firmware to Cloud

Taught in Bangla, this lesson is the capstone: the cold-storage monitor end to end, with nine requirements, six milestones, six acceptance tests and a 100-point rubric with must-pass gates. The reference C firmware, built with Clang for the virtual BG-M3 board, takes a median of three readings and runs an alarm state machine, watchdog, .noinit memory and WFI in 2584 bytes of flash. accept.py passes 6/6 tests, a mutant proves the tests bite, and a bridge carries telemetry to a local MQTT broker.

এই পর্বে যা শিখবেন

  • একটি এমবেডেড-IoT প্রজেক্টকে requirement, মাইলফলক আর acceptance test-এ ভাগ করা
  • কোর্সের সব টুকরো এক firmware-এ জোড়া: sensor, filter, state machine, alarm, watchdog, ঘুম আর telemetry
  • খারাপ দিনের test: spike, আটকে যাওয়া loop আর মরা sensor-এ firmware কী করে, তা চালিয়ে প্রমাণ
  • UART থেকে gateway bridge হয়ে MQTT broker আর dashboard পর্যন্ত পুরো পথ যাচাই
  • Rubric দিয়ে নিজের বা দলের কাজ মাপা, আর stretch goal দিয়ে পরের ধাপ বাছাই

১ · ক্যাপস্টোনের লক্ষ্য — বাজারঘরের ঠান্ডা ঘর, শুরু থেকে শেষ

বিয়েবাড়ির রান্নার কথা ভাবুন। বাবুর্চি আলাদা আলাদা করে পোলাও, রোস্ট আর বোরহানি রাঁধতে জানেন; কিন্তু আসল পরীক্ষা হলো পাঁচশো মানুষের জন্য সব একসাথে, সময়মতো, ঠিক স্বাদে নামানো। এই কোর্সের ৭৯টি পর্বে আপনি টুকরো টুকরো শিখেছেন: I2C, SysTick, state machine, watchdog, ঘুম, MQTT. এই ক্যাপস্টোন সব একসাথে নামানোর পরীক্ষা।

প্রজেক্টের বিষয় কোর্সের শুরু থেকে চেনা: বাজারঘর দোকানের ঠান্ডা ঘর, যেখানে মাছ-মাংস রাখা হয়। যন্ত্রটি প্রতি সেকেন্ডে তাপমাত্রা মাপবে, বিপদে সাইরেন বাজাবে, প্রতি 10 s-এ দূরের dashboard-এ খবর পাঠাবে, আর নিজে আটকে গেলে নিজেই উঠে দাঁড়াবে। সব সংখ্যা reference lab-এর README-এর “বাজারঘর devices” অংশ থেকে, কোর্সজুড়ে যেমন। এই পর্বে register আর ঠিকানা C-এর ধরনে লেখা, যেমন 0x40005400. কাজের ভিত্তি একটি লিখিত requirement-এর তালিকা; প্রতিটির পাশে লেখা কোন পর্ব তা শিখিয়েছে আর কোন test তা প্রমাণ করবে। এই সংযোগের নাম traceability.

IDRequirement (README-এর সংখ্যায়)শেখানো পর্বপ্রমাণ
R1প্রতি 1 s-এ I2C sensor 0x48 পড়া, 0.0625 °C/LSB৫১, ৬৫AT1
R2১০ ms-এর একটি spike alarm বা telemetry-তে যাবে না৬৮AT2
R3HIGH 8.00 °C-এর ওপরে, LOW 0.00 °C-এর নিচে, ৩টি পরপর; বন্ধ 0.50 … 7.50 °C-এ ৩টি পরপর৫৫AT1, AT5
R4Alarm-এ PA6 চালু আর UART-এ লেখা৩৫AT1
R5প্রতি 10 s-এ README-এর JSON-এ telemetry৪৯AT1, AT6
R6Main loop আটকালে 2 s-এর মধ্যে reset; চলমান alarm reset-এর পরেও চালু৬১AT3
R7অপেক্ষায় WFI; virtual board-এর মাপে জেগে থাকা ১%-এর কম৬০AT4
R8নিয়মের host unit test, প্রতিটি সীমাসহ৬৪AT5
R9Telemetry broker-এ QoS 1; status online/offline, retained, Last Will৭৩AT6

লক্ষ করুন, প্রতিটি requirement মাপা যায়: “দ্রুত” বা “নির্ভরযোগ্য” লেখা নেই, লেখা আছে “2 s-এর মধ্যে” আর “৩টি পরপর”। মাপা না গেলে test লেখা যায় না, আর test ছাড়া “কাজ শেষ” কথাটির কোনো মানে নেই। R3-এ চালু আর বন্ধের আলাদা সীমা, অর্থাৎ hysteresis, আর OFF, HIGH, LOW তিন অবস্থার নিয়মটি একটি finite state machine. প্রতিটি requirement-এর পাস-ফেলের শর্তকে বলে acceptance criteria; সেগুলো কোড লেখার আগে লেখা হয়, যাতে ফল দেখে শর্ত বদলানোর লোভ না থাকে। Acceptance testing-এর সাধারণ তত্ত্ব সফটওয়্যার টেস্টিং ও QA পর্ব ৪৪-এ।

সৎ সীমা: পুরো প্রজেক্ট চলে কোর্সের virtual “বাজারঘর board” BG-M3-এ, যা কোনো আসল পণ্য নয়; আসল Cortex-M chip-এর আদলে বানানো শেখার board (পর্ব ০৬)। সেখানে ১টি নির্দেশ = ১ cycle আর exception-এ ঢোকার খরচ শূন্য (Spec decision 17), UART-এর baud-এর সময় মাপা হয় না (24), I2C শুধু register-স্তরে (26). তাই এই পর্বের সময় আর শক্তির সংখ্যা মডেলের সংখ্যা; আসল chip-এর জন্য datasheet আর মাপ লাগবে। Broker শুধু 127.0.0.1-এ, পরিচয় যাচাই ছাড়া (Spec decision 37): lab-এর জন্য ঠিক, মাঠের জন্য কখনো নয়।

২ · পুরো system-এর ছবি — sensor থেকে dashboard

কোড লেখার আগে ছবি। নিচের ছবিতে বাঁয়ের বড় বাক্সটি firmware, যা board-এ চলে; ডানে আর নিচে তার বাইরের জগৎ। প্রতিটি তীর একটি interface, আর প্রতিটি interface-এ একটি test বসে। একটি পার্থক্য খেয়াল রাখুন: alarm-এর সিদ্ধান্ত নেয় device নিজে, cloud নয়। Internet বন্ধ থাকলেও সাইরেন বাজবে; এই নীতি পর্ব ৭০-এর edge-বনাম-cloud আলোচনার ফল।

ছবি ৮০.১ — ক্যাপস্টোনের system: firmware, bridge, broker আর test

সবুজ বাক্সের ভেতরের সব board-এ চলে, নীল বাক্স PC-তে; কমলা লেখা দেখায় কোন test কোন অংশ ধরে

ক্যাপস্টোনের system-এর ব্লক ডায়াগ্রাম তাপমাত্রার sensor I2C 0x48 · 1/16 °C BG-M3 firmware · cold_cap.c 980/990/1000 ms-এ ৩টি পড়া → median3 cr_step: OFF · HIGH · LOW (৩টি, hysteresis) PA6 · UART TELEMETRY/10 s IWDG 2000 ms .noinit keep SysTick 10 ms WFI ঘুম Flash 2584 byte · static RAM 28 byte AT1 · AT2 · AT3 · AT4 UART লাইন Gateway bridge (gateway-1, Python) MQTT, QoS 1 Broker amqtt · শুধু 127.0.0.1 Dashboard (paho) · AT6 Host PC: test_cr.exe (cr_logic.c, AT5) accept.py: AT1 থেকে AT6 এক কমান্ডে

ছবির দুটি সিদ্ধান্ত আলাদা করে বলা দরকার। প্রথমত, board-এ কোনো radio নেই, তাই device আর gateway-এর মাঝের wireless link-এর জায়গায় UART লাইন; আসল যন্ত্রে এটি Wi-Fi, BLE বা LoRa হতে পারত (পর্ব ৭১, ৭২)। দ্বিতীয়ত, firmware-এর নিয়মের অংশ (cr_logic.c) register ছোঁয় না, তাই একই ফাইল PC-তে test হয় (host testing) আর board-এ চলে। পর্ব ৬৪-এর “পাতলা দেয়াল” এখানে প্রজেক্টের কাঠামো।

৩ · ছয়টি মাইলফলক — প্রতিটির শেষে চলমান কিছু

বড় কাজ একবারে লিখে শেষে চালালে ভুল কোথায়, খুঁজে পাওয়া যায় না। তাই কাজটি ছয়টি মাইলফলক-এ ভাগ করা। প্রতিটির শেষে board-এ এমন কিছু চলে, যা দেখানো যায়, আর প্রতিটির নিজস্ব প্রমাণ আছে। পদ্মা সেতুর মতো বড় নির্মাণও একবারে হয়নি: পিলারের পর পিলার, স্প্যানের পর স্প্যান, প্রতিটির আলাদা পরীক্ষা। নিচের stepper-এ প্রতিটি মাইলফলকের কাজ আর lab-এর আসল প্রমাণ-লাইন:

  1. M1bootbuild, UART
  2. M2median3sensor, filter
  3. M3cr_stepনিয়ম, host test
  4. M4PA6alarm, telemetry
  5. M5IWDGwatchdog, ঘুম
  6. M6MQTTbridge, AT
M1 · board-এ প্রথম কথা-Werror build
board.py build cold_cap.c
  cr_logic.c → built
[0.0626 ms] UART: cold-room
monitor (capstone) boot #1,
reset cause: POWER-ON
M2 · sensor আর filterspike.json
2995 ms > +30.00 C
[3000.1389] spike rejected
[3000.1675] t=3 s
            T=+4.00 C
M3 · নিয়ম আলাদা ফাইলেhost PC
$ ./test_cr.exe
ok   band_edges_clear
ok   low_alarm
...
15 checks, 0 failed
M4 · alarm আর telemetrycoldroom.json
[7000.1585] GPIO PA6
            ALARM ON
[10000.2304] TELEMETRY
 {"seq":1,"temp_c":7.00,
  "alarm":"HIGH"}
M5 · watchdog আর ঘুমwdt.json
[6000.1599] RESET
   (watchdog timeout)
[6000.2535] alarm restored
   after reset: HIGH
awake 0.0242 %
M6 · পুরো পথaccept.py
dashboard <- status online
dashboard <- temp seq 1, 2
dashboard <- status offline
6/6 acceptance tests passed
  1. M1 · board-এ প্রথম কথা: Reference lab-এর startup, linker script আর bglib.c নিয়ে একটি ফাঁকা firmware, যা -Wall -Wextra -Werror-এ build হয়, UART-এ boot-এর লাইন আর reset-এর কারণ ছাপে। ছোট মনে হলেও এটিই ভিত: toolchain, memory map আর UART একসাথে কাজ করছে, যা পর্ব ৩৭-এর বিষয়।
  2. M2 · sensor আর filter: I2C-ধাঁচের bus-এ 0x48 থেকে প্রতি সেকেন্ডে তিনটি পড়া, 10 ms ফাঁকে (980, 990, 1000 ms), আর তাদের median. প্রমাণ: 3000 ms-এর পড়ায় 30.00 °C-এর spike ঢোকানো হলেও ছাপা হয় +4.00 °C.
  3. M3 · নিয়ম আলাদা ফাইলে: cr_logic.c-এ median3 আর cr_step, register ছাড়া। Host PC-তে ৬টি test-এ ১৫টি যাচাই, প্রতিটি সীমাসহ: 8.00, 7.75, 7.50, 0.50, 0.00 °C.
  4. M4 · alarm আর telemetry: নিয়মের ফল PA6-এ (BSRR/BRR-এ একটি লেখা) আর UART-এ। README-এর পুরো script চালালে alarm 7 s-এ HIGH, 12 s-এ OFF, 17 s-এ LOW, আর 10 s ও 20 s-এ telemetry, reference-এর মতোই।
  5. M5 · watchdog আর ঘুম: IWDG 2000 ms, kick শুধু একটি পুরো sample শেষ হলে; alarm-এর অবস্থা .noinit-এ। আটকে যাওয়া loop 6000.16 ms-এ reset পায়, আর alarm ফিরে আসে। অপেক্ষার সময় WFI, তাই CPU জেগে থাকে 0.0242% সময়।
  6. M6 · পুরো পথ: Python bridge UART-এর TELEMETRY লাইন MQTT-তে পাঠায়, dashboard চারটি বার্তা পায়: online, দুটি telemetry, আর gateway হারালে Last Will-এর offline. শেষে এক কমান্ডে ৬টি acceptance test.

ক্রমটি ইচ্ছাকৃত। M3 (host test) আসে M4 (alarm)-এর আগে, কারণ নিয়মটি board ছাড়াই পরীক্ষা করা সস্তা। M5 আসে শেষের দিকে, কারণ watchdog চালু করলে debugging কঠিন হয়: breakpoint-এ থামলেই reset (পর্ব ৬১)। আর M6-এর আগে firmware-এর সব test সবুজ থাকা চাই, নইলে network-এর ভুল আর firmware-এর ভুল মিশে যায়।

৪ · Reference solution — মূল অংশগুলো

নিচে reference solution-এর মূল অংশ, পুরো কোড নয়। পুরো কোড দেওয়া হলো না ইচ্ছা করেই: ক্যাপস্টোনের মূল্য নিজে জোড়া লাগানোয়। ফাইল তিনটি: cr_logic.c (নিয়ম, ২৮ লাইন), cold_cap.c (board-এর অংশ) আর lab-এর accept.py. এই পাতার সব আউটপুট কোর্সের reference lab-এর virtual board থেকে; আপনি নিজের প্রকল্প বানাবেন পর্ব ০৬-এর কোনো free tool বা একটি আসল board-এ, তাই সময়ের দশমিক অঙ্ক মিলবে না, কিন্তু মান, alarm-এর ক্রম আর acceptance test-এর রায় মেলাতে হবে। প্রথমে main loop-এর হৃৎপিণ্ড, অর্থাৎ পড়ার সময়সূচি, filter, নিয়ম আর kick:

uint32_t n = 0, k = 0, next = SAMPLE_TICKS;   /* tick = 10 ms */
int32_t sub[3];
while (n < RUN_SAMPLES) {
    poll_uart();                              /* test hook: "hang", "stop" */
    if (ticks < next - 2u + k) {              /* পড়া: next-2, next-1, next */
        __WFI();                              /* বাকি সময় ঘুম */
        continue;
    }
    if (tsens_read(&sub[k]) != 0) {           /* I2C NACK */
        uart_puts("sensor NACK\r\n");
        k = 0;
        next += SAMPLE_TICKS;
        continue;                             /* kick নেই: অনুশীলন ১ দেখুন */
    }
    if (++k < 3u)
        continue;
    k = 0;
    next += SAMPLE_TICKS;
    n++;
    int32_t t16 = median3(sub[0], sub[1], sub[2]);
    put_line_temp(n, t16);
    enum alarm before = c.state;
    enum alarm now = cr_step(&c, t16);        /* README-এর নিয়ম */
    if (now != before) {
        alarm_out(now);                       /* BSRR বা BRR-এ একটি লেখা */
        keep.alarm = now;                     /* .noinit-এ মনে রাখা */
        /* ... "ALARM ON: HIGH temperature" বা "ALARM OFF" ছাপা ... */
    }
    if (n % TELEMETRY_EVERY == 0u)
        put_telemetry(n / TELEMETRY_EVERY, t16, now);
    IWDG->KR = 0xAAAAu;                       /* check-in: একটি পুরো sample শেষ */
}

তিনটি বিষয় খেয়াল করুন। প্রথমত, super loop নিজে অপেক্ষা করে না; SysTick প্রতি 10 ms-এ ticks বাড়ায় আর loop শুধু তুলনা করে, মাঝে WFI-তে ঘুমায়; অল্প জেগে কাজ, তারপর লম্বা ঘুমের এই ছন্দই duty cycling (পর্ব ৫৫, ৬০)। ticks ISR আর main দুজনেই ছোঁয়, তাই volatile (পর্ব ৩৪)। দ্বিতীয়ত, median filter তিনটি পড়ার মাঝেরটি নেয়, তাই একটি outlier পুরো বাদ পড়ে; গড় নিলে সেটি তিন ভাগে ছড়িয়ে থেকে যেত (পর্ব ৬৮)। তৃতীয়ত, kick loop-এর একেবারে শেষে: একটি পুরো sample (তিনটি পড়া, নিয়ম, ছাপা) শেষ হলে তবেই। এটি task check-in-এর সবচেয়ে সরল রূপ।

দ্বিতীয় অংশ reset-এর পরে ফিরে আসা। Watchdog reset হলে startup code .bss শূন্য করে, তাই alarm-এর অবস্থা হারায়, আর GPIO reset-এ PA6 নিভে যায়। অথচ ঘর তখনো গরম! সমাধান .noinit section-এ একটি ছোট struct, যা startup ছোঁয় না (পর্ব ৩২):

typedef struct { uint32_t magic, boots, alarm; } keep_t;
__attribute__((section(".noinit"))) static volatile keep_t keep;

uint32_t csr = RCC->CSR;                      /* reset-এর কারণ */
RCC->CSR = RCC_CSR_RMVF;                      /* flag মোছা */
if (keep.magic != KEEP_MAGIC) {               /* প্রথম power-on: SRAM-এ আবর্জনা */
    keep.magic = KEEP_MAGIC;
    keep.boots = 0;
    keep.alarm = ALARM_OFF;
}
keep.boots++;
/* ... */
cr_t c = { 0, 0, 0, ALARM_OFF };
if ((csr & RCC_CSR_IWDGRSTF) && keep.alarm <= ALARM_LOW
                             && keep.alarm != ALARM_OFF) {
    c.state = (enum alarm)keep.alarm;         /* চলমান alarm চুপ করানো নয় */
    alarm_out(c.state);
    uart_puts("alarm restored after reset: ");
    /* ... */
}

keep volatile, কারণ এর মান program-এর অজান্তে টিকে থাকে আর compiler-কে প্রতিটি লেখা সত্যিই করতে হবে। Magic সংখ্যাটি প্রথম power-on আলাদা করে, আর keep.alarm <= ALARM_LOW যাচাই নিশ্চিত করে যে নষ্ট মান enum-এ ঢুকবে না। Reset cause শুধু watchdog হলে পুরোনো alarm ফেরে; power-on-এ নতুন করে শুরু। এর তাত্ত্বিক আলোচনা, বিশেষ করে .noinit-এর ফাঁদ, পর্ব ৬১-এ।

শেষে খরচ। Linker-এর map file থেকে (পর্ব ৩৭), reference lab-এর সাধারণ coldroom.c-এর পাশে:

Sectioncoldroom.c (reference)cold_cap.c (ক্যাপস্টোন)
.isr_vector + .text (flash)0x60 + 0x6d8 = 1848 byte0x60 + 0x9b8 = 2584 byte
.bss (RAM)4 byte16 byte (ticks, cmd, cmd_len)
.noinit (RAM)0 byte12 byte (keep)

সত্যিকারের run (Clang 22.1.8 via ziglang 0.17.1, ld.lld-এর -Map). Watchdog, filter, reset-এর পরে ফেরা আর UART-এর নির্দেশ মিলিয়ে বাড়তি মাত্র 736 byte flash; 128 KiB-এর board-এ নগণ্য, কিন্তু 16 KiB-এর ছোট chip-এ এমন হিসাবই সিদ্ধান্ত বদলায়। Stack-এর মাপ map file বলে না; তার জন্য পর্ব ৩৯-এর পদ্ধতি।

৫ · Acceptance test — শর্ত আগে, run পরে

Acceptance test প্রশ্ন করে: “যা চাওয়া হয়েছিল, তা কি হয়েছে?” Unit test একটি function দেখে; acceptance test পুরো যন্ত্রকে বাইরে থেকে দেখে, যেমন দোকানের মালিক দেখবেন। ক্যাপস্টোনের ছয়টি test, প্রতিটির শর্ত আগে থেকে লেখা:

Testকী চালায়পাসের শর্ত
AT1README-এর coldroom.jsont=, ALARM, TELEMETRY আর PA6-এর সব লাইন README-এর expected file-এর সঙ্গে পূর্ণ ms-এ মেলে
AT2spike.json: দুটি 10 ms-এর 30.00 °C, পরে আসল 9.00 °C২টি “spike rejected”, telemetry-তে 4.00, 15 s-এ HIGH
AT3wdt.json: HIGH-এর মাঝে “hang”6000 ms-এ reset, boot #2, alarm ফিরে আসে, 12 s-এ OFF
AT4README script, নির্দেশ গোনাজেগে থাকা ১%-এর কম
AT5Host-এ test_cr.exe“0 failed”
AT6Board-এর UART → bridge → broker → dashboardonline, দুটি telemetry হুবহু, Last Will-এর offline

AT2 আর AT3-এর script-এ UART দিয়ে পাঠানো hang আর stop নির্দেশ দুটি test hook: ইচ্ছা করে ভুল ঘটানোর দরজা, যাকে বলে fault injection. Board-এর script sensor-কে ভাঙতে পারে না (Spec decision 26), কিন্তু loop আটকানো firmware নিজেই পারে। বিক্রির firmware-এ এই দরজা থাকা চলবে না; ভাবনার প্রশ্ন ৫ দেখুন। এক কমান্ডে সব test:

~/lab/capstone $ python -B accept.py --show 6
AT1 regression vs README   PASS  28/28 README lines match (t=, ALARM, TELEMETRY, PA6)
AT2 spike filter           PASS  2 spikes rejected, telemetry 4.00, HIGH at 15 s
AT3 watchdog recovery      PASS  reset at 6000 ms, boot #2, alarm restored, OFF at 12 s
AT4 low power (WFI)        PASS  awake 38695 of 160001859 cycles = 0.0242 % (limit 1 %)
AT5 host unit tests        PASS  host: 15 checks, 0 failed
AT6 UART-bridge-MQTT       PASS  dashboard got 4 messages: online, 2 telemetry, offline (Last Will)
    dashboard <- status online
    dashboard <- temp {"dev":"coldroom-1","seq":1,"temp_c":7.00,"alarm":"HIGH"}
    dashboard <- temp {"dev":"coldroom-1","seq":2,"temp_c":-0.50,"alarm":"LOW"}
    dashboard <- status offline
6/6 acceptance tests passed

সত্যিকারের run — Python 3.13.5; board.py (BG-M3, virtual; unicorn 2.1.4, Clang 22.1.8); amqtt 0.12.2 + paho-mqtt 2.2.0, শুধু 127.0.0.1, port চলার সময় বাছা আর কোথাও ছাপা হয় না। accept.py reference lab-এর board.py আর mqtt_demo.py-এর অপরিবর্তিত কপি library হিসেবে ব্যবহার করে। প্রতিটি লাইন ধরে:

accept.py: কী চলল, কী মেলানো হলো
test
ইনপুট
মাপা হলো
ফল
  1. AT1 · regression: README-এর script চালিয়ে শুধু README-এ সংজ্ঞায়িত লাইন রাখা হয়: ২০টি t=, ৩টি ALARM, ২টি TELEMETRY আর ৩টি PA6, মোট ২৮। সময় কাটা হয় পূর্ণ ms-এ, কারণ ms-এর ভগ্নাংশ compiler আর কোডের ওপর নির্ভর করে (Spec decision 30): reference-এ 7000.0387, ক্যাপস্টোনে 7000.1585, কাটার পরে দুটিই “7000 ms” হয়ে যায়।
  2. AT2 · spike: 2995–3005 ms আর 9995–10005 ms-এ 30.00 °C. প্রতিবার শুধু 1000 ms-এর পড়াটি নষ্ট, median তাকে ফেলে দেয়। Telemetry-তে 4.00, আর 12.5 s থেকে আসল 9.00 °C-এ alarm 15 s-এ, ৩টি পরপর reading-এর পরে।
  3. AT3 · watchdog: 3 s-এ HIGH, 4.5 s-এ “hang”. শেষ kick 4000.16 ms-এ, তাই reset ঠিক 2000 ms পরে, 6000.16 ms-এ। Boot #2 কারণ পড়ে WATCHDOG, .noinit থেকে HIGH ফেরায়, আর 7.00 °C-এর ৩টি reading-এর পরে 12 s-এ OFF.
  4. AT4 · ঘুম: একই README script, কিন্তু board-এর একটি subclass প্রতিটি সত্যিই চলা নির্দেশ গোনে। 20 s-এ 160 001 859 cycle-এর মধ্যে চলেছে 38 695টি নির্দেশ, বাকি সময় WFI. মনে রাখুন, এটি মডেলের সংখ্যা: Spec decision 17 অনুযায়ী এখানে ১ নির্দেশ = ১ cycle ধরা হয়, আসল chip-এ নয়।
  5. AT5 · host: একই cr_logic.c PC-র Clang-এ compile করে নিজের ছোট test harness-এ ৬টি test, ১৫টি যাচাই, boundary value analysis মেনে: median-এর দুই দিকের spike, 8.00 ঠিক সীমায় alarm নয়, 7.75-এ বন্ধ নয়, 7.50 আর 0.50-এ বন্ধ, 0.00 ঠিক সীমায় LOW নয়।
  6. AT6 · পুরো পথ: Board-এর দুটি TELEMETRY লাইন bridge QoS 1-এ পাঠায়, প্রতিটির PUBACK অপেক্ষা করে। Dashboard-এর পাওয়া payload firmware-এর লেখার সঙ্গে অক্ষরে অক্ষরে মেলানো হয়। শেষে bridge-এর socket DISCONNECT ছাড়া বন্ধ, broker ছাপে Last Will.
  7. সারাংশ: ৬টির ৬টি পাস, exit code 0. এই একটি কমান্ডই CI-এর কাজ: প্রতিটি কোড বদলের পরে চলে, আর 1 মানে “এখানে থামুন” (সফটওয়্যার টেস্টিং ও QA পর্ব ৬৪)।

AT1-এর তুলনার নিয়মটি ছোট হলেও সূক্ষ্ম, আর এটিই regression test-এর প্রাণ। Expected file (golden file) README থেকে আসে, নিজের firmware-এর output থেকে নয়। নিচের block একই নিয়মে দুটি run মেলায়: ক্যাপস্টোনের আসল লাইন, আর CONFIRM 3 থেকে 4 করা একটি mutant-এর আসল লাইন (দুটিই lab-এর board run থেকে কপি করা)।

# accept.py-র তুলনার নিয়ম: README-এর লাইন রাখা, সময় পূর্ণ ms-এ কাটা (Spec decision 30)
import re
KEEP = re.compile(r"^\[\s*(\d+)\.\d+ ms\] (UART: (t=|ALARM|TELEMETRY)|GPIO PA6)")

def normalise(lines):
    out = []
    for line in lines:
        m = KEEP.match(line)
        if m:
            out.append(m.group(1) + " ms " + line.split("] ", 1)[1])
    return out

expected = ["[  6000.0352 ms] UART: t=6 s T=+9.00 C",          # README-এর coldroom.txt
            "[  7000.0352 ms] UART: t=7 s T=+9.50 C",
            "[  7000.0387 ms] GPIO PA6 ALARM ON",
            "[  7000.0634 ms] UART: ALARM ON: HIGH temperature"]
runs = {
    "cold_cap.elf": ["[     0.0626 ms] UART: cold-room monitor (capstone) boot #1, reset cause: POWER-ON",
                     "[  6000.1547 ms] UART: t=6 s T=+9.00 C",
                     "[  7000.1547 ms] UART: t=7 s T=+9.50 C",
                     "[  7000.1585 ms] GPIO PA6 ALARM ON",
                     "[  7000.1834 ms] UART: ALARM ON: HIGH temperature"],
    "cold_mut.elf (CONFIRM 4)": ["[  6000.1547 ms] UART: t=6 s T=+9.00 C",
                                 "[  7000.1547 ms] UART: t=7 s T=+9.50 C",
                                 "[  8000.1547 ms] UART: t=8 s T=+9.50 C",
                                 "[  8000.1585 ms] GPIO PA6 ALARM ON"],
}
want = normalise(expected)
for name, lines in runs.items():
    got = normalise(lines)
    diff = [(i + 1, w, g) for i, (w, g) in enumerate(zip(want, got)) if w != g]
    print(f"{name}: {'PASS' if got == want else 'FAIL'} ({len(got)} lines kept)")
    for i, w, g in diff[:1]:
        print(f"  line {i}: expected '{w}'")
        print(f"          got      '{g}'")

আসল আউটপুট (ব্রাউজারের Python):

cold_cap.elf: PASS (4 lines kept)
cold_mut.elf (CONFIRM 4): FAIL (4 lines kept)
  line 3: expected '7000 ms GPIO PA6 ALARM ON'
          got      '8000 ms UART: t=8 s T=+9.50 C'

ক্যাপস্টোনের boot-এর লাইনটি README-এ নেই, তাই নিয়ম তাকে বাদ দেয়; বাকি চারটি লাইনের ms-এর ভগ্নাংশ আলাদা হলেও পাস। Mutant-এ alarm এক সেকেন্ড দেরিতে, তাই তৃতীয় লাইনেই অমিল। Lab-এর পুরো run-এ একই mutant AT1-এ 19/28 আর host test-এ 15 checks, 4 failed দিয়েছে। ইচ্ছা করে ভুল ঢুকিয়ে test-এর শক্তি মাপার এই কৌশল mutation testing (সফটওয়্যার টেস্টিং ও QA পর্ব ৫৯): যে test কোনো mutant ধরে না, সে আসলে কিছু পাহারা দেয় না।

৬ · খারাপ দিনের test — spike আর আটকে যাওয়া loop

সুন্দর দিনে যেকোনো firmware চলে। ক্যাপস্টোনের আসল প্রশ্ন খারাপ দিনের: সাইরেনের পাশে কেউ মোটর চালু করলে I2C-এর তারে ঝাঁকি লাগে, একটি পড়া নষ্ট হয়; কোনো বিরল ভুলে main loop আটকে যায়। প্রথমটির জন্য AT2. Reference lab-এর সাধারণ coldroom.c (প্রতি সেকেন্ডে একটি পড়া) আর ক্যাপস্টোন একই spike.json-এ:

coldroom.c (একটি পড়া)                          cold_cap.c (median of 3)
[  3000.0374 ms] UART: t=3 s T=+30.00 C        [  3000.1389 ms] UART: spike rejected
                                               [  3000.1675 ms] UART: t=3 s T=+4.00 C
[ 10000.1140 ms] UART: TELEMETRY {...          [ 10000.2421 ms] UART: TELEMETRY {...
   "temp_c":30.00,"alarm":"OFF"}                  "temp_c":4.00,"alarm":"OFF"}

সত্যিকারের run (board.py, দুটি firmware একই script-এ; বাছাই করা লাইন)। Alarm-এর দিক থেকে reference-ও নিরাপদ, কারণ একটি reading “৩টি পরপর” শর্ত পূরণ করে না। কিন্তু 10 s-এর spike ঠিক telemetry-র sample-এ পড়েছে, তাই dashboard-এ গেছে 30.00 °C: দূরের ম্যানেজার ভাববেন ঘর গরম, অথচ ঘর 4.00 °C-এ। নিচের block একই ঘটনা ব্রাউজারে, cr_logic.c-এর Python রূপে:

# spike.json-এর ১৫ সেকেন্ড: প্রতি সেকেন্ডে 980, 990, 1000 ms-এর তিনটি পড়া (t16 = °C × 16)
def median3(a, b, c):                     # cr_logic.c-এর median3
    if a > b:
        a, b = b, a
    return max(a, min(b, c))

def step(c, t):                           # README-এর alarm নিয়ম (cr_step)
    c["hi"] = c["hi"] + 1 if t > 128 else 0
    c["lo"] = c["lo"] + 1 if t < 0 else 0
    c["ok"] = c["ok"] + 1 if 8 <= t <= 120 else 0
    if c["hi"] >= 3: c["st"] = "HIGH"
    elif c["lo"] >= 3: c["st"] = "LOW"
    elif c["st"] != "OFF" and c["ok"] >= 3: c["st"] = "OFF"
    return c["st"]

subs = {s: (64, 64, 64) for s in range(1, 16)}       # 4.00 °C
subs[3] = subs[10] = (64, 64, 480)                   # 1000 ms-এর পড়ায় 30.00 °C
for s in (13, 14, 15):
    subs[s] = (144, 144, 144)                        # 9.00 °C

for name, pick in (("one read (coldroom.c)", lambda r: r[2]),
                   ("median of 3 (cold_cap.c)", lambda r: median3(*r))):
    c = {"hi": 0, "lo": 0, "ok": 0, "st": "OFF"}
    print(name)
    for s in range(1, 16):
        t = pick(subs[s])
        before = c["st"]
        now = step(c, t)
        if t not in (64, 144):
            print(f"  {s:2} s: reading {t * 25 // 4 / 100:.2f} C")
        if now != before:
            print(f"  {s:2} s: ALARM {now}")
        if s % 10 == 0:
            print(f"  {s:2} s: TELEMETRY temp_c {t * 25 // 4 / 100:.2f}, alarm {now}")

আসল আউটপুট (ব্রাউজারের Python):

one read (coldroom.c)
   3 s: reading 30.00 C
  10 s: reading 30.00 C
  10 s: TELEMETRY temp_c 30.00, alarm OFF
  15 s: ALARM HIGH
median of 3 (cold_cap.c)
  10 s: TELEMETRY temp_c 4.00, alarm OFF
  15 s: ALARM HIGH

Board-এর দুই run-এর সঙ্গে হুবহু এক ছবি: একক পড়ায় দুটি 30.00 আর ভুল telemetry; median-এ কোনোটিই নেই, অথচ আসল গরম (9.00 °C) একই 15 s-এ alarm দেয়, দেরি ছাড়া। Median-এর দাম: প্রতি sample-এ তিনটি পড়া, তাই জেগে থাকার নির্দেশ 27 867 থেকে 38 695 (একই README script, একই গোনা)। আর সীমা: পরপর দুটি পড়া নষ্ট হলে তিনটির median-ও নষ্ট।

দ্বিতীয় খারাপ দিন, আটকে যাওয়া loop. AT3-এর script-এ ঘর 9.50 °C-এ, তাই 3 s-এ HIGH alarm বাজছে; 4.5 s-এ hang loop আটকায়। একটি অযত্নের firmware এখানে দুবার ব্যর্থ হতো: আটকে থাকত, অথবা reset-এর পরে চুপ করে যেত। ক্যাপস্টোনের IWDG আর .noinit কী করে, ধাপে ধাপে:

Board-এর সময়রেখা (সত্যিকারের run)
সময়
ঘটনা
PA6
IWDG বাকি
keep
  1. Alarm বাজছে: 9.50 °C-এর ৩টি reading (1, 2, 3 s)-এর পরে HIGH: PA6 ON, আর keep.alarm = HIGH, .noinit-এ। প্রতিটি sample শেষে kick, তাই watchdog-এর counter আবার পূর্ণ।
  2. শেষ kick: t=4 s-এর sample শেষে 4000.16 ms-এ kick. এরপর আর কোনো kick আসবে না; counter-এর হাতে 2000 ms.
  3. Loop আটকাল: 4.5 s-এ UART-এ “hang”: for (;;) { }. SysTick-এর ISR তখনো চলছে, ticks বাড়ছে, কিন্তু main আর sample নেয় না, kick-ও দেয় না। এখানেই অন্ধ kick আর check-in-এর পার্থক্য (অনুশীলন ২)।
  4. Reset: শেষ kick-এর ঠিক 2000 ms পরে, 6000.16 ms-এ watchdog board reset করে। Peripheral reset-এ PA6 নিভে যায়। কিন্তু SRAM টিকে থাকে (Spec decision 18), তাই keep অক্ষত।
  5. নতুন boot: RCC->CSR-এ IWDGRSTF, তাই কারণ WATCHDOG; magic মেলে, boots 2. Watchdog এখনো চালু হয়নি; reset-এ সেটিও থেমেছে, firmware 6000.31 ms-এ আবার চালু করে।
  6. Alarm ফিরে এল: keep.alarm = HIGH আর কারণ watchdog, তাই state HIGH. PA6 আবার ON হয় 6000.22 ms-এ, reset-এর মাত্র 0.06 ms পরে, আর 6000.25 ms-এ UART-এ খবর। সাইরেন প্রায় এক মুহূর্তও থামেনি।
  7. স্বাভাবিক বন্ধ: 9.5 s থেকে 7.00 °C. নতুন boot-এর t=4, 5, 6 s (board-এর 10, 11, 12 s)-এর ৩টি reading 0.50–7.50-এর মধ্যে, তাই 12000.36 ms-এ OFF, আর keep.alarm = OFF.

দামটিও লক্ষ করুন: 4 s-এর পরের reading আসে 7 s-এ (নতুন boot-এর t=1), অর্থাৎ ২টি reading হারাল। Timeout ছোট করলে ক্ষতি কমে, কিন্তু নিচে নামার সীমা আছে: সবচেয়ে লম্বা স্বাভাবিক kick-এর ফাঁক 1 s, আর আসল chip-এ watchdog-এর oscillator-এর সহনশীলতা (অনুশীলন ৩)। আরেকটি লক্ষণীয় বিষয়: নতুন boot-এ t= আর telemetry-র seq আবার 1 থেকে গোনে। Dashboard-কে তাই boot বদল চিনতে হবে, নইলে একই seq দুবার দেখে বিভ্রান্ত হবে; এটি একটি stretch goal.

৭ · UART থেকে dashboard — bridge আর MQTT

M6-এর কাজ firmware-এর লেখা লাইনকে network-এর বার্তায় বদলানো। এই অনুবাদকই gateway; ক্যাপস্টোনে এটি PC-র একটি ছোট Python bridge. Device নিজে কোনো MQTT broker চেনে না, শুধু UART-এ লেখে; bridge সেই লাইন পড়ে telemetry topic-এ পাঠায়। accept.py-এর AT6-এর মূল অংশ:

md.patch_amqtt()                       # Spec decision 37-এর দুটি সংশোধন
port = md.free_port()                  # শুধু 127.0.0.1, port ছাপা হয় না
broker = md.BrokerThread(port)
broker.start()
dash = md.Client("dashboard", port, sink.append)
gw = md.Client("gateway-1", port, sink.append,
               will=(md.TOPIC_STATUS, "offline", 1, True))   # Last Will
dash.connect()
dash.subscribe("bazarghar/coldroom/#", 1)
gw.connect()
gw.c.publish(md.TOPIC_STATUS, "online", qos=1, retain=True)
for i, p in enumerate(tel):            # bridge: প্রতিটি TELEMETRY লাইন
    gw.c.publish(md.TOPIC_TEMP, p, qos=1)
    gw.wait_log(r"^Received PUBACK", i + 2)
gw.c.loop_stop()
gw.c.socket().close()                  # gateway হারাল, DISCONNECT ছাড়া
dash.wait(lambda: len(dash.messages) >= 2 + len(tel), "last will")

এখানে md reference lab-এর mqtt_demo.py-এর অপরিবর্তিত কপি, আর tel board-এর run থেকে নেওয়া দুটি TELEMETRY লাইনের JSON অংশ। নকশার তিনটি সিদ্ধান্ত: telemetry QoS 1-এ, কারণ PUBACK জানায় বার্তা broker-এ পৌঁছেছে; status topic-এ retained “online”, যাতে পরে আসা যেকোনো app শেষ অবস্থা সঙ্গে সঙ্গে পায়; আর Last Will “offline”, যাতে gateway হঠাৎ হারালে broker নিজেই সবাইকে জানায়। Run-এ dashboard ঠিক এই ক্রমে চারটি বার্তা পেয়েছে (অংশ ৫-এর আউটপুট), আর দুটি telemetry-র payload board-এর UART লাইনের সঙ্গে অক্ষরে অক্ষরে এক। প্রতিটি সিদ্ধান্তের তত্ত্ব পর্ব ৭৩-এ; gateway-এর store-and-forward, অর্থাৎ link ছিঁড়লে জমিয়ে রাখা, পর্ব ৭০-এ।

আরও গভীরে: ক্যাপস্টোনের মূল কৌশল, অর্থাৎ watchdog-এর reset-এর পরে জরুরি অবস্থা মনে রেখে কাজে ফেরা, মহাকাশযানের software-এ পুরোনো। Apollo Guidance Computer-এর software-এ “restart protection” ছিল বলে MIT-এর নথিতে বর্ণিত: গুরুত্বপূর্ণ কাজগুলো নিজের অগ্রগতির চিহ্ন এমন memory-তে রাখত যা restart-এ মোছে না, ফলে restart-এর পরে সেখান থেকেই আবার শুরু হতো। ১৯৬৯-এর চাঁদে নামার সময় 1201 আর 1202 alarm-এ এই restart বারবার ঘটেছিল বলে বহুল বর্ণিত, আর অবতরণ চলতে থাকে। আধুনিক MCU-তে একই ধারণার রূপ .noinit RAM, backup register আর “retained” memory.

৮ · দ্বিতীয় ট্র্যাক আর stretch goal

যাঁরা ওজনের যন্ত্র পছন্দ করেন, তাঁদের জন্য একই কাঠামোয় দ্বিতীয় ট্র্যাক: বাজারঘরের smart scale. README-এর সংখ্যা: খালি পাল্লা 400 count, 2000 g-এ 1800 count, ক্ষমতা 5000 g, প্রতি 100 ms-এ চারটি পড়ার গড়, 8 ms-এর debounce-করা বোতামে tare, আলু 65.50 টাকা/kg, দাম = (net_g × 6550 + 500) / 1000 paisa (পর্ব ৪০, ৪২)। Acceptance-এর শর্ত reference lab-এর scale.c-এর আসল run থেকে, যা আমার lab-এ build করে চালানো হয়েছে আর README-এর expected file-এর সঙ্গে প্রতিটি লাইনে মিলেছে (বাছাই করা লাইন):

[   300.0978 ms] UART: raw=505 gross=150 g tare=0 g net=150 g price=9.83 Tk
[   427.0341 ms] UART: TARE set to 150 g
[   700.1125 ms] UART: raw=1380 gross=1400 g tare=150 g net=1250 g price=81.88 Tk
[   900.0529 ms] UART: OVERLOAD: gross=5100 g > 5000 g
[  1100.1043 ms] UART: raw=855 gross=650 g tare=150 g net=500 g price=32.75 Tk

সত্যিকারের run: board.py-তে scale.c আর scale.json দিয়ে চালানো। Smart scale-এর ক্যাপস্টোন একই ছয় মাইলফলকে চলে: M2-তে ADC আর গড়, M3-তে raw_to_grams আর price_paisa-এর host test (150 g → 983 paisa ঠিক অর্ধেকের rounding যাচাই করে), M4-এ display-এর লাইন, M5-এ watchdog, M6-এ bazarghar/scale/1/weight-এ QoS 1, retained. শেষটির প্রমাণ reference-এর MQTT demo থেকে, আমার lab-এ চালানো: পরে আসা phone app subscribe করামাত্র শেষ ওজন পায়, phone-app got bazarghar/scale/1/weight qos=1 retain=1 {…"net_g":1250,…"price_paisa":8188}.

যাঁরা মূল কাজ শেষ করেছেন, তাঁদের জন্য stretch goal. প্রতিটি কোর্সের একটি পর্বের দিকে নিয়ে যায়:

নিরাপদ update

নতুন firmware-এর image-এর signature যাচাই, A/B slot আর ব্যর্থ boot-এ rollback; secure boot আর OTA update-এর শৃঙ্খল পর্ব ৭৭-এ, device management-এর দিক পর্ব ৭৫-এ।

TinyML anomaly

তাপমাত্রার ধারা থেকে দরজা খোলা থাকা বা compressor-এর গোলমাল চেনা, অর্থাৎ anomaly detection, int8-এর ছোট model-এ, device-এর ওপরেই; পর্ব ৭৮-এর বিষয়।

নিরাপত্তা

Broker-এ username/password আর TLS, প্রতিটি device-এর আলাদা পরিচয়, test hook বন্ধ; threat model দিয়ে শুরু, পর্ব ৭৬।

RTOS-এ নতুন করে

Sensor, alarm আর telemetry তিনটি task, queue দিয়ে জোড়া, আর watchdog-এর supervisor; পর্ব ৫৬, ৫৮। এছাড়া boot বদলের পরে seq-এর বিভ্রান্তি দূর করা, আর পর্ব ৬২-এর মতো battery-র আয়ুর হিসাব।

৯ · মূল্যায়নের rubric — নম্বর আর “অবশ্যই পাস”

নিজের কাজ নিজে মাপতে, বা দলে একে অপরের কাজ দেখতে, একটি rubric লাগে: আগে থেকে ঠিক করা, কোন অংশে কত নম্বর আর কী দেখলে পুরো নম্বর। ক্রিকেটের DRS-এর কথা ভাবুন: আম্পায়ার কী দেখে সিদ্ধান্ত বদলাবেন, তা খেলার আগেই লেখা; তাই দুই দলই ফল মেনে নেয়। ক্যাপস্টোনের rubric ১০০ নম্বরের:

অংশনম্বরপুরো নম্বরের শর্ত
A · Acceptance40AT1 10, AT2 6, AT3 8, AT4 4, AT5 6, AT6 6: পাস হলে পুরো, না হলে 0
B · Firmware-এর মান20ISR-এর ভাগ করা ভ্যারিয়েবল volatile আর ISR ছোট (5); pin-এ BSRR/BRR (5); -Werror-এ পরিষ্কার build (5); map file থেকে flash/RAM-এর হিসাব (5)
C · Test15সব সীমার host test (5); একটি mutant ধরা পড়ার প্রমাণ (5); তুলনার নিয়ম শুধু সময় কাটে (5)
D · নকশার নথি15Traceability table (5); watchdog timeout-এর যুক্তি (5); simulator-এর সীমা সৎভাবে লেখা (5)
E · প্রদর্শন10চালানোর README (5); একটি demo log (5)

সঙ্গে দুটি “অবশ্যই পাস” শর্ত: AT1 (alarm-এর নিয়ম) আর AT3 (আটকে গেলে উদ্ধার)। এ দুটি নিরাপত্তার কাজ; মোট নম্বর যত বেশিই হোক, এর একটি ব্যর্থ হলে কাজটি “আবার জমা দিন”। কারণ সহজ: ৭৭ নম্বরের একটি যন্ত্র, যার সাইরেন আটকে গেলে আর ফেরে না, দোকানের মালিকের কাছে শূন্য। একটি কাল্পনিক জমার হিসাব, Python-এ:

# ক্যাপস্টোনের মূল্যায়ন: ১০০ নম্বর, আর দুটি "অবশ্যই পাস" শর্ত (AT1, AT3)
RUBRIC = {   # অংশ: [(বিষয়, পূর্ণ নম্বর), ...]
    "A acceptance": [("AT1", 10), ("AT2", 6), ("AT3", 8), ("AT4", 4), ("AT5", 6), ("AT6", 6)],
    "B firmware":   [("volatile/ISR", 5), ("BSRR/BRR", 5), ("-Werror build", 5), ("map file", 5)],
    "C tests":      [("boundaries", 5), ("mutant caught", 5), ("normalise", 5)],
    "D design doc": [("traceability", 5), ("WDT timeout", 5), ("sim limits", 5)],
    "E demo":       [("README", 5), ("demo log", 5)],
}
GATES = ("AT1", "AT3")          # নিরাপত্তার শর্ত: এ দুটি ব্যর্থ হলে মোট নম্বর যা-ই হোক

def score(sub):                 # sub: বিষয় -> পাওয়া নম্বর (না থাকলে পূর্ণ)
    total = 0
    for part, items in RUBRIC.items():
        got = sum(sub.get(k, full) for k, full in items)
        total += got
        print(f"{part:13} {got:3} / {sum(f for _, f in items)}")
    gates = [g for g in GATES if sub.get(g, 1) == 0]
    verdict = "accepted" if total >= 60 and not gates else "resubmit"
    print(f"total {total} / 100, failed gates {gates or 'none'} -> {verdict}")

# উদাহরণ: watchdog-এর kick SysTick ISR-এ (AT3 FAIL), mutant দেখানো হয়নি,
# timeout-এর যুক্তি অর্ধেক, map file-এর হিসাব নেই
score({"AT3": 0, "mutant caught": 0, "WDT timeout": 2, "map file": 0, "volatile/ISR": 3})

আসল আউটপুট (ব্রাউজারের Python):

A acceptance   32 / 40
B firmware     13 / 20
C tests        10 / 15
D design doc   12 / 15
E demo         10 / 10
total 77 / 100, failed gates ['AT3'] -> resubmit

৭৭ নম্বর ৬০-এর অনেক ওপরে, তবু রায় “resubmit”, কারণ AT3 একটি gate. নম্বর বলে কাজটি কতটা ভালো; gate বলে কাজটি বিপজ্জনক কি না। Software-এর release pipeline-এও একই নীতি: coverage যত ভালোই হোক, একটি নিরাপত্তার test লাল হলে release থামে।

জমা: kick SysTick ISR-এ, mutant নেই, map file নেই
অংশ
পেল
কাটা কেন
চলমান মোট
  1. Acceptance: জমার firmware-এ kick SysTick-এর ISR-এ, তাই “hang”-এর পরেও watchdog খুশি থাকে; AT3 FAIL, ৮ নম্বর কাটা। বাকি পাঁচটি test পাস: ৪০-এর মধ্যে ৩২।
  2. Firmware-এর মান: ISR-এ kick রাখা ISR-এর দায়িত্বের ভুল, তাই volatile/ISR-এ ৫-এর মধ্যে ৩; map file থেকে কোনো হিসাব নেই, ০। BSRR/BRR আর build পুরো: ২০-এর মধ্যে ১৩, মোট ৪৫।
  3. Test: সীমার host test আর তুলনার নিয়ম ঠিক, কিন্তু কোনো mutant দিয়ে test-এর শক্তি দেখানো হয়নি: ১৫-এর মধ্যে ১০, মোট ৫৫।
  4. নকশার নথি: Traceability আর simulator-এর সীমা পুরো; timeout কেন 2000 ms, তার যুক্তি অর্ধেক (kick-এর সবচেয়ে লম্বা ফাঁক লেখা, oscillator-এর সহনশীলতা নেই): ৫-এর মধ্যে ২, মোট ৬৭।
  5. প্রদর্শন: চালানোর README আর demo log দুটিই আছে: পুরো ১০, মোট ৭৭।
  6. Gate: AT1 পাস, কিন্তু AT3 ব্যর্থ। ৭৭ ≥ ৬০ হলেও রায় “resubmit”. ঠিক করার পথ অনুশীলন ২-এ: kick-কে main loop-এর শেষে, একটি পুরো sample-এর পরে।

পরীক্ষা ও ইন্টারভিউতে: (১) “একটি এমবেডেড প্রজেক্টের acceptance test কীভাবে লিখবেন?” → মাপা যায় এমন requirement থেকে, কোডের আগে, প্রতিটির পাস-ফেলের শর্তসহ, আর খারাপ ঘটনার (fault injection) test-সহ। (২) “Watchdog কোথায় kick করবেন?” → main loop-এর একটি পুরো কাজের চক্র শেষে, ISR-এ কখনো নয়। (৩) “Reset-এর পরে কোন অবস্থা টিকিয়ে রাখবেন, কীভাবে?” → নিরাপত্তার অবস্থা, .noinit-এ, magic আর সীমা যাচাইসহ, volatile. (৪) “Median বনাম গড়?” → median একক spike পুরো বাদ দেয়, গড় ছড়িয়ে রাখে। (৫) “Simulator-এ পাস মানে কি hardware-এ পাস?” → না; timing, analog আর oscillator-এর সহনশীলতা মডেলের বাইরে, HIL আর মাঠে যাচাই লাগে।

১০ · AI-এর যুগে ক্যাপস্টোন — সাহায্য নিন, প্রমাণ নিজে

AI assistant এক মিনিটে পুরো cold-room firmware লিখে দিতে পারে, দেখতেও সুন্দর। কিন্তু ক্যাপস্টোনের মূল্য কোডে নয়, প্রমাণে: requirement-এর পাশে সবুজ test. AI-এর কোড সেই প্রমাণের যন্ত্রে ঢোকানো একটি খসড়া মাত্র। এই বিষয়ে AI-এর সবচেয়ে চেনা ভুল আর ধরার উপায়:

AI প্রায়ই যা করেকীভাবে ধরবেন
Watchdog-এর kick timer ISR-এ বসায়AT3-এর মতো hang-এর test; ISR-এ IWDG খুঁজুন
ISR-এর ভ্যারিয়েবল আর .noinit-এর struct-এ volatile ভোলে-O2-এর -S আউটপুট পড়ুন; review-এর তালিকায় রাখুন
নির্দিষ্ট chip-এর বানানো register নাম বা ঠিকানা লেখেBoard-এর header (bazarghar.h) বা reference manual-এর সঙ্গে মেলান
Hysteresis-এর ব্যান্ড বা “৩টি পরপর” ভুল পড়ে, সীমায় < বনাম <=সীমার host test: 8.00, 7.50, 0.50, 0.00 °C
Expected output নিজের কোড চালিয়ে বানায়Expected শুধু README থেকে; mutant দিয়ে test-কে লাল করে দেখুন
Broker-এ hard-coded password, TLS নেই, test hook খোলানকল secret; lab-এর বাইরে auth আর TLS; বিক্রির build-এ hook বাদ
Simulator-এর সময়কে আসল chip-এর সময় বলেSpec decision 17 পড়ুন; সময় datasheet আর আসল মাপে

AI-কে কাজ দেওয়ার সময় spec, সীমা আর প্রমাণের শর্ত একসাথে দিন:

আমি একটি Cortex-M3 (virtual board, STM32-ধাঁচের register) cold-room monitor-এর firmware C11-এ লিখছি। Spec: প্রতি 1 s-এ I2C 0x48 থেকে তাপমাত্রা (12-bit, 0.0625 °C/LSB), তিনটি পড়ার median; HIGH 8.00 °C-এর ওপরে আর LOW 0.00 °C-এর নিচে পরপর ৩টি reading-এ; বন্ধ 0.50 থেকে 7.50 °C-এ (প্রান্তসহ) পরপর ৩টি reading-এ; IWDG 2000 ms; alarm-এর অবস্থা .noinit-এ। ১. নিয়মের অংশ register ছাড়া আলাদা ফাইলে দাও, যাতে PC-তে unit test হয়। ২. Watchdog-এর kick কোথায় দিচ্ছ আর কেন, ব্যাখ্যা করো; ISR-এ kick দিও না। ৩. ISR আর main দুজনেই যে ভ্যারিয়েবল ছোঁয়, আর .noinit-এর সব ভ্যারিয়েবল volatile রাখো। ৪. প্রতিটি সীমার (8.00, 7.50, 0.50, 0.00) জন্য একটি test দাও; expected মান শুধু spec থেকে নাও। ৫. কোনো register-এর নাম, ঠিকানা বা timing নিয়ে নিশ্চিত না হলে বলো "নিশ্চিত নই, reference manual দেখুন"।

AI-এর উত্তর হাতে পেলে — যাচাইয়ের চেকলিস্ট

ভাবনার প্রশ্ন

প্রতিটি প্রশ্ন নিয়ে নিজে কিছুক্ষণ ভাবুন, তারপর “→ উত্তর” চাপুন।

প্র ০১Therac-25 নামের চিকিৎসা-যন্ত্রের দুর্ঘটনা (১৯৮৫–৮৭) থেকে একটি এমবেডেড প্রজেক্টের acceptance test-এর নকশা কী শিখতে পারে?

Therac-25 ছিল ক্যান্সারের চিকিৎসায় ব্যবহৃত একটি radiation therapy যন্ত্র। ১৯৮৫ থেকে ১৯৮৭ সালের মধ্যে কয়েকজন রোগী মাত্রার চেয়ে বহুগুণ বেশি radiation পান, যাঁদের কয়েকজন মারা যান। Nancy Leveson আর Clark Turner-এর ১৯৯৩ সালের বহুল উদ্ধৃত তদন্ত-প্রবন্ধ অনুযায়ী, আগের মডেলগুলোতে যে নিরাপত্তা-পাহারা hardware-এর interlock-এ ছিল, Therac-25-এ তার বড় অংশ software-এর ওপর ছেড়ে দেওয়া হয়েছিল। আর software-এ ছিল race condition: অভিজ্ঞ operator খুব দ্রুত তথ্য বদলালে যন্ত্র একটি অসংগত অবস্থায় পৌঁছাত, যা স্বাভাবিক গতির test-এ কখনো দেখা দেয়নি।

Acceptance test-এর দিক থেকে প্রথম শিক্ষা: “স্বাভাবিক ব্যবহার” চালিয়ে পাস দেখা যথেষ্ট নয়। ক্যাপস্টোনে তাই আলাদা test খারাপ ঘটনার জন্য: spike (AT2), আটকে যাওয়া loop (AT3), আর অনুশীলনে মরা sensor. এগুলো fault injection: যন্ত্রকে ইচ্ছা করে বিপদে ফেলে দেখা সে নিরাপদ অবস্থায় যায় কি না। দ্বিতীয় শিক্ষা: নিরাপত্তার পাহারা একটি জায়গায় রাখা বিপজ্জনক। বাজারঘরের যন্ত্রে watchdog-ই software-এর বাইরের একটি স্বাধীন পাহারা; আসল ঠান্ডা ঘরে একটি সাধারণ যান্ত্রিক thermostat বা আলাদা alarm-ও রাখা যেত, যা firmware নষ্ট হলেও কাজ করে।

তৃতীয় শিক্ষা নথি আর জবাবদিহির। তদন্তে উঠে আসে, যন্ত্রের error message অস্পষ্ট ছিল আর ঘটনার রিপোর্ট গুরুত্ব পায়নি। ক্যাপস্টোনের reset-এর লাইন (“reset cause: WATCHDOG”, “alarm restored”) সেই কারণেই: যন্ত্র কী ঘটেছে তা স্পষ্ট বলে, যাতে মানুষ বুঝতে পারে। নিরাপত্তা আর fault tolerance-এর বিস্তারিত পর্ব ৬৩-এ।

মূল উপলব্ধি: নিরাপত্তার acceptance test-এ খারাপ ঘটনা ইচ্ছা করে ঘটাতে হয়, পাহারা একাধিক স্বাধীন স্তরে রাখতে হয়, আর যন্ত্রকে নিজের অবস্থা স্পষ্ট ভাষায় জানাতে হয়।

প্র ০২ক্যাপস্টোনের watchdog timeout 2000 ms. Virtual board-এ এটি ঠিক 2000 ms, কিন্তু আসল STM32F103-এ একই সেটিংয়ে timeout কত হতে পারে, আর তাতে নকশা কীভাবে বদলায়?

Virtual board-এর watchdog counter ঠিক 1 kHz-এ চলে (Spec decision 28), তাই RLR = 2000 মানে ঠিক 2000 ms. আসল STM32F1-এ independent watchdog চলে chip-এর ভেতরের LSI নামের একটি ছোট RC oscillator-এ। RC oscillator সস্তা আর মূল clock থেকে স্বাধীন, যা watchdog-এর জন্য ঠিক দরকার, কিন্তু নির্ভুল নয়। STM32F103-এর datasheet LSI-এর জন্য সাধারণত প্রায় 40 kHz লেখে, আর সীমা মোটামুটি 30 থেকে 60 kHz; সঠিক মান নির্দিষ্ট datasheet-এর সংস্করণে দেখে নিতে হয়।

এর মানে, 40 kHz ধরে হিসাব করা 2000 ms-এর timeout আসলে 40/60 গুণ, অর্থাৎ প্রায় 1333 ms থেকে 40/30 গুণ, প্রায় 2667 ms পর্যন্ত হতে পারে। নকশার দুই দিক। নিচের দিক: সবচেয়ে ছোট সম্ভাব্য timeout (1333 ms) যেন সবচেয়ে লম্বা স্বাভাবিক kick-এর ফাঁকের চেয়ে বড় হয়। ক্যাপস্টোনে kick প্রতি 1 s-এ, sample-এর কাজ কয়েক মাইক্রোসেকেন্ড, তাই 1333 > 1000 নিরাপদ, তবে মার্জিন বড় নয়। যদি পরে TLS বা flash-এ লেখার মতো লম্বা কাজ যোগ হয়, তা ধরতে হবে। ওপরের দিক: সবচেয়ে বড় timeout (2667 ms) পর্যন্ত যন্ত্র আটকে থাকতে পারে, তাই requirement R6-এর “2 s-এর মধ্যে” আসল chip-এ নিশ্চিত নয়।

সমাধানের কয়েকটি পথ: requirement-কে আসল সহনশীলতা ধরে লেখা (“3 s-এর মধ্যে”), RLR ছোট করা (যেমন nominal 1500 ms, যা সবচেয়ে ছোট অবস্থায় 1000 ms, তখন kick-এর ফাঁক 1 s-এর কম রাখতে হবে), অথবা LSI-কে একটি নির্ভুল timer দিয়ে মেপে নেওয়া, যা কিছু STM32-এর reference manual-এ বর্ণিত কৌশল। Timeout বাছাইয়ের পুরো আলোচনা পর্ব ৬১-এ।

এই প্রশ্ন একটি বড় সত্যও দেখায়: simulator নির্ভুল, আসল জগৎ নয়। Rubric-এর “simulator-এর সীমা সৎভাবে লেখা” অংশ এ জন্যই।

মূল উপলব্ধি: Watchdog-এর timeout একটি সংখ্যা নয়, একটি পরিসর; সবচেয়ে ছোট মান kick-এর ফাঁকের চেয়ে বড় আর সবচেয়ে বড় মান requirement-এর সীমার মধ্যে রাখতে হয়।

প্র ০৩MQTT জন্মেছিল ১৯৯৯ সালে তেলের পাইপলাইনের জন্য। তার কোন নকশা ক্যাপস্টোনের bridge সরাসরি ব্যবহার করে, আর reset-এর পরে seq আবার 1 থেকে গোনার সমস্যা MQTT কি সমাধান করে?

MQTT-এর নকশা করেন IBM-এর Andy Stanford-Clark আর Arcom-এর (পরে Eurotech) Arlen Nipper, ১৯৯৯ সালে, তেলের পাইপলাইনের দূরের যন্ত্র satellite link-এ নজরে রাখার জন্য বলে বহুল বর্ণিত। সেই link ছিল ধীর, দামি আর অনির্ভরযোগ্য; তাই protocol-টি ছোট header, publish/subscribe আর সংযোগ হারানোর জন্য বিশেষ ব্যবস্থা নিয়ে আসে। পরে OASIS ২০১৪ সালে MQTT 3.1.1-কে standard করে, যা ২০১৬ সালে ISO/IEC 20922 হয়; MQTT 5.0 আসে ২০১৯ সালে।

ক্যাপস্টোনের bridge তিনটি নকশা সরাসরি ব্যবহার করে। QoS 1: PUBACK না আসা পর্যন্ত বার্তা আবার পাঠানো, তাই telemetry হারায় না; দাম হলো একই বার্তা দুবার পৌঁছাতে পারে। Retained message: status topic-এর শেষ “online” broker রেখে দেয়, পরে আসা app সঙ্গে সঙ্গে পায়। Last Will: gateway-এর socket হঠাৎ বন্ধ হলে broker নিজেই “offline” প্রকাশ করে, AT6-এ যেমন দেখা গেছে। পাইপলাইনের দূরের যন্ত্র আর বাজারঘরের ঠান্ডা ঘরের সমস্যা আসলে একই: কেউ পাশে দাঁড়িয়ে নেই, যন্ত্রকেই জানাতে হবে সে বেঁচে আছে কি না।

কিন্তু seq-এর সমস্যা MQTT সমাধান করে না। AT3-এর run-এ watchdog reset-এর পরে নতুন boot আবার t=1 আর seq 1 থেকে গোনে। QoS 1-এর পুনরায় পাঠানো বার্তা আর reset-এর পরের নতুন seq 1, দুটি মিলে dashboard-এ একই seq-এর দুটি ভিন্ন বার্তা আসতে পারে। MQTT শুধু পরিবহন নিশ্চিত করে, বার্তার অর্থ নয়। সমাধান application-স্তরে: payload-এ boot সংখ্যা যোগ করা (যেমন keep.boots), বা seq-কে .noinit-এ রেখে reset পেরিয়ে চালু রাখা, বা প্রতিটি বার্তায় সময়ের ছাপ। README-এর payload স্থির, তাই এটি stretch goal; কিন্তু বাস্তব device management-এ এটি জরুরি (পর্ব ৭৫)।

মূল উপলব্ধি: MQTT পৌঁছানো আর অনুপস্থিতি জানানো দেখে; বার্তার পরিচয় আর ক্রম, বিশেষ করে reset পেরিয়ে, application-কে নিজে নকশা করতে হয়।

প্র ০৪ক্যাপস্টোন virtual board-এ ৬টির ৬টি পাস করেছে। একই firmware আসল ঠান্ডা ঘরে বসানোর আগে আর কী কী test লাগবে, আর কেন?

Virtual board-এ যা প্রমাণ হয়েছে, তা হলো logic: নিয়ম, ক্রম, reset-এর পরে ফেরা, payload-এর বানান। যা প্রমাণ হয়নি, তা মডেলের বাইরের সবকিছু। README নিজেই তালিকা দেয়: আসল cycle-এর হিসাব নেই (Spec decision 17), UART-এর baud-এর সময় নেই (24), I2C-এর বিট-স্তর, ACK আর clock stretching নেই (26), আর 28 নম্বর সিদ্ধান্তে watchdog-এর oscillator একদম নির্ভুল। প্রতিটি ফাঁক একটি নতুন test দাবি করে।

প্রথম ধাপ hardware-in-the-loop: আসল board, তার সঙ্গে একটি test কম্পিউটার যা sensor-এর জায়গায় নকল তাপমাত্রা দেয় আর PA6 মাপে (পর্ব ৬৪)। এখানে ধরা পড়ে আসল I2C-এর সময়, pull-up resistor-এর মান, তারের দৈর্ঘ্য আর noise-এর প্রভাব। দ্বিতীয় ধাপ পরিবেশ: ঠান্ডা ঘরের ভেতরের তাপমাত্রা শূন্যের কাছে, আর্দ্রতা বেশি, দরজা খোলায় জলীয় বাষ্প জমে। Electronics-এর অংশ, battery আর connector সেই অবস্থায় কেমন আচরণ করে, তা ঘরের বাইরের test-এ বোঝা যায় না। তৃতীয় ধাপ শক্তির মাপ: AT4-এর 0.0242% মডেলের সংখ্যা, আসল chip-এ exception-এ ঢোকা, flash-এর অপেক্ষা আর peripheral-এর current যোগ হবে; একটি current meter দিয়ে মাপা লাগবে (পর্ব ৬২)।

চতুর্থ ধাপ দীর্ঘ সময়: কয়েক দিন বা সপ্তাহ চালিয়ে দেখা, কারণ কিছু ভুল বিরল: counter উপচে পড়া, memory-র ধীর ক্ষয়, network বিচ্ছিন্নতার পরে ফেরা। শেষ ধাপ মাঠে অল্প কয়েকটি যন্ত্র, পুরোনো ব্যবস্থার পাশাপাশি, যাতে নতুন যন্ত্র ভুল করলেও মাল নষ্ট না হয়। প্রতিটি ধাপে acceptance test একই, শুধু ঘটনা আসে আসল জগৎ থেকে।

একটি সতর্কতা: কোনো লাইসেন্স বা মান-নির্ধারণী সংস্থার সনদ লাগবে কি না, তা পণ্যের ধরন আর দেশের নিয়মের ওপর নির্ভর করে; সেই সিদ্ধান্ত প্রকৌশলীর একার নয়।

মূল উপলব্ধি: Simulator-এর সবুজ মানে logic ঠিক; আসল সময়, analog, পরিবেশ আর দীর্ঘ চলার ভুল ধরতে HIL, মাপ আর মাঠের ধাপে ধাপে test লাগে।

প্র ০৫ক্যাপস্টোনের firmware UART-এ “hang” পেলে নিজেকে আটকায়, আর broker-এ কোনো password নেই। Lab-এ এগুলো ঠিক; বিক্রির যন্ত্রে কেন বিপজ্জনক, আর ২০১৬-এর Mirai এ বিষয়ে কী শেখায়?

২০১৬ সালের Mirai botnet কয়েক লাখ পর্যন্ত IoT যন্ত্র, প্রধানত IP camera আর home router, দখল করেছিল বলে বিভিন্ন গবেষণায় অনুমান করা হয়, আর সেগুলো দিয়ে বড় মাপের DDoS আক্রমণ চালানো হয়। বহুল বর্ণিত কারণ ছিল সরল: খোলা Telnet-এর মতো সেবা আর কারখানার default username-password, যা কেউ বদলায়নি। অর্থাৎ যন্ত্রগুলোর দুর্বলতা জটিল কোনো ভুল নয়, বরং পরীক্ষা আর সুবিধার জন্য রাখা খোলা দরজা।

ক্যাপস্টোনের test hook ঠিক এমন একটি দরজা। Lab-এ “hang” দরকার, কারণ এটি ছাড়া watchdog-এর test সম্ভব নয়। কিন্তু বিক্রির যন্ত্রে UART-এর pin কেউ ছুঁলে সাইরেন-সহ পুরো monitor আটকে দিতে পারে; “stop” দিয়ে বন্ধও করতে পারে। একইভাবে পরিচয় যাচাই ছাড়া broker-এ যে-কেউ bazarghar/coldroom/1/temp-এ ভুয়া 4.00 °C পাঠাতে পারে, আর dashboard কিছু টের পাবে না। Lab-এ broker শুধু 127.0.0.1-এ, তাই বাইরের কেউ পৌঁছায় না; মাঠে সেই সুরক্ষা নেই।

প্রতিরক্ষার নিয়ম সরল। Test hook শুধু test build-এ, compile-time flag দিয়ে, আর বিক্রির build-এ সেই flag-এর অনুপস্থিতি একটি test দিয়ে যাচাই। Debug port তালা দেওয়া। Broker-এ প্রতিটি device-এর আলাদা পরিচয়, TLS আর topic-ভিত্তিক অনুমতি, যাতে cold room শুধু নিজের topic-এ লিখতে পারে। কোনো আসল secret source code-এ নয়। ইউরোপের ETSI EN 303 645 (প্রথম সংস্করণ ২০২০) consumer IoT-এর জন্য “সর্বজনীন default password নয়” আর নিরাপদ update-এর মতো নীতি তালিকাভুক্ত করেছে বলে জানা যায়। বিস্তারিত পর্ব ৭৬ আর সাইবার নিরাপত্তা পর্ব ৩৫-এ।

মূল উপলব্ধি: Test-এর সুবিধার জন্য খোলা প্রতিটি দরজা বিক্রির আগে বন্ধ করা আর সেই বন্ধ থাকা test দিয়ে প্রমাণ করা ক্যাপস্টোনেরই অংশ।

অনুশীলন

প্রথমে নিজে লিখুন বা হিসাব করুন, তারপর উত্তর খুলুন। প্রতিটি উত্তর lab-এর virtual board-এ চালিয়ে বা হিসাব-script দিয়ে যাচাই করা।

  1. নকশা ও বাস্তবায়ন — মরা sensor: Reference solution-এ sensor সাড়া না দিলে (I2C NACK) sample বাদ যায় আর kick হয় না। একটি test hook দিয়ে 3.5 s-এ sensor-কে “খুলে” ফেললে (fault .noinit-এ, তাই reset-এর পরেও থাকে) কী ঘটবে? তারপর এমন বদল লিখুন, যাতে পরপর ৩টি ব্যর্থ sample-এ যন্ত্র “SENSOR FAULT” জানায়, PA6 চালু করে আর reset-এর চক্রে না পড়ে।

    বর্তমান কোডে kick নেই, তাই শেষ kick (3000.16 ms)-এর 2000 ms পরে reset: lab-এর run-এ [ 5000.1605 ms] RESET (watchdog timeout), তারপর 7000.28, 9000.39, 11000.51 ms-এ আবার, boot #2 থেকে #5. যন্ত্র চিরকাল reset-এর চক্রে, আর একবারও জানায় না সমস্যা sensor-এ। Watchdog-এর কাজ software আটকানো ধরা; hardware-এর ভুল আলাদা করে জানাতে হয়। বদল:

    if (tsens_read(&sub[k]) != 0) {
        uart_puts("sensor NACK\r\n");
        k = 0;
        next += SAMPLE_TICKS;
        if (++nack_run == 3u) {               /* ৩টি sample পরপর: hardware fault */
            GPIOA->BSRR = 1u << ALARM_PIN;
            uart_puts("SENSOR FAULT: no reply from 0x48\r\n");
        }
        IWDG->KR = 0xAAAAu;                   /* loop বেঁচে আছে: kick চলবে */
        continue;
    }
    nack_run = 0;

    Lab-এ চালানো ফল: 3980, 4980, 5980 ms-এ “sensor NACK”, তারপর [ 5980.1341 ms] GPIO PA6 ALARM ON আর [ 5980.1605 ms] UART: SENSOR FAULT: no reply from 0x48; 12.5 s পর্যন্ত কোনো reset নেই। Acceptance test-এর শর্ত: “৩টি ব্যর্থ sample-এর পরে SENSOR FAULT আর PA6 ON, আর কোনো RESET লাইন নেই”। একটি বাড়তি প্রশ্ন নিজে ভাবুন: telemetry-তে এই অবস্থা কীভাবে যাবে, যখন README-এর alarm ঘরে শুধু OFF, HIGH আর LOW?

  2. ভুল খুঁজুন — অন্ধ kick: একজন ছাত্রী reference solution থেকে kick-এর লাইন সরিয়ে লিখলেন void SysTick_Handler(void) { ticks++; IWDG->KR = 0xAAAAu; }, যুক্তি: “প্রতি 10 ms-এ kick, তাই কখনো ভুল reset হবে না।” README script-এ সব ঠিক চলে। AT3-এর wdt.json-এ কী ঘটবে, আর ভুলটা কোথায়?

    Lab-এ এই রূপটি চালানো হলো: 4500.15 ms-এ “hang command”, তারপর আর কোনো UART লাইন নেই, কোনো RESET নেই; 9.5 s-এ তাপমাত্রা 7.00 °C হলেও কেউ পড়ে না; run শেষ হয় stopped: cycle limit (120000000) reached-এ, 15000 ms-এ। কারণ: main loop আটকে গেলেও SysTick-এর interrupt চলতে থাকে, আর সেই ISR প্রতি 10 ms-এ watchdog-কে “সব ঠিক” বলে। Watchdog প্রশ্ন করে “ISR চলছে কি?”, অথচ জানতে হতো “আসল কাজ চলছে কি?”। এই নমুনায় alarm ON অবস্থায় আটকেছে বলে সাইরেন বাজছে, কিন্তু ঘর ঠান্ডা হলেও আর বন্ধ হবে না, আর OFF অবস্থায় আটকালে গরম হলেও বাজবে না। ঠিক নিয়ম: kick শুধু main loop-এ, একটি পুরো sample শেষ হওয়ার পরে; একাধিক task থাকলে প্রতিটির হাজিরা নিয়ে একটি supervisor kick দেয় (watchdog kick আর task check-in, পর্ব ৬১)।

  3. হিসাব — reset-এর সময় আর হারানো reading: একটি firmware প্রতি 1 s-এ sample নেয় আর প্রতিটি sample শেষে kick দেয়; watchdog-এর timeout nominal 2000 ms. শেষ kick 4000.16 ms-এ, তারপর loop আটকায়। (ক) Virtual board-এ reset কখন? (খ) নতুন boot-এর প্রথম reading 1 s পরে হলে কয়টি সেকেন্ডের reading হারাল? (গ) আসল chip-এ watchdog-এর oscillator 40 kHz ধরে হিসাব করা, কিন্তু আসলে 30 থেকে 60 kHz হতে পারে; timeout-এর পরিসর কত, আর 1 s-এর kick-এর জন্য তা নিরাপদ কি না?

    (ক) 4000.16 + 2000 = 6000.16 ms, lab-এর run-এর [ 6000.1599 ms] RESET (watchdog timeout)-এর সঙ্গে মেলে। (খ) Reset-এর পরে নতুন boot-এর প্রথম reading 7000.34 ms-এ; 5 s আর 6 s-এর reading নেই, অর্থাৎ ২টি হারাল (4 s থেকে 7 s-এর ফাঁক)। (গ) Counter একই সংখ্যক tick গোনে, তাই সময় clock-এর উল্টো অনুপাতে: 2000 × 40 / 60 ≈ 1333 ms থেকে 2000 × 40 / 30 ≈ 2667 ms. সবচেয়ে ছোট 1333 ms > 1000 ms, তাই স্বাভাবিক kick-এ ভুল reset হবে না, তবে মার্জিন মাত্র 333 ms; আর সবচেয়ে খারাপ অবস্থায় যন্ত্র প্রায় 2.7 s আটকে থাকতে পারে, ফলে “2 s-এর মধ্যে reset” requirement আসল chip-এ ভাঙতে পারে (ভাবনার প্রশ্ন ২)।

  4. আগে বলুন, তারপর মেলান — median-এর বদলে গড়: কেউ median3(sub[0], sub[1], sub[2])-এর বদলে (sub[0] + sub[1] + sub[2]) / 3 লিখলেন। spike.json-এ 3 s-এর তিনটি পড়া t16-এ 64, 64, 480, অর্থাৎ 4.00, 4.00 আর 30.00 °C-এর তিনটি পড়া। ছাপা T কত হবে (নিয়ম: centi = t16 × 25 / 4, integer), 10 s-এর telemetry-তে কী যাবে, alarm বাজবে কি না, আর ছয়টি acceptance test-এর কোনটি ব্যর্থ হবে?

    গড় = 608 / 3 = 202 (integer). Centi = 202 × 25 / 4 = 5050 / 4 = 1262 (integer-এ কাটা), তাই T=+12.62 C. 10 s-এও একই, তাই telemetry "temp_c":12.62,"alarm":"OFF". 202 > 128, তাই HIGH-এর counter ১ হয়, কিন্তু পরের reading আবার 64, counter শূন্য; ৩টি পরপর হয় না, তাই alarm বাজে না। আসল 9.00 °C-এর alarm 15 s-এ ঠিকই আসে। Lab-এর board-এ এই রূপটি চালিয়ে হুবহু মিলেছে: [ 3000.1666 ms] UART: t=3 s T=+12.62 C আর TELEMETRY {…"temp_c":12.62,"alarm":"OFF"}. ব্যর্থ হবে AT2, কারণ শর্ত telemetry-তে 4.00. গড় spike-কে বাদ দেয় না, তিন ভাগে ছড়িয়ে দেয়: dashboard-এ এখন 30.00-এর বদলে 12.62 °C, তাও একটি মিথ্যা খবর।

নিজেকে যাচাই করুন

ভুল হলে কারণসহ ব্যাখ্যা পাবেন, আবার চেষ্টাও করতে পারবেন।

ক্রমএকটি cold-room monitor প্রজেক্টের কাজগুলো সঠিক ক্রমে সাজান (▲▼ চেপে সরান)

  1. মাপা যায় এমন requirement আর acceptance criteria লেখা
  2. Board-এ build করে UART-এ boot-এর লাইন দেখা
  3. Sensor পড়া আর spike-এর filter যোগ করা
  4. Alarm-এর নিয়ম আলাদা ফাইলে লিখে host-এ unit test চালানো
  5. Watchdog আর reset-এর পরে অবস্থা ফেরানো যোগ করা
  6. Bridge আর MQTT জুড়ে সব acceptance test একসাথে চালানো

একটি firmware প্রতি 1 s-এ sample নেয়; main loop আটকে গেলে watchdog reset চাই। Watchdog-এর kick কোথায় দেওয়া সবচেয়ে ঠিক?

  • প্রতি 10 ms-এর SysTick ISR-এ
  • Main loop-এ, একটি পুরো sample-এর কাজ শেষ হওয়ার পরে
  • শুধু main-এর শুরুতে একবার
  • I2C-এর পড়া শেষের interrupt-এ

একটি ঠান্ডা ঘরের firmware-এ HIGH alarm বাজার সময় watchdog reset হলো। Startup code .bss শূন্য করে আর GPIO reset-এ সাইরেনের pin নিভে যায়। Reset-এর পরে alarm সঙ্গে সঙ্গে ফেরানোর সবচেয়ে ভালো উপায় কোনটি?

  • Alarm-এর অবস্থা একটি সাধারণ static ভ্যারিয়েবলে রাখা
  • Reset-এর পরে নতুন করে ৩টি reading নিয়ে সিদ্ধান্ত নেওয়া
  • Magic সংখ্যাসহ একটি volatile struct-এ, .noinit section-এ রেখে reset-এর কারণ WATCHDOG হলে ফেরানো
  • প্রতিবার alarm বদলালে flash-এ লিখে রাখা

প্রতি সেকেন্ডে তিনটি পড়া 4.00, 4.00 আর 30.00 °C (শেষেরটি 10 ms-এর একটি ঝাঁকি)। কোন filter-এর ফল 4.00 °C হবে?

  • তিনটির median
  • তিনটির গড়
  • শুধু শেষ পড়াটি
  • তিনটির সর্বোচ্চ

একটি firmware-এর regression test-এ simulator-এর output README-এর expected file-এর সঙ্গে মেলানো হয়। Firmware-এ নতুন লাইন যোগ হওয়ায় সব সময়ের ছাপ ms-এর ভগ্নাংশে বদলেছে, যেমন 7000.0387 থেকে 7000.1585; মান আর ক্রম এক। ঠিক তুলনার নিয়ম কোনটি?

  • পুরো লাইন অক্ষরে অক্ষরে মেলানো
  • লাইনের সব দশমিক সংখ্যা মুছে মেলানো
  • নতুন output দিয়েই expected file বানিয়ে নেওয়া
  • শুধু শুরুর সময়কে পূর্ণ ms-এ কেটে, বাকি লাইন হুবহু মেলানো

একটি IoT gateway MQTT broker-এ সংযোগের সময় Last Will হিসেবে status topic-এ “offline” (QoS 1, retained) দিয়ে রাখে। কখন broker এই বার্তা প্রকাশ করবে?

  • Gateway ঠিকভাবে DISCONNECT পাঠালে
  • Gateway DISCONNECT ছাড়া হঠাৎ সংযোগ হারালে
  • Gateway প্রতিবার telemetry পাঠানোর পরে
  • নতুন কোনো dashboard subscribe করলে

একটি প্রজেক্টের rubric-এ মোট ১০০ নম্বর আর দুটি “অবশ্যই পাস” test (alarm-এর নিয়ম, watchdog-এর উদ্ধার)। একটি জমা ৭৭ নম্বর পেল, কিন্তু watchdog-এর test ব্যর্থ। পাসের সীমা ৬০ হলে রায় কী?

  • গ্রহণ, কারণ ৭৭ ≥ ৬০
  • গ্রহণ, তবে ৮ নম্বর কেটে ৬৯
  • আবার জমা দিতে হবে, কারণ একটি gate ব্যর্থ
  • শূন্য নম্বর

একটি virtual Cortex-M board-এ (১টি নির্দেশ = ১ cycle, exception-এ ঢোকার খরচ শূন্য ধরা) গোনা গেল, firmware 20 s-এর মধ্যে মাত্র 0.0242% সময় জেগে ছিল। এ থেকে সবচেয়ে সঠিক সিদ্ধান্ত কোনটি?

  • WFI-এর নকশা কাজ করছে, কিন্তু আসল chip-এর জেগে থাকার সময় আর current আলাদা করে মাপতে হবে
  • আসল chip-এও ঠিক 0.0242% সময় জাগবে
  • এ থেকে battery-র আয়ু সরাসরি বছরে বলা যায়
  • এত কম জাগা মানে firmware ঠিকমতো কাজ করছে না

শব্দকোষ

লেখার মধ্যে ডটেড দাগ দেওয়া শব্দে মাউস রাখুন বা চাপুন — অর্থ দেখাবে। এই পর্বের সব নতুন শব্দ এখানে একসাথে:

মনে রাখুন

  1. Requirement আগে: প্রতিটি মাপা যায় এমন, শেখানো পর্ব আর প্রমাণের test-এর সঙ্গে জোড়া (traceability); acceptance criteria কোডের আগে।
  2. মাইলফলকে কাজ: boot → sensor আর filter → নিয়ম আর host test → alarm আর telemetry → watchdog আর ঘুম → bridge আর MQTT; প্রতিটির শেষে চলমান প্রমাণ।
  3. খারাপ দিনের test: median একক spike বাদ দেয়; kick শুধু পুরো sample-এর পরে; চলমান alarm volatile .noinit-এ টিকে থাকে; মরা sensor reset-এর চক্র নয়, স্পষ্ট fault.
  4. Test-এর test: README থেকে expected, শুধু সময় কেটে তুলনা, আর mutant দিয়ে প্রমাণ যে test সত্যিই কিছু ধরে।
  5. সৎ সীমা: virtual board-এর সময় আর শক্তি মডেলের সংখ্যা; আসল chip-এ HIL, মাপ আর মাঠের test, আর বিক্রির আগে test hook ও খোলা broker বন্ধ।

পরের পর্বে: পর্ব ৮১ (8085 আর 8086-এর সমস্যা অনুশীলন — program, timing আর interfacing). কোর্সের শেষ মডিউল পরীক্ষার প্রস্তুতির: 8085 আর 8086-এর program, T-state আর delay-এর হিসাব, আর interfacing-এর সমস্যা, ধাপে ধাপে সমাধানসহ।

আরও পড়ুন · ABCL TECH-এ আপনার পরবর্তী পদক্ষেপ

এই পর্বটি শেয়ার করুন:
এই পর্বে ভুল পেয়েছেন? জানান