meta: add interactive draft URL

This commit is contained in:
2026-07-20 08:36:36 +02:00
parent e30ca17a72
commit 781c6c9692
+261 -40
View File
@@ -1,63 +1,284 @@
{
"$schema": "../../../tools/card-layouts/schemas/card-source.schema.json", "schema": "esc-card-source.v1",
"$schema": "../../../tools/card-layouts/schemas/card-source.schema.json",
"schema": "esc-card-source.v1",
"card": {
"id": "mpabi-freertos-cpp-12-semaphore-notify", "series": "freertos-cpp", "series_title": "FreeRTOS C++", "number": "12", "count": "16", "slug": "semaphore-notify",
"title": "Semaphores and Task Notifications", "topic": "Binary/counting bounds, blocked wakeup and explicit notification actions", "project": "Freestanding C++ nad FreeRTOS", "subject": "Informatyka",
"level": "Rok 2 · L11 · RV32I/Hazard3", "revision_date": "2026-07-19T00:00:00+02:00", "status": "Gotowa", "version": "v00.01",
"uuid": "fcb6107c-268f-4e86-a8cc-092e5875f6f0", "author": "M. Pabiszczak", "year": "2026"
"id": "mpabi-freertos-cpp-12-semaphore-notify",
"series": "freertos-cpp",
"series_title": "FreeRTOS C++",
"number": "12",
"count": "16",
"slug": "semaphore-notify",
"title": "Semaphores and Task Notifications",
"topic": "Binary/counting bounds, blocked wakeup and explicit notification actions",
"project": "Freestanding C++ nad FreeRTOS",
"subject": "Informatyka",
"level": "Rok 2 · L11 · RV32I/Hazard3",
"revision_date": "2026-07-19T00:00:00+02:00",
"status": "Gotowa",
"version": "v00.01",
"uuid": "fcb6107c-268f-4e86-a8cc-092e5875f6f0",
"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
},
"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": "Semaphores and Task Notifications", "repository_url": "https://zsl-gitea.mpabi.pl/edu-freertos-cpp/lab-rv32i-freertos-semaphore-notify",
"revision": "v00.01", "issued_on": "2026-07-19T00:00:00+02:00", "series": "FREERTOS-CPP-12", "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
"category": "KARTA PRACY · INFORMATYKA",
"prepared_by": "M. Pabiszczak",
"prepared_on": "2026-07-19T00:00:00+02:00",
"title": "Semaphores and Task Notifications",
"repository_url": "https://zsl-gitea.mpabi.pl/edu-freertos-cpp/lab-rv32i-freertos-semaphore-notify",
"revision": "v00.01",
"issued_on": "2026-07-19T00:00:00+02:00",
"series": "FREERTOS-CPP-12",
"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/fcb6107c-268f-4e86-a8cc-092e5875f6f0"
},
"front_page_scope": {
"title": "Cel karty", "content_tex": "Uczeń wybiera binary/counting semaphore lub task notification na podstawie cardinality i stanu, a następnie dowodzi block/wake, bounds oraz action i clear policy.",
"scope_title": "Zakres karty", "scope_content_tex": "Semaphore nie przechowuje payloadu. Notification jest kanałem jednego taska/TCB slotu; nie zastępuje kolejki wielu odbiorców."
"title": "Cel karty",
"content_tex": "Uczeń wybiera binary/counting semaphore lub task notification na podstawie cardinality i stanu, a następnie dowodzi block/wake, bounds oraz action i clear policy.",
"scope_title": "Zakres karty",
"scope_content_tex": "Semaphore nie przechowuje payloadu. Notification jest kanałem jednego taska/TCB slotu; nie zastępuje kolejki wielu odbiorców."
},
"side_margin_tree_layout": {
"columns": [
{
"id": "zawodowe",
"label": "TECH",
"side": "left",
"tree": "WE -> EK -> KW",
"description": "Counts, task states, TCB value i event order."
},
{
"id": "ogolne",
"label": "OG",
"side": "right",
"tree": "WE -> EN -> KW",
"description": "Cardinality, payload i clear semantics."
}
]
},
"side_margin_tree_layout": {"columns": [
{"id": "zawodowe", "label": "TECH", "side": "left", "tree": "WE -> EK -> KW", "description": "Counts, task states, TCB value i event order."},
{"id": "ogolne", "label": "OG", "side": "right", "tree": "WE -> EN -> KW", "description": "Cardinality, payload i clear semantics."}
]},
"learning_effects": {
"K12.EN01": {"bloom_level": "Analiza", "label": "Wybór mechanizmu", "text": "Uczeń rozróżnia sygnał binary, count zasobu i jednoodbiorczą notification value.", "assessment_criteria": ["K12.KW01"]},
"K12.EK01": {"bloom_level": "Zastosowanie", "label": "Block i wake", "text": "Uczeń mierzy bounds, eBlocked, handoff, notification take i jawny overwrite value.", "assessment_criteria": ["K12.KW01"]}
"K12.EN01": {
"bloom_level": "Analiza",
"label": "Wybór mechanizmu",
"text": "Uczeń rozróżnia sygnał binary, count zasobu i jednoodbiorczą notification value.",
"assessment_criteria": [
"K12.KW01"
]
},
"K12.EK01": {
"bloom_level": "Zastosowanie",
"label": "Block i wake",
"text": "Uczeń mierzy bounds, eBlocked, handoff, notification take i jawny overwrite value.",
"assessment_criteria": [
"K12.KW01"
]
}
},
"assessment_criteria": {
"K12.KW01": {"text": "Program kończy się PASS; binary 0-1-0, counting 2-1-0 i waiter Blocked, give budzi z count 0, notification take=1, overwrite value=0xA5A55A5A, storage nie zmienia heapu.", "learning_effects": ["K12.EN01", "K12.EK01"]}
"K12.KW01": {
"text": "Program kończy się PASS; binary 0-1-0, counting 2-1-0 i waiter Blocked, give budzi z count 0, notification take=1, overwrite value=0xA5A55A5A, storage nie zmienia heapu.",
"learning_effects": [
"K12.EN01",
"K12.EK01"
]
}
},
"educational_requirements": {
"K12.WE01": {
"text": "Dobór i implementacja synchronizacji według cardinality, count/value i storage.", "label": "Semaphores i notifications", "learning_effects": ["K12.EN01", "K12.EK01"],
"text": "Dobór i implementacja synchronizacji według cardinality, count/value i storage.",
"label": "Semaphores i notifications",
"learning_effects": [
"K12.EN01",
"K12.EK01"
],
"learning_tree": {
"schema": "we-learning-tree.v1", "policy": "Każdy mechanizm ma jawny stan, odbiorcę, storage oraz politykę konsumpcji.",
"ogolne": [{"effect_ref": "K12.EN01", "display": "EN LOCAL RTOS.SYNC.01", "source": "LOCAL", "official": "RTOS.SYNC", "local": "01", "kind": "EN", "tree_id": "K12.WE01.OG.LOCAL.RTOS.SYNC.01", "text": "Analizuje cardinality i semantykę signal/count/value.", "kw": [{"criterion_ref": "K12.KW01", "display": "KW LOCAL RTOS.SYNC.01", "source": "LOCAL", "kind": "KW", "official": "RTOS.SYNC", "local": "01", "text": "Dobiera mechanizm bez przypisywania semaphore payloadu ani notification wielu konsumentów."}]}],
"zawodowe": [{"effect_ref": "K12.EK01", "display": "EK LOCAL DBG.SYNC.01", "source": "LOCAL", "official": "DBG.SYNC", "local": "01", "kind": "EK", "tree_id": "K12.WE01.TECH.LOCAL.DBG.SYNC.01", "text": "Mierzy count, blocked state, wake sequence i TCB notification value.", "kw": [{"criterion_ref": "K12.KW01", "display": "KW LOCAL DBG.SYNC.01", "source": "LOCAL", "kind": "KW", "official": "DBG.SYNC", "local": "01", "text": "Pokazuje 0/1, 2/1/0, take=1, overwrite value i PASS."}]}]
"schema": "we-learning-tree.v1",
"policy": "Każdy mechanizm ma jawny stan, odbiorcę, storage oraz politykę konsumpcji.",
"ogolne": [
{
"effect_ref": "K12.EN01",
"display": "EN LOCAL RTOS.SYNC.01",
"source": "LOCAL",
"official": "RTOS.SYNC",
"local": "01",
"kind": "EN",
"tree_id": "K12.WE01.OG.LOCAL.RTOS.SYNC.01",
"text": "Analizuje cardinality i semantykę signal/count/value.",
"kw": [
{
"criterion_ref": "K12.KW01",
"display": "KW LOCAL RTOS.SYNC.01",
"source": "LOCAL",
"kind": "KW",
"official": "RTOS.SYNC",
"local": "01",
"text": "Dobiera mechanizm bez przypisywania semaphore payloadu ani notification wielu konsumentów."
}
]
}
],
"zawodowe": [
{
"effect_ref": "K12.EK01",
"display": "EK LOCAL DBG.SYNC.01",
"source": "LOCAL",
"official": "DBG.SYNC",
"local": "01",
"kind": "EK",
"tree_id": "K12.WE01.TECH.LOCAL.DBG.SYNC.01",
"text": "Mierzy count, blocked state, wake sequence i TCB notification value.",
"kw": [
{
"criterion_ref": "K12.KW01",
"display": "KW LOCAL DBG.SYNC.01",
"source": "LOCAL",
"kind": "KW",
"official": "DBG.SYNC",
"local": "01",
"text": "Pokazuje 0/1, 2/1/0, take=1, overwrite value i PASS."
}
]
}
]
}
}
},
"sections": [
{"title": "Binary i counting bounds", "content_kind": "prose", "content_tex": "Zmierz binary 0-1-0 i counting 2-1-0, odrzuć give przy maximum oraz zablokuj trzeci take.", "educational_requirement_refs": ["K12.WE01"], "learning_effect_refs": ["K12.EK01"], "assessment_criterion_refs": ["K12.KW01"], "area_tree_refs": ["K12.WE01.TECH.LOCAL.DBG.SYNC.01"], "steps": [
{"id": "S01", "title": "Potwierdź bounds obu semaphore.", "tree_refs": ["K12.WE01.TECH.LOCAL.DBG.SYNC.01"]},
{"id": "S02", "title": "Pokaż eBlocked i natychmiastowy handoff count 0.", "tree_refs": ["K12.WE01.TECH.LOCAL.DBG.SYNC.01"]}
]},
{"title": "Notification count i value", "content_kind": "prose", "content_tex": "Zastąp jednoodbiorczy wake przez TCB give/take, a potem prześlij jawną wartość przez overwrite/wait.", "educational_requirement_refs": ["K12.WE01"], "learning_effect_refs": ["K12.EK01"], "assessment_criterion_refs": ["K12.KW01"], "area_tree_refs": ["K12.WE01.TECH.LOCAL.DBG.SYNC.01"], "steps": [
{"id": "S03", "title": "Zapisz pending checkpoint i take result 1.", "tree_refs": ["K12.WE01.TECH.LOCAL.DBG.SYNC.01"]},
{"id": "S04", "title": "Odbierz overwrite 0xA5A55A5A.", "tree_refs": ["K12.WE01.TECH.LOCAL.DBG.SYNC.01"]}
]},
{"title": "Cardinality, storage i clear policy", "content_kind": "prose", "content_tex": "Porównaj caller semaphore control z notification state w TCB i dobierz clear-on-exit lub decrement do binary/counting znaczenia.", "educational_requirement_refs": ["K12.WE01"], "learning_effect_refs": ["K12.EN01"], "assessment_criterion_refs": ["K12.KW01"], "area_tree_refs": ["K12.WE01.OG.LOCAL.RTOS.SYNC.01"], "steps": [
{"id": "S05", "title": "Dobierz mechanizm do trzech scenariuszy.", "tree_refs": ["K12.WE01.OG.LOCAL.RTOS.SYNC.01"]},
{"id": "S06", "title": "Uzasadnij one receiver i brak payloadu semaphore.", "tree_refs": ["K12.WE01.OG.LOCAL.RTOS.SYNC.01"]}
]}
{
"title": "Binary i counting bounds",
"content_kind": "prose",
"content_tex": "Zmierz binary 0-1-0 i counting 2-1-0, odrzuć give przy maximum oraz zablokuj trzeci take.",
"educational_requirement_refs": [
"K12.WE01"
],
"tasks": {"task01": {
"title": "Semaphore slots i jednoodbiorcza notification", "uuid": "fcb6107c-268f-4e86-a8cc-092e5875f6f0",
"learning_effect_refs": [
"K12.EK01"
],
"assessment_criterion_refs": [
"K12.KW01"
],
"area_tree_refs": [
"K12.WE01.TECH.LOCAL.DBG.SYNC.01"
],
"steps": [
{
"id": "S01",
"title": "Potwierdź bounds obu semaphore.",
"tree_refs": [
"K12.WE01.TECH.LOCAL.DBG.SYNC.01"
]
},
{
"id": "S02",
"title": "Pokaż eBlocked i natychmiastowy handoff count 0.",
"tree_refs": [
"K12.WE01.TECH.LOCAL.DBG.SYNC.01"
]
}
]
},
{
"title": "Notification count i value",
"content_kind": "prose",
"content_tex": "Zastąp jednoodbiorczy wake przez TCB give/take, a potem prześlij jawną wartość przez overwrite/wait.",
"educational_requirement_refs": [
"K12.WE01"
],
"learning_effect_refs": [
"K12.EK01"
],
"assessment_criterion_refs": [
"K12.KW01"
],
"area_tree_refs": [
"K12.WE01.TECH.LOCAL.DBG.SYNC.01"
],
"steps": [
{
"id": "S03",
"title": "Zapisz pending checkpoint i take result 1.",
"tree_refs": [
"K12.WE01.TECH.LOCAL.DBG.SYNC.01"
]
},
{
"id": "S04",
"title": "Odbierz overwrite 0xA5A55A5A.",
"tree_refs": [
"K12.WE01.TECH.LOCAL.DBG.SYNC.01"
]
}
]
},
{
"title": "Cardinality, storage i clear policy",
"content_kind": "prose",
"content_tex": "Porównaj caller semaphore control z notification state w TCB i dobierz clear-on-exit lub decrement do binary/counting znaczenia.",
"educational_requirement_refs": [
"K12.WE01"
],
"learning_effect_refs": [
"K12.EN01"
],
"assessment_criterion_refs": [
"K12.KW01"
],
"area_tree_refs": [
"K12.WE01.OG.LOCAL.RTOS.SYNC.01"
],
"steps": [
{
"id": "S05",
"title": "Dobierz mechanizm do trzech scenariuszy.",
"tree_refs": [
"K12.WE01.OG.LOCAL.RTOS.SYNC.01"
]
},
{
"id": "S06",
"title": "Uzasadnij one receiver i brak payloadu semaphore.",
"tree_refs": [
"K12.WE01.OG.LOCAL.RTOS.SYNC.01"
]
}
]
}
],
"tasks": {
"task01": {
"title": "Semaphore slots i jednoodbiorcza notification",
"uuid": "fcb6107c-268f-4e86-a8cc-092e5875f6f0",
"prompt_tex": "Porównaj binary/counting semaphore i task notification przez bounds, blocked/wake, storage, take clear policy oraz explicit overwrite value.",
"criterion": "Binary 0-1-0; counting 2-1-0/eBlocked/handoff; notify take 1; overwrite A5A55A5A; heap delta 0; pass=1.",
"educational_requirement_refs": ["K12.WE01"], "learning_effect_refs": ["K12.EN01", "K12.EK01"], "assessment_criterion_ref": "K12.KW01", "links": {"equations": [], "figures": []}
}},
"tasks_order": ["task01"]
"educational_requirement_refs": [
"K12.WE01"
],
"learning_effect_refs": [
"K12.EN01",
"K12.EK01"
],
"assessment_criterion_ref": "K12.KW01",
"links": {
"equations": [],
"figures": []
}
}
},
"tasks_order": [
"task01"
]
}