commit b30007f604b6860a3ad70e305cf3cf8d2b6942da Author: M. Pabiszczak <2+mpabi@noreply.zsl-gitea.mpabi.pl> Date: Mon Jul 20 08:24:44 2026 +0200 publish: K07 task-wrapper v00.01 diff --git a/json/card_source.json b/json/card_source.json new file mode 100644 index 0000000..8ccd55a --- /dev/null +++ b/json/card_source.json @@ -0,0 +1,77 @@ +{ + "$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 + }, + "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"] +} diff --git a/pdf/mpabi-inf-freertos-cpp-07-task-wrapper-v00.01-9bffead0-4341-4350-806d-e975b1a3a08f.pdf b/pdf/mpabi-inf-freertos-cpp-07-task-wrapper-v00.01-9bffead0-4341-4350-806d-e975b1a3a08f.pdf new file mode 100644 index 0000000..18b78b4 Binary files /dev/null and b/pdf/mpabi-inf-freertos-cpp-07-task-wrapper-v00.01-9bffead0-4341-4350-806d-e975b1a3a08f.pdf differ