Files
lab-rv32i-freertos-event-group/json/card_source.json
T
2026-07-20 08:36:37 +02:00

285 lines
8.8 KiB
JSON

{
"$schema": "../../../tools/card-layouts/schemas/card-source.schema.json",
"schema": "esc-card-source.v1",
"card": {
"id": "mpabi-freertos-cpp-13-event-group",
"series": "freertos-cpp",
"series_title": "FreeRTOS C++",
"number": "13",
"count": "16",
"slug": "event-group",
"title": "EventGroup and Coordinated State",
"topic": "Typed bit masks, any/all predicates, clear-on-exit and timeout snapshots",
"project": "Freestanding C++ nad FreeRTOS",
"subject": "Informatyka",
"level": "Rok 2 · L12 · RV32I/Hazard3",
"revision_date": "2026-07-19T00:00:00+02:00",
"status": "Gotowa",
"version": "v00.01",
"uuid": "5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa",
"author": "M. Pabiszczak",
"year": "2026"
},
"generated": {
"tex": "doc/generated/main.tex",
"html": "web/index.html",
"html_css": "web/style.css",
"html_tree_inspector": false,
"react_app": true
},
"template": "templates/karta-klasyczna.json",
"title_block": {
"category": "KARTA PRACY · INFORMATYKA",
"prepared_by": "M. Pabiszczak",
"prepared_on": "2026-07-19T00:00:00+02:00",
"title": "EventGroup and Coordinated State",
"repository_url": "https://zsl-gitea.mpabi.pl/edu-freertos-cpp/lab-rv32i-freertos-event-group",
"revision": "v00.01",
"issued_on": "2026-07-19T00:00:00+02:00",
"series": "FREERTOS-CPP-13",
"document_type": "karta pracy",
"tool": "card-layouts",
"show_qr": false,
"show_repository_qr": false,
"height_cm": 2.6,
"repeat_on_every_page": true,
"replace_front_matter": true,
"url": "https://dce7fb9d-7b2f-5d49-96a2-3a30d3070b84.mpabi.pl/5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa"
},
"front_page_scope": {
"title": "Cel karty",
"content_tex": "Uczeń modeluje skoordynowany stan trzema typowanymi bitami, wybiera predykat any/all oraz mierzy snapshot, clear-on-exit i timeout.",
"scope_title": "Zakres karty",
"scope_content_tex": "EventGroup przechowuje bity stanu, nie licznik zdarzeń ani payload. Wynik wait jest snapshotem i wymaga sprawdzenia wybranego predykatu."
},
"side_margin_tree_layout": {
"columns": [
{
"id": "zawodowe",
"label": "TECH",
"side": "left",
"tree": "WE -> EK -> KW",
"description": "Task states, bit transitions, timeout i clear policy."
},
{
"id": "ogolne",
"label": "OG",
"side": "right",
"tree": "WE -> EN -> KW",
"description": "State versus count/payload oraz any/all semantics."
}
]
},
"learning_effects": {
"K13.EN01": {
"bloom_level": "Analiza",
"label": "Semantyka bitów",
"text": "Uczeń odróżnia bit stanu od licznika i payloadu oraz analizuje race przy clear-on-exit.",
"assessment_criteria": [
"K13.KW01"
]
},
"K13.EK01": {
"bloom_level": "Zastosowanie",
"label": "Koordynacja any/all",
"text": "Uczeń buduje typed mask, mierzy wait all/any, snapshot timeoutu i jawne czyszczenie bitów.",
"assessment_criteria": [
"K13.KW01"
]
}
},
"assessment_criteria": {
"K13.KW01": {
"text": "Program kończy się PASS; maska all=0x7, repeated UART=0x1, clear GPIO daje 0x7->0x5, timeout 3 zwraca snapshot 0x5/false, a any clear kończy maską 0x0 bez zmiany heapu.",
"learning_effects": [
"K13.EN01",
"K13.EK01"
]
}
},
"educational_requirements": {
"K13.WE01": {
"text": "Implementacja i pomiar EventGroup jako współdzielonego bitowego stanu.",
"label": "EventGroup i koordynacja",
"learning_effects": [
"K13.EN01",
"K13.EK01"
],
"learning_tree": {
"schema": "we-learning-tree.v1",
"policy": "Każdy wait ma jawną maskę, predykat any/all, politykę clear oraz timeout.",
"ogolne": [
{
"effect_ref": "K13.EN01",
"display": "EN LOCAL RTOS.EVENT.01",
"source": "LOCAL",
"official": "RTOS.EVENT",
"local": "01",
"kind": "EN",
"tree_id": "K13.WE01.OG.LOCAL.RTOS.EVENT.01",
"text": "Analizuje stan bitowy, utratę informacji i granice EventGroup.",
"kw": [
{
"criterion_ref": "K13.KW01",
"display": "KW LOCAL RTOS.EVENT.01",
"source": "LOCAL",
"kind": "KW",
"official": "RTOS.EVENT",
"local": "01",
"text": "Nie używa bitów jako licznika ani payloadu i uzasadnia race clear-on-exit."
}
]
}
],
"zawodowe": [
{
"effect_ref": "K13.EK01",
"display": "EK LOCAL DBG.EVENT.01",
"source": "LOCAL",
"official": "DBG.EVENT",
"local": "01",
"kind": "EK",
"tree_id": "K13.WE01.TECH.LOCAL.DBG.EVENT.01",
"text": "Mierzy transitions, task blocking, snapshots i timeout ticks.",
"kw": [
{
"criterion_ref": "K13.KW01",
"display": "KW LOCAL DBG.EVENT.01",
"source": "LOCAL",
"kind": "KW",
"official": "DBG.EVENT",
"local": "01",
"text": "Pokazuje 0x7, 0x5, timeout false, final 0x0 i PASS."
}
]
}
]
}
}
},
"sections": [
{
"title": "Typed masks i wait all",
"content_kind": "prose",
"content_tex": "Zbuduj maskę UART/GPIO/APP, zablokuj coordinator, opublikuj trzy stany i zachowaj maskę po wait all.",
"educational_requirement_refs": [
"K13.WE01"
],
"learning_effect_refs": [
"K13.EK01"
],
"assessment_criterion_refs": [
"K13.KW01"
],
"area_tree_refs": [
"K13.WE01.TECH.LOCAL.DBG.EVENT.01"
],
"steps": [
{
"id": "S01",
"title": "Potwierdź Blocked oraz set 1, 2 i 4.",
"tree_refs": [
"K13.WE01.TECH.LOCAL.DBG.EVENT.01"
]
},
{
"id": "S02",
"title": "Zapisz all snapshot i current 0x7.",
"tree_refs": [
"K13.WE01.TECH.LOCAL.DBG.EVENT.01"
]
}
]
},
{
"title": "Clear, timeout i wait any",
"content_kind": "prose",
"content_tex": "Usuń GPIO, zmierz timeout all z częściową maską, a następnie skonsumuj UART i APP przez any/clear-on-exit.",
"educational_requirement_refs": [
"K13.WE01"
],
"learning_effect_refs": [
"K13.EK01"
],
"assessment_criterion_refs": [
"K13.KW01"
],
"area_tree_refs": [
"K13.WE01.TECH.LOCAL.DBG.EVENT.01"
],
"steps": [
{
"id": "S03",
"title": "Pokaż transition 0x7 do 0x5.",
"tree_refs": [
"K13.WE01.TECH.LOCAL.DBG.EVENT.01"
]
},
{
"id": "S04",
"title": "Zmierz timeout 3 i final mask 0x0.",
"tree_refs": [
"K13.WE01.TECH.LOCAL.DBG.EVENT.01"
]
}
]
},
{
"title": "Stan, licznik i race",
"content_kind": "prose",
"content_tex": "Wyjaśnij, dlaczego repeated set pozostaje 0x1, dlaczego result!=0 nie dowodzi wait all i jak clear-on-exit wpływa na drugiego waitera.",
"educational_requirement_refs": [
"K13.WE01"
],
"learning_effect_refs": [
"K13.EN01"
],
"assessment_criterion_refs": [
"K13.KW01"
],
"area_tree_refs": [
"K13.WE01.OG.LOCAL.RTOS.EVENT.01"
],
"steps": [
{
"id": "S05",
"title": "Dobierz queue/counter dla wielokrotnych zdarzeń.",
"tree_refs": [
"K13.WE01.OG.LOCAL.RTOS.EVENT.01"
]
},
{
"id": "S06",
"title": "Przeanalizuj dwóch waiterów z clear-on-exit.",
"tree_refs": [
"K13.WE01.OG.LOCAL.RTOS.EVENT.01"
]
}
]
}
],
"tasks": {
"task01": {
"title": "Typed EventGroup i trzy źródła stanu",
"uuid": "5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa",
"prompt_tex": "Skoordynuj UART/GPIO/APP przez typed mask, wait all/any, keep/clear-on-exit oraz timeout snapshot i udowodnij granicę state versus count.",
"criterion": "All 0x7; repeated 0x1; clear 0x7->0x5; timeout 3/snapshot 0x5/false; any snapshot 0x5/final 0; heap delta 0; pass=1.",
"educational_requirement_refs": [
"K13.WE01"
],
"learning_effect_refs": [
"K13.EN01",
"K13.EK01"
],
"assessment_criterion_ref": "K13.KW01",
"links": {
"equations": [],
"figures": []
}
}
},
"tasks_order": [
"task01"
]
}