Files

285 lines
9.1 KiB
JSON

{
"$schema": "../../../tools/card-layouts/schemas/card-source.schema.json",
"schema": "esc-card-source.v1",
"card": {
"id": "mpabi-freertos-cpp-07-task-wrapper",
"series": "freertos-cpp",
"series_title": "FreeRTOS C++",
"number": "07",
"count": "16",
"slug": "task-wrapper",
"title": "TaskHandle_t, jawny start i statyczny trampoline",
"topic": "Stabilny context, C/C++ boundary, TCB, stack i lifecycle taska",
"project": "Freestanding C++ nad FreeRTOS",
"subject": "Informatyka",
"level": "Rok 2 · L06 · RV32I/Hazard3",
"revision_date": "2026-07-19T00:00:00+02:00",
"status": "Gotowa",
"version": "v00.01",
"uuid": "9bffead0-4341-4350-806d-e975b1a3a08f",
"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": "TaskHandle_t, jawny start i statyczny trampoline",
"repository_url": "https://zsl-gitea.mpabi.pl/edu-freertos-cpp/lab-rv32i-freertos-task-wrapper",
"revision": "v00.01",
"issued_on": "2026-07-19T00:00:00+02:00",
"series": "FREERTOS-CPP-07",
"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/9bffead0-4341-4350-806d-e975b1a3a08f"
},
"front_page_scope": {
"title": "Cel karty",
"content_tex": "Uczeń prowadzi stabilny adres kompletnego obiektu przez xTaskCreate i statyczny trampoline do prywatnego run(), odróżniając obiekt, TCB/handle oraz task stack.",
"scope_title": "Zakres karty",
"scope_content_tex": "Konstruktor nie alokuje ani nie startuje. Wrapper jest non-copyable/non-movable, kończy body i self-delete; porównanie dynamicznego i statycznego storage należy do K08."
},
"side_margin_tree_layout": {
"columns": [
{
"id": "zawodowe",
"label": "TECH",
"side": "left",
"tree": "WE -> EK -> KW",
"description": "C boundary, adresy TCB/stack i ABI."
},
{
"id": "ogolne",
"label": "OG",
"side": "right",
"tree": "WE -> EN -> KW",
"description": "Lifecycle, stabilna tożsamość i ownership."
}
]
},
"learning_effects": {
"K07.EN01": {
"bloom_level": "Analiza",
"label": "Tożsamość i lifecycle",
"text": "Uczeń uzasadnia explicit start, stabilny context, brak copy/move i bezpieczną granicę self-delete.",
"assessment_criteria": [
"K07.KW01"
]
},
"K07.EK01": {
"bloom_level": "Zastosowanie",
"label": "C/C++ trampoline",
"text": "Uczeń śledzi argumenty xTaskCreate, raw context, handle/TCB i stack do typed run().",
"assessment_criteria": [
"K07.KW01"
]
}
},
"assessment_criteria": {
"K07.KW01": {
"text": "Program kończy się PASS; konstruktor nie zmienia heapu; object identity jest stała; handle=current=TCB i różni się od obiektu; local leży w stack bounds; result=500500; wrapper completed z null handle.",
"learning_effects": [
"K07.EN01",
"K07.EK01"
]
}
},
"educational_requirements": {
"K07.WE01": {
"text": "Zaprojektowanie jawnej, stabilnej granicy między taskiem FreeRTOS C i obiektem C++.",
"label": "Explicit Task i trampoline",
"learning_effects": [
"K07.EN01",
"K07.EK01"
],
"learning_tree": {
"schema": "we-learning-tree.v1",
"policy": "Każdy etap lifecycle ma checkpoint, a każdy wskaźnik ma wskazany obiekt i lifetime.",
"ogolne": [
{
"effect_ref": "K07.EN01",
"display": "EN LOCAL RTOS.LIFE.01",
"source": "LOCAL",
"official": "RTOS.LIFE",
"local": "01",
"kind": "EN",
"tree_id": "K07.WE01.OG.LOCAL.RTOS.LIFE.01",
"text": "Analizuje explicit start, stabilny adres oraz completion/self-delete.",
"kw": [
{
"criterion_ref": "K07.KW01",
"display": "KW LOCAL RTOS.LIFE.01",
"source": "LOCAL",
"kind": "KW",
"official": "RTOS.LIFE",
"local": "01",
"text": "Uzasadnia brak startu w konstruktorze, copy/move i wymuszonego delete w destruktorze."
}
]
}
],
"zawodowe": [
{
"effect_ref": "K07.EK01",
"display": "EK LOCAL DBG.TASK.01",
"source": "LOCAL",
"official": "DBG.TASK",
"local": "01",
"kind": "EK",
"tree_id": "K07.WE01.TECH.LOCAL.DBG.TASK.01",
"text": "Śledzi obiekt, context, TCB/handle i stack przez trampoline.",
"kw": [
{
"criterion_ref": "K07.KW01",
"display": "KW LOCAL DBG.TASK.01",
"source": "LOCAL",
"kind": "KW",
"official": "DBG.TASK",
"local": "01",
"text": "Pokazuje object equalities, handle=current=TCB, local w bounds i brak vtable."
}
]
}
]
}
}
},
"sections": [
{
"title": "Explicit start i stany",
"content_kind": "prose",
"content_tex": "Konstruktor zapisuje konfigurację. Start dopiero po kompletnej konstrukcji tworzy TCB/stack i odrzuca duplikat.",
"educational_requirement_refs": [
"K07.WE01"
],
"learning_effect_refs": [
"K07.EN01"
],
"assessment_criterion_refs": [
"K07.KW01"
],
"area_tree_refs": [
"K07.WE01.OG.LOCAL.RTOS.LIFE.01"
],
"steps": [
{
"id": "S01",
"title": "Pokaż zerowy heap delta konstruktora i zmianę przy start.",
"tree_refs": [
"K07.WE01.OG.LOCAL.RTOS.LIFE.01"
]
},
{
"id": "S02",
"title": "Odtwórz constructed--starting--ready--running--completed.",
"tree_refs": [
"K07.WE01.OG.LOCAL.RTOS.LIFE.01"
]
}
]
},
{
"title": "xTaskCreate i trampoline",
"content_kind": "prose",
"content_tex": "Rozpisz sześć argumentów C API, a następnie śledź typed object jako void* context do static trampoline i private run().",
"educational_requirement_refs": [
"K07.WE01"
],
"learning_effect_refs": [
"K07.EK01"
],
"assessment_criterion_refs": [
"K07.KW01"
],
"area_tree_refs": [
"K07.WE01.TECH.LOCAL.DBG.TASK.01"
],
"steps": [
{
"id": "S03",
"title": "Zapisz równość object/context/this/completed object.",
"tree_refs": [
"K07.WE01.TECH.LOCAL.DBG.TASK.01"
]
},
{
"id": "S04",
"title": "Pokaż statyczny trampoline i brak vtable w ELF.",
"tree_refs": [
"K07.WE01.TECH.LOCAL.DBG.TASK.01"
]
}
]
},
{
"title": "TCB, handle i task stack",
"content_kind": "prose",
"content_tex": "Odróżnij aplikacyjny object address od dynamicznego TCB. Potwierdź handle=current=TCB oraz local w granicach task stack.",
"educational_requirement_refs": [
"K07.WE01"
],
"learning_effect_refs": [
"K07.EK01"
],
"assessment_criterion_refs": [
"K07.KW01"
],
"area_tree_refs": [
"K07.WE01.TECH.LOCAL.DBG.TASK.01"
],
"steps": [
{
"id": "S05",
"title": "Sklasyfikuj trzy domeny adresów i jednostkę stack words.",
"tree_refs": [
"K07.WE01.TECH.LOCAL.DBG.TASK.01"
]
},
{
"id": "S06",
"title": "Potwierdź completion, null handle, wynik 500500 i PASS.",
"tree_refs": [
"K07.WE01.TECH.LOCAL.DBG.TASK.01"
]
}
]
}
],
"tasks": {
"task01": {
"title": "Stabilny obiekt przez statyczny trampoline",
"uuid": "9bffead0-4341-4350-806d-e975b1a3a08f",
"prompt_tex": "Uruchom lokalny CounterTask przez explicit start, rozpisz xTaskCreate i udowodnij stabilny context, osobny TCB/handle, stack bounds oraz zakończony lifecycle.",
"criterion": "Constructor heap delta 0; duplicate rejected; object identity stała; handle=current=TCB w ucHeap; local w task stack; result=500500; completed/null; pass=1.",
"educational_requirement_refs": [
"K07.WE01"
],
"learning_effect_refs": [
"K07.EN01",
"K07.EK01"
],
"assessment_criterion_ref": "K07.KW01",
"links": {
"equations": [],
"figures": []
}
}
},
"tasks_order": [
"task01"
]
}